@usethrottle/catalog 1.0.0 → 1.1.0

package/dist/{catalog-error-DO6ANrGR.d.cts → catalog-error-s1BINNkt.d.cts}

@@ -1,4 +1,4 @@
-import { p as CatalogContractErrorCode } from './types-DYfIvIaI.cjs';
+import { g as CatalogContractErrorCode } from './contract-types-DhiThMEr.cjs';
 
 /**
  * Shared error type for every Throttle SDK.
@@ -239,5 +239,5 @@ declare class FeatureUnavailableError extends CatalogError {
 /** True for a `CatalogError` from this or any other copy of the SDK. */
 declare function isCatalogError(value: unknown): value is CatalogError;
 
-export { CartLineError as C, FeatureUnavailableError as F, NetworkError as N, OriginNotAllowedError as O, RateLimitedError as R, CatalogError as b, CustomerTokenInvalidError as h, TimeoutError as i, isCatalogError as j };
-export type { ThrottleCartCode as T, CartLineProblem as a, CatalogErrorCode as c, CatalogErrorInit as d, CatalogErrorIssue as e, CatalogErrorSource as f, ClientErrorCode as g };
+export { CartLineError as C, FeatureUnavailableError as F, NetworkError as N, OriginNotAllowedError as O, RateLimitedError as R, TimeoutError as T, CatalogError as b, CustomerTokenInvalidError as h, isCatalogError as i };
+export type { CartLineProblem as a, CatalogErrorCode as c, CatalogErrorInit as d, CatalogErrorIssue as e, CatalogErrorSource as f, ClientErrorCode as g, ThrottleCartCode as j };

package/dist/{chunk-ZFUELHUU.cjs → chunk-4ORXUW2U.cjs}

@@ -3,7 +3,7 @@
 var _chunkETV4XYOVcjs = require('./chunk-ETV4XYOV.cjs');
 
 // src/version.ts
-var SDK_VERSION = true ? "1.0.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.1.0" : "0.0.0-dev";
 
 // src/errors/catalog-error.ts
 var _errors = require('@usethrottle/errors');
@@ -128,6 +128,7 @@ var TAG_MAX_CHARS = 256;
 var DEFAULT_REVALIDATE_S = 60;
 var LIST_PAGE_SIZE = 100;
 var LIST_MAX_HANDLES = 5e4;
