@replohq/sdk 1.4.1 → 1.6.0

package/cart/gateways/cookie-cart-gateway.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../cart/gateways/cookie-cart-gateway.ts"],
-  "sourcesContent": ["import type {\n  AddToCartPayload,\n  Cart,\n  CartLinePayload,\n  RemoveFromCartPayload,\n  UpdateCartDiscountCodesPayload,\n  UpdateCartLineItemPayload,\n} from \"../cart-types\";\nimport type { LineMergeFn } from \"../utils/cookie-cart-persistence\";\nimport type { CartGateway } from \"./cart-gateway\";\n\nimport {\n  addToCartWithPersistence,\n  createCartWithPersistence,\n  loadCartFromCookie,\n  removeCartLineItemsWithPersistence,\n  updateCartLineItemWithPersistence,\n} from \"../utils/cookie-cart-persistence\";\n\n/**\n * Configuration for cookie-based cart gateways\n */\ninterface CookieCartConfig {\n  cookieName: string;\n  lineMergeFn: LineMergeFn;\n  lineIdGenerator: () => string;\n  cartIdGenerator: () => string;\n  gatewayName: string; // For logging (e.g., \"Stripe\", \"Default\")\n}\n\n/**\n * Abstract base class for cookie-based cart gateways.\n * Provides common error handling, logging, and cart operations.\n * Subclasses must provide gateway-specific configuration.\n */\nexport abstract class CookieBasedCartGateway implements CartGateway {\n  protected abstract readonly config: CookieCartConfig;\n\n  async getCart(cartId: string): Promise<Cart | null> {\n    try {\n      const cart = await loadCartFromCookie(this.config.cookieName);\n      return cart?.id === cartId ? cart : null;\n    } catch (error) {\n      console.warn(\n        `${this.config.gatewayName} cart ${cartId} not found, could not fetch cart:`,\n        error,\n      );\n      return null;\n    }\n  }\n\n  async createCart(\n    lines?: CartLinePayload[],\n    _discountCodes?: string[],\n  ): Promise<Cart | null> {\n    try {\n      const cart = await createCartWithPersistence({\n        cookieName: this.config.cookieName,\n        lines,\n        lineIdGenerator: this.config.lineIdGenerator,\n        cartIdGenerator: this.config.cartIdGenerator,\n      });\n      return cart;\n    } catch (createCartError) {\n      console.warn(\n        `Failed to create ${this.config.gatewayName} cart${lines?.length ? \" with lines\" : \"\"}:`,\n        createCartError,\n      );\n      return null;\n    }\n  }\n\n  async addToCart(cartPayload: AddToCartPayload): Promise<Cart | null> {\n    try {\n      const cartData = await addToCartWithPersistence(cartPayload, {\n        cookieName: this.config.cookieName,\n        mergeFn: this.config.lineMergeFn,\n        lineIdGenerator: this.config.lineIdGenerator,\n      });\n      return cartData;\n    } catch (error) {\n      console.warn(`Failed to add items to ${this.config.gatewayName} cart:`, {\n        error: error instanceof Error ? error.message : String(error),\n        cartId: cartPayload.cartId,\n        itemCount: cartPayload.lines.length,\n      });\n      return null;\n    }\n  }\n\n  async updateCartLineItem(\n    cartPayload: UpdateCartLineItemPayload,\n  ): Promise<Cart | null> {\n    try {\n      const cartData = await updateCartLineItemWithPersistence(\n        cartPayload,\n        this.config.cookieName,\n      );\n      return cartData;\n    } catch (error) {\n      console.warn(\n        `Failed to update ${this.config.gatewayName} cart line item:`,\n        {\n          error: error instanceof Error ? error.message : String(error),\n          cartId: cartPayload.cartId,\n          lineId: cartPayload.line.id,\n          quantity: cartPayload.line.quantity,\n        },\n      );\n      return null;\n    }\n  }\n\n  async removeCartLineItems(\n    cartPayload: RemoveFromCartPayload,\n  ): Promise<Cart | null> {\n    try {\n      const cartData = await removeCartLineItemsWithPersistence(\n        cartPayload,\n        this.config.cookieName,\n      );\n      return cartData;\n    } catch (error) {\n      console.warn(\n        `Failed to remove ${this.config.gatewayName} cart line items:`,\n        {\n          error: error instanceof Error ? error.message : String(error),\n          cartId: cartPayload.cartId,\n          lineIds: cartPayload.lineIds,\n        },\n      );\n      return null;\n    }\n  }\n\n  async updateCartDiscountCodes(\n    cartPayload: UpdateCartDiscountCodesPayload,\n  ): Promise<Cart | null> {\n    console.warn(\n      `${this.config.gatewayName} cart gateway does not yet support discount codes`,\n    );\n    // Return existing cart without changes\n    try {\n      return await this.getCart(cartPayload.cartId);\n    } catch (error) {\n      console.warn(\"Failed to fetch cart for discount code update:\", error);\n      return null;\n    }\n  }\n}\n"],
-  "mappings": "AAWA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAkBA,MAAe,uBAA8C;AAAA,EAGlE,MAAM,QAAQ,QAAsC;AAClD,QAAI;AACF,YAAM,OAAO,MAAM,mBAAmB,KAAK,OAAO,UAAU;AAC5D,aAAO,MAAM,OAAO,SAAS,OAAO;AAAA,IACtC,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,GAAG,KAAK,OAAO,WAAW,SAAS,MAAM;AAAA,QACzC;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,WACJ,OACA,gBACsB;AACtB,QAAI;AACF,YAAM,OAAO,MAAM,0BAA0B;AAAA,QAC3C,YAAY,KAAK,OAAO;AAAA,QACxB;AAAA,QACA,iBAAiB,KAAK,OAAO;AAAA,QAC7B,iBAAiB,KAAK,OAAO;AAAA,MAC/B,CAAC;AACD,aAAO;AAAA,IACT,SAAS,iBAAiB;AACxB,cAAQ;AAAA,QACN,oBAAoB,KAAK,OAAO,WAAW,QAAQ,OAAO,SAAS,gBAAgB,EAAE;AAAA,QACrF;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,UAAU,aAAqD;AACnE,QAAI;AACF,YAAM,WAAW,MAAM,yBAAyB,aAAa;AAAA,QAC3D,YAAY,KAAK,OAAO;AAAA,QACxB,SAAS,KAAK,OAAO;AAAA,QACrB,iBAAiB,KAAK,OAAO;AAAA,MAC/B,CAAC;AACD,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ,KAAK,0BAA0B,KAAK,OAAO,WAAW,UAAU;AAAA,QACtE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,QAC5D,QAAQ,YAAY;AAAA,QACpB,WAAW,YAAY,MAAM;AAAA,MAC/B,CAAC;AACD,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,mBACJ,aACsB;AACtB,QAAI;AACF,YAAM,WAAW,MAAM;AAAA,QACrB;AAAA,QACA,KAAK,OAAO;AAAA,MACd;AACA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,oBAAoB,KAAK,OAAO,WAAW;AAAA,QAC3C;AAAA,UACE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UAC5D,QAAQ,YAAY;AAAA,UACpB,QAAQ,YAAY,KAAK;AAAA,UACzB,UAAU,YAAY,KAAK;AAAA,QAC7B;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,oBACJ,aACsB;AACtB,QAAI;AACF,YAAM,WAAW,MAAM;AAAA,QACrB;AAAA,QACA,KAAK,OAAO;AAAA,MACd;AACA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,oBAAoB,KAAK,OAAO,WAAW;AAAA,QAC3C;AAAA,UACE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UAC5D,QAAQ,YAAY;AAAA,UACpB,SAAS,YAAY;AAAA,QACvB;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,wBACJ,aACsB;AACtB,YAAQ;AAAA,MACN,GAAG,KAAK,OAAO,WAAW;AAAA,IAC5B;AAEA,QAAI;AACF,aAAO,MAAM,KAAK,QAAQ,YAAY,MAAM;AAAA,IAC9C,SAAS,OAAO;AACd,cAAQ,KAAK,kDAAkD,KAAK;AACpE,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { ReconciledCartLine } from \"../../gateways/canopy-api\";\nimport type {\n  AddToCartPayload,\n  Cart,\n  CartLinePayload,\n  RemoveFromCartPayload,\n  UpdateCartDiscountCodesPayload,\n  UpdateCartLineItemPayload,\n} from \"../cart-types\";\nimport type { LineMergeFn } from \"../utils/cookie-cart-persistence\";\nimport type { CartGateway } from \"./cart-gateway\";\n\nimport { applyCartLineReconciliation } from \"../utils/cart-utils\";\nimport {\n  addToCartWithPersistence,\n  createCartWithPersistence,\n  loadCartFromCookie,\n  removeCartLineItemsWithPersistence,\n  saveCartToCookie,\n  updateCartLineItemWithPersistence,\n} from \"../utils/cookie-cart-persistence\";\n\n/**\n * Configuration for cookie-based cart gateways\n */\ninterface CookieCartConfig {\n  cookieName: string;\n  lineMergeFn: LineMergeFn;\n  lineIdGenerator: () => string;\n  cartIdGenerator: () => string;\n  gatewayName: string; // For logging (e.g., \"Stripe\", \"Default\")\n  // The catalog's per-line facts for this cart's variants. When present,\n  // every cart write reconciles against it (reprice, clamp, drop\n  // unavailable); absent means the gateway has no catalog to ask.\n  reconcileLines?: (\n    lines: { variantId: string; quantity: number }[],\n  ) => Promise<ReconciledCartLine[]>;\n}\n\n/**\n * Abstract base class for cookie-based cart gateways.\n * Provides common error handling, logging, and cart operations.\n * Subclasses must provide gateway-specific configuration.\n */\nexport abstract class CookieBasedCartGateway implements CartGateway {\n  protected abstract readonly config: CookieCartConfig;\n\n  // Fails open (null) when the catalog can't answer: a canopy blip must not\n  // block cart writes \u2014 checkout still enforces stock and price.\n  private async fetchReconciledLines(\n    cart: Cart,\n  ): Promise<ReconciledCartLine[] | null> {\n    const reconcileLines = this.config.reconcileLines;\n    if (!reconcileLines) {\n      return null;\n    }\n    const requestLines = cart.lines.flatMap((line) => {\n      return line.merchandise\n        ? [{ variantId: line.merchandise.id, quantity: line.quantity }]\n        : [];\n    });\n    if (requestLines.length === 0) {\n      return null;\n    }\n    try {\n      return await reconcileLines(requestLines);\n    } catch (error) {\n      console.warn(\n        `${this.config.gatewayName} cart reconciliation unavailable, keeping cart as written:`,\n        error,\n      );\n      return null;\n    }\n  }\n\n  // Catalog fetch failures fail open inside fetchReconciledLines; a\n  // reconciliation mismatch from the apply still throws.\n  private async reconcile(\n    cart: Cart,\n    { clampQuantities }: { clampQuantities: boolean },\n  ): Promise<Cart> {\n    const reconciledLines = await this.fetchReconciledLines(cart);\n    if (!reconciledLines) {\n      return cart;\n    }\n    return applyCartLineReconciliation(cart, reconciledLines, {\n      clampQuantities,\n    });\n  }\n\n  private reconcileForWrite = (cart: Cart): Promise<Cart> => {\n    return this.reconcile(cart, { clampQuantities: true });\n  };\n\n  async reconcileStoredCart(cart: Cart): Promise<Cart> {\n    // Reads reprice and drop unavailable lines but never clamp quantities \u2014\n    // silent quantity changes are the write and checkout paths' job, where\n    // they come with messaging.\n    const reconciledCart = await this.reconcile(cart, {\n      clampQuantities: false,\n    });\n    // Lines are the only thing reconciliation can change; cost derives from them.\n    if (JSON.stringify(reconciledCart.lines) !== JSON.stringify(cart.lines)) {\n      await saveCartToCookie(reconciledCart, this.config.cookieName);\n    }\n    return reconciledCart;\n  }\n\n  async getCart(cartId: string): Promise<Cart | null> {\n    try {\n      const cart = await loadCartFromCookie(this.config.cookieName);\n      return cart?.id === cartId ? cart : null;\n    } catch (error) {\n      console.warn(\n        `${this.config.gatewayName} cart ${cartId} not found, could not fetch cart:`,\n        error,\n      );\n      return null;\n    }\n  }\n\n  async createCart(\n    lines?: CartLinePayload[],\n    _discountCodes?: string[],\n  ): Promise<Cart | null> {\n    try {\n      const cart = await createCartWithPersistence({\n        cookieName: this.config.cookieName,\n        lines,\n        lineIdGenerator: this.config.lineIdGenerator,\n        cartIdGenerator: this.config.cartIdGenerator,\n        reconcile: this.reconcileForWrite,\n      });\n      return cart;\n    } catch (createCartError) {\n      console.warn(\n        `Failed to create ${this.config.gatewayName} cart${lines?.length ? \" with lines\" : \"\"}:`,\n        createCartError,\n      );\n      return null;\n    }\n  }\n\n  async addToCart(cartPayload: AddToCartPayload): Promise<Cart | null> {\n    try {\n      const cartData = await addToCartWithPersistence(cartPayload, {\n        cookieName: this.config.cookieName,\n        mergeFn: this.config.lineMergeFn,\n        lineIdGenerator: this.config.lineIdGenerator,\n        reconcile: this.reconcileForWrite,\n      });\n      return cartData;\n    } catch (error) {\n      console.warn(`Failed to add items to ${this.config.gatewayName} cart:`, {\n        error: error instanceof Error ? error.message : String(error),\n        cartId: cartPayload.cartId,\n        itemCount: cartPayload.lines.length,\n      });\n      return null;\n    }\n  }\n\n  async updateCartLineItem(\n    cartPayload: UpdateCartLineItemPayload,\n  ): Promise<Cart | null> {\n    try {\n      const cartData = await updateCartLineItemWithPersistence(\n        cartPayload,\n        this.config.cookieName,\n        this.reconcileForWrite,\n      );\n      return cartData;\n    } catch (error) {\n      console.warn(\n        `Failed to update ${this.config.gatewayName} cart line item:`,\n        {\n          error: error instanceof Error ? error.message : String(error),\n          cartId: cartPayload.cartId,\n          lineId: cartPayload.line.id,\n          quantity: cartPayload.line.quantity,\n        },\n      );\n      return null;\n    }\n  }\n\n  async removeCartLineItems(\n    cartPayload: RemoveFromCartPayload,\n  ): Promise<Cart | null> {\n    try {\n      const cartData = await removeCartLineItemsWithPersistence(\n        cartPayload,\n        this.config.cookieName,\n      );\n      return cartData;\n    } catch (error) {\n      console.warn(\n        `Failed to remove ${this.config.gatewayName} cart line items:`,\n        {\n          error: error instanceof Error ? error.message : String(error),\n          cartId: cartPayload.cartId,\n          lineIds: cartPayload.lineIds,\n        },\n      );\n      return null;\n    }\n  }\n\n  async updateCartDiscountCodes(\n    cartPayload: UpdateCartDiscountCodesPayload,\n  ): Promise<Cart | null> {\n    console.warn(\n      `${this.config.gatewayName} cart gateway does not yet support discount codes`,\n    );\n    // Return existing cart without changes\n    try {\n      return await this.getCart(cartPayload.cartId);\n    } catch (error) {\n      console.warn(\"Failed to fetch cart for discount code update:\", error);\n      return null;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/cart/gateways/resolver-cart-gateway.js

