@replohq/sdk 2.20.2 → 2.20.3

package/cart/checkout-restart.d.ts

@@ -0,0 +1,8 @@
+export declare const CHECKOUT_RESTART_STORAGE_KEY = "replo-checkout-restarted-at";
+type RestartStorage = Pick<Storage, "getItem" | "setItem">;
+/** True when the page should restart checkout now, recording that it did. */
+export declare function claimCheckoutRestart({ getStorage, now, }: {
+    getStorage: () => RestartStorage;
+    now: number;
+}): boolean;
+export {};

package/cart/checkout-restart.js

@@ -0,0 +1,23 @@
+const CHECKOUT_RESTART_STORAGE_KEY = "replo-checkout-restarted-at";
+const RESTART_WINDOW_MS = 3e4;
+function claimCheckoutRestart({
+  getStorage,
+  now
+}) {
+  try {
+    const storage = getStorage();
+    const restartedAt = Number(storage.getItem(CHECKOUT_RESTART_STORAGE_KEY));
+    if (restartedAt > 0 && now - restartedAt < RESTART_WINDOW_MS) {
+      return false;
+    }
+    storage.setItem(CHECKOUT_RESTART_STORAGE_KEY, String(now));
+    return storage.getItem(CHECKOUT_RESTART_STORAGE_KEY) === String(now);
+  } catch (error) {
+    console.warn("[Replo] Session storage is unavailable", error);
+    return false;
+  }
+}
+export {
+  CHECKOUT_RESTART_STORAGE_KEY,
+  claimCheckoutRestart
+};

package/cart/checkout.js

@@ -14,6 +14,10 @@ import { CanopyError } from "../lib/canopy-error";
 import { formatAmount } from "../money";
 import { getCrossSellsAction } from "./checkout-actions";
 import { readSiteCheckoutAppearance } from "./checkout-appearance";
+import {
+  CHECKOUT_RESTART_STORAGE_KEY,
+  claimCheckoutRestart
+} from "./checkout-restart";
 import {
   addCrossSellAction,
   updateCheckoutShippingAction
@@ -75,6 +79,7 @@ function readCheckoutConfig() {
     writeStorage(CONFIG_STORAGE_KEY, null);
   } else if (fragment) {
     writeStorage(CONFIG_STORAGE_KEY, fragment);
+    writeStorage(CHECKOUT_RESTART_STORAGE_KEY, null);
   }
   if (fragment) {
     window.history.replaceState(
@@ -98,14 +103,22 @@ function readCheckoutConfig() {
   return parsed.success ? parsed.output : "missing";
 }
 let loadedCheckout = null;
-function getLoadedCheckout() {
+function getLoadedCheckout(startCheckoutPath) {
   const fragment = window.location.hash;
   if (!loadedCheckout || fragment && fragment !== loadedCheckout.fragment) {
     const config = readCheckoutConfig();
+    const shouldRestartCheckout = config === "missing" && claimCheckoutRestart({
+      getStorage: () => sessionStorage,
+      now: Date.now()
+    });
+    if (shouldRestartCheckout) {
+      window.location.assign(startCheckoutPath);
+    }
     loadedCheckout = {
       fragment,
       value: {
         config,
+        shouldRestartCheckout,
         stripe: typeof config === "string" ? null : loadStripe(config.publishableKey, {
           stripeAccount: config.stripeAccountId
         }),
@@ -341,7 +354,7 @@ function CheckoutSessionProvider({
 }) {
   const loaded = React.useSyncExternalStore(
     subscribeToNothing,
-    getLoadedCheckout,
+    () => getLoadedCheckout(startCheckoutPath),
     () => null
   );
   const retry = () => {
@@ -356,7 +369,10 @@ function CheckoutSessionProvider({
     return /* @__PURE__ */ jsx(
       CheckoutSessionContext.Provider,
       {
-        value: { state: loaded ? state : { status: "loading" }, form: null },
+        value: {
+          state: loaded && !loaded.shouldRestartCheckout ? state : { status: "loading" },
+          form: null
+        },
         children
       }
     );

package/lib/buildMetadata.js

@@ -1,7 +1,7 @@
 export const BUILD_METADATA = {
   "packageName": "@replohq/sdk",
-  "version": "2.20.2",
+  "version": "2.20.3",
   "branch": "HEAD",
-  "commit": "437e1e853916beee996b6b16fc2d77f31da0638d",
-  "builtAt": "2026-11-07T00:33:22.871Z"
+  "commit": "f4d42a40b0c8d0a03eb9e295f7c8aa0ae2ed6512",
+  "builtAt": "2026-11-08T00:27:06.748Z"
 };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@replohq/sdk",
-  "version": "2.20.2",
+  "version": "2.20.3",
   "reploBuild": {
     "packageName": "@replohq/sdk",
-    "version": "2.20.2",
+    "version": "2.20.3",
     "branch": "HEAD",
-    "commit": "437e1e853916beee996b6b16fc2d77f31da0638d",
-    "builtAt": "2026-11-07T00:33:22.871Z"
+    "commit": "f4d42a40b0c8d0a03eb9e295f7c8aa0ae2ed6512",
+    "builtAt": "2026-11-08T00:27:06.748Z"
   },
   "description": "Replo SDK — cart, analytics, and data loaders for agent-built Next.js sites.",
   "license": "SEE LICENSE IN LICENSE",