common

type AcceptedStatus string

type ActivityVerb string

type AdminSubmission struct {
	// CoverUrl The entry's cover URL, live from the proposal join; prefills the curation cover field.
	CoverUrl  *string   `json:"cover_url,omitempty"`
	CreatedAt time.Time `json:"created_at"`

	// Developers The entry's developer credit facts, live from the proposal join; prefill the curation form.
	Developers       *[]string           `json:"developers,omitempty"`
	DisplayName      string              `json:"display_name"`
	Edition          *string             `json:"edition,omitempty"`
	EntryId          openapi_types.UUID  `json:"entry_id"`
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	Id               openapi_types.UUID  `json:"id"`
	ItemType         ItemType            `json:"item_type"`
	PlatformName     *string             `json:"platform_name,omitempty"`

	// Publishers The entry's publisher credit facts, live from the proposal join; prefill the curation form.
	Publishers *[]string          `json:"publishers,omitempty"`
	Region     string             `json:"region"`
	Status     SubmissionStatus   `json:"status"`
	UpdatedAt  time.Time          `json:"updated_at"`
	UserId     openapi_types.UUID `json:"user_id"`
}

type AdminSubmissionsPage struct {
	Submissions []AdminSubmission `json:"submissions"`

	// TotalCount Full pending count, beyond this page.
	TotalCount int64 `json:"total_count"`
}

type BulkUpdateRequest struct {
	AddTagIds    *[]openapi_types.UUID `json:"add_tag_ids,omitempty"`
	EntryIds     []openapi_types.UUID  `json:"entry_ids"`
	RemoveTagIds *[]openapi_types.UUID `json:"remove_tag_ids,omitempty"`
	Status       *EntryStatus          `json:"status,omitempty"`

	// StorageLocation Empty string clears the field; an absent field leaves it untouched (see the operation description).
	StorageLocation *string `json:"storage_location,omitempty"`
}

type BulkUpdateResult struct {
	// UpdatedCount Count of the caller's own entries among entry_ids, whether or not any targeted field actually changed.
	UpdatedCount int `json:"updated_count"`
}

type CatalogPlatform struct {
	// Aliases Alternate spellings and abbreviations (compare case-insensitively).
	Aliases []string `json:"aliases"`
	IgdbId  int64    `json:"igdb_id"`
	Name    string   `json:"name"`
}

type CatalogProvider string

type CatalogQ = string

type CommunityMeta struct {
	// CoverUrl User-supplied cover image URL (https, never fetched server-side; the client renders it with a broken-image fallback). Served as the product cover when no provider cover is present; retained after promotion as gap-fill.
	CoverUrl *string `json:"cover_url,omitempty"`

	// Developers Curated developer company names, one per element; served into entry credit snapshots when the provider block carries no developer credits (per-field gap-fill).
	Developers       *[]string           `json:"developers,omitempty"`
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	PlatformName     *string             `json:"platform_name,omitempty"`

	// Publishers Curated publisher company names; same gap-fill posture as developers.
	Publishers *[]string `json:"publishers,omitempty"`

	// Region Curated entry-vocabulary region fact (open-world; known values ntsc_u, ntsc_j, pal, region_free, korea, brazil, china).
	Region *string `json:"region,omitempty"`
}

type CommunityProductSpec struct {
	// CoverUrl Optional https cover image URL (validated by shape only, never fetched).
	CoverUrl *string `json:"cover_url,omitempty"`

	// Developers Curated developer company names, one per element.
	Developers *[]string `json:"developers,omitempty"`

	// Edition The entry idiom's single "Edition or variant" note.
	Edition          *string             `json:"edition,omitempty"`
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	Name             string              `json:"name"`
	PlatformName     *string             `json:"platform_name,omitempty"`

	// Publishers Curated publisher company names, one per element.
	Publishers *[]string `json:"publishers,omitempty"`

	// Region Curated entry-vocabulary region fact; stored under the community facts block (community.region), not the product's top-level region field.
	Region *string  `json:"region,omitempty"`
	Type   ItemType `json:"type"`
}

type CommunityProductsPage struct {
	Products []Product `json:"products"`

	// TotalCount Full count of community products, beyond this page.
	TotalCount int64 `json:"total_count"`
}

type CompanyCredit struct {
	Developer bool   `json:"developer"`
	Name      string `json:"name"`
	Publisher bool   `json:"publisher"`
}

type CurrencyCode = string

type CurrencySpend struct {
	Currency   string `json:"currency"`
	TotalCents int64  `json:"total_cents"`
}

type Cursor = string

