@sixtyninecommerce/client 0.24.0 → 0.25.0

package/dist/commerce/search.js

@@ -9,6 +9,8 @@ export function createSearchMethods(http) {
                 vars.collectionSlug = input.collectionSlug;
             if (input.collectionId)
                 vars.collectionId = input.collectionId;
+            // Plural collection filters combine with AND server-side — a product must
+            // belong to every listed collection (the storefront's cross-group filter).
             if (input.collectionSlugs?.length)
                 vars.collectionSlugs = input.collectionSlugs;
             if (input.collectionIds?.length)
@@ -23,6 +25,7 @@ export function createSearchMethods(http) {
                 vars.skip = input.skip;
             if (input.sort)
                 vars.sort = input.sort;
+            // Only ids are taggable up front; slug filters resolve server-side.
             const collectionIds = [
                 ...(input.collectionId ? [input.collectionId] : []),
                 ...(input.collectionIds ?? []),

package/dist/commerce/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commerce/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAmB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAClD,OAAO;QACL,KAAK,CAAC,cAAc,CAAC,KAAkB,EAAE,OAAwB;YAC/D,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3D,IAAI,KAAK,CAAC,cAAc;gBAAE,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;YACrE,IAAI,KAAK,CAAC,YAAY;gBAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;YAG/D,IAAI,KAAK,CAAC,eAAe,EAAE,MAAM;gBAAE,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;YAChF,IAAI,KAAK,CAAC,aAAa,EAAE,MAAM;gBAAE,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YAC1E,IAAI,KAAK,CAAC,aAAa,EAAE,MAAM;gBAAE,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YAC1E,IAAI,KAAK,CAAC,iBAAiB,EAAE,MAAM;gBAAE,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC;YACtF,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC/C,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC/C,IAAI,KAAK,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAGvC,MAAM,aAAa,GAAG;gBACpB,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;aAC/B,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,eAAe,EACf,EAAE,KAAK,EAAE,IAAI,EAAE,EACf,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAC7E,CAAC;YACF,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commerce/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAmB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAClD,OAAO;QACL,KAAK,CAAC,cAAc,CAAC,KAAkB,EAAE,OAAwB;YAC/D,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3D,IAAI,KAAK,CAAC,cAAc;gBAAE,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;YACrE,IAAI,KAAK,CAAC,YAAY;gBAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;YAC/D,0EAA0E;YAC1E,2EAA2E;YAC3E,IAAI,KAAK,CAAC,eAAe,EAAE,MAAM;gBAAE,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;YAChF,IAAI,KAAK,CAAC,aAAa,EAAE,MAAM;gBAAE,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YAC1E,IAAI,KAAK,CAAC,aAAa,EAAE,MAAM;gBAAE,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YAC1E,IAAI,KAAK,CAAC,iBAAiB,EAAE,MAAM;gBAAE,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC;YACtF,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC/C,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC/C,IAAI,KAAK,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAEvC,oEAAoE;YACpE,MAAM,aAAa,GAAG;gBACpB,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;aAC/B,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,eAAe,EACf,EAAE,KAAK,EAAE,IAAI,EAAE,EACf,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAC7E,CAAC;YACF,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commerce/shipping.js

@@ -1,4 +1,4 @@
-export const DROP_OFF_POINTS = `
+export const DROP_OFF_POINTS = /* GraphQL */ `
   query MyparcelDropOffPoints($input: MyparcelDropOffPointInput!) {
     myparcelDropOffPoints(input: $input) {
       location_code
@@ -20,7 +20,7 @@ export const DROP_OFF_POINTS = `
     }
   }
 `;
-export const DELIVERY_OPTIONS = `
+export const DELIVERY_OPTIONS = /* GraphQL */ `
   query MyparcelDeliveryOptions($input: MyparcelDeliveryOptionsInput!) {
     myparcelDeliveryOptions(input: $input) {
       date
@@ -34,7 +34,7 @@ export const DELIVERY_OPTIONS = `
     }
   }
 `;
-export const TRACK_SHIPMENT = `
+export const TRACK_SHIPMENT = /* GraphQL */ `
   query MyparcelTrackShipment($barcode: String!, $postalCode: String!) {
     myparcelTrackShipment(barcode: $barcode, postalCode: $postalCode) {
       shipment_id

package/dist/commerce/shipping.js.map

@@ -1 +1 @@
-{"version":3,"file":"shipping.js","sourceRoot":"","sources":["../../src/commerce/shipping.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,eAAe,GAAiB;;;;;;;;;;;;;;;;;;;;;CAqB5C,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAiB;;;;;;;;;;;;;CAa7C,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAiB;;;;;;;;;;;;;;;;CAgB3C,CAAC;AAwCF,SAAS,eAAe,CAAC,GAAoB;IAC3C,OAAO;QACL,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,EAAE;QACnB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,UAAU,EAAE,GAAG,CAAC,YAAY;QAC5B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAsB;IAC/C,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,YAAY,EAAE,CAAC,CAAC,aAAa;YAC7B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,YAAY,EAAE,CAAC,CAAC,IAAI;SACrB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAA6B;IAChD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,kBAAkB,EAAE,GAAG,CAAC,oBAAoB;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAgB;IACpD,OAAO;QACL,KAAK,CAAC,gBAAgB,CAAC,KAAwB;YAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,eAAe,EACf,EAAE,KAAK,EAAE,CACV,CAAC;YACF,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,KAA2B;YAClD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,gBAAgB,EAChB,EAAE,KAAK,EAAE,CACV,CAAC;YACF,OAAO,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,UAAkB;YACrD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,cAAc,EACd,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;YACF,OAAO,WAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"shipping.js","sourceRoot":"","sources":["../../src/commerce/shipping.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;CAqB5C,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;;;;;;;;;;;;;CAa7C,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;CAgB3C,CAAC;AAwCF,SAAS,eAAe,CAAC,GAAoB;IAC3C,OAAO;QACL,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,EAAE;QACnB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,UAAU,EAAE,GAAG,CAAC,YAAY;QAC5B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAsB;IAC/C,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,YAAY,EAAE,CAAC,CAAC,aAAa;YAC7B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,YAAY,EAAE,CAAC,CAAC,IAAI;SACrB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAA6B;IAChD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,kBAAkB,EAAE,GAAG,CAAC,oBAAoB;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAgB;IACpD,OAAO;QACL,KAAK,CAAC,gBAAgB,CAAC,KAAwB;YAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,eAAe,EACf,EAAE,KAAK,EAAE,CACV,CAAC;YACF,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,KAA2B;YAClD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,gBAAgB,EAChB,EAAE,KAAK,EAAE,CACV,CAAC;YACF,OAAO,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,UAAkB;YACrD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,cAAc,EACd,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;YACF,OAAO,WAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commerce/stock-notifications.d.ts

@@ -1,7 +1,18 @@
 import type { HttpClient } from '../core/http.js';
 import type { StockNotificationSubscriptionResult } from '../types.js';
 export declare function createStockNotificationsMethods(http: HttpClient): {
+    /**
+     * Subscribe to a "back in stock" email for a variant. Logged-in customers
+     * may omit `emailAddress` — their account email is used. Guests must supply it.
+     *
+     * Throws `MutationError` for guest validation errors so callers can
+     * branch on `errorCode`. Returns the new subscription on success.
+     */
     subscribeToStockNotification(productVariantId: string, emailAddress?: string): Promise<StockNotificationSubscriptionResult>;
+    /**
+     * Unsubscribe from a stock notification using the token embedded in the
+     * email link. Always resolves to true (idempotent).
+     */
     unsubscribeFromStockNotification(token: string): Promise<boolean>;
 };
 //# sourceMappingURL=stock-notifications.d.ts.map

package/dist/commerce/stock-notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stock-notifications.d.ts","sourceRoot":"","sources":["../../src/commerce/stock-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,aAAa,CAAC;AA2CvE,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,UAAU;mDAUxC,MAAM,iBACT,MAAM,GACpB,OAAO,CAAC,mCAAmC,CAAC;4CAwBD,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;EAQ1E"}
+{"version":3,"file":"stock-notifications.d.ts","sourceRoot":"","sources":["../../src/commerce/stock-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,aAAa,CAAC;AA2CvE,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,UAAU;IAE5D;;;;;;OAMG;mDAEiB,MAAM,iBACT,MAAM,GACpB,OAAO,CAAC,mCAAmC,CAAC;IAoB/C;;;OAGG;4CAC2C,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;EAQ1E"}

package/dist/commerce/stock-notifications.js

@@ -26,6 +26,13 @@ const UNSUBSCRIBE_FROM_STOCK_NOTIFICATION = `
 `;
 export function createStockNotificationsMethods(http) {
     return {
+        /**
+         * Subscribe to a "back in stock" email for a variant. Logged-in customers
+         * may omit `emailAddress` — their account email is used. Guests must supply it.
+         *
+         * Throws `MutationError` for guest validation errors so callers can
+         * branch on `errorCode`. Returns the new subscription on success.
+         */
         async subscribeToStockNotification(productVariantId, emailAddress) {
             const data = await http.graphql(SUBSCRIBE_TO_STOCK_NOTIFICATION, { productVariantId, emailAddress });
             const result = data.subscribeToStockNotification;
@@ -39,6 +46,10 @@ export function createStockNotificationsMethods(http) {
             }
             throw new MutationError(result.errorCode ?? 'STOCK_NOTIFICATION_ERROR', result.message ?? 'Stock notification subscription failed');
         },
+        /**
+         * Unsubscribe from a stock notification using the token embedded in the
+         * email link. Always resolves to true (idempotent).
+         */
         async unsubscribeFromStockNotification(token) {
             const data = await http.graphql(UNSUBSCRIBE_FROM_STOCK_NOTIFICATION, { token });
             return data.unsubscribeFromStockNotification;

package/dist/commerce/stock-notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"stock-notifications.js","sourceRoot":"","sources":["../../src/commerce/stock-notifications.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;CAmBvC,CAAC;AAEF,MAAM,mCAAmC,GAAG;;;;CAI3C,CAAC;AAgBF,MAAM,UAAU,+BAA+B,CAAC,IAAgB;IAC9D,OAAO;QAQL,KAAK,CAAC,4BAA4B,CAChC,gBAAwB,EACxB,YAAqB;YAErB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,+BAA+B,EAC/B,EAAE,gBAAgB,EAAE,YAAY,EAAE,CACnC,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,CAAC,4BAA4B,CAAC;YACjD,IAAI,MAAM,CAAC,UAAU,KAAK,+BAA+B,EAAE,CAAC;gBAC1D,OAAO;oBACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE;oBACnB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,EAAE;oBAC/C,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;oBACvC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;iBAClC,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,aAAa,CACrB,MAAM,CAAC,SAAS,IAAI,0BAA0B,EAC9C,MAAM,CAAC,OAAO,IAAI,wCAAwC,CAC3D,CAAC;QACJ,CAAC;QAMD,KAAK,CAAC,gCAAgC,CAAC,KAAa;YAClD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,mCAAmC,EACnC,EAAE,KAAK,EAAE,CACV,CAAC;YACF,OAAO,IAAI,CAAC,gCAAgC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"stock-notifications.js","sourceRoot":"","sources":["../../src/commerce/stock-notifications.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;CAmBvC,CAAC;AAEF,MAAM,mCAAmC,GAAG;;;;CAI3C,CAAC;AAgBF,MAAM,UAAU,+BAA+B,CAAC,IAAgB;IAC9D,OAAO;QACL;;;;;;WAMG;QACH,KAAK,CAAC,4BAA4B,CAChC,gBAAwB,EACxB,YAAqB;YAErB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,+BAA+B,EAC/B,EAAE,gBAAgB,EAAE,YAAY,EAAE,CACnC,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,CAAC,4BAA4B,CAAC;YACjD,IAAI,MAAM,CAAC,UAAU,KAAK,+BAA+B,EAAE,CAAC;gBAC1D,OAAO;oBACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE;oBACnB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,EAAE;oBAC/C,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;oBACvC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;iBAClC,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,aAAa,CACrB,MAAM,CAAC,SAAS,IAAI,0BAA0B,EAC9C,MAAM,CAAC,OAAO,IAAI,wCAAwC,CAC3D,CAAC;QACJ,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,gCAAgC,CAAC,KAAa;YAClD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,mCAAmC,EACnC,EAAE,KAAK,EAAE,CACV,CAAC;YACF,OAAO,IAAI,CAAC,gCAAgC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commerce/vat-validation.js

@@ -1,4 +1,4 @@
-const VAT_FIELDS = `
+const VAT_FIELDS = /* GraphQL */ `
   status
   vatNumber
   countryCode
@@ -7,17 +7,17 @@ const VAT_FIELDS = `
   validatedAt
   error
 `;
-const MY_VAT_VALIDATION_STATUS = `
+const MY_VAT_VALIDATION_STATUS = /* GraphQL */ `
   query MyVatValidationStatus {
     myVatValidationStatus { ${VAT_FIELDS} }
   }
 `;
-const SET_MY_VAT_NUMBER = `
+const SET_MY_VAT_NUMBER = /* GraphQL */ `
   mutation SetMyVatNumber($vatNumber: String!) {
     setMyVatNumber(vatNumber: $vatNumber) { ${VAT_FIELDS} }
   }
 `;
-const CLEAR_MY_VAT_NUMBER = `
+const CLEAR_MY_VAT_NUMBER = /* GraphQL */ `
   mutation ClearMyVatNumber {
     clearMyVatNumber
   }

package/dist/commerce/vat-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat-validation.js","sourceRoot":"","sources":["../../src/commerce/vat-validation.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,GAAiB;;;;;;;;CAQhC,CAAC;AAEF,MAAM,wBAAwB,GAAiB;;8BAEjB,UAAU;;CAEvC,CAAC;AAEF,MAAM,iBAAiB,GAAiB;;8CAEM,UAAU;;CAEvD,CAAC;AAEF,MAAM,mBAAmB,GAAiB;;;;CAIzC,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAAgB;IACzD,OAAO;QACL,KAAK,CAAC,wBAAwB;YAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,wBAAwB,CACzB,CAAC;YACF,OAAO,IAAI,CAAC,qBAAqB,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,SAAiB;YACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA0C,iBAAiB,EAAE;gBAC1F,SAAS;aACV,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,gBAAgB;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAgC,mBAAmB,CAAC,CAAC;YACpF,OAAO,IAAI,CAAC,gBAAgB,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"vat-validation.js","sourceRoot":"","sources":["../../src/commerce/vat-validation.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,GAAG,aAAa,CAAC;;;;;;;;CAQhC,CAAC;AAEF,MAAM,wBAAwB,GAAG,aAAa,CAAC;;8BAEjB,UAAU;;CAEvC,CAAC;AAEF,MAAM,iBAAiB,GAAG,aAAa,CAAC;;8CAEM,UAAU;;CAEvD,CAAC;AAEF,MAAM,mBAAmB,GAAG,aAAa,CAAC;;;;CAIzC,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAAgB;IACzD,OAAO;QACL,KAAK,CAAC,wBAAwB;YAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,wBAAwB,CACzB,CAAC;YACF,OAAO,IAAI,CAAC,qBAAqB,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,SAAiB;YACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA0C,iBAAiB,EAAE;gBAC1F,SAAS;aACV,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,gBAAgB;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAgC,mBAAmB,CAAC,CAAC;YACpF,OAAO,IAAI,CAAC,gBAAgB,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/constants.d.ts

@@ -1,10 +1,41 @@
+/** Default Vendure Shop API base URL. Append `/shop-api` for GraphQL endpoint. */
 export declare const DEFAULT_VENDURE_URL = "https://engine.sixtyninecommerce.com";
+/** Default CMS REST API base URL. */
 export declare const DEFAULT_CMS_URL = "https://cms.sixtyninecommerce.com";
+/** Default Plugins REST API base URL. Used for routes manifest. */
 export declare const DEFAULT_PLUGINS_URL = "https://plugins.sixtyninecommerce.com";
+/** Vendure Shop API GraphQL path. */
 export declare const SHOP_API_PATH = "/shop-api";
+/** Request timeout in milliseconds for all API calls. */
 export declare const REQUEST_TIMEOUT_MS = 15000;
+/** Request timeout in milliseconds for initialization (channel resolution). */
 export declare const INIT_TIMEOUT_MS = 10000;
+/**
+ * URL path segments that storefronts own and must never collide with
+ * CMS-routed root-level content. The platform validates root content slugs
+ * against this list and rejects collisions.
+ *
+ * Add a new entry only when introducing a new platform-reserved storefront
+ * route. Sub-paths (e.g. `/blog/cart`) are not reserved — only root.
+ *
+ * Mirrored in `services/cms/src/collections/reserved-slugs.ts`; both files
+ * must be kept in sync.
+ */
 export declare const RESERVED_STOREFRONT_PATHS: readonly ["cart", "checkout", "account", "sign-in", "register", "forgot-password", "reset-password", "verify", "verify-pending", "api", "sitemaps"];
 export type ReservedStorefrontPath = (typeof RESERVED_STOREFRONT_PATHS)[number];
+/**
+ * Request header carrying the order scope — WHICH storefront a cart belongs to.
+ *
+ * A tenant can run a consumer shop and a trade (B2B/dealer) shop off ONE
+ * channel. Vendure's active-order lookup falls back to "the one active order
+ * for this customer in this channel", so separate cookies are not enough: a
+ * dealer logged into both shops otherwise shares a single cart. The engine's
+ * scoped active-order strategy reads this header on every Shop API request
+ * (including uploads) and keeps the two carts apart.
+ *
+ * Omitting the header is NOT the same as sending `CONSUMER` — the engine then
+ * behaves exactly as stock Vendure does, so a storefront that has never heard
+ * of scopes is unaffected.
+ */
 export declare const ORDER_SCOPE_HEADER = "x-order-scope";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,yCAAyC,CAAC;AAG1E,eAAO,MAAM,eAAe,sCAAsC,CAAC;AAGnE,eAAO,MAAM,mBAAmB,0CAA0C,CAAC;AAG3E,eAAO,MAAM,aAAa,cAAc,CAAC;AAGzC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAGzC,eAAO,MAAM,eAAe,QAAS,CAAC;AAatC,eAAO,MAAM,yBAAyB,qJAa5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAgBhF,eAAO,MAAM,kBAAkB,kBAAkB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,yCAAyC,CAAC;AAE1E,qCAAqC;AACrC,eAAO,MAAM,eAAe,sCAAsC,CAAC;AAEnE,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,0CAA0C,CAAC;AAE3E,qCAAqC;AACrC,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,+EAA+E;AAC/E,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,qJAa5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC"}

package/dist/constants.js

@@ -1,9 +1,26 @@
+/** Default Vendure Shop API base URL. Append `/shop-api` for GraphQL endpoint. */
 export const DEFAULT_VENDURE_URL = 'https://engine.sixtyninecommerce.com';
+/** Default CMS REST API base URL. */
 export const DEFAULT_CMS_URL = 'https://cms.sixtyninecommerce.com';
+/** Default Plugins REST API base URL. Used for routes manifest. */
 export const DEFAULT_PLUGINS_URL = 'https://plugins.sixtyninecommerce.com';
+/** Vendure Shop API GraphQL path. */
 export const SHOP_API_PATH = '/shop-api';
+/** Request timeout in milliseconds for all API calls. */
 export const REQUEST_TIMEOUT_MS = 15_000;
+/** Request timeout in milliseconds for initialization (channel resolution). */
 export const INIT_TIMEOUT_MS = 10_000;
+/**
+ * URL path segments that storefronts own and must never collide with
+ * CMS-routed root-level content. The platform validates root content slugs
+ * against this list and rejects collisions.
+ *
+ * Add a new entry only when introducing a new platform-reserved storefront
+ * route. Sub-paths (e.g. `/blog/cart`) are not reserved — only root.
+ *
+ * Mirrored in `services/cms/src/collections/reserved-slugs.ts`; both files
+ * must be kept in sync.
+ */
 export const RESERVED_STOREFRONT_PATHS = [
     'cart',
     'checkout',
@@ -15,7 +32,22 @@ export const RESERVED_STOREFRONT_PATHS = [
     'verify',
     'verify-pending',
     'api',
+    // Child-sitemap proxy path (/sitemaps/:file) — CMS content must not collide.
     'sitemaps',
 ];
+/**
+ * Request header carrying the order scope — WHICH storefront a cart belongs to.
+ *
+ * A tenant can run a consumer shop and a trade (B2B/dealer) shop off ONE
+ * channel. Vendure's active-order lookup falls back to "the one active order
+ * for this customer in this channel", so separate cookies are not enough: a
+ * dealer logged into both shops otherwise shares a single cart. The engine's
+ * scoped active-order strategy reads this header on every Shop API request
+ * (including uploads) and keeps the two carts apart.
+ *
+ * Omitting the header is NOT the same as sending `CONSUMER` — the engine then
+ * behaves exactly as stock Vendure does, so a storefront that has never heard
+ * of scopes is unaffected.
+ */
 export const ORDER_SCOPE_HEADER = 'x-order-scope';
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,mBAAmB,GAAG,sCAAsC,CAAC;AAG1E,MAAM,CAAC,MAAM,eAAe,GAAG,mCAAmC,CAAC;AAGnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,uCAAuC,CAAC;AAG3E,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAGzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAGzC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAatC,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,MAAM;IACN,UAAU;IACV,SAAS;IACT,SAAS;IACT,UAAU;IACV,iBAAiB;IACjB,gBAAgB;IAChB,QAAQ;IACR,gBAAgB;IAChB,KAAK;IAEL,UAAU;CACF,CAAC;AAkBX,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAG,sCAAsC,CAAC;AAE1E,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,mCAAmC,CAAC;AAEnE,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,uCAAuC,CAAC;AAE3E,qCAAqC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC,yDAAyD;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,MAAM;IACN,UAAU;IACV,SAAS;IACT,SAAS;IACT,UAAU;IACV,iBAAiB;IACjB,gBAAgB;IAChB,QAAQ;IACR,gBAAgB;IAChB,KAAK;IACL,6EAA6E;IAC7E,UAAU;CACF,CAAC;AAIX;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC"}

package/dist/content/asset-urls.d.ts

@@ -1,7 +1,57 @@
+/**
+ * Resolve asset references inside CMS content values.
+ *
+ * CMS field values used to be written as ABSOLUTE CDN URLs — both bare picker
+ * values and `<img src>` inside rich text. That baked the CDN origin and the
+ * channel's code into the content itself, so a channel rename or a change of
+ * CDN domain silently broke every image (1,915 such references existed in
+ * production across two tenants). Values are now stored as storage KEYS and
+ * resolved here, at render time.
+ *
+ * Both forms are handled on purpose: an absolute URL passes through the
+ * resolver unchanged, so old and new content coexist and no backfill has to
+ * land before this ships.
+ */
 import type { AssetUrlResolver } from '../media/urls.js';
+/** True when a bare string is an asset reference rather than merchant prose. */
 export declare function isAssetReference(value: string): boolean;
+/**
+ * Resolve every asset reference in one stored value.
+ *
+ * - Rich text: rewrites each `src` attribute.
+ * - A bare storage key: resolves the whole value.
+ * - Anything else (prose, numbers, JSON): returned untouched.
+ */
 export declare function resolveContentAssetUrls(value: string, resolve: AssetUrlResolver): string;
+/**
+ * Apply {@link resolveContentAssetUrls} across a field-value bag.
+ *
+ * Walks NESTED values, not just top-level strings. A `video` field is stored as
+ * `{ source, url }` and a `group` field as an object (or an array of them) with
+ * asset, multi-asset and rich-text members — the dashboard writes storage keys
+ * inside all of those, so stopping at the first level would hand the storefront
+ * a raw key and render a broken video or image.
+ *
+ * Non-string leaves (numbers, booleans, null) are returned untouched, and the
+ * walk is depth-capped: field values are merchant JSON, and a render must not
+ * be able to blow the stack.
+ */
 export declare function resolveContentFieldValues(fields: Record<string, unknown> | null | undefined, resolve: AssetUrlResolver): Record<string, unknown>;
+/**
+ * Resolve the field values flattened onto one search hit.
+ *
+ * Search results come from Meilisearch, which stores `value_json` verbatim —
+ * so a hit carries exactly the same stored form as a direct read and needs
+ * exactly the same resolution. Missing it means a storefront search bar renders
+ * raw storage keys while the pages themselves are fine, and only for items
+ * re-saved since the migration, which makes it look intermittent.
+ */
 export declare function resolveSearchHitValues<T extends Record<string, unknown>>(hit: T, resolve: AssetUrlResolver): T;
+/**
+ * Resolve the hits inside a raw search envelope (`{ data: { hits: [...] } }`).
+ *
+ * Used by the untyped `getContent` passthrough, which hands the caller whatever
+ * the endpoint returned — including, before this, unresolved storage keys.
+ */
 export declare function resolveSearchEnvelope(envelope: Record<string, unknown>, resolve: AssetUrlResolver): Record<string, unknown>;
 //# sourceMappingURL=asset-urls.d.ts.map

package/dist/content/asset-urls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-urls.d.ts","sourceRoot":"","sources":["../../src/content/asset-urls.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAmDzD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIvD;AASD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAiBxF;AAmCD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAiCD,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,gBAAgB,GACxB,CAAC,CAQH;AAQD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB"}
+{"version":3,"file":"asset-urls.d.ts","sourceRoot":"","sources":["../../src/content/asset-urls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAkDzD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAiBxF;AAsBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,gBAAgB,GACxB,CAAC,CAQH;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB"}

package/dist/content/asset-urls.js

@@ -1,6 +1,45 @@
+/**
+ * Resolve asset references inside CMS content values.
+ *
+ * CMS field values used to be written as ABSOLUTE CDN URLs — both bare picker
+ * values and `<img src>` inside rich text. That baked the CDN origin and the
+ * channel's code into the content itself, so a channel rename or a change of
+ * CDN domain silently broke every image (1,915 such references existed in
+ * production across two tenants). Values are now stored as storage KEYS and
+ * resolved here, at render time.
+ *
+ * Both forms are handled on purpose: an absolute URL passes through the
+ * resolver unchanged, so old and new content coexist and no backfill has to
+ * land before this ships.
+ */
+/**
+ * A storage key: `{channelCode}/{source|preview|content}/…`. Deliberately
+ * narrow — content values are arbitrary merchant text, and anything looser
+ * would rewrite prose that merely contains a slash.
+ *
+ * `_global` is explicit: both asset writers map the DEFAULT channel to that
+ * prefix (`storage.service.ts`, `channel-aware-asset-naming-strategy.ts`), and
+ * a leading-underscore segment fails a plain `[a-z0-9]` opener — so
+ * platform-wide assets would silently never resolve.
+ */
 const STORAGE_KEY_PATTERN = /^(_global|[a-z0-9][a-z0-9-]*)\/(source|preview|content)\//;
+/**
+ * Single-URL asset attributes inside stored rich-text HTML.
+ *
+ * BOTH quote styles: the WordPress importer preserves whatever the source
+ * markup used, so a single-quoted `src` holding a storage key would otherwise
+ * never be resolved and render as a broken image.
+ */
 const HTML_ATTR_PATTERN = /(\s(?:src|poster|href)=["'])([^"']+)(["'])/g;
+/**
+ * `srcset` holds a COMMA-SEPARATED candidate list (`url 300w, url 500w`), so it
+ * needs its own parse — a whole-attribute replace would mangle the descriptors.
+ * It cannot be skipped either: browsers PREFER a matching srcset candidate over
+ * `src`, so leaving these unresolved would keep serving the old path even after
+ * everything else moved. Production rich text carries ~200 of these.
+ */
 const HTML_SRCSET_PATTERN = /(\ssrcset=["'])([^"']+)(["'])/g;
+/** Rewrite each candidate's URL, preserving its width/density descriptor. */
 function resolveSrcset(value, resolve) {
     return value
         .split(',')
@@ -18,9 +57,17 @@ function resolveSrcset(value, resolve) {
 function looksLikeHtml(value) {
     return value.includes('<');
 }
+/** True when a bare string is an asset reference rather than merchant prose. */
 export function isAssetReference(value) {
     return (STORAGE_KEY_PATTERN.test(value) || value.startsWith('http://') || value.startsWith('https://'));
 }
+/**
+ * Resolve every asset reference in one stored value.
+ *
+ * - Rich text: rewrites each `src` attribute.
+ * - A bare storage key: resolves the whole value.
+ * - Anything else (prose, numbers, JSON): returned untouched.
+ */
 export function resolveContentAssetUrls(value, resolve) {
     if (!value)
         return value;
@@ -30,7 +77,14 @@ export function resolveContentAssetUrls(value, resolve) {
     }
     return isAssetReference(value) ? resolve(value) : value;
 }
+/**
+ * How deep to walk a stored value. Field values are merchant JSON, so a
+ * pathological or cyclic-looking shape must not turn a page render into a stack
+ * overflow. Real content nests two or three levels (`group` → repeater entry →
+ * asset).
+ */
 const MAX_VALUE_DEPTH = 8;
+/** Resolve every asset reference inside one stored value, at any depth. */
 function resolveValue(value, resolve, depth) {
     if (typeof value === 'string')
         return resolveContentAssetUrls(value, resolve);
@@ -44,7 +98,23 @@ function resolveValue(value, resolve, depth) {
     }
     return out;
 }
+/**
+ * Apply {@link resolveContentAssetUrls} across a field-value bag.
+ *
+ * Walks NESTED values, not just top-level strings. A `video` field is stored as
+ * `{ source, url }` and a `group` field as an object (or an array of them) with
+ * asset, multi-asset and rich-text members — the dashboard writes storage keys
+ * inside all of those, so stopping at the first level would hand the storefront
+ * a raw key and render a broken video or image.
+ *
+ * Non-string leaves (numbers, booleans, null) are returned untouched, and the
+ * walk is depth-capped: field values are merchant JSON, and a render must not
+ * be able to blow the stack.
+ */
 export function resolveContentFieldValues(fields, resolve) {
+    // This runs on whatever the CMS returned. A field bag that is absent or not
+    // an object is a response shape, not a crash — the SDK must hand the caller
+    // something renderable either way.
     if (!fields || typeof fields !== 'object')
         return {};
     const out = {};
@@ -53,6 +123,13 @@ export function resolveContentFieldValues(fields, resolve) {
     }
     return out;
 }
+/**
+ * Keys a search hit carries as ITEM METADATA rather than as a field value.
+ *
+ * They must be passed through untouched: `path` in particular is merchant
+ * routing like `products/content/winter`, which matches the storage-key shape
+ * exactly and would be rewritten into a CDN URL.
+ */
 const SEARCH_HIT_METADATA_KEYS = new Set([
     'id',
     'channel_id',
@@ -67,6 +144,15 @@ const SEARCH_HIT_METADATA_KEYS = new Set([
     'updated_at',
     'published_at',
 ]);
+/**
+ * Resolve the field values flattened onto one search hit.
+ *
+ * Search results come from Meilisearch, which stores `value_json` verbatim —
+ * so a hit carries exactly the same stored form as a direct read and needs
+ * exactly the same resolution. Missing it means a storefront search bar renders
+ * raw storage keys while the pages themselves are fine, and only for items
+ * re-saved since the migration, which makes it look intermittent.
+ */
 export function resolveSearchHitValues(hit, resolve) {
     const out = {};
     for (const [key, value] of Object.entries(hit)) {
@@ -76,6 +162,12 @@ export function resolveSearchHitValues(hit, resolve) {
     }
     return out;
 }
+/**
+ * Resolve the hits inside a raw search envelope (`{ data: { hits: [...] } }`).
+ *
+ * Used by the untyped `getContent` passthrough, which hands the caller whatever
+ * the endpoint returned — including, before this, unresolved storage keys.
+ */
 export function resolveSearchEnvelope(envelope, resolve) {
     const data = envelope.data;
     if (!data || typeof data !== 'object')

package/dist/content/asset-urls.js.map

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

package/dist/content/assets.d.ts

@@ -1,8 +1,23 @@
 import type { HttpClient } from '../core/http.js';
 import type { CmsAsset, RequestOptions, VendureAssetDescriptionTranslation } from '../types.js';
 export declare function createAssetMethods(http: HttpClient): {
+    /**
+     * Fetch a single CMS asset by ID. Public endpoint, scoped by channel header.
+     * Returns the public-safe asset shape with image presets and alt-text translations.
+     */
     getAsset(id: string, options?: RequestOptions): Promise<CmsAsset>;
+    /**
+     * Bulk-fetch CMS assets by ID. Used to resolve image references stored in
+     * CMS field values (the `image`/`images` field types store asset ID arrays).
+     * Public endpoint; max 50 IDs per call. Foreign or missing IDs are silently
+     * dropped — the result may have fewer entries than requested.
+     */
     lookupAssets(ids: string[], options?: RequestOptions): Promise<CmsAsset[]>;
+    /**
+     * Bulk-fetch alt-text translations for Vendure product image assets, keyed
+     * by Vendure asset ID. Vendure stores assets globally; per-channel alt-text
+     * translations live in the CMS service. Public endpoint; max 50 IDs per call.
+     */
     lookupVendureAssetDescriptions(vendureAssetIds: string[], options?: RequestOptions): Promise<Record<string, VendureAssetDescriptionTranslation[]>>;
 };
 //# sourceMappingURL=assets.d.ts.map

package/dist/content/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/content/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,kCAAkC,EAAE,MAAM,aAAa,CAAC;AAchG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU;iBAM5B,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;sBAe/C,MAAM,EAAE,YAAY,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;oDAgB7D,MAAM,EAAE,YACf,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kCAAkC,EAAE,CAAC,CAAC;EAUnE"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/content/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,kCAAkC,EAAE,MAAM,aAAa,CAAC;AAchG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU;IAE/C;;;OAGG;iBACgB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IASvE;;;;;OAKG;sBACqB,MAAM,EAAE,YAAY,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUhF;;;;OAIG;oDAEgB,MAAM,EAAE,YACf,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kCAAkC,EAAE,CAAC,CAAC;EAUnE"}

package/dist/content/assets.js

@@ -1,15 +1,30 @@
 export function createAssetMethods(http) {
     return {
+        /**
+         * Fetch a single CMS asset by ID. Public endpoint, scoped by channel header.
+         * Returns the public-safe asset shape with image presets and alt-text translations.
+         */
         async getAsset(id, options) {
             const response = await http.cmsGet(`/public-assets/${id}`, undefined, options);
             return response.data;
         },
+        /**
+         * Bulk-fetch CMS assets by ID. Used to resolve image references stored in
+         * CMS field values (the `image`/`images` field types store asset ID arrays).
+         * Public endpoint; max 50 IDs per call. Foreign or missing IDs are silently
+         * dropped — the result may have fewer entries than requested.
+         */
         async lookupAssets(ids, options) {
             if (ids.length === 0)
                 return [];
             const response = await http.cmsGet('/assets/lookup', { ids: ids.join(',') }, options);
             return response.data;
         },
+        /**
+         * Bulk-fetch alt-text translations for Vendure product image assets, keyed
+         * by Vendure asset ID. Vendure stores assets globally; per-channel alt-text
+         * translations live in the CMS service. Public endpoint; max 50 IDs per call.
+         */
         async lookupVendureAssetDescriptions(vendureAssetIds, options) {
             if (vendureAssetIds.length === 0)
                 return {};

package/dist/content/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/content/assets.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,OAAO;QAKL,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;YACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,kBAAkB,EAAE,EAAE,EACtB,SAAS,EACT,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAQD,KAAK,CAAC,YAAY,CAAC,GAAa,EAAE,OAAwB;YACxD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,EAChB,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EACtB,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAOD,KAAK,CAAC,8BAA8B,CAClC,eAAyB,EACzB,OAAwB;YAExB,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,wBAAwB,EACxB,EAAE,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAClC,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/content/assets.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,OAAO;QACL;;;WAGG;QACH,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;YACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,kBAAkB,EAAE,EAAE,EACtB,SAAS,EACT,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,YAAY,CAAC,GAAa,EAAE,OAAwB;YACxD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,EAChB,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EACtB,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,8BAA8B,CAClC,eAAyB,EACzB,OAAwB;YAExB,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,wBAAwB,EACxB,EAAE,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAClC,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/content/collection-pages.d.ts

@@ -1,6 +1,11 @@
 import type { HttpClient } from '../core/http.js';
 import type { CollectionPageValues, RequestOptions, StoreContext } from '../types.js';
 export declare function createCollectionPageMethods(http: HttpClient, ctx: StoreContext): {
+    /**
+     * Fetch the page-scoped field values for a collection's landing page.
+     * Use this to render collection index pages (e.g. `/blog`, `/shop/sale`)
+     * with their associated CMS-managed hero image, intro copy, etc.
+     */
     getCollectionPageValues(collectionId: string, languageCode?: string, options?: RequestOptions): Promise<CollectionPageValues>;
 };
 //# sourceMappingURL=collection-pages.d.ts.map

package/dist/content/collection-pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection-pages.d.ts","sourceRoot":"","sources":["../../src/content/collection-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOtF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY;0CAQ3D,MAAM,iBACL,MAAM,YACX,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;EAkBnC"}
+{"version":3,"file":"collection-pages.d.ts","sourceRoot":"","sources":["../../src/content/collection-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOtF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY;IAE3E;;;;OAIG;0CAEa,MAAM,iBACL,MAAM,YACX,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;EAkBnC"}

package/dist/content/collection-pages.js

@@ -2,11 +2,19 @@ import { createContextAssetUrlResolver } from '../media/urls.js';
 import { resolveContentFieldValues } from './asset-urls.js';
 export function createCollectionPageMethods(http, ctx) {
     return {
+        /**
+         * Fetch the page-scoped field values for a collection's landing page.
+         * Use this to render collection index pages (e.g. `/blog`, `/shop/sale`)
+         * with their associated CMS-managed hero image, intro copy, etc.
+         */
         async getCollectionPageValues(collectionId, languageCode, options) {
             const params = {};
             if (languageCode)
                 params.language_code = languageCode;
             const response = await http.cmsGet(`/collections/${collectionId}/page-values`, params, options);
+            // Values reference assets by storage key; the CDN origin (and the
+            // channel prefix, on a custom domain) belongs to render time, not to
+            // stored content. Legacy absolute URLs pass through untouched.
             const resolve = createContextAssetUrlResolver(ctx);
             return {
                 ...response.data,

package/dist/content/collection-pages.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection-pages.js","sourceRoot":"","sources":["../../src/content/collection-pages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAM5D,MAAM,UAAU,2BAA2B,CAAC,IAAgB,EAAE,GAAiB;IAC7E,OAAO;QAML,KAAK,CAAC,uBAAuB,CAC3B,YAAoB,EACpB,YAAqB,EACrB,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,YAAY,cAAc,EAC1C,MAAM,EACN,OAAO,CACR,CAAC;YAIF,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;YACnD,OAAO;gBACL,GAAG,QAAQ,CAAC,IAAI;gBAChB,MAAM,EAAE,yBAAyB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;aACjE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"collection-pages.js","sourceRoot":"","sources":["../../src/content/collection-pages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAM5D,MAAM,UAAU,2BAA2B,CAAC,IAAgB,EAAE,GAAiB;IAC7E,OAAO;QACL;;;;WAIG;QACH,KAAK,CAAC,uBAAuB,CAC3B,YAAoB,EACpB,YAAqB,EACrB,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,YAAY,cAAc,EAC1C,MAAM,EACN,OAAO,CACR,CAAC;YACF,kEAAkE;YAClE,qEAAqE;YACrE,+DAA+D;YAC/D,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;YACnD,OAAO;gBACL,GAAG,QAAQ,CAAC,IAAI;gBAChB,MAAM,EAAE,yBAAyB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;aACjE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}