@vtex/faststore 0.0.7 → 0.0.10

package/dist/sdk/cache/storefront-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"storefront-cache.js","names":[],"sources":["../../../src/sdk/cache/storefront-cache.ts"],"sourcesContent":["import { InMemoryCache, type InMemoryCacheConfig, type TypePolicies } from '@apollo/client';\nimport { possibleTypes } from '../generated/fragment-types.js';\n\n/**\n * Per-entity normalization and field-merge rules for the Storefront cache.\n *\n * Empty in T1. Domain entries (Product, Cart, OrderForm, …) arrive with the\n * particles that need them — see docs/storefront-core/reference-free-particle-model.md § Typed documents and the shared cache,\n * \"Out of Scope\".\n */\nexport const typePolicies: TypePolicies = {};\n\nexport { possibleTypes };\n\n/**\n * The single source of truth for InMemoryCache configuration. Both the\n * server-side `createClient` and the client-side `StorefrontProvider`\n * consume this so SSR and CSR normalize entities identically.\n */\nexport function getCacheConfig(): InMemoryCacheConfig {\n  return {\n    typePolicies,\n    possibleTypes,\n  };\n}\n\n/**\n * The only place an `InMemoryCache` is constructed on the server path.\n * The client-side provider builds its cache from `getCacheConfig()` so the\n * config is shared verbatim without coupling to a specific InMemoryCache\n * subclass (the Next.js integration ships its own SSR-aware variant).\n */\nexport function buildCache(): InMemoryCache {\n  return new InMemoryCache(getCacheConfig());\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,eAA6B,CAAC;;;;;;AAS3C,SAAgB,iBAAsC;CACpD,OAAO;EACL;EACA;CACF;AACF;;;;;;;AAQA,SAAgB,aAA4B;CAC1C,OAAO,IAAI,cAAc,eAAe,CAAC;AAC3C"}
+{"version":3,"file":"storefront-cache.js","names":[],"sources":["../../../src/sdk/cache/storefront-cache.ts"],"sourcesContent":["import { InMemoryCache, type InMemoryCacheConfig, type TypePolicies } from '@apollo/client';\nimport { possibleTypes } from '../generated/fragment-types.js';\n\n/**\n * Per-entity normalization and field-merge rules for the Storefront cache.\n *\n * The cart and the order share three types whose ids neither can scope\n * (docs/features/order-placed/rfc.md, 3.4): a totalizer's id is its category\n * (\"Items\"), which the cart's totalizer line selects by; an address's id is the\n * saved address itself, masked on the order and not on the cart; and a\n * customization's id is the assembly (\"Engraving\"), which two lines of one cart\n * already share. Normalized, one record would overwrite the other, so each is\n * stored inside the record that holds it, and replaced on every write: safe\n * while every fragment selects the same subfields of each.\n *\n * The lists that hold them are the server's whole answer, so each write\n * replaces the list (`merge: false`). Apollo does the same by default, but warns\n * that data may be lost whenever such a list shrinks, as when a discount line\n * leaves the cart's totalizers; a merge by id would keep that stale line.\n *\n * Other domain entries arrive with the particles that need them — see\n * docs/storefront-core/reference-free-particle-model.md § Typed documents and the shared cache.\n */\nconst replaceList = { merge: false } as const;\n\nexport const typePolicies: TypePolicies = {\n  CartTotalizer: { keyFields: false },\n  Address: { keyFields: false },\n  CartItemCustomization: { keyFields: false },\n  Cart: { fields: { totalizers: replaceList } },\n  CartItem: { fields: { customizations: replaceList } },\n  CartItemComposition: { fields: { customizations: replaceList } },\n  Shipping: { fields: { savedAddresses: replaceList } },\n  Order: { fields: { totals: replaceList } },\n  SellerOrder: { fields: { totals: replaceList } },\n  OrderItem: { fields: { customizations: replaceList } },\n  // A card network's id is the platform's payment-system id and is empty when a saved card has none,\n  // so two networks would collide on one entry. Each stays embedded in its own card.\n  CardNetwork: { keyFields: false },\n};\n\nexport { possibleTypes };\n\n/**\n * The single source of truth for InMemoryCache configuration. Both the\n * server-side `createClient` and the client-side `StorefrontProvider`\n * consume this so SSR and CSR normalize entities identically.\n */\nexport function getCacheConfig(): InMemoryCacheConfig {\n  return {\n    typePolicies,\n    possibleTypes,\n  };\n}\n\n/**\n * The only place an `InMemoryCache` is constructed on the server path.\n * The client-side provider builds its cache from `getCacheConfig()` so the\n * config is shared verbatim without coupling to a specific InMemoryCache\n * subclass (the Next.js integration ships its own SSR-aware variant).\n */\nexport function buildCache(): InMemoryCache {\n  return new InMemoryCache(getCacheConfig());\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAM,cAAc,EAAE,OAAO,MAAM;AAEnC,MAAa,eAA6B;CACxC,eAAe,EAAE,WAAW,MAAM;CAClC,SAAS,EAAE,WAAW,MAAM;CAC5B,uBAAuB,EAAE,WAAW,MAAM;CAC1C,MAAM,EAAE,QAAQ,EAAE,YAAY,YAAY,EAAE;CAC5C,UAAU,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CACpD,qBAAqB,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CAC/D,UAAU,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CACpD,OAAO,EAAE,QAAQ,EAAE,QAAQ,YAAY,EAAE;CACzC,aAAa,EAAE,QAAQ,EAAE,QAAQ,YAAY,EAAE;CAC/C,WAAW,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CAGrD,aAAa,EAAE,WAAW,MAAM;AAClC;;;;;;AASA,SAAgB,iBAAsC;CACpD,OAAO;EACL;EACA;CACF;AACF;;;;;;;AAQA,SAAgB,aAA4B;CAC1C,OAAO,IAAI,cAAc,eAAe,CAAC;AAC3C"}

package/dist/sdk/cart/operations.d.ts

@@ -1,4 +1,4 @@
-import { CartFragmentFragment, CartItemFragmentFragment, CartItemQuantityDecreaseMutation, CartItemQuantityIncreaseMutation, CartItemRemoveMutation, MoneyFragmentFragment } from "../generated/graphql.js";
+import { CartFragmentFragment, CartFreeShippingProgressFragmentFragment, CartItemFragmentFragment, CartItemQuantityDecreaseMutation, CartItemQuantityIncreaseMutation, CartItemRemoveMutation, MoneyFragmentFragment } from "../generated/graphql.js";
 import "./operations.js";
 import { TypedDocumentNode } from "@apollo/client";
 //#region src/sdk/cart/operations.d.ts
@@ -20,6 +20,7 @@ export type Money = MoneyFragmentFragment;
 export type CartItemEntity = CartItemFragmentFragment;
 export type CartEntity = CartFragmentFragment;
 export type CartTotalizer = CartFragmentFragment['totalizers'][number];
+export type CartFreeShippingProgress = CartFreeShippingProgressFragmentFragment['freeShippingProgress'];
 export type CartUserError = Readonly<{
   code: string;
   message: string;

package/dist/sdk/cart/operations.js

@@ -10,6 +10,7 @@ graphql(`
   fragment CartItemFragment on CartItem {
     __typename
     id
+    lineId
     quantity
     price {
       ...MoneyFragment
@@ -87,6 +88,36 @@ const CartFragment = graphql(`
       code
       isUnmatchedCondition
     }
+    discounts {
+      name
+      value {
+        ...MoneyFragment
+      }
+      kind
+    }
+    salesChannelMismatch {
+      cartSalesChannel
+      activeSalesChannel
+    }
+  }
+`);
+/**
+* The free-shipping progress slice of a cart. The four line writes and the coupon removal spread it, and
+* the shipping address update selects it inline. On the coupon removal the server answers it with an
+* extra order-form read; on the address update it costs nothing upstream. It stays out of `CartFragment`
+* (which every cart write and the page read of the cart share).
+*/
+const CartFreeShippingProgressFragment = graphql(`
+  fragment CartFreeShippingProgressFragment on Cart {
+    freeShippingProgress {
+      threshold {
+        ...MoneyFragment
+      }
+      remaining {
+        ...MoneyFragment
+      }
+      qualified
+    }
   }
 `);
 const CART_ITEM_ADD = graphql(`
@@ -109,6 +140,7 @@ const CART_ITEM_REMOVE = graphql(`
       __typename
       cart {
         ...CartFragment
+        ...CartFreeShippingProgressFragment
       }
       userErrors {
         code
@@ -123,6 +155,7 @@ const CART_ITEMS_REMOVE = graphql(`
       __typename
       cart {
         ...CartFragment
+        ...CartFreeShippingProgressFragment
       }
       userErrors {
         code
@@ -137,6 +170,7 @@ const CART_ITEM_QUANTITY_INCREASE = graphql(`
       __typename
       cart {
         ...CartFragment
+        ...CartFreeShippingProgressFragment
       }
       userErrors {
         code
@@ -151,6 +185,7 @@ const CART_ITEM_QUANTITY_DECREASE = graphql(`
       __typename
       cart {
         ...CartFragment
+        ...CartFreeShippingProgressFragment
       }
       userErrors {
         code
@@ -179,6 +214,7 @@ const CART_COUPON_REMOVE = graphql(`
       __typename
       cart {
         ...CartFragment
+        ...CartFreeShippingProgressFragment
       }
       userErrors {
         code
@@ -209,7 +245,25 @@ const CART_VALIDATE = graphql(`
     }
   }
 `);
+/**
+* Move the active cart onto the request's sales channel and reconcile its locale. No variables —
+* the channel is the request's. No optimistic response: Checkout decides which lines remain.
+*/
+const CART_SALES_CHANNEL_SYNC = graphql(`
+  mutation CartSalesChannelSync {
+    cartSalesChannelSync {
+      __typename
+      cart {
+        ...CartFragment
+      }
+      userErrors {
+        code
+        message
+      }
+    }
+  }
+`);
 //#endregion
-export { CART_COUPON_APPLY, CART_COUPON_REMOVE, CART_ITEMS_REMOVE, CART_ITEM_ADD, CART_ITEM_QUANTITY_DECREASE, CART_ITEM_QUANTITY_INCREASE, CART_ITEM_REMOVE, CART_VALIDATE, CartFragment };
+export { CART_COUPON_APPLY, CART_COUPON_REMOVE, CART_ITEMS_REMOVE, CART_ITEM_ADD, CART_ITEM_QUANTITY_DECREASE, CART_ITEM_QUANTITY_INCREASE, CART_ITEM_REMOVE, CART_SALES_CHANNEL_SYNC, CART_VALIDATE, CartFragment, CartFreeShippingProgressFragment };
 
 //# sourceMappingURL=operations.js.map

package/dist/sdk/cart/operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"operations.js","names":[],"sources":["../../../src/sdk/cart/operations.ts"],"sourcesContent":["import type { TypedDocumentNode } from '@apollo/client';\nimport { graphql } from '../generated/gql.js';\nimport type {\n  CartCouponApplyMutation,\n  CartCouponApplyMutationVariables,\n  CartCouponRemoveMutation,\n  CartCouponRemoveMutationVariables,\n  CartFragmentFragment,\n  CartItemAddMutation,\n  CartItemAddMutationVariables,\n  CartItemFragmentFragment,\n  CartItemQuantityDecreaseMutation,\n  CartItemQuantityDecreaseMutationVariables,\n  CartItemQuantityIncreaseMutation,\n  CartItemQuantityIncreaseMutationVariables,\n  CartItemRemoveMutation,\n  CartItemRemoveMutationVariables,\n  CartItemsRemoveMutation,\n  CartItemsRemoveMutationVariables,\n  CartValidateMutation,\n  CartValidateMutationVariables,\n  MoneyFragmentFragment,\n} from '../generated/graphql.js';\n\n/**\n * Cart-related GraphQL operations and shared fragments (T6 / mutation-contract.md (archived at the specs-archive tag)).\n *\n * The `CartFragment` is the canonical Cart selection set: every mutation operation spreads it so\n * the cache normalisation reaches every reactive subscriber (CartTotal, CartCount, CartItems, …)\n * through a single response. The contract regression test (`contract.test.ts`) parses these\n * documents and asserts the spread is present — see mutation-contract.md (archived at the specs-archive tag).\n *\n * T7 ([Typed documents and the shared cache][T7]) routes the domain types and the operation factory\n * through @graphql-codegen. Public type names (`CartEntity`, `CartItemEntity`, `Money`, payload\n * + input aliases) are preserved as re-exports / aliases so consumer call sites do not change.\n *\n * [T7]: ../../../../../docs/storefront-core/reference-free-particle-model.md#typed-documents-and-the-shared-cache\n */\n\n// ---------------------------------------------------------------------------\n// Domain type aliases — re-exports from codegen artifacts (T7)\n// ---------------------------------------------------------------------------\n\nexport type Money = MoneyFragmentFragment;\nexport type CartItemEntity = CartItemFragmentFragment;\nexport type CartEntity = CartFragmentFragment;\nexport type CartTotalizer = CartFragmentFragment['totalizers'][number];\nexport type CartMessage = CartFragmentFragment['messages'][number];\nexport type AppliedCoupon = CartFragmentFragment['appliedCoupons'][number];\n\nexport type CartUserError = Readonly<{ code: string; message: string }>;\n\n// ---------------------------------------------------------------------------\n// Mutation input types — direct re-exports from codegen\n// ---------------------------------------------------------------------------\n\nexport type {\n  CartCouponApplyInput,\n  CartCouponRemoveInput,\n  CartItemAddInput,\n  CartItemQuantityDecreaseInput,\n  CartItemQuantityIncreaseInput,\n  CartItemRemoveInput,\n  CartItemsRemoveInput,\n} from '../generated/graphql.js';\n\n// ---------------------------------------------------------------------------\n// Mutation payload types — derived from operation result types\n// ---------------------------------------------------------------------------\n\nexport type CartItemAddPayload = CartItemAddMutation['cartItemAdd'];\nexport type CartItemRemovePayload = CartItemRemoveMutation['cartItemRemove'];\nexport type CartItemsRemovePayload = CartItemsRemoveMutation['cartItemsRemove'];\nexport type CartItemQuantityIncreasePayload = CartItemQuantityIncreaseMutation['cartItemQuantityIncrease'];\nexport type CartItemQuantityDecreasePayload = CartItemQuantityDecreaseMutation['cartItemQuantityDecrease'];\nexport type CartCouponApplyPayload = CartCouponApplyMutation['cartCouponApply'];\nexport type CartCouponRemovePayload = CartCouponRemoveMutation['cartCouponRemove'];\nexport type CartValidatePayload = CartValidateMutation['cartValidate'];\n\n// ---------------------------------------------------------------------------\n// Shared fragments — authored via the codegen `graphql()` factory so codegen can scan and type\n// every operation that spreads them.\n// ---------------------------------------------------------------------------\n\nexport const MoneyFragment: TypedDocumentNode<MoneyFragmentFragment, never> = graphql(`\n  fragment MoneyFragment on Money {\n    __typename\n    amount\n    currencyCode\n  }\n`);\n\nexport const CartItemFragment: TypedDocumentNode<CartItemFragmentFragment, never> = graphql(`\n  fragment CartItemFragment on CartItem {\n    __typename\n    id\n    quantity\n    price {\n      ...MoneyFragment\n    }\n    listPrice {\n      ...MoneyFragment\n    }\n    sellingPrice {\n      ...MoneyFragment\n    }\n    gift\n    ownTotal {\n      ...MoneyFragment\n    }\n    total {\n      ...MoneyFragment\n    }\n    variant {\n      __typename\n      variantId\n      sku\n      name\n      image {\n        url\n        altText\n      }\n      availability\n    }\n    product {\n      __typename\n      productId\n      title\n      detailUrl\n      categories {\n        categoryId\n        name\n      }\n      brand {\n        brandId\n        name\n      }\n    }\n  }\n`);\n\n/**\n * Canonical Cart selection set. Every cart mutation MUST spread this fragment so the cache\n * receives the entity slices that all subscribers depend on (id + items + totalizers + total +\n * messages). The regression test in contract.test.ts enforces this.\n */\nexport const CartFragment: TypedDocumentNode<CartFragmentFragment, never> = graphql(`\n  fragment CartFragment on Cart {\n    __typename\n    id\n    items {\n      ...CartItemFragment\n    }\n    totalizers {\n      __typename\n      id\n      name\n      value {\n        ...MoneyFragment\n      }\n    }\n    total {\n      ...MoneyFragment\n    }\n    messages {\n      __typename\n      code\n      text\n      status\n    }\n    appliedCoupons {\n      code\n      isUnmatchedCondition\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Mutation operations — authored via `graphql()`, typed via the codegen-derived\n// TypedDocumentNode generic so Apollo's `useMutation` infers TData / TVariables correctly.\n// ---------------------------------------------------------------------------\n\nexport const CART_ITEM_ADD: TypedDocumentNode<CartItemAddMutation, CartItemAddMutationVariables> = graphql(`\n  mutation CartItemAdd($input: CartItemAddInput!) {\n    cartItemAdd(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_ITEM_REMOVE: TypedDocumentNode<CartItemRemoveMutation, CartItemRemoveMutationVariables> = graphql(`\n  mutation CartItemRemove($input: CartItemRemoveInput!) {\n    cartItemRemove(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_ITEMS_REMOVE: TypedDocumentNode<CartItemsRemoveMutation, CartItemsRemoveMutationVariables> = graphql(`\n  mutation CartItemsRemove($input: CartItemsRemoveInput!) {\n    cartItemsRemove(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_ITEM_QUANTITY_INCREASE: TypedDocumentNode<\n  CartItemQuantityIncreaseMutation,\n  CartItemQuantityIncreaseMutationVariables\n> = graphql(`\n  mutation CartItemQuantityIncrease($input: CartItemQuantityIncreaseInput!) {\n    cartItemQuantityIncrease(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_ITEM_QUANTITY_DECREASE: TypedDocumentNode<\n  CartItemQuantityDecreaseMutation,\n  CartItemQuantityDecreaseMutationVariables\n> = graphql(`\n  mutation CartItemQuantityDecrease($input: CartItemQuantityDecreaseInput!) {\n    cartItemQuantityDecrease(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_COUPON_APPLY: TypedDocumentNode<CartCouponApplyMutation, CartCouponApplyMutationVariables> = graphql(`\n  mutation CartCouponApply($input: CartCouponApplyInput!) {\n    cartCouponApply(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_COUPON_REMOVE: TypedDocumentNode<CartCouponRemoveMutation, CartCouponRemoveMutationVariables> =\n  graphql(`\n  mutation CartCouponRemove($input: CartCouponRemoveInput!) {\n    cartCouponRemove(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\n/**\n * Re-check the active cart against the platform and adopt corrected availability. Read-only upstream\n * (docs/storefront-api-core/CONTEXT.md § Language, Cart Validation): the payload is the cart with each line's\n * `variant.availability` refreshed, shaped like every other cart mutation so the correction lands in\n * the normalized cache. Takes no arguments — the cart resolves from the request context. Spreading\n * `CartFragment` is what makes the guard, the per-line alert, and the badge re-render as subscribers,\n * so T13 needs no fragment or codegen change beyond registering this document.\n */\nexport const CART_VALIDATE: TypedDocumentNode<CartValidateMutation, CartValidateMutationVariables> = graphql(`\n  mutation CartValidate {\n    cartValidate {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\n/**\n * Canonical list of cart mutation documents. Used by the contract regression test to iterate\n * over every shipped operation without hard-coding names.\n */\nexport const CART_MUTATIONS = [\n  { name: 'CartItemAdd', document: CART_ITEM_ADD },\n  { name: 'CartItemRemove', document: CART_ITEM_REMOVE },\n  { name: 'CartItemsRemove', document: CART_ITEMS_REMOVE },\n  { name: 'CartItemQuantityIncrease', document: CART_ITEM_QUANTITY_INCREASE },\n  { name: 'CartItemQuantityDecrease', document: CART_ITEM_QUANTITY_DECREASE },\n  { name: 'CartCouponApply', document: CART_COUPON_APPLY },\n  { name: 'CartCouponRemove', document: CART_COUPON_REMOVE },\n  { name: 'CartValidate', document: CART_VALIDATE },\n] as const;\n"],"mappings":";AAoF8E,QAAQ;;;;;;CAMrF;AAEmF,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+C3F;;;;;;AAOD,MAAa,eAA+D,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BnF;AAOD,MAAa,gBAAsF,QAAQ;;;;;;;;;;;;;CAa1G;AAED,MAAa,mBAA+F,QAAQ;;;;;;;;;;;;;CAanH;AAED,MAAa,oBAAkG,QAAQ;;;;;;;;;;;;;CAatH;AAED,MAAa,8BAGT,QAAQ;;;;;;;;;;;;;CAaX;AAED,MAAa,8BAGT,QAAQ;;;;;;;;;;;;;CAaX;AAED,MAAa,oBAAkG,QAAQ;;;;;;;;;;;;;CAatH;AAED,MAAa,qBACX,QAAQ;;;;;;;;;;;;;CAaT;;;;;;;;;AAUD,MAAa,gBAAwF,QAAQ;;;;;;;;;;;;;CAa5G"}
+{"version":3,"file":"operations.js","names":[],"sources":["../../../src/sdk/cart/operations.ts"],"sourcesContent":["import type { TypedDocumentNode } from '@apollo/client';\nimport { graphql } from '../generated/gql.js';\nimport type {\n  CartCouponApplyMutation,\n  CartCouponApplyMutationVariables,\n  CartCouponRemoveMutation,\n  CartCouponRemoveMutationVariables,\n  CartFragmentFragment,\n  CartFreeShippingProgressFragmentFragment,\n  CartItemAddMutation,\n  CartItemAddMutationVariables,\n  CartItemFragmentFragment,\n  CartItemQuantityDecreaseMutation,\n  CartItemQuantityDecreaseMutationVariables,\n  CartItemQuantityIncreaseMutation,\n  CartItemQuantityIncreaseMutationVariables,\n  CartItemRemoveMutation,\n  CartItemRemoveMutationVariables,\n  CartItemsRemoveMutation,\n  CartItemsRemoveMutationVariables,\n  CartSalesChannelSyncMutation,\n  CartSalesChannelSyncMutationVariables,\n  CartValidateMutation,\n  CartValidateMutationVariables,\n  MoneyFragmentFragment,\n} from '../generated/graphql.js';\n\n/**\n * Cart-related GraphQL operations and shared fragments (T6 / mutation-contract.md (archived at the specs-archive tag)).\n *\n * The `CartFragment` is the canonical Cart selection set: every mutation operation spreads it so\n * the cache normalisation reaches every reactive subscriber (CartTotal, CartCount, CartItems, …)\n * through a single response. The contract regression test (`contract.test.ts`) parses these\n * documents and asserts the spread is present — see mutation-contract.md (archived at the specs-archive tag).\n *\n * T7 ([Typed documents and the shared cache][T7]) routes the domain types and the operation factory\n * through @graphql-codegen. Public type names (`CartEntity`, `CartItemEntity`, `Money`, payload\n * + input aliases) are preserved as re-exports / aliases so consumer call sites do not change.\n *\n * [T7]: ../../../../../docs/storefront-core/reference-free-particle-model.md#typed-documents-and-the-shared-cache\n */\n\n// ---------------------------------------------------------------------------\n// Domain type aliases — re-exports from codegen artifacts (T7)\n// ---------------------------------------------------------------------------\n\nexport type Money = MoneyFragmentFragment;\nexport type CartItemEntity = CartItemFragmentFragment;\nexport type CartEntity = CartFragmentFragment;\nexport type CartTotalizer = CartFragmentFragment['totalizers'][number];\nexport type CartMessage = CartFragmentFragment['messages'][number];\nexport type AppliedCoupon = CartFragmentFragment['appliedCoupons'][number];\nexport type CartDiscount = CartFragmentFragment['discounts'][number];\nexport type CartFreeShippingProgress = CartFreeShippingProgressFragmentFragment['freeShippingProgress'];\n\nexport type CartUserError = Readonly<{ code: string; message: string }>;\n\n// ---------------------------------------------------------------------------\n// Mutation input types — direct re-exports from codegen\n// ---------------------------------------------------------------------------\n\nexport type {\n  CartCouponApplyInput,\n  CartCouponRemoveInput,\n  CartItemAddInput,\n  CartItemQuantityDecreaseInput,\n  CartItemQuantityIncreaseInput,\n  CartItemRemoveInput,\n  CartItemsRemoveInput,\n} from '../generated/graphql.js';\n\n// ---------------------------------------------------------------------------\n// Mutation payload types — derived from operation result types\n// ---------------------------------------------------------------------------\n\nexport type CartItemAddPayload = CartItemAddMutation['cartItemAdd'];\nexport type CartItemRemovePayload = CartItemRemoveMutation['cartItemRemove'];\nexport type CartItemsRemovePayload = CartItemsRemoveMutation['cartItemsRemove'];\nexport type CartItemQuantityIncreasePayload = CartItemQuantityIncreaseMutation['cartItemQuantityIncrease'];\nexport type CartItemQuantityDecreasePayload = CartItemQuantityDecreaseMutation['cartItemQuantityDecrease'];\nexport type CartCouponApplyPayload = CartCouponApplyMutation['cartCouponApply'];\nexport type CartCouponRemovePayload = CartCouponRemoveMutation['cartCouponRemove'];\nexport type CartValidatePayload = CartValidateMutation['cartValidate'];\nexport type CartSalesChannelSyncPayload = CartSalesChannelSyncMutation['cartSalesChannelSync'];\n\n// ---------------------------------------------------------------------------\n// Shared fragments — authored via the codegen `graphql()` factory so codegen can scan and type\n// every operation that spreads them.\n// ---------------------------------------------------------------------------\n\nexport const MoneyFragment: TypedDocumentNode<MoneyFragmentFragment, never> = graphql(`\n  fragment MoneyFragment on Money {\n    __typename\n    amount\n    currencyCode\n  }\n`);\n\nexport const CartItemFragment: TypedDocumentNode<CartItemFragmentFragment, never> = graphql(`\n  fragment CartItemFragment on CartItem {\n    __typename\n    id\n    lineId\n    quantity\n    price {\n      ...MoneyFragment\n    }\n    listPrice {\n      ...MoneyFragment\n    }\n    sellingPrice {\n      ...MoneyFragment\n    }\n    gift\n    ownTotal {\n      ...MoneyFragment\n    }\n    total {\n      ...MoneyFragment\n    }\n    variant {\n      __typename\n      variantId\n      sku\n      name\n      image {\n        url\n        altText\n      }\n      availability\n    }\n    product {\n      __typename\n      productId\n      title\n      detailUrl\n      categories {\n        categoryId\n        name\n      }\n      brand {\n        brandId\n        name\n      }\n    }\n  }\n`);\n\n/**\n * Canonical Cart selection set. Every cart mutation MUST spread this fragment so the cache\n * receives the entity slices that all subscribers depend on (id + items + totalizers + total +\n * messages). The regression test in contract.test.ts enforces this.\n */\nexport const CartFragment: TypedDocumentNode<CartFragmentFragment, never> = graphql(`\n  fragment CartFragment on Cart {\n    __typename\n    id\n    items {\n      ...CartItemFragment\n    }\n    totalizers {\n      __typename\n      id\n      name\n      value {\n        ...MoneyFragment\n      }\n    }\n    total {\n      ...MoneyFragment\n    }\n    messages {\n      __typename\n      code\n      text\n      status\n    }\n    appliedCoupons {\n      code\n      isUnmatchedCondition\n    }\n    discounts {\n      name\n      value {\n        ...MoneyFragment\n      }\n      kind\n    }\n    salesChannelMismatch {\n      cartSalesChannel\n      activeSalesChannel\n    }\n  }\n`);\n\n/**\n * The free-shipping progress slice of a cart. The four line writes and the coupon removal spread it, and\n * the shipping address update selects it inline. On the coupon removal the server answers it with an\n * extra order-form read; on the address update it costs nothing upstream. It stays out of `CartFragment`\n * (which every cart write and the page read of the cart share).\n */\nexport const CartFreeShippingProgressFragment: TypedDocumentNode<CartFreeShippingProgressFragmentFragment, never> =\n  graphql(`\n  fragment CartFreeShippingProgressFragment on Cart {\n    freeShippingProgress {\n      threshold {\n        ...MoneyFragment\n      }\n      remaining {\n        ...MoneyFragment\n      }\n      qualified\n    }\n  }\n`);\n\n// ---------------------------------------------------------------------------\n// Mutation operations — authored via `graphql()`, typed via the codegen-derived\n// TypedDocumentNode generic so Apollo's `useMutation` infers TData / TVariables correctly.\n// ---------------------------------------------------------------------------\n\nexport const CART_ITEM_ADD: TypedDocumentNode<CartItemAddMutation, CartItemAddMutationVariables> = graphql(`\n  mutation CartItemAdd($input: CartItemAddInput!) {\n    cartItemAdd(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_ITEM_REMOVE: TypedDocumentNode<CartItemRemoveMutation, CartItemRemoveMutationVariables> = graphql(`\n  mutation CartItemRemove($input: CartItemRemoveInput!) {\n    cartItemRemove(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n        ...CartFreeShippingProgressFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_ITEMS_REMOVE: TypedDocumentNode<CartItemsRemoveMutation, CartItemsRemoveMutationVariables> = graphql(`\n  mutation CartItemsRemove($input: CartItemsRemoveInput!) {\n    cartItemsRemove(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n        ...CartFreeShippingProgressFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_ITEM_QUANTITY_INCREASE: TypedDocumentNode<\n  CartItemQuantityIncreaseMutation,\n  CartItemQuantityIncreaseMutationVariables\n> = graphql(`\n  mutation CartItemQuantityIncrease($input: CartItemQuantityIncreaseInput!) {\n    cartItemQuantityIncrease(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n        ...CartFreeShippingProgressFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_ITEM_QUANTITY_DECREASE: TypedDocumentNode<\n  CartItemQuantityDecreaseMutation,\n  CartItemQuantityDecreaseMutationVariables\n> = graphql(`\n  mutation CartItemQuantityDecrease($input: CartItemQuantityDecreaseInput!) {\n    cartItemQuantityDecrease(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n        ...CartFreeShippingProgressFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_COUPON_APPLY: TypedDocumentNode<CartCouponApplyMutation, CartCouponApplyMutationVariables> = graphql(`\n  mutation CartCouponApply($input: CartCouponApplyInput!) {\n    cartCouponApply(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\nexport const CART_COUPON_REMOVE: TypedDocumentNode<CartCouponRemoveMutation, CartCouponRemoveMutationVariables> =\n  graphql(`\n  mutation CartCouponRemove($input: CartCouponRemoveInput!) {\n    cartCouponRemove(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n        ...CartFreeShippingProgressFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\n/**\n * Re-check the active cart against the platform and adopt corrected availability. Read-only upstream\n * (docs/storefront-api-core/CONTEXT.md § Language, Cart Validation): the payload is the cart with each line's\n * `variant.availability` refreshed, shaped like every other cart mutation so the correction lands in\n * the normalized cache. Takes no arguments — the cart resolves from the request context. Spreading\n * `CartFragment` is what makes the guard, the per-line alert, and the badge re-render as subscribers,\n * so T13 needs no fragment or codegen change beyond registering this document.\n */\nexport const CART_VALIDATE: TypedDocumentNode<CartValidateMutation, CartValidateMutationVariables> = graphql(`\n  mutation CartValidate {\n    cartValidate {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\n/**\n * Move the active cart onto the request's sales channel and reconcile its locale. No variables —\n * the channel is the request's. No optimistic response: Checkout decides which lines remain.\n */\nexport const CART_SALES_CHANNEL_SYNC: TypedDocumentNode<\n  CartSalesChannelSyncMutation,\n  CartSalesChannelSyncMutationVariables\n> = graphql(`\n  mutation CartSalesChannelSync {\n    cartSalesChannelSync {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n`);\n\n/**\n * Canonical list of cart mutation documents. Used by the contract regression test to iterate\n * over every shipped operation without hard-coding names.\n */\nexport const CART_MUTATIONS = [\n  { name: 'CartItemAdd', document: CART_ITEM_ADD },\n  { name: 'CartItemRemove', document: CART_ITEM_REMOVE },\n  { name: 'CartItemsRemove', document: CART_ITEMS_REMOVE },\n  { name: 'CartItemQuantityIncrease', document: CART_ITEM_QUANTITY_INCREASE },\n  { name: 'CartItemQuantityDecrease', document: CART_ITEM_QUANTITY_DECREASE },\n  { name: 'CartCouponApply', document: CART_COUPON_APPLY },\n  { name: 'CartCouponRemove', document: CART_COUPON_REMOVE },\n  { name: 'CartValidate', document: CART_VALIDATE },\n  { name: 'CartSalesChannelSync', document: CART_SALES_CHANNEL_SYNC },\n] as const;\n"],"mappings":";AA0F8E,QAAQ;;;;;;CAMrF;AAEmF,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgD3F;;;;;;AAOD,MAAa,eAA+D,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCnF;;;;;;;AAQD,MAAa,mCACX,QAAQ;;;;;;;;;;;;CAYT;AAOD,MAAa,gBAAsF,QAAQ;;;;;;;;;;;;;CAa1G;AAED,MAAa,mBAA+F,QAAQ;;;;;;;;;;;;;;CAcnH;AAED,MAAa,oBAAkG,QAAQ;;;;;;;;;;;;;;CActH;AAED,MAAa,8BAGT,QAAQ;;;;;;;;;;;;;;CAcX;AAED,MAAa,8BAGT,QAAQ;;;;;;;;;;;;;;CAcX;AAED,MAAa,oBAAkG,QAAQ;;;;;;;;;;;;;CAatH;AAED,MAAa,qBACX,QAAQ;;;;;;;;;;;;;;CAcT;;;;;;;;;AAUD,MAAa,gBAAwF,QAAQ;;;;;;;;;;;;;CAa5G;;;;;AAMD,MAAa,0BAGT,QAAQ;;;;;;;;;;;;;CAaX"}

package/dist/sdk/cart/optimistic.d.ts

@@ -1,23 +1,46 @@
-import { CartEntity, CartItemEntity, CartItemQuantityDecreasePayload, CartItemQuantityIncreasePayload, CartItemRemovePayload } from "./operations.js";
+import { CartEntity, CartFreeShippingProgress, CartItemEntity, CartItemQuantityDecreasePayload, CartItemQuantityIncreasePayload, CartItemRemovePayload } from "./operations.js";
 //#region src/sdk/cart/optimistic.d.ts
 /**
- * Predicts the cart after `cartItemQuantityIncrease(input: { variantId, quantityToAdd })`.
+ * Pure optimistic-response builders for the three cache-propagating cart mutations
+ * (mutation-contract.md (archived at the specs-archive tag)).
+ *
+ * Each builder takes the current `CartEntity` and the affected `CartItemEntity` and returns the
+ * predicted post-mutation `Cart` carrying every field the canonical `CartFragment` selects:
+ * `id`, `items`, `totalizers`, `total`. The shape MUST match Apollo's normalised cache slot for
+ * the entity, so `__typename` and the same `id` are preserved.
+ *
+ * Lines are matched by their opaque `id` (Base64("CartItem:<orderFormId>:<uniqueId>")).
+ *
+ * Recomputation rules (kept simple — server reconciles drift on response):
+ *   - `Items` totalizer (matched by `id === 'Items'`) is adjusted by `item.sellingPrice * delta`.
+ *   - `total` (the cart's grand total) is adjusted by the same delta.
+ *   - All other totalizers (Shipping, Discounts, …) stay as-is until the server response lands.
+ *   - `freeShippingProgress` (the four line writes select it) keeps its last known value, except that a
+ *     qualified value, whose threshold is unknown, becomes `null` when the predicted `Items` total
+ *     drops, and an emptied cart carries `null`; the server's answer replaces it.
+ */
+/** The cart the builders read: the canonical entity plus the free-shipping slice the line writes select. */
+type CartWithProgress = CartEntity & {
+  freeShippingProgress?: CartFreeShippingProgress | null;
+};
+/**
+ * Predicts the cart after `cartItemQuantityIncrease(input: { lineId, quantityToAdd })`.
  */
-export declare function buildOptimisticIncrease(cart: CartEntity, item: CartItemEntity, by?: number): {
+export declare function buildOptimisticIncrease(cart: CartWithProgress, item: CartItemEntity, by?: number): {
   cartItemQuantityIncrease: CartItemQuantityIncreasePayload;
 };
 /**
- * Predicts the cart after `cartItemQuantityDecrease(input: { variantId, quantityToRemove })`.
+ * Predicts the cart after `cartItemQuantityDecrease(input: { lineId, quantityToRemove })`.
  *
  * If the resulting quantity would be `<= 0`, the line is removed entirely.
  */
-export declare function buildOptimisticDecrease(cart: CartEntity, item: CartItemEntity, by?: number): {
+export declare function buildOptimisticDecrease(cart: CartWithProgress, item: CartItemEntity, by?: number): {
   cartItemQuantityDecrease: CartItemQuantityDecreasePayload;
 };
 /**
- * Predicts the cart after `cartItemRemove(input: { variantId })`.
+ * Predicts the cart after `cartItemRemove(input: { lineId })`.
  */
-export declare function buildOptimisticRemove(cart: CartEntity, item: CartItemEntity): {
+export declare function buildOptimisticRemove(cart: CartWithProgress, item: CartItemEntity): {
   cartItemRemove: CartItemRemovePayload;
 };
 //#endregion

package/dist/sdk/cart/optimistic.js

@@ -1,24 +1,8 @@
 //#region src/sdk/cart/optimistic.ts
-/**
-* Pure optimistic-response builders for the three cache-propagating cart mutations
-* (mutation-contract.md (archived at the specs-archive tag)).
-*
-* Each builder takes the current `CartEntity` and the affected `CartItemEntity` and returns the
-* predicted post-mutation `Cart` carrying every field the canonical `CartFragment` selects:
-* `id`, `items`, `totalizers`, `total`. The shape MUST match Apollo's normalised cache slot for
-* the entity, so `__typename` and the same `id` are preserved.
-*
-* Lines are matched by their opaque `id` (Base64("CartItem:<orderFormId>:<uniqueId>")).
-*
-* Recomputation rules (kept simple — server reconciles drift on response):
-*   - `Items` totalizer (matched by `id === 'Items'`) is adjusted by `item.sellingPrice * delta`.
-*   - `total` (the cart's grand total) is adjusted by the same delta.
-*   - All other totalizers (Shipping, Discounts, …) stay as-is until the server response lands.
-*/
 function moneyAdd(money, delta) {
 	return {
 		__typename: "Money",
-		amount: Number(money.amount) + delta,
+		amount: (Number(money.amount) + delta).toFixed(2),
 		currencyCode: money.currencyCode
 	};
 }
@@ -28,110 +12,155 @@ function adjustItemsTotalizer(totalizers, delta) {
 		value: moneyAdd(t.value, delta)
 	} : t);
 }
+function itemsAmount(totalizers) {
+	return Number(totalizers.find((t) => t.id === "Items")?.value.amount ?? 0);
+}
+/**
+* The `freeShippingProgress` the predicted cart carries. A qualified value has no threshold (the
+* promotion teaser is gone once met), so the client cannot tell "still above the goal" from "below"
+* after a drop: it hides the field until the server answers rather than claim a state it cannot know.
+*/
+function predictProgress(cart, predictedItems, predictedTotalizers) {
+	const current = cart.freeShippingProgress ?? null;
+	if (current === null || predictedItems.length === 0) return null;
+	if (!current.qualified) return current;
+	const before = itemsAmount(cart.totalizers);
+	const after = itemsAmount(predictedTotalizers);
+	if (!Number.isFinite(before) || !Number.isFinite(after) || after < before) return null;
+	return current;
+}
 function emptyUserErrors() {
 	return [];
 }
 /**
-* Predicts the cart after `cartItemQuantityIncrease(input: { variantId, quantityToAdd })`.
+* Predicts the cart after `cartItemQuantityIncrease(input: { lineId, quantityToAdd })`.
 */
 function buildOptimisticIncrease(cart, item, by = 1) {
 	if (by <= 0) return { cartItemQuantityIncrease: {
 		__typename: "CartItemQuantityIncreasePayload",
-		cart,
+		cart: {
+			...cart,
+			freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers)
+		},
 		userErrors: emptyUserErrors()
 	} };
 	const currentItem = cart.items.find((i) => i.id === item.id);
 	if (!currentItem) return { cartItemQuantityIncrease: {
 		__typename: "CartItemQuantityIncreasePayload",
-		cart,
+		cart: {
+			...cart,
+			freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers)
+		},
 		userErrors: emptyUserErrors()
 	} };
 	const newQuantity = currentItem.quantity + by;
-	const delta = currentItem.sellingPrice.amount * by;
+	const delta = Number(currentItem.sellingPrice.amount) * by;
 	const updatedItems = cart.items.map((i) => i.id === item.id ? {
 		...i,
 		quantity: newQuantity
 	} : i);
+	const totalizers = adjustItemsTotalizer(cart.totalizers, delta);
 	return { cartItemQuantityIncrease: {
 		__typename: "CartItemQuantityIncreasePayload",
 		cart: {
 			__typename: "Cart",
 			id: cart.id,
 			items: updatedItems,
-			totalizers: adjustItemsTotalizer(cart.totalizers, delta),
+			totalizers,
 			total: moneyAdd(cart.total, delta),
 			messages: cart.messages,
-			appliedCoupons: cart.appliedCoupons
+			appliedCoupons: cart.appliedCoupons,
+			discounts: cart.discounts,
+			freeShippingProgress: predictProgress(cart, updatedItems, totalizers),
+			salesChannelMismatch: cart.salesChannelMismatch
 		},
 		userErrors: emptyUserErrors()
 	} };
 }
 /**
-* Predicts the cart after `cartItemQuantityDecrease(input: { variantId, quantityToRemove })`.
+* Predicts the cart after `cartItemQuantityDecrease(input: { lineId, quantityToRemove })`.
 *
 * If the resulting quantity would be `<= 0`, the line is removed entirely.
 */
 function buildOptimisticDecrease(cart, item, by = 1) {
 	if (by <= 0) return { cartItemQuantityDecrease: {
 		__typename: "CartItemQuantityDecreasePayload",
-		cart,
+		cart: {
+			...cart,
+			freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers)
+		},
 		userErrors: emptyUserErrors()
 	} };
 	const currentItem = cart.items.find((i) => i.id === item.id);
 	if (!currentItem) return { cartItemQuantityDecrease: {
 		__typename: "CartItemQuantityDecreasePayload",
-		cart,
+		cart: {
+			...cart,
+			freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers)
+		},
 		userErrors: emptyUserErrors()
 	} };
 	const requestedQuantity = currentItem.quantity - by;
 	const removed = requestedQuantity <= 0;
 	const actualDelta = removed ? currentItem.quantity : by;
-	const priceDelta = -currentItem.sellingPrice.amount * actualDelta;
+	const priceDelta = -Number(currentItem.sellingPrice.amount) * actualDelta;
 	const updatedItems = removed ? cart.items.filter((i) => i.id !== item.id) : cart.items.map((i) => i.id === item.id ? {
 		...i,
 		quantity: requestedQuantity
 	} : i);
+	const totalizers = adjustItemsTotalizer(cart.totalizers, priceDelta);
 	return { cartItemQuantityDecrease: {
 		__typename: "CartItemQuantityDecreasePayload",
 		cart: {
 			__typename: "Cart",
 			id: cart.id,
 			items: updatedItems,
-			totalizers: adjustItemsTotalizer(cart.totalizers, priceDelta),
+			totalizers,
 			total: moneyAdd(cart.total, priceDelta),
 			messages: cart.messages,
-			appliedCoupons: cart.appliedCoupons
+			appliedCoupons: cart.appliedCoupons,
+			discounts: cart.discounts,
+			freeShippingProgress: predictProgress(cart, updatedItems, totalizers),
+			salesChannelMismatch: cart.salesChannelMismatch
 		},
 		userErrors: emptyUserErrors()
 	} };
 }
 /**
-* Predicts the cart after `cartItemRemove(input: { variantId })`.
+* Predicts the cart after `cartItemRemove(input: { lineId })`.
 */
 function buildOptimisticRemove(cart, item) {
 	const currentItem = cart.items.find((i) => i.id === item.id);
 	if (!currentItem) return { cartItemRemove: {
 		__typename: "CartItemRemovePayload",
-		cart,
+		cart: {
+			...cart,
+			freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers)
+		},
 		userErrors: emptyUserErrors()
 	} };
-	const priceDelta = -currentItem.sellingPrice.amount * currentItem.quantity;
+	const priceDelta = -Number(currentItem.sellingPrice.amount) * currentItem.quantity;
+	const remainingItems = cart.items.filter((i) => i.id !== item.id);
+	const totalizers = adjustItemsTotalizer(cart.totalizers, priceDelta);
 	return { cartItemRemove: {
 		__typename: "CartItemRemovePayload",
 		cart: {
 			__typename: "Cart",
 			id: cart.id,
-			items: cart.items.filter((i) => i.id !== item.id),
-			totalizers: adjustItemsTotalizer(cart.totalizers, priceDelta),
+			items: remainingItems,
+			totalizers,
 			total: moneyAdd(cart.total, priceDelta),
 			messages: cart.messages,
-			appliedCoupons: cart.appliedCoupons
+			appliedCoupons: cart.appliedCoupons,
+			discounts: cart.discounts,
+			freeShippingProgress: predictProgress(cart, remainingItems, totalizers),
+			salesChannelMismatch: cart.salesChannelMismatch
 		},
 		userErrors: emptyUserErrors()
 	} };
 }
 /**
-* Predicts the cart after `cartItemsRemove(input: { variantIds })` — the N-line generalisation of
+* Predicts the cart after `cartItemsRemove(input: { lineIds })` — the N-line generalisation of
 * `buildOptimisticRemove`. Lines absent from the cart are ignored; the summed price delta of the
 * matched lines adjusts the `Items` totalizer and the grand total.
 */
@@ -140,20 +169,28 @@ function buildOptimisticRemoveItems(cart, items) {
 	const removedLines = cart.items.filter((i) => removedIds.has(i.id));
 	if (removedLines.length === 0) return { cartItemsRemove: {
 		__typename: "CartItemsRemovePayload",
-		cart,
+		cart: {
+			...cart,
+			freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers)
+		},
 		userErrors: emptyUserErrors()
 	} };
-	const priceDelta = removedLines.reduce((sum, line) => sum - line.sellingPrice.amount * line.quantity, 0);
+	const priceDelta = removedLines.reduce((sum, line) => sum - Number(line.sellingPrice.amount) * line.quantity, 0);
+	const remainingItems = cart.items.filter((i) => !removedIds.has(i.id));
+	const totalizers = adjustItemsTotalizer(cart.totalizers, priceDelta);
 	return { cartItemsRemove: {
 		__typename: "CartItemsRemovePayload",
 		cart: {
 			__typename: "Cart",
 			id: cart.id,
-			items: cart.items.filter((i) => !removedIds.has(i.id)),
-			totalizers: adjustItemsTotalizer(cart.totalizers, priceDelta),
+			items: remainingItems,
+			totalizers,
 			total: moneyAdd(cart.total, priceDelta),
 			messages: cart.messages,
-			appliedCoupons: cart.appliedCoupons
+			appliedCoupons: cart.appliedCoupons,
+			discounts: cart.discounts,
+			freeShippingProgress: predictProgress(cart, remainingItems, totalizers),
+			salesChannelMismatch: cart.salesChannelMismatch
 		},
 		userErrors: emptyUserErrors()
 	} };

package/dist/sdk/cart/optimistic.js.map

@@ -1 +1 @@
-{"version":3,"file":"optimistic.js","names":[],"sources":["../../../src/sdk/cart/optimistic.ts"],"sourcesContent":["import type {\n  CartEntity,\n  CartItemEntity,\n  CartItemQuantityDecreasePayload,\n  CartItemQuantityIncreasePayload,\n  CartItemRemovePayload,\n  CartItemsRemovePayload,\n  CartTotalizer,\n  Money,\n} from './operations.js';\n\n/**\n * Pure optimistic-response builders for the three cache-propagating cart mutations\n * (mutation-contract.md (archived at the specs-archive tag)).\n *\n * Each builder takes the current `CartEntity` and the affected `CartItemEntity` and returns the\n * predicted post-mutation `Cart` carrying every field the canonical `CartFragment` selects:\n * `id`, `items`, `totalizers`, `total`. The shape MUST match Apollo's normalised cache slot for\n * the entity, so `__typename` and the same `id` are preserved.\n *\n * Lines are matched by their opaque `id` (Base64(\"CartItem:<orderFormId>:<uniqueId>\")).\n *\n * Recomputation rules (kept simple — server reconciles drift on response):\n *   - `Items` totalizer (matched by `id === 'Items'`) is adjusted by `item.sellingPrice * delta`.\n *   - `total` (the cart's grand total) is adjusted by the same delta.\n *   - All other totalizers (Shipping, Discounts, …) stay as-is until the server response lands.\n */\n\nfunction moneyAdd(money: Money, delta: number): Money {\n  // `Money.amount` is typed as `number` by codegen but arrives over the wire as a decimal *string*\n  // (the server's `Decimal` scalar = `(cents / 100).toFixed(2)`). Without coercing, `string + number`\n  // concatenates (e.g. \"49.99\" + 49.99 → \"49.9949.99\"), which formats to NaN during the optimistic\n  // window until the server response replaces it. Number() restores numeric addition.\n  return { __typename: 'Money', amount: Number(money.amount) + delta, currencyCode: money.currencyCode };\n}\n\nfunction adjustItemsTotalizer(totalizers: readonly CartTotalizer[], delta: number): CartTotalizer[] {\n  return totalizers.map((t) => (t.id === 'Items' ? { ...t, value: moneyAdd(t.value, delta) } : t));\n}\n\nfunction emptyUserErrors<T>(): T[] {\n  return [];\n}\n\n/**\n * Predicts the cart after `cartItemQuantityIncrease(input: { variantId, quantityToAdd })`.\n */\nexport function buildOptimisticIncrease(\n  cart: CartEntity,\n  item: CartItemEntity,\n  by = 1,\n): { cartItemQuantityIncrease: CartItemQuantityIncreasePayload } {\n  if (by <= 0) {\n    return {\n      cartItemQuantityIncrease: {\n        __typename: 'CartItemQuantityIncreasePayload',\n        cart,\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const currentItem = cart.items.find((i) => i.id === item.id);\n  if (!currentItem) {\n    return {\n      cartItemQuantityIncrease: {\n        __typename: 'CartItemQuantityIncreasePayload',\n        cart,\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const newQuantity = currentItem.quantity + by;\n  const delta = currentItem.sellingPrice.amount * by;\n\n  const updatedItems = cart.items.map((i) => (i.id === item.id ? { ...i, quantity: newQuantity } : i));\n\n  return {\n    cartItemQuantityIncrease: {\n      __typename: 'CartItemQuantityIncreasePayload',\n      cart: {\n        __typename: 'Cart',\n        id: cart.id,\n        items: updatedItems,\n        totalizers: adjustItemsTotalizer(cart.totalizers, delta),\n        total: moneyAdd(cart.total, delta),\n        messages: cart.messages,\n        appliedCoupons: cart.appliedCoupons,\n      },\n      userErrors: emptyUserErrors(),\n    },\n  };\n}\n\n/**\n * Predicts the cart after `cartItemQuantityDecrease(input: { variantId, quantityToRemove })`.\n *\n * If the resulting quantity would be `<= 0`, the line is removed entirely.\n */\nexport function buildOptimisticDecrease(\n  cart: CartEntity,\n  item: CartItemEntity,\n  by = 1,\n): { cartItemQuantityDecrease: CartItemQuantityDecreasePayload } {\n  if (by <= 0) {\n    return {\n      cartItemQuantityDecrease: {\n        __typename: 'CartItemQuantityDecreasePayload',\n        cart,\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const currentItem = cart.items.find((i) => i.id === item.id);\n  if (!currentItem) {\n    return {\n      cartItemQuantityDecrease: {\n        __typename: 'CartItemQuantityDecreasePayload',\n        cart,\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const requestedQuantity = currentItem.quantity - by;\n  const removed = requestedQuantity <= 0;\n  const actualDelta = removed ? currentItem.quantity : by;\n  const priceDelta = -currentItem.sellingPrice.amount * actualDelta;\n\n  const updatedItems = removed\n    ? cart.items.filter((i) => i.id !== item.id)\n    : cart.items.map((i) => (i.id === item.id ? { ...i, quantity: requestedQuantity } : i));\n\n  return {\n    cartItemQuantityDecrease: {\n      __typename: 'CartItemQuantityDecreasePayload',\n      cart: {\n        __typename: 'Cart',\n        id: cart.id,\n        items: updatedItems,\n        totalizers: adjustItemsTotalizer(cart.totalizers, priceDelta),\n        total: moneyAdd(cart.total, priceDelta),\n        messages: cart.messages,\n        appliedCoupons: cart.appliedCoupons,\n      },\n      userErrors: emptyUserErrors(),\n    },\n  };\n}\n\n/**\n * Predicts the cart after `cartItemRemove(input: { variantId })`.\n */\nexport function buildOptimisticRemove(\n  cart: CartEntity,\n  item: CartItemEntity,\n): { cartItemRemove: CartItemRemovePayload } {\n  const currentItem = cart.items.find((i) => i.id === item.id);\n  if (!currentItem) {\n    return {\n      cartItemRemove: {\n        __typename: 'CartItemRemovePayload',\n        cart,\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const priceDelta = -currentItem.sellingPrice.amount * currentItem.quantity;\n\n  return {\n    cartItemRemove: {\n      __typename: 'CartItemRemovePayload',\n      cart: {\n        __typename: 'Cart',\n        id: cart.id,\n        items: cart.items.filter((i) => i.id !== item.id),\n        totalizers: adjustItemsTotalizer(cart.totalizers, priceDelta),\n        total: moneyAdd(cart.total, priceDelta),\n        messages: cart.messages,\n        appliedCoupons: cart.appliedCoupons,\n      },\n      userErrors: emptyUserErrors(),\n    },\n  };\n}\n\n/**\n * Predicts the cart after `cartItemsRemove(input: { variantIds })` — the N-line generalisation of\n * `buildOptimisticRemove`. Lines absent from the cart are ignored; the summed price delta of the\n * matched lines adjusts the `Items` totalizer and the grand total.\n */\nexport function buildOptimisticRemoveItems(\n  cart: CartEntity,\n  items: readonly CartItemEntity[],\n): { cartItemsRemove: CartItemsRemovePayload } {\n  const removedIds = new Set(items.map((item) => item.id));\n  const removedLines = cart.items.filter((i) => removedIds.has(i.id));\n  if (removedLines.length === 0) {\n    return {\n      cartItemsRemove: {\n        __typename: 'CartItemsRemovePayload',\n        cart,\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const priceDelta = removedLines.reduce((sum, line) => sum - line.sellingPrice.amount * line.quantity, 0);\n\n  return {\n    cartItemsRemove: {\n      __typename: 'CartItemsRemovePayload',\n      cart: {\n        __typename: 'Cart',\n        id: cart.id,\n        items: cart.items.filter((i) => !removedIds.has(i.id)),\n        totalizers: adjustItemsTotalizer(cart.totalizers, priceDelta),\n        total: moneyAdd(cart.total, priceDelta),\n        messages: cart.messages,\n        appliedCoupons: cart.appliedCoupons,\n      },\n      userErrors: emptyUserErrors(),\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"optimistic.js","names":[],"sources":["../../../src/sdk/cart/optimistic.ts"],"sourcesContent":["import type {\n  CartEntity,\n  CartFreeShippingProgress,\n  CartItemEntity,\n  CartItemQuantityDecreasePayload,\n  CartItemQuantityIncreasePayload,\n  CartItemRemovePayload,\n  CartItemsRemovePayload,\n  CartTotalizer,\n  Money,\n} from './operations.js';\n\n/**\n * Pure optimistic-response builders for the three cache-propagating cart mutations\n * (mutation-contract.md (archived at the specs-archive tag)).\n *\n * Each builder takes the current `CartEntity` and the affected `CartItemEntity` and returns the\n * predicted post-mutation `Cart` carrying every field the canonical `CartFragment` selects:\n * `id`, `items`, `totalizers`, `total`. The shape MUST match Apollo's normalised cache slot for\n * the entity, so `__typename` and the same `id` are preserved.\n *\n * Lines are matched by their opaque `id` (Base64(\"CartItem:<orderFormId>:<uniqueId>\")).\n *\n * Recomputation rules (kept simple — server reconciles drift on response):\n *   - `Items` totalizer (matched by `id === 'Items'`) is adjusted by `item.sellingPrice * delta`.\n *   - `total` (the cart's grand total) is adjusted by the same delta.\n *   - All other totalizers (Shipping, Discounts, …) stay as-is until the server response lands.\n *   - `freeShippingProgress` (the four line writes select it) keeps its last known value, except that a\n *     qualified value, whose threshold is unknown, becomes `null` when the predicted `Items` total\n *     drops, and an emptied cart carries `null`; the server's answer replaces it.\n */\n\n/** The cart the builders read: the canonical entity plus the free-shipping slice the line writes select. */\ntype CartWithProgress = CartEntity & { freeShippingProgress?: CartFreeShippingProgress | null };\n\nfunction moneyAdd(money: Money, delta: number): Money {\n  // `Money.amount` is the decimal *string* the server's `Decimal` scalar sends (`(cents / 100).toFixed(2)`).\n  // Without coercing, `string + number` concatenates (e.g. \"49.99\" + 49.99 → \"49.9949.99\"), which formats\n  // to NaN during the optimistic window until the server response replaces it. Number() restores numeric\n  // addition and toFixed(2) writes the result back in the wire shape, with no float noise.\n  return { __typename: 'Money', amount: (Number(money.amount) + delta).toFixed(2), currencyCode: money.currencyCode };\n}\n\nfunction adjustItemsTotalizer(totalizers: readonly CartTotalizer[], delta: number): CartTotalizer[] {\n  return totalizers.map((t) => (t.id === 'Items' ? { ...t, value: moneyAdd(t.value, delta) } : t));\n}\n\nfunction itemsAmount(totalizers: readonly CartTotalizer[]): number {\n  return Number(totalizers.find((t) => t.id === 'Items')?.value.amount ?? 0);\n}\n\n/**\n * The `freeShippingProgress` the predicted cart carries. A qualified value has no threshold (the\n * promotion teaser is gone once met), so the client cannot tell \"still above the goal\" from \"below\"\n * after a drop: it hides the field until the server answers rather than claim a state it cannot know.\n */\nfunction predictProgress(\n  cart: CartWithProgress,\n  predictedItems: readonly CartItemEntity[],\n  predictedTotalizers: readonly CartTotalizer[],\n): CartFreeShippingProgress {\n  const current = cart.freeShippingProgress ?? null;\n  if (current === null || predictedItems.length === 0) return null;\n  if (!current.qualified) return current;\n\n  const before = itemsAmount(cart.totalizers);\n  const after = itemsAmount(predictedTotalizers);\n  if (!Number.isFinite(before) || !Number.isFinite(after) || after < before) return null;\n  return current;\n}\n\nfunction emptyUserErrors<T>(): T[] {\n  return [];\n}\n\n/**\n * Predicts the cart after `cartItemQuantityIncrease(input: { lineId, quantityToAdd })`.\n */\nexport function buildOptimisticIncrease(\n  cart: CartWithProgress,\n  item: CartItemEntity,\n  by = 1,\n): { cartItemQuantityIncrease: CartItemQuantityIncreasePayload } {\n  if (by <= 0) {\n    return {\n      cartItemQuantityIncrease: {\n        __typename: 'CartItemQuantityIncreasePayload',\n        cart: { ...cart, freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers) },\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const currentItem = cart.items.find((i) => i.id === item.id);\n  if (!currentItem) {\n    return {\n      cartItemQuantityIncrease: {\n        __typename: 'CartItemQuantityIncreasePayload',\n        cart: { ...cart, freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers) },\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const newQuantity = currentItem.quantity + by;\n  const delta = Number(currentItem.sellingPrice.amount) * by;\n\n  const updatedItems = cart.items.map((i) => (i.id === item.id ? { ...i, quantity: newQuantity } : i));\n\n  const totalizers = adjustItemsTotalizer(cart.totalizers, delta);\n  return {\n    cartItemQuantityIncrease: {\n      __typename: 'CartItemQuantityIncreasePayload',\n      cart: {\n        __typename: 'Cart',\n        id: cart.id,\n        items: updatedItems,\n        totalizers,\n        total: moneyAdd(cart.total, delta),\n        messages: cart.messages,\n        appliedCoupons: cart.appliedCoupons,\n        discounts: cart.discounts,\n        freeShippingProgress: predictProgress(cart, updatedItems, totalizers),\n        salesChannelMismatch: cart.salesChannelMismatch,\n      },\n      userErrors: emptyUserErrors(),\n    },\n  };\n}\n\n/**\n * Predicts the cart after `cartItemQuantityDecrease(input: { lineId, quantityToRemove })`.\n *\n * If the resulting quantity would be `<= 0`, the line is removed entirely.\n */\nexport function buildOptimisticDecrease(\n  cart: CartWithProgress,\n  item: CartItemEntity,\n  by = 1,\n): { cartItemQuantityDecrease: CartItemQuantityDecreasePayload } {\n  if (by <= 0) {\n    return {\n      cartItemQuantityDecrease: {\n        __typename: 'CartItemQuantityDecreasePayload',\n        cart: { ...cart, freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers) },\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const currentItem = cart.items.find((i) => i.id === item.id);\n  if (!currentItem) {\n    return {\n      cartItemQuantityDecrease: {\n        __typename: 'CartItemQuantityDecreasePayload',\n        cart: { ...cart, freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers) },\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const requestedQuantity = currentItem.quantity - by;\n  const removed = requestedQuantity <= 0;\n  const actualDelta = removed ? currentItem.quantity : by;\n  const priceDelta = -Number(currentItem.sellingPrice.amount) * actualDelta;\n\n  const updatedItems = removed\n    ? cart.items.filter((i) => i.id !== item.id)\n    : cart.items.map((i) => (i.id === item.id ? { ...i, quantity: requestedQuantity } : i));\n\n  const totalizers = adjustItemsTotalizer(cart.totalizers, priceDelta);\n  return {\n    cartItemQuantityDecrease: {\n      __typename: 'CartItemQuantityDecreasePayload',\n      cart: {\n        __typename: 'Cart',\n        id: cart.id,\n        items: updatedItems,\n        totalizers,\n        total: moneyAdd(cart.total, priceDelta),\n        messages: cart.messages,\n        appliedCoupons: cart.appliedCoupons,\n        discounts: cart.discounts,\n        freeShippingProgress: predictProgress(cart, updatedItems, totalizers),\n        salesChannelMismatch: cart.salesChannelMismatch,\n      },\n      userErrors: emptyUserErrors(),\n    },\n  };\n}\n\n/**\n * Predicts the cart after `cartItemRemove(input: { lineId })`.\n */\nexport function buildOptimisticRemove(\n  cart: CartWithProgress,\n  item: CartItemEntity,\n): { cartItemRemove: CartItemRemovePayload } {\n  const currentItem = cart.items.find((i) => i.id === item.id);\n  if (!currentItem) {\n    return {\n      cartItemRemove: {\n        __typename: 'CartItemRemovePayload',\n        cart: { ...cart, freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers) },\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const priceDelta = -Number(currentItem.sellingPrice.amount) * currentItem.quantity;\n  const remainingItems = cart.items.filter((i) => i.id !== item.id);\n\n  const totalizers = adjustItemsTotalizer(cart.totalizers, priceDelta);\n  return {\n    cartItemRemove: {\n      __typename: 'CartItemRemovePayload',\n      cart: {\n        __typename: 'Cart',\n        id: cart.id,\n        items: remainingItems,\n        totalizers,\n        total: moneyAdd(cart.total, priceDelta),\n        messages: cart.messages,\n        appliedCoupons: cart.appliedCoupons,\n        discounts: cart.discounts,\n        freeShippingProgress: predictProgress(cart, remainingItems, totalizers),\n        salesChannelMismatch: cart.salesChannelMismatch,\n      },\n      userErrors: emptyUserErrors(),\n    },\n  };\n}\n\n/**\n * Predicts the cart after `cartItemsRemove(input: { lineIds })` — the N-line generalisation of\n * `buildOptimisticRemove`. Lines absent from the cart are ignored; the summed price delta of the\n * matched lines adjusts the `Items` totalizer and the grand total.\n */\nexport function buildOptimisticRemoveItems(\n  cart: CartWithProgress,\n  items: readonly CartItemEntity[],\n): { cartItemsRemove: CartItemsRemovePayload } {\n  const removedIds = new Set(items.map((item) => item.id));\n  const removedLines = cart.items.filter((i) => removedIds.has(i.id));\n  if (removedLines.length === 0) {\n    return {\n      cartItemsRemove: {\n        __typename: 'CartItemsRemovePayload',\n        cart: { ...cart, freeShippingProgress: predictProgress(cart, cart.items, cart.totalizers) },\n        userErrors: emptyUserErrors(),\n      },\n    };\n  }\n\n  const priceDelta = removedLines.reduce((sum, line) => sum - Number(line.sellingPrice.amount) * line.quantity, 0);\n  const remainingItems = cart.items.filter((i) => !removedIds.has(i.id));\n\n  const totalizers = adjustItemsTotalizer(cart.totalizers, priceDelta);\n  return {\n    cartItemsRemove: {\n      __typename: 'CartItemsRemovePayload',\n      cart: {\n        __typename: 'Cart',\n        id: cart.id,\n        items: remainingItems,\n        totalizers,\n        total: moneyAdd(cart.total, priceDelta),\n        messages: cart.messages,\n        appliedCoupons: cart.appliedCoupons,\n        discounts: cart.discounts,\n        freeShippingProgress: predictProgress(cart, remainingItems, totalizers),\n        salesChannelMismatch: cart.salesChannelMismatch,\n      },\n      userErrors: emptyUserErrors(),\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/sdk/cart/use-cart-actions.d.ts

@@ -51,6 +51,13 @@ export type CartActions = Readonly<{
    * `cartUserErrorsVar` — a speculative open-time failure must raise no error banner (Decision 6).
    */
   validate: () => Promise<readonly CartUserError[]>;
+  /**
+   * Move the active cart onto the request's sales channel and reconcile its locale. Async (no
+   * optimistic). Returns userErrors (empty on success) and stamps the freshness window on success.
+   * Does not publish to `cartUserErrorsVar`: a background failure must raise no error banner.
+   * Registers as an in-flight write so a stock check skips while it runs.
+   */
+  syncSalesChannel: () => Promise<readonly CartUserError[]>;
 }>;
 //#endregion
 //# sourceMappingURL=use-cart-actions.d.ts.map