@replohq/sdk 0.1.0

package/cart/cart-provider.d.ts

@@ -0,0 +1,85 @@
+import type { Cart, CartLine, CartLinePayload } from "./cart-types";
+import React from "react";
+/**
+ * Internal cart context type with full functionality.
+ * This is for internal use only - external code should use the limited CartContextType.
+ */
+export interface CartContextTypeInternal {
+    /** The current cart (can be null) */
+    cartData: Cart | null;
+    /** Array of cart line items  */
+    lineItems: CartLine[];
+    /** Total price of all items */
+    subtotal: number;
+    /** Total number of items in cart */
+    itemsCount: number;
+    /** Currency code for the cart */
+    currencyCode: string;
+    /** Function to add items to cart */
+    addToCart: (lines: CartLinePayload[], openCartAfterAdd?: boolean) => Promise<void>;
+    /** Function to update cart item quantity */
+    updateCartItem: (line: CartLinePayload) => Promise<void>;
+    /** Function to remove item from cart */
+    removeCartItem: (lineId: string) => Promise<void>;
+    /** Function to update discount codes on cart */
+    updateDiscountCodes: (discountCodes: string[]) => Promise<void>;
+    /** Function to create cart and checkout immediately */
+    buyNow: (lines: CartLinePayload[], discountCodes?: string[]) => Promise<Cart | null>;
+    /** URL to redirect to checkout */
+    checkoutUrl: string;
+    /** Whether the cart UI is open */
+    isCartOpen: boolean;
+    /** Function to open the cart UI */
+    openCart: () => void;
+    /** Function to close the cart UI */
+    closeCart: () => void;
+}
+/**
+ * Public cart context type for LLM use.
+ * For adding products to cart, use useAddToCart.
+ * For buy now functionality, use useBuyNow.
+ */
+export interface CartContextType {
+    /** Total number of items in cart */
+    itemsCount: number;
+    /** Whether the cart UI is open */
+    isCartOpen: boolean;
+    /** Function to open the cart UI */
+    openCart: () => void;
+    /** Function to close the cart UI */
+    closeCart: () => void;
+    /** Function to update discount codes on cart */
+    updateDiscountCodes: (discountCodes: string[]) => Promise<void>;
+}
+/**
+ * Provider component that manages global cart state and operations. Handles both
+ * server-side cart synchronization and client-side optimistic updates. Supports
+ * editor mode for preview environments.
+ *
+ * @returns A context provider wrapping the children with cart functionality
+ */
+export declare function CartProvider({ children, cart, }: React.PropsWithChildren<{
+    /** Initial cart data from the server (can be null) */
+    cart: Cart | null;
+}>): import("react/jsx-runtime").JSX.Element;
+/**
+ * @deprecated For internal use only. Use useAddToCart or useBuyNow
+ * for cart operations. Use useCart for cart UI state (itemsCount, openCart, closeCart).
+ */
+export declare function useCartInternal(): CartContextTypeInternal;
+/**
+ * Hook to access cart UI state and controls. For adding products to cart,
+ * use useAddToCart. For buy now functionality, use useBuyNow.
+ *
+ * @example
+ * ```tsx
+ * import { useCart } from "@replohq/sdk/cart/cart-provider";
+ *
+ * function MyComponent() {
+ *   const { itemsCount, openCart } = useCart();
+ *   ...
+ * }
+ * ```
+ * @throws Error if used outside of a CartProvider
+ */
+export declare function useCart(): CartContextType;

package/cart/cart-provider.js

