tcgpriser 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -27,7 +27,6 @@ declare class HttpClient {
     patch<T>(path: string, body: unknown, requestOptions?: PremiumOptions): Promise<T>;
     private request;
 }
-
 interface components {
     schemas: {
         ApiError: {
@@ -2746,7 +2745,6 @@ interface components {
     headers: never;
     pathItems: never;
 }
-
 /**
  * Shared primitives reused across every resource. Pulled from `src/generated/openapi.d.ts` via
  * indexed access instead of retyped by hand, so a field rename in the API is a compile error here,
@@ -2758,9 +2756,250 @@ interface components {
  * byte-identical across `ProductWithPricing`, `PackRate` and the shop-match schemas too, so picking
  * one as the source of truth works fine.
  */
-
-type CardSchema = components['schemas']['CardWithPricing'];
-type LowestShopOfferSchema = NonNullable<CardSchema['lowestShopOffer']>;
+type CardSchema = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+    shortName: string | undefined;
+    technicalName: string;
+    brand: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Pokémon */
+        name: string;
+        /** @example pokemon */
+        technicalName: 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;
+    };
+    manufacturer: string;
+    modelNumber: string | undefined;
+    category: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Booster Box */
+        name: string;
+        /** @example booster-box */
+        technicalName: string;
+    } | undefined;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    } | undefined;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string|null}
+     */
+    language: "ENG" | "JPN" | "CHI" | undefined;
+    alternativeNames: {
+        name: string;
+        shortName: string | undefined;
+    }[];
+    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: "card";
+    /** @example 4/102 */
+    cardNumber: string;
+    /** @example Rare Holo */
+    rarity: string | undefined;
+    artist: string | undefined;
+    cardmarketId: string | undefined;
+    tcgplayerId: string | undefined;
+    variants: {
+        normal: boolean;
+        holo: boolean;
+        reverse: boolean;
+        firstEdition: boolean;
+        wPromo: boolean;
+    } | undefined;
+    prisjaktId: string | undefined;
+    lowestShopOffer: {
+        shop: {
+            /** @example cardlevels */
+            technicalName: string;
+            /** @example Cardlevels */
+            name: string;
+        };
+        url: string;
+        /** @example 149.5 */
+        price: number;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string;
+        inStock: boolean;
+        inPreorder: boolean;
+        inMonitor: boolean;
+        isFullyBooked: boolean;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        matchedAt: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        updatedAt: string;
+        bargain: {
+            discountPercent: number;
+            /** @enum {string} */
+            referenceSource: "retail" | "tradera" | "cardmarket";
+        } | undefined;
+    } | undefined;
+    referencePriceSnapshotsByProvider: {
+        [key: string]: {
+            /** @enum {string} */
+            provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+            /** @example 149.5 */
+            price: number;
+            /**
+             * @description ISO-4217 currency code
+             * @example SEK
+             */
+            currency: string;
+            /**
+             * @description price converted to SEK at the rate stored on the row
+             * @example 149.5
+             */
+            priceSek: number;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            snapshotDate: string;
+        };
+    };
+};
+type LowestShopOfferSchema = {
+    shop: {
+        /** @example cardlevels */
+        technicalName: string;
+        /** @example Cardlevels */
+        name: string;
+    };
+    url: string;
+    /** @example 149.5 */
+    price: number;
+    /**
+     * @description ISO-4217 currency code
+     * @example SEK
+     */
+    currency: string;
+    inStock: boolean;
+    inPreorder: boolean;
+    inMonitor: boolean;
+    isFullyBooked: boolean;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    matchedAt: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    updatedAt: string;
+    bargain: {
+        discountPercent: number;
+        /** @enum {string} */
+        referenceSource: "retail" | "tradera" | "cardmarket";
+    } | undefined;
+};
 /** A Mongo ObjectId, always a 24-char lowercase hex string. Just `string`, not a branded type;
  * nothing here needs to tell it apart from any other id at compile time. */
 type ResourceId = string;
@@ -2768,8 +3007,14 @@ type ResourceId = string;
 type CurrencyCode = string;
 /** ISO 8601 timestamp, as returned by the API (always UTC, `Z`-suffixed). */
 type Timestamp = string;
-type PrintingLanguage = NonNullable<CardSchema['language']>;
-type PageMeta = components['schemas']['PageMeta'];
+type PrintingLanguage = "ENG" | "JPN" | "CHI";
+type PageMeta = {
+    /** @description Total matching records, ignoring pagination */
+    total: number;
+    limit: number;
+    skip: number;
+    hasMore: boolean;
+};
 /** The standard paginated list envelope every `list`/`search` method returns. Hand-declared, not
  * generated: the API repeats a fresh anonymous `{ data, pagination }` object per endpoint rather
  * than naming it once. */
@@ -2782,177 +3027,3880 @@ interface PaginationParams {
     limit?: number;
     skip?: number;
 }
-type AlternativeName = CardSchema['alternativeNames'][number];
-type BrandRef = CardSchema['brand'];
-type CategoryRef = NonNullable<CardSchema['category']>;
+type AlternativeName = {
+    name: string;
+    shortName: string | undefined;
+};
+type BrandRef = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    /** @example Pokémon */
+    name: string;
+    /** @example pokemon */
+    technicalName: 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;
+};
+type CategoryRef = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    /** @example Booster Box */
+    name: string;
+    /** @example booster-box */
+    technicalName: string;
+};
 /** The expansion shape embedded on cards, products and pack rates. Not the full `Expansion`
  * returned by `client.expansions.list()`, which additionally carries counts and a `brand`. */
-type ExpansionRef = NonNullable<CardSchema['expansion']>;
+type ExpansionRef = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    /** @example Mega Evolution 30th Celebration */
+    name: string;
+    /** @example 30th Celebration */
+    shortName: string;
+    /** @example jpn-mega-evolution-30th-celebration */
+    technicalName: string;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string}
+     */
+    language: "ENG" | "JPN" | "CHI";
+    /** @example m6a */
+    code: string | undefined;
+    /** @example m6a */
+    cardCode: string | undefined;
+    /** @example Mega Evolution */
+    seriesName: string | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    releaseDate: string | undefined;
+    /**
+     * @description Absolute asset URL, or null when absent
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    logoUrl: string | undefined;
+    /**
+     * @description Absolute asset URL, or null when absent
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    symbolUrl: string | undefined;
+    /**
+     * @description Absolute asset URL, or null when absent
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    imageUrl: string | undefined;
+};
 /** The minimal shop identity embedded on offers and matches. */
-type ShopRef = LowestShopOfferSchema['shop'];
-type BargainReferenceSource = NonNullable<LowestShopOfferSchema['bargain']>['referenceSource'];
+type ShopRef = {
+    /** @example cardlevels */
+    technicalName: string;
+    /** @example Cardlevels */
+    name: string;
+};
+type BargainReferenceSource = "retail" | "tradera" | "cardmarket";
 /** Present on an offer/match when its price is a known-good discount off a reference price. */
-type BargainInfo = NonNullable<LowestShopOfferSchema['bargain']>;
+type BargainInfo = {
+    discountPercent: number;
+    /** @enum {string} */
+    referenceSource: "retail" | "tradera" | "cardmarket";
+};
 /** The cheapest current shop offer for a card or product. */
 type LowestShopOffer = LowestShopOfferSchema;
-type ReferencePriceProvider = CardSchema['referencePriceSnapshotsByProvider'][string]['provider'];
-type ReferencePriceSnapshot = CardSchema['referencePriceSnapshotsByProvider'][string];
+type ReferencePriceProvider = "tradera" | "cardmarket" | "tcgplayer" | "ebay";
+type ReferencePriceSnapshot = {
+    /** @enum {string} */
+    provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+    /** @example 149.5 */
+    price: number;
+    /**
+     * @description ISO-4217 currency code
+     * @example SEK
+     */
+    currency: string;
+    /**
+     * @description price converted to SEK at the rate stored on the row
+     * @example 149.5
+     */
+    priceSek: number;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    snapshotDate: string;
+};
 /** 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. */
-type Card = components['schemas']['CardWithPricing'];
+type Card = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+    shortName: string | undefined;
+    technicalName: string;
+    brand: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Pokémon */
+        name: string;
+        /** @example pokemon */
+        technicalName: 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;
+    };
+    manufacturer: string;
+    modelNumber: string | undefined;
+    category: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Booster Box */
+        name: string;
+        /** @example booster-box */
+        technicalName: string;
+    } | undefined;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    } | undefined;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string|null}
+     */
+    language: "ENG" | "JPN" | "CHI" | undefined;
+    alternativeNames: {
+        name: string;
+        shortName: string | undefined;
+    }[];
+    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: "card";
+    /** @example 4/102 */
+    cardNumber: string;
+    /** @example Rare Holo */
+    rarity: string | undefined;
+    artist: string | undefined;
+    cardmarketId: string | undefined;
+    tcgplayerId: string | undefined;
+    variants: {
+        normal: boolean;
+        holo: boolean;
+        reverse: boolean;
+        firstEdition: boolean;
+        wPromo: boolean;
+    } | undefined;
+    prisjaktId: string | undefined;
+    lowestShopOffer: {
+        shop: {
+            /** @example cardlevels */
+            technicalName: string;
+            /** @example Cardlevels */
+            name: string;
+        };
+        url: string;
+        /** @example 149.5 */
+        price: number;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string;
+        inStock: boolean;
+        inPreorder: boolean;
+        inMonitor: boolean;
+        isFullyBooked: boolean;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        matchedAt: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        updatedAt: string;
+        bargain: {
+            discountPercent: number;
+            /** @enum {string} */
+            referenceSource: "retail" | "tradera" | "cardmarket";
+        } | undefined;
+    } | undefined;
+    referencePriceSnapshotsByProvider: {
+        [key: string]: {
+            /** @enum {string} */
+            provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+            /** @example 149.5 */
+            price: number;
+            /**
+             * @description ISO-4217 currency code
+             * @example SEK
+             */
+            currency: string;
+            /**
+             * @description price converted to SEK at the rate stored on the row
+             * @example 149.5
+             */
+            priceSek: number;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            snapshotDate: string;
+        };
+    };
+};
 /** 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. */