type Dashboard struct {
	ByItemType map[string]int   `json:"by_item_type"`
	ByPlatform []PlatformCount  `json:"by_platform"`
	ByStatus   map[string]int   `json:"by_status"`
	Pricing    DashboardPricing `json:"pricing"`

	// Spend Sum of price_paid_cents per currency, over entries that record a price.
	Spend        []CurrencySpend `json:"spend"`
	TotalEntries int             `json:"total_entries"`
}

type DashboardPricing struct {
	// Available False when enrichment was unreachable; total_value_cents is then absent.
	Available bool `json:"available"`

	// ExcludedEntries Entries with pricing_mode disabled.
	ExcludedEntries int    `json:"excluded_entries"`
	PricedEntries   int    `json:"priced_entries"`
	TotalValueCents *int64 `json:"total_value_cents,omitempty"`

	// UnpricedEntries Entries whose effective product is unmatched or lacks a price for their packaging.
	UnpricedEntries int `json:"unpriced_entries"`
}

type DismissCandidateRequest struct {
	Provider   CatalogProvider `json:"provider"`
	ProviderId int64           `json:"provider_id"`
}

type EntriesDeveloper = []string

type EntriesItemCondition = []ItemCondition

type EntriesItemType = []ItemType

type EntriesPackaging = []Packaging

type EntriesPublisher = []string

type EntriesRegion = []string

type EntriesSort string

type EntriesTagId = []openapi_types.UUID

type Entry struct {
	// BacklogRank Present exactly while status is backlog; server-generated.
	BacklogRank  *string        `json:"backlog_rank,omitempty"`
	BoxCondition *ItemCondition `json:"box_condition,omitempty"`

	// CoverUrl Cover art URL. For product-backed entries it is snapshotted from the product at creation (and refreshed on adoption). Custom entries may set their own (https, shape-validated). Absent on hardware and products without art (render a placeholder).
	CoverUrl  *string   `json:"cover_url,omitempty"`
	CreatedAt time.Time `json:"created_at"`
	Currency  string    `json:"currency"`

	// CustomValueCents The user-set market value (USD cents). With pricing_mode custom it IS the entry's value; under any other mode it persists as "last custom price" memory.
	CustomValueCents *int64 `json:"custom_value_cents,omitempty"`

	// CustomValueEnteredCents The custom price exactly as the user typed it, in custom_value_entered_currency minor units (major units x 100, including zero-decimal currencies). Display metadata only: no aggregation reads it; custom_value_cents remains the USD value used everywhere.
	CustomValueEnteredCents *int64 `json:"custom_value_entered_cents,omitempty"`

	// CustomValueEnteredCurrency Currency of custom_value_entered_cents.
	CustomValueEnteredCurrency *string `json:"custom_value_entered_currency,omitempty"`

	// CustomValueSetAt Server-managed: stamped when custom_value_cents is first set or changes value, untouched otherwise. Read-only.
	CustomValueSetAt *time.Time `json:"custom_value_set_at,omitempty"`

	// Developers Developer company names snapshotted for the entry: IGDB credits where the product carries them, community curated lists as gap-fill, or the user's own facts on a custom entry. Absent when no credits are known.
	Developers  *[]string `json:"developers,omitempty"`
	DisplayName string    `json:"display_name"`

	// Edition Per-copy variant note ("first print (glitched rev)", "black edition"): the idiom for variants of cataloged items is an entry on the base product with the variant recorded here.
	Edition          *string             `json:"edition,omitempty"`
	ExternalRef      *string             `json:"external_ref,omitempty"`
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	HasBox           bool                `json:"has_box"`
	HasManual        bool                `json:"has_manual"`
	Id               openapi_types.UUID  `json:"id"`

	// IgdbGameId The recommendation identity: snapshotted from the entry's own product, or from the proxy target on custom game entries (owning a reproduction of X means playing X).
	IgdbGameId    *int64         `json:"igdb_game_id,omitempty"`
	ItemCondition *ItemCondition `json:"item_condition,omitempty"`
	ItemType      ItemType       `json:"item_type"`

	// LocalizedCoverUrl Region-picked box art URL (server-derived).
	LocalizedCoverUrl *string `json:"localized_cover_url,omitempty"`

	// LocalizedName Region-picked native-script title (server-derived from the entry's region; absent when the region has none).
	LocalizedName *string `json:"localized_name,omitempty"`

	// LocalizedNameTranslit Latin transliteration of localized_name's title (server-derived).
	LocalizedNameTranslit *string        `json:"localized_name_translit,omitempty"`
	ManualCondition       *ItemCondition `json:"manual_condition,omitempty"`
	MediaType             MediaType      `json:"media_type"`
	Notes                 *string        `json:"notes,omitempty"`
	Packaging             Packaging      `json:"packaging"`
	Pinned                bool           `json:"pinned"`

	// Platform The entry's platform: a creation-time snapshot of the product's platform (both fields) on product-backed entries, or a user-supplied platform on custom entries - both fields when picked from the catalog or normalized by the admin lever, name-only for escape-hatch free text. Absent when neither exists.
	Platform         *EntryPlatform      `json:"platform,omitempty"`
	PricePaidCents   *int64              `json:"price_paid_cents,omitempty"`
	PricingMode      PricingMode         `json:"pricing_mode"`
	PricingProductId *openapi_types.UUID `json:"pricing_product_id,omitempty"`

	// ProductId Absent on custom entries.
	ProductId *openapi_types.UUID `json:"product_id,omitempty"`

	// Publishers Publisher company names; same sourcing as developers.
	Publishers    *[]string           `json:"publishers,omitempty"`
	PurchasedAt   *openapi_types.Date `json:"purchased_at,omitempty"`
	PurchasedFrom *string             `json:"purchased_from,omitempty"`
	Rating        *int                `json:"rating,omitempty"`
	Region        string              `json:"region"`

	// RegionMismatchAckAt Null until the owner dismisses the region-mismatch banner; cleared whenever region or product changes.
	RegionMismatchAckAt *time.Time  `json:"region_mismatch_ack_at,omitempty"`
	Source              EntrySource `json:"source"`
	Status              EntryStatus `json:"status"`
	StorageLocation     *string     `json:"storage_location,omitempty"`
	Tags                []TagRef    `json:"tags"`
	UpdatedAt           time.Time   `json:"updated_at"`
	ValueCents          *int64      `json:"value_cents,omitempty"`
}

