@cimplify/sdk 0.6.11 → 0.6.12

package/dist/utils.d.mts

@@ -1,2 +1,2 @@
-export { C as CURRENCY_SYMBOLS, M as MOBILE_MONEY_PROVIDERS, n as categorizePaymentError, u as detectMobileMoneyProvider, c as formatMoney, d as formatNumberCompact, f as formatPrice, a as formatPriceAdjustment, b as formatPriceCompact, e as formatProductPrice, i as getBasePrice, g as getCurrencySymbol, k as getDiscountPercentage, h as getDisplayPrice, l as getMarkupPercentage, m as getProductCurrency, j as isOnSale, r as isPaymentStatusFailure, s as isPaymentStatusRequiresAction, t as isPaymentStatusSuccess, o as normalizePaymentResponse, q as normalizeStatusResponse, p as parsePrice } from './index-DaKJxoEh.mjs';
-import './payment-Cu75tmUc.mjs';
+export { C as CURRENCY_SYMBOLS, M as MOBILE_MONEY_PROVIDERS, s as categorizePaymentError, y as detectMobileMoneyProvider, c as formatMoney, d as formatNumberCompact, f as formatPrice, a as formatPriceAdjustment, b as formatPriceCompact, j as formatPriceWithTax, e as formatProductPrice, m as getBasePrice, k as getCurrencySymbol, o as getDiscountPercentage, l as getDisplayPrice, q as getMarkupPercentage, r as getProductCurrency, g as getTaxAmount, h as hasTaxInfo, n as isOnSale, v as isPaymentStatusFailure, w as isPaymentStatusRequiresAction, x as isPaymentStatusSuccess, i as isTaxInclusive, t as normalizePaymentResponse, u as normalizeStatusResponse, p as parsePrice } from './index-Dqaywky7.mjs';
+import './payment-CLIWNMaP.mjs';

package/dist/utils.d.ts

@@ -1,2 +1,2 @@
-export { C as CURRENCY_SYMBOLS, M as MOBILE_MONEY_PROVIDERS, n as categorizePaymentError, u as detectMobileMoneyProvider, c as formatMoney, d as formatNumberCompact, f as formatPrice, a as formatPriceAdjustment, b as formatPriceCompact, e as formatProductPrice, i as getBasePrice, g as getCurrencySymbol, k as getDiscountPercentage, h as getDisplayPrice, l as getMarkupPercentage, m as getProductCurrency, j as isOnSale, r as isPaymentStatusFailure, s as isPaymentStatusRequiresAction, t as isPaymentStatusSuccess, o as normalizePaymentResponse, q as normalizeStatusResponse, p as parsePrice } from './index-pztT_bcJ.js';
-import './payment-Cu75tmUc.js';
+export { C as CURRENCY_SYMBOLS, M as MOBILE_MONEY_PROVIDERS, s as categorizePaymentError, y as detectMobileMoneyProvider, c as formatMoney, d as formatNumberCompact, f as formatPrice, a as formatPriceAdjustment, b as formatPriceCompact, j as formatPriceWithTax, e as formatProductPrice, m as getBasePrice, k as getCurrencySymbol, o as getDiscountPercentage, l as getDisplayPrice, q as getMarkupPercentage, r as getProductCurrency, g as getTaxAmount, h as hasTaxInfo, n as isOnSale, v as isPaymentStatusFailure, w as isPaymentStatusRequiresAction, x as isPaymentStatusSuccess, i as isTaxInclusive, t as normalizePaymentResponse, u as normalizeStatusResponse, p as parsePrice } from './index-DAztg_LQ.js';
+import './payment-CLIWNMaP.js';

package/dist/utils.js

@@ -145,6 +145,25 @@ function parsePrice(value) {
   const parsed = parseFloat(cleaned);
   return isNaN(parsed) ? 0 : parsed;
 }