-type SealedProduct = components['schemas']['ProductWithPricing'];
+type SealedProduct = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+    shortName: string | undefined;
+    technicalName: string;
+    brand: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Pokémon */
+        name: string;
+        /** @example pokemon */
+        technicalName: 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;
+    };
+    manufacturer: string;
+    modelNumber: string | undefined;
+    category: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Booster Box */
+        name: string;
+        /** @example booster-box */
+        technicalName: string;
+    } | undefined;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    } | undefined;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string|null}
+     */
+    language: "ENG" | "JPN" | "CHI" | undefined;
+    alternativeNames: {
+        name: string;
+        shortName: string | undefined;
+    }[];
+    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: {
+        shop: {
+            /** @example cardlevels */
+            technicalName: string;
+            /** @example Cardlevels */
+            name: string;
+        };
+        url: string;
+        /** @example 149.5 */
+        price: number;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string;
+        inStock: boolean;
+        inPreorder: boolean;
+        inMonitor: boolean;
+        isFullyBooked: boolean;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        matchedAt: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        updatedAt: string;
+        bargain: {
+            discountPercent: number;
+            /** @enum {string} */
+            referenceSource: "retail" | "tradera" | "cardmarket";
+        } | undefined;
+    } | undefined;
+    referencePriceSnapshotsByProvider: {
+        [key: string]: {
+            /** @enum {string} */
+            provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+            /** @example 149.5 */
+            price: number;
+            /**
+             * @description ISO-4217 currency code
+             * @example SEK
+             */
+            currency: string;
+            /**
+             * @description price converted to SEK at the rate stored on the row
+             * @example 149.5
+             */
+            priceSek: number;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            snapshotDate: string;
+        };
+    };
+};
 /** A card or sealed product, discriminated on `kind`. */
 type CatalogItem = Card | SealedProduct;
-type CardVariants = NonNullable<Card['variants']>;
+type CardVariants = {
+    normal: boolean;
+    holo: boolean;
+    reverse: boolean;
+    firstEdition: boolean;
+    wPromo: boolean;
+};
 /** The compact item reference used inside flat shop-match rows (`client.shopMatches.list()` /
  * `.forShop()`), enough to render a result list, not the full `CatalogItem`. */
-type MatchedItemRef = NonNullable<components['schemas']['ShopMatchWithItem']['item']>;
+type MatchedItemRef = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    /** @enum {string} */
+    kind: "card" | "sealed";
+    name: string;
+    shortName: string | undefined;
+    technicalName: string;
+    cardNumber: string | undefined;
+    imageUrl: string | undefined;
+    language: string | undefined;
+    priceChartingId: string | undefined;
+};
 /** One shop listing currently discounted relative to a reference price (retail, Tradera, or
  * Cardmarket). Returned by `client.bargains.list()` / `client.bargains.search()`. */
-type Bargain = components['schemas']['BargainListResponse']['data'][number];
-type BargainProductRef = Bargain['product'];
-
+type Bargain = {
+    url: string;
+    /** @example 149.5 */
+    price: number | undefined;
+    /**
+     * @description ISO-4217 currency code
+     * @example SEK
+     */
+    currency: string | undefined;
+    shop: {
+        /** @example cardlevels */
+        technicalName: string;
+        /** @example Cardlevels */
+        name: string;
+    };
+    inStock: boolean;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    matchedAt: string;
+    product: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @enum {string} */
+        kind: "sealed" | "card";
+        name: string;
+        technicalName: string;
+        imageUrl: string | undefined;
+    };
+    bargain: {
+        discountPercent: number;
+        /** @enum {string} */
+        referenceSource: "retail" | "tradera" | "cardmarket";
+    };
+};
+type BargainProductRef = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    /** @enum {string} */
+    kind: "sealed" | "card";
+    name: string;
+    technicalName: string;
+    imageUrl: string | undefined;
+};
 /** A set/expansion, as returned by `client.expansions.list()`. This is the full record. The
  * `expansion` field embedded on a card or product is the smaller `ExpansionRef` from
  * `types/common.ts`. */
