@sixtyninecommerce/client 0.30.0 → 0.31.0

package/dist/credit/credit-status.js

@@ -1,26 +1,78 @@
-const B2B_CREDIT_STATUS_FIELDS = /* GraphQL */ `
-  customerId
-  currencyCode
-  balance
-  uninvoicedOrdersTotal
-  exposure
-  creditLimit
-  available
-  overdueInvoiceCount
-  overLimit
-  hasOverdue
-  balanceSource
-`;
-const B2B_CREDIT_STATUS = /* GraphQL */ `
-  query B2bCreditStatus {
-    b2bCreditStatus { ${B2B_CREDIT_STATUS_FIELDS} }
+import { isUnknownFieldRejection } from '../core/unknown-field-rejection.js';
+import { fragment, withFragments } from '../graphql-document.js';
+const B2B_CREDIT_STATUS_FRAGMENT = fragment(/* GraphQL */ `
+  fragment B2bCreditStatus on B2bCreditStatus {
+    customerId
+    currencyCode
+    balance
+    uninvoicedOrdersTotal
+    exposure
+    creditLimit
+    available
+    overdueInvoiceCount
+    overLimit
+    hasOverdue
+    balanceSource
+    unconvertedCurrencies
   }
-`;
+`);
+/**
+ * The same status without `unconvertedCurrencies`, for an engine released
+ * before 2026-10-01: GraphQL refuses the WHOLE document over one unknown
+ * field, so without this an SDK upgraded ahead of its engine would lose the
+ * credit status entirely.
+ */
+const B2B_CREDIT_STATUS_LEGACY_FRAGMENT = fragment(/* GraphQL */ `
+  fragment B2bCreditStatusLegacy on B2bCreditStatus {
+    customerId
+    currencyCode
+    balance
+    uninvoicedOrdersTotal
+    exposure
+    creditLimit
+    available
+    overdueInvoiceCount
+    overLimit
+    hasOverdue
+    balanceSource
+  }
+`);
+export const B2B_CREDIT_STATUS = withFragments(
+/* GraphQL */ `
+    query B2bCreditStatus {
+      b2bCreditStatus { ...B2bCreditStatus }
+    }
+`, B2B_CREDIT_STATUS_FRAGMENT);
+export const B2B_CREDIT_STATUS_LEGACY = withFragments(
+/* GraphQL */ `
+    query B2bCreditStatusLegacy {
+      b2bCreditStatus { ...B2bCreditStatusLegacy }
+    }
+`, B2B_CREDIT_STATUS_LEGACY_FRAGMENT);
 export function createCreditStatusMethods(http) {
+    /**
+     * Latched once the engine proved it predates `unconvertedCurrencies`, so the
+     * downgrade costs one rejected request per client (the quotes pattern).
+     */
+    let unconvertedUnsupported = false;
     return {
         async getCreditStatus(options) {
-            const data = await http.graphql(B2B_CREDIT_STATUS, undefined, options);
-            return data.b2bCreditStatus;
+            // Each call is typed by the document it sends (generated); the legacy
+            // answer simply has no `unconvertedCurrencies`, which the public type
+            // allows (an engine before 2026-10-01 never leaves money out).
+            if (unconvertedUnsupported) {
+                return (await http.graphql(B2B_CREDIT_STATUS_LEGACY, undefined, options)).b2bCreditStatus;
+            }
+            try {
+                return (await http.graphql(B2B_CREDIT_STATUS, undefined, options)).b2bCreditStatus;
+            }
+            catch (error) {
+                if (!isUnknownFieldRejection(error))
+                    throw error;
+                const data = await http.graphql(B2B_CREDIT_STATUS_LEGACY, undefined, options);
+                unconvertedUnsupported = true;
+                return data.b2bCreditStatus;
+            }
         },
     };
 }

package/dist/credit/credit-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"credit-status.js","sourceRoot":"","sources":["../../src/credit/credit-status.ts"],"names":[],"mappings":"AAGA,MAAM,wBAAwB,GAAG,aAAa,CAAC;;;;;;;;;;;;CAY9C,CAAC;AAEF,MAAM,iBAAiB,GAAG,aAAa,CAAC;;wBAEhB,wBAAwB;;CAE/C,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,IAAgB;IACxD,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,OAAwB;YAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,iBAAiB,EACjB,SAAS,EACT,OAAO,CACR,CAAC;YACF,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"credit-status.js","sourceRoot":"","sources":["../../src/credit/credit-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGjE,MAAM,0BAA0B,GAAG,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;CAezD,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,iCAAiC,GAAG,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;;;;;CAchE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa;AAC5C,aAAa,CAAC;;;;CAIf,EACC,0BAA0B,CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa;AACnD,aAAa,CAAC;;;;CAIf,EACC,iCAAiC,CAClC,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,IAAgB;IACxD;;;OAGG;IACH,IAAI,sBAAsB,GAAG,KAAK,CAAC;IACnC,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,OAAwB;YAC5C,sEAAsE;YACtE,sEAAsE;YACtE,+DAA+D;YAC/D,IAAI,sBAAsB,EAAE,CAAC;gBAC3B,OAAO,CACL,MAAM,IAAI,CAAC,OAAO,CAChB,wBAAwB,EACxB,SAAS,EACT,OAAO,CACR,CACF,CAAC,eAAe,CAAC;YACpB,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,CACL,MAAM,IAAI,CAAC,OAAO,CAA4B,iBAAiB,EAAE,SAAS,EAAE,OAAO,CAAC,CACrF,CAAC,eAAe,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,wBAAwB,EACxB,SAAS,EACT,OAAO,CACR,CAAC;gBACF,sBAAsB,GAAG,IAAI,CAAC;gBAC9B,OAAO,IAAI,CAAC,eAAe,CAAC;YAC9B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/credit/index.d.ts

