tcgpriser 0.7.0 → 0.13.0

package/dist/index.d.cts

@@ -4,31 +4,69 @@ interface HttpClientOptions {
     headers?: Record<string, string>;
     /** Default bearer token for premium endpoints, used when a call doesn't pass its own `authToken`. */
     authToken?: string;
+    /** Default per-request timeout. See `RequestOptions.timeoutMs`. */
+    timeoutMs?: number;
 }
-/** Per-call auth override for a premium endpoint, on top of the client's default `authToken`.
- * Every premium method takes one of these, either standalone or merged into its params object via
- * `splitAuthToken`. */
-interface PremiumOptions {
-    /** Overrides the client's default `authToken` for this call. Pass `undefined` explicitly to
-     * force an anonymous request even when the client has a default token. */
+/**
+ * Per-call overrides, accepted by every method — either standalone or merged into its params object
+ * and split back out by `splitRequestOptions`.
+ */
+interface RequestOptions {
+    /**
+     * Overrides the client's default `authToken` for this call. Pass `undefined` explicitly to force
+     * an anonymous request even when the client has a default token.
+     */
     authToken?: string;
+    /**
+     * Cancel the request from outside — a user navigating away, a parent operation being abandoned.
+     * Composed with `timeoutMs`, so whichever fires first wins; aborting through this signal rejects
+     * with the standard `AbortError`, not a `TcgPriserError`.
+     */
+    signal?: AbortSignal;
+    /**
+     * Milliseconds before this request is aborted, overriding the client's default. `0` disables the
+     * timeout for this call, which is occasionally right for `expansions.cardsLivePricing()` on a very
+     * large set. A timeout rejects with a `TcgPriserError` whose `code` is `'timeout'`.
+     */
+    timeoutMs?: number;
 }
-/** Thin wrapper around `fetch`: joins the base URL, adds default headers, turns non-2xx responses
- * into a `TcgPriserError`. Every resource method goes through this instead of calling `fetch`
- * directly. */
+/** @deprecated Renamed to `RequestOptions`, which also carries `signal` and `timeoutMs`. */
+type PremiumOptions = RequestOptions;
+/**
+ * Default request timeout.
+ *
+ * There was none, which meant a connection that opened and then stalled hung the caller forever
+ * with no way out: `fetch` has no built-in timeout, and without a `signal` there is nothing to
+ * cancel. A minute is well clear of the slowest thing the API does (a whole-expansion live-pricing
+ * recompute) while still being a bound.
+ */
+declare const DEFAULT_TIMEOUT_MS = 60000;
+/** Thin wrapper around `fetch`: joins the base URL, adds default headers, applies the timeout, turns
+ * non-2xx responses into a `TcgPriserError`. Every resource method goes through this instead of
+ * calling `fetch` directly. */
 declare class HttpClient {
     private readonly baseUrl;
     private readonly fetchImpl;
     private readonly defaultHeaders;
     private readonly defaultAuthToken;
+    private readonly defaultTimeoutMs;
+    /**
+     * The `X-Credits-Remaining` value from the most recent charged response, or `undefined` if no
+     * charged call has been made yet. See `TcgPriser.creditsRemaining`.
+     */
+    creditsRemaining: number | undefined;
     constructor(options: HttpClientOptions);
-    get<T>(path: string, requestOptions?: PremiumOptions): Promise<T>;
-    post<T>(path: string, body: unknown, requestOptions?: PremiumOptions): Promise<T>;
-    patch<T>(path: string, body: unknown, requestOptions?: PremiumOptions): Promise<T>;
+    get<T>(path: string, requestOptions?: RequestOptions): Promise<T>;
+    post<T>(path: string, body: unknown, requestOptions?: RequestOptions): Promise<T>;
+    patch<T>(path: string, body: unknown, requestOptions?: RequestOptions): Promise<T>;
+    delete<T>(path: string, requestOptions?: RequestOptions): Promise<T>;
     private request;
 }
 interface components {
     schemas: {
+        Acknowledgement: {
+            message: string;
+        };
         AlternativeName: {
             name: string;
             shortName: string | undefined;
@@ -41,7 +79,7 @@ interface components {
         ApiError: {
             error: {
                 /** @enum {string} */
-                code: "validationFailed" | "unauthorized" | "forbidden" | "notFound" | "conflict" | "readOnlyField" | "rateLimited" | "premiumRequired" | "businessRequired" | "internalError";
+                code: "validationFailed" | "unauthorized" | "forbidden" | "notFound" | "conflict" | "readOnlyField" | "rateLimited" | "premiumRequired" | "businessRequired" | "creditsExhausted" | "internalError";
                 message: string;
                 details: unknown;
             };
@@ -311,17 +349,6 @@ interface components {
              */
             updatedAt: string;
         };
-        ExpansionContents: {
-            expansion: components["schemas"]["ExpansionRef"];
-            cards: {
-                count: number;
-                items: components["schemas"]["Card"][];
-            };
-            sealed: {
-                count: number;
-                items: components["schemas"]["Product"][];
-            };
-        };
         ExpansionLivePricing: {
             expansion: {
                 technicalName: string;
@@ -1021,7 +1048,7 @@ interface components {
             shopUrl: components["schemas"]["ShopUrl"];
         };
         /** @enum {string} */
-        ShopUrlStatus: "pending" | "active" | "invalid" | "rejected" | "sanityRejected";
+        ShopUrlStatus: "pending" | "active" | "invalid" | "rejected" | "sanityRejected" | "wrongBrand";
         SoldPrice: {
             /**
              * @description Resource identifier
@@ -1089,6 +1116,70 @@ interface components {
             looseCount: number;
             gradedCount: number;
         };
+        Webhook: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            url: string;
+            events: components["schemas"]["WebhookEvent"][];
+            isActive: boolean;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            lastDeliveryAt: string | undefined;
+            /** @enum {string|null} */
+            lastDeliveryStatus: "success" | "failed" | 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} */
+        WebhookEvent: "price.updated" | "bargain.found" | "product.created" | "card.created";
+        WebhookList: {
+            data: components["schemas"]["Webhook"][];
+            pagination: components["schemas"]["PageMeta"];
+        };
+        WebhookSecret: {
+            /**
+             * @description Resource identifier
+             * @example 6a577711abc1ce71383d3e10
+             */
+            id: string;
+            url: string;
+            events: components["schemas"]["WebhookEvent"][];
+            isActive: boolean;
+            /**
+             * Format: date-time
+             * @example 2026-07-15T12:03:29.322Z
+             */
+            lastDeliveryAt: string | undefined;
+            /** @enum {string|null} */
+            lastDeliveryStatus: "success" | "failed" | 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;
+            secret: string;
+        };
+        WebhookTestResult: {
+            message: string;
+        };
     };
     responses: never;
     parameters: never;
@@ -1209,8 +1300,14 @@ interface ListResponse<T> {
     data: T[];
     pagination: PageMeta;
 }
-/** Query params shared by every offset-paginated list endpoint. */
-interface PaginationParams {
+/**
+ * Query params shared by every offset-paginated list endpoint.
+ *
+ * Extends `RequestOptions` so `signal` and `timeoutMs` can be passed inline alongside the filters,
+ * rather than as a second argument on some methods and a merged field on others. `splitRequestOptions`
+ * strips them back out before the query string is built, so they never reach the URL.
+ */
+interface PaginationParams extends RequestOptions {
     limit?: number;
     skip?: number;
 }
@@ -1343,7 +1440,7 @@ type ReferencePriceProvider = "tradera" | "cardmarket" | "tcgplayer" | "ebay";
 /** Keyed by provider, at most one snapshot per provider. */
 type ReferencePriceSnapshotsByProvider = Partial<Record<ReferencePriceProvider, ReferencePriceSnapshot>>;
 /** A card, as returned by `client.cards.get()` / `client.cards.list()`, and as embedded in
- * `client.expansions.products()`. `kind: 'card'` is a literal on the generated type, which is what
+ * `client.expansions.cards()`. `kind: 'card'` is a literal on the generated type, which is what
  * makes `CatalogItem` (below) discriminate cleanly. Content only — no pricing fields; fetch those
  * separately via `client.cards.pricing()` / `.pricingBatch()`. */
 type Card = {
@@ -1397,8 +1494,9 @@ type Card = {
     prisjaktId: string | undefined;
 };
 /** 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. Content only — no
- * pricing fields; fetch those separately via `client.products.pricing()` / `.pricingBatch()`. */
+ * `client.products.list()`, and as embedded in `client.expansions.sealedProducts()`. `kind:
+ * 'sealed'` is a literal on the generated type. Content only — no pricing fields; fetch those
+ * separately via `client.products.pricing()` / `.pricingBatch()`. */
 type SealedProduct = {
     /**
      * @description Resource identifier
@@ -1488,6 +1586,17 @@ type CardVariants = {
     firstEdition: boolean;
     wPromo: boolean;
 };
+/** One entry from `client.cards.technicalNames()` / `client.products.technicalNames()`: a slug and
+ * when that item last changed. Enough to build a sitemap or decide what to re-fetch, without paying
+ * for the full catalog page. */
+type CatalogSlug = {
+    technicalName: string;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    updatedAt: string;
+};
 /** 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 = {
@@ -1566,9 +1675,10 @@ type BargainProductRef = {
      */
     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`. */
+/** A set/expansion, as returned by `client.expansions.list()`. This is the full record, including
+ * the `sealedCount`/`cardCount`/`productCount` aggregation `list()` runs. The `expansion` field
+ * embedded on a card or product, and the result of `client.expansions.get()`, are the smaller
+ * `ExpansionRef` from `types/common.ts` instead. */
 type Expansion = {
     /**
      * @description Resource identifier
@@ -1633,26 +1743,6 @@ type Expansion = {
      */
     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 = {
-    expansion: ExpansionRef;
-    cards: {
-        count: number;
-        items: CardSchema[];
-    };
-    sealed: {
-        count: number;
-        items: SealedProduct[];
-    };
-};
-/** One card as embedded in `client.expansions.products()`'s `cards` group. `$ref`s `CardWithPricing`
- * on the wire, so this is literally `Card` — kept as its own name since a card found through an
- * expansion's contents reads more naturally as `ExpansionCard` at the call site. */
-type ExpansionCard = Card;
-/** One sealed product as embedded in `client.expansions.products()`'s `sealed` group. Literally
- * `SealedProduct`, same reasoning as `ExpansionCard`. */
-type ExpansionSealedProduct = SealedProduct;
 type ShopMatchWithItemSchema = {
     /**
      * @description Resource identifier
@@ -2389,7 +2479,7 @@ type ItemPriceComparison = {
     items: ShopPriceComparisonRow[];
     stats: ShopPriceComparisonStats | undefined;
 };
-type ShopUrlStatus = "pending" | "active" | "invalid" | "rejected" | "sanityRejected";
+type ShopUrlStatus = "pending" | "active" | "invalid" | "rejected" | "sanityRejected" | "wrongBrand";
 type ShopUrlDiscoveredBy = "scraper" | "user";
 /** A URL at a shop that tcgpriser scrapes, and what it has been matched to. */
 type ShopUrl = {
@@ -2446,11 +2536,93 @@ type ShopUrlMutationResult = {
     message: string;
     shopUrl: ShopUrl;
 };
-interface ListBargainsParams {
+/**
+ * Types for the Business tier: outbound webhooks, the one feature that distinguishes Business from
+ * Premium. Everything here needs a Business subscriber's API token — a Premium token answers
+ * `403 businessRequired`.
+ *
+ * Derived from `src/generated/openapi.d.ts`, same as everything else in this directory.
+ */
+/** One registered webhook, as returned by `client.webhooks.list()`. Never carries the signing
+ * secret — see `WebhookWithSecret`, which is returned exactly once at registration. */
+type Webhook = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    url: string;
+    events: WebhookEvent[];
+    isActive: boolean;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    lastDeliveryAt: string | undefined;
+    /** @enum {string|null} */
+    lastDeliveryStatus: "success" | "failed" | 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 catalog-wide events a webhook can subscribe to. */
+type WebhookEvent = "price.updated" | "bargain.found" | "product.created" | "card.created";
+/** Whether the most recent delivery attempt succeeded. `undefined` until the first attempt. */
+type WebhookDeliveryStatus = "success" | "failed";
+/**
+ * What `client.webhooks.create()` returns: a `Webhook` plus the `secret` used to sign deliveries.
+ *
+ * The secret is returned by that one call and never again — there is no endpoint that reads it
+ * back, by design. Store it when you create the webhook; if you lose it, delete the webhook and
+ * register a new one.
+ */
+type WebhookWithSecret = {
+    /**
+     * @description Resource identifier
+     * @example 6a577711abc1ce71383d3e10
+     */
+    id: string;
+    url: string;
+    events: WebhookEvent[];
+    isActive: boolean;
+    /**
+     * Format: date-time
+     * @example 2026-07-15T12:03:29.322Z
+     */
+    lastDeliveryAt: string | undefined;
+    /** @enum {string|null} */
+    lastDeliveryStatus: "success" | "failed" | 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;
+    secret: string;
+};
+/** Response of `client.webhooks.test()`. */
+type WebhookTestResult = {
+    message: string;
+};
+/** Response of `client.webhooks.delete()`. */
+type Acknowledgement = {
+    message: string;
+};
+interface ListBargainsParams extends RequestOptions {
     type?: 'sealed' | 'card' | 'all';
 }
 interface SearchBargainsParams extends PaginationParams {
-    authToken?: string;
     type?: 'sealed' | 'card' | 'all';
     /** Filter by shop technicalName. */
     shop?: string;
@@ -2479,6 +2651,8 @@ declare class BargainsResource {
     search(params?: SearchBargainsParams): Promise<ListResponse<Bargain>>;
 }
 interface ListCardsParams extends PaginationParams {
+}
+interface SearchCardsParams extends PaginationParams {
     /** Free-text search over card and set names. */
     search?: string;
 }
@@ -2486,7 +2660,7 @@ interface CardMatchesParams extends PaginationParams {
     /** Keep only matches whose shop currently has stock. */
     inStock?: boolean;
 }
-interface CardReferencePricesParams {
+interface CardReferencePricesParams extends RequestOptions {
     /** Bearer token for this call. Overrides the client's default `authToken`. */
     authToken?: string;
     /** Rolling window ending today, in days. Ignored when `from`/`to` are supplied. Default 90. */
@@ -2500,15 +2674,45 @@ interface CardReferencePricesParams {
     variant?: ReferencePriceCardVariant;
 }
 interface CardPricesParams extends PaginationParams {
-    authToken?: string;
+}
+/** Filters for `cards.dailyStats()`. Narrow to one card, or to a whole expansion/category. */
+interface CardDailyStatsParams extends RequestOptions {
+    /** `YYYY-MM-DD` */
+    startDate?: string;
+    /** `YYYY-MM-DD` */
+    endDate?: string;
+    productName?: string;
+    technicalName?: string;
+    /** Category technicalName. */
+    category?: string;
+    /** Expansion technicalName. */
+    expansion?: string;
+    /** Category id (ObjectId), an alternative to `category`. */
+    categoryId?: string;
+    /** Expansion id (ObjectId), an alternative to `expansion`. */
+    expansionId?: string;
+}
+/** Filters for `cards.estimatedValues()`. Note `page`/`limit`, not the `limit`/`skip` the rest of
+ * the API paginates with — this endpoint predates that convention. */
+interface CardEstimatedValuesParams extends RequestOptions {
+    page?: number;
+    limit?: number;
+    productName?: string;
+    technicalName?: string;
+    /** Category technicalName. */
+    category?: string;
+    /** Expansion technicalName. */
+    expansion?: string;
 }
 declare class CardsResource {
     private readonly http;
     constructor(http: HttpClient);
-    /** `GET /cards`: search or list cards. */
+    /** `GET /cards`: list cards, newest first. No free-text search — use `search()` for that. */
     list(params?: ListCardsParams): Promise<ListResponse<Card>>;
+    /** `GET /cards/search`: like `list()`, but with free-text search on card and set names. Premium. */
+    search(params?: SearchCardsParams): Promise<ListResponse<Card>>;
     /** `GET /cards/{id}`: fetch one card by its id or technicalName. */
-    get(idOrTechnicalName: string): Promise<Card>;
+    get(idOrTechnicalName: string, options?: RequestOptions): Promise<Card>;
     /** `GET /cards/{id}/matches`: current shop listings matched to this card (latest per shop). */
     matches(idOrTechnicalName: string, params?: CardMatchesParams): Promise<ItemShopMatches>;
     /** `GET /cards/{id}/reference-prices`: Cardmarket/TCGplayer/eBay/Tradera price history. Premium. */
@@ -2517,46 +2721,70 @@ declare class CardsResource {
     prices(idOrTechnicalName: string, params?: CardPricesParams): Promise<ItemSoldPrices>;
     /** `GET /cards/{id}/pricing/live`: computed fresh for this request, not read from the last
      * stats job. Premium. */
-    livePricing(idOrTechnicalName: string, options?: PremiumOptions): Promise<LivePricingForItem>;
+    livePricing(idOrTechnicalName: string, options?: RequestOptions): Promise<LivePricingForItem>;
     /** `GET /cards/{id}/pricing`: this card's current pricing snapshot — `retailPrice`,
      * `estimatedValue`, `lowestShopOffer`, `referencePriceSnapshotsByProvider` — refreshed once a day
      * by the nightly pricing/scraper jobs. `get()` returns content only; this is the separate,
      * shorter-cached call for the part of a card that actually changes day to day. */
-    pricing(idOrTechnicalName: string): Promise<CatalogItemPricing>;
+    pricing(idOrTechnicalName: string, options?: RequestOptions): Promise<CatalogItemPricing>;
     /** `GET /cards/pricing`: pricing for up to 200 cards in one request, keyed by `id` — the batch
      * counterpart to `pricing()`, for a page of results (a search page, an expansion's contents) that
      * needs pricing for many items at once. Unlike `get()`/`pricing()`, this only accepts `id`s, not
      * technicalNames — pass the `id`s already on the cards you fetched. Ids with no match are
      * silently omitted from the result rather than causing an error. */
-    pricingBatch(ids: string[]): Promise<ListResponse<CatalogItemPricing>>;
+    pricingBatch(ids: string[], options?: RequestOptions): Promise<ListResponse<CatalogItemPricing>>;
+    /** `GET /cards/technical-names`: every card's `technicalName` and `updatedAt`, unpaginated and
+     * with no pricing joins. Built for enumerating the whole catalog cheaply — a sitemap, or working
+     * out which items changed since your last sync — where `list()` would make you page through full
+     * card documents to learn the same two fields. */
+    technicalNames(options?: RequestOptions): Promise<ListResponse<CatalogSlug>>;
+    /** `GET /cards/price-stats/daily`: daily average price history, cards only. The same data as
+     * `client.priceStats.daily()`, scoped to the card catalog so a filter like `expansion` can't pull
+     * in that expansion's sealed products too. */
+    dailyStats(params?: CardDailyStatsParams): Promise<ListResponse<ItemDailyStats>>;
+    /** `GET /cards/price-stats/estimated-values`: current estimated market value, cards only. The
+     * card-scoped counterpart to `client.priceStats.estimatedValues()`. */
+    estimatedValues(params?: CardEstimatedValuesParams): Promise<ListResponse<ItemEstimatedValue>>;
 }
 declare class ExpansionsResource {
     private readonly http;
     constructor(http: HttpClient);
     /** `GET /expansions`: every expansion. Unwrapped to a plain array, nothing to paginate here. */
-    list(): Promise<Expansion[]>;
-    /** `GET /expansions/{technicalName}/products`: every card and sealed product in one
-     * expansion, kept as separate `cards`/`sealed` groups. Content only, no pricing fields — pass the
-     * `id`s from the result to `client.cards.pricingBatch()` / `client.products.pricingBatch()` if you
-     * need pricing too. This mirrors the API 1:1 rather than fetching pricing for you, since pricing
-     * for every item in an expansion is a second, separately-cached call the caller may not want. */
-    products(technicalName: string): Promise<ExpansionContents>;
-    /** `GET /expansions/{technicalName}/products/live-pricing`: computed fresh for every item in
-     * this expansion, not read from the last stats job. Premium. */
-    livePricing(technicalName: string, options?: PremiumOptions): Promise<ExpansionLivePricing>;
+    list(options?: RequestOptions): Promise<Expansion[]>;
+    /** `GET /expansions/{technicalName}`: metadata only — no cards or sealed products. Returns the
+     * smaller `ExpansionRef`, not the full `Expansion`: this is a plain lookup by technicalName, not
+     * the aggregation `list()` runs, so `sealedCount`/`cardCount`/`productCount` aren't available
+     * here. See `cards()` and `sealedProducts()` for this expansion's contents. */
+    get(technicalName: string, options?: RequestOptions): Promise<ExpansionRef>;
+    /** `GET /expansions/{technicalName}/cards`: every card in this expansion. Content only, no
+     * pricing fields — pass the `id`s from the result to `client.cards.pricingBatch()` if you need
+     * pricing too. Sealed products are a separate call — see `sealedProducts()` — never merged into
+     * this one. */
+    cards(technicalName: string, options?: RequestOptions): Promise<ListResponse<Card>>;
+    /** `GET /expansions/{technicalName}/products`: every sealed product in this expansion. Content
+     * only, no pricing fields — pass the `id`s from the result to `client.products.pricingBatch()`
+     * if you need pricing too. Cards are a separate call — see `cards()` — never merged into this
+     * one. */
+    sealedProducts(technicalName: string, options?: RequestOptions): Promise<ListResponse<SealedProduct>>;
+    /** `GET /expansions/{technicalName}/cards/live-pricing`: computed fresh for every card in this
+     * expansion, not read from the last stats job. Premium. */
+    cardsLivePricing(technicalName: string, options?: RequestOptions): Promise<ExpansionLivePricing>;
+    /** `GET /expansions/{technicalName}/products/live-pricing`: computed fresh for every sealed
+     * product in this expansion, not read from the last stats job. Premium. */
+    productsLivePricing(technicalName: string, options?: RequestOptions): Promise<ExpansionLivePricing>;
 }
 declare class PackRatesResource {
     private readonly http;
     constructor(http: HttpClient);
     /** `GET /pack-rates`: pull-rate odds for every expansion that has them. Unwrapped to a plain
      * array, nothing to paginate here. */
-    list(): Promise<PackRate[]>;
+    list(options?: RequestOptions): Promise<PackRate[]>;
     /** `GET /pack-rates/{expansionId}`: pull-rate odds for one expansion. */
-    get(expansionId: string): Promise<PackRate>;
+    get(expansionId: string, options?: RequestOptions): Promise<PackRate>;
 }
 /** Filters shared by `daily()` and `estimatedValues()`: all narrow which product(s) the stats
  * cover; combine as many as you like. */
-interface ProductFilterParams {
+interface ProductFilterParams extends RequestOptions {
     productName?: string;
     technicalName?: string;
     priceChartingId?: string;
@@ -2580,21 +2808,18 @@ interface EstimatedValuesParams extends ProductFilterParams {
     page?: number;
     limit?: number;
 }
-interface TopProductsParams {
+interface TopProductsParams extends RequestOptions {
     limit?: number;
 }
-interface ProductDailyStatsParams {
-    authToken?: string;
+interface ProductDailyStatsParams extends RequestOptions {
     /** Number of days to retrieve, from today backwards. Default 30. */
     days?: number;
 }
-interface ProductByVariantParams {
-    authToken?: string;
+interface ProductByVariantParams extends RequestOptions {
     /** Number of days to include in the average calculation. Default 30. */
     days?: number;
 }
-interface ProductDailyByVariantParams {
-    authToken?: string;
+interface ProductDailyByVariantParams extends RequestOptions {
     cardType: CardType;
     /** Required when `cardType` is `'loose'`. */
     condition?: ItemCondition;
@@ -2618,18 +2843,18 @@ declare class PriceStatsResource {
     topProducts(params?: TopProductsParams): Promise<ListResponse<TopItem>>;
     /** `GET /price-stats/product/{id}`: daily price history, current estimate, and a variant-count
      * summary for one product. Premium. */
-    product(idOrTechnicalName: string, options?: PremiumOptions): Promise<ItemStats>;
+    product(idOrTechnicalName: string, options?: RequestOptions): Promise<ItemStats>;
     /** `GET /price-stats/product/{id}/full`: everything `product()` has, plus the item's current
      * shop matches. Premium. */
-    productFull(idOrTechnicalName: string, options?: PremiumOptions): Promise<ItemFullStats>;
+    productFull(idOrTechnicalName: string, options?: RequestOptions): Promise<ItemFullStats>;
     /** `GET /price-stats/product/{id}/daily`: daily price history for one product, with a
      * caller-chosen window. Premium. */
     productDaily(idOrTechnicalName: string, params?: ProductDailyStatsParams): Promise<ItemDailyStats>;
     /** `GET /price-stats/product/{id}/daily-last-30`: daily price history for the last 30 days
      * exactly (no window param, for callers that want a stable cache key). Premium. */
-    productDailyLast30(idOrTechnicalName: string, options?: PremiumOptions): Promise<ItemDailyStats>;
+    productDailyLast30(idOrTechnicalName: string, options?: RequestOptions): Promise<ItemDailyStats>;
     /** `GET /price-stats/product/{id}/estimated-value`: current estimated value only. Premium. */
-    productEstimatedValue(idOrTechnicalName: string, options?: PremiumOptions): Promise<ItemEstimatedValue>;
+    productEstimatedValue(idOrTechnicalName: string, options?: RequestOptions): Promise<ItemEstimatedValue>;
     /** `GET /price-stats/product/{id}/by-variant`: price stats broken out per card condition/grade.
      * Premium. */
     productByVariant(idOrTechnicalName: string, params?: ProductByVariantParams): Promise<ItemVariantStats>;
@@ -2639,6 +2864,8 @@ declare class PriceStatsResource {
     productDailyByVariant(idOrTechnicalName: string, params: ProductDailyByVariantParams): Promise<ItemVariantDailyStats>;
 }
 interface ListProductsParams extends PaginationParams {
+}
+interface SearchProductsParams extends PaginationParams {
     /** Whitespace-separated tokens, each matched against the start of a word. */
     search?: string;
 }
@@ -2650,7 +2877,7 @@ interface ProductMatchesParams extends PaginationParams {
     gradingCompany?: GradingCompany;
     grade?: number;
 }
-interface ProductReferencePricesParams {
+interface ProductReferencePricesParams extends RequestOptions {
     authToken?: string;
     /** Rolling window ending today, in days. Ignored when `from`/`to` are supplied. Default 90. */
     days?: number;
@@ -2661,17 +2888,52 @@ interface ProductReferencePricesParams {
     provider?: ReferencePriceProvider;
 }
 interface ProductPricesParams extends PaginationParams {
-    authToken?: string;
+}
+/** Filters for `products.dailyStats()`. Narrow to one product, or to a whole expansion/category. */
+interface ProductDailyPriceStatsParams extends RequestOptions {
+    /** `YYYY-MM-DD` */
+    startDate?: string;
+    /** `YYYY-MM-DD` */
+    endDate?: string;
+    productName?: string;
+    technicalName?: string;
+    priceChartingId?: string;
+    modelNumber?: string;
+    /** Category technicalName. */
+    category?: string;
+    /** Expansion technicalName. */
+    expansion?: string;
+    /** Category id (ObjectId), an alternative to `category`. */
+    categoryId?: string;
+    /** Expansion id (ObjectId), an alternative to `expansion`. */
+    expansionId?: string;
+}
+/** Filters for `products.estimatedValues()`. Note `page`/`limit`, not the `limit`/`skip` the rest
+ * of the API paginates with — this endpoint predates that convention. */
+interface ProductEstimatedValuesParams extends RequestOptions {
+    page?: number;
+    limit?: number;
+    productName?: string;
+    technicalName?: string;
+    priceChartingId?: string;
+    modelNumber?: string;
+    /** Category technicalName. */
+    category?: string;
+    /** Expansion technicalName. */
+    expansion?: string;
 }
 /** Sealed products: booster boxes, ETBs, tins, and the like. Single cards live under
  * `client.cards` instead. */
 declare class ProductsResource {
     private readonly http;
     constructor(http: HttpClient);
-    /** `GET /product`: search or list sealed products. */
+    /** `GET /product`: list sealed products, newest first. No free-text search — use `search()` for
+     * that. */
     list(params?: ListProductsParams): Promise<ListResponse<SealedProduct>>;
+    /** `GET /product/search`: like `list()`, but with free-text search on the product name. Premium. */
+    search(params?: SearchProductsParams): Promise<ListResponse<SealedProduct>>;
     /** `GET /product/{id}`: fetch one sealed product by its id or technicalName. */
-    get(idOrTechnicalName: string): Promise<SealedProduct>;
+    get(idOrTechnicalName: string, options?: RequestOptions): Promise<SealedProduct>;
     /** `GET /product/{id}/matches`: current shop listings matched to this product (latest per shop). */
     matches(idOrTechnicalName: string, params?: ProductMatchesParams): Promise<ItemShopMatches>;
     /** `GET /product/{id}/reference-prices`: Cardmarket/TCGplayer/Tradera price history. Premium. */
@@ -2680,21 +2942,31 @@ declare class ProductsResource {
     prices(idOrTechnicalName: string, params?: ProductPricesParams): Promise<ItemSoldPrices>;
     /** `GET /product/{id}/pricing/live`: computed fresh for this request, not read from the last
      * stats job. Premium. */
-    livePricing(idOrTechnicalName: string, options?: PremiumOptions): Promise<LivePricingForItem>;
+    livePricing(idOrTechnicalName: string, options?: RequestOptions): Promise<LivePricingForItem>;
     /** `GET /product/{id}/pricing`: this product's current pricing snapshot — `retailPrice`,
      * `estimatedValue`, `lowestShopOffer`, `referencePriceSnapshotsByProvider` — refreshed once a day
      * by the nightly pricing/scraper jobs. `get()` returns content only; this is the separate,
      * shorter-cached call for the part of a product that actually changes day to day. */
-    pricing(idOrTechnicalName: string): Promise<CatalogItemPricing>;
+    pricing(idOrTechnicalName: string, options?: RequestOptions): Promise<CatalogItemPricing>;
     /** `GET /product/pricing`: pricing for up to 200 sealed products in one request, keyed by `id` —
      * the batch counterpart to `pricing()`, for a page of results (a search page, an expansion's
      * contents) that needs pricing for many items at once. Unlike `get()`/`pricing()`, this only
      * accepts `id`s, not technicalNames — pass the `id`s already on the products you fetched. Ids with
      * no match are silently omitted from the result rather than causing an error. */
-    pricingBatch(ids: string[]): Promise<ListResponse<CatalogItemPricing>>;
+    pricingBatch(ids: string[], options?: RequestOptions): Promise<ListResponse<CatalogItemPricing>>;
+    /** `GET /product/technical-names`: every sealed product's `technicalName` and `updatedAt`,
+     * unpaginated and with no pricing joins. The sealed counterpart to
+     * `client.cards.technicalNames()` — for sitemaps and incremental syncs. */
+    technicalNames(options?: RequestOptions): Promise<ListResponse<CatalogSlug>>;
+    /** `GET /product/price-stats/daily`: daily average price history, sealed products only. The same
+     * data as `client.priceStats.daily()`, scoped to the sealed catalog so a filter like `expansion`
+     * can't pull in that expansion's single cards too. */
+    dailyStats(params?: ProductDailyPriceStatsParams): Promise<ListResponse<ItemDailyStats>>;
+    /** `GET /product/price-stats/estimated-values`: current estimated market value, sealed products
+     * only. The sealed-scoped counterpart to `client.priceStats.estimatedValues()`. */
+    estimatedValues(params?: ProductEstimatedValuesParams): Promise<ListResponse<ItemEstimatedValue>>;
 }
-interface ShopMatchStatsForProductParams {
-    authToken?: string;
+interface ShopMatchStatsForProductParams extends RequestOptions {
     /** `YYYY-MM-DD` */
     startDate?: string;
     /** `YYYY-MM-DD` */
@@ -2702,17 +2974,15 @@ interface ShopMatchStatsForProductParams {
     /** Filter to one shop's technicalName. */
     shop?: string;
 }
-interface ShopMatchStatsForShopParams {
-    authToken?: string;
+interface ShopMatchStatsForShopParams extends RequestOptions {
     /** `YYYY-MM-DD` */
     startDate?: string;
     /** `YYYY-MM-DD` */
     endDate?: string;
-    /** Maximum products to return. Default 100. */
+    /** Maximum products to return. Default 20, max 50. */
     limit?: number;
 }
-interface CompareShopPricesParams {
-    authToken?: string;
+interface CompareShopPricesParams extends RequestOptions {
     /** Product/card id or technicalName. */
     productId: string;
     /** `YYYY-MM-DD`: defaults to the latest date with data. */
@@ -2755,12 +3025,12 @@ 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 {
+interface SubmitShopUrlParams extends RequestOptions {
     url: string;
     /** Shop technicalName. Auto-created if it doesn't exist yet. */
     shop: string;
 }
-interface AssignShopUrlProductParams extends PremiumOptions {
+interface AssignShopUrlProductParams extends RequestOptions {
     /** Product/card id to link, or `null` to unlink and let auto-matching resume. */
     productId: string | null;
 }
@@ -2774,7 +3044,7 @@ 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 {
+interface ListShopsParams extends RequestOptions {
     active?: boolean;
 }
 declare class ShopsResource {
@@ -2783,13 +3053,48 @@ declare class ShopsResource {
     /** `GET /shops`: every tracked shop. Unwrapped to a plain array, nothing to paginate here. */
     list(params?: ListShopsParams): Promise<Shop[]>;
     /** `GET /shops/{id}`: fetch one shop by its id or technicalName. */
-    get(idOrTechnicalName: string): Promise<Shop>;
+    get(idOrTechnicalName: string, options?: RequestOptions): 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>;
+    platform(options?: RequestOptions): Promise<PlatformStats>;
+}
+interface CreateWebhookParams extends RequestOptions {
+    /**
+     * Where deliveries are POSTed. Must be `https://` — the API rejects plaintext, since a delivery
+     * carries the signature that authenticates it.
+     */
+    url: string;
+    /** At least one event to subscribe to. */
+    events: WebhookEvent[];
+}
+/**
+ * Outbound webhooks: the API calls you when something changes, instead of you polling for it.
+ *
+ * Business tier, not Premium — a Premium token answers `403 businessRequired`. The feature is also
+ * behind a server-side flag, and when that flag is off these answer `404 notFound` rather than 403,
+ * so a `notFound` here means "not enabled on this instance", not "wrong id".
+ */
+declare class WebhooksResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * `POST /webhooks`: register a new webhook.
+     *
+     * The returned `secret` is the only copy you will ever get — sign-verification depends on it and
+     * no endpoint reads it back. Persist it here, at creation, or delete the webhook and make a new
+     * one.
+     */
+    create(params: CreateWebhookParams): Promise<WebhookWithSecret>;
+    /** `GET /webhooks`: every webhook registered on this account. Secrets are never included. */
+    list(options?: RequestOptions): Promise<ListResponse<Webhook>>;
+    /** `DELETE /webhooks/{id}`: revoke a webhook. Deliveries stop immediately; its secret is void. */
+    delete(webhookId: string, options?: RequestOptions): Promise<Acknowledgement>;
+    /** `POST /webhooks/{id}/test`: send a sample delivery to the registered URL, so you can verify
+     * your endpoint and your signature check before waiting on a real event. */
+    test(webhookId: string, options?: RequestOptions): Promise<WebhookTestResult>;
 }
 declare const DEFAULT_BASE_URL = "https://api.tcgpriser.se";
 /** Local dev, self-hosting and testing overrides. Most integrations never touch these. */
@@ -2800,6 +3105,12 @@ interface TcgPriserAdvancedOptions {
     headers?: Record<string, string>;
     /** Swap in a different `fetch` (older Node, testing, a proxying agent). Defaults to global `fetch`. */
     fetch?: typeof fetch;
+    /**
+     * Default milliseconds before a request is aborted, for every call this client makes. Defaults to
+     * `DEFAULT_TIMEOUT_MS` (60s). `0` disables the timeout entirely. Every method can override it per
+     * call with `timeoutMs`.
+     */
+    timeoutMs?: number;
 }
 interface TcgPriserOptions {
     /**
@@ -2850,14 +3161,37 @@ declare class TcgPriser {
     readonly bargains: BargainsResource;
     readonly packRates: PackRatesResource;
     readonly stats: StatsResource;
+    readonly webhooks: WebhooksResource;
+    /** Holds the `HttpClient` so `creditsRemaining` can read the running value off it. */
+    private readonly http;
     /**
      * @param optionsOrAuthToken A subscriber's API token (`new TcgPriser(myApiToken)`), a full
      * `TcgPriserOptions` object, or omit it entirely for an anonymous, public-only client.
      */
     constructor(optionsOrAuthToken?: string | TcgPriserOptions);
+    /**
+     * Credits left in this week's allowance, as of the last charged call this client made.
+     *
+     * The API returns `X-Credits-Remaining` on every response it charges for, so this needs no extra
+     * request — but it is only as current as your last premium call, and it is `undefined` until you
+     * make one. Uncharged calls (every public method, and any call authenticated with something other
+     * than an API token) don't update it, because the API doesn't meter them.
+     *
+     * ```ts
+     * await tcgpriser.cards.livePricing('fezandipiti-ex');
+     * if ((tcgpriser.creditsRemaining ?? Infinity) < 100) scheduleFewerRefreshes();
+     * ```
+     *
+     * Reading it in a browser additionally needs the API to expose the header via CORS, which it does.
+     */
+    get creditsRemaining(): number | undefined;
 }
 /** The stable error codes the API's `error.code` field can hold. */
-type TcgPriserErrorCode = 'validationFailed' | 'unauthorized' | 'forbidden' | 'notFound' | 'conflict' | 'readOnlyField' | 'rateLimited' | 'premiumRequired' | 'internalError'
+type TcgPriserErrorCode = 'validationFailed' | 'unauthorized' | 'forbidden' | 'notFound' | 'conflict' | 'readOnlyField' | 'rateLimited' | 'premiumRequired' | 'businessRequired' | 'creditsExhausted' | 'internalError'
+    /** The request exceeded its `timeoutMs` and was aborted client-side. Never sent by the API — the
+     * one code this package raises on its own, so a stalled connection is distinguishable from a
+     * server that answered. */
+    | 'timeout'
     /** Response body wasn't the `{ error: { code, message } }` shape. Probably a proxy or gateway
      * error in front of the API. */
     | 'unknown';
@@ -2871,6 +3205,18 @@ declare class TcgPriserError extends Error {
     readonly details: unknown;
     /** The raw response body, for debugging when `code`/`details` don't cover what you need. */
     readonly body: string;
+    /**
+     * Seconds to wait before retrying, from the `Retry-After` header. Present on `rateLimited`, and
+     * on anything else a proxy in front of the API decides to send it with. Absent otherwise — an
+     * error without it is not one that says retrying will help.
+     */
+    readonly retryAfter: number | undefined;
+    /**
+     * Credits left in this week's allowance, from `X-Credits-Remaining`. Present on errors from
+     * charged routes — notably `creditsExhausted`, where it is `0`. Absent on uncharged routes and on
+     * anything a proxy answered instead of the API.
+     */
+    readonly creditsRemaining: number | undefined;
     constructor(params: {
         statusCode: number;
         statusText: string;
@@ -2879,6 +3225,8 @@ declare class TcgPriserError extends Error {
         message: string;
         details?: unknown;
         body: string;
+        retryAfter?: number;
+        creditsRemaining?: number;
     });
 }
-export { type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type BrandRef, type Card, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CategoryRef, type CompareShopPricesParams, type CurrencyCode, DEFAULT_BASE_URL, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionCard, type ExpansionContents, type ExpansionLivePricing, type ExpansionRef, type ExpansionSealedProduct, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type MatchShop, type MatchedItemRef, type PackRate, type PackRateBucket, type PackSlot, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyStatsParams, type ProductFilterParams, type ProductMatchesParams, type ProductPricesParams, type ProductReferencePricesParams, type ReferencePriceCardVariant, type ReferencePriceCurrencyMode, type ReferencePriceMetric, type ReferencePriceProvider, type ReferencePriceSeries, type ReferencePriceSeriesPoint, type ReferencePriceSnapshot, type ReferencePriceSnapshotsByProvider, type ReferencePriceSource, type ResourceId, type SealedProduct, type SearchBargainsParams, type Shop, type ShopItemPriceHistory, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistory, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type components };
+export { type Acknowledgement, type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type BrandRef, type Card, type CardDailyStatsParams, type CardEstimatedValuesParams, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CatalogSlug, type CategoryRef, type CompareShopPricesParams, type CreateWebhookParams, type CurrencyCode, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionLivePricing, type ExpansionRef, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type MatchShop, type MatchedItemRef, type PackRate, type PackRateBucket, type PackSlot, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyPriceStatsParams, type ProductDailyStatsParams, type ProductEstimatedValuesParams, type ProductFilterParams, type ProductMatchesParams, type ProductPricesParams, type ProductReferencePricesParams, type ReferencePriceCardVariant, type ReferencePriceCurrencyMode, type ReferencePriceMetric, type ReferencePriceProvider, type ReferencePriceSeries, type ReferencePriceSeriesPoint, type ReferencePriceSnapshot, type ReferencePriceSnapshotsByProvider, type ReferencePriceSource, type RequestOptions, type ResourceId, type SealedProduct, type SearchBargainsParams, type SearchCardsParams, type SearchProductsParams, type Shop, type ShopItemPriceHistory, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistory, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, type TcgPriserAdvancedOptions, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type Webhook, type WebhookDeliveryStatus, type WebhookEvent, type WebhookTestResult, type WebhookWithSecret, type components };