@@ -0,0 +1,372 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import React from "react";
+import { fromMinorUnitsToMajorUnits } from "../_vendor/schemas/money.mjs";
+import { v4 as uuidv4 } from "uuid";
+import { useAnalyticsOptional } from "../analytics/analytics-provider";
+import { CanopyError } from "../lib/canopy-error";
+import {
+  addToCartAction,
+  createCartAction,
+  getOrCreateCartAction,
+  removeCartLineItemsAction,
+  updateCartDiscountCodesAction,
+  updateCartLineItemAction
+} from "./cart-actions";
+import { createOptimisticSellingPlanAllocation } from "./utils/variant-to-cart-line";
+class CartContextError extends CanopyError {
+}
+const isEditorMode = () => {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  return window.parent !== window;
+};
+let cartCreationPromise = null;
+function addLineToCart(cart, line) {
+  const existingLineIndex = cart.lines.findIndex((existingLine) => {
+    return existingLine.merchandise?.id === line.id && // Distinguish by selling plan to avoid merging subscription with one-time
+    (line.sellingPlanId ?? null) === (existingLine.sellingPlanAllocation?.sellingPlan.id ?? null);
+  });
+  if (existingLineIndex >= 0) {
+    const updatedLines = [...cart.lines];
+    updatedLines[existingLineIndex] = {
+      ...updatedLines[existingLineIndex],
+      quantity: updatedLines[existingLineIndex].quantity + line.quantity
+    };
+    return { ...cart, lines: updatedLines };
+  } else {
+    const optimisticSellingPlanAllocation = line.sellingPlanId && line.merchandise ? createOptimisticSellingPlanAllocation({
+      merchandise: line.merchandise,
+      sellingPlanId: line.sellingPlanId,
+      currencyCode: cart.cost?.currencyCode ?? "USD"
+    }) : null;
+    const newLine = {
+      id: `temp-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`,
+      quantity: line.quantity,
+      merchandise: line.merchandise ?? null,
+      attributes: line.properties ?? [],
+      sellingPlanAllocation: optimisticSellingPlanAllocation
+    };
+    return { ...cart, lines: [newLine, ...cart.lines] };
+  }
+}
+function updateLineInCart(cart, line) {
+  const updatedLines = cart.lines.map((existingLine) => {
+    return existingLine.id === line.id ? { ...existingLine, quantity: line.quantity } : existingLine;
+  });
+  return { ...cart, lines: updatedLines };
+}
+function removeLineFromCart(cart, lineId) {
+  const updatedLines = cart.lines.filter((line) => line.id !== lineId);
+  return { ...cart, lines: updatedLines };
+}
+const CartContext = React.createContext(
+  void 0
+);
+function CartProvider({
+  children,
+  cart
+}) {
+  const [cartData, setCartData] = React.useState(cart);
+  const [isCartOpen, setIsCartOpen] = React.useState(false);
+  const hasInitialized = React.useRef(false);
+  const analytics = useAnalyticsOptional();
+  React.useEffect(() => {
+    if (hasInitialized.current) {
+      return;
+    }
+    if (cartCreationPromise) {
+      void cartCreationPromise.then((cart2) => {
+        if (cart2) {
+          setCartData(cart2);
+        }
+      });
+      return;
+    }
+    hasInitialized.current = true;
+    cartCreationPromise = getOrCreateCartAction().then((cart2) => {
+      if (cart2) {
+        setCartData(cart2);
+      } else {
+        console.warn(
+          "[Replo] Failed to get or create cart on the server. Reach out to support@replo.app if this persists."
+        );
+      }
+      return cart2;
+    }).catch((error) => {
+      console.error("[Replo] Error getting or creating cart:", error);
+      return null;
+    }).finally(() => {
+      cartCreationPromise = null;
+    });
+  }, []);
+  const lineItems = cartData?.lines ?? [];
+  const subtotal = cartData?.lines.reduce((sum, lineItem) => {
+    if (lineItem.quantity > 0 && lineItem.merchandise) {
+      sum += lineItem.merchandise.price * lineItem.quantity;
+    }
+    return sum;
+  }, 0) ?? 0;
+  const itemsCount = cartData?.lines.reduce((sum, lineItem) => {
+    if (lineItem.quantity > 0) {
+      sum += lineItem.quantity;
+    }
+    return sum;
+  }, 0) ?? 0;
+  const openCart = React.useCallback(() => {
+    setIsCartOpen(true);
+    if (analytics) {
+      const analyticsCurrencyCode = cartData?.cost.currencyCode ?? "USD";
+      void analytics.viewCart({
+        data: {
+          itemCount: itemsCount,
+          subtotal: fromMinorUnitsToMajorUnits({
+            amount: subtotal,
+            currencyCode: analyticsCurrencyCode
+          }),
+          currency: cartData?.cost.currencyCode,
+          lineItems: cartData?.lines.flatMap((item) => {
+            if (!item.merchandise) {
+              return [];
+            }
+            return [
+              {
+                productId: item.merchandise.product.id,
+                variantId: item.merchandise.id,
+                quantity: item.quantity,
+                price: fromMinorUnitsToMajorUnits({
+                  amount: item.merchandise.price,
+                  currencyCode: analyticsCurrencyCode
+                })
+              }
+            ];
+          })
+        }
+      });
+    }
+  }, [analytics, cartData, itemsCount, subtotal]);
+  const closeCart = React.useCallback(() => {
+    setIsCartOpen(false);
+  }, []);
+  const latestUpdateRequestId = React.useRef(null);
+  const addToCart = async (lines, openCartAfterAdd = true) => {
+    if (!cartData) {
+      console.warn(
+        "[Replo] Cannot add to cart: no cart exists. Reach out to support@replo.app if this persists."
+      );
+      return;
+    }
+    setCartData((currentCart) => {
+      if (!currentCart) {
+        return null;
+      }
+      let updatedCart = { ...currentCart };
+      for (const line of lines) {
+        updatedCart = addLineToCart(updatedCart, line);
+      }
+      return updatedCart;
+    });
+    if (openCartAfterAdd) {
+      openCart();
+    }
+    if (analytics) {
+      for (const line of lines) {
+        if (!line.merchandise) {
+          continue;
+        }
+        void analytics.addToCart({
+          data: {
+            productId: line.merchandise.product.id,
+            variantId: line.merchandise.id,
+            quantity: line.quantity,
+            price: fromMinorUnitsToMajorUnits({
+              amount: line.merchandise.price,
+              currencyCode: cartData?.cost.currencyCode ?? "USD"
+            }),
+            currency: cartData?.cost.currencyCode,
+            productTitle: line.merchandise.product.title,
+            variantTitle: line.merchandise.title
+          }
+        });
+      }
+    }
+    const serverCart = await addToCartAction(lines, cartData.id);
+    if (serverCart) {
+      setCartData(serverCart);
+    } else {
+      console.warn(
+        "[Replo] Failed to add item to cart on server. Cart may be out of sync. Reach out to support@replo.app if this persists."
+      );
+    }
+  };
+  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 requestId = uuidv4();
+    latestUpdateRequestId.current = requestId;
+    setCartData((currentCart) => {
+      if (!currentCart) {
+        return null;
+      }
+      return updateLineInCart(currentCart, line);
+    });
+    const serverCart = await updateCartLineItemAction(line, cartData.id);
+    if (latestUpdateRequestId.current === requestId) {
+      if (serverCart) {
+        setCartData(serverCart);
+      } else {
+        console.warn(
+          "[Replo] Failed to update cart item on server. Cart may be out of sync. Reach out to support@replo.app if this persists."
+        );
+      }
+    }
+  };
+  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);
+    if (analytics && itemToRemove && itemToRemove.merchandise) {
+      void analytics.removeFromCart({
+        data: {
+          productId: itemToRemove.merchandise.product.id,
+          variantId: itemToRemove.merchandise.id,
+          quantity: itemToRemove.quantity,
+          price: fromMinorUnitsToMajorUnits({
+            amount: itemToRemove.merchandise.price,
+            currencyCode: cartData.cost.currencyCode
+          }),
+          currency: cartData.cost.currencyCode,
+          productTitle: itemToRemove.merchandise.product.title,
+          variantTitle: itemToRemove.merchandise.title
+        }
+      });
+    }
+    setCartData((currentCart) => {
+      if (!currentCart) {
+        return null;
+      }
+      return removeLineFromCart(currentCart, lineId);
+    });
+    const serverCart = await removeCartLineItemsAction([lineId], cartData.id);
+    if (serverCart) {
+      setCartData(serverCart);
+    } else {
+      console.warn(
+        "[Replo] Failed to remove cart item on server. Cart may be out of sync. Reach out to support@replo.app if this persists."
+      );
+    }
+  };
+  const updateDiscountCodes = async (discountCodes) => {
+    if (!cartData) {
+      console.warn(
+        "[Replo] Cannot update discount codes: no cart exists. Reach out to support@replo.app if this persists."
+      );
+      return;
+    }
+    setCartData((currentCart) => {
+      if (!currentCart) {
+        return null;
+      }
+      return {
+        ...currentCart,
+        discountCodes: discountCodes.map((code) => ({
+          code,
+          applicable: true
+        }))
+      };
+    });
+    const serverCart = await updateCartDiscountCodesAction(
+      discountCodes,
+      cartData.id
+    );
+    if (serverCart) {
+      setCartData(serverCart);
+    } else {
+      console.warn(
+        "[Replo] Failed to update discount codes on server. Cart may be out of sync. Reach out to support@replo.app if this persists."
+      );
+    }
+  };
+  const buyNow = async (lines, discountCodes) => {
+    const cart2 = await createCartAction({
+      lines,
+      skipStoringCart: true,
+      discountCodes
+    });
+    if (cart2) {
+      return cart2;
+    } else {
+      console.warn(
+        "[Replo] Failed to create cart for buy now. Reach out to support@replo.app if this persists."
+      );
+      return null;
+    }
+  };
+  const checkoutUrl = (() => {
+    if (isEditorMode()) {
+      return "/";
+    }
+    return cartData?.checkoutUrl ?? "/";
+  })();
+  return /* @__PURE__ */ jsx(
+    CartContext.Provider,
+    {
+      value: {
+        cartData,
+        lineItems,
+        subtotal,
+        itemsCount,
+        currencyCode: cartData?.cost.currencyCode ?? "USD",
+        addToCart,
+        updateCartItem,
+        removeCartItem,
+        updateDiscountCodes,
+        buyNow,
+        checkoutUrl,
+        isCartOpen,
+        openCart,
+        closeCart
+      },
+      children
+    }
+  );
+}
+function useCartInternal() {
+  const context = React.useContext(CartContext);
+  if (context === void 0) {
+    throw new CartContextError({
+      message: "useCartInternal must be used within a CartProvider"
+    });
+  }
+  return context;
+}
+function useCart() {
+  const context = React.useContext(CartContext);
+  if (context === void 0) {
+    throw new CartContextError({
+      message: "useCart must be used within a CartProvider"
+    });
+  }
+  return {
+    itemsCount: context.itemsCount,
+    isCartOpen: context.isCartOpen,
+    openCart: context.openCart,
+    closeCart: context.closeCart,
+    updateDiscountCodes: context.updateDiscountCodes
+  };
+}
+export {
+  CartProvider,
+  useCart,
+  useCartInternal
+};
+//# sourceMappingURL=cart-provider.js.map