@@ -1,6 +1,10 @@
 "use server";
 import { getCanopyApiGateway } from "../../gateways/canopy-api";
 class ResolverCartGateway {
+  // Shopify carts are fetched from Shopify on every read — already reconciled.
+  async reconcileStoredCart(cart) {
+    return cart;
+  }
   // Returns the gateway's wire-parsed Cart where the client Cart is expected.
   // Safe because client = wire + widenings only — enforced by the widening
   // assertions in cart-schema.spec.ts.

package/cart/gateways/resolver-cart-gateway.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../cart/gateways/resolver-cart-gateway.ts"],
-  "sourcesContent": ["\"use server\";\n\nimport type {\n  AddToCartPayload,\n  Cart,\n  CartLinePayload,\n  RemoveFromCartPayload,\n  UpdateCartDiscountCodesPayload,\n  UpdateCartLineItemPayload,\n} from \"../cart-types\";\nimport type { CartGateway } from \"./cart-gateway\";\n\nimport { getCanopyApiGateway } from \"../../gateways/canopy-api\";\n\n/**\n * @author Ryan\n * CartGateway that delegates all mutations to the canopy-api's cart\n * endpoints. Used for \"externalCart\" integrations (Shopify). canopy-api\n * handles credential resolution and upstream API calls.\n */\nclass ResolverCartGateway implements CartGateway {\n  // Returns the gateway's wire-parsed Cart where the client Cart is expected.\n  // Safe because client = wire + widenings only \u2014 enforced by the widening\n  // assertions in cart-schema.spec.ts.\n  async getCart(cartId: string): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartGet({ cartId });\n    } catch (error) {\n      console.warn(`Cart ${cartId} not found via canopy-api:`, error);\n      return null;\n    }\n  }\n\n  async createCart(\n    lines?: CartLinePayload[],\n    discountCodes?: string[],\n  ): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartCreate({\n        lines: lines?.map((line) => ({\n          merchandiseId: line.id,\n          quantity: line.quantity,\n          attributes: line.properties?.map((prop) => ({\n            key: prop.key,\n            value: String(prop.value),\n          })),\n          sellingPlanId: line.sellingPlanId,\n        })),\n        discountCodes,\n      });\n    } catch (error) {\n      console.warn(\"Failed to create cart via canopy-api:\", error);\n      return null;\n    }\n  }\n\n  async addToCart(cartPayload: AddToCartPayload): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartAddLines({\n        cartId: cartPayload.cartId,\n        lines: cartPayload.lines.map((line) => ({\n          merchandiseId: line.id,\n          quantity: line.quantity,\n          attributes: line.properties?.map((prop) => ({\n            key: prop.key,\n            value: String(prop.value),\n          })),\n          sellingPlanId: line.sellingPlanId,\n        })),\n      });\n    } catch (error) {\n      console.warn(\"Failed to add to cart via canopy-api:\", error);\n      return null;\n    }\n  }\n\n  async updateCartLineItem(\n    cartPayload: UpdateCartLineItemPayload,\n  ): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartUpdateLines({\n        cartId: cartPayload.cartId,\n        lines: [\n          {\n            lineId: cartPayload.line.id,\n            quantity: cartPayload.line.quantity,\n            attributes: cartPayload.line.properties?.map((prop) => ({\n              key: prop.key,\n              value: String(prop.value),\n            })),\n            sellingPlanId: cartPayload.line.sellingPlanId,\n          },\n        ],\n      });\n    } catch (error) {\n      console.warn(\"Failed to update cart line via canopy-api:\", error);\n      return null;\n    }\n  }\n\n  async removeCartLineItems(\n    cartPayload: RemoveFromCartPayload,\n  ): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartRemoveLines({\n        cartId: cartPayload.cartId,\n        lineIds: cartPayload.lineIds,\n      });\n    } catch (error) {\n      console.warn(\"Failed to remove cart lines via canopy-api:\", error);\n      return null;\n    }\n  }\n\n  async updateCartDiscountCodes(\n    cartPayload: UpdateCartDiscountCodesPayload,\n  ): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartUpdateDiscountCodes({\n        cartId: cartPayload.cartId,\n        discountCodes: cartPayload.discountCodes,\n      });\n    } catch (error) {\n      console.warn(\"Failed to update discount codes via canopy-api:\", error);\n      return null;\n    }\n  }\n}\n\nexport async function createResolverCartGateway(): Promise<CartGateway> {\n  return new ResolverCartGateway();\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["\"use server\";\n\nimport type {\n  AddToCartPayload,\n  Cart,\n  CartLinePayload,\n  RemoveFromCartPayload,\n  UpdateCartDiscountCodesPayload,\n  UpdateCartLineItemPayload,\n} from \"../cart-types\";\nimport type { CartGateway } from \"./cart-gateway\";\n\nimport { getCanopyApiGateway } from \"../../gateways/canopy-api\";\n\n/**\n * @author Ryan\n * CartGateway that delegates all mutations to the canopy-api's cart\n * endpoints. Used for \"externalCart\" integrations (Shopify). canopy-api\n * handles credential resolution and upstream API calls.\n */\nclass ResolverCartGateway implements CartGateway {\n  // Shopify carts are fetched from Shopify on every read \u2014 already reconciled.\n  async reconcileStoredCart(cart: Cart): Promise<Cart> {\n    return cart;\n  }\n\n  // Returns the gateway's wire-parsed Cart where the client Cart is expected.\n  // Safe because client = wire + widenings only \u2014 enforced by the widening\n  // assertions in cart-schema.spec.ts.\n  async getCart(cartId: string): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartGet({ cartId });\n    } catch (error) {\n      console.warn(`Cart ${cartId} not found via canopy-api:`, error);\n      return null;\n    }\n  }\n\n  async createCart(\n    lines?: CartLinePayload[],\n    discountCodes?: string[],\n  ): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartCreate({\n        lines: lines?.map((line) => ({\n          merchandiseId: line.id,\n          quantity: line.quantity,\n          attributes: line.properties?.map((prop) => ({\n            key: prop.key,\n            value: String(prop.value),\n          })),\n          sellingPlanId: line.sellingPlanId,\n        })),\n        discountCodes,\n      });\n    } catch (error) {\n      console.warn(\"Failed to create cart via canopy-api:\", error);\n      return null;\n    }\n  }\n\n  async addToCart(cartPayload: AddToCartPayload): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartAddLines({\n        cartId: cartPayload.cartId,\n        lines: cartPayload.lines.map((line) => ({\n          merchandiseId: line.id,\n          quantity: line.quantity,\n          attributes: line.properties?.map((prop) => ({\n            key: prop.key,\n            value: String(prop.value),\n          })),\n          sellingPlanId: line.sellingPlanId,\n        })),\n      });\n    } catch (error) {\n      console.warn(\"Failed to add to cart via canopy-api:\", error);\n      return null;\n    }\n  }\n\n  async updateCartLineItem(\n    cartPayload: UpdateCartLineItemPayload,\n  ): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartUpdateLines({\n        cartId: cartPayload.cartId,\n        lines: [\n          {\n            lineId: cartPayload.line.id,\n            quantity: cartPayload.line.quantity,\n            attributes: cartPayload.line.properties?.map((prop) => ({\n              key: prop.key,\n              value: String(prop.value),\n            })),\n            sellingPlanId: cartPayload.line.sellingPlanId,\n          },\n        ],\n      });\n    } catch (error) {\n      console.warn(\"Failed to update cart line via canopy-api:\", error);\n      return null;\n    }\n  }\n\n  async removeCartLineItems(\n    cartPayload: RemoveFromCartPayload,\n  ): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartRemoveLines({\n        cartId: cartPayload.cartId,\n        lineIds: cartPayload.lineIds,\n      });\n    } catch (error) {\n      console.warn(\"Failed to remove cart lines via canopy-api:\", error);\n      return null;\n    }\n  }\n\n  async updateCartDiscountCodes(\n    cartPayload: UpdateCartDiscountCodesPayload,\n  ): Promise<Cart | null> {\n    try {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.cartUpdateDiscountCodes({\n        cartId: cartPayload.cartId,\n        discountCodes: cartPayload.discountCodes,\n      });\n    } catch (error) {\n      console.warn(\"Failed to update discount codes via canopy-api:\", error);\n      return null;\n    }\n  }\n}\n\nexport async function createResolverCartGateway(): Promise<CartGateway> {\n  return new ResolverCartGateway();\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/cart/gateways/stripe-cart-gateway.d.ts

@@ -13,6 +13,20 @@ declare class StripeCartGateway extends CookieBasedCartGateway {
         lineIdGenerator: typeof stripeLineIdGenerator;
         cartIdGenerator: typeof stripeCartIdGenerator;
         gatewayName: string;
+        reconcileLines: (lines: {
+            variantId: string;
+            quantity: number;
+        }[]) => Promise<({
+            variantId: string;
+            status: "purchasable";
+            unitPriceMinor: number;
+            compareAtPriceMinor: number | null;
+            currencyCode: string;
+            purchasableQuantity: number;
+        } | {
+            variantId: string;
+            status: "unavailable";
+        })[]>;
     };
 }
 export declare function createStripeCartGateway(): Promise<StripeCartGateway>;

package/cart/gateways/stripe-cart-gateway.js

@@ -1,4 +1,5 @@
 "use server";
+import { getCanopyApiGateway } from "../../gateways/canopy-api";
 import { REPLO_CART_COOKIE_NAME } from "./cart-constants";
 import { CookieBasedCartGateway } from "./cookie-cart-gateway";
 function stripeLineMergeFn(existingLines, newLine) {
@@ -16,7 +17,11 @@ class StripeCartGateway extends CookieBasedCartGateway {
     lineMergeFn: stripeLineMergeFn,
     lineIdGenerator: stripeLineIdGenerator,
     cartIdGenerator: stripeCartIdGenerator,
-    gatewayName: "Stripe"
+    gatewayName: "Stripe",
+    reconcileLines: async (lines) => {
+      const gateway = await getCanopyApiGateway();
+      return await gateway.reconcileCartLines({ lines });
+    }
   };
 }
 async function createStripeCartGateway() {

package/cart/gateways/stripe-cart-gateway.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../cart/gateways/stripe-cart-gateway.ts"],
-  "sourcesContent": ["\"use server\";\n\nimport type { CartLine, CartLinePayload } from \"../cart-types\";\n\nimport { REPLO_CART_COOKIE_NAME } from \"./cart-constants\";\nimport { CookieBasedCartGateway } from \"./cookie-cart-gateway\";\n\n/**\n * Merges lines by merchandise ID only (unlike default which also checks selling plan)\n */\nfunction stripeLineMergeFn(\n  existingLines: CartLine[],\n  newLine: CartLinePayload,\n): number {\n  return existingLines.findIndex((line) => line.merchandise?.id === newLine.id);\n}\n\nfunction stripeLineIdGenerator(): string {\n  return crypto.randomUUID();\n}\n\nfunction stripeCartIdGenerator(): string {\n  return crypto.randomUUID();\n}\n\nclass StripeCartGateway extends CookieBasedCartGateway {\n  protected readonly config = {\n    cookieName: REPLO_CART_COOKIE_NAME,\n    lineMergeFn: stripeLineMergeFn,\n    lineIdGenerator: stripeLineIdGenerator,\n    cartIdGenerator: stripeCartIdGenerator,\n    gatewayName: \"Stripe\",\n  };\n}\n\nexport async function createStripeCartGateway(): Promise<StripeCartGateway> {\n  return new StripeCartGateway();\n}\n"],
-  "mappings": ";AAIA,SAAS,8BAA8B;AACvC,SAAS,8BAA8B;AAKvC,SAAS,kBACP,eACA,SACQ;AACR,SAAO,cAAc,UAAU,CAAC,SAAS,KAAK,aAAa,OAAO,QAAQ,EAAE;AAC9E;AAEA,SAAS,wBAAgC;AACvC,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,wBAAgC;AACvC,SAAO,OAAO,WAAW;AAC3B;AAEA,MAAM,0BAA0B,uBAAuB;AAAA,EAClC,SAAS;AAAA,IAC1B,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,iBAAiB;AAAA,IACjB,aAAa;AAAA,EACf;AACF;AAEA,eAAsB,0BAAsD;AAC1E,SAAO,IAAI,kBAAkB;AAC/B;",
+  "sourcesContent": ["\"use server\";\n\nimport type { CartLine, CartLinePayload } from \"../cart-types\";\n\nimport { getCanopyApiGateway } from \"../../gateways/canopy-api\";\nimport { REPLO_CART_COOKIE_NAME } from \"./cart-constants\";\nimport { CookieBasedCartGateway } from \"./cookie-cart-gateway\";\n\n/**\n * Merges lines by merchandise ID only (unlike default which also checks selling plan)\n */\nfunction stripeLineMergeFn(\n  existingLines: CartLine[],\n  newLine: CartLinePayload,\n): number {\n  return existingLines.findIndex((line) => line.merchandise?.id === newLine.id);\n}\n\nfunction stripeLineIdGenerator(): string {\n  return crypto.randomUUID();\n}\n\nfunction stripeCartIdGenerator(): string {\n  return crypto.randomUUID();\n}\n\nclass StripeCartGateway extends CookieBasedCartGateway {\n  protected readonly config = {\n    cookieName: REPLO_CART_COOKIE_NAME,\n    lineMergeFn: stripeLineMergeFn,\n    lineIdGenerator: stripeLineIdGenerator,\n    cartIdGenerator: stripeCartIdGenerator,\n    gatewayName: \"Stripe\",\n    reconcileLines: async (\n      lines: { variantId: string; quantity: number }[],\n    ) => {\n      const gateway = await getCanopyApiGateway();\n      return await gateway.reconcileCartLines({ lines });\n    },\n  };\n}\n\nexport async function createStripeCartGateway(): Promise<StripeCartGateway> {\n  return new StripeCartGateway();\n}\n"],
+  "mappings": ";AAIA,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;AACvC,SAAS,8BAA8B;AAKvC,SAAS,kBACP,eACA,SACQ;AACR,SAAO,cAAc,UAAU,CAAC,SAAS,KAAK,aAAa,OAAO,QAAQ,EAAE;AAC9E;AAEA,SAAS,wBAAgC;AACvC,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,wBAAgC;AACvC,SAAO,OAAO,WAAW;AAC3B;AAEA,MAAM,0BAA0B,uBAAuB;AAAA,EAClC,SAAS;AAAA,IAC1B,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,iBAAiB;AAAA,IACjB,aAAa;AAAA,IACb,gBAAgB,OACd,UACG;AACH,YAAM,UAAU,MAAM,oBAAoB;AAC1C,aAAO,MAAM,QAAQ,mBAAmB,EAAE,MAAM,CAAC;AAAA,IACnD;AAAA,EACF;AACF;AAEA,eAAsB,0BAAsD;AAC1E,SAAO,IAAI,kBAAkB;AAC/B;",
   "names": []
 }

package/cart/hooks/use-add-to-cart.d.ts

@@ -58,6 +58,8 @@ export declare function findMerchandiseInQueryCache({ queryClient, merchandiseId
  * ```
  */
 export declare function useAddToCart(): {
-    addToCart: (items: AddToCartItem[], openCartAfterAdd?: boolean) => Promise<void>;
+    addToCart: (items: AddToCartItem[], openCartAfterAdd?: boolean) => Promise<{
+        adjustments: import("../cart-types").CartLineAdjustment[];
+    }>;
     isAdding: boolean;
 };

package/cart/hooks/use-add-to-cart.js

@@ -108,7 +108,7 @@ function useAddToCart() {
             merchandise
           };
         });
-        await cart.addToCart(cartLines, openCartAfterAdd);
+        return await cart.addToCart(cartLines, openCartAfterAdd);
       } finally {
         setIsAdding(false);
       }

package/cart/hooks/use-add-to-cart.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../cart/hooks/use-add-to-cart.ts"],
-  "sourcesContent": ["/**\n * Hook for adding items to cart using merchandiseId directly (e.g. variant GIDs from data loaders).\n * Merchandise display data for optimistic UI is auto-resolved from the React Query cache.\n * @module\n */\n\"use client\";\n\nimport type { QueryClient } from \"@tanstack/react-query\";\nimport type { Product } from \"../../loaders/loader-schemas\";\nimport type { CartLineAttribute, CartLineMerchandise } from \"../cart-types\";\n\nimport React from \"react\";\n\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport { fromMajorUnitsToMinorUnits } from \"schemas/money\";\n\nimport { DATA_LOADER_KEYS } from \"../../loaders/loader-keys\";\nimport { useCartInternal } from \"../cart-provider\";\nimport { REPLO_ATTRIBUTION_PROPERTY } from \"../cart-types\";\n\ntype ProductListLike = { products: Product[] };\n\n/**\n * Describes a single item to add to the cart. Uses the merchandiseId\n * (e.g. a variant GID) directly from data loader output. Product\n * display data for optimistic UI is resolved automatically from the\n * React Query cache for both single-product loaders (e.g. ProductLoader)\n * and product-list loaders (e.g. CollectionProductsLoader,\n * RebuyRecommendationsLoader). Pass `merchandise` explicitly to bypass\n * the cache lookup when the variant is known but its product was not\n * loaded via a supported loader.\n */\nexport interface AddToCartItem {\n  /** The cart-addressable merchandise ID (e.g. `product.variants[N].id` from loader output). */\n  merchandiseId: string;\n  quantity?: number;\n  sellingPlanId?: string | null;\n  /** Custom line item properties (appear on the order). */\n  properties?: CartLineAttribute[];\n  merchandise?: CartLineMerchandise;\n}\n\n/**\n * Loaders whose cached value is a single Product. Scanned for variant\n * matches first since they carry the richest product data.\n */\nconst PRODUCT_LOADER_KEYS = [\n  DATA_LOADER_KEYS.SHOPIFY_PRODUCT,\n  DATA_LOADER_KEYS.REPLO_PRODUCT,\n] as const;\n\nconst PRODUCT_LIST_LOADER_KEYS = [\n  DATA_LOADER_KEYS.SHOPIFY_COLLECTION_PRODUCTS,\n  DATA_LOADER_KEYS.REBUY_RECOMMENDATIONS,\n] as const;\n\nfunction getMerchandiseFromProduct({\n  product,\n  merchandiseId,\n}: {\n  product: Product;\n  merchandiseId: string;\n}): CartLineMerchandise | undefined {\n  if (!product.variants) {\n    return undefined;\n  }\n\n  const matchingVariant = product.variants.find(\n    (variant) => variant.id === merchandiseId,\n  );\n\n  if (!matchingVariant) {\n    return undefined;\n  }\n\n  const image = matchingVariant.image ?? product.featuredImage ?? null;\n  return {\n    id: merchandiseId,\n    product: {\n      id: product.id,\n      title: product.title ?? \"\",\n      sellingPlanGroups: product.sellingPlanGroups ?? [],\n    },\n    title: matchingVariant.title ?? \"\",\n    // NOTE (Max, 2026-08-03): loader prices are decimal MoneyV2 strings, but the\n    // cart is integer minor units, so convert at this storefront\u2192cart boundary \u2014\n    // a raw parseFloat would store \"19.99\" as 19 minor units (~100\u00D7 too cheap).\n    price: matchingVariant.price\n      ? fromMajorUnitsToMinorUnits(matchingVariant.price)\n      : 0,\n    compareAtPrice: matchingVariant.compareAtPrice\n      ? fromMajorUnitsToMinorUnits(matchingVariant.compareAtPrice)\n      : null,\n    image: image ? { url: image.url, altText: image.altText } : null,\n    selectedOptions: matchingVariant.selectedOptions ?? [],\n  };\n}\n\nexport function findMerchandiseInQueryCache({\n  queryClient,\n  merchandiseId,\n}: {\n  queryClient: QueryClient;\n  merchandiseId: string;\n}): CartLineMerchandise | undefined {\n  for (const loaderKey of PRODUCT_LOADER_KEYS) {\n    const productQueries = queryClient.getQueriesData<Product>({\n      queryKey: [loaderKey],\n    });\n\n    for (const [, productData] of productQueries) {\n      if (!productData) {\n        continue;\n      }\n\n      const merchandise = getMerchandiseFromProduct({\n        product: productData,\n        merchandiseId,\n      });\n      if (merchandise) {\n        return merchandise;\n      }\n    }\n  }\n\n  for (const loaderKey of PRODUCT_LIST_LOADER_KEYS) {\n    const productListQueries = queryClient.getQueriesData<ProductListLike>({\n      queryKey: [loaderKey],\n    });\n\n    for (const [, productListData] of productListQueries) {\n      for (const product of productListData?.products ?? []) {\n        const merchandise = getMerchandiseFromProduct({\n          product,\n          merchandiseId,\n        });\n        if (merchandise) {\n          return merchandise;\n        }\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Hook for adding items to cart using merchandise IDs from data loader output.\n *\n * This is the primary hook for adding items to cart in the data-loader\n * architecture. It works with the resolver-backed CartGateway so the scaffold\n * never needs direct integration credentials.\n *\n * Merchandise display data (title, price, image) for optimistic cart UI is\n * auto-resolved from the React Query cache for both single-product loaders\n * (e.g. `ProductLoader`) and product-list loaders (e.g.\n * `CollectionProductsLoader`, `RebuyRecommendationsLoader`). Just pass the\n * merchandiseId. Pass `merchandise` explicitly only when the variant is\n * known but its product was not loaded via a supported loader.\n *\n * @example\n * ```tsx\n * import { useAddToCart } from \"@replohq/sdk/cart/hooks/use-add-to-cart\";\n *\n * function AddToCartButton({ variant }) {\n *   const { addToCart, isAdding } = useAddToCart();\n *\n *   return (\n *     <button\n *       disabled={!variant.availableForSale || isAdding}\n *       onClick={() => {\n *         addToCart([{ merchandiseId: variant.id, quantity: 1 }]);\n *       }}\n *     >\n *       {isAdding ? \"Adding...\" : \"Add to Cart\"}\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useAddToCart() {\n  const cart = useCartInternal();\n  const queryClient = useQueryClient();\n  const [isAdding, setIsAdding] = React.useState(false);\n\n  const addToCart = React.useCallback(\n    async (items: AddToCartItem[], openCartAfterAdd = true) => {\n      setIsAdding(true);\n      try {\n        const cartLines = items.map((item) => {\n          const hasReploAttribution = item.properties?.some(\n            (prop) => prop.key === REPLO_ATTRIBUTION_PROPERTY.key,\n          );\n          const properties = hasReploAttribution\n            ? item.properties ?? []\n            : [REPLO_ATTRIBUTION_PROPERTY, ...(item.properties ?? [])];\n\n          const merchandise =\n            item.merchandise ??\n            findMerchandiseInQueryCache({\n              queryClient,\n              merchandiseId: item.merchandiseId,\n            });\n\n          return {\n            id: item.merchandiseId,\n            quantity: item.quantity ?? 1,\n            sellingPlanId: item.sellingPlanId ?? undefined,\n            properties,\n            merchandise,\n          };\n        });\n\n        await cart.addToCart(cartLines, openCartAfterAdd);\n      } finally {\n        setIsAdding(false);\n      }\n    },\n    [cart, queryClient],\n  );\n\n  return { addToCart, isAdding };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Hook for adding items to cart using merchandiseId directly (e.g. variant GIDs from data loaders).\n * Merchandise display data for optimistic UI is auto-resolved from the React Query cache.\n * `addToCart` resolves with `{ adjustments }` describing anything the server\n * changed about the request (a quantity clamped to stock, an unavailable line\n * removed) so the storefront can show a notice.\n * @module\n */\n\"use client\";\n\nimport type { QueryClient } from \"@tanstack/react-query\";\nimport type { Product } from \"../../loaders/loader-schemas\";\nimport type { CartLineAttribute, CartLineMerchandise } from \"../cart-types\";\n\nimport React from \"react\";\n\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport { fromMajorUnitsToMinorUnits } from \"schemas/money\";\n\nimport { DATA_LOADER_KEYS } from \"../../loaders/loader-keys\";\nimport { useCartInternal } from \"../cart-provider\";\nimport { REPLO_ATTRIBUTION_PROPERTY } from \"../cart-types\";\n\ntype ProductListLike = { products: Product[] };\n\n/**\n * Describes a single item to add to the cart. Uses the merchandiseId\n * (e.g. a variant GID) directly from data loader output. Product\n * display data for optimistic UI is resolved automatically from the\n * React Query cache for both single-product loaders (e.g. ProductLoader)\n * and product-list loaders (e.g. CollectionProductsLoader,\n * RebuyRecommendationsLoader). Pass `merchandise` explicitly to bypass\n * the cache lookup when the variant is known but its product was not\n * loaded via a supported loader.\n */\nexport interface AddToCartItem {\n  /** The cart-addressable merchandise ID (e.g. `product.variants[N].id` from loader output). */\n  merchandiseId: string;\n  quantity?: number;\n  sellingPlanId?: string | null;\n  /** Custom line item properties (appear on the order). */\n  properties?: CartLineAttribute[];\n  merchandise?: CartLineMerchandise;\n}\n\n/**\n * Loaders whose cached value is a single Product. Scanned for variant\n * matches first since they carry the richest product data.\n */\nconst PRODUCT_LOADER_KEYS = [\n  DATA_LOADER_KEYS.SHOPIFY_PRODUCT,\n  DATA_LOADER_KEYS.REPLO_PRODUCT,\n] as const;\n\nconst PRODUCT_LIST_LOADER_KEYS = [\n  DATA_LOADER_KEYS.SHOPIFY_COLLECTION_PRODUCTS,\n  DATA_LOADER_KEYS.REBUY_RECOMMENDATIONS,\n] as const;\n\nfunction getMerchandiseFromProduct({\n  product,\n  merchandiseId,\n}: {\n  product: Product;\n  merchandiseId: string;\n}): CartLineMerchandise | undefined {\n  if (!product.variants) {\n    return undefined;\n  }\n\n  const matchingVariant = product.variants.find(\n    (variant) => variant.id === merchandiseId,\n  );\n\n  if (!matchingVariant) {\n    return undefined;\n  }\n\n  const image = matchingVariant.image ?? product.featuredImage ?? null;\n  return {\n    id: merchandiseId,\n    product: {\n      id: product.id,\n      title: product.title ?? \"\",\n      sellingPlanGroups: product.sellingPlanGroups ?? [],\n    },\n    title: matchingVariant.title ?? \"\",\n    // NOTE (Max, 2026-08-03): loader prices are decimal MoneyV2 strings, but the\n    // cart is integer minor units, so convert at this storefront\u2192cart boundary \u2014\n    // a raw parseFloat would store \"19.99\" as 19 minor units (~100\u00D7 too cheap).\n    price: matchingVariant.price\n      ? fromMajorUnitsToMinorUnits(matchingVariant.price)\n      : 0,\n    compareAtPrice: matchingVariant.compareAtPrice\n      ? fromMajorUnitsToMinorUnits(matchingVariant.compareAtPrice)\n      : null,\n    image: image ? { url: image.url, altText: image.altText } : null,\n    selectedOptions: matchingVariant.selectedOptions ?? [],\n  };\n}\n\nexport function findMerchandiseInQueryCache({\n  queryClient,\n  merchandiseId,\n}: {\n  queryClient: QueryClient;\n  merchandiseId: string;\n}): CartLineMerchandise | undefined {\n  for (const loaderKey of PRODUCT_LOADER_KEYS) {\n    const productQueries = queryClient.getQueriesData<Product>({\n      queryKey: [loaderKey],\n    });\n\n    for (const [, productData] of productQueries) {\n      if (!productData) {\n        continue;\n      }\n\n      const merchandise = getMerchandiseFromProduct({\n        product: productData,\n        merchandiseId,\n      });\n      if (merchandise) {\n        return merchandise;\n      }\n    }\n  }\n\n  for (const loaderKey of PRODUCT_LIST_LOADER_KEYS) {\n    const productListQueries = queryClient.getQueriesData<ProductListLike>({\n      queryKey: [loaderKey],\n    });\n\n    for (const [, productListData] of productListQueries) {\n      for (const product of productListData?.products ?? []) {\n        const merchandise = getMerchandiseFromProduct({\n          product,\n          merchandiseId,\n        });\n        if (merchandise) {\n          return merchandise;\n        }\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Hook for adding items to cart using merchandise IDs from data loader output.\n *\n * This is the primary hook for adding items to cart in the data-loader\n * architecture. It works with the resolver-backed CartGateway so the scaffold\n * never needs direct integration credentials.\n *\n * Merchandise display data (title, price, image) for optimistic cart UI is\n * auto-resolved from the React Query cache for both single-product loaders\n * (e.g. `ProductLoader`) and product-list loaders (e.g.\n * `CollectionProductsLoader`, `RebuyRecommendationsLoader`). Just pass the\n * merchandiseId. Pass `merchandise` explicitly only when the variant is\n * known but its product was not loaded via a supported loader.\n *\n * @example\n * ```tsx\n * import { useAddToCart } from \"@replohq/sdk/cart/hooks/use-add-to-cart\";\n *\n * function AddToCartButton({ variant }) {\n *   const { addToCart, isAdding } = useAddToCart();\n *\n *   return (\n *     <button\n *       disabled={!variant.availableForSale || isAdding}\n *       onClick={() => {\n *         addToCart([{ merchandiseId: variant.id, quantity: 1 }]);\n *       }}\n *     >\n *       {isAdding ? \"Adding...\" : \"Add to Cart\"}\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useAddToCart() {\n  const cart = useCartInternal();\n  const queryClient = useQueryClient();\n  const [isAdding, setIsAdding] = React.useState(false);\n\n  const addToCart = React.useCallback(\n    async (items: AddToCartItem[], openCartAfterAdd = true) => {\n      setIsAdding(true);\n      try {\n        const cartLines = items.map((item) => {\n          const hasReploAttribution = item.properties?.some(\n            (prop) => prop.key === REPLO_ATTRIBUTION_PROPERTY.key,\n          );\n          const properties = hasReploAttribution\n            ? item.properties ?? []\n            : [REPLO_ATTRIBUTION_PROPERTY, ...(item.properties ?? [])];\n\n          const merchandise =\n            item.merchandise ??\n            findMerchandiseInQueryCache({\n              queryClient,\n              merchandiseId: item.merchandiseId,\n            });\n\n          return {\n            id: item.merchandiseId,\n            quantity: item.quantity ?? 1,\n            sellingPlanId: item.sellingPlanId ?? undefined,\n            properties,\n            merchandise,\n          };\n        });\n\n        return await cart.addToCart(cartLines, openCartAfterAdd);\n      } finally {\n        setIsAdding(false);\n      }\n    },\n    [cart, queryClient],\n  );\n\n  return { addToCart, isAdding };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/cart/utils/cart-adjustments.d.ts

@@ -0,0 +1,29 @@
+import type { Cart, CartLine, CartLineAdjustment, CartLinePayload } from "../cart-types";
+/**
+ * Diff what an add intended against the cart the server saved, as
+ * Shopify-style adjustment notices. Intent is built from the request's own
+ * identity (variant id + selling plan) on top of the pre-mutation server
+ * cart — never from the optimistic display cart, whose lines can lack
+ * merchandise (query-cache miss) or a resolvable plan allocation and would
+ * silently drop or misattribute the comparison. The write reconciles the
+ * whole cart, so lines the shopper didn't touch are covered too.
+ */
+export declare function deriveAddToCartAdjustments({ cartBeforeAdd, requestedLines, savedCart, }: {
+    cartBeforeAdd: Cart;
+    requestedLines: CartLinePayload[];
+    savedCart: Cart;
+}): CartLineAdjustment[];
+/**
+ * Same diff for a line update. The intended totals move the edited line's
+ * quantity to the requested selling plan — `undefined` keeps the line's
+ * current plan, explicit `null` removes it (the resolver forwards the
+ * requested plan, so a successful A→B switch must not read as a removal).
+ * A deliberate removal (quantity 0) intends nothing and reports nothing.
+ */
+export declare function deriveUpdateCartAdjustments({ cartBeforeUpdate, editedLine, requestedQuantity, requestedSellingPlanId, savedCart, }: {
+    cartBeforeUpdate: Cart;
+    editedLine: CartLine;
+    requestedQuantity: number;
+    requestedSellingPlanId: string | null | undefined;
+    savedCart: Cart;
+}): CartLineAdjustment[];

package/cart/utils/cart-adjustments.js

@@ -0,0 +1,81 @@
+function totalKey(variantId, sellingPlanId) {
+  return `${variantId}::${sellingPlanId ?? ""}`;
+}
+function addToTotals(totals, variantId, sellingPlanId, delta) {
+  const key = totalKey(variantId, sellingPlanId);
+  const entry = totals.get(key);
+  if (entry) {
+    entry.quantity += delta;
+  } else {
+    totals.set(key, { variantId, quantity: delta });
+  }
+}
+function totalsFromCart(cart) {
+  const totals = /* @__PURE__ */ new Map();
+  for (const line of cart.lines) {
+    if (!line.merchandise) {
+      continue;
+    }
+    addToTotals(
+      totals,
+      line.merchandise.id,
+      line.sellingPlanAllocation?.sellingPlan.id ?? null,
+      line.quantity
+    );
+  }
+  return totals;
+}
+function diffTotals(intended, saved) {
+  const adjustments = [];
+  for (const [key, entry] of intended) {
+    const appliedQuantity = saved.get(key)?.quantity ?? 0;
+    if (appliedQuantity >= entry.quantity) {
+      continue;
+    }
+    adjustments.push(
+      appliedQuantity > 0 ? {
+        type: "quantityClampedToStock",
+        variantId: entry.variantId,
+        requested: entry.quantity,
+        applied: appliedQuantity
+      } : { type: "unavailableLineRemoved", variantId: entry.variantId }
+    );
+  }
+  return adjustments;
+}
+function deriveAddToCartAdjustments({
+  cartBeforeAdd,
+  requestedLines,
+  savedCart
+}) {
+  const intended = totalsFromCart(cartBeforeAdd);
+  for (const line of requestedLines) {
+    addToTotals(intended, line.id, line.sellingPlanId ?? null, line.quantity);
+  }
+  return diffTotals(intended, totalsFromCart(savedCart));
+}
+function deriveUpdateCartAdjustments({
+  cartBeforeUpdate,
+  editedLine,
+  requestedQuantity,
+  requestedSellingPlanId,
+  savedCart
+}) {
+  const variantId = editedLine.merchandise?.id;
+  if (!variantId) {
+    return [];
+  }
+  const currentPlanId = editedLine.sellingPlanAllocation?.sellingPlan.id ?? null;
+  const intended = totalsFromCart(cartBeforeUpdate);
+  addToTotals(intended, variantId, currentPlanId, -editedLine.quantity);
+  if (requestedQuantity > 0) {
+    const intendedPlanId = requestedSellingPlanId === void 0 ? currentPlanId : requestedSellingPlanId;
+    addToTotals(intended, variantId, intendedPlanId, requestedQuantity);
+  }
+  return diffTotals(intended, totalsFromCart(savedCart));
+}
+export {
+  deriveAddToCartAdjustments,
+  deriveUpdateCartAdjustments
+};
+//# sourceMappingURL=cart-adjustments.js.map

package/cart/utils/cart-adjustments.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../cart/utils/cart-adjustments.ts"],
+  "sourcesContent": ["import type {\n  Cart,\n  CartLine,\n  CartLineAdjustment,\n  CartLinePayload,\n} from \"../cart-types\";\n\ntype VariantPlanTotals = Map<string, { variantId: string; quantity: number }>;\n\nfunction totalKey(variantId: string, sellingPlanId: string | null): string {\n  return `${variantId}::${sellingPlanId ?? \"\"}`;\n}\n\nfunction addToTotals(\n  totals: VariantPlanTotals,\n  variantId: string,\n  sellingPlanId: string | null,\n  delta: number,\n) {\n  const key = totalKey(variantId, sellingPlanId);\n  const entry = totals.get(key);\n  if (entry) {\n    entry.quantity += delta;\n  } else {\n    totals.set(key, { variantId, quantity: delta });\n  }\n}\n\n// Shopify separates lines for the same variant + plan by custom properties\n// (two engravings, two lines), so quantities are summed per variant + plan \u2014\n// notices are variant-level, never per property-split line.\nfunction totalsFromCart(cart: Cart): VariantPlanTotals {\n  const totals: VariantPlanTotals = new Map();\n  for (const line of cart.lines) {\n    if (!line.merchandise) {\n      continue;\n    }\n    addToTotals(\n      totals,\n      line.merchandise.id,\n      line.sellingPlanAllocation?.sellingPlan.id ?? null,\n      line.quantity,\n    );\n  }\n  return totals;\n}\n\nfunction diffTotals(\n  intended: VariantPlanTotals,\n  saved: VariantPlanTotals,\n): CartLineAdjustment[] {\n  const adjustments: CartLineAdjustment[] = [];\n  for (const [key, entry] of intended) {\n    const appliedQuantity = saved.get(key)?.quantity ?? 0;\n    if (appliedQuantity >= entry.quantity) {\n      continue;\n    }\n    adjustments.push(\n      appliedQuantity > 0\n        ? {\n            type: \"quantityClampedToStock\",\n            variantId: entry.variantId,\n            requested: entry.quantity,\n            applied: appliedQuantity,\n          }\n        : { type: \"unavailableLineRemoved\", variantId: entry.variantId },\n    );\n  }\n  return adjustments;\n}\n\n/**\n * Diff what an add intended against the cart the server saved, as\n * Shopify-style adjustment notices. Intent is built from the request's own\n * identity (variant id + selling plan) on top of the pre-mutation server\n * cart \u2014 never from the optimistic display cart, whose lines can lack\n * merchandise (query-cache miss) or a resolvable plan allocation and would\n * silently drop or misattribute the comparison. The write reconciles the\n * whole cart, so lines the shopper didn't touch are covered too.\n */\nexport function deriveAddToCartAdjustments({\n  cartBeforeAdd,\n  requestedLines,\n  savedCart,\n}: {\n  cartBeforeAdd: Cart;\n  requestedLines: CartLinePayload[];\n  savedCart: Cart;\n}): CartLineAdjustment[] {\n  const intended = totalsFromCart(cartBeforeAdd);\n  for (const line of requestedLines) {\n    addToTotals(intended, line.id, line.sellingPlanId ?? null, line.quantity);\n  }\n  return diffTotals(intended, totalsFromCart(savedCart));\n}\n\n/**\n * Same diff for a line update. The intended totals move the edited line's\n * quantity to the requested selling plan \u2014 `undefined` keeps the line's\n * current plan, explicit `null` removes it (the resolver forwards the\n * requested plan, so a successful A\u2192B switch must not read as a removal).\n * A deliberate removal (quantity 0) intends nothing and reports nothing.\n */\nexport function deriveUpdateCartAdjustments({\n  cartBeforeUpdate,\n  editedLine,\n  requestedQuantity,\n  requestedSellingPlanId,\n  savedCart,\n}: {\n  cartBeforeUpdate: Cart;\n  editedLine: CartLine;\n  requestedQuantity: number;\n  requestedSellingPlanId: string | null | undefined;\n  savedCart: Cart;\n}): CartLineAdjustment[] {\n  const variantId = editedLine.merchandise?.id;\n  if (!variantId) {\n    return [];\n  }\n  const currentPlanId =\n    editedLine.sellingPlanAllocation?.sellingPlan.id ?? null;\n  const intended = totalsFromCart(cartBeforeUpdate);\n  addToTotals(intended, variantId, currentPlanId, -editedLine.quantity);\n  if (requestedQuantity > 0) {\n    const intendedPlanId =\n      requestedSellingPlanId === undefined\n        ? currentPlanId\n        : requestedSellingPlanId;\n    addToTotals(intended, variantId, intendedPlanId, requestedQuantity);\n  }\n  return diffTotals(intended, totalsFromCart(savedCart));\n}\n"],
+  "mappings": "AASA,SAAS,SAAS,WAAmB,eAAsC;AACzE,SAAO,GAAG,SAAS,KAAK,iBAAiB,EAAE;AAC7C;AAEA,SAAS,YACP,QACA,WACA,eACA,OACA;AACA,QAAM,MAAM,SAAS,WAAW,aAAa;AAC7C,QAAM,QAAQ,OAAO,IAAI,GAAG;AAC5B,MAAI,OAAO;AACT,UAAM,YAAY;AAAA,EACpB,OAAO;AACL,WAAO,IAAI,KAAK,EAAE,WAAW,UAAU,MAAM,CAAC;AAAA,EAChD;AACF;AAKA,SAAS,eAAe,MAA+B;AACrD,QAAM,SAA4B,oBAAI,IAAI;AAC1C,aAAW,QAAQ,KAAK,OAAO;AAC7B,QAAI,CAAC,KAAK,aAAa;AACrB;AAAA,IACF;AACA;AAAA,MACE;AAAA,MACA,KAAK,YAAY;AAAA,MACjB,KAAK,uBAAuB,YAAY,MAAM;AAAA,MAC9C,KAAK;AAAA,IACP;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,WACP,UACA,OACsB;AACtB,QAAM,cAAoC,CAAC;AAC3C,aAAW,CAAC,KAAK,KAAK,KAAK,UAAU;AACnC,UAAM,kBAAkB,MAAM,IAAI,GAAG,GAAG,YAAY;AACpD,QAAI,mBAAmB,MAAM,UAAU;AACrC;AAAA,IACF;AACA,gBAAY;AAAA,MACV,kBAAkB,IACd;AAAA,QACE,MAAM;AAAA,QACN,WAAW,MAAM;AAAA,QACjB,WAAW,MAAM;AAAA,QACjB,SAAS;AAAA,MACX,IACA,EAAE,MAAM,0BAA0B,WAAW,MAAM,UAAU;AAAA,IACnE;AAAA,EACF;AACA,SAAO;AACT;AAWO,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AACF,GAIyB;AACvB,QAAM,WAAW,eAAe,aAAa;AAC7C,aAAW,QAAQ,gBAAgB;AACjC,gBAAY,UAAU,KAAK,IAAI,KAAK,iBAAiB,MAAM,KAAK,QAAQ;AAAA,EAC1E;AACA,SAAO,WAAW,UAAU,eAAe,SAAS,CAAC;AACvD;AASO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMyB;AACvB,QAAM,YAAY,WAAW,aAAa;AAC1C,MAAI,CAAC,WAAW;AACd,WAAO,CAAC;AAAA,EACV;AACA,QAAM,gBACJ,WAAW,uBAAuB,YAAY,MAAM;AACtD,QAAM,WAAW,eAAe,gBAAgB;AAChD,cAAY,UAAU,WAAW,eAAe,CAAC,WAAW,QAAQ;AACpE,MAAI,oBAAoB,GAAG;AACzB,UAAM,iBACJ,2BAA2B,SACvB,gBACA;AACN,gBAAY,UAAU,WAAW,gBAAgB,iBAAiB;AAAA,EACpE;AACA,SAAO,WAAW,UAAU,eAAe,SAAS,CAAC;AACvD;",
+  "names": []
+}

package/cart/utils/cart-utils.d.ts

@@ -1,3 +1,4 @@
+import type { ReconciledCartLine } from "../../gateways/canopy-api";
 import type { Cart, CartLine } from "../cart-types";
 export interface CartTotals {
     subtotal: number;
@@ -19,6 +20,19 @@ export declare function calculateLineItemsSubtotal(lineItems: CartLine[]): numbe
  * checkout analytics) reports $0 for a priced cart.
  */
 export declare function recalculateCartCost(cart: Cart): Cart;
+/**
+ * Rewrite a cookie cart with the catalog's current facts: live prices always,
+ * unavailable lines dropped, and — on write paths only — quantities clamped to
+ * the purchasable remainder. Reads never clamp (`clampQuantities: false`):
+ * a quantity change without messaging is worse than one the mutation or
+ * checkout path reports, mirroring Shopify's cart behavior.
+ *
+ * `reconciledLines` must be the catalog's answer for this cart's
+ * merchandise-bearing lines in order — the shape reconcileCartLines returns.
+ */
+export declare function applyCartLineReconciliation(cart: Cart, reconciledLines: ReconciledCartLine[], { clampQuantities }: {
+    clampQuantities: boolean;
+}): Cart;
 /**
  * Calculate cart totals including subtotal, discounts, and final total.
  * When cart cost data is provided (from Shopify), uses the actual totalAmount

package/cart/utils/cart-utils.js

@@ -1,5 +1,8 @@
 import { formatAmount } from "../../_vendor/schemas/money.mjs";
+import { CanopyError } from "../../lib/canopy-error";
 import { getCartLinePricing } from "./variant-to-cart-line";
+class CartReconciliationMismatchError extends CanopyError {
+}
 function calculateLineItemsSubtotal(lineItems) {
   return lineItems.reduce(
     (sum, item) => sum + getCartLinePricing(item).finalPrice * item.quantity,
@@ -18,6 +21,45 @@ function recalculateCartCost(cart) {
     discountAllocations: []
   };
 }
+function applyCartLineReconciliation(cart, reconciledLines, { clampQuantities }) {
+  let reconciledIndex = 0;
+  const lines = cart.lines.flatMap((line) => {
+    if (!line.merchandise) {
+      return [line];
+    }
+    const catalogLine = reconciledLines[reconciledIndex];
+    reconciledIndex += 1;
+    if (!catalogLine || catalogLine.variantId !== line.merchandise.id) {
+      throw new CartReconciliationMismatchError({
+        message: "Reconciled lines do not match the cart's lines",
+        additionalData: {
+          cartId: cart.id,
+          variantId: line.merchandise.id,
+          reconciledVariantId: catalogLine?.variantId ?? null
+        }
+      });
+    }
+    if (catalogLine.status === "unavailable") {
+      return [];
+    }
+    const quantity = clampQuantities ? Math.min(line.quantity, catalogLine.purchasableQuantity) : line.quantity;
+    if (quantity <= 0) {
+      return [];
+    }
+    return [
+      {
+        ...line,
+        quantity,
+        merchandise: {
+          ...line.merchandise,
+          price: catalogLine.unitPriceMinor,
+          compareAtPrice: catalogLine.compareAtPriceMinor
+        }
+      }
+    ];
+  });
+  return recalculateCartCost({ ...cart, lines });
+}
 function calculateCartTotals({
   lineItems,
   cart
@@ -52,6 +94,7 @@ function formatSellingPlanId(sellingPlanId) {
   return `gid://shopify/SellingPlan/${sellingPlanId}`;
 }
 export {
+  applyCartLineReconciliation,
   calculateCartTotals,
   calculateLineItemsSubtotal,
   formatPrice,

package/cart/utils/cart-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../cart/utils/cart-utils.ts"],
-  "sourcesContent": ["import type { Cart, CartLine } from \"../cart-types\";\n\nimport { formatAmount } from \"schemas/money\";\n\nimport { getCartLinePricing } from \"./variant-to-cart-line\";\n\nexport interface CartTotals {\n  subtotal: number;\n  discountAmount: number;\n  totalSavings: number;\n  total: number;\n}\n\n/**\n * Sum the final (post selling-plan) price of every line item in the cart.\n * This is the authoritative subtotal for cookie-based carts, which have no\n * server-computed cost to rely on.\n */\nexport function calculateLineItemsSubtotal(lineItems: CartLine[]): number {\n  return lineItems.reduce(\n    (sum, item) => sum + getCartLinePricing(item).finalPrice * item.quantity,\n    0,\n  );\n}\n\n/**\n * Recompute a cart's cost from its line items. Cookie carts are their own source\n * of truth (no server roundtrip) and apply no discounts, so subtotal equals\n * total and there are no discount allocations. Without this the cost stays at\n * the 0 it was created with, and every consumer that trusts it (cart total,\n * checkout analytics) reports $0 for a priced cart.\n */\nexport function recalculateCartCost(cart: Cart): Cart {\n  const subtotal = calculateLineItemsSubtotal(cart.lines);\n  return {\n    ...cart,\n    cost: {\n      ...cart.cost,\n      subtotalAmount: subtotal,\n      totalAmount: subtotal,\n    },\n    discountAllocations: [],\n  };\n}\n\n/**\n * Calculate cart totals including subtotal, discounts, and final total.\n * When cart cost data is provided (from Shopify), uses the actual totalAmount\n * and sums the provider's discount allocations (automatic, code, and custom\n * discounts, at both line and cart level) for the discount amount.\n *\n * @param options - Object containing lineItems and cart\n * @param options.lineItems - Array of cart line items\n * @param options.cart - Optional cart data from Shopify (includes discount allocations)\n */\nexport function calculateCartTotals({\n  lineItems,\n  cart,\n}: {\n  lineItems: CartLine[];\n  cart: Cart | null;\n}): CartTotals {\n  const lineItemSubtotal = calculateLineItemsSubtotal(lineItems);\n  const compareAtSubtotal = lineItems.reduce((sum, item) => {\n    return sum + getCartLinePricing(item).compareAtPrice * item.quantity;\n  }, 0);\n\n  // NOTE (Jasmine, 2026-07-22): Trust the provider's authoritative cost when\n  // present. For Shopify this is the server-computed cart cost (including a\n  // legitimate $0 when items aren't purchasable), which we must not\n  // second-guess; cookie carts keep their cost truthful via\n  // cookie-cart-persistence.ts.\n  const total = cart?.cost.totalAmount ?? lineItemSubtotal;\n\n  // Shopify folds line-level discounts into cost.subtotalAmount too, so the\n  // cost gap can't be used; the allocations carry every applied discount.\n  const discountAmount = (cart?.discountAllocations ?? []).reduce(\n    (sum, allocation) => sum + allocation.discountedAmount,\n    0,\n  );\n\n  const totalSavings = compareAtSubtotal - total;\n\n  return {\n    subtotal: lineItemSubtotal,\n    discountAmount,\n    totalSavings,\n    total,\n  };\n}\n\n/**\n * @deprecated Back-compat shim kept for surface parity with canopy-sdk, so\n * sites migrating off `import { formatPrice } from\n * \"canopy-sdk/cart/utils/cart-utils\"` keep rendering with only the package\n * specifier renamed. It formats INTEGER MINOR UNITS \u2014 the units every cart\n * value uses (`calculateCartTotals`, `getCartLinePricing`, `CartCost`):\n * passing 1999 yields \"$19.99\", not \"$1,999.00\". New code should call\n * `formatAmount({ amount, currencyCode })` from `@replohq/sdk/money` directly.\n */\nexport function formatPrice(price: number, currency: string = \"USD\"): string {\n  return formatAmount({ amount: price, currencyCode: currency });\n}\n\n/**\n * Validates and formats a Shopify selling plan ID to ensure it has the correct GID format.\n *\n * @param sellingPlanId - The selling plan ID to validate and format\n * @returns The formatted selling plan ID with GID prefix, or null if no ID provided\n */\nexport function formatSellingPlanId(\n  sellingPlanId: string | null | undefined,\n): string | null {\n  if (!sellingPlanId) {\n    return null;\n  }\n\n  // Check if it already has the gid format\n  if (sellingPlanId.startsWith(\"gid://shopify/SellingPlan/\")) {\n    return sellingPlanId;\n  }\n\n  // If it doesn't have the gid format, prepend it\n  return `gid://shopify/SellingPlan/${sellingPlanId}`;\n}\n"],
-  "mappings": "AAEA,SAAS,oBAAoB;AAE7B,SAAS,0BAA0B;AAc5B,SAAS,2BAA2B,WAA+B;AACxE,SAAO,UAAU;AAAA,IACf,CAAC,KAAK,SAAS,MAAM,mBAAmB,IAAI,EAAE,aAAa,KAAK;AAAA,IAChE;AAAA,EACF;AACF;AASO,SAAS,oBAAoB,MAAkB;AACpD,QAAM,WAAW,2BAA2B,KAAK,KAAK;AACtD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM;AAAA,MACJ,GAAG,KAAK;AAAA,MACR,gBAAgB;AAAA,MAChB,aAAa;AAAA,IACf;AAAA,IACA,qBAAqB,CAAC;AAAA,EACxB;AACF;AAYO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGe;AACb,QAAM,mBAAmB,2BAA2B,SAAS;AAC7D,QAAM,oBAAoB,UAAU,OAAO,CAAC,KAAK,SAAS;AACxD,WAAO,MAAM,mBAAmB,IAAI,EAAE,iBAAiB,KAAK;AAAA,EAC9D,GAAG,CAAC;AAOJ,QAAM,QAAQ,MAAM,KAAK,eAAe;AAIxC,QAAM,kBAAkB,MAAM,uBAAuB,CAAC,GAAG;AAAA,IACvD,CAAC,KAAK,eAAe,MAAM,WAAW;AAAA,IACtC;AAAA,EACF;AAEA,QAAM,eAAe,oBAAoB;AAEzC,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAWO,SAAS,YAAY,OAAe,WAAmB,OAAe;AAC3E,SAAO,aAAa,EAAE,QAAQ,OAAO,cAAc,SAAS,CAAC;AAC/D;AAQO,SAAS,oBACd,eACe;AACf,MAAI,CAAC,eAAe;AAClB,WAAO;AAAA,EACT;AAGA,MAAI,cAAc,WAAW,4BAA4B,GAAG;AAC1D,WAAO;AAAA,EACT;AAGA,SAAO,6BAA6B,aAAa;AACnD;",
+  "sourcesContent": ["import type { ReconciledCartLine } from \"../../gateways/canopy-api\";\nimport type { Cart, CartLine } from \"../cart-types\";\n\nimport { formatAmount } from \"schemas/money\";\n\nimport { CanopyError } from \"../../lib/canopy-error\";\nimport { getCartLinePricing } from \"./variant-to-cart-line\";\n\nclass CartReconciliationMismatchError extends CanopyError {}\n\nexport interface CartTotals {\n  subtotal: number;\n  discountAmount: number;\n  totalSavings: number;\n  total: number;\n}\n\n/**\n * Sum the final (post selling-plan) price of every line item in the cart.\n * This is the authoritative subtotal for cookie-based carts, which have no\n * server-computed cost to rely on.\n */\nexport function calculateLineItemsSubtotal(lineItems: CartLine[]): number {\n  return lineItems.reduce(\n    (sum, item) => sum + getCartLinePricing(item).finalPrice * item.quantity,\n    0,\n  );\n}\n\n/**\n * Recompute a cart's cost from its line items. Cookie carts are their own source\n * of truth (no server roundtrip) and apply no discounts, so subtotal equals\n * total and there are no discount allocations. Without this the cost stays at\n * the 0 it was created with, and every consumer that trusts it (cart total,\n * checkout analytics) reports $0 for a priced cart.\n */\nexport function recalculateCartCost(cart: Cart): Cart {\n  const subtotal = calculateLineItemsSubtotal(cart.lines);\n  return {\n    ...cart,\n    cost: {\n      ...cart.cost,\n      subtotalAmount: subtotal,\n      totalAmount: subtotal,\n    },\n    discountAllocations: [],\n  };\n}\n\n/**\n * Rewrite a cookie cart with the catalog's current facts: live prices always,\n * unavailable lines dropped, and \u2014 on write paths only \u2014 quantities clamped to\n * the purchasable remainder. Reads never clamp (`clampQuantities: false`):\n * a quantity change without messaging is worse than one the mutation or\n * checkout path reports, mirroring Shopify's cart behavior.\n *\n * `reconciledLines` must be the catalog's answer for this cart's\n * merchandise-bearing lines in order \u2014 the shape reconcileCartLines returns.\n */\nexport function applyCartLineReconciliation(\n  cart: Cart,\n  reconciledLines: ReconciledCartLine[],\n  { clampQuantities }: { clampQuantities: boolean },\n): Cart {\n  let reconciledIndex = 0;\n  const lines = cart.lines.flatMap((line) => {\n    if (!line.merchandise) {\n      return [line];\n    }\n    const catalogLine = reconciledLines[reconciledIndex];\n    reconciledIndex += 1;\n    if (!catalogLine || catalogLine.variantId !== line.merchandise.id) {\n      throw new CartReconciliationMismatchError({\n        message: \"Reconciled lines do not match the cart's lines\",\n        additionalData: {\n          cartId: cart.id,\n          variantId: line.merchandise.id,\n          reconciledVariantId: catalogLine?.variantId ?? null,\n        },\n      });\n    }\n    if (catalogLine.status === \"unavailable\") {\n      return [];\n    }\n    const quantity = clampQuantities\n      ? Math.min(line.quantity, catalogLine.purchasableQuantity)\n      : line.quantity;\n    if (quantity <= 0) {\n      return [];\n    }\n    return [\n      {\n        ...line,\n        quantity,\n        merchandise: {\n          ...line.merchandise,\n          price: catalogLine.unitPriceMinor,\n          compareAtPrice: catalogLine.compareAtPriceMinor,\n        },\n      },\n    ];\n  });\n  return recalculateCartCost({ ...cart, lines });\n}\n\n/**\n * Calculate cart totals including subtotal, discounts, and final total.\n * When cart cost data is provided (from Shopify), uses the actual totalAmount\n * and sums the provider's discount allocations (automatic, code, and custom\n * discounts, at both line and cart level) for the discount amount.\n *\n * @param options - Object containing lineItems and cart\n * @param options.lineItems - Array of cart line items\n * @param options.cart - Optional cart data from Shopify (includes discount allocations)\n */\nexport function calculateCartTotals({\n  lineItems,\n  cart,\n}: {\n  lineItems: CartLine[];\n  cart: Cart | null;\n}): CartTotals {\n  const lineItemSubtotal = calculateLineItemsSubtotal(lineItems);\n  const compareAtSubtotal = lineItems.reduce((sum, item) => {\n    return sum + getCartLinePricing(item).compareAtPrice * item.quantity;\n  }, 0);\n\n  // NOTE (Jasmine, 2026-07-22): Trust the provider's authoritative cost when\n  // present. For Shopify this is the server-computed cart cost (including a\n  // legitimate $0 when items aren't purchasable), which we must not\n  // second-guess; cookie carts keep their cost truthful via\n  // cookie-cart-persistence.ts.\n  const total = cart?.cost.totalAmount ?? lineItemSubtotal;\n\n  // Shopify folds line-level discounts into cost.subtotalAmount too, so the\n  // cost gap can't be used; the allocations carry every applied discount.\n  const discountAmount = (cart?.discountAllocations ?? []).reduce(\n    (sum, allocation) => sum + allocation.discountedAmount,\n    0,\n  );\n\n  const totalSavings = compareAtSubtotal - total;\n\n  return {\n    subtotal: lineItemSubtotal,\n    discountAmount,\n    totalSavings,\n    total,\n  };\n}\n\n/**\n * @deprecated Back-compat shim kept for surface parity with canopy-sdk, so\n * sites migrating off `import { formatPrice } from\n * \"canopy-sdk/cart/utils/cart-utils\"` keep rendering with only the package\n * specifier renamed. It formats INTEGER MINOR UNITS \u2014 the units every cart\n * value uses (`calculateCartTotals`, `getCartLinePricing`, `CartCost`):\n * passing 1999 yields \"$19.99\", not \"$1,999.00\". New code should call\n * `formatAmount({ amount, currencyCode })` from `@replohq/sdk/money` directly.\n */\nexport function formatPrice(price: number, currency: string = \"USD\"): string {\n  return formatAmount({ amount: price, currencyCode: currency });\n}\n\n/**\n * Validates and formats a Shopify selling plan ID to ensure it has the correct GID format.\n *\n * @param sellingPlanId - The selling plan ID to validate and format\n * @returns The formatted selling plan ID with GID prefix, or null if no ID provided\n */\nexport function formatSellingPlanId(\n  sellingPlanId: string | null | undefined,\n): string | null {\n  if (!sellingPlanId) {\n    return null;\n  }\n\n  // Check if it already has the gid format\n  if (sellingPlanId.startsWith(\"gid://shopify/SellingPlan/\")) {\n    return sellingPlanId;\n  }\n\n  // If it doesn't have the gid format, prepend it\n  return `gid://shopify/SellingPlan/${sellingPlanId}`;\n}\n"],
+  "mappings": "AAGA,SAAS,oBAAoB;AAE7B,SAAS,mBAAmB;AAC5B,SAAS,0BAA0B;AAEnC,MAAM,wCAAwC,YAAY;AAAC;AAcpD,SAAS,2BAA2B,WAA+B;AACxE,SAAO,UAAU;AAAA,IACf,CAAC,KAAK,SAAS,MAAM,mBAAmB,IAAI,EAAE,aAAa,KAAK;AAAA,IAChE;AAAA,EACF;AACF;AASO,SAAS,oBAAoB,MAAkB;AACpD,QAAM,WAAW,2BAA2B,KAAK,KAAK;AACtD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM;AAAA,MACJ,GAAG,KAAK;AAAA,MACR,gBAAgB;AAAA,MAChB,aAAa;AAAA,IACf;AAAA,IACA,qBAAqB,CAAC;AAAA,EACxB;AACF;AAYO,SAAS,4BACd,MACA,iBACA,EAAE,gBAAgB,GACZ;AACN,MAAI,kBAAkB;AACtB,QAAM,QAAQ,KAAK,MAAM,QAAQ,CAAC,SAAS;AACzC,QAAI,CAAC,KAAK,aAAa;AACrB,aAAO,CAAC,IAAI;AAAA,IACd;AACA,UAAM,cAAc,gBAAgB,eAAe;AACnD,uBAAmB;AACnB,QAAI,CAAC,eAAe,YAAY,cAAc,KAAK,YAAY,IAAI;AACjE,YAAM,IAAI,gCAAgC;AAAA,QACxC,SAAS;AAAA,QACT,gBAAgB;AAAA,UACd,QAAQ,KAAK;AAAA,UACb,WAAW,KAAK,YAAY;AAAA,UAC5B,qBAAqB,aAAa,aAAa;AAAA,QACjD;AAAA,MACF,CAAC;AAAA,IACH;AACA,QAAI,YAAY,WAAW,eAAe;AACxC,aAAO,CAAC;AAAA,IACV;AACA,UAAM,WAAW,kBACb,KAAK,IAAI,KAAK,UAAU,YAAY,mBAAmB,IACvD,KAAK;AACT,QAAI,YAAY,GAAG;AACjB,aAAO,CAAC;AAAA,IACV;AACA,WAAO;AAAA,MACL;AAAA,QACE,GAAG;AAAA,QACH;AAAA,QACA,aAAa;AAAA,UACX,GAAG,KAAK;AAAA,UACR,OAAO,YAAY;AAAA,UACnB,gBAAgB,YAAY;AAAA,QAC9B;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AACD,SAAO,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC;AAC/C;AAYO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGe;AACb,QAAM,mBAAmB,2BAA2B,SAAS;AAC7D,QAAM,oBAAoB,UAAU,OAAO,CAAC,KAAK,SAAS;AACxD,WAAO,MAAM,mBAAmB,IAAI,EAAE,iBAAiB,KAAK;AAAA,EAC9D,GAAG,CAAC;AAOJ,QAAM,QAAQ,MAAM,KAAK,eAAe;AAIxC,QAAM,kBAAkB,MAAM,uBAAuB,CAAC,GAAG;AAAA,IACvD,CAAC,KAAK,eAAe,MAAM,WAAW;AAAA,IACtC;AAAA,EACF;AAEA,QAAM,eAAe,oBAAoB;AAEzC,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAWO,SAAS,YAAY,OAAe,WAAmB,OAAe;AAC3E,SAAO,aAAa,EAAE,QAAQ,OAAO,cAAc,SAAS,CAAC;AAC/D;AAQO,SAAS,oBACd,eACe;AACf,MAAI,CAAC,eAAe;AAClB,WAAO;AAAA,EACT;AAGA,MAAI,cAAc,WAAW,4BAA4B,GAAG;AAC1D,WAAO;AAAA,EACT;AAGA,SAAO,6BAA6B,aAAa;AACnD;",
   "names": []
 }

package/cart/utils/cookie-cart-persistence.d.ts

@@ -11,6 +11,7 @@ interface CreateCartOptions {
     lines?: CartLinePayload[];
     lineIdGenerator: () => string;
     cartIdGenerator: () => string;
+    reconcile?: (cart: Cart) => Promise<Cart>;
 }
 /**
  * Options for adding to cart with persistence
@@ -19,6 +20,7 @@ interface AddToCartOptions {
     cookieName: string;
     mergeFn: LineMergeFn;
     lineIdGenerator: () => string;
+    reconcile?: (cart: Cart) => Promise<Cart>;
 }
 /**
  * Save cart to cookie
@@ -35,7 +37,7 @@ export declare function clearCartCookie(cookieName: string): Promise<void>;
 /**
  * Update cart in cookie atomically (load-transform-save pattern)
  */
-export declare function updateCartInCookie(cartId: string, cookieName: string, updater: (cart: Cart) => Cart): Promise<Cart | null>;
+export declare function updateCartInCookie(cartId: string, cookieName: string, updater: (cart: Cart) => Cart, reconcile?: (cart: Cart) => Promise<Cart>): Promise<Cart | null>;
 /**
  * Create a new cart with persistence
  */
@@ -47,7 +49,7 @@ export declare function addToCartWithPersistence(payload: AddToCartPayload, opti
 /**
  * Update cart line item
  */
-export declare function updateCartLineItemWithPersistence(payload: UpdateCartLineItemPayload, cookieName: string): Promise<Cart | null>;
+export declare function updateCartLineItemWithPersistence(payload: UpdateCartLineItemPayload, cookieName: string, reconcile?: (cart: Cart) => Promise<Cart>): Promise<Cart | null>;
 /**
  * Remove cart line items
  */

package/cart/utils/cookie-cart-persistence.js

@@ -24,12 +24,15 @@ async function clearCartCookie(cookieName) {
   const cookieStore = await cookies();
   cookieStore.set(cookieName, "", { ...getCartCookieOptions(), maxAge: 0 });
 }
-async function updateCartInCookie(cartId, cookieName, updater) {
+async function updateCartInCookie(cartId, cookieName, updater, reconcile) {
   const existingCart = await loadCartFromCookie(cookieName);
   if (!existingCart || existingCart.id !== cartId) {
     return null;
   }
-  const updatedCart = recalculateCartCost(updater(existingCart));
+  let updatedCart = recalculateCartCost(updater(existingCart));
+  if (reconcile) {
+    updatedCart = await reconcile(updatedCart);
+  }
   await saveCartToCookie(updatedCart, cookieName);
   return updatedCart;
 }
@@ -50,7 +53,10 @@ async function createCartWithPersistence(options) {
       convertCartLinePayloadToCartLine(line, options.lineIdGenerator)
     );
   }
-  const cartWithCost = recalculateCartCost(cart);
+  let cartWithCost = recalculateCartCost(cart);
+  if (options.reconcile) {
+    cartWithCost = await options.reconcile(cartWithCost);
+  }
   await saveCartToCookie(cartWithCost, options.cookieName);
   return cartWithCost;
 }
@@ -72,29 +78,37 @@ async function addToCartWithPersistence(payload, options) {
         }
       }
       return cart;
-    }
+    },
+    options.reconcile
   );
 }