type EntryCreate struct {
	BoxCondition *ItemCondition `json:"box_condition,omitempty"`

	// CoverUrl Custom entries only; an https cover image URL (validated by shape, never fetched).
	CoverUrl                   *string `json:"cover_url,omitempty"`
	Currency                   *string `json:"currency,omitempty"`
	CustomValueCents           *int64  `json:"custom_value_cents,omitempty"`
	CustomValueEnteredCents    *int64  `json:"custom_value_entered_cents,omitempty"`
	CustomValueEnteredCurrency *string `json:"custom_value_entered_currency,omitempty"`

	// Developers Custom entries only: developer company names, one per element. Ignored on product-backed creation, where the snapshot derives credits from the product.
	Developers *[]string `json:"developers,omitempty"`

	// DisplayName Custom entries only (required there).
	DisplayName *string `json:"display_name,omitempty"`

	// Edition Per-copy variant note; the idiom for variants of cataloged items.
	Edition *string `json:"edition,omitempty"`

	// FirstReleaseDate Custom entries only.
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	HasBox           *bool               `json:"has_box,omitempty"`
	HasManual        *bool               `json:"has_manual,omitempty"`
	ItemCondition    *ItemCondition      `json:"item_condition,omitempty"`

	// ItemType Custom entries only (required there).
	ItemType        *ItemType      `json:"item_type,omitempty"`
	ManualCondition *ItemCondition `json:"manual_condition,omitempty"`

	// MatchProvenance Whose choice the matched product is. Send user only when the add flow's manual match picked the price listing; automated repoints (region edits, the entry rematch) never touch user rows. Not accepted on update - the server stamps user when the narrow product_id re-match arm fires.
	MatchProvenance *EntryCreateMatchProvenance `json:"match_provenance,omitempty"`
	MediaType       *EntryCreateMediaType       `json:"media_type,omitempty"`
	Notes           *string                     `json:"notes,omitempty"`
	Packaging       Packaging                   `json:"packaging"`
	Pinned          *bool                       `json:"pinned,omitempty"`

	// PlatformIgdbId Custom entries only; the canonical platform id from the picker (surfaces the entry in the platform filter).
	PlatformIgdbId *int64 `json:"platform_igdb_id,omitempty"`

	// PlatformName Custom entries only.
	PlatformName     *string             `json:"platform_name,omitempty"`
	PricePaidCents   *int64              `json:"price_paid_cents,omitempty"`
	PricingMode      *PricingMode        `json:"pricing_mode,omitempty"`
	PricingProductId *openapi_types.UUID `json:"pricing_product_id,omitempty"`

	// ProductId Omit for a custom (off-catalog) entry.
	ProductId *openapi_types.UUID `json:"product_id,omitempty"`

	// Publishers Custom entries only; publisher company names, one per element.
	Publishers    *[]string           `json:"publishers,omitempty"`
	PurchasedAt   *openapi_types.Date `json:"purchased_at,omitempty"`
	PurchasedFrom *string             `json:"purchased_from,omitempty"`
	Rating        *int                `json:"rating,omitempty"`

	// Region Entry region. Known values ntsc_u, ntsc_j, pal, region_free, korea, brazil and china are first-class: labeled in the UI, filterable, normalize-lever promotion targets, with release-date chains, availability rows, and localized display snapshots per region (ntsc_u and region_free render the canonical presentation by design). korea, brazil and china have no PriceCharting axis, so they price from base listings as their deliberate proxy. Any other non-empty string is stored verbatim as a display fact and prices like ntsc_u until the value graduates to the known set.
	Region          string                `json:"region"`
	Status          *EntryStatus          `json:"status,omitempty"`
	StorageLocation *string               `json:"storage_location,omitempty"`
	TagIds          *[]openapi_types.UUID `json:"tag_ids,omitempty"`
}