package/cart/cart-provider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../cart/cart-provider.tsx"],
+  "sourcesContent": ["/**\n * Use useCart() hook to access cart UI state (itemsCount, isCartOpen, openCart, closeCart). For adding products to cart, use useAddToCart. For buy now functionality, use useBuyNow.\n * @module\n */\n\"use client\";\n\nimport type { Cart, CartLine, CartLinePayload } from \"./cart-types\";\n\nimport React from \"react\";\n\nimport { fromMinorUnitsToMajorUnits } from \"schemas/money\";\nimport { v4 as uuidv4 } from \"uuid\";\n\nimport { useAnalyticsOptional } from \"../analytics/analytics-provider\";\nimport { CanopyError } from \"../lib/canopy-error\";\nimport {\n  addToCartAction,\n  createCartAction,\n  getOrCreateCartAction,\n  removeCartLineItemsAction,\n  updateCartDiscountCodesAction,\n  updateCartLineItemAction,\n} from \"./cart-actions\";\nimport { createOptimisticSellingPlanAllocation } from \"./utils/variant-to-cart-line\";\n\nclass CartContextError extends CanopyError {}\n\n/**\n * Detects if the app is running in editor mode (iframe).\n *\n * @returns True if running in an iframe (editor mode)\n */\nconst isEditorMode = () => {\n  if (typeof window === \"undefined\") {\n    return false;\n  }\n\n  return window.parent !== window;\n};\n\n// Global promise to prevent multiple cart creation attempts\nlet cartCreationPromise: Promise<Cart | null> | null = null;\n\n/**\n * Client-side cart operation to add a line item. Used in editor mode.\n * Merges with existing lines if they match by merchandise ID and selling plan.\n *\n * @param cart - The cart to add the line to\n * @param line - The cart line payload to add\n * @returns The updated cart\n */\nfunction addLineToCart(cart: Cart, line: CartLinePayload): Cart {\n  const existingLineIndex = cart.lines.findIndex((existingLine) => {\n    return (\n      existingLine.merchandise?.id === line.id &&\n      // Distinguish by selling plan to avoid merging subscription with one-time\n      (line.sellingPlanId ?? null) ===\n        (existingLine.sellingPlanAllocation?.sellingPlan.id ?? null)\n    );\n  });\n\n  if (existingLineIndex >= 0) {\n    // Update existing line\n    const updatedLines = [...cart.lines];\n    updatedLines[existingLineIndex] = {\n      ...updatedLines[existingLineIndex]!,\n      quantity: updatedLines[existingLineIndex]!.quantity + line.quantity,\n    };\n    return { ...cart, lines: updatedLines };\n  } else {\n    const optimisticSellingPlanAllocation =\n      line.sellingPlanId && line.merchandise\n        ? createOptimisticSellingPlanAllocation({\n            merchandise: line.merchandise,\n            sellingPlanId: line.sellingPlanId,\n            currencyCode: cart.cost?.currencyCode ?? \"USD\",\n          })\n        : null;\n\n    const newLine: CartLine = {\n      id: `temp-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`,\n      quantity: line.quantity,\n      merchandise: line.merchandise ?? null,\n      attributes: line.properties ?? [],\n      sellingPlanAllocation: optimisticSellingPlanAllocation,\n    };\n    return { ...cart, lines: [newLine, ...cart.lines] };\n  }\n}\n\n/**\n * Client-side cart operation to update a line item. Used in editor mode.\n *\n * @param cart - The cart containing the line to update\n * @param line - The cart line payload with updated values\n * @returns The updated cart\n */\nfunction updateLineInCart(cart: Cart, line: CartLinePayload): Cart {\n  const updatedLines = cart.lines.map((existingLine) => {\n    return existingLine.id === line.id\n      ? { ...existingLine, quantity: line.quantity }\n      : existingLine;\n  });\n  return { ...cart, lines: updatedLines };\n}\n\n/**\n * Client-side cart operation to remove a line item. Used in editor mode.\n *\n * @param cart - The cart containing the line to remove\n * @param lineId - The ID of the line to remove\n * @returns The updated cart\n */\nfunction removeLineFromCart(cart: Cart, lineId: string): Cart {\n  const updatedLines = cart.lines.filter((line) => line.id !== lineId);\n  return { ...cart, lines: updatedLines };\n}\n\n/**\n * Internal cart context type with full functionality.\n * This is for internal use only - external code should use the limited CartContextType.\n */\nexport interface CartContextTypeInternal {\n  /** The current cart (can be null) */\n  cartData: Cart | null;\n  /** Array of cart line items  */\n  lineItems: CartLine[];\n  /** Total price of all items */\n  subtotal: number;\n  /** Total number of items in cart */\n  itemsCount: number;\n  /** Currency code for the cart */\n  currencyCode: string;\n  /** Function to add items to cart */\n  addToCart: (\n    lines: CartLinePayload[],\n    openCartAfterAdd?: boolean,\n  ) => Promise<void>;\n  /** Function to update cart item quantity */\n  updateCartItem: (line: CartLinePayload) => Promise<void>;\n  /** Function to remove item from cart */\n  removeCartItem: (lineId: string) => Promise<void>;\n  /** Function to update discount codes on cart */\n  updateDiscountCodes: (discountCodes: string[]) => Promise<void>;\n  /** Function to create cart and checkout immediately */\n  buyNow: (\n    lines: CartLinePayload[],\n    discountCodes?: string[],\n  ) => Promise<Cart | null>;\n  /** URL to redirect to checkout */\n  checkoutUrl: string;\n  /** Whether the cart UI is open */\n  isCartOpen: boolean;\n  /** Function to open the cart UI */\n  openCart: () => void;\n  /** Function to close the cart UI */\n  closeCart: () => void;\n}\n\n// NOTE (Gabe, 2026-01-08): We intentionally duplicate properties from CartContextTypeInternal\n// rather than using Pick<> so that TypeDoc generates expanded documentation for each property.\n/**\n * Public cart context type for LLM use.\n * For adding products to cart, use useAddToCart.\n * For buy now functionality, use useBuyNow.\n */\nexport interface CartContextType {\n  /** Total number of items in cart */\n  itemsCount: number;\n  /** Whether the cart UI is open */\n  isCartOpen: boolean;\n  /** Function to open the cart UI */\n  openCart: () => void;\n  /** Function to close the cart UI */\n  closeCart: () => void;\n  /** Function to update discount codes on cart */\n  updateDiscountCodes: (discountCodes: string[]) => Promise<void>;\n}\n\nconst CartContext = React.createContext<CartContextTypeInternal | undefined>(\n  undefined,\n);\n\n/**\n * Provider component that manages global cart state and operations. Handles both\n * server-side cart synchronization and client-side optimistic updates. Supports\n * editor mode for preview environments.\n *\n * @returns A context provider wrapping the children with cart functionality\n */\nexport function CartProvider({\n  children,\n  cart,\n}: React.PropsWithChildren<{\n  /** Initial cart data from the server (can be null) */\n  cart: Cart | null;\n}>) {\n  const [cartData, setCartData] = React.useState<Cart | null>(cart);\n  const [isCartOpen, setIsCartOpen] = React.useState(false);\n  const hasInitialized = React.useRef(false);\n  const analytics = useAnalyticsOptional();\n\n  // Initialize cart on mount\n  // eslint-disable-next-line replo/no-use-effect -- Legacy effect - may or may not be necessary\n  React.useEffect(() => {\n    // Early exit if already initialized\n    if (hasInitialized.current) {\n      return;\n    }\n\n    // If there's already a creation in progress, attach to it\n    if (cartCreationPromise) {\n      void cartCreationPromise.then((cart) => {\n        if (cart) {\n          setCartData(cart);\n        }\n      });\n      return;\n    }\n\n    // Mark as initialized to prevent duplicate calls\n    hasInitialized.current = true;\n\n    // Get existing cart or create new one\n    cartCreationPromise = getOrCreateCartAction()\n      .then((cart) => {\n        if (cart) {\n          setCartData(cart);\n        } else {\n          console.warn(\n            \"[Replo] Failed to get or create cart on the server. Reach out to support@replo.app if this persists.\",\n          );\n        }\n        return cart;\n      })\n      .catch((error) => {\n        console.error(\"[Replo] Error getting or creating cart:\", error);\n        return null;\n      })\n      .finally(() => {\n        // Reset the promise after completion\n        cartCreationPromise = null;\n      });\n  }, []);\n\n  // Derived values - handle null cart gracefully\n  const lineItems = cartData?.lines ?? [];\n\n  const subtotal =\n    cartData?.lines.reduce((sum, lineItem) => {\n      if (lineItem.quantity > 0 && lineItem.merchandise) {\n        sum += lineItem.merchandise.price * lineItem.quantity;\n      }\n      return sum;\n    }, 0) ?? 0;\n\n  const itemsCount =\n    cartData?.lines.reduce((sum, lineItem) => {\n      if (lineItem.quantity > 0) {\n        sum += lineItem.quantity;\n      }\n      return sum;\n    }, 0) ?? 0;\n\n  // Cart UI state functions\n  const openCart = React.useCallback(() => {\n    setIsCartOpen(true);\n\n    if (analytics) {\n      const analyticsCurrencyCode = cartData?.cost.currencyCode ?? \"USD\";\n      // NOTE (Max, 2026-08-03): cart amounts are integer minor units, but the\n      // analytics payload speaks decimal major units (ad pixels + the Replo\n      // store), so convert at this boundary.\n      void analytics.viewCart({\n        data: {\n          itemCount: itemsCount,\n          subtotal: fromMinorUnitsToMajorUnits({\n            amount: subtotal,\n            currencyCode: analyticsCurrencyCode,\n          }),\n          currency: cartData?.cost.currencyCode,\n          lineItems: cartData?.lines.flatMap((item) => {\n            if (!item.merchandise) {\n              return [];\n            }\n            return [\n              {\n                productId: item.merchandise.product.id,\n                variantId: item.merchandise.id,\n                quantity: item.quantity,\n                price: fromMinorUnitsToMajorUnits({\n                  amount: item.merchandise.price,\n                  currencyCode: analyticsCurrencyCode,\n                }),\n              },\n            ];\n          }),\n        },\n      });\n    }\n  }, [analytics, cartData, itemsCount, subtotal]);\n\n  const closeCart = React.useCallback(() => {\n    setIsCartOpen(false);\n  }, []);\n\n  // Track the latest update request to avoid updating with stale responses\n  const latestUpdateRequestId = React.useRef<string | null>(null);\n\n  const addToCart = async (\n    lines: CartLinePayload[],\n    openCartAfterAdd: boolean = true,\n  ) => {\n    // If no cart exists, we can't add to it\n    if (!cartData) {\n      console.warn(\n        \"[Replo] Cannot add to cart: no cart exists. Reach out to support@replo.app if this persists.\",\n      );\n      return;\n    }\n\n    // Optimistic update - use functional form to avoid stale state\n    setCartData((currentCart) => {\n      if (!currentCart) {\n        return null;\n      }\n      let updatedCart = { ...currentCart };\n      for (const line of lines) {\n        updatedCart = addLineToCart(updatedCart, line);\n      }\n      return updatedCart;\n    });\n\n    if (openCartAfterAdd) {\n      openCart();\n    }\n\n    if (analytics) {\n      for (const line of lines) {\n        if (!line.merchandise) {\n          continue;\n        }\n        // NOTE (Max, 2026-08-03): cart amounts are integer minor units, but the\n        // analytics payload speaks decimal major units (ad pixels + the Replo\n        // store), so convert at this boundary.\n        void analytics.addToCart({\n          data: {\n            productId: line.merchandise.product.id,\n            variantId: line.merchandise.id,\n            quantity: line.quantity,\n            price: fromMinorUnitsToMajorUnits({\n              amount: line.merchandise.price,\n              currencyCode: cartData?.cost.currencyCode ?? \"USD\",\n            }),\n            currency: cartData?.cost.currencyCode,\n            productTitle: line.merchandise.product.title,\n            variantTitle: line.merchandise.title,\n          },\n        });\n      }\n    }\n\n    // Direct server update (no debouncing)\n    const serverCart = await addToCartAction(lines, cartData.id);\n    if (serverCart) {\n      setCartData(serverCart);\n    } else {\n      console.warn(\n        \"[Replo] Failed to add item to cart on server. Cart may be out of sync. Reach out to support@replo.app if this persists.\",\n      );\n    }\n  };\n\n  const updateCartItem = async (line: CartLinePayload) => {\n    // If no cart exists, we can't update it\n    if (!cartData) {\n      console.warn(\n        \"[Replo] Cannot update cart item: no cart exists. Reach out to support@replo.app if this persists.\",\n      );\n      return;\n    }\n\n    // Generate a unique request ID for this update\n    const requestId = uuidv4();\n    latestUpdateRequestId.current = requestId;\n\n    // Optimistic update - use functional form to avoid stale state\n    setCartData((currentCart) => {\n      if (!currentCart) {\n        return null;\n      }\n      return updateLineInCart(currentCart, line);\n    });\n\n    // Server update\n    const serverCart = await updateCartLineItemAction(line, cartData.id);\n\n    // Only update if this is still the latest request\n    if (latestUpdateRequestId.current === requestId) {\n      if (serverCart) {\n        setCartData(serverCart);\n      } else {\n        console.warn(\n          \"[Replo] Failed to update cart item on server. Cart may be out of sync. Reach out to support@replo.app if this persists.\",\n        );\n      }\n    }\n  };\n\n  const removeCartItem = async (lineId: string) => {\n    if (!cartData) {\n      console.warn(\n        \"[Replo] Cannot remove cart item: no cart exists. Reach out to support@replo.app if this persists.\",\n      );\n      return;\n    }\n\n    const itemToRemove = cartData.lines.find((item) => item.id === lineId);\n    if (analytics && itemToRemove && itemToRemove.merchandise) {\n      // NOTE (Max, 2026-08-03): cart amounts are integer minor units, but the\n      // analytics payload speaks decimal major units (ad pixels + the Replo\n      // store), so convert at this boundary.\n      void analytics.removeFromCart({\n        data: {\n          productId: itemToRemove.merchandise.product.id,\n          variantId: itemToRemove.merchandise.id,\n          quantity: itemToRemove.quantity,\n          price: fromMinorUnitsToMajorUnits({\n            amount: itemToRemove.merchandise.price,\n            currencyCode: cartData.cost.currencyCode,\n          }),\n          currency: cartData.cost.currencyCode,\n          productTitle: itemToRemove.merchandise.product.title,\n          variantTitle: itemToRemove.merchandise.title,\n        },\n      });\n    }\n\n    // Optimistic update - use functional form to avoid stale state\n    setCartData((currentCart) => {\n      if (!currentCart) {\n        return null;\n      }\n      return removeLineFromCart(currentCart, lineId);\n    });\n\n    // Direct server update (no debouncing)\n    const serverCart = await removeCartLineItemsAction([lineId], cartData.id);\n    if (serverCart) {\n      setCartData(serverCart);\n    } else {\n      console.warn(\n        \"[Replo] Failed to remove cart item on server. Cart may be out of sync. Reach out to support@replo.app if this persists.\",\n      );\n    }\n  };\n\n  const updateDiscountCodes = async (discountCodes: string[]) => {\n    // If no cart exists, we can't update discount codes\n    if (!cartData) {\n      console.warn(\n        \"[Replo] Cannot update discount codes: no cart exists. Reach out to support@replo.app if this persists.\",\n      );\n      return;\n    }\n\n    // Optimistic update - use functional form to avoid stale state\n    setCartData((currentCart) => {\n      if (!currentCart) {\n        return null;\n      }\n      return {\n        ...currentCart,\n        discountCodes: discountCodes.map((code) => ({\n          code,\n          applicable: true,\n        })),\n      };\n    });\n\n    // Server update\n    const serverCart = await updateCartDiscountCodesAction(\n      discountCodes,\n      cartData.id,\n    );\n    if (serverCart) {\n      setCartData(serverCart);\n    } else {\n      console.warn(\n        \"[Replo] Failed to update discount codes on server. Cart may be out of sync. Reach out to support@replo.app if this persists.\",\n      );\n    }\n  };\n\n  const buyNow = async (lines: CartLinePayload[], discountCodes?: string[]) => {\n    // Create a new cart with the specified lines and discount codes\n    const cart = await createCartAction({\n      lines,\n      skipStoringCart: true,\n      discountCodes,\n    });\n    if (cart) {\n      return cart;\n    } else {\n      console.warn(\n        \"[Replo] Failed to create cart for buy now. Reach out to support@replo.app if this persists.\",\n      );\n      return null;\n    }\n  };\n\n  const checkoutUrl: string = (() => {\n    if (isEditorMode()) {\n      return \"/\";\n    }\n\n    return cartData?.checkoutUrl ?? \"/\";\n  })();\n\n  return (\n    <CartContext.Provider\n      value={{\n        cartData,\n        lineItems,\n        subtotal,\n        itemsCount,\n        currencyCode: cartData?.cost.currencyCode ?? \"USD\",\n        addToCart,\n        updateCartItem,\n        removeCartItem,\n        updateDiscountCodes,\n        buyNow,\n        checkoutUrl,\n        isCartOpen,\n        openCart,\n        closeCart,\n      }}\n    >\n      {children}\n    </CartContext.Provider>\n  );\n}\n\n/**\n * @deprecated For internal use only. Use useAddToCart or useBuyNow\n * for cart operations. Use useCart for cart UI state (itemsCount, openCart, closeCart).\n */\nexport function useCartInternal(): CartContextTypeInternal {\n  const context = React.useContext(CartContext);\n  if (context === undefined) {\n    throw new CartContextError({\n      message: \"useCartInternal must be used within a CartProvider\",\n    });\n  }\n  return context;\n}\n\n/**\n * Hook to access cart UI state and controls. For adding products to cart,\n * use useAddToCart. For buy now functionality, use useBuyNow.\n *\n * @example\n * ```tsx\n * import { useCart } from \"@replohq/sdk/cart/cart-provider\";\n *\n * function MyComponent() {\n *   const { itemsCount, openCart } = useCart();\n *   ...\n * }\n * ```\n * @throws Error if used outside of a CartProvider\n */\nexport function useCart(): CartContextType {\n  const context = React.useContext(CartContext);\n  if (context === undefined) {\n    throw new CartContextError({\n      message: \"useCart must be used within a CartProvider\",\n    });\n  }\n  return {\n    itemsCount: context.itemsCount,\n    isCartOpen: context.isCartOpen,\n    openCart: context.openCart,\n    closeCart: context.closeCart,\n    updateDiscountCodes: context.updateDiscountCodes,\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["cart"]
+}

