@replohq/sdk 1.3.0 → 1.3.2

package/cart/buy-now-action.d.ts

@@ -7,7 +7,18 @@ import type { CartLineAttribute } from "./cart-types";
  * Variant IDs are expected to already be Storefront GIDs (from data loader output).
  * No internal→external ID mapping is needed.
  */
-export declare function buyNowAction(input: {
+export declare function buyNowAction(input: Parameters<typeof buyNowWithRecoveryAction>[0]): Promise<{
+    result: "created";
+    redirectUrl: string;
+} | {
+    result: "outOfStock";
+    variants: {
+        variantId: string;
+        available: number;
+    }[];
+}>;
+export declare function buyNowWithRecoveryAction(input: {
+    checkoutAttemptId?: string;
     lineItems: {
         variantId: string;
         quantity: number;
@@ -19,6 +30,9 @@ export declare function buyNowAction(input: {
 }): Promise<{
     result: "created";
     redirectUrl: string;
+} | {
+    result: "restartCheckout";
+    message: string;
 } | {
     result: "outOfStock";
     variants: {

package/cart/buy-now-action.js

@@ -14,6 +14,13 @@ class BuyNowError extends CanopyError {
 class BuyNowCartCreationError extends CanopyError {
 }
 async function buyNowAction(input) {
+  const outcome = await buyNowWithRecoveryAction(input);
+  if (outcome.result === "restartCheckout") {
+    throw new BuyNowCartCreationError({ message: outcome.message });
+  }
+  return outcome;
+}
+async function buyNowWithRecoveryAction(input) {
   const { lineItems, discountCodes, pageUrl } = input;
   const headersList = await headers();
   const host = headersList.get("host");
@@ -42,9 +49,10 @@ async function buyNowAction(input) {
   });
   if (checkoutProvider === "stripe") {
     const env = await getEnv();
-    const temporaryCartId = uuidv4();
+    const temporaryCartId = input.checkoutAttemptId ?? uuidv4();
     const body = {
       cartId: temporaryCartId,
+      checkoutAttemptId: temporaryCartId,
       lines: cartLines.map((line) => ({
         variantId: line.id,
         quantity: line.quantity,
@@ -63,6 +71,18 @@ async function buyNowAction(input) {
       body: JSON.stringify(body)
     });
     if (!response.ok) {
+      if (response.status === 409) {
+        const terminalAttempt = z.object({
+          error: z.literal("checkoutUnavailable"),
+          retry: z.literal("newAttempt"),
+          message: z.string().min(1)
+        }).safeParse(await response.json());
+        if (terminalAttempt.success)
+          return {
+            result: "restartCheckout",
+            message: terminalAttempt.data.message
+          };
+      }
       throw new BuyNowCartCreationError({
         message: "Failed to create Stripe checkout session for buy now",
         additionalData: {
@@ -108,6 +128,7 @@ async function buyNowAction(input) {
   return { result: "created", redirectUrl: checkoutUrl.toString() };
 }
 export {
-  buyNowAction
+  buyNowAction,
+  buyNowWithRecoveryAction
 };
 //# sourceMappingURL=buy-now-action.js.map

package/cart/buy-now-action.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../cart/buy-now-action.ts"],
-  "sourcesContent": ["\"use server\";\n\nimport type { CartLineAttribute } from \"./cart-types\";\n\nimport { headers } from \"next/headers\";\n\nimport { v4 as uuidv4 } from \"uuid\";\nimport { z } from \"zod\";\n\nimport { getEnv } from \"../env\";\nimport { CanopyError } from \"../lib/canopy-error\";\nimport { getCheckoutProvider } from \"../lib/integration-utils\";\nimport { buildBaseUrl } from \"../lib/url-utils\";\nimport { createCartAction } from \"./cart-actions\";\nimport { REPLO_ATTRIBUTION_PROPERTY } from \"./cart-types\";\nimport { getReturnUrls } from \"./return-urls\";\n\nclass BuyNowError extends CanopyError {}\nclass BuyNowCartCreationError extends CanopyError {}\n\n/**\n * Server action that handles the full buy-now flow:\n * 1. For Shopify: creates a cart via the canopy-api-backed gateway, returns checkoutUrl.\n * 2. For Stripe: creates a Stripe checkout session via canopy-api, returns session URL.\n *\n * Variant IDs are expected to already be Storefront GIDs (from data loader output).\n * No internal\u2192external ID mapping is needed.\n */\nexport async function buyNowAction(input: {\n  lineItems: {\n    variantId: string;\n    quantity: number;\n    sellingPlanId: string | null;\n    properties: CartLineAttribute[];\n  }[];\n  discountCodes: string[];\n  pageUrl: string;\n}): Promise<\n  | { result: \"created\"; redirectUrl: string }\n  | {\n      result: \"outOfStock\";\n      // Each short variant with the purchasable remainder, so the cart can\n      // clamp quantities to what's in stock instead of dropping whole lines.\n      variants: { variantId: string; available: number }[];\n    }\n> {\n  const { lineItems, discountCodes, pageUrl } = input;\n\n  const headersList = await headers();\n  const host = headersList.get(\"host\");\n  if (!host) {\n    throw new BuyNowError({ message: \"Missing host header\" });\n  }\n  const { origin, cancelUrl } = getReturnUrls({\n    host,\n    forwardedHost: headersList.get(\"x-forwarded-host\"),\n    forwardedProto: headersList.get(\"x-forwarded-proto\"),\n    requestOrigin: headersList.get(\"origin\"),\n    pageUrl,\n  });\n\n  const checkoutProvider = await getCheckoutProvider();\n\n  const cartLines = lineItems.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    return {\n      id: item.variantId,\n      quantity: item.quantity,\n      sellingPlanId: item.sellingPlanId,\n      properties,\n    };\n  });\n\n  if (checkoutProvider === \"stripe\") {\n    const env = await getEnv();\n    const temporaryCartId = uuidv4();\n\n    const body = {\n      cartId: temporaryCartId,\n      lines: cartLines.map((line) => ({\n        variantId: line.id,\n        quantity: line.quantity,\n        properties: line.properties,\n      })),\n      projectId: env.PROJECT_ID,\n      // canopy appends session_id={CHECKOUT_SESSION_ID} at session creation;\n      // the success route resolves it into the order status page.\n      successUrl: `${origin}/checkout/success`,\n      cancelUrl,\n    };\n\n    const canopyApiUrl = `${buildBaseUrl(env.CANOPY_API_HOST)}/api/v1/stripe-checkout/create-session`;\n    const response = await fetch(canopyApiUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      throw new BuyNowCartCreationError({\n        message: \"Failed to create Stripe checkout session for buy now\",\n        additionalData: {\n          status: response.status,\n          statusText: response.statusText,\n        },\n      });\n    }\n\n    const payload: unknown = await response.json();\n    const outOfStock = z\n      .object({\n        result: z.literal(\"outOfStock\"),\n        variants: z.array(\n          z.object({\n            variantId: z.string(),\n            available: z.number().int().min(0),\n          }),\n        ),\n      })\n      .safeParse(payload);\n    if (outOfStock.success) {\n      return { result: \"outOfStock\", variants: outOfStock.data.variants };\n    }\n    const created = z.object({ url: z.string() }).safeParse(payload);\n    if (!created.success) {\n      throw new BuyNowCartCreationError({\n        message: \"Stripe checkout session response missing redirect URL\",\n        cause: created.error,\n      });\n    }\n    return { result: \"created\", redirectUrl: created.data.url };\n  }\n\n  // Shopify and other integrations: create cart via canopy-api-backed gateway\n  const cart = await createCartAction({\n    lines: cartLines,\n    skipStoringCart: true,\n    discountCodes: discountCodes.length > 0 ? discountCodes : undefined,\n  });\n\n  if (!cart?.checkoutUrl) {\n    throw new BuyNowCartCreationError({\n      message: \"Failed to create cart or get checkout URL\",\n      additionalData: { lineItems, discountCodes },\n    });\n  }\n\n  const checkoutUrl = new URL(cart.checkoutUrl, origin);\n  return { result: \"created\", redirectUrl: checkoutUrl.toString() };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["\"use server\";\n\nimport type { CartLineAttribute } from \"./cart-types\";\n\nimport { headers } from \"next/headers\";\n\nimport { v4 as uuidv4 } from \"uuid\";\nimport { z } from \"zod\";\n\nimport { getEnv } from \"../env\";\nimport { CanopyError } from \"../lib/canopy-error\";\nimport { getCheckoutProvider } from \"../lib/integration-utils\";\nimport { buildBaseUrl } from \"../lib/url-utils\";\nimport { createCartAction } from \"./cart-actions\";\nimport { REPLO_ATTRIBUTION_PROPERTY } from \"./cart-types\";\nimport { getReturnUrls } from \"./return-urls\";\n\nclass BuyNowError extends CanopyError {}\nclass BuyNowCartCreationError extends CanopyError {}\n\n/**\n * Server action that handles the full buy-now flow:\n * 1. For Shopify: creates a cart via the canopy-api-backed gateway, returns checkoutUrl.\n * 2. For Stripe: creates a Stripe checkout session via canopy-api, returns session URL.\n *\n * Variant IDs are expected to already be Storefront GIDs (from data loader output).\n * No internal\u2192external ID mapping is needed.\n */\nexport async function buyNowAction(\n  input: Parameters<typeof buyNowWithRecoveryAction>[0],\n) {\n  const outcome = await buyNowWithRecoveryAction(input);\n  if (outcome.result === \"restartCheckout\") {\n    throw new BuyNowCartCreationError({ message: outcome.message });\n  }\n  return outcome;\n}\n\nexport async function buyNowWithRecoveryAction(input: {\n  checkoutAttemptId?: string;\n  lineItems: {\n    variantId: string;\n    quantity: number;\n    sellingPlanId: string | null;\n    properties: CartLineAttribute[];\n  }[];\n  discountCodes: string[];\n  pageUrl: string;\n}): Promise<\n  | { result: \"created\"; redirectUrl: string }\n  | { result: \"restartCheckout\"; message: string }\n  | {\n      result: \"outOfStock\";\n      // Each short variant with the purchasable remainder, so the cart can\n      // clamp quantities to what's in stock instead of dropping whole lines.\n      variants: { variantId: string; available: number }[];\n    }\n> {\n  const { lineItems, discountCodes, pageUrl } = input;\n\n  const headersList = await headers();\n  const host = headersList.get(\"host\");\n  if (!host) {\n    throw new BuyNowError({ message: \"Missing host header\" });\n  }\n  const { origin, cancelUrl } = getReturnUrls({\n    host,\n    forwardedHost: headersList.get(\"x-forwarded-host\"),\n    forwardedProto: headersList.get(\"x-forwarded-proto\"),\n    requestOrigin: headersList.get(\"origin\"),\n    pageUrl,\n  });\n\n  const checkoutProvider = await getCheckoutProvider();\n\n  const cartLines = lineItems.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    return {\n      id: item.variantId,\n      quantity: item.quantity,\n      sellingPlanId: item.sellingPlanId,\n      properties,\n    };\n  });\n\n  if (checkoutProvider === \"stripe\") {\n    const env = await getEnv();\n    const temporaryCartId = input.checkoutAttemptId ?? uuidv4();\n\n    const body = {\n      cartId: temporaryCartId,\n      checkoutAttemptId: temporaryCartId,\n      lines: cartLines.map((line) => ({\n        variantId: line.id,\n        quantity: line.quantity,\n        properties: line.properties,\n      })),\n      projectId: env.PROJECT_ID,\n      // canopy appends session_id={CHECKOUT_SESSION_ID} at session creation;\n      // the success route resolves it into the order status page.\n      successUrl: `${origin}/checkout/success`,\n      cancelUrl,\n    };\n\n    const canopyApiUrl = `${buildBaseUrl(env.CANOPY_API_HOST)}/api/v1/stripe-checkout/create-session`;\n    const response = await fetch(canopyApiUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      if (response.status === 409) {\n        const terminalAttempt = z\n          .object({\n            error: z.literal(\"checkoutUnavailable\"),\n            retry: z.literal(\"newAttempt\"),\n            message: z.string().min(1),\n          })\n          .safeParse(await response.json());\n        if (terminalAttempt.success)\n          return {\n            result: \"restartCheckout\",\n            message: terminalAttempt.data.message,\n          };\n      }\n      throw new BuyNowCartCreationError({\n        message: \"Failed to create Stripe checkout session for buy now\",\n        additionalData: {\n          status: response.status,\n          statusText: response.statusText,\n        },\n      });\n    }\n\n    const payload: unknown = await response.json();\n    const outOfStock = z\n      .object({\n        result: z.literal(\"outOfStock\"),\n        variants: z.array(\n          z.object({\n            variantId: z.string(),\n            available: z.number().int().min(0),\n          }),\n        ),\n      })\n      .safeParse(payload);\n    if (outOfStock.success) {\n      return { result: \"outOfStock\", variants: outOfStock.data.variants };\n    }\n    const created = z.object({ url: z.string() }).safeParse(payload);\n    if (!created.success) {\n      throw new BuyNowCartCreationError({\n        message: \"Stripe checkout session response missing redirect URL\",\n        cause: created.error,\n      });\n    }\n    return { result: \"created\", redirectUrl: created.data.url };\n  }\n\n  // Shopify and other integrations: create cart via canopy-api-backed gateway\n  const cart = await createCartAction({\n    lines: cartLines,\n    skipStoringCart: true,\n    discountCodes: discountCodes.length > 0 ? discountCodes : undefined,\n  });\n\n  if (!cart?.checkoutUrl) {\n    throw new BuyNowCartCreationError({\n      message: \"Failed to create cart or get checkout URL\",\n      additionalData: { lineItems, discountCodes },\n    });\n  }\n\n  const checkoutUrl = new URL(cart.checkoutUrl, origin);\n  return { result: \"created\", redirectUrl: checkoutUrl.toString() };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/cart/cart-provider.js

@@ -7,6 +7,7 @@ import { CanopyError } from "../lib/canopy-error";
 import {
   addToCartAction,
   createCartAction,
+  getCartAction,
   getOrCreateCartAction,
   removeCartLineItemsAction,
   updateCartDiscountCodesAction,
@@ -21,7 +22,11 @@ import { createOptimisticSellingPlanAllocation } from "./utils/variant-to-cart-l
 class CartContextError extends CanopyError {
 }
 let cartCreationPromise = null;
-function addLineToCart(cart, line) {
+function addLineToCart({
+  cart,
+  line,
+  lineId
+}) {
   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);
@@ -40,7 +45,7 @@ function addLineToCart(cart, line) {
       currencyCode: cart.cost?.currencyCode ?? "USD"
     }) : null;
     const newLine = {
-      id: `temp-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`,
+      id: lineId,
       quantity: line.quantity,
       merchandise: line.merchandise ?? null,
       attributes: line.properties ?? [],
@@ -70,14 +75,76 @@ function CartProvider({
   const [isCartOpen, setIsCartOpen] = React.useState(false);
   const hasInitialized = React.useRef(false);
   const analytics = useAnalyticsOptional();
+  const serverCart = React.useRef(cart);
+  const needsRefresh = React.useRef(false);
+  const mutationQueue = React.useRef(Promise.resolve());
+  const pendingMutations = React.useRef(0);
+  const optimisticLines = React.useRef(/* @__PURE__ */ new Map());
+  const enqueueMutation = async (save) => {
+    pendingMutations.current += 1;
+    const request = mutationQueue.current.then(async () => {
+      await cartCreationPromise;
+      if (needsRefresh.current) {
+        const restoredCart = await getCartAction();
+        if (!restoredCart)
+          throw new CartContextError({
+            message: "Your cart could not be refreshed. Please reload before changing it."
+          });
+        serverCart.current = restoredCart;
+        needsRefresh.current = false;
+      }
+      if (!serverCart.current) return;
+      try {
+        const savedCart = await save(serverCart.current);
+        if (!savedCart)
+          throw new CartContextError({
+            message: "Your cart could not be saved. Please try again."
+          });
+        serverCart.current = savedCart;
+      } catch (error) {
+        const restoredCart = await getCartAction().catch(() => null);
+        needsRefresh.current = !restoredCart;
+        if (restoredCart) serverCart.current = restoredCart;
+        throw error;
+      }
+    });
+    mutationQueue.current = request.catch(() => {
+    }).then(() => {
+      pendingMutations.current -= 1;
+      if (pendingMutations.current === 0) {
+        reportedLineQuantities.current.clear();
+        optimisticLines.current.clear();
+        setCartData(serverCart.current);
+      }
+    });
+    await request;
+  };
+  const findLine = ({
+    currentCart,
+    lineId,
+    originalLine
+  }) => {
+    const existingLine = currentCart.lines.find((line) => line.id === lineId);
+    if (existingLine) return existingLine;
+    const optimisticLine = optimisticLines.current.get(lineId);
+    const merchandiseId = optimisticLine?.id ?? originalLine?.merchandise?.id;
+    const sellingPlanId = optimisticLine?.sellingPlanId ?? originalLine?.sellingPlanAllocation?.sellingPlan.id ?? null;
+    return currentCart.lines.find((line) => {
+      return line.merchandise?.id === merchandiseId && (line.sellingPlanAllocation?.sellingPlan.id ?? null) === sellingPlanId;
+    });
+  };
   React.useEffect(() => {
+    const initializeCart = (loadedCart) => {
+      serverCart.current = loadedCart;
+      if (pendingMutations.current === 0) setCartData(loadedCart);
+    };
     if (hasInitialized.current) {
       return;
     }
     if (cartCreationPromise) {
       void cartCreationPromise.then((cart2) => {
         if (cart2) {
-          setCartData(cart2);
+          initializeCart(cart2);
         }
       });
       return;
@@ -85,7 +152,7 @@ function CartProvider({
     hasInitialized.current = true;
     cartCreationPromise = getOrCreateCartAction().then((cart2) => {
       if (cart2) {
-        setCartData(cart2);
+        initializeCart(cart2);
       } else {
         console.warn(
           "[Replo] Failed to get or create cart on the server. Reach out to support@replo.app if this persists."
@@ -127,7 +194,6 @@ function CartProvider({
   const closeCart = React.useCallback(() => {
     setIsCartOpen(false);
   }, []);
-  const latestUpdateRequestId = React.useRef(null);
   const reportedLineQuantities = React.useRef(/* @__PURE__ */ new Map());
   const addToCart = async (lines, openCartAfterAdd = true) => {
     if (!cartData) {
@@ -137,10 +203,15 @@ function CartProvider({
       return;
     }
     reportedLineQuantities.current.clear();
+    const additions = lines.map((line) => {
+      const lineId = `temp-${uuidv4()}`;
+      optimisticLines.current.set(lineId, line);
+      return { line, lineId };
+    });
     const applyLines = (cart2) => {
       let updatedCart = { ...cart2 };
-      for (const line of lines) {
-        updatedCart = addLineToCart(updatedCart, line);
+      for (const { line, lineId } of additions) {
+        updatedCart = addLineToCart({ cart: updatedCart, line, lineId });
       }
       return updatedCart;
     };
@@ -165,14 +236,9 @@ function CartProvider({
       setIsCartOpen(true);
       emitCartView(applyLines(cartData));
     }
-    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."
-      );
-    }
+    await enqueueMutation((currentCart) => {
+      return addToCartAction(lines, currentCart.id);
+    });
   };
   const updateCartItem = async (line) => {
     if (!cartData) {
@@ -181,8 +247,6 @@ function CartProvider({
       );
       return;
     }
-    const requestId = uuidv4();
-    latestUpdateRequestId.current = requestId;
     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);
@@ -201,17 +265,17 @@ function CartProvider({
       }
       return updateLineInCart(currentCart, line);
     });
-    const serverCart = await updateCartLineItemAction(line, cartData.id);
-    if (latestUpdateRequestId.current === requestId) {
-      reportedLineQuantities.current.delete(line.id);
-      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."
-        );
-      }
-    }
+    await enqueueMutation(async (currentCart) => {
+      const savedLine = findLine({
+        currentCart,
+        lineId: line.id,
+        originalLine: currentLine
+      });
+      return savedLine ? await updateCartLineItemAction(
+        { ...line, id: savedLine.id },
+        currentCart.id
+      ) : currentCart;
+    });
   };
   const removeCartItem = async (lineId) => {
     if (!cartData) {
@@ -237,14 +301,14 @@ function CartProvider({
       }
       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."
-      );
-    }
+    await enqueueMutation(async (currentCart) => {
+      const savedLine = findLine({
+        currentCart,
+        lineId,
+        originalLine: itemToRemove
+      });
+      return savedLine ? await removeCartLineItemsAction([savedLine.id], currentCart.id) : currentCart;
+    });
   };
   const updateDiscountCodes = async (discountCodes) => {
     if (!cartData) {
@@ -265,17 +329,9 @@ function CartProvider({
         }))
       };
     });
-    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."
-      );
-    }
+    await enqueueMutation((currentCart) => {
+      return updateCartDiscountCodesAction(discountCodes, currentCart.id);
+    });
   };
   const buyNow = async (lines, discountCodes) => {
     const cart2 = await createCartAction({

package/cart/cart-provider.js.map

@@ -1,7 +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 { 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 {\n  buildCartLineAnalyticsData,\n  buildCartViewAnalyticsData,\n} from \"./utils/cart-analytics\";\nimport { recalculateCartCost } from \"./utils/cart-utils\";\nimport { createOptimisticSellingPlanAllocation } from \"./utils/variant-to-cart-line\";\n\nclass CartContextError extends CanopyError {}\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 recalculateCartCost({ ...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 recalculateCartCost({ ...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 recalculateCartCost({ ...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 recalculateCartCost({ ...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.\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 emitCartView = React.useCallback(\n    (cart: Cart | null) => {\n      if (analytics) {\n        void analytics.viewCart({ data: buildCartViewAnalyticsData(cart) });\n      }\n    },\n    [analytics],\n  );\n\n  const openCart = React.useCallback(() => {\n    setIsCartOpen(true);\n    emitCartView(cartData);\n  }, [cartData, emitCartView]);\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  // Last quantity reported to analytics per line with an update in flight, so\n  // overlapping stepper clicks diff against it instead of the same render-time\n  // quantity. Dropped once the server confirms or another mutation replaces\n  // the line set.\n  const reportedLineQuantities = React.useRef(new Map<string, number>());\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    reportedLineQuantities.current.clear();\n    const applyLines = (cart: Cart) => {\n      let updatedCart = { ...cart };\n      for (const line of lines) {\n        updatedCart = addLineToCart(updatedCart, line);\n      }\n      return updatedCart;\n    };\n\n    // Optimistic update - use functional form to avoid stale state\n    setCartData((currentCart) => {\n      return currentCart ? applyLines(currentCart) : null;\n    });\n\n    if (analytics) {\n      for (const line of lines) {\n        if (!line.merchandise) {\n          continue;\n        }\n        void analytics.addToCart({\n          data: buildCartLineAnalyticsData({\n            merchandise: line.merchandise,\n            quantity: line.quantity,\n            currencyCode: cartData.cost.currencyCode,\n          }),\n        });\n      }\n    }\n\n    if (openCartAfterAdd) {\n      setIsCartOpen(true);\n      // The cart view has to describe the cart with the new lines in it, and\n      // React state has not re-rendered yet, so build it from the same\n      // projection the optimistic update used.\n      emitCartView(applyLines(cartData));\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    // Ad platforms have no \"quantity changed\" event: an increase is an add of\n    // the difference and a decrease is a remove of the difference, matching\n    // how Shopify themes report their cart steppers.\n    const currentLine = cartData.lines.find((item) => item.id === line.id);\n    const merchandise = currentLine?.merchandise ?? line.merchandise;\n    const quantityDelta =\n      line.quantity -\n      (reportedLineQuantities.current.get(line.id) ??\n        currentLine?.quantity ??\n        0);\n    reportedLineQuantities.current.set(line.id, line.quantity);\n    if (analytics && merchandise && quantityDelta !== 0) {\n      const data = buildCartLineAnalyticsData({\n        merchandise,\n        quantity: Math.abs(quantityDelta),\n        currencyCode: cartData.cost.currencyCode,\n      });\n      void (quantityDelta > 0\n        ? analytics.addToCart({ data })\n        : analytics.removeFromCart({ data }));\n    }\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      reportedLineQuantities.current.delete(line.id);\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    reportedLineQuantities.current.delete(lineId);\n    if (analytics && itemToRemove && itemToRemove.merchandise) {\n      void analytics.removeFromCart({\n        data: buildCartLineAnalyticsData({\n          merchandise: itemToRemove.merchandise,\n          quantity: itemToRemove.quantity,\n          currencyCode: cartData.cost.currencyCode,\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 = cartData?.checkoutUrl ?? \"/\";\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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",
+  "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 { v4 as uuidv4 } from \"uuid\";\n\nimport { useAnalyticsOptional } from \"../analytics/analytics-provider\";\nimport { CanopyError } from \"../lib/canopy-error\";\nimport {\n  addToCartAction,\n  createCartAction,\n  getCartAction,\n  getOrCreateCartAction,\n  removeCartLineItemsAction,\n  updateCartDiscountCodesAction,\n  updateCartLineItemAction,\n} from \"./cart-actions\";\nimport {\n  buildCartLineAnalyticsData,\n  buildCartViewAnalyticsData,\n} from \"./utils/cart-analytics\";\nimport { recalculateCartCost } from \"./utils/cart-utils\";\nimport { createOptimisticSellingPlanAllocation } from \"./utils/variant-to-cart-line\";\n\nclass CartContextError extends CanopyError {}\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({\n  cart,\n  line,\n  lineId,\n}: {\n  cart: Cart;\n  line: CartLinePayload;\n  lineId: string;\n}): 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 recalculateCartCost({ ...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: lineId,\n      quantity: line.quantity,\n      merchandise: line.merchandise ?? null,\n      attributes: line.properties ?? [],\n      sellingPlanAllocation: optimisticSellingPlanAllocation,\n    };\n    return recalculateCartCost({ ...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 recalculateCartCost({ ...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 recalculateCartCost({ ...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.\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  const serverCart = React.useRef(cart);\n  const needsRefresh = React.useRef(false);\n  const mutationQueue = React.useRef(Promise.resolve());\n  const pendingMutations = React.useRef(0);\n  const optimisticLines = React.useRef(new Map<string, CartLinePayload>());\n\n  const enqueueMutation = async (\n    save: (currentCart: Cart) => Promise<Cart | null>,\n  ) => {\n    pendingMutations.current += 1;\n    const request = mutationQueue.current.then(async () => {\n      await cartCreationPromise;\n      if (needsRefresh.current) {\n        const restoredCart = await getCartAction();\n        if (!restoredCart)\n          throw new CartContextError({\n            message:\n              \"Your cart could not be refreshed. Please reload before changing it.\",\n          });\n        serverCart.current = restoredCart;\n        needsRefresh.current = false;\n      }\n      if (!serverCart.current) return;\n      try {\n        const savedCart = await save(serverCart.current);\n        if (!savedCart)\n          throw new CartContextError({\n            message: \"Your cart could not be saved. Please try again.\",\n          });\n        serverCart.current = savedCart;\n      } catch (error) {\n        // A lost response may still have persisted the add that the next removal targets.\n        const restoredCart = await getCartAction().catch(() => null);\n        needsRefresh.current = !restoredCart;\n        if (restoredCart) serverCart.current = restoredCart;\n        throw error;\n      }\n    });\n    // Cookie writes must finish in shopper order, including after a failed request.\n    mutationQueue.current = request\n      .catch(() => {})\n      .then(() => {\n        pendingMutations.current -= 1;\n        if (pendingMutations.current === 0) {\n          reportedLineQuantities.current.clear();\n          optimisticLines.current.clear();\n          setCartData(serverCart.current);\n        }\n      });\n    await request;\n  };\n\n  const findLine = ({\n    currentCart,\n    lineId,\n    originalLine,\n  }: {\n    currentCart: Cart;\n    lineId: string;\n    originalLine?: CartLine;\n  }) => {\n    const existingLine = currentCart.lines.find((line) => line.id === lineId);\n    if (existingLine) return existingLine;\n    const optimisticLine = optimisticLines.current.get(lineId);\n    const merchandiseId = optimisticLine?.id ?? originalLine?.merchandise?.id;\n    const sellingPlanId =\n      optimisticLine?.sellingPlanId ??\n      originalLine?.sellingPlanAllocation?.sellingPlan.id ??\n      null;\n    return currentCart.lines.find((line) => {\n      return (\n        line.merchandise?.id === merchandiseId &&\n        (line.sellingPlanAllocation?.sellingPlan.id ?? null) === sellingPlanId\n      );\n    });\n  };\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    const initializeCart = (loadedCart: Cart) => {\n      serverCart.current = loadedCart;\n      if (pendingMutations.current === 0) setCartData(loadedCart);\n    };\n\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          initializeCart(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          initializeCart(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 emitCartView = React.useCallback(\n    (cart: Cart | null) => {\n      if (analytics) {\n        void analytics.viewCart({ data: buildCartViewAnalyticsData(cart) });\n      }\n    },\n    [analytics],\n  );\n\n  const openCart = React.useCallback(() => {\n    setIsCartOpen(true);\n    emitCartView(cartData);\n  }, [cartData, emitCartView]);\n\n  const closeCart = React.useCallback(() => {\n    setIsCartOpen(false);\n  }, []);\n\n  // Last quantity reported to analytics per line with an update in flight, so\n  // overlapping stepper clicks diff against it instead of the same render-time\n  // quantity. Dropped once the server confirms or another mutation replaces\n  // the line set.\n  const reportedLineQuantities = React.useRef(new Map<string, number>());\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    reportedLineQuantities.current.clear();\n    const additions = lines.map((line) => {\n      const lineId = `temp-${uuidv4()}`;\n      optimisticLines.current.set(lineId, line);\n      return { line, lineId };\n    });\n    const applyLines = (cart: Cart) => {\n      let updatedCart = { ...cart };\n      for (const { line, lineId } of additions) {\n        updatedCart = addLineToCart({ cart: updatedCart, line, lineId });\n      }\n      return updatedCart;\n    };\n\n    // Optimistic update - use functional form to avoid stale state\n    setCartData((currentCart) => {\n      return currentCart ? applyLines(currentCart) : null;\n    });\n\n    if (analytics) {\n      for (const line of lines) {\n        if (!line.merchandise) {\n          continue;\n        }\n        void analytics.addToCart({\n          data: buildCartLineAnalyticsData({\n            merchandise: line.merchandise,\n            quantity: line.quantity,\n            currencyCode: cartData.cost.currencyCode,\n          }),\n        });\n      }\n    }\n\n    if (openCartAfterAdd) {\n      setIsCartOpen(true);\n      // The cart view has to describe the cart with the new lines in it, and\n      // React state has not re-rendered yet, so build it from the same\n      // projection the optimistic update used.\n      emitCartView(applyLines(cartData));\n    }\n\n    await enqueueMutation((currentCart) => {\n      return addToCartAction(lines, currentCart.id);\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    // Ad platforms have no \"quantity changed\" event: an increase is an add of\n    // the difference and a decrease is a remove of the difference, matching\n    // how Shopify themes report their cart steppers.\n    const currentLine = cartData.lines.find((item) => item.id === line.id);\n    const merchandise = currentLine?.merchandise ?? line.merchandise;\n    const quantityDelta =\n      line.quantity -\n      (reportedLineQuantities.current.get(line.id) ??\n        currentLine?.quantity ??\n        0);\n    reportedLineQuantities.current.set(line.id, line.quantity);\n    if (analytics && merchandise && quantityDelta !== 0) {\n      const data = buildCartLineAnalyticsData({\n        merchandise,\n        quantity: Math.abs(quantityDelta),\n        currencyCode: cartData.cost.currencyCode,\n      });\n      void (quantityDelta > 0\n        ? analytics.addToCart({ data })\n        : analytics.removeFromCart({ data }));\n    }\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    await enqueueMutation(async (currentCart) => {\n      const savedLine = findLine({\n        currentCart,\n        lineId: line.id,\n        originalLine: currentLine,\n      });\n      return savedLine\n        ? await updateCartLineItemAction(\n            { ...line, id: savedLine.id },\n            currentCart.id,\n          )\n        : currentCart;\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    reportedLineQuantities.current.delete(lineId);\n    if (analytics && itemToRemove && itemToRemove.merchandise) {\n      void analytics.removeFromCart({\n        data: buildCartLineAnalyticsData({\n          merchandise: itemToRemove.merchandise,\n          quantity: itemToRemove.quantity,\n          currencyCode: cartData.cost.currencyCode,\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    await enqueueMutation(async (currentCart) => {\n      const savedLine = findLine({\n        currentCart,\n        lineId,\n        originalLine: itemToRemove,\n      });\n      return savedLine\n        ? await removeCartLineItemsAction([savedLine.id], currentCart.id)\n        : currentCart;\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    await enqueueMutation((currentCart) => {\n      return updateCartDiscountCodesAction(discountCodes, currentCart.id);\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 = cartData?.checkoutUrl ?? \"/\";\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/hooks/use-buy-now.js

@@ -3,12 +3,15 @@ import React from "react";
 import { useClientValue } from "../../hooks/use-client-value";
 import { CanopyError } from "../../lib/canopy-error";
 import { navigateExternal } from "../../lib/external-navigation";
-import { buyNowAction } from "../buy-now-action";
+import { buyNowWithRecoveryAction } from "../buy-now-action";
 const REPLO_LOCAL_STORAGE_SESSION_KEY = "_replo_sid";
 const REPLO_SESSION_ID_KEY = "rsid";
 const REPLO_CLIENT_ID_KEY = "rclid";
 class ProductHasNoVariantsError extends CanopyError {
 }
+class CheckoutAttemptError extends CanopyError {
+}
+const checkoutAttempts = /* @__PURE__ */ new Map();
 function useBuyNow() {
   const reploSessionString = useClientValue(
     () => localStorage.getItem(REPLO_LOCAL_STORAGE_SESSION_KEY),
@@ -21,7 +24,7 @@ function useBuyNow() {
           message: "No variants provided"
         });
       }
-      const buyNowResult = await buyNowAction({
+      const checkoutInput = {
         lineItems: variants.map((variant) => ({
           variantId: variant.variantId,
           quantity: variant.quantity ?? 1,
@@ -30,7 +33,29 @@ function useBuyNow() {
         })),
         discountCodes: options?.discountCodes ?? [],
         pageUrl: window.location.href
+      };
+      const attemptStorageKey = `replo-checkout-attempt:${JSON.stringify(checkoutInput)}`;
+      let checkoutAttemptId = checkoutAttempts.get(attemptStorageKey);
+      try {
+        checkoutAttemptId ??= sessionStorage.getItem(attemptStorageKey) ?? crypto.randomUUID();
+        sessionStorage.setItem(attemptStorageKey, checkoutAttemptId);
+      } catch {
+        checkoutAttemptId ??= crypto.randomUUID();
+      }
+      checkoutAttempts.set(attemptStorageKey, checkoutAttemptId);
+      const buyNowResult = await buyNowWithRecoveryAction({
+        ...checkoutInput,
+        checkoutAttemptId
       });
+      checkoutAttempts.delete(attemptStorageKey);
+      try {
+        sessionStorage.removeItem(attemptStorageKey);
+      } catch {
+        checkoutAttempts.set(attemptStorageKey, crypto.randomUUID());
+      }
+      if (buyNowResult.result === "restartCheckout") {
+        throw new CheckoutAttemptError({ message: buyNowResult.message });
+      }
       if (buyNowResult.result === "outOfStock") {
         return { result: "outOfStock", variants: buyNowResult.variants };
       }

package/cart/hooks/use-buy-now.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../cart/hooks/use-buy-now.ts"],
-  "sourcesContent": ["/**\n * Use useBuyNow() hook to create \"Buy Now\" buttons that skip the cart and go directly to checkout.\n * Calls a server action to create the cart/checkout session, then redirects the browser.\n * @module\n */\n\"use client\";\n\nimport React from \"react\";\n\nimport { useClientValue } from \"../../hooks/use-client-value\";\nimport { CanopyError } from \"../../lib/canopy-error\";\nimport { navigateExternal } from \"../../lib/external-navigation\";\nimport { buyNowAction } from \"../buy-now-action\";\n\n// Analytics constants - defined locally to avoid dependency on analytics-client package\nconst REPLO_LOCAL_STORAGE_SESSION_KEY = \"_replo_sid\";\nconst REPLO_SESSION_ID_KEY = \"rsid\";\nconst REPLO_CLIENT_ID_KEY = \"rclid\";\n\n// Analytics session data type - defined locally to avoid dependency\ninterface AnalyticsSessionData {\n  sessionId: string;\n  reploId: string;\n  expiresAt: number;\n  createdAt: number;\n  conversionsCounter: number;\n  isEntryPage: boolean;\n}\n\nclass ProductHasNoVariantsError extends CanopyError {}\n\n/**\n * What a `buyNow` call did. Out of stock is an expected storefront outcome\n * (a buyer can race the last unit), so it rides the return value rather than\n * a thrown error; `variants` carries each short variant with the purchasable\n * remainder so the button can render a sold-out state.\n */\nexport type BuyNowOutcome =\n  | { result: \"redirected\" }\n  | {\n      result: \"outOfStock\";\n      variants: { variantId: string; available: number }[];\n    };\n\nexport interface VariantBuyNowInfo {\n  variantId: string;\n  quantity?: number;\n  sellingPlanId?: string | null;\n}\n\n/**\n * React hook that returns a `buyNow` function for express checkout flows.\n * Handles creating the cart/checkout session server-side and redirecting\n * the browser to checkout.\n *\n * @example\n *\n * ```tsx\n * import { useBuyNow } from \"@replohq/sdk/cart/hooks/use-buy-now\";\n *\n * function MyComponent({ selectedVariant, selectedSellingPlan, quantity }) {\n *   const { buyNow } = useBuyNow();\n *   const [isSoldOut, setIsSoldOut] = React.useState(false);\n *\n *   return (\n *     <Button\n *       disabled={!selectedVariant?.availableForSale || isSoldOut}\n *       onClick={async () => {\n *         if (selectedVariant) {\n *           const outcome = await buyNow(\n *             [\n *               {\n *                 variantId: selectedVariant.id,\n *                 quantity,\n *                 sellingPlanId: selectedSellingPlan?.id,\n *               },\n *             ],\n *             { discountCodes: [\"SUMMER2024\"] }\n *           );\n *           if (outcome.result === \"outOfStock\") {\n *             setIsSoldOut(true);\n *           }\n *         }\n *       }}\n *     >\n *       {isSoldOut ? \"Sold out\" : \"Shop Now\"}\n *     </Button>\n *   );\n * }\n * ```\n *\n * @returns Object containing the buyNow function\n */\nexport function useBuyNow() {\n  const reploSessionString = useClientValue(\n    () => localStorage.getItem(REPLO_LOCAL_STORAGE_SESSION_KEY),\n    null,\n  );\n\n  const buyNow = React.useCallback(\n    async (\n      variants: VariantBuyNowInfo[],\n      options?: { discountCodes?: string[] },\n    ): Promise<BuyNowOutcome> => {\n      if (!variants || variants.length === 0) {\n        throw new ProductHasNoVariantsError({\n          message: \"No variants provided\",\n        });\n      }\n\n      const buyNowResult = await buyNowAction({\n        lineItems: variants.map((variant) => ({\n          variantId: variant.variantId,\n          quantity: variant.quantity ?? 1,\n          sellingPlanId: variant.sellingPlanId ?? null,\n          properties: [],\n        })),\n        discountCodes: options?.discountCodes ?? [],\n        pageUrl: window.location.href,\n      });\n      if (buyNowResult.result === \"outOfStock\") {\n        return { result: \"outOfStock\", variants: buyNowResult.variants };\n      }\n\n      const url = new URL(buyNowResult.redirectUrl);\n\n      // Only append tracking params for non-Stripe checkout URLs (e.g. Shopify).\n      // Stripe checkout URLs should not be modified with extra query params.\n      const isStripeCheckout = url.hostname.endsWith(\"stripe.com\");\n      if (!isStripeCheckout) {\n        const currentParams = new URLSearchParams(window.location.search);\n        for (const [key, value] of currentParams.entries()) {\n          if (!url.searchParams.has(key)) {\n            url.searchParams.set(key, value);\n          }\n        }\n\n        if (reploSessionString) {\n          try {\n            const sessionData: AnalyticsSessionData =\n              JSON.parse(reploSessionString);\n            if (sessionData.sessionId && sessionData.reploId) {\n              url.searchParams.set(REPLO_SESSION_ID_KEY, sessionData.sessionId);\n              url.searchParams.set(REPLO_CLIENT_ID_KEY, sessionData.reploId);\n            }\n          } catch {\n            // Ignore invalid session data\n          }\n        }\n      }\n\n      navigateExternal(url.toString());\n      return { result: \"redirected\" };\n    },\n    [reploSessionString],\n  );\n\n  return { buyNow };\n}\n"],
-  "mappings": ";AAOA,OAAO,WAAW;AAElB,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AACjC,SAAS,oBAAoB;AAG7B,MAAM,kCAAkC;AACxC,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAY5B,MAAM,kCAAkC,YAAY;AAAC;AAgE9C,SAAS,YAAY;AAC1B,QAAM,qBAAqB;AAAA,IACzB,MAAM,aAAa,QAAQ,+BAA+B;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,SAAS,MAAM;AAAA,IACnB,OACE,UACA,YAC2B;AAC3B,UAAI,CAAC,YAAY,SAAS,WAAW,GAAG;AACtC,cAAM,IAAI,0BAA0B;AAAA,UAClC,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAEA,YAAM,eAAe,MAAM,aAAa;AAAA,QACtC,WAAW,SAAS,IAAI,CAAC,aAAa;AAAA,UACpC,WAAW,QAAQ;AAAA,UACnB,UAAU,QAAQ,YAAY;AAAA,UAC9B,eAAe,QAAQ,iBAAiB;AAAA,UACxC,YAAY,CAAC;AAAA,QACf,EAAE;AAAA,QACF,eAAe,SAAS,iBAAiB,CAAC;AAAA,QAC1C,SAAS,OAAO,SAAS;AAAA,MAC3B,CAAC;AACD,UAAI,aAAa,WAAW,cAAc;AACxC,eAAO,EAAE,QAAQ,cAAc,UAAU,aAAa,SAAS;AAAA,MACjE;AAEA,YAAM,MAAM,IAAI,IAAI,aAAa,WAAW;AAI5C,YAAM,mBAAmB,IAAI,SAAS,SAAS,YAAY;AAC3D,UAAI,CAAC,kBAAkB;AACrB,cAAM,gBAAgB,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAChE,mBAAW,CAAC,KAAK,KAAK,KAAK,cAAc,QAAQ,GAAG;AAClD,cAAI,CAAC,IAAI,aAAa,IAAI,GAAG,GAAG;AAC9B,gBAAI,aAAa,IAAI,KAAK,KAAK;AAAA,UACjC;AAAA,QACF;AAEA,YAAI,oBAAoB;AACtB,cAAI;AACF,kBAAM,cACJ,KAAK,MAAM,kBAAkB;AAC/B,gBAAI,YAAY,aAAa,YAAY,SAAS;AAChD,kBAAI,aAAa,IAAI,sBAAsB,YAAY,SAAS;AAChE,kBAAI,aAAa,IAAI,qBAAqB,YAAY,OAAO;AAAA,YAC/D;AAAA,UACF,QAAQ;AAAA,UAER;AAAA,QACF;AAAA,MACF;AAEA,uBAAiB,IAAI,SAAS,CAAC;AAC/B,aAAO,EAAE,QAAQ,aAAa;AAAA,IAChC;AAAA,IACA,CAAC,kBAAkB;AAAA,EACrB;AAEA,SAAO,EAAE,OAAO;AAClB;",
+  "sourcesContent": ["/**\n * Use useBuyNow() hook to create \"Buy Now\" buttons that skip the cart and go directly to checkout.\n * Calls a server action to create the cart/checkout session, then redirects the browser.\n * @module\n */\n\"use client\";\n\nimport React from \"react\";\n\nimport { useClientValue } from \"../../hooks/use-client-value\";\nimport { CanopyError } from \"../../lib/canopy-error\";\nimport { navigateExternal } from \"../../lib/external-navigation\";\nimport { buyNowWithRecoveryAction } from \"../buy-now-action\";\n\n// Analytics constants - defined locally to avoid dependency on analytics-client package\nconst REPLO_LOCAL_STORAGE_SESSION_KEY = \"_replo_sid\";\nconst REPLO_SESSION_ID_KEY = \"rsid\";\nconst REPLO_CLIENT_ID_KEY = \"rclid\";\n\n// Analytics session data type - defined locally to avoid dependency\ninterface AnalyticsSessionData {\n  sessionId: string;\n  reploId: string;\n  expiresAt: number;\n  createdAt: number;\n  conversionsCounter: number;\n  isEntryPage: boolean;\n}\n\nclass ProductHasNoVariantsError extends CanopyError {}\nclass CheckoutAttemptError extends CanopyError {}\n\nconst checkoutAttempts = new Map<string, string>();\n\n/**\n * What a `buyNow` call did. Out of stock is an expected storefront outcome\n * (a buyer can race the last unit), so it rides the return value rather than\n * a thrown error; `variants` carries each short variant with the purchasable\n * remainder so the button can render a sold-out state.\n */\nexport type BuyNowOutcome =\n  | { result: \"redirected\" }\n  | {\n      result: \"outOfStock\";\n      variants: { variantId: string; available: number }[];\n    };\n\nexport interface VariantBuyNowInfo {\n  variantId: string;\n  quantity?: number;\n  sellingPlanId?: string | null;\n}\n\n/**\n * React hook that returns a `buyNow` function for express checkout flows.\n * Handles creating the cart/checkout session server-side and redirecting\n * the browser to checkout.\n *\n * @example\n *\n * ```tsx\n * import { useBuyNow } from \"@replohq/sdk/cart/hooks/use-buy-now\";\n *\n * function MyComponent({ selectedVariant, selectedSellingPlan, quantity }) {\n *   const { buyNow } = useBuyNow();\n *   const [isSoldOut, setIsSoldOut] = React.useState(false);\n *\n *   return (\n *     <Button\n *       disabled={!selectedVariant?.availableForSale || isSoldOut}\n *       onClick={async () => {\n *         if (selectedVariant) {\n *           const outcome = await buyNow(\n *             [\n *               {\n *                 variantId: selectedVariant.id,\n *                 quantity,\n *                 sellingPlanId: selectedSellingPlan?.id,\n *               },\n *             ],\n *             { discountCodes: [\"SUMMER2024\"] }\n *           );\n *           if (outcome.result === \"outOfStock\") {\n *             setIsSoldOut(true);\n *           }\n *         }\n *       }}\n *     >\n *       {isSoldOut ? \"Sold out\" : \"Shop Now\"}\n *     </Button>\n *   );\n * }\n * ```\n *\n * @returns Object containing the buyNow function\n */\nexport function useBuyNow() {\n  const reploSessionString = useClientValue(\n    () => localStorage.getItem(REPLO_LOCAL_STORAGE_SESSION_KEY),\n    null,\n  );\n\n  const buyNow = React.useCallback(\n    async (\n      variants: VariantBuyNowInfo[],\n      options?: { discountCodes?: string[] },\n    ): Promise<BuyNowOutcome> => {\n      if (!variants || variants.length === 0) {\n        throw new ProductHasNoVariantsError({\n          message: \"No variants provided\",\n        });\n      }\n\n      const checkoutInput = {\n        lineItems: variants.map((variant) => ({\n          variantId: variant.variantId,\n          quantity: variant.quantity ?? 1,\n          sellingPlanId: variant.sellingPlanId ?? null,\n          properties: [],\n        })),\n        discountCodes: options?.discountCodes ?? [],\n        pageUrl: window.location.href,\n      };\n      const attemptStorageKey = `replo-checkout-attempt:${JSON.stringify(checkoutInput)}`;\n      let checkoutAttemptId = checkoutAttempts.get(attemptStorageKey);\n      try {\n        checkoutAttemptId ??=\n          sessionStorage.getItem(attemptStorageKey) ?? crypto.randomUUID();\n        sessionStorage.setItem(attemptStorageKey, checkoutAttemptId);\n      } catch {\n        // Storage can be unavailable in embeds; retries still share the in-memory ID.\n        checkoutAttemptId ??= crypto.randomUUID();\n      }\n      checkoutAttempts.set(attemptStorageKey, checkoutAttemptId);\n      const buyNowResult = await buyNowWithRecoveryAction({\n        ...checkoutInput,\n        checkoutAttemptId,\n      });\n      checkoutAttempts.delete(attemptStorageKey);\n      try {\n        sessionStorage.removeItem(attemptStorageKey);\n      } catch {\n        // A fresh ID supersedes stale storage on the next shopper attempt.\n        checkoutAttempts.set(attemptStorageKey, crypto.randomUUID());\n      }\n      if (buyNowResult.result === \"restartCheckout\") {\n        throw new CheckoutAttemptError({ message: buyNowResult.message });\n      }\n      if (buyNowResult.result === \"outOfStock\") {\n        return { result: \"outOfStock\", variants: buyNowResult.variants };\n      }\n\n      const url = new URL(buyNowResult.redirectUrl);\n\n      // Only append tracking params for non-Stripe checkout URLs (e.g. Shopify).\n      // Stripe checkout URLs should not be modified with extra query params.\n      const isStripeCheckout = url.hostname.endsWith(\"stripe.com\");\n      if (!isStripeCheckout) {\n        const currentParams = new URLSearchParams(window.location.search);\n        for (const [key, value] of currentParams.entries()) {\n          if (!url.searchParams.has(key)) {\n            url.searchParams.set(key, value);\n          }\n        }\n\n        if (reploSessionString) {\n          try {\n            const sessionData: AnalyticsSessionData =\n              JSON.parse(reploSessionString);\n            if (sessionData.sessionId && sessionData.reploId) {\n              url.searchParams.set(REPLO_SESSION_ID_KEY, sessionData.sessionId);\n              url.searchParams.set(REPLO_CLIENT_ID_KEY, sessionData.reploId);\n            }\n          } catch {\n            // Ignore invalid session data\n          }\n        }\n      }\n\n      navigateExternal(url.toString());\n      return { result: \"redirected\" };\n    },\n    [reploSessionString],\n  );\n\n  return { buyNow };\n}\n"],
+  "mappings": ";AAOA,OAAO,WAAW;AAElB,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AACjC,SAAS,gCAAgC;AAGzC,MAAM,kCAAkC;AACxC,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAY5B,MAAM,kCAAkC,YAAY;AAAC;AACrD,MAAM,6BAA6B,YAAY;AAAC;AAEhD,MAAM,mBAAmB,oBAAI,IAAoB;AAgE1C,SAAS,YAAY;AAC1B,QAAM,qBAAqB;AAAA,IACzB,MAAM,aAAa,QAAQ,+BAA+B;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,SAAS,MAAM;AAAA,IACnB,OACE,UACA,YAC2B;AAC3B,UAAI,CAAC,YAAY,SAAS,WAAW,GAAG;AACtC,cAAM,IAAI,0BAA0B;AAAA,UAClC,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAEA,YAAM,gBAAgB;AAAA,QACpB,WAAW,SAAS,IAAI,CAAC,aAAa;AAAA,UACpC,WAAW,QAAQ;AAAA,UACnB,UAAU,QAAQ,YAAY;AAAA,UAC9B,eAAe,QAAQ,iBAAiB;AAAA,UACxC,YAAY,CAAC;AAAA,QACf,EAAE;AAAA,QACF,eAAe,SAAS,iBAAiB,CAAC;AAAA,QAC1C,SAAS,OAAO,SAAS;AAAA,MAC3B;AACA,YAAM,oBAAoB,0BAA0B,KAAK,UAAU,aAAa,CAAC;AACjF,UAAI,oBAAoB,iBAAiB,IAAI,iBAAiB;AAC9D,UAAI;AACF,8BACE,eAAe,QAAQ,iBAAiB,KAAK,OAAO,WAAW;AACjE,uBAAe,QAAQ,mBAAmB,iBAAiB;AAAA,MAC7D,QAAQ;AAEN,8BAAsB,OAAO,WAAW;AAAA,MAC1C;AACA,uBAAiB,IAAI,mBAAmB,iBAAiB;AACzD,YAAM,eAAe,MAAM,yBAAyB;AAAA,QAClD,GAAG;AAAA,QACH;AAAA,MACF,CAAC;AACD,uBAAiB,OAAO,iBAAiB;AACzC,UAAI;AACF,uBAAe,WAAW,iBAAiB;AAAA,MAC7C,QAAQ;AAEN,yBAAiB,IAAI,mBAAmB,OAAO,WAAW,CAAC;AAAA,MAC7D;AACA,UAAI,aAAa,WAAW,mBAAmB;AAC7C,cAAM,IAAI,qBAAqB,EAAE,SAAS,aAAa,QAAQ,CAAC;AAAA,MAClE;AACA,UAAI,aAAa,WAAW,cAAc;AACxC,eAAO,EAAE,QAAQ,cAAc,UAAU,aAAa,SAAS;AAAA,MACjE;AAEA,YAAM,MAAM,IAAI,IAAI,aAAa,WAAW;AAI5C,YAAM,mBAAmB,IAAI,SAAS,SAAS,YAAY;AAC3D,UAAI,CAAC,kBAAkB;AACrB,cAAM,gBAAgB,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAChE,mBAAW,CAAC,KAAK,KAAK,KAAK,cAAc,QAAQ,GAAG;AAClD,cAAI,CAAC,IAAI,aAAa,IAAI,GAAG,GAAG;AAC9B,gBAAI,aAAa,IAAI,KAAK,KAAK;AAAA,UACjC;AAAA,QACF;AAEA,YAAI,oBAAoB;AACtB,cAAI;AACF,kBAAM,cACJ,KAAK,MAAM,kBAAkB;AAC/B,gBAAI,YAAY,aAAa,YAAY,SAAS;AAChD,kBAAI,aAAa,IAAI,sBAAsB,YAAY,SAAS;AAChE,kBAAI,aAAa,IAAI,qBAAqB,YAAY,OAAO;AAAA,YAC/D;AAAA,UACF,QAAQ;AAAA,UAER;AAAA,QACF;AAAA,MACF;AAEA,uBAAiB,IAAI,SAAS,CAAC;AAC/B,aAAO,EAAE,QAAQ,aAAa;AAAA,IAChC;AAAA,IACA,CAAC,kBAAkB;AAAA,EACrB;AAEA,SAAO,EAAE,OAAO;AAClB;",
   "names": []
 }

package/gateways/canopy-api.js

@@ -97,7 +97,11 @@ If you're running locally, make sure the canopy-api cloudflare worker is running
     const response = await this._post(`${this.baseUrl}/api/v1/loaders/invoke`, {
       projectId: env.PROJECT_ID,
       loaderKey,
-      args
+      args,
+      // The builder preview must render a product the merchant hasn't launched
+      // yet; a published storefront must not. Only the sandbox dev server sets
+      // IS_REPLO_SANDBOX, so it is what separates the two.
+      includeInactiveProducts: Boolean(process.env.IS_REPLO_SANDBOX)
     });
     if (!response.ok) {
       const errorBody = await response.text().catch(() => "");

package/gateways/canopy-api.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../gateways/canopy-api.ts"],
-  "sourcesContent": ["import type { Cart } from \"../cart/cart-schema\";\n\nimport { z } from \"zod\";\n\nimport { cartSchema } from \"../cart/cart-schema\";\nimport { getEnv } from \"../env\";\nimport { CanopyError } from \"../lib/canopy-error\";\nimport { buildBaseUrl } from \"../lib/url-utils\";\n\ntype CanopyApiGatewayErrorConfig = {\n  message: string;\n  statusCode?: number;\n  cause?: unknown;\n  additionalData?: Record<string, unknown>;\n};\n\nexport class CanopyApiGatewayError extends CanopyError {\n  statusCode: number;\n\n  constructor(config: CanopyApiGatewayErrorConfig) {\n    const resolvedStatusCode = config.statusCode ?? 500;\n    super({\n      message: config.message,\n      cause: config.cause,\n      additionalData: {\n        ...config.additionalData,\n        statusCode: resolvedStatusCode,\n      },\n    });\n    this.statusCode = resolvedStatusCode;\n  }\n}\n\nclass UnknownCanopyApiError extends CanopyApiGatewayError {\n  constructor(config: Omit<CanopyApiGatewayErrorConfig, \"statusCode\">) {\n    super({ ...config, statusCode: 502 });\n  }\n}\n\nconst loaderInvokeResponseSchema = z.object({\n  data: z.unknown(),\n  meta: z\n    .object({\n      cache: z.object({\n        hit: z.boolean(),\n        ttlSeconds: z.number(),\n      }),\n    })\n    .optional(),\n});\n\nclass CanopyApiGateway {\n  private apiHost: string;\n  private baseUrl: string;\n  constructor(apiHost: string) {\n    this.apiHost = apiHost;\n    this.baseUrl = buildBaseUrl(apiHost);\n  }\n\n  private static readonly REQUEST_TIMEOUT_MILLISECONDS = 10_000;\n\n  static async setup() {\n    const env = await getEnv();\n\n    return new CanopyApiGateway(env.CANOPY_API_HOST);\n  }\n\n  private async _post(url: string, body: unknown) {\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    try {\n      return await fetch(url, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body),\n        signal: abortController.signal,\n      });\n    } catch (error) {\n      let message = `Failed to POST to canopy-api at ${url}: ${error}`;\n      if (process.env.NODE_ENV !== \"production\") {\n        message += `\\n\\napiHost: ${this.apiHost}\\nIf you're running locally, make sure the canopy-api cloudflare worker is running. You may need to restart the dev server.`;\n      }\n      throw new UnknownCanopyApiError({ message, cause: error });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private async _get(url: string) {\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    try {\n      return await fetch(url, { signal: abortController.signal });\n    } catch (error) {\n      let message = `Failed to GET from canopy-api at ${url}: ${error}`;\n      if (process.env.NODE_ENV !== \"production\") {\n        message += `\\n\\napiHost: ${this.apiHost}\\nIf you're running locally, make sure the canopy-api cloudflare worker is running. You may need to restart the dev server.`;\n      }\n      throw new UnknownCanopyApiError({ message, cause: error });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  async invokeLoader({\n    loaderKey,\n    args,\n  }: {\n    loaderKey: string;\n    args: Record<string, unknown>;\n  }) {\n    const env = await getEnv();\n    const response = await this._post(`${this.baseUrl}/api/v1/loaders/invoke`, {\n      projectId: env.PROJECT_ID,\n      loaderKey,\n      args,\n    });\n\n    if (!response.ok) {\n      const errorBody = await response.text().catch(() => \"\");\n      throw new CanopyApiGatewayError({\n        message: `Failed to invoke loader ${loaderKey}: ${response.status} ${response.statusText}${errorBody ? ` \u2014 ${errorBody}` : \"\"}`,\n        statusCode: response.status,\n      });\n    }\n\n    return loaderInvokeResponseSchema.parse(await response.json());\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cart operations (canopy-api-backed ExternalCart)\n  // ---------------------------------------------------------------------------\n\n  private async _cartPost(\n    path: string,\n    body: Record<string, unknown>,\n  ): Promise<Cart> {\n    const env = await getEnv();\n    const url = `${this.baseUrl}/api/v1/cart${path}`;\n\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ ...body, projectId: env.PROJECT_ID }),\n        signal: abortController.signal,\n      });\n    } catch (error) {\n      throw new UnknownCanopyApiError({\n        message: `Failed to POST cart operation to ${url}: ${error}`,\n        cause: error,\n      });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new CanopyApiGatewayError({\n        message: `Cart operation ${path} failed: ${response.status} ${response.statusText} \u2014 ${text}`,\n        statusCode: response.status,\n      });\n    }\n\n    // Legacy cast - may or may not be necessary\n    // eslint-disable-next-line replo/no-as-cast\n    const json = (await response.json()) as { data: unknown };\n    return cartSchema.parse(json.data);\n  }\n\n  async cartGet({ cartId }: { cartId: string }): Promise<Cart | null> {\n    try {\n      return await this._cartPost(\"/get\", { cartId });\n    } catch (error) {\n      if (error instanceof CanopyApiGatewayError && error.statusCode === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  async cartCreate(options?: {\n    lines?: {\n      merchandiseId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n    discountCodes?: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/create\", {\n      lines: options?.lines,\n      discountCodes: options?.discountCodes,\n    });\n  }\n\n  async cartAddLines({\n    cartId,\n    lines,\n  }: {\n    cartId: string;\n    lines: {\n      merchandiseId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/add-lines\", { cartId, lines });\n  }\n\n  async cartUpdateLines({\n    cartId,\n    lines,\n  }: {\n    cartId: string;\n    lines: {\n      lineId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/update-lines\", { cartId, lines });\n  }\n\n  async cartRemoveLines({\n    cartId,\n    lineIds,\n  }: {\n    cartId: string;\n    lineIds: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/remove-lines\", { cartId, lineIds });\n  }\n\n  async cartUpdateDiscountCodes({\n    cartId,\n    discountCodes,\n  }: {\n    cartId: string;\n    discountCodes: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/update-discount-codes\", { cartId, discountCodes });\n  }\n}\n\nexport async function getCanopyApiGateway() {\n  return CanopyApiGateway.setup();\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Cart } from \"../cart/cart-schema\";\n\nimport { z } from \"zod\";\n\nimport { cartSchema } from \"../cart/cart-schema\";\nimport { getEnv } from \"../env\";\nimport { CanopyError } from \"../lib/canopy-error\";\nimport { buildBaseUrl } from \"../lib/url-utils\";\n\ntype CanopyApiGatewayErrorConfig = {\n  message: string;\n  statusCode?: number;\n  cause?: unknown;\n  additionalData?: Record<string, unknown>;\n};\n\nexport class CanopyApiGatewayError extends CanopyError {\n  statusCode: number;\n\n  constructor(config: CanopyApiGatewayErrorConfig) {\n    const resolvedStatusCode = config.statusCode ?? 500;\n    super({\n      message: config.message,\n      cause: config.cause,\n      additionalData: {\n        ...config.additionalData,\n        statusCode: resolvedStatusCode,\n      },\n    });\n    this.statusCode = resolvedStatusCode;\n  }\n}\n\nclass UnknownCanopyApiError extends CanopyApiGatewayError {\n  constructor(config: Omit<CanopyApiGatewayErrorConfig, \"statusCode\">) {\n    super({ ...config, statusCode: 502 });\n  }\n}\n\nconst loaderInvokeResponseSchema = z.object({\n  data: z.unknown(),\n  meta: z\n    .object({\n      cache: z.object({\n        hit: z.boolean(),\n        ttlSeconds: z.number(),\n      }),\n    })\n    .optional(),\n});\n\nclass CanopyApiGateway {\n  private apiHost: string;\n  private baseUrl: string;\n  constructor(apiHost: string) {\n    this.apiHost = apiHost;\n    this.baseUrl = buildBaseUrl(apiHost);\n  }\n\n  private static readonly REQUEST_TIMEOUT_MILLISECONDS = 10_000;\n\n  static async setup() {\n    const env = await getEnv();\n\n    return new CanopyApiGateway(env.CANOPY_API_HOST);\n  }\n\n  private async _post(url: string, body: unknown) {\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    try {\n      return await fetch(url, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body),\n        signal: abortController.signal,\n      });\n    } catch (error) {\n      let message = `Failed to POST to canopy-api at ${url}: ${error}`;\n      if (process.env.NODE_ENV !== \"production\") {\n        message += `\\n\\napiHost: ${this.apiHost}\\nIf you're running locally, make sure the canopy-api cloudflare worker is running. You may need to restart the dev server.`;\n      }\n      throw new UnknownCanopyApiError({ message, cause: error });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private async _get(url: string) {\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    try {\n      return await fetch(url, { signal: abortController.signal });\n    } catch (error) {\n      let message = `Failed to GET from canopy-api at ${url}: ${error}`;\n      if (process.env.NODE_ENV !== \"production\") {\n        message += `\\n\\napiHost: ${this.apiHost}\\nIf you're running locally, make sure the canopy-api cloudflare worker is running. You may need to restart the dev server.`;\n      }\n      throw new UnknownCanopyApiError({ message, cause: error });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  async invokeLoader({\n    loaderKey,\n    args,\n  }: {\n    loaderKey: string;\n    args: Record<string, unknown>;\n  }) {\n    const env = await getEnv();\n    const response = await this._post(`${this.baseUrl}/api/v1/loaders/invoke`, {\n      projectId: env.PROJECT_ID,\n      loaderKey,\n      args,\n      // The builder preview must render a product the merchant hasn't launched\n      // yet; a published storefront must not. Only the sandbox dev server sets\n      // IS_REPLO_SANDBOX, so it is what separates the two.\n      includeInactiveProducts: Boolean(process.env.IS_REPLO_SANDBOX),\n    });\n\n    if (!response.ok) {\n      const errorBody = await response.text().catch(() => \"\");\n      throw new CanopyApiGatewayError({\n        message: `Failed to invoke loader ${loaderKey}: ${response.status} ${response.statusText}${errorBody ? ` \u2014 ${errorBody}` : \"\"}`,\n        statusCode: response.status,\n      });\n    }\n\n    return loaderInvokeResponseSchema.parse(await response.json());\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cart operations (canopy-api-backed ExternalCart)\n  // ---------------------------------------------------------------------------\n\n  private async _cartPost(\n    path: string,\n    body: Record<string, unknown>,\n  ): Promise<Cart> {\n    const env = await getEnv();\n    const url = `${this.baseUrl}/api/v1/cart${path}`;\n\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => {\n      abortController.abort();\n    }, CanopyApiGateway.REQUEST_TIMEOUT_MILLISECONDS);\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ ...body, projectId: env.PROJECT_ID }),\n        signal: abortController.signal,\n      });\n    } catch (error) {\n      throw new UnknownCanopyApiError({\n        message: `Failed to POST cart operation to ${url}: ${error}`,\n        cause: error,\n      });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new CanopyApiGatewayError({\n        message: `Cart operation ${path} failed: ${response.status} ${response.statusText} \u2014 ${text}`,\n        statusCode: response.status,\n      });\n    }\n\n    // Legacy cast - may or may not be necessary\n    // eslint-disable-next-line replo/no-as-cast\n    const json = (await response.json()) as { data: unknown };\n    return cartSchema.parse(json.data);\n  }\n\n  async cartGet({ cartId }: { cartId: string }): Promise<Cart | null> {\n    try {\n      return await this._cartPost(\"/get\", { cartId });\n    } catch (error) {\n      if (error instanceof CanopyApiGatewayError && error.statusCode === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  async cartCreate(options?: {\n    lines?: {\n      merchandiseId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n    discountCodes?: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/create\", {\n      lines: options?.lines,\n      discountCodes: options?.discountCodes,\n    });\n  }\n\n  async cartAddLines({\n    cartId,\n    lines,\n  }: {\n    cartId: string;\n    lines: {\n      merchandiseId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/add-lines\", { cartId, lines });\n  }\n\n  async cartUpdateLines({\n    cartId,\n    lines,\n  }: {\n    cartId: string;\n    lines: {\n      lineId: string;\n      quantity: number;\n      attributes?: { key: string; value: string }[];\n      sellingPlanId?: string | null;\n    }[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/update-lines\", { cartId, lines });\n  }\n\n  async cartRemoveLines({\n    cartId,\n    lineIds,\n  }: {\n    cartId: string;\n    lineIds: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/remove-lines\", { cartId, lineIds });\n  }\n\n  async cartUpdateDiscountCodes({\n    cartId,\n    discountCodes,\n  }: {\n    cartId: string;\n    discountCodes: string[];\n  }): Promise<Cart> {\n    return this._cartPost(\"/update-discount-codes\", { cartId, discountCodes });\n  }\n}\n\nexport async function getCanopyApiGateway() {\n  return CanopyApiGateway.setup();\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "branch": "HEAD",
-  "commit": "c0d11c1e3985716775e9b0807abda85fd506bd4c",
-  "builtAt": "2026-09-04T21:22:29.470Z"
+  "commit": "a6ddf179a9377ee3c08389733ee7fc67a11ee3ec",
+  "builtAt": "2026-09-08T07:18:18.884Z"
 };

package/loaders/product-loader.d.ts

@@ -5,6 +5,7 @@ type ProductLoaderProps = ProductLoaderArgs & {
     loaderKey: string;
     children: (data: FullProduct) => ReactNode;
     fallback?: ReactNode;
+    loadingFallback?: ReactNode;
 };
-export declare function ProductLoader({ loaderKey, handle, productId, productMetafieldIdentifiers, variantMetafieldIdentifiers, language, children, fallback, }: ProductLoaderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ProductLoader({ loaderKey, handle, productId, productMetafieldIdentifiers, variantMetafieldIdentifiers, language, children, fallback, loadingFallback, }: ProductLoaderProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/loaders/product-loader.js

@@ -30,7 +30,8 @@ function ProductLoader({
   variantMetafieldIdentifiers,
   language,
   children,
-  fallback
+  fallback,
+  loadingFallback = fallback
 }) {
   const args = buildProductLoaderArgs({
     handle,
@@ -44,7 +45,7 @@ function ProductLoader({
     {
       fallback: fallback ?? null,
       resetKey: `${loaderKey}:${JSON.stringify(args)}`,
-      children: /* @__PURE__ */ jsx(Suspense, { fallback: fallback ?? null, children: /* @__PURE__ */ jsx(ProductLoaderInner, { loaderKey, args, children }) })
+      children: /* @__PURE__ */ jsx(Suspense, { fallback: loadingFallback ?? null, children: /* @__PURE__ */ jsx(ProductLoaderInner, { loaderKey, args, children }) })
     }
   );
 }

package/loaders/product-loader.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../loaders/product-loader.tsx"],
-  "sourcesContent": ["\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport type { FullProduct } from \"./loader-schemas\";\nimport type { ProductLoaderArgs } from \"./product-loader-args\";\n\nimport { Suspense } from \"react\";\n\nimport { useSuspenseQuery } from \"@tanstack/react-query\";\n\nimport { invokeLoader } from \"./invoke-loader\";\nimport { LoaderErrorBoundary } from \"./loader-error-boundary\";\nimport { fullProductSchema } from \"./loader-schemas\";\nimport { useReportPreviewPlaceholderRender } from \"./preview-placeholder\";\nimport { buildProductLoaderArgs } from \"./product-loader-args\";\n\ntype ProductLoaderProps = ProductLoaderArgs & {\n  loaderKey: string;\n  children: (data: FullProduct) => ReactNode;\n  fallback?: ReactNode;\n};\n\nfunction ProductLoaderInner({\n  loaderKey,\n  args,\n  children,\n}: {\n  loaderKey: string;\n  args: ProductLoaderArgs;\n  children: (data: FullProduct) => ReactNode;\n}) {\n  const queryResult = useSuspenseQuery({\n    queryKey: [loaderKey, args],\n    queryFn: async () => {\n      const loadedData = await invokeLoader({ loaderKey, args });\n      return fullProductSchema.parse(loadedData);\n    },\n  });\n  useReportPreviewPlaceholderRender(queryResult.data);\n\n  return <>{children(queryResult.data)}</>;\n}\n\nexport function ProductLoader({\n  loaderKey,\n  handle,\n  productId,\n  productMetafieldIdentifiers,\n  variantMetafieldIdentifiers,\n  language,\n  children,\n  fallback,\n}: ProductLoaderProps) {\n  const args = buildProductLoaderArgs({\n    handle,\n    productId,\n    productMetafieldIdentifiers,\n    variantMetafieldIdentifiers,\n    language,\n  });\n\n  return (\n    <LoaderErrorBoundary\n      fallback={fallback ?? null}\n      resetKey={`${loaderKey}:${JSON.stringify(args)}`}\n    >\n      <Suspense fallback={fallback ?? null}>\n        <ProductLoaderInner loaderKey={loaderKey} args={args}>\n          {children}\n        </ProductLoaderInner>\n      </Suspense>\n    </LoaderErrorBoundary>\n  );\n}\n"],
-  "mappings": ";AAwCS;AAlCT,SAAS,gBAAgB;AAEzB,SAAS,wBAAwB;AAEjC,SAAS,oBAAoB;AAC7B,SAAS,2BAA2B;AACpC,SAAS,yBAAyB;AAClC,SAAS,yCAAyC;AAClD,SAAS,8BAA8B;AAQvC,SAAS,mBAAmB;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,cAAc,iBAAiB;AAAA,IACnC,UAAU,CAAC,WAAW,IAAI;AAAA,IAC1B,SAAS,YAAY;AACnB,YAAM,aAAa,MAAM,aAAa,EAAE,WAAW,KAAK,CAAC;AACzD,aAAO,kBAAkB,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF,CAAC;AACD,oCAAkC,YAAY,IAAI;AAElD,SAAO,gCAAG,mBAAS,YAAY,IAAI,GAAE;AACvC;AAEO,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAuB;AACrB,QAAM,OAAO,uBAAuB;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,SACE;AAAA,IAAC;AAAA;AAAA,MACC,UAAU,YAAY;AAAA,MACtB,UAAU,GAAG,SAAS,IAAI,KAAK,UAAU,IAAI,CAAC;AAAA,MAE9C,8BAAC,YAAS,UAAU,YAAY,MAC9B,8BAAC,sBAAmB,WAAsB,MACvC,UACH,GACF;AAAA;AAAA,EACF;AAEJ;",
+  "sourcesContent": ["\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport type { FullProduct } from \"./loader-schemas\";\nimport type { ProductLoaderArgs } from \"./product-loader-args\";\n\nimport { Suspense } from \"react\";\n\nimport { useSuspenseQuery } from \"@tanstack/react-query\";\n\nimport { invokeLoader } from \"./invoke-loader\";\nimport { LoaderErrorBoundary } from \"./loader-error-boundary\";\nimport { fullProductSchema } from \"./loader-schemas\";\nimport { useReportPreviewPlaceholderRender } from \"./preview-placeholder\";\nimport { buildProductLoaderArgs } from \"./product-loader-args\";\n\ntype ProductLoaderProps = ProductLoaderArgs & {\n  loaderKey: string;\n  children: (data: FullProduct) => ReactNode;\n  fallback?: ReactNode;\n  loadingFallback?: ReactNode;\n};\n\nfunction ProductLoaderInner({\n  loaderKey,\n  args,\n  children,\n}: {\n  loaderKey: string;\n  args: ProductLoaderArgs;\n  children: (data: FullProduct) => ReactNode;\n}) {\n  const queryResult = useSuspenseQuery({\n    queryKey: [loaderKey, args],\n    queryFn: async () => {\n      const loadedData = await invokeLoader({ loaderKey, args });\n      return fullProductSchema.parse(loadedData);\n    },\n  });\n  useReportPreviewPlaceholderRender(queryResult.data);\n\n  return <>{children(queryResult.data)}</>;\n}\n\nexport function ProductLoader({\n  loaderKey,\n  handle,\n  productId,\n  productMetafieldIdentifiers,\n  variantMetafieldIdentifiers,\n  language,\n  children,\n  fallback,\n  loadingFallback = fallback,\n}: ProductLoaderProps) {\n  const args = buildProductLoaderArgs({\n    handle,\n    productId,\n    productMetafieldIdentifiers,\n    variantMetafieldIdentifiers,\n    language,\n  });\n\n  return (\n    <LoaderErrorBoundary\n      fallback={fallback ?? null}\n      resetKey={`${loaderKey}:${JSON.stringify(args)}`}\n    >\n      <Suspense fallback={loadingFallback ?? null}>\n        <ProductLoaderInner loaderKey={loaderKey} args={args}>\n          {children}\n        </ProductLoaderInner>\n      </Suspense>\n    </LoaderErrorBoundary>\n  );\n}\n"],
+  "mappings": ";AAyCS;AAnCT,SAAS,gBAAgB;AAEzB,SAAS,wBAAwB;AAEjC,SAAS,oBAAoB;AAC7B,SAAS,2BAA2B;AACpC,SAAS,yBAAyB;AAClC,SAAS,yCAAyC;AAClD,SAAS,8BAA8B;AASvC,SAAS,mBAAmB;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,cAAc,iBAAiB;AAAA,IACnC,UAAU,CAAC,WAAW,IAAI;AAAA,IAC1B,SAAS,YAAY;AACnB,YAAM,aAAa,MAAM,aAAa,EAAE,WAAW,KAAK,CAAC;AACzD,aAAO,kBAAkB,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF,CAAC;AACD,oCAAkC,YAAY,IAAI;AAElD,SAAO,gCAAG,mBAAS,YAAY,IAAI,GAAE;AACvC;AAEO,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AACpB,GAAuB;AACrB,QAAM,OAAO,uBAAuB;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,SACE;AAAA,IAAC;AAAA;AAAA,MACC,UAAU,YAAY;AAAA,MACtB,UAAU,GAAG,SAAS,IAAI,KAAK,UAAU,IAAI,CAAC;AAAA,MAE9C,8BAAC,YAAS,UAAU,mBAAmB,MACrC,8BAAC,sBAAmB,WAAsB,MACvC,UACH,GACF;AAAA;AAAA,EACF;AAEJ;",
   "names": []
 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.3.0",
+    "version": "1.3.2",
     "branch": "HEAD",
-    "commit": "c0d11c1e3985716775e9b0807abda85fd506bd4c",
-    "builtAt": "2026-09-04T21:22:29.470Z"
+    "commit": "a6ddf179a9377ee3c08389733ee7fc67a11ee3ec",
+    "builtAt": "2026-09-08T07:18:18.884Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",