+var CATEGORY_TREE_MAX_DEPTH = 10;
 
 // src/errors/map.ts
 var ERROR_KINDS = Object.freeze({
@@ -1176,4 +1177,5 @@ function createCatalogClient(options) {
 
 
 
-exports.SDK_VERSION = SDK_VERSION; exports.CatalogError = CatalogError; exports.RateLimitedError = RateLimitedError; exports.OriginNotAllowedError = OriginNotAllowedError; exports.CustomerTokenInvalidError = CustomerTokenInvalidError; exports.CartLineError = CartLineError; exports.TimeoutError = TimeoutError; exports.NetworkError = NetworkError; exports.FeatureUnavailableError = FeatureUnavailableError; exports.isCatalogError = isCatalogError; exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL; exports.THROTTLE_CHECKOUT_URL = THROTTLE_CHECKOUT_URL; exports.RATE_LIMIT_DEFAULT_RETRY_S = RATE_LIMIT_DEFAULT_RETRY_S; exports.STALE_MS = STALE_MS; exports.CACHE_MAX_ENTRIES = CACHE_MAX_ENTRIES; exports.SUGGEST_DEBOUNCE_MS = SUGGEST_DEBOUNCE_MS; exports.SUGGEST_MIN_CHARS = SUGGEST_MIN_CHARS; exports.INDEXING_REVALIDATE_MS = INDEXING_REVALIDATE_MS; exports.CACHE_TAG = CACHE_TAG; exports.TAG_MAX_CHARS = TAG_MAX_CHARS; exports.DEFAULT_REVALIDATE_S = DEFAULT_REVALIDATE_S; exports.LIST_PAGE_SIZE = LIST_PAGE_SIZE; exports.LIST_MAX_HANDLES = LIST_MAX_HANDLES; exports.createCatalogClient = createCatalogClient;
+
+exports.SDK_VERSION = SDK_VERSION; exports.CatalogError = CatalogError; exports.RateLimitedError = RateLimitedError; exports.OriginNotAllowedError = OriginNotAllowedError; exports.CustomerTokenInvalidError = CustomerTokenInvalidError; exports.CartLineError = CartLineError; exports.TimeoutError = TimeoutError; exports.NetworkError = NetworkError; exports.FeatureUnavailableError = FeatureUnavailableError; exports.isCatalogError = isCatalogError; exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL; exports.THROTTLE_CHECKOUT_URL = THROTTLE_CHECKOUT_URL; exports.RATE_LIMIT_DEFAULT_RETRY_S = RATE_LIMIT_DEFAULT_RETRY_S; exports.STALE_MS = STALE_MS; exports.CACHE_MAX_ENTRIES = CACHE_MAX_ENTRIES; exports.SUGGEST_DEBOUNCE_MS = SUGGEST_DEBOUNCE_MS; exports.SUGGEST_MIN_CHARS = SUGGEST_MIN_CHARS; exports.INDEXING_REVALIDATE_MS = INDEXING_REVALIDATE_MS; exports.CACHE_TAG = CACHE_TAG; exports.TAG_MAX_CHARS = TAG_MAX_CHARS; exports.DEFAULT_REVALIDATE_S = DEFAULT_REVALIDATE_S; exports.LIST_PAGE_SIZE = LIST_PAGE_SIZE; exports.LIST_MAX_HANDLES = LIST_MAX_HANDLES; exports.CATEGORY_TREE_MAX_DEPTH = CATEGORY_TREE_MAX_DEPTH; exports.createCatalogClient = createCatalogClient;

package/dist/{chunk-2PJXGAZF.js → chunk-JK2UY4CD.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-PKBMQBKP.js";
 
 // src/version.ts
-var SDK_VERSION = true ? "1.0.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.1.0" : "0.0.0-dev";
 
 // src/errors/catalog-error.ts
 import { ThrottleError } from "@usethrottle/errors";
@@ -128,6 +128,7 @@ var TAG_MAX_CHARS = 256;
 var DEFAULT_REVALIDATE_S = 60;
 var LIST_PAGE_SIZE = 100;
 var LIST_MAX_HANDLES = 5e4;
+var CATEGORY_TREE_MAX_DEPTH = 10;
 
 // src/errors/map.ts
 var ERROR_KINDS = Object.freeze({
@@ -1175,5 +1176,6 @@ export {
   DEFAULT_REVALIDATE_S,
   LIST_PAGE_SIZE,
   LIST_MAX_HANDLES,
+  CATEGORY_TREE_MAX_DEPTH,
   createCatalogClient
 };

package/dist/{client-BNtBTEyh.d.cts → client-BAoq6jmM.d.cts}

@@ -1,4 +1,4 @@
-import { X as RequestSpec, C as CallOptions, s as CatalogNamespaces, o as CatalogClientOptions } from './types-DYfIvIaI.cjs';
+import { v as RequestSpec, C as CallOptions, k as CatalogNamespaces, h as CatalogClientOptions } from './types-DsjoG8ce.cjs';
 
 /**
  * The package version, baked in at build time (tsup `define`). Under the

package/dist/{client-CHLvULRQ.d.ts → client-c2F-eCaL.d.ts}

@@ -1,4 +1,4 @@
-import { X as RequestSpec, C as CallOptions, s as CatalogNamespaces, o as CatalogClientOptions } from './types-DYfIvIaI.js';
+import { v as RequestSpec, C as CallOptions, k as CatalogNamespaces, h as CatalogClientOptions } from './types-xQLID-4j.js';
 
 /**
  * The package version, baked in at build time (tsup `define`). Under the

package/dist/{types-DYfIvIaI.d.cts → contract-types-DhiThMEr.d.cts}

@@ -596,275 +596,4 @@ type StorefrontTagsAnswer = {
 };
 type CatalogContractErrorCode = 'INVALID_REQUEST' | 'AUTHENTICATION_FAILED' | 'INFRASTRUCTURE_UNAVAILABLE' | 'PROVIDER_UNAVAILABLE' | 'INTERNAL_ERROR' | 'CUSTOMER_TOKEN_INVALID' | 'ORIGIN_NOT_ALLOWED' | 'SERVER_KEY_IN_BROWSER' | 'NOT_FOUND' | 'RATE_LIMITED' | 'STOREFRONT_UNAVAILABLE' | 'REQUEST_BODY_TOO_LARGE' | 'CART_CURRENCY_REQUIRED' | 'CART_CURRENCY_NOT_ENABLED' | 'CHECKOUT_NOT_CONFIGURED' | 'EXTENSION_UPGRADE_REQUIRED' | 'CART_ITEMS_INVALID' | 'CART_REJECTED' | 'CART_UNAVAILABLE' | 'CHECKOUT_UNAVAILABLE' | 'RETURN_URL_NOT_ALLOWED' | 'CHECKOUT_TOTAL_TOO_LARGE' | 'CHECKOUT_CART_MISMATCH' | 'CHECKOUT_ITEMS_INVALID' | 'CHECKOUT_REJECTED' | 'CURRENCY_NOT_ENABLED' | 'STOREFRONT_INDEXING' | 'EMAIL_NOT_VERIFIED' | 'NOT_VERIFIED_BUYER' | 'PURCHASE_REFUNDED' | 'ALREADY_REVIEWED' | 'REVIEW_QUEUE_FULL' | 'REVIEW_VERIFICATION_UNAVAILABLE';
 
-type QueryPairs = [string, string][];
-
-/** One stored answer for ETag reuse (P6-R13). */
-type CatalogHttpCacheEntry = {
-    etag: string;
-    body: unknown;
-};
-/** Caller-provided store for ETag reuse; without one nothing is sent (P6-R13). */
-type CatalogHttpCache = {
-    get(key: string): CatalogHttpCacheEntry | undefined;
-    set(key: string, entry: CatalogHttpCacheEntry): void;
-};
-type CustomerTokenSource = () => string | null | undefined | Promise<string | null | undefined>;
-type CatalogClientOptions = {
-    publishableKey: string;
-    baseUrl?: string;
-    fetch?: typeof fetch;
-    timeoutMs?: number;
-    currency?: string;
-    locale?: string;
-    customerToken?: CustomerTokenSource;
-    cache?: CatalogHttpCache;
-    /** The customer partition of the cache key (P6-R13). */
-    cacheScope?: () => string;
-    indexingRetry?: false | {
-        maxWaitSeconds: number;
-    };
-    headers?: Record<string, string>;
-};
-/** Next.js's `fetch` cache options; the SDK never imports Next. */
-type NextFetchOptions = {
-    revalidate?: number | false;
-    tags?: string[];
-};
-type CallOptions = {
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    currency?: string;
-    locale?: string;
-    /** Extra `fetch` init keys (for example Next's `next`); never overrides the request. */
-    fetchInit?: Record<string, unknown>;
-    /**
-     * Sent as the `fetch` init's `next` (over `fetchInit.next`). The server
-     * client adds one to every cacheable GET (P6-R17); a plain client passes it
-     * through. A request that carries a customer token drops it and is sent
-     * `cache: 'no-store'`.
-     */
-    next?: NextFetchOptions;
-};
-type RequestSpec = {
-    method: 'GET' | 'POST';
-    /** Already encoded, starting with `/`. */
-    path: string;
-    query?: QueryPairs;
-    body?: unknown;
-    /** `'optional'` and `'required'` both send a token when there is one; `tokenFallback` decides a `401`. */
-    customerToken: 'none' | 'optional' | 'required';
-    tokenFallback: 'anonymous' | 'throw';
-    /** The endpoint never answers a resource `404` (P6-R8 (b)). */
-    featureRoute: boolean;
-    idempotencyKey?: string;
-    /** `false` turns off the one indexing retry for this request (P6-R10). */
-    indexingRetry?: boolean;
-    ifNoneMatch?: string;
-    /**
-     * Query context the transport appends to a GET: `'priced'` adds `currency`
-     * and `locale`, `'locale'` adds `locale` only (call options over client
-     * options). A POST takes them in its body, from `context()`.
-     */
-    context?: 'priced' | 'locale';
-};
-
-/** A list sort the catalog knows. */
-type StorefrontSort = StorefrontListAnswer['sort'];
-/** An old handle's answer: where the resource lives now. */
-type Redirect = {
-    redirectTo: string;
-};
-/** `fields`: `lite` (the list default), `full`, or top-level product keys. */
-type FieldsOption = 'lite' | 'full' | readonly string[];
-/** The `/products` (and `/filters/:key/values`) selection. */
-type ProductsQuery = {
-    q?: string;
-    category?: string;
-    collection?: string;
-    /** Sent as repeated `tag`. */
-    tags?: string[];
-    featured?: boolean;
-    /** `filter.<key>`, one parameter per value; a range is one `min..max` value. */
-    filters?: Record<string, string | readonly string[]>;
-    handles?: string[];
-    skus?: string[];
-    vehicle?: {
-        year?: number;
-        make: string;
-        model: string;
-        submodel?: string;
-        engine?: string;
-    };
-    sort?: StorefrontSort | (string & {});
-    limit?: number;
-    page?: number;
-    cursor?: string;
-    /** `true` for every filter, or filter keys (repeated). */
-    facets?: boolean | readonly string[];
-    /** Comma-joined on the wire. */
-    fields?: FieldsOption;
-    /** Comma-joined on the wire. */
-    include?: readonly string[];
-};
-/** A line of a Throttle cart. */
-type ThrottleLine = {
-    id: string;
-    referenceId: string | null;
-    name: string;
-    quantity: number;
-    unitPrice: number;
-    imageUrl: string | null;
-    resolution?: {
-        status: 'resolved' | 'refused' | 'stale';
-        code: string | null;
-        maxQuantity: number | null;
-    } | null;
-};
-/** Throttle's cart as a cart session answers it; other keys pass through. */
-type ThrottleCart = {
-    cartId: string;
-    currency: string;
-    subtotal: number;
-    total: number;
-    unitCount: number;
-    lineItems?: ThrottleLine[];
-    lineResolver?: {
-        extensionId: string | null;
-    };
-} & {
-    [key: string]: unknown;
-};
-/**
- * A cart session answer, `data` unwrapped. Throttle sends `status` and
- * `expiresAt` on `get()` only; the mutations answer `{ cartSessionId, cart }`
- * and `refresh()` adds `changed`.
- */
-type CartSessionSnapshot = {
-    cartSessionId: string;
-    status?: string;
-    expiresAt?: string;
-    cart: ThrottleCart;
-    changed?: boolean;
-};
-/** The store's look, as Throttle answers it on a cart-session read. */
-type CartSessionBranding = {
-    logoUrl: string | null;
-    primaryColor: string | null;
-    merchantName: string | null;
-};
-/**
- * What `CartSession.get()` answers: the snapshot plus the fields only the
- * read carries. `metadata` is the session's own write-once metadata (the
- * buyer's return, cancel and storefront URLs among it), so its keys are the
- * caller's.
- */
-type CartSessionDetail = CartSessionSnapshot & {
-    status: string;
-    expiresAt: string;
-    /** Throttle sends both today; an older deployment may omit them. */
-    branding?: CartSessionBranding;
-    metadata?: Record<string, unknown>;
-};
-type CartCheckoutInput = {
-    /** Absolute `http:` or `https:` URL; anything else is refused before a request. */
-    returnUrl: string;
-    /** Absolute `http:` or `https:` URL; anything else is refused before a request. */
-    cancelUrl: string;
-    customerEmail?: string;
-    keepOpen?: boolean;
-};
-type CartCheckout = {
-    checkoutUrl: string;
-    checkoutSessionId: string;
-    expiresAt: string;
-};
-/** Per-call options of a cart-session call. */
-type SessionCallOptions = Pick<CallOptions, 'signal' | 'timeoutMs'>;
-/** One Throttle cart session, addressed by its opaque id. */
-type CartSession = {
-    readonly id: string;
-    get(call?: SessionCallOptions): Promise<CartSessionDetail>;
-    add(input: {
-        sku: string;
-        quantity?: number;
-        metadata?: Record<string, unknown>;
-    }, call?: SessionCallOptions): Promise<CartSessionSnapshot>;
-    update(lineId: string, quantity: number, call?: SessionCallOptions): Promise<CartSessionSnapshot>;
-    remove(lineId: string, call?: SessionCallOptions): Promise<CartSessionSnapshot>;
-    refresh(call?: SessionCallOptions): Promise<CartSessionSnapshot>;
-    /** Refuses non-http(s) URLs before a request, and never returns a non-http(s) `checkoutUrl`. */
-    checkout(input: CartCheckoutInput, call?: SessionCallOptions): Promise<CartCheckout>;
-};
-type ProductsNamespace = {
-    list(query?: ProductsQuery, call?: CallOptions): Promise<StorefrontListAnswer>;
-    /** Always the full product (`fields=full`, P6-R18), or a redirect. */
-    get(handle: string, opts?: {
-        include?: readonly string[];
-    } & CallOptions): Promise<StorefrontProductAnswer | Redirect>;
-    related(handle: string, opts?: {
-        limit?: number;
-        fields?: FieldsOption;
-    } & CallOptions): Promise<StorefrontRelatedAnswer>;
-};
-type FiltersNamespace = {
-    values(key: string, query?: ProductsQuery, call?: CallOptions): Promise<StorefrontFilterValuesAnswer>;
-};
-type CategoriesNamespace = {
-    tree(opts?: {
-        depth?: 1 | 2 | 3;
-    } & CallOptions): Promise<StorefrontCategoriesAnswer>;
-    get(handle: string, call?: CallOptions): Promise<StorefrontCategoryAnswer>;
-};
-type TagsNamespace = {
-    list(opts?: {
-        q?: string;
-        limit?: number;
-    } & CallOptions): Promise<StorefrontTagsAnswer>;
-};
-type CollectionsNamespace = {
-    list(opts?: {
-        limit?: number;
-        cursor?: string;
-    } & CallOptions): Promise<StorefrontCollectionsAnswer>;
-    get(handle: string, call?: CallOptions): Promise<StorefrontCollectionAnswer>;
-};
-type ReviewsNamespace = {
-    list(handle: string, opts?: {
-        sort?: 'newest' | 'highest' | 'lowest';
-        rating?: 1 | 2 | 3 | 4 | 5;
-        limit?: number;
-        cursor?: string;
-    } & CallOptions): Promise<StorefrontReviewsAnswer>;
-    eligibility(handle: string, call?: CallOptions): Promise<ReviewEligibilityAnswer>;
-    submit(handle: string, input: ReviewSubmitInput, opts?: {
-        idempotencyKey?: string;
-    } & CallOptions): Promise<ReviewSubmitAnswer>;
-};
-type CartsNamespace = {
-    check(items: {
-        sku: string;
-        quantity: number;
-    }[], opts?: CallOptions): Promise<CartCheckAnswer>;
-    create(input: CartCreateRequest, opts?: {
-        idempotencyKey?: string;
-    } & CallOptions): Promise<CartCreateAnswer>;
-    /** Throttle's cart-session routes; no catalog key and no customer token are sent. */
-    session(sessionId: string, opts?: {
-        throttleBaseUrl?: string;
-    }): CartSession;
-};
-type CatalogNamespaces = {
-    readonly products: ProductsNamespace;
-    readonly filters: FiltersNamespace;
-    readonly categories: CategoriesNamespace;
-    readonly tags: TagsNamespace;
-    readonly collections: CollectionsNamespace;
-    readonly suggest: (q: string, opts?: {
-        limit?: number;
-    } & CallOptions) => Promise<StorefrontSuggestAnswer>;
-    readonly config: (call?: CallOptions) => Promise<StorefrontConfigAnswer>;
-    readonly reviews: ReviewsNamespace;
-    readonly carts: CartsNamespace;
-};
-
-export type { ReviewSubmitInput as A, ReviewsNamespace as B, CallOptions as C, SessionCallOptions as D, StorefrontCategoriesAnswer as E, FieldsOption as F, StorefrontCategoryAnswer as G, StorefrontCollectionAnswer as H, StorefrontCollectionsAnswer as I, StorefrontConfigAnswer as J, StorefrontFilterValuesAnswer as K, StorefrontRelatedAnswer as L, StorefrontReviewsAnswer as M, NextFetchOptions as N, StorefrontSort as O, ProductsNamespace as P, StorefrontSuggestAnswer as Q, Redirect as R, StorefrontCategoryNode as S, StorefrontTagsAnswer as T, TagsNamespace as U, ThrottleCart as V, ThrottleLine as W, RequestSpec as X, StorefrontListAnswer as a, StorefrontListProduct as b, StorefrontProductAnswer as c, CartCheckAnswer as d, CartCheckRequest as e, CartCheckout as f, CartCheckoutInput as g, CartCreateAnswer as h, CartCreateRequest as i, CartSession as j, CartSessionBranding as k, CartSessionDetail as l, CartSessionSnapshot as m, CartsNamespace as n, CatalogClientOptions as o, CatalogContractErrorCode as p, CatalogHttpCache as q, CatalogHttpCacheEntry as r, CatalogNamespaces as s, CategoriesNamespace as t, CollectionsNamespace as u, CustomerTokenSource as v, FiltersNamespace as w, ProductsQuery as x, ReviewEligibilityAnswer as y, ReviewSubmitAnswer as z };
+export type { CartCheckAnswer as C, ReviewEligibilityAnswer as R, StorefrontCategoryNode as S, StorefrontListAnswer as a, StorefrontListProduct as b, StorefrontProductAnswer as c, CartCheckRequest as d, CartCreateAnswer as e, CartCreateRequest as f, CatalogContractErrorCode as g, ReviewSubmitAnswer as h, ReviewSubmitInput as i, StorefrontCategoriesAnswer as j, StorefrontCategoryAnswer as k, StorefrontCollectionAnswer as l, StorefrontCollectionsAnswer as m, StorefrontConfigAnswer as n, StorefrontFilterValuesAnswer as o, StorefrontRelatedAnswer as p, StorefrontReviewsAnswer as q, StorefrontSuggestAnswer as r, StorefrontTagsAnswer as s };

package/dist/{types-DYfIvIaI.d.ts → contract-types-DhiThMEr.d.ts}

@@ -596,275 +596,4 @@ type StorefrontTagsAnswer = {
 };
 type CatalogContractErrorCode = 'INVALID_REQUEST' | 'AUTHENTICATION_FAILED' | 'INFRASTRUCTURE_UNAVAILABLE' | 'PROVIDER_UNAVAILABLE' | 'INTERNAL_ERROR' | 'CUSTOMER_TOKEN_INVALID' | 'ORIGIN_NOT_ALLOWED' | 'SERVER_KEY_IN_BROWSER' | 'NOT_FOUND' | 'RATE_LIMITED' | 'STOREFRONT_UNAVAILABLE' | 'REQUEST_BODY_TOO_LARGE' | 'CART_CURRENCY_REQUIRED' | 'CART_CURRENCY_NOT_ENABLED' | 'CHECKOUT_NOT_CONFIGURED' | 'EXTENSION_UPGRADE_REQUIRED' | 'CART_ITEMS_INVALID' | 'CART_REJECTED' | 'CART_UNAVAILABLE' | 'CHECKOUT_UNAVAILABLE' | 'RETURN_URL_NOT_ALLOWED' | 'CHECKOUT_TOTAL_TOO_LARGE' | 'CHECKOUT_CART_MISMATCH' | 'CHECKOUT_ITEMS_INVALID' | 'CHECKOUT_REJECTED' | 'CURRENCY_NOT_ENABLED' | 'STOREFRONT_INDEXING' | 'EMAIL_NOT_VERIFIED' | 'NOT_VERIFIED_BUYER' | 'PURCHASE_REFUNDED' | 'ALREADY_REVIEWED' | 'REVIEW_QUEUE_FULL' | 'REVIEW_VERIFICATION_UNAVAILABLE';
 
-type QueryPairs = [string, string][];
-
-/** One stored answer for ETag reuse (P6-R13). */
-type CatalogHttpCacheEntry = {
-    etag: string;
-    body: unknown;
-};
-/** Caller-provided store for ETag reuse; without one nothing is sent (P6-R13). */
-type CatalogHttpCache = {
-    get(key: string): CatalogHttpCacheEntry | undefined;
-    set(key: string, entry: CatalogHttpCacheEntry): void;
-};
-type CustomerTokenSource = () => string | null | undefined | Promise<string | null | undefined>;
-type CatalogClientOptions = {
-    publishableKey: string;
-    baseUrl?: string;
-    fetch?: typeof fetch;
-    timeoutMs?: number;
-    currency?: string;
-    locale?: string;
-    customerToken?: CustomerTokenSource;
-    cache?: CatalogHttpCache;
-    /** The customer partition of the cache key (P6-R13). */
-    cacheScope?: () => string;
-    indexingRetry?: false | {
-        maxWaitSeconds: number;
-    };
-    headers?: Record<string, string>;
-};
-/** Next.js's `fetch` cache options; the SDK never imports Next. */
-type NextFetchOptions = {
-    revalidate?: number | false;
-    tags?: string[];
-};
-type CallOptions = {
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    currency?: string;
-    locale?: string;
-    /** Extra `fetch` init keys (for example Next's `next`); never overrides the request. */
-    fetchInit?: Record<string, unknown>;
-    /**
-     * Sent as the `fetch` init's `next` (over `fetchInit.next`). The server
-     * client adds one to every cacheable GET (P6-R17); a plain client passes it
-     * through. A request that carries a customer token drops it and is sent
-     * `cache: 'no-store'`.
-     */
-    next?: NextFetchOptions;
-};
-type RequestSpec = {
-    method: 'GET' | 'POST';
-    /** Already encoded, starting with `/`. */
-    path: string;
-    query?: QueryPairs;
-    body?: unknown;
-    /** `'optional'` and `'required'` both send a token when there is one; `tokenFallback` decides a `401`. */
-    customerToken: 'none' | 'optional' | 'required';
-    tokenFallback: 'anonymous' | 'throw';
-    /** The endpoint never answers a resource `404` (P6-R8 (b)). */
-    featureRoute: boolean;
-    idempotencyKey?: string;
-    /** `false` turns off the one indexing retry for this request (P6-R10). */
-    indexingRetry?: boolean;
-    ifNoneMatch?: string;
-    /**
-     * Query context the transport appends to a GET: `'priced'` adds `currency`
-     * and `locale`, `'locale'` adds `locale` only (call options over client
-     * options). A POST takes them in its body, from `context()`.
-     */
-    context?: 'priced' | 'locale';
-};
-
-/** A list sort the catalog knows. */
-type StorefrontSort = StorefrontListAnswer['sort'];
-/** An old handle's answer: where the resource lives now. */
-type Redirect = {
-    redirectTo: string;
-};
-/** `fields`: `lite` (the list default), `full`, or top-level product keys. */
-type FieldsOption = 'lite' | 'full' | readonly string[];
-/** The `/products` (and `/filters/:key/values`) selection. */
-type ProductsQuery = {
-    q?: string;
-    category?: string;
-    collection?: string;
-    /** Sent as repeated `tag`. */
-    tags?: string[];
-    featured?: boolean;
-    /** `filter.<key>`, one parameter per value; a range is one `min..max` value. */
-    filters?: Record<string, string | readonly string[]>;
-    handles?: string[];
-    skus?: string[];
-    vehicle?: {
-        year?: number;
-        make: string;
-        model: string;
-        submodel?: string;
-        engine?: string;
-    };
-    sort?: StorefrontSort | (string & {});
-    limit?: number;
-    page?: number;
-    cursor?: string;
-    /** `true` for every filter, or filter keys (repeated). */
-    facets?: boolean | readonly string[];
-    /** Comma-joined on the wire. */
-    fields?: FieldsOption;
-    /** Comma-joined on the wire. */
-    include?: readonly string[];
-};
-/** A line of a Throttle cart. */
-type ThrottleLine = {
-    id: string;
-    referenceId: string | null;
-    name: string;
-    quantity: number;
-    unitPrice: number;
-    imageUrl: string | null;
-    resolution?: {
-        status: 'resolved' | 'refused' | 'stale';
-        code: string | null;
-        maxQuantity: number | null;
-    } | null;
-};
-/** Throttle's cart as a cart session answers it; other keys pass through. */
-type ThrottleCart = {
-    cartId: string;
-    currency: string;
-    subtotal: number;
-    total: number;
-    unitCount: number;
-    lineItems?: ThrottleLine[];
-    lineResolver?: {
-        extensionId: string | null;
-    };
-} & {
-    [key: string]: unknown;
-};
-/**
- * A cart session answer, `data` unwrapped. Throttle sends `status` and
- * `expiresAt` on `get()` only; the mutations answer `{ cartSessionId, cart }`
- * and `refresh()` adds `changed`.
- */
-type CartSessionSnapshot = {
-    cartSessionId: string;
-    status?: string;
-    expiresAt?: string;
-    cart: ThrottleCart;
-    changed?: boolean;
-};
-/** The store's look, as Throttle answers it on a cart-session read. */
-type CartSessionBranding = {
-    logoUrl: string | null;
-    primaryColor: string | null;
-    merchantName: string | null;
-};
-/**
- * What `CartSession.get()` answers: the snapshot plus the fields only the
- * read carries. `metadata` is the session's own write-once metadata (the
- * buyer's return, cancel and storefront URLs among it), so its keys are the
- * caller's.
- */
-type CartSessionDetail = CartSessionSnapshot & {
-    status: string;
-    expiresAt: string;
-    /** Throttle sends both today; an older deployment may omit them. */
-    branding?: CartSessionBranding;
-    metadata?: Record<string, unknown>;
-};
-type CartCheckoutInput = {
-    /** Absolute `http:` or `https:` URL; anything else is refused before a request. */
-    returnUrl: string;
-    /** Absolute `http:` or `https:` URL; anything else is refused before a request. */
-    cancelUrl: string;
-    customerEmail?: string;
-    keepOpen?: boolean;
-};
-type CartCheckout = {
-    checkoutUrl: string;
-    checkoutSessionId: string;
-    expiresAt: string;
-};
-/** Per-call options of a cart-session call. */
-type SessionCallOptions = Pick<CallOptions, 'signal' | 'timeoutMs'>;
-/** One Throttle cart session, addressed by its opaque id. */
-type CartSession = {
-    readonly id: string;
-    get(call?: SessionCallOptions): Promise<CartSessionDetail>;
-    add(input: {
-        sku: string;
-        quantity?: number;
-        metadata?: Record<string, unknown>;
-    }, call?: SessionCallOptions): Promise<CartSessionSnapshot>;
-    update(lineId: string, quantity: number, call?: SessionCallOptions): Promise<CartSessionSnapshot>;
-    remove(lineId: string, call?: SessionCallOptions): Promise<CartSessionSnapshot>;
-    refresh(call?: SessionCallOptions): Promise<CartSessionSnapshot>;
-    /** Refuses non-http(s) URLs before a request, and never returns a non-http(s) `checkoutUrl`. */
-    checkout(input: CartCheckoutInput, call?: SessionCallOptions): Promise<CartCheckout>;
-};
-type ProductsNamespace = {
-    list(query?: ProductsQuery, call?: CallOptions): Promise<StorefrontListAnswer>;
-    /** Always the full product (`fields=full`, P6-R18), or a redirect. */
-    get(handle: string, opts?: {
-        include?: readonly string[];
-    } & CallOptions): Promise<StorefrontProductAnswer | Redirect>;
-    related(handle: string, opts?: {
-        limit?: number;
-        fields?: FieldsOption;
-    } & CallOptions): Promise<StorefrontRelatedAnswer>;
-};
-type FiltersNamespace = {
-    values(key: string, query?: ProductsQuery, call?: CallOptions): Promise<StorefrontFilterValuesAnswer>;
-};
-type CategoriesNamespace = {
-    tree(opts?: {
-        depth?: 1 | 2 | 3;
-    } & CallOptions): Promise<StorefrontCategoriesAnswer>;
-    get(handle: string, call?: CallOptions): Promise<StorefrontCategoryAnswer>;
-};
-type TagsNamespace = {
-    list(opts?: {
-        q?: string;
-        limit?: number;
-    } & CallOptions): Promise<StorefrontTagsAnswer>;
-};
-type CollectionsNamespace = {
-    list(opts?: {
-        limit?: number;
-        cursor?: string;
-    } & CallOptions): Promise<StorefrontCollectionsAnswer>;
-    get(handle: string, call?: CallOptions): Promise<StorefrontCollectionAnswer>;
-};
-type ReviewsNamespace = {
-    list(handle: string, opts?: {
-        sort?: 'newest' | 'highest' | 'lowest';
-        rating?: 1 | 2 | 3 | 4 | 5;
-        limit?: number;
-        cursor?: string;
-    } & CallOptions): Promise<StorefrontReviewsAnswer>;
-    eligibility(handle: string, call?: CallOptions): Promise<ReviewEligibilityAnswer>;
-    submit(handle: string, input: ReviewSubmitInput, opts?: {
-        idempotencyKey?: string;
-    } & CallOptions): Promise<ReviewSubmitAnswer>;
-};
-type CartsNamespace = {
-    check(items: {
-        sku: string;
-        quantity: number;
-    }[], opts?: CallOptions): Promise<CartCheckAnswer>;
-    create(input: CartCreateRequest, opts?: {
-        idempotencyKey?: string;
-    } & CallOptions): Promise<CartCreateAnswer>;
-    /** Throttle's cart-session routes; no catalog key and no customer token are sent. */
-    session(sessionId: string, opts?: {
-        throttleBaseUrl?: string;
-    }): CartSession;
-};
-type CatalogNamespaces = {
-    readonly products: ProductsNamespace;
-    readonly filters: FiltersNamespace;
-    readonly categories: CategoriesNamespace;
-    readonly tags: TagsNamespace;
-    readonly collections: CollectionsNamespace;
-    readonly suggest: (q: string, opts?: {
-        limit?: number;
-    } & CallOptions) => Promise<StorefrontSuggestAnswer>;
-    readonly config: (call?: CallOptions) => Promise<StorefrontConfigAnswer>;
-    readonly reviews: ReviewsNamespace;
-    readonly carts: CartsNamespace;
-};
-
-export type { ReviewSubmitInput as A, ReviewsNamespace as B, CallOptions as C, SessionCallOptions as D, StorefrontCategoriesAnswer as E, FieldsOption as F, StorefrontCategoryAnswer as G, StorefrontCollectionAnswer as H, StorefrontCollectionsAnswer as I, StorefrontConfigAnswer as J, StorefrontFilterValuesAnswer as K, StorefrontRelatedAnswer as L, StorefrontReviewsAnswer as M, NextFetchOptions as N, StorefrontSort as O, ProductsNamespace as P, StorefrontSuggestAnswer as Q, Redirect as R, StorefrontCategoryNode as S, StorefrontTagsAnswer as T, TagsNamespace as U, ThrottleCart as V, ThrottleLine as W, RequestSpec as X, StorefrontListAnswer as a, StorefrontListProduct as b, StorefrontProductAnswer as c, CartCheckAnswer as d, CartCheckRequest as e, CartCheckout as f, CartCheckoutInput as g, CartCreateAnswer as h, CartCreateRequest as i, CartSession as j, CartSessionBranding as k, CartSessionDetail as l, CartSessionSnapshot as m, CartsNamespace as n, CatalogClientOptions as o, CatalogContractErrorCode as p, CatalogHttpCache as q, CatalogHttpCacheEntry as r, CatalogNamespaces as s, CategoriesNamespace as t, CollectionsNamespace as u, CustomerTokenSource as v, FiltersNamespace as w, ProductsQuery as x, ReviewEligibilityAnswer as y, ReviewSubmitAnswer as z };
+export type { CartCheckAnswer as C, ReviewEligibilityAnswer as R, StorefrontCategoryNode as S, StorefrontListAnswer as a, StorefrontListProduct as b, StorefrontProductAnswer as c, CartCheckRequest as d, CartCreateAnswer as e, CartCreateRequest as f, CatalogContractErrorCode as g, ReviewSubmitAnswer as h, ReviewSubmitInput as i, StorefrontCategoriesAnswer as j, StorefrontCategoryAnswer as k, StorefrontCollectionAnswer as l, StorefrontCollectionsAnswer as m, StorefrontConfigAnswer as n, StorefrontFilterValuesAnswer as o, StorefrontRelatedAnswer as p, StorefrontReviewsAnswer as q, StorefrontSuggestAnswer as r, StorefrontTagsAnswer as s };

package/dist/index.cjs

@@ -10,7 +10,7 @@
 
 
 
-var _chunkZFUELHUUcjs = require('./chunk-ZFUELHUU.cjs');
+var _chunk4ORXUW2Ucjs = require('./chunk-4ORXUW2U.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 
@@ -24,4 +24,4 @@ require('./chunk-ETV4XYOV.cjs');
 
 
 
-exports.CartLineError = _chunkZFUELHUUcjs.CartLineError; exports.CatalogError = _chunkZFUELHUUcjs.CatalogError; exports.CustomerTokenInvalidError = _chunkZFUELHUUcjs.CustomerTokenInvalidError; exports.FeatureUnavailableError = _chunkZFUELHUUcjs.FeatureUnavailableError; exports.NetworkError = _chunkZFUELHUUcjs.NetworkError; exports.OriginNotAllowedError = _chunkZFUELHUUcjs.OriginNotAllowedError; exports.RateLimitedError = _chunkZFUELHUUcjs.RateLimitedError; exports.SDK_VERSION = _chunkZFUELHUUcjs.SDK_VERSION; exports.TimeoutError = _chunkZFUELHUUcjs.TimeoutError; exports.createCatalogClient = _chunkZFUELHUUcjs.createCatalogClient; exports.isCatalogError = _chunkZFUELHUUcjs.isCatalogError;
+exports.CartLineError = _chunk4ORXUW2Ucjs.CartLineError; exports.CatalogError = _chunk4ORXUW2Ucjs.CatalogError; exports.CustomerTokenInvalidError = _chunk4ORXUW2Ucjs.CustomerTokenInvalidError; exports.FeatureUnavailableError = _chunk4ORXUW2Ucjs.FeatureUnavailableError; exports.NetworkError = _chunk4ORXUW2Ucjs.NetworkError; exports.OriginNotAllowedError = _chunk4ORXUW2Ucjs.OriginNotAllowedError; exports.RateLimitedError = _chunk4ORXUW2Ucjs.RateLimitedError; exports.SDK_VERSION = _chunk4ORXUW2Ucjs.SDK_VERSION; exports.TimeoutError = _chunk4ORXUW2Ucjs.TimeoutError; exports.createCatalogClient = _chunk4ORXUW2Ucjs.createCatalogClient; exports.isCatalogError = _chunk4ORXUW2Ucjs.isCatalogError;