package/cart/cart-schema.d.ts

@@ -0,0 +1,74 @@
+import { z } from "zod";
+export declare const cartSchema: z.ZodObject<{
+    id: z.ZodString;
+    lines: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        quantity: z.ZodNumber;
+        merchandise: z.ZodObject<{
+            id: z.ZodString;
+            product: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$strip>;
+            title: z.ZodString;
+            price: z.ZodNumber;
+            compareAtPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            image: z.ZodNullable<z.ZodObject<{
+                url: z.ZodString;
+                altText: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            selectedOptions: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        attributes: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        }, z.core.$strip>>;
+        sellingPlanAllocation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            sellingPlan: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            priceAdjustments: z.ZodArray<z.ZodObject<{
+                compareAtPrice: z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                }, z.core.$strip>;
+                perDeliveryPrice: z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                }, z.core.$strip>;
+                price: z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                }, z.core.$strip>;
+                unitPrice: z.ZodNullable<z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currencyCode: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            checkoutChargeAmount: z.ZodObject<{
+                amount: z.ZodNumber;
+                currencyCode: z.ZodString;
+            }, z.core.$strip>;
+            remainingBalanceChargeAmount: z.ZodObject<{
+                amount: z.ZodNumber;
+                currencyCode: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    cost: z.ZodObject<{
+        subtotalAmount: z.ZodNumber;
+        totalAmount: z.ZodNumber;
+        currencyCode: z.ZodString;
+    }, z.core.$strip>;
+    checkoutUrl: z.ZodOptional<z.ZodString>;
+    discountCodes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        applicable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Cart = z.infer<typeof cartSchema>;

package/cart/cart-schema.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+const cartLineAttributeSchema = z.object({
+  key: z.string(),
+  value: z.union([z.string(), z.number(), z.boolean()])
+});
+const cartImageSchema = z.object({
+  url: z.string(),
+  altText: z.string().nullable()
+});
+const amountSchema = z.number().int();
+const amountWithCurrencyCodeSchema = z.object({
+  amount: amountSchema,
+  currencyCode: z.string()
+});
+const sellingPlanPriceAdjustmentSchema = z.object({
+  compareAtPrice: amountWithCurrencyCodeSchema,
+  perDeliveryPrice: amountWithCurrencyCodeSchema,
+  price: amountWithCurrencyCodeSchema,
+  unitPrice: amountWithCurrencyCodeSchema.nullable()
+});
+const sellingPlanAllocationSchema = z.object({
+  sellingPlan: z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().nullable()
+  }),
+  priceAdjustments: z.array(sellingPlanPriceAdjustmentSchema),
+  checkoutChargeAmount: amountWithCurrencyCodeSchema,
+  remainingBalanceChargeAmount: amountWithCurrencyCodeSchema
+});
+const cartLineMerchandiseSchema = z.object({
+  id: z.string(),
+  product: z.object({
+    id: z.string(),
+    title: z.string()
+  }),
+  title: z.string(),
+  price: amountSchema,
+  compareAtPrice: amountSchema.nullish(),
+  image: cartImageSchema.nullable(),
+  selectedOptions: z.array(z.object({ name: z.string(), value: z.string() }))
+});
+const cartLineSchema = z.object({
+  id: z.string(),
+  quantity: z.number(),
+  merchandise: cartLineMerchandiseSchema,
+  attributes: z.array(cartLineAttributeSchema),
+  sellingPlanAllocation: sellingPlanAllocationSchema.nullish()
+});
+const cartCostSchema = z.object({
+  subtotalAmount: amountSchema,
+  totalAmount: amountSchema,
+  currencyCode: z.string()
+});
+const cartDiscountCodeSchema = z.object({
+  code: z.string(),
+  applicable: z.boolean()
+});
+const cartSchema = z.object({
+  id: z.string(),
+  lines: z.array(cartLineSchema),
+  cost: cartCostSchema,
+  checkoutUrl: z.string().optional(),
+  discountCodes: z.array(cartDiscountCodeSchema).optional()
+});
+export {
+  cartSchema
+};
+//# sourceMappingURL=cart-schema.js.map

