@cimplify/sdk 0.31.0 → 0.36.0

package/dist/{chunk-3J4PPSMI.mjs → chunk-TFHKVQLL.mjs}

@@ -1,4 +1,4 @@
-import { CimplifyError, currencyCode, ErrorCode, enrichError, isPaymentStatusRequiresAction, normalizeStatusResponse, isPaymentStatusSuccess, isPaymentStatusFailure, getErrorHint } from './chunk-E3HC2YAE.mjs';
+import { CimplifyError, currencyCode, ErrorCode, enrichError, isPaymentStatusRequiresAction, normalizeStatusResponse, isPaymentStatusSuccess, isPaymentStatusFailure, getErrorHint } from './chunk-6TVQQYQ5.mjs';
 
 // src/types/result.ts
 function ok(value) {
@@ -70,6 +70,16 @@ function combineObject(results) {
   return ok(values);
 }
 
+// src/internal/idempotency.ts
+function generateIdempotencyKey(prefix = "idem") {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return `${prefix}_${crypto.randomUUID()}`;
+  }
+  const timestamp = Date.now().toString(36);
+  const random = Math.random().toString(36).substring(2, 15);
+  return `${prefix}_${timestamp}_${random}`;
+}
+
 // src/internal/safe.ts
 function toCimplifyError(error) {
   if (error instanceof CimplifyError) return enrichError(error);
@@ -398,8 +408,11 @@ var CatalogueQueries = class {
       )
     );
   }
