@cimplify/sdk 0.31.0 → 0.35.0

package/dist/{chunk-2CGA3MUW.js → chunk-HKVRUGM6.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkPEDLCL72_js = require('./chunk-PEDLCL72.js');
+var chunkV2O5AO7I_js = require('./chunk-V2O5AO7I.js');
 
 // src/types/result.ts
 function ok(value) {
@@ -72,13 +72,23 @@ 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 chunkPEDLCL72_js.CimplifyError) return chunkPEDLCL72_js.enrichError(error);
+  if (error instanceof chunkV2O5AO7I_js.CimplifyError) return chunkV2O5AO7I_js.enrichError(error);
   if (error instanceof Error) {
-    return chunkPEDLCL72_js.enrichError(new chunkPEDLCL72_js.CimplifyError(chunkPEDLCL72_js.ErrorCode.UNKNOWN_ERROR, error.message, false));
+    return chunkV2O5AO7I_js.enrichError(new chunkV2O5AO7I_js.CimplifyError(chunkV2O5AO7I_js.ErrorCode.UNKNOWN_ERROR, error.message, false));
   }
-  return chunkPEDLCL72_js.enrichError(new chunkPEDLCL72_js.CimplifyError(chunkPEDLCL72_js.ErrorCode.UNKNOWN_ERROR, String(error), false));
+  return chunkV2O5AO7I_js.enrichError(new chunkV2O5AO7I_js.CimplifyError(chunkV2O5AO7I_js.ErrorCode.UNKNOWN_ERROR, String(error), false));
 }
 async function safe(promise) {
   try {
@@ -400,8 +410,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);
@@ -594,22 +607,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() {
@@ -635,15 +637,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 chunkV2O5AO7I_js.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);
@@ -660,11 +670,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() {
@@ -1071,7 +1084,7 @@ var CheckoutResolver = class {
           }
         }
       }
