@cimplify/sdk 0.31.0 → 0.36.0

package/dist/advanced.d.mts

@@ -1,2 +1,6 @@
-export { A as AuthService, B as BusinessService, j as CartOperations, b as CatalogueQueries, l as CheckoutOperations, l as CheckoutService, a7 as CimplifyElement, a6 as CimplifyElements, ab as ELEMENT_TYPES, aa as EVENT_TYPES, af as ElementEventType, ad as ElementOptions, ae as ElementType, ac as ElementsOptions, F as FetchQuoteInput, s as FxService, G as GetProductsOptions, I as InventoryService, L as LinkService, r as LiteService, a9 as MESSAGE_TYPES, O as OrderQueries, P as PriceQuote, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, f as QuoteDynamicBuckets, e as QuoteStatus, g as QuoteUiMessage, R as RefreshQuoteInput, i as RefreshQuoteResult, q as SchedulingService, a8 as createElements, m as generateIdempotencyKey } from './index-m8zGQUda.mjs';
-import './payment-DnU_eLuT.mjs';
+export { A as AuthService, B as BusinessService, j as CartOperations, b as CatalogueQueries, l as CheckoutOperations, l as CheckoutService, a6 as CimplifyElement, a5 as CimplifyElements, aa as ELEMENT_TYPES, a9 as EVENT_TYPES, ae as ElementEventType, ac as ElementOptions, ad as ElementType, ab as ElementsOptions, F as FetchQuoteInput, r as FxService, G as GetProductsOptions, I as InventoryService, L as LinkService, q as LiteService, a8 as MESSAGE_TYPES, O as OrderQueries, P as PriceQuote, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, f as QuoteDynamicBuckets, e as QuoteStatus, g as QuoteUiMessage, R as RefreshQuoteInput, i as RefreshQuoteResult, p as SchedulingService, a7 as createElements } from './client-CkGlXZRd.mjs';
+import './payment-DA1i5hhk.mjs';
+
+declare function generateIdempotencyKey(prefix?: string): string;
+
+export { generateIdempotencyKey };

package/dist/advanced.d.ts

@@ -1,2 +1,6 @@
-export { A as AuthService, B as BusinessService, j as CartOperations, b as CatalogueQueries, l as CheckoutOperations, l as CheckoutService, a7 as CimplifyElement, a6 as CimplifyElements, ab as ELEMENT_TYPES, aa as EVENT_TYPES, af as ElementEventType, ad as ElementOptions, ae as ElementType, ac as ElementsOptions, F as FetchQuoteInput, s as FxService, G as GetProductsOptions, I as InventoryService, L as LinkService, r as LiteService, a9 as MESSAGE_TYPES, O as OrderQueries, P as PriceQuote, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, f as QuoteDynamicBuckets, e as QuoteStatus, g as QuoteUiMessage, R as RefreshQuoteInput, i as RefreshQuoteResult, q as SchedulingService, a8 as createElements, m as generateIdempotencyKey } from './index-BpyFcJVv.js';
-import './payment-DnU_eLuT.js';
+export { A as AuthService, B as BusinessService, j as CartOperations, b as CatalogueQueries, l as CheckoutOperations, l as CheckoutService, a6 as CimplifyElement, a5 as CimplifyElements, aa as ELEMENT_TYPES, a9 as EVENT_TYPES, ae as ElementEventType, ac as ElementOptions, ad as ElementType, ab as ElementsOptions, F as FetchQuoteInput, r as FxService, G as GetProductsOptions, I as InventoryService, L as LinkService, q as LiteService, a8 as MESSAGE_TYPES, O as OrderQueries, P as PriceQuote, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, f as QuoteDynamicBuckets, e as QuoteStatus, g as QuoteUiMessage, R as RefreshQuoteInput, i as RefreshQuoteResult, p as SchedulingService, a7 as createElements } from './client-lvLvB1_K.js';
+import './payment-DA1i5hhk.js';
+
+declare function generateIdempotencyKey(prefix?: string): string;
+
+export { generateIdempotencyKey };

package/dist/advanced.js

@@ -1,83 +1,83 @@
 'use strict';
 