-  async fetchQuote(input) {
-    return safe(this.client.post("/api/v1/catalogue/quotes", input));
+  async fetchQuote(input, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
+    return safe(
+      this.client.post("/api/v1/catalogue/quotes", input, { idempotencyKey })
+    );
   }
   async getQuote(quoteId) {
     const encodedQuoteId = encodeURIComponent(quoteId);
@@ -592,22 +605,11 @@ function lineItemToCartInput(item) {
   }
   return input;
 }
-function isUICartResponse(value) {
-  return "cart" in value;
-}
-function unwrapEnrichedCart(value) {
-  return isUICartResponse(value) ? value.cart : value;
-}
 var CartOperations = class {
   constructor(client) {
     this.client = client;
   }
   async get() {
-    const result = await safe(this.client.get("/api/v1/cart"));
-    if (!result.ok) return result;
-    return ok(unwrapEnrichedCart(result.value));
-  }
-  async getRaw() {
     return safe(this.client.get("/api/v1/cart"));
   }
   async getItems() {
@@ -633,15 +635,23 @@ var CartOperations = class {
       currency: cart.pricing.currency
     });
   }
-  async addItem(input) {
-    return safe(this.client.post("/api/v1/cart/items", input));
+  async addItem(input, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
+    return safe(
+      this.client.post("/api/v1/cart/items", input, { idempotencyKey })
+    );
   }
   async updateItem(cartItemId, updates) {
-    if (typeof updates.quantity === "number") {
-      return this.updateQuantity(cartItemId, updates.quantity);
+    if (typeof updates.quantity !== "number") {
+      return {
+        ok: false,
+        error: new CimplifyError(
+          "VALIDATION_ERROR",
+          "updateItem requires a quantity; richer mid-cart edits are not supported"
+        )
+      };
     }
-    const encodedId = encodeURIComponent(cartItemId);
-    return safe(this.client.patch(`/api/v1/cart/items/${encodedId}`, updates));
+    return this.updateQuantity(cartItemId, updates.quantity);
   }
   async updateQuantity(cartItemId, quantity) {
     const encodedId = encodeURIComponent(cartItemId);
@@ -658,11 +668,14 @@ var CartOperations = class {
   async clear() {
     return safe(this.client.delete("/api/v1/cart"));
   }
-  async applyCoupon(code) {
+  async applyCoupon(code, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post("/api/v1/cart/coupons", {
-        coupon_code: code
-      })
+      this.client.post(
+        "/api/v1/cart/coupons",
+        { coupon_code: code },
+        { idempotencyKey }
+      )
     );
   }
   async removeCoupon() {
@@ -1525,14 +1538,6 @@ function toTerminalFailure(code, message, recoverable) {
     }
   };
 }
-function generateIdempotencyKey() {
-  if (typeof crypto !== "undefined" && crypto.randomUUID) {
-    return `idem_${crypto.randomUUID()}`;
-  }
-  const timestamp = Date.now().toString(36);
-  const random = Math.random().toString(36).substring(2, 15);
-  return `idem_${timestamp}_${random}`;
-}
 var CheckoutService = class {
   constructor(client) {
     this.client = client;
@@ -1713,13 +1718,16 @@ var OrderQueries = class {
   async getByStatus(status) {
     return this.list({ status });
   }
-  async cancel(orderId, reason) {
+  async cancel(orderId, reason, opts) {
     const encodedId = encodeURIComponent(orderId);
     const tokenParam = this.orderTokenParam(orderId);
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post(`/api/v1/orders/${encodedId}/cancel${tokenParam}`, {
-        reason
-      })
+      this.client.post(
+        `/api/v1/orders/${encodedId}/cancel${tokenParam}`,
+        { reason },
+        { idempotencyKey }
+      )
     );
   }
 };
@@ -1764,12 +1772,16 @@ var LinkService = class {
   async getProfile() {
     return safe(this.client.linkGet("/v1/link/profile"));
   }
-  async requestOtp(input) {
-    return safe(this.client.linkPost("/v1/link/auth/request-otp", input));
+  async requestOtp(input, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
+    return safe(
+      this.client.linkPost("/v1/link/auth/request-otp", input, { idempotencyKey })
+    );
   }
-  async verifyOtp(input) {
+  async verifyOtp(input, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     const result = await safe(
-      this.client.linkPost("/v1/link/auth/verify-otp", input)
+      this.client.linkPost("/v1/link/auth/verify-otp", input, { idempotencyKey })
     );
     if (result.ok && result.value.session_token) {
       this.client.setAccessToken(result.value.session_token);
@@ -1798,20 +1810,33 @@ var LinkService = class {
   async getPreferences() {
     return safe(this.client.linkGet("/v1/link/preferences"));
   }
-  async enroll(data) {
-    return safe(this.client.linkPost("/v1/link/enroll", data));
+  async enroll(data, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
+    return safe(
+      this.client.linkPost("/v1/link/enroll", data, { idempotencyKey })
+    );
   }
-  async enrollAndLinkOrder(data) {
+  async enrollAndLinkOrder(data, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.linkPost("/v1/link/enroll-and-link-order", data)
+      this.client.linkPost(
+        "/v1/link/enroll-and-link-order",
+        data,
+        { idempotencyKey }
+      )
     );
   }
   async updatePreferences(preferences) {
     return safe(this.client.linkPost("/v1/link/preferences", preferences));
   }
-  async createAddress(input) {
+  async createAddress(input, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.linkPost("/v1/link/addresses", toCreateAddressPayload(input))
+      this.client.linkPost(
+        "/v1/link/addresses",
+        toCreateAddressPayload(input),
+        { idempotencyKey }
+      )
     );
   }
   async updateAddress(input) {
@@ -1841,11 +1866,13 @@ var LinkService = class {
       )
     );
   }
-  async createMobileMoney(input) {
+  async createMobileMoney(input, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
       this.client.linkPost(
         "/v1/link/mobile-money",
-        toCreateMobileMoneyPayload(input)
+        toCreateMobileMoneyPayload(input),
+        { idempotencyKey }
       )
     );
   }
@@ -1870,10 +1897,13 @@ var LinkService = class {
       )
     );
   }
-  async verifyMobileMoney(mobileMoneyId) {
+  async verifyMobileMoney(mobileMoneyId, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
       this.client.linkPost(
-        `/v1/link/mobile-money/${encodePathSegment(mobileMoneyId)}/verify`
+        `/v1/link/mobile-money/${encodePathSegment(mobileMoneyId)}/verify`,
+        void 0,
+        { idempotencyKey }
       )
     );
   }
@@ -1906,24 +1936,34 @@ var AuthService = class {
     if (!result.ok) return result;
     return ok(result.value.is_authenticated);
   }
-  async requestOtp(contact, contactType) {
+  async requestOtp(contact, contactType, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post("/api/v1/auth/request-otp", {
-        contact,
-        contact_type: contactType
-      })
+      this.client.post(
+        "/api/v1/auth/request-otp",
+        { contact, contact_type: contactType },
+        { idempotencyKey }
+      )
     );
   }
-  async verifyOtp(code, contact) {
-    return safe(
-      this.client.post("/api/v1/auth/verify-otp", {
-        otp_code: code,
-        contact
-      })
+  async verifyOtp(code, contact, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
+    const result = await safe(
+      this.client.post(
+        "/api/v1/auth/verify-otp",
+        { otp_code: code, contact },
+        { idempotencyKey }
+      )
     );
+    if (result.ok && result.value.session_token) {
+      this.client.setAccessToken(result.value.session_token);
+    }
+    return result;
   }
   async logout() {
-    return safe(this.client.post("/api/v1/auth/logout"));
+    const result = await safe(this.client.post("/api/v1/auth/logout"));
+    this.client.clearSession();
+    return result;
   }
   async updateProfile(input) {
     return safe(this.client.post("/api/v1/auth/profile", input));
@@ -2118,17 +2158,25 @@ var SchedulingService = class {
     const past = result.value.filter((booking) => String(booking.status).toLowerCase() === "completed").sort((a, b) => firstScheduledTime(b).localeCompare(firstScheduledTime(a))).slice(0, Math.max(0, limit));
     return ok(past);
   }
-  async cancelBooking(input) {
+  async cancelBooking(input, opts) {
     const encodedId = encodeURIComponent(input.booking_id);
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post(`/api/v1/scheduling/bookings/${encodedId}/cancel`, {
-        reason: input.reason
-      })
+      this.client.post(
+        `/api/v1/scheduling/bookings/${encodedId}/cancel`,
+        { reason: input.reason },
+        { idempotencyKey }
+      )
     );
   }
-  async rescheduleBooking(input) {
+  async rescheduleBooking(input, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
     return safe(
-      this.client.post("/api/v1/scheduling/bookings/reschedule", input)
+      this.client.post(
+        "/api/v1/scheduling/bookings/reschedule",
+        input,
+        { idempotencyKey }
+      )
     );
   }
   async getNextAvailableSlot(serviceId, fromDate) {
@@ -2138,7 +2186,7 @@ var SchedulingService = class {
       date
     });
     if (!result.ok) return result;
-    return ok(result.value.find((slot) => slot.is_available) || null);
+    return ok(result.value[0] ?? null);
   }
   async hasAvailabilityOn(serviceId, date) {
     const result = await this.getAvailableSlots({
@@ -2146,7 +2194,7 @@ var SchedulingService = class {
       date
     });
     if (!result.ok) return result;
-    return ok(result.value.some((slot) => slot.is_available));
+    return ok(result.value.length > 0);
   }
 };
 
@@ -2180,8 +2228,11 @@ var FxService = class {
     const path = `/api/v1/fx/rate?from=${encodeURIComponent(from)}&to=${encodeURIComponent(to)}`;
     return safe(this.client.get(path));
   }
-  async lockQuote(request) {
-    return safe(this.client.post("/api/v1/fx/quotes", request));
+  async lockQuote(request, opts) {
+    const idempotencyKey = opts?.idempotencyKey ?? generateIdempotencyKey();
+    return safe(
+      this.client.post("/api/v1/fx/quotes", request, { idempotencyKey })
+    );
   }
 };
 

package/dist/{chunk-PEDLCL72.js → chunk-V2O5AO7I.js}

@@ -185,13 +185,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;
@@ -701,6 +714,7 @@ exports.CURRENCY_SYMBOLS = CURRENCY_SYMBOLS;
 exports.CimplifyError = CimplifyError;
 exports.ERROR_HINTS = ERROR_HINTS;
 exports.ErrorCode = ErrorCode;
+exports.IdempotencyMismatchError = IdempotencyMismatchError;
 exports.MOBILE_MONEY_PROVIDERS = MOBILE_MONEY_PROVIDERS;
 exports.ZERO = ZERO;
 exports.categorizePaymentError = categorizePaymentError;
@@ -727,6 +741,7 @@ exports.getTaxAmount = getTaxAmount;
 exports.getUnitPriceAtQuantity = getUnitPriceAtQuantity;
 exports.hasTaxInfo = hasTaxInfo;
 exports.isCimplifyError = isCimplifyError;
+exports.isIdempotencyMismatchError = isIdempotencyMismatchError;
 exports.isOnSale = isOnSale;
 exports.isPaymentStatusFailure = isPaymentStatusFailure;
 exports.isPaymentStatusRequiresAction = isPaymentStatusRequiresAction;