@replohq/sdk 1.10.1 → 1.10.2

package/cart/cart-actions.d.ts

@@ -11,6 +11,14 @@ import type { AddToCartPayload, Cart, CartLinePayload, RemoveFromCartPayload, Up
 export declare function getOrCreateCartAction(options?: {
     country?: StorefrontCountryCode;
 }): Promise<Cart | null>;
+/**
+ * Reconciles an existing persisted cart without creating one when none exists.
+ *
+ * @returns The reconciled cart, or null when no persisted cart exists
+ */
+export declare function reconcileCartAction(options?: {
+    country?: StorefrontCountryCode;
+}): Promise<Cart | null>;
 /**
  * Retrieves the current cart from cookies. Returns null if no cart exists or
  * if the cart has expired/been deleted.

package/cart/cart-actions.js

@@ -11,21 +11,31 @@ import {
   saveCartToCookie
 } from "./utils/cookie-cart-persistence";
 const SHOPIFY_CART_COOKIE_NAME = "replo_cart_id";
+async function reconcileExistingCart(cart, country) {
+  const cartGateway = await getCartGateway();
+  const reconciledCart = await cartGateway.reconcileStoredCart(cart);
+  if (country && reconciledCart.buyerIdentity?.country !== country) {
+    return await cartGateway.updateCartBuyerIdentity({
+      cartId: reconciledCart.id,
+      buyerIdentity: { country }
+    });
+  }
+  return reconciledCart;
+}
 async function getOrCreateCartAction(options) {
   const existingCart = await getCartAction();
   if (existingCart) {
-    const cartGateway = await getCartGateway();
-    const reconciledCart = await cartGateway.reconcileStoredCart(existingCart);
-    if (options?.country && reconciledCart.buyerIdentity?.country !== options.country) {
-      return await cartGateway.updateCartBuyerIdentity({
-        cartId: reconciledCart.id,
-        buyerIdentity: { country: options.country }
-      });
-    }
-    return reconciledCart;
+    return await reconcileExistingCart(existingCart, options?.country);
   }
   return await createCartAction({ country: options?.country });
 }
+async function reconcileCartAction(options) {
+  const existingCart = await getCartAction();
+  if (!existingCart) {
+    return null;
+  }
+  return await reconcileExistingCart(existingCart, options?.country);
+}
 async function getCartAction() {
   const checkoutProvider = await getCheckoutProvider();
   if (checkoutProvider === "stripe") {
@@ -103,6 +113,7 @@ export {
   createCartAction,
   getCartAction,
   getOrCreateCartAction,
+  reconcileCartAction,
   removeCartLineItemsAction,
   updateCartDiscountCodesAction,
   updateCartLineItemAction

package/cart/cart-loader.d.ts

@@ -7,6 +7,7 @@ import type { StorefrontCountryCode } from "../loaders/markets";
  * @param children - Child components that will have access to the cart
  * @returns A CartProvider component wrapping the children with cart data
  */
-export declare function CartLoader({ children, country, }: React.PropsWithChildren<{
+export declare function CartLoader({ children, country, shouldReconcileSuppliedCart, }: React.PropsWithChildren<{
     country?: StorefrontCountryCode;
+    shouldReconcileSuppliedCart: boolean;
 }>): Promise<import("react/jsx-runtime").JSX.Element>;

package/cart/cart-loader.js

@@ -2,16 +2,18 @@ import { jsx } from "react/jsx-runtime";
 import { unstable_rethrow } from "next/navigation";
 import { getCartAction } from "./cart-actions";
 import { CartProvider } from "./cart-provider";
+import { SuppliedCartReconciliationBoundary } from "./supplied-cart-reconciliation";
 async function CartLoader({
   children,
-  country
+  country,
+  shouldReconcileSuppliedCart
 }) {
   const cart = false ? null : await getCartAction().catch((error) => {
     unstable_rethrow(error);
     console.warn("[Replo] Failed to load cart:", error);
     return null;
   });
-  return /* @__PURE__ */ jsx(CartProvider, { cart, country, children });
+  return /* @__PURE__ */ jsx(SuppliedCartReconciliationBoundary, { enabled: shouldReconcileSuppliedCart, children: /* @__PURE__ */ jsx(CartProvider, { cart, country, children }) });
 }
 export {
   CartLoader

package/cart/cart-provider.js

@@ -8,11 +8,13 @@ import {
   createCartAction,
   getCartAction,
   getOrCreateCartAction,
+  reconcileCartAction,
   removeCartLineItemsAction,
   updateCartDiscountCodesAction,
   updateCartLineItemAction
 } from "./cart-actions";
 import { CartCountryContext } from "./cart-country-context";
+import { useShouldReconcileSuppliedCart } from "./supplied-cart-reconciliation";
 import {
   deriveAddToCartAdjustments,
   deriveUpdateCartAdjustments
@@ -89,6 +91,25 @@ function removeLineFromCart(cart, lineId) {
   const updatedLines = cart.lines.filter((line) => line.id !== lineId);
   return recalculateCartCost({ ...cart, lines: updatedLines });
 }
+async function createBuyNowCart({
+  lines,
+  discountCodes,
+  country
+}) {
+  const cart = await createCartAction({
+    lines,
+    skipStoringCart: true,
+    discountCodes,
+    country
+  });
+  if (!cart) {
+    console.warn(
+      "[Replo] Failed to create cart for buy now. Reach out to support@replo.app if this persists."
+    );
+    return null;
+  }
+  return cart;
+}
 const CartContext = React.createContext(
   void 0
 );
@@ -97,6 +118,9 @@ function CartProvider({
   cart,
   country
 }) {
+  const isSuppliedCart = Boolean(cart);
+  const isInternalSuppliedCartReconciliationEnabled = useShouldReconcileSuppliedCart();
+  const shouldReconcileSuppliedCart = isSuppliedCart && (isInternalSuppliedCartReconciliationEnabled || Boolean(country));
   const [cartData, setCartData] = React.useState(cart);
   const optimisticCart = React.useRef(cart);
   const updateCartData = React.useCallback(
@@ -116,79 +140,110 @@ function CartProvider({
   if (marketSelection.current.country !== country) {
     marketSelection.current = { country };
   }
-  const runWithErrorState = async (operation, mutate) => {
-    setError(null);
-    try {
-      return await mutate();
-    } catch (caught) {
-      console.error(`[Replo] Cart ${operation} failed:`, caught);
-      setError(toCartError(operation, caught));
-      throw caught;
-    }
-  };
+  const runWithErrorState = React.useCallback(
+    async (operation, mutate) => {
+      setError(null);
+      try {
+        return await mutate();
+      } catch (caught) {
+        console.error(`[Replo] Cart ${operation} failed:`, caught);
+        setError(toCartError(operation, caught));
+        throw caught;
+      }
+    },
+    []
+  );
   const analytics = useAnalyticsOptional();
   const serverCart = React.useRef(cart);
   const needsRefresh = React.useRef(false);
   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?.catch(() => null);
-      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) {
-        throw new CartContextError({
-          message: "Your cart could not be loaded. Please try again."
-        });
-      }
+  const lastReconciliationCountry = React.useRef(false);
+  const startSuppliedCartReconciliation = React.useCallback(() => {
+    if (!shouldReconcileSuppliedCart || lastReconciliationCountry.current === country) {
+      return;
+    }
+    lastReconciliationCountry.current = country;
+    mutationQueue.current = mutationQueue.current.then(async () => {
       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;
+        const reconciledCart = await reconcileCartAction({ country });
+        if (!reconciledCart) {
+          return;
+        }
+        serverCart.current = reconciledCart;
+        if (isMounted.current && pendingMutations.current === 0) {
+          updateCartData(reconciledCart);
+        }
       } catch (error2) {
-        const restoredCart = await getCartAction().catch(() => null);
-        needsRefresh.current = !restoredCart;
-        if (restoredCart) serverCart.current = restoredCart;
-        throw error2;
+        console.warn("[Replo] Failed to reconcile supplied cart:", error2);
       }
     });
-    mutationQueue.current = request.catch(() => {
-    }).then(() => {
-      pendingMutations.current -= 1;
-      if (pendingMutations.current === 0) {
-        reportedLineQuantities.current.clear();
-        optimisticLines.current.clear();
-        updateCartData(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;
-    });
-  };
+  }, [country, shouldReconcileSuppliedCart, updateCartData]);
+  const enqueueMutation = React.useCallback(
+    async (save) => {
+      startSuppliedCartReconciliation();
+      pendingMutations.current += 1;
+      const request = mutationQueue.current.then(async () => {
+        await cartCreationPromise?.catch(() => null);
+        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) {
+          throw new CartContextError({
+            message: "Your cart could not be loaded. Please try again."
+          });
+        }
+        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 (error2) {
+          const restoredCart = await getCartAction().catch(() => null);
+          needsRefresh.current = !restoredCart;
+          if (restoredCart) serverCart.current = restoredCart;
+          throw error2;
+        }
+      });
+      mutationQueue.current = request.catch(() => {
+      }).then(() => {
+        pendingMutations.current -= 1;
+        if (pendingMutations.current === 0) {
+          reportedLineQuantities.current.clear();
+          optimisticLines.current.clear();
+          updateCartData(serverCart.current);
+        }
+      });
+      await request;
+    },
+    [startSuppliedCartReconciliation, updateCartData]
+  );
+  const findLine = React.useCallback(
+    ({
+      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;
+      });
+    },
+    []
+  );
   const initializeCart = React.useCallback(async () => {
     const selection = marketSelection.current;
     const loadedCart = await getOrCreateSharedCart(country);
@@ -204,16 +259,19 @@ function CartProvider({
   }, [country, updateCartData]);
   React.useEffect(() => {
     isMounted.current = true;
-    void initializeCart().catch((error2) => {
-      if (isMounted.current && !(error2 instanceof DOMException && error2.name === "AbortError")) {
-        console.error("[Replo] Error getting or creating cart:", error2);
-      }
-    });
+    if (isSuppliedCart) {
+      startSuppliedCartReconciliation();
+    } else {
+      void initializeCart().catch((error2) => {
+        if (isMounted.current && !(error2 instanceof DOMException && error2.name === "AbortError")) {
+          console.error("[Replo] Error getting or creating cart:", error2);
+        }
+      });
+    }
     return () => {
       isMounted.current = false;
     };
-  }, [initializeCart]);
-  const lineItems = cartData?.lines ?? [];
+  }, [initializeCart, isSuppliedCart, startSuppliedCartReconciliation]);
   const subtotal = cartData?.lines.reduce((sum, lineItem) => {
     if (lineItem.quantity > 0 && lineItem.merchandise) {
       sum += lineItem.merchandise.price * lineItem.quantity;
@@ -250,213 +308,255 @@ function CartProvider({
     updateCartData(refreshedCart);
   }, [updateCartData]);
   const reportedLineQuantities = React.useRef(/* @__PURE__ */ new Map());
-  const addToCart = (lines, openCartAfterAdd = true) => {
-    return runWithErrorState("add", async () => {
-      const readyCart = cartData ?? serverCart.current ?? await initializeCart().catch((caught) => {
-        if (openCartAfterAdd) setIsCartOpen(true);
-        throw caught;
-      });
-      reportedLineQuantities.current.clear();
-      const additions = lines.map((line) => {
-        const lineId = `temp-${uuidv4()}`;
-        optimisticLines.current.set(lineId, line);
-        return { line, lineId };
-      });
-      const applyLines = (cart2) => {
-        let updatedCart2 = { ...cart2 };
-        for (const { line, lineId } of additions) {
-          updatedCart2 = addLineToCart({ cart: updatedCart2, line, lineId });
+  const addToCart = React.useCallback(
+    (lines, openCartAfterAdd = true) => {
+      return runWithErrorState("add", async () => {
+        const readyCart = cartData ?? serverCart.current ?? await initializeCart().catch((caught) => {
+          if (openCartAfterAdd) setIsCartOpen(true);
+          throw caught;
+        });
+        reportedLineQuantities.current.clear();
+        const additions = lines.map((line) => {
+          const lineId = `temp-${uuidv4()}`;
+          optimisticLines.current.set(lineId, line);
+          return { line, lineId };
+        });
+        const applyLines = (cart2) => {
+          let updatedCart2 = { ...cart2 };
+          for (const { line, lineId } of additions) {
+            updatedCart2 = addLineToCart({ cart: updatedCart2, line, lineId });
+          }
+          return updatedCart2;
+        };
+        const updatedCart = updateCartData((currentCart) => {
+          return applyLines(currentCart ?? readyCart);
+        });
+        if (analytics) {
+          for (const line of lines) {
+            if (!line.merchandise) {
+              continue;
+            }
+            void analytics.addToCart({
+              data: buildCartLineAnalyticsData({
+                merchandise: line.merchandise,
+                quantity: line.quantity,
+                currencyCode: readyCart.cost.currencyCode
+              })
+            });
+          }
         }
-        return updatedCart2;
-      };
-      const updatedCart = updateCartData((currentCart) => {
-        return applyLines(currentCart ?? readyCart);
-      });
-      if (analytics) {
-        for (const line of lines) {
-          if (!line.merchandise) {
-            continue;
+        if (openCartAfterAdd) {
+          setIsCartOpen(true);
+          emitCartView(updatedCart);
+        }
+        const adjustments = [];
+        await enqueueMutation(async (currentCart) => {
+          const savedCart = await addToCartAction(lines, currentCart.id);
+          if (savedCart) {
+            adjustments.push(
+              ...deriveAddToCartAdjustments({
+                cartBeforeAdd: currentCart,
+                requestedLines: lines,
+                savedCart
+              })
+            );
           }
-          void analytics.addToCart({
-            data: buildCartLineAnalyticsData({
-              merchandise: line.merchandise,
-              quantity: line.quantity,
-              currencyCode: readyCart.cost.currencyCode
-            })
+          return savedCart;
+        });
+        return { adjustments };
+      });
+    },
+    [
+      analytics,
+      cartData,
+      emitCartView,
+      enqueueMutation,
+      initializeCart,
+      runWithErrorState,
+      updateCartData
+    ]
+  );
+  const updateCartItem = React.useCallback(
+    (line) => {
+      return runWithErrorState("update", async () => {
+        if (!cartData) {
+          console.warn(
+            "[Replo] Cannot update cart item: no cart exists. Reach out to support@replo.app if this persists."
+          );
+          return { adjustments: [] };
+        }
+        const currentLine = cartData.lines.find((item) => item.id === line.id);
+        const merchandise = currentLine?.merchandise ?? line.merchandise;
+        const quantityDelta = line.quantity - (reportedLineQuantities.current.get(line.id) ?? currentLine?.quantity ?? 0);
+        reportedLineQuantities.current.set(line.id, line.quantity);
+        if (analytics && merchandise && quantityDelta !== 0) {
+          const data = buildCartLineAnalyticsData({
+            merchandise,
+            quantity: Math.abs(quantityDelta),
+            currencyCode: cartData.cost.currencyCode
           });
+          void (quantityDelta > 0 ? analytics.addToCart({ data }) : analytics.removeFromCart({ data }));
         }
-      }
-      if (openCartAfterAdd) {
-        setIsCartOpen(true);
-        emitCartView(updatedCart);
-      }
-      const adjustments = [];
-      await enqueueMutation(async (currentCart) => {
-        const savedCart = await addToCartAction(lines, currentCart.id);
-        if (savedCart) {
-          adjustments.push(
-            ...deriveAddToCartAdjustments({
-              cartBeforeAdd: currentCart,
-              requestedLines: lines,
-              savedCart
-            })
+        updateCartData((currentCart) => {
+          if (!currentCart) {
+            return null;
+          }
+          return updateLineInCart(currentCart, line);
+        });
+        const adjustments = [];
+        await enqueueMutation(async (currentCart) => {
+          const savedLine = findLine({
+            currentCart,
+            lineId: line.id,
+            originalLine: currentLine
+          });
+          if (!savedLine) {
+            return currentCart;
+          }
+          const savedCart = await updateCartLineItemAction(
+            { ...line, id: savedLine.id },
+            currentCart.id
           );
-        }
-        return savedCart;
-      });
-      return { adjustments };
-    });
-  };
-  const updateCartItem = (line) => {
-    return runWithErrorState("update", async () => {
-      if (!cartData) {
-        console.warn(
-          "[Replo] Cannot update cart item: no cart exists. Reach out to support@replo.app if this persists."
-        );
-        return { adjustments: [] };
-      }
-      const currentLine = cartData.lines.find((item) => item.id === line.id);
-      const merchandise = currentLine?.merchandise ?? line.merchandise;
-      const quantityDelta = line.quantity - (reportedLineQuantities.current.get(line.id) ?? currentLine?.quantity ?? 0);
-      reportedLineQuantities.current.set(line.id, line.quantity);
-      if (analytics && merchandise && quantityDelta !== 0) {
-        const data = buildCartLineAnalyticsData({
-          merchandise,
-          quantity: Math.abs(quantityDelta),
-          currencyCode: cartData.cost.currencyCode
+          if (savedCart) {
+            adjustments.push(
+              ...deriveUpdateCartAdjustments({
+                cartBeforeUpdate: currentCart,
+                editedLine: savedLine,
+                requestedQuantity: line.quantity,
+                requestedSellingPlanId: line.sellingPlanId,
+                savedCart
+              })
+            );
+          }
+          return savedCart;
         });
-        void (quantityDelta > 0 ? analytics.addToCart({ data }) : analytics.removeFromCart({ data }));
-      }
-      updateCartData((currentCart) => {
-        if (!currentCart) {
-          return null;
-        }
-        return updateLineInCart(currentCart, line);
+        return { adjustments };
       });
-      const adjustments = [];
-      await enqueueMutation(async (currentCart) => {
-        const savedLine = findLine({
-          currentCart,
-          lineId: line.id,
-          originalLine: currentLine
-        });
-        if (!savedLine) {
-          return currentCart;
+    },
+    [
+      analytics,
+      cartData,
+      enqueueMutation,
+      findLine,
+      runWithErrorState,
+      updateCartData
+    ]
+  );
+  const removeCartItem = React.useCallback(
+    (lineId) => {
+      return runWithErrorState("remove", async () => {
+        if (!cartData) {
+          console.warn(
+            "[Replo] Cannot remove cart item: no cart exists. Reach out to support@replo.app if this persists."
+          );
+          return;
         }
-        const savedCart = await updateCartLineItemAction(
-          { ...line, id: savedLine.id },
-          currentCart.id
-        );
-        if (savedCart) {
-          adjustments.push(
-            ...deriveUpdateCartAdjustments({
-              cartBeforeUpdate: currentCart,
-              editedLine: savedLine,
-              requestedQuantity: line.quantity,
-              requestedSellingPlanId: line.sellingPlanId,
-              savedCart
+        const itemToRemove = cartData.lines.find((item) => item.id === lineId);
+        reportedLineQuantities.current.delete(lineId);
+        if (analytics && itemToRemove && itemToRemove.merchandise) {
+          void analytics.removeFromCart({
+            data: buildCartLineAnalyticsData({
+              merchandise: itemToRemove.merchandise,
+              quantity: itemToRemove.quantity,
+              currencyCode: cartData.cost.currencyCode
             })
-          );
+          });
         }
-        return savedCart;
-      });
-      return { adjustments };
-    });
-  };
-  const removeCartItem = (lineId) => {
-    return runWithErrorState("remove", async () => {
-      if (!cartData) {
-        console.warn(
-          "[Replo] Cannot remove cart item: no cart exists. Reach out to support@replo.app if this persists."
-        );
-        return;
-      }
-      const itemToRemove = cartData.lines.find((item) => item.id === lineId);
-      reportedLineQuantities.current.delete(lineId);
-      if (analytics && itemToRemove && itemToRemove.merchandise) {
-        void analytics.removeFromCart({
-          data: buildCartLineAnalyticsData({
-            merchandise: itemToRemove.merchandise,
-            quantity: itemToRemove.quantity,
-            currencyCode: cartData.cost.currencyCode
-          })
+        updateCartData((currentCart) => {
+          if (!currentCart) {
+            return null;
+          }
+          return removeLineFromCart(currentCart, lineId);
         });
-      }
-      updateCartData((currentCart) => {
-        if (!currentCart) {
-          return null;
-        }
-        return removeLineFromCart(currentCart, lineId);
-      });
-      await enqueueMutation(async (currentCart) => {
-        const savedLine = findLine({
-          currentCart,
-          lineId,
-          originalLine: itemToRemove
+        await enqueueMutation(async (currentCart) => {
+          const savedLine = findLine({
+            currentCart,
+            lineId,
+            originalLine: itemToRemove
+          });
+          return savedLine ? await removeCartLineItemsAction([savedLine.id], currentCart.id) : currentCart;
         });
-        return savedLine ? await removeCartLineItemsAction([savedLine.id], currentCart.id) : currentCart;
-      });
-    });
-  };
-  const updateDiscountCodes = (discountCodes) => {
-    return runWithErrorState("discount", async () => {
-      const readyCart = cartData ?? serverCart.current ?? await initializeCart();
-      updateCartData((currentCart) => {
-        return {
-          ...currentCart ?? readyCart,
-          discountCodes: discountCodes.map((code) => ({
-            code,
-            applicable: true
-          }))
-        };
       });
-      await enqueueMutation((currentCart) => {
-        return updateCartDiscountCodesAction(discountCodes, currentCart.id);
+    },
+    [
+      analytics,
+      cartData,
+      enqueueMutation,
+      findLine,
+      runWithErrorState,
+      updateCartData
+    ]
+  );
+  const updateDiscountCodes = React.useCallback(
+    (discountCodes) => {
+      return runWithErrorState("discount", async () => {
+        const readyCart = cartData ?? serverCart.current ?? await initializeCart();
+        updateCartData((currentCart) => {
+          return {
+            ...currentCart ?? readyCart,
+            discountCodes: discountCodes.map((code) => ({
+              code,
+              applicable: true
+            }))
+          };
+        });
+        await enqueueMutation((currentCart) => {
+          return updateCartDiscountCodesAction(discountCodes, currentCart.id);
+        });
       });
-    });
-  };
-  const buyNow = async (lines, discountCodes) => {
-    const cart2 = await createCartAction({
-      lines,
-      skipStoringCart: true,
-      discountCodes,
-      country
-    });
-    if (cart2) {
-      return cart2;
-    } else {
-      console.warn(
-        "[Replo] Failed to create cart for buy now. Reach out to support@replo.app if this persists."
-      );
-      return null;
-    }
-  };
-  const checkoutUrl = cartData?.checkoutUrl ?? "/";
-  return /* @__PURE__ */ jsx(CartCountryContext.Provider, { value: country, children: /* @__PURE__ */ jsx(
-    CartContext.Provider,
-    {
-      value: {
-        cartData,
-        lineItems,
-        subtotal,
-        itemsCount,
-        currencyCode: cartData?.cost.currencyCode ?? "USD",
-        addToCart,
-        updateCartItem,
-        removeCartItem,
-        updateDiscountCodes,
-        refreshCart,
-        buyNow,
-        checkoutUrl,
-        isCartOpen,
-        openCart,
-        closeCart,
-        error,
-        clearError
-      },
-      children
-    }
-  ) });
+    },
+    [
+      cartData,
+      enqueueMutation,
+      initializeCart,
+      runWithErrorState,
+      updateCartData
+    ]
+  );
+  const buyNow = React.useCallback(
+    (lines, discountCodes) => {
+      return createBuyNowCart({ lines, discountCodes, country });
+    },
+    [country]
+  );
+  const contextValue = React.useMemo(
+    () => ({
+      cartData,
+      lineItems: cartData?.lines ?? [],
+      subtotal,
+      itemsCount,
+      currencyCode: cartData?.cost.currencyCode ?? "USD",
+      addToCart,
+      updateCartItem,
+      removeCartItem,
+      updateDiscountCodes,
+      refreshCart,
+      buyNow,
+      checkoutUrl: cartData?.checkoutUrl ?? "/",
+      isCartOpen,
+      openCart,
+      closeCart,
+      error,
+      clearError
+    }),
+    [
+      addToCart,
+      buyNow,
+      cartData,
+      clearError,
+      closeCart,
+      error,
+      isCartOpen,
+      itemsCount,
+      openCart,
+      refreshCart,
+      removeCartItem,
+      subtotal,
+      updateCartItem,
+      updateDiscountCodes
+    ]
+  );
+  return /* @__PURE__ */ jsx(CartCountryContext.Provider, { value: country, children: /* @__PURE__ */ jsx(CartContext.Provider, { value: contextValue, children }) });
 }
 function useCartInternal() {
   const context = React.useContext(CartContext);

package/cart/supplied-cart-reconciliation.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+export declare function SuppliedCartReconciliationBoundary({ children, enabled, }: React.PropsWithChildren<{
+    enabled: boolean;
+}>): import("react/jsx-runtime").JSX.Element;
+export declare function useShouldReconcileSuppliedCart(): boolean;

package/cart/supplied-cart-reconciliation.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import React from "react";
+const ShouldReconcileSuppliedCartContext = React.createContext(true);
+function SuppliedCartReconciliationBoundary({
+  children,
+  enabled
+}) {
+  return /* @__PURE__ */ jsx(ShouldReconcileSuppliedCartContext.Provider, { value: enabled, children });
+}
+function useShouldReconcileSuppliedCart() {
+  return React.useContext(ShouldReconcileSuppliedCartContext);
+}
+export {
+  SuppliedCartReconciliationBoundary,
+  useShouldReconcileSuppliedCart
+};

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "1.10.1",
+  "version": "1.10.2",
   "branch": "HEAD",
-  "commit": "bad30733ed6d9f37c3fe49876e818d01dad78e77",
-  "builtAt": "2026-09-20T21:19:55.438Z"
+  "commit": "5ee9af27c9ec5545655f225b5029ef7572f61344",
+  "builtAt": "2026-09-20T21:55:46.106Z"
 };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "1.10.1",
+  "version": "1.10.2",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.10.1",
+    "version": "1.10.2",
     "branch": "HEAD",
-    "commit": "bad30733ed6d9f37c3fe49876e818d01dad78e77",
-    "builtAt": "2026-09-20T21:19:55.438Z"
+    "commit": "5ee9af27c9ec5545655f225b5029ef7572f61344",
+    "builtAt": "2026-09-20T21:55:46.106Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",

package/providers/replo-provider.js

@@ -18,7 +18,14 @@ async function ReploProvider({
   }
   return /* @__PURE__ */ jsx(QueryProvider, { children: /* @__PURE__ */ jsx(LoaderErrorDetailsProvider, { enabled: shouldShowLoaderErrorDetails(), children: /* @__PURE__ */ jsxs(AnalyticsProvider, { checkoutProvider, children: [
     /* @__PURE__ */ jsx(ReploFirstPartyPixel, {}),
-    /* @__PURE__ */ jsx(CartLoader, { country: markets?.shopify?.country, children })
+    /* @__PURE__ */ jsx(
+      CartLoader,
+      {
+        country: markets?.shopify?.country,
+        shouldReconcileSuppliedCart: checkoutProvider === "stripe",
+        children
+      }
+    )
   ] }) }) });
 }
 export {