fetch

type Booster struct {
	// ReleaseCode is the first set of characters following the / in the card
	// number. See Card.Release for more information.
	ReleaseCode string
	Cards       []Card
}

type Card struct {
	// CardNumber is the full card number/code used to identify each card.
	// It typically consists of the SetID, Side, Release, ReleasePackID, and ID,
	// though the format is different in some situations.
	CardNumber string `json:"cardNumber"`
	// SetID is the alphanumeric string found at the beginning of card numbers,
	// before the "/"".
	SetID string `json:"setId"`
	// SetName is the official name of the set/IP.
	// It is currently unset by the scraper and is reserved for when the websites
	// expose one or the scraper is updated to find it.
	SetName string `json:"setName"`
	// ExpansionName is the normalized product/expansion title shown on card pages
	// (eg. "Love Live! Vol.2"). This may differ from the product page title.
	ExpansionName string `json:"expansionName"`
	// ExpansionSlug is the official product slug for normal releases when available.
	// Promo cards use a best-effort code from promo metadata, with ReleasePackID as
	// a fallback when the listing doesn't expose one.
	ExpansionSlug string `json:"expansionSlug"`
	// ExpansionProductDisplayName is the product page title for normal releases or
	// the specific promo group/distribution name from the promo listing.
	ExpansionProductDisplayName string `json:"expansionProductDisplayName"`
	// ExpansionProductURL is the product page URL when the card page links to one.
	ExpansionProductURL string `json:"expansionProductURL,omitempty"`
	// ExpansionSourceType indicates whether the richer expansion metadata came from
	// a linked product page or an official promo listing.
	ExpansionSourceType ExpansionSourceType `json:"expansionSourceType"`
	// Sides contains the card's side ("W" for Weiss, "S" for Schwarz).
	// Some cards are dual-sided (eg. Gso/WS02-124SP and Gso/WS02-E124SP).
	Sides []Side `json:"sides,omitempty"`
	// Release typically consists of the card's side, followed by a number
	// (the release pack ID) indicating which consecutive release for the relative
	// side the release is.
	// For example, "W64" would mean the 64th set of the Weiss side.
	// There are certain situations that don't follow the aforementioned format,
	// such as with promo cards (eg. BSF2024) or special sets (eg. EN-W03).
	Release string `json:"release"`
	// ReleasePackID indicates which consecutive release for the relative
	// side the release is.
	// For example, "W64" would mean the 64th set of the Weiss side.
	// For cards with non-standard release codes, a best-effort/most sensible
	// ID is chosen (eg. 2021 from BSL2021). This may be empty if there's
	// no sensible ID to choose (eg. from TCPR-P01).
	ReleasePackID string `json:"releasePackId"`
	// ID of the card within the set+release. This is usually the last part
	// of the card number (after the -).
	ID string `json:"id"`
	// Language the card is printed in.
	Language string `json:"language"`

	// Type can be either "CH" for character, "EV" for event, or "CX" for climax.
	Type CardType `json:"type"`

	// Name of the card.
	Name string `json:"name"`
	// Color of the card. Should be either "BLUE", "GREEN", "RED", or "YELLOW".
	// ...Except for the two purple cards (むらさきパプリス(PY/S38-125) and むらさきぷよ(PY/S38-120)).
	Color CardColor `json:"color"`
	// Stock cost to play the card.
	Cost *int `json:"cost,omitempty"`
	// Level required in order to play the card.
	Level *int `json:"level,omitempty"`
	// Power indicates the card's battle strength. Only valid for Character cards.
	Power *int `json:"power,omitempty"`
	// Soul indicates how many soul points the card has. Only valid for Character cards.
	Soul *int `json:"soul,omitempty"`
	// Text describing the card's abilities.
	Text []string `json:"text"`
	// Traits indicating the attributes the card has. These are often referenced in card text.
	Traits []string `json:"traits,omitempty"`
	// Triggers that the card has and are activated during trigger checks.
	Triggers []Trigger `json:"triggers,omitempty"`
	// ParseFailures captures non-fatal parsing issues where the remaining card data
	// still looked trustworthy enough to keep.
	ParseFailures []string `json:"parseFailures,omitempty"`

	FlavorText string      `json:"flavorText,omitempty"`
	ImageURL   string      `json:"imageURL"`
	Image      image.Image `json:"-"`
	Rarity     string      `json:"rarity"`
}

