@doswiftly/storefront-sdk 20.2.0 → 21.0.1

package/dist/core/auth/handlers.d.ts

@@ -182,18 +182,19 @@ interface WhoamiHandlerOptions {
     isTrustedOrigin?: OriginValidator | null;
 }
 /**
- * Create a GET handler that hydrates customer state z httpOnly cookie.
+ * Create a GET handler that hydrates customer state from the httpOnly cookie.
  *
- * Browser-based storefront po hydration mountuje React app z czystym auth store
- * (XSS fix — `accessToken` nie persistuje w localStorage). Aby pokazać "logged in"
- * UI bez round-trip do login, klient wywołuje GET `/api/auth/whoami`:
+ * A browser-based storefront mounts the React app after hydration with a clean
+ * auth store (XSS hardening — `accessToken` is never persisted to localStorage).
+ * To show the "logged in" UI without a login round-trip, the client calls GET
+ * `/api/auth/whoami`:
  *
- * 1. Endpoint reads httpOnly cookie `customerAccessToken` (server-side, JS-inaccessible)
- * 2. Forward jako `Authorization: Bearer` header do backend GraphQL `customer` query
- * 3. Return `{ isAuthenticated, customer | null }` do klienta
- * 4. Klient setAuth(customer, '') — token NIE w body (cookie kontynuuje per-request auth)
+ * 1. The endpoint reads the httpOnly cookie `customerAccessToken` (server-side, JS-inaccessible)
+ * 2. Forwards it as an `Authorization: Bearer` header to the backend GraphQL `customer` query
+ * 3. Returns `{ isAuthenticated, customer | null }` to the client
+ * 4. The client calls setAuth(customer, '') — the token is NOT in the body (the cookie keeps handling per-request auth)
  *
- * Security: origin validation, fetch via Bearer (cookie nie crossuje API boundary).
+ * Security: origin validation, fetch via Bearer (the cookie never crosses the API boundary).
  * Pass `isTrustedOrigin` when running behind a reverse proxy — see
  * {@link trustedForwardedHostValidator}.
  *

package/dist/core/auth/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/core/auth/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,sBAAsB,KACxB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,UAAU,sBAAsB;IAC9B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED,UAAU,wBAAwB;IAChC,sEAAsE;IACtE,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GACA,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IACR,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C,GACA,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA2D1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,6BAA6B,EAAE,eAa3C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EAAE,GACvB,eAAe,CAajB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,sBAAsB,GACjC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAiEzC;AAED,UAAU,oBAAoB;IAC5B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAwEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,CAAC,EAAE,wBAAwB,GACjC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAoCzC"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/core/auth/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,sBAAsB,KACxB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,UAAU,sBAAsB;IAC9B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED,UAAU,wBAAwB;IAChC,sEAAsE;IACtE,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GACA,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IACR,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C,GACA,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA2D1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,6BAA6B,EAAE,eAa3C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EAAE,GACvB,eAAe,CAajB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,sBAAsB,GACjC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAiEzC;AAED,UAAU,oBAAoB;IAC5B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAwEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,CAAC,EAAE,wBAAwB,GACjC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAoCzC"}

package/dist/core/auth/handlers.js

@@ -265,18 +265,19 @@ export function createSetTokenHandler(overrides) {
     };
 }
 /**
- * Create a GET handler that hydrates customer state z httpOnly cookie.
+ * Create a GET handler that hydrates customer state from the httpOnly cookie.
  *
- * Browser-based storefront po hydration mountuje React app z czystym auth store
- * (XSS fix — `accessToken` nie persistuje w localStorage). Aby pokazać "logged in"
- * UI bez round-trip do login, klient wywołuje GET `/api/auth/whoami`:
+ * A browser-based storefront mounts the React app after hydration with a clean
+ * auth store (XSS hardening — `accessToken` is never persisted to localStorage).
+ * To show the "logged in" UI without a login round-trip, the client calls GET
+ * `/api/auth/whoami`:
  *
- * 1. Endpoint reads httpOnly cookie `customerAccessToken` (server-side, JS-inaccessible)
- * 2. Forward jako `Authorization: Bearer` header do backend GraphQL `customer` query
- * 3. Return `{ isAuthenticated, customer | null }` do klienta
- * 4. Klient setAuth(customer, '') — token NIE w body (cookie kontynuuje per-request auth)
+ * 1. The endpoint reads the httpOnly cookie `customerAccessToken` (server-side, JS-inaccessible)
+ * 2. Forwards it as an `Authorization: Bearer` header to the backend GraphQL `customer` query
+ * 3. Returns `{ isAuthenticated, customer | null }` to the client
+ * 4. The client calls setAuth(customer, '') — the token is NOT in the body (the cookie keeps handling per-request auth)
  *
- * Security: origin validation, fetch via Bearer (cookie nie crossuje API boundary).
+ * Security: origin validation, fetch via Bearer (the cookie never crosses the API boundary).
  * Pass `isTrustedOrigin` when running behind a reverse proxy — see
  * {@link trustedForwardedHostValidator}.
  *

package/dist/core/auth/session-events.d.ts

@@ -6,8 +6,8 @@
  * a 401 also failed. Storefronts subscribe once globally (`useSessionExpired`)
  * and react (notify + redirect to sign-in).
  *
- * 0-deps (Inv-1): plain `Set` + closure, no React / DOM. The provider owns the
- * instance (`useRef` + Context, Inv-3) — never a module-level singleton.
+ * 0-deps: plain `Set` + closure, no React / DOM. The provider owns the
+ * instance (`useRef` + Context) — never a module-level singleton.
  */
 export type SessionExpiredReason = 
 /** Proactive scheduler tried to refresh on tab wake but the session was already gone. */