-      if (checkoutResult.requires_authorization || chunkPEDLCL72_js.isPaymentStatusRequiresAction(checkoutResult.payment_status)) {
+      if (checkoutResult.requires_authorization || chunkV2O5AO7I_js.isPaymentStatusRequiresAction(checkoutResult.payment_status)) {
         const authorization = await this.handleAuthorization({
           authorizationType,
           paymentReference,
@@ -1245,18 +1258,18 @@ var CheckoutResolver = class {
       if (statusResult.value.reference) {
         paymentReference = statusResult.value.reference;
       }
-      const normalized = chunkPEDLCL72_js.normalizeStatusResponse(statusResult.value);
-      if (normalized.paid || chunkPEDLCL72_js.isPaymentStatusSuccess(normalized.status)) {
+      const normalized = chunkV2O5AO7I_js.normalizeStatusResponse(statusResult.value);
+      if (normalized.paid || chunkV2O5AO7I_js.isPaymentStatusSuccess(normalized.status)) {
         return this.finalizeSuccess(latestCheckoutResult);
       }
-      if (chunkPEDLCL72_js.isPaymentStatusFailure(normalized.status)) {
+      if (chunkV2O5AO7I_js.isPaymentStatusFailure(normalized.status)) {
         return this.fail(
           normalized.status ? normalized.status.toUpperCase() : "PAYMENT_FAILED",
           normalized.message || "Payment failed during confirmation.",
           false
         );
       }
-      if (chunkPEDLCL72_js.isPaymentStatusRequiresAction(normalized.status)) {
+      if (chunkV2O5AO7I_js.isPaymentStatusRequiresAction(normalized.status)) {
         const authorization = await this.handleAuthorization({
           authorizationType,
           paymentReference,
@@ -1287,8 +1300,8 @@ var CheckoutResolver = class {
     try {
       const finalResult = await this.client.checkout.pollPaymentStatus(input.orderId);
       if (finalResult.ok) {
-        const normalized = chunkPEDLCL72_js.normalizeStatusResponse(finalResult.value);
-        if (normalized.paid || chunkPEDLCL72_js.isPaymentStatusSuccess(normalized.status)) {
+        const normalized = chunkV2O5AO7I_js.normalizeStatusResponse(finalResult.value);
+        if (normalized.paid || chunkV2O5AO7I_js.isPaymentStatusSuccess(normalized.status)) {
           return this.finalizeSuccess(latestCheckoutResult);
         }
       }
@@ -1484,12 +1497,12 @@ var CheckoutResolver = class {
     };
   }
   isSuccessfulStatus(status) {
-    const normalized = chunkPEDLCL72_js.normalizeStatusResponse({ status, paid: false });
-    return normalized.paid || chunkPEDLCL72_js.isPaymentStatusSuccess(normalized.status);
+    const normalized = chunkV2O5AO7I_js.normalizeStatusResponse({ status, paid: false });
+    return normalized.paid || chunkV2O5AO7I_js.isPaymentStatusSuccess(normalized.status);
   }
   isFailureStatus(status) {
-    const normalized = chunkPEDLCL72_js.normalizeStatusResponse({ status, paid: false });
-    return chunkPEDLCL72_js.isPaymentStatusFailure(normalized.status);
+    const normalized = chunkV2O5AO7I_js.normalizeStatusResponse({ status, paid: false });
+    return chunkV2O5AO7I_js.isPaymentStatusFailure(normalized.status);
   }
   ensureNotAborted() {
     if (this.signal?.aborted) {
@@ -1527,14 +1540,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;
@@ -1560,7 +1565,7 @@ var CheckoutService = class {
   }
   async initializePayment(_orderId, _method) {
     return err(
-      new chunkPEDLCL72_js.CimplifyError(
+      new chunkV2O5AO7I_js.CimplifyError(
         "NOT_IMPLEMENTED",
         "initializePayment is not available in REST mode.",
         false
@@ -1632,11 +1637,11 @@ var CheckoutService = class {
       pay_currency: data.pay_currency,
       fx_quote_id: data.fx_quote_id
     };
-    const baseCurrency = chunkPEDLCL72_js.currencyCode(
+    const baseCurrency = chunkV2O5AO7I_js.currencyCode(
       (cart.pricing.currency || checkoutData.pay_currency || "GHS").toUpperCase()
     );
     const payCurrency = data.pay_currency?.trim().toUpperCase();
-    const payCurrencyCode = payCurrency ? chunkPEDLCL72_js.currencyCode(payCurrency) : void 0;
+    const payCurrencyCode = payCurrency ? chunkV2O5AO7I_js.currencyCode(payCurrency) : void 0;
     const cartTotalAmount = typeof cart.pricing.total_price === "number" ? cart.pricing.total_price : Number.parseFloat(cart.pricing.total_price || "0");
     if (payCurrencyCode && payCurrencyCode !== baseCurrency && !checkoutData.fx_quote_id && Number.isFinite(cartTotalAmount) && cartTotalAmount > 0) {
       const fxQuoteResult = await this.client.fx.lockQuote({
@@ -1715,13 +1720,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 }
+      )
     );
   }
 };
@@ -1766,12 +1774,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);
@@ -1800,20 +1812,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) {
@@ -1843,11 +1868,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 }
       )
     );
   }
@@ -1872,10 +1899,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 }
       )
     );
   }
@@ -1908,24 +1938,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));
@@ -1959,7 +1999,7 @@ var BusinessService = class {
     if (!result.ok) return err(result.error);
     const location = result.value.find((item) => item.id === locationId);
     if (!location) {
-      return err(new chunkPEDLCL72_js.CimplifyError(chunkPEDLCL72_js.ErrorCode.NOT_FOUND, `Location not found: ${locationId}`, false));
+      return err(new chunkV2O5AO7I_js.CimplifyError(chunkV2O5AO7I_js.ErrorCode.NOT_FOUND, `Location not found: ${locationId}`, false));
     }
     return ok(location);
   }
@@ -2120,17 +2160,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) {
@@ -2140,7 +2188,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({
@@ -2148,7 +2196,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);
   }
 };
 
@@ -2182,8 +2230,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 })
+    );
   }
 };
 
@@ -2234,7 +2285,7 @@ var EVENT_TYPES = {
 
 // src/elements.ts
 function toCheckoutError(code, message, recoverable) {
-  const hint = chunkPEDLCL72_js.getErrorHint(code);
+  const hint = chunkV2O5AO7I_js.getErrorHint(code);
   return {
     success: false,
     error: {