@shoppexio/storefront 1.0.24 → 1.0.26

package/dist/modules/cart.d.ts

@@ -27,6 +27,24 @@ export declare function setCartItem(productId: string, variantId: string, quanti
  */
 export declare function updateCartItem(lineId: string, updates: CartItemUpdate): void;
 export declare function removeFromCart(lineId: string): void;
+/**
+ * Discards the cart entirely — and with it the proof that describes it.
+ *
+ * PAYMENT PATH. `latestQuoteToken` is evidence about a specific cart, and this
+ * is the one mutation after which that cart does not exist in any form. Held
+ * across the clear, the proof outlives its subject: a caller that clears and
+ * re-adds (Buy Now REPLACES the cart) hands `/from-cart` a token bound to the
+ * previous cart's hash, which is refused as `quote_token_stale` — a hand-off
+ * dead-ended by a proof nobody asked for. And with no re-quote in between there
+ * is nothing to replace it with, so the retry is refused identically.
+ *
+ * Only this path clears it. Every OTHER mutation turns one cart into another
+ * cart, where a proof that no longer matches is the server's to refuse: it
+ * answers `quote_token_stale`, the surfaces re-quote, and the buyer approves the
+ * new total. Dropping the proof there instead would silently remove the approved
+ * -total ceiling from a checkout that raced the re-quote, which is the failure
+ * the token exists to prevent.
+ */
 export declare function clearCart(): void;
 export declare function createCartBackup(): void;
 export declare function restoreCartFromBackup(): boolean;

package/dist/modules/cart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/modules/cart.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,WAAW,EAEX,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,cAAc,EACf,MAAM,UAAU,CAAC;AAkJlB,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,mBAAmB,IAAI,cAAc,GAAG,IAAI,CAE3D;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,MAAM,GAAE,cAAyB,GAChC,MAAM,GAAG,IAAI,CASf;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAkCD,wBAAgB,OAAO,IAAI,QAAQ,EAAE,CAGpC;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,QAAQ,EAAc,GAC3B,MAAM,CAQR;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAU,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI,CAmEN;AA4DD,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAU,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI,CAkDN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GACtB,IAAI,CAyEN;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CASnD;AAED,wBAAgB,SAAS,IAAI,IAAI,CAIhC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAqBvC;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAyB/C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,QAAQ,EAAE,CAyCrE;AAED,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,IAAI,CAiCN;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAW/C;AAED,wBAAgB,YAAY,IAAI,SAAS,CAuBxC;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAQ3D;AA+CD,8EAA8E;AAC9E,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAED,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,gDA2BjE;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAWrD"}
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/modules/cart.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,WAAW,EAEX,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,cAAc,EACf,MAAM,UAAU,CAAC;AAkJlB,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,mBAAmB,IAAI,cAAc,GAAG,IAAI,CAE3D;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,MAAM,GAAE,cAAyB,GAChC,MAAM,GAAG,IAAI,CASf;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAkCD,wBAAgB,OAAO,IAAI,QAAQ,EAAE,CAGpC;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,QAAQ,EAAc,GAC3B,MAAM,CAQR;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAU,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI,CAmEN;AA4DD,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAU,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI,CAkDN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GACtB,IAAI,CAyEN;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CASnD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAKhC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAqBvC;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAyB/C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,QAAQ,EAAE,CAyCrE;AAED,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,IAAI,CAiCN;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAW/C;AAED,wBAAgB,YAAY,IAAI,SAAS,CAuBxC;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAQ3D;AA+CD,8EAA8E;AAC9E,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAED,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,gDA2BjE;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAWrD"}

package/dist/modules/checkout.d.ts

@@ -28,16 +28,23 @@ export interface CheckoutOptions {
      *
      * PAYMENT PATH. A caller that writes the cart and reads it back before
      * checking out (Buy Now, which replaces the cart, is the sharp case) verifies
-     * a cart it read at one moment, while this function reads storage again on
-     * its way into the request — and localStorage is shared with every other tab
-     * on the domain. A write landing in that gap is billed without ever having
-     * passed the caller's verification.
+     * a cart it read at one moment, while these functions read storage again on
+     * their way into the request — and localStorage is shared with every other
+     * tab on the domain. A write landing in that gap is billed without ever
+     * having passed the caller's verification.
      *
      * The caller cannot close that itself: any check it makes is one more read
      * BEFORE this one. Pinning the expected bytes moves the comparison to the
-     * only place it can be conclusive — against the exact cart this call is about
+     * only place it can be conclusive — against the exact cart the call is about
      * to POST. A mismatch refuses before anything is created or sent.
      *
+     * Honoured identically by BOTH invoice-creating entry points, `checkout()`
+     * and `buildCheckoutUrl()` — they hit the same endpoint and create the same
+     * invoice, so a pin that held on one and not the other would be a promise
+     * the caller could not rely on. Only the refusal shape differs, following
+     * each function's own success shape: `checkout()` returns
+     * `{ success: false }`, `buildCheckoutUrl()` throws.
+     *
      * Optional and additive: omitted, nothing changes, and the server is not
      * involved either way.
      */
@@ -55,6 +62,15 @@ export interface CheckoutResult {
      * `errors.checkout.affiliate_code_not_applicable`. Branch on this rather
      * than on `message`, which is localized display copy.
      *
+     * The quote-proof family — `errors.checkout.quote_token_invalid`,
+     * `errors.checkout.quote_token_expired`, `errors.checkout.quote_token_stale`
+     * — says the proof this call submitted could not be honoured: not ours, past
+     * its window, or priced for a cart/currency/codes that have since moved. The
+     * server refuses rather than pricing without the ceiling, so the caller's
+     * response is always the same: `quoteCart()` again, show the buyer the new
+     * total, and only then retry. A retry with the same stale token is refused
+     * identically.
+     *
      * Absent for failures the server never named (transport, timeout, an empty
      * cart caught client-side).
      */
@@ -64,6 +80,18 @@ export declare function checkout(couponOrOptions?: string | CheckoutOptions, opt
 /**
  * Build checkout URL by creating invoice first.
  * Returns the checkout URL for the created invoice.
+ *
+ * PAYMENT PATH. "Build a URL" names what this returns, not a lighter way to
+ * price a cart: it POSTs the same invoice-creating endpoint as `checkout()` and
+ * bills whatever storage holds when it reads. It therefore honours
+ * `CheckoutOptions.expectedCart` on exactly the same terms — a pinned cart that
+ * moved is refused, not invoiced.
+ *
+ * A refusal throws, like every other refusal on this function: the success
+ * shape is a URL string, so there is no in-band value that a caller could
+ * mistake for one. The thrown message is the buyer-facing copy, identical to
+ * the sentence `checkout()` returns, and callers that already handle the
+ * `Cart is empty` throw handle this one unchanged.
  */
 export declare function buildCheckoutUrl(couponOrOptions?: string | CheckoutOptions, options?: CheckoutOptions): Promise<string>;
 /**

package/dist/modules/checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/modules/checkout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;IACjD;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA2TD,wBAAsB,QAAQ,CAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,EAC1C,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CA2GzB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,EAC1C,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CA6DjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAE5C"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/modules/checkout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;IACjD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiVD,wBAAsB,QAAQ,CAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,EAC1C,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CAwGzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,EAC1C,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAwEjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAE5C"}