tcgpriser 0.5.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 = {
@@ -1221,29 +1130,11 @@ type CardSchema = {
     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
@@ -1265,10 +1156,6 @@ type CardSchema = {
     tcgplayerId: string | undefined;
     variants: CardVariants | undefined;
     prisjaktId: string | undefined;
-    lowestShopOffer: LowestShopOfferSchema | undefined;
-    referencePriceSnapshotsByProvider: {
-        [key: string]: ReferencePriceSnapshot;
-    };
 };
 type LowestShopOfferSchema = {
     shop: ShopRef;
@@ -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;
@@ -1452,7 +1344,8 @@ type ReferencePriceProvider = "tradera" | "cardmarket" | "tcgplayer" | "ebay";
 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
@@ -1476,29 +1369,11 @@ type Card = {
     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
@@ -1520,13 +1395,10 @@ type Card = {
     tcgplayerId: string | undefined;
     variants: CardVariants | undefined;
     prisjaktId: string | undefined;
-    lowestShopOffer: LowestShopOfferSchema | undefined;
-    referencePriceSnapshotsByProvider: {
-        [key: string]: ReferencePriceSnapshot;
-    };
 };
 /** 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
@@ -1550,10 +1422,41 @@ type SealedProduct = {
     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: LowestShopOfferSchema | undefined;
     referencePriceSnapshotsByProvider: {
         [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;
@@ -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,17 +1599,17 @@ 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;
@@ -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;
@@ -2063,6 +1963,36 @@ type PackRate = {
     id: string;
     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
@@ -2074,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;
@@ -2083,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`.
@@ -2092,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} */
@@ -2114,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()`.
@@ -2233,29 +2165,11 @@ type StatsItemRef = {
     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
@@ -2300,29 +2214,11 @@ type StatsItemRef = {
     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
@@ -2622,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;
@@ -2629,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. */
@@ -2771,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;
@@ -2882,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.
@@ -2907,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');
  * ```
  */
@@ -2927,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);
@@ -2957,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 MatchShop, 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 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 };
+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 };