@sixtyninecommerce/client 0.29.0 → 0.31.0

package/dist/core/currency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../src/core/currency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,wFAAwF;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD,oEAAoE;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,SAAS,eAAe,CAAC,KAAsB,EAAE,YAAoB,EAAE,GAAW;IAChF,IAAI,KAAK,CAAC,SAAS,KAAK,kBAAkB;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;AACpF,CAAC;AAED,4FAA4F;AAC5F,SAAS,sBAAsB,CAAC,KAAsB,EAAE,OAAe;IACrE,OAAO,IAAI,eAAe,CACxB,OAAO,EACP,SAAS,EACT,GAAG,EACH,sBAAsB,EACtB,KAAK,CAAC,OAAO,EACb,SAAS,EACT;QACE,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK;KACb,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAsB,EACtB,mBAA2B;IAE3B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,mBAAmB,EAAE,mCAAmC,CAAC,EAAE,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,sBAAsB,CAC3B,KAAK,EACL,6BAA6B,mBAAmB,6CAA6C;QAC3F,yFAAyF;QACzF,oBAAoB,CACvB,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAClC,KAAsB,EACtB,YAAoB;IAEpB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,8BAA8B,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5F,OAAO,sBAAsB,CAC3B,KAAK,EACL,6BAA6B,YAAY,iDAAiD;QACxF,8CAA8C,CACjD,CAAC;AACJ,CAAC"}

package/dist/core/deprecation.d.ts

@@ -0,0 +1,23 @@
+import type { DeprecationNotice } from '@sixtyninecommerce/core';
+import type { MethodDeprecationNotice, StorefrontClientConfig } from '../types.js';
+type DeprecationHook = NonNullable<StorefrontClientConfig['onDeprecation']>;
+export declare const GRAPHQL_DEPRECATION: MethodDeprecationNotice;
+/**
+ * Who hears that a deprecated METHOD of this SDK was used. A configured hook is called once
+ * per reporter for each method — one reporter per single-store client, one per store router
+ * (shared by its per-request clients); without one the client prints the notice's line once
+ * per process.
+ */
+export declare function methodDeprecationReporter(onDeprecation?: DeprecationHook): (notice: MethodDeprecationNotice) => void;
+/** For a context built without a reporter (by hand, in a test): the process-wide default. */
+export declare const defaultMethodDeprecationReporter: (notice: MethodDeprecationNotice) => void;
+/**
+ * The hook as `@sixtyninecommerce/core`'s transports want it, for a deprecated platform ROUTE
+ * (a `Deprecation` response header): tagged `kind: 'endpoint'`. Undefined without a hook, so
+ * core keeps printing those itself, exactly as before the hook existed.
+ */
+export declare function endpointDeprecationHook(onDeprecation?: DeprecationHook): ((notice: DeprecationNotice) => void) | undefined;
+/** Refused at construction, before any request: a hook that is not a function. */
+export declare function assertDeprecationHook(onDeprecation: unknown): void;
+export {};
+//# sourceMappingURL=deprecation.d.ts.map

package/dist/core/deprecation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../src/core/deprecation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EAEvB,MAAM,aAAa,CAAC;AAErB,KAAK,eAAe,GAAG,WAAW,CAAC,sBAAsB,CAAC,eAAe,CAAC,CAAC,CAAC;AAc5E,eAAO,MAAM,mBAAmB,EAAE,uBAOhC,CAAC;AAyBH;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,CAAC,EAAE,eAAe,GAC9B,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAa3C;AAED,6FAA6F;AAC7F,eAAO,MAAM,gCAAgC,WAhBjC,uBAAuB,KAAK,IAgBmC,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,CAAC,EAAE,eAAe,GAC9B,CAAC,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,CAGnD;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,OAAO,GAAG,IAAI,CAQlE"}

package/dist/core/deprecation.js

