@joai/sdk 14.0.1 → 14.0.2

package/dist/index.d.mts

@@ -299,7 +299,10 @@ declare function createGuestCommerceStorage(options: GuestCommerceStorageOptions
     accessToken
   }: GuestOrderAccess): void;
   readOrderAccess(orderId: string): string | null;
-  listOrderAccess(): GuestOrderAccess[]; /** Absolute shop URL from a path or full URL (e.g. orders page). */
+  listOrderAccess(): GuestOrderAccess[]; /** Remember the order being paid so a gateway return without `?order=` can reopen it. */
+  savePendingOrderReturn(orderId: string): void;
+  readPendingOrderReturn(): string | null;
+  clearPendingOrderReturn(): void; /** Absolute shop URL from a path or full URL (e.g. orders page). */
   shopUrl(ordersPage: string): string; /** Thank-you → shop handoff URL with capability token query params. */
   orderReturnUrl(ordersPage: string, orderId: string, accessToken: string): string; /** Persist `order` + `orderAccessToken` from the shop handoff query, then strip the token. */
   claimOrderReturn(): GuestOrderAccess | null;

package/dist/index.mjs

@@ -286,6 +286,7 @@ const orderAccessPrefix = "joai:order-access:";
 const checkoutKey = (namespace) => `joai:guest-checkout:${namespace}`;
 const ordersKey = (namespace) => `joai:guest-orders:${namespace}`;
 const orderAccessKey = (namespace, orderId) => `${orderAccessPrefix}${namespace}:${orderId}`;
+const pendingOrderReturnKey = (namespace) => `joai:guest-pending-order-return:${namespace}`;
 const safeGet$1 = (key) => {
 	if (typeof localStorage === "undefined") return null;
 	try {
@@ -397,6 +398,16 @@ function createGuestCommerceStorage(options) {
 				accessToken: entry.accessToken || safeGet$1(orderAccessKey(options.namespace, entry.orderId))
 			}));
 		},
+		/** Remember the order being paid so a gateway return without `?order=` can reopen it. */
+		savePendingOrderReturn(orderId) {
+			safeSet$1(pendingOrderReturnKey(options.namespace), orderId);
+		},
+		readPendingOrderReturn() {
+			return safeGet$1(pendingOrderReturnKey(options.namespace));
+		},
+		clearPendingOrderReturn() {
+			safeRemove$1(pendingOrderReturnKey(options.namespace));
+		},
 		/** Absolute shop URL from a path or full URL (e.g. orders page). */
 		shopUrl(ordersPage) {
 			return absoluteOrdersPageUrl(ordersPage);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "14.0.1",
+  "version": "14.0.2",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",