@cimplify/sdk 0.6.6 → 0.6.8

package/dist/{client-CUFdFugo.d.mts → client-D4vA6FY_.d.ts}

@@ -1,4 +1,4 @@
-import { M as Money, c as CimplifyError, h as AuthorizationType, k as PaymentMethod, I as InitializePaymentResult, S as SubmitAuthorizationInput, n as PaymentStatusResponse } from './payment-D-u3asA8.mjs';
+import { M as Money, C as CurrencyCode, h as CimplifyError, q as AuthorizationType, s as PaymentMethod, I as InitializePaymentResult, S as SubmitAuthorizationInput, v as PaymentStatusResponse } from './payment-Cu75tmUc.js';
 
 /**
  * Observability hooks for monitoring SDK behavior.
@@ -50,6 +50,8 @@ interface RequestSuccessEvent extends RequestContext {
 interface RequestErrorEvent extends RequestContext {
     /** The error that occurred */
     error: Error;
+    /** HTTP status code (when available) */
+    status?: number;
     /** Duration in milliseconds */
     durationMs: number;
     /** Number of retries attempted before giving up */
@@ -84,7 +86,7 @@ interface ObservabilityHooks {
     onRequestStart?: (event: RequestStartEvent) => void;
     /** Called when a request completes successfully */
     onRequestSuccess?: (event: RequestSuccessEvent) => void;
-    /** Called when a request fails (after all retries exhausted) */
+    /** Called when a request fails (4xx/5xx responses or network errors after retries) */
     onRequestError?: (event: RequestErrorEvent) => void;
     /** Called before each retry attempt */
     onRetry?: (event: RetryEvent) => void;
@@ -152,7 +154,7 @@ interface Product {
     access_duration_days?: number;
     code_type?: string;
     code_value?: Money;
-    code_currency?: string;
+    code_currency?: CurrencyCode;
     duration_minutes?: number;
     preparation_time_minutes?: number;
     staff_required_count?: number;
@@ -613,7 +615,7 @@ interface ChosenPrice {
     markup_amount: Money;
     markup_discount_percentage: Money;
     markup_discount_amount: Money;
-    currency?: string;
+    currency?: CurrencyCode;
     custom_fields?: Record<string, unknown>;
     decision_path?: PriceDecisionPath;
     tax_info?: PricePathTaxInfo;
@@ -758,7 +760,7 @@ interface Cart {
     applied_discount_ids: string[];
     applied_discount_codes: string[];
     discount_details?: DiscountDetails;
-    currency: string;
+    currency: CurrencyCode;
     customer_name?: string;
     customer_email?: string;
     customer_phone?: string;
@@ -813,7 +815,7 @@ interface DisplayCart {
     total_items: number;
     tax_rate?: Money;
     service_charge_rate?: Money;
-    currency: string;
+    currency: CurrencyCode;
     channel: string;
     status: string;
     business_name: string;
@@ -888,7 +890,7 @@ interface UICartPricing {
     total_price: Money;
     tax_rate?: Money;
     service_charge_rate?: Money;
-    currency: string;
+    currency: CurrencyCode;
 }
 interface AddOnOptionDetails {
     id: string;
@@ -1015,7 +1017,7 @@ interface CartSummary {
     discount_amount: Money;
     tax_amount: Money;
     total: Money;
-    currency: string;
+    currency: CurrencyCode;
 }
 
 /**
@@ -1442,7 +1444,7 @@ interface Order {
     service_charge?: Money;
     tax?: Money;
     price_info: ChosenPrice;
-    currency: string;
+    currency: CurrencyCode;
     bill_token?: string;
     order_group_id?: string;
     paid_via_group: boolean;
@@ -1490,7 +1492,7 @@ interface OrderGroup {
     payment_status: OrderGroupPaymentState;
     split_method?: string;
     max_orders?: number;
-    currency?: string;
+    currency?: CurrencyCode;
     amount_to_pay: AmountToPay;
     metadata?: Record<string, unknown>;
 }
@@ -2004,7 +2006,7 @@ interface CheckoutFormData {
     idempotency_key?: string;
     /** Optional metadata passed through to the payment provider (e.g. success_url, cancel_url) */
     metadata?: Record<string, unknown>;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     fx_quote_id?: string;
 }
 interface CheckoutResult {
@@ -2020,10 +2022,10 @@ interface CheckoutResult {
     client_secret?: string;
     public_key?: string;
     fx?: {
-        base_currency: string;
-        base_amount: number;
-        pay_currency: string;
-        pay_amount: number;
+        base_currency: CurrencyCode;
+        base_amount: Money;
+        pay_currency: CurrencyCode;
+        pay_amount: Money;
         rate: number;
         quote_id: string;
     };
@@ -2046,7 +2048,7 @@ interface ProcessCheckoutOptions {
     scheduled_time?: string;
     tip_amount?: number;
     enroll_in_link?: boolean;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     timeout_ms?: number;
     on_status_change?: (status: CheckoutStatus, context: CheckoutStatusContext) => void;
 }
@@ -2057,12 +2059,14 @@ interface ProcessCheckoutResult {
         order_number: string;
         status: string;
         total: string;
-        currency: string;
+        currency: CurrencyCode;
     };
     error?: {
         code: string;
         message: string;
         recoverable: boolean;
+        docs_url?: string;
+        suggestion?: string;
     };
     enrolled_in_link?: boolean;
 }
@@ -2216,7 +2220,7 @@ interface Business {
     handle: string;
     business_type: BusinessType;
     email: string;
-    default_currency: string;
+    default_currency: CurrencyCode;
     default_phone?: string;
     default_address?: string;
     default_offers_table_service: boolean;
@@ -2254,7 +2258,7 @@ interface Location {
     phone?: string;
     address?: string;
     service_charge_rate?: number;
-    currency: string;
+    currency: CurrencyCode;
     capacity: number;
     status: string;
     enabled_payment_types?: string[];
@@ -2321,7 +2325,7 @@ interface StorefrontBootstrap {
     location?: Location;
     locations: Location[];
     categories: CategoryInfo[];
-    currency: string;
+    currency: CurrencyCode;
     is_open: boolean;
     accepts_orders: boolean;
     time_profiles?: LocationTimeProfile[];
@@ -2651,7 +2655,7 @@ interface Service {
     buffer_after_minutes: number;
     max_participants: number;
     price: Money;
-    currency: string;
+    currency: CurrencyCode;
     requires_staff: boolean;
     is_active: boolean;
     image_url?: string;
@@ -2871,24 +2875,24 @@ declare class LiteService {
 }
 
 interface FxQuoteRequest {
-    from: string;
-    to: string;
-    amount: number;
+    from: CurrencyCode;
+    to: CurrencyCode;
+    amount: Money;
 }
 interface FxQuote {
     id: string;
-    base_currency: string;
-    pay_currency: string;
+    base_currency: CurrencyCode;
+    pay_currency: CurrencyCode;
     rate: number;
     inverse_rate: number;
-    base_amount: number;
-    converted_amount: number;
+    base_amount: Money;
+    converted_amount: Money;
     quoted_at: string;
     valid_until: string;
 }
 interface FxRateResponse {
-    from: string;
-    to: string;
+    from: CurrencyCode;
+    to: CurrencyCode;
     rate: number;
     inverse_rate: number;
     quoted_at: string;
@@ -2898,7 +2902,7 @@ interface FxRateResponse {
 declare class FxService {
     private client;
     constructor(client: CimplifyClient);
-    getRate(from: string, to: string): Promise<Result<FxRateResponse, CimplifyError>>;
+    getRate(from: CurrencyCode, to: CurrencyCode): Promise<Result<FxRateResponse, CimplifyError>>;
     lockQuote(request: FxQuoteRequest): Promise<Result<FxQuote, CimplifyError>>;
 }
 
@@ -2945,7 +2949,7 @@ interface ElementOptions {
     mode?: "shipping" | "billing";
     prefillEmail?: string;
     amount?: number;
-    currency?: string;
+    currency?: CurrencyCode;
 }
 interface AddressInfo {
     id?: string;
@@ -3026,7 +3030,7 @@ type ParentToIframeMessage = {
     notes?: string;
     scheduled_time?: string;
     tip_amount?: number;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     enroll_in_link?: boolean;
     address?: AddressInfo;
     customer: ElementsCustomerInfo;
@@ -3082,7 +3086,7 @@ type IframeToParentMessage = {
         order_number: string;
         status: string;
         total: string;
-        currency: string;
+        currency: CurrencyCode;
     };
     error?: {
         code: string;
@@ -3117,6 +3121,7 @@ declare class CimplifyElements {
     private paymentData;
     private checkoutInProgress;
     private activeCheckoutAbort;
+    private hasWarnedMissingAuthElement;
     private boundHandleMessage;
     private businessIdResolvePromise;
     constructor(client: CimplifyClient, businessId?: string, options?: ElementsOptions);
@@ -3208,6 +3213,7 @@ declare class CimplifyClient {
     setSessionToken(token: string | null): void;
     getAccessToken(): string | null;
     getPublicKey(): string;
+    isTestMode(): boolean;
     setAccessToken(token: string | null): void;
     clearSession(): void;
     /** Set the active location/branch for all subsequent requests */

package/dist/{client-CjqNbEM6.d.ts → client-FQUyv41r.d.mts}

@@ -1,4 +1,4 @@
-import { M as Money, c as CimplifyError, h as AuthorizationType, k as PaymentMethod, I as InitializePaymentResult, S as SubmitAuthorizationInput, n as PaymentStatusResponse } from './payment-D-u3asA8.js';
+import { M as Money, C as CurrencyCode, h as CimplifyError, q as AuthorizationType, s as PaymentMethod, I as InitializePaymentResult, S as SubmitAuthorizationInput, v as PaymentStatusResponse } from './payment-Cu75tmUc.mjs';
 
 /**
  * Observability hooks for monitoring SDK behavior.
@@ -50,6 +50,8 @@ interface RequestSuccessEvent extends RequestContext {
 interface RequestErrorEvent extends RequestContext {
     /** The error that occurred */
     error: Error;
+    /** HTTP status code (when available) */
+    status?: number;
     /** Duration in milliseconds */
     durationMs: number;
     /** Number of retries attempted before giving up */
@@ -84,7 +86,7 @@ interface ObservabilityHooks {
     onRequestStart?: (event: RequestStartEvent) => void;
     /** Called when a request completes successfully */
     onRequestSuccess?: (event: RequestSuccessEvent) => void;
-    /** Called when a request fails (after all retries exhausted) */
+    /** Called when a request fails (4xx/5xx responses or network errors after retries) */
     onRequestError?: (event: RequestErrorEvent) => void;
     /** Called before each retry attempt */
     onRetry?: (event: RetryEvent) => void;
@@ -152,7 +154,7 @@ interface Product {
     access_duration_days?: number;
     code_type?: string;
     code_value?: Money;
-    code_currency?: string;
+    code_currency?: CurrencyCode;
     duration_minutes?: number;
     preparation_time_minutes?: number;
     staff_required_count?: number;
@@ -613,7 +615,7 @@ interface ChosenPrice {
     markup_amount: Money;
     markup_discount_percentage: Money;
     markup_discount_amount: Money;
-    currency?: string;
+    currency?: CurrencyCode;
     custom_fields?: Record<string, unknown>;
     decision_path?: PriceDecisionPath;
     tax_info?: PricePathTaxInfo;
@@ -758,7 +760,7 @@ interface Cart {
     applied_discount_ids: string[];
     applied_discount_codes: string[];
     discount_details?: DiscountDetails;
-    currency: string;
+    currency: CurrencyCode;
     customer_name?: string;
     customer_email?: string;
     customer_phone?: string;
@@ -813,7 +815,7 @@ interface DisplayCart {
     total_items: number;
     tax_rate?: Money;
     service_charge_rate?: Money;
-    currency: string;
+    currency: CurrencyCode;
     channel: string;
     status: string;
     business_name: string;
@@ -888,7 +890,7 @@ interface UICartPricing {
     total_price: Money;
     tax_rate?: Money;
     service_charge_rate?: Money;
-    currency: string;
+    currency: CurrencyCode;
 }
 interface AddOnOptionDetails {
     id: string;
@@ -1015,7 +1017,7 @@ interface CartSummary {
     discount_amount: Money;
     tax_amount: Money;
     total: Money;
-    currency: string;
+    currency: CurrencyCode;
 }
 
 /**
@@ -1442,7 +1444,7 @@ interface Order {
     service_charge?: Money;
     tax?: Money;
     price_info: ChosenPrice;
-    currency: string;
+    currency: CurrencyCode;
     bill_token?: string;
     order_group_id?: string;
     paid_via_group: boolean;
@@ -1490,7 +1492,7 @@ interface OrderGroup {
     payment_status: OrderGroupPaymentState;
     split_method?: string;
     max_orders?: number;
-    currency?: string;
+    currency?: CurrencyCode;
     amount_to_pay: AmountToPay;
     metadata?: Record<string, unknown>;
 }
@@ -2004,7 +2006,7 @@ interface CheckoutFormData {
     idempotency_key?: string;
     /** Optional metadata passed through to the payment provider (e.g. success_url, cancel_url) */
     metadata?: Record<string, unknown>;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     fx_quote_id?: string;
 }
 interface CheckoutResult {
@@ -2020,10 +2022,10 @@ interface CheckoutResult {
     client_secret?: string;
     public_key?: string;
     fx?: {
-        base_currency: string;
-        base_amount: number;
-        pay_currency: string;
-        pay_amount: number;
+        base_currency: CurrencyCode;
+        base_amount: Money;
+        pay_currency: CurrencyCode;
+        pay_amount: Money;
         rate: number;
         quote_id: string;
     };
@@ -2046,7 +2048,7 @@ interface ProcessCheckoutOptions {
     scheduled_time?: string;
     tip_amount?: number;
     enroll_in_link?: boolean;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     timeout_ms?: number;
     on_status_change?: (status: CheckoutStatus, context: CheckoutStatusContext) => void;
 }
@@ -2057,12 +2059,14 @@ interface ProcessCheckoutResult {
         order_number: string;
         status: string;
         total: string;
-        currency: string;
+        currency: CurrencyCode;
     };
     error?: {
         code: string;
         message: string;
         recoverable: boolean;
+        docs_url?: string;
+        suggestion?: string;
     };
     enrolled_in_link?: boolean;
 }
@@ -2216,7 +2220,7 @@ interface Business {
     handle: string;
     business_type: BusinessType;
     email: string;
-    default_currency: string;
+    default_currency: CurrencyCode;
     default_phone?: string;
     default_address?: string;
     default_offers_table_service: boolean;
@@ -2254,7 +2258,7 @@ interface Location {
     phone?: string;
     address?: string;
     service_charge_rate?: number;
-    currency: string;
+    currency: CurrencyCode;
     capacity: number;
     status: string;
     enabled_payment_types?: string[];
@@ -2321,7 +2325,7 @@ interface StorefrontBootstrap {
     location?: Location;
     locations: Location[];
     categories: CategoryInfo[];
-    currency: string;
+    currency: CurrencyCode;
     is_open: boolean;
     accepts_orders: boolean;
     time_profiles?: LocationTimeProfile[];
@@ -2651,7 +2655,7 @@ interface Service {
     buffer_after_minutes: number;
     max_participants: number;
     price: Money;
-    currency: string;
+    currency: CurrencyCode;
     requires_staff: boolean;
     is_active: boolean;
     image_url?: string;
@@ -2871,24 +2875,24 @@ declare class LiteService {
 }
 
 interface FxQuoteRequest {
-    from: string;
-    to: string;
-    amount: number;
+    from: CurrencyCode;
+    to: CurrencyCode;
+    amount: Money;
 }
 interface FxQuote {
     id: string;
-    base_currency: string;
-    pay_currency: string;
+    base_currency: CurrencyCode;
+    pay_currency: CurrencyCode;
     rate: number;
     inverse_rate: number;
-    base_amount: number;
-    converted_amount: number;
+    base_amount: Money;
+    converted_amount: Money;
     quoted_at: string;
     valid_until: string;
 }
 interface FxRateResponse {
-    from: string;
-    to: string;
+    from: CurrencyCode;
+    to: CurrencyCode;
     rate: number;
     inverse_rate: number;
     quoted_at: string;
@@ -2898,7 +2902,7 @@ interface FxRateResponse {
 declare class FxService {
     private client;
     constructor(client: CimplifyClient);
-    getRate(from: string, to: string): Promise<Result<FxRateResponse, CimplifyError>>;
+    getRate(from: CurrencyCode, to: CurrencyCode): Promise<Result<FxRateResponse, CimplifyError>>;
     lockQuote(request: FxQuoteRequest): Promise<Result<FxQuote, CimplifyError>>;
 }
 
@@ -2945,7 +2949,7 @@ interface ElementOptions {
     mode?: "shipping" | "billing";
     prefillEmail?: string;
     amount?: number;
-    currency?: string;
+    currency?: CurrencyCode;
 }
 interface AddressInfo {
     id?: string;
@@ -3026,7 +3030,7 @@ type ParentToIframeMessage = {
     notes?: string;
     scheduled_time?: string;
     tip_amount?: number;
-    pay_currency?: string;
+    pay_currency?: CurrencyCode;
     enroll_in_link?: boolean;
     address?: AddressInfo;
     customer: ElementsCustomerInfo;
@@ -3082,7 +3086,7 @@ type IframeToParentMessage = {
         order_number: string;
         status: string;
         total: string;
-        currency: string;
+        currency: CurrencyCode;
     };
     error?: {
         code: string;
@@ -3117,6 +3121,7 @@ declare class CimplifyElements {
     private paymentData;
     private checkoutInProgress;
     private activeCheckoutAbort;
+    private hasWarnedMissingAuthElement;
     private boundHandleMessage;
     private businessIdResolvePromise;
     constructor(client: CimplifyClient, businessId?: string, options?: ElementsOptions);
@@ -3208,6 +3213,7 @@ declare class CimplifyClient {
     setSessionToken(token: string | null): void;
     getAccessToken(): string | null;
     getPublicKey(): string;
+    isTestMode(): boolean;
     setAccessToken(token: string | null): void;
     clearSession(): void;
     /** Set the active location/branch for all subsequent requests */

package/dist/{index-CJ9GkIXf.d.mts → index-DaKJxoEh.d.mts}

@@ -1,10 +1,11 @@
-import { o as PaymentErrorDetails, m as PaymentResponse, n as PaymentStatusResponse } from './payment-D-u3asA8.mjs';
+import { C as CurrencyCode, M as Money, w as PaymentErrorDetails, u as PaymentResponse, v as PaymentStatusResponse } from './payment-Cu75tmUc.mjs';
 
 /**
  * Price Types
  *
  * Types for price parsing, formatting, and display utilities.
  */
+
 /**
  * Individual tax component (e.g., VAT, NHIL, GETFund)
  */
@@ -41,7 +42,7 @@ interface PriceInfo {
     /** Markup amount if applicable */
     markup_amount?: number;
     /** Currency code (e.g., "GHS", "USD") */
-    currency?: string;
+    currency?: CurrencyCode;
     /** Tax information */
     tax_info?: TaxInfo;
     /** Decision path showing pricing adjustments */
@@ -61,14 +62,14 @@ interface ProductWithPrice {
     /** Default/indicative price in plain field form */
     default_price?: number | string | null;
     /** Currency in plain field form */
-    currency?: string | null;
+    currency?: CurrencyCode | null;
 }
 /**
  * Options for price formatting functions
  */
 interface FormatPriceOptions {
     /** Currency code (default: "GHS") */
-    currency?: string;
+    currency?: CurrencyCode;
     /** Locale for Intl.NumberFormat (default: "en-US") */
     locale?: string;
     /** Minimum fraction digits (default: 2) */
@@ -81,7 +82,7 @@ interface FormatPriceOptions {
  */
 interface FormatCompactOptions {
     /** Currency code (default: "GHS") */
-    currency?: string;
+    currency?: CurrencyCode;
     /** Number of decimal places for compact notation (default: 1) */
     decimals?: number;
 }
@@ -128,7 +129,7 @@ declare const CURRENCY_SYMBOLS: Record<string, string>;
  * getCurrencySymbol('GHS') // "GH₵"
  * getCurrencySymbol('XYZ') // "XYZ"
  */
-declare function getCurrencySymbol(currencyCode: string): string;
+declare function getCurrencySymbol(currencyCode: CurrencyCode): string;
 /**
  * Format a number compactly with K/M/B suffixes
  * @param value - Number to format
@@ -156,7 +157,7 @@ declare function formatNumberCompact(value: number, decimals?: number): string;
  * formatPrice('29.99', 'EUR')    // "€29.99"
  * formatPrice(1234.56, 'USD', 'de-DE') // "1.234,56 $"
  */
-declare function formatPrice(amount: number | string, currency?: string, locale?: string): string;
+declare function formatPrice(amount: number | Money, currency?: CurrencyCode, locale?: string): string;
 /**
  * Format a price with +/- sign for adjustments
  * Useful for showing price changes, modifiers, or discounts
@@ -171,7 +172,7 @@ declare function formatPrice(amount: number | string, currency?: string, locale?
  * formatPriceAdjustment(-3.50, 'GHS') // "-GH₵3.50"
  * formatPriceAdjustment(0, 'EUR')     // "€0.00"
  */
-declare function formatPriceAdjustment(amount: number, currency?: string, locale?: string): string;
+declare function formatPriceAdjustment(amount: number, currency?: CurrencyCode, locale?: string): string;
 /**
  * Format a price compactly for large numbers
  * Uses K/M/B suffixes for thousands, millions, billions
@@ -187,7 +188,7 @@ declare function formatPriceAdjustment(amount: number, currency?: string, locale
  * formatPriceCompact(2500000, 'USD')   // "$2.5M"
  * formatPriceCompact(1200000000, 'EUR') // "€1.2B"
  */
-declare function formatPriceCompact(amount: number | string, currency?: string, decimals?: number): string;
+declare function formatPriceCompact(amount: number | Money, currency?: CurrencyCode, decimals?: number): string;
 /**
  * Simple currency symbol + amount format
  * Lighter alternative to formatPrice without Intl
@@ -200,7 +201,7 @@ declare function formatPriceCompact(amount: number | string, currency?: string,
  * formatMoney(29.99, 'USD') // "$29.99"
  * formatMoney('15.00', 'GHS') // "GH₵15.00"
  */
-declare function formatMoney(amount: string | number, currency?: string): string;
+declare function formatMoney(amount: Money | number, currency?: CurrencyCode): string;
 /**
  * Parse a price string or number to a numeric value
  * Handles various input formats gracefully
@@ -215,7 +216,7 @@ declare function formatMoney(amount: string | number, currency?: string): string
  * parsePrice(undefined) // 0
  * parsePrice('invalid') // 0
  */
-declare function parsePrice(value: string | number | undefined | null): number;
+declare function parsePrice(value: Money | string | number | undefined | null): number;
 /**
  * Get the display price from a product.
  * Prefers quote-aware price_info, then plain price fields.
@@ -273,7 +274,7 @@ declare function getMarkupPercentage(product: ProductWithPrice): number;
  * @param product - Product with price data
  * @returns Currency code (default: "GHS")
  */
-declare function getProductCurrency(product: ProductWithPrice): string;
+declare function getProductCurrency(product: ProductWithPrice): CurrencyCode;
 /**
  * Format a product's display price
  * Convenience function combining getDisplayPrice and formatPrice