@replohq/sdk 1.5.0 → 1.7.0

package/_vendor/replo-utils/lib/url.d.ts

@@ -64,6 +64,10 @@ export declare function fileExtensionFromUrl(url: string): string;
  * Registration inputs are attacker-typeable, and the pipeline fetches them
  * server-side — so only plain public https(+http) origins pass: no
  * credentials, no ports, no IP literals, no localhost/RFC-6762 style names.
+ * Upgrades http to https and strips the fragment by default; `preserveProtocol`
+ * keeps the requested scheme.
  */
-export declare function sanitizePublicHttpUrl(value: string | null): string | null;
+export declare function sanitizePublicHttpUrl(value: string | null, { preserveProtocol }?: {
+    preserveProtocol?: boolean;
+}): string | null;
 export declare function safeHost(url: string): string | null;

package/cart/cart-actions.js

@@ -14,7 +14,8 @@ const SHOPIFY_CART_COOKIE_NAME = "replo_cart_id";
 async function getOrCreateCartAction() {
   const existingCart = await getCartAction();
   if (existingCart) {
-    return existingCart;
+    const cartGateway = await getCartGateway();
+    return await cartGateway.reconcileStoredCart(existingCart);
   }
   return await createCartAction();
 }

package/cart/cart-actions.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../cart/cart-actions.ts"],
-  "sourcesContent": ["\"use server\";\n\nimport type {\n  AddToCartPayload,\n  Cart,\n  CartLinePayload,\n  RemoveFromCartPayload,\n  UpdateCartLineItemPayload,\n} from \"./cart-types\";\n\nimport { cookies } from \"next/headers\";\n\nimport { getCheckoutProvider } from \"../lib/integration-utils\";\nimport {\n  getCartCookieOptions,\n  REPLO_CART_COOKIE_NAME,\n} from \"./gateways/cart-constants\";\nimport { getCartGateway } from \"./gateways/cart-gateway\";\nimport {\n  loadCartFromCookie,\n  saveCartToCookie,\n} from \"./utils/cookie-cart-persistence\";\n\nconst SHOPIFY_CART_COOKIE_NAME = \"replo_cart_id\";\n\n/**\n * Gets the existing cart or creates a new one if none exists. This is necessary\n * because we may not have cookies in the server context during initial load.\n *\n * See: https://nextjs.org/docs/app/api-reference/functions/cookies#understanding-cookie-behavior-in-server-components\n *\n * @returns The existing cart or a newly created cart\n */\nexport async function getOrCreateCartAction(): Promise<Cart | null> {\n  const existingCart = await getCartAction();\n  if (existingCart) {\n    return existingCart;\n  }\n  return await createCartAction();\n}\n\n/**\n * Retrieves the current cart from cookies. Returns null if no cart exists or\n * if the cart has expired/been deleted.\n *\n * @returns The current cart or null if none exists\n */\nexport async function getCartAction(): Promise<Cart | null> {\n  const checkoutProvider = await getCheckoutProvider();\n\n  if (checkoutProvider === \"stripe\") {\n    return await loadCartFromCookie(REPLO_CART_COOKIE_NAME);\n  }\n\n  const cookieStore = await cookies();\n  const existingCartId = cookieStore.get(SHOPIFY_CART_COOKIE_NAME)?.value;\n\n  if (!existingCartId) {\n    return null;\n  }\n\n  const cartGateway = await getCartGateway();\n  const cart = await cartGateway.getCart(existingCartId);\n\n  // If we had a cart ID in the cookie but couldn't fetch the cart,\n  // it means the cart is invalid/expired - clear the cookie\n  if (!cart) {\n    try {\n      cookieStore.set(SHOPIFY_CART_COOKIE_NAME, \"\", {\n        ...getCartCookieOptions(),\n        maxAge: 0,\n      });\n    } catch (error) {\n      console.warn(\"Failed to delete cart cookie:\", error);\n    }\n  }\n\n  return cart;\n}\n\n/**\n * Creates a new cart with optional initial line items. The cart ID is stored\n * in a cookie for future retrieval.\n *\n * @param options.lines - Optional initial cart line items\n * @param options.skipStoringCart - If true, skips storing the cart in cookies (used for buy-now flows)\n * @param options.discountCodes - Optional discount codes to apply on cart creation\n * @returns The newly created cart\n */\nexport async function createCartAction(options?: {\n  lines?: CartLinePayload[];\n  skipStoringCart?: boolean;\n  discountCodes?: string[];\n}): Promise<Cart | null> {\n  const { lines, skipStoringCart = false, discountCodes } = options ?? {};\n  const checkoutProvider = await getCheckoutProvider();\n  const cartGateway = await getCartGateway();\n  const cart = await cartGateway.createCart(lines, discountCodes);\n\n  if (cart && !skipStoringCart) {\n    // Set the cart ID in a cookie - this works in Server Action context\n    try {\n      if (checkoutProvider === \"stripe\") {\n        await saveCartToCookie(cart, REPLO_CART_COOKIE_NAME);\n      } else {\n        const cookieStore = await cookies();\n        cookieStore.set(\n          SHOPIFY_CART_COOKIE_NAME,\n          cart.id,\n          getCartCookieOptions(),\n        );\n      }\n    } catch (cookieError) {\n      console.warn(\"Failed to set cart cookie:\", cookieError);\n    }\n  }\n\n  return cart;\n}\n\n/**\n * Adds line items to an existing cart.\n *\n * @param lines - Array of cart line items to add\n * @param cartId - The ID of the cart to add items to\n * @returns The updated cart\n */\nexport async function addToCartAction(\n  lines: AddToCartPayload[\"lines\"],\n  cartId: string,\n): Promise<Cart | null> {\n  const cartGateway = await getCartGateway();\n  return await cartGateway.addToCart({ lines, cartId });\n}\n\n/**\n * Updates a cart line item (typically quantity).\n *\n * @param line - The cart line item with updated values\n * @param cartId - The ID of the cart containing the line item\n * @returns The updated cart\n */\nexport async function updateCartLineItemAction(\n  line: UpdateCartLineItemPayload[\"line\"],\n  cartId: string,\n): Promise<Cart | null> {\n  const cartGateway = await getCartGateway();\n  return await cartGateway.updateCartLineItem({ line, cartId });\n}\n\n/**\n * Removes one or more line items from the cart.\n *\n * @param lineIds - Array of line item IDs to remove\n * @param cartId - The ID of the cart to remove items from\n * @returns The updated cart\n */\nexport async function removeCartLineItemsAction(\n  lineIds: RemoveFromCartPayload[\"lineIds\"],\n  cartId: string,\n): Promise<Cart | null> {\n  const cartGateway = await getCartGateway();\n  return await cartGateway.removeCartLineItems({ lineIds, cartId });\n}\n\n/**\n * Updates discount codes for a cart.\n *\n * @param discountCodes - Array of discount code strings to apply\n * @param cartId - The ID of the cart to update\n * @returns The updated cart\n */\nexport async function updateCartDiscountCodesAction(\n  discountCodes: string[],\n  cartId: string,\n): Promise<Cart | null> {\n  const cartGateway = await getCartGateway();\n  return await cartGateway.updateCartDiscountCodes({ discountCodes, cartId });\n}\n"],
-  "mappings": ";AAUA,SAAS,eAAe;AAExB,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,MAAM,2BAA2B;AAUjC,eAAsB,wBAA8C;AAClE,QAAM,eAAe,MAAM,cAAc;AACzC,MAAI,cAAc;AAChB,WAAO;AAAA,EACT;AACA,SAAO,MAAM,iBAAiB;AAChC;AAQA,eAAsB,gBAAsC;AAC1D,QAAM,mBAAmB,MAAM,oBAAoB;AAEnD,MAAI,qBAAqB,UAAU;AACjC,WAAO,MAAM,mBAAmB,sBAAsB;AAAA,EACxD;AAEA,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,iBAAiB,YAAY,IAAI,wBAAwB,GAAG;AAElE,MAAI,CAAC,gBAAgB;AACnB,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,MAAM,eAAe;AACzC,QAAM,OAAO,MAAM,YAAY,QAAQ,cAAc;AAIrD,MAAI,CAAC,MAAM;AACT,QAAI;AACF,kBAAY,IAAI,0BAA0B,IAAI;AAAA,QAC5C,GAAG,qBAAqB;AAAA,QACxB,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,SAAS,OAAO;AACd,cAAQ,KAAK,iCAAiC,KAAK;AAAA,IACrD;AAAA,EACF;AAEA,SAAO;AACT;AAWA,eAAsB,iBAAiB,SAId;AACvB,QAAM,EAAE,OAAO,kBAAkB,OAAO,cAAc,IAAI,WAAW,CAAC;AACtE,QAAM,mBAAmB,MAAM,oBAAoB;AACnD,QAAM,cAAc,MAAM,eAAe;AACzC,QAAM,OAAO,MAAM,YAAY,WAAW,OAAO,aAAa;AAE9D,MAAI,QAAQ,CAAC,iBAAiB;AAE5B,QAAI;AACF,UAAI,qBAAqB,UAAU;AACjC,cAAM,iBAAiB,MAAM,sBAAsB;AAAA,MACrD,OAAO;AACL,cAAM,cAAc,MAAM,QAAQ;AAClC,oBAAY;AAAA,UACV;AAAA,UACA,KAAK;AAAA,UACL,qBAAqB;AAAA,QACvB;AAAA,MACF;AAAA,IACF,SAAS,aAAa;AACpB,cAAQ,KAAK,8BAA8B,WAAW;AAAA,IACxD;AAAA,EACF;AAEA,SAAO;AACT;AASA,eAAsB,gBACpB,OACA,QACsB;AACtB,QAAM,cAAc,MAAM,eAAe;AACzC,SAAO,MAAM,YAAY,UAAU,EAAE,OAAO,OAAO,CAAC;AACtD;AASA,eAAsB,yBACpB,MACA,QACsB;AACtB,QAAM,cAAc,MAAM,eAAe;AACzC,SAAO,MAAM,YAAY,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAC9D;AASA,eAAsB,0BACpB,SACA,QACsB;AACtB,QAAM,cAAc,MAAM,eAAe;AACzC,SAAO,MAAM,YAAY,oBAAoB,EAAE,SAAS,OAAO,CAAC;AAClE;AASA,eAAsB,8BACpB,eACA,QACsB;AACtB,QAAM,cAAc,MAAM,eAAe;AACzC,SAAO,MAAM,YAAY,wBAAwB,EAAE,eAAe,OAAO,CAAC;AAC5E;",
+  "sourcesContent": ["\"use server\";\n\nimport type {\n  AddToCartPayload,\n  Cart,\n  CartLinePayload,\n  RemoveFromCartPayload,\n  UpdateCartLineItemPayload,\n} from \"./cart-types\";\n\nimport { cookies } from \"next/headers\";\n\nimport { getCheckoutProvider } from \"../lib/integration-utils\";\nimport {\n  getCartCookieOptions,\n  REPLO_CART_COOKIE_NAME,\n} from \"./gateways/cart-constants\";\nimport { getCartGateway } from \"./gateways/cart-gateway\";\nimport {\n  loadCartFromCookie,\n  saveCartToCookie,\n} from \"./utils/cookie-cart-persistence\";\n\nconst SHOPIFY_CART_COOKIE_NAME = \"replo_cart_id\";\n\n/**\n * Gets the existing cart or creates a new one if none exists. This is necessary\n * because we may not have cookies in the server context during initial load.\n *\n * See: https://nextjs.org/docs/app/api-reference/functions/cookies#understanding-cookie-behavior-in-server-components\n *\n * @returns The existing cart or a newly created cart\n */\nexport async function getOrCreateCartAction(): Promise<Cart | null> {\n  const existingCart = await getCartAction();\n  if (existingCart) {\n    // The cookie cart snapshots catalog facts at add-to-cart time; a cart\n    // that outlives a price change or a product removal corrects itself here,\n    // on the mount round-trip, instead of lying until checkout.\n    const cartGateway = await getCartGateway();\n    return await cartGateway.reconcileStoredCart(existingCart);\n  }\n  return await createCartAction();\n}\n\n/**\n * Retrieves the current cart from cookies. Returns null if no cart exists or\n * if the cart has expired/been deleted.\n *\n * @returns The current cart or null if none exists\n */\nexport async function getCartAction(): Promise<Cart | null> {\n  const checkoutProvider = await getCheckoutProvider();\n\n  if (checkoutProvider === \"stripe\") {\n    return await loadCartFromCookie(REPLO_CART_COOKIE_NAME);\n  }\n\n  const cookieStore = await cookies();\n  const existingCartId = cookieStore.get(SHOPIFY_CART_COOKIE_NAME)?.value;\n\n  if (!existingCartId) {\n    return null;\n  }\n\n  const cartGateway = await getCartGateway();\n  const cart = await cartGateway.getCart(existingCartId);\n\n  // If we had a cart ID in the cookie but couldn't fetch the cart,\n  // it means the cart is invalid/expired - clear the cookie\n  if (!cart) {\n    try {\n      cookieStore.set(SHOPIFY_CART_COOKIE_NAME, \"\", {\n        ...getCartCookieOptions(),\n        maxAge: 0,\n      });\n    } catch (error) {\n      console.warn(\"Failed to delete cart cookie:\", error);\n    }\n  }\n\n  return cart;\n}\n\n/**\n * Creates a new cart with optional initial line items. The cart ID is stored\n * in a cookie for future retrieval.\n *\n * @param options.lines - Optional initial cart line items\n * @param options.skipStoringCart - If true, skips storing the cart in cookies (used for buy-now flows)\n * @param options.discountCodes - Optional discount codes to apply on cart creation\n * @returns The newly created cart\n */\nexport async function createCartAction(options?: {\n  lines?: CartLinePayload[];\n  skipStoringCart?: boolean;\n  discountCodes?: string[];\n}): Promise<Cart | null> {\n  const { lines, skipStoringCart = false, discountCodes } = options ?? {};\n  const checkoutProvider = await getCheckoutProvider();\n  const cartGateway = await getCartGateway();\n  const cart = await cartGateway.createCart(lines, discountCodes);\n\n  if (cart && !skipStoringCart) {\n    // Set the cart ID in a cookie - this works in Server Action context\n    try {\n      if (checkoutProvider === \"stripe\") {\n        await saveCartToCookie(cart, REPLO_CART_COOKIE_NAME);\n      } else {\n        const cookieStore = await cookies();\n        cookieStore.set(\n          SHOPIFY_CART_COOKIE_NAME,\n          cart.id,\n          getCartCookieOptions(),\n        );\n      }\n    } catch (cookieError) {\n      console.warn(\"Failed to set cart cookie:\", cookieError);\n    }\n  }\n\n  return cart;\n}\n\n/**\n * Adds line items to an existing cart.\n *\n * @param lines - Array of cart line items to add\n * @param cartId - The ID of the cart to add items to\n * @returns The updated cart\n */\nexport async function addToCartAction(\n  lines: AddToCartPayload[\"lines\"],\n  cartId: string,\n): Promise<Cart | null> {\n  const cartGateway = await getCartGateway();\n  return await cartGateway.addToCart({ lines, cartId });\n}\n\n/**\n * Updates a cart line item (typically quantity).\n *\n * @param line - The cart line item with updated values\n * @param cartId - The ID of the cart containing the line item\n * @returns The updated cart\n */\nexport async function updateCartLineItemAction(\n  line: UpdateCartLineItemPayload[\"line\"],\n  cartId: string,\n): Promise<Cart | null> {\n  const cartGateway = await getCartGateway();\n  return await cartGateway.updateCartLineItem({ line, cartId });\n}\n\n/**\n * Removes one or more line items from the cart.\n *\n * @param lineIds - Array of line item IDs to remove\n * @param cartId - The ID of the cart to remove items from\n * @returns The updated cart\n */\nexport async function removeCartLineItemsAction(\n  lineIds: RemoveFromCartPayload[\"lineIds\"],\n  cartId: string,\n): Promise<Cart | null> {\n  const cartGateway = await getCartGateway();\n  return await cartGateway.removeCartLineItems({ lineIds, cartId });\n}\n\n/**\n * Updates discount codes for a cart.\n *\n * @param discountCodes - Array of discount code strings to apply\n * @param cartId - The ID of the cart to update\n * @returns The updated cart\n */\nexport async function updateCartDiscountCodesAction(\n  discountCodes: string[],\n  cartId: string,\n): Promise<Cart | null> {\n  const cartGateway = await getCartGateway();\n  return await cartGateway.updateCartDiscountCodes({ discountCodes, cartId });\n}\n"],
+  "mappings": ";AAUA,SAAS,eAAe;AAExB,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,MAAM,2BAA2B;AAUjC,eAAsB,wBAA8C;AAClE,QAAM,eAAe,MAAM,cAAc;AACzC,MAAI,cAAc;AAIhB,UAAM,cAAc,MAAM,eAAe;AACzC,WAAO,MAAM,YAAY,oBAAoB,YAAY;AAAA,EAC3D;AACA,SAAO,MAAM,iBAAiB;AAChC;AAQA,eAAsB,gBAAsC;AAC1D,QAAM,mBAAmB,MAAM,oBAAoB;AAEnD,MAAI,qBAAqB,UAAU;AACjC,WAAO,MAAM,mBAAmB,sBAAsB;AAAA,EACxD;AAEA,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,iBAAiB,YAAY,IAAI,wBAAwB,GAAG;AAElE,MAAI,CAAC,gBAAgB;AACnB,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,MAAM,eAAe;AACzC,QAAM,OAAO,MAAM,YAAY,QAAQ,cAAc;AAIrD,MAAI,CAAC,MAAM;AACT,QAAI;AACF,kBAAY,IAAI,0BAA0B,IAAI;AAAA,QAC5C,GAAG,qBAAqB;AAAA,QACxB,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,SAAS,OAAO;AACd,cAAQ,KAAK,iCAAiC,KAAK;AAAA,IACrD;AAAA,EACF;AAEA,SAAO;AACT;AAWA,eAAsB,iBAAiB,SAId;AACvB,QAAM,EAAE,OAAO,kBAAkB,OAAO,cAAc,IAAI,WAAW,CAAC;AACtE,QAAM,mBAAmB,MAAM,oBAAoB;AACnD,QAAM,cAAc,MAAM,eAAe;AACzC,QAAM,OAAO,MAAM,YAAY,WAAW,OAAO,aAAa;AAE9D,MAAI,QAAQ,CAAC,iBAAiB;AAE5B,QAAI;AACF,UAAI,qBAAqB,UAAU;AACjC,cAAM,iBAAiB,MAAM,sBAAsB;AAAA,MACrD,OAAO;AACL,cAAM,cAAc,MAAM,QAAQ;AAClC,oBAAY;AAAA,UACV;AAAA,UACA,KAAK;AAAA,UACL,qBAAqB;AAAA,QACvB;AAAA,MACF;AAAA,IACF,SAAS,aAAa;AACpB,cAAQ,KAAK,8BAA8B,WAAW;AAAA,IACxD;AAAA,EACF;AAEA,SAAO;AACT;AASA,eAAsB,gBACpB,OACA,QACsB;AACtB,QAAM,cAAc,MAAM,eAAe;AACzC,SAAO,MAAM,YAAY,UAAU,EAAE,OAAO,OAAO,CAAC;AACtD;AASA,eAAsB,yBACpB,MACA,QACsB;AACtB,QAAM,cAAc,MAAM,eAAe;AACzC,SAAO,MAAM,YAAY,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAC9D;AASA,eAAsB,0BACpB,SACA,QACsB;AACtB,QAAM,cAAc,MAAM,eAAe;AACzC,SAAO,MAAM,YAAY,oBAAoB,EAAE,SAAS,OAAO,CAAC;AAClE;AASA,eAAsB,8BACpB,eACA,QACsB;AACtB,QAAM,cAAc,MAAM,eAAe;AACzC,SAAO,MAAM,YAAY,wBAAwB,EAAE,eAAe,OAAO,CAAC;AAC5E;",
   "names": []
 }

