@vtex/faststore 0.0.8 → 0.0.11

package/dist/sdk/cart/use-cart-actions.js

@@ -2,7 +2,7 @@
 import { defineActions } from "../../core/dist/actions/registry.js";
 import "../../core/dist/index.js";
 import { loggableErrorName } from "../../utils/loggable-error-name.js";
-import { 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 } from "./operations.js";
+import { 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 } from "./operations.js";
 import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, orderFormIdVar } from "../state/cart.js";
 import { buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildOptimisticRemoveItems } from "./optimistic.js";
 import { markAvailabilityFresh, trackCartWrite } from "./write-gate.js";
@@ -19,8 +19,11 @@ import { useCallback, useMemo } from "react";
 * tree can dispatch a write through the compiler-injected `$actions.cart.*` prop — the cache is the
 * only meeting point between the read side and the write side (ADR-0010).
 *
-* `userErrors` from every call are published to `cartUserErrorsVar` (cleared at the start of the
-* next call) so `CartError` can surface them without a data context, and also returned to the caller.
+* `userErrors` from every call are published to `cartUserErrorsVar` (coupon writes to `cartCouponErrorsVar`)
+* so `CartError` and `CartCouponError` can surface them without a data context, and also returned to the
+* caller. Each write clears only its own channel as it starts (item writes `cartUserErrorsVar`, coupon
+* writes `cartCouponErrorsVar`), `validate` clears neither, and a CartRoot mount clears both; the mount
+* clear lives in `CartRoot`, because this hook mounts once per consumer element and cannot see a page mount.
 */
 /**
 * Thrown by the existing-line handlers (remove / quantity) when invoked before the cart resolves.
@@ -94,6 +97,30 @@ function readCartFromCache(client) {
 	}) ?? null;
 }
 /**
+* The line writes carry the cached `freeShippingProgress` into their optimistic response. It lives
+* outside `CartFragment` (only the line writes select it), so a cart the page read did not select it
+* for, or one never fetched, reads as `null`. The progress is read through the optimistic layers: a
+* second line write started while a drop is pending must see the hidden prediction, not the cached
+* "qualified" value underneath it, or its own layer would put the bar back.
+*/
+function readCartWithProgress(client) {
+	const cart = readCartFromCache(client);
+	if (!cart) return null;
+	const data = client.cache.readFragment({
+		id: client.cache.identify({
+			__typename: "Cart",
+			id: cart.id
+		}),
+		fragment: CartFreeShippingProgressFragment,
+		fragmentName: "CartFreeShippingProgressFragment",
+		optimistic: true
+	});
+	return {
+		...cart,
+		freeShippingProgress: data?.freeShippingProgress ?? null
+	};
+}
+/**
 * The `cart` namespace hook. Registered with the first-party action registry via `cartActions`
 * below; the compiler-emitted `CartActionProvider` calls it and threads the narrowed methods into
 * each consumer's `$actions.cart`.
@@ -108,9 +135,10 @@ function useCartActions() {
 	const [applyCouponMutation] = useMutation(CART_COUPON_APPLY);
 	const [removeCouponMutation] = useMutation(CART_COUPON_REMOVE);
 	const [validateMutation] = useMutation(CART_VALIDATE);
-	const readCart = useCallback(() => readCartFromCache(client), [client]);
+	const [syncMutation] = useMutation(CART_SALES_CHANNEL_SYNC);
+	const readCartForLineWrite = useCallback(() => readCartWithProgress(client), [client]);
 	const requireLine = useCallback((id) => {
-		const cart = readCart();
+		const cart = readCartForLineWrite();
 		if (!cart) throw new CartNotReadyError();
 		const line = cart.items.find((item) => item.id === id);
 		if (!line) return null;
@@ -118,7 +146,7 @@ function useCartActions() {
 			cart,
 			line
 		};
-	}, [readCart]);
+	}, [readCartForLineWrite]);
 	const addItem = useCallback(async (payload) => {
 		cartUserErrorsVar([]);
 		try {
@@ -145,7 +173,7 @@ function useCartActions() {
 		cartUserErrorsVar([]);
 		try {
 			return publishWrite((await trackCartWrite(removeMutation({
-				variables: { input: { variantId: found.line.variant.variantId } },
+				variables: { input: { lineId: found.line.lineId } },
 				optimisticResponse: buildOptimisticRemove(found.cart, found.line)
 			}))).data?.cartItemRemove?.userErrors ?? []);
 		} catch (error) {
@@ -154,22 +182,22 @@ function useCartActions() {
 		}
 	}, [requireLine, removeMutation]);
 	const removeItems = useCallback(async (payload) => {
-		const cart = readCart();
+		const cart = readCartForLineWrite();
 		if (!cart) throw new CartNotReadyError();
 		const lines = cart.items.filter((item) => payload.ids.includes(item.id));
 		if (lines.length === 0) return publish([]);
-		const variantIds = [...new Set(lines.map((line) => line.variant.variantId))];
+		const lineIds = lines.map((line) => line.lineId);
 		cartUserErrorsVar([]);
 		try {
 			return publishWrite((await trackCartWrite(removeItemsMutation({
-				variables: { input: { variantIds } },
+				variables: { input: { lineIds } },
 				optimisticResponse: buildOptimisticRemoveItems(cart, lines)
 			}))).data?.cartItemsRemove?.userErrors ?? []);
 		} catch (error) {
 			console.error("[cart.removeItems] cartItemsRemove failed", loggableErrorName(error));
 			return publish([NETWORK_USER_ERROR]);
 		}
-	}, [readCart, removeItemsMutation]);
+	}, [readCartForLineWrite, removeItemsMutation]);
 	const increaseQuantity = useCallback(async (payload) => {
 		const by = payload.by ?? 1;
 		const found = requireLine(payload.id);
@@ -178,7 +206,7 @@ function useCartActions() {
 		try {
 			return publishWrite((await trackCartWrite(increaseMutation({
 				variables: { input: {
-					variantId: found.line.variant.variantId,
+					lineId: found.line.lineId,
 					quantityToAdd: by
 				} },
 				optimisticResponse: buildOptimisticIncrease(found.cart, found.line, by)
@@ -196,7 +224,7 @@ function useCartActions() {
 		try {
 			return publishWrite((await trackCartWrite(decreaseMutation({
 				variables: { input: {
-					variantId: found.line.variant.variantId,
+					lineId: found.line.lineId,
 					quantityToRemove: by
 				} },
 				optimisticResponse: buildOptimisticDecrease(found.cart, found.line, by)
@@ -240,6 +268,18 @@ function useCartActions() {
 			return [NETWORK_USER_ERROR];
 		}
 	}, [validateMutation]);
+	const syncSalesChannel = useCallback(async () => {
+		try {
+			const result = await trackCartWrite(syncMutation());
+			hydrateCartId(result.data?.cartSalesChannelSync?.cart?.id ?? null);
+			const errors = result.data?.cartSalesChannelSync?.userErrors ?? [];
+			if (errors.length === 0) markAvailabilityFresh();
+			return errors;
+		} catch (error) {
+			console.error("[cart.syncSalesChannel] cartSalesChannelSync failed", loggableErrorName(error));
+			return [NETWORK_USER_ERROR];
+		}
+	}, [syncMutation]);
 	return useMemo(() => ({
 		addItem,
 		removeItem,
@@ -248,7 +288,8 @@ function useCartActions() {
 		decreaseQuantity,
 		applyCoupon,
 		removeCoupon,
-		validate
+		validate,
+		syncSalesChannel
 	}), [
 		addItem,
 		removeItem,
@@ -257,7 +298,8 @@ function useCartActions() {
 		decreaseQuantity,
 		applyCoupon,
 		removeCoupon,
-		validate
+		validate,
+		syncSalesChannel
 	]);
 }
 defineActions({
@@ -339,6 +381,10 @@ defineActions({
 		validate: {
 			description: "Re-check the active cart against the platform and adopt corrected availability (async, read-only upstream).",
 			payload: []
+		},
+		syncSalesChannel: {
+			description: "Moves the active cart onto the request's sales channel and reconciles its locale.",
+			payload: []
 		}
 	},
 	use: useCartActions

package/dist/sdk/cart/use-cart-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-cart-actions.js","names":[],"sources":["../../../src/sdk/cart/use-cart-actions.ts"],"sourcesContent":["'use client';\n\nimport type { ApolloClient } from '@apollo/client';\nimport { useApolloClient, useMutation } from '@apollo/client/react';\nimport { defineActions } from '@vtex/fs-core';\nimport { useCallback, useMemo } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, orderFormIdVar } from '../state/cart.js';\nimport {\n  CART_COUPON_APPLY,\n  CART_COUPON_REMOVE,\n  CART_ITEM_ADD,\n  CART_ITEM_QUANTITY_DECREASE,\n  CART_ITEM_QUANTITY_INCREASE,\n  CART_ITEM_REMOVE,\n  CART_ITEMS_REMOVE,\n  CART_VALIDATE,\n  type CartEntity,\n  CartFragment,\n  type CartItemEntity,\n  type CartUserError,\n} from './operations.js';\nimport {\n  buildOptimisticDecrease,\n  buildOptimisticIncrease,\n  buildOptimisticRemove,\n  buildOptimisticRemoveItems,\n} from './optimistic.js';\nimport { markAvailabilityFresh, trackCartWrite } from './write-gate.js';\n\n/**\n * The `cart` action namespace — the consolidated, context-free owner of every cart write\n * (docs/storefront-core/reference-free-particle-model.md § The cart write contract, docs/storefront-core/adr-0010-actions-own-the-write-side.md).\n *\n * It replaces `useCartMutations` + the mutation handlers `CartRoot` used to publish through\n * `CartDataContext`. A handler reads the current cart from the normalized Apollo cache (keyed by\n * `orderFormIdVar`), not from component props or React context, so any component anywhere in the\n * tree can dispatch a write through the compiler-injected `$actions.cart.*` prop — the cache is the\n * only meeting point between the read side and the write side (ADR-0010).\n *\n * `userErrors` from every call are published to `cartUserErrorsVar` (cleared at the start of the\n * next call) so `CartError` can surface them without a data context, and also returned to the caller.\n */\n\n/**\n * Thrown by the existing-line handlers (remove / quantity) when invoked before the cart resolves.\n * The first `addItem` mints the cart and hydrates `orderFormIdVar`; until then there is no cached\n * cart entity to read for the optimistic response.\n */\nexport class CartNotReadyError extends Error {\n  constructor(message?: string) {\n    super(message ?? 'CartNotReadyError: no cart in cache yet; add an item (or load the cart) before mutating a line.');\n    this.name = 'CartNotReadyError';\n  }\n}\n\nexport type AddItemPayload = Readonly<{\n  variantId: string;\n  quantity?: number;\n  /** Seller global Node ID, e.g. base64(\"Seller:1\"). The server rejects raw ids with INVALID_SELLER_ID. */\n  seller: string;\n}>;\n\n/** Existing-line payloads address the line by its opaque cart-item `id`; the handler reads the rest from cache. */\nexport type CartLinePayload = Readonly<{ id: string }>;\n\n/** Batch payloads address several lines by their opaque cart-item `id`s. */\nexport type CartLinesPayload = Readonly<{ ids: readonly string[] }>;\n\nexport type CartQuantityPayload = Readonly<{ id: string; by?: number }>;\n\n/** Coupon writes address the coupon by its `code`; the server resolves the cart from the cookie. */\nexport type CartCouponPayload = Readonly<{ code: string }>;\n\n/**\n * The `cart` namespace surface. Item writes return the resulting `userErrors` (empty on success)\n * and publish them to `cartUserErrorsVar`; coupon writes publish to the dedicated\n * `cartCouponErrorsVar` (docs/storefront-core/reference-free-particle-model.md § The cart write contract).\n */\nexport type CartActions = Readonly<{\n  /** Add an item to the cart. Async (no optimistic response). Creates the cart on first add. */\n  addItem: (payload: AddItemPayload) => Promise<readonly CartUserError[]>;\n  /** Remove a line entirely. Optimistic. */\n  removeItem: (payload: CartLinePayload) => Promise<readonly CartUserError[]>;\n  /** Remove several lines in one mutation. Optimistic. Ids missing from the cache are skipped. */\n  removeItems: (payload: CartLinesPayload) => Promise<readonly CartUserError[]>;\n  /** Increase a line's quantity by N (default 1). Optimistic. */\n  increaseQuantity: (payload: CartQuantityPayload) => Promise<readonly CartUserError[]>;\n  /** Decrease a line's quantity by N (default 1). Optimistic. Removes the line when result <= 0. */\n  decreaseQuantity: (payload: CartQuantityPayload) => Promise<readonly CartUserError[]>;\n  /** Apply a coupon code. Async (no optimistic). Publishes userErrors to cartCouponErrorsVar. */\n  applyCoupon: (payload: CartCouponPayload) => Promise<readonly CartUserError[]>;\n  /** Remove a coupon code by code. Async (no optimistic). Publishes userErrors to cartCouponErrorsVar. */\n  removeCoupon: (payload: CartCouponPayload) => Promise<readonly CartUserError[]>;\n  /**\n   * Re-check the active cart against the platform and adopt corrected availability. Async (no\n   * optimistic), read-only upstream. Returns userErrors (empty on success) to its caller and stamps\n   * the freshness window on success. Unlike the item writes it does NOT publish to\n   * `cartUserErrorsVar` — a speculative open-time failure must raise no error banner (Decision 6).\n   */\n  validate: () => Promise<readonly CartUserError[]>;\n}>;\n\nconst NETWORK_USER_ERROR: CartUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to update cart. Please try again.',\n};\n\nfunction publish(errors: readonly CartUserError[]): readonly CartUserError[] {\n  cartUserErrorsVar(errors);\n  return errors;\n}\n\n/** Coupon-scoped publish — keeps coupon feedback off the shared item-error channel (AD-2). */\nfunction publishCoupon(errors: readonly CartUserError[]): readonly CartUserError[] {\n  cartCouponErrorsVar(errors);\n  return errors;\n}\n\n/**\n * Publish a write's outcome and, when it came back clean, stamp the availability freshness window —\n * a clean write's payload carries the platform's recomputed cart, which is what lets the\n * validate-on-open call skip (docs/storefront-core/reference-free-particle-model.md § The cart write contract). Used only on paths\n * where a mutation actually reached the server: a `userErrors` response carries `cart: null` and a\n * no-op (unknown line) issues no request, so neither refreshes availability.\n */\nfunction publishWrite(errors: readonly CartUserError[]): readonly CartUserError[] {\n  if (errors.length === 0) markAvailabilityFresh();\n  return publish(errors);\n}\n\n/** Coupon-channel counterpart of `publishWrite`. */\nfunction publishCouponWrite(errors: readonly CartUserError[]): readonly CartUserError[] {\n  if (errors.length === 0) markAvailabilityFresh();\n  return publishCoupon(errors);\n}\n\n/**\n * Backfill `orderFormIdVar` from a mutation's returned `cart.id` when local state is still cold.\n * A coupon op can be the first cart write (SSR cold / drawer closed on first load); without this the\n * later `requireLine` paths short-circuit on `orderFormIdVar() === null` and throw `CartNotReadyError`.\n * Mirrors the `addItem` first-add handoff.\n */\nfunction hydrateCartId(cartId: string | null): void {\n  if (cartId && orderFormIdVar() === null) orderFormIdVar(cartId);\n}\n\n/**\n * Read the live cart entity from the normalized cache (ADR-0010), keyed by `orderFormIdVar`. Returns\n * null before the cart is minted/loaded. Module-level so it can be shared with the read-only callers\n * that live outside this hook — the pre-checkout gate re-reads the corrected cart this way after\n * `validate` resolves, because Apollo commits the mutation's cache write before the promise settles\n * (docs/storefront-core/reference-cart.md § Validation). The codegen `CartFragment` document embeds its\n * nested fragments, so it is a self-contained read.\n */\nexport function readCartFromCache(client: ApolloClient): CartEntity | null {\n  const cartId = orderFormIdVar();\n  if (!cartId) return null;\n  const cacheId = client.cache.identify({ __typename: 'Cart', id: cartId });\n  if (!cacheId) return null;\n  return (\n    client.cache.readFragment<CartEntity>({ id: cacheId, fragment: CartFragment, fragmentName: 'CartFragment' }) ?? null\n  );\n}\n\n/**\n * The `cart` namespace hook. Registered with the first-party action registry via `cartActions`\n * below; the compiler-emitted `CartActionProvider` calls it and threads the narrowed methods into\n * each consumer's `$actions.cart`.\n */\nexport function useCartActions(): CartActions {\n  const client = useApolloClient();\n\n  const [addMutation] = useMutation(CART_ITEM_ADD);\n  const [removeMutation] = useMutation(CART_ITEM_REMOVE);\n  const [removeItemsMutation] = useMutation(CART_ITEMS_REMOVE);\n  const [increaseMutation] = useMutation(CART_ITEM_QUANTITY_INCREASE);\n  const [decreaseMutation] = useMutation(CART_ITEM_QUANTITY_DECREASE);\n  const [applyCouponMutation] = useMutation(CART_COUPON_APPLY);\n  const [removeCouponMutation] = useMutation(CART_COUPON_REMOVE);\n  const [validateMutation] = useMutation(CART_VALIDATE);\n\n  const readCart = useCallback((): CartEntity | null => readCartFromCache(client), [client]);\n\n  const requireLine = useCallback(\n    (id: string): { cart: CartEntity; line: CartItemEntity } | null => {\n      const cart = readCart();\n      if (!cart) throw new CartNotReadyError();\n      const line = cart.items.find((item) => item.id === id);\n      if (!line) return null;\n      return { cart, line };\n    },\n    [readCart],\n  );\n\n  const addItem = useCallback<CartActions['addItem']>(\n    async (payload) => {\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          addMutation({\n            variables: {\n              input: { variantId: payload.variantId, quantity: payload.quantity ?? 1, seller: payload.seller },\n            },\n          }),\n        );\n        // Very-first add: the server minted a cart from the empty transport context. Hydrate the\n        // var so the existing-line handlers unlock without requiring a cart query.\n        if (orderFormIdVar() === null) {\n          const newId = result.data?.cartItemAdd?.cart?.id ?? null;\n          if (newId) orderFormIdVar(newId);\n        }\n        const errors = result.data?.cartItemAdd?.userErrors ?? [];\n        // Bump the add-success pulse only on the clean branch; the post-add behavior components\n        // (CartOpenOnAdd / CartRedirectOnAdd) key their effect on it. The userErrors and\n        // network-catch branches leave it untouched (docs/storefront-core/reference-free-particle-model.md § The cart write contract).\n        if (errors.length === 0) cartLastAddVar(cartLastAddVar() + 1);\n        return publishWrite(errors);\n      } catch (error) {\n        console.error('[cart.addItem] cartItemAdd failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [addMutation],\n  );\n\n  const removeItem = useCallback<CartActions['removeItem']>(\n    async (payload) => {\n      const found = requireLine(payload.id);\n      if (!found) return publish([]);\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          removeMutation({\n            variables: { input: { variantId: found.line.variant.variantId } },\n            optimisticResponse: buildOptimisticRemove(found.cart, found.line),\n          }),\n        );\n        return publishWrite(result.data?.cartItemRemove?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.removeItem] cartItemRemove failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [requireLine, removeMutation],\n  );\n\n  const removeItems = useCallback<CartActions['removeItems']>(\n    async (payload) => {\n      const cart = readCart();\n      if (!cart) throw new CartNotReadyError();\n      // Client-side tolerance mirroring removeItem's not-found no-op: ids without a cached line\n      // are skipped, and the surviving set is deduped before the single mutation.\n      const lines = cart.items.filter((item) => payload.ids.includes(item.id));\n      if (lines.length === 0) return publish([]);\n      const variantIds = [...new Set(lines.map((line) => line.variant.variantId))];\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          removeItemsMutation({\n            variables: { input: { variantIds } },\n            optimisticResponse: buildOptimisticRemoveItems(cart, lines),\n          }),\n        );\n        return publishWrite(result.data?.cartItemsRemove?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.removeItems] cartItemsRemove failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [readCart, removeItemsMutation],\n  );\n\n  const increaseQuantity = useCallback<CartActions['increaseQuantity']>(\n    async (payload) => {\n      const by = payload.by ?? 1;\n      const found = requireLine(payload.id);\n      if (!found) return publish([]);\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          increaseMutation({\n            variables: { input: { variantId: found.line.variant.variantId, quantityToAdd: by } },\n            optimisticResponse: buildOptimisticIncrease(found.cart, found.line, by),\n          }),\n        );\n        return publishWrite(result.data?.cartItemQuantityIncrease?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.increaseQuantity] cartItemQuantityIncrease failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [requireLine, increaseMutation],\n  );\n\n  const decreaseQuantity = useCallback<CartActions['decreaseQuantity']>(\n    async (payload) => {\n      const by = payload.by ?? 1;\n      const found = requireLine(payload.id);\n      if (!found) return publish([]);\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          decreaseMutation({\n            variables: { input: { variantId: found.line.variant.variantId, quantityToRemove: by } },\n            optimisticResponse: buildOptimisticDecrease(found.cart, found.line, by),\n          }),\n        );\n        return publishWrite(result.data?.cartItemQuantityDecrease?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.decreaseQuantity] cartItemQuantityDecrease failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [requireLine, decreaseMutation],\n  );\n\n  // Coupons are cart-level: no `requireLine` gate (AD-9). No optimistic response and no client\n  // rollback — totals and `isUnmatchedCondition` are server-computed and the server rolls back its\n  // own single-coupon rejections; the returned cart (spreading the extended CartFragment)\n  // self-updates the cache and every reactive subscriber (docs/storefront-core/reference-free-particle-model.md § The cart write contract).\n  const applyCoupon = useCallback<CartActions['applyCoupon']>(\n    async (payload) => {\n      cartCouponErrorsVar([]);\n      try {\n        const result = await trackCartWrite(applyCouponMutation({ variables: { input: { code: payload.code } } }));\n        hydrateCartId(result.data?.cartCouponApply?.cart?.id ?? null);\n        return publishCouponWrite(result.data?.cartCouponApply?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.applyCoupon] cartCouponApply failed', loggableErrorName(error));\n        return publishCoupon([NETWORK_USER_ERROR]);\n      }\n    },\n    [applyCouponMutation],\n  );\n\n  const removeCoupon = useCallback<CartActions['removeCoupon']>(\n    async (payload) => {\n      cartCouponErrorsVar([]);\n      try {\n        const result = await trackCartWrite(removeCouponMutation({ variables: { input: { code: payload.code } } }));\n        hydrateCartId(result.data?.cartCouponRemove?.cart?.id ?? null);\n        return publishCouponWrite(result.data?.cartCouponRemove?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.removeCoupon] cartCouponRemove failed', loggableErrorName(error));\n        return publishCoupon([NETWORK_USER_ERROR]);\n      }\n    },\n    [removeCouponMutation],\n  );\n\n  // Read-only upstream (docs/storefront-core/reference-free-particle-model.md § The cart write contract): re-simulates the cart and returns it\n  // with `variant.availability` corrected, spreading CartFragment so the guard, the per-line alert,\n  // and the badge re-render off the cache. Deliberately unlike the item writes: it does NOT register\n  // as an in-flight write (it would gate itself) and it does NOT publish to cartUserErrorsVar — the\n  // open call is speculative and the pre-checkout call is fail-open, so a failure must raise no error\n  // banner (Decision 6). It stamps the freshness window on success so open-on-add does not re-check.\n  const validate = useCallback<CartActions['validate']>(async () => {\n    try {\n      const result = await validateMutation();\n      // Hydrate as the coupon writes do: the corrected cart is now in the cache, and the pre-checkout\n      // gate finds it by `orderFormIdVar`. Without this a cold var would leave the gate reading null\n      // and passing a cart it never actually checked.\n      hydrateCartId(result.data?.cartValidate?.cart?.id ?? null);\n      const errors = result.data?.cartValidate?.userErrors ?? [];\n      if (errors.length === 0) markAvailabilityFresh();\n      return errors;\n    } catch (error) {\n      console.error('[cart.validate] cartValidate failed', loggableErrorName(error));\n      return [NETWORK_USER_ERROR];\n    }\n  }, [validateMutation]);\n\n  return useMemo(\n    () => ({\n      addItem,\n      removeItem,\n      removeItems,\n      increaseQuantity,\n      decreaseQuantity,\n      applyCoupon,\n      removeCoupon,\n      validate,\n    }),\n    [addItem, removeItem, removeItems, increaseQuantity, decreaseQuantity, applyCoupon, removeCoupon, validate],\n  );\n}\n\n/**\n * Declares the `cart` action namespace — the single source of truth for its method/payload metadata,\n * runtime provider, and `use` hook (mirrors `defineComponent`). The native catalog builder\n * (`@vtex/faststore-catalog`'s `buildPackageCatalog`) statically reads this call to emit `actions.json`;\n * at runtime `CartActionProvider` calls `useCartActions` directly.\n */\nexport const cartActions = defineActions({\n  namespace: 'cart',\n  description: 'Mutation-backed writes against the current cart (consolidates useCartMutations / CartRoot).',\n  provider: { name: 'CartActionProvider', importPath: '@vtex/faststore/internal/client' },\n  methods: {\n    addItem: {\n      description: 'Add an item to the cart (async strategy). Creates the cart on first add.',\n      payload: [\n        { name: 'variantId', type: 'string' },\n        { name: 'seller', type: 'string' },\n        { name: 'quantity', type: 'number', optional: true },\n      ],\n    },\n    removeItem: {\n      description: 'Remove a line from the cart (optimistic strategy).',\n      payload: [{ name: 'id', type: 'string' }],\n    },\n    removeItems: {\n      description: 'Remove several lines from the cart in one call (optimistic strategy).',\n      payload: [{ name: 'ids', type: 'string[]' }],\n    },\n    increaseQuantity: {\n      description: \"Increase a line's quantity by N (default 1, optimistic strategy).\",\n      payload: [\n        { name: 'id', type: 'string' },\n        { name: 'by', type: 'number', optional: true },\n      ],\n    },\n    decreaseQuantity: {\n      description: \"Decrease a line's quantity by N (default 1, optimistic). Removes the line at <= 0.\",\n      payload: [\n        { name: 'id', type: 'string' },\n        { name: 'by', type: 'number', optional: true },\n      ],\n    },\n    applyCoupon: {\n      description: 'Apply a coupon code to the cart (async strategy). Server recomputes totals.',\n      payload: [{ name: 'code', type: 'string' }],\n    },\n    removeCoupon: {\n      description: 'Remove a coupon code from the cart (async strategy). Server recomputes totals.',\n      payload: [{ name: 'code', type: 'string' }],\n    },\n    validate: {\n      description:\n        'Re-check the active cart against the platform and adopt corrected availability (async, read-only upstream).',\n      payload: [],\n    },\n  },\n  use: useCartActions,\n});\n"],"mappings":"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"}
+{"version":3,"file":"use-cart-actions.js","names":[],"sources":["../../../src/sdk/cart/use-cart-actions.ts"],"sourcesContent":["'use client';\n\nimport type { ApolloClient } from '@apollo/client';\nimport { useApolloClient, useMutation } from '@apollo/client/react';\nimport { defineActions } from '@vtex/fs-core';\nimport { useCallback, useMemo } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, orderFormIdVar } from '../state/cart.js';\nimport {\n  CART_COUPON_APPLY,\n  CART_COUPON_REMOVE,\n  CART_ITEM_ADD,\n  CART_ITEM_QUANTITY_DECREASE,\n  CART_ITEM_QUANTITY_INCREASE,\n  CART_ITEM_REMOVE,\n  CART_ITEMS_REMOVE,\n  CART_SALES_CHANNEL_SYNC,\n  CART_VALIDATE,\n  type CartEntity,\n  CartFragment,\n  type CartFreeShippingProgress,\n  CartFreeShippingProgressFragment,\n  type CartItemEntity,\n  type CartUserError,\n} from './operations.js';\nimport {\n  buildOptimisticDecrease,\n  buildOptimisticIncrease,\n  buildOptimisticRemove,\n  buildOptimisticRemoveItems,\n} from './optimistic.js';\nimport { markAvailabilityFresh, trackCartWrite } from './write-gate.js';\n\n/**\n * The `cart` action namespace — the consolidated, context-free owner of every cart write\n * (docs/storefront-core/reference-free-particle-model.md § The cart write contract, docs/storefront-core/adr-0010-actions-own-the-write-side.md).\n *\n * It replaces `useCartMutations` + the mutation handlers `CartRoot` used to publish through\n * `CartDataContext`. A handler reads the current cart from the normalized Apollo cache (keyed by\n * `orderFormIdVar`), not from component props or React context, so any component anywhere in the\n * tree can dispatch a write through the compiler-injected `$actions.cart.*` prop — the cache is the\n * only meeting point between the read side and the write side (ADR-0010).\n *\n * `userErrors` from every call are published to `cartUserErrorsVar` (coupon writes to `cartCouponErrorsVar`)\n * so `CartError` and `CartCouponError` can surface them without a data context, and also returned to the\n * caller. Each write clears only its own channel as it starts (item writes `cartUserErrorsVar`, coupon\n * writes `cartCouponErrorsVar`), `validate` clears neither, and a CartRoot mount clears both; the mount\n * clear lives in `CartRoot`, because this hook mounts once per consumer element and cannot see a page mount.\n */\n\n/**\n * Thrown by the existing-line handlers (remove / quantity) when invoked before the cart resolves.\n * The first `addItem` mints the cart and hydrates `orderFormIdVar`; until then there is no cached\n * cart entity to read for the optimistic response.\n */\nexport class CartNotReadyError extends Error {\n  constructor(message?: string) {\n    super(message ?? 'CartNotReadyError: no cart in cache yet; add an item (or load the cart) before mutating a line.');\n    this.name = 'CartNotReadyError';\n  }\n}\n\nexport type AddItemPayload = Readonly<{\n  variantId: string;\n  quantity?: number;\n  /** Seller global Node ID, e.g. base64(\"Seller:1\"). The server rejects raw ids with INVALID_SELLER_ID. */\n  seller: string;\n}>;\n\n/** Existing-line payloads address the line by its opaque cart-item `id`; the handler reads the rest from cache. */\nexport type CartLinePayload = Readonly<{ id: string }>;\n\n/** Batch payloads address several lines by their opaque cart-item `id`s. */\nexport type CartLinesPayload = Readonly<{ ids: readonly string[] }>;\n\nexport type CartQuantityPayload = Readonly<{ id: string; by?: number }>;\n\n/** Coupon writes address the coupon by its `code`; the server resolves the cart from the cookie. */\nexport type CartCouponPayload = Readonly<{ code: string }>;\n\n/**\n * The `cart` namespace surface. Item writes return the resulting `userErrors` (empty on success)\n * and publish them to `cartUserErrorsVar`; coupon writes publish to the dedicated\n * `cartCouponErrorsVar` (docs/storefront-core/reference-free-particle-model.md § The cart write contract).\n */\nexport type CartActions = Readonly<{\n  /** Add an item to the cart. Async (no optimistic response). Creates the cart on first add. */\n  addItem: (payload: AddItemPayload) => Promise<readonly CartUserError[]>;\n  /** Remove a line entirely. Optimistic. */\n  removeItem: (payload: CartLinePayload) => Promise<readonly CartUserError[]>;\n  /** Remove several lines in one mutation. Optimistic. Ids missing from the cache are skipped. */\n  removeItems: (payload: CartLinesPayload) => Promise<readonly CartUserError[]>;\n  /** Increase a line's quantity by N (default 1). Optimistic. */\n  increaseQuantity: (payload: CartQuantityPayload) => Promise<readonly CartUserError[]>;\n  /** Decrease a line's quantity by N (default 1). Optimistic. Removes the line when result <= 0. */\n  decreaseQuantity: (payload: CartQuantityPayload) => Promise<readonly CartUserError[]>;\n  /** Apply a coupon code. Async (no optimistic). Publishes userErrors to cartCouponErrorsVar. */\n  applyCoupon: (payload: CartCouponPayload) => Promise<readonly CartUserError[]>;\n  /** Remove a coupon code by code. Async (no optimistic). Publishes userErrors to cartCouponErrorsVar. */\n  removeCoupon: (payload: CartCouponPayload) => Promise<readonly CartUserError[]>;\n  /**\n   * Re-check the active cart against the platform and adopt corrected availability. Async (no\n   * optimistic), read-only upstream. Returns userErrors (empty on success) to its caller and stamps\n   * the freshness window on success. Unlike the item writes it does NOT publish to\n   * `cartUserErrorsVar` — a speculative open-time failure must raise no error banner (Decision 6).\n   */\n  validate: () => Promise<readonly CartUserError[]>;\n  /**\n   * Move the active cart onto the request's sales channel and reconcile its locale. Async (no\n   * optimistic). Returns userErrors (empty on success) and stamps the freshness window on success.\n   * Does not publish to `cartUserErrorsVar`: a background failure must raise no error banner.\n   * Registers as an in-flight write so a stock check skips while it runs.\n   */\n  syncSalesChannel: () => Promise<readonly CartUserError[]>;\n}>;\n\n// Diagnostic text for logs and callers: `CartError` and `CartCouponError` word this code from their own `$content`.\nconst NETWORK_USER_ERROR: CartUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to update cart. Please try again.',\n};\n\nfunction publish(errors: readonly CartUserError[]): readonly CartUserError[] {\n  cartUserErrorsVar(errors);\n  return errors;\n}\n\n/** Coupon-scoped publish — keeps coupon feedback off the shared item-error channel (AD-2). */\nfunction publishCoupon(errors: readonly CartUserError[]): readonly CartUserError[] {\n  cartCouponErrorsVar(errors);\n  return errors;\n}\n\n/**\n * Publish a write's outcome and, when it came back clean, stamp the availability freshness window —\n * a clean write's payload carries the platform's recomputed cart, which is what lets the\n * validate-on-open call skip (docs/storefront-core/reference-free-particle-model.md § The cart write contract). Used only on paths\n * where a mutation actually reached the server: a `userErrors` response carries `cart: null` and a\n * no-op (unknown line) issues no request, so neither refreshes availability.\n */\nfunction publishWrite(errors: readonly CartUserError[]): readonly CartUserError[] {\n  if (errors.length === 0) markAvailabilityFresh();\n  return publish(errors);\n}\n\n/** Coupon-channel counterpart of `publishWrite`. */\nfunction publishCouponWrite(errors: readonly CartUserError[]): readonly CartUserError[] {\n  if (errors.length === 0) markAvailabilityFresh();\n  return publishCoupon(errors);\n}\n\n/**\n * Backfill `orderFormIdVar` from a mutation's returned `cart.id` when local state is still cold.\n * A coupon op can be the first cart write (SSR cold / drawer closed on first load); without this the\n * later `requireLine` paths short-circuit on `orderFormIdVar() === null` and throw `CartNotReadyError`.\n * Mirrors the `addItem` first-add handoff.\n */\nfunction hydrateCartId(cartId: string | null): void {\n  if (cartId && orderFormIdVar() === null) orderFormIdVar(cartId);\n}\n\n/**\n * Read the live cart entity from the normalized cache (ADR-0010), keyed by `orderFormIdVar`. Returns\n * null before the cart is minted/loaded. Module-level so it can be shared with the read-only callers\n * that live outside this hook — the pre-checkout gate re-reads the corrected cart this way after\n * `validate` resolves, because Apollo commits the mutation's cache write before the promise settles\n * (docs/storefront-core/reference-cart.md § Validation). The codegen `CartFragment` document embeds its\n * nested fragments, so it is a self-contained read.\n */\nexport function readCartFromCache(client: ApolloClient): CartEntity | null {\n  const cartId = orderFormIdVar();\n  if (!cartId) return null;\n  const cacheId = client.cache.identify({ __typename: 'Cart', id: cartId });\n  if (!cacheId) return null;\n  return (\n    client.cache.readFragment<CartEntity>({ id: cacheId, fragment: CartFragment, fragmentName: 'CartFragment' }) ?? null\n  );\n}\n\ntype CartWithProgress = CartEntity & { freeShippingProgress: CartFreeShippingProgress };\n\n/**\n * The line writes carry the cached `freeShippingProgress` into their optimistic response. It lives\n * outside `CartFragment` (only the line writes select it), so a cart the page read did not select it\n * for, or one never fetched, reads as `null`. The progress is read through the optimistic layers: a\n * second line write started while a drop is pending must see the hidden prediction, not the cached\n * \"qualified\" value underneath it, or its own layer would put the bar back.\n */\nfunction readCartWithProgress(client: ApolloClient): CartWithProgress | null {\n  const cart = readCartFromCache(client);\n  if (!cart) return null;\n  const data = client.cache.readFragment<{ freeShippingProgress: CartFreeShippingProgress }>({\n    id: client.cache.identify({ __typename: 'Cart', id: cart.id }),\n    fragment: CartFreeShippingProgressFragment,\n    fragmentName: 'CartFreeShippingProgressFragment',\n    optimistic: true,\n  });\n  return { ...cart, freeShippingProgress: data?.freeShippingProgress ?? null };\n}\n\n/**\n * The `cart` namespace hook. Registered with the first-party action registry via `cartActions`\n * below; the compiler-emitted `CartActionProvider` calls it and threads the narrowed methods into\n * each consumer's `$actions.cart`.\n */\nexport function useCartActions(): CartActions {\n  const client = useApolloClient();\n\n  const [addMutation] = useMutation(CART_ITEM_ADD);\n  const [removeMutation] = useMutation(CART_ITEM_REMOVE);\n  const [removeItemsMutation] = useMutation(CART_ITEMS_REMOVE);\n  const [increaseMutation] = useMutation(CART_ITEM_QUANTITY_INCREASE);\n  const [decreaseMutation] = useMutation(CART_ITEM_QUANTITY_DECREASE);\n  const [applyCouponMutation] = useMutation(CART_COUPON_APPLY);\n  const [removeCouponMutation] = useMutation(CART_COUPON_REMOVE);\n  const [validateMutation] = useMutation(CART_VALIDATE);\n  const [syncMutation] = useMutation(CART_SALES_CHANNEL_SYNC);\n\n  const readCartForLineWrite = useCallback((): CartWithProgress | null => readCartWithProgress(client), [client]);\n\n  const requireLine = useCallback(\n    (id: string): { cart: CartWithProgress; line: CartItemEntity } | null => {\n      const cart = readCartForLineWrite();\n      if (!cart) throw new CartNotReadyError();\n      const line = cart.items.find((item) => item.id === id);\n      if (!line) return null;\n      return { cart, line };\n    },\n    [readCartForLineWrite],\n  );\n\n  const addItem = useCallback<CartActions['addItem']>(\n    async (payload) => {\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          addMutation({\n            variables: {\n              input: { variantId: payload.variantId, quantity: payload.quantity ?? 1, seller: payload.seller },\n            },\n          }),\n        );\n        // Very-first add: the server minted a cart from the empty transport context. Hydrate the\n        // var so the existing-line handlers unlock without requiring a cart query.\n        if (orderFormIdVar() === null) {\n          const newId = result.data?.cartItemAdd?.cart?.id ?? null;\n          if (newId) orderFormIdVar(newId);\n        }\n        const errors = result.data?.cartItemAdd?.userErrors ?? [];\n        // Bump the add-success pulse only on the clean branch; the post-add behavior components\n        // (CartOpenOnAdd / CartRedirectOnAdd) key their effect on it. The userErrors and\n        // network-catch branches leave it untouched (docs/storefront-core/reference-free-particle-model.md § The cart write contract).\n        if (errors.length === 0) cartLastAddVar(cartLastAddVar() + 1);\n        return publishWrite(errors);\n      } catch (error) {\n        console.error('[cart.addItem] cartItemAdd failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [addMutation],\n  );\n\n  const removeItem = useCallback<CartActions['removeItem']>(\n    async (payload) => {\n      const found = requireLine(payload.id);\n      if (!found) return publish([]);\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          removeMutation({\n            variables: { input: { lineId: found.line.lineId } },\n            optimisticResponse: buildOptimisticRemove(found.cart, found.line),\n          }),\n        );\n        return publishWrite(result.data?.cartItemRemove?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.removeItem] cartItemRemove failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [requireLine, removeMutation],\n  );\n\n  const removeItems = useCallback<CartActions['removeItems']>(\n    async (payload) => {\n      const cart = readCartForLineWrite();\n      if (!cart) throw new CartNotReadyError();\n      // Client-side tolerance mirroring removeItem's not-found no-op: ids without a cached line\n      // are skipped, and a repeated id resolves to its one line. Each line is sent by its own\n      // `lineId`: two lines of one SKU stay two entries.\n      const lines = cart.items.filter((item) => payload.ids.includes(item.id));\n      if (lines.length === 0) return publish([]);\n      const lineIds = lines.map((line) => line.lineId);\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          removeItemsMutation({\n            variables: { input: { lineIds } },\n            optimisticResponse: buildOptimisticRemoveItems(cart, lines),\n          }),\n        );\n        return publishWrite(result.data?.cartItemsRemove?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.removeItems] cartItemsRemove failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [readCartForLineWrite, removeItemsMutation],\n  );\n\n  const increaseQuantity = useCallback<CartActions['increaseQuantity']>(\n    async (payload) => {\n      const by = payload.by ?? 1;\n      const found = requireLine(payload.id);\n      if (!found) return publish([]);\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          increaseMutation({\n            variables: { input: { lineId: found.line.lineId, quantityToAdd: by } },\n            optimisticResponse: buildOptimisticIncrease(found.cart, found.line, by),\n          }),\n        );\n        return publishWrite(result.data?.cartItemQuantityIncrease?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.increaseQuantity] cartItemQuantityIncrease failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [requireLine, increaseMutation],\n  );\n\n  const decreaseQuantity = useCallback<CartActions['decreaseQuantity']>(\n    async (payload) => {\n      const by = payload.by ?? 1;\n      const found = requireLine(payload.id);\n      if (!found) return publish([]);\n      cartUserErrorsVar([]);\n      try {\n        const result = await trackCartWrite(\n          decreaseMutation({\n            variables: { input: { lineId: found.line.lineId, quantityToRemove: by } },\n            optimisticResponse: buildOptimisticDecrease(found.cart, found.line, by),\n          }),\n        );\n        return publishWrite(result.data?.cartItemQuantityDecrease?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.decreaseQuantity] cartItemQuantityDecrease failed', loggableErrorName(error));\n        return publish([NETWORK_USER_ERROR]);\n      }\n    },\n    [requireLine, decreaseMutation],\n  );\n\n  // Coupons are cart-level: no `requireLine` gate (AD-9). No optimistic response and no client\n  // rollback — totals and `isUnmatchedCondition` are server-computed and the server rolls back its\n  // own single-coupon rejections; the returned cart (spreading the extended CartFragment)\n  // self-updates the cache and every reactive subscriber (docs/storefront-core/reference-free-particle-model.md § The cart write contract).\n  const applyCoupon = useCallback<CartActions['applyCoupon']>(\n    async (payload) => {\n      cartCouponErrorsVar([]);\n      try {\n        const result = await trackCartWrite(applyCouponMutation({ variables: { input: { code: payload.code } } }));\n        hydrateCartId(result.data?.cartCouponApply?.cart?.id ?? null);\n        return publishCouponWrite(result.data?.cartCouponApply?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.applyCoupon] cartCouponApply failed', loggableErrorName(error));\n        return publishCoupon([NETWORK_USER_ERROR]);\n      }\n    },\n    [applyCouponMutation],\n  );\n\n  const removeCoupon = useCallback<CartActions['removeCoupon']>(\n    async (payload) => {\n      cartCouponErrorsVar([]);\n      try {\n        const result = await trackCartWrite(removeCouponMutation({ variables: { input: { code: payload.code } } }));\n        hydrateCartId(result.data?.cartCouponRemove?.cart?.id ?? null);\n        return publishCouponWrite(result.data?.cartCouponRemove?.userErrors ?? []);\n      } catch (error) {\n        console.error('[cart.removeCoupon] cartCouponRemove failed', loggableErrorName(error));\n        return publishCoupon([NETWORK_USER_ERROR]);\n      }\n    },\n    [removeCouponMutation],\n  );\n\n  // Read-only upstream (docs/storefront-core/reference-free-particle-model.md § The cart write contract): re-simulates the cart and returns it\n  // with `variant.availability` corrected, spreading CartFragment so the guard, the per-line alert,\n  // and the badge re-render off the cache. Deliberately unlike the item writes: it does NOT register\n  // as an in-flight write (it would gate itself) and it does NOT publish to cartUserErrorsVar — the\n  // open call is speculative and the pre-checkout call is fail-open, so a failure must raise no error\n  // banner (Decision 6). It stamps the freshness window on success so open-on-add does not re-check.\n  const validate = useCallback<CartActions['validate']>(async () => {\n    try {\n      const result = await validateMutation();\n      // Hydrate as the coupon writes do: the corrected cart is now in the cache, and the pre-checkout\n      // gate finds it by `orderFormIdVar`. Without this a cold var would leave the gate reading null\n      // and passing a cart it never actually checked.\n      hydrateCartId(result.data?.cartValidate?.cart?.id ?? null);\n      const errors = result.data?.cartValidate?.userErrors ?? [];\n      if (errors.length === 0) markAvailabilityFresh();\n      return errors;\n    } catch (error) {\n      console.error('[cart.validate] cartValidate failed', loggableErrorName(error));\n      return [NETWORK_USER_ERROR];\n    }\n  }, [validateMutation]);\n\n  // Same outcome rules as `validate` (stamp freshness only when userErrors is empty, never publish),\n  // except this write registers: a stock check must skip while the channel move is in flight.\n  const syncSalesChannel = useCallback<CartActions['syncSalesChannel']>(async () => {\n    try {\n      const result = await trackCartWrite(syncMutation());\n      hydrateCartId(result.data?.cartSalesChannelSync?.cart?.id ?? null);\n      const errors = result.data?.cartSalesChannelSync?.userErrors ?? [];\n      if (errors.length === 0) markAvailabilityFresh();\n      return errors;\n    } catch (error) {\n      console.error('[cart.syncSalesChannel] cartSalesChannelSync failed', loggableErrorName(error));\n      return [NETWORK_USER_ERROR];\n    }\n  }, [syncMutation]);\n\n  return useMemo(\n    () => ({\n      addItem,\n      removeItem,\n      removeItems,\n      increaseQuantity,\n      decreaseQuantity,\n      applyCoupon,\n      removeCoupon,\n      validate,\n      syncSalesChannel,\n    }),\n    [\n      addItem,\n      removeItem,\n      removeItems,\n      increaseQuantity,\n      decreaseQuantity,\n      applyCoupon,\n      removeCoupon,\n      validate,\n      syncSalesChannel,\n    ],\n  );\n}\n\n/**\n * Declares the `cart` action namespace — the single source of truth for its method/payload metadata,\n * runtime provider, and `use` hook (mirrors `defineComponent`). The native catalog builder\n * (`@vtex/faststore-catalog`'s `buildPackageCatalog`) statically reads this call to emit `actions.json`;\n * at runtime `CartActionProvider` calls `useCartActions` directly.\n */\nexport const cartActions = defineActions({\n  namespace: 'cart',\n  description: 'Mutation-backed writes against the current cart (consolidates useCartMutations / CartRoot).',\n  provider: { name: 'CartActionProvider', importPath: '@vtex/faststore/internal/client' },\n  methods: {\n    addItem: {\n      description: 'Add an item to the cart (async strategy). Creates the cart on first add.',\n      payload: [\n        { name: 'variantId', type: 'string' },\n        { name: 'seller', type: 'string' },\n        { name: 'quantity', type: 'number', optional: true },\n      ],\n    },\n    removeItem: {\n      description: 'Remove a line from the cart (optimistic strategy).',\n      payload: [{ name: 'id', type: 'string' }],\n    },\n    removeItems: {\n      description: 'Remove several lines from the cart in one call (optimistic strategy).',\n      payload: [{ name: 'ids', type: 'string[]' }],\n    },\n    increaseQuantity: {\n      description: \"Increase a line's quantity by N (default 1, optimistic strategy).\",\n      payload: [\n        { name: 'id', type: 'string' },\n        { name: 'by', type: 'number', optional: true },\n      ],\n    },\n    decreaseQuantity: {\n      description: \"Decrease a line's quantity by N (default 1, optimistic). Removes the line at <= 0.\",\n      payload: [\n        { name: 'id', type: 'string' },\n        { name: 'by', type: 'number', optional: true },\n      ],\n    },\n    applyCoupon: {\n      description: 'Apply a coupon code to the cart (async strategy). Server recomputes totals.',\n      payload: [{ name: 'code', type: 'string' }],\n    },\n    removeCoupon: {\n      description: 'Remove a coupon code from the cart (async strategy). Server recomputes totals.',\n      payload: [{ name: 'code', type: 'string' }],\n    },\n    validate: {\n      description:\n        'Re-check the active cart against the platform and adopt corrected availability (async, read-only upstream).',\n      payload: [],\n    },\n    syncSalesChannel: {\n      description: \"Moves the active cart onto the request's sales channel and reconciles its locale.\",\n      payload: [],\n    },\n  },\n  use: useCartActions,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YAAY,SAAkB;EAC5B,MAAM,WAAW,iGAAiG;EAClH,KAAK,OAAO;CACd;AACF;AAyDA,MAAM,qBAAoC;CACxC,MAAM;CACN,SAAS;AACX;AAEA,SAAS,QAAQ,QAA4D;CAC3E,kBAAkB,MAAM;CACxB,OAAO;AACT;;AAGA,SAAS,cAAc,QAA4D;CACjF,oBAAoB,MAAM;CAC1B,OAAO;AACT;;;;;;;;AASA,SAAS,aAAa,QAA4D;CAChF,IAAI,OAAO,WAAW,GAAG,sBAAsB;CAC/C,OAAO,QAAQ,MAAM;AACvB;;AAGA,SAAS,mBAAmB,QAA4D;CACtF,IAAI,OAAO,WAAW,GAAG,sBAAsB;CAC/C,OAAO,cAAc,MAAM;AAC7B;;;;;;;AAQA,SAAS,cAAc,QAA6B;CAClD,IAAI,UAAU,eAAe,MAAM,MAAM,eAAe,MAAM;AAChE;;;;;;;;;AAUA,SAAgB,kBAAkB,QAAyC;CACzE,MAAM,SAAS,eAAe;CAC9B,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,UAAU,OAAO,MAAM,SAAS;EAAE,YAAY;EAAQ,IAAI;CAAO,CAAC;CACxE,IAAI,CAAC,SAAS,OAAO;CACrB,OACE,OAAO,MAAM,aAAyB;EAAE,IAAI;EAAS,UAAU;EAAc,cAAc;CAAe,CAAC,KAAK;AAEpH;;;;;;;;AAWA,SAAS,qBAAqB,QAA+C;CAC3E,MAAM,OAAO,kBAAkB,MAAM;CACrC,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,OAAO,OAAO,MAAM,aAAiE;EACzF,IAAI,OAAO,MAAM,SAAS;GAAE,YAAY;GAAQ,IAAI,KAAK;EAAG,CAAC;EAC7D,UAAU;EACV,cAAc;EACd,YAAY;CACd,CAAC;CACD,OAAO;EAAE,GAAG;EAAM,sBAAsB,MAAM,wBAAwB;CAAK;AAC7E;;;;;;AAOA,SAAgB,iBAA8B;CAC5C,MAAM,SAAS,gBAAgB;CAE/B,MAAM,CAAC,eAAe,YAAY,aAAa;CAC/C,MAAM,CAAC,kBAAkB,YAAY,gBAAgB;CACrD,MAAM,CAAC,uBAAuB,YAAY,iBAAiB;CAC3D,MAAM,CAAC,oBAAoB,YAAY,2BAA2B;CAClE,MAAM,CAAC,oBAAoB,YAAY,2BAA2B;CAClE,MAAM,CAAC,uBAAuB,YAAY,iBAAiB;CAC3D,MAAM,CAAC,wBAAwB,YAAY,kBAAkB;CAC7D,MAAM,CAAC,oBAAoB,YAAY,aAAa;CACpD,MAAM,CAAC,gBAAgB,YAAY,uBAAuB;CAE1D,MAAM,uBAAuB,kBAA2C,qBAAqB,MAAM,GAAG,CAAC,MAAM,CAAC;CAE9G,MAAM,cAAc,aACjB,OAAwE;EACvE,MAAM,OAAO,qBAAqB;EAClC,IAAI,CAAC,MAAM,MAAM,IAAI,kBAAkB;EACvC,MAAM,OAAO,KAAK,MAAM,MAAM,SAAS,KAAK,OAAO,EAAE;EACrD,IAAI,CAAC,MAAM,OAAO;EAClB,OAAO;GAAE;GAAM;EAAK;CACtB,GACA,CAAC,oBAAoB,CACvB;CAEA,MAAM,UAAU,YACd,OAAO,YAAY;EACjB,kBAAkB,CAAC,CAAC;EACpB,IAAI;GACF,MAAM,SAAS,MAAM,eACnB,YAAY,EACV,WAAW,EACT,OAAO;IAAE,WAAW,QAAQ;IAAW,UAAU,QAAQ,YAAY;IAAG,QAAQ,QAAQ;GAAO,EACjG,EACF,CAAC,CACH;GAGA,IAAI,eAAe,MAAM,MAAM;IAC7B,MAAM,QAAQ,OAAO,MAAM,aAAa,MAAM,MAAM;IACpD,IAAI,OAAO,eAAe,KAAK;GACjC;GACA,MAAM,SAAS,OAAO,MAAM,aAAa,cAAc,CAAC;GAIxD,IAAI,OAAO,WAAW,GAAG,eAAe,eAAe,IAAI,CAAC;GAC5D,OAAO,aAAa,MAAM;EAC5B,SAAS,OAAO;GACd,QAAQ,MAAM,qCAAqC,kBAAkB,KAAK,CAAC;GAC3E,OAAO,QAAQ,CAAC,kBAAkB,CAAC;EACrC;CACF,GACA,CAAC,WAAW,CACd;CAEA,MAAM,aAAa,YACjB,OAAO,YAAY;EACjB,MAAM,QAAQ,YAAY,QAAQ,EAAE;EACpC,IAAI,CAAC,OAAO,OAAO,QAAQ,CAAC,CAAC;EAC7B,kBAAkB,CAAC,CAAC;EACpB,IAAI;GAOF,OAAO,cAAa,MANC,eACnB,eAAe;IACb,WAAW,EAAE,OAAO,EAAE,QAAQ,MAAM,KAAK,OAAO,EAAE;IAClD,oBAAoB,sBAAsB,MAAM,MAAM,MAAM,IAAI;GAClE,CAAC,CACH,EAAA,CAC2B,MAAM,gBAAgB,cAAc,CAAC,CAAC;EACnE,SAAS,OAAO;GACd,QAAQ,MAAM,2CAA2C,kBAAkB,KAAK,CAAC;GACjF,OAAO,QAAQ,CAAC,kBAAkB,CAAC;EACrC;CACF,GACA,CAAC,aAAa,cAAc,CAC9B;CAEA,MAAM,cAAc,YAClB,OAAO,YAAY;EACjB,MAAM,OAAO,qBAAqB;EAClC,IAAI,CAAC,MAAM,MAAM,IAAI,kBAAkB;EAIvC,MAAM,QAAQ,KAAK,MAAM,QAAQ,SAAS,QAAQ,IAAI,SAAS,KAAK,EAAE,CAAC;EACvE,IAAI,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,CAAC;EACzC,MAAM,UAAU,MAAM,KAAK,SAAS,KAAK,MAAM;EAC/C,kBAAkB,CAAC,CAAC;EACpB,IAAI;GAOF,OAAO,cAAa,MANC,eACnB,oBAAoB;IAClB,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE;IAChC,oBAAoB,2BAA2B,MAAM,KAAK;GAC5D,CAAC,CACH,EAAA,CAC2B,MAAM,iBAAiB,cAAc,CAAC,CAAC;EACpE,SAAS,OAAO;GACd,QAAQ,MAAM,6CAA6C,kBAAkB,KAAK,CAAC;GACnF,OAAO,QAAQ,CAAC,kBAAkB,CAAC;EACrC;CACF,GACA,CAAC,sBAAsB,mBAAmB,CAC5C;CAEA,MAAM,mBAAmB,YACvB,OAAO,YAAY;EACjB,MAAM,KAAK,QAAQ,MAAM;EACzB,MAAM,QAAQ,YAAY,QAAQ,EAAE;EACpC,IAAI,CAAC,OAAO,OAAO,QAAQ,CAAC,CAAC;EAC7B,kBAAkB,CAAC,CAAC;EACpB,IAAI;GAOF,OAAO,cAAa,MANC,eACnB,iBAAiB;IACf,WAAW,EAAE,OAAO;KAAE,QAAQ,MAAM,KAAK;KAAQ,eAAe;IAAG,EAAE;IACrE,oBAAoB,wBAAwB,MAAM,MAAM,MAAM,MAAM,EAAE;GACxE,CAAC,CACH,EAAA,CAC2B,MAAM,0BAA0B,cAAc,CAAC,CAAC;EAC7E,SAAS,OAAO;GACd,QAAQ,MAAM,2DAA2D,kBAAkB,KAAK,CAAC;GACjG,OAAO,QAAQ,CAAC,kBAAkB,CAAC;EACrC;CACF,GACA,CAAC,aAAa,gBAAgB,CAChC;CAEA,MAAM,mBAAmB,YACvB,OAAO,YAAY;EACjB,MAAM,KAAK,QAAQ,MAAM;EACzB,MAAM,QAAQ,YAAY,QAAQ,EAAE;EACpC,IAAI,CAAC,OAAO,OAAO,QAAQ,CAAC,CAAC;EAC7B,kBAAkB,CAAC,CAAC;EACpB,IAAI;GAOF,OAAO,cAAa,MANC,eACnB,iBAAiB;IACf,WAAW,EAAE,OAAO;KAAE,QAAQ,MAAM,KAAK;KAAQ,kBAAkB;IAAG,EAAE;IACxE,oBAAoB,wBAAwB,MAAM,MAAM,MAAM,MAAM,EAAE;GACxE,CAAC,CACH,EAAA,CAC2B,MAAM,0BAA0B,cAAc,CAAC,CAAC;EAC7E,SAAS,OAAO;GACd,QAAQ,MAAM,2DAA2D,kBAAkB,KAAK,CAAC;GACjG,OAAO,QAAQ,CAAC,kBAAkB,CAAC;EACrC;CACF,GACA,CAAC,aAAa,gBAAgB,CAChC;CAMA,MAAM,cAAc,YAClB,OAAO,YAAY;EACjB,oBAAoB,CAAC,CAAC;EACtB,IAAI;GACF,MAAM,SAAS,MAAM,eAAe,oBAAoB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,QAAQ,KAAK,EAAE,EAAE,CAAC,CAAC;GACzG,cAAc,OAAO,MAAM,iBAAiB,MAAM,MAAM,IAAI;GAC5D,OAAO,mBAAmB,OAAO,MAAM,iBAAiB,cAAc,CAAC,CAAC;EAC1E,SAAS,OAAO;GACd,QAAQ,MAAM,6CAA6C,kBAAkB,KAAK,CAAC;GACnF,OAAO,cAAc,CAAC,kBAAkB,CAAC;EAC3C;CACF,GACA,CAAC,mBAAmB,CACtB;CAEA,MAAM,eAAe,YACnB,OAAO,YAAY;EACjB,oBAAoB,CAAC,CAAC;EACtB,IAAI;GACF,MAAM,SAAS,MAAM,eAAe,qBAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,QAAQ,KAAK,EAAE,EAAE,CAAC,CAAC;GAC1G,cAAc,OAAO,MAAM,kBAAkB,MAAM,MAAM,IAAI;GAC7D,OAAO,mBAAmB,OAAO,MAAM,kBAAkB,cAAc,CAAC,CAAC;EAC3E,SAAS,OAAO;GACd,QAAQ,MAAM,+CAA+C,kBAAkB,KAAK,CAAC;GACrF,OAAO,cAAc,CAAC,kBAAkB,CAAC;EAC3C;CACF,GACA,CAAC,oBAAoB,CACvB;CAQA,MAAM,WAAW,YAAqC,YAAY;EAChE,IAAI;GACF,MAAM,SAAS,MAAM,iBAAiB;GAItC,cAAc,OAAO,MAAM,cAAc,MAAM,MAAM,IAAI;GACzD,MAAM,SAAS,OAAO,MAAM,cAAc,cAAc,CAAC;GACzD,IAAI,OAAO,WAAW,GAAG,sBAAsB;GAC/C,OAAO;EACT,SAAS,OAAO;GACd,QAAQ,MAAM,uCAAuC,kBAAkB,KAAK,CAAC;GAC7E,OAAO,CAAC,kBAAkB;EAC5B;CACF,GAAG,CAAC,gBAAgB,CAAC;CAIrB,MAAM,mBAAmB,YAA6C,YAAY;EAChF,IAAI;GACF,MAAM,SAAS,MAAM,eAAe,aAAa,CAAC;GAClD,cAAc,OAAO,MAAM,sBAAsB,MAAM,MAAM,IAAI;GACjE,MAAM,SAAS,OAAO,MAAM,sBAAsB,cAAc,CAAC;GACjE,IAAI,OAAO,WAAW,GAAG,sBAAsB;GAC/C,OAAO;EACT,SAAS,OAAO;GACd,QAAQ,MAAM,uDAAuD,kBAAkB,KAAK,CAAC;GAC7F,OAAO,CAAC,kBAAkB;EAC5B;CACF,GAAG,CAAC,YAAY,CAAC;CAEjB,OAAO,eACE;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CACF;AACF;AAQ2B,cAAc;CACvC,WAAW;CACX,aAAa;CACb,UAAU;EAAE,MAAM;EAAsB,YAAY;CAAkC;CACtF,SAAS;EACP,SAAS;GACP,aAAa;GACb,SAAS;IACP;KAAE,MAAM;KAAa,MAAM;IAAS;IACpC;KAAE,MAAM;KAAU,MAAM;IAAS;IACjC;KAAE,MAAM;KAAY,MAAM;KAAU,UAAU;IAAK;GACrD;EACF;EACA,YAAY;GACV,aAAa;GACb,SAAS,CAAC;IAAE,MAAM;IAAM,MAAM;GAAS,CAAC;EAC1C;EACA,aAAa;GACX,aAAa;GACb,SAAS,CAAC;IAAE,MAAM;IAAO,MAAM;GAAW,CAAC;EAC7C;EACA,kBAAkB;GAChB,aAAa;GACb,SAAS,CACP;IAAE,MAAM;IAAM,MAAM;GAAS,GAC7B;IAAE,MAAM;IAAM,MAAM;IAAU,UAAU;GAAK,CAC/C;EACF;EACA,kBAAkB;GAChB,aAAa;GACb,SAAS,CACP;IAAE,MAAM;IAAM,MAAM;GAAS,GAC7B;IAAE,MAAM;IAAM,MAAM;IAAU,UAAU;GAAK,CAC/C;EACF;EACA,aAAa;GACX,aAAa;GACb,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;GAAS,CAAC;EAC5C;EACA,cAAc;GACZ,aAAa;GACb,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;GAAS,CAAC;EAC5C;EACA,UAAU;GACR,aACE;GACF,SAAS,CAAC;EACZ;EACA,kBAAkB;GAChB,aAAa;GACb,SAAS,CAAC;EACZ;CACF;CACA,KAAK;AACP,CAAC"}

package/dist/sdk/cart/use-cart-sync-sales-channel.js

@@ -0,0 +1,70 @@
+"use client";
+import { loggableErrorName } from "../../utils/loggable-error-name.js";
+import { cartWritesInFlightVar } from "../state/cart.js";
+import { awaitCartWrites } from "./write-gate.js";
+import { useEffect, useRef, useState } from "react";
+//#region src/sdk/cart/use-cart-sync-sales-channel.ts
+function nextTick(tick) {
+	return tick + 1;
+}
+/** Attempts per mismatch, the first included, before the hook stops until the next document. */
+const MAX_SYNC_ATTEMPTS = 3;
+/** Wait before a retry, multiplied by the failures so far: 2 s, then 4 s. */
+const RETRY_DELAY_MS = 2e3;
+/**
+* Moves the cart onto the request's sales channel once per mismatch, after in-flight cart writes
+* settle. `sync` is `$actions.cart.syncSalesChannel`. A null mismatch, a missing cart id, or a
+* missing action does nothing. A dispatched key stays recorded, so a cache rewrite that carries the
+* same mismatch does not start a second call. A call that rejects or resolves with user errors is
+* retried on a timer, up to `MAX_SYNC_ATTEMPTS` attempts in all.
+*/
+function useCartSyncSalesChannel(sync, cartId, mismatch) {
+	const dispatched = useRef(/* @__PURE__ */ new Set());
+	const failures = useRef(/* @__PURE__ */ new Map());
+	const retryTimers = useRef(/* @__PURE__ */ new Set());
+	const [retryTick, setRetryTick] = useState(0);
+	useEffect(() => {
+		const timers = retryTimers.current;
+		return () => {
+			for (const timer of timers) clearTimeout(timer);
+			timers.clear();
+		};
+	}, []);
+	useEffect(() => {
+		if (!sync || cartId == null || mismatch == null) return;
+		const key = `${cartId}:${mismatch.cartSalesChannel}:${mismatch.activeSalesChannel}`;
+		if (dispatched.current.has(key)) return;
+		dispatched.current.add(key);
+		const call = sync;
+		function scheduleRetry() {
+			const failed = (failures.current.get(key) ?? 0) + 1;
+			failures.current.set(key, failed);
+			if (failed >= MAX_SYNC_ATTEMPTS) return;
+			const timer = setTimeout(() => {
+				retryTimers.current.delete(timer);
+				dispatched.current.delete(key);
+				setRetryTick(nextTick);
+			}, RETRY_DELAY_MS * failed);
+			retryTimers.current.add(timer);
+		}
+		(async () => {
+			while (cartWritesInFlightVar() > 0) await awaitCartWrites();
+			try {
+				const userErrors = await call();
+				if (Array.isArray(userErrors) && userErrors.length > 0) scheduleRetry();
+			} catch (error) {
+				console.error("[cart.syncSalesChannel] sync rejected", loggableErrorName(error));
+				scheduleRetry();
+			}
+		})();
+	}, [
+		sync,
+		cartId,
+		mismatch,
+		retryTick
+	]);
+}
+//#endregion
+export { useCartSyncSalesChannel };
+
+//# sourceMappingURL=use-cart-sync-sales-channel.js.map

package/dist/sdk/cart/use-cart-sync-sales-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cart-sync-sales-channel.js","names":[],"sources":["../../../src/sdk/cart/use-cart-sync-sales-channel.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef, useState } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport { cartWritesInFlightVar } from '../state/cart.js';\nimport { awaitCartWrites } from './write-gate.js';\n\ntype SalesChannelMismatch = {\n  cartSalesChannel: string;\n  activeSalesChannel: string;\n};\n\nfunction nextTick(tick: number): number {\n  return tick + 1;\n}\n\n/** Attempts per mismatch, the first included, before the hook stops until the next document. */\nconst MAX_SYNC_ATTEMPTS = 3;\n/** Wait before a retry, multiplied by the failures so far: 2 s, then 4 s. */\nconst RETRY_DELAY_MS = 2_000;\n\n/**\n * Moves the cart onto the request's sales channel once per mismatch, after in-flight cart writes\n * settle. `sync` is `$actions.cart.syncSalesChannel`. A null mismatch, a missing cart id, or a\n * missing action does nothing. A dispatched key stays recorded, so a cache rewrite that carries the\n * same mismatch does not start a second call. A call that rejects or resolves with user errors is\n * retried on a timer, up to `MAX_SYNC_ATTEMPTS` attempts in all.\n */\nexport function useCartSyncSalesChannel(\n  sync: (() => Promise<unknown>) | undefined,\n  cartId: string | null,\n  mismatch: SalesChannelMismatch | null | undefined,\n): void {\n  const dispatched = useRef(new Set<string>());\n  const failures = useRef(new Map<string, number>());\n  const retryTimers = useRef(new Set<ReturnType<typeof setTimeout>>());\n  const [retryTick, setRetryTick] = useState(0);\n\n  useEffect(() => {\n    const timers = retryTimers.current;\n    return () => {\n      for (const timer of timers) clearTimeout(timer);\n      timers.clear();\n    };\n  }, []);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: `retryTick` re-runs the effect after a retry delay.\n  useEffect(() => {\n    if (!sync || cartId == null || mismatch == null) return;\n    const key = `${cartId}:${mismatch.cartSalesChannel}:${mismatch.activeSalesChannel}`;\n    if (dispatched.current.has(key)) return;\n    // Record before any await so a re-render from this call cannot start a second one.\n    dispatched.current.add(key);\n    const call = sync;\n\n    function scheduleRetry() {\n      const failed = (failures.current.get(key) ?? 0) + 1;\n      failures.current.set(key, failed);\n      if (failed >= MAX_SYNC_ATTEMPTS) return;\n      const timer = setTimeout(() => {\n        retryTimers.current.delete(timer);\n        dispatched.current.delete(key);\n        setRetryTick(nextTick);\n      }, RETRY_DELAY_MS * failed);\n      retryTimers.current.add(timer);\n    }\n\n    void (async () => {\n      // Each pass waits for the writes in flight at that moment, including one that replaced a settled one.\n      while (cartWritesInFlightVar() > 0) await awaitCartWrites();\n      try {\n        const userErrors = await call();\n        if (Array.isArray(userErrors) && userErrors.length > 0) scheduleRetry();\n      } catch (error) {\n        console.error('[cart.syncSalesChannel] sync rejected', loggableErrorName(error));\n        scheduleRetry();\n      }\n    })();\n  }, [sync, cartId, mismatch, retryTick]);\n}\n"],"mappings":";;;;;;AAYA,SAAS,SAAS,MAAsB;CACtC,OAAO,OAAO;AAChB;;AAGA,MAAM,oBAAoB;;AAE1B,MAAM,iBAAiB;;;;;;;;AASvB,SAAgB,wBACd,MACA,QACA,UACM;CACN,MAAM,aAAa,uBAAO,IAAI,IAAY,CAAC;CAC3C,MAAM,WAAW,uBAAO,IAAI,IAAoB,CAAC;CACjD,MAAM,cAAc,uBAAO,IAAI,IAAmC,CAAC;CACnE,MAAM,CAAC,WAAW,gBAAgB,SAAS,CAAC;CAE5C,gBAAgB;EACd,MAAM,SAAS,YAAY;EAC3B,aAAa;GACX,KAAK,MAAM,SAAS,QAAQ,aAAa,KAAK;GAC9C,OAAO,MAAM;EACf;CACF,GAAG,CAAC,CAAC;CAGL,gBAAgB;EACd,IAAI,CAAC,QAAQ,UAAU,QAAQ,YAAY,MAAM;EACjD,MAAM,MAAM,GAAG,OAAO,GAAG,SAAS,iBAAiB,GAAG,SAAS;EAC/D,IAAI,WAAW,QAAQ,IAAI,GAAG,GAAG;EAEjC,WAAW,QAAQ,IAAI,GAAG;EAC1B,MAAM,OAAO;EAEb,SAAS,gBAAgB;GACvB,MAAM,UAAU,SAAS,QAAQ,IAAI,GAAG,KAAK,KAAK;GAClD,SAAS,QAAQ,IAAI,KAAK,MAAM;GAChC,IAAI,UAAU,mBAAmB;GACjC,MAAM,QAAQ,iBAAiB;IAC7B,YAAY,QAAQ,OAAO,KAAK;IAChC,WAAW,QAAQ,OAAO,GAAG;IAC7B,aAAa,QAAQ;GACvB,GAAG,iBAAiB,MAAM;GAC1B,YAAY,QAAQ,IAAI,KAAK;EAC/B;EAEA,CAAM,YAAY;GAEhB,OAAO,sBAAsB,IAAI,GAAG,MAAM,gBAAgB;GAC1D,IAAI;IACF,MAAM,aAAa,MAAM,KAAK;IAC9B,IAAI,MAAM,QAAQ,UAAU,KAAK,WAAW,SAAS,GAAG,cAAc;GACxE,SAAS,OAAO;IACd,QAAQ,MAAM,yCAAyC,kBAAkB,KAAK,CAAC;IAC/E,cAAc;GAChB;EACF,EAAA,CAAG;CACL,GAAG;EAAC;EAAM;EAAQ;EAAU;CAAS,CAAC;AACxC"}

package/dist/sdk/data/index.js

@@ -1,7 +1,7 @@
 import { DataOverrideContext, useDataOverride } from "./data-override-context.js";
-import { ListItemRefContext, useListItemRef } from "./list-item-ref-context.js";
-import { PageReactiveDataRoot, ReactiveRootContext } from "./page-reactive-data-root.js";
 import "./entity-resolution-context.js";
+import { PageReactiveDataRoot, ReactiveRootContext } from "./page-reactive-data-root.js";
+import { ListItemRefContext, useListItemRef } from "./list-item-ref-context.js";
 import { HotDataProvider } from "./hot-data-provider.js";
 import { MultipleReactiveDataProvider } from "./multiple-reactive-data-provider.js";
 import { ReactiveDataProvider } from "./reactive-data-provider.js";

package/dist/sdk/data/reactive-list-item-data-provider.js

@@ -1,8 +1,8 @@
 "use client";
 import { DataOverrideContext } from "./data-override-context.js";
-import { useListItemRef } from "./list-item-ref-context.js";
-import { ReactiveRootContext } from "./page-reactive-data-root.js";
 import { EntityResolutionContext } from "./entity-resolution-context.js";
+import { ReactiveRootContext } from "./page-reactive-data-root.js";
+import { useListItemRef } from "./list-item-ref-context.js";
 import { useApolloClient, useFragment } from "@apollo/client/react";
 import { useContext } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/sdk/generated/gql.js

@@ -1,6 +1,8 @@
-import { AccountSessionRevalidateDocument, AddressByPostalCodeDocument, BuyButtonDataFragmentDoc, CartCouponApplyDocument, CartCouponRemoveDocument, CartDataFragmentDoc, CartDiscountLinesDataFragmentDoc, CartFragmentFragmentDoc, CartItemAddDocument, CartItemCompositionsDataFragmentDoc, CartItemCustomizationsDataFragmentDoc, CartItemDiscountsDataFragmentDoc, CartItemFragmentFragmentDoc, CartItemQuantityDataFragmentDoc, CartItemQuantityDecreaseDocument, CartItemQuantityIncreaseDocument, CartItemRemoveDocument, CartItemRootDataFragmentDoc, CartItemSellerInfoDataFragmentDoc, CartItemVariationsDataFragmentDoc, CartItemsRemoveDocument, CartMarkdownDataFragmentDoc, CartShippingSimulationDocument, CartTotalizerDataFragmentDoc, CartValidateDocument, CatalogRouteAlternatesDocument, MoneyFragmentFragmentDoc, PricingDataFragmentDoc, ProductGalleryDataFragmentDoc, ProductInformationDataFragmentDoc, RegionDataFragmentDoc, RegionFragmentFragmentDoc, ServerSessionReadDocument, SessionDataFragmentDoc, SessionFragmentFragmentDoc, ShippingAddressUpdateDocument, ShippingSimulationDocument, VariantBuyButtonDataFragmentDoc, VariantBuyButtonQueryDocument, VariantGalleryDataFragmentDoc, VariantGalleryQueryDocument, VariantPricingDataFragmentDoc, VariantPricingQueryDocument, VariantSelectorDataFragmentDoc } from "./graphql.js";
+import { AccountSavedCardItemDataFragmentDoc, AccountSavedCardsDataFragmentDoc, AccountSessionRevalidateDocument, AddressByPostalCodeDocument, BuyButtonDataFragmentDoc, CartCouponApplyDocument, CartCouponRemoveDocument, CartDataFragmentDoc, CartDiscountLinesDataFragmentDoc, CartFragmentFragmentDoc, CartFreeShippingProgressFragmentFragmentDoc, CartItemAddDocument, CartItemCompositionsDataFragmentDoc, CartItemCustomizationsDataFragmentDoc, CartItemDiscountsDataFragmentDoc, CartItemFragmentFragmentDoc, CartItemQuantityDataFragmentDoc, CartItemQuantityDecreaseDocument, CartItemQuantityIncreaseDocument, CartItemRemoveDocument, CartItemRootDataFragmentDoc, CartItemSellerInfoDataFragmentDoc, CartItemVariationsDataFragmentDoc, CartItemsRemoveDocument, CartMarkdownDataFragmentDoc, CartSalesChannelSyncDocument, CartShippingSimulationDocument, CartTotalizerDataFragmentDoc, CartValidateDocument, CatalogRouteAlternatesDocument, MoneyFragmentFragmentDoc, PricingDataFragmentDoc, ProductGalleryDataFragmentDoc, ProductInformationDataFragmentDoc, RegionDataFragmentDoc, RegionFragmentFragmentDoc, ServerSessionReadDocument, SessionDataFragmentDoc, SessionFragmentFragmentDoc, ShippingAddressUpdateDocument, ShippingSimulationDocument, VariantBuyButtonDataFragmentDoc, VariantBuyButtonQueryDocument, VariantGalleryDataFragmentDoc, VariantGalleryQueryDocument, VariantPricingDataFragmentDoc, VariantPricingQueryDocument, VariantSelectorDataFragmentDoc } from "./graphql.js";
 //#region src/sdk/generated/gql.ts
 const documents = {
+	"\n  fragment AccountSavedCardsData on Query {\n    customerSavedCards {\n      __typename\n      id\n      cards {\n        __typename\n        id\n      }\n    }\n  }\n": AccountSavedCardsDataFragmentDoc,
+	"\n  fragment AccountSavedCardItemData on Query {\n    customerSavedCards {\n      cards {\n        __typename\n        id\n        network {\n          name\n        }\n        lastDigits\n        expiry {\n          month\n          year\n        }\n        status\n      }\n    }\n  }\n": AccountSavedCardItemDataFragmentDoc,
 	"\n  fragment BuyButtonData on Query {\n    productBySlug(slug: $slug) {\n      id\n      title\n      slug\n      images(first: 1) {\n        edges {\n          node {\n            url\n            altText\n          }\n        }\n      }\n      variants(first: 1) {\n        edges {\n          node {\n            id\n            sku\n            availableForSale\n            sellers {\n              id\n              isDefault\n              offer {\n                price { amount currencyCode }\n                listPrice { amount currencyCode }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n": BuyButtonDataFragmentDoc,
 	"\n  fragment VariantBuyButtonData on Variant {\n    __typename\n    id\n    availableForSale\n    sellers {\n      id\n      isDefault\n      offer {\n        price { amount currencyCode }\n      }\n    }\n  }\n": VariantBuyButtonDataFragmentDoc,
 	"\n  query VariantBuyButtonQuery($id: ID!) {\n    node(id: $id) {\n      __typename\n      ... on Variant {\n        ...VariantBuyButtonData\n      }\n    }\n  }\n": VariantBuyButtonQueryDocument,
@@ -9,12 +11,12 @@ const documents = {
 	"\n  fragment CartItemDiscountsData on Query {\n    cart {\n      items {\n        __typename\n        id\n        discounts {\n          name\n          value {\n            ...MoneyFragment\n          }\n          isPercentual\n        }\n      }\n    }\n  }\n": CartItemDiscountsDataFragmentDoc,
 	"\n  fragment CartItemSellerInfoData on Query {\n    cart {\n      items {\n        __typename\n        id\n        variant {\n          __typename\n          variantId\n          seller {\n            sellerId\n            name\n          }\n        }\n      }\n    }\n  }\n": CartItemSellerInfoDataFragmentDoc,
 	"\n  fragment CartItemVariationsData on Query {\n    cart {\n      items {\n        __typename\n        id\n        variant {\n          __typename\n          selectedOptions {\n            name\n            value\n          }\n        }\n      }\n    }\n  }\n": CartItemVariationsDataFragmentDoc,
-	"\n  fragment CartItemRootData on Query {\n    cart {\n      items {\n        __typename\n        id\n        quantity\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n        sellingPrice {\n          amount\n          currencyCode\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": CartItemRootDataFragmentDoc,
+	"\n  fragment CartItemRootData on Query {\n    cart {\n      items {\n        __typename\n        id\n        lineId\n        quantity\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n        sellingPrice {\n          amount\n          currencyCode\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": CartItemRootDataFragmentDoc,
 	"\n  fragment CartItemQuantityData on Query {\n    cart {\n      items {\n        __typename\n        id\n        variant {\n          __typename\n          unitMultiplier\n        }\n      }\n    }\n  }\n": CartItemQuantityDataFragmentDoc,
 	"\n  fragment CartTotalizerData on Query {\n    cart {\n      __typename\n      id\n      totalizers {\n        __typename\n        id\n        name\n        value {\n          ...MoneyFragment\n        }\n      }\n      total {\n        ...MoneyFragment\n      }\n    }\n  }\n": CartTotalizerDataFragmentDoc,
 	"\n  fragment CartDiscountLinesData on Query {\n    cart {\n      __typename\n      id\n      discounts {\n        name\n        value {\n          ...MoneyFragment\n        }\n        kind\n      }\n    }\n  }\n": CartDiscountLinesDataFragmentDoc,
 	"\n  fragment CartMarkdownData on Query {\n    cart {\n      __typename\n      id\n      itemMarkdownTotal {\n        ...MoneyFragment\n      }\n    }\n  }\n": CartMarkdownDataFragmentDoc,
-	"\n  fragment CartData on Query {\n    cart {\n      __typename\n      id\n      items {\n        __typename\n        id\n        quantity\n        gift\n        variant {\n          __typename\n          availability\n        }\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": CartDataFragmentDoc,
+	"\n  fragment CartData on Query {\n    cart {\n      __typename\n      id\n      items {\n        __typename\n        id\n        quantity\n        gift\n        variant {\n          __typename\n          availability\n        }\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": CartDataFragmentDoc,
 	"\n  fragment PricingData on Query {\n    productBySlug(slug: $slug) {\n      __typename\n      id\n      variants(first: 1) {\n        edges {\n          node {\n            sellers {\n              isDefault\n              offer {\n                price { amount currencyCode }\n                listPrice { amount currencyCode }\n                spotPrice { amount currencyCode }\n                installmentPlans {\n                  paymentMethod\n                  paymentType\n                  installments {\n                    count\n                    value { amount currencyCode }\n                    totalAmount { amount currencyCode }\n                    interestRate\n                    interestFree\n                  }\n                }\n                discountHighlights\n                promotions {\n                  name\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n": PricingDataFragmentDoc,
 	"\n  fragment VariantPricingData on Variant {\n    __typename\n    id\n    sellers {\n      isDefault\n      offer {\n        price { amount currencyCode }\n        listPrice { amount currencyCode }\n        spotPrice { amount currencyCode }\n        installmentPlans {\n          paymentMethod\n          paymentType\n          installments {\n            count\n            value { amount currencyCode }\n            totalAmount { amount currencyCode }\n            interestRate\n            interestFree\n          }\n        }\n        discountHighlights\n        promotions {\n          name\n        }\n      }\n    }\n  }\n": VariantPricingDataFragmentDoc,
 	"\n  query VariantPricingQuery($id: ID!) {\n    node(id: $id) {\n      __typename\n      ... on Variant {\n        ...VariantPricingData\n      }\n    }\n  }\n": VariantPricingQueryDocument,
@@ -27,24 +29,26 @@ const documents = {
 	"\n  fragment VariantSelectorData on Query {\n    productBySlug(slug: $slug) {\n      __typename\n      id\n      options {\n        name\n        values\n      }\n      variants(first: 50) {\n        edges {\n          node {\n            __typename\n            id\n            name\n            sku\n            availableForSale\n            selectedOptions {\n              name\n              value\n            }\n            images(first: 1) {\n              edges {\n                node {\n                  url\n                  altText\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n": VariantSelectorDataFragmentDoc,
 	"\n  query AddressByPostalCode($country: String!, $postalCode: String!) {\n    addressByPostalCode(country: $country, postalCode: $postalCode) {\n      city\n      state\n      street\n      neighborhood\n    }\n  }\n": AddressByPostalCodeDocument,
 	"\n  fragment MoneyFragment on Money {\n    __typename\n    amount\n    currencyCode\n  }\n": MoneyFragmentFragmentDoc,
-	"\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": CartItemFragmentFragmentDoc,
-	"\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": CartFragmentFragmentDoc,
+	"\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": CartItemFragmentFragmentDoc,
+	"\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": CartFragmentFragmentDoc,
+	"\n  fragment CartFreeShippingProgressFragment on Cart {\n    freeShippingProgress {\n      threshold {\n        ...MoneyFragment\n      }\n      remaining {\n        ...MoneyFragment\n      }\n      qualified\n    }\n  }\n": CartFreeShippingProgressFragmentFragmentDoc,
 	"\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": CartItemAddDocument,
-	"\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": CartItemRemoveDocument,
-	"\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": CartItemsRemoveDocument,
-	"\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": CartItemQuantityIncreaseDocument,
-	"\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": CartItemQuantityDecreaseDocument,
+	"\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": CartItemRemoveDocument,
+	"\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": CartItemsRemoveDocument,
+	"\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": CartItemQuantityIncreaseDocument,
+	"\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": CartItemQuantityDecreaseDocument,
 	"\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": CartCouponApplyDocument,
-	"\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": CartCouponRemoveDocument,
+	"\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": CartCouponRemoveDocument,
 	"\n  mutation CartValidate {\n    cartValidate {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n": CartValidateDocument,
+	"\n  mutation CartSalesChannelSync {\n    cartSalesChannelSync {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n": CartSalesChannelSyncDocument,
 	"\n  fragment RegionFragment on Region {\n    __typename\n    id\n    postalCode\n    city\n  }\n": RegionFragmentFragmentDoc,
-	"\n  query CatalogRouteAlternates($path: String!) {\n    catalogRoute(input: { path: $path }) {\n      variants {\n        locale\n        path\n      }\n    }\n  }\n": CatalogRouteAlternatesDocument,
+	"\n  query CatalogRouteAlternates($path: String!) {\n    catalogRoute(input: { path: $path }) {\n      id\n      variants {\n        locale\n        path\n      }\n    }\n  }\n": CatalogRouteAlternatesDocument,
 	"\n  fragment SessionFragment on Session {\n    __typename\n    id\n    loggedIn\n    canEditData\n    isIdentified\n  }\n": SessionFragmentFragmentDoc,
 	"\n  query ServerSessionRead {\n    session {\n      ...SessionFragment\n    }\n  }\n": ServerSessionReadDocument,
 	"\n  query AccountSessionRevalidate {\n    session {\n      ...SessionFragment\n    }\n  }\n": AccountSessionRevalidateDocument,
 	"\n  query CartShippingSimulation($input: CartShippingSimulateInput!) {\n    cartShippingSimulation(input: $input) {\n      shippingOptions {\n        id\n        name\n        channel\n        shippingEstimate {\n          value\n          unit\n        }\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n": CartShippingSimulationDocument,
 	"\n  query ShippingSimulation($input: ShippingSimulateInput!) {\n    shippingSimulation(input: $input) {\n      shippingOptions {\n        id\n        name\n        channel\n        shippingEstimate {\n          value\n          unit\n        }\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n": ShippingSimulationDocument,
-	"\n  mutation ShippingAddressUpdate($input: ShippingAddressUpdateInput!) {\n    shippingAddressUpdate(input: $input) {\n      shipping {\n        __typename\n        id\n        address {\n          __typename\n          id\n          recipientName\n          postalCode\n          country\n          street\n          number\n          complement\n          neighborhood\n          city\n          state\n        }\n        savedAddresses {\n          __typename\n          id\n          recipientName\n          postalCode\n          country\n          street\n          number\n          complement\n          neighborhood\n          city\n          state\n        }\n        options {\n          __typename\n          id\n          name\n          channel\n          shippingEstimate {\n            value\n            unit\n          }\n          price {\n            amount\n            currencyCode\n          }\n          listPrice {\n            amount\n            currencyCode\n          }\n        }\n        selectedOptionId\n      }\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n  \n": ShippingAddressUpdateDocument
+	"\n  mutation ShippingAddressUpdate($input: ShippingAddressUpdateInput!) {\n    shippingAddressUpdate(input: $input) {\n      shipping {\n        __typename\n        id\n        address {\n          __typename\n          id\n          recipientName\n          postalCode\n          country\n          street\n          number\n          complement\n          neighborhood\n          city\n          state\n        }\n        savedAddresses {\n          __typename\n          id\n          recipientName\n          postalCode\n          country\n          street\n          number\n          complement\n          neighborhood\n          city\n          state\n        }\n        options {\n          __typename\n          id\n          name\n          channel\n          shippingEstimate {\n            value\n            unit\n          }\n          price {\n            amount\n            currencyCode\n          }\n          listPrice {\n            amount\n            currencyCode\n          }\n        }\n        selectedOptionId\n      }\n      cart {\n        ...CartFragment\n        freeShippingProgress {\n          threshold {\n            __typename\n            amount\n            currencyCode\n          }\n          remaining {\n            __typename\n            amount\n            currencyCode\n          }\n          qualified\n        }\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n  \n": ShippingAddressUpdateDocument
 };
 function graphql(source) {
 	return documents[source] ?? {};