@cimplify/sdk 0.99.1 → 0.99.2

package/dist/advanced.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkVEOAMBEX_js = require('./chunk-VEOAMBEX.js');
+var chunk4S5EMSF5_js = require('./chunk-4S5EMSF5.js');
 require('./chunk-PTPOQVXS.js');
 require('./chunk-AETVRBKI.js');
 require('./chunk-OWW5GUSB.js');
@@ -9,77 +9,77 @@ require('./chunk-OWW5GUSB.js');
 
 Object.defineProperty(exports, "AuthService", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.AuthService; }
+  get: function () { return chunk4S5EMSF5_js.AuthService; }
 });
 Object.defineProperty(exports, "BusinessService", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.BusinessService; }
+  get: function () { return chunk4S5EMSF5_js.BusinessService; }
 });
 Object.defineProperty(exports, "CartOperations", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.CartOperations; }
+  get: function () { return chunk4S5EMSF5_js.CartOperations; }
 });
 Object.defineProperty(exports, "CatalogueQueries", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.CatalogueQueries; }
+  get: function () { return chunk4S5EMSF5_js.CatalogueQueries; }
 });
 Object.defineProperty(exports, "CheckoutOperations", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.CheckoutService; }
+  get: function () { return chunk4S5EMSF5_js.CheckoutService; }
 });
 Object.defineProperty(exports, "CheckoutService", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.CheckoutService; }
+  get: function () { return chunk4S5EMSF5_js.CheckoutService; }
 });
 Object.defineProperty(exports, "CimplifyElement", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.CimplifyElement; }
+  get: function () { return chunk4S5EMSF5_js.CimplifyElement; }
 });
 Object.defineProperty(exports, "CimplifyElements", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.CimplifyElements; }
+  get: function () { return chunk4S5EMSF5_js.CimplifyElements; }
 });
 Object.defineProperty(exports, "ELEMENT_TYPES", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.ELEMENT_TYPES; }
+  get: function () { return chunk4S5EMSF5_js.ELEMENT_TYPES; }
 });
 Object.defineProperty(exports, "EVENT_TYPES", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.EVENT_TYPES; }
+  get: function () { return chunk4S5EMSF5_js.EVENT_TYPES; }
 });
 Object.defineProperty(exports, "FxService", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.FxService; }
+  get: function () { return chunk4S5EMSF5_js.FxService; }
 });
 Object.defineProperty(exports, "InventoryService", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.InventoryService; }
+  get: function () { return chunk4S5EMSF5_js.InventoryService; }
 });
 Object.defineProperty(exports, "LinkService", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.LinkService; }
+  get: function () { return chunk4S5EMSF5_js.LinkService; }
 });
 Object.defineProperty(exports, "LiteService", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.LiteService; }
+  get: function () { return chunk4S5EMSF5_js.LiteService; }
 });
 Object.defineProperty(exports, "MESSAGE_TYPES", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.MESSAGE_TYPES; }
+  get: function () { return chunk4S5EMSF5_js.MESSAGE_TYPES; }
 });
 Object.defineProperty(exports, "OrderQueries", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.OrderQueries; }
+  get: function () { return chunk4S5EMSF5_js.OrderQueries; }
 });
 Object.defineProperty(exports, "SchedulingService", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.SchedulingService; }
+  get: function () { return chunk4S5EMSF5_js.SchedulingService; }
 });
 Object.defineProperty(exports, "createElements", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.createElements; }
+  get: function () { return chunk4S5EMSF5_js.createElements; }
 });
 Object.defineProperty(exports, "generateIdempotencyKey", {
   enumerable: true,
-  get: function () { return chunkVEOAMBEX_js.generateIdempotencyKey; }
+  get: function () { return chunk4S5EMSF5_js.generateIdempotencyKey; }
 });

package/dist/advanced.mjs

