@doswiftly/storefront-sdk 16.0.0 → 17.0.0

package/CHANGELOG.md

@@ -1,5 +1,471 @@
 # Changelog
 
+## 17.0.0
+
+### Major Changes
+
+- d3f0f04: `cartSelectPaymentMethod` mutation is now method-centric.
+
+  The buyer picks a payment **category** (`BLIK`, `CARD`, `BANK_TRANSFER`, ...) and the backend resolves the preferred gateway from the merchant's `MerchantPaymentConfig` at `paymentCreate` time. Previously the storefront had to look up a per-provider tile UUID via `availablePaymentMethods` and pass it as `paymentMethodId`.
+
+  **Breaking** — `CartSelectPaymentMethodInput` shape changed:
+
+  ```graphql
+  # Before
+  input CartSelectPaymentMethodInput {
+    cartId: ID!
+    paymentMethodId: ID! # UUID of a per-provider tile
+  }
+
+  # After
+  input CartSelectPaymentMethodInput {
+    cartId: ID!
+    methodType: PaymentMethodType! # BLIK, CARD, BANK_TRANSFER, ...
+    preferredProviderId: String # optional override (provider code)
+  }
+  ```
+
+  Migration:
+
+  ```ts
+  // Before
+  await sdk.cartSelectPaymentMethod({ input: { cartId, paymentMethodId } });
+
+  // After
+  await sdk.cartSelectPaymentMethod({ input: { cartId, methodType: "BLIK" } });
+  // Or with explicit gateway override:
+  await sdk.cartSelectPaymentMethod({
+    input: { cartId, methodType: "BLIK", preferredProviderId: "payu" },
+  });
+  ```
+
+  The `availablePaymentMethods` query now returns deduplicated rows per `PaymentMethodType` (one row per BLIK, CARD, ...) with `providersAvailable` (gateway codes sorted by merchant priority) and `preferredProvider` (head of the list). The legacy `group: BY_PROVIDER` argument was removed — there is one canonical shape.
+
+  **Why** — A merchant configuring PayU + Przelewy24 would previously see "PayU BLIK" and "P24 BLIK" as two separate tiles on the storefront. After this change the storefront shows one BLIK tile; the merchant chooses which gateway handles BLIK via priority settings, and the buyer never sees the internal routing.
+
+  **Live capability sync (opt-in)** — gateway adapters may expose an optional `getAvailablePaymentMethods(credentials, { currency, amount, country })` capability returning the gateway-reported active methods (min/max amount, brand image, enabled flag). When supported, the platform caches the response per shop/currency and uses it to refine the storefront picker. Gateways without the capability fall back to a static capability matrix. Gateway HTTP failures are soft-failed — the buyer always sees the merchant's configured methods even when the upstream is temporarily unreachable.
+
+- 7931668: Payment instrument preselection — direct deep-link to a specific instrument screen on the hosted gateway page (BLIK code, branded bank, wallet, card brand) instead of the gateway default landing.
+
+  **Why**: shoppers picking BLIK from the storefront UI now skip the gateway method picker entirely — the redirect lands directly on the BLIK code entry. Same flow for picking mBank, ING, Apple Pay, etc. Industry shorthand calls this "deep-link checkout" — 5-15% conversion uplift on single-instrument funnels.
+
+  **Breaking schema changes**:
+  1. `CartSelectPaymentMethodInput.preferredProviderId` → `preferredProviderCode`. Rename only — same semantics (override the merchant's preferred provider). Aligns with the `*Code` naming convention (`*Id` reserved for UUIDs, `*Code` for lowercase string identifiers like `payu` / `przelewy24`).
+
+     ```graphql
+     # Before
+     input CartSelectPaymentMethodInput {
+       cartId: ID!
+       methodType: PaymentMethodType!
+       preferredProviderId: String # ← removed
+     }
+
+     # After
+     input CartSelectPaymentMethodInput {
+       cartId: ID!
+       methodType: PaymentMethodType!
+       preferredProviderCode: String # ← renamed
+       preferredInstrumentCode: String # ← new (additive)
+     }
+     ```
+
+  2. `PaymentMethod.provider` / `PaymentMethod.providersAvailable` / `PaymentMethod.preferredProvider` / `Order.paymentMethod` / `Payment.provider` are now the typed `ProviderCode` enum (UPPERCASE: `PAYU`, `PRZELEWY24`, `STRIPE`, `CASH_ON_DELIVERY`, `BANK_TRANSFER`, `MANUAL_PAYMENT`, `GIFT_CARD`, `TEST_GATEWAY`) instead of `String`. Replace any `if (provider === 'payu')` storefront branches with the imported enum.
+
+     ```ts
+     // Before
+     if (paymentMethod.provider === "payu") {
+       /* ... */
+     }
+
+     // After
+     import { ProviderCode } from "@doswiftly/storefront-sdk";
+     if (paymentMethod.provider === ProviderCode.PAYU) {
+       /* ... */
+     }
+     ```
+
+  3. `PaymentMethod.amountLimits` removed from the SDK fragment. The field still exists on the schema for backward-compat, but the SDK no longer selects it — most storefronts never used it and the data is provider-specific (PayU/P24 report limits per method, not per checkout). Re-add it to your local fragment if you need it.
+
+  **Additive (backward-compatible)**:
+  - `PaymentMethod.instruments: [PaymentMethodInstrument!]` — concrete instruments exposed by the gateway (BLIK code, branded banks, wallets, card brands). Each instrument carries `providerCode`, `instrumentCode`, `displayName`, `brandImageUrl`, `displayHint` (semantic UX hint: `PIN_ENTRY` / `WALLET_TAP` / `BANK_LIST` / `CARD_FORM`), `enabled`. `null` when the gateway doesn't expose granular data; empty array when all instruments are disabled.
+  - `cartSelectPaymentMethod(input: { preferredInstrumentCode })` — pass the chosen instrument's `instrumentCode` to persist it on the cart. Eager validation cross-checks against the gateway's live capabilities — invalid codes return `userErrors[].code = 'CART_INVALID_INSTRUMENT_CODE'`.
+  - `Cart.selectedPaymentInstrumentCode: String` — round-trips the persisted choice so the storefront can re-render the selected instrument on cart refresh.
+  - `Order.paymentInstrumentCode: String` — propagated from cart at `cartComplete`; the gateway adapter uses it to build the deep-link payload at `paymentCreate`.
+
+  **Usage example** — instrument-level deep-link checkout:
+
+  ```ts
+  import { useCartManager, ProviderCode } from "@doswiftly/storefront-sdk";
+
+  const { selectPaymentMethod, complete, createPayment } = useCartManager();
+
+  // 1. Render the instrument tiles from the gateway-reported list
+  const method = availablePaymentMethods.methods.find((m) => m.type === "BLIK");
+  const instrument = method?.instruments?.find(
+    (i) => i.instrumentCode === "blik",
+  );
+
+  // 2. Persist the buyer's choice on the cart
+  await selectPaymentMethod({
+    methodType: "BLIK",
+    preferredProviderCode: "payu",
+    preferredInstrumentCode: instrument.instrumentCode,
+  });
+
+  // 3. Complete the cart — instrument propagates to the Order
+  const { order } = await complete();
+
+  // 4. Initiate payment — gateway redirects directly to the BLIK code screen
+  const session = await createPayment(order.id);
+  window.location.href = session.redirectUrl;
+  ```
+
+  **Error handling**:
+  - `userErrors[].code === 'CART_INVALID_INSTRUMENT_CODE'` — instrument code is not available with the chosen provider (gateway disabled it, merchant config changed, typo). Refresh `availablePaymentMethods` and re-prompt the buyer.
+  - `paymentCreate` failed gateway initiation with the preselected instrument? The order's `paymentInstrumentCode` is automatically cleared (best-effort) — the next `paymentCreate` call falls back to the gateway default landing page. Storefront just retries.
+
+  **Rate limits**:
+  - `availablePaymentMethods` Query: 60 requests/min per IP+shop. Live capability lookups (OAuth + gateway list call) are expensive — hitting the limit returns `extensions.code: 'THROTTLED'` with `retryAfter`. Don't poll; cache the result for the duration of the checkout step.
+
+  **Gateway API version pinning**:
+  - PayU API pinned to `v2_1`, Przelewy24 API pinned to `v1`. When the upstream gateway ships a major version migration, the SDK / operations packages will bump major together with the constant update.
+
+  **Migration checklist for existing storefronts**:
+  - [ ] Rename `preferredProviderId` → `preferredProviderCode` everywhere in storefront mutations.
+  - [ ] Replace string comparisons (`provider === 'payu'`) with `ProviderCode` enum.
+  - [ ] Re-add `amountLimits` to your local PaymentMethod fragment if you used it.
+  - [ ] (Optional) Render the new `instruments` array as tiles to enable instrument-level deep-link checkout — 1-2 extra hours of UI work, measurable conversion impact on single-instrument flows.
+
+### Minor Changes
+
+- fd82b62: `PaymentMethod` type gains availability + amount limit fields.
+
+  The storefront `PaymentMethod` returned by `availablePaymentMethods` (and `Cart.availablePaymentMethods` / `Cart.selectedPaymentMethod`) now carries three additional fields:
+  - **`available: Boolean!`** — `false` when the resolving gateway is temporarily unavailable (incident, maintenance) or reported the method as disabled. Storefront should gray-out the tile instead of hiding it — gives merchants observability into routing failures.
+  - **`unavailableReason: PaymentMethodUnavailableReason`** — diagnostic enum (`GATEWAY_DOWN`, `GATEWAY_DISABLED`, `NO_INSTRUMENTS`, `CREDENTIALS_INVALID`). Null when `available` is true. Use for context-aware copy ("Provider is temporarily down" vs "Method not configured").
+  - **`amountLimits: PaymentMethodAmountLimits`** — gateway-reported min/max transaction amount in the resolving currency (e.g. BLIK 1-20000 PLN). Filter the picker against cart total. Null when the gateway does not report limits.
+
+  ```graphql
+  fragment PaymentMethod on PaymentMethod {
+    # existing fields (id, name, provider, type, icon, ...)
+    providersAvailable
+    preferredProvider
+    available
+    unavailableReason
+    amountLimits {
+      min
+      max
+      currency
+    }
+  }
+  ```
+
+  **Currency** is automatically resolved from the storefront context (cascade: `@inContext(currency:)` directive → `X-Preferred-Currency` header → cookie → `Accept-Language` → shop default). Override per query via the `@inContext(currency: "EUR")` directive — no new schema argument.
+
+  **Migration example** for storefront pickers:
+
+  ```ts
+  const { methods } = await sdk.cart.availablePaymentMethods();
+  return methods.map((method) => (
+    <PaymentTile
+      key={method.type}
+      type={method.type}
+      disabled={!method.available}
+      tooltip={method.unavailableReason && reasonCopy[method.unavailableReason]}
+      badge={method.amountLimits && cart.total > method.amountLimits.max ? 'Cart too large' : null}
+    />
+  ));
+  ```
+
+  Backend additionally sanitizes provider error messages (strips OAuth tokens, URLs, JSON secret keys, stack traces) before returning them in admin diagnostic responses — internal logs keep the full error for diagnostics.
+
+- c878d14: Payment instrument preselection — storefront UX completion (distinct error code + warnings array + explicit deselect mutation).
+
+  **Why**: storefront dispatching dla instrument failure stał się context-aware. Dziś generic `PAYMENT_FAILED` post-auto-clear nie pozwalał odróżnić "instrument cleared, retry default landing OK" od "real gateway outage, retry kolejnym attempt". Plus brak explicit deselect — accordion "wróć do wyboru metody" UI wymagał hack typu re-select method.
+
+  **Additive (backward-compatible)**:
+  1. `PaymentErrorCode.INSTRUMENT_PRESELECTION_FAILED` — new enum value. Wystawiany po auto-clear `Order.paymentInstrumentCode` post-`InvalidPaymentInstrumentError`. Distinct od `PAYMENT_FAILED` (generic gateway failure fallback dla credentials / network / 5xx / circuit breaker).
+  2. `PaymentCreatePayload.warnings: [PaymentWarning!]!` — new field, default empty array. Emitted post-auto-clear z entry `{ code: INSTRUMENT_CLEARED_FOR_RETRY, message, retryHint: null }`. Storefront dispatches retry hint differently (accordion reset / progress bar / itp.).
+  3. `cartClearPaymentSelection(input: { cartId: ID! })` — new mutation. Atomic NULL across all payment selection fields. Idempotent. The cart must be `ACTIVE` — `CONVERTED` carts reject with `userErrors[0].code = 'ALREADY_COMPLETED'`. Rate limit 30/min.
+
+  **Storefront usage** — handle instrument failure z context-aware retry:
+
+  ```ts
+  import {
+    useCartManager,
+    type CartMutationOutcome,
+  } from "@doswiftly/storefront-sdk";
+
+  const { selectPaymentMethod, clearPaymentSelection, createPayment } =
+    useCartManager();
+
+  // 1. Klient wybiera BLIK preselect
+  await selectPaymentMethod({
+    methodType: "BLIK",
+    preferredProviderCode: "payu",
+    preferredInstrumentCode: "blik",
+  });
+
+  // 2. Try paymentCreate — może rzucić instrument-specific error
+  try {
+    const session = await createPayment(orderId);
+    window.location.href = session.redirectUrl;
+  } catch (err) {
+    if (err.userErrors?.[0]?.code === "INSTRUMENT_PRESELECTION_FAILED") {
+      // Backend auto-cleared instrument — show retry button
+      // Warning message available via err.warnings[0].message
+      showRetryUI({
+        title: "Instrument płatności niedostępny",
+        message: err.warnings?.[0]?.message ?? err.message,
+        onRetry: () => createPayment(orderId), // next attempt = default landing
+      });
+    } else if (err.userErrors?.[0]?.code === "PAYMENT_FAILED") {
+      // Generic gateway outage — retry z tym samym instrumentem
+      showOutageUI({
+        message: err.message,
+        onRetry: () => createPayment(orderId),
+      });
+    }
+  }
+
+  // 3. Accordion "wróć do wyboru metody" — explicit deselect
+  await clearPaymentSelection({ cartId });
+  // Cart.selectedPaymentMethod === null, Cart.selectedPaymentInstrumentCode === null
+  ```
+
+  **Migration guide for existing storefronts**:
+  - [ ] Add `warnings[]` to your `paymentCreate` selection set (if you use a custom GraphQL document instead of the SDK helpers).
+  - [ ] Branch UI dispatch on `userErrors[0].code === 'INSTRUMENT_PRESELECTION_FAILED'` distinct from `PAYMENT_FAILED`.
+  - [ ] (Optional) Replace any accordion-reset hack with `cartClearPaymentSelection({ cartId })` — clearer API, idempotent, single round-trip.
+
+  **Standards note**: splitting `userErrors[]` (blocking) and `warnings[]` (non-blocking) is a common e-commerce convention. The `INSTRUMENT_PRESELECTION_FAILED` semantics match retry-hint patterns used by major payment gateway SDKs (Stripe `payment_method_unavailable`, etc.).
+
+- c553c80: Payment instrument preselection — cart re-validation stale signal + headless instrument components + browser data helper.
+
+  **Why**: previously the storefront kept showing an obsolete instrument selection until the buyer clicked "pay" — only then did the gateway reject it. The signal is now **proactive**: every cart query re-validates the selection against live gateway capabilities and emits a warning when the method or instrument disappeared. Plus a set of pre-built headless React components so the instrument picker no longer requires manual `displayHint` dispatch.
+
+  **Additive (backward-compatible)**:
+  1. `Cart.warnings: [CartWarning!]!` — new field, default empty array. Computed at query time. Currently emitted: `PAYMENT_SELECTION_STALE` (code) when `selectedPaymentMethod` or `selectedPaymentInstrumentCode` no longer matches live gateway capabilities. Read-only signal — backend persistence is preserved (clear via `cartClearPaymentSelection` or a fresh `cartSelectPaymentMethod`).
+  2. `Cart.selectedPaymentMethod` re-validation — when the method disappeared from live caps the field returns `null` plus a warning with `target: 'selectedPaymentMethod'`.
+  3. `Cart.selectedPaymentInstrumentCode` re-validation — when only the instrument disappeared (method preserved), the field returns `null` plus a warning with `target: 'selectedPaymentInstrumentCode'` (method-level signal stays intact). Backend persistence is preserved — a re-select gets a fresh state.
+  4. `CartWarningCode.PAYMENT_SELECTION_STALE` — new enum value in the existing `CartWarning` envelope.
+  5. Graceful degradation — when the live capability check fails (gateway timeout / network outage), `Cart` returns the existing selection without a warning (UX continuity over freshness; `cartComplete` time-of-payment validation is the final safety net).
+  6. `<PaymentInstrumentTile>` — new pre-built headless component. Single instrument button with full ARIA contract (`role="radio"`, `aria-checked`, `aria-label`, `data-instrument-code`, `data-display-hint`, `data-selected`). Zero opinionated styling — class props per part (button, icon, label). `displayHint` is emitted as a `data-display-hint` attribute so you can style via CSS attribute selectors.
+  7. `<PaymentInstrumentSection>` — new pre-built headless component. Radio-group container with keyboard navigation (ArrowUp/Down/Left/Right wrap, Home/End jump). Renders one `<PaymentInstrumentTile>` per instrument in the order received from `availablePaymentMethods` (no client-side resort — the backend ordering is the source of truth).
+  8. `getBrowserDataForPayment()` — new helper. Collects PSD2/3DS2 browser context (`userAgent`, `language`, screen dimensions, color depth, timezone offset, IANA timezone, `javaEnabled` fallback). Browser-only — throws `BrowserDataNotAvailableError` in SSR. Forward-looking utility for future 3DS challenge flows.
+
+  **Storefront usage** — listen to the stale signal in your cart query:
+
+  ```ts
+  const { cart } = useCart(cartId);
+
+  const staleWarning = cart?.warnings?.find(
+    (w) => w.code === "PAYMENT_SELECTION_STALE",
+  );
+
+  if (staleWarning) {
+    // The backend signals that the buyer picked a method which is no longer
+    // available at the gateway — show a "pick another method" dialog.
+    // `target` distinguishes method vs instrument level:
+    if (staleWarning.target === "selectedPaymentMethod") {
+      // cart.selectedPaymentMethod === null — full re-select required
+    } else if (staleWarning.target === "selectedPaymentInstrumentCode") {
+      // cart.selectedPaymentMethod is still set, only the instrument cleared
+    }
+    // Backend persistence is preserved — `cartClearPaymentSelection` or
+    // a fresh `cartSelectPaymentMethod` is the consumer's responsibility.
+  }
+  ```
+
+  **Storefront usage** — instrument picker with pre-built components:
+
+  ```tsx
+  import { PaymentInstrumentSection } from "@doswiftly/storefront-sdk/react";
+  import { useState } from "react";
+
+  function CheckoutPaymentStep({ method }: { method: PaymentMethod }) {
+    const [instrumentCode, setInstrumentCode] = useState<string | undefined>(
+      undefined,
+    );
+
+    return (
+      <PaymentInstrumentSection
+        method={method}
+        selectedInstrumentCode={instrumentCode}
+        onSelectInstrument={(code) => {
+          setInstrumentCode(code);
+          cart.selectPaymentMethod({
+            methodType: method.type,
+            preferredProviderCode: method.preferredProvider,
+            preferredInstrumentCode: code,
+          });
+        }}
+        sectionClassName="grid grid-cols-2 gap-2"
+        tileClassName="rounded border p-3 hover:bg-gray-50 data-[selected=true]:border-blue-500"
+        labelClassName="font-semibold"
+        ariaLabel="Pick a payment instrument"
+      />
+    );
+  }
+  ```
+
+  **Storefront usage** — browser data for future 3DS flows:
+
+  ```ts
+  import { getBrowserDataForPayment, BrowserDataNotAvailableError } from '@doswiftly/storefront-sdk/react';
+
+  function handleCheckoutSubmit() {
+    try {
+      const browserData = getBrowserDataForPayment();
+      // Pass to paymentCreate input when the gateway requires a 3DS challenge
+      await cart.createPayment({ ..., browserData });
+    } catch (err) {
+      if (err instanceof BrowserDataNotAvailableError) {
+        // SSR / no DOM — skip browser data; the gateway uses its default flow
+      }
+      throw err;
+    }
+  }
+  ```
+
+  **Migration checklist for existing storefronts**:
+  - [ ] Add `warnings { message code target }` to your cart query selection set (if you use a custom GraphQL document instead of the SDK fragments — SDK fragments are updated automatically).
+  - [ ] Branch UI on `cart.warnings[].code === 'PAYMENT_SELECTION_STALE'` to show a re-prompt dialog before checkout submit.
+  - [ ] (Optional) Replace a custom instrument picker with `<PaymentInstrumentSection>` — saves boilerplate, ships full ARIA + keyboard nav out of the box.
+  - [ ] (Forward-looking) Adopt `getBrowserDataForPayment()` in checkout submit handlers when 3DS flows become relevant (currently optional — the gateway accepts an undefined `browserData`).
+
+  **Standards reference**: `PaymentInstrumentSection` follows the WAI-ARIA radiogroup pattern (https://www.w3.org/WAI/ARIA/apg/patterns/radio/). The browser data helper shape matches the EMVCo 3DS2 BrowserData specification.
+
+## 16.1.0
+
+### Minor Changes
+
+- 1e6062e: Read the gift card recipient back from the cart.
+
+  `cartUpdateGiftCardRecipient` already persisted the recipient (email, name,
+  personalised message) on a gift card line — but the `CartLine` type didn't
+  expose any field to read it. Storefronts that render the checkout server-side
+  (SSR, deep link, "back to cart" navigation) had no way to know that the buyer
+  had already filled in the recipient form on a previous visit. The recipient
+  dialog opened blank, like nothing had been saved.
+
+  **New field** — `CartLine.giftCardRecipient: GiftCardLineRecipient`
+
+  ```graphql
+  type GiftCardLineRecipient {
+    recipientEmail: String
+    recipientName: String
+    message: String
+  }
+  ```
+
+  All three fields are individually nullable so a partial set (email only, no
+  name or message) is representable as-is. The field on `CartLine` itself is
+  nullable — `null` means the buyer has not set a recipient yet, in which case
+  the gift card is delivered to the order `customerEmail` on completion.
+
+  `null` is also what you get for any non-gift-card line — there is no risk of
+  the field reporting a stale recipient from a previous line at the same index.
+
+  **Use it to seed your form**
+
+  ```tsx
+  const cart = await cartClient.get(cartId);
+  const giftLine = cart?.lines.edges.find(
+    (e) => e.node.productType === "GIFT_CARD",
+  );
+
+  <GiftRecipientForm
+    defaultValues={
+      giftLine?.node.giftCardRecipient ?? {
+        recipientEmail: "",
+        recipientName: "",
+        message: "",
+      }
+    }
+    onSubmit={(values) =>
+      cartClient.updateGiftCardRecipient(cartId, giftLine!.node.id, values)
+    }
+  />;
+  ```
+
+  **Migration**
+
+  Additive change — no rename, no signature change. The `CartLine` fragment
+  shipped by the SDK already includes the new field after this release, so
+  upgrading immediately unlocks the read path. No client code changes required
+  to keep existing flows working.
+
+- ac2e306: Distinguish recoverable session loss from permanent cart denial.
+
+  Adds a new `CART_UNAUTHENTICATED` code to the cart error envelope. Until now,
+  both "your sign-in expired" and "this cart belongs to someone else" surfaced
+  as `CART_FORBIDDEN`, so a storefront had no way to know whether to send the
+  buyer to `/login` (recoverable) or to drop the cart cookie (permanent).
+  After the typical ~24h session TTL, the buyer would silently lose their
+  checkout state instead of being prompted to re-authenticate.
+
+  **New code** — `CART_UNAUTHENTICATED`
+
+  | Condition                                                                             | Code                         | Recovery                                                    |
+  | ------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------------- |
+  | Anonymous request **or** expired/invalid session on a cart that belongs to a customer | `CART_UNAUTHENTICATED`       | Re-authenticate. Cart is preserved (`cart-id` cookie kept). |
+  | Authenticated as a **different** customer than the cart owner                         | `CART_FORBIDDEN` (unchanged) | Drop the cart cookie and start over.                        |
+
+  The cart resource itself is intact in the `CART_UNAUTHENTICATED` case — the
+  buyer's saved address, line items, discount codes, and gift cards return as
+  soon as they sign in.
+
+  **New SDK signal** — `runner.onSessionExpired(...)`
+
+  The recovery runner now exposes a separate event for session loss, distinct
+  from `onExpired` (which is for cart-resource lifecycle: cart not found, cart
+  already completed). Subscribe once at the provider level and route the buyer
+  to `/login` with a `return_to` parameter; the cart cookie stays put.
+
+  ```ts
+  // app/providers.tsx
+  const unsubExpired = runner.onExpired(() => {
+    // cart resource gone — start fresh
+    router.push("/cart/new");
+  });
+
+  const unsubSession = runner.onSessionExpired(() => {
+    // session gone, cart preserved — sign back in
+    router.push(`/login?return_to=${encodeURIComponent(location.pathname)}`);
+  });
+  ```
+
+  The session branch throws `CartSessionRequiredError` (re-exported alongside
+  `CartRecoveryNotPossibleError`) and does **not** invoke `recreateAndRun` —
+  recreating the cart on a stale session would discard the buyer's progress.
+
+  **Imperative handling**
+
+  If you handle mutation errors directly (Server Action, custom hook), add one
+  case to your existing switch:
+
+  ```ts
+  switch (err.userErrors[0]?.code) {
+    case "CART_UNAUTHENTICATED":
+      redirect(`/login?return_to=${encodeURIComponent("/checkout")}`);
+      break;
+    case "CART_FORBIDDEN":
+      cookies().delete("cart-id");
+      redirect("/cart/expired");
+      break;
+    // ...existing cases for CART_NOT_FOUND / ALREADY_COMPLETED
+  }
+  ```
+
+  **Migration**
+
+  Additive change — no rename, no signature change. Existing `case 'CART_FORBIDDEN'`
+  branches keep working as before. Opt in to the new code at your own pace; until
+  you add the case, anonymous and cross-customer denials fall into your existing
+  default branch (one will be recoverable, one will not — adding the case lets
+  you distinguish them).
+
 ## 16.0.0
 
 ### Major Changes

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

@@ -22,7 +22,7 @@
  * ```
  */
 import type { StorefrontClient } from '../client/types';
-import type { Cart, CartCreateInput, CartLineInput, CartLineUpdateInput, CartBuyerIdentityInput, CartAttributeInput, CartSetShippingAddressInput, CartSetBillingAddressInput, CartSelectShippingMethodInput, CartSelectPaymentMethodInput, CartApplyGiftCardInput, CartRemoveGiftCardInput, CartUpdateGiftCardRecipientInput, CartCompleteInput, CartWarning, Order, DiscountValidationResult, PaymentSession, PaymentCreateInput, AvailableShippingMethodsPayload, AvailablePaymentMethods, ShippingAddressInput } from './types';
+import type { Cart, CartCreateInput, CartLineInput, CartLineUpdateInput, CartBuyerIdentityInput, CartAttributeInput, CartSetShippingAddressInput, CartSetBillingAddressInput, CartSelectShippingMethodInput, CartSelectPaymentMethodInput, CartClearPaymentSelectionInput, CartApplyGiftCardInput, CartRemoveGiftCardInput, CartUpdateGiftCardRecipientInput, CartCompleteInput, CartWarning, Order, DiscountValidationResult, PaymentSession, PaymentCreateInput, AvailableShippingMethodsPayload, AvailablePaymentMethods, ShippingAddressInput } from './types';
 /**
  * Standard mutation return shape — `cart` is non-null on success (userErrors
  * cause assertNoUserErrors to throw), `warnings` may be empty.
@@ -149,6 +149,15 @@ export declare class CartClient {
      * no pre-authorization.
      */
     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.
+     */
+    clearPaymentSelection(input: CartClearPaymentSelectionInput): Promise<CartMutationOutcome>;
     /**
      * Apply gift card to cart (stackable z discount codes, FIFO consumption).
      * Balance NOT debited yet — actual deduction at cartComplete.

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

@@ -22,7 +22,7 @@
  * ```
  */
 import { assertNoUserErrors } from '../helpers/assert-no-user-errors';
-import { CART_QUERY, ORDER_BY_TOKEN_QUERY, CART_AVAILABLE_SHIPPING_METHODS_QUERY, AVAILABLE_PAYMENT_METHODS_QUERY, CART_CREATE, CART_ADD_LINES, CART_UPDATE_LINES, CART_REMOVE_LINES, CART_DISCOUNT_CODES_UPDATE, CART_UPDATE_NOTE, CART_UPDATE_ATTRIBUTES, CART_UPDATE_BUYER_IDENTITY, CART_SET_SHIPPING_ADDRESS, CART_SET_BILLING_ADDRESS, CART_SELECT_SHIPPING_METHOD, CART_SELECT_PAYMENT_METHOD, CART_APPLY_GIFT_CARD, CART_REMOVE_GIFT_CARD, CART_UPDATE_GIFT_CARD_RECIPIENT, CART_COMPLETE, CART_VALIDATE_DISCOUNT_CODE, PAYMENT_CREATE, } from '../operations/cart';
+import { CART_QUERY, ORDER_BY_TOKEN_QUERY, CART_AVAILABLE_SHIPPING_METHODS_QUERY, AVAILABLE_PAYMENT_METHODS_QUERY, CART_CREATE, CART_ADD_LINES, CART_UPDATE_LINES, CART_REMOVE_LINES, CART_DISCOUNT_CODES_UPDATE, CART_UPDATE_NOTE, CART_UPDATE_ATTRIBUTES, CART_UPDATE_BUYER_IDENTITY, CART_SET_SHIPPING_ADDRESS, CART_SET_BILLING_ADDRESS, CART_SELECT_SHIPPING_METHOD, CART_SELECT_PAYMENT_METHOD, CART_CLEAR_PAYMENT_SELECTION, CART_APPLY_GIFT_CARD, CART_REMOVE_GIFT_CARD, CART_UPDATE_GIFT_CARD_RECIPIENT, CART_COMPLETE, CART_VALIDATE_DISCOUNT_CODE, PAYMENT_CREATE, } from '../operations/cart';
 export class CartClient {
     client;
     constructor(client) {
@@ -194,6 +194,22 @@ export class CartClient {
         assertNoUserErrors(data.cartSelectPaymentMethod);
         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.
+     */
+    async clearPaymentSelection(input) {
+        const data = await this.client.mutate(CART_CLEAR_PAYMENT_SELECTION, { input });
+        assertNoUserErrors(data.cartClearPaymentSelection);
+        return {
+            cart: data.cartClearPaymentSelection.cart,
+            warnings: data.cartClearPaymentSelection.warnings ?? [],
+        };
+    }
     /**
      * Apply gift card to cart (stackable z discount codes, FIFO consumption).
      * Balance NOT debited yet — actual deduction at cartComplete.

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

@@ -55,6 +55,54 @@ export type CartRecoverableErrorCode = (typeof CART_RECOVERABLE_ERROR_CODES)[num
  * `StorefrontError` carries at least one userError with a recoverable code.
  */
 export declare function isCartRecoverableError(err: unknown): err is StorefrontError;
+/**
+ * Cart error codes that signal a missing or invalid auth context on a
+ * customer-owned cart — distinct from cart-resource recovery
+ * (`CART_RECOVERABLE_ERROR_CODES`).
+ *
+ * - `CART_UNAUTHENTICATED` — anonymous request OR present-but-invalid token
+ *   (expired JWT, malformed). The cart resource is intact and reachable
+ *   again after re-auth.
+ *
+ * Storefronts SHOULD preserve the `cart-id` cookie when handling these
+ * codes and prompt sign-in — the same cart resumes after a successful login.
+ */
+export declare const CART_SESSION_ERROR_CODES: readonly ["CART_UNAUTHENTICATED"];
+export type CartSessionErrorCode = (typeof CART_SESSION_ERROR_CODES)[number];
+/**
+ * Type-safe predicate for "this error means the session is gone, but the
+ * cart resource is intact". Distinct from `isCartRecoverableError`
+ * (cart-resource recovery) — `isCartSessionError` matches auth-recoverable
+ * codes that should trigger re-auth flow, NOT cart cookie cleanup.
+ *
+ * Inspects `err.userErrors[].code` (structured field) — never matches against
+ * `err.message` (locale-dependent, non-stable).
+ */
+export declare function isCartSessionError(err: unknown): err is StorefrontError;
+/**
+ * Event fired when the runner observes a session error (`CART_UNAUTHENTICATED`).
+ * Cart-id cookie is NOT cleared — the cart resource is intact and the buyer
+ * should be prompted to re-authenticate; after a successful login the same
+ * cart resumes.
+ */
+export interface CartSessionExpiredEvent {
+    /** Cart id from the cookie at the time of the failure (null when no cart was set). */
+    oldCartId: string | null;
+    /** Operation name from `CartRecoveryOperation.name` if provided, otherwise 'unknown'. */
+    operation: string;
+    /** Original `StorefrontError` carrying the `CART_UNAUTHENTICATED` userError. */
+    cause: unknown;
+}
+/**
+ * Thrown when a cart operation fails with a session error
+ * (`CART_UNAUTHENTICATED`). Distinct from `CartRecoveryNotPossibleError`
+ * (cart-resource issue) — storefronts should redirect to a sign-in flow
+ * and retry the operation after re-auth.
+ */
+export declare class CartSessionRequiredError extends Error {
+    readonly cause: unknown;
+    constructor(cause: unknown, message?: string);
+}
 /**
  * Cookie I/O port. Caller's responsibility — core never touches `document.cookie`.
  *
@@ -137,6 +185,14 @@ export interface ExecuteWithCartRecoveryOptions<T> {
     cookieMaxAge?: number;
     /** Optional listener fired before the runner throws `CartRecoveryNotPossibleError`. */
     onExpired?: (event: CartExpiredEvent) => void;
+    /**
+     * Optional listener fired before the runner throws
+     * `CartSessionRequiredError`. Distinct from `onExpired` — the cart
+     * resource is intact, but the session/auth context is missing or invalid.
+     * Storefront should redirect to sign-in and retry the operation after
+     * re-auth; the same cart resumes.
+     */
+    onSessionExpired?: (event: CartSessionExpiredEvent) => void;
 }
 /**
  * Runs an operation against the current cart, recovering once on
@@ -158,6 +214,13 @@ export interface CartRecoveryRunner {
      * fails. Returns an unsubscribe function. Multiple subscribers are supported.
      */
     onExpired(listener: (event: CartExpiredEvent) => void): () => void;
+    /**
+     * Subscribe to `session-expired` events fired when the runner observes a
+     * `CART_UNAUTHENTICATED` userError (cart resource intact, re-auth required).
+     * The cart-id cookie is preserved so the same cart resumes after a successful
+     * sign-in. Returns an unsubscribe function. Multiple subscribers are supported.
+     */
+    onSessionExpired(listener: (event: CartSessionExpiredEvent) => void): () => void;
     /** Underlying cart client (for advanced flows / read-only helpers). */
     readonly cartClient: CartClient;
     /** Underlying cookie store (for advanced flows). */

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

@@ -1 +1 @@
-{"version":3,"file":"cart-recovery.d.ts","sourceRoot":"","sources":["../../../src/core/cart/cart-recovery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cart-recovery.d.ts","sourceRoot":"","sources":["../../../src/core/cart/cart-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAMrD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,kDAAmD,CAAC;AAE7F,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAQrF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAM3E;AAMD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,mCAAoC,CAAC;AAE1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAI7E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAMvE;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,sFAAsF;IACtF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM;CAK7C;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,GAAG,IAAI,MAAM,GAAG,IAAI,CAAC;IACrB,qFAAqF;IACrF,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,6EAA6E;IAC7E,KAAK,IAAI,IAAI,CAAC;CACf;AAMD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,4CAA4C;IAC5C,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAChF,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,MAAM,yBAAyB,GACjC,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,CAAC;AAExB;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,MAAM,EAAE,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM;CAMhF;AAaD,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,MAAM,EAAE,yBAAyB,CAAC;IAClC,4FAA4F;IAC5F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB;AAmCD,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACpC,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC9C;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC7D;AAOD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,IAAI,EAAE,8BAA8B,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,CAAC,CAAC,CAmFZ;AAMD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5D;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAChC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnE;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACjF,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;CACvC;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,kBAAkB,CAmFpB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,IACxC,YAAY,UAAU,KAAG,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAI5F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAC5C,UAAU,GAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAM,gBAZrB,UAAU,KAAG,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAe5F"}