package/cart/cart-provider.d.ts

@@ -1,5 +1,16 @@
-import type { Cart, CartLine, CartLinePayload } from "./cart-types";
+import type { Cart, CartLine, CartLineAdjustment, CartLinePayload } from "./cart-types";
 import React from "react";
+export type CartOperation = "add" | "update" | "remove" | "discount";
+/**
+ * The most recent cart change that could not be saved. `message` is written
+ * for the shopper, so a cart UI can render it as-is next to a retry.
+ */
+export interface CartError {
+    /** Which cart change failed */
+    operation: CartOperation;
+    /** Shopper-facing explanation with a retry prompt */
+    message: string;
+}
 /**
  * Internal cart context type with full functionality.
  * This is for internal use only - external code should use the limited CartContextType.
@@ -16,13 +27,19 @@ export interface CartContextTypeInternal {
     /** Currency code for the cart */
     currencyCode: string;
     /** Function to add items to cart */
-    addToCart: (lines: CartLinePayload[], openCartAfterAdd?: boolean) => Promise<void>;
+    addToCart: (lines: CartLinePayload[], openCartAfterAdd?: boolean) => Promise<{
+        adjustments: CartLineAdjustment[];
+    }>;
     /** Function to update cart item quantity */
-    updateCartItem: (line: CartLinePayload) => Promise<void>;
+    updateCartItem: (line: CartLinePayload) => Promise<{
+        adjustments: CartLineAdjustment[];
+    }>;
     /** Function to remove item from cart */
     removeCartItem: (lineId: string) => Promise<void>;
     /** Function to update discount codes on cart */
     updateDiscountCodes: (discountCodes: string[]) => Promise<void>;