@@ -1,6 +1,6 @@
 import type { HttpClient } from '../core/http.js';
 export declare function createCreditModule(http: HttpClient): {
-    getPaymentTerms(options?: import("../core/http.js").RequestOptions): Promise<import("../types.js").CustomerPaymentTerms | null>;
+    getPaymentTerms(options?: import("../core/http.js").RequestOptions): Promise<import("../types.js").CustomerPaymentTermsFragment | null>;
     getCreditStatus(options?: import("../core/http.js").RequestOptions): Promise<import("../types.js").B2bCreditStatus | null>;
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/credit/payment-terms.d.ts

@@ -1,7 +1,7 @@
 import type { HttpClient, RequestOptions } from '../core/http.js';
-import type { CustomerPaymentTerms } from '../types.js';
-export declare const MY_PAYMENT_TERMS = "\n  query MyPaymentTerms {\n    myPaymentTerms { \n  customerId\n  source\n  managedExternally\n  status\n  conditionCode\n  conditionDescription\n  summary\n  classification\n  paymentDays\n  paymentEndOfMonths\n  paymentMethod\n  percentage\n  discountPaymentDays\n  discountPercentage\n  paymentDiscountType\n  stale\n  syncedAt\n  error\n }\n  }\n";
+import type * as Shop from '../generated/shop.js';
+export declare const MY_PAYMENT_TERMS: string;
 export declare function createPaymentTermsMethods(http: HttpClient): {
-    getPaymentTerms(options?: RequestOptions): Promise<CustomerPaymentTerms | null>;
+    getPaymentTerms(options?: RequestOptions): Promise<Shop.CustomerPaymentTermsFragment | null>;
 };
 //# sourceMappingURL=payment-terms.d.ts.map

package/dist/credit/payment-terms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-terms.d.ts","sourceRoot":"","sources":["../../src/credit/payment-terms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAuBxD,eAAO,MAAM,gBAAgB,oWAI5B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU;8BAEtB,cAAc,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;EASxF"}
+{"version":3,"file":"payment-terms.d.ts","sourceRoot":"","sources":["../../src/credit/payment-terms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,KAAK,IAAI,MAAM,sBAAsB,CAAC;AA0BlD,eAAO,MAAM,gBAAgB,QAO5B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU;8BAG1C,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,4BAA4B,GAAG,IAAI,CAAC;EASvD"}

package/dist/credit/payment-terms.js

@@ -1,28 +1,32 @@
-const CUSTOMER_PAYMENT_TERMS_FIELDS = /* GraphQL */ `
-  customerId
-  source
-  managedExternally
-  status
-  conditionCode
-  conditionDescription
-  summary
-  classification
-  paymentDays
-  paymentEndOfMonths
-  paymentMethod
-  percentage
-  discountPaymentDays
-  discountPercentage
-  paymentDiscountType
-  stale
-  syncedAt
-  error
-`;
-export const MY_PAYMENT_TERMS = /* GraphQL */ `
-  query MyPaymentTerms {
-    myPaymentTerms { ${CUSTOMER_PAYMENT_TERMS_FIELDS} }
+import { fragment, withFragments } from '../graphql-document.js';
+const CUSTOMER_PAYMENT_TERMS_FRAGMENT = fragment(/* GraphQL */ `
+  fragment CustomerPaymentTerms on CustomerPaymentTerms {
+    customerId
+    source
+    managedExternally
+    status
+    conditionCode
+    conditionDescription
+    summary
+    classification
+    paymentDays
+    paymentEndOfMonths
+    paymentMethod
+    percentage
+    discountPaymentDays
+    discountPercentage
+    paymentDiscountType
+    stale
+    syncedAt
+    error
   }
-`;
+`);
+export const MY_PAYMENT_TERMS = withFragments(
+/* GraphQL */ `
+    query MyPaymentTerms {
+      myPaymentTerms { ...CustomerPaymentTerms }
+    }
+`, CUSTOMER_PAYMENT_TERMS_FRAGMENT);
 export function createPaymentTermsMethods(http) {
     return {
         async getPaymentTerms(options) {

package/dist/credit/payment-terms.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-terms.js","sourceRoot":"","sources":["../../src/credit/payment-terms.ts"],"names":[],"mappings":"AAGA,MAAM,6BAA6B,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;CAmBnD,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;;uBAEvB,6BAA6B;;CAEnD,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,IAAgB;IACxD,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,OAAwB;YAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,gBAAgB,EAChB,SAAS,EACT,OAAO,CACR,CAAC;YACF,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"payment-terms.js","sourceRoot":"","sources":["../../src/credit/payment-terms.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,+BAA+B,GAAG,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;CAqB9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa;AAC3C,aAAa,CAAC;;;;CAIf,EACC,+BAA+B,CAChC,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,IAAgB;IACxD,OAAO;QACL,KAAK,CAAC,eAAe,CACnB,OAAwB;YAExB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,gBAAgB,EAChB,SAAS,EACT,OAAO,CACR,CAAC;YACF,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/currency/exchange.d.ts

@@ -1,22 +1,22 @@
 import type { HttpClient } from '../core/http.js';
-import type { BulkConversionResult, ConvertedAmount, ExchangeRate } from '../types.js';
+import type * as Shop from '../generated/shop.js';
 export declare function createExchangeMethods(http: HttpClient): {
-    getExchangeRates(): Promise<ExchangeRate[]>;
+    getExchangeRates(): Promise<Shop.ExchangeRatesQuery["exchangeRates"]>;
     /**
      * Current rate for a single base→target pair. `null` when no rate is
      * stored for that currency.
      */
-    getExchangeRate(targetCurrency: string): Promise<ExchangeRate | null>;
-    convertCurrency(amount: string, fromCurrency: string, toCurrency: string): Promise<ConvertedAmount>;
+    getExchangeRate(targetCurrency: string): Promise<Shop.ExchangeRateQuery["exchangeRate"]>;
+    convertCurrency(amount: string, fromCurrency: string, toCurrency: string): Promise<Shop.ConvertedAmountFragment | null>;
     /** Convert an amount from the base currency (EUR) to a target currency. */
-    convertFromBase(amount: string, targetCurrency: string): Promise<ConvertedAmount>;
+    convertFromBase(amount: string, targetCurrency: string): Promise<Shop.ConvertedAmountFragment | null>;
     /** Convert an amount from a source currency to the base currency (EUR). */
-    convertToBase(amount: string, sourceCurrency: string): Promise<ConvertedAmount>;
+    convertToBase(amount: string, sourceCurrency: string): Promise<Shop.ConvertedAmountFragment | null>;
     /**
      * Convert one amount into several currencies in a single roundtrip —
      * e.g. a currency-switcher dropdown showing the price in every
      * available currency.
      */
-    convertToMultiple(amount: string, fromCurrency: string, toCurrencies: string[]): Promise<BulkConversionResult[]>;
+    convertToMultiple(amount: string, fromCurrency: string, toCurrencies: string[]): Promise<Shop.ConvertToMultipleQuery["convertToMultiple"]>;
 };
 //# sourceMappingURL=exchange.d.ts.map

package/dist/currency/exchange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exchange.d.ts","sourceRoot":"","sources":["../../src/currency/exchange.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU;wBAExB,OAAO,CAAC,YAAY,EAAE,CAAC;IAKjD;;;OAGG;oCACmC,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;4BAQjE,MAAM,gBACA,MAAM,cACR,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC;IAS3B,2EAA2E;4BAC7C,MAAM,kBAAkB,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQvF,2EAA2E;0BAC/C,MAAM,kBAAkB,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQrF;;;;OAIG;8BAEO,MAAM,gBACA,MAAM,gBACN,MAAM,EAAE,GACrB,OAAO,CAAC,oBAAoB,EAAE,CAAC;EAQrC"}
+{"version":3,"file":"exchange.d.ts","sourceRoot":"","sources":["../../src/currency/exchange.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,KAAK,IAAI,MAAM,sBAAsB,CAAC;AAElD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU;wBAExB,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAK3E;;;OAGG;oCACmC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;4BAQpF,MAAM,gBACA,MAAM,cACR,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAS/C,2EAA2E;4BAEjE,MAAM,kBACE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAQ/C,2EAA2E;0BAEjE,MAAM,kBACE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAQ/C;;;;OAIG;8BAEO,MAAM,gBACA,MAAM,gBACN,MAAM,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;EAS/D"}

package/dist/currency/exchange.js

@@ -45,7 +45,11 @@ export function createExchangeMethods(http) {
          * available currency.
          */
         async convertToMultiple(amount, fromCurrency, toCurrencies) {
-            const data = await http.graphql(CONVERT_TO_MULTIPLE, { amount, from: fromCurrency, to: toCurrencies });
+            const data = await http.graphql(CONVERT_TO_MULTIPLE, {
+                amount,
+                from: fromCurrency,
+                to: toCurrencies,
+            });
             return data.convertToMultiple;
         },
     };

package/dist/currency/exchange.js.map

@@ -1 +1 @@
-{"version":3,"file":"exchange.js","sourceRoot":"","sources":["../../src/currency/exchange.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,UAAU,qBAAqB,CAAC,IAAgB;IACpD,OAAO;QACL,KAAK,CAAC,gBAAgB;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAoC,kBAAkB,CAAC,CAAC;YACvF,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,eAAe,CAAC,cAAsB;YAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAwC,iBAAiB,EAAE;gBACxF,cAAc;aACf,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,YAAoB,EACpB,UAAkB;YAElB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAuC,gBAAgB,EAAE;gBACtF,MAAM;gBACN,IAAI,EAAE,YAAY;gBAClB,EAAE,EAAE,UAAU;aACf,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;QAED,2EAA2E;QAC3E,KAAK,CAAC,eAAe,CAAC,MAAc,EAAE,cAAsB;YAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAuC,iBAAiB,EAAE;gBACvF,MAAM;gBACN,cAAc;aACf,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;QAED,2EAA2E;QAC3E,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,cAAsB;YACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAqC,eAAe,EAAE;gBACnF,MAAM;gBACN,cAAc;aACf,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,iBAAiB,CACrB,MAAc,EACd,YAAoB,EACpB,YAAsB;YAEtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,mBAAmB,EACnB,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,CACjD,CAAC;YACF,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"exchange.js","sourceRoot":"","sources":["../../src/currency/exchange.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,UAAU,qBAAqB,CAAC,IAAgB;IACpD,OAAO;QACL,KAAK,CAAC,gBAAgB;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA0B,kBAAkB,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,eAAe,CAAC,cAAsB;YAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAyB,iBAAiB,EAAE;gBACzE,cAAc;aACf,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,YAAoB,EACpB,UAAkB;YAElB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA4B,gBAAgB,EAAE;gBAC3E,MAAM;gBACN,IAAI,EAAE,YAAY;gBAClB,EAAE,EAAE,UAAU;aACf,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;QAED,2EAA2E;QAC3E,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,cAAsB;YAEtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA4B,iBAAiB,EAAE;gBAC5E,MAAM;gBACN,cAAc;aACf,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;QAED,2EAA2E;QAC3E,KAAK,CAAC,aAAa,CACjB,MAAc,EACd,cAAsB;YAEtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA0B,eAAe,EAAE;gBACxE,MAAM;gBACN,cAAc;aACf,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,iBAAiB,CACrB,MAAc,EACd,YAAoB,EACpB,YAAsB;YAEtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA8B,mBAAmB,EAAE;gBAChF,MAAM;gBACN,IAAI,EAAE,YAAY;gBAClB,EAAE,EAAE,YAAY;aACjB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -40,10 +40,27 @@ export interface StorefrontErrorContext {
      * value or a 503 would report itself as terminal.
      */
     retryable?: boolean;
+    /**
+     * The platform could not say whether the operation took effect — see
+     * `PlatformError.outcomeUnknown`. A converted error must pass the original's
+     * value, or an unknown write would read as one the platform vouches for.
+     */
+    outcomeUnknown?: boolean;
     cause?: unknown;
 }
 export declare class StorefrontError extends PlatformError {
     #private;
+    /**
+     * The idempotency key the failed call went out under, when it had one —
+     * `commerce.addPayment`, `payDeposit` and `createDepositPaymentIntent` always
+     * have one, their own if you passed none.
+     *
+     * When the answer never came (`outcomeUnknown`), repeat the call with
+     * `{ idempotencyKey: error.idempotencyKey }`: an engine that honours the key
+     * answers with the first attempt's payment instead of taking a second one.
+     * Use a NEW key only for a new attempt after a definite refusal.
+     */
+    idempotencyKey?: string;
     constructor(message: string, service: ServiceName, statusCode?: number, errorCode?: string, 
     /** Field-level details parsed from a structured error response. */
     details?: ErrorDetail[], 

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,aAAa;;gBAK9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,WAAW,EAAE;IACvB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,sBAAsB;IAuBlC,qEAAqE;IACrE,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;;;;OAKG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;CACF;AAED,gFAAgF;AAChF,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,sBAAsB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,qBAAa,aAAc,SAAQ,eAAe;;aAsD9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IArDlD;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAiB,IAAI,EAAE,sBAAsB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAExC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;gBAKxC,SAAS,EAAE,MAAM;IACjB;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EAChD,UAAU,CAAC,EAAE,0BAA0B;IAsBzC,8EAA8E;IAC9E,IAAa,SAAS,IAAI,MAAM,CAE/B;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,eAAe,CAyBvF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AAGzD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,aAAa;;IAIhD;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;gBAGtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,WAAW,EAAE;IACvB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,sBAAsB;IAwBlC,qEAAqE;IACrE,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;;;;OAKG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;CACF;AAGD,gFAAgF;AAChF,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,sBAAsB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,qBAAa,aAAc,SAAQ,eAAe;;aAsD9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IArDlD;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAiB,IAAI,EAAE,sBAAsB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAExC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;gBAKxC,SAAS,EAAE,MAAM;IACjB;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EAChD,UAAU,CAAC,EAAE,0BAA0B;IAsBzC,8EAA8E;IAC9E,IAAa,SAAS,IAAI,MAAM,CAE/B;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,eAAe,CA0BvF"}

package/dist/errors.js

@@ -18,6 +18,17 @@ export const STOREFRONT_ERROR_CODE = 'STOREFRONT_ERROR';
 export class StorefrontError extends PlatformError {
     #statusCode;
     #errorCode;
+    /**
+     * The idempotency key the failed call went out under, when it had one —
+     * `commerce.addPayment`, `payDeposit` and `createDepositPaymentIntent` always
+     * have one, their own if you passed none.
+     *
+     * When the answer never came (`outcomeUnknown`), repeat the call with
+     * `{ idempotencyKey: error.idempotencyKey }`: an engine that honours the key
+     * answers with the first attempt's payment instead of taking a second one.
+     * Use a NEW key only for a new attempt after a definite refusal.
+     */
+    idempotencyKey;
     constructor(message, service, statusCode, errorCode, 
     /** Field-level details parsed from a structured error response. */
     details, 
@@ -37,6 +48,7 @@ export class StorefrontError extends PlatformError {
             traceId: context?.traceId,
             problem: context?.problem,
             retryable: context?.retryable,
+            outcomeUnknown: context?.outcomeUnknown,
             cause: context?.cause,
         });
         this.name = 'StorefrontError';
@@ -132,6 +144,7 @@ export function toStorefrontError(error, service) {
             traceId: error.traceId,
             problem: error.problem,
             retryable: error.retryable,
+            outcomeUnknown: error.outcomeUnknown,
             cause: error,
         });
     }

package/dist/errors.js.map

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

package/dist/events/index.d.ts

@@ -2,19 +2,32 @@
  * Platform events: the envelope you receive, how to verify a webhook, and the
  * revalidation a storefront-facing event calls for.
  *
- * Two surfaces deliver the same envelope. A **webhook** POST is signed — verify
- * `X-Webhook-Signature` against the RAW request body, before parsing, with the secret shown
- * once when the subscription was created (`verifyEventDelivery` does that and checks the
- * `delivered_at` replay window). The **pull feed** (`GET /events` on the plugins
+ * Two surfaces deliver the same envelope. A **webhook** POST is signed twice — Standard
+ * Webhooks (`webhook-id`/`webhook-timestamp`/`webhook-signature`) and the legacy
+ * `X-Webhook-Signature` — over the RAW request body, with the secret shown once when the
+ * subscription was created. `verifyEventDelivery` (from `@sixtyninecommerce/core`) checks
+ * whichever set arrived, preferring the standard one, and its replay window. The **pull feed** (`GET /events` on the plugins
  * API, with an API token holding `ReadPlatformEvents`) carries no signature and no
  * `delivered_at`: the authenticated request is the freshness proof, and a feed serving 90
  * days of history would put every row outside any replay window you could sensibly set.
  * `planRevalidation` works on envelopes from either surface.
+ *
+ * **Receiving events of your own.** `createEventHandler` (from
+ * `@sixtyninecommerce/core`) is a webhook endpoint as one framework-neutral
+ * `(request: Request) => Promise<Response>`: it verifies the delivery and hands
+ * each event to the handler you registered for its type, with `data` typed by
+ * that type's payload contract — every contract is exported here. There is no
+ * `poll` or `stream` on this entry point: the pull feed and the live stream need
+ * an API token holding `ReadPlatformEvents`, a back-office credential a
+ * storefront must not hold. A server-side job that has one uses
+ * `@sixtyninecommerce/admin` (`admin.events.poll()` / `admin.events.stream()`).
  */
-export { collectionCacheTag, productCacheTag, SEO_ARTIFACT_TAG } from '../cache-tags.js';
-export type { RevalidationDegradedReason, RevalidationPlan, RevalidationPlanOptions, RevalidationSkipReason, } from '../revalidation/event-plan.js';
+export type { EventHandlerOptions, EventHandlers, TypedEnvelope, } from '@sixtyninecommerce/core';
+export { createEventHandler, isEventType } from '@sixtyninecommerce/core';
+export { CATALOG_TAG, collectionCacheTag, menuCacheTag, productCacheTag, SEO_ARTIFACT_TAG, } from '../cache-tags.js';
+export type { RevalidationDegradedReason, RevalidationHandledEventTypeV1, RevalidationPlan, RevalidationPlanOptions, RevalidationSkipReason, } from '../revalidation/event-plan.js';
 export { EventPayloadError, planRevalidation } from '../revalidation/event-plan.js';
-export type { EventDeliveryVerification, VerifyEventDeliveryOptions, } from '../revalidation/event-verify.js';
+export type { EventDeliveryHeaders, EventDeliveryVerification, VerifyEventDeliveryOptions, } from '../revalidation/event-verify.js';
 export { verifyEventDelivery } from '../revalidation/event-verify.js';
 export type { ChannelUrlRuleSet, UrlContext, UrlContextSource, } from '../revalidation/url-context.js';
 export { urlContextFromChannelSettings, urlContextFromClient, } from '../revalidation/url-context.js';

package/dist/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzF,YAAY,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACpF,YAAY,EACV,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,mBAAmB,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,EAC9B,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACpF,YAAY,EACV,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,mBAAmB,eAAe,CAAC"}

package/dist/events/index.js

@@ -2,16 +2,28 @@
  * Platform events: the envelope you receive, how to verify a webhook, and the
  * revalidation a storefront-facing event calls for.
  *
- * Two surfaces deliver the same envelope. A **webhook** POST is signed — verify
- * `X-Webhook-Signature` against the RAW request body, before parsing, with the secret shown
- * once when the subscription was created (`verifyEventDelivery` does that and checks the
- * `delivered_at` replay window). The **pull feed** (`GET /events` on the plugins
+ * Two surfaces deliver the same envelope. A **webhook** POST is signed twice — Standard
+ * Webhooks (`webhook-id`/`webhook-timestamp`/`webhook-signature`) and the legacy
+ * `X-Webhook-Signature` — over the RAW request body, with the secret shown once when the
+ * subscription was created. `verifyEventDelivery` (from `@sixtyninecommerce/core`) checks
+ * whichever set arrived, preferring the standard one, and its replay window. The **pull feed** (`GET /events` on the plugins
  * API, with an API token holding `ReadPlatformEvents`) carries no signature and no
  * `delivered_at`: the authenticated request is the freshness proof, and a feed serving 90
  * days of history would put every row outside any replay window you could sensibly set.
  * `planRevalidation` works on envelopes from either surface.
+ *
+ * **Receiving events of your own.** `createEventHandler` (from
+ * `@sixtyninecommerce/core`) is a webhook endpoint as one framework-neutral
+ * `(request: Request) => Promise<Response>`: it verifies the delivery and hands
+ * each event to the handler you registered for its type, with `data` typed by
+ * that type's payload contract — every contract is exported here. There is no
+ * `poll` or `stream` on this entry point: the pull feed and the live stream need
+ * an API token holding `ReadPlatformEvents`, a back-office credential a
+ * storefront must not hold. A server-side job that has one uses
+ * `@sixtyninecommerce/admin` (`admin.events.poll()` / `admin.events.stream()`).
  */
-export { collectionCacheTag, productCacheTag, SEO_ARTIFACT_TAG } from '../cache-tags.js';
+export { createEventHandler, isEventType } from '@sixtyninecommerce/core';
+export { CATALOG_TAG, collectionCacheTag, menuCacheTag, productCacheTag, SEO_ARTIFACT_TAG, } from '../cache-tags.js';
 export { EventPayloadError, planRevalidation } from '../revalidation/event-plan.js';
 export { verifyEventDelivery } from '../revalidation/event-verify.js';
 export { urlContextFromChannelSettings, urlContextFromClient, } from '../revalidation/url-context.js';

package/dist/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAOzF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAMtE,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAMtE,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/events/payloads.d.ts

@@ -1,12 +1,15 @@
 /**
- * Revalidation payload contracts, re-exported from `@sixtyninecommerce/core`.
+ * Every platform event payload contract, re-exported from `@sixtyninecommerce/core`.
  *
  * The byte-identical copy of `packages/shared/src/events/shims/` lives in
- * `core` now — one published home for the wire contracts, so the admin SDK and
+ * `core` — one published home for the wire contracts, so the admin SDK and
  * this one cannot disagree about an envelope. The names are listed rather than
  * star-exported on purpose: a contract removed from `core` fails the build
  * HERE, at the entry point consumers import, instead of vanishing from
- * `@sixtyninecommerce/client/events` unnoticed.
+ * `@sixtyninecommerce/client/events` unnoticed. The list is EVERY type core's
+ * `event-payloads.ts` declares (plus the two revalidation-subset names), and
+ * `__tests__/event-payload-exports.spec.ts` fails when core gains one that is
+ * not listed here.
  */
-export type { CatalogueChangeClass, ChannelPathPrefixV1, ChannelUrlSettingClass, ChannelUrlSettingsChangedV1, CollectionAffectedScopeV1, CollectionChangeClass, CollectionCreatedV1, CollectionDeletedV1, CollectionEntityChangeBaseV1, CollectionMembershipChangedV1, CollectionStateV1, CollectionUpdatedV1, ContentChangeClass, ContentCollectionBaseV1, ContentCollectionChangeClass, ContentCollectionCreatedV1, ContentCollectionRemovedV1, ContentCollectionUpdatedV1, ContentItemBaseV1, ContentItemStatusV1, ContentPathV1, ContentPublishedV1, ContentUnpublishedV1, ContentUpdatedV1, ProductChangeBaseV1, ProductCreatedV1, ProductDeletedV1, ProductUpdatedV1, ProductVariantPriceChangedV1, RevalidationEventTypeV1, RevalidationPayloadByTypeV1, SeoPathChangeV1, SeoPathDiffTriggerV1, SeoPathEntityTypeV1, SeoPathsChangedV1, SiteContentChangedV1, SiteContentKindV1, SiteContentResourceScopeV1, UrlLocaleStrategyV1, } from '@sixtyninecommerce/core';
+export type { AccessPayloadByTypeV1, ApiTokenChangedV1, ApiTokenChangeV1, ApiTokenKindV1, AppConsentRequiredV1, AppFieldGroupV1, AppFieldOwnerKindV1, AppFieldOwnershipCauseV1, AppFieldOwnershipChangedV1, AppFieldOwnershipChangeV1, AppHookFailureReasonV1, AppHookHealthChangedV1, AppHookHealthStateV1, AppHookKindV1, AppInstallationEventBaseV1, AppInstalledV1, AppPayloadByTypeV1, AppProviderAssignmentCauseV1, AppProviderAssignmentChangedV1, AppProviderAssignmentChangeV1, AppProviderKindV1, AppUninstalledV1, ArReceiptRefV1, ArSettledInvoiceV1, AssetChangedV1, AssetChangeV1, AssetPayloadByTypeV1, CatalogueChangeClass, CataloguePayloadByTypeV1, ChannelLifecycleChangedV1, ChannelLifecycleReasonCodeV1, ChannelLifecycleStateV1, ChannelLifecycleTransitionV1, ChannelPathPrefixV1, ChannelPayloadByTypeV1, ChannelRenamedV1, ChannelUrlSettingClass, ChannelUrlSettingsChangedV1, CollectionAffectedScopeV1, CollectionChangeClass, CollectionCreatedV1, CollectionDeletedV1, CollectionEntityChangeBaseV1, CollectionMembershipChangedV1, CollectionPayloadByTypeV1, CollectionStateV1, CollectionUpdatedV1, CommerceExtensionPayloadByTypeV1, ContentChangeClass, ContentCollectionBaseV1, ContentCollectionChangeClass, ContentCollectionCreatedV1, ContentCollectionPayloadByTypeV1, ContentCollectionRemovedV1, ContentCollectionUpdatedV1, ContentItemBaseV1, ContentItemStatusV1, ContentPathV1, ContentPayloadByTypeV1, ContentPublishedV1, ContentUnpublishedV1, ContentUpdatedV1, CreditNoteCustomerRefV1, CreditNoteIssuedV1, CreditNoteKindV1, CreditNoteLedgerV1, CreditNotePayloadByTypeV1, CreditNoteTaxRowV1, CustomerAgentSessionStartedV1, CustomerCreatedV1, CustomerDataRequestedV1, CustomerDeletedV1, CustomerGroupChangedV1, CustomerIdentityRefV1, CustomerPayloadByTypeV1, CustomerRedactRequestedV1, CustomerUpdatedV1, FacetChangeBaseV1, FacetChangeClass, FacetCreatedV1, FacetDeletedV1, FacetPayloadByTypeV1, FacetUpdatedV1, FacetValueChangeBaseV1, FacetValueCreatedV1, FacetValueDeletedV1, FacetValueUpdatedV1, FormChangedV1, FormChangeV1, FormPayloadByTypeV1, FormSubmissionFileV1, FormSubmissionValueV1, FormSubmittedV1, FulfillmentBaseV1, FulfillmentCancelledV1, FulfillmentCreatedV1, FulfillmentDeliveredV1, FulfillmentLineV1, FulfillmentPayloadByTypeV1, FulfillmentShippedV1, FulfillmentTrackingV1, HeadChangedV1, HeadChangeV1, HeadKindV1, HeadPayloadByTypeV1, InstallationPayloadByTypeV1, InstallationRedactRequestedV1, InvoiceCustomerRefV1, InvoiceGeneratedV1, InvoiceKindV1, InvoicePayloadByTypeV1, InvoiceTaxRowV1, LocationChangedV1, LocationChangeV1, LocationPayloadByTypeV1, MenuChangedV1, MenuChangeV1, MenuPayloadByTypeV1, NotificationConfigChangedV1, NotificationConfigPayloadByTypeV1, NotificationSenderV1, OrderBaseV1, OrderCancelledV1, OrderCompletedV1, OrderCreatedV1, OrderCustomerRefV1, OrderLineV1, OrderParkedV1, OrderPayloadByTypeV1, OrderReopenedV1, OrderSettlementCompletedV1, OrderSettlementPaymentV1, OrderStatusChangedV1, OrderStatusTupleV1, OrderUnparkedV1, OrderUpdatedChangeV1, OrderUpdatedV1, OrganizationMemberJoinedV1, OrganizationPayloadByTypeV1, OrganizationRecordDetachedV1, PaymentAuthorizedV1, PaymentBaseV1, PaymentCancelledV1, PaymentFailedV1, PaymentPartialRecordedV1, PaymentPayloadByTypeV1, PaymentReceivableReversedV1, PaymentReceivableSettledV1, PaymentRefundedV1, PaymentRefundFailedV1, PaymentSettledV1, PipelinePayloadByTypeV1, PipelineRunCompletedV1, PipelineRunCountersV1, PipelineRunKindV1, PipelineRunStatusV1, PlatformEventPayloadByTypeV1, PlatformEventTypeV1, PriceListChangedV1, PriceListChangeV1, PricingPayloadByTypeV1, ProductChangeBaseV1, ProductChannelAssignedV1, ProductChannelChangeV1, ProductChannelRemovedV1, ProductCreatedV1, ProductDeletedV1, ProductUpdatedV1, ProductVariantChangeBaseV1, ProductVariantCreatedV1, ProductVariantDeletedV1, ProductVariantPriceChangedV1, ProductVariantUpdatedV1, PromotionChangedV1, PromotionChangeV1, ProviderConnectionChangedV1, ProviderConnectionChangeV1, ProviderConnectionPayloadByTypeV1, QuoteStatusChangedV1, QuoteStatusV1, RefundBaseV1, ReturnActorV1, ReturnApprovedV1, ReturnBaseV1, ReturnCancelledV1, ReturnInitiatorV1, ReturnLineV1, ReturnPayloadByTypeV1, ReturnReceiptLineV1, ReturnReceivedV1, ReturnRejectedV1, ReturnRequestedV1, ReturnSettledV1, ReturnSettlementMethodV1, ReturnStateV1, RevalidationEventTypeV1, RevalidationPayloadByTypeV1, RoleChangedV1, RoleChangeV1, SeoPathChangeV1, SeoPathDiffTriggerV1, SeoPathEntityTypeV1, SeoPathsChangedV1, SeoPayloadByTypeV1, SiteContentChangedV1, SiteContentKindV1, SiteContentPayloadByTypeV1, SiteContentResourceScopeV1, StockAdjustedV1, StockChangeCause, StockChangeSource, StockLevelChangedV1, StockLocationLevelV1, StockPayloadByTypeV1, StockTransferBaseV1, StockTransferCancelledV1, StockTransferCompletionV1, StockTransferCreatedV1, StockTransferKindV1, StockTransferLineV1, StockTransferPayloadByTypeV1, StockTransferReceivedV1, StockTransferShipmentRemovedV1, StockTransferShippedV1, StockTransferStateV1, StockTransferVariantQuantityV1, StoredValueAccountCreatedV1, StoredValueAccountKindV1, StoredValueAccountStatusChangedV1, StoredValueAccountStatusV1, StoredValueEntryPostedV1, StoredValueEntryTypeV1, SubscriptionStatusChangedV1, SubscriptionStatusReasonCodeV1, SubscriptionStatusV1, TaxClassChangedV1, TaxClassChangeV1, TaxClassPayloadByTypeV1, TerminalChangedV1, TerminalChangeV1, UrlLocaleStrategyV1, } from '@sixtyninecommerce/core';
 //# sourceMappingURL=payloads.d.ts.map

package/dist/events/payloads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payloads.d.ts","sourceRoot":"","sources":["../../src/events/payloads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,EAC5B,6BAA6B,EAC7B,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"payloads.d.ts","sourceRoot":"","sources":["../../src/events/payloads.ts"],"names":[],"mappings":"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"}

package/dist/events/payloads.js

@@ -1,12 +1,15 @@
 /**
- * Revalidation payload contracts, re-exported from `@sixtyninecommerce/core`.
+ * Every platform event payload contract, re-exported from `@sixtyninecommerce/core`.
  *
  * The byte-identical copy of `packages/shared/src/events/shims/` lives in
- * `core` now — one published home for the wire contracts, so the admin SDK and
+ * `core` — one published home for the wire contracts, so the admin SDK and
  * this one cannot disagree about an envelope. The names are listed rather than
  * star-exported on purpose: a contract removed from `core` fails the build
  * HERE, at the entry point consumers import, instead of vanishing from
- * `@sixtyninecommerce/client/events` unnoticed.
+ * `@sixtyninecommerce/client/events` unnoticed. The list is EVERY type core's
+ * `event-payloads.ts` declares (plus the two revalidation-subset names), and
+ * `__tests__/event-payload-exports.spec.ts` fails when core gains one that is
+ * not listed here.
  */
 export {};
 //# sourceMappingURL=payloads.js.map

package/dist/events/payloads.js.map

@@ -1 +1 @@
-{"version":3,"file":"payloads.js","sourceRoot":"","sources":["../../src/events/payloads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
+{"version":3,"file":"payloads.js","sourceRoot":"","sources":["../../src/events/payloads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/feeds/index.d.ts

@@ -0,0 +1,5 @@
+import type { StoreContext } from '../types.js';
+import type { FeedsModule } from './types.js';
+export declare function createFeedsModule(ctx: StoreContext): FeedsModule;
+export type { FeedsModule } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/feeds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feeds/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CAUhE;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/feeds/index.js

@@ -0,0 +1,12 @@
+export function createFeedsModule(ctx) {
+    return {
+        feedUrl(token) {
+            const trimmed = token.trim();
+            if (!trimmed) {
+                throw new Error('feedUrl requires a feed token');
+            }
+            return `${ctx.pluginsUrl}/feeds/${encodeURIComponent(ctx.channel.code)}/${encodeURIComponent(trimmed)}.xml`;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/feeds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feeds/index.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,OAAO;QACL,OAAO,CAAC,KAAa;YACnB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,GAAG,GAAG,CAAC,UAAU,UAAU,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9G,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/feeds/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Product feeds — the platform renders one RSS 2.0 file per configured feed
+ * (Google Shopping, Meta, Pinterest, TikTok) and serves it at a token-guarded
+ * public URL. The token is the feed's shared secret: it is the only thing that
+ * identifies a feed, so treat the URL as unlisted.
+ */
+export interface FeedsModule {
+    /**
+     * Platform URL of one product feed, e.g.
+     * `https://plugins.example.com/feeds/megamart/9f3c….xml`.
+     *
+     * Copy the token from Dashboard → Marketing → Product feeds. Hand this URL to
+     * a merchant centre directly, or proxy it on the storefront's own origin with
+     * `createProductFeedHandler` from `@sixtyninecommerce/client/next`.
+     */
+    feedUrl(token: string): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/feeds/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/feeds/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,MAAM,WAAW,WAAW;IAC1B;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC"}

package/dist/feeds/types.js

@@ -0,0 +1,8 @@
+/**
+ * Product feeds — the platform renders one RSS 2.0 file per configured feed
+ * (Google Shopping, Meta, Pinterest, TikTok) and serves it at a token-guarded
+ * public URL. The token is the feed's shared secret: it is the only thing that
+ * identifies a feed, so treat the URL as unlisted.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/feeds/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/feeds/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}