package/dist/core/auth/session-events.js

@@ -6,8 +6,8 @@
  * a 401 also failed. Storefronts subscribe once globally (`useSessionExpired`)
  * and react (notify + redirect to sign-in).
  *
- * 0-deps (Inv-1): plain `Set` + closure, no React / DOM. The provider owns the
- * instance (`useRef` + Context, Inv-3) — never a module-level singleton.
+ * 0-deps: plain `Set` + closure, no React / DOM. The provider owns the
+ * instance (`useRef` + Context) — never a module-level singleton.
  */
 export function createSessionExpiredEmitter() {
     const listeners = new Set();

package/dist/core/cart/cart-client.d.ts

@@ -172,13 +172,13 @@ export declare class CartClient {
      */
     setShippingAddress(input: CartSetShippingAddressInput): Promise<CartMutationOutcome>;
     /**
-     * Set billing address on the cart (independent z shipping address — pass
-     * even when "billing same as shipping").
+     * Set billing address on the cart (independent of the shipping address —
+     * pass it even when "billing same as shipping").
      */
     setBillingAddress(input: CartSetBillingAddressInput): Promise<CartMutationOutcome>;
     /**
-     * Select shipping method on the cart (Decision D8 term unification — typed
-     * `shippingMethodId` jako ID, NIE String).
+     * Select shipping method on the cart (typed `shippingMethodId` — an ID,
+     * not a plain string).
      */
     selectShippingMethod(input: CartSelectShippingMethodInput): Promise<CartMutationOutcome>;
     /**
@@ -187,28 +187,27 @@ export declare class CartClient {
      */
     selectPaymentMethod(input: CartSelectPaymentMethodInput): Promise<CartMutationOutcome>;
     /**
-     * Clear all payment selection state on the cart — atomic NULL na method type,
-     * provider code, instrument code i legacy method ID. Idempotent — wielokrotne
-     * call = same final state. Use dla accordion "wróć do wyboru metody" UI flow.
-     * Cart MUSI być `ACTIVE` (CONVERTED carts throw z `ALREADY_COMPLETED`).
-     *
-     * Added by payment-instrument-preselection-advanced Adv-1 Req 3.6.
+     * Clear all payment selection state on the cart — atomically NULLs the method
+     * type, provider code, instrument code and legacy method ID. Idempotent —
+     * repeated calls produce the same final state. Use it for "back to payment
+     * method selection" accordion UI flows. The cart MUST be `ACTIVE` (CONVERTED
+     * carts throw with `ALREADY_COMPLETED`).
      */
     clearPaymentSelection(input: CartClearPaymentSelectionInput): Promise<CartMutationOutcome>;
     /**
-     * Apply gift card to cart (stackable z discount codes, FIFO consumption).
+     * Apply gift card to cart (stackable with discount codes, FIFO consumption).
      * Balance NOT debited yet — actual deduction at cartComplete.
      */
     applyGiftCard(input: CartApplyGiftCardInput): Promise<CartMutationOutcome>;
     /**
-     * Remove applied gift card from cart. Re-calculates FIFO amounts dla
-     * pozostałych cards.
+     * Remove applied gift card from cart. Re-calculates FIFO amounts for the
+     * remaining cards.
      */
     removeGiftCard(input: CartRemoveGiftCardInput): Promise<CartMutationOutcome>;
     /**
-     * Update gift card recipient info na line item (personalised delivery —
-     * recipientEmail, recipientName, message). Required przed cartComplete
-     * dla każdego gift card line item.
+     * Update gift card recipient info on a line item (personalised delivery —
+     * recipientEmail, recipientName, message). Required before cartComplete
+     * for every gift card line item.
      */
     updateGiftCardRecipient(input: CartUpdateGiftCardRecipientInput): Promise<CartMutationOutcome>;
     /**
@@ -221,8 +220,8 @@ export declare class CartClient {
      * is CONVERTED/locked, so drop your local cart and work with the Order. The
      * Order carries `canCreatePayment` + `paymentMethodType` so the storefront can
      * decide the payment flow. `paymentUrl` is intentionally NOT in the response
-     * (Decision D4) — the storefront initiates payment with a separate
-     * `paymentCreate` mutation after checking `order.canCreatePayment`.
+     * — the payment session is created by a separate `paymentCreate` mutation
+     * after checking `order.canCreatePayment`.
      */
     complete(input: CartCompleteInput): Promise<CartCompleteOutcome>;
     /**
@@ -244,13 +243,13 @@ export declare class CartClient {
      */
     createPayment(input: PaymentCreateInput): Promise<PaymentSession>;
     /**
-     * Validate discount code preview (Decision D3) — read-only Query, NIE
-     * mutation. Doesn't modify cart state. Returns `{ isValid, discount?, error? }`
-     * — storefront UI używa do inline feedback gdy klient wpisuje kod.
+     * Validate a discount code as a preview — a read-only Query, NOT a mutation:
+     * validation must not mutate cart state. Returns `{ isValid, discount?, error? }`
+     * — storefront UI uses it for inline feedback while the customer types a code.
      *
-     * Caching: storefront powinien używać `fetchPolicy: 'network-only'` lub
-     * cache key z `cart.subtotal` (discount eligibility może zależeć od minimum
-     * order amount).
+     * Caching: the storefront should use `fetchPolicy: 'network-only'` or a
+     * cache key that includes `cart.subtotal` (discount eligibility may depend
+     * on a minimum order amount).
      */
     validateDiscountCode(cartId: string, discountCode: string): Promise<DiscountValidationResult>;
 }

package/dist/core/cart/cart-client.d.ts.map

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

package/dist/core/cart/cart-client.js

@@ -206,7 +206,7 @@ export class CartClient {
         };
     }
     // -------------------------------------------------------------------------
