@cimplify/sdk 0.6.11 → 0.6.12

package/dist/payment-CLIWNMaP.d.mts

@@ -0,0 +1,1133 @@
+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;
+    has_more: boolean;
+    next_cursor?: string;
+}
+/** 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 QUOTE_NOT_FOUND: "QUOTE_NOT_FOUND";
+    readonly QUOTE_EXPIRED: "QUOTE_EXPIRED";
+    readonly QUOTE_CONSUMED: "QUOTE_CONSUMED";
+    readonly QUOTE_STORAGE_UNAVAILABLE: "QUOTE_STORAGE_UNAVAILABLE";
+    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 ProductType = "product" | "service" | "digital" | "bundle" | "composite";
+type ProductRenderHint = "food" | "physical" | "general";
+type InventoryType = "one_to_one" | "composition" | "none";
+type VariantStrategy = "fetch_all" | "use_axes";
+type DigitalProductType = "download" | "license_key" | "ticket" | "access_grant" | "redemption_code";
+type DepositType = "none" | "fixed" | "percentage";
+type SalesChannel = "pos" | "online" | "marketplace" | "partners";
+interface Product {
+    id: string;
+    business_id: string;
+    category_id?: string;
+    name: string;
+    slug: string;
+    description?: string;
+    image_url?: string;
+    default_price: Money;
+    /** Salesman tagged-union discriminant on catalogue browse responses. */
+    type?: ProductType;
+    product_type: ProductType;
+    /** Server-derived UI hint for conditional rendering. */
+    render_hint?: ProductRenderHint;
+    inventory_type: InventoryType;
+    variant_strategy: VariantStrategy;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    images?: string[];
+    calories?: number;
+    allergies?: string[];
+    recipe?: Record<string, unknown>;
+    sku?: string;
+    barcode?: string;
+    ean?: string;
+    upc?: string;
+    is_trackable?: boolean;
+    is_tracked?: boolean;
+    is_tracked_in_store?: boolean;
+    is_tracked_in_warehouse?: boolean;
+    inventory_threshold?: number;
+    external_id?: string;
+    external_source?: string;
+    download_url?: string;
+    digital_type?: DigitalProductType;
+    max_downloads?: number;
+    license_key_required?: boolean;
+    file_size_mb?: number;
+    file_hash?: string;
+    file_type?: string;
+    version?: string;
+    download_expires_days?: number;
+    license_key_format?: string;
+    max_activations?: number;
+    validity_days?: number;
+    event_id?: string;
+    event_date?: string;
+    venue?: string;
+    ticket_type?: string;
+    seat_info?: Record<string, unknown>;
+    access_type?: string;
+    access_level?: string;
+    access_duration_days?: number;
+    code_type?: string;
+    code_value?: Money;
+    code_currency?: CurrencyCode;
+    duration_minutes?: number;
+    preparation_time_minutes?: number;
+    staff_required_count?: number;
+    buffer_before_minutes?: number;
+    buffer_after_minutes?: number;
+    general_service_capacity?: number;
+    deposit_type?: DepositType;
+    deposit_amount?: Money;
+    cancellation_window_minutes?: number;
+    no_show_fee?: Money;
+    requires_specific_staff?: boolean;
+    requires_specific_resource?: boolean;
+    hs_code?: string;
+    mid_code?: string;
+    material?: string;
+    allow_backorder?: boolean;
+    item_condition?: string;
+    vendor?: string;
+    length_mm?: number;
+    width_mm?: number;
+    height_mm?: number;
+    channels?: SalesChannel[];
+    meta_title?: string;
+    meta_description?: string;
+    is_discountable?: boolean;
+    taxonomy_id?: string;
+}
+interface ProductWithDetails extends Product {
+    category?: Category;
+    variants?: ProductVariant[];
+    add_ons?: AddOnWithOptions[];
+    variant_axes?: VariantAxisWithValues[];
+    location_prices?: LocationProductPrice[];
+    location_availability?: ProductAvailability[];
+    time_profiles?: ProductTimeProfile[];
+}
+interface ProductVariant {
+    id: string;
+    name: string;
+    business_id: string;
+    product_id: string;
+    component_multiplier: Money;
+    price_adjustment: Money;
+    is_default: boolean;
+    created_at: string;
+    updated_at: string;
+    is_active?: boolean;
+    is_archived?: boolean;
+    is_deleted?: boolean;
+    inventory_threshold?: number;
+    images?: string[];
+    external_id?: string;
+    external_source?: string;
+    ean?: string;
+    upc?: string;
+    is_trackable?: boolean;
+    is_tracked?: boolean;
+    is_tracked_in_store?: boolean;
+    is_tracked_in_warehouse?: boolean;
+    sku?: string;
+    barcode?: string;
+    download_url?: string;
+    metadata?: Record<string, unknown>;
+    duration_minutes?: number;
+    max_downloads?: number;
+    license_key?: string;
+    display_attributes?: VariantDisplayAttribute[];
+}
+interface VariantDisplayAttribute {
+    axis_id: string;
+    axis_name: string;
+    value_id: string;
+    value_name: string;
+}
+interface VariantAxis {
+    id: string;
+    business_id: string;
+    product_id: string;
+    name: string;
+    display_order: number;
+    affects_recipe: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface VariantAxisWithValues extends VariantAxis {
+    values: VariantAxisValue[];
+}
+interface VariantAxisValue {
+    id: string;
+    business_id: string;
+    axis_id: string;
+    name: string;
+    display_order: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface ProductVariantValue {
+    variant_id: string;
+    axis_value_id: string;
+    business_id: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface VariantLocationAvailability {
+    id: string;
+    variant_id: string;
+    location_id: string;
+    business_id: string;
+    is_available: boolean;
+    is_in_stock: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+/** Input for selecting a variant by axis values */
+interface VariantAxisSelection {
+    [axisName: string]: string;
+}
+interface AddOn {
+    id: string;
+    business_id: string;
+    name: string;
+    is_multiple_allowed: boolean;
+    is_required: boolean;
+    is_mutually_exclusive: boolean;
+    min_selections?: number;
+    max_selections?: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface AddOnWithOptions extends AddOn {
+    options: AddOnOption[];
+}
+interface AddOnOption {
+    id: string;
+    add_on_id: string;
+    business_id: string;
+    name: string;
+    option_sku?: string;
+    default_price?: Money;
+    description?: string;
+    is_required: boolean;
+    is_mutually_exclusive: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface AddOnOptionPrice {
+    id: string;
+    add_on_option_id: string;
+    location_id: string;
+    business_id: string;
+    price: Money;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface ProductAddOn {
+    id: string;
+    business_id: string;
+    product_id: string;
+    add_on_id: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface Category {
+    id: string;
+    business_id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface CategorySummary extends Category {
+    product_count: number;
+}
+interface Collection {
+    id: string;
+    business_id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    tags?: string[];
+    image_url?: string;
+    channels?: SalesChannel[];
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface CollectionSummary extends Collection {
+    product_count: number;
+}
+interface CollectionProduct {
+    id: string;
+    collection_id: string;
+    product_id: string;
+    display_order?: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+type BundlePriceType = "fixed" | "percentage_discount" | "fixed_discount";
+interface Bundle {
+    id: string;
+    business_id: string;
+    product_id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    image_url?: string;
+    pricing_type: BundlePriceType;
+    bundle_price?: Money;
+    discount_value?: Money;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface BundleSummary extends Bundle {
+    product_count: number;
+}
+interface BundleProduct {
+    id: string;
+    bundle_id: string;
+    product_id: string;
+    variant_id?: string;
+    allow_variant_choice: boolean;
+    quantity: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface BundleWithDetails extends Bundle {
+    product: Product;
+    components: BundleComponentData[];
+    schedules?: ProductTimeProfile[];
+    availability?: Record<string, ProductAvailability>;
+}
+interface BundleComponentData {
+    component: BundleProduct;
+    product: Product;
+    variants: ProductVariant[];
+    variant_axes: VariantAxis[];
+    variant_axis_values: VariantAxisValue[];
+    product_variant_values: ProductVariantValue[];
+}
+interface BundleComponentInfo {
+    id: string;
+    product_id: string;
+    variant_id?: string;
+    quantity: number;
+}
+type CompositePricingMode = "additive" | "highest_per_group" | "highest_overall" | "tiered";
+type GroupPricingBehavior = "additive" | "first_n_free" | "flat_fee" | "highest_only";
+type ComponentSourceType = "product" | "stock" | "add_on" | "standalone";
+interface Composite {
+    id: string;
+    business_id: string;
+    product_id: string;
+    base_price: Money;
+    pricing_mode: CompositePricingMode;
+    min_order_quantity?: number;
+    max_order_quantity?: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface CompositeWithDetails extends Composite {
+    product: Product;
+    groups: ComponentGroupWithComponents[];
+}
+interface ComponentGroup {
+    id: string;
+    composite_id: string;
+    name: string;
+    description?: string;
+    display_order: number;
+    min_selections: number;
+    max_selections?: number;
+    allow_quantity: boolean;
+    max_quantity_per_component?: number;
+    pricing_behavior: GroupPricingBehavior;
+    pricing_behavior_config?: Record<string, unknown>;
+    icon?: string;
+    color?: string;
+    created_at: string;
+    updated_at: string;
+}
+interface ComponentGroupWithComponents extends ComponentGroup {
+    components: CompositeComponent[];
+}
+interface CompositeComponent {
+    id: string;
+    group_id: string;
+    product_id?: string;
+    variant_id?: string;
+    stock_id?: string;
+    add_on_id?: string;
+    add_on_option_id?: string;
+    display_name?: string;
+    display_description?: string;
+    display_image_url?: string;
+    price: Money;
+    price_per_additional?: Money;
+    quantity_per_selection?: Money;
+    waste_percentage?: Money;
+    calories?: number;
+    allergens?: string[];
+    display_order: number;
+    is_popular: boolean;
+    is_premium: boolean;
+    is_available: boolean;
+    is_archived: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** Input for calculating composite price or adding to cart */
+interface ComponentSelectionInput {
+    component_id: string;
+    quantity: number;
+    variant_id?: string;
+    add_on_option_id?: string;
+}
+/** Result of composite price calculation */
+interface CompositePriceResult {
+    base_price: Money;
+    components_total: Money;
+    tier_applied?: string;
+    final_price: Money;
+    breakdown: ComponentPriceBreakdown[];
+}
+interface ComponentPriceBreakdown {
+    component_id: string;
+    component_name: string;
+    quantity: number;
+    unit_price: Money;
+    total_price: Money;
+    group_id: string;
+    source_type: ComponentSourceType;
+    source_product_id?: string;
+    source_stock_id?: string;
+}
+type PriceEntryType = "base" | "location" | "time" | "channel";
+interface Price {
+    id: string;
+    product_id: string;
+    location_id: string;
+    business_id: string;
+    price: Money;
+    entry_type: PriceEntryType;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+type LocationProductPrice = Price;
+interface ProductAvailability {
+    id: string;
+    business_id: string;
+    location_id: string;
+    product_id: string;
+    is_available: boolean;
+    is_in_stock: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface ProductTimeProfile {
+    id: string;
+    business_id: string;
+    product_id: string;
+    day_of_week: number;
+    start_time: string;
+    end_time: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+
+type CartStatus = "active" | "converting" | "converted" | "expired" | "abandoned";
+type CartChannel = "qr" | "taker" | "staff" | "web" | "dashboard";
+type PriceSource = {
+    type: "default_item";
+} | {
+    type: "location_specific";
+    location_id: string;
+} | {
+    type: "variant";
+    variant_id: string;
+} | {
+    type: "composite";
+    composite_id: string;
+} | {
+    type: "custom";
+};
+type AdjustmentType = {
+    type: "location_based";
+    location_id: string;
+} | {
+    type: "variant_based";
+    variant_id: string;
+} | {
+    type: "time_based";
+} | {
+    type: "customer_segment";
+    segment_id: string;
+} | {
+    type: "customer_loyalty";
+    tier: string;
+} | {
+    type: "channel_markup";
+    channel: string;
+} | {
+    type: "discount";
+    discount_id: string;
+} | {
+    type: "bundle";
+    bundle_id: string;
+} | {
+    type: "manual";
+    reason: string;
+} | {
+    type: "time_limited_promotion";
+    promotion_id: string;
+    valid_until: string;
+};
+interface PriceAdjustment {
+    adjustment_type: AdjustmentType;
+    amount: Money;
+    percentage?: Money;
+    reason: string;
+    applied_at: string;
+}
+interface TaxPathComponent {
+    name: string;
+    rate: Money;
+}
+interface PricePathTaxInfo {
+    tax_rate: Money;
+    tax_amount: Money;
+    is_inclusive: boolean;
+    components: TaxPathComponent[];
+}
+interface PriceDecisionPath {
+    base_price_source: PriceSource;
+    adjustments: PriceAdjustment[];
+    context?: Record<string, unknown>;
+}
+interface ChosenPrice {
+    base_price: Money;
+    final_price: Money;
+    markup_percentage: Money;
+    markup_amount: Money;
+    markup_discount_percentage: Money;
+    markup_discount_amount: Money;
+    currency?: CurrencyCode;
+    custom_fields?: Record<string, unknown>;
+    decision_path?: PriceDecisionPath;
+    tax_info?: PricePathTaxInfo;
+}
+type BenefitType = "percentage" | "fixed_amount" | "free_item" | "buy_x_get_y";
+interface AppliedDiscount {
+    discount_id: string;
+    discount_code?: string;
+    discount_type: BenefitType;
+    discount_value: Money;
+    discount_amount: Money;
+    applied_at: string;
+}
+interface DiscountBreakdown {
+    item_discounts: Record<string, AppliedDiscount[]>;
+    order_discounts: AppliedDiscount[];
+}
+interface DiscountDetails {
+    discounts: AppliedDiscount[];
+    total_discount_amount: Money;
+    breakdown: DiscountBreakdown;
+}
+interface SelectedAddOnOption {
+    option_id: string;
+    add_on_id: string;
+    name: string;
+    price: Money;
+    quantity: number;
+    is_required: boolean;
+    selected_at: string;
+    price_info?: ChosenPrice;
+}
+interface AddOnDetails {
+    selected_options: SelectedAddOnOption[];
+    total_add_on_price: Money;
+    add_ons: CartAddOn[];
+}
+interface CartAddOn {
+    add_on_id: string;
+    name: string;
+    min_selections: number;
+    max_selections: number;
+    selected_options: string[];
+    is_required: boolean;
+}
+interface VariantDetails {
+    variant_id: string;
+    sku?: string;
+    properties: Record<string, string>;
+}
+interface BundleSelectionInput {
+    component_id: string;
+    variant_id?: string;
+    quantity: number;
+}
+interface BundleStoredSelection {
+    component_id: string;
+    product_id: string;
+    product_name: string;
+    variant_id?: string;
+    variant_name?: string;
+    quantity: number;
+    unit_price: Money;
+}
+interface BundleSelectionData {
+    bundle_id: string;
+    selections: BundleStoredSelection[];
+}
+interface CompositeStoredSelection {
+    component_id: string;
+    component_name: string;
+    quantity: number;
+    group_id: string;
+    source_type: "product" | "stock" | "add_on" | "standalone";
+    source_product_id?: string;
+    source_stock_id?: string;
+    unit_price: Money;
+}
+interface CompositePriceBreakdown {
+    base_price: Money;
+    components_total: Money;
+    tier_applied?: string;
+    final_price: Money;
+}
+interface CompositeSelectionData {
+    composite_id: string;
+    selections: CompositeStoredSelection[];
+    breakdown: CompositePriceBreakdown;
+}
+
+type LineConfiguration = {
+    type: "simple";
+    variant?: VariantDetails;
+    add_ons?: AddOnDetails;
+} | {
+    type: "service";
+    variant?: VariantDetails;
+    add_ons?: AddOnDetails;
+    scheduled_start?: string;
+    scheduled_end?: string;
+    confirmation_code?: string;
+    service_status?: string;
+    primary_staff_id?: string;
+    scheduling_metadata?: Record<string, unknown>;
+} | {
+    type: "bundle";
+    variant?: VariantDetails;
+    input: BundleSelectionInput[];
+    resolved?: BundleSelectionData;
+    add_ons?: AddOnDetails;
+} | {
+    type: "composite";
+    variant?: VariantDetails;
+    input: ComponentSelectionInput[];
+    resolved?: CompositeSelectionData;
+    add_ons?: AddOnDetails;
+} | {
+    type: "digital";
+    variant?: VariantDetails;
+    add_ons?: AddOnDetails;
+    digital_type?: string;
+    fulfillment_id?: string;
+};
+interface Cart {
+    id: string;
+    business_id: string;
+    customer_id?: string;
+    session_id?: string;
+    location_id?: string;
+    created_at: string;
+    updated_at: string;
+    expires_at: string;
+    subtotal: Money;
+    tax_amount: Money;
+    service_charge: Money;
+    total_discounts: Money;
+    total_price: Money;
+    total_items: number;
+    tax_rate?: Money;
+    service_charge_rate?: Money;
+    price_info: ChosenPrice;
+    applied_discount_ids: string[];
+    applied_discount_codes: string[];
+    discount_details?: DiscountDetails;
+    currency: CurrencyCode;
+    customer_name?: string;
+    customer_email?: string;
+    customer_phone?: string;
+    customer_address?: string;
+    source: string;
+    status: CartStatus;
+    channel: string;
+    order_id?: string;
+    metadata?: Record<string, unknown>;
+    items: CartItem[];
+}
+interface CartItem {
+    id: string;
+    cart_id: string;
+    item_id: string;
+    quantity: number;
+    line_key: string;
+    configuration: LineConfiguration;
+    price: Money;
+    add_ons_price: Money;
+    price_info: ChosenPrice;
+    applied_discount_ids: string[];
+    item_discount_amount: Money;
+    discount_details?: DiscountDetails;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface CartTotals {
+    subtotal: Money;
+    tax_amount: Money;
+    service_charge: Money;
+    total_discounts: Money;
+    total_price: Money;
+    tax_rate?: Money;
+    service_charge_rate?: Money;
+    applied_discount_ids: string[];
+    applied_discount_codes: string[];
+    discount_details?: DiscountDetails;
+}
+interface DisplayCart {
+    id: string;
+    business_id: string;
+    customer_id?: string;
+    session_id?: string;
+    location_id?: string;
+    subtotal: Money;
+    tax_amount: Money;
+    service_charge: Money;
+    total_discounts: Money;
+    total_price: Money;
+    total_items: number;
+    tax_rate?: Money;
+    service_charge_rate?: Money;
+    currency: CurrencyCode;
+    channel: string;
+    status: string;
+    business_name: string;
+    business_logo?: string;
+    location_name?: string;
+    customer_name?: string;
+    customer_email?: string;
+    customer_phone?: string;
+    customer_address?: string;
+    items: DisplayCartItem[];
+    applied_discount_codes: string[];
+    discount_details?: DiscountDetails;
+}
+interface DisplayCartItem {
+    id: string;
+    cart_id: string;
+    item_id: string;
+    quantity: number;
+    name: string;
+    description?: string;
+    image_url?: string;
+    category_name?: string;
+    is_available: boolean;
+    preparation_time?: number;
+    unit_price: Money;
+    total_price: Money;
+    add_ons_price: Money;
+    price_info: ChosenPrice;
+    item_discount_amount: Money;
+    discount_details?: DiscountDetails;
+    add_ons: DisplayAddOn[];
+    special_instructions?: string;
+}
+interface DisplayAddOn {
+    id: string;
+    name: string;
+    min_selections: number;
+    max_selections: number;
+    is_required: boolean;
+    selected_options: DisplayAddOnOption[];
+}
+interface DisplayAddOnOption {
+    id: string;
+    name: string;
+    price: Money;
+    quantity: number;
+    image_url?: string;
+    description?: string;
+}
+interface UICartBusiness {
+    name: string;
+    logo_url?: string;
+    contact_email?: string;
+    contact_phone?: string;
+}
+interface UICartLocation {
+    id?: string;
+    name?: string;
+}
+interface UICartCustomer {
+    id?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+}
+interface UICartPricing {
+    subtotal: Money;
+    tax_amount: Money;
+    service_charge: Money;
+    total_discounts: Money;
+    total_price: Money;
+    tax_rate?: Money;
+    service_charge_rate?: Money;
+    currency: CurrencyCode;
+}
+interface AddOnOptionDetails {
+    id: string;
+    name: string;
+    price?: Money;
+    is_required: boolean;
+    description?: string;
+    image_url?: string;
+}
+interface AddOnGroupDetails {
+    id: string;
+    name: string;
+    is_multiple_allowed: boolean;
+    min_selections: number;
+    max_selections: number;
+    required: boolean;
+    options: AddOnOptionDetails[];
+}
+interface VariantDetailsDTO {
+    id: string;
+    name: string;
+    price: Money;
+    price_adjustment: Money;
+    is_default: boolean;
+}
+interface CartItemDetails {
+    id: string;
+    cart_id: string;
+    item_id: string;
+    quantity: number;
+    line_key: string;
+    line_type: "simple" | "service" | "bundle" | "composite" | "digital";
+    name: string;
+    description?: string;
+    image_url?: string;
+    category_id?: string;
+    category_name?: string;
+    is_available: boolean;
+    variant_id?: string;
+    variant_details?: VariantDetails;
+    variant_name?: string;
+    variant_info?: VariantDetailsDTO;
+    base_price: Money;
+    add_ons_price: Money;
+    total_price: Money;
+    item_discount_amount: Money;
+    price_info: ChosenPrice;
+    add_on_option_ids: string[];
+    add_on_ids: string[];
+    add_on_details: AddOnDetails;
+    add_on_options: AddOnOptionDetails[];
+    add_ons: AddOnGroupDetails[];
+    special_instructions?: string;
+    scheduled_start?: string;
+    scheduled_end?: string;
+    confirmation_code?: string;
+    service_status?: string;
+    staff_id?: string;
+    scheduling_metadata?: Record<string, unknown>;
+    bundle_selections?: BundleSelectionInput[];
+    bundle_resolved?: BundleSelectionData;
+    composite_selections?: ComponentSelectionInput[];
+    composite_resolved?: CompositeSelectionData;
+    applied_discount_ids: string[];
+    discount_details?: DiscountDetails;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+/** Enriched cart returned by cart#enriched - matches cart_dto.rs UICart */
+interface UICart {
+    id: string;
+    business_id: string;
+    session_id?: string;
+    customer_id?: string;
+    location_id?: string;
+    created_at: string;
+    updated_at: string;
+    expires_at: string;
+    status: string;
+    source: string;
+    channel: string;
+    business_details?: UICartBusiness;
+    location_details?: UICartLocation;
+    customer_info: UICartCustomer;
+    items: CartItemDetails[];
+    pricing: UICartPricing;
+    metadata?: Record<string, unknown>;
+}
+/** Envelope returned by cart#enriched query */
+interface UICartResponse {
+    cart: UICart;
+    cart_count: number;
+    message?: string | null;
+}
+interface AddToCartInput {
+    item_id: string;
+    quantity?: number;
+    variant_id?: string;
+    quote_id?: string;
+    add_on_options?: string[];
+    special_instructions?: string;
+    bundle_selections?: BundleSelectionInput[];
+    composite_selections?: ComponentSelectionInput[];
+    scheduled_start?: string;
+    scheduled_end?: string;
+    staff_id?: string;
+}
+interface UpdateCartItemInput {
+    quantity?: number;
+    variant_id?: string;
+    add_on_options?: string[];
+    notes?: string;
+    bundle_selections?: BundleSelectionInput[];
+    composite_selections?: ComponentSelectionInput[];
+    scheduled_start?: string;
+    scheduled_end?: string;
+    staff_id?: string;
+}
+interface CartSummary {
+    item_count: number;
+    total_items: number;
+    subtotal: Money;
+    discount_amount: Money;
+    tax_amount: Money;
+    total: Money;
+    currency: CurrencyCode;
+}
+
+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 CompositePricingMode as $, type ApiError as A, type AddOn as B, type CurrencyCode as C, type DigitalProductType as D, ErrorCode as E, type AddOnWithOptions as F, type AddOnOption as G, type AddOnOptionPrice as H, type InventoryType as I, type ProductAddOn as J, type Category as K, type CategorySummary as L, type Money as M, type Collection as N, type CollectionSummary as O, type PaginationParams as P, type CollectionProduct as Q, type BundlePriceType as R, type SalesChannel as S, type Bundle as T, type BundleSummary as U, type VariantStrategy as V, type BundleProduct as W, type BundleWithDetails as X, type BundleComponentData as Y, ZERO as Z, type BundleComponentInfo as _, moneyFromNumber as a, type PaymentProcessingState as a$, type GroupPricingBehavior as a0, type ComponentSourceType as a1, type Composite as a2, type CompositeWithDetails as a3, type ComponentGroup as a4, type ComponentGroupWithComponents as a5, type CompositeComponent as a6, type ComponentSelectionInput as a7, type CompositePriceResult as a8, type ComponentPriceBreakdown as a9, type CompositePriceBreakdown as aA, type CompositeSelectionData as aB, type LineConfiguration as aC, type Cart as aD, type CartItem as aE, type CartTotals as aF, type DisplayCart as aG, type DisplayCartItem as aH, type DisplayAddOn as aI, type DisplayAddOnOption as aJ, type UICartBusiness as aK, type UICartLocation as aL, type UICartCustomer as aM, type UICartPricing as aN, type AddOnOptionDetails as aO, type AddOnGroupDetails as aP, type VariantDetailsDTO as aQ, type CartItemDetails as aR, type UICart as aS, type UICartResponse as aT, type AddToCartInput as aU, type UpdateCartItemInput as aV, type CartSummary as aW, type PaymentStatus as aX, type PaymentProvider as aY, type PaymentMethodType as aZ, type AuthorizationType as a_, type PriceEntryType as aa, type Price as ab, type LocationProductPrice as ac, type ProductAvailability as ad, type ProductTimeProfile as ae, type CartStatus as af, type CartChannel as ag, type PriceSource as ah, type AdjustmentType as ai, type PriceAdjustment as aj, type TaxPathComponent as ak, type PricePathTaxInfo as al, type PriceDecisionPath as am, type ChosenPrice as an, type BenefitType as ao, type AppliedDiscount as ap, type DiscountBreakdown as aq, type DiscountDetails as ar, type SelectedAddOnOption as as, type AddOnDetails as at, type CartAddOn as au, type VariantDetails as av, type BundleSelectionInput as aw, type BundleStoredSelection as ax, type BundleSelectionData as ay, type CompositeStoredSelection as az, type Currency as b, type PaymentMethod as b0, type Payment as b1, type InitializePaymentResult as b2, type PaymentResponse as b3, type PaymentStatusResponse as b4, type PaymentErrorDetails as b5, type SubmitAuthorizationInput as b6, 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 ProductType as n, type ProductRenderHint as o, type DepositType as p, type Product as q, type ProductWithDetails as r, type ProductVariant as s, type VariantDisplayAttribute as t, type VariantAxis as u, type VariantAxisWithValues as v, type VariantAxisValue as w, type ProductVariantValue as x, type VariantLocationAvailability as y, type VariantAxisSelection as z };