-var chunk2CGA3MUW_js = require('./chunk-2CGA3MUW.js');
-require('./chunk-PEDLCL72.js');
+var chunkHKVRUGM6_js = require('./chunk-HKVRUGM6.js');
+require('./chunk-V2O5AO7I.js');
 
 
 
 Object.defineProperty(exports, "AuthService", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.AuthService; }
+  get: function () { return chunkHKVRUGM6_js.AuthService; }
 });
 Object.defineProperty(exports, "BusinessService", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.BusinessService; }
+  get: function () { return chunkHKVRUGM6_js.BusinessService; }
 });
 Object.defineProperty(exports, "CartOperations", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.CartOperations; }
+  get: function () { return chunkHKVRUGM6_js.CartOperations; }
 });
 Object.defineProperty(exports, "CatalogueQueries", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.CatalogueQueries; }
+  get: function () { return chunkHKVRUGM6_js.CatalogueQueries; }
 });
 Object.defineProperty(exports, "CheckoutOperations", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.CheckoutService; }
+  get: function () { return chunkHKVRUGM6_js.CheckoutService; }
 });
 Object.defineProperty(exports, "CheckoutService", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.CheckoutService; }
+  get: function () { return chunkHKVRUGM6_js.CheckoutService; }
 });
 Object.defineProperty(exports, "CimplifyElement", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.CimplifyElement; }
+  get: function () { return chunkHKVRUGM6_js.CimplifyElement; }
 });
 Object.defineProperty(exports, "CimplifyElements", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.CimplifyElements; }
+  get: function () { return chunkHKVRUGM6_js.CimplifyElements; }
 });
 Object.defineProperty(exports, "ELEMENT_TYPES", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.ELEMENT_TYPES; }
+  get: function () { return chunkHKVRUGM6_js.ELEMENT_TYPES; }
 });
 Object.defineProperty(exports, "EVENT_TYPES", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.EVENT_TYPES; }
+  get: function () { return chunkHKVRUGM6_js.EVENT_TYPES; }
 });
 Object.defineProperty(exports, "FxService", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.FxService; }
+  get: function () { return chunkHKVRUGM6_js.FxService; }
 });
 Object.defineProperty(exports, "InventoryService", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.InventoryService; }
+  get: function () { return chunkHKVRUGM6_js.InventoryService; }
 });
 Object.defineProperty(exports, "LinkService", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.LinkService; }
+  get: function () { return chunkHKVRUGM6_js.LinkService; }
 });
 Object.defineProperty(exports, "LiteService", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.LiteService; }
+  get: function () { return chunkHKVRUGM6_js.LiteService; }
 });
 Object.defineProperty(exports, "MESSAGE_TYPES", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.MESSAGE_TYPES; }
+  get: function () { return chunkHKVRUGM6_js.MESSAGE_TYPES; }
 });
 Object.defineProperty(exports, "OrderQueries", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.OrderQueries; }
+  get: function () { return chunkHKVRUGM6_js.OrderQueries; }
 });
 Object.defineProperty(exports, "SchedulingService", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.SchedulingService; }
+  get: function () { return chunkHKVRUGM6_js.SchedulingService; }
 });
 Object.defineProperty(exports, "createElements", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.createElements; }
+  get: function () { return chunkHKVRUGM6_js.createElements; }
 });
 Object.defineProperty(exports, "generateIdempotencyKey", {
   enumerable: true,
-  get: function () { return chunk2CGA3MUW_js.generateIdempotencyKey; }
+  get: function () { return chunkHKVRUGM6_js.generateIdempotencyKey; }
 });

package/dist/advanced.mjs

@@ -1,2 +1,2 @@
-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-3J4PPSMI.mjs';
-import './chunk-E3HC2YAE.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-TFHKVQLL.mjs';
+import './chunk-6TVQQYQ5.mjs';

package/dist/{chunk-46BDUSJX.mjs → chunk-2X6P5WJZ.mjs}