-type Expansion = components['schemas']['Expansion'];
+type Expansion = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    /** @example Mega Evolution 30th Celebration */
+    name: string;
+    /** @example 30th Celebration */
+    shortName: string;
+    /** @example jpn-mega-evolution-30th-celebration */
+    technicalName: string;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string}
+     */
+    language: "ENG" | "JPN" | "CHI";
+    /** @example m6a */
+    code: string | undefined;
+    /** @example m6a */
+    cardCode: string | undefined;
+    /** @example Mega Evolution */
+    seriesName: string | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    releaseDate: string | undefined;
+    /**
+     * @description Absolute asset URL, or null when absent
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    logoUrl: string | undefined;
+    /**
+     * @description Absolute asset URL, or null when absent
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    symbolUrl: string | undefined;
+    /**
+     * @description Absolute asset URL, or null when absent
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    imageUrl: string | undefined;
+    year: number | undefined;
+    brand: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Pokémon */
+        name: string;
+        /** @example pokemon */
+        technicalName: 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;
+    };
+    alternativeNames: {
+        name: string;
+        shortName: string | undefined;
+    }[];
+    /** @description Sealed products in this expansion */
+    sealedCount: number;
+    /** @description Cards in this expansion */
+    cardCount: number;
+    /** @description Sealed products plus cards */
+    productCount: number;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    createdAt: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    updatedAt: string;
+};
 /** 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 = components['schemas']['ExpansionContents'];
-
-type ShopMatchWithItemSchema = components['schemas']['ShopMatchWithItem'];
-type ItemShopMatchSchema = components['schemas']['ItemShopMatches']['data'][number];
-/** A shop tracked by tcgpriser, as returned by `client.shops.list()` / `client.shops.get()`. The
- * `*Count` fields are `undefined` when the shop has never had a match computed (rather than `0`, which
- * would mean "matched, currently empty"). */
-type Shop = components['schemas']['Shop'];
-/** The lighter shop shape embedded in shop-match responses: a subset of `Shop`, no id or delivery
- * cost breakdown. */
-type ShopSummary = components['schemas']['ShopMatchStats']['shop'];
-type CardType = NonNullable<ShopMatchWithItemSchema['cardType']>;
-type ItemCondition = NonNullable<ShopMatchWithItemSchema['itemCondition']>;
-type GradingCompany = NonNullable<ShopMatchWithItemSchema['gradingCompany']>;
-/** A shop's listing matched (or not yet matched) to a catalog item. Returned by
- * `client.shopMatches.list()` and as the rows inside `client.shopMatches.forShop()`. */
-type ShopMatch = ShopMatchWithItemSchema;
-type ShopMatchDelivery = ItemShopMatchSchema['shop']['delivery'];
-/** 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 = components['schemas']['ItemShopMatches'];
-/** Response of `client.shopMatches.forShop()`: every match, of any item, currently live at one shop. */
-type ShopMatchesForShop = components['schemas']['ShopMatchesForShop'];
-/** One row of `client.shopMatches.shopStats()`: match counts per shop, not the matches themselves. */
-type ShopMatchStats = components['schemas']['ShopMatchStats'];
-
-/** A named `{ id, name }` reference to a card or product: the compact identity used by every
- * `price-stats` response, which is keyed by item rather than embedding the full catalog record. */
-type ItemRef = components['schemas']['ItemDailyStats']['item'];
-/** One day's average price for one item. */
-type DailyPricePoint = components['schemas']['ItemDailyStats']['dailyStats'][number];
-/** Response row of `client.priceStats.daily()`. */
-type ItemDailyStats = components['schemas']['ItemDailyStats'];
-type EstimatedValue = components['schemas']['ItemEstimatedValue']['estimate'];
-/** Response row of `client.priceStats.estimatedValues()`. */
-type ItemEstimatedValue = components['schemas']['ItemEstimatedValue'];
-/** Response row of `client.priceStats.topProducts()`: items ranked by shop availability, not price. */
-type TopItem = components['schemas']['TopItem'];
-
-/** One rarity's share of a booster pack's pulls. `weight` is relative to the other buckets in the
- * same pack rate, not a percentage. Normalise across `buckets` yourself if you need one. */
-type PackRateBucket = components['schemas']['PackRate']['buckets'][number];
-/** Pull-rate odds for one expansion's booster packs, as returned by `client.packRates.list()` /
- * `client.packRates.get()`. */
-type PackRate = components['schemas']['PackRate'];
-
-/** Platform-wide overview counts, returned by `client.stats.platform()`. */
-type PlatformStats = components['schemas']['PlatformStats'];
-
-/**
- * Types for the premium tier: endpoints that need a signed-in subscriber's JWT (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`.
- *
- * Derived from `src/generated/openapi.d.ts`, same as everything else in this directory.
- */
-
-type ReferencePriceSeries = components['schemas']['ItemReferencePrices']['series'][number];
-type ReferencePriceSeriesPoint = ReferencePriceSeries['points'][number];
-type ReferencePriceSource = ReferencePriceSeries['source'];
-type ReferencePriceCardVariant = NonNullable<ReferencePriceSeries['variant']>;
-type ReferencePriceMetric = components['schemas']['ItemReferencePrices']['metric'];
-type ReferencePriceCurrencyMode = components['schemas']['ItemReferencePrices']['currencyMode'];
-/** Response of `client.cards.referencePrices()` / `client.products.referencePrices()`.
- *
- * Non-graded card prices come from TCGdex and are variant-aware (normal / holo / reverse). Graded
- * prices and eBay medians come from cmapi. Tradera is tcgpriser's own data: realised Swedish
- * auction sales rather than asking prices, always SEK, no variant. In native mode each series
- * keeps its own `currency`; in `sek` mode everything is `SEK`, converted at the rate stored on
- * each point. */
-type ItemReferencePrices = components['schemas']['ItemReferencePrices'];
-type SoldPrice = components['schemas']['ItemSoldPrices']['data'][number];
-/** Response of `client.cards.prices()` / `client.products.prices()`. `premiumRequired` is always
- * `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 = components['schemas']['ItemSoldPrices'];
-type LivePricingDetail = components['schemas']['LivePricingForItem']['pricing'];
-/** Response of `client.cards.livePricing()` / `client.products.livePricing()`. */
-type LivePricingForItem = components['schemas']['LivePricingForItem'];
-/** Response of `client.expansions.livePricing()`: live pricing for every item in one expansion. */
-type ExpansionLivePricing = components['schemas']['ExpansionLivePricing'];
-/** The catalog item as embedded in stats responses: a `Card`/`SealedProduct` minus
- * `lowestShopOffer` and `referencePriceSnapshotsByProvider`, which these endpoints already answer
- * more precisely on their own. */
-type StatsItemRef = components['schemas']['ItemStats']['item'];
-type VariantStatsSummary = components['schemas']['ItemStats']['variantStats'];
-/** Response of `client.priceStats.product()`. */
-type ItemStats = components['schemas']['ItemStats'];
-/** Response of `client.priceStats.productFull()`: everything `product()` has, plus the item's
- * current shop matches. */
-type ItemFullStats = components['schemas']['ItemFullStats'];
-type VariantPriceStat = components['schemas']['ItemVariantStats']['variants']['loose'][string];
-/** Response of `client.priceStats.productByVariant()`. The generated shape keys `loose`/`graded`
- * by a bare `string` (JSON Schema `additionalProperties` doesn't carry an enum), re-keyed here by
- * `ItemCondition`/`GradingCompany` for real autocomplete. Only hand-written wrapper in this file.
- * `graded` has a second string-keyed level for grade (`10`, `9.5` etc, straight from a JSON key). */
-interface ItemVariantStats {
-    item: components['schemas']['ItemVariantStats']['item'];
-    variants: {
-        loose: Partial<Record<ItemCondition, VariantPriceStat>>;
-        graded: Partial<Record<GradingCompany, Record<string, VariantPriceStat>>>;
+type ExpansionContents = {
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
     };
-}
-type VariantSelector = components['schemas']['ItemVariantDailyStats']['variant'];
-/** Response of `client.priceStats.productDailyByVariant()`. */
-type ItemVariantDailyStats = components['schemas']['ItemVariantDailyStats'];
-type ShopPricePoint = components['schemas']['ItemShopPriceHistory']['shops'][number]['history'][number];
-/** Response of `client.shopMatchStats.forProduct()`: one product's price history, broken out per
- * shop. */
-type ItemShopPriceHistory = components['schemas']['ItemShopPriceHistory'];
-/** Response of `client.shopMatchStats.forShop()`: one shop's price history, broken out per
- * product. */
-type ShopPriceHistoryList = components['schemas']['ShopPriceHistoryList'];
-type ShopPriceComparisonRow = components['schemas']['ItemPriceComparison']['items'][number];
-type ShopPriceComparisonStats = NonNullable<components['schemas']['ItemPriceComparison']['stats']>;
-/** 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 = components['schemas']['ItemPriceComparison'];
-type ShopUrlStatus = components['schemas']['ShopUrlMutationResult']['shopUrl']['status'];
-type ShopUrlDiscoveredBy = components['schemas']['ShopUrlMutationResult']['shopUrl']['discoveredBy'];
-/** A URL at a shop that tcgpriser scrapes, and what it has been matched to. */
-type ShopUrl = components['schemas']['ShopUrlMutationResult']['shopUrl'];
-/** Response of `client.shopUrls.submit()` / `client.shopUrls.assignProduct()`. */
-type ShopUrlMutationResult = components['schemas']['ShopUrlMutationResult'];
-
+    cards: {
+        count: number;
+        items: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            name: string;
+            shortName: string | undefined;
+            technicalName: string;
+            brand: {
+                /**
+                 * @description Resource identifier
+                 * @example 6a577711abc1ce71383d3e10
+                 */
+                id: string;
+                /** @example Pokémon */
+                name: string;
+                /** @example pokemon */
+                technicalName: 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;
+            };
+            manufacturer: string;
+            modelNumber: string | undefined;
+            category: {
+                /**
+                 * @description Resource identifier
+                 * @example 6a577711abc1ce71383d3e10
+                 */
+                id: string;
+                /** @example Booster Box */
+                name: string;
+                /** @example booster-box */
+                technicalName: string;
+            } | undefined;
+            expansion: {
+                /**
+                 * @description Resource identifier
+                 * @example 6a577711abc1ce71383d3e10
+                 */
+                id: string;
+                /** @example Mega Evolution 30th Celebration */
+                name: string;
+                /** @example 30th Celebration */
+                shortName: string;
+                /** @example jpn-mega-evolution-30th-celebration */
+                technicalName: string;
+                /**
+                 * @description Printing language of the item
+                 * @example JPN
+                 * @enum {string}
+                 */
+                language: "ENG" | "JPN" | "CHI";
+                /** @example m6a */
+                code: string | undefined;
+                /** @example m6a */
+                cardCode: string | undefined;
+                /** @example Mega Evolution */
+                seriesName: string | undefined;
+                /**
+                 * Format: date-time
+                 * @example 2026-07-15T12:03:29.322Z
+                 */
+                releaseDate: string | undefined;
+                /**
+                 * @description Absolute asset URL, or null when absent
+                 * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+                 */
+                logoUrl: string | undefined;
+                /**
+                 * @description Absolute asset URL, or null when absent
+                 * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+                 */
+                symbolUrl: string | undefined;
+                /**
+                 * @description Absolute asset URL, or null when absent
+                 * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+                 */
+                imageUrl: string | undefined;
+            } | undefined;
+            /**
+             * @description Printing language of the item
+             * @example JPN
+             * @enum {string|null}
+             */
+            language: "ENG" | "JPN" | "CHI" | undefined;
+            alternativeNames: {
+                name: string;
+                shortName: string | undefined;
+            }[];
+            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: "card";
+            /** @example 4/102 */
+            cardNumber: string;
+            /** @example Rare Holo */
+            rarity: string | undefined;
+            artist: string | undefined;
+            cardmarketId: string | undefined;
+            tcgplayerId: string | undefined;
+            variants: {
+                normal: boolean;
+                holo: boolean;
+                reverse: boolean;
+                firstEdition: boolean;
+                wPromo: boolean;
+            } | undefined;
+            prisjaktId: string | undefined;
+            lowestShopOffer: {
+                shop: {
+                    /** @example cardlevels */
+                    technicalName: string;
+                    /** @example Cardlevels */
+                    name: string;
+                };
+                url: string;
+                /** @example 149.5 */
+                price: number;
+                /**
+                 * @description ISO-4217 currency code
+                 * @example SEK
+                 */
+                currency: string;
+                inStock: boolean;
+                inPreorder: boolean;
+                inMonitor: boolean;
+                isFullyBooked: boolean;
+                /**
+                 * Format: date-time
+                 * @example 2026-07-15T12:03:29.322Z
+                 */
+                matchedAt: string;
+                /**
+                 * Format: date-time
+                 * @example 2026-07-15T12:03:29.322Z
+                 */
+                updatedAt: string;
+                bargain: {
+                    discountPercent: number;
+                    /** @enum {string} */
+                    referenceSource: "retail" | "tradera" | "cardmarket";
+                } | undefined;
+            } | undefined;
+            referencePriceSnapshotsByProvider: {
+                [key: string]: {
+                    /** @enum {string} */
+                    provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+                    /** @example 149.5 */
+                    price: number;
+                    /**
+                     * @description ISO-4217 currency code
+                     * @example SEK
+                     */
+                    currency: string;
+                    /**
+                     * @description price converted to SEK at the rate stored on the row
+                     * @example 149.5
+                     */
+                    priceSek: number;
+                    /**
+                     * Format: date-time
+                     * @example 2026-07-15T12:03:29.322Z
+                     */
+                    snapshotDate: string;
+                };
+            };
+        }[];
+    };
+    sealed: {
+        count: number;
+        items: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            name: string;
+            shortName: string | undefined;
+            technicalName: string;
+            brand: {
+                /**
+                 * @description Resource identifier
+                 * @example 6a577711abc1ce71383d3e10
+                 */
+                id: string;
+                /** @example Pokémon */
+                name: string;
+                /** @example pokemon */
+                technicalName: 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;
+            };
+            manufacturer: string;
+            modelNumber: string | undefined;
+            category: {
+                /**
+                 * @description Resource identifier
+                 * @example 6a577711abc1ce71383d3e10
+                 */
+                id: string;
+                /** @example Booster Box */
+                name: string;
+                /** @example booster-box */
+                technicalName: string;
+            } | undefined;
+            expansion: {
+                /**
+                 * @description Resource identifier
+                 * @example 6a577711abc1ce71383d3e10
+                 */
+                id: string;
+                /** @example Mega Evolution 30th Celebration */
+                name: string;
+                /** @example 30th Celebration */
+                shortName: string;
+                /** @example jpn-mega-evolution-30th-celebration */
+                technicalName: string;
+                /**
+                 * @description Printing language of the item
+                 * @example JPN
+                 * @enum {string}
+                 */
+                language: "ENG" | "JPN" | "CHI";
+                /** @example m6a */
+                code: string | undefined;
+                /** @example m6a */
+                cardCode: string | undefined;
+                /** @example Mega Evolution */
+                seriesName: string | undefined;
+                /**
+                 * Format: date-time
+                 * @example 2026-07-15T12:03:29.322Z
+                 */
+                releaseDate: string | undefined;
+                /**
+                 * @description Absolute asset URL, or null when absent
+                 * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+                 */
+                logoUrl: string | undefined;
+                /**
+                 * @description Absolute asset URL, or null when absent
+                 * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+                 */
+                symbolUrl: string | undefined;
+                /**
+                 * @description Absolute asset URL, or null when absent
+                 * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+                 */
+                imageUrl: string | undefined;
+            } | undefined;
+            /**
+             * @description Printing language of the item
+             * @example JPN
+             * @enum {string|null}
+             */
+            language: "ENG" | "JPN" | "CHI" | undefined;
+            alternativeNames: {
+                name: string;
+                shortName: string | undefined;
+            }[];
+            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: {
+                shop: {
+                    /** @example cardlevels */
+                    technicalName: string;
+                    /** @example Cardlevels */
+                    name: string;
+                };
+                url: string;
+                /** @example 149.5 */
+                price: number;
+                /**
+                 * @description ISO-4217 currency code
+                 * @example SEK
+                 */
+                currency: string;
+                inStock: boolean;
+                inPreorder: boolean;
+                inMonitor: boolean;
+                isFullyBooked: boolean;
+                /**
+                 * Format: date-time
+                 * @example 2026-07-15T12:03:29.322Z
+                 */
+                matchedAt: string;
+                /**
+                 * Format: date-time
+                 * @example 2026-07-15T12:03:29.322Z
+                 */
+                updatedAt: string;
+                bargain: {
+                    discountPercent: number;
+                    /** @enum {string} */
+                    referenceSource: "retail" | "tradera" | "cardmarket";
+                } | undefined;
+            } | undefined;
+            referencePriceSnapshotsByProvider: {
+                [key: string]: {
+                    /** @enum {string} */
+                    provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+                    /** @example 149.5 */
+                    price: number;
+                    /**
+                     * @description ISO-4217 currency code
+                     * @example SEK
+                     */
+                    currency: string;
+                    /**
+                     * @description price converted to SEK at the rate stored on the row
+                     * @example 149.5
+                     */
+                    priceSek: number;
+                    /**
+                     * Format: date-time
+                     * @example 2026-07-15T12:03:29.322Z
+                     */
+                    snapshotDate: string;
+                };
+            };
+        }[];
+    };
+};
+/** One card as embedded in `client.expansions.products()`'s `cards` group. The API inlines this
+ * rather than `$ref`-ing `CardWithPricing`, so it's a separately-named (if structurally identical)
+ * shape rather than literally `Card`. */
+type ExpansionCard = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+    shortName: string | undefined;
+    technicalName: string;
+    brand: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Pokémon */
+        name: string;
+        /** @example pokemon */
+        technicalName: 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;
+    };
+    manufacturer: string;
+    modelNumber: string | undefined;
+    category: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Booster Box */
+        name: string;
+        /** @example booster-box */
+        technicalName: string;
+    } | undefined;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    } | undefined;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string|null}
+     */
+    language: "ENG" | "JPN" | "CHI" | undefined;
+    alternativeNames: {
+        name: string;
+        shortName: string | undefined;
+    }[];
+    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: "card";
+    /** @example 4/102 */
+    cardNumber: string;
+    /** @example Rare Holo */
+    rarity: string | undefined;
+    artist: string | undefined;
+    cardmarketId: string | undefined;
+    tcgplayerId: string | undefined;
+    variants: {
+        normal: boolean;
+        holo: boolean;
+        reverse: boolean;
+        firstEdition: boolean;
+        wPromo: boolean;
+    } | undefined;
+    prisjaktId: string | undefined;
+    lowestShopOffer: {
+        shop: {
+            /** @example cardlevels */
+            technicalName: string;
+            /** @example Cardlevels */
+            name: string;
+        };
+        url: string;
+        /** @example 149.5 */
+        price: number;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string;
+        inStock: boolean;
+        inPreorder: boolean;
+        inMonitor: boolean;
+        isFullyBooked: boolean;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        matchedAt: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        updatedAt: string;
+        bargain: {
+            discountPercent: number;
+            /** @enum {string} */
+            referenceSource: "retail" | "tradera" | "cardmarket";
+        } | undefined;
+    } | undefined;
+    referencePriceSnapshotsByProvider: {
+        [key: string]: {
+            /** @enum {string} */
+            provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+            /** @example 149.5 */
+            price: number;
+            /**
+             * @description ISO-4217 currency code
+             * @example SEK
+             */
+            currency: string;
+            /**
+             * @description price converted to SEK at the rate stored on the row
+             * @example 149.5
+             */
+            priceSek: number;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            snapshotDate: string;
+        };
+    };
+};
+/** One sealed product as embedded in `client.expansions.products()`'s `sealed` group. Same caveat
+ * as `ExpansionCard`: inlined by the API, not `$ref`-ing `ProductWithPricing`. */
+type ExpansionSealedProduct = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+    shortName: string | undefined;
+    technicalName: string;
+    brand: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Pokémon */
+        name: string;
+        /** @example pokemon */
+        technicalName: 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;
+    };
+    manufacturer: string;
+    modelNumber: string | undefined;
+    category: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Booster Box */
+        name: string;
+        /** @example booster-box */
+        technicalName: string;
+    } | undefined;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    } | undefined;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string|null}
+     */
+    language: "ENG" | "JPN" | "CHI" | undefined;
+    alternativeNames: {
+        name: string;
+        shortName: string | undefined;
+    }[];
+    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: {
+        shop: {
+            /** @example cardlevels */
+            technicalName: string;
+            /** @example Cardlevels */
+            name: string;
+        };
+        url: string;
+        /** @example 149.5 */
+        price: number;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string;
+        inStock: boolean;
+        inPreorder: boolean;
+        inMonitor: boolean;
+        isFullyBooked: boolean;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        matchedAt: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        updatedAt: string;
+        bargain: {
+            discountPercent: number;
+            /** @enum {string} */
+            referenceSource: "retail" | "tradera" | "cardmarket";
+        } | undefined;
+    } | undefined;
+    referencePriceSnapshotsByProvider: {
+        [key: string]: {
+            /** @enum {string} */
+            provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+            /** @example 149.5 */
+            price: number;
+            /**
+             * @description ISO-4217 currency code
+             * @example SEK
+             */
+            currency: string;
+            /**
+             * @description price converted to SEK at the rate stored on the row
+             * @example 149.5
+             */
+            priceSek: number;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            snapshotDate: string;
+        };
+    };
+};
+type ShopMatchWithItemSchema = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    shop: {
+        /** @example cardlevels */
+        technicalName: string;
+        /** @example Cardlevels */
+        name: string;
+    };
+    url: string;
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    shopUrlId: string | undefined;
+    /** @example 149.5 */
+    price: number | undefined;
+    /**
+     * @description ISO-4217 currency code
+     * @example SEK
+     */
+    currency: string | undefined;
+    inStock: boolean;
+    inPreorder: boolean;
+    inMonitor: boolean;
+    isFullyBooked: boolean;
+    scrapedName: string | undefined;
+    scrapedType: string | undefined;
+    matchScore: number | undefined;
+    hasCategoryMismatch: boolean;
+    /** @enum {string|null} */
+    cardType: "loose" | "graded" | undefined;
+    /** @enum {string|null} */
+    itemCondition: "NM" | "LP" | "MP" | "HP" | "DMG" | undefined;
+    /** @enum {string|null} */
+    gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+    grade: number | undefined;
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @enum {string} */
+        kind: "card" | "sealed";
+        name: string;
+        shortName: string | undefined;
+        technicalName: string;
+        cardNumber: string | undefined;
+        imageUrl: string | undefined;
+        language: string | undefined;
+        priceChartingId: string | undefined;
+    } | undefined;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    } | undefined;
+    category: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Booster Box */
+        name: string;
+        /** @example booster-box */
+        technicalName: string;
+    } | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    matchedAt: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    updatedAt: string;
+    bargain: {
+        discountPercent: number;
+        /** @enum {string} */
+        referenceSource: "retail" | "tradera" | "cardmarket";
+    } | undefined;
+};
+type ItemShopMatchSchema = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    shop: {
+        /** @example cardlevels */
+        technicalName: string;
+        /** @example Cardlevels */
+        name: string;
+        delivery: {
+            /** @example 149.5 */
+            cost: number | undefined;
+            currency: string | undefined;
+            daysMin: number | undefined;
+            daysMax: number | undefined;
+            /** @example 149.5 */
+            freeShippingThreshold: number | undefined;
+            supportsLocalPickup: boolean | undefined;
+            note: string | undefined;
+        };
+    };
+    url: string;
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    shopUrlId: string | undefined;
+    /** @example 149.5 */
+    price: number | undefined;
+    /**
+     * @description ISO-4217 currency code
+     * @example SEK
+     */
+    currency: string | undefined;
+    inStock: boolean;
+    inPreorder: boolean;
+    inMonitor: boolean;
+    isFullyBooked: boolean;
+    scrapedName: string | undefined;
+    scrapedType: string | undefined;
+    matchScore: number | undefined;
+    hasCategoryMismatch: boolean;
+    /** @enum {string|null} */
+    cardType: "loose" | "graded" | undefined;
+    /** @enum {string|null} */
+    itemCondition: "NM" | "LP" | "MP" | "HP" | "DMG" | undefined;
+    /** @enum {string|null} */
+    gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+    grade: number | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    matchedAt: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    updatedAt: string;
+    bargain: {
+        discountPercent: number;
+        /** @enum {string} */
+        referenceSource: "retail" | "tradera" | "cardmarket";
+    } | undefined;
+};
+/** A shop tracked by tcgpriser, as returned by `client.shops.list()` / `client.shops.get()`. The
+ * `*Count` fields are `undefined` when the shop has never had a match computed (rather than `0`, which
+ * would mean "matched, currently empty"). */
+type Shop = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    /** @example Cardlevels */
+    name: string;
+    /** @example cardlevels */
+    technicalName: string;
+    websiteUrl: string | undefined;
+    /**
+     * @description Absolute asset URL, or null when absent
+     * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+     */
+    logoUrl: string | undefined;
+    description: string | undefined;
+    /** @example 149.5 */
+    defaultDeliveryCost: number | undefined;
+    /**
+     * @description ISO-4217, or null
+     * @example SEK
+     */
+    deliveryCurrency: string | undefined;
+    deliveryDaysMin: number | undefined;
+    deliveryDaysMax: number | undefined;
+    /** @example 149.5 */
+    freeShippingThreshold: number | undefined;
+    supportsLocalPickup: boolean;
+    deliveryNote: string | undefined;
+    isActive: boolean;
+    isTemporarilyClosed: boolean;
+    isOptedOut: boolean;
+    matchCount: number | undefined;
+    /** @description Matches resolved to a catalog item */
+    linkedMatchCount: number | undefined;
+    inStockCount: number | undefined;
+    preorderCount: number | undefined;
+    monitorCount: number | undefined;
+    fullyBookedCount: number | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    lastMatchedAt: 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;
+};
+/** The lighter shop shape embedded in shop-match responses: a subset of `Shop`, no id or delivery
+ * cost breakdown. */
+type ShopSummary = {
+    technicalName: string;
+    name: string;
+    logoUrl: string | undefined;
+    websiteUrl: string | undefined;
+    description: string | undefined;
+    isActive: boolean;
+    isTemporarilyClosed: boolean;
+    isOptedOut: boolean;
+    deliveryNote: string | undefined;
+};
+type CardType = "loose" | "graded";
+type ItemCondition = "NM" | "LP" | "MP" | "HP" | "DMG";
+type GradingCompany = "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA";
+/** A shop's listing matched (or not yet matched) to a catalog item. Returned by
+ * `client.shopMatches.list()` and as the rows inside `client.shopMatches.forShop()`. */
+type ShopMatch = ShopMatchWithItemSchema;
+type ShopMatchDelivery = {
+    /** @example 149.5 */
+    cost: number | undefined;
+    currency: string | undefined;
+    daysMin: number | undefined;
+    daysMax: number | undefined;
+    /** @example 149.5 */
+    freeShippingThreshold: number | undefined;
+    supportsLocalPickup: boolean | undefined;
+    note: string | undefined;
+};
+/** 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: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    data: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        shop: {
+            /** @example cardlevels */
+            technicalName: string;
+            /** @example Cardlevels */
+            name: string;
+            delivery: {
+                /** @example 149.5 */
+                cost: number | undefined;
+                currency: string | undefined;
+                daysMin: number | undefined;
+                daysMax: number | undefined;
+                /** @example 149.5 */
+                freeShippingThreshold: number | undefined;
+                supportsLocalPickup: boolean | undefined;
+                note: string | undefined;
+            };
+        };
+        url: string;
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        shopUrlId: string | undefined;
+        /** @example 149.5 */
+        price: number | undefined;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string | undefined;
+        inStock: boolean;
+        inPreorder: boolean;
+        inMonitor: boolean;
+        isFullyBooked: boolean;
+        scrapedName: string | undefined;
+        scrapedType: string | undefined;
+        matchScore: number | undefined;
+        hasCategoryMismatch: boolean;
+        /** @enum {string|null} */
+        cardType: "loose" | "graded" | undefined;
+        /** @enum {string|null} */
+        itemCondition: "NM" | "LP" | "MP" | "HP" | "DMG" | undefined;
+        /** @enum {string|null} */
+        gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+        grade: number | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        matchedAt: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        updatedAt: string;
+        bargain: {
+            discountPercent: number;
+            /** @enum {string} */
+            referenceSource: "retail" | "tradera" | "cardmarket";
+        } | undefined;
+    }[];
+    pagination: {
+        /** @description Total matching records, ignoring pagination */
+        total: number;
+        limit: number;
+        skip: number;
+        hasMore: boolean;
+    };
+};
+/** Response of `client.shopMatches.forShop()`: every match, of any item, currently live at one shop. */
+type ShopMatchesForShop = {
+    shop: {
+        technicalName: string;
+        name: string;
+        logoUrl: string | undefined;
+        websiteUrl: string | undefined;
+        description: string | undefined;
+        isActive: boolean;
+        isTemporarilyClosed: boolean;
+        isOptedOut: boolean;
+        deliveryNote: string | undefined;
+    } | undefined;
+    data: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        shop: {
+            /** @example cardlevels */
+            technicalName: string;
+            /** @example Cardlevels */
+            name: string;
+        };
+        url: string;
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        shopUrlId: string | undefined;
+        /** @example 149.5 */
+        price: number | undefined;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string | undefined;
+        inStock: boolean;
+        inPreorder: boolean;
+        inMonitor: boolean;
+        isFullyBooked: boolean;
+        scrapedName: string | undefined;
+        scrapedType: string | undefined;
+        matchScore: number | undefined;
+        hasCategoryMismatch: boolean;
+        /** @enum {string|null} */
+        cardType: "loose" | "graded" | undefined;
+        /** @enum {string|null} */
+        itemCondition: "NM" | "LP" | "MP" | "HP" | "DMG" | undefined;
+        /** @enum {string|null} */
+        gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+        grade: number | undefined;
+        item: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @enum {string} */
+            kind: "card" | "sealed";
+            name: string;
+            shortName: string | undefined;
+            technicalName: string;
+            cardNumber: string | undefined;
+            imageUrl: string | undefined;
+            language: string | undefined;
+            priceChartingId: string | undefined;
+        } | undefined;
+        expansion: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Mega Evolution 30th Celebration */
+            name: string;
+            /** @example 30th Celebration */
+            shortName: string;
+            /** @example jpn-mega-evolution-30th-celebration */
+            technicalName: string;
+            /**
+             * @description Printing language of the item
+             * @example JPN
+             * @enum {string}
+             */
+            language: "ENG" | "JPN" | "CHI";
+            /** @example m6a */
+            code: string | undefined;
+            /** @example m6a */
+            cardCode: string | undefined;
+            /** @example Mega Evolution */
+            seriesName: string | undefined;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            releaseDate: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            logoUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            symbolUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            imageUrl: string | undefined;
+        } | undefined;
+        category: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Booster Box */
+            name: string;
+            /** @example booster-box */
+            technicalName: string;
+        } | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        matchedAt: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        updatedAt: string;
+        bargain: {
+            discountPercent: number;
+            /** @enum {string} */
+            referenceSource: "retail" | "tradera" | "cardmarket";
+        } | undefined;
+    }[];
+    pagination: {
+        /** @description Total matching records, ignoring pagination */
+        total: number;
+        limit: number;
+        skip: number;
+        hasMore: boolean;
+    };
+};
+/** One row of `client.shopMatches.shopStats()`: match counts per shop, not the matches themselves. */
+type ShopMatchStats = {
+    shop: {
+        technicalName: string;
+        name: string;
+        logoUrl: string | undefined;
+        websiteUrl: string | undefined;
+        description: string | undefined;
+        isActive: boolean;
+        isTemporarilyClosed: boolean;
+        isOptedOut: boolean;
+        deliveryNote: string | undefined;
+    };
+    matchCount: number;
+    /** @description Matches resolved to a catalog item */
+    linkedMatchCount: number;
+    inStockCount: number;
+    preorderCount: number;
+    monitorCount: number;
+    fullyBookedCount: number;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    lastMatchedAt: string | undefined;
+};
+/** A named `{ id, name }` reference to a card or product: the compact identity used by every
+ * `price-stats` response, which is keyed by item rather than embedding the full catalog record. */
+type ItemRef = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+};
+/** One day's average price for one item. */
+type DailyPricePoint = {
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    statDate: string;
+    /** @example 149.5 */
+    averagePrice: number;
+};
+/** Response row of `client.priceStats.daily()`. */
+type ItemDailyStats = {
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    dailyStats: {
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        statDate: string;
+        /** @example 149.5 */
+        averagePrice: number;
+    }[];
+};
+type EstimatedValue = {
+    /** @example 149.5 */
+    estimatedValue: number | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    estimateUpdatedAt: string | undefined;
+    dataPointCount: number;
+};
+/** Response row of `client.priceStats.estimatedValues()`. */
+type ItemEstimatedValue = {
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    estimate: {
+        /** @example 149.5 */
+        estimatedValue: number | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        estimateUpdatedAt: string | undefined;
+        dataPointCount: number;
+    };
+};
+/** Response row of `client.priceStats.topProducts()`: items ranked by shop availability, not price. */
+type TopItem = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    slug: string | undefined;
+    shopMatchCount: number;
+};
+/** One rarity's share of a booster pack's pulls. `weight` is relative to the other buckets in the
+ * same pack rate, not a percentage. Normalise across `buckets` yourself if you need one. */
+type PackRateBucket = {
+    /** @example Double rare */
+    rarity: string;
+    /**
+     * @description Relative draw weight (normalised across buckets)
+     * @example 24
+     */
+    weight: number;
+};
+/** Pull-rate odds for one expansion's booster packs, as returned by `client.packRates.list()` /
+ * `client.packRates.get()`. */
+type PackRate = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    };
+    buckets: {
+        /** @example Double rare */
+        rarity: string;
+        /**
+         * @description Relative draw weight (normalised across buckets)
+         * @example 24
+         */
+        weight: number;
+    }[];
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    createdAt: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    updatedAt: string;
+};
+/** Platform-wide overview counts, returned by `client.stats.platform()`. */
+type PlatformStats = {
+    shopCount: number;
+    categoryCount: number;
+    expansionCount: number;
+    productCount: number;
+    priceCount: number;
+};
+/**
+ * Types for the premium tier: endpoints that need a signed-in subscriber's JWT (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`.
+ *
+ * Derived from `src/generated/openapi.d.ts`, same as everything else in this directory.
+ */
+type ReferencePriceSeries = {
+    /** @enum {string} */
+    source: "tcgdex" | "cmapi" | "tradera";
+    /** @enum {string} */
+    provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+    /** @enum {string|null} */
+    variant: "normal" | "holo" | "reverse" | undefined;
+    /** @enum {string|null} */
+    cardType: "loose" | "graded" | undefined;
+    /** @enum {string|null} */
+    gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+    grade: number | undefined;
+    currency: string;
+    sampleSize: number | undefined;
+    points: {
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        snapshotDate: string;
+        price: number;
+    }[];
+};
+type ReferencePriceSeriesPoint = {
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    snapshotDate: string;
+    price: number;
+};
+type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi";
+type ReferencePriceCardVariant = "normal" | "holo" | "reverse";
+type ReferencePriceMetric = "price" | "low" | "mid" | "high" | "avg" | "avg1" | "avg7" | "avg30" | "directLow";
+type ReferencePriceCurrencyMode = "native" | "sek";
+/** Response of `client.cards.referencePrices()` / `client.products.referencePrices()`.
+ *
+ * Non-graded card prices come from TCGdex and are variant-aware (normal / holo / reverse). Graded
+ * prices and eBay medians come from cmapi. Tradera is tcgpriser's own data: realised Swedish
+ * auction sales rather than asking prices, always SEK, no variant. In native mode each series
+ * keeps its own `currency`; in `sek` mode everything is `SEK`, converted at the rate stored on
+ * each point. */
+type ItemReferencePrices = {
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    fromDate: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    toDate: string;
+    /** @enum {string} */
+    metric: "price" | "low" | "mid" | "high" | "avg" | "avg1" | "avg7" | "avg30" | "directLow";
+    /** @enum {string} */
+    currencyMode: "native" | "sek";
+    series: {
+        /** @enum {string} */
+        source: "tcgdex" | "cmapi" | "tradera";
+        /** @enum {string} */
+        provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
+        /** @enum {string|null} */
+        variant: "normal" | "holo" | "reverse" | undefined;
+        /** @enum {string|null} */
+        cardType: "loose" | "graded" | undefined;
+        /** @enum {string|null} */
+        gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+        grade: number | undefined;
+        currency: string;
+        sampleSize: number | undefined;
+        points: {
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            snapshotDate: string;
+            price: number;
+        }[];
+    }[];
+};
+type SoldPrice = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    url: string;
+    /** @example 149.5 */
+    price: number;
+    /**
+     * @description ISO-4217 currency code
+     * @example SEK
+     */
+    currency: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    soldAt: string | undefined;
+    itemId: string | undefined;
+    /** @example tradera */
+    source: string | undefined;
+};
+/** Response of `client.cards.prices()` / `client.products.prices()`. `premiumRequired` is always
+ * `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: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    data: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        url: string;
+        /** @example 149.5 */
+        price: number;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        soldAt: string | undefined;
+        itemId: string | undefined;
+        /** @example tradera */
+        source: string | undefined;
+    }[];
+    pagination: {
+        /** @description Total matching records, ignoring pagination */
+        total: number;
+        limit: number;
+        skip: number;
+        hasMore: boolean;
+    };
+    /** @enum {boolean} */
+    premiumRequired: true;
+};
+type LivePricingDetail = {
+    /** @example 149.5 */
+    retailPrice: number | undefined;
+    /** @example 149.5 */
+    estimatedValue: number | undefined;
+    shopCount: number;
+    pricingDataPoints: number;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    calculatedAt: string;
+};
+/** Response of `client.cards.livePricing()` / `client.products.livePricing()`. */
+type LivePricingForItem = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+    technicalName: string;
+    pricing: {
+        /** @example 149.5 */
+        retailPrice: number | undefined;
+        /** @example 149.5 */
+        estimatedValue: number | undefined;
+        shopCount: number;
+        pricingDataPoints: number;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        calculatedAt: string;
+    };
+};
+/** Response of `client.expansions.livePricing()`: live pricing for every item in one expansion. */
+type ExpansionLivePricing = {
+    expansion: {
+        technicalName: string;
+    };
+    items: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+        technicalName: string;
+        pricing: {
+            /** @example 149.5 */
+            retailPrice: number | undefined;
+            /** @example 149.5 */
+            estimatedValue: number | undefined;
+            shopCount: number;
+            pricingDataPoints: number;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            calculatedAt: string;
+        };
+    }[];
+};
+/** The catalog item as embedded in stats responses: a `Card`/`SealedProduct` minus
+ * `lowestShopOffer` and `referencePriceSnapshotsByProvider`, which these endpoints already answer
+ * more precisely on their own. */
+type StatsItemRef = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+    shortName: string | undefined;
+    technicalName: string;
+    brand: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Pokémon */
+        name: string;
+        /** @example pokemon */
+        technicalName: 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;
+    };
+    manufacturer: string;
+    modelNumber: string | undefined;
+    category: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Booster Box */
+        name: string;
+        /** @example booster-box */
+        technicalName: string;
+    } | undefined;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    } | undefined;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string|null}
+     */
+    language: "ENG" | "JPN" | "CHI" | undefined;
+    alternativeNames: {
+        name: string;
+        shortName: string | undefined;
+    }[];
+    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: "card";
+    /** @example 4/102 */
+    cardNumber: string;
+    /** @example Rare Holo */
+    rarity: string | undefined;
+    artist: string | undefined;
+    cardmarketId: string | undefined;
+    tcgplayerId: string | undefined;
+    variants: {
+        normal: boolean;
+        holo: boolean;
+        reverse: boolean;
+        firstEdition: boolean;
+        wPromo: boolean;
+    } | undefined;
+    prisjaktId: string | undefined;
+} | {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    name: string;
+    shortName: string | undefined;
+    technicalName: string;
+    brand: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Pokémon */
+        name: string;
+        /** @example pokemon */
+        technicalName: 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;
+    };
+    manufacturer: string;
+    modelNumber: string | undefined;
+    category: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Booster Box */
+        name: string;
+        /** @example booster-box */
+        technicalName: string;
+    } | undefined;
+    expansion: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        /** @example Mega Evolution 30th Celebration */
+        name: string;
+        /** @example 30th Celebration */
+        shortName: string;
+        /** @example jpn-mega-evolution-30th-celebration */
+        technicalName: string;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string}
+         */
+        language: "ENG" | "JPN" | "CHI";
+        /** @example m6a */
+        code: string | undefined;
+        /** @example m6a */
+        cardCode: string | undefined;
+        /** @example Mega Evolution */
+        seriesName: string | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        releaseDate: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        logoUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        symbolUrl: string | undefined;
+        /**
+         * @description Absolute asset URL, or null when absent
+         * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+         */
+        imageUrl: string | undefined;
+    } | undefined;
+    /**
+     * @description Printing language of the item
+     * @example JPN
+     * @enum {string|null}
+     */
+    language: "ENG" | "JPN" | "CHI" | undefined;
+    alternativeNames: {
+        name: string;
+        shortName: string | undefined;
+    }[];
+    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;
+};
+type VariantStatsSummary = {
+    /** @description Distinct cardType/condition/company/grade combinations */
+    variantCount: number;
+    looseCount: number;
+    gradedCount: number;
+};
+/** Response of `client.priceStats.product()`. */
+type ItemStats = {
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+        shortName: string | undefined;
+        technicalName: string;
+        brand: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Pokémon */
+            name: string;
+            /** @example pokemon */
+            technicalName: 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;
+        };
+        manufacturer: string;
+        modelNumber: string | undefined;
+        category: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Booster Box */
+            name: string;
+            /** @example booster-box */
+            technicalName: string;
+        } | undefined;
+        expansion: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Mega Evolution 30th Celebration */
+            name: string;
+            /** @example 30th Celebration */
+            shortName: string;
+            /** @example jpn-mega-evolution-30th-celebration */
+            technicalName: string;
+            /**
+             * @description Printing language of the item
+             * @example JPN
+             * @enum {string}
+             */
+            language: "ENG" | "JPN" | "CHI";
+            /** @example m6a */
+            code: string | undefined;
+            /** @example m6a */
+            cardCode: string | undefined;
+            /** @example Mega Evolution */
+            seriesName: string | undefined;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            releaseDate: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            logoUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            symbolUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            imageUrl: string | undefined;
+        } | undefined;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string|null}
+         */
+        language: "ENG" | "JPN" | "CHI" | undefined;
+        alternativeNames: {
+            name: string;
+            shortName: string | undefined;
+        }[];
+        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: "card";
+        /** @example 4/102 */
+        cardNumber: string;
+        /** @example Rare Holo */
+        rarity: string | undefined;
+        artist: string | undefined;
+        cardmarketId: string | undefined;
+        tcgplayerId: string | undefined;
+        variants: {
+            normal: boolean;
+            holo: boolean;
+            reverse: boolean;
+            firstEdition: boolean;
+            wPromo: boolean;
+        } | undefined;
+        prisjaktId: string | undefined;
+    } | {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+        shortName: string | undefined;
+        technicalName: string;
+        brand: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Pokémon */
+            name: string;
+            /** @example pokemon */
+            technicalName: 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;
+        };
+        manufacturer: string;
+        modelNumber: string | undefined;
+        category: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Booster Box */
+            name: string;
+            /** @example booster-box */
+            technicalName: string;
+        } | undefined;
+        expansion: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Mega Evolution 30th Celebration */
+            name: string;
+            /** @example 30th Celebration */
+            shortName: string;
+            /** @example jpn-mega-evolution-30th-celebration */
+            technicalName: string;
+            /**
+             * @description Printing language of the item
+             * @example JPN
+             * @enum {string}
+             */
+            language: "ENG" | "JPN" | "CHI";
+            /** @example m6a */
+            code: string | undefined;
+            /** @example m6a */
+            cardCode: string | undefined;
+            /** @example Mega Evolution */
+            seriesName: string | undefined;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            releaseDate: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            logoUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            symbolUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            imageUrl: string | undefined;
+        } | undefined;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string|null}
+         */
+        language: "ENG" | "JPN" | "CHI" | undefined;
+        alternativeNames: {
+            name: string;
+            shortName: string | undefined;
+        }[];
+        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;
+    };
+    dailyStats: {
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        statDate: string;
+        /** @example 149.5 */
+        averagePrice: number;
+    }[];
+    estimate: {
+        /** @example 149.5 */
+        estimatedValue: number | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        estimateUpdatedAt: string | undefined;
+        dataPointCount: number;
+    };
+    variantStats: {
+        /** @description Distinct cardType/condition/company/grade combinations */
+        variantCount: number;
+        looseCount: number;
+        gradedCount: number;
+    };
+};
+/** Response of `client.priceStats.productFull()`: everything `product()` has, plus the item's
+ * current shop matches. */
+type ItemFullStats = {
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+        shortName: string | undefined;
+        technicalName: string;
+        brand: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Pokémon */
+            name: string;
+            /** @example pokemon */
+            technicalName: 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;
+        };
+        manufacturer: string;
+        modelNumber: string | undefined;
+        category: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Booster Box */
+            name: string;
+            /** @example booster-box */
+            technicalName: string;
+        } | undefined;
+        expansion: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Mega Evolution 30th Celebration */
+            name: string;
+            /** @example 30th Celebration */
+            shortName: string;
+            /** @example jpn-mega-evolution-30th-celebration */
+            technicalName: string;
+            /**
+             * @description Printing language of the item
+             * @example JPN
+             * @enum {string}
+             */
+            language: "ENG" | "JPN" | "CHI";
+            /** @example m6a */
+            code: string | undefined;
+            /** @example m6a */
+            cardCode: string | undefined;
+            /** @example Mega Evolution */
+            seriesName: string | undefined;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            releaseDate: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            logoUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            symbolUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            imageUrl: string | undefined;
+        } | undefined;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string|null}
+         */
+        language: "ENG" | "JPN" | "CHI" | undefined;
+        alternativeNames: {
+            name: string;
+            shortName: string | undefined;
+        }[];
+        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: "card";
+        /** @example 4/102 */
+        cardNumber: string;
+        /** @example Rare Holo */
+        rarity: string | undefined;
+        artist: string | undefined;
+        cardmarketId: string | undefined;
+        tcgplayerId: string | undefined;
+        variants: {
+            normal: boolean;
+            holo: boolean;
+            reverse: boolean;
+            firstEdition: boolean;
+            wPromo: boolean;
+        } | undefined;
+        prisjaktId: string | undefined;
+    } | {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+        shortName: string | undefined;
+        technicalName: string;
+        brand: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Pokémon */
+            name: string;
+            /** @example pokemon */
+            technicalName: 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;
+        };
+        manufacturer: string;
+        modelNumber: string | undefined;
+        category: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Booster Box */
+            name: string;
+            /** @example booster-box */
+            technicalName: string;
+        } | undefined;
+        expansion: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            /** @example Mega Evolution 30th Celebration */
+            name: string;
+            /** @example 30th Celebration */
+            shortName: string;
+            /** @example jpn-mega-evolution-30th-celebration */
+            technicalName: string;
+            /**
+             * @description Printing language of the item
+             * @example JPN
+             * @enum {string}
+             */
+            language: "ENG" | "JPN" | "CHI";
+            /** @example m6a */
+            code: string | undefined;
+            /** @example m6a */
+            cardCode: string | undefined;
+            /** @example Mega Evolution */
+            seriesName: string | undefined;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            releaseDate: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            logoUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            symbolUrl: string | undefined;
+            /**
+             * @description Absolute asset URL, or null when absent
+             * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
+             */
+            imageUrl: string | undefined;
+        } | undefined;
+        /**
+         * @description Printing language of the item
+         * @example JPN
+         * @enum {string|null}
+         */
+        language: "ENG" | "JPN" | "CHI" | undefined;
+        alternativeNames: {
+            name: string;
+            shortName: string | undefined;
+        }[];
+        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;
+    };
+    stats: {
+        dailyStats: {
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            statDate: string;
+            /** @example 149.5 */
+            averagePrice: number;
+        }[];
+        variantStats: {
+            /** @description Distinct cardType/condition/company/grade combinations */
+            variantCount: number;
+            looseCount: number;
+            gradedCount: number;
+        };
+    };
+    estimate: {
+        /** @example 149.5 */
+        estimatedValue: number | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        estimateUpdatedAt: string | undefined;
+        dataPointCount: number;
+    };
+    shopMatches: {
+        data: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            shop: {
+                /** @example cardlevels */
+                technicalName: string;
+                /** @example Cardlevels */
+                name: string;
+                delivery: {
+                    /** @example 149.5 */
+                    cost: number | undefined;
+                    currency: string | undefined;
+                    daysMin: number | undefined;
+                    daysMax: number | undefined;
+                    /** @example 149.5 */
+                    freeShippingThreshold: number | undefined;
+                    supportsLocalPickup: boolean | undefined;
+                    note: string | undefined;
+                };
+            };
+            url: string;
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            shopUrlId: string | undefined;
+            /** @example 149.5 */
+            price: number | undefined;
+            /**
+             * @description ISO-4217 currency code
+             * @example SEK
+             */
+            currency: string | undefined;
+            inStock: boolean;
+            inPreorder: boolean;
+            inMonitor: boolean;
+            isFullyBooked: boolean;
+            scrapedName: string | undefined;
+            scrapedType: string | undefined;
+            matchScore: number | undefined;
+            hasCategoryMismatch: boolean;
+            /** @enum {string|null} */
+            cardType: "loose" | "graded" | undefined;
+            /** @enum {string|null} */
+            itemCondition: "NM" | "LP" | "MP" | "HP" | "DMG" | undefined;
+            /** @enum {string|null} */
+            gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+            grade: number | undefined;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            matchedAt: string;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            updatedAt: string;
+            bargain: {
+                discountPercent: number;
+                /** @enum {string} */
+                referenceSource: "retail" | "tradera" | "cardmarket";
+            } | undefined;
+        }[];
+        pagination: {
+            /** @description Total matching records, ignoring pagination */
+            total: number;
+            limit: number;
+            skip: number;
+            hasMore: boolean;
+        };
+    };
+};
+type VariantPriceStat = {
+    /** @example 149.5 */
+    averagePrice: number;
+    dataPointCount: number;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    lastSaleDate: string;
+};
+/** Response of `client.priceStats.productByVariant()`. The generated shape keys `loose`/`graded`
+ * by a bare `string` (JSON Schema `additionalProperties` doesn't carry an enum), re-keyed here by
+ * `ItemCondition`/`GradingCompany` for real autocomplete. Only hand-written wrapper in this file.
+ * `graded` has a second string-keyed level for grade (`10`, `9.5` etc, straight from a JSON key). */
+interface ItemVariantStats {
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    variants: {
+        loose: Partial<Record<ItemCondition, VariantPriceStat>>;
+        graded: Partial<Record<GradingCompany, Record<string, VariantPriceStat>>>;
+    };
+}
+type VariantSelector = {
+    /** @enum {string|null} */
+    cardType: "loose" | "graded" | undefined;
+    /** @enum {string|null} */
+    condition: "NM" | "LP" | "MP" | "HP" | "DMG" | undefined;
+    /** @enum {string|null} */
+    gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+    grade: number | undefined;
+};
+/** Response of `client.priceStats.productDailyByVariant()`. */
+type ItemVariantDailyStats = {
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    variant: {
+        /** @enum {string|null} */
+        cardType: "loose" | "graded" | undefined;
+        /** @enum {string|null} */
+        condition: "NM" | "LP" | "MP" | "HP" | "DMG" | undefined;
+        /** @enum {string|null} */
+        gradingCompany: "PSA" | "BGS" | "CGC" | "SGC" | "ACE" | "RAUKCARD" | "TAG" | "GMA" | undefined;
+        grade: number | undefined;
+    };
+    dailyStats: {
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        statDate: string;
+        /** @example 149.5 */
+        averagePrice: number;
+    }[];
+};
+type ShopPricePoint = {
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    snapshotDate: string;
+    /** @example 149.5 */
+    price: number;
+    /**
+     * @description ISO-4217 currency code
+     * @example SEK
+     */
+    currency: string;
+    inStock: boolean;
+    url: string;
+};
+/** Response of `client.shopMatchStats.forProduct()`: one product's price history, broken out per
+ * shop. */
+type ItemShopPriceHistory = {
+    item: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    shops: {
+        /** @description The shop's technicalName */
+        shop: string;
+        history: {
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            snapshotDate: string;
+            /** @example 149.5 */
+            price: number;
+            /**
+             * @description ISO-4217 currency code
+             * @example SEK
+             */
+            currency: string;
+            inStock: boolean;
+            url: string;
+        }[];
+    }[];
+    recordCount: number;
+};
+/** Response of `client.shopMatchStats.forShop()`: one shop's price history, broken out per
+ * product. */
+type ShopPriceHistoryList = {
+    shop: string;
+    items: {
+        item: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            name: string;
+        };
+        history: {
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            snapshotDate: string;
+            /** @example 149.5 */
+            price: number;
+            /**
+             * @description ISO-4217 currency code
+             * @example SEK
+             */
+            currency: string;
+            inStock: boolean;
+            url: string;
+        }[];
+        /** @example 149.5 */
+        latestPrice: number | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        latestDate: string | undefined;
+    }[];
+    itemCount: number;
+};
+type ShopPriceComparisonRow = {
+    shop: string;
+    /** @example 149.5 */
+    price: number;
+    /**
+     * @description ISO-4217 currency code
+     * @example SEK
+     */
+    currency: string;
+    inStock: boolean;
+    url: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    snapshotDate: string;
+};
+type ShopPriceComparisonStats = {
+    /** @example 149.5 */
+    lowestPrice: number;
+    /** @example 149.5 */
+    highestPrice: number;
+    /** @example 149.5 */
+    averagePrice: number;
+    inStockCount: number;
+};
+/** 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: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        name: string;
+    };
+    items: {
+        shop: string;
+        /** @example 149.5 */
+        price: number;
+        /**
+         * @description ISO-4217 currency code
+         * @example SEK
+         */
+        currency: string;
+        inStock: boolean;
+        url: string;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        snapshotDate: string;
+    }[];
+    stats: {
+        /** @example 149.5 */
+        lowestPrice: number;
+        /** @example 149.5 */
+        highestPrice: number;
+        /** @example 149.5 */
+        averagePrice: number;
+        inStockCount: number;
+    } | undefined;
+};
+type ShopUrlStatus = "pending" | "active" | "invalid" | "rejected" | "sanityRejected";
+type ShopUrlDiscoveredBy = "scraper" | "user";
+/** A URL at a shop that tcgpriser scrapes, and what it has been matched to. */
+type ShopUrl = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    url: string;
+    shop: string | undefined;
+    /** @enum {string} */
+    status: "pending" | "active" | "invalid" | "rejected" | "sanityRejected";
+    /** @enum {string} */
+    discoveredBy: "scraper" | "user";
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    itemId: string | undefined;
+    /** @enum {string|null} */
+    itemKind: "card" | "sealed" | undefined;
+    lockedItem: boolean;
+    priceChartingId: string | undefined;
+    scrapedName: string | undefined;
+    matchScore: number | undefined;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    lastMatchedAt: string | undefined;
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    expansionId: string | undefined;
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    categoryId: string | undefined;
+    submittedByUserId: 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;
+};
+/** Response of `client.shopUrls.submit()` / `client.shopUrls.assignProduct()`. */
+type ShopUrlMutationResult = {
+    message: string;
+    shopUrl: {
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        id: string;
+        url: string;
+        shop: string | undefined;
+        /** @enum {string} */
+        status: "pending" | "active" | "invalid" | "rejected" | "sanityRejected";
+        /** @enum {string} */
+        discoveredBy: "scraper" | "user";
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        itemId: string | undefined;
+        /** @enum {string|null} */
+        itemKind: "card" | "sealed" | undefined;
+        lockedItem: boolean;
+        priceChartingId: string | undefined;
+        scrapedName: string | undefined;
+        matchScore: number | undefined;
+        /**
+         * Format: date-time
+         * @example 2026-07-15T12:03:29.322Z
+         */
+        lastMatchedAt: string | undefined;
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        expansionId: string | undefined;
+        /**
+         * @description Resource identifier
+         * @example 6a577711abc1ce71383d3e10
+         */
+        categoryId: string | undefined;
+        submittedByUserId: 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;
+    };
+};
 interface ListBargainsParams {
     type?: 'sealed' | 'card' | 'all';
 }