@@ -1,4 +1,4 @@
-export { AuthService, BusinessService, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyElement, CimplifyElements, ELEMENT_TYPES, EVENT_TYPES, FxService, InventoryService, LinkService, LiteService, MESSAGE_TYPES, OrderQueries, SchedulingService, createElements, generateIdempotencyKey } from './chunk-VUSHG3HA.mjs';
+export { AuthService, BusinessService, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyElement, CimplifyElements, ELEMENT_TYPES, EVENT_TYPES, FxService, InventoryService, LinkService, LiteService, MESSAGE_TYPES, OrderQueries, SchedulingService, createElements, generateIdempotencyKey } from './chunk-ZFI2TKTO.mjs';
 import './chunk-KFLGQGMC.mjs';
 import './chunk-K5EN2W2Q.mjs';
 import './chunk-3G6RQLXK.mjs';

package/dist/{chunk-VEOAMBEX.js → chunk-4S5EMSF5.js}

@@ -82,6 +82,37 @@ function generateIdempotencyKey(prefix = "idem") {
   const random = Math.random().toString(36).substring(2, 15);
   return `${prefix}_${timestamp}_${random}`;
 }
+var INTENT_PREFIX = "cimplify-intent:";
+function sessionStorageOrNull() {
+  try {
+    return typeof window !== "undefined" ? window.sessionStorage : null;
+  } catch {
+    return null;
+  }
+}
+function intentIdempotencyKey(scope, fingerprint, storage = sessionStorageOrNull()) {
+  const slot = INTENT_PREFIX + scope;
+  try {
+    const raw = storage?.getItem(slot);
+    if (raw) {
+      const stored = JSON.parse(raw);
+      if (stored.fingerprint === fingerprint && typeof stored.key === "string") return stored.key;
+    }
+  } catch {
+  }
+  const key = generateIdempotencyKey();
+  try {
+    storage?.setItem(slot, JSON.stringify({ key, fingerprint }));
+  } catch {
+  }
+  return key;
+}
+function clearIntentIdempotencyKey(scope, storage = sessionStorageOrNull()) {
+  try {
+    storage?.removeItem(INTENT_PREFIX + scope);
+  } catch {
+  }
+}
 
 // src/internal/safe.ts
 function toCimplifyError(error) {
@@ -1590,13 +1621,26 @@ var CheckoutService = class {
     if (invalid) {
       return err(invalid);
     }
+    const intentScope = `checkout:${data.cart_id}`;
+    const intentFingerprint = JSON.stringify([
+      data.payment_method,
+      data.mobile_money_details,
+      data.pay_currency,
+      data.voucher_code,
+      data.pay_deposit
+    ]);
     const checkoutData = {
       ...data,
-      idempotency_key: data.idempotency_key || generateIdempotencyKey()
+      idempotency_key: data.idempotency_key || intentIdempotencyKey(intentScope, intentFingerprint)
     };
     const result = await safe(this.client.post("/api/v1/checkout", checkoutData));
-    if (result.ok && result.value.bill_token) {
-      this.client.setOrderToken(result.value.order_id, result.value.bill_token);
+    if (result.ok) {
+      clearIntentIdempotencyKey(intentScope);
+      if (result.value.bill_token) {
+        this.client.setOrderToken(result.value.order_id, result.value.bill_token);
+      }
+    } else if (result.error.code !== chunkAETVRBKI_js.ErrorCode.NETWORK_ERROR && result.error.code !== chunkAETVRBKI_js.ErrorCode.TIMEOUT) {
+      clearIntentIdempotencyKey(intentScope);
     }
     return result;
   }
@@ -1670,7 +1714,7 @@ var CheckoutService = class {
       special_instructions: data.special_instructions,
       link_address_id: data.link_address_id,
       link_payment_method_id: data.link_payment_method_id,
-      idempotency_key: data.idempotency_key || generateIdempotencyKey(),
+      idempotency_key: data.idempotency_key,
       metadata: data.metadata,
       pay_currency: data.pay_currency,
       fx_quote_id: data.fx_quote_id,

package/dist/{chunk-XMDLF5Y6.mjs → chunk-DOEGVGTM.mjs}

@@ -1,4 +1,4 @@
-import { safe, generateIdempotencyKey, err, ok, CatalogueQueries, CartOperations, CheckoutService, OrderQueries, LinkService, AuthService, BusinessService, InventoryService, SchedulingService, LiteService, FxService, createElements } from './chunk-VUSHG3HA.mjs';
+import { safe, generateIdempotencyKey, err, ok, CatalogueQueries, CartOperations, CheckoutService, OrderQueries, LinkService, AuthService, BusinessService, InventoryService, SchedulingService, LiteService, FxService, createElements } from './chunk-ZFI2TKTO.mjs';
 import { CimplifyError, ErrorCode, IdempotencyMismatchError, enrichError } from './chunk-K5EN2W2Q.mjs';
 
 // src/store-credit.ts

package/dist/{chunk-WEEGNH7K.js → chunk-J64F56EB.js}

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkFECGCIVV_js = require('./chunk-FECGCIVV.js');
-var chunkW5PH7SPK_js = require('./chunk-W5PH7SPK.js');
+var chunkR7FAU2ZF_js = require('./chunk-R7FAU2ZF.js');
 var zod = require('zod');
 
 var cimplifyRegistry = zod.z.registry();
@@ -619,7 +619,7 @@ function createTestClient(options = {}) {
     if (echoed) sessionToken = echoed;
     return res;
   };
-  const client = chunkW5PH7SPK_js.createCimplifyClient({
+  const client = chunkR7FAU2ZF_js.createCimplifyClient({
     baseUrl: TEST_BASE_URL,
     // Link mock lives at /v1/link on the same Hono app, so point the SDK's
     // separate Link transport at the same TEST_BASE_URL.

package/dist/{chunk-BUPCMMRR.mjs → chunk-QYBGG3ZJ.mjs}

@@ -1,5 +1,5 @@
 import { createMockApp } from './chunk-7TEMLVDT.mjs';
-import { createCimplifyClient } from './chunk-XMDLF5Y6.mjs';
+import { createCimplifyClient } from './chunk-DOEGVGTM.mjs';
 import { z } from 'zod';
 
 var cimplifyRegistry = z.registry();

package/dist/{chunk-W5PH7SPK.js → chunk-R7FAU2ZF.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkVEOAMBEX_js = require('./chunk-VEOAMBEX.js');
+var chunk4S5EMSF5_js = require('./chunk-4S5EMSF5.js');
 var chunkAETVRBKI_js = require('./chunk-AETVRBKI.js');
 
 // src/store-credit.ts
@@ -13,7 +13,7 @@ var StoreCreditQueries = class {
    * currency. Requires a signed-in customer; returns an error otherwise.
    */
   async balance() {
-    return chunkVEOAMBEX_js.safe(this.client.get("/api/v1/store-credit/balance"));
+    return chunk4S5EMSF5_js.safe(this.client.get("/api/v1/store-credit/balance"));
   }
 };
 
@@ -105,7 +105,7 @@ var ActivityService = class {
     this.sendEvents([event]);
   }
   async getState() {
-    return chunkVEOAMBEX_js.safe(this.client.get("/api/v1/activity/state"));
+    return chunk4S5EMSF5_js.safe(this.client.get("/api/v1/activity/state"));
   }
   async getRecommendations(options) {
     const params = new URLSearchParams();
@@ -113,10 +113,10 @@ var ActivityService = class {
     if (options?.limit) params.set("limit", String(options.limit));
     const query = params.toString();
     const path = query ? `/api/v1/activity/recommendations?${query}` : "/api/v1/activity/recommendations";
-    return chunkVEOAMBEX_js.safe(this.client.get(path));
+    return chunk4S5EMSF5_js.safe(this.client.get(path));
   }
   async dismissMessage(code) {
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.post("/api/v1/activity/messages/dismiss", { code })
     );
   }
@@ -189,16 +189,16 @@ var SubscriptionService = class {
     this.client = client;
   }
   async list() {
-    return chunkVEOAMBEX_js.safe(this.client.get("/api/v1/subscriptions"));
+    return chunk4S5EMSF5_js.safe(this.client.get("/api/v1/subscriptions"));
   }
   async get(id) {
     const encodedId = encodeURIComponent(id);
-    return chunkVEOAMBEX_js.safe(this.client.get(`/api/v1/subscriptions/${encodedId}`));
+    return chunk4S5EMSF5_js.safe(this.client.get(`/api/v1/subscriptions/${encodedId}`));
   }
   async cancel(id, reason, opts) {
     const encodedId = encodeURIComponent(id);
-    const idempotencyKey = opts?.idempotencyKey ?? chunkVEOAMBEX_js.generateIdempotencyKey();
-    return chunkVEOAMBEX_js.safe(
+    const idempotencyKey = opts?.idempotencyKey ?? chunk4S5EMSF5_js.generateIdempotencyKey();
+    return chunk4S5EMSF5_js.safe(
       this.client.post(
         `/api/v1/subscriptions/${encodedId}/cancel`,
         { reason },
@@ -208,20 +208,20 @@ var SubscriptionService = class {
   }
   async pause(id) {
     const encodedId = encodeURIComponent(id);
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.post(`/api/v1/subscriptions/${encodedId}/pause`)
     );
   }
   async resume(id) {
     const encodedId = encodeURIComponent(id);
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.post(`/api/v1/subscriptions/${encodedId}/resume`)
     );
   }
   async skipNextRenewal(id, opts) {
     const encodedId = encodeURIComponent(id);
-    const idempotencyKey = opts?.idempotencyKey ?? chunkVEOAMBEX_js.generateIdempotencyKey();
-    return chunkVEOAMBEX_js.safe(
+    const idempotencyKey = opts?.idempotencyKey ?? chunk4S5EMSF5_js.generateIdempotencyKey();
+    return chunk4S5EMSF5_js.safe(
       this.client.post(
         `/api/v1/subscriptions/${encodedId}/skip`,
         void 0,
@@ -237,8 +237,8 @@ var UploadService = class {
     this.client = client;
   }
   async init(filename, contentType, sizeBytes, opts) {
-    const idempotencyKey = opts?.idempotencyKey ?? chunkVEOAMBEX_js.generateIdempotencyKey();
-    return chunkVEOAMBEX_js.safe(
+    const idempotencyKey = opts?.idempotencyKey ?? chunk4S5EMSF5_js.generateIdempotencyKey();
+    return chunk4S5EMSF5_js.safe(
       this.client.post(
         "/api/v1/uploads/init",
         {
@@ -251,7 +251,7 @@ var UploadService = class {
     );
   }
   async confirm(uploadId) {
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.post("/api/v1/uploads/confirm", {
         upload_id: uploadId
       })
@@ -297,7 +297,7 @@ var PlacesService = class {
     this.client = client;
   }
   async autocomplete(input, sessionToken) {
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.post("/api/v1/places/autocomplete", {
         input,
         sessionToken
@@ -305,7 +305,7 @@ var PlacesService = class {
     );
   }
   async details(placeId, sessionToken) {
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.post("/api/v1/places/details", {
         place_id: placeId,
         sessionToken
@@ -324,7 +324,7 @@ var DeliveryService = class {
     params.set("dropoff_lat", String(dropoffLat));
     params.set("dropoff_lng", String(dropoffLng));
     if (country) params.set("country", country);
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.get(`/api/v1/delivery/fee?${params.toString()}`)
     );
   }
@@ -336,7 +336,7 @@ var DeliveryService = class {
     params.set("dropoff_lng", String(dropoffLng));
     if (opts?.country) params.set("country", opts.country);
     if (opts?.orderValue != null) params.set("order_value", String(opts.orderValue));
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.get(`/api/v1/delivery/options?${params.toString()}`)
     );
   }
@@ -413,7 +413,7 @@ var SupportService = class {
   async claimConversation() {
     const accessToken = this.client.getAccessToken();
     if (!accessToken) {
-      return chunkVEOAMBEX_js.err(new chunkAETVRBKI_js.CimplifyError("not_authenticated", "No access token to claim with"));
+      return chunk4S5EMSF5_js.err(new chunkAETVRBKI_js.CimplifyError("not_authenticated", "No access token to claim with"));
     }
     if (this.claimInFlight) {
       if (this.claimInFlightToken === accessToken) return this.claimInFlight;
@@ -421,12 +421,12 @@ var SupportService = class {
       return this.claimConversation();
     }
     if (this.lastClaimedAccessToken === accessToken) {
-      return chunkVEOAMBEX_js.err(new chunkAETVRBKI_js.CimplifyError("already_claimed", "Session already claimed for this token"));
+      return chunk4S5EMSF5_js.err(new chunkAETVRBKI_js.CimplifyError("already_claimed", "Session already claimed for this token"));
     }
     const epoch = this.client.getSessionEpoch();
     this.claimInFlightToken = accessToken;
     this.claimInFlight = (async () => {
-      const result = await chunkVEOAMBEX_js.safe(
+      const result = await chunk4S5EMSF5_js.safe(
         this.client.post(
           "/api/v1/support/conversation/claim",
           { access_token: accessToken },
@@ -435,7 +435,7 @@ var SupportService = class {
       );
       if (result.ok) {
         if (this.client.getSessionEpoch() !== epoch) {
-          return chunkVEOAMBEX_js.err(
+          return chunk4S5EMSF5_js.err(
             new chunkAETVRBKI_js.CimplifyError("session_cleared", "Session was cleared during the claim")
           );
         }
@@ -464,20 +464,20 @@ var SupportService = class {
    * the inbox with empty threads.
    */
   async peekConversation() {
-    const result = await chunkVEOAMBEX_js.safe(
+    const result = await chunk4S5EMSF5_js.safe(
       this.client.get("/api/v1/support/conversation")
     );
     if (!result.ok) return result;
-    if (!result.value.conversation) return chunkVEOAMBEX_js.ok(null);
-    return chunkVEOAMBEX_js.ok({
+    if (!result.value.conversation) return chunk4S5EMSF5_js.ok(null);
+    return chunk4S5EMSF5_js.ok({
       conversation: result.value.conversation,
       messages: result.value.messages
     });
   }
   /** Open (or resume) the customer's widget conversation. */
   async openConversation(opts) {
-    const idempotencyKey = opts?.idempotencyKey ?? chunkVEOAMBEX_js.generateIdempotencyKey();
-    return chunkVEOAMBEX_js.safe(
+    const idempotencyKey = opts?.idempotencyKey ?? chunk4S5EMSF5_js.generateIdempotencyKey();
+    return chunk4S5EMSF5_js.safe(
       this.client.post("/api/v1/support/conversation", void 0, {
         idempotencyKey
       })
@@ -492,8 +492,8 @@ var SupportService = class {
    * server resolves it thread-scoped and echoes the quote as `reply_to`.
    */
   async sendMessage(content, opts) {
-    const idempotencyKey = opts?.idempotencyKey ?? chunkVEOAMBEX_js.generateIdempotencyKey();
-    return chunkVEOAMBEX_js.safe(
+    const idempotencyKey = opts?.idempotencyKey ?? chunk4S5EMSF5_js.generateIdempotencyKey();
+    return chunk4S5EMSF5_js.safe(
       this.client.post(
         "/api/v1/support/conversation/messages",
         {
@@ -517,11 +517,11 @@ var SupportService = class {
     if (options.limit) params.set("limit", String(options.limit));
     const query = params.toString();
     const path = query ? `/api/v1/support/conversation/messages?${query}` : "/api/v1/support/conversation/messages";
-    return chunkVEOAMBEX_js.safe(this.client.get(path));
+    return chunk4S5EMSF5_js.safe(this.client.get(path));
   }
   /** React to a message in the active conversation by its `ChatMessage.id`. */
   async reactToMessage(messageId, emoji) {
-    return chunkVEOAMBEX_js.safe(
+    return chunk4S5EMSF5_js.safe(
       this.client.post(
         `/api/v1/support/conversation/messages/${messageId}/reactions`,
         { emoji }
@@ -530,8 +530,8 @@ var SupportService = class {
   }
   /** Ask for a person: flags the thread for the merchant's inbox. */
   async requestHuman(opts) {
-    const idempotencyKey = opts?.idempotencyKey ?? chunkVEOAMBEX_js.generateIdempotencyKey();
-    return chunkVEOAMBEX_js.safe(
+    const idempotencyKey = opts?.idempotencyKey ?? chunk4S5EMSF5_js.generateIdempotencyKey();
+    return chunk4S5EMSF5_js.safe(
       this.client.post(
         "/api/v1/support/conversation/handoff",
         void 0,
@@ -1250,25 +1250,25 @@ var CimplifyClient = class {
   }
   get catalogue() {
     if (!this._catalogue) {
-      this._catalogue = new chunkVEOAMBEX_js.CatalogueQueries(this);
+      this._catalogue = new chunk4S5EMSF5_js.CatalogueQueries(this);
     }
     return this._catalogue;
   }
   get cart() {
     if (!this._cart) {
-      this._cart = new chunkVEOAMBEX_js.CartOperations(this);
+      this._cart = new chunk4S5EMSF5_js.CartOperations(this);
     }
     return this._cart;
   }
   get checkout() {
     if (!this._checkout) {
-      this._checkout = new chunkVEOAMBEX_js.CheckoutService(this);
+      this._checkout = new chunk4S5EMSF5_js.CheckoutService(this);
     }
     return this._checkout;
   }
   get orders() {
     if (!this._orders) {
-      this._orders = new chunkVEOAMBEX_js.OrderQueries(this);
+      this._orders = new chunk4S5EMSF5_js.OrderQueries(this);
     }
     return this._orders;
   }
@@ -1298,43 +1298,43 @@ var CimplifyClient = class {
   }
   get link() {
     if (!this._link) {
-      this._link = new chunkVEOAMBEX_js.LinkService(this);
+      this._link = new chunk4S5EMSF5_js.LinkService(this);
     }
     return this._link;
   }
   get auth() {
     if (!this._auth) {
-      this._auth = new chunkVEOAMBEX_js.AuthService(this);
+      this._auth = new chunk4S5EMSF5_js.AuthService(this);
     }
     return this._auth;
   }
   get business() {
     if (!this._business) {
-      this._business = new chunkVEOAMBEX_js.BusinessService(this);
+      this._business = new chunk4S5EMSF5_js.BusinessService(this);
     }
     return this._business;
   }
   get inventory() {
     if (!this._inventory) {
-      this._inventory = new chunkVEOAMBEX_js.InventoryService(this);
+      this._inventory = new chunk4S5EMSF5_js.InventoryService(this);
     }
     return this._inventory;
   }
   get scheduling() {
     if (!this._scheduling) {
-      this._scheduling = new chunkVEOAMBEX_js.SchedulingService(this);
+      this._scheduling = new chunk4S5EMSF5_js.SchedulingService(this);
     }
     return this._scheduling;
   }
   get lite() {
     if (!this._lite) {
-      this._lite = new chunkVEOAMBEX_js.LiteService(this);
+      this._lite = new chunk4S5EMSF5_js.LiteService(this);
     }
     return this._lite;
   }
   get fx() {
     if (!this._fx) {
-      this._fx = new chunkVEOAMBEX_js.FxService(this);
+      this._fx = new chunk4S5EMSF5_js.FxService(this);
     }
     return this._fx;
   }
@@ -1369,7 +1369,7 @@ var CimplifyClient = class {
     if (businessId) {
       this.setBusinessId(businessId);
     }
-    return chunkVEOAMBEX_js.createElements(this, businessId ?? this.businessId ?? void 0, options);
+    return chunk4S5EMSF5_js.createElements(this, businessId ?? this.businessId ?? void 0, options);
   }
 };
 function createCimplifyClient(config = {}) {

package/dist/{chunk-VUSHG3HA.mjs → chunk-ZFI2TKTO.mjs}

@@ -1,5 +1,5 @@
 import { isPaymentStatusRequiresAction, normalizeStatusResponse, isPaymentStatusSuccess, isPaymentStatusFailure } from './chunk-KFLGQGMC.mjs';
-import { CimplifyError, currencyCode, ErrorCode, enrichError, getErrorHint } from './chunk-K5EN2W2Q.mjs';
+import { CimplifyError, ErrorCode, currencyCode, enrichError, getErrorHint } from './chunk-K5EN2W2Q.mjs';
 
 // src/types/result.ts
 function ok(value) {
@@ -80,6 +80,37 @@ function generateIdempotencyKey(prefix = "idem") {
   const random = Math.random().toString(36).substring(2, 15);
   return `${prefix}_${timestamp}_${random}`;
 }
+var INTENT_PREFIX = "cimplify-intent:";
+function sessionStorageOrNull() {
+  try {
+    return typeof window !== "undefined" ? window.sessionStorage : null;
+  } catch {
+    return null;
+  }
+}
+function intentIdempotencyKey(scope, fingerprint, storage = sessionStorageOrNull()) {
+  const slot = INTENT_PREFIX + scope;
+  try {
+    const raw = storage?.getItem(slot);
+    if (raw) {
+      const stored = JSON.parse(raw);
+      if (stored.fingerprint === fingerprint && typeof stored.key === "string") return stored.key;
+    }
+  } catch {
+  }
+  const key = generateIdempotencyKey();
+  try {
+    storage?.setItem(slot, JSON.stringify({ key, fingerprint }));
+  } catch {
+  }
+  return key;
+}
+function clearIntentIdempotencyKey(scope, storage = sessionStorageOrNull()) {
+  try {
+    storage?.removeItem(INTENT_PREFIX + scope);
+  } catch {
+  }
+}
 
 // src/internal/safe.ts
 function toCimplifyError(error) {
@@ -1588,13 +1619,26 @@ var CheckoutService = class {
     if (invalid) {
       return err(invalid);
     }
+    const intentScope = `checkout:${data.cart_id}`;
+    const intentFingerprint = JSON.stringify([
+      data.payment_method,
+      data.mobile_money_details,
+      data.pay_currency,
+      data.voucher_code,
+      data.pay_deposit
+    ]);
     const checkoutData = {
       ...data,
-      idempotency_key: data.idempotency_key || generateIdempotencyKey()
+      idempotency_key: data.idempotency_key || intentIdempotencyKey(intentScope, intentFingerprint)
     };
     const result = await safe(this.client.post("/api/v1/checkout", checkoutData));
-    if (result.ok && result.value.bill_token) {
-      this.client.setOrderToken(result.value.order_id, result.value.bill_token);
+    if (result.ok) {
+      clearIntentIdempotencyKey(intentScope);
+      if (result.value.bill_token) {
+        this.client.setOrderToken(result.value.order_id, result.value.bill_token);
+      }
+    } else if (result.error.code !== ErrorCode.NETWORK_ERROR && result.error.code !== ErrorCode.TIMEOUT) {
+      clearIntentIdempotencyKey(intentScope);
     }
     return result;
   }
@@ -1668,7 +1712,7 @@ var CheckoutService = class {
       special_instructions: data.special_instructions,
       link_address_id: data.link_address_id,
       link_payment_method_id: data.link_payment_method_id,
-      idempotency_key: data.idempotency_key || generateIdempotencyKey(),
+      idempotency_key: data.idempotency_key,
       metadata: data.metadata,
       pay_currency: data.pay_currency,
       fx_quote_id: data.fx_quote_id,