type EntryCreateMatchProvenance string

type EntryCreateMediaType string

type EntryGroup struct {
	Entries []Entry `json:"entries"`
	Key     string  `json:"key"`
	Label   string  `json:"label"`
}

type EntryList struct {
	Entries *[]Entry      `json:"entries,omitempty"`
	Groups  *[]EntryGroup `json:"groups,omitempty"`

	// PricingAvailable False when enrichment was unreachable; every value_cents is null.
	PricingAvailable bool `json:"pricing_available"`

	// TotalCount Size of the full filtered set, before pagination.
	TotalCount int `json:"total_count"`
}

type EntryPlatform struct {
	// IgdbPlatformId Absent on name-only custom entries.
	IgdbPlatformId *int64 `json:"igdb_platform_id,omitempty"`
	Name           string `json:"name"`
}

type EntrySource string

type EntryStatus string

type EntryUpdate struct {
	BoxCondition *ItemCondition `json:"box_condition,omitempty"`

	// CoverUrl Custom entries only; an https cover image URL (validated by shape, never fetched).
	CoverUrl                   *string `json:"cover_url,omitempty"`
	Currency                   *string `json:"currency,omitempty"`
	CustomValueCents           *int64  `json:"custom_value_cents,omitempty"`
	CustomValueEnteredCents    *int64  `json:"custom_value_entered_cents,omitempty"`
	CustomValueEnteredCurrency *string `json:"custom_value_entered_currency,omitempty"`

	// Developers Custom entries only; developer company names, one per element (full replacement).
	Developers *[]string `json:"developers,omitempty"`

	// DisplayName Custom entries only (required there).
	DisplayName *string `json:"display_name,omitempty"`

	// Edition Per-copy variant note; the idiom for variants of cataloged items.
	Edition *string `json:"edition,omitempty"`

	// FirstReleaseDate Custom entries only.
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	HasBox           *bool               `json:"has_box,omitempty"`
	HasManual        *bool               `json:"has_manual,omitempty"`
	ItemCondition    *ItemCondition      `json:"item_condition,omitempty"`
	ManualCondition  *ItemCondition      `json:"manual_condition,omitempty"`
	Notes            *string             `json:"notes,omitempty"`
	Packaging        Packaging           `json:"packaging"`
	Pinned           bool                `json:"pinned"`

	// PlatformIgdbId Custom entries only; the canonical platform id from the picker.
	PlatformIgdbId *int64 `json:"platform_igdb_id,omitempty"`

	// PlatformName Custom entries only.
	PlatformName     *string             `json:"platform_name,omitempty"`
	PricePaidCents   *int64              `json:"price_paid_cents,omitempty"`
	PricingMode      PricingMode         `json:"pricing_mode"`
	PricingProductId *openapi_types.UUID `json:"pricing_product_id,omitempty"`

	// ProductId Narrow re-match. Accepted only when the entry is product-backed with pricing_mode auto, its current product is a game with no price mapping, and the new product is a game of the same family (same igdb game and platform); the same id as the entry already has is a no-op. Anything else answers 400 code invalid_product_change; enrichment unreachable answers 502 code enrichment_unavailable and leaves the entry unchanged. Snapshotted display fields stay as they are.
	ProductId *openapi_types.UUID `json:"product_id,omitempty"`

	// Publishers Custom entries only; publisher company names, one per element (full replacement).
	Publishers    *[]string           `json:"publishers,omitempty"`
	PurchasedAt   *openapi_types.Date `json:"purchased_at,omitempty"`
	PurchasedFrom *string             `json:"purchased_from,omitempty"`
	Rating        *int                `json:"rating,omitempty"`

	// Region Entry region. Known values ntsc_u, ntsc_j, pal, region_free, korea, brazil and china are first-class: labeled in the UI, filterable, normalize-lever promotion targets, with release-date chains, availability rows, and localized display snapshots per region (ntsc_u and region_free render the canonical presentation by design). korea, brazil and china have no PriceCharting axis, so they price from base listings as their deliberate proxy. Any other non-empty string is stored verbatim as a display fact and prices like ntsc_u until the value graduates to the known set. On an auto-provenance game entry, a region change repoints the entry to the sibling catalog product whose listing prices that region; snapshotted display fields re-derive from it.
	Region          string                `json:"region"`
	Status          EntryStatus           `json:"status"`
	StorageLocation *string               `json:"storage_location,omitempty"`
	TagIds          *[]openapi_types.UUID `json:"tag_ids,omitempty"`
}