-    // Phase 3 — Cart completion lifecycle methods
+    // Cart completion lifecycle methods
     // -------------------------------------------------------------------------
     /**
      * Set shipping address on the cart. Full replace (not patch). Triggers cart
@@ -218,8 +218,8 @@ export class CartClient {
         return { cart: data.cartSetShippingAddress.cart, warnings: data.cartSetShippingAddress.warnings ?? [] };
     }
     /**
-     * Set billing address on the cart (independent z shipping address — pass
-     * even when "billing same as shipping").
+     * Set billing address on the cart (independent of the shipping address —
+     * pass it even when "billing same as shipping").
      */
     async setBillingAddress(input) {
         const data = await this.client.mutate(CART_SET_BILLING_ADDRESS, { input });
@@ -227,8 +227,8 @@ export class CartClient {
         return { cart: data.cartSetBillingAddress.cart, warnings: data.cartSetBillingAddress.warnings ?? [] };
     }
     /**
-     * Select shipping method on the cart (Decision D8 term unification — typed
-     * `shippingMethodId` jako ID, NIE String).
+     * Select shipping method on the cart (typed `shippingMethodId` — an ID,
+     * not a plain string).
      */
     async selectShippingMethod(input) {
         const data = await this.client.mutate(CART_SELECT_SHIPPING_METHOD, { input });
@@ -245,12 +245,11 @@ export class CartClient {
         return { cart: data.cartSelectPaymentMethod.cart, warnings: data.cartSelectPaymentMethod.warnings ?? [] };
     }
     /**
-     * Clear all payment selection state on the cart — atomic NULL na method type,
-     * provider code, instrument code i legacy method ID. Idempotent — wielokrotne
-     * call = same final state. Use dla accordion "wróć do wyboru metody" UI flow.
-     * Cart MUSI być `ACTIVE` (CONVERTED carts throw z `ALREADY_COMPLETED`).
-     *
-     * Added by payment-instrument-preselection-advanced Adv-1 Req 3.6.
+     * Clear all payment selection state on the cart — atomically NULLs the method
+     * type, provider code, instrument code and legacy method ID. Idempotent —
+     * repeated calls produce the same final state. Use it for "back to payment
+     * method selection" accordion UI flows. The cart MUST be `ACTIVE` (CONVERTED
+     * carts throw with `ALREADY_COMPLETED`).
      */
     async clearPaymentSelection(input) {
         const data = await this.client.mutate(CART_CLEAR_PAYMENT_SELECTION, { input });
@@ -261,7 +260,7 @@ export class CartClient {
         };
     }
     /**
-     * Apply gift card to cart (stackable z discount codes, FIFO consumption).
+     * Apply gift card to cart (stackable with discount codes, FIFO consumption).
      * Balance NOT debited yet — actual deduction at cartComplete.
      */
     async applyGiftCard(input) {
@@ -270,8 +269,8 @@ export class CartClient {
         return { cart: data.cartApplyGiftCard.cart, warnings: data.cartApplyGiftCard.warnings ?? [] };
     }
     /**
-     * Remove applied gift card from cart. Re-calculates FIFO amounts dla
-     * pozostałych cards.
+     * Remove applied gift card from cart. Re-calculates FIFO amounts for the
+     * remaining cards.
      */
     async removeGiftCard(input) {
         const data = await this.client.mutate(CART_REMOVE_GIFT_CARD, { input });
@@ -279,9 +278,9 @@ export class CartClient {
         return { cart: data.cartRemoveGiftCard.cart, warnings: data.cartRemoveGiftCard.warnings ?? [] };
     }
     /**
-     * Update gift card recipient info na line item (personalised delivery —
-     * recipientEmail, recipientName, message). Required przed cartComplete
-     * dla każdego gift card line item.
+     * Update gift card recipient info on a line item (personalised delivery —
+     * recipientEmail, recipientName, message). Required before cartComplete
+     * for every gift card line item.
      */
     async updateGiftCardRecipient(input) {
         const data = await this.client.mutate(CART_UPDATE_GIFT_CARD_RECIPIENT, { input });
@@ -298,8 +297,8 @@ export class CartClient {
      * is CONVERTED/locked, so drop your local cart and work with the Order. The
      * Order carries `canCreatePayment` + `paymentMethodType` so the storefront can
      * decide the payment flow. `paymentUrl` is intentionally NOT in the response
-     * (Decision D4) — the storefront initiates payment with a separate
-     * `paymentCreate` mutation after checking `order.canCreatePayment`.
+     * — the payment session is created by a separate `paymentCreate` mutation
+     * after checking `order.canCreatePayment`.
      */
     async complete(input) {
         const data = await this.client.mutate(CART_COMPLETE, { input });
@@ -332,13 +331,13 @@ export class CartClient {
         return data.paymentCreate.payment;
     }
     /**
-     * Validate discount code preview (Decision D3) — read-only Query, NIE
-     * mutation. Doesn't modify cart state. Returns `{ isValid, discount?, error? }`
-     * — storefront UI używa do inline feedback gdy klient wpisuje kod.
+     * Validate a discount code as a preview — a read-only Query, NOT a mutation:
+     * validation must not mutate cart state. Returns `{ isValid, discount?, error? }`
+     * — storefront UI uses it for inline feedback while the customer types a code.
      *
-     * Caching: storefront powinien używać `fetchPolicy: 'network-only'` lub
-     * cache key z `cart.subtotal` (discount eligibility może zależeć od minimum
-     * order amount).
+     * Caching: the storefront should use `fetchPolicy: 'network-only'` or a
+     * cache key that includes `cart.subtotal` (discount eligibility may depend
+     * on a minimum order amount).
      */
     async validateDiscountCode(cartId, discountCode) {
         const data = await this.client.query(CART_VALIDATE_DISCOUNT_CODE, { cartId, discountCode });