@@ -1,5 +1,5 @@
-import { safe, CatalogueQueries, CartOperations, CheckoutService, OrderQueries, LinkService, AuthService, BusinessService, InventoryService, SchedulingService, LiteService, FxService, createElements } from './chunk-3J4PPSMI.mjs';
-import { CimplifyError, ErrorCode, enrichError } from './chunk-E3HC2YAE.mjs';
+import { safe, generateIdempotencyKey, CatalogueQueries, CartOperations, CheckoutService, OrderQueries, LinkService, AuthService, BusinessService, InventoryService, SchedulingService, LiteService, FxService, createElements } from './chunk-TFHKVQLL.mjs';
+import { CimplifyError, ErrorCode, IdempotencyMismatchError, enrichError } from './chunk-6TVQQYQ5.mjs';
 
 // src/activity.ts
 var ActivityService = class {
@@ -66,12 +66,15 @@ var SubscriptionService = class {
     const encodedId = encodeURIComponent(id);
     return safe(this.client.get(`/api/v1/subscriptions/${encodedId}`));
   }
-  async cancel(id, reason) {
+  async cancel(id, reason, opts) {
     const encodedId = encodeURIComponent(id);
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post(`/api/v1/subscriptions/${encodedId}/cancel`, {
-        reason
-      })
+      this.client.post(
+        `/api/v1/subscriptions/${encodedId}/cancel`,
+        { reason },
+        { idempotencyKey }
+      )
     );
   }
   async pause(id) {
@@ -86,10 +89,15 @@ var SubscriptionService = class {
       this.client.post(`/api/v1/subscriptions/${encodedId}/resume`)
     );
   }
-  async skipNextRenewal(id) {
+  async skipNextRenewal(id, opts) {
     const encodedId = encodeURIComponent(id);
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post(`/api/v1/subscriptions/${encodedId}/skip`)
+      this.client.post(
+        `/api/v1/subscriptions/${encodedId}/skip`,
+        void 0,
+        { idempotencyKey }
+      )
     );
   }
 };