type FXRates struct {
	// Base Always USD.
	Base string `json:"base"`

	// Date Upstream snapshot date (YYYY-MM-DD), not the fetch time.
	Date string `json:"date"`

	// Rates Target-units-per-USD by ISO 4217 code. USD itself is omitted (it is the base; conversion short-circuits).
	Rates map[string]float64 `json:"rates"`
}

type GroupBy string

type Handle = string

type Identities struct {
	Identities []Identity `json:"identities"`
}

type Identity struct {
	CreatedAt time.Time `json:"created_at"`

	// Email Informational; the email the provider asserted when this identity last signed in.
	Email    *string            `json:"email,omitempty"`
	Id       openapi_types.UUID `json:"id"`
	Provider string             `json:"provider"`
}

type IgdbMeta struct {
	Companies []CompanyCredit `json:"companies"`
	CoverUrl  *string         `json:"cover_url,omitempty"`
	FetchedAt time.Time       `json:"fetched_at"`

	// FirstReleaseDate Earliest date for the product's platform; the game-level first release when IGDB lists no dated rows for the platform.
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	Franchises       []string            `json:"franchises"`
	GameId           int64               `json:"game_id"`
	Genres           []string            `json:"genres"`

	// Localizations Per-region presentations; absent both on projections predating the feature and on games with no localizations at all (an empty slice is omitted rather than sent).
	Localizations *[]Localization `json:"localizations,omitempty"`
	Name          string          `json:"name"`

	// ReleaseDates Per-region release dates for the product's platform, the earliest concrete date per region. Region values are canonical IGDB names (europe, north_america, australia, new_zealand, japan, china, asia, worldwide, korea, brazil). JP twin platforms fold into their sibling (SNES/Super Famicom, NES/Famicom).
	ReleaseDates *[]ReleaseDate `json:"release_dates,omitempty"`
	SimilarGames []int64        `json:"similar_games"`
	Themes       []string       `json:"themes"`
}

type ItemCondition string

type ItemType string

type LandingPage string

type LibraryEntry struct {
	IgdbGameId int64 `json:"igdb_game_id"`
	Rating     *int  `json:"rating,omitempty"`

	// Status The caller's own status vocabulary; scoring only distinguishes "dropped".
	Status *string `json:"status,omitempty"`
}

type Localization struct {
	CoverUrl *string `json:"cover_url,omitempty"`
	Name     *string `json:"name,omitempty"`
	Region   string  `json:"region"`
	Translit *string `json:"translit,omitempty"`
}

type MappingRequest struct {
	// PcProductId Null clears the mapping (the product becomes unmatched and held).
	PcProductId *int64 `json:"pc_product_id"`
}

type MediaType string

type NormalizeResult struct {
	Normalized int `json:"normalized"`
	Scanned    int `json:"scanned"`
	Skipped    int `json:"skipped"`
}

type Offset = int

type Order string

type Packaging string

type PlatformCatalog struct {
	Platforms []CatalogPlatform `json:"platforms"`
}

type PlatformCount struct {
	Count int    `json:"count"`
	Name  string `json:"name"`
}

type PlatformId = []int64

type PlatformRef struct {
	IgdbPlatformId int64 `json:"igdb_platform_id"`

	// LogoUrl IGDB platform logo; the display fallback for products without cover art.
	LogoUrl *string `json:"logo_url,omitempty"`
	Name    string  `json:"name"`

	// ReleaseRegions Distinct canonical IGDB release regions for this game on this platform (japan, north_america, europe, ...), ordered by that region's earliest release date on the platform (dateless rows last, then alphabetical). Platform-exact: JP twin platforms are NOT folded here (a Famicom row stays on Famicom), unlike the product projection's date fold - the physical release is platform-specific. Populated on game search results only; absent on product payloads and hardware results.
	ReleaseRegions *[]ReleaseRegion `json:"release_regions,omitempty"`
}

type PricechartingMeta struct {
	AsOf            time.Time `json:"as_of"`
	CibCents        *int64    `json:"cib_cents,omitempty"`
	ConsoleName     string    `json:"console_name"`
	LooseCents      *int64    `json:"loose_cents,omitempty"`
	MatchConfidence float64   `json:"match_confidence"`
	NewCents        *int64    `json:"new_cents,omitempty"`
	PcName          string    `json:"pc_name"`
	PcProductId     int64     `json:"pc_product_id"`
	Verified        bool      `json:"verified"`
}

