@cimplify/sdk 0.6.7 → 0.6.9

package/dist/index.mjs

@@ -1,4 +1,14 @@
 // src/types/common.ts
+function money(value) {
+  return value;
+}
+function moneyFromNumber(value) {
+  return value.toFixed(2);
+}
+var ZERO = "0.00";
+function currencyCode(value) {
+  return value;
+}
 var ErrorCode = {
   // General
   UNKNOWN_ERROR: "UNKNOWN_ERROR",
@@ -217,6 +227,74 @@ function combineObject(results) {
   return ok(values);
 }
 
+// src/query/builder.ts
+function escapeQueryValue(value) {
+  return value.replace(/'/g, "\\'");
+}
+var QueryBuilder = class {
+  constructor(entity) {
+    this.filters = [];
+    this.modifiers = [];
+    this.pathSegments = [];
+    this.entity = entity;
+  }
+  path(segment) {
+    this.pathSegments.push(segment);
+    return this;
+  }
+  where(field, op, value) {
+    const v = typeof value === "string" ? `'${escapeQueryValue(value)}'` : value;
+    if (op === "contains" || op === "startsWith") {
+      this.filters.push(`@.${field} ${op} ${v}`);
+    } else {
+      this.filters.push(`@.${field}${op}${v}`);
+    }
+    return this;
+  }
+  and(field, op, value) {
+    return this.where(field, op, value);
+  }
+  sort(field, order = "asc") {
+    this.modifiers.push(`sort(${field},${order})`);
+    return this;
+  }
+  limit(n) {
+    this.modifiers.push(`limit(${n})`);
+    return this;
+  }
+  offset(n) {
+    this.modifiers.push(`offset(${n})`);
+    return this;
+  }
+  count() {
+    this.modifiers.push("count");
+    return this;
+  }
+  enriched() {
+    this.modifiers.push("enriched");
+    return this;
+  }
+  build() {
+    let query2 = this.entity;
+    if (this.pathSegments.length > 0) {
+      query2 += "." + this.pathSegments.join(".");
+    }
+    if (this.filters.length > 0) {
+      query2 += `[?(${this.filters.join(" && ")})]`;
+    }
+    for (const mod of this.modifiers) {
+      query2 += `#${mod}`;
+    }
+    return query2;
+  }
+  toString() {
+    return this.build();
+  }
+};
+function query(entity) {
+  return new QueryBuilder(entity);
+}
+
 // src/catalogue.ts
 function toCimplifyError(error) {
   if (error instanceof CimplifyError) return enrichError(error);
@@ -297,7 +375,7 @@ var CatalogueQueries = class {
     let query2 = "products";
     const filters = [];
     if (options?.category) {
-      filters.push(`@.category_id=='${options.category}'`);
+      filters.push(`@.category_id=='${escapeQueryValue(options.category)}'`);
     }
     if (options?.featured !== void 0) {
       filters.push(`@.featured==${options.featured}`);
@@ -306,7 +384,7 @@ var CatalogueQueries = class {
       filters.push(`@.in_stock==${options.in_stock}`);
     }
     if (options?.search) {
-      filters.push(`@.name contains '${options.search}'`);
+      filters.push(`@.name contains '${escapeQueryValue(options.search)}'`);
     }
     if (options?.min_price !== void 0) {
       filters.push(`@.price>=${options.min_price}`);
@@ -337,7 +415,9 @@ var CatalogueQueries = class {
   }
   async getProductBySlug(slug) {
     const filteredResult = await safe(
-      this.client.query(`products[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `products[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!filteredResult.ok) return filteredResult;
     const exactMatch = findProductBySlug(filteredResult.value, slug);
@@ -389,7 +469,7 @@ var CatalogueQueries = class {
   }
   async getCategoryBySlug(slug) {
     const result = await safe(
-      this.client.query(`categories[?(@.slug=='${slug}')]`)
+      this.client.query(`categories[?(@.slug=='${escapeQueryValue(slug)}')]`)
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -398,7 +478,11 @@ var CatalogueQueries = class {
     return ok(result.value[0]);
   }
   async getCategoryProducts(categoryId) {
-    return safe(this.client.query(`products[?(@.category_id=='${categoryId}')]`));
+    return safe(
+      this.client.query(
+        `products[?(@.category_id=='${escapeQueryValue(categoryId)}')]`
+      )
+    );
   }
   async getCollections() {
     return safe(this.client.query("collections"));
@@ -408,7 +492,9 @@ var CatalogueQueries = class {
   }
   async getCollectionBySlug(slug) {
     const result = await safe(
-      this.client.query(`collections[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `collections[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -421,7 +507,9 @@ var CatalogueQueries = class {
   }
   async searchCollections(query2, limit = 20) {
     return safe(
-      this.client.query(`collections[?(@.name contains '${query2}')]#limit(${limit})`)
+      this.client.query(
+        `collections[?(@.name contains '${escapeQueryValue(query2)}')]#limit(${limit})`
+      )
     );
   }
   async getBundles() {
@@ -432,7 +520,9 @@ var CatalogueQueries = class {
   }
   async getBundleBySlug(slug) {
     const result = await safe(
-      this.client.query(`bundles[?(@.slug=='${slug}')]`)
+      this.client.query(
+        `bundles[?(@.slug=='${escapeQueryValue(slug)}')]`
+      )
     );
     if (!result.ok) return result;
     if (!result.value.length) {
@@ -442,7 +532,9 @@ var CatalogueQueries = class {
   }
   async searchBundles(query2, limit = 20) {
     return safe(
-      this.client.query(`bundles[?(@.name contains '${query2}')]#limit(${limit})`)
+      this.client.query(
+        `bundles[?(@.name contains '${escapeQueryValue(query2)}')]#limit(${limit})`
+      )
     );
   }
   async getComposites(options) {
@@ -482,9 +574,9 @@ var CatalogueQueries = class {
   }
   async search(query2, options) {
     const limit = options?.limit ?? 20;
-    let searchQuery = `products[?(@.name contains '${query2}')]`;
+    let searchQuery = `products[?(@.name contains '${escapeQueryValue(query2)}')]`;
     if (options?.category) {
-      searchQuery = `products[?(@.name contains '${query2}' && @.category_id=='${options.category}')]`;
+      searchQuery = `products[?(@.name contains '${escapeQueryValue(query2)}' && @.category_id=='${escapeQueryValue(options.category)}')]`;
     }
     searchQuery += `#limit(${limit})`;
     return safe(this.client.query(searchQuery));
@@ -501,7 +593,7 @@ var CatalogueQueries = class {
   async getMenu(options) {
     let query2 = "menu";
     if (options?.category) {
-      query2 = `menu[?(@.category=='${options.category}')]`;
+      query2 = `menu[?(@.category=='${escapeQueryValue(options.category)}')]`;
     }
     if (options?.limit) {
       query2 += `#limit(${options.limit})`;
@@ -818,8 +910,8 @@ var CURRENCY_SYMBOLS = {
   KMF: "CF",
   BIF: "FBu"
 };
-function getCurrencySymbol(currencyCode) {
-  return CURRENCY_SYMBOLS[currencyCode.toUpperCase()] || currencyCode;
+function getCurrencySymbol(currencyCode2) {
+  return CURRENCY_SYMBOLS[currencyCode2.toUpperCase()] || currencyCode2;
 }
 function formatNumberCompact(value, decimals = 1) {
   const absValue = Math.abs(value);
@@ -1143,6 +1235,8 @@ function normalizeStatusResponse(response) {
   }
   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 paidValue = res.paid === true;
   const derivedPaid = paidValue || [
     "success",
@@ -1155,8 +1249,8 @@ function normalizeStatusResponse(response) {
   return {
     status: normalizedStatus,
     paid: derivedPaid,
-    amount: res.amount,
-    currency: res.currency,
+    amount: normalizedAmount,
+    currency: normalizedCurrency,
     reference: res.reference,
     message: res.message || ""
   };
@@ -1863,14 +1957,17 @@ var CheckoutService = class {
       pay_currency: data.pay_currency,
       fx_quote_id: data.fx_quote_id
     };
-    const baseCurrency = (cart.pricing.currency || checkoutData.pay_currency || "GHS").toUpperCase();
+    const baseCurrency = currencyCode(
+      (cart.pricing.currency || checkoutData.pay_currency || "GHS").toUpperCase()
+    );
     const payCurrency = data.pay_currency?.trim().toUpperCase();
+    const payCurrencyCode = payCurrency ? currencyCode(payCurrency) : void 0;
     const cartTotalAmount = Number.parseFloat(cart.pricing.total_price || "0");
-    if (payCurrency && payCurrency !== baseCurrency && !checkoutData.fx_quote_id && Number.isFinite(cartTotalAmount) && cartTotalAmount > 0) {
+    if (payCurrencyCode && payCurrencyCode !== baseCurrency && !checkoutData.fx_quote_id && Number.isFinite(cartTotalAmount) && cartTotalAmount > 0) {
       const fxQuoteResult = await this.client.fx.lockQuote({
         from: baseCurrency,
-        to: payCurrency,
-        amount: cartTotalAmount
+        to: payCurrencyCode,
+        amount: cart.pricing.total_price
       });
       if (!fxQuoteResult.ok) {
         return ok(
@@ -1881,7 +1978,7 @@ var CheckoutService = class {
           )
         );
       }
-      checkoutData.pay_currency = payCurrency;
+      checkoutData.pay_currency = payCurrencyCode;
       checkoutData.fx_quote_id = fxQuoteResult.value.id;
     }
     data.on_status_change?.("processing", {});
@@ -1986,6 +2083,9 @@ var LinkService = class {
   constructor(client) {
     this.client = client;
   }
+  async getProfile() {
+    return safe5(this.client.linkGet("/v1/link/profile"));
+  }
   async requestOtp(input) {
     return safe5(this.client.linkPost("/v1/link/auth/request-otp", input));
   }
@@ -2013,13 +2113,13 @@ var LinkService = class {
     );
   }
   async getLinkData() {
-    return safe5(this.client.query(LINK_QUERY.DATA));
+    return safe5(this.client.linkGet("/v1/link/data"));
   }
   async getAddresses() {
-    return safe5(this.client.query(LINK_QUERY.ADDRESSES));
+    return safe5(this.client.linkGet("/v1/link/addresses"));
   }
   async getMobileMoney() {
-    return safe5(this.client.query(LINK_QUERY.MOBILE_MONEY));
+    return safe5(this.client.linkGet("/v1/link/mobile-money"));
   }
   async getPreferences() {
     return safe5(this.client.query(LINK_QUERY.PREFERENCES));
@@ -2042,10 +2142,10 @@ var LinkService = class {
     return safe5(this.client.call(LINK_MUTATION.UPDATE_ADDRESS, input));
   }
   async deleteAddress(addressId) {
-    return safe5(this.client.call(LINK_MUTATION.DELETE_ADDRESS, addressId));
+    return safe5(this.client.linkDelete(`/v1/link/addresses/${addressId}`));
   }
   async setDefaultAddress(addressId) {
-    return safe5(this.client.call(LINK_MUTATION.SET_DEFAULT_ADDRESS, addressId));
+    return safe5(this.client.linkPost(`/v1/link/addresses/${addressId}/default`));
   }
   async trackAddressUsage(addressId) {
     return safe5(
@@ -2058,11 +2158,13 @@ var LinkService = class {
     return safe5(this.client.call(LINK_MUTATION.CREATE_MOBILE_MONEY, input));
   }
   async deleteMobileMoney(mobileMoneyId) {
-    return safe5(this.client.call(LINK_MUTATION.DELETE_MOBILE_MONEY, mobileMoneyId));
+    return safe5(
+      this.client.linkDelete(`/v1/link/mobile-money/${mobileMoneyId}`)
+    );
   }
   async setDefaultMobileMoney(mobileMoneyId) {
     return safe5(
-      this.client.call(LINK_MUTATION.SET_DEFAULT_MOBILE_MONEY, mobileMoneyId)
+      this.client.linkPost(`/v1/link/mobile-money/${mobileMoneyId}/default`)
     );
   }
   async trackMobileMoneyUsage(mobileMoneyId) {
@@ -3227,7 +3329,7 @@ var CimplifyClient = class {
     this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY_MS;
     this.hooks = config.hooks ?? {};
     this.accessToken = this.loadAccessToken();
-    if (!this.publicKey) {
+    if (!this.publicKey && !config.suppressPublicKeyWarning) {
       console.warn(
         '[Cimplify] No public key found. Set NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY in your environment, or pass { publicKey: "pk_..." } to createCimplifyClient().'
       );
@@ -3340,9 +3442,12 @@ var CimplifyClient = class {
   }
   getHeaders() {
     const headers = {
-      "Content-Type": "application/json",
-      "X-API-Key": this.publicKey
+      "Content-Type": "application/json"
     };
+    const trimmedPublicKey = this.publicKey.trim();
+    if (trimmedPublicKey) {
+      headers["X-API-Key"] = trimmedPublicKey;
+    }
     if (this.accessToken) {
       headers["Authorization"] = `Bearer ${this.accessToken}`;
     }
@@ -3371,7 +3476,7 @@ var CimplifyClient = class {
           signal: controller.signal
         });
         clearTimeout(timeoutId);
-        if (response.ok || response.status >= 400 && response.status < 500) {
+        if (response.ok) {
           this.hooks.onRequestSuccess?.({
             ...context,
             status: response.status,
@@ -3379,6 +3484,21 @@ var CimplifyClient = class {
           });
           return response;
         }
+        if (response.status >= 400 && response.status < 500) {
+          this.hooks.onRequestError?.({
+            ...context,
+            error: new CimplifyError(
+              `HTTP_${response.status}`,
+              `Request failed with status ${response.status}`,
+              false
+            ),
+            status: response.status,
+            durationMs: Date.now() - startTime,
+            retryCount,
+            retryable: false
+          });
+          return response;
+        }
         if (response.status >= 500 && attempt < this.maxRetries) {
           retryCount++;
           const delay = this.retryDelay * Math.pow(2, attempt);
@@ -3391,10 +3511,17 @@ var CimplifyClient = class {
           await sleep(delay);
           continue;
         }
-        this.hooks.onRequestSuccess?.({
+        this.hooks.onRequestError?.({
           ...context,
+          error: new CimplifyError(
+            "SERVER_ERROR",
+            `Server error ${response.status} after ${retryCount} retries`,
+            false
+          ),
           status: response.status,
-          durationMs: Date.now() - startTime
+          durationMs: Date.now() - startTime,
+          retryCount,
+          retryable: false
         });
         return response;
       } catch (error) {
@@ -3668,69 +3795,4 @@ function createCimplifyClient(config = {}) {
   return new CimplifyClient(config);
 }
 
-// src/query/builder.ts
-var QueryBuilder = class {
-  constructor(entity) {
-    this.filters = [];
-    this.modifiers = [];
-    this.pathSegments = [];
-    this.entity = entity;
-  }
-  path(segment) {
-    this.pathSegments.push(segment);
-    return this;
-  }
-  where(field, op, value) {
-    const v = typeof value === "string" ? `'${value}'` : value;
-    if (op === "contains" || op === "startsWith") {
-      this.filters.push(`@.${field} ${op} ${v}`);
-    } else {
-      this.filters.push(`@.${field}${op}${v}`);
-    }
-    return this;
-  }
-  and(field, op, value) {
-    return this.where(field, op, value);
-  }
-  sort(field, order = "asc") {
-    this.modifiers.push(`sort(${field},${order})`);
-    return this;
-  }
-  limit(n) {
-    this.modifiers.push(`limit(${n})`);
-    return this;
-  }
-  offset(n) {
-    this.modifiers.push(`offset(${n})`);
-    return this;
-  }
-  count() {
-    this.modifiers.push("count");
-    return this;
-  }
-  enriched() {
-    this.modifiers.push("enriched");
-    return this;
-  }
-  build() {
-    let query2 = this.entity;
-    if (this.pathSegments.length > 0) {
-      query2 += "." + this.pathSegments.join(".");
-    }
-    if (this.filters.length > 0) {
-      query2 += `[?(${this.filters.join(" && ")})]`;
-    }
-    for (const mod of this.modifiers) {
-      query2 += `#${mod}`;
-    }
-    return query2;
-  }
-  toString() {
-    return this.build();
-  }
-};
-function query(entity) {
-  return new QueryBuilder(entity);
-}
-
-export { AUTHORIZATION_TYPE, AUTH_MUTATION, AuthService, BusinessService, CHECKOUT_MODE, CHECKOUT_MUTATION, CHECKOUT_STEP, CONTACT_TYPE, CURRENCY_SYMBOLS, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyClient, CimplifyElement, CimplifyElements, CimplifyError, DEFAULT_COUNTRY, DEFAULT_CURRENCY, DEVICE_TYPE, ELEMENT_TYPES, ERROR_HINTS, EVENT_TYPES, ErrorCode, FxService, InventoryService, LINK_MUTATION, LINK_QUERY, LinkService, LiteService, MESSAGE_TYPES, MOBILE_MONEY_PROVIDER, MOBILE_MONEY_PROVIDERS, ORDER_MUTATION, ORDER_TYPE, OrderQueries, PAYMENT_METHOD, PAYMENT_MUTATION, PAYMENT_STATE, PICKUP_TIME_TYPE, QueryBuilder, SchedulingService, categorizePaymentError, combine, combineObject, createCimplifyClient, createElements, detectMobileMoneyProvider, enrichError, err, flatMap, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatProductPrice, fromPromise, generateIdempotencyKey, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getErrorHint, getMarkupPercentage, getOrElse, getProductCurrency, isCimplifyError, isErr, isOk, isOnSale, isPaymentStatusFailure, isPaymentStatusRequiresAction, isPaymentStatusSuccess, isRetryableError, mapError, mapResult, normalizePaymentResponse, normalizeStatusResponse, ok, parsePrice, query, toNullable, tryCatch, unwrap };
+export { AUTHORIZATION_TYPE, AUTH_MUTATION, AuthService, BusinessService, CHECKOUT_MODE, CHECKOUT_MUTATION, CHECKOUT_STEP, CONTACT_TYPE, CURRENCY_SYMBOLS, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyClient, CimplifyElement, CimplifyElements, CimplifyError, DEFAULT_COUNTRY, DEFAULT_CURRENCY, DEVICE_TYPE, ELEMENT_TYPES, ERROR_HINTS, EVENT_TYPES, ErrorCode, FxService, InventoryService, LINK_MUTATION, LINK_QUERY, LinkService, LiteService, MESSAGE_TYPES, MOBILE_MONEY_PROVIDER, MOBILE_MONEY_PROVIDERS, ORDER_MUTATION, ORDER_TYPE, OrderQueries, PAYMENT_METHOD, PAYMENT_MUTATION, PAYMENT_STATE, PICKUP_TIME_TYPE, QueryBuilder, SchedulingService, ZERO, categorizePaymentError, combine, combineObject, createCimplifyClient, createElements, currencyCode, detectMobileMoneyProvider, enrichError, err, flatMap, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatProductPrice, fromPromise, generateIdempotencyKey, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getErrorHint, getMarkupPercentage, getOrElse, getProductCurrency, isCimplifyError, isErr, isOk, isOnSale, isPaymentStatusFailure, isPaymentStatusRequiresAction, isPaymentStatusSuccess, isRetryableError, mapError, mapResult, money, moneyFromNumber, normalizePaymentResponse, normalizeStatusResponse, ok, parsePrice, query, toNullable, tryCatch, unwrap };

package/dist/{payment-pjpfIKX8.d.mts → payment-Cu75tmUc.d.mts}

@@ -1,7 +1,22 @@
-/** Decimal value represented as string for precision */
-type Money = string;
-/** Supported currencies */
-type Currency = "GHS" | "USD" | "NGN" | "KES" | "ZAR" | string;
+declare const __money: unique symbol;
+/** Decimal monetary amount as a string (e.g. "29.99"). Branded to prevent mixing with plain strings. */
+type Money = string & {
+    readonly [__money]: true;
+};
+/** Create a Money value from a string decimal. */
+declare function money(value: string): Money;
+/** Create a Money value from a number. Converts to a 2-decimal string. */
+declare function moneyFromNumber(value: number): Money;
+/** Zero money constant. */
+declare const ZERO: Money;
+/** ISO 4217 currency codes supported by the platform */
+type CurrencyCode = "USD" | "EUR" | "GBP" | "JPY" | "CNY" | "CHF" | "CAD" | "AUD" | "GHS" | "NGN" | "KES" | "ZAR" | "XOF" | "XAF" | "EGP" | "TZS" | "UGX" | "RWF" | "ETB" | "ZMW" | "BWP" | "MUR" | "NAD" | "MWK" | "AOA" | "CDF" | "GMD" | "GNF" | "LRD" | "SLL" | "MZN" | "BIF" | "INR" | "BRL" | "MXN" | "KRW" | "TRY" | "THB" | "MYR" | "PHP" | "IDR" | "VND" | "SGD" | "HKD" | "TWD" | "AED" | "SAR" | "ILS";
+/** Assert a string as CurrencyCode at API boundaries. */
+declare function currencyCode(value: string): CurrencyCode;
+/**
+ * @deprecated Use `CurrencyCode` instead. Kept for backward compatibility.
+ */
+type Currency = CurrencyCode;
 /** Pagination parameters */
 interface PaginationParams {
     page?: number;
@@ -121,7 +136,7 @@ interface Payment {
     order_id: string;
     business_id: string;
     amount: Money;
-    currency: Currency;
+    currency: CurrencyCode;
     payment_method: PaymentMethod;
     status: PaymentStatus;
     provider: PaymentProvider;
@@ -162,7 +177,7 @@ interface PaymentStatusResponse {
     status: PaymentStatus;
     paid: boolean;
     amount?: Money;
-    currency?: string;
+    currency?: CurrencyCode;
     reference?: string;
     message?: string;
 }
@@ -178,4 +193,4 @@ interface SubmitAuthorizationInput {
     value: string;
 }
 
-export { type ApiError as A, type Currency as C, ErrorCode as E, type InitializePaymentResult as I, type Money as M, type PaginationParams as P, type SubmitAuthorizationInput as S, type Pagination as a, type ErrorCodeType as b, type ErrorHint as c, ERROR_HINTS as d, CimplifyError as e, enrichError as f, getErrorHint as g, isRetryableError as h, isCimplifyError as i, type PaymentStatus as j, type PaymentProvider as k, type PaymentMethodType as l, type AuthorizationType as m, type PaymentProcessingState as n, type PaymentMethod as o, type Payment as p, type PaymentResponse as q, type PaymentStatusResponse as r, type PaymentErrorDetails as s };
+export { type ApiError as A, type CurrencyCode as C, ErrorCode as E, type InitializePaymentResult as I, type Money as M, type PaginationParams as P, type SubmitAuthorizationInput as S, ZERO as Z, moneyFromNumber as a, type Currency as b, currencyCode as c, type Pagination as d, type ErrorCodeType as e, type ErrorHint as f, ERROR_HINTS as g, CimplifyError as h, isCimplifyError as i, getErrorHint as j, enrichError as k, isRetryableError as l, money as m, type PaymentStatus as n, type PaymentProvider as o, type PaymentMethodType as p, type AuthorizationType as q, type PaymentProcessingState as r, type PaymentMethod as s, type Payment as t, type PaymentResponse as u, type PaymentStatusResponse as v, type PaymentErrorDetails as w };

package/dist/{payment-pjpfIKX8.d.ts → payment-Cu75tmUc.d.ts}

@@ -1,7 +1,22 @@
-/** Decimal value represented as string for precision */
-type Money = string;
-/** Supported currencies */
-type Currency = "GHS" | "USD" | "NGN" | "KES" | "ZAR" | string;
+declare const __money: unique symbol;
+/** Decimal monetary amount as a string (e.g. "29.99"). Branded to prevent mixing with plain strings. */
+type Money = string & {
+    readonly [__money]: true;
+};
+/** Create a Money value from a string decimal. */
+declare function money(value: string): Money;
+/** Create a Money value from a number. Converts to a 2-decimal string. */
+declare function moneyFromNumber(value: number): Money;
+/** Zero money constant. */
+declare const ZERO: Money;
+/** ISO 4217 currency codes supported by the platform */
+type CurrencyCode = "USD" | "EUR" | "GBP" | "JPY" | "CNY" | "CHF" | "CAD" | "AUD" | "GHS" | "NGN" | "KES" | "ZAR" | "XOF" | "XAF" | "EGP" | "TZS" | "UGX" | "RWF" | "ETB" | "ZMW" | "BWP" | "MUR" | "NAD" | "MWK" | "AOA" | "CDF" | "GMD" | "GNF" | "LRD" | "SLL" | "MZN" | "BIF" | "INR" | "BRL" | "MXN" | "KRW" | "TRY" | "THB" | "MYR" | "PHP" | "IDR" | "VND" | "SGD" | "HKD" | "TWD" | "AED" | "SAR" | "ILS";
+/** Assert a string as CurrencyCode at API boundaries. */
+declare function currencyCode(value: string): CurrencyCode;
+/**
+ * @deprecated Use `CurrencyCode` instead. Kept for backward compatibility.
+ */
+type Currency = CurrencyCode;
 /** Pagination parameters */
 interface PaginationParams {
     page?: number;
@@ -121,7 +136,7 @@ interface Payment {
     order_id: string;
     business_id: string;
     amount: Money;
-    currency: Currency;
+    currency: CurrencyCode;
     payment_method: PaymentMethod;
     status: PaymentStatus;
     provider: PaymentProvider;
@@ -162,7 +177,7 @@ interface PaymentStatusResponse {
     status: PaymentStatus;
     paid: boolean;
     amount?: Money;
-    currency?: string;
+    currency?: CurrencyCode;
     reference?: string;
     message?: string;
 }
@@ -178,4 +193,4 @@ interface SubmitAuthorizationInput {
     value: string;
 }
 
-export { type ApiError as A, type Currency as C, ErrorCode as E, type InitializePaymentResult as I, type Money as M, type PaginationParams as P, type SubmitAuthorizationInput as S, type Pagination as a, type ErrorCodeType as b, type ErrorHint as c, ERROR_HINTS as d, CimplifyError as e, enrichError as f, getErrorHint as g, isRetryableError as h, isCimplifyError as i, type PaymentStatus as j, type PaymentProvider as k, type PaymentMethodType as l, type AuthorizationType as m, type PaymentProcessingState as n, type PaymentMethod as o, type Payment as p, type PaymentResponse as q, type PaymentStatusResponse as r, type PaymentErrorDetails as s };
+export { type ApiError as A, type CurrencyCode as C, ErrorCode as E, type InitializePaymentResult as I, type Money as M, type PaginationParams as P, type SubmitAuthorizationInput as S, ZERO as Z, moneyFromNumber as a, type Currency as b, currencyCode as c, type Pagination as d, type ErrorCodeType as e, type ErrorHint as f, ERROR_HINTS as g, CimplifyError as h, isCimplifyError as i, getErrorHint as j, enrichError as k, isRetryableError as l, money as m, type PaymentStatus as n, type PaymentProvider as o, type PaymentMethodType as p, type AuthorizationType as q, type PaymentProcessingState as r, type PaymentMethod as s, type Payment as t, type PaymentResponse as u, type PaymentStatusResponse as v, type PaymentErrorDetails as w };