tcgpriser 0.13.0 → 1.1.0

package/dist/index.d.cts

@@ -140,6 +140,11 @@ interface components {
             name: string;
             /** @example pokemon */
             technicalName: string;
+            /**
+             * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            imageUrl: string | undefined;
             /**
              * Format: date-time
              * @example 2026-07-15T12:03:29.322Z
@@ -162,6 +167,8 @@ interface components {
             technicalName: string;
             brand: components["schemas"]["Brand"];
             manufacturer: string;
+            /** @enum {string} */
+            productLine: "tcg" | "accessory" | "collectible" | "boardGame" | "videoGame" | "other";
             modelNumber: string | undefined;
             category: components["schemas"]["CategoryRef"] | undefined;
             expansion: components["schemas"]["ExpansionRef"] | undefined;
@@ -170,7 +177,7 @@ interface components {
              * @example JPN
              * @enum {string|null}
              */
-            language: "ENG" | "JPN" | "CHI" | undefined;
+            language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS" | undefined;
             alternativeNames: components["schemas"]["AlternativeName"][];
             supportsMultipackPricing: boolean;
             /**
@@ -297,18 +304,32 @@ interface components {
             shortName: string;
             /** @example jpn-mega-evolution-30th-celebration */
             technicalName: string;
+            brand: components["schemas"]["Brand"];
             /**
              * @description Printing language of the item
              * @example JPN
              * @enum {string}
              */
-            language: "ENG" | "JPN" | "CHI";
+            language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS";
             /** @example m6a */
             code: string | undefined;
             /** @example m6a */
             cardCode: string | undefined;
             /** @example Mega Evolution */
             seriesName: string | undefined;
+            /** @example The Lord of the Rings: Tales of Middle-earth */
+            releaseGroupName: string | undefined;
+            releaseGroup: {
+                /**
+                 * @description Resource identifier
+                 * @example 6a577711abc1ce71383d3e10
+                 */
+                id: string;
+                /** @example The Lord of the Rings: Tales of Middle-earth */
+                name: string;
+                /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
+                technicalName: string;
+            } | undefined;
             /**
              * Format: date-time
              * @example 2026-07-15T12:03:29.322Z
@@ -330,7 +351,6 @@ interface components {
              */
             imageUrl: string | undefined;
             year: number | undefined;
-            brand: components["schemas"]["Brand"];
             alternativeNames: components["schemas"]["AlternativeName"][];
             /** @description Sealed products in this expansion */
             sealedCount: number;
@@ -367,18 +387,32 @@ interface components {
             shortName: string;
             /** @example jpn-mega-evolution-30th-celebration */
             technicalName: string;
+            brand: components["schemas"]["Brand"] | undefined;
             /**
              * @description Printing language of the item
              * @example JPN
              * @enum {string}
              */
-            language: "ENG" | "JPN" | "CHI";
+            language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS";
             /** @example m6a */
             code: string | undefined;
             /** @example m6a */
             cardCode: string | undefined;
             /** @example Mega Evolution */
             seriesName: string | undefined;
+            /** @example The Lord of the Rings: Tales of Middle-earth */
+            releaseGroupName: string | undefined;
+            releaseGroup: {
+                /**
+                 * @description Resource identifier
+                 * @example 6a577711abc1ce71383d3e10
+                 */
+                id: string;
+                /** @example The Lord of the Rings: Tales of Middle-earth */
+                name: string;
+                /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
+                technicalName: string;
+            } | undefined;
             /**
              * Format: date-time
              * @example 2026-07-15T12:03:29.322Z
@@ -400,6 +434,10 @@ interface components {
              */
             imageUrl: string | undefined;
         };
+        ExpansionReleaseGroup: {
+            releaseGroupName: string | undefined;
+            expansions: components["schemas"]["Expansion"][];
+        };
         ItemDailyStats: {
             item: components["schemas"]["CatalogItemRef"];
             dailyStats: components["schemas"]["DailyPricePoint"][];
@@ -638,6 +676,8 @@ interface components {
             technicalName: string;
             brand: components["schemas"]["Brand"];
             manufacturer: string;
+            /** @enum {string} */
+            productLine: "tcg" | "accessory" | "collectible" | "boardGame" | "videoGame" | "other";
             modelNumber: string | undefined;
             category: components["schemas"]["CategoryRef"] | undefined;
             expansion: components["schemas"]["ExpansionRef"] | undefined;
@@ -646,7 +686,7 @@ interface components {
              * @example JPN
              * @enum {string|null}
              */
-            language: "ENG" | "JPN" | "CHI" | undefined;
+            language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS" | undefined;
             alternativeNames: components["schemas"]["AlternativeName"][];
             supportsMultipackPricing: boolean;
             /**
@@ -675,11 +715,11 @@ interface components {
         };
         ReferencePriceSeries: {
             /** @enum {string} */
-            source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker";
+            source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker" | "scryfall";
             /** @enum {string} */
             provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
             /** @enum {string|null} */
-            variant: "normal" | "holo" | "reverse" | undefined;
+            variant: "normal" | "holo" | "reverse" | "foil" | undefined;
             /** @enum {string|null} */
             cardType: "loose" | "graded" | undefined;
             /** @enum {string|null} */
@@ -1209,6 +1249,8 @@ type CardSchema = {
     technicalName: string;
     brand: BrandRef;
     manufacturer: string;
+    /** @enum {string} */
+    productLine: "tcg" | "accessory" | "collectible" | "boardGame" | "videoGame" | "other";
     modelNumber: string | undefined;
     category: CategoryRef | undefined;
     expansion: ExpansionRef | undefined;
@@ -1217,7 +1259,7 @@ type CardSchema = {
      * @example JPN
      * @enum {string|null}
      */
-    language: "ENG" | "JPN" | "CHI" | undefined;
+    language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS" | undefined;
     alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
@@ -1285,7 +1327,13 @@ type ResourceId = string;
 type CurrencyCode = string;
 /** ISO 8601 timestamp, as returned by the API (always UTC, `Z`-suffixed). */
 type Timestamp = string;
-type PrintingLanguage = "ENG" | "JPN" | "CHI";
+type PrintingLanguage = "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS";
+/** What universe of product an item is — `'tcg'` for every card and sealed product today, plus
+ * `'accessory'`/`'collectible'`/`'boardGame'`/`'videoGame'`/`'other'` for non-TCG catalogue items.
+ * Orthogonal to `kind` (which endpoint returned it: `cards` vs `products`) and to `category` (the
+ * specific group within a product line, e.g. "Booster Box"). The value `productLine` filters on
+ * `cards.list()`/`products.list()` accept. */
+type ProductLine = "tcg" | "accessory" | "collectible" | "boardGame" | "videoGame" | "other";
 type PageMeta = {
     /** @description Total matching records, ignoring pagination */
     total: number;
@@ -1330,6 +1378,11 @@ type BrandRef = {
     name: string;
     /** @example pokemon */
     technicalName: string;
+    /**
+     * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    imageUrl: string | undefined;
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -1352,8 +1405,9 @@ type CategoryRef = {
     /** @example booster-box */
     technicalName: string;
 };
-/** The expansion shape embedded on cards, products and pack rates. Not the full `Expansion`
- * returned by `client.expansions.list()`, which additionally carries counts and a `brand`. */
+/** The expansion shape embedded on cards, products and pack rates, and returned by
+ * `client.expansions.get()`. It includes the owning `brand`, but not the aggregation counts that
+ * only `client.expansions.list()` computes. */
 type ExpansionRef = {
     /**
      * @description Resource identifier
@@ -1366,18 +1420,32 @@ type ExpansionRef = {
     shortName: string;
     /** @example jpn-mega-evolution-30th-celebration */
     technicalName: string;
+    brand: BrandRef | undefined;
     /**
      * @description Printing language of the item
      * @example JPN
      * @enum {string}
      */
-    language: "ENG" | "JPN" | "CHI";
+    language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS";
     /** @example m6a */
     code: string | undefined;
     /** @example m6a */
     cardCode: string | undefined;
     /** @example Mega Evolution */
     seriesName: string | undefined;
+    /** @example The Lord of the Rings: Tales of Middle-earth */
+    releaseGroupName: string | undefined;
+    releaseGroup: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example The Lord of the Rings: Tales of Middle-earth */
+        name: string;
+        /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
+        technicalName: string;
+    } | undefined;
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -1439,6 +1507,39 @@ type ReferencePriceSnapshot = {
 type ReferencePriceProvider = "tradera" | "cardmarket" | "tcgplayer" | "ebay";
 /** Keyed by provider, at most one snapshot per provider. */
 type ReferencePriceSnapshotsByProvider = Partial<Record<ReferencePriceProvider, ReferencePriceSnapshot>>;
+/** A brand/franchise (e.g. "Pokémon"), as returned by `client.brands.list()` /
+ * `client.brands.get()`. Same shape as `BrandRef` (the form embedded on `Card`/`SealedProduct`/
+ * `Expansion`) today — kept as its own named type for symmetry with `Shop`/`ShopRef` and
+ * `Expansion`/`ExpansionRef`, in case the two diverge later. `imageUrl` is the CDN-hosted brand
+ * mark when one has been uploaded. This is the value `brand` filters on
+ * `cards.list()`, `products.list()` and `expansions.list()` accept (either `id` or
+ * `technicalName`). */
+type Brand = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    /** @example Pokémon */
+    name: string;
+    /** @example pokemon */
+    technicalName: string;
+    /**
+     * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    imageUrl: string | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    createdAt: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    updatedAt: string;
+};
 /** A card, as returned by `client.cards.get()` / `client.cards.list()`, and as embedded in
  * `client.expansions.cards()`. `kind: 'card'` is a literal on the generated type, which is what
  * makes `CatalogItem` (below) discriminate cleanly. Content only — no pricing fields; fetch those
@@ -1454,6 +1555,8 @@ type Card = {
     technicalName: string;
     brand: BrandRef;
     manufacturer: string;
+    /** @enum {string} */
+    productLine: "tcg" | "accessory" | "collectible" | "boardGame" | "videoGame" | "other";
     modelNumber: string | undefined;
     category: CategoryRef | undefined;
     expansion: ExpansionRef | undefined;
@@ -1462,7 +1565,7 @@ type Card = {
      * @example JPN
      * @enum {string|null}
      */
-    language: "ENG" | "JPN" | "CHI" | undefined;
+    language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS" | undefined;
     alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
@@ -1508,6 +1611,8 @@ type SealedProduct = {
     technicalName: string;
     brand: BrandRef;
     manufacturer: string;
+    /** @enum {string} */
+    productLine: "tcg" | "accessory" | "collectible" | "boardGame" | "videoGame" | "other";
     modelNumber: string | undefined;
     category: CategoryRef | undefined;
     expansion: ExpansionRef | undefined;
@@ -1516,7 +1621,7 @@ type SealedProduct = {
      * @example JPN
      * @enum {string|null}
      */
-    language: "ENG" | "JPN" | "CHI" | undefined;
+    language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS" | undefined;
     alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
@@ -1678,7 +1783,7 @@ type BargainProductRef = {
 /** A set/expansion, as returned by `client.expansions.list()`. This is the full record, including
  * the `sealedCount`/`cardCount`/`productCount` aggregation `list()` runs. The `expansion` field
  * embedded on a card or product, and the result of `client.expansions.get()`, are the smaller
- * `ExpansionRef` from `types/common.ts` instead. */
+ * `ExpansionRef` from `types/common.ts` instead; both shapes include the owning `brand`. */
 type Expansion = {
     /**
      * @description Resource identifier
@@ -1691,18 +1796,32 @@ type Expansion = {
     shortName: string;
     /** @example jpn-mega-evolution-30th-celebration */
     technicalName: string;
+    brand: BrandRef;
     /**
      * @description Printing language of the item
      * @example JPN
      * @enum {string}
      */
-    language: "ENG" | "JPN" | "CHI";
+    language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS";
     /** @example m6a */
     code: string | undefined;
     /** @example m6a */
     cardCode: string | undefined;
     /** @example Mega Evolution */
     seriesName: string | undefined;
+    /** @example The Lord of the Rings: Tales of Middle-earth */
+    releaseGroupName: string | undefined;
+    releaseGroup: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example The Lord of the Rings: Tales of Middle-earth */
+        name: string;
+        /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
+        technicalName: string;
+    } | undefined;
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -1724,7 +1843,6 @@ type Expansion = {
      */
     imageUrl: string | undefined;
     year: number | undefined;
-    brand: BrandRef;
     alternativeNames: AlternativeName[];
     /** @description Sealed products in this expansion */
     sealedCount: number;
@@ -1743,6 +1861,13 @@ type Expansion = {
      */
     updatedAt: string;
 };
+/** `client.expansions.releaseGroup()`: the other expansions in a release group (e.g. a core set's
+ * variant drops), excluding the requested expansion itself. Empty `expansions` and undefined
+ * `releaseGroupName` when the expansion isn't part of a release group. */
+type ExpansionReleaseGroup = {
+    releaseGroupName: string | undefined;
+    expansions: Expansion[];
+};
 type ShopMatchWithItemSchema = {
     /**
      * @description Resource identifier
@@ -2114,11 +2239,11 @@ type PlatformStats = {
  */
 type ReferencePriceSeries = {
     /** @enum {string} */
-    source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker";
+    source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker" | "scryfall";
     /** @enum {string} */
     provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
     /** @enum {string|null} */
-    variant: "normal" | "holo" | "reverse" | undefined;
+    variant: "normal" | "holo" | "reverse" | "foil" | undefined;
     /** @enum {string|null} */
     cardType: "loose" | "graded" | undefined;
     /** @enum {string|null} */
@@ -2136,8 +2261,8 @@ type ReferencePriceSeriesPoint = {
     snapshotDate: string;
     price: number;
 };
-type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi" | "pokemonpricetracker";
-type ReferencePriceCardVariant = "reverse" | "normal" | "holo";
+type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi" | "pokemonpricetracker" | "scryfall";
+type ReferencePriceCardVariant = "reverse" | "normal" | "holo" | "foil";
 type ReferencePriceMetric = "price" | "low" | "mid" | "high" | "avg" | "avg1" | "avg7" | "avg30" | "directLow";
 type ReferencePriceCurrencyMode = "native" | "sek";
 /** Response of `client.cards.referencePrices()` / `client.products.referencePrices()`.
@@ -2243,6 +2368,8 @@ type StatsItemRef = {
     technicalName: string;
     brand: BrandRef;
     manufacturer: string;
+    /** @enum {string} */
+    productLine: "tcg" | "accessory" | "collectible" | "boardGame" | "videoGame" | "other";
     modelNumber: string | undefined;
     category: CategoryRef | undefined;
     expansion: ExpansionRef | undefined;
@@ -2251,7 +2378,7 @@ type StatsItemRef = {
      * @example JPN
      * @enum {string|null}
      */
-    language: "ENG" | "JPN" | "CHI" | undefined;
+    language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS" | undefined;
     alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
@@ -2292,6 +2419,8 @@ type StatsItemRef = {
     technicalName: string;
     brand: BrandRef;
     manufacturer: string;
+    /** @enum {string} */
+    productLine: "tcg" | "accessory" | "collectible" | "boardGame" | "videoGame" | "other";
     modelNumber: string | undefined;
     category: CategoryRef | undefined;
     expansion: ExpansionRef | undefined;
@@ -2300,7 +2429,7 @@ type StatsItemRef = {
      * @example JPN
      * @enum {string|null}
      */
-    language: "ENG" | "JPN" | "CHI" | undefined;
+    language: "ENG" | "JPN" | "CHI" | "KOR" | "SPA" | "GER" | "FRA" | "ITA" | "POR" | "RUS" | undefined;
     alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
@@ -2650,7 +2779,28 @@ declare class BargainsResource {
      * threshold, card condition/grade, free-text search). Premium. */
     search(params?: SearchBargainsParams): Promise<ListResponse<Bargain>>;
 }
+/** The franchises and makers the catalogue carries — what `brand` filters on `cards.list()`,
+ * `products.list()` and `expansions.list()` accept. Read-only: brand rows are rare and deliberate
+ * on the API side, so there is no create/update method here. */
+declare class BrandsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** `GET /brands`: every brand. Unwrapped to a plain array, nothing to paginate here — same
+     * shape as `expansions.list()`/`shops.list()`. */
+    list(options?: RequestOptions): Promise<Brand[]>;
+    /** `GET /brands/{id}`: fetch one brand by its id or technicalName. */
+    get(idOrTechnicalName: string, options?: RequestOptions): Promise<Brand>;
+}
 interface ListCardsParams extends PaginationParams {
+    /** Brand `id` or technicalName, e.g. `'pokemon'`. Scopes the listing to one game/universe. An
+     * unrecognized value is a 400, not an empty page. */
+    brand?: string;
+    productLine?: ProductLine;
+}
+interface GetCardParams extends RequestOptions {
+    /** Brand `id` or technicalName. Disambiguates a `technicalName` two brands both happen to use —
+     * irrelevant while the catalogue carries only one brand, and unused for an `id` lookup. */
+    brand?: string;
 }
 interface SearchCardsParams extends PaginationParams {
     /** Free-text search over card and set names. */
@@ -2691,6 +2841,11 @@ interface CardDailyStatsParams extends RequestOptions {
     categoryId?: string;
     /** Expansion id (ObjectId), an alternative to `expansion`. */
     expansionId?: string;
+    /** Brand technicalName. */
+    brand?: string;
+    /** Brand id (ObjectId), an alternative to `brand`. */
+    brandId?: string;
+    productLine?: ProductLine;
 }
 /** Filters for `cards.estimatedValues()`. Note `page`/`limit`, not the `limit`/`skip` the rest of
  * the API paginates with — this endpoint predates that convention. */
@@ -2703,6 +2858,11 @@ interface CardEstimatedValuesParams extends RequestOptions {
     category?: string;
     /** Expansion technicalName. */
     expansion?: string;
+    /** Brand technicalName. */
+    brand?: string;
+    /** Brand id (ObjectId), an alternative to `brand`. */
+    brandId?: string;
+    productLine?: ProductLine;
 }
 declare class CardsResource {
     private readonly http;
@@ -2711,8 +2871,9 @@ declare class CardsResource {
     list(params?: ListCardsParams): Promise<ListResponse<Card>>;
     /** `GET /cards/search`: like `list()`, but with free-text search on card and set names. Premium. */
     search(params?: SearchCardsParams): Promise<ListResponse<Card>>;
-    /** `GET /cards/{id}`: fetch one card by its id or technicalName. */
-    get(idOrTechnicalName: string, options?: RequestOptions): Promise<Card>;
+    /** `GET /cards/{id}`: fetch one card by its id or technicalName. Pass `brand` if two brands
+     * might share the same technicalName — see `GetCardParams`. */
+    get(idOrTechnicalName: string, params?: GetCardParams): Promise<Card>;
     /** `GET /cards/{id}/matches`: current shop listings matched to this card (latest per shop). */
     matches(idOrTechnicalName: string, params?: CardMatchesParams): Promise<ItemShopMatches>;
     /** `GET /cards/{id}/reference-prices`: Cardmarket/TCGplayer/eBay/Tradera price history. Premium. */
@@ -2746,11 +2907,16 @@ declare class CardsResource {
      * card-scoped counterpart to `client.priceStats.estimatedValues()`. */
     estimatedValues(params?: CardEstimatedValuesParams): Promise<ListResponse<ItemEstimatedValue>>;
 }
+interface ListExpansionsParams extends RequestOptions {
+    /** Brand `id` or technicalName, e.g. `'pokemon'`. An unrecognized value is a 400, not an empty
+     * list. */
+    brand?: string;
+}
 declare class ExpansionsResource {
     private readonly http;
     constructor(http: HttpClient);
     /** `GET /expansions`: every expansion. Unwrapped to a plain array, nothing to paginate here. */
-    list(options?: RequestOptions): Promise<Expansion[]>;
+    list(params?: ListExpansionsParams): Promise<Expansion[]>;
     /** `GET /expansions/{technicalName}`: metadata only — no cards or sealed products. Returns the
      * smaller `ExpansionRef`, not the full `Expansion`: this is a plain lookup by technicalName, not
      * the aggregation `list()` runs, so `sealedCount`/`cardCount`/`productCount` aren't available
@@ -2761,6 +2927,9 @@ declare class ExpansionsResource {
      * pricing too. Sealed products are a separate call — see `sealedProducts()` — never merged into
      * this one. */
     cards(technicalName: string, options?: RequestOptions): Promise<ListResponse<Card>>;
+    /** `GET /expansions/{technicalName}/release-group`: the other expansions in this expansion's
+     * release group (e.g. a core set's variant drops), excluding the requested expansion itself. */
+    releaseGroup(technicalName: string, options?: RequestOptions): Promise<ExpansionReleaseGroup>;
     /** `GET /expansions/{technicalName}/products`: every sealed product in this expansion. Content
      * only, no pricing fields — pass the `id`s from the result to `client.products.pricingBatch()`
      * if you need pricing too. Cards are a separate call — see `cards()` — never merged into this
@@ -2793,6 +2962,11 @@ interface ProductFilterParams extends RequestOptions {
     category?: string;
     /** Expansion technicalName. */
     expansion?: string;
+    /** Brand technicalName. */
+    brand?: string;
+    /** Brand id (ObjectId), an alternative to `brand`. */
+    brandId?: string;
+    productLine?: ProductLine;
 }
 interface DailyPriceStatsParams extends ProductFilterParams {
     /** `YYYY-MM-DD` */
@@ -2864,6 +3038,15 @@ declare class PriceStatsResource {
     productDailyByVariant(idOrTechnicalName: string, params: ProductDailyByVariantParams): Promise<ItemVariantDailyStats>;
 }
 interface ListProductsParams extends PaginationParams {
+    /** Brand `id` or technicalName, e.g. `'pokemon'`. Scopes the listing to one game/universe. An
+     * unrecognized value is a 400, not an empty page. */
+    brand?: string;
+    productLine?: ProductLine;
+}
+interface GetProductParams extends RequestOptions {
+    /** Brand `id` or technicalName. Disambiguates a `technicalName` two brands both happen to use —
+     * irrelevant while the catalogue carries only one brand, and unused for an `id` lookup. */
+    brand?: string;
 }
 interface SearchProductsParams extends PaginationParams {
     /** Whitespace-separated tokens, each matched against the start of a word. */
@@ -2907,6 +3090,11 @@ interface ProductDailyPriceStatsParams extends RequestOptions {
     categoryId?: string;
     /** Expansion id (ObjectId), an alternative to `expansion`. */
     expansionId?: string;
+    /** Brand technicalName. */
+    brand?: string;
+    /** Brand id (ObjectId), an alternative to `brand`. */
+    brandId?: string;
+    productLine?: ProductLine;
 }
 /** Filters for `products.estimatedValues()`. Note `page`/`limit`, not the `limit`/`skip` the rest
  * of the API paginates with — this endpoint predates that convention. */
@@ -2921,6 +3109,11 @@ interface ProductEstimatedValuesParams extends RequestOptions {
     category?: string;
     /** Expansion technicalName. */
     expansion?: string;
+    /** Brand technicalName. */
+    brand?: string;
+    /** Brand id (ObjectId), an alternative to `brand`. */
+    brandId?: string;
+    productLine?: ProductLine;
 }
 /** Sealed products: booster boxes, ETBs, tins, and the like. Single cards live under
  * `client.cards` instead. */
@@ -2932,8 +3125,9 @@ declare class ProductsResource {
     list(params?: ListProductsParams): Promise<ListResponse<SealedProduct>>;
     /** `GET /product/search`: like `list()`, but with free-text search on the product name. Premium. */
     search(params?: SearchProductsParams): Promise<ListResponse<SealedProduct>>;
-    /** `GET /product/{id}`: fetch one sealed product by its id or technicalName. */
-    get(idOrTechnicalName: string, options?: RequestOptions): Promise<SealedProduct>;
+    /** `GET /product/{id}`: fetch one sealed product by its id or technicalName. Pass `brand` if two
+     * brands might share the same technicalName — see `GetProductParams`. */
+    get(idOrTechnicalName: string, params?: GetProductParams): Promise<SealedProduct>;
     /** `GET /product/{id}/matches`: current shop listings matched to this product (latest per shop). */
     matches(idOrTechnicalName: string, params?: ProductMatchesParams): Promise<ItemShopMatches>;
     /** `GET /product/{id}/reference-prices`: Cardmarket/TCGplayer/Tradera price history. Premium. */
@@ -3153,6 +3347,7 @@ declare class TcgPriser {
     readonly cards: CardsResource;
     readonly products: ProductsResource;
     readonly expansions: ExpansionsResource;
+    readonly brands: BrandsResource;
     readonly shops: ShopsResource;
     readonly shopMatches: ShopMatchesResource;
     readonly shopMatchStats: ShopMatchStatsResource;
@@ -3229,4 +3424,4 @@ declare class TcgPriserError extends Error {
         creditsRemaining?: number;
     });
 }
-export { type Acknowledgement, type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type BrandRef, type Card, type CardDailyStatsParams, type CardEstimatedValuesParams, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CatalogSlug, type CategoryRef, type CompareShopPricesParams, type CreateWebhookParams, type CurrencyCode, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionLivePricing, type ExpansionRef, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type MatchShop, type MatchedItemRef, type PackRate, type PackRateBucket, type PackSlot, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyPriceStatsParams, type ProductDailyStatsParams, type ProductEstimatedValuesParams, type ProductFilterParams, type ProductMatchesParams, type ProductPricesParams, type ProductReferencePricesParams, type ReferencePriceCardVariant, type ReferencePriceCurrencyMode, type ReferencePriceMetric, type ReferencePriceProvider, type ReferencePriceSeries, type ReferencePriceSeriesPoint, type ReferencePriceSnapshot, type ReferencePriceSnapshotsByProvider, type ReferencePriceSource, type RequestOptions, type ResourceId, type SealedProduct, type SearchBargainsParams, type SearchCardsParams, type SearchProductsParams, type Shop, type ShopItemPriceHistory, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistory, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, type TcgPriserAdvancedOptions, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type Webhook, type WebhookDeliveryStatus, type WebhookEvent, type WebhookTestResult, type WebhookWithSecret, type components };
+export { type Acknowledgement, type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type Brand, type BrandRef, type Card, type CardDailyStatsParams, type CardEstimatedValuesParams, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CatalogSlug, type CategoryRef, type CompareShopPricesParams, type CreateWebhookParams, type CurrencyCode, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionLivePricing, type ExpansionRef, type ExpansionReleaseGroup, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type MatchShop, type MatchedItemRef, type PackRate, type PackRateBucket, type PackSlot, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyPriceStatsParams, type ProductDailyStatsParams, type ProductEstimatedValuesParams, type ProductFilterParams, type ProductLine, type ProductMatchesParams, type ProductPricesParams, type ProductReferencePricesParams, type ReferencePriceCardVariant, type ReferencePriceCurrencyMode, type ReferencePriceMetric, type ReferencePriceProvider, type ReferencePriceSeries, type ReferencePriceSeriesPoint, type ReferencePriceSnapshot, type ReferencePriceSnapshotsByProvider, type ReferencePriceSource, type RequestOptions, type ResourceId, type SealedProduct, type SearchBargainsParams, type SearchCardsParams, type SearchProductsParams, type Shop, type ShopItemPriceHistory, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistory, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, type TcgPriserAdvancedOptions, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type Webhook, type WebhookDeliveryStatus, type WebhookEvent, type WebhookTestResult, type WebhookWithSecret, type components };