@@ -99,13 +107,18 @@ var UploadService = class {
   constructor(client) {
     this.client = client;
   }
-  async init(filename, contentType, sizeBytes) {
+  async init(filename, contentType, sizeBytes, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post("/api/v1/uploads/init", {
-        filename,
-        content_type: contentType,
-        size_bytes: sizeBytes
-      })
+      this.client.post(
+        "/api/v1/uploads/init",
+        {
+          filename,
+          content_type: contentType,
+          size_bytes: sizeBytes
+        },
+        { idempotencyKey }
+      )
     );
   }
   async confirm(uploadId) {
@@ -194,17 +207,23 @@ var SupportService = class {
     this.client = client;
   }
   /** Open (or resume) the customer's widget conversation. */
-  async openConversation() {
+  async openConversation(opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post("/api/v1/support/conversation")
+      this.client.post("/api/v1/support/conversation", void 0, {
+        idempotencyKey
+      })
     );
   }
   /** Send a message in the active conversation. */
-  async sendMessage(content) {
+  async sendMessage(content, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post("/api/v1/support/conversation/messages", {
-        content
-      })
+      this.client.post(
+        "/api/v1/support/conversation/messages",
+        { content },
+        { idempotencyKey }
+      )
     );
   }
   /** Poll for new messages since the given cursor. */
@@ -218,6 +237,39 @@ var SupportService = class {
   }
 };
 
+// src/internal/events.ts
+function createClientEvents() {
+  const listeners = /* @__PURE__ */ new Map();
+  return {
+    on(name, listener) {
+      let set = listeners.get(name);
+      if (!set) {
+        set = /* @__PURE__ */ new Set();
+        listeners.set(name, set);
+      }
+      set.add(listener);
+      return () => {
+        set?.delete(listener);
+      };
+    },
+    off(name, listener) {
+      listeners.get(name)?.delete(listener);
+    },
+    emit(name, payload) {
+      const set = listeners.get(name);
+      if (!set) return;
+      const snapshot = Array.from(set);
+      for (const listener of snapshot) {
+        try {
+          listener(payload);
+        } catch (err) {
+          console.error(`[Cimplify] event listener for "${name}" threw:`, err);
+        }
+      }
+    }
+  };
+}
+
 // src/client.ts
 var ACCESS_TOKEN_STORAGE_KEY = "cimplify_access_token";
 var SESSION_TOKEN_STORAGE_KEY = "cimplify_session_token";
@@ -230,6 +282,19 @@ var DEFAULT_RETRY_DELAY_MS = 1e3;
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function mergeOptionHeaders(base, opts) {
+  if (!opts) return base;
+  const merged = { ...base };
+  if (opts.headers) {
+    for (const [k, v] of Object.entries(opts.headers)) {
+      merged[k] = v;
+    }
+  }
+  if (opts.idempotencyKey) {
+    merged["Idempotency-Key"] = opts.idempotencyKey;
+  }
+  return merged;
+}
 function isRetryable(error) {
   if (error instanceof TypeError && error.message.includes("fetch")) {
     return true;
@@ -310,6 +375,13 @@ var CimplifyClient = class {
     this.businessId = null;
     this.businessIdResolvePromise = null;
     this.inflightRequests = /* @__PURE__ */ new Map();
+    /**
+     * App-level event channel. Subscribe to surface mutation rollbacks, outbox
+     * activity, and dead-letter notifications to consumer code (toasts,
+     * Sentry, analytics, etc.). The SDK emits but never auto-consumes — the
+     * consumer decides how to react.
+     */
+    this.events = createClientEvents();
     this.publicKey = config.publicKey || getEnvPublicKey() || "";
     const urls = deriveUrls();
     this.baseUrl = config.baseUrl ? normalizeUrl(config.baseUrl) : urls.baseUrl;
@@ -537,7 +609,7 @@ var CimplifyClient = class {
           });
           return response;
         }
-        if (response.status === 429 && attempt < this.maxRetries) {
+        if ((response.status === 429 || response.status === 503) && attempt < this.maxRetries) {
           retryCount++;
           const retryAfter = response.headers.get("Retry-After");
           const delay = retryAfter ? Math.min(parseInt(retryAfter, 10) * 1e3, 3e4) || this.retryDelay * Math.pow(2, attempt) : this.retryDelay * Math.pow(2, attempt);
@@ -545,7 +617,7 @@ var CimplifyClient = class {
             ...context,
             attempt: retryCount,
             delayMs: delay,
-            error: new Error(`Rate limited: ${response.status}`)
+            error: new Error(`Retryable: ${response.status}`)
           });
           await sleep(delay);
           continue;
@@ -650,29 +722,29 @@ var CimplifyClient = class {
       return this.handleRestResponse(response);
     });
   }
-  async post(path, body) {
+  async post(path, body, opts) {
     const response = await this.resilientFetch(this.buildUrl(this.baseUrl, path), {
       method: "POST",
       credentials: this.credentials,
-      headers: this.getHeaders(),
+      headers: mergeOptionHeaders(this.getHeaders(), opts),
       body: body ? JSON.stringify(body) : void 0
     });
     return this.handleRestResponse(response);
   }
-  async patch(path, body) {
+  async patch(path, body, opts) {
     const response = await this.resilientFetch(this.buildUrl(this.baseUrl, path), {
       method: "PATCH",
       credentials: this.credentials,
-      headers: this.getHeaders(),
+      headers: mergeOptionHeaders(this.getHeaders(), opts),
       body: body ? JSON.stringify(body) : void 0
     });
     return this.handleRestResponse(response);
   }
-  async delete(path) {
+  async delete(path, opts) {
     const response = await this.resilientFetch(this.buildUrl(this.baseUrl, path), {
       method: "DELETE",
       credentials: this.credentials,
-      headers: this.getHeaders()
+      headers: mergeOptionHeaders(this.getHeaders(), opts)
     });
     return this.handleRestResponse(response);
   }
@@ -687,20 +759,20 @@ var CimplifyClient = class {
       return this.handleRestResponse(response);
     });
   }
-  async linkPost(path, body) {
+  async linkPost(path, body, opts) {
     const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
       method: "POST",
       credentials: this.credentials,
-      headers: this.getHeaders(),
+      headers: mergeOptionHeaders(this.getHeaders(), opts),
       body: body ? JSON.stringify(body) : void 0
     });
     return this.handleRestResponse(response);
   }
-  async linkDelete(path) {
+  async linkDelete(path, opts) {
     const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
       method: "DELETE",
       credentials: this.credentials,
-      headers: this.getHeaders()
+      headers: mergeOptionHeaders(this.getHeaders(), opts)
     });
     return this.handleRestResponse(response);
   }