+    /** Re-read the persisted cart and adopt it if no mutations are in flight */
+    refreshCart: () => Promise<void>;
     /** Function to create cart and checkout immediately */
     buyNow: (lines: CartLinePayload[], discountCodes?: string[]) => Promise<Cart | null>;
     /** URL to redirect to checkout */
@@ -33,6 +50,10 @@ export interface CartContextTypeInternal {
     openCart: () => void;
     /** Function to close the cart UI */
     closeCart: () => void;
+    /** The last cart change that failed to save; cleared when the next change starts */
+    error: CartError | null;
+    /** Function to dismiss the current error */
+    clearError: () => void;
 }
 /**
  * Public cart context type for LLM use.
@@ -50,6 +71,21 @@ export interface CartContextType {
     closeCart: () => void;
     /** Function to update discount codes on cart */
     updateDiscountCodes: (discountCodes: string[]) => Promise<void>;
+    /**
+     * Re-read the persisted cart and adopt it if no mutations are in flight.
+     * Call after something outside the provider rewrote the cart — e.g. the
+     * checkout route clamped it and bounced back with `?checkout=adjusted`.
+     */
+    refreshCart: () => Promise<void>;
+    /**
+     * The last cart change that could not be saved, with a shopper-ready
+     * message. Set when an add, quantity change, removal, or discount fails;
+     * cleared when the next change starts or via `clearError`. Render it in the
+     * cart UI so the shopper knows to retry.
+     */
+    error: CartError | null;
+    /** Function to dismiss the current error */
+    clearError: () => void;
 }
 /**
  * Provider component that manages global cart state and operations. Handles both

package/cart/cart-provider.js

@@ -3,7 +3,6 @@ import { jsx } from "react/jsx-runtime";
 import React from "react";
 import { v4 as uuidv4 } from "uuid";
 import { useAnalyticsOptional } from "../analytics/analytics-provider";
-import { CanopyError } from "../lib/canopy-error";
 import {
   addToCartAction,
   createCartAction,
@@ -13,14 +12,17 @@ import {
   updateCartDiscountCodesAction,
   updateCartLineItemAction
 } from "./cart-actions";
+import {
+  deriveAddToCartAdjustments,
+  deriveUpdateCartAdjustments
+} from "./utils/cart-adjustments";
 import {
   buildCartLineAnalyticsData,
   buildCartViewAnalyticsData
 } from "./utils/cart-analytics";
+import { CartContextError, toCartError } from "./utils/cart-error";
 import { recalculateCartCost } from "./utils/cart-utils";
 import { createOptimisticSellingPlanAllocation } from "./utils/variant-to-cart-line";
-class CartContextError extends CanopyError {
-}
 let cartCreationPromise = null;
 function getOrCreateSharedCart() {
   cartCreationPromise ??= getOrCreateCartAction().then((cart) => {
@@ -96,7 +98,19 @@ function CartProvider({
     []
   );
   const [isCartOpen, setIsCartOpen] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const clearError = React.useCallback(() => setError(null), []);
   const isMounted = React.useRef(true);
+  const runWithErrorState = async (operation, mutate) => {
+    setError(null);
+    try {
+      return await mutate();
+    } catch (caught) {
+      console.error(`[Replo] Cart ${operation} failed:`, caught);
+      setError(toCartError(operation, caught));
+      throw caught;
+    }
+  };
   const analytics = useAnalyticsOptional();
   const serverCart = React.useRef(cart);
   const needsRefresh = React.useRef(false);
@@ -128,11 +142,11 @@ function CartProvider({
             message: "Your cart could not be saved. Please try again."
           });
         serverCart.current = savedCart;
-      } catch (error) {
+      } catch (error2) {
         const restoredCart = await getCartAction().catch(() => null);
         needsRefresh.current = !restoredCart;
         if (restoredCart) serverCart.current = restoredCart;
-        throw error;
+        throw error2;
       }
     });
     mutationQueue.current = request.catch(() => {
@@ -171,9 +185,9 @@ function CartProvider({
   }, [updateCartData]);
   React.useEffect(() => {
     isMounted.current = true;
-    void initializeCart().catch((error) => {
+    void initializeCart().catch((error2) => {
       if (isMounted.current) {
-        console.error("[Replo] Error getting or creating cart:", error);
+        console.error("[Replo] Error getting or creating cart:", error2);
       }
     });
     return () => {
@@ -208,130 +222,178 @@ function CartProvider({
   const closeCart = React.useCallback(() => {
     setIsCartOpen(false);
   }, []);
+  const refreshCart = React.useCallback(async () => {
+    const refreshedCart = await getCartAction();
+    if (!isMounted.current || !refreshedCart || pendingMutations.current !== 0) {
+      return;
+    }
+    serverCart.current = refreshedCart;
+    updateCartData(refreshedCart);
+  }, [updateCartData]);
   const reportedLineQuantities = React.useRef(/* @__PURE__ */ new Map());
