@sixtyninecommerce/client 0.29.0 → 0.31.0

package/dist/media/video.js.map

@@ -1 +1 @@
-{"version":3,"file":"video.js","sourceRoot":"","sources":["../../src/media/video.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../src/media/video.ts"],"names":[],"mappings":"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"}

package/dist/multi-store.d.ts

@@ -0,0 +1,200 @@
+/**
+ * One storefront process, several stores (headless spec §6.2, §12.2;
+ * multi-region §7.9).
+ *
+ * `createStorefrontClient({ resolveStore })` returns a store ROUTER. Each
+ * request asks it for a `StorefrontClient` of its own, assembled from two
+ * halves that never mix:
+ *
+ * - **Per store, shared by every request for that store:** the channel snapshot
+ *   (frozen), the CDN, the redirect store and the fact that the code names a
+ *   real store. Held in a bounded LRU; one CMS channel resolver serves them all.
+ * - **Per request, shared with nothing:** the sign-in, language, session
+ *   currency, order scope, head and buyer address — a NEW `StoreContext` for
+ *   every `forRequest`/`forStore`, so two concurrent requests (for one store or
+ *   two) can never send each other's token or price in each other's currency.
+ *
+ * Which store a request is for is the storefront's own rule (ruling F8): a
+ * function from the request to a store code. Nothing is looked up on the
+ * platform; `storeFromHostMap` and `storeFromPathPrefix` cover a fixed list.
+ */
+import type { HeadKey, OrderScope, StorefrontClient, StorefrontClientConfig } from './types.js';
+/**
+ * What a store resolver answers for one request:
+ *
+ * - a store code;
+ * - `{ storeCode, head?, language? }` to also name the head the request came
+ *   in on (`x-head`, where emailed links point) or the language it is in;
+ * - `null` (or `undefined`) for a request that belongs to no store —
+ *   `forRequest` then refuses with 404 `STORE_NOT_RESOLVED`.
+ */
+export type StoreResolution = string | {
+    readonly storeCode: string;
+    readonly head?: HeadKey;
+    readonly language?: string;
+} | null | undefined;
+/** The request a store resolver decides on: a parsed URL and the headers, both copies. */
+export interface StoreRequest {
+    readonly url: URL;
+    readonly headers: Headers;
+}
+/** Your rule for which store a request belongs to (ruling F8). May be async. */
+export type StoreResolver = (request: StoreRequest) => StoreResolution | Promise<StoreResolution>;
+/**
+ * What `forRequest` accepts: a Fetch `Request` (Next.js route handlers and
+ * middleware hand you one), or its two parts. The URL must be ABSOLUTE — on a
+ * plain `node:http` server build it from the `Host` header you trust.
+ */
+export type StoreRequestInput = Request | {
+    readonly url: string | URL;
+    readonly headers?: Headers | Readonly<Record<string, string>>;
+};
+/**
+ * The shopper state of ONE request. Everything here applies to the client
+ * `forRequest`/`forStore` returns and to nothing else.
+ */
+export interface StoreRequestOptions {
+    /** The shopper's session, e.g. from a cookie — see `StorefrontClientConfig.customerToken`. */
+    customerToken?: string;
+    /** The currency the shopper chose — see `StorefrontClientConfig.currencyCode`. */
+    currencyCode?: string;
+    /** Wins over the resolution's `language`, the config's `defaultLanguageCode` and the store's default. */
+    languageCode?: string;
+    /** Wins over the config's `orderScope`. */
+    orderScope?: OrderScope;
+    /** Wins over the resolution's `head` and the config's `head`. */
+    head?: HeadKey;
+    /**
+     * The shopper's address — see `StorefrontClientConfig.buyerIp`. Sent only to a
+     * store that has a private token, and left out for any other (the platform
+     * ignores it there), so one handler can pass it on every request without
+     * knowing which store the request will resolve to. Refused when blank.
+     */
+    buyerIp?: string;
+    /** Wins over the config's callback for this request. */
+    onAuthToken?: (token: string) => void;
+    /** Wins over the config's callback for this request. */
+    onAuthExpired?: () => void;
+    /** Wins over the config's callback for this request. */
+    onAuthCleared?: () => void;
+}
+/**
+ * Configuration for one process serving several stores. Everything a
+ * single-store client takes, except what belongs to ONE store or ONE shopper:
+ *
+ * - no `storeCode` — `resolveStore` decides per request;
+ * - no `customerToken`, `currencyCode` or `buyerIp` — a value here would be
+ *   sent by every request to every store; pass them per request instead
+ *   (`forRequest(request, { customerToken })`);
+ * - `privateToken` per store — a private storefront token is bound to ONE
+ *   channel, and the platform ignores it on any other store's requests.
+ */
+export interface MultiStoreClientConfig extends Omit<StorefrontClientConfig, 'storeCode' | 'customerToken' | 'currencyCode' | 'buyerIp' | 'privateToken'> {
+    storeCode?: never;
+    customerToken?: never;
+    currencyCode?: never;
+    buyerIp?: never;
+    /** Which store a request belongs to. Return `null` for none. */
+    resolveStore: StoreResolver;
+    /**
+     * The store codes this process serves. Set it whenever `resolveStore` passes
+     * on anything taken from the request: a code outside the list is refused
+     * (404 `STORE_NOT_ALLOWED`) before any request reaches the platform, so a
+     * visitor cannot make the process look up codes it never meant to serve.
+     */
+    stores?: readonly string[];
+    /**
+     * The private storefront token of each store (`s69p_…`, one per head, from
+     * `admin.heads.privateTokens.issue`), by store code — or a function from the
+     * code to its token. A store with none sends none. Never in a browser.
+     */
+    privateToken?: Readonly<Record<string, string>> | ((storeCode: string) => string | undefined);
+}
+/** A store router. Each call returns a fresh client whose shopper state is its own. */
+export interface MultiStoreClient {
+    /**
+     * The client for this request's store, per your `resolveStore`.
+     *
+     * Refuses with `StorefrontError` (404 `STORE_NOT_RESOLVED`) when the resolver
+     * returns `null`, 404 `STORE_NOT_ALLOWED` for a code outside `stores`, and 404
+     * `CHANNEL_NOT_FOUND` for a code that names no store — an unknown code, the
+     * bootstrap root `__default_channel__`, or an organization's workspace (a
+     * hub is never a storefront). An error your resolver throws is passed on.
+     */
+    forRequest(request: StoreRequestInput, options?: StoreRequestOptions): Promise<StorefrontClient>;
+    /** The client for a store you name, with the same refusals as {@link forRequest}. */
+    forStore(storeCode: string, options?: StoreRequestOptions): Promise<StorefrontClient>;
+}
+/**
+ * Forget what the router's shared channel resolver holds for a store code, so the next request
+ * for it asks the CMS again — `channel.renamed` delivers this before any request has to fail
+ * on the old code's rotated token (W8-16b). A no-op for anything that is not a router.
+ */
+export declare function forgetStoreCode(router: MultiStoreClient, storeCode: string): void;
+/**
+ * Hear about any of the router's stores failing to load its redirect map — the
+ * one signal that redirects have stopped refreshing (the stores keep serving
+ * their last good map). `createRedirectMiddleware({ client, onError })` wires
+ * its `onError` here. Returns the unsubscribe.
+ */
+export declare function onRedirectError(router: MultiStoreClient, listener: (error: Error) => void): () => void;
+/** Is this a store router (`createStorefrontClient({ resolveStore })`)? */
+export declare function isMultiStoreClient(value: unknown): value is MultiStoreClient;
+/** Does this config ask for a store router rather than one store's client? */
+export declare function isMultiStoreConfig(config: StorefrontClientConfig | MultiStoreClientConfig): config is MultiStoreClientConfig;
+/**
+ * The client an adapter serves a request from: a router resolves the request
+ * (`null` when it belongs to no store the router serves — answer it 404); a
+ * single-store client, or its promise, is the answer as it always was.
+ */
+export declare function adapterClient(source: StorefrontClient | Promise<StorefrontClient> | MultiStoreClient, request: Request): Promise<StorefrontClient | null>;
+/** Did a router refuse because the request belongs to no store it serves? */
+export declare function isStoreRefusal(error: unknown): boolean;
+/**
+ * The tags an adapter's own upstream fetch carries: the bare tag, plus its
+ * store-scoped copy when the client serves one store of several.
+ */
+export declare function adapterCacheTags(client: Pick<StorefrontClient, 'context'>, tag: string): string[];
+/**
+ * Is this code a store? Organization workspaces (hubs) are mirrored into the
+ * CMS and answer `GET /channels/by-code/:code` with 200, so the lookup cannot
+ * tell; the Shop API refuses a hub's token with 404 `CHANNEL_NOT_FOUND`
+ * (multi-region #792). One read per store per channel id, never per request.
+ */
+export declare const STORE_PROBE = "\n  query StoreProbe {\n    activeChannel {\n      id\n    }\n  }\n";
+export declare function createMultiStoreClient(config: MultiStoreClientConfig): MultiStoreClient;
+/**
+ * A resolver for a fixed list of addresses (ruling F8): the request's host →
+ * its store. A key with a port (`localhost:3000`) matches only that port; a
+ * key without one matches the host on any port. Anything unlisted resolves to
+ * `null` (404 `STORE_NOT_RESOLVED`).
+ *
+ * Decides by the `Host` header the server received, and only by the URL when
+ * the request carries none: a self-hosted Next.js server (`next start`, the
+ * standalone output) builds `request.url` on its OWN host (`localhost:3000`),
+ * so the URL alone would resolve no visitor to any store. Never by
+ * `X-Forwarded-Host`: a visitor can send that header, and a cache in front of
+ * you keys on the Host it saw — so trusting it would let anyone fill store A's
+ * cache with store B's pages. Behind a proxy that rewrites Host, write a
+ * resolver that reads the header your proxy guarantees.
+ *
+ * @example
+ * ```ts
+ * storeFromHostMap({
+ *   'fashion.example.com': 'fashion-store',
+ *   'trade.fashion.example.com': { storeCode: 'fashion-store', head: 'trade' },
+ * });
+ * ```
+ */
+export declare function storeFromHostMap(map: Readonly<Record<string, StoreResolution>>): StoreResolver;
+/**
+ * A resolver for stores under path prefixes (`/nl/…` → one store, `/be/…` →
+ * another). Matches whole segments only (`/nl` never matches `/nlx`), longest
+ * prefix first; `/` alone matches every path, as a fallback. Anything else
+ * resolves to `null` (404 `STORE_NOT_RESOLVED`).
+ *
+ * The prefix stays part of every URL: canonical links are built on each
+ * store's own main shop address (`storefrontUrl`, e.g. `https://example.com/nl`).
+ */
+export declare function storeFromPathPrefix(map: Readonly<Record<string, StoreResolution>>): StoreResolver;
+//# sourceMappingURL=multi-store.d.ts.map

package/dist/multi-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-store.d.ts","sourceRoot":"","sources":["../src/multi-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAuCH,OAAO,KAAK,EAEV,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAGpB;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnF,IAAI,GACJ,SAAS,CAAC;AAGd,0FAA0F;AAC1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAGD,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAGlG;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP;IACE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D,CAAC;AAGN;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,8FAA8F;IAC9F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAGD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBACf,SAAQ,IAAI,CACV,sBAAsB,EACtB,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,SAAS,GAAG,cAAc,CAC5E;IACD,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,gEAAgE;IAChE,YAAY,EAAE,aAAa,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;CAC/F;AAGD,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjG,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvF;AAaD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAKjF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC/B,MAAM,IAAI,CAOZ;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAM5E;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,GACtD,MAAM,IAAI,sBAAsB,CAElC;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,EACvE,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAQlC;AASD,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjG;AAQD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,wEAMvB,CAAC;AAgKF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,CAqOvF;AA6BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,GAAG,aAAa,CA2B9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,GAAG,aAAa,CAyBjG"}