+function hasTaxInfo(priceInfo) {
+  return priceInfo.tax_info !== void 0 && priceInfo.tax_info !== null;
+}
+function getTaxAmount(priceInfo) {
+  return parsePrice(priceInfo.tax_info?.tax_amount);
+}
+function isTaxInclusive(priceInfo) {
+  return priceInfo.tax_info?.is_inclusive === true;
+}
+function formatPriceWithTax(priceInfo, currency = "GHS") {
+  const finalPrice = formatPrice(priceInfo.final_price, currency);
+  if (!hasTaxInfo(priceInfo)) {
+    return finalPrice;
+  }
+  if (isTaxInclusive(priceInfo)) {
+    return `${finalPrice} (incl. tax)`;
+  }
+  return `${finalPrice} + ${formatPrice(getTaxAmount(priceInfo), currency)} tax`;
+}
 function getDisplayPrice(product) {
   if (product.price_info) {
     return parsePrice(product.price_info.final_price);
@@ -238,6 +257,10 @@ var ERROR_SUGGESTIONS = {
   CHECKOUT_VALIDATION_FAILED: "Checkout payload failed validation. Verify customer, order type, and address fields are complete.",
   DELIVERY_ADDRESS_REQUIRED: "Delivery orders require an address. Collect and pass address info before processing checkout.",
   CUSTOMER_INFO_REQUIRED: "Customer details are required. Ensure name/email/phone are available before checkout.",
+  QUOTE_NOT_FOUND: "Quote could not be found. Refresh pricing and create a new quote before checkout.",
+  QUOTE_EXPIRED: "Quote has expired. Re-fetch pricing to generate a new quote with a valid expiry window.",
+  QUOTE_CONSUMED: "Quote has already been used. Request a fresh quote to prevent duplicate checkout attempts.",
+  QUOTE_STORAGE_UNAVAILABLE: "Quote storage is temporarily unavailable. Retry shortly and avoid charging until quote fetch succeeds.",
   PAYMENT_FAILED: "Payment provider rejected or failed processing. Show retry/change-method options to the shopper.",
   PAYMENT_CANCELLED: "Payment was cancelled by the shopper or provider flow. Allow a safe retry path.",
   INSUFFICIENT_FUNDS: "Payment method has insufficient funds. Prompt shopper to use another method.",
@@ -513,6 +536,7 @@ exports.formatNumberCompact = formatNumberCompact;
 exports.formatPrice = formatPrice;
 exports.formatPriceAdjustment = formatPriceAdjustment;
 exports.formatPriceCompact = formatPriceCompact;
+exports.formatPriceWithTax = formatPriceWithTax;
 exports.formatProductPrice = formatProductPrice;
 exports.getBasePrice = getBasePrice;
 exports.getCurrencySymbol = getCurrencySymbol;
@@ -520,10 +544,13 @@ exports.getDiscountPercentage = getDiscountPercentage;
 exports.getDisplayPrice = getDisplayPrice;
 exports.getMarkupPercentage = getMarkupPercentage;
 exports.getProductCurrency = getProductCurrency;
+exports.getTaxAmount = getTaxAmount;
+exports.hasTaxInfo = hasTaxInfo;
 exports.isOnSale = isOnSale;
 exports.isPaymentStatusFailure = isPaymentStatusFailure;
 exports.isPaymentStatusRequiresAction = isPaymentStatusRequiresAction;
 exports.isPaymentStatusSuccess = isPaymentStatusSuccess;
+exports.isTaxInclusive = isTaxInclusive;
 exports.normalizePaymentResponse = normalizePaymentResponse;
 exports.normalizeStatusResponse = normalizeStatusResponse;
 exports.parsePrice = parsePrice;

package/dist/utils.mjs

@@ -143,6 +143,25 @@ function parsePrice(value) {
   const parsed = parseFloat(cleaned);
   return isNaN(parsed) ? 0 : parsed;
 }
+function hasTaxInfo(priceInfo) {
+  return priceInfo.tax_info !== void 0 && priceInfo.tax_info !== null;
+}
+function getTaxAmount(priceInfo) {
+  return parsePrice(priceInfo.tax_info?.tax_amount);
+}
+function isTaxInclusive(priceInfo) {
+  return priceInfo.tax_info?.is_inclusive === true;
+}
+function formatPriceWithTax(priceInfo, currency = "GHS") {
+  const finalPrice = formatPrice(priceInfo.final_price, currency);
+  if (!hasTaxInfo(priceInfo)) {
+    return finalPrice;
+  }
+  if (isTaxInclusive(priceInfo)) {
+    return `${finalPrice} (incl. tax)`;
+  }
+  return `${finalPrice} + ${formatPrice(getTaxAmount(priceInfo), currency)} tax`;
+}
 function getDisplayPrice(product) {
   if (product.price_info) {
     return parsePrice(product.price_info.final_price);
@@ -236,6 +255,10 @@ var ERROR_SUGGESTIONS = {
   CHECKOUT_VALIDATION_FAILED: "Checkout payload failed validation. Verify customer, order type, and address fields are complete.",
   DELIVERY_ADDRESS_REQUIRED: "Delivery orders require an address. Collect and pass address info before processing checkout.",
   CUSTOMER_INFO_REQUIRED: "Customer details are required. Ensure name/email/phone are available before checkout.",
+  QUOTE_NOT_FOUND: "Quote could not be found. Refresh pricing and create a new quote before checkout.",
+  QUOTE_EXPIRED: "Quote has expired. Re-fetch pricing to generate a new quote with a valid expiry window.",
+  QUOTE_CONSUMED: "Quote has already been used. Request a fresh quote to prevent duplicate checkout attempts.",
+  QUOTE_STORAGE_UNAVAILABLE: "Quote storage is temporarily unavailable. Retry shortly and avoid charging until quote fetch succeeds.",
   PAYMENT_FAILED: "Payment provider rejected or failed processing. Show retry/change-method options to the shopper.",
   PAYMENT_CANCELLED: "Payment was cancelled by the shopper or provider flow. Allow a safe retry path.",
   INSUFFICIENT_FUNDS: "Payment method has insufficient funds. Prompt shopper to use another method.",
@@ -502,4 +525,4 @@ function detectMobileMoneyProvider(phoneNumber) {
   return null;
 }
 
-export { CURRENCY_SYMBOLS, MOBILE_MONEY_PROVIDERS, categorizePaymentError, detectMobileMoneyProvider, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatProductPrice, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getMarkupPercentage, getProductCurrency, isOnSale, isPaymentStatusFailure, isPaymentStatusRequiresAction, isPaymentStatusSuccess, normalizePaymentResponse, normalizeStatusResponse, parsePrice };
+export { CURRENCY_SYMBOLS, MOBILE_MONEY_PROVIDERS, categorizePaymentError, detectMobileMoneyProvider, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatPriceWithTax, formatProductPrice, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getMarkupPercentage, getProductCurrency, getTaxAmount, hasTaxInfo, isOnSale, isPaymentStatusFailure, isPaymentStatusRequiresAction, isPaymentStatusSuccess, isTaxInclusive, normalizePaymentResponse, normalizeStatusResponse, parsePrice };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/sdk",
-  "version": "0.6.11",
+  "version": "0.6.12",
   "description": "Cimplify Commerce SDK for storefronts",
   "keywords": [
     "cimplify",

package/dist/payment-Cu75tmUc.d.mts

@@ -1,196 +0,0 @@
-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;
-    limit?: number;
-    offset?: number;
-}
-/** Pagination metadata in response */
-interface Pagination {
-    total_count: number;
-    current_page: number;
-    page_size: number;
-    total_pages: number;
-}
-/** Strongly-typed error codes for better DX */
-declare const ErrorCode: {
-    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
-    readonly NETWORK_ERROR: "NETWORK_ERROR";
-    readonly TIMEOUT: "TIMEOUT";
-    readonly UNAUTHORIZED: "UNAUTHORIZED";
-    readonly FORBIDDEN: "FORBIDDEN";
-    readonly NOT_FOUND: "NOT_FOUND";
-    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
-    readonly CART_EMPTY: "CART_EMPTY";
-    readonly CART_EXPIRED: "CART_EXPIRED";
-    readonly CART_NOT_FOUND: "CART_NOT_FOUND";
-    readonly ITEM_UNAVAILABLE: "ITEM_UNAVAILABLE";
-    readonly VARIANT_NOT_FOUND: "VARIANT_NOT_FOUND";
-    readonly VARIANT_OUT_OF_STOCK: "VARIANT_OUT_OF_STOCK";
-    readonly ADDON_REQUIRED: "ADDON_REQUIRED";
-    readonly ADDON_MAX_EXCEEDED: "ADDON_MAX_EXCEEDED";
-    readonly CHECKOUT_VALIDATION_FAILED: "CHECKOUT_VALIDATION_FAILED";
-    readonly DELIVERY_ADDRESS_REQUIRED: "DELIVERY_ADDRESS_REQUIRED";
-    readonly CUSTOMER_INFO_REQUIRED: "CUSTOMER_INFO_REQUIRED";
-    readonly PAYMENT_FAILED: "PAYMENT_FAILED";
-    readonly PAYMENT_CANCELLED: "PAYMENT_CANCELLED";
-    readonly INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
-    readonly CARD_DECLINED: "CARD_DECLINED";
-    readonly INVALID_OTP: "INVALID_OTP";
-    readonly OTP_EXPIRED: "OTP_EXPIRED";
-    readonly AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED";
-    readonly PAYMENT_ACTION_NOT_COMPLETED: "PAYMENT_ACTION_NOT_COMPLETED";
-    readonly SLOT_UNAVAILABLE: "SLOT_UNAVAILABLE";
-    readonly BOOKING_CONFLICT: "BOOKING_CONFLICT";
-    readonly SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND";
-    readonly OUT_OF_STOCK: "OUT_OF_STOCK";
-    readonly INSUFFICIENT_QUANTITY: "INSUFFICIENT_QUANTITY";
-};
-type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
-/** API error structure */
-interface ApiError {
-    code: string;
-    message: string;
-    retryable: boolean;
-}
-interface ErrorHint {
-    docs_url: string;
-    suggestion: string;
-}
-declare const ERROR_HINTS: Record<string, ErrorHint>;
-/**
- * Custom error class for SDK errors with typed error codes.
- *
- * @example
- * ```typescript
- * try {
- *   await client.cart.addItem({ item_id: "prod_123" });
- * } catch (error) {
- *   if (isCimplifyError(error)) {
- *     switch (error.code) {
- *       case ErrorCode.ITEM_UNAVAILABLE:
- *         toast.error("This item is no longer available");
- *         break;
- *       case ErrorCode.VARIANT_OUT_OF_STOCK:
- *         toast.error("Selected option is out of stock");
- *         break;
- *       default:
- *         toast.error(error.message);
- *     }
- *   }
- * }
- * ```
- */
-declare class CimplifyError extends Error {
-    code: string;
-    retryable: boolean;
-    docs_url?: string | undefined;
-    suggestion?: string | undefined;
-    constructor(code: string, message: string, retryable?: boolean, docs_url?: string | undefined, suggestion?: string | undefined);
-    /** User-friendly message safe to display */
-    get userMessage(): string;
-}
-/** Type guard for CimplifyError */
-declare function isCimplifyError(error: unknown): error is CimplifyError;
-declare function getErrorHint(code: string): ErrorHint | undefined;
-declare function enrichError(error: CimplifyError, options?: {
-    isTestMode?: boolean;
-}): CimplifyError;
-/** Check if error is retryable */
-declare function isRetryableError(error: unknown): boolean;
-
-type PaymentStatus = "pending" | "processing" | "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";
-type PaymentProvider = "stripe" | "paystack" | "mtn" | "vodafone" | "airtel" | "cellulant" | "offline" | "cash" | "manual";
-type PaymentMethodType = "card" | "mobile_money" | "bank_transfer" | "cash" | "custom";
-/** Authorization types for payment verification (OTP, PIN, etc.) */
-type AuthorizationType = "otp" | "pin" | "phone" | "birthday" | "address";
-/** Payment processing state machine states (for UI) */
-type PaymentProcessingState = "initial" | "preparing" | "processing" | "verifying" | "awaiting_authorization" | "success" | "error" | "timeout";
-interface PaymentMethod {
-    type: PaymentMethodType;
-    provider?: string;
-    phone_number?: string;
-    card_last_four?: string;
-    custom_value?: string;
-}
-interface Payment {
-    id: string;
-    order_id: string;
-    business_id: string;
-    amount: Money;
-    currency: CurrencyCode;
-    payment_method: PaymentMethod;
-    status: PaymentStatus;
-    provider: PaymentProvider;
-    provider_reference?: string;
-    failure_reason?: string;
-    created_at: string;
-    updated_at: string;
-}
-interface InitializePaymentResult {
-    payment_id: string;
-    status: PaymentStatus;
-    redirect_url?: string;
-    authorization_url?: string;
-    reference: string;
-    provider: PaymentProvider;
-}
-/** Normalized payment response from checkout or payment initialization */
-interface PaymentResponse {
-    method: string;
-    provider: string;
-    requires_action: boolean;
-    public_key?: string;
-    client_secret?: string;
-    access_code?: string;
-    redirect_url?: string;
-    transaction_id?: string;
-    order_id?: string;
-    reference?: string;
-    metadata?: Record<string, unknown>;
-    instructions?: string;
-    display_text?: string;
-    requires_authorization?: boolean;
-    authorization_type?: AuthorizationType;
-    provider_payment_id?: string;
-}
-/** Payment status polling response */
-interface PaymentStatusResponse {
-    status: PaymentStatus;
-    paid: boolean;
-    amount?: Money;
-    currency?: CurrencyCode;
-    reference?: string;
-    message?: string;
-}
-interface PaymentErrorDetails {
-    code: string;
-    message: string;
-    recoverable: boolean;
-    technical?: string;
-}
-interface SubmitAuthorizationInput {
-    reference: string;
-    auth_type: AuthorizationType;
-    value: string;
-}
-
-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-Cu75tmUc.d.ts

@@ -1,196 +0,0 @@
-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;
-    limit?: number;
-    offset?: number;
-}
-/** Pagination metadata in response */
-interface Pagination {
-    total_count: number;
-    current_page: number;
-    page_size: number;
-    total_pages: number;
-}
-/** Strongly-typed error codes for better DX */
-declare const ErrorCode: {
-    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
-    readonly NETWORK_ERROR: "NETWORK_ERROR";
-    readonly TIMEOUT: "TIMEOUT";
-    readonly UNAUTHORIZED: "UNAUTHORIZED";
-    readonly FORBIDDEN: "FORBIDDEN";
-    readonly NOT_FOUND: "NOT_FOUND";
-    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
-    readonly CART_EMPTY: "CART_EMPTY";
-    readonly CART_EXPIRED: "CART_EXPIRED";
-    readonly CART_NOT_FOUND: "CART_NOT_FOUND";
-    readonly ITEM_UNAVAILABLE: "ITEM_UNAVAILABLE";
-    readonly VARIANT_NOT_FOUND: "VARIANT_NOT_FOUND";
-    readonly VARIANT_OUT_OF_STOCK: "VARIANT_OUT_OF_STOCK";
-    readonly ADDON_REQUIRED: "ADDON_REQUIRED";
-    readonly ADDON_MAX_EXCEEDED: "ADDON_MAX_EXCEEDED";
-    readonly CHECKOUT_VALIDATION_FAILED: "CHECKOUT_VALIDATION_FAILED";
-    readonly DELIVERY_ADDRESS_REQUIRED: "DELIVERY_ADDRESS_REQUIRED";
-    readonly CUSTOMER_INFO_REQUIRED: "CUSTOMER_INFO_REQUIRED";
-    readonly PAYMENT_FAILED: "PAYMENT_FAILED";
-    readonly PAYMENT_CANCELLED: "PAYMENT_CANCELLED";
-    readonly INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
-    readonly CARD_DECLINED: "CARD_DECLINED";
-    readonly INVALID_OTP: "INVALID_OTP";
-    readonly OTP_EXPIRED: "OTP_EXPIRED";
-    readonly AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED";
-    readonly PAYMENT_ACTION_NOT_COMPLETED: "PAYMENT_ACTION_NOT_COMPLETED";
-    readonly SLOT_UNAVAILABLE: "SLOT_UNAVAILABLE";
-    readonly BOOKING_CONFLICT: "BOOKING_CONFLICT";
-    readonly SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND";
-    readonly OUT_OF_STOCK: "OUT_OF_STOCK";
-    readonly INSUFFICIENT_QUANTITY: "INSUFFICIENT_QUANTITY";
-};
-type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
-/** API error structure */
-interface ApiError {
-    code: string;
-    message: string;
-    retryable: boolean;
-}
-interface ErrorHint {
-    docs_url: string;
-    suggestion: string;
-}
-declare const ERROR_HINTS: Record<string, ErrorHint>;
-/**
- * Custom error class for SDK errors with typed error codes.
- *
- * @example
- * ```typescript
- * try {
- *   await client.cart.addItem({ item_id: "prod_123" });
- * } catch (error) {
- *   if (isCimplifyError(error)) {
- *     switch (error.code) {
- *       case ErrorCode.ITEM_UNAVAILABLE:
- *         toast.error("This item is no longer available");
- *         break;
- *       case ErrorCode.VARIANT_OUT_OF_STOCK:
- *         toast.error("Selected option is out of stock");
- *         break;
- *       default:
- *         toast.error(error.message);
- *     }
- *   }
- * }
- * ```
- */
-declare class CimplifyError extends Error {
-    code: string;
-    retryable: boolean;
-    docs_url?: string | undefined;
-    suggestion?: string | undefined;
-    constructor(code: string, message: string, retryable?: boolean, docs_url?: string | undefined, suggestion?: string | undefined);
-    /** User-friendly message safe to display */
-    get userMessage(): string;
-}
-/** Type guard for CimplifyError */
-declare function isCimplifyError(error: unknown): error is CimplifyError;
-declare function getErrorHint(code: string): ErrorHint | undefined;
-declare function enrichError(error: CimplifyError, options?: {
-    isTestMode?: boolean;
-}): CimplifyError;
-/** Check if error is retryable */
-declare function isRetryableError(error: unknown): boolean;
-
-type PaymentStatus = "pending" | "processing" | "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";
-type PaymentProvider = "stripe" | "paystack" | "mtn" | "vodafone" | "airtel" | "cellulant" | "offline" | "cash" | "manual";
-type PaymentMethodType = "card" | "mobile_money" | "bank_transfer" | "cash" | "custom";
-/** Authorization types for payment verification (OTP, PIN, etc.) */
-type AuthorizationType = "otp" | "pin" | "phone" | "birthday" | "address";
-/** Payment processing state machine states (for UI) */
-type PaymentProcessingState = "initial" | "preparing" | "processing" | "verifying" | "awaiting_authorization" | "success" | "error" | "timeout";
-interface PaymentMethod {
-    type: PaymentMethodType;
-    provider?: string;
-    phone_number?: string;
-    card_last_four?: string;
-    custom_value?: string;
-}
-interface Payment {
-    id: string;
-    order_id: string;
-    business_id: string;
-    amount: Money;
-    currency: CurrencyCode;
-    payment_method: PaymentMethod;
-    status: PaymentStatus;
-    provider: PaymentProvider;
-    provider_reference?: string;
-    failure_reason?: string;
-    created_at: string;
-    updated_at: string;
-}
-interface InitializePaymentResult {
-    payment_id: string;
-    status: PaymentStatus;
-    redirect_url?: string;
-    authorization_url?: string;
-    reference: string;
-    provider: PaymentProvider;
-}
-/** Normalized payment response from checkout or payment initialization */
-interface PaymentResponse {
-    method: string;
-    provider: string;
-    requires_action: boolean;
-    public_key?: string;
-    client_secret?: string;
-    access_code?: string;
-    redirect_url?: string;
-    transaction_id?: string;
-    order_id?: string;
-    reference?: string;
-    metadata?: Record<string, unknown>;
-    instructions?: string;
-    display_text?: string;
-    requires_authorization?: boolean;
-    authorization_type?: AuthorizationType;
-    provider_payment_id?: string;
-}
-/** Payment status polling response */
-interface PaymentStatusResponse {
-    status: PaymentStatus;
-    paid: boolean;
-    amount?: Money;
-    currency?: CurrencyCode;
-    reference?: string;
-    message?: string;
-}
-interface PaymentErrorDetails {
-    code: string;
-    message: string;
-    recoverable: boolean;
-    technical?: string;
-}
-interface SubmitAuthorizationInput {
-    reference: string;
-    auth_type: AuthorizationType;
-    value: string;
-}
-
-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 };