-async function updateCartLineItemWithPersistence(payload, cookieName) {
-  return await updateCartInCookie(payload.cartId, cookieName, (cart) => {
-    const lineIndex = cart.lines.findIndex(
-      (line) => line.id === payload.line.id
-    );
-    if (lineIndex >= 0) {
+async function updateCartLineItemWithPersistence(payload, cookieName, reconcile) {
+  return await updateCartInCookie(
+    payload.cartId,
+    cookieName,
+    (cart) => {
+      const lineIndex = cart.lines.findIndex(
+        (line2) => line2.id === payload.line.id
+      );
+      if (lineIndex < 0) {
+        return cart;
+      }
       if (payload.line.quantity <= 0) {
         cart.lines.splice(lineIndex, 1);
-      } else {
-        cart.lines[lineIndex].quantity = payload.line.quantity;
-        if (payload.line.properties) {
-          cart.lines[lineIndex].attributes = payload.line.properties;
-        }
-        if (payload.line.merchandise) {
-          cart.lines[lineIndex].merchandise = payload.line.merchandise;
-        }
+        return cart;
       }
-    }
-    return cart;
-  });
+      const line = cart.lines[lineIndex];
+      line.quantity = payload.line.quantity;
+      if (payload.line.properties) {
+        line.attributes = payload.line.properties;
+      }
+      if (payload.line.merchandise) {
+        line.merchandise = payload.line.merchandise;
+      }
+      return cart;
+    },
+    reconcile
+  );
 }
 async function removeCartLineItemsWithPersistence(payload, cookieName) {
   return await updateCartInCookie(payload.cartId, cookieName, (cart) => {