@@ -710,6 +782,10 @@ var CimplifyClient = class {
       const errorCode = typeof json.error === "object" && json.error?.error_code || typeof json.error === "object" && json.error?.code || "API_ERROR";
       const errorMessage = typeof json.error === "object" && json.error?.error_message || typeof json.error === "object" && json.error?.message || typeof json.error === "string" && json.error || typeof json.message === "string" && json.message || "An error occurred";
       const retryable = typeof json.error === "object" && typeof json.error?.retryable === "boolean" ? json.error.retryable : false;
+      if (errorCode === "IDEMPOTENCY_MISMATCH") {
+        const originalCreatedAt = typeof json.error === "object" && json.error?.original_created_at || "";
+        throw new IdempotencyMismatchError(errorMessage, originalCreatedAt);
+      }
       const error = enrichError(
         new CimplifyError(
           errorCode,

package/dist/{chunk-E3HC2YAE.mjs → chunk-6TVQQYQ5.mjs}

@@ -183,13 +183,26 @@ var CimplifyError = class extends Error {
     return this.message;
   }
 };
+var IdempotencyMismatchError = class extends CimplifyError {
+  constructor(message, originalCreatedAt) {
+    super("IDEMPOTENCY_MISMATCH", message, false);
+    this.originalCreatedAt = originalCreatedAt;
+    this.name = "IdempotencyMismatchError";
+  }
+};
 function isCimplifyError(error) {
   return error instanceof CimplifyError;
 }
+function isIdempotencyMismatchError(error) {
+  return error instanceof IdempotencyMismatchError;
+}
 function getErrorHint(code) {
   return ERROR_HINTS[code];
 }
 function enrichError(error, options = {}) {
+  if (error instanceof IdempotencyMismatchError) {
+    return error;
+  }
   const hint = getErrorHint(error.code);
   const docsUrl = error.docs_url || hint?.docs_url || docsUrlForCode(error.code || ErrorCode.UNKNOWN_ERROR);
   const suggestion = error.suggestion || hint?.suggestion;
@@ -695,4 +708,4 @@ function detectMobileMoneyProvider(phoneNumber) {
   return null;
 }
 
-export { CURRENCY_SYMBOLS, CimplifyError, ERROR_HINTS, ErrorCode, MOBILE_MONEY_PROVIDERS, ZERO, categorizePaymentError, currencyCode, detectMobileMoneyProvider, enrichError, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatPriceRange, formatPriceWithTax, formatProductPrice, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getErrorHint, getMarkupPercentage, getPriceRange, getProductCurrency, getTaxAmount, getUnitPriceAtQuantity, hasTaxInfo, isCimplifyError, isOnSale, isPaymentStatusFailure, isPaymentStatusRequiresAction, isPaymentStatusSuccess, isRetryableError, isSupportedCurrency, isTaxInclusive, money, moneyFromNumber, normalizePaymentResponse, normalizeStatusResponse, parsePrice };
+export { CURRENCY_SYMBOLS, CimplifyError, ERROR_HINTS, ErrorCode, IdempotencyMismatchError, MOBILE_MONEY_PROVIDERS, ZERO, categorizePaymentError, currencyCode, detectMobileMoneyProvider, enrichError, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatPriceRange, formatPriceWithTax, formatProductPrice, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getErrorHint, getMarkupPercentage, getPriceRange, getProductCurrency, getTaxAmount, getUnitPriceAtQuantity, hasTaxInfo, isCimplifyError, isIdempotencyMismatchError, isOnSale, isPaymentStatusFailure, isPaymentStatusRequiresAction, isPaymentStatusSuccess, isRetryableError, isSupportedCurrency, isTaxInclusive, money, moneyFromNumber, normalizePaymentResponse, normalizeStatusResponse, parsePrice };