@@ -0,0 +1,81 @@
+import { StorefrontError } from '../errors.js';
+/**
+ * What `client.graphql()` is replaced by. Kept in step with the `@deprecated` tag on
+ * `StorefrontClient.graphql` (types.ts), which names the same methods in the editor.
+ * No removal DATE on purpose (user decision F9): it keeps working until 1.0.
+ */
+const GRAPHQL_REPLACEMENT = 'the typed methods: client.commerce.* for the Shop API (getCollectionById, getProductById, ' +
+    'getProduct(slug, { metafields: true }), setOrderCurrency, getCapabilities, getBranding, ' +
+    'authenticate, setOrderCustomFields, transitionOrder, …), client.content.* for the CMS ' +
+    '(getContentString, getAsset, …) and the other modules. The Shop API fields no method sends ' +
+    'yet are listed in the MCP capability catalog (storefront://capability-catalog).';
+export const GRAPHQL_DEPRECATION = Object.freeze({
+    kind: 'method',
+    name: 'client.graphql',
+    replacement: GRAPHQL_REPLACEMENT,
+    message: `[@sixtyninecommerce/client] client.graphql() is deprecated and keeps working until 1.0: ` +
+        `call ${GRAPHQL_REPLACEMENT} Route or silence this notice with createStorefrontClient({ onDeprecation }).`,
+});
+/**
+ * Process-wide on purpose (spec §11, F9): the default warning is said ONCE per running
+ * process for each deprecated method, however many clients and routers the process builds —
+ * a storefront that builds a client per request would otherwise print it per request.
+ */
+const WARNED_METHODS = new Set();
+/**
+ * Hand a notice to the consumer's hook without letting the hook decide the call it observes:
+ * a throw, or a promise that rejects (an unhandled rejection ends a Node process), is logged.
+ */
+function deliver(hook, notice) {
+    const about = notice.kind === 'method' ? notice.name : `${notice.method} ${notice.path}`;
+    const failed = (error) => {
+        console.warn(`[@sixtyninecommerce/client] the onDeprecation handler threw for ${about}`, error);
+    };
+    try {
+        void Promise.resolve(hook(notice)).catch(failed);
+    }
+    catch (error) {
+        failed(error);
+    }
+}
+/**
+ * Who hears that a deprecated METHOD of this SDK was used. A configured hook is called once
+ * per reporter for each method — one reporter per single-store client, one per store router
+ * (shared by its per-request clients); without one the client prints the notice's line once
+ * per process.
+ */
+export function methodDeprecationReporter(onDeprecation) {
+    const told = new Set();
+    return (notice) => {
+        if (onDeprecation) {
+            if (told.has(notice.name))
+                return;
+            told.add(notice.name);
+            deliver(onDeprecation, notice);
+            return;
+        }
+        if (WARNED_METHODS.has(notice.name))
+            return;
+        WARNED_METHODS.add(notice.name);
+        console.warn(notice.message);
+    };
+}
+/** For a context built without a reporter (by hand, in a test): the process-wide default. */
+export const defaultMethodDeprecationReporter = methodDeprecationReporter();
+/**
+ * The hook as `@sixtyninecommerce/core`'s transports want it, for a deprecated platform ROUTE
+ * (a `Deprecation` response header): tagged `kind: 'endpoint'`. Undefined without a hook, so
+ * core keeps printing those itself, exactly as before the hook existed.
+ */
+export function endpointDeprecationHook(onDeprecation) {
+    if (!onDeprecation)
+        return undefined;
+    return (notice) => deliver(onDeprecation, { kind: 'endpoint', ...notice });
+}
+/** Refused at construction, before any request: a hook that is not a function. */
+export function assertDeprecationHook(onDeprecation) {
+    if (onDeprecation === undefined || typeof onDeprecation === 'function')
+        return;
+    throw new StorefrontError(`onDeprecation must be a function (notice) => void; got ${onDeprecation === null ? 'null' : typeof onDeprecation}`, 'cms', 400, 'INVALID_ARGUMENT');
+}
+//# sourceMappingURL=deprecation.js.map