package/cart/cart-schema.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../cart/cart-schema.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\n// NOTE (Ryan, 2026-07-23, REPL-27611): Self-contained copy of the cart wire\n// schema that the SDK gateway validates on published pages, so nothing\n// shipped to a generated site imports from `schemas`. The backend keeps the\n// canonical copy in `schemas/cart.ts` (its cart services can't depend on\n// the SDK without a cycle); `cart-schema.spec.ts` keeps the two in lockstep.\n// This module is internal wire validation; public types live in `cart/cart-types`.\n\n// ---------------------------------------------------------------------------\n// Cart line attribute\n// ---------------------------------------------------------------------------\n\nconst cartLineAttributeSchema = z.object({\n  key: z.string(),\n  value: z.union([z.string(), z.number(), z.boolean()]),\n});\n\n// ---------------------------------------------------------------------------\n// Image (cart-scoped; lightweight compared to objectType image)\n// ---------------------------------------------------------------------------\n\nconst cartImageSchema = z.object({\n  url: z.string(),\n  altText: z.string().nullable(),\n});\n\n// ---------------------------------------------------------------------------\n// Selling plan types\n// ---------------------------------------------------------------------------\n\n// Integer minor units (Stripe convention): 1999 = $19.99 USD. Mirrors\n// amountSchema in schemas/money.ts, which shipped code cannot import.\nconst amountSchema = z.number().int();\nconst amountWithCurrencyCodeSchema = z.object({\n  amount: amountSchema,\n  currencyCode: z.string(),\n});\n\nconst sellingPlanPriceAdjustmentSchema = z.object({\n  compareAtPrice: amountWithCurrencyCodeSchema,\n  perDeliveryPrice: amountWithCurrencyCodeSchema,\n  price: amountWithCurrencyCodeSchema,\n  unitPrice: amountWithCurrencyCodeSchema.nullable(),\n});\n\nconst sellingPlanAllocationSchema = z.object({\n  sellingPlan: z.object({\n    id: z.string(),\n    name: z.string(),\n    description: z.string().nullable(),\n  }),\n  priceAdjustments: z.array(sellingPlanPriceAdjustmentSchema),\n  checkoutChargeAmount: amountWithCurrencyCodeSchema,\n  remainingBalanceChargeAmount: amountWithCurrencyCodeSchema,\n});\n\n// ---------------------------------------------------------------------------\n// Cart line merchandise\n// ---------------------------------------------------------------------------\n\nconst cartLineMerchandiseSchema = z.object({\n  id: z.string(),\n  product: z.object({\n    id: z.string(),\n    title: z.string(),\n  }),\n  title: z.string(),\n  price: amountSchema,\n  compareAtPrice: amountSchema.nullish(),\n  image: cartImageSchema.nullable(),\n  selectedOptions: z.array(z.object({ name: z.string(), value: z.string() })),\n});\n\n// ---------------------------------------------------------------------------\n// Cart line\n// ---------------------------------------------------------------------------\n\nconst cartLineSchema = z.object({\n  id: z.string(),\n  quantity: z.number(),\n  merchandise: cartLineMerchandiseSchema,\n  attributes: z.array(cartLineAttributeSchema),\n  sellingPlanAllocation: sellingPlanAllocationSchema.nullish(),\n});\n\n// ---------------------------------------------------------------------------\n// Cart cost\n// ---------------------------------------------------------------------------\n\nconst cartCostSchema = z.object({\n  subtotalAmount: amountSchema,\n  totalAmount: amountSchema,\n  currencyCode: z.string(),\n});\n\n// ---------------------------------------------------------------------------\n// Cart discount code\n// ---------------------------------------------------------------------------\n\nconst cartDiscountCodeSchema = z.object({\n  code: z.string(),\n  applicable: z.boolean(),\n});\n\n// ---------------------------------------------------------------------------\n// Cart (top level)\n// ---------------------------------------------------------------------------\n\nexport const cartSchema = z.object({\n  id: z.string(),\n  lines: z.array(cartLineSchema),\n  cost: cartCostSchema,\n  checkoutUrl: z.string().optional(),\n  discountCodes: z.array(cartDiscountCodeSchema).optional(),\n});\n\nexport type Cart = z.infer<typeof cartSchema>;\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAalB,MAAM,0BAA0B,EAAE,OAAO;AAAA,EACvC,KAAK,EAAE,OAAO;AAAA,EACd,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAMD,MAAM,kBAAkB,EAAE,OAAO;AAAA,EAC/B,KAAK,EAAE,OAAO;AAAA,EACd,SAAS,EAAE,OAAO,EAAE,SAAS;AAC/B,CAAC;AAQD,MAAM,eAAe,EAAE,OAAO,EAAE,IAAI;AACpC,MAAM,+BAA+B,EAAE,OAAO;AAAA,EAC5C,QAAQ;AAAA,EACR,cAAc,EAAE,OAAO;AACzB,CAAC;AAED,MAAM,mCAAmC,EAAE,OAAO;AAAA,EAChD,gBAAgB;AAAA,EAChB,kBAAkB;AAAA,EAClB,OAAO;AAAA,EACP,WAAW,6BAA6B,SAAS;AACnD,CAAC;AAED,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC3C,aAAa,EAAE,OAAO;AAAA,IACpB,IAAI,EAAE,OAAO;AAAA,IACb,MAAM,EAAE,OAAO;AAAA,IACf,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACnC,CAAC;AAAA,EACD,kBAAkB,EAAE,MAAM,gCAAgC;AAAA,EAC1D,sBAAsB;AAAA,EACtB,8BAA8B;AAChC,CAAC;AAMD,MAAM,4BAA4B,EAAE,OAAO;AAAA,EACzC,IAAI,EAAE,OAAO;AAAA,EACb,SAAS,EAAE,OAAO;AAAA,IAChB,IAAI,EAAE,OAAO;AAAA,IACb,OAAO,EAAE,OAAO;AAAA,EAClB,CAAC;AAAA,EACD,OAAO,EAAE,OAAO;AAAA,EAChB,OAAO;AAAA,EACP,gBAAgB,aAAa,QAAQ;AAAA,EACrC,OAAO,gBAAgB,SAAS;AAAA,EAChC,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5E,CAAC;AAMD,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,IAAI,EAAE,OAAO;AAAA,EACb,UAAU,EAAE,OAAO;AAAA,EACnB,aAAa;AAAA,EACb,YAAY,EAAE,MAAM,uBAAuB;AAAA,EAC3C,uBAAuB,4BAA4B,QAAQ;AAC7D,CAAC;AAMD,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,cAAc,EAAE,OAAO;AACzB,CAAC;AAMD,MAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,MAAM,EAAE,OAAO;AAAA,EACf,YAAY,EAAE,QAAQ;AACxB,CAAC;AAMM,MAAM,aAAa,EAAE,OAAO;AAAA,EACjC,IAAI,EAAE,OAAO;AAAA,EACb,OAAO,EAAE,MAAM,cAAc;AAAA,EAC7B,MAAM;AAAA,EACN,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,eAAe,EAAE,MAAM,sBAAsB,EAAE,SAAS;AAC1D,CAAC;",
+  "names": []
+}