type PricingMode string

type Problem struct {
	// Code The full house code vocabulary across every service (Problem is shared, and the bff relays upstream codes verbatim).
	Code     *ProblemCode `json:"code,omitempty"`
	Detail   *string      `json:"detail,omitempty"`
	Instance *string      `json:"instance,omitempty"`
	Status   int          `json:"status"`
	Title    string       `json:"title"`
	Type     string       `json:"type"`
}

type ProblemCode string

type Product struct {
	// Community Facts curated at community mint time; retained after promotion as gap-fill (provider blocks win per-field where present).
	Community *CommunityMeta     `json:"community,omitempty"`
	CreatedAt time.Time          `json:"created_at"`
	Edition   *string            `json:"edition,omitempty"`
	Id        openapi_types.UUID `json:"id"`

	// Igdb Projection of the raw IGDB payload held in igdb_raw; refreshed on its own cadence.
	Igdb *IgdbMeta `json:"igdb,omitempty"`

	// MatchHold Present true when an admin clear holds this product's mapping against a future automated match (resolve, or the entry-side re-match).
	MatchHold *bool  `json:"match_hold,omitempty"`
	Name      string `json:"name"`

	// Origin Emitted only for admin-minted community products (absent means provider-identified). Community products live outside the provider identity indexes; their curated name is their identity.
	Origin   *ProductOrigin `json:"origin,omitempty"`
	Platform *PlatformRef   `json:"platform,omitempty"`

	// Pricecharting The PriceCharting mapping and current prices; refreshed daily. Absent from a product when no candidate cleared the match confidence threshold (no guessing) and the mapping has not been corrected by an admin.
	Pricecharting *PricechartingMeta `json:"pricecharting,omitempty"`

	// Region Provider hardware identity fact; community products carry their region under community.region instead.
	Region    *string     `json:"region,omitempty"`
	Type      ProductType `json:"type"`
	UpdatedAt time.Time   `json:"updated_at"`
	Variant   *string     `json:"variant,omitempty"`
}

type ProductOrigin string

type ProductType string

type ProfileCard struct {
	AvatarUrl         *string            `json:"avatar_url,omitempty"`
	Handle            Handle             `json:"handle"`
	ProfileVisibility Visibility         `json:"profile_visibility"`
	UserId            openapi_types.UUID `json:"user_id"`
}

type ProfileSocialSummary struct {
	FollowerCount  int  `json:"follower_count"`
	FollowingCount int  `json:"following_count"`
	ViewerFollows  bool `json:"viewer_follows"`
}

type PromoteCandidate struct {
	FoundAt    time.Time       `json:"found_at"`
	Name       string          `json:"name"`
	Provider   CatalogProvider `json:"provider"`
	ProviderId int64           `json:"provider_id"`
	Score      float64         `json:"score"`
}

type PromoteCandidateProduct struct {
	Candidates []PromoteCandidate `json:"candidates"`
	Product    Product            `json:"product"`
}

type PromoteCandidatesPage struct {
	Products []PromoteCandidateProduct `json:"products"`

	// TotalCount Full count of flagged community products.
	TotalCount int64 `json:"total_count"`
}

type PromoteRequest struct {
	IgdbGameId     *int64 `json:"igdb_game_id,omitempty"`
	PcProductId    *int64 `json:"pc_product_id,omitempty"`
	PlatformIgdbId *int64 `json:"platform_igdb_id,omitempty"`
}

type Providers struct {
	// Providers Subset of: google, twitch, dev
	Providers []string `json:"providers"`
}

type Recommendation struct {
	CoverUrl         *string             `json:"cover_url,omitempty"`
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	Genres           []string            `json:"genres"`
	IgdbGameId       int64               `json:"igdb_game_id"`
	Name             string              `json:"name"`
	Score            float64             `json:"score"`
}

type RefreshAccepted struct {
	Status AcceptedStatus `json:"status"`
}

type ReleaseDate struct {
	Date   openapi_types.Date `json:"date"`
	Region ReleaseRegion      `json:"region"`
}

type ReleaseRegion string

type RematchAccepted struct {
	Status AcceptedStatus `json:"status"`
}

type ReorderRequest struct {
	AfterId  *openapi_types.UUID `json:"after_id,omitempty"`
	BeforeId *openapi_types.UUID `json:"before_id,omitempty"`
}

type ResnapshotResult struct {
	EntriesUpdated int `json:"entries_updated"`
	ProductsFailed int `json:"products_failed"`
	ProductsSeen   int `json:"products_seen"`
}