package/dist/core/deprecation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.js","sourceRoot":"","sources":["../../src/core/deprecation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS/C;;;;GAIG;AACH,MAAM,mBAAmB,GACvB,4FAA4F;IAC5F,0FAA0F;IAC1F,wFAAwF;IACxF,6FAA6F;IAC7F,iFAAiF,CAAC;AAEpF,MAAM,CAAC,MAAM,mBAAmB,GAA4B,MAAM,CAAC,MAAM,CAAC;IACxE,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,mBAAmB;IAChC,OAAO,EACL,0FAA0F;QAC1F,QAAQ,mBAAmB,+EAA+E;CAC7G,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;AAEzC;;;GAGG;AACH,SAAS,OAAO,CAAC,IAAqB,EAAE,MAAmC;IACzE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACzF,MAAM,MAAM,GAAG,CAAC,KAAc,EAAQ,EAAE;QACtC,OAAO,CAAC,IAAI,CAAC,mEAAmE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAClG,CAAC,CAAC;IACF,IAAI,CAAC;QACH,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAY,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,aAA+B;IAE/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,OAAO;YAClC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO;QAC5C,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gCAAgC,GAAG,yBAAyB,EAAE,CAAC;AAE5E;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,aAA+B;IAE/B,IAAI,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IACrC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,qBAAqB,CAAC,aAAsB;IAC1D,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,aAAa,KAAK,UAAU;QAAE,OAAO;IAC/E,MAAM,IAAI,eAAe,CACvB,0DAA0D,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,aAAa,EAAE,EAClH,KAAK,EACL,GAAG,EACH,kBAAkB,CACnB,CAAC;AACJ,CAAC"}

package/dist/core/http.d.ts

@@ -24,9 +24,23 @@ export interface RequestOptions {
         readonly operation: string;
         readonly tags: readonly string[];
     };
+    /** See the public `RequestOptions.buyerIp`. */
+    buyerIp?: string;
+    /**
+     * SDK-internal: sent as the `Idempotency-Key` header on a Vendure call. Only
+     * the keyed payment calls set it — `commerce.addPayment`, `payDeposit` and
+     * `createDepositPaymentIntent` — for the Shop API operations that read it.
+     */
+    idempotencyKey?: string;
 }
-/** Mark a request as a taggable catalogue read, keeping the caller's own options. */
+/** Mark a request as a taggable read, keeping the caller's own options. */
 export declare function tagRequest(options: RequestOptions | undefined, operation: string, tags?: readonly string[]): RequestOptions;
+/**
+ * Mark a request as a CATALOGUE read: its own tags plus {@link CATALOG_TAG},
+ * which the events that move catalogue data without naming a product purge
+ * (`facet.*`, `price_list.changed`).
+ */
+export declare function tagCatalogRead(options: RequestOptions | undefined, operation: string, tags?: readonly string[]): RequestOptions;
 export interface HttpClient {
     graphql<T = unknown>(query: string, variables?: Record<string, unknown>, options?: RequestOptions): Promise<T>;
     graphqlUpload<T = unknown>(query: string, variables: Record<string, unknown>, files: Map<string, File>, options?: RequestOptions): Promise<T>;

package/dist/core/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CACjF;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAS,MAAM,EAAO,GAC3B,cAAc,CAEhB;AA8BD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,aAAa,CAAC,CAAC,GAAG,OAAO,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxF,UAAU,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAuDD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CA2M9D"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAChF,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAS,MAAM,EAAO,GAC3B,cAAc,CAEhB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAS,MAAM,EAAO,GAC3B,cAAc,CAEhB;AAqCD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,aAAa,CAAC,CAAC,GAAG,OAAO,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxF,UAAU,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAuDD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CA8O9D"}

package/dist/core/http.js

@@ -10,12 +10,22 @@
  * off).
  */
 import { createTransport, } from '@sixtyninecommerce/core';
+import { CATALOG_TAG, storeCacheTag } from '../cache-tags.js';
 import { REQUEST_TIMEOUT_MS } from '../constants.js';
 import { StorefrontError, toStorefrontError } from '../errors.js';