@@ -2985,7 +6933,6 @@ declare class BargainsResource {
      * threshold, card condition/grade, free-text search). Premium. */
     search(params?: SearchBargainsParams): Promise<ListResponse<Bargain>>;
 }
-
 interface ListCardsParams extends PaginationParams {
     /** Free-text search over card and set names. */
     search?: string;
@@ -3027,7 +6974,6 @@ declare class CardsResource {
      * stats job. Premium. */
     livePricing(idOrTechnicalName: string, options?: PremiumOptions): Promise<LivePricingForItem>;
 }
-
 declare class ExpansionsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -3040,7 +6986,6 @@ declare class ExpansionsResource {
      * this expansion, not read from the last stats job. Premium. */
     livePricing(technicalName: string, options?: PremiumOptions): Promise<ExpansionLivePricing>;
 }
-
 declare class PackRatesResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -3050,7 +6995,6 @@ declare class PackRatesResource {
     /** `GET /pack-rates/{expansionId}`: pull-rate odds for one expansion. */
     get(expansionId: string): Promise<PackRate>;
 }
-
 /** Filters shared by `daily()` and `estimatedValues()`: all narrow which product(s) the stats
  * cover; combine as many as you like. */
 interface ProductFilterParams {
@@ -3135,7 +7079,6 @@ declare class PriceStatsResource {
      * are required for `cardType: 'graded'`. Premium. */
     productDailyByVariant(idOrTechnicalName: string, params: ProductDailyByVariantParams): Promise<ItemVariantDailyStats>;
 }
-
 interface ListProductsParams extends PaginationParams {
     /** Whitespace-separated tokens, each matched against the start of a word. */
     search?: string;
@@ -3180,7 +7123,6 @@ declare class ProductsResource {
      * stats job. Premium. */
     livePricing(idOrTechnicalName: string, options?: PremiumOptions): Promise<LivePricingForItem>;
 }
-
 interface ShopMatchStatsForProductParams {
     authToken?: string;
     /** `YYYY-MM-DD` */
@@ -3219,7 +7161,6 @@ declare class ShopMatchStatsResource {
      * one date (defaults to the latest). */
     compare(params: CompareShopPricesParams): Promise<ItemPriceComparison>;
 }
-
 interface ListShopMatchesParams extends PaginationParams {
     /** Filter to one shop's technicalName. */
     shop?: string;
@@ -3244,7 +7185,6 @@ declare class ShopMatchesResource {
     /** `GET /shop-matches/shops`: match counts per shop (based on latest records only). */
     shopStats(params?: PaginationParams): Promise<ListResponse<ShopMatchStats>>;
 }
-
 interface SubmitShopUrlParams extends PremiumOptions {
     url: string;
     /** Shop technicalName. Auto-created if it doesn't exist yet. */
@@ -3264,7 +7204,6 @@ declare class ShopUrlsResource {
     /** `PATCH /shop-urls/{id}/product`: manually assign (or clear) the product a shop URL resolves to. */
     assignProduct(shopUrlId: string, params: AssignShopUrlProductParams): Promise<ShopUrlMutationResult>;
 }
-
 interface ListShopsParams {
     active?: boolean;
 }
@@ -3276,14 +7215,12 @@ declare class ShopsResource {
     /** `GET /shops/{id}`: fetch one shop by its id or technicalName. */
     get(idOrTechnicalName: string): Promise<Shop>;
 }
-
 declare class StatsResource {
     private readonly http;
     constructor(http: HttpClient);
     /** `GET /stats`: platform-wide overview counts (shops, expansions, products, prices tracked). */
     platform(): Promise<PlatformStats>;
 }
-
 declare const DEFAULT_BASE_URL = "https://api.tcgpriser.se";
 /** Local dev, self-hosting and testing overrides. Most integrations never touch these. */
 interface TcgPriserAdvancedOptions {
@@ -3346,12 +7283,11 @@ declare class TcgPriser {
      */
     constructor(optionsOrAuthToken?: string | TcgPriserOptions);
 }
-
 /** The stable error codes the API's `error.code` field can hold. */
 type TcgPriserErrorCode = 'validationFailed' | 'unauthorized' | 'forbidden' | 'notFound' | 'conflict' | 'readOnlyField' | 'rateLimited' | 'premiumRequired' | 'internalError'
-/** Response body wasn't the `{ error: { code, message } }` shape. Probably a proxy or gateway
- * error in front of the API. */
- | 'unknown';
+    /** Response body wasn't the `{ error: { code, message } }` shape. Probably a proxy or gateway
+     * error in front of the API. */
+    | 'unknown';
 /** Thrown for any non-2xx response. Carries the parsed `{ code, message }` when the body matched
  * the API's error envelope, plus the raw status/body regardless so nothing gets lost. */
 declare class TcgPriserError extends Error {
@@ -3372,5 +7308,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 ExpansionContents, type ExpansionLivePricing, type ExpansionRef, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type 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 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 };