@replohq/sdk 1.13.0 → 1.13.2

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

@@ -80,4 +80,5 @@ export declare function isNetworkErrorMessage(message: string): boolean;
  * fallback string or `String(error)`.
  */
 export declare function getErrorMessage(error: unknown, fallback?: string): string;
+export declare function appendErrorId(detail: string, errorId: string | null | undefined): string;
 export {};

package/_vendor/schemas/errors.d.ts

@@ -436,6 +436,12 @@ export declare class IframeRpcChannelTimeoutError extends IframeRpcChannelError
         timeoutMs: number;
     });
 }
+export declare class IframeRpcChannelTargetUnavailableError extends IframeRpcChannelError {
+    constructor({ callType, method, }: {
+        callType: "notify" | "request" | "response";
+        method?: string;
+    });
+}
 export declare class IframeRpcChannelRemoteError extends IframeRpcChannelError {
     constructor({ method, message }: {
         method: string;

package/cart/cart-actions.d.ts

@@ -1,13 +1,6 @@
 import type { StorefrontCountryCode } from "../loaders/markets";
 import type { AddToCartPayload, Cart, CartLineAttribute, CartLinePayload, RemoveFromCartPayload, UpdateCartLineItemPayload } from "./cart-types";
-/**
- * Gets the existing cart or creates a new one if none exists. This is necessary
- * because we may not have cookies in the server context during initial load.
- *
- * See: https://nextjs.org/docs/app/api-reference/functions/cookies#understanding-cookie-behavior-in-server-components
- *
- * @returns The existing cart or a newly created cart
- */
+/** Gets the existing cart or creates a new one if none exists. */
 export declare function getOrCreateCartAction(options?: {
     country?: StorefrontCountryCode;
 }): Promise<Cart | null>;

package/cart/cart-provider.js

@@ -28,8 +28,25 @@ import {
 import { CartContextError, toCartError } from "./utils/cart-error";
 import { recalculateCartCost } from "./utils/cart-utils";
 import { createOptimisticSellingPlanAllocation } from "./utils/variant-to-cart-line";
+let cartLoadPromise = null;
+let cartLoadCountry;
 let cartCreationPromise = null;
 let cartCreationCountry;
+function getSharedReconciledCart(country) {
+  if (cartLoadPromise && cartLoadCountry === country) {
+    return cartLoadPromise;
+  }
+  const previousLoad = cartLoadPromise;
+  const load = (async () => {
+    if (previousLoad) await previousLoad.catch(() => null);
+    return await reconcileCartAction({ country });
+  })().finally(() => {
+    if (cartLoadPromise === load) cartLoadPromise = null;
+  });
+  cartLoadCountry = country;
+  cartLoadPromise = load;
+  return load;
+}
 function getOrCreateSharedCart(country) {
   if (cartCreationPromise && cartCreationCountry === country) {
     return cartCreationPromise;
@@ -161,6 +178,7 @@ function CartProvider({
   const mutationQueue = React.useRef(Promise.resolve());
   const pendingMutations = React.useRef(0);
   const optimisticLines = React.useRef(/* @__PURE__ */ new Map());
+  const cartInitialization = React.useRef(null);
   const lastReconciliationCountry = React.useRef(false);
   const startSuppliedCartReconciliation = React.useCallback(() => {
     if (!shouldReconcileSuppliedCart || lastReconciliationCountry.current === country) {
@@ -187,6 +205,7 @@ function CartProvider({
       startSuppliedCartReconciliation();
       pendingMutations.current += 1;
       const request = mutationQueue.current.then(async () => {
+        await cartLoadPromise?.catch(() => null);
         await cartCreationPromise?.catch(() => null);
         if (needsRefresh.current) {
           const restoredCart = await getCartAction();
@@ -246,34 +265,59 @@ function CartProvider({
     },
     []
   );
-  const initializeCart = React.useCallback(async () => {
+  const reconcilePersistedCart = React.useCallback(() => {
+    const currentInitialization = cartInitialization.current;
+    if (currentInitialization && currentInitialization.country === country) {
+      return currentInitialization.promise;
+    }
+    const selection = marketSelection.current;
+    const initialization = (async () => {
+      const loadedCart = await getSharedReconciledCart(country);
+      if (!isMounted.current || marketSelection.current !== selection) {
+        throw new DOMException(
+          "Cart initialization was superseded",
+          "AbortError"
+        );
+      }
+      serverCart.current = loadedCart;
+      if (pendingMutations.current === 0) updateCartData(loadedCart);
+      return loadedCart;
+    })();
+    cartInitialization.current = { country, promise: initialization };
+    void initialization.catch(() => {
+      if (cartInitialization.current?.promise === initialization) {
+        cartInitialization.current = null;
+      }
+    });
+    return initialization;
+  }, [country, updateCartData]);
+  const getOrCreateCartForMutation = React.useCallback(async () => {
+    const loadedCart = await reconcilePersistedCart();
+    if (loadedCart) return loadedCart;
     const selection = marketSelection.current;
-    const loadedCart = await getOrCreateSharedCart(country);
+    const createdCart = await getOrCreateSharedCart(country);
     if (!isMounted.current || marketSelection.current !== selection) {
-      throw new DOMException(
-        "Cart initialization was superseded",
-        "AbortError"
-      );
+      throw new DOMException("Cart creation was superseded", "AbortError");
     }
-    serverCart.current = loadedCart;
-    if (pendingMutations.current === 0) updateCartData(loadedCart);
-    return loadedCart;
-  }, [country, updateCartData]);
+    serverCart.current = createdCart;
+    if (pendingMutations.current === 0) updateCartData(createdCart);
+    return createdCart;
+  }, [country, reconcilePersistedCart, updateCartData]);
   React.useEffect(() => {
     isMounted.current = true;
     if (isSuppliedCart) {
       startSuppliedCartReconciliation();
     } else {
-      void initializeCart().catch((error2) => {
+      void reconcilePersistedCart().catch((error2) => {
         if (isMounted.current && !(error2 instanceof DOMException && error2.name === "AbortError")) {
-          console.error("[Replo] Error getting or creating cart:", error2);
+          console.error("[Replo] Error loading cart:", error2);
         }
       });
     }
     return () => {
       isMounted.current = false;
     };
-  }, [initializeCart, isSuppliedCart, startSuppliedCartReconciliation]);
+  }, [isSuppliedCart, reconcilePersistedCart, startSuppliedCartReconciliation]);
   const subtotal = cartData?.lines.reduce((sum, lineItem) => {
     if (lineItem.quantity > 0 && lineItem.merchandise) {
       sum += lineItem.merchandise.price * lineItem.quantity;
@@ -313,7 +357,7 @@ function CartProvider({
   const addToCart = React.useCallback(
     (lines, openCartAfterAdd = true) => {
       return runWithErrorState("add", async () => {
-        const readyCart = cartData ?? serverCart.current ?? await initializeCart().catch((caught) => {
+        const readyCart = cartData ?? serverCart.current ?? await getOrCreateCartForMutation().catch((caught) => {
           if (openCartAfterAdd) setIsCartOpen(true);
           throw caught;
         });
@@ -373,7 +417,7 @@ function CartProvider({
       cartData,
       emitCartView,
       enqueueMutation,
-      initializeCart,
+      getOrCreateCartForMutation,
       runWithErrorState,
       updateCartData
     ]
@@ -381,13 +425,14 @@ function CartProvider({
   const updateCartItem = React.useCallback(
     (line) => {
       return runWithErrorState("update", async () => {
-        if (!cartData) {
+        const readyCart = cartData ?? serverCart.current ?? await reconcilePersistedCart();
+        if (!readyCart) {
           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 currentLine = readyCart.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);
@@ -395,15 +440,12 @@ function CartProvider({
           const data = buildCartLineAnalyticsData({
             merchandise,
             quantity: Math.abs(quantityDelta),
-            currencyCode: cartData.cost.currencyCode
+            currencyCode: readyCart.cost.currencyCode
           });
           void (quantityDelta > 0 ? analytics.addToCart({ data }) : analytics.removeFromCart({ data }));
         }
         updateCartData((currentCart) => {
-          if (!currentCart) {
-            return null;
-          }
-          return updateLineInCart(currentCart, line);
+          return updateLineInCart(currentCart ?? readyCart, line);
         });
         const adjustments = [];
         await enqueueMutation(async (currentCart) => {
@@ -440,6 +482,7 @@ function CartProvider({
       cartData,
       enqueueMutation,
       findLine,
+      reconcilePersistedCart,
       runWithErrorState,
       updateCartData
     ]
@@ -447,28 +490,26 @@ function CartProvider({
   const removeCartItem = React.useCallback(
     (lineId) => {
       return runWithErrorState("remove", async () => {
-        if (!cartData) {
+        const readyCart = cartData ?? serverCart.current ?? await reconcilePersistedCart();
+        if (!readyCart) {
           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);
+        const itemToRemove = readyCart.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
+              currencyCode: readyCart.cost.currencyCode
             })
           });
         }
         updateCartData((currentCart) => {
-          if (!currentCart) {
-            return null;
-          }
-          return removeLineFromCart(currentCart, lineId);
+          return removeLineFromCart(currentCart ?? readyCart, lineId);
         });
         await enqueueMutation(async (currentCart) => {
           const savedLine = findLine({
@@ -485,6 +526,7 @@ function CartProvider({
       cartData,
       enqueueMutation,
       findLine,
+      reconcilePersistedCart,
       runWithErrorState,
       updateCartData
     ]
@@ -492,7 +534,7 @@ function CartProvider({
   const updateCartField = React.useCallback(
     (operation, patch, save) => {
       return runWithErrorState(operation, async () => {
-        const readyCart = cartData ?? serverCart.current ?? await initializeCart();
+        const readyCart = cartData ?? serverCart.current ?? await getOrCreateCartForMutation();
         updateCartData((currentCart) => ({
           ...currentCart ?? readyCart,
           ...patch
@@ -503,7 +545,7 @@ function CartProvider({
     [
       cartData,
       enqueueMutation,
-      initializeCart,
+      getOrCreateCartForMutation,
       runWithErrorState,
       updateCartData
     ]

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

@@ -46,7 +46,7 @@ class CookieBasedCartGateway {
     const reconciledCart = await this.reconcile(cart, {
       clampQuantities: false
     });
-    if (JSON.stringify(reconciledCart.lines) !== JSON.stringify(cart.lines)) {
+    if (JSON.stringify(reconciledCart.lines) !== JSON.stringify(cart.lines) || reconciledCart.cost.currencyCode !== cart.cost.currencyCode) {
       await saveCartToCookie(reconciledCart, this.config.cookieName);
     }
     return reconciledCart;

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

@@ -21,9 +21,10 @@ export declare function calculateLineItemsSubtotal(lineItems: CartLine[]): numbe
  */
 export declare function recalculateCartCost(cart: Cart): Cart;
 /**
- * Rewrite a cookie cart with the catalog's current facts: live prices always,
- * unavailable lines dropped, and — on write paths only — quantities clamped to
- * the purchasable remainder. Reads never clamp (`clampQuantities: false`):
+ * Rewrite a cookie cart with the catalog's current facts: live prices and
+ * currency always, unavailable lines dropped, and — on write paths only —
+ * quantities clamped to the purchasable remainder. Reads never clamp
+ * (`clampQuantities: false`):
  * a quantity change without messaging is worse than one the mutation or
  * checkout path reports, mirroring Shopify's cart behavior.
  *

package/cart/utils/cart-utils.js

@@ -58,7 +58,14 @@ function applyCartLineReconciliation(cart, reconciledLines, { clampQuantities })
       }
     ];
   });
-  return recalculateCartCost({ ...cart, lines });
+  const currencyCode = reconciledLines.find((catalogLine) => {
+    return catalogLine.status === "purchasable";
+  })?.currencyCode ?? cart.cost.currencyCode;
+  return recalculateCartCost({
+    ...cart,
+    lines,
+    cost: { ...cart.cost, currencyCode }
+  });
 }
 function calculateCartTotals({
   lineItems,

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "branch": "HEAD",
-  "commit": "55186f7cb6b1441e4d471b2d954118f3d11767ae",
-  "builtAt": "2026-09-22T17:30:33.714Z"
+  "commit": "9717e963b637fc156b2ca32880d1612b38dce67a",
+  "builtAt": "2026-09-22T23:53:49.827Z"
 };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "1.13.0",
+    "version": "1.13.2",
     "branch": "HEAD",
-    "commit": "55186f7cb6b1441e4d471b2d954118f3d11767ae",
-    "builtAt": "2026-09-22T17:30:33.714Z"
+    "commit": "9717e963b637fc156b2ca32880d1612b38dce67a",
+    "builtAt": "2026-09-22T23:53:49.827Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",