-/** Mark a request as a taggable catalogue read, keeping the caller's own options. */
+import { sessionCurrencyRefusal } from './currency.js';
+/** Mark a request as a taggable read, keeping the caller's own options. */
 export function tagRequest(options, operation, tags = []) {
     return { ...options, cacheTagging: { operation, tags } };
 }
+/**
+ * Mark a request as a CATALOGUE read: its own tags plus {@link CATALOG_TAG},
+ * which the events that move catalogue data without naming a product purge
+ * (`facet.*`, `price_list.changed`).
+ */
+export function tagCatalogRead(options, operation, tags = []) {
+    return tagRequest(options, operation, [CATALOG_TAG, ...tags]);
+}
 /**
  * The tags to send as `next: { tags }`, or `null` for none. Resolved per
  * request so a resolver sees exactly what it is deciding for.
@@ -28,7 +38,13 @@ function fetchCacheTags(ctx, options) {
     const extra = options?.cacheTags ?? [];
     if (!tagging && extra.length === 0)
         return null;
-    const merged = [...new Set([...(tagging?.tags ?? []), ...extra])];
+    const bare = [...new Set([...(tagging?.tags ?? []), ...extra])];
+    // A multi-store client serves several stores from one process, so a bare
+    // `catalog` purge would drop every store's catalogue. The scoped copy lets a
+    // store's own events purge only its own reads; the bare tag stays beside it.
+    const merged = ctx.storeScopedCacheTags
+        ? [...bare, ...bare.map((tag) => storeCacheTag(ctx.channel.code, tag))]
+        : bare;
     const resolved = typeof setting === 'function'
         ? setting(merged, { operation: tagging?.operation ?? 'graphql' })
         : merged;
@@ -94,10 +110,15 @@ export function createHttpClient(ctx) {
         tenant: () => ({
             scope: { kind: 'channel', code: ctx.channel.code },
             ...(ctx.languageCode ? { language: ctx.languageCode } : {}),
+            ...(ctx.sessionCurrencyCode ? { currency: ctx.sessionCurrencyCode } : {}),
             ...(ctx.orderScope ? { orderScope: ctx.orderScope } : {}),
+            // `core` stamps it as `x-head` on every service; the platform composes
+            // the links it emails for this request on that head's origin.
+            ...(ctx.head ? { head: ctx.head } : {}),
         }),
         channels: channelResolverFor(ctx),
         fetch: ctx.fetch,
+        ...(ctx.onDeprecation ? { onDeprecation: ctx.onDeprecation } : {}),
         // `attempts: 0` used to mean one attempt here (`Math.max(1, …)`); core
         // treats a value below 1 as unset and would fall back to its own default,
         // so the floor is applied before it gets there.
@@ -111,6 +132,11 @@ export function createHttpClient(ctx) {
         // and each maps its own response. Converting underneath them would rename
         // every key they read.
         convertCase: false,
+        // A server-side storefront's credential, on every service. `core` refuses
+        // it in a browser; `createStoreContext` already did, before any request.
+        ...(ctx.privateToken
+            ? { storefrontToken: ctx.privateToken, buyerIp: () => ctx.buyerIp ?? undefined }
+            : {}),
     };
     /** Vendure: the shopper's session, when there is one. */
     const vendureTransport = createTransport({
@@ -143,6 +169,9 @@ export function createHttpClient(ctx) {
     const restTransport = createTransport({
         ...shared,
         principal: { kind: 'anonymous' },
+        // On by default (F6). Only this transport: it is the anonymous one, and
+        // the Vendure transport above carries the shopper's session.
+        conditionalReads: ctx.conditionalReads ?? true,
     });
     /**
      * Decide whether the stored session is genuinely dead and fire `onAuthExpired`
@@ -191,11 +220,32 @@ export function createHttpClient(ctx) {
             return null;
         }
     }
+    /**
+     * A session currency the channel refuses fails EVERY Shop API request, this
+     * one included, before any resolver runs — so it is reported as
+     * `CURRENCY_NOT_AVAILABLE` and cleared, never left to break the next call
+     * too. Cleared only when it is still the code the refusal named: a request
+     * that raced a newer `setOrderCurrency` must not undo the shopper's choice.
+     */
+    function currencyReset(error, sent) {
+        if (!sent)
+            return error;
+        const refusal = sessionCurrencyRefusal(error, sent);
+        if (!refusal)
+            return error;
+        if (ctx.sessionCurrencyCode === sent) {
+            ctx.sessionCurrencyCode = null;
+            ctx.currencyCode = ctx.channel.defaultCurrencyCode;
+        }
+        return refusal;
+    }
     /** The per-call options `core` takes, plus this SDK's cache tagging. */
     function callOptions(options, extra) {
         const tags = fetchCacheTags(ctx, options);
         return {
             ...(options?.signal ? { signal: options.signal } : {}),
+            ...(options?.buyerIp ? { buyerIp: options.buyerIp } : {}),
+            ...(options?.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
             // Next.js reads `next.tags` off the fetch init for `revalidateTag`; other
             // fetch implementations ignore keys they do not know. No cache policy is set.
             ...(tags ? { fetchInit: { next: { tags } } } : {}),
@@ -203,6 +253,8 @@ export function createHttpClient(ctx) {
         };
     }
     async function graphqlRequest(query, variables, options, isProbe, files) {
+        // What this request names: `setOrderCurrency` may change it while in flight.
+        const sentCurrency = ctx.sessionCurrencyCode ?? null;
         try {
             return await vendureTransport.graphql({ query, variables, api: 'shop', ...(files ? { files } : {}) }, 
             // An upload streams a file body; 15s is the read timeout for a JSON
@@ -212,7 +264,7 @@ export function createHttpClient(ctx) {
         catch (error) {
             const converted = toStorefrontError(error, 'vendure');
             await maybeSignalAuthExpired(converted, isProbe);
-            throw converted;
+            throw currencyReset(converted, sentCurrency);
         }
     }
     function graphql(query, variables, options) {

package/dist/core/http.js.map

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

package/dist/core/public-artifact.d.ts

@@ -0,0 +1,72 @@
+/**
+ * One read of a platform-rendered public file — a sitemap, robots.txt,
+ * llms.txt, the IndexNow key, a product feed — reduced to the four outcomes a
+ * proxy has to tell apart. Framework-neutral: a `fetch` in, a plain object out.
+ *
+ * Deliberately NOT the SDK transport (`core/http.ts`):
+ * - the bodies are XML and text, not JSON;
+ * - the upstream `ETag` must reach the storefront's caller untouched, and a
+ *   `304` must come back AS a `304`: a transport-level conditional-read cache
+ *   answers a `304` from memory with the stored body, which is right for a
+ *   menu read and wrong for a crawler that asked "has this changed?";
+ * - no credential is ever sent, the private storefront token included. The
+ *   files are public, keyed by the store code in the path, and the same bytes
+ *   for every caller; a secret on the request would buy nothing and travel
+ *   with a response every CDN on the way is told to share.
+ */
+/** Seconds a crawler is told to wait after a `503`. */
+export declare const ARTIFACT_RETRY_AFTER_SECONDS = 60;
+/**
+ * What the platform answered, as one of four outcomes:
+ * - `200` — the body, its `Content-Type` and `ETag` as the platform sent them;
+ * - `304` — unchanged since the `ifNoneMatch` you sent (no body);
+ * - `404` — the platform has no such file for this store. It says why in
+ *   `detail` (llms.txt is off, the store lacks the SEO plugin or a storefront
+ *   URL, the feed is unknown or paused) — diagnostics for YOUR logs and tools;
+ *   the responders never put it in a crawler's response;
+ * - `503` — anything else. `upstreamStatus` (with the platform's `detail`)
+ *   when the platform answered some other status; `error` when the request
+ *   itself failed — the network, or the timeout. `retryAfterSeconds` is the
+ *   wait to advertise.
+ */
+export type PublicArtifactRead<Body> = {
+    status: 200;
+    body: Body;
+    contentType?: string;
+    etag?: string;
+} | {
+    status: 304;
+    etag?: string;
+} | {
+    status: 404;
+    detail?: string;
+} | {
+    status: 503;
+    retryAfterSeconds: number;
+    upstreamStatus?: number;
+    detail?: string;
+    error?: string;
+};
+export interface PublicArtifactReadOptions {
+    /** Sent upstream as `If-None-Match`; a match answers `304`. */
+    ifNoneMatch?: string;
+    /**
+     * The caller's cancellation. An abort through it REJECTS with the signal's
+     * reason (the caller asked to stop); the timeout below is a `503` instead.
+     */
+    signal?: AbortSignal;
+    /** Deadline for the whole exchange, body included. */
+    timeoutMs: number;
+    /**
+     * Extra `RequestInit` keys (the Next adapters' `next: { tags }`). Never
+     * `headers` or `signal`: those are this function's.
+     */
+    init?: Record<string, unknown>;
+}
+/**
+ * GET `url` once. `readBody` runs INSIDE the deadline: a transfer that stalls
+ * or drops mid-body is a `503`, never a truncated `200` — a proxy that let the
+ * `200` and its `Cache-Control` out first would have a CDN cache half a feed.
+ */
+export declare function readPublicArtifact<Body>(fetchFn: typeof globalThis.fetch, url: string, readBody: (response: Response) => Promise<Body>, options: PublicArtifactReadOptions): Promise<PublicArtifactRead<Body>>;
+//# sourceMappingURL=public-artifact.d.ts.map

package/dist/core/public-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-artifact.d.ts","sourceRoot":"","sources":["../../src/core/public-artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,uDAAuD;AACvD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAG/C;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,CAAC,IAAI,IAC/B;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IACE,MAAM,EAAE,GAAG,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AA4BN,MAAM,WAAW,yBAAyB;IACxC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAiCD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAC3C,OAAO,EAAE,OAAO,UAAU,CAAC,KAAK,EAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CA6CnC"}

package/dist/core/public-artifact.js

@@ -0,0 +1,122 @@
+/**
+ * One read of a platform-rendered public file — a sitemap, robots.txt,
+ * llms.txt, the IndexNow key, a product feed — reduced to the four outcomes a
+ * proxy has to tell apart. Framework-neutral: a `fetch` in, a plain object out.
+ *
+ * Deliberately NOT the SDK transport (`core/http.ts`):
+ * - the bodies are XML and text, not JSON;
+ * - the upstream `ETag` must reach the storefront's caller untouched, and a
+ *   `304` must come back AS a `304`: a transport-level conditional-read cache
+ *   answers a `304` from memory with the stored body, which is right for a
+ *   menu read and wrong for a crawler that asked "has this changed?";
+ * - no credential is ever sent, the private storefront token included. The
+ *   files are public, keyed by the store code in the path, and the same bytes
+ *   for every caller; a secret on the request would buy nothing and travel
+ *   with a response every CDN on the way is told to share.
+ */
+/** Seconds a crawler is told to wait after a `503`. */
+export const ARTIFACT_RETRY_AFTER_SECONDS = 60;
+/** Longest platform `detail` passed on; a problem body is short, a proxy page is not. */
+const MAX_DETAIL_LENGTH = 500;
+/**
+ * The `detail` of an RFC 9457 problem body (or its legacy `message`), when the
+ * platform sent one. Never throws: an unreadable or non-problem body simply
+ * has no detail, and must not turn a clean `404` into a `503`.
+ */
+async function problemDetail(response) {
+    const contentType = response.headers.get('content-type') ?? '';
+    if (!contentType.includes('json')) {
+        response.body?.cancel().catch(() => undefined);
+        return undefined;
+    }
+    try {
+        const parsed = (await response.json());
+        const detail = parsed?.detail ?? parsed?.message;
+        return typeof detail === 'string' && detail.trim() !== ''
+            ? detail.slice(0, MAX_DETAIL_LENGTH)
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * One signal that fires on the timeout OR the caller's abort, whichever comes
+ * first. Linked by hand: `AbortSignal.any` is missing from runtimes this
+ * package still supports.
+ */
+function deadline(timeoutMs, callerSignal) {
+    const controller = new AbortController();
+    // The same reason `AbortSignal.timeout()` rejects with, so a timed-out proxy
+    // reports what it always has.
+    const timer = setTimeout(() => {
+        controller.abort(new DOMException('The operation was aborted due to timeout', 'TimeoutError'));
+    }, timeoutMs);
+    const onCallerAbort = () => {
+        controller.abort(callerSignal?.reason);
+    };
+    if (callerSignal?.aborted)
+        onCallerAbort();
+    else
+        callerSignal?.addEventListener('abort', onCallerAbort, { once: true });
+    return {
+        signal: controller.signal,
+        dispose() {
+            clearTimeout(timer);
+            callerSignal?.removeEventListener('abort', onCallerAbort);
+        },
+    };
+}
+/**
+ * GET `url` once. `readBody` runs INSIDE the deadline: a transfer that stalls
+ * or drops mid-body is a `503`, never a truncated `200` — a proxy that let the
+ * `200` and its `Cache-Control` out first would have a CDN cache half a feed.
+ */
+export async function readPublicArtifact(fetchFn, url, readBody, options) {
+    // Only the validator. The inbound User-Agent in particular is never
+    // forwarded: the platform host blocks crawler UAs and must see this server.
+    const headers = {};
+    if (options.ifNoneMatch)
+        headers['If-None-Match'] = options.ifNoneMatch;
+    const limit = deadline(options.timeoutMs, options.signal);
+    try {
+        const upstream = await fetchFn(url, { ...options.init, headers, signal: limit.signal });
+        const etag = upstream.headers.get('etag') ?? undefined;
+        if (upstream.status === 304) {
+            return etag === undefined ? { status: 304 } : { status: 304, etag };
+        }
+        if (!upstream.ok) {
+            const detail = await problemDetail(upstream);
+            const why = detail === undefined ? {} : { detail };
+            return upstream.status === 404
+                ? { status: 404, ...why }
+                : {
+                    status: 503,
+                    retryAfterSeconds: ARTIFACT_RETRY_AFTER_SECONDS,
+                    upstreamStatus: upstream.status,
+                    ...why,
+                };
+        }
+        const body = await readBody(upstream);
+        const contentType = upstream.headers.get('content-type') ?? undefined;
+        return {
+            status: 200,
+            body,
+            ...(contentType === undefined ? {} : { contentType }),
+            ...(etag === undefined ? {} : { etag }),
+        };
+    }
+    catch (error) {
+        if (options.signal?.aborted)
+            throw options.signal.reason;
+        return {
+            status: 503,
+            retryAfterSeconds: ARTIFACT_RETRY_AFTER_SECONDS,
+            error: error instanceof Error ? error.message : 'Proxy failed',
+        };
+    }
+    finally {
+        limit.dispose();
+    }
+}
+//# sourceMappingURL=public-artifact.js.map

package/dist/core/public-artifact.js.map

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

package/dist/core/unknown-field-rejection.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Whether a Shop API failure is "this Vendure does not know that field yet",
+ * as opposed to a transient failure that must not be papered over.
+ *
+ * Two spellings, because the message is not always preserved: graphql-js
+ * answers a validation rejection with HTTP 400, and the HTTP client turns any
+ * non-ok response into `Vendure Shop API returned 400` before it parses the
+ * body; when the body IS parsed, the message is graphql-js's standard
+ * `Cannot query field "x" on type "y"`. (Same two spellings the plugins
+ * service matches for its own compat fallback.)
+ *
+ * Everything else — a timeout, a 5xx from a rolling restart, a connection
+ * reset, a GraphQL error that is not a validation rejection — deliberately
+ * does NOT match: degrading on those would hide an outage behind silently
+ * missing fields.
+ */
+export declare function isUnknownFieldRejection(error: unknown): boolean;
+//# sourceMappingURL=unknown-field-rejection.d.ts.map

package/dist/core/unknown-field-rejection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-field-rejection.d.ts","sourceRoot":"","sources":["../../src/core/unknown-field-rejection.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkB/D"}

package/dist/core/unknown-field-rejection.js

@@ -0,0 +1,37 @@
+import { StorefrontError } from '../errors.js';
+/**
+ * Whether a Shop API failure is "this Vendure does not know that field yet",
+ * as opposed to a transient failure that must not be papered over.
+ *
+ * Two spellings, because the message is not always preserved: graphql-js
+ * answers a validation rejection with HTTP 400, and the HTTP client turns any
+ * non-ok response into `Vendure Shop API returned 400` before it parses the
+ * body; when the body IS parsed, the message is graphql-js's standard
+ * `Cannot query field "x" on type "y"`. (Same two spellings the plugins
+ * service matches for its own compat fallback.)
+ *
+ * Everything else — a timeout, a 5xx from a rolling restart, a connection
+ * reset, a GraphQL error that is not a validation rejection — deliberately
+ * does NOT match: degrading on those would hide an outage behind silently
+ * missing fields.
+ */
+export function isUnknownFieldRejection(error) {
+    if (!(error instanceof StorefrontError))
+        return false;
+    if (error.service !== 'vendure')
+        return false;
+    // NOT every 400. `BAD_USER_INPUT` and `USER_INPUT_ERROR` are also mapped to
+    // 400, and those are EXECUTION-time refusals — `getMyQuote` on somebody
+    // else's quote is one — where the document did run. Re-issuing the legacy
+    // document there doubles the request, reports the second attempt's error
+    // instead of the first, and for a mutation replays a write that only
+    // `@Transaction()` rolled back. The two codes below both mean the document
+    // was refused before execution:
+    //   BAD_REQUEST — an HTTP 400 with no GraphQL body, which is how graphql-js
+    //                 answers a validation failure;
+    //   GRAPHQL_VALIDATION_FAILED — the same refusal as a coded `errors[]` entry.
+    return (error.errorCode === 'BAD_REQUEST' ||
+        error.errorCode === 'GRAPHQL_VALIDATION_FAILED' ||
+        /Cannot query field/i.test(error.message));
+}
+//# sourceMappingURL=unknown-field-rejection.js.map

package/dist/core/unknown-field-rejection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-field-rejection.js","sourceRoot":"","sources":["../../src/core/unknown-field-rejection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,CAAC,CAAC,KAAK,YAAY,eAAe,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC9C,4EAA4E;IAC5E,wEAAwE;IACxE,0EAA0E;IAC1E,yEAAyE;IACzE,qEAAqE;IACrE,2EAA2E;IAC3E,gCAAgC;IAChC,4EAA4E;IAC5E,gDAAgD;IAChD,8EAA8E;IAC9E,OAAO,CACL,KAAK,CAAC,SAAS,KAAK,aAAa;QACjC,KAAK,CAAC,SAAS,KAAK,2BAA2B;QAC/C,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAC1C,CAAC;AACJ,CAAC"}

package/dist/credit/credit-status.d.ts

@@ -1,5 +1,7 @@
 import type { HttpClient, RequestOptions } from '../core/http.js';
 import type { B2bCreditStatus } from '../types.js';
+export declare const B2B_CREDIT_STATUS: string;
+export declare const B2B_CREDIT_STATUS_LEGACY: string;
 export declare function createCreditStatusMethods(http: HttpClient): {
     getCreditStatus(options?: RequestOptions): Promise<B2bCreditStatus | null>;
 };

package/dist/credit/credit-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credit-status.d.ts","sourceRoot":"","sources":["../../src/credit/credit-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAsBnD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU;8BAEtB,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;EASnF"}
+{"version":3,"file":"credit-status.d.ts","sourceRoot":"","sources":["../../src/credit/credit-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAyCnD,eAAO,MAAM,iBAAiB,QAO7B,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAOpC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU;8BAOtB,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;EA6BnF"}