type CardColor string

type CardType string

type Client struct {
	// contains filtered or unexported fields
}

type Config struct {
	// The website's internal code for each expansion. The value is language-specific.
	// For example,
	//   159 is "BanG Dream! Girls Band Party Premium Booster" in EN
	//   159 is "Monogatari Series: Second Season"
	ExpansionNumber int
	GetAllRarities  bool
	GetImages       bool
	GetRecent       bool
	Language        SiteLanguage
	PageStart       int
	Reverse         bool
	SetCode         []string
	// The website's internal code for each set. The value is language-specific.
	// For example
	//   159 is "Tokyo Revengers" in EN
	//   159 isn't supported in JP
	TitleNumber int
}

type DeckRules struct {
	TitleDeckGroups     []TitleDeckGroup              `json:"titleDeckGroups"`
	FreeFloaters        []FreeFloaterGroup            `json:"freeFloaters,omitempty"`
	RestrictionsByGroup map[string][]RestrictionGroup `json:"restrictionsByGroup,omitempty"`
}

type DeckRulesConfig struct {
	// Language selects which official site to parse.
	Language SiteLanguage
}

type ExpansionSourceType string

type FreeFloaterGroup struct {
	Label          string            `json:"label"`
	Cards          []RestrictionCard `json:"cards"`
	Notes          []string          `json:"notes,omitempty"`
	SourceLanguage string            `json:"sourceLanguage"`
	SourceURL      string            `json:"sourceURL"`
}

type Option func(*Client) error

type ProductInfo struct {
	ReleaseDate string
	Title       string
	LicenceCode string
	Image       string
	SetCode     string
}

type RestrictionCard struct {
	Name        string   `json:"name"`
	CardNumbers []string `json:"cardNumbers"`
	IsNew       bool     `json:"isNew,omitempty"`
}

type RestrictionGroup struct {
	// Type is the normalized restriction category.
	Type RestrictionType `json:"type"`
	// Label preserves the original restriction label text from the source page.
	Label string `json:"label"`
	// Updated reports whether the source label marked this rule as updated.
	Updated bool `json:"updated,omitempty"`
	// MaxCopies is the maximum number of copies allowed by this rule, when one
	// is explicitly defined.
	MaxCopies int `json:"maxCopies,omitempty"`
	// ChooseOneOf is the size of a choice-restriction set, when specified.
	ChooseOneOf int `json:"chooseOneOf,omitempty"`
	// Cards are the card entries covered by this rule.
	Cards []RestrictionCard `json:"cards"`
	// Notes contains parser-preserved notes attached to this rule.
	Notes []string `json:"notes,omitempty"`
	// SourceLanguage identifies which language site the rule was parsed from.
	SourceLanguage string `json:"sourceLanguage"`
	// SourceURL is the rules page that produced this rule.
	SourceURL string `json:"sourceURL"`
}

type RestrictionType string

type Side string

type SiteLanguage language.Tag

type TitleDeckGroup struct {
	// CanonicalName is the normalized title family name for this group.
	CanonicalName string `json:"canonicalName"`
	// Side is the side this group belongs to: "W" for Weiss or "S" for Schwarz.
	Side Side `json:"side"`
	// AllowedCodes are the set/title codes that may be used in this group.
	AllowedCodes []string `json:"allowedCodes"`
	// Aliases contains alternate labels for the same title family.
	Aliases []string `json:"aliases"`
	// SourceLanguage identifies which language site the row was parsed from.
	SourceLanguage string `json:"sourceLanguage"`
	// SourceTitle preserves the original title text from the source row.
	SourceTitle string `json:"sourceTitle"`
	// SourceURL is the rules page that produced this group.
	SourceURL string `json:"sourceURL"`
	// Notes contains parser-preserved context from the source row when useful,
	// such as side-selection notes from the Japanese rules page.
	Notes []string `json:"notes,omitempty"`
}

type Trigger string