tcgpriser 0.4.0 → 0.7.0

package/dist/index.d.cts

@@ -32,11 +32,16 @@ interface components {
         AlternativeName: {
             name: string;
             shortName: string | undefined;
+            /**
+             * @description ISO 639-1 language code the alias is written in (e.g. "sv"), possibly combined ("sv/da/no"). Null means unspecified.
+             * @example sv
+             */
+            language: string | undefined;
         };
         ApiError: {
             error: {
                 /** @enum {string} */
-                code: "validationFailed" | "unauthorized" | "forbidden" | "notFound" | "conflict" | "readOnlyField" | "rateLimited" | "premiumRequired" | "internalError";
+                code: "validationFailed" | "unauthorized" | "forbidden" | "notFound" | "conflict" | "readOnlyField" | "rateLimited" | "premiumRequired" | "businessRequired" | "internalError";
                 message: string;
                 details: unknown;
             };
@@ -71,6 +76,10 @@ interface components {
                 kind: "sealed" | "card";
                 name: string;
                 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;
             };
             bargain: {
@@ -127,29 +136,11 @@ interface components {
             alternativeNames: components["schemas"]["AlternativeName"][];
             supportsMultipackPricing: boolean;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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;
-            /**
-             * @description Cheapest current shop price, in SEK
-             * @example 149.5
-             */
-            retailPrice: number | undefined;
-            /**
-             * @description Estimated market value, in SEK
-             * @example 149.5
-             */
-            estimatedValue: number | undefined;
-            /** @description Active shops currently tracking this item */
-            shopCount: number;
-            /** @description Observations the estimate rests on */
-            pricingDataPoints: number;
-            /**
-             * Format: date-time
-             * @example 2026-07-15T12:03:29.322Z
-             */
-            pricingUpdatedAt: string | undefined;
+            lockedFields: string[];
             /**
              * Format: date-time
              * @example 2026-07-15T12:03:29.322Z
@@ -179,33 +170,13 @@ interface components {
             firstEdition: boolean;
             wPromo: boolean;
         };
-        CardWithPricing: {
+        CatalogItem: components["schemas"]["Card"] | components["schemas"]["Product"];
+        CatalogItemPricing: {
             /**
              * @description Resource identifier
              * @example 6a577711abc1ce71383d3e10
              */
             id: string;
-            name: string;
-            shortName: string | undefined;
-            technicalName: string;
-            brand: components["schemas"]["Brand"];
-            manufacturer: string;
-            modelNumber: string | undefined;
-            category: components["schemas"]["CategoryRef"] | undefined;
-            expansion: components["schemas"]["ExpansionRef"] | undefined;
-            /**
-             * @description Printing language of the item
-             * @example JPN
-             * @enum {string|null}
-             */
-            language: "ENG" | "JPN" | "CHI" | undefined;
-            alternativeNames: components["schemas"]["AlternativeName"][];
-            supportsMultipackPricing: boolean;
-            /**
-             * @description Absolute asset URL, or null when absent
-             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
-             */
-            imageUrl: string | undefined;
             /**
              * @description Cheapest current shop price, in SEK
              * @example 149.5
@@ -225,33 +196,11 @@ interface components {
              * @example 2026-07-15T12:03:29.322Z
              */
             pricingUpdatedAt: 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;
-            /** @enum {string} */
-            kind: "card";
-            /** @example 4/102 */
-            cardNumber: string;
-            /** @example Rare Holo */
-            rarity: string | undefined;
-            artist: string | undefined;
-            cardmarketId: string | undefined;
-            tcgplayerId: string | undefined;
-            variants: components["schemas"]["CardVariants"] | undefined;
-            prisjaktId: string | undefined;
             lowestShopOffer: components["schemas"]["LowestShopOffer"] | undefined;
             referencePriceSnapshotsByProvider: {
                 [key: string]: components["schemas"]["ReferencePriceSummary"];
             };
         };
-        CatalogItem: components["schemas"]["Card"] | components["schemas"]["Product"];
         CatalogItemRef: {
             /**
              * @description Resource identifier
@@ -260,6 +209,14 @@ interface components {
             id: string;
             name: string;
         };
+        CatalogSlug: {
+            technicalName: string;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            updatedAt: string;
+        };
         CategoryRef: {
             /**
              * @description Resource identifier
@@ -320,17 +277,17 @@ interface components {
              */
             releaseDate: string | undefined;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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
              */
             logoUrl: string | undefined;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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
              */
             symbolUrl: string | undefined;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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;
@@ -358,11 +315,11 @@ interface components {
             expansion: components["schemas"]["ExpansionRef"];
             cards: {
                 count: number;
-                items: components["schemas"]["CardWithPricing"][];
+                items: components["schemas"]["Card"][];
             };
             sealed: {
                 count: number;
-                items: components["schemas"]["ProductWithPricing"][];
+                items: components["schemas"]["Product"][];
             };
         };
         ExpansionLivePricing: {
@@ -401,17 +358,17 @@ interface components {
              */
             releaseDate: string | undefined;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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
              */
             logoUrl: string | undefined;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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
              */
             symbolUrl: string | undefined;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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;
@@ -563,6 +520,10 @@ interface components {
             shortName: string | undefined;
             technicalName: string;
             cardNumber: string | undefined;
+            /**
+             * @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;
             language: string | undefined;
             priceChartingId: string | undefined;
@@ -575,6 +536,36 @@ interface components {
             id: string;
             expansion: components["schemas"]["ExpansionRef"];
             buckets: components["schemas"]["PackRateBucket"][];
+            /**
+             * @example [
+             *       "code",
+             *       "common",
+             *       "common",
+             *       "common",
+             *       "uncommon",
+             *       "uncommon",
+             *       "uncommon",
+             *       "reverse",
+             *       "common",
+             *       "hit",
+             *       "energy"
+             *     ]
+             */
+            slotOrder: ("common" | "uncommon" | "reverse" | "hit" | "energy" | "code")[] | undefined;
+            source: {
+                /** @example pullrates.gg */
+                name: string;
+                /**
+                 * Format: uri
+                 * @description The specific page these rates were read from, if any
+                 */
+                url: string | undefined;
+                /**
+                 * Format: date-time
+                 * @example 2026-07-15T12:03:29.322Z
+                 */
+                fetchedAt: string | undefined;
+            } | undefined;
             /**
              * Format: date-time
              * @example 2026-07-15T12:03:29.322Z
@@ -632,29 +623,11 @@ interface components {
             alternativeNames: components["schemas"]["AlternativeName"][];
             supportsMultipackPricing: boolean;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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;
-            /**
-             * @description Cheapest current shop price, in SEK
-             * @example 149.5
-             */
-            retailPrice: number | undefined;
-            /**
-             * @description Estimated market value, in SEK
-             * @example 149.5
-             */
-            estimatedValue: number | undefined;
-            /** @description Active shops currently tracking this item */
-            shopCount: number;
-            /** @description Observations the estimate rests on */
-            pricingDataPoints: number;
-            /**
-             * Format: date-time
-             * @example 2026-07-15T12:03:29.322Z
-             */
-            pricingUpdatedAt: string | undefined;
+            lockedFields: string[];
             /**
              * Format: date-time
              * @example 2026-07-15T12:03:29.322Z
@@ -673,77 +646,9 @@ interface components {
             priceChartingId: string | undefined;
             prisjaktId: string | undefined;
         };
-        ProductWithPricing: {
-            /**
-             * @description Resource identifier
-             * @example 6a577711abc1ce71383d3e10
-             */
-            id: string;
-            name: string;
-            shortName: string | undefined;
-            technicalName: string;
-            brand: components["schemas"]["Brand"];
-            manufacturer: string;
-            modelNumber: string | undefined;
-            category: components["schemas"]["CategoryRef"] | undefined;
-            expansion: components["schemas"]["ExpansionRef"] | undefined;
-            /**
-             * @description Printing language of the item
-             * @example JPN
-             * @enum {string|null}
-             */
-            language: "ENG" | "JPN" | "CHI" | undefined;
-            alternativeNames: components["schemas"]["AlternativeName"][];
-            supportsMultipackPricing: boolean;
-            /**
-             * @description Absolute asset URL, or null when absent
-             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
-             */
-            imageUrl: string | undefined;
-            /**
-             * @description Cheapest current shop price, in SEK
-             * @example 149.5
-             */
-            retailPrice: number | undefined;
-            /**
-             * @description Estimated market value, in SEK
-             * @example 149.5
-             */
-            estimatedValue: number | undefined;
-            /** @description Active shops currently tracking this item */
-            shopCount: number;
-            /** @description Observations the estimate rests on */
-            pricingDataPoints: number;
-            /**
-             * Format: date-time
-             * @example 2026-07-15T12:03:29.322Z
-             */
-            pricingUpdatedAt: 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;
-            /** @enum {string} */
-            kind: "sealed";
-            upc: string | undefined;
-            asin: string | undefined;
-            epid: string | undefined;
-            priceChartingId: string | undefined;
-            prisjaktId: string | undefined;
-            lowestShopOffer: components["schemas"]["LowestShopOffer"] | undefined;
-            referencePriceSnapshotsByProvider: {
-                [key: string]: components["schemas"]["ReferencePriceSummary"];
-            };
-        };
         ReferencePriceSeries: {
             /** @enum {string} */
-            source: "tcgdex" | "cmapi" | "tradera";
+            source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker";
             /** @enum {string} */
             provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
             /** @enum {string|null} */
@@ -798,7 +703,7 @@ interface components {
             technicalName: string;
             websiteUrl: string | undefined;
             /**
-             * @description Absolute asset URL, or null when absent
+             * @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
              */
             logoUrl: string | undefined;
@@ -1050,6 +955,10 @@ interface components {
         ShopSummary: {
             technicalName: string;
             name: 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
+             */
             logoUrl: string | undefined;
             websiteUrl: string | undefined;
             description: string | undefined;
@@ -1193,9 +1102,9 @@ interface components {
  * not silent drift.
  *
  * The API registers `Brand`, `CategoryRef`, `ExpansionRef`, `ShopRef` etc. as their own named
- * components and `$ref`s them wherever they're embedded (in `CardWithPricing`, `ProductWithPricing`,
- * `PackRate`, the shop-match schemas, ...), so those are pulled by name directly. `CardWithPricing`
- * is still the extraction source for the handful of shapes that aren't independently registered
+ * components and `$ref`s them wherever they're embedded (in `Card`, `Product`, `PackRate`, the
+ * shop-match schemas, ...), so those are pulled by name directly. `CardSchema` is still the
+ * extraction source for the handful of shapes that aren't independently registered
  * (`lowestShopOffer`'s `bargain`, the reference-price snapshot map).
  */
 type CardSchema = {
@@ -1207,43 +1116,25 @@ type CardSchema = {
     name: string;
     shortName: string | undefined;
     technicalName: string;
-    brand: components["schemas"]["Brand"];
+    brand: BrandRef;
     manufacturer: string;
     modelNumber: string | undefined;
-    category: components["schemas"]["CategoryRef"] | undefined;
-    expansion: components["schemas"]["ExpansionRef"] | undefined;
+    category: CategoryRef | undefined;
+    expansion: ExpansionRef | undefined;
     /**
      * @description Printing language of the item
      * @example JPN
      * @enum {string|null}
      */
     language: "ENG" | "JPN" | "CHI" | undefined;
-    alternativeNames: components["schemas"]["AlternativeName"][];
+    alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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;
-    /**
-     * @description Cheapest current shop price, in SEK
-     * @example 149.5
-     */
-    retailPrice: number | undefined;
-    /**
-     * @description Estimated market value, in SEK
-     * @example 149.5
-     */
-    estimatedValue: number | undefined;
-    /** @description Active shops currently tracking this item */
-    shopCount: number;
-    /** @description Observations the estimate rests on */
-    pricingDataPoints: number;
-    /**
-     * Format: date-time
-     * @example 2026-07-15T12:03:29.322Z
-     */
-    pricingUpdatedAt: string | undefined;
+    lockedFields: string[];
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -1263,15 +1154,11 @@ type CardSchema = {
     artist: string | undefined;
     cardmarketId: string | undefined;
     tcgplayerId: string | undefined;
-    variants: components["schemas"]["CardVariants"] | undefined;
+    variants: CardVariants | undefined;
     prisjaktId: string | undefined;
-    lowestShopOffer: components["schemas"]["LowestShopOffer"] | undefined;
-    referencePriceSnapshotsByProvider: {
-        [key: string]: components["schemas"]["ReferencePriceSummary"];
-    };
 };
 type LowestShopOfferSchema = {
-    shop: components["schemas"]["ShopRef"];
+    shop: ShopRef;
     url: string;
     /** @example 149.5 */
     price: number;
@@ -1330,6 +1217,11 @@ interface PaginationParams {
 type AlternativeName = {
     name: string;
     shortName: string | undefined;
+    /**
+     * @description ISO 639-1 language code the alias is written in (e.g. "sv"), possibly combined ("sv/da/no"). Null means unspecified.
+     * @example sv
+     */
+    language: string | undefined;
 };
 type BrandRef = {
     /**
@@ -1395,17 +1287,17 @@ type ExpansionRef = {
      */
     releaseDate: string | undefined;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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
      */
     logoUrl: string | undefined;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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
      */
     symbolUrl: string | undefined;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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;
@@ -1426,7 +1318,6 @@ type BargainInfo = {
 };
 /** The cheapest current shop offer for a card or product. */
 type LowestShopOffer = LowestShopOfferSchema;
-type ReferencePriceProvider = "tradera" | "cardmarket" | "tcgplayer" | "ebay";
 type ReferencePriceSnapshot = {
     /** @enum {string} */
     provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
@@ -1448,11 +1339,13 @@ type ReferencePriceSnapshot = {
      */
     snapshotDate: string;
 };
+type ReferencePriceProvider = "tradera" | "cardmarket" | "tcgplayer" | "ebay";
 /** Keyed by provider, at most one snapshot per provider. */
 type ReferencePriceSnapshotsByProvider = Partial<Record<ReferencePriceProvider, ReferencePriceSnapshot>>;
 /** A card, as returned by `client.cards.get()` / `client.cards.list()`, and as embedded in
  * `client.expansions.products()`. `kind: 'card'` is a literal on the generated type, which is what
- * makes `CatalogItem` (below) discriminate cleanly. */
+ * makes `CatalogItem` (below) discriminate cleanly. Content only — no pricing fields; fetch those
+ * separately via `client.cards.pricing()` / `.pricingBatch()`. */
 type Card = {
     /**
      * @description Resource identifier
@@ -1462,43 +1355,25 @@ type Card = {
     name: string;
     shortName: string | undefined;
     technicalName: string;
-    brand: components["schemas"]["Brand"];
+    brand: BrandRef;
     manufacturer: string;
     modelNumber: string | undefined;
-    category: components["schemas"]["CategoryRef"] | undefined;
-    expansion: components["schemas"]["ExpansionRef"] | undefined;
+    category: CategoryRef | undefined;
+    expansion: ExpansionRef | undefined;
     /**
      * @description Printing language of the item
      * @example JPN
      * @enum {string|null}
      */
     language: "ENG" | "JPN" | "CHI" | undefined;
-    alternativeNames: components["schemas"]["AlternativeName"][];
+    alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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;
-    /**
-     * @description Cheapest current shop price, in SEK
-     * @example 149.5
-     */
-    retailPrice: number | undefined;
-    /**
-     * @description Estimated market value, in SEK
-     * @example 149.5
-     */
-    estimatedValue: number | undefined;
-    /** @description Active shops currently tracking this item */
-    shopCount: number;
-    /** @description Observations the estimate rests on */
-    pricingDataPoints: number;
-    /**
-     * Format: date-time
-     * @example 2026-07-15T12:03:29.322Z
-     */
-    pricingUpdatedAt: string | undefined;
+    lockedFields: string[];
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -1518,15 +1393,12 @@ type Card = {
     artist: string | undefined;
     cardmarketId: string | undefined;
     tcgplayerId: string | undefined;
-    variants: components["schemas"]["CardVariants"] | undefined;
+    variants: CardVariants | undefined;
     prisjaktId: string | undefined;
-    lowestShopOffer: components["schemas"]["LowestShopOffer"] | undefined;
-    referencePriceSnapshotsByProvider: {
-        [key: string]: components["schemas"]["ReferencePriceSummary"];
-    };
 };
 /** A sealed product (booster box, ETB, tin, ...), as returned by `client.products.get()` /
- * `client.products.list()`. `kind: 'sealed'` is a literal on the generated type. */
+ * `client.products.list()`. `kind: 'sealed'` is a literal on the generated type. Content only — no
+ * pricing fields; fetch those separately via `client.products.pricing()` / `.pricingBatch()`. */
 type SealedProduct = {
     /**
      * @description Resource identifier
@@ -1536,24 +1408,55 @@ type SealedProduct = {
     name: string;
     shortName: string | undefined;
     technicalName: string;
-    brand: components["schemas"]["Brand"];
+    brand: BrandRef;
     manufacturer: string;
     modelNumber: string | undefined;
-    category: components["schemas"]["CategoryRef"] | undefined;
-    expansion: components["schemas"]["ExpansionRef"] | undefined;
+    category: CategoryRef | undefined;
+    expansion: ExpansionRef | undefined;
     /**
      * @description Printing language of the item
      * @example JPN
      * @enum {string|null}
      */
     language: "ENG" | "JPN" | "CHI" | undefined;
-    alternativeNames: components["schemas"]["AlternativeName"][];
+    alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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;
+    lockedFields: string[];
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    createdAt: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    updatedAt: string;
+    /** @enum {string} */
+    kind: "sealed";
+    upc: string | undefined;
+    asin: string | undefined;
+    epid: string | undefined;
+    priceChartingId: string | undefined;
+    prisjaktId: string | undefined;
+};
+/** A card or sealed product, discriminated on `kind`. */
+type CatalogItem = Card | SealedProduct;
+/** Pricing for one catalog item (card or sealed product) — `retailPrice`, `estimatedValue`,
+ * `lowestShopOffer`, `referencePriceSnapshotsByProvider` — refreshed once a day by the nightly
+ * pricing/scraper jobs, not embedded in `Card`/`SealedProduct` above. Returned by
+ * `client.cards.pricing()` / `.pricingBatch()` and their `client.products` equivalents. */
+type CatalogItemPricing = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
     /**
      * @description Cheapest current shop price, in SEK
      * @example 149.5
@@ -1573,30 +1476,11 @@ type SealedProduct = {
      * @example 2026-07-15T12:03:29.322Z
      */
     pricingUpdatedAt: 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;
-    /** @enum {string} */
-    kind: "sealed";
-    upc: string | undefined;
-    asin: string | undefined;
-    epid: string | undefined;
-    priceChartingId: string | undefined;
-    prisjaktId: string | undefined;
-    lowestShopOffer: components["schemas"]["LowestShopOffer"] | undefined;
+    lowestShopOffer: LowestShopOfferSchema | undefined;
     referencePriceSnapshotsByProvider: {
-        [key: string]: components["schemas"]["ReferencePriceSummary"];
+        [key: string]: ReferencePriceSnapshot;
     };
 };
-/** A card or sealed product, discriminated on `kind`. */
-type CatalogItem = Card | SealedProduct;
 type CardVariants = {
     normal: boolean;
     holo: boolean;
@@ -1618,6 +1502,10 @@ type MatchedItemRef = {
     shortName: string | undefined;
     technicalName: string;
     cardNumber: string | undefined;
+    /**
+     * @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;
     language: string | undefined;
     priceChartingId: string | undefined;
@@ -1633,7 +1521,7 @@ type Bargain = {
      * @example SEK
      */
     currency: string | undefined;
-    shop: components["schemas"]["ShopRef"];
+    shop: ShopRef;
     inStock: boolean;
     /**
      * Format: date-time
@@ -1650,6 +1538,10 @@ type Bargain = {
         kind: "sealed" | "card";
         name: string;
         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;
     };
     bargain: {
@@ -1668,6 +1560,10 @@ type BargainProductRef = {
     kind: "sealed" | "card";
     name: string;
     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;
 };
 /** A set/expansion, as returned by `client.expansions.list()`. This is the full record. The
@@ -1703,23 +1599,23 @@ type Expansion = {
      */
     releaseDate: string | undefined;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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
      */
     logoUrl: string | undefined;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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
      */
     symbolUrl: string | undefined;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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;
     year: number | undefined;
-    brand: components["schemas"]["Brand"];
-    alternativeNames: components["schemas"]["AlternativeName"][];
+    brand: BrandRef;
+    alternativeNames: AlternativeName[];
     /** @description Sealed products in this expansion */
     sealedCount: number;
     /** @description Cards in this expansion */
@@ -1740,14 +1636,14 @@ type Expansion = {
 /** Response of `client.expansions.products()`: everything in one expansion, cards and sealed
  * products kept as separate `cards`/`sealed` groups rather than merged into one mixed list. */
 type ExpansionContents = {
-    expansion: components["schemas"]["ExpansionRef"];
+    expansion: ExpansionRef;
     cards: {
         count: number;
-        items: components["schemas"]["CardWithPricing"][];
+        items: CardSchema[];
     };
     sealed: {
         count: number;
-        items: components["schemas"]["ProductWithPricing"][];
+        items: SealedProduct[];
     };
 };
 /** One card as embedded in `client.expansions.products()`'s `cards` group. `$ref`s `CardWithPricing`
@@ -1763,7 +1659,7 @@ type ShopMatchWithItemSchema = {
      * @example 6a577711abc1ce71383d3e10
      */
     id: string;
-    shop: components["schemas"]["ShopRef"];
+    shop: ShopRef;
     url: string;
     /**
      * @description Resource identifier
@@ -1792,9 +1688,9 @@ type ShopMatchWithItemSchema = {
     /** @enum {string|null} */
     gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
     grade: number | undefined;
-    item: components["schemas"]["MatchedItemRef"] | undefined;
-    expansion: components["schemas"]["ExpansionRef"] | undefined;
-    category: components["schemas"]["CategoryRef"] | undefined;
+    item: MatchedItemRef | undefined;
+    expansion: ExpansionRef | undefined;
+    category: CategoryRef | undefined;
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -1817,7 +1713,7 @@ type ItemShopMatchSchema = {
      * @example 6a577711abc1ce71383d3e10
      */
     id: string;
-    shop: components["schemas"]["MatchShop"];
+    shop: MatchShop;
     url: string;
     /**
      * @description Resource identifier
@@ -1877,7 +1773,7 @@ type Shop = {
     technicalName: string;
     websiteUrl: string | undefined;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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
      */
     logoUrl: string | undefined;
@@ -1926,6 +1822,10 @@ type Shop = {
 type ShopSummary = {
     technicalName: string;
     name: 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
+     */
     logoUrl: string | undefined;
     websiteUrl: string | undefined;
     description: string | undefined;
@@ -1951,25 +1851,34 @@ type ShopMatchDelivery = {
     supportsLocalPickup: boolean | undefined;
     note: string | undefined;
 };
+/** The shop identity embedded on an item-scoped match (`ItemShopMatch.shop`): like `ShopRef`, plus
+ * delivery terms -- this is the one place a match row prices in shipping. */
+type MatchShop = {
+    /** @example cardlevels */
+    technicalName: string;
+    /** @example Cardlevels */
+    name: string;
+    delivery: ShopMatchDelivery;
+};
 /** A shop-match row scoped to one already-known item. `client.cards.matches()` and
  * `client.products.matches()` drop `item`/`expansion`/`category` since the caller already has
  * them, but add delivery terms since you're looking at one listing's total cost here. */
 type ItemShopMatch = ItemShopMatchSchema;
 /** Response of `client.cards.matches()` / `client.products.matches()`. */
 type ItemShopMatches = {
-    item: components["schemas"]["CatalogItemRef"];
-    data: components["schemas"]["ShopProductMatch"][];
-    pagination: components["schemas"]["PageMeta"];
+    item: ItemRef;
+    data: ItemShopMatchSchema[];
+    pagination: PageMeta;
 };
 /** Response of `client.shopMatches.forShop()`: every match, of any item, currently live at one shop. */
 type ShopMatchesForShop = {
-    shop: components["schemas"]["ShopSummary"] | undefined;
-    data: components["schemas"]["ShopMatchWithItem"][];
-    pagination: components["schemas"]["PageMeta"];
+    shop: ShopSummary | undefined;
+    data: ShopMatchWithItemSchema[];
+    pagination: PageMeta;
 };
 /** One row of `client.shopMatches.shopStats()`: match counts per shop, not the matches themselves. */
 type ShopMatchStats = {
-    shop: components["schemas"]["ShopSummary"];
+    shop: ShopSummary;
     matchCount: number;
     /** @description Matches resolved to a catalog item */
     linkedMatchCount: number;
@@ -2005,8 +1914,8 @@ type DailyPricePoint = {
 };
 /** Response row of `client.priceStats.daily()`. */
 type ItemDailyStats = {
-    item: components["schemas"]["CatalogItemRef"];
-    dailyStats: components["schemas"]["DailyPricePoint"][];
+    item: ItemRef;
+    dailyStats: DailyPricePoint[];
 };
 type EstimatedValue = {
     /** @example 149.5 */
@@ -2020,8 +1929,8 @@ type EstimatedValue = {
 };
 /** Response row of `client.priceStats.estimatedValues()`. */
 type ItemEstimatedValue = {
-    item: components["schemas"]["CatalogItemRef"];
-    estimate: components["schemas"]["EstimatedValue"];
+    item: ItemRef;
+    estimate: EstimatedValue;
 };
 /** Response row of `client.priceStats.topProducts()`: items ranked by shop availability, not price. */
 type TopItem = {
@@ -2052,8 +1961,38 @@ type PackRate = {
      * @example 6a577711abc1ce71383d3e10
      */
     id: string;
-    expansion: components["schemas"]["ExpansionRef"];
-    buckets: components["schemas"]["PackRateBucket"][];
+    expansion: ExpansionRef;
+    buckets: PackRateBucket[];
+    /**
+     * @example [
+     *       "code",
+     *       "common",
+     *       "common",
+     *       "common",
+     *       "uncommon",
+     *       "uncommon",
+     *       "uncommon",
+     *       "reverse",
+     *       "common",
+     *       "hit",
+     *       "energy"
+     *     ]
+     */
+    slotOrder: ("common" | "uncommon" | "reverse" | "hit" | "energy" | "code")[] | undefined;
+    source: {
+        /** @example pullrates.gg */
+        name: string;
+        /**
+         * Format: uri
+         * @description The specific page these rates were read from, if any
+         */
+        url: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        fetchedAt: string | undefined;
+    } | undefined;
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -2065,6 +2004,8 @@ type PackRate = {
      */
     updatedAt: string;
 };
+/** One of the 9 fixed slots in a simulated pack (4 common, 3 uncommon, 1 reverse, 1 hit). */
+type PackSlot = "common" | "uncommon" | "reverse" | "hit" | "energy" | "code";
 /** Platform-wide overview counts, returned by `client.stats.platform()`. */
 type PlatformStats = {
     shopCount: number;
@@ -2074,7 +2015,7 @@ type PlatformStats = {
     priceCount: number;
 };
 /**
- * Types for the premium tier: endpoints that need a signed-in subscriber's JWT (see
+ * Types for the premium tier: endpoints that need a subscriber's API token (see
  * `TcgPriserOptions.authToken`, or the `authToken` field on each premium method's params). Split
  * out from the public-tier types because none of these mean anything without a token: without one,
  * the API just answers `403 premiumRequired`.
@@ -2083,7 +2024,7 @@ type PlatformStats = {
  */
 type ReferencePriceSeries = {
     /** @enum {string} */
-    source: "tcgdex" | "cmapi" | "tradera";
+    source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker";
     /** @enum {string} */
     provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
     /** @enum {string|null} */
@@ -2095,7 +2036,7 @@ type ReferencePriceSeries = {
     grade: number | undefined;
     currency: string;
     sampleSize: number | undefined;
-    points: components["schemas"]["ReferencePriceSeriesPoint"][];
+    points: ReferencePriceSeriesPoint[];
 };
 type ReferencePriceSeriesPoint = {
     /**
@@ -2105,8 +2046,8 @@ type ReferencePriceSeriesPoint = {
     snapshotDate: string;
     price: number;
 };
-type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi";
-type ReferencePriceCardVariant = "normal" | "holo" | "reverse";
+type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi" | "pokemonpricetracker";
+type ReferencePriceCardVariant = "reverse" | "normal" | "holo";
 type ReferencePriceMetric = "price" | "low" | "mid" | "high" | "avg" | "avg1" | "avg7" | "avg30" | "directLow";
 type ReferencePriceCurrencyMode = "native" | "sek";
 /** Response of `client.cards.referencePrices()` / `client.products.referencePrices()`.
@@ -2117,7 +2058,7 @@ type ReferencePriceCurrencyMode = "native" | "sek";
  * keeps its own `currency`; in `sek` mode everything is `SEK`, converted at the rate stored on
  * each point. */
 type ItemReferencePrices = {
-    item: components["schemas"]["CatalogItemRef"];
+    item: ItemRef;
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -2132,7 +2073,7 @@ type ItemReferencePrices = {
     metric: "price" | "low" | "mid" | "high" | "avg" | "avg1" | "avg7" | "avg30" | "directLow";
     /** @enum {string} */
     currencyMode: "native" | "sek";
-    series: components["schemas"]["ReferencePriceSeries"][];
+    series: ReferencePriceSeries[];
 };
 type SoldPrice = {
     /**
@@ -2161,9 +2102,9 @@ type SoldPrice = {
  * `true` here. That field only exists because this envelope shape is shared with a free preview
  * elsewhere in the API; this response is never the preview. */
 type ItemSoldPrices = {
-    item: components["schemas"]["CatalogItemRef"];
-    data: components["schemas"]["SoldPrice"][];
-    pagination: components["schemas"]["PageMeta"];
+    item: ItemRef;
+    data: SoldPrice[];
+    pagination: PageMeta;
     /** @enum {boolean} */
     premiumRequired: true;
 };
@@ -2189,14 +2130,14 @@ type LivePricingForItem = {
     id: string;
     name: string;
     technicalName: string;
-    pricing: components["schemas"]["LivePricing"];
+    pricing: LivePricingDetail;
 };
 /** Response of `client.expansions.livePricing()`: live pricing for every item in one expansion. */
 type ExpansionLivePricing = {
     expansion: {
         technicalName: string;
     };
-    items: components["schemas"]["LivePricingForItem"][];
+    items: LivePricingForItem[];
 };
 /** The catalog item as embedded in stats responses: a `Card`/`SealedProduct` minus
  * `lowestShopOffer` and `referencePriceSnapshotsByProvider`, which these endpoints already answer
@@ -2210,43 +2151,25 @@ type StatsItemRef = {
     name: string;
     shortName: string | undefined;
     technicalName: string;
-    brand: components["schemas"]["Brand"];
+    brand: BrandRef;
     manufacturer: string;
     modelNumber: string | undefined;
-    category: components["schemas"]["CategoryRef"] | undefined;
-    expansion: components["schemas"]["ExpansionRef"] | undefined;
+    category: CategoryRef | undefined;
+    expansion: ExpansionRef | undefined;
     /**
      * @description Printing language of the item
      * @example JPN
      * @enum {string|null}
      */
     language: "ENG" | "JPN" | "CHI" | undefined;
-    alternativeNames: components["schemas"]["AlternativeName"][];
+    alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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;
-    /**
-     * @description Cheapest current shop price, in SEK
-     * @example 149.5
-     */
-    retailPrice: number | undefined;
-    /**
-     * @description Estimated market value, in SEK
-     * @example 149.5
-     */
-    estimatedValue: number | undefined;
-    /** @description Active shops currently tracking this item */
-    shopCount: number;
-    /** @description Observations the estimate rests on */
-    pricingDataPoints: number;
-    /**
-     * Format: date-time
-     * @example 2026-07-15T12:03:29.322Z
-     */
-    pricingUpdatedAt: string | undefined;
+    lockedFields: string[];
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -2266,7 +2189,7 @@ type StatsItemRef = {
     artist: string | undefined;
     cardmarketId: string | undefined;
     tcgplayerId: string | undefined;
-    variants: components["schemas"]["CardVariants"] | undefined;
+    variants: CardVariants | undefined;
     prisjaktId: string | undefined;
 } | {
     /**
@@ -2277,43 +2200,25 @@ type StatsItemRef = {
     name: string;
     shortName: string | undefined;
     technicalName: string;
-    brand: components["schemas"]["Brand"];
+    brand: BrandRef;
     manufacturer: string;
     modelNumber: string | undefined;
-    category: components["schemas"]["CategoryRef"] | undefined;
-    expansion: components["schemas"]["ExpansionRef"] | undefined;
+    category: CategoryRef | undefined;
+    expansion: ExpansionRef | undefined;
     /**
      * @description Printing language of the item
      * @example JPN
      * @enum {string|null}
      */
     language: "ENG" | "JPN" | "CHI" | undefined;
-    alternativeNames: components["schemas"]["AlternativeName"][];
+    alternativeNames: AlternativeName[];
     supportsMultipackPricing: boolean;
     /**
-     * @description Absolute asset URL, or null when absent
+     * @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;
-    /**
-     * @description Cheapest current shop price, in SEK
-     * @example 149.5
-     */
-    retailPrice: number | undefined;
-    /**
-     * @description Estimated market value, in SEK
-     * @example 149.5
-     */
-    estimatedValue: number | undefined;
-    /** @description Active shops currently tracking this item */
-    shopCount: number;
-    /** @description Observations the estimate rests on */
-    pricingDataPoints: number;
-    /**
-     * Format: date-time
-     * @example 2026-07-15T12:03:29.322Z
-     */
-    pricingUpdatedAt: string | undefined;
+    lockedFields: string[];
     /**
      * Format: date-time
      * @example 2026-07-15T12:03:29.322Z
@@ -2340,23 +2245,23 @@ type VariantStatsSummary = {
 };
 /** Response of `client.priceStats.product()`. */
 type ItemStats = {
-    item: components["schemas"]["CatalogItem"];
-    dailyStats: components["schemas"]["DailyPricePoint"][];
-    estimate: components["schemas"]["EstimatedValue"];
-    variantStats: components["schemas"]["VariantStatsSummary"];
+    item: StatsItemRef;
+    dailyStats: DailyPricePoint[];
+    estimate: EstimatedValue;
+    variantStats: VariantStatsSummary;
 };
 /** Response of `client.priceStats.productFull()`: everything `product()` has, plus the item's
  * current shop matches. */
 type ItemFullStats = {
-    item: components["schemas"]["CatalogItem"];
+    item: StatsItemRef;
     stats: {
-        dailyStats: components["schemas"]["DailyPricePoint"][];
-        variantStats: components["schemas"]["VariantStatsSummary"];
+        dailyStats: DailyPricePoint[];
+        variantStats: VariantStatsSummary;
     };
-    estimate: components["schemas"]["EstimatedValue"];
+    estimate: EstimatedValue;
     shopMatches: {
-        data: components["schemas"]["ShopProductMatch"][];
-        pagination: components["schemas"]["PageMeta"];
+        data: ItemShopMatchSchema[];
+        pagination: PageMeta;
     };
 };
 type VariantPriceStat = {
@@ -2399,9 +2304,9 @@ type VariantSelector = {
 };
 /** Response of `client.priceStats.productDailyByVariant()`. */
 type ItemVariantDailyStats = {
-    item: components["schemas"]["CatalogItemRef"];
-    variant: components["schemas"]["VariantSelector"];
-    dailyStats: components["schemas"]["DailyPricePoint"][];
+    item: ItemRef;
+    variant: VariantSelector;
+    dailyStats: DailyPricePoint[];
 };
 type ShopPricePoint = {
     /**
@@ -2419,18 +2324,36 @@ type ShopPricePoint = {
     inStock: boolean;
     url: string;
 };
+/** One shop's history for the item `ItemShopPriceHistory` is scoped to. */
+type ShopPriceHistory = {
+    /** @description The shop's technicalName */
+    shop: string;
+    history: ShopPricePoint[];
+};
 /** Response of `client.shopMatchStats.forProduct()`: one product's price history, broken out per
  * shop. */
 type ItemShopPriceHistory = {
-    item: components["schemas"]["CatalogItemRef"];
-    shops: components["schemas"]["ShopPriceHistory"][];
+    item: ItemRef;
+    shops: ShopPriceHistory[];
     recordCount: number;
 };
+/** One product's history for the shop `ShopPriceHistoryList` is scoped to. */
+type ShopItemPriceHistory = {
+    item: ItemRef;
+    history: ShopPricePoint[];
+    /** @example 149.5 */
+    latestPrice: number | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    latestDate: string | undefined;
+};
 /** Response of `client.shopMatchStats.forShop()`: one shop's price history, broken out per
  * product. */
 type ShopPriceHistoryList = {
     shop: string;
-    items: components["schemas"]["ShopItemPriceHistory"][];
+    items: ShopItemPriceHistory[];
     itemCount: number;
 };
 type ShopPriceComparisonRow = {
@@ -2462,9 +2385,9 @@ type ShopPriceComparisonStats = {
 /** Response of `client.shopMatchStats.compare()`: one product's price at every shop that carries
  * it, as of one date. `stats` is `undefined` when no shop had a price on that date. */
 type ItemPriceComparison = {
-    item: components["schemas"]["CatalogItemRef"];
-    items: components["schemas"]["ShopPriceComparisonRow"][];
-    stats: components["schemas"]["ShopPriceComparisonStats"] | undefined;
+    item: ItemRef;
+    items: ShopPriceComparisonRow[];
+    stats: ShopPriceComparisonStats | undefined;
 };
 type ShopUrlStatus = "pending" | "active" | "invalid" | "rejected" | "sanityRejected";
 type ShopUrlDiscoveredBy = "scraper" | "user";
@@ -2477,7 +2400,7 @@ type ShopUrl = {
     id: string;
     url: string;
     shop: string | undefined;
-    status: components["schemas"]["ShopUrlStatus"];
+    status: ShopUrlStatus;
     /** @enum {string} */
     discoveredBy: "scraper" | "user";
     /**
@@ -2521,7 +2444,7 @@ type ShopUrl = {
 /** Response of `client.shopUrls.submit()` / `client.shopUrls.assignProduct()`. */
 type ShopUrlMutationResult = {
     message: string;
-    shopUrl: components["schemas"]["ShopUrl"];
+    shopUrl: ShopUrl;
 };
 interface ListBargainsParams {
     type?: 'sealed' | 'card' | 'all';
@@ -2595,6 +2518,17 @@ declare class CardsResource {
     /** `GET /cards/{id}/pricing/live`: computed fresh for this request, not read from the last
      * stats job. Premium. */
     livePricing(idOrTechnicalName: string, options?: PremiumOptions): Promise<LivePricingForItem>;
+    /** `GET /cards/{id}/pricing`: this card's current pricing snapshot — `retailPrice`,
+     * `estimatedValue`, `lowestShopOffer`, `referencePriceSnapshotsByProvider` — refreshed once a day
+     * by the nightly pricing/scraper jobs. `get()` returns content only; this is the separate,
+     * shorter-cached call for the part of a card that actually changes day to day. */
+    pricing(idOrTechnicalName: string): Promise<CatalogItemPricing>;
+    /** `GET /cards/pricing`: pricing for up to 200 cards in one request, keyed by `id` — the batch
+     * counterpart to `pricing()`, for a page of results (a search page, an expansion's contents) that
+     * needs pricing for many items at once. Unlike `get()`/`pricing()`, this only accepts `id`s, not
+     * technicalNames — pass the `id`s already on the cards you fetched. Ids with no match are
+     * silently omitted from the result rather than causing an error. */
+    pricingBatch(ids: string[]): Promise<ListResponse<CatalogItemPricing>>;
 }
 declare class ExpansionsResource {
     private readonly http;
@@ -2602,7 +2536,10 @@ declare class ExpansionsResource {
     /** `GET /expansions`: every expansion. Unwrapped to a plain array, nothing to paginate here. */
     list(): Promise<Expansion[]>;
     /** `GET /expansions/{technicalName}/products`: every card and sealed product in one
-     * expansion, kept as separate `cards`/`sealed` groups. */
+     * expansion, kept as separate `cards`/`sealed` groups. Content only, no pricing fields — pass the
+     * `id`s from the result to `client.cards.pricingBatch()` / `client.products.pricingBatch()` if you
+     * need pricing too. This mirrors the API 1:1 rather than fetching pricing for you, since pricing
+     * for every item in an expansion is a second, separately-cached call the caller may not want. */
     products(technicalName: string): Promise<ExpansionContents>;
     /** `GET /expansions/{technicalName}/products/live-pricing`: computed fresh for every item in
      * this expansion, not read from the last stats job. Premium. */
@@ -2744,6 +2681,17 @@ declare class ProductsResource {
     /** `GET /product/{id}/pricing/live`: computed fresh for this request, not read from the last
      * stats job. Premium. */
     livePricing(idOrTechnicalName: string, options?: PremiumOptions): Promise<LivePricingForItem>;
+    /** `GET /product/{id}/pricing`: this product's current pricing snapshot — `retailPrice`,
+     * `estimatedValue`, `lowestShopOffer`, `referencePriceSnapshotsByProvider` — refreshed once a day
+     * by the nightly pricing/scraper jobs. `get()` returns content only; this is the separate,
+     * shorter-cached call for the part of a product that actually changes day to day. */
+    pricing(idOrTechnicalName: string): Promise<CatalogItemPricing>;
+    /** `GET /product/pricing`: pricing for up to 200 sealed products in one request, keyed by `id` —
+     * the batch counterpart to `pricing()`, for a page of results (a search page, an expansion's
+     * contents) that needs pricing for many items at once. Unlike `get()`/`pricing()`, this only
+     * accepts `id`s, not technicalNames — pass the `id`s already on the products you fetched. Ids with
+     * no match are silently omitted from the result rather than causing an error. */
+    pricingBatch(ids: string[]): Promise<ListResponse<CatalogItemPricing>>;
 }
 interface ShopMatchStatsForProductParams {
     authToken?: string;
@@ -2855,9 +2803,11 @@ interface TcgPriserAdvancedOptions {
 }
 interface TcgPriserOptions {
     /**
-     * A signed-in subscriber's JWT. Only needed for premium methods (`cards.prices()`,
-     * `priceStats.product()`, `bargains.search()` etc.); public methods work fine without it.
-     * This client has no login flow of its own, so bring your own token.
+     * A per-account API token, generated from your account page at tcgpriser.se/account/api-token.
+     * Only needed for premium methods (`cards.prices()`, `priceStats.product()`,
+     * `bargains.search()` etc.); public methods work fine without it. This client has no login flow
+     * of its own, and doesn't need one: the API token is a long-lived, revocable secret made for
+     * exactly this, so there's no OAuth dance to drive.
      *
      * Every premium method also accepts its own `authToken` to override this per call. Useful when
      * one server-side client is shared across requests for several different signed-in users.
@@ -2880,10 +2830,11 @@ interface TcgPriserOptions {
  *
  * That example needs no token. Most of the API is public (https://api.tcgpriser.se/docs). A
  * smaller set of premium methods (live pricing, per-condition history, shop comparison, bargain
- * search, shop-URL submission) need a subscriber's JWT (https://api.tcgpriser.se/premium-docs):
+ * search, shop-URL submission) need a Premium subscriber's API token
+ * (https://api.tcgpriser.se/premium-docs), generated from tcgpriser.se/account/api-token:
  *
  * ```ts
- * const tcgpriser = new TcgPriser(myJwt); // shorthand for { authToken: myJwt }
+ * const tcgpriser = new TcgPriser(myApiToken); // shorthand for { authToken: myApiToken }
  * await tcgpriser.cards.livePricing('fezandipiti-ex');
  * ```
  */
@@ -2900,7 +2851,7 @@ declare class TcgPriser {
     readonly packRates: PackRatesResource;
     readonly stats: StatsResource;
     /**
-     * @param optionsOrAuthToken A subscriber JWT (`new TcgPriser(myJwt)`), a full
+     * @param optionsOrAuthToken A subscriber's API token (`new TcgPriser(myApiToken)`), a full
      * `TcgPriserOptions` object, or omit it entirely for an anonymous, public-only client.
      */
     constructor(optionsOrAuthToken?: string | TcgPriserOptions);
@@ -2930,4 +2881,4 @@ declare class TcgPriserError extends Error {
         body: string;
     });
 }
-export { type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type BrandRef, type Card, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CategoryRef, type CompareShopPricesParams, type CurrencyCode, DEFAULT_BASE_URL, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionCard, type ExpansionContents, type ExpansionLivePricing, type ExpansionRef, type ExpansionSealedProduct, 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 MatchedItemRef, type PackRate, type PackRateBucket, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyStatsParams, 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 ResourceId, type SealedProduct, type SearchBargainsParams, type Shop, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type components };
+export { type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type BrandRef, type Card, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CategoryRef, type CompareShopPricesParams, type CurrencyCode, DEFAULT_BASE_URL, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionCard, type ExpansionContents, type ExpansionLivePricing, type ExpansionRef, type ExpansionSealedProduct, 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 ProductDailyStatsParams, 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 ResourceId, type SealedProduct, type SearchBargainsParams, 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, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type components };