-  const addToCart = async (lines, openCartAfterAdd = true) => {
-    const readyCart = cartData ?? serverCart.current ?? await initializeCart();
-    reportedLineQuantities.current.clear();
-    const additions = lines.map((line) => {
-      const lineId = `temp-${uuidv4()}`;
-      optimisticLines.current.set(lineId, line);
-      return { line, lineId };
-    });
-    const applyLines = (cart2) => {
-      let updatedCart2 = { ...cart2 };
-      for (const { line, lineId } of additions) {
-        updatedCart2 = addLineToCart({ cart: updatedCart2, line, lineId });
+  const addToCart = (lines, openCartAfterAdd = true) => {
+    return runWithErrorState("add", async () => {
+      const readyCart = cartData ?? serverCart.current ?? await initializeCart().catch((caught) => {
+        if (openCartAfterAdd) setIsCartOpen(true);
+        throw caught;
+      });
+      reportedLineQuantities.current.clear();
+      const additions = lines.map((line) => {
+        const lineId = `temp-${uuidv4()}`;
+        optimisticLines.current.set(lineId, line);
+        return { line, lineId };
+      });
+      const applyLines = (cart2) => {
+        let updatedCart2 = { ...cart2 };
+        for (const { line, lineId } of additions) {
+          updatedCart2 = addLineToCart({ cart: updatedCart2, line, lineId });
+        }
+        return updatedCart2;
+      };
+      const updatedCart = updateCartData((currentCart) => {
+        return applyLines(currentCart ?? readyCart);
+      });
+      if (analytics) {
+        for (const line of lines) {
+          if (!line.merchandise) {
+            continue;
+          }
+          void analytics.addToCart({
+            data: buildCartLineAnalyticsData({
+              merchandise: line.merchandise,
+              quantity: line.quantity,
+              currencyCode: readyCart.cost.currencyCode
+            })
+          });
+        }
       }
-      return updatedCart2;
-    };
-    const updatedCart = updateCartData((currentCart) => {
-      return applyLines(currentCart ?? readyCart);
+      if (openCartAfterAdd) {
+        setIsCartOpen(true);
+        emitCartView(updatedCart);
+      }
+      const adjustments = [];
+      await enqueueMutation(async (currentCart) => {
+        const savedCart = await addToCartAction(lines, currentCart.id);
+        if (savedCart) {
+          adjustments.push(
+            ...deriveAddToCartAdjustments({
+              cartBeforeAdd: currentCart,
+              requestedLines: lines,
+              savedCart
+            })
+          );
+        }
+        return savedCart;
+      });
+      return { adjustments };
     });
-    if (analytics) {
-      for (const line of lines) {
-        if (!line.merchandise) {
-          continue;
+  };
+  const updateCartItem = (line) => {
+    return runWithErrorState("update", async () => {
+      if (!cartData) {
+        console.warn(
+          "[Replo] Cannot update cart item: no cart exists. Reach out to support@replo.app if this persists."
+        );
+        return { adjustments: [] };
+      }
+      const currentLine = cartData.lines.find((item) => item.id === line.id);
+      const merchandise = currentLine?.merchandise ?? line.merchandise;
+      const quantityDelta = line.quantity - (reportedLineQuantities.current.get(line.id) ?? currentLine?.quantity ?? 0);
+      reportedLineQuantities.current.set(line.id, line.quantity);
+      if (analytics && merchandise && quantityDelta !== 0) {
+        const data = buildCartLineAnalyticsData({
+          merchandise,
+          quantity: Math.abs(quantityDelta),
+          currencyCode: cartData.cost.currencyCode
+        });
+        void (quantityDelta > 0 ? analytics.addToCart({ data }) : analytics.removeFromCart({ data }));
+      }
+      updateCartData((currentCart) => {
+        if (!currentCart) {
+          return null;
+        }
+        return updateLineInCart(currentCart, line);
+      });
+      const adjustments = [];
+      await enqueueMutation(async (currentCart) => {
+        const savedLine = findLine({
+          currentCart,
+          lineId: line.id,
+          originalLine: currentLine
+        });
+        if (!savedLine) {
+          return currentCart;
+        }
+        const savedCart = await updateCartLineItemAction(
+          { ...line, id: savedLine.id },
+          currentCart.id
+        );
+        if (savedCart) {
+          adjustments.push(
+            ...deriveUpdateCartAdjustments({
+              cartBeforeUpdate: currentCart,
+              editedLine: savedLine,
+              requestedQuantity: line.quantity,
+              requestedSellingPlanId: line.sellingPlanId,
+              savedCart
+            })
+          );
         }
-        void analytics.addToCart({
+        return savedCart;
+      });
+      return { adjustments };
+    });
+  };
+  const removeCartItem = (lineId) => {
+    return runWithErrorState("remove", async () => {
+      if (!cartData) {
+        console.warn(
+          "[Replo] Cannot remove cart item: no cart exists. Reach out to support@replo.app if this persists."
+        );
+        return;
+      }
+      const itemToRemove = cartData.lines.find((item) => item.id === lineId);
+      reportedLineQuantities.current.delete(lineId);
+      if (analytics && itemToRemove && itemToRemove.merchandise) {
+        void analytics.removeFromCart({
           data: buildCartLineAnalyticsData({
-            merchandise: line.merchandise,
-            quantity: line.quantity,
-            currencyCode: readyCart.cost.currencyCode
+            merchandise: itemToRemove.merchandise,
+            quantity: itemToRemove.quantity,
+            currencyCode: cartData.cost.currencyCode
           })
         });
       }
-    }
-    if (openCartAfterAdd) {
-      setIsCartOpen(true);
-      emitCartView(updatedCart);
-    }
-    await enqueueMutation((currentCart) => {
-      return addToCartAction(lines, currentCart.id);
-    });
-  };
-  const updateCartItem = async (line) => {
-    if (!cartData) {
-      console.warn(
-        "[Replo] Cannot update cart item: no cart exists. Reach out to support@replo.app if this persists."
-      );
-      return;
-    }
-    const currentLine = cartData.lines.find((item) => item.id === line.id);
-    const merchandise = currentLine?.merchandise ?? line.merchandise;
-    const quantityDelta = line.quantity - (reportedLineQuantities.current.get(line.id) ?? currentLine?.quantity ?? 0);
-    reportedLineQuantities.current.set(line.id, line.quantity);
-    if (analytics && merchandise && quantityDelta !== 0) {
-      const data = buildCartLineAnalyticsData({
-        merchandise,
-        quantity: Math.abs(quantityDelta),
-        currencyCode: cartData.cost.currencyCode
+      updateCartData((currentCart) => {
+        if (!currentCart) {
+          return null;
+        }
+        return removeLineFromCart(currentCart, lineId);
       });
-      void (quantityDelta > 0 ? analytics.addToCart({ data }) : analytics.removeFromCart({ data }));
-    }
-    updateCartData((currentCart) => {
-      if (!currentCart) {
-        return null;
-      }
-      return updateLineInCart(currentCart, line);
-    });
-    await enqueueMutation(async (currentCart) => {
-      const savedLine = findLine({
-        currentCart,
-        lineId: line.id,
-        originalLine: currentLine
+      await enqueueMutation(async (currentCart) => {
+        const savedLine = findLine({
+          currentCart,
+          lineId,
+          originalLine: itemToRemove
+        });
+        return savedLine ? await removeCartLineItemsAction([savedLine.id], currentCart.id) : currentCart;
       });
-      return savedLine ? await updateCartLineItemAction(
-        { ...line, id: savedLine.id },
-        currentCart.id
-      ) : currentCart;
     });
   };
-  const removeCartItem = async (lineId) => {
-    if (!cartData) {
-      console.warn(
-        "[Replo] Cannot remove cart item: no cart exists. Reach out to support@replo.app if this persists."
-      );
-      return;
-    }
-    const itemToRemove = cartData.lines.find((item) => item.id === lineId);
-    reportedLineQuantities.current.delete(lineId);
-    if (analytics && itemToRemove && itemToRemove.merchandise) {
-      void analytics.removeFromCart({
-        data: buildCartLineAnalyticsData({
-          merchandise: itemToRemove.merchandise,
-          quantity: itemToRemove.quantity,
-          currencyCode: cartData.cost.currencyCode
-        })
+  const updateDiscountCodes = (discountCodes) => {
+    return runWithErrorState("discount", async () => {
+      const readyCart = cartData ?? serverCart.current ?? await initializeCart();
+      updateCartData((currentCart) => {
+        return {
+          ...currentCart ?? readyCart,
+          discountCodes: discountCodes.map((code) => ({
+            code,
+            applicable: true
+          }))
+        };
       });
-    }
-    updateCartData((currentCart) => {
-      if (!currentCart) {
-        return null;
-      }
-      return removeLineFromCart(currentCart, lineId);
-    });
-    await enqueueMutation(async (currentCart) => {
-      const savedLine = findLine({
-        currentCart,
-        lineId,
-        originalLine: itemToRemove
+      await enqueueMutation((currentCart) => {
+        return updateCartDiscountCodesAction(discountCodes, currentCart.id);
       });
-      return savedLine ? await removeCartLineItemsAction([savedLine.id], currentCart.id) : currentCart;
-    });
-  };
-  const updateDiscountCodes = async (discountCodes) => {
-    const readyCart = cartData ?? serverCart.current ?? await initializeCart();
-    updateCartData((currentCart) => {
-      return {
-        ...currentCart ?? readyCart,
-        discountCodes: discountCodes.map((code) => ({
-          code,
-          applicable: true
-        }))
-      };
-    });
-    await enqueueMutation((currentCart) => {
-      return updateCartDiscountCodesAction(discountCodes, currentCart.id);
     });
   };
   const buyNow = async (lines, discountCodes) => {
@@ -363,11 +425,14 @@ function CartProvider({
         updateCartItem,
         removeCartItem,
         updateDiscountCodes,
+        refreshCart,
         buyNow,
         checkoutUrl,
         isCartOpen,
         openCart,
-        closeCart
+        closeCart,
+        error,
+        clearError
       },
       children
     }
@@ -394,7 +459,10 @@ function useCart() {
     isCartOpen: context.isCartOpen,
     openCart: context.openCart,
     closeCart: context.closeCart,
-    updateDiscountCodes: context.updateDiscountCodes
+    updateDiscountCodes: context.updateDiscountCodes,
+    refreshCart: context.refreshCart,
+    error: context.error,
+    clearError: context.clearError
   };
 }
 export {