ebay

type Category struct {
	ID     string   `json:"id" kit:"id"` // numeric leaf category id
	Name   string   `json:"name"`
	Parent string   `json:"parent,omitempty"` // parent category name (from the trail)
	Trail  []string `json:"trail,omitempty"`  // the full ancestor path, eBay first, leaf last
	Node   string   `json:"node,omitempty"`   // bn_<digits> browse-node id when known
	URL    string   `json:"url"`
}

type Client struct {
	HTTP      *http.Client
	BaseURL   string
	UserAgent string
	Delay     time.Duration
	Retries   int

	// SuggestURL is the autocomplete endpoint. It defaults to the public
	// autosug host; tests point it at an httptest server.
	SuggestURL string
	// contains filtered or unexported fields
}

type Config struct {
	UserAgent   string
	Marketplace string

	// ClientID and ClientSecret enable the Browse API fallback for the walled
	// surfaces (item, search). Empty leaves the fallback off; the walled
	// commands then report the bot wall rather than guessing.
	ClientID     string
	ClientSecret string

	// Delay is the minimum gap between requests. Zero means no pacing.
	Delay   time.Duration
	Retries int
	Timeout time.Duration

	// BaseURL is the site root. Empty uses the public site; tests point it at an
	// httptest server.
	BaseURL string

	// CacheDir is where responses are cached. Empty disables the cache, as does
	// NoCache.
	CacheDir string
	CacheTTL time.Duration
	NoCache  bool
	// Refresh fetches fresh copies and rewrites the cache, ignoring any hit.
	Refresh bool
}

type Deal struct {
	ID           string  `json:"id" kit:"id"`
	Title        string  `json:"title,omitempty" table:",truncate"`
	Price        float64 `json:"price,omitempty"`
	Was          float64 `json:"was,omitempty"` // original price
	Currency     string  `json:"currency,omitempty"`
	Discount     string  `json:"discount,omitempty"` // the badge text, e.g. "20% off"
	FreeShipping bool    `json:"free_shipping,omitempty"`
	Trending     bool    `json:"trending,omitempty"` // the tile carries a hotness badge
	Image        string  `json:"image,omitempty" table:",truncate"`
	URL          string  `json:"url"`
}

type Domain struct{}

type Item struct {
	ID           string   `json:"id" kit:"id"`
	Title        string   `json:"title,omitempty" table:",truncate"`
	Subtitle     string   `json:"subtitle,omitempty" table:",truncate"`
	Price        float64  `json:"price,omitempty"`
	Currency     string   `json:"currency,omitempty"`
	Condition    string   `json:"condition,omitempty"`
	Buying       string   `json:"buying,omitempty"` // fixed, auction
	Bids         int      `json:"bids,omitempty"`   // auctions only
	EndsAt       string   `json:"ends_at,omitempty"`
	Available    int      `json:"available,omitempty"`
	Sold         int      `json:"sold,omitempty"`
	Seller       string   `json:"seller,omitempty"`
	SellerScore  int      `json:"seller_score,omitempty"`
	SellerRating float64  `json:"seller_rating,omitempty"`
	Location     string   `json:"location,omitempty"`
	Shipping     string   `json:"shipping,omitempty"`
	Returns      string   `json:"returns,omitempty"`
	Category     string   `json:"category,omitempty"`
	Image        string   `json:"image,omitempty" table:",truncate"`
	Images       []string `json:"images,omitempty"` // the photo gallery, when the page or API lists more than one
	URL          string   `json:"url"`
}

type Listing struct {
	ID        string   `json:"id" kit:"id"`
	Title     string   `json:"title,omitempty" table:",truncate"`
	Price     float64  `json:"price,omitempty"`
	Currency  string   `json:"currency,omitempty"`
	Condition string   `json:"condition,omitempty"`
	Buying    string   `json:"buying,omitempty"` // fixed, auction, best_offer
	Bids      int      `json:"bids,omitempty"`   // auctions only
	Shipping  string   `json:"shipping,omitempty"`
	Seller    string   `json:"seller,omitempty"`
	Rating    float64  `json:"rating,omitempty"`  // aggregate rating (category JSON-LD)
	Reviews   int      `json:"reviews,omitempty"` // review count (category JSON-LD)
	Sold      int      `json:"sold,omitempty"`    // units sold, when the card prints it
	Watching  int      `json:"watching,omitempty"`
	Thumbnail string   `json:"thumbnail,omitempty" table:",truncate"`
	Images    []string `json:"images,omitempty"` // image gallery (category JSON-LD itemOffered)
	URL       string   `json:"url"`
}

type Ref struct {
	Input string `json:"input"`
	Kind  string `json:"kind"`
	ID    string `json:"id"`
	URL   string `json:"url"`
}

type Seller struct {
	Username  string  `json:"username" kit:"id"`
	Store     string  `json:"store,omitempty"`
	Score     int     `json:"score,omitempty"`    // feedback score (count), when shown
	Positive  float64 `json:"positive,omitempty"` // percent positive feedback
	Sold      int     `json:"sold,omitempty"`     // lifetime items sold (storefront)
	Followers int     `json:"followers,omitempty"`
	TopRated  bool    `json:"top_rated,omitempty"` // the Top Rated Seller badge
	Location  string  `json:"location,omitempty"`
	Logo      string  `json:"logo,omitempty" table:",truncate"` // store logo image
	URL       string  `json:"url"`
}

type Suggestion struct {
	Query string `json:"query"`         // the prefix that was queried
	Term  string `json:"term" kit:"id"` // a suggested completion
}