@cimplify/sdk 0.9.10 → 0.10.0

package/dist/index.js

@@ -2,12 +2,12 @@
 
 // src/types/common.ts
 function money(value) {
-  return value;
+  return typeof value === "string" ? parseFloat(value) || 0 : value;
 }
 function moneyFromNumber(value) {
-  return value.toFixed(2);
+  return value;
 }
-var ZERO = "0.00";
+var ZERO = 0;
 var SUPPORTED_CURRENCY_CODES = /* @__PURE__ */ new Set([
   "USD",
   "EUR",
@@ -65,7 +65,6 @@ function currencyCode(value) {
   return value;
 }
 var ErrorCode = {
-  // General
   UNKNOWN_ERROR: "UNKNOWN_ERROR",
   NETWORK_ERROR: "NETWORK_ERROR",
   TIMEOUT: "TIMEOUT",
@@ -73,7 +72,6 @@ var ErrorCode = {
   FORBIDDEN: "FORBIDDEN",
   NOT_FOUND: "NOT_FOUND",
   VALIDATION_ERROR: "VALIDATION_ERROR",
-  // Cart
   CART_EMPTY: "CART_EMPTY",
   CART_EXPIRED: "CART_EXPIRED",
   CART_NOT_FOUND: "CART_NOT_FOUND",
@@ -82,16 +80,13 @@ var ErrorCode = {
   VARIANT_OUT_OF_STOCK: "VARIANT_OUT_OF_STOCK",
   ADDON_REQUIRED: "ADDON_REQUIRED",
   ADDON_MAX_EXCEEDED: "ADDON_MAX_EXCEEDED",
-  // Checkout
   CHECKOUT_VALIDATION_FAILED: "CHECKOUT_VALIDATION_FAILED",
   DELIVERY_ADDRESS_REQUIRED: "DELIVERY_ADDRESS_REQUIRED",
   CUSTOMER_INFO_REQUIRED: "CUSTOMER_INFO_REQUIRED",
-  // Quote
   QUOTE_NOT_FOUND: "QUOTE_NOT_FOUND",
   QUOTE_EXPIRED: "QUOTE_EXPIRED",
   QUOTE_CONSUMED: "QUOTE_CONSUMED",
   QUOTE_STORAGE_UNAVAILABLE: "QUOTE_STORAGE_UNAVAILABLE",
-  // Payment
   PAYMENT_FAILED: "PAYMENT_FAILED",
   PAYMENT_CANCELLED: "PAYMENT_CANCELLED",
   INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS",
@@ -100,11 +95,9 @@ var ErrorCode = {
   OTP_EXPIRED: "OTP_EXPIRED",
   AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED",
   PAYMENT_ACTION_NOT_COMPLETED: "PAYMENT_ACTION_NOT_COMPLETED",
-  // Scheduling
   SLOT_UNAVAILABLE: "SLOT_UNAVAILABLE",
   BOOKING_CONFLICT: "BOOKING_CONFLICT",
   SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND",
-  // Inventory
   OUT_OF_STOCK: "OUT_OF_STOCK",
   INSUFFICIENT_QUANTITY: "INSUFFICIENT_QUANTITY"
 };
@@ -180,7 +173,6 @@ var CimplifyError = class extends Error {
     this.suggestion = suggestion;
     this.name = "CimplifyError";
   }
-  /** User-friendly message safe to display */
   get userMessage() {
     return this.message;
   }
@@ -449,6 +441,7 @@ var CatalogueQueries = class {
   async getProducts(options) {
     const path = withQuery("/api/v1/catalogue/products", {
       category_id: options?.category,
+      taxonomy_id: options?.taxonomy,
       search: options?.search,
       page: options?.page,
       tags: options?.tags?.join(","),
@@ -581,6 +574,59 @@ var CatalogueQueries = class {
       )
     );
   }
+  async getTaxonomies(parentId) {
+    const path = withQuery("/api/v1/catalogue/taxonomies", { parent_id: parentId });
+    return safe(this.client.get(path));
+  }
+  async getTaxonomy(id) {
+    const encodedId = encodeURIComponent(id);
+    return safe(this.client.get(`/api/v1/catalogue/taxonomies/${encodedId}`));
+  }
+  async getTaxonomyPath(id) {
+    const encodedId = encodeURIComponent(id);
+    return safe(this.client.get(`/api/v1/catalogue/taxonomies/${encodedId}/path`));
+  }
+  async searchTaxonomies(query2, limit) {
+    const path = withQuery("/api/v1/catalogue/taxonomies/search", { q: query2, limit });
+    return safe(this.client.get(path));
+  }
+  async getProductSchedules(productId) {
+    const encodedId = encodeURIComponent(productId);
+    return safe(this.client.get(`/api/v1/catalogue/products/${encodedId}/schedules`));
+  }
+  async checkProductAvailableNow(productId, locationId) {
+    const encodedId = encodeURIComponent(productId);
+    const path = withQuery(`/api/v1/catalogue/products/${encodedId}/available-now`, { location_id: locationId });
+    return safe(this.client.get(path));
+  }
+  async getDeals(locationId) {
+    const path = withQuery("/api/v1/catalogue/deals", { location_id: locationId });
+    return safe(this.client.get(path));
+  }
+  async getProductsOnSale() {
+    return safe(this.client.get("/api/v1/catalogue/deals/on-sale"));
+  }
+  async getProductDeals(productId) {
+    const encodedId = encodeURIComponent(productId);
+    return safe(this.client.get(`/api/v1/catalogue/products/${encodedId}/deals`));
+  }
+  async getCategoryDeals(categoryId) {
+    const encodedId = encodeURIComponent(categoryId);
+    return safe(this.client.get(`/api/v1/catalogue/categories/${encodedId}/deals`));
+  }
+  async getCollectionDeals(collectionId) {
+    const encodedId = encodeURIComponent(collectionId);
+    return safe(this.client.get(`/api/v1/catalogue/collections/${encodedId}/deals`));
+  }
+  async validateDiscountCode(code, orderSubtotal, locationId) {
+    return safe(
+      this.client.post("/api/v1/catalogue/deals/validate", {
+        discount_code: code,
+        order_subtotal: orderSubtotal,
+        location_id: locationId
+      })
+    );
+  }
   async search(query2, options) {
     const result = await this.getProducts({
       search: query2,
@@ -608,6 +654,16 @@ var CatalogueQueries = class {
     const encodedId = encodeURIComponent(itemId);
     return safe(this.client.get(`/api/v1/catalogue/menu/items/${encodedId}`));
   }
+  async getTags(options) {
+    const path = withQuery("/api/v1/catalogue/tags", {
+      tag_group: options?.tag_group,
+      search: options?.search,
+      min_usage: options?.min_usage,
+      limit: options?.limit,
+      offset: options?.offset
+    });
+    return safe(this.client.get(path));
+  }
 };
 
 // src/cart.ts
@@ -837,7 +893,6 @@ var DEFAULT_COUNTRY = "GHA";
 
 // src/utils/price.ts
 var CURRENCY_SYMBOLS = {
-  // Major world currencies
   USD: "$",
   EUR: "\u20AC",
   GBP: "\xA3",
@@ -870,7 +925,6 @@ var CURRENCY_SYMBOLS = {
   IDR: "Rp",
   VND: "\u20AB",
   TWD: "NT$",
-  // African currencies
   GHS: "GH\u20B5",
   NGN: "\u20A6",
   KES: "KSh",
@@ -908,8 +962,8 @@ var CURRENCY_SYMBOLS = {
   KMF: "CF",
   BIF: "FBu"
 };
-function getCurrencySymbol(currencyCode2) {
-  return CURRENCY_SYMBOLS[currencyCode2.toUpperCase()] || currencyCode2;
+function getCurrencySymbol(currencyCode3) {
+  return CURRENCY_SYMBOLS[currencyCode3.toUpperCase()] || currencyCode3;
 }
 function formatNumberCompact(value, decimals = 1) {
   const absValue = Math.abs(value);
@@ -1126,8 +1180,8 @@ function normalizePaymentResponse(response) {
   }
   if (isWebPaymentResponse(response)) {
     const authType = response.authorization_type?.toLowerCase();
-    const validAuthTypes = ["otp", "pin", "phone", "birthday", "address"];
-    const safeAuthType = authType && validAuthTypes.includes(authType) ? authType : void 0;
+    const validStringAuthTypes = ["otp", "pin", "phone", "birthday"];
+    const safeAuthType = authType && validStringAuthTypes.includes(authType) ? authType : void 0;
     return {
       provider: response.transaction.provider_type?.toLowerCase() || "unknown",
       requires_action: response.requires_action || false,
@@ -1166,7 +1220,8 @@ var PAYMENT_FAILURE_STATUSES = /* @__PURE__ */ new Set([
   "declined",
   "cancelled",
   "voided",
-  "error"
+  "error",
+  "abandoned"
 ]);
 var PAYMENT_REQUIRES_ACTION_STATUSES = /* @__PURE__ */ new Set([
   "requires_action",
@@ -1196,29 +1251,34 @@ var PAYMENT_STATUS_ALIAS_MAP = {
   unresolved: "pending"
 };
 var KNOWN_PAYMENT_STATUSES = /* @__PURE__ */ new Set([
+  "initialized",
   "pending",
   "processing",
+  "authorized",
+  "captured",
+  "failed",
+  "cancelled",
+  "refunded",
+  "unknown",
+  "voided",
+  "requires_action",
+  "abandoned",
+  "reversed",
+  "disputed",
+  "refund_pending",
   "created",
   "pending_confirmation",
   "success",
   "succeeded",
-  "failed",
   "declined",
-  "authorized",
-  "refunded",
   "partially_refunded",
   "partially_paid",
   "paid",
   "unpaid",
-  "requires_action",
   "requires_payment_method",
   "requires_capture",
-  "captured",
-  "cancelled",
   "completed",
-  "voided",
-  "error",
-  "unknown"
+  "error"
 ]);
 function normalizeStatusToken(status) {
   return status?.trim().toLowerCase().replace(/[\s-]+/g, "_") ?? "";
@@ -1247,13 +1307,15 @@ function normalizeStatusResponse(response) {
     return {
       status: "pending",
       paid: false,
+      amount: moneyFromNumber(0),
+      currency: "",
       message: "No status available"
     };
   }
   const res = response;
   const normalizedStatus = normalizePaymentStatusValue(res.status ?? void 0);
-  const normalizedAmount = typeof res.amount === "string" ? money(res.amount) : typeof res.amount === "number" && Number.isFinite(res.amount) ? moneyFromNumber(res.amount) : void 0;
-  const normalizedCurrency = typeof res.currency === "string" && res.currency.trim().length > 0 ? currencyCode(res.currency) : void 0;
+  const normalizedAmount = typeof res.amount === "string" ? money(res.amount) : typeof res.amount === "number" && Number.isFinite(res.amount) ? moneyFromNumber(res.amount) : moneyFromNumber(0);
+  const normalizedCurrency = typeof res.currency === "string" && res.currency.trim().length > 0 ? res.currency : "";
   const paidValue = res.paid === true;
   const derivedPaid = paidValue || [
     "success",
@@ -1401,7 +1463,8 @@ function isValidMobileMoneyProvider(value) {
   return VALID_MOBILE_MONEY_PROVIDERS.has(value);
 }
 function normalizeAuthorizationType(value) {
-  const lower = value?.toLowerCase();
+  if (typeof value !== "string") return void 0;
+  const lower = value.toLowerCase();
   return lower === "otp" || lower === "pin" ? lower : void 0;
 }
 function formatMoney2(value) {
@@ -2107,7 +2170,7 @@ var CheckoutService = class {
     );
     const payCurrency = data.pay_currency?.trim().toUpperCase();
     const payCurrencyCode = payCurrency ? currencyCode(payCurrency) : void 0;
-    const cartTotalAmount = Number.parseFloat(cart.pricing.total_price || "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({
         from: baseCurrency,
@@ -2272,7 +2335,7 @@ var LinkService = class {
       this.client.linkPost("/v1/link/auth/verify-otp", input)
     );
     if (result.ok && result.value.session_token) {
-      this.client.setSessionToken(result.value.session_token);
+      this.client.setAccessToken(result.value.session_token);
     }
     return result;
   }
@@ -2386,30 +2449,6 @@ var LinkService = class {
   async revokeAllSessions() {
     return safe5(this.client.linkDelete("/v1/link/sessions"));
   }
-  async getAddressesRest() {
-    return this.getAddresses();
-  }
-  async createAddressRest(input) {
-    return this.createAddress(input);
-  }
-  async deleteAddressRest(addressId) {
-    return this.deleteAddress(addressId);
-  }
-  async setDefaultAddressRest(addressId) {
-    return this.setDefaultAddress(addressId);
-  }
-  async getMobileMoneyRest() {
-    return this.getMobileMoney();
-  }
-  async createMobileMoneyRest(input) {
-    return this.createMobileMoney(input);
-  }
-  async deleteMobileMoneyRest(mobileMoneyId) {
-    return this.deleteMobileMoney(mobileMoneyId);
-  }
-  async setDefaultMobileMoneyRest(mobileMoneyId) {
-    return this.setDefaultMobileMoney(mobileMoneyId);
-  }
 };
 
 // src/auth.ts
@@ -2501,9 +2540,6 @@ var BusinessService = class {
   async getSettings() {
     return safe7(this.client.get("/api/v1/business/settings"));
   }
-  async getTheme() {
-    return safe7(this.client.get("/api/v1/business/theme"));
-  }
   async getLocations() {
     return safe7(this.client.get("/api/v1/business/locations"));
   }
@@ -2557,9 +2593,6 @@ var InventoryService = class {
     const query2 = searchParams.toString();
     return query2 ? `${path}?${query2}` : path;
   }
-  async getStockLevels() {
-    return safe8(this.client.get("/api/v1/inventory/stock-levels"));
-  }
   async getProductStock(productId, locationId) {
     const encodedId = encodeURIComponent(productId);
     const path = this.withQuery(`/api/v1/inventory/products/${encodedId}/stock`, {
@@ -2601,9 +2634,6 @@ var InventoryService = class {
     }
     return ok(results.map((r) => r.value));
   }
-  async getSummary() {
-    return safe8(this.client.get("/api/v1/inventory/summary"));
-  }
   async isInStock(productId, locationId) {
     const result = await this.checkProductAvailability(productId, 1, locationId);
     if (!result.ok) return result;
@@ -2640,16 +2670,6 @@ function withQuery2(path, params) {
   const query2 = searchParams.toString();
   return query2 ? `${path}?${query2}` : path;
 }
-function normalizeServiceAvailability(result) {
-  if (Array.isArray(result.days) && result.days.length > 0) {
-    return result;
-  }
-  const days = Array.isArray(result.availability) ? result.availability.map((day) => ({
-    ...day,
-    is_fully_booked: day.is_fully_booked ?? (typeof day.has_availability === "boolean" ? !day.has_availability : void 0)
-  })) : [];
-  return { ...result, days };
-}
 function firstScheduledTime(booking) {
   return booking.service_items.find((item) => typeof item.scheduled_start === "string")?.scheduled_start || booking.created_at;
 }
@@ -2660,13 +2680,9 @@ var SchedulingService = class {
   async getServices() {
     return safe9(this.client.get("/api/v1/scheduling/services"));
   }
-  /**
-   * Get a specific service by ID.
-   */
   async getService(serviceId) {
-    const result = await this.getServices();
-    if (!result.ok) return result;
-    return ok(result.value.find((service) => service.id === serviceId) || null);
+    const encodedId = encodeURIComponent(serviceId);
+    return safe9(this.client.get(`/api/v1/scheduling/services/${encodedId}`));
   }
   async getAvailableSlots(input) {
     const path = withQuery2("/api/v1/scheduling/slots", {
@@ -2694,9 +2710,7 @@ var SchedulingService = class {
       location_id: params.location_id,
       participant_count: params.participant_count
     });
-    return safe9(
-      this.client.get(path).then((result) => normalizeServiceAvailability(result))
-    );
+    return safe9(this.client.get(path));
   }
   async getBooking(bookingId) {
     const encodedId = encodeURIComponent(bookingId);
@@ -2753,12 +2767,6 @@ var SchedulingService = class {
     if (!result.ok) return result;
     return ok(result.value.some((slot) => slot.is_available));
   }
-  // Compatibility alias for callers typed against the older Booking shape.
-  async getBookingLegacy(bookingId) {
-    const result = await this.getBooking(bookingId);
-    if (!result.ok) return result;
-    return ok(result.value);
-  }
 };
 
 // src/lite.ts
@@ -2832,7 +2840,6 @@ var ELEMENT_TYPES = {
   CHECKOUT: "checkout"
 };
 var MESSAGE_TYPES = {
-  // Parent → Iframe
   INIT: "init",
   SET_TOKEN: "set_token",
   SET_CART: "set_cart",
@@ -2841,7 +2848,6 @@ var MESSAGE_TYPES = {
   LOGOUT: "logout",
   PROCESS_CHECKOUT: "process_checkout",
   ABORT_CHECKOUT: "abort_checkout",
-  // Iframe → Parent
   READY: "ready",
   HEIGHT_CHANGE: "height_change",
   AUTHENTICATED: "authenticated",
@@ -3069,7 +3075,6 @@ var CimplifyElements = class {
         tip_amount: options.tip_amount,
         pay_currency: options.pay_currency,
         enroll_in_link: options.enroll_in_link ?? true,
-        // Unified checkout has its own address/customer state; only pass if available externally
         address: isUnifiedCheckout ? void 0 : this.addressData ?? void 0,
         customer: isUnifiedCheckout ? void 0 : this.customerData ? {
           name: this.customerData.name,
@@ -3552,9 +3557,6 @@ function isRetryable(error) {
   if (error instanceof CimplifyError) {
     return error.retryable;
   }
-  if (error instanceof CimplifyError && error.code === "SERVER_ERROR") {
-    return true;
-  }
   return false;
 }
 function toNetworkError(error, isTestMode) {
@@ -3642,7 +3644,6 @@ var CimplifyClient = class {
       );
     }
   }
-  /** Build a full URL, appending context params (e.g. location_id) as query parameters. */
   buildUrl(base, path) {
     const url = `${base}${path}`;
     const locationId = this.context.location_id;
@@ -3650,14 +3651,6 @@ var CimplifyClient = class {
     const separator = url.includes("?") ? "&" : "?";
     return `${url}${separator}location_id=${encodeURIComponent(locationId)}`;
   }
-  /** @deprecated Use getAccessToken() instead */
-  getSessionToken() {
-    return this.accessToken;
-  }
-  /** @deprecated Use setAccessToken() instead */
-  setSessionToken(token) {
-    this.setAccessToken(token);
-  }
   getAccessToken() {
     return this.accessToken;
   }
@@ -3736,11 +3729,9 @@ var CimplifyClient = class {
       delete this.context.location_id;
     }
   }
-  /** Get the currently active location ID */
   getLocationId() {
     return this.context.location_id ?? null;
   }
-  /** Cache a resolved business ID for future element/checkouts initialization. */
   setBusinessId(businessId) {
     const normalized = businessId.trim();
     if (!normalized) {
@@ -3748,14 +3739,9 @@ var CimplifyClient = class {
     }
     this.businessId = normalized;
   }
-  /** Get cached business ID if available. */
   getBusinessId() {
     return this.businessId;
   }
-  /**
-   * Resolve business ID from public key once and cache it.
-   * Subsequent calls return the cached value (or shared in-flight promise).
-   */
   async resolveBusinessId() {
     if (this.businessId) {
       return this.businessId;
@@ -4138,20 +4124,6 @@ var CimplifyClient = class {
     }
     return this._fx;
   }
-  /**
-   * Create a CimplifyElements instance for embedding checkout components.
-   * Like Stripe's stripe.elements().
-   *
-   * @param businessId - The business ID for checkout context
-   * @param options - Optional configuration for elements
-   *
-   * @example
-   * ```ts
-   * const elements = client.elements('bus_xxx');
-   * const authElement = elements.create('auth');
-   * authElement.mount('#auth-container');
-   * ```
-   */
   elements(businessId, options) {
     if (businessId) {
       this.setBusinessId(businessId);