type ResolveRequest struct {
	Edition        *string `json:"edition,omitempty"`
	IgdbGameId     *int64  `json:"igdb_game_id,omitempty"`
	MatchHint      *string `json:"match_hint,omitempty"`
	PcProductId    *int64  `json:"pc_product_id,omitempty"`
	PlatformIgdbId *int64  `json:"platform_igdb_id,omitempty"`

	// Region For console/accessory: part of hardware identity, distinguishing physical variants. For game: a matching input only - the entry region (ntsc_u, ntsc_j, pal, region_free, korea, brazil, china) steers which PriceCharting listing auto-match lands on (JP and PAL listings live under region-prefixed or JP-named console axes; korea, brazil and china have no provider axis and match like ntsc_u) and is never stored on the product; ignored when pc_product_id is present; unknown values behave like ntsc_u. Ignored for pc_listing.
	Region  *string     `json:"region,omitempty"`
	Type    ProductType `json:"type"`
	Variant *string     `json:"variant,omitempty"`
}

type Role string

type SavedView struct {
	CreatedAt time.Time              `json:"created_at"`
	Id        openapi_types.UUID     `json:"id"`
	Name      string                 `json:"name"`
	Params    map[string]interface{} `json:"params"`

	// PublishedAt Stamped on each transition into listed.
	PublishedAt *time.Time `json:"published_at,omitempty"`

	// Slug URL slug derived from the name (underscore transform); unique per user on its folded key.
	Slug       string     `json:"slug"`
	UpdatedAt  time.Time  `json:"updated_at"`
	Visibility Visibility `json:"visibility"`
}

type ScoreResponse struct {
	// Degraded True when candidate metadata fetches failed and some candidates were skipped.
	Degraded        bool             `json:"degraded"`
	Recommendations []Recommendation `json:"recommendations"`
}

type SearchResult struct {
	Category    *string `json:"category,omitempty"`
	CibCents    *int64  `json:"cib_cents,omitempty"`
	ConsoleName *string `json:"console_name,omitempty"`
	CoverUrl    *string `json:"cover_url,omitempty"`

	// Developers Community rows only - the curated developer names, for based-add prefill.
	Developers       *[]string           `json:"developers,omitempty"`
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	IgdbGameId       *int64              `json:"igdb_game_id,omitempty"`
	ItemType         *ItemType           `json:"item_type,omitempty"`

	// Localizations Per-region presentations of a game result (games only).
	Localizations *[]Localization `json:"localizations,omitempty"`
	LooseCents    *int64          `json:"loose_cents,omitempty"`

	// MatchedRegion Set when the query matched a region's localized name or transliteration rather than the canonical name: that bundle's region identifier. Clients may present the region's data and preselect a matching entry region. Absent on canonical-name matches, hardware, pc_listing, and community results.
	MatchedRegion *string `json:"matched_region,omitempty"`
	Name          string  `json:"name"`
	NewCents      *int64  `json:"new_cents,omitempty"`

	// Origin Marks an interleaved community result (admin-minted, anchor-less); absent on provider results. Community results carry product_id + item_type + platform_name for the pick, community.cover_url as cover_url, and community.region as region. They are scored against the query by name similarity and merged into results by descending score (a provider result precedes a community result of equal score), capped at 10, for game and hardware searches only (never pc_listing). The provider cache stores provider results only - community items attach fresh on every search.
	Origin       *ProductOrigin      `json:"origin,omitempty"`
	PcProductId  *int64              `json:"pc_product_id,omitempty"`
	PlatformName *string             `json:"platform_name,omitempty"`
	Platforms    *[]PlatformRef      `json:"platforms,omitempty"`
	ProductId    *openapi_types.UUID `json:"product_id,omitempty"`

	// Publishers Community rows only - the curated publisher names, for based-add prefill.
	Publishers *[]string `json:"publishers,omitempty"`

	// Region Community rows only - the community facts region, entry vocabulary.
	Region *string          `json:"region,omitempty"`
	Type   SearchResultType `json:"type"`
}

type SearchResultType string

type SearchResults struct {
	// Degraded True when the provider was unreachable and the local catalog answered instead.
	Degraded bool           `json:"degraded"`
	Results  []SearchResult `json:"results"`
}

type SharedEntry struct {
	BoxCondition     *ItemCondition      `json:"box_condition,omitempty"`
	CoverUrl         *string             `json:"cover_url,omitempty"`
	CreatedAt        time.Time           `json:"created_at"`
	Developers       *[]string           `json:"developers,omitempty"`
	DisplayName      string              `json:"display_name"`
	Edition          *string             `json:"edition,omitempty"`
	FirstReleaseDate *openapi_types.Date `json:"first_release_date,omitempty"`
	HasBox           bool                `json:"has_box"`
	HasManual        bool                `json:"has_manual"`
	Id               openapi_types.UUID  `json:"id"`
	IgdbGameId       *int64              `json:"igdb_game_id,omitempty"`
	ItemCondition    *ItemCondition      `json:"item_condition,omitempty"`
	ItemType         ItemType            `json:"item_type"`

	// LocalizedCoverUrl Region-picked box art URL (server-derived).
	LocalizedCoverUrl *string `json:"localized_cover_url,omitempty"`

	// LocalizedName Region-picked native-script title (server-derived from the entry's region; absent when the region has none).
	LocalizedName *string `json:"localized_name,omitempty"`

	// LocalizedNameTranslit Latin transliteration of localized_name's title (server-derived).
	LocalizedNameTranslit *string        `json:"localized_name_translit,omitempty"`
	ManualCondition       *ItemCondition `json:"manual_condition,omitempty"`
	MediaType             MediaType      `json:"media_type"`
	Packaging             Packaging      `json:"packaging"`
	Pinned                bool           `json:"pinned"`

	// Platform The entry's platform: a creation-time snapshot of the product's platform (both fields) on product-backed entries, or a user-supplied platform on custom entries - both fields when picked from the catalog or normalized by the admin lever, name-only for escape-hatch free text. Absent when neither exists.
	Platform   *EntryPlatform      `json:"platform,omitempty"`
	ProductId  *openapi_types.UUID `json:"product_id,omitempty"`
	Publishers *[]string           `json:"publishers,omitempty"`
	Region     string              `json:"region"`
	Tags       []TagRef            `json:"tags"`
}

type SharedEntryGroup struct {
	Entries []SharedEntry `json:"entries"`
	Key     string        `json:"key"`
	Label   string        `json:"label"`
}

type SharedEntryList struct {
	Entries    *[]SharedEntry      `json:"entries,omitempty"`
	Groups     *[]SharedEntryGroup `json:"groups,omitempty"`
	TotalCount int                 `json:"total_count"`
}

type ShelfSocialSummary struct {
	// CommentCount Live comments only.
	CommentCount int                `json:"comment_count"`
	LikeCount    int                `json:"like_count"`
	ShelfId      openapi_types.UUID `json:"shelf_id"`
	ViewerLikes  bool               `json:"viewer_likes"`
}

type StatusFilter = []EntryStatus

type Submission struct {
	CreatedAt    time.Time           `json:"created_at"`
	EntryId      openapi_types.UUID  `json:"entry_id"`
	Id           openapi_types.UUID  `json:"id"`
	ProductId    *openapi_types.UUID `json:"product_id,omitempty"`
	RejectReason *string             `json:"reject_reason,omitempty"`

	// ResolutionAckAt When the submitter acknowledged an approved verdict (closed the approval banner). Absent until acknowledged.
	ResolutionAckAt *time.Time       `json:"resolution_ack_at,omitempty"`
	ReviewedAt      *time.Time       `json:"reviewed_at,omitempty"`
	Status          SubmissionStatus `json:"status"`
	UpdatedAt       time.Time        `json:"updated_at"`
}

type SubmissionStatus string

type Tab string

type Tag struct {
	EntryCount int                `json:"entry_count"`
	Id         openapi_types.UUID `json:"id"`
	Name       string             `json:"name"`
}

type TagCreate struct {
	Name string `json:"name"`
}

type TagRef struct {
	Id   openapi_types.UUID `json:"id"`
	Name string             `json:"name"`
}

type UnmatchedProductsPage struct {
	Products []Product `json:"products"`

	// TotalCount Full count of unmatched products, beyond this page.
	TotalCount int64 `json:"total_count"`
}

type UserSearchQ = string

type ValueHistory struct {
	// Available False when enrichment was unreachable; points is then empty.
	Available bool         `json:"available"`
	Points    []ValuePoint `json:"points"`
}

type ValuePoint struct {
	Date       openapi_types.Date `json:"date"`
	ValueCents int64              `json:"value_cents"`
}

type VerdictRequest struct {
	Action VerdictRequestAction `json:"action"`

	// Product The curated fields for approve_new; mirrors the enrichment mint request (single edition field, no variant).
	Product   *CommunityProductSpec `json:"product,omitempty"`
	ProductId *openapi_types.UUID   `json:"product_id,omitempty"`
	Reason    *string               `json:"reason,omitempty"`
}

type VerdictRequestAction string

type ViewCreate struct {
	Name string `json:"name"`

	// Params Opaque frontend view state; at most 8192 marshaled bytes.
	Params     map[string]interface{} `json:"params"`
	Visibility *Visibility            `json:"visibility,omitempty"`
}

type Visibility string