@cimplify/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2620 @@
+/** Decimal value represented as string for precision */
+type Money = string;
+/** Supported currencies */
+type Currency = "GHS" | "USD" | "NGN" | "KES" | "ZAR" | string;
+/** 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;
+}
+/** API error structure */
+interface ApiError {
+    code: string;
+    message: string;
+    retryable: boolean;
+}
+/** Custom error class for SDK errors */
+declare class CimplifyError extends Error {
+    code: string;
+    retryable: boolean;
+    constructor(code: string, message: string, retryable?: boolean);
+}
+
+type ProductType = "product" | "service" | "digital" | "bundle" | "composite";
+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;
+    product_type: ProductType;
+    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?: string;
+    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>;
+}
+
+interface GetProductsOptions {
+    category?: string;
+    collection?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+    tags?: string[];
+    featured?: boolean;
+    in_stock?: boolean;
+    min_price?: number;
+    max_price?: number;
+    sort_by?: "name" | "price" | "created_at";
+    sort_order?: "asc" | "desc";
+}
+interface SearchOptions {
+    limit?: number;
+    category?: string;
+}
+declare class CatalogueQueries {
+    private client;
+    constructor(client: CimplifyClient);
+    getProducts(options?: GetProductsOptions): Promise<Product[]>;
+    getProduct(id: string): Promise<ProductWithDetails>;
+    getProductBySlug(slug: string): Promise<ProductWithDetails>;
+    getVariants(productId: string): Promise<ProductVariant[]>;
+    getVariantAxes(productId: string): Promise<VariantAxis[]>;
+    /**
+     * Find a variant by axis selections (e.g., { "Size": "Large", "Color": "Red" })
+     * Returns the matching variant or null if no match found.
+     */
+    getVariantByAxisSelections(productId: string, selections: VariantAxisSelection): Promise<ProductVariant | null>;
+    /**
+     * Get a specific variant by its ID
+     */
+    getVariantById(productId: string, variantId: string): Promise<ProductVariant>;
+    getAddOns(productId: string): Promise<AddOn[]>;
+    getCategories(): Promise<Category[]>;
+    getCategory(id: string): Promise<Category>;
+    getCategoryBySlug(slug: string): Promise<Category>;
+    getCategoryProducts(categoryId: string): Promise<Product[]>;
+    getCollections(): Promise<Collection[]>;
+    getCollection(id: string): Promise<Collection>;
+    getCollectionBySlug(slug: string): Promise<Collection>;
+    getCollectionProducts(collectionId: string): Promise<Product[]>;
+    searchCollections(query: string, limit?: number): Promise<Collection[]>;
+    getBundles(): Promise<Bundle[]>;
+    getBundle(id: string): Promise<BundleWithDetails>;
+    getBundleBySlug(slug: string): Promise<BundleWithDetails>;
+    searchBundles(query: string, limit?: number): Promise<Bundle[]>;
+    getComposites(options?: {
+        limit?: number;
+    }): Promise<Composite[]>;
+    getComposite(id: string): Promise<CompositeWithDetails>;
+    getCompositeByProductId(productId: string): Promise<CompositeWithDetails>;
+    calculateCompositePrice(compositeId: string, selections: ComponentSelectionInput[], locationId?: string): Promise<CompositePriceResult>;
+    search(query: string, options?: SearchOptions): Promise<Product[]>;
+    searchProducts(query: string, options?: SearchOptions): Promise<Product[]>;
+    getMenu(options?: {
+        category?: string;
+        limit?: number;
+    }): Promise<Product[]>;
+    getMenuCategory(categoryId: string): Promise<Product[]>;
+    getMenuItem(itemId: string): Promise<ProductWithDetails>;
+}
+
+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?: string;
+    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: string;
+    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: string;
+    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: string;
+}
+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>;
+}
+interface AddToCartInput {
+    item_id: string;
+    quantity?: number;
+    variant_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: string;
+}
+
+declare class CartOperations {
+    private client;
+    constructor(client: CimplifyClient);
+    /**
+     * Get the enriched cart with product names, images, and details.
+     * This is the main method for storefront display.
+     */
+    get(): Promise<UICart>;
+    getRaw(): Promise<Cart>;
+    getItems(): Promise<CartItem[]>;
+    getCount(): Promise<number>;
+    getTotal(): Promise<string>;
+    getSummary(): Promise<CartSummary>;
+    addItem(input: AddToCartInput): Promise<Cart>;
+    updateItem(cartItemId: string, updates: UpdateCartItemInput): Promise<Cart>;
+    updateQuantity(cartItemId: string, quantity: number): Promise<Cart>;
+    removeItem(cartItemId: string): Promise<Cart>;
+    clear(): Promise<Cart>;
+    applyCoupon(code: string): Promise<Cart>;
+    removeCoupon(): Promise<Cart>;
+    isEmpty(): Promise<boolean>;
+    hasItem(productId: string, variantId?: string): Promise<boolean>;
+    findItem(productId: string, variantId?: string): Promise<CartItem | undefined>;
+}
+
+type OrderStatus = "pending" | "created" | "confirmed" | "in_preparation" | "ready_to_serve" | "partially_served" | "served" | "delivered" | "picked_up" | "completed" | "cancelled" | "refunded";
+type PaymentState = "not_paid" | "paid" | "partially_refunded" | "refunded";
+type OrderChannel = "qr" | "taker" | "staff" | "web" | "dashboard";
+type LineType = "product" | "service" | "bundle" | "composite" | "digital";
+type OrderLineState = {
+    state: "pending";
+} | {
+    state: "in_preparation";
+} | {
+    state: "ready";
+} | {
+    state: "partially_served";
+    served_quantity: number;
+} | {
+    state: "served";
+} | {
+    state: "completed";
+} | {
+    state: "cancelled";
+    reason?: string;
+};
+interface OrderLineStatus {
+    state: OrderLineState;
+    quantity_ordered: number;
+    quantity_prepared: number;
+    quantity_served: number;
+    last_modified: string;
+    modified_by: string;
+}
+type FulfillmentType = "appointment" | "shipment" | "order" | "digital";
+type FulfillmentStatus = "pending" | "in_progress" | "completed" | "cancelled";
+interface FulfillmentLink {
+    fulfillment_type: FulfillmentType;
+    fulfillment_id: string;
+}
+interface OrderFulfillmentSummary {
+    total_items: number;
+    pending_items: number;
+    in_progress_items: number;
+    completed_items: number;
+    cancelled_items: number;
+    all_complete: boolean;
+    any_in_progress: boolean;
+}
+type FeeBearerType = "customer" | "business" | "split";
+interface AmountToPay {
+    customer_pays: Money;
+    business_receives: Money;
+    cimplify_receives: Money;
+    provider_receives: Money;
+    fee_bearer: FeeBearerType;
+}
+interface LineItem {
+    id: string;
+    order_id: string;
+    product_id: string;
+    line_key: string;
+    quantity: number;
+    configuration: LineConfiguration;
+    price: Money;
+    add_ons_price: Money;
+    price_info: ChosenPrice;
+    item_discount_amount: Money;
+    discount_details?: DiscountDetails;
+    created_at: string;
+    updated_at: string;
+    line_state: OrderLineStatus;
+    metadata?: Record<string, unknown>;
+    fulfillment_type?: FulfillmentType;
+    fulfillment_id?: string;
+}
+interface Order {
+    id: string;
+    business_id: string;
+    channel: OrderChannel;
+    status: OrderStatus;
+    payment_state: PaymentState;
+    order_type: string;
+    placed_by?: string;
+    user_friendly_id: string;
+    customer_id?: string;
+    customer_name?: string;
+    customer_email?: string;
+    customer_phone?: string;
+    customer_notes?: string[];
+    discount_code?: string;
+    applied_discount_ids: string[];
+    applied_discount_codes: string[];
+    discount_details?: DiscountDetails;
+    delivery_address?: string;
+    tracking_token?: string;
+    tracking_link?: string;
+    pickup_time?: string;
+    created_at: string;
+    updated_at: string;
+    delivered_at?: string;
+    fulfilled_at?: string;
+    confirmed_at?: string;
+    served_at?: string;
+    completed_at?: string;
+    cancelled_at?: string;
+    table_number?: string;
+    room_number?: string;
+    location_id?: string;
+    was_placed_by_staff: boolean;
+    modified_by_staff: boolean;
+    delivery_required: boolean;
+    customer_will_pick_up: boolean;
+    total_price: Money;
+    total_excl_tax_discount_and_service_charge: Money;
+    total_discount: Money;
+    service_charge?: Money;
+    tax?: Money;
+    price_info: ChosenPrice;
+    currency: string;
+    bill_token?: string;
+    order_group_id?: string;
+    paid_via_group: boolean;
+    amount_to_pay: AmountToPay;
+    served_by?: string;
+    metadata?: Record<string, unknown>;
+    requires_scheduling: boolean;
+    all_items_scheduled: boolean;
+    earliest_service_time?: string;
+    latest_service_time?: string;
+    deposit_required: boolean;
+    deposit_amount: Money;
+    deposit_paid_amount: Money;
+    balance_due: Money;
+    deposit_due_date?: string;
+    final_payment_due_date?: string;
+    version: number;
+    total_quantity: number;
+    items: LineItem[];
+    computed_payment_status?: string;
+    is_service_only?: boolean;
+}
+interface OrderHistory {
+    id: string;
+    order_id: string;
+    modified_by: string;
+    modification_type: string;
+    modification_details: string;
+    modified_at: string;
+    metadata?: Record<string, unknown>;
+}
+type OrderGroupPaymentState = "not_paid" | "partially_paid" | "fully_paid" | "refunded";
+interface OrderGroup {
+    id: string;
+    business_id: string;
+    location_id: string;
+    table_number: string;
+    created_at: string;
+    updated_at: string;
+    status: string;
+    is_split: boolean;
+    is_closed: boolean;
+    total_amount?: Money;
+    paid_amount?: Money;
+    payment_status: OrderGroupPaymentState;
+    split_method?: string;
+    max_orders?: number;
+    currency?: string;
+    amount_to_pay: AmountToPay;
+    metadata?: Record<string, unknown>;
+}
+interface OrderGroupPayment {
+    id: string;
+    order_group_id: string;
+    order_id?: string;
+    amount: Money;
+    payment_method: string;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface OrderSplitDetail {
+    order_id: string;
+    amount: Money;
+    paid_amount?: Money;
+    remaining_amount?: Money;
+}
+interface OrderGroupPaymentSummary {
+    total_amount: Money;
+    paid_amount: Money;
+    remaining_amount: Money;
+    split_details?: OrderSplitDetail[];
+}
+interface OrderGroupDetails {
+    order_group: OrderGroup;
+    orders: Order[];
+    total: Money;
+    payments: OrderGroupPayment[];
+    payment_summary: OrderGroupPaymentSummary;
+}
+interface OrderPaymentEvent {
+    id: string;
+    order_id: string;
+    amount: Money;
+    reference: string;
+    created_at: string;
+    event_type: string;
+    provider?: string;
+    metadata?: Record<string, unknown>;
+}
+interface OrderFilter {
+    location_id?: string;
+    table_number?: string;
+    order_type?: string;
+    status?: string;
+    from?: string;
+    to?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+interface CheckoutInput {
+    customer_name?: string;
+    customer_email?: string;
+    customer_phone?: string;
+    delivery_address?: string;
+    order_type?: string;
+    notes?: string;
+    table_number?: string;
+    room_number?: string;
+}
+interface UpdateOrderStatusInput {
+    status: OrderStatus;
+    notes?: string;
+}
+interface CancelOrderInput {
+    reason?: string;
+}
+interface RefundOrderInput {
+    amount?: Money;
+    reason?: string;
+}
+type ServiceStatus = "awaiting_scheduling" | "scheduled" | "deposit_paid" | "confirmed" | "in_progress" | "completed" | "rescheduled" | "no_show" | "cancelled";
+type StaffRole = "primary" | "assistant" | "specialist" | "supervisor";
+type ReminderMethod = "sms" | "email" | "push" | "call" | "whatsapp";
+interface CustomerServicePreferences {
+    preferred_staff_ids: string[];
+    avoid_staff_ids: string[];
+    room_type?: string;
+    accessibility_needs: string[];
+    temperature_preference?: string;
+    music_preference?: string;
+    special_requests?: string;
+    previous_service_history: string[];
+}
+interface BufferTimes {
+    before_minutes: number;
+    after_minutes: number;
+    travel_time_minutes?: number;
+    setup_time_minutes?: number;
+    cleanup_time_minutes?: number;
+}
+interface ReminderSettings {
+    send_24h_reminder: boolean;
+    send_2h_reminder: boolean;
+    send_30min_reminder: boolean;
+    reminder_phone?: string;
+    reminder_email?: string;
+    reminder_method: ReminderMethod;
+    custom_reminder_message?: string;
+}
+interface CancellationPolicy {
+    free_cancellation_hours: number;
+    partial_refund_hours: number;
+    no_refund_hours: number;
+    cancellation_fee?: Money;
+    reschedule_allowed: boolean;
+    reschedule_fee?: Money;
+    max_reschedules?: number;
+}
+interface ServiceNotes {
+    preparation_notes?: string;
+    staff_notes?: string;
+    internal_notes?: string;
+    customer_history: string[];
+    allergies_warnings: string[];
+}
+interface PricingOverrides {
+    custom_duration_minutes?: number;
+    price_adjustment?: Money;
+    discount_reason?: string;
+    surge_pricing_multiplier?: Money;
+    loyalty_discount?: Money;
+    package_deal_reference?: string;
+}
+interface SchedulingMetadata {
+    customer_preferences?: CustomerServicePreferences;
+    buffer_times?: BufferTimes;
+    reminder_settings?: ReminderSettings;
+    cancellation_policy?: CancellationPolicy;
+    service_notes?: ServiceNotes;
+    pricing_overrides?: PricingOverrides;
+}
+interface StaffAssignment {
+    staff_id: string;
+    role: StaffRole;
+    assigned_at: string;
+    notes?: string;
+}
+interface ResourceAssignment {
+    resource_id: string;
+    quantity: number;
+    assigned_at: string;
+    notes?: string;
+}
+interface SchedulingResult {
+    confirmation_code: string;
+    assigned_staff: StaffAssignment[];
+    assigned_resources: ResourceAssignment[];
+    deposit_required: boolean;
+    deposit_amount?: Money;
+    total_duration_minutes: number;
+}
+interface DepositResult {
+    order_confirmed: boolean;
+    balance_due: Money;
+    final_payment_due?: string;
+    confirmation_sent: boolean;
+}
+interface ServiceScheduleRequest {
+    line_item_id: string;
+    start_time: string;
+    end_time: string;
+    preferred_staff_ids?: string[];
+    resource_requirements?: string[];
+    customer_notes?: string;
+}
+interface StaffScheduleItem {
+    line_item_id: string;
+    order_id: string;
+    customer_name: string;
+    service_name: string;
+    start_time: string;
+    end_time: string;
+    confirmation_code: string;
+    service_status: ServiceStatus;
+    notes?: string;
+}
+interface LocationAppointment {
+    line_item_id: string;
+    order_id: string;
+    customer_name: string;
+    service_name: string;
+    start_time: string;
+    end_time: string;
+    assigned_staff: string[];
+    assigned_resources: string[];
+    service_status: ServiceStatus;
+}
+
+type PaymentStatus = "pending" | "processing" | "success" | "failed" | "refunded" | "captured" | "cancelled";
+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: Currency;
+    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: "pending" | "processing" | "success" | "failed";
+    paid: boolean;
+    amount?: Money;
+    currency?: string;
+    reference?: string;
+    message?: string;
+}
+interface PaymentErrorDetails {
+    code: string;
+    message: string;
+    recoverable: boolean;
+    technical?: string;
+}
+interface SubmitAuthorizationInput {
+    reference: string;
+    auth_type: AuthorizationType;
+    value: string;
+}
+
+type MobileMoneyProvider = "mtn" | "vodafone" | "airtel";
+interface Customer {
+    id: string;
+    email: string | null;
+    phone: string | null;
+    name: string;
+    delivery_address: string | null;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface CustomerAddress {
+    id: string;
+    customer_id: string;
+    label: string;
+    street_address: string;
+    apartment: string | null;
+    city: string;
+    region: string;
+    postal_code: string | null;
+    country: string | null;
+    delivery_instructions: string | null;
+    phone_for_delivery: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    is_default: boolean | null;
+    usage_count: number | null;
+    last_used_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface CustomerMobileMoney {
+    id: string;
+    customer_id: string;
+    phone_number: string;
+    provider: MobileMoneyProvider;
+    label: string;
+    is_verified: boolean | null;
+    verification_date: string | null;
+    is_default: boolean | null;
+    usage_count: number | null;
+    last_used_at: string | null;
+    success_rate: number | null;
+    created_at: string;
+    updated_at: string;
+}
+interface CustomerLinkPreferences {
+    customer_id: string;
+    is_link_enabled: boolean | null;
+    enrolled_at: string | null;
+    enrollment_business_id: string | null;
+    preferred_order_type: string | null;
+    default_address_id: string | null;
+    default_mobile_money_id: string | null;
+    remember_me: boolean | null;
+    session_duration_days: number | null;
+    two_factor_enabled: boolean | null;
+    notify_on_order: boolean | null;
+    notify_on_payment: boolean | null;
+    created_at: string;
+    updated_at: string;
+}
+interface LinkData {
+    customer: Customer;
+    addresses: CustomerAddress[];
+    mobile_money: CustomerMobileMoney[];
+    preferences: CustomerLinkPreferences;
+    default_address: CustomerAddress | null;
+    default_mobile_money: CustomerMobileMoney | null;
+}
+interface CreateAddressInput {
+    address_line1: string;
+    address_line2?: string;
+    city: string;
+    state?: string;
+    postal_code?: string;
+    country: string;
+    label?: string;
+}
+interface UpdateAddressInput {
+    address_id: string;
+    address_line1?: string;
+    address_line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country?: string;
+    label?: string;
+}
+interface CreateMobileMoneyInput {
+    phone_number: string;
+    provider: string;
+    account_name?: string;
+}
+interface EnrollmentData {
+    contact: string;
+    name?: string;
+}
+interface AddressData {
+    label: string;
+    street_address: string;
+    apartment?: string;
+    city: string;
+    region: string;
+    delivery_instructions?: string;
+    phone_for_delivery?: string;
+}
+interface MobileMoneyData {
+    phone_number: string;
+    provider: string;
+    label: string;
+}
+interface EnrollAndLinkOrderInput {
+    order_id: string;
+    business_id: string;
+    address?: AddressData;
+    mobile_money?: MobileMoneyData;
+    order_type?: string;
+}
+interface LinkStatusResult {
+    is_link_customer: boolean;
+}
+interface LinkEnrollResult {
+    success: boolean;
+    customer_id: string;
+    contact?: string;
+    enrolled_at?: string;
+    preferences?: CustomerLinkPreferences;
+}
+interface EnrollAndLinkOrderResult {
+    success: boolean;
+    customer_id: string;
+    order_id: string;
+    enrollment_result: unknown;
+    linked_at: string;
+}
+type DeviceType = "mobile" | "desktop" | "tablet";
+interface LinkSession {
+    id: string;
+    device_name: string | null;
+    device_type: DeviceType | null;
+    ip_address: string | null;
+    last_used_at: string | null;
+    created_at: string;
+    is_current: boolean;
+}
+interface RevokeSessionResult {
+    success: boolean;
+    session_id: string;
+    message: string;
+}
+interface RevokeAllSessionsResult {
+    success: boolean;
+    revoked_count: number;
+    message: string;
+}
+type ContactType = "phone" | "email";
+interface RequestOtpInput {
+    contact: string;
+    contact_type: ContactType;
+}
+interface VerifyOtpInput {
+    contact: string;
+    contact_type: ContactType;
+    otp_code: string;
+}
+interface AuthResponse {
+    success: boolean;
+    session_token: string | null;
+    customer_id: string | null;
+    message: string;
+}
+
+type CheckoutMode = "link" | "guest";
+type CheckoutOrderType = "delivery" | "pickup" | "dine-in" | "walk-in";
+type CheckoutPaymentMethod = "mobile_money" | "card";
+type CheckoutStep = "authentication" | "order_details" | "payment_method" | "payment" | "confirmation";
+type PickupTimeType = "asap" | "scheduled";
+interface PickupTime {
+    type: PickupTimeType;
+    scheduled_time?: string;
+}
+interface CheckoutAddressInfo {
+    street_address?: string;
+    apartment?: string;
+    city?: string;
+    region?: string;
+    postal_code?: string;
+    country?: string;
+    delivery_instructions?: string;
+    phone_for_delivery?: string;
+    pickup_time?: string;
+    guest_count?: number;
+    seating_time?: string;
+    seating_requests?: string;
+}
+interface MobileMoneyDetails {
+    phone_number: string;
+    provider: MobileMoneyProvider;
+    provider_other?: string;
+}
+interface CheckoutCustomerInfo {
+    name: string;
+    email: string;
+    phone: string;
+    notes?: string;
+    save_details: boolean;
+}
+interface CheckoutFormData {
+    cart_id: string;
+    customer: CheckoutCustomerInfo;
+    order_type: CheckoutOrderType;
+    address_info: CheckoutAddressInfo;
+    payment_method: string;
+    mobile_money_details?: MobileMoneyDetails;
+    special_instructions?: string;
+    link_address_id?: string;
+    link_payment_method_id?: string;
+    idempotency_key?: string;
+}
+interface CheckoutResult {
+    order_id: string;
+    order_number: string;
+    payment_reference?: string;
+    payment_status: string;
+    requires_authorization: boolean;
+    authorization_type?: AuthorizationType;
+    authorization_url?: string;
+    display_text?: string;
+    provider?: string;
+}
+
+declare class CheckoutService {
+    private client;
+    constructor(client: CimplifyClient);
+    process(data: CheckoutFormData): Promise<CheckoutResult>;
+    initializePayment(orderId: string, method: PaymentMethod): Promise<InitializePaymentResult>;
+    submitAuthorization(input: SubmitAuthorizationInput): Promise<CheckoutResult>;
+    pollPaymentStatus(orderId: string): Promise<PaymentStatusResponse>;
+    updateOrderCustomer(orderId: string, customer: CheckoutCustomerInfo): Promise<Order>;
+    verifyPayment(orderId: string): Promise<Order>;
+}
+
+interface GetOrdersOptions {
+    status?: OrderStatus;
+    limit?: number;
+    offset?: number;
+}
+declare class OrderQueries {
+    private client;
+    constructor(client: CimplifyClient);
+    list(options?: GetOrdersOptions): Promise<Order[]>;
+    get(orderId: string): Promise<Order>;
+    getRecent(limit?: number): Promise<Order[]>;
+    getByStatus(status: OrderStatus): Promise<Order[]>;
+    cancel(orderId: string, reason?: string): Promise<Order>;
+}
+
+interface SuccessResult {
+    success: boolean;
+    message?: string;
+}
+declare class LinkService {
+    private client;
+    constructor(client: CimplifyClient);
+    requestOtp(input: RequestOtpInput): Promise<SuccessResult>;
+    verifyOtp(input: VerifyOtpInput): Promise<AuthResponse>;
+    logout(): Promise<SuccessResult>;
+    checkStatus(contact: string): Promise<LinkStatusResult>;
+    getLinkData(): Promise<LinkData>;
+    getAddresses(): Promise<CustomerAddress[]>;
+    getMobileMoney(): Promise<CustomerMobileMoney[]>;
+    getPreferences(): Promise<CustomerLinkPreferences>;
+    enroll(data: EnrollmentData): Promise<LinkEnrollResult>;
+    enrollAndLinkOrder(data: EnrollAndLinkOrderInput): Promise<EnrollAndLinkOrderResult>;
+    updatePreferences(preferences: Partial<CustomerLinkPreferences>): Promise<SuccessResult>;
+    createAddress(input: CreateAddressInput): Promise<CustomerAddress>;
+    updateAddress(input: UpdateAddressInput): Promise<SuccessResult>;
+    deleteAddress(addressId: string): Promise<SuccessResult>;
+    setDefaultAddress(addressId: string): Promise<SuccessResult>;
+    trackAddressUsage(addressId: string): Promise<SuccessResult>;
+    createMobileMoney(input: CreateMobileMoneyInput): Promise<CustomerMobileMoney>;
+    deleteMobileMoney(mobileMoneyId: string): Promise<SuccessResult>;
+    setDefaultMobileMoney(mobileMoneyId: string): Promise<SuccessResult>;
+    trackMobileMoneyUsage(mobileMoneyId: string): Promise<SuccessResult>;
+    verifyMobileMoney(mobileMoneyId: string): Promise<SuccessResult>;
+    getSessions(): Promise<LinkSession[]>;
+    revokeSession(sessionId: string): Promise<RevokeSessionResult>;
+    revokeAllSessions(): Promise<RevokeAllSessionsResult>;
+    getAddressesRest(): Promise<CustomerAddress[]>;
+    createAddressRest(input: CreateAddressInput): Promise<CustomerAddress>;
+    deleteAddressRest(addressId: string): Promise<SuccessResult>;
+    setDefaultAddressRest(addressId: string): Promise<SuccessResult>;
+    getMobileMoneyRest(): Promise<CustomerMobileMoney[]>;
+    createMobileMoneyRest(input: CreateMobileMoneyInput): Promise<CustomerMobileMoney>;
+    deleteMobileMoneyRest(mobileMoneyId: string): Promise<SuccessResult>;
+    setDefaultMobileMoneyRest(mobileMoneyId: string): Promise<SuccessResult>;
+}
+
+interface AuthStatus {
+    is_authenticated: boolean;
+    customer?: Customer;
+    session_expires_at?: string;
+}
+interface OtpResult {
+    customer: Customer;
+    session_token?: string;
+}
+interface UpdateProfileInput {
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+interface ChangePasswordInput {
+    current_password: string;
+    new_password: string;
+}
+declare class AuthService {
+    private client;
+    constructor(client: CimplifyClient);
+    getStatus(): Promise<AuthStatus>;
+    getCurrentUser(): Promise<Customer | null>;
+    isAuthenticated(): Promise<boolean>;
+    requestOtp(contact: string, contactType?: "phone" | "email"): Promise<void>;
+    verifyOtp(code: string, contact?: string): Promise<OtpResult>;
+    logout(): Promise<{
+        success: boolean;
+    }>;
+    updateProfile(input: UpdateProfileInput): Promise<Customer>;
+    changePassword(input: ChangePasswordInput): Promise<{
+        success: boolean;
+    }>;
+    resetPassword(email: string): Promise<{
+        success: boolean;
+    }>;
+}
+
+type BusinessType = "eatery" | "retail" | "service" | "other" | "system" | "unset";
+interface BusinessPreferences {
+    [key: string]: unknown;
+}
+interface Business {
+    id: string;
+    name: string;
+    handle: string;
+    business_type: BusinessType;
+    email: string;
+    default_currency: string;
+    default_phone?: string;
+    default_address?: string;
+    default_offers_table_service: boolean;
+    default_accepts_online_orders: boolean;
+    image?: string;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    subscription_id?: string;
+    owner_id?: string;
+    created_by: string;
+    preferences: BusinessPreferences;
+    is_online_only: boolean;
+    enabled_payment_types: string[];
+    default_location_settings: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface LocationTaxBehavior {
+    is_tax_inclusive: boolean;
+    tax_rate: Money;
+}
+interface LocationTaxOverrides {
+    [productId: string]: {
+        tax_rate: Money;
+        is_exempt: boolean;
+    };
+}
+interface Location {
+    id: string;
+    business_id: string;
+    name: string;
+    location?: string;
+    phone?: string;
+    address?: string;
+    service_charge_rate?: number;
+    currency: string;
+    capacity: number;
+    status: string;
+    enabled_payment_types?: string[];
+    offers_table_service: boolean;
+    accepts_online_orders: boolean;
+    created_at: string;
+    updated_at: string;
+    preferences?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    country_code: string;
+    timezone: string;
+    tax_behavior?: LocationTaxBehavior;
+    tax_overrides?: LocationTaxOverrides;
+}
+interface TimeRange {
+    start: string;
+    end: string;
+}
+type TimeRanges = TimeRange[];
+interface LocationTimeProfile {
+    id: string;
+    business_id: string;
+    location_id: string;
+    day: string;
+    is_open: boolean;
+    hours: TimeRanges;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface Table {
+    id: string;
+    business_id: string;
+    location_id: string;
+    table_number: string;
+    capacity: number;
+    occupied: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface Room {
+    id: string;
+    business_id: string;
+    location_id: string;
+    name: string;
+    capacity: number;
+    status: string;
+    floor?: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface ServiceCharge {
+    percentage?: Money;
+    is_mandatory?: boolean;
+    description?: string;
+    applies_to_parties_of?: number;
+    minimum_amount?: Money;
+    maximum_amount?: Money;
+}
+interface StorefrontBootstrap {
+    business: Business;
+    location?: Location;
+    locations: Location[];
+    categories: CategoryInfo[];
+    currency: string;
+    is_open: boolean;
+    accepts_orders: boolean;
+    time_profiles?: LocationTimeProfile[];
+}
+interface BusinessWithLocations extends Business {
+    locations: Location[];
+    default_location?: Location;
+}
+interface LocationWithDetails extends Location {
+    time_profiles: LocationTimeProfile[];
+    tables: Table[];
+    rooms: Room[];
+    is_open_now: boolean;
+    next_open_time?: string;
+}
+/** Settings for frontend display (derived from Business/Location) */
+interface BusinessSettings {
+    accept_online_orders: boolean;
+    accept_reservations: boolean;
+    require_customer_account: boolean;
+    enable_tips: boolean;
+    enable_loyalty: boolean;
+    minimum_order_amount?: string;
+    delivery_fee?: string;
+    free_delivery_threshold?: string;
+    tax_rate?: number;
+    tax_inclusive: boolean;
+}
+/** Business hours (simplified for frontend) */
+interface BusinessHours {
+    business_id: string;
+    location_id?: string;
+    day_of_week: number;
+    open_time: string;
+    close_time: string;
+    is_closed: boolean;
+}
+/** Category summary for bootstrap (minimal fields) */
+interface CategoryInfo {
+    id: string;
+    name: string;
+    slug: string;
+}
+
+declare class BusinessService {
+    private client;
+    constructor(client: CimplifyClient);
+    getInfo(): Promise<Business>;
+    getByHandle(handle: string): Promise<Business>;
+    getByDomain(domain: string): Promise<Business>;
+    getSettings(): Promise<BusinessSettings>;
+    getTheme(): Promise<Record<string, unknown>>;
+    getLocations(): Promise<Location[]>;
+    getLocation(locationId: string): Promise<Location>;
+    getHours(): Promise<BusinessHours[]>;
+    getLocationHours(locationId: string): Promise<BusinessHours[]>;
+    getBootstrap(): Promise<StorefrontBootstrap>;
+}
+
+type StockOwnershipType = "owned" | "consignment" | "dropship";
+type StockStatus = "in_stock" | "low_stock" | "out_of_stock";
+interface Stock {
+    id: string;
+    business_id: string;
+    name: string;
+    sku?: string;
+    barcode?: string;
+    unit_type: string;
+    unit_cost?: Money;
+    description?: string;
+    image_url?: string;
+    tags?: string[];
+    categories?: string[];
+    is_taxable: boolean;
+    tax_rate?: Money;
+    is_expirable: boolean;
+    ownership_type: StockOwnershipType;
+    quantity_on_hand: Money;
+    quantity_allocated: Money;
+    quantity_reserved: Money;
+    min_order_quantity: Money;
+    reorder_point?: Money;
+    reorder_quantity?: Money;
+    last_counted_at?: string;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface StockLevel {
+    product_id: string;
+    variant_id?: string;
+    location_id?: string;
+    quantity: number;
+    reserved_quantity: number;
+    available_quantity: number;
+    low_stock_threshold?: number;
+    status: StockStatus;
+    last_updated: string;
+}
+interface ProductStock {
+    product_id: string;
+    product_name: string;
+    total_quantity: number;
+    available_quantity: number;
+    reserved_quantity: number;
+    status: StockStatus;
+    variants?: VariantStock[];
+    locations?: LocationStock[];
+}
+interface VariantStock {
+    variant_id: string;
+    variant_name: string;
+    sku?: string;
+    quantity: number;
+    available_quantity: number;
+    status: StockStatus;
+}
+interface LocationStock {
+    location_id: string;
+    location_name: string;
+    quantity: number;
+    available_quantity: number;
+    status: StockStatus;
+}
+interface AvailabilityCheck {
+    product_id: string;
+    variant_id?: string;
+    location_id?: string;
+    requested_quantity: number;
+}
+interface AvailabilityResult {
+    product_id: string;
+    variant_id?: string;
+    is_available: boolean;
+    available_quantity: number;
+    requested_quantity: number;
+    shortfall?: number;
+}
+interface InventorySummary {
+    total_products: number;
+    in_stock_count: number;
+    low_stock_count: number;
+    out_of_stock_count: number;
+    total_value?: Money;
+}
+
+declare class InventoryService {
+    private client;
+    constructor(client: CimplifyClient);
+    getStockLevels(): Promise<StockLevel[]>;
+    getProductStock(productId: string, locationId?: string): Promise<ProductStock>;
+    getVariantStock(variantId: string, locationId?: string): Promise<StockLevel>;
+    checkProductAvailability(productId: string, quantity: number, locationId?: string): Promise<AvailabilityResult>;
+    checkVariantAvailability(variantId: string, quantity: number, locationId?: string): Promise<AvailabilityResult>;
+    checkMultipleAvailability(items: {
+        product_id: string;
+        variant_id?: string;
+        quantity: number;
+    }[], locationId?: string): Promise<AvailabilityResult[]>;
+    getSummary(): Promise<InventorySummary>;
+    isInStock(productId: string, locationId?: string): Promise<boolean>;
+    getAvailableQuantity(productId: string, locationId?: string): Promise<number>;
+}
+
+interface ServiceAvailabilityRule {
+    id: string;
+    business_id: string;
+    location_id: string;
+    item_id: string;
+    day_of_week: number;
+    start_time: string;
+    end_time: string;
+    capacity?: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface ServiceAvailabilityException {
+    id: string;
+    business_id: string;
+    location_id: string;
+    item_id: string;
+    exception_date: string;
+    is_closed: boolean;
+    start_time?: string;
+    end_time?: string;
+    capacity?: number;
+    reason?: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface StaffAvailabilityRule {
+    id: string;
+    staff_id: string;
+    location_id?: string;
+    day_of_week: number;
+    start_time: string;
+    end_time: string;
+    is_available: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface StaffAvailabilityException {
+    id: string;
+    staff_id: string;
+    location_id?: string;
+    exception_date: string;
+    is_unavailable_all_day: boolean;
+    start_time?: string;
+    end_time?: string;
+    reason?: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface ResourceAvailabilityRule {
+    id: string;
+    business_id: string;
+    location_id: string;
+    resource_id: string;
+    day_of_week: number;
+    start_time: string;
+    end_time: string;
+    is_available: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface ResourceAvailabilityException {
+    id: string;
+    business_id: string;
+    location_id: string;
+    resource_id: string;
+    exception_date: string;
+    is_unavailable_all_day: boolean;
+    start_time?: string;
+    end_time?: string;
+    reason?: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface StaffBookingProfile {
+    id: string;
+    staff_id: string;
+    skills?: string[];
+    can_be_booked: boolean;
+    default_service_duration_override?: number;
+    booking_buffer_minutes?: number;
+    max_daily_bookings?: number;
+    preferred_working_hours?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface ServiceStaffRequirement {
+    id: string;
+    service_item_id: string;
+    role_id?: string;
+    required_skill?: string;
+    number_of_staff: number;
+    specific_staff_assignment_required: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+interface BookingRequirementOverride {
+    id: string;
+    appointment_id: string;
+    overridden_by: string;
+    reason: string;
+    missing_staff_requirements?: Record<string, unknown>;
+    missing_resource_requirements?: Record<string, unknown>;
+    created_at: string;
+}
+interface ResourceType {
+    id: string;
+    business_id: string;
+    name: string;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+}
+interface Service {
+    id: string;
+    business_id: string;
+    product_id: string;
+    name: string;
+    description?: string;
+    duration_minutes: number;
+    buffer_before_minutes: number;
+    buffer_after_minutes: number;
+    max_participants: number;
+    price: Money;
+    currency: string;
+    requires_staff: boolean;
+    is_active: boolean;
+    image_url?: string;
+    category_id?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ServiceWithStaff extends Service {
+    available_staff: Staff[];
+}
+interface Staff {
+    id: string;
+    business_id: string;
+    name: string;
+    email?: string;
+    phone?: string;
+    avatar_url?: string;
+    bio?: string;
+    is_active: boolean;
+    services?: string[];
+}
+interface TimeSlot {
+    start_time: string;
+    end_time: string;
+    is_available: boolean;
+    staff_id?: string;
+    staff_name?: string;
+    remaining_capacity?: number;
+}
+interface AvailableSlot extends TimeSlot {
+    price?: Money;
+    duration_minutes: number;
+}
+interface DayAvailability {
+    date: string;
+    slots: TimeSlot[];
+    is_fully_booked: boolean;
+}
+type BookingStatus = "pending" | "confirmed" | "in_progress" | "completed" | "cancelled" | "no_show";
+interface Booking {
+    id: string;
+    business_id: string;
+    order_id: string;
+    line_item_id: string;
+    service_id: string;
+    service_name: string;
+    customer_id?: string;
+    customer_name?: string;
+    customer_phone?: string;
+    staff_id?: string;
+    staff_name?: string;
+    location_id?: string;
+    location_name?: string;
+    start_time: string;
+    end_time: string;
+    duration_minutes: number;
+    participant_count: number;
+    status: BookingStatus;
+    notes?: string;
+    cancellation_reason?: string;
+    cancelled_at?: string;
+    created_at: string;
+    updated_at: string;
+}
+interface BookingWithDetails extends Booking {
+    service: Service;
+    staff?: Staff;
+}
+interface GetAvailableSlotsInput {
+    service_id: string;
+    date: string;
+    participant_count?: number;
+    duration_minutes?: number;
+    staff_id?: string;
+    location_id?: string;
+}
+interface CheckSlotAvailabilityInput {
+    service_id: string;
+    slot_time: string;
+    duration_minutes?: number;
+    participant_count?: number;
+    staff_id?: string;
+}
+interface RescheduleBookingInput {
+    order_id: string;
+    line_item_id: string;
+    new_start_time: string;
+    new_end_time: string;
+    new_staff_id?: string;
+    reason?: string;
+}
+interface CancelBookingInput {
+    booking_id: string;
+    reason?: string;
+}
+interface ServiceAvailabilityParams {
+    service_id: string;
+    start_date: string;
+    end_date: string;
+    location_id?: string;
+    staff_id?: string;
+    participant_count?: number;
+}
+interface ServiceAvailabilityResult {
+    service_id: string;
+    days: DayAvailability[];
+}
+
+declare class SchedulingService {
+    private client;
+    constructor(client: CimplifyClient);
+    getServices(): Promise<Service[]>;
+    getService(serviceId: string): Promise<Service>;
+    getAvailableSlots(input: GetAvailableSlotsInput): Promise<AvailableSlot[]>;
+    checkSlotAvailability(input: CheckSlotAvailabilityInput): Promise<{
+        available: boolean;
+        reason?: string;
+    }>;
+    getServiceAvailability(params: ServiceAvailabilityParams): Promise<ServiceAvailabilityResult>;
+    getBooking(bookingId: string): Promise<BookingWithDetails>;
+    getCustomerBookings(): Promise<Booking[]>;
+    getUpcomingBookings(): Promise<Booking[]>;
+    getPastBookings(limit?: number): Promise<Booking[]>;
+    cancelBooking(input: CancelBookingInput): Promise<Booking>;
+    rescheduleBooking(input: RescheduleBookingInput): Promise<Booking>;
+    getNextAvailableSlot(serviceId: string, fromDate?: string): Promise<AvailableSlot | null>;
+    hasAvailabilityOn(serviceId: string, date: string): Promise<boolean>;
+}
+
+interface LiteBootstrap {
+    business: Business;
+    location: Location;
+    categories: Category[];
+    table?: TableInfo;
+    cart: Cart | null;
+    currency: string;
+    is_open: boolean;
+}
+interface TableInfo {
+    id: string;
+    number: string;
+    location_id: string;
+    capacity?: number;
+    status: "available" | "occupied" | "reserved";
+    current_order_id?: string;
+}
+interface KitchenOrderItem {
+    product_id: string;
+    quantity: number;
+    variant_id?: string;
+    modifiers?: string[];
+    notes?: string;
+}
+interface KitchenOrderResult {
+    success: boolean;
+    order_id: string;
+    order_number: string;
+    estimated_time_minutes?: number;
+}
+declare class LiteService {
+    private client;
+    constructor(client: CimplifyClient);
+    getBootstrap(): Promise<LiteBootstrap>;
+    getTable(tableId: string): Promise<TableInfo>;
+    getTableByNumber(tableNumber: string, locationId?: string): Promise<TableInfo>;
+    sendToKitchen(tableId: string, items: KitchenOrderItem[]): Promise<KitchenOrderResult>;
+    callWaiter(tableId: string, reason?: string): Promise<{
+        success: boolean;
+    }>;
+    requestBill(tableId: string): Promise<{
+        success: boolean;
+        order_id: string;
+    }>;
+    getMenu(): Promise<Product[]>;
+    getMenuByCategory(categoryId: string): Promise<Product[]>;
+}
+
+interface CimplifyConfig {
+    publicKey?: string;
+    credentials?: RequestCredentials;
+}
+declare class CimplifyClient {
+    private baseUrl;
+    private linkApiUrl;
+    private publicKey;
+    private credentials;
+    private sessionToken;
+    private _catalogue?;
+    private _cart?;
+    private _checkout?;
+    private _orders?;
+    private _link?;
+    private _auth?;
+    private _business?;
+    private _inventory?;
+    private _scheduling?;
+    private _lite?;
+    constructor(config?: CimplifyConfig);
+    getSessionToken(): string | null;
+    setSessionToken(token: string | null): void;
+    clearSession(): void;
+    private loadSessionToken;
+    private saveSessionToken;
+    private getHeaders;
+    private updateSessionFromResponse;
+    query<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    call<T = unknown>(method: string, args?: unknown): Promise<T>;
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
+    linkGet<T = unknown>(path: string): Promise<T>;
+    linkPost<T = unknown>(path: string, body?: unknown): Promise<T>;
+    linkDelete<T = unknown>(path: string): Promise<T>;
+    private handleRestResponse;
+    private handleResponse;
+    get catalogue(): CatalogueQueries;
+    get cart(): CartOperations;
+    get checkout(): CheckoutService;
+    get orders(): OrderQueries;
+    get link(): LinkService;
+    get auth(): AuthService;
+    get business(): BusinessService;
+    get inventory(): InventoryService;
+    get scheduling(): SchedulingService;
+    get lite(): LiteService;
+}
+declare function createCimplifyClient(config: CimplifyConfig): CimplifyClient;
+
+type Operator = "==" | "!=" | ">" | "<" | ">=" | "<=" | "contains" | "startsWith";
+type SortOrder = "asc" | "desc";
+declare class QueryBuilder {
+    private entity;
+    private filters;
+    private modifiers;
+    private pathSegments;
+    constructor(entity: string);
+    path(segment: string): this;
+    where(field: string, op: Operator, value: unknown): this;
+    and(field: string, op: Operator, value: unknown): this;
+    sort(field: string, order?: SortOrder): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    count(): this;
+    enriched(): this;
+    build(): string;
+    toString(): string;
+}
+declare function query(entity: string): QueryBuilder;
+
+declare const CHECKOUT_MODE: {
+    readonly LINK: "link";
+    readonly GUEST: "guest";
+};
+declare const ORDER_TYPE: {
+    readonly DELIVERY: "delivery";
+    readonly PICKUP: "pickup";
+    readonly DINE_IN: "dine-in";
+    readonly WALK_IN: "walk-in";
+};
+declare const PAYMENT_METHOD: {
+    readonly MOBILE_MONEY: "mobile_money";
+    readonly CARD: "card";
+};
+declare const CHECKOUT_STEP: {
+    readonly AUTHENTICATION: "authentication";
+    readonly ORDER_DETAILS: "order_details";
+    readonly PAYMENT_METHOD: "payment_method";
+    readonly PAYMENT: "payment";
+    readonly CONFIRMATION: "confirmation";
+};
+declare const PAYMENT_STATE: {
+    readonly INITIAL: "initial";
+    readonly PREPARING: "preparing";
+    readonly PROCESSING: "processing";
+    readonly VERIFYING: "verifying";
+    readonly AWAITING_AUTHORIZATION: "awaiting_authorization";
+    readonly SUCCESS: "success";
+    readonly ERROR: "error";
+    readonly TIMEOUT: "timeout";
+};
+declare const PICKUP_TIME_TYPE: {
+    readonly ASAP: "asap";
+    readonly SCHEDULED: "scheduled";
+};
+declare const MOBILE_MONEY_PROVIDER: {
+    readonly MTN: "mtn";
+    readonly VODAFONE: "vodafone";
+    readonly AIRTEL: "airtel";
+};
+declare const AUTHORIZATION_TYPE: {
+    readonly OTP: "otp";
+    readonly PIN: "pin";
+    readonly PHONE: "phone";
+    readonly BIRTHDAY: "birthday";
+    readonly ADDRESS: "address";
+};
+declare const LINK_QUERY: {
+    readonly DATA: "link.data";
+    readonly ADDRESSES: "link.addresses";
+    readonly MOBILE_MONEY: "link.mobile_money";
+    readonly PREFERENCES: "link.preferences";
+    readonly SESSIONS: "link.sessions";
+};
+declare const LINK_MUTATION: {
+    readonly CHECK_STATUS: "link.check_status";
+    readonly ENROLL: "link.enroll";
+    readonly ENROLL_AND_LINK_ORDER: "link.enroll_and_link_order";
+    readonly UPDATE_PREFERENCES: "link.update_preferences";
+    readonly CREATE_ADDRESS: "link.create_address";
+    readonly UPDATE_ADDRESS: "link.update_address";
+    readonly DELETE_ADDRESS: "link.delete_address";
+    readonly SET_DEFAULT_ADDRESS: "link.set_default_address";
+    readonly TRACK_ADDRESS_USAGE: "link.track_address_usage";
+    readonly CREATE_MOBILE_MONEY: "link.create_mobile_money";
+    readonly DELETE_MOBILE_MONEY: "link.delete_mobile_money";
+    readonly SET_DEFAULT_MOBILE_MONEY: "link.set_default_mobile_money";
+    readonly TRACK_MOBILE_MONEY_USAGE: "link.track_mobile_money_usage";
+    readonly VERIFY_MOBILE_MONEY: "link.verify_mobile_money";
+    readonly REVOKE_SESSION: "link.revoke_session";
+    readonly REVOKE_ALL_SESSIONS: "link.revoke_all_sessions";
+};
+declare const AUTH_MUTATION: {
+    readonly REQUEST_OTP: "auth.request_otp";
+    readonly VERIFY_OTP: "auth.verify_otp";
+};
+declare const CHECKOUT_MUTATION: {
+    readonly PROCESS: "checkout.process";
+};
+declare const PAYMENT_MUTATION: {
+    readonly SUBMIT_AUTHORIZATION: "payment.submit_authorization";
+    readonly CHECK_STATUS: "order.poll_payment_status";
+};
+declare const ORDER_MUTATION: {
+    readonly UPDATE_CUSTOMER: "order.update_order_customer";
+};
+declare const DEFAULT_CURRENCY = "GHS";
+declare const DEFAULT_COUNTRY = "GHA";
+
+/** Currency symbol mapping */
+declare const CURRENCY_SYMBOLS: Record<string, string>;
+/**
+ * Format a money value with currency symbol
+ */
+declare function formatMoney(amount: string | number, currency?: string): string;
+/**
+ * Categorize payment errors into user-friendly messages
+ */
+declare function categorizePaymentError(error: Error, errorCode?: string): PaymentErrorDetails;
+/**
+ * Normalize payment response from different formats into a standard PaymentResponse
+ */
+declare function normalizePaymentResponse(response: unknown): PaymentResponse;
+/**
+ * Normalize payment status response into a standard format
+ */
+declare function normalizeStatusResponse(response: unknown): PaymentStatusResponse;
+/** Mobile money provider display names */
+declare const MOBILE_MONEY_PROVIDERS: {
+    readonly mtn: {
+        readonly name: "MTN Mobile Money";
+        readonly prefix: readonly ["024", "054", "055", "059"];
+    };
+    readonly vodafone: {
+        readonly name: "Vodafone Cash";
+        readonly prefix: readonly ["020", "050"];
+    };
+    readonly airtel: {
+        readonly name: "AirtelTigo Money";
+        readonly prefix: readonly ["027", "057", "026", "056"];
+    };
+};
+/**
+ * Detect mobile money provider from phone number
+ */
+declare function detectMobileMoneyProvider(phoneNumber: string): "mtn" | "vodafone" | "airtel" | null;
+
+/** Request body for POST /api/q */
+interface QueryRequest {
+    query: string;
+    variables?: Record<string, unknown>;
+    cache_hint?: string;
+}
+/** Request body for POST /api/m */
+interface MutationRequest {
+    method: string;
+    args: unknown[];
+}
+/** Response metadata */
+interface ResponseMetadata {
+    execution_time_ms: number;
+    cache_hit: boolean;
+}
+/** Standard API response wrapper */
+interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: ApiError;
+    metadata?: ResponseMetadata;
+}
+
+export { AUTHORIZATION_TYPE, AUTH_MUTATION, type AddOn, type AddOnDetails, type AddOnGroupDetails, type AddOnOption, type AddOnOptionDetails, type AddOnOptionPrice, type AddOnWithOptions, type AddToCartInput, type AddressData, type AdjustmentType, type AmountToPay, type ApiError, type ApiResponse, type AppliedDiscount, type AuthResponse, AuthService, type AuthStatus, type AuthorizationType, type AvailabilityCheck, type AvailabilityResult, type AvailableSlot, type BenefitType, type Booking, type BookingRequirementOverride, type BookingStatus, type BookingWithDetails, type BufferTimes, type Bundle, type BundleComponentData, type BundleComponentInfo, type BundlePriceType, type BundleProduct, type BundleSelectionData, type BundleSelectionInput, type BundleStoredSelection, type BundleSummary, type BundleWithDetails, type Business, type BusinessHours, type BusinessPreferences, BusinessService, type BusinessSettings, type BusinessType, type BusinessWithLocations, CHECKOUT_MODE, CHECKOUT_MUTATION, CHECKOUT_STEP, CURRENCY_SYMBOLS, type CancelBookingInput, type CancelOrderInput, type CancellationPolicy, type Cart, type CartAddOn, type CartChannel, type CartItem, type CartItemDetails, CartOperations, type CartStatus, type CartSummary, type CartTotals, CatalogueQueries, type Category, type CategoryInfo, type CategorySummary, type ChangePasswordInput, type CheckSlotAvailabilityInput, type CheckoutAddressInfo, type CheckoutCustomerInfo, type CheckoutFormData, type CheckoutInput, type CheckoutMode, CheckoutService as CheckoutOperations, type CheckoutOrderType, type CheckoutPaymentMethod, type CheckoutResult, CheckoutService, type CheckoutStep, type ChosenPrice, CimplifyClient, type CimplifyConfig, CimplifyError, type Collection, type CollectionProduct, type CollectionSummary, type ComponentGroup, type ComponentGroupWithComponents, type ComponentPriceBreakdown, type ComponentSelectionInput, type ComponentSourceType, type Composite, type CompositeComponent, type CompositePriceBreakdown, type CompositePriceResult, type CompositePricingMode, type CompositeSelectionData, type ComponentSelectionInput as CompositeSelectionInput, type CompositeStoredSelection, type CompositeWithDetails, type ContactType, type CreateAddressInput, type CreateMobileMoneyInput, type Currency, type Customer, type CustomerAddress, type CustomerLinkPreferences, type CustomerMobileMoney, type CustomerServicePreferences, DEFAULT_COUNTRY, DEFAULT_CURRENCY, type DayAvailability, type DepositResult, type DepositType, type DeviceType, type DigitalProductType, type DiscountBreakdown, type DiscountDetails, type DisplayAddOn, type DisplayAddOnOption, type DisplayCart, type DisplayCartItem, type EnrollAndLinkOrderInput, type EnrollAndLinkOrderResult, type EnrollmentData, type FeeBearerType, type FulfillmentLink, type FulfillmentStatus, type FulfillmentType, type GetAvailableSlotsInput, type GetOrdersOptions, type GetProductsOptions, type GroupPricingBehavior, type InitializePaymentResult, InventoryService, type InventorySummary, type InventoryType, type KitchenOrderItem, type KitchenOrderResult, LINK_MUTATION, LINK_QUERY, type LineConfiguration, type LineItem, type LineType, type LinkData, type LinkEnrollResult, LinkService, type LinkSession, type LinkStatusResult, type LiteBootstrap, LiteService, type Location, type LocationAppointment, type LocationProductPrice, type LocationStock, type LocationTaxBehavior, type LocationTaxOverrides, type LocationTimeProfile, type LocationWithDetails, MOBILE_MONEY_PROVIDER, MOBILE_MONEY_PROVIDERS, type MobileMoneyData, type MobileMoneyDetails, type MobileMoneyProvider, type Money, type MutationRequest, ORDER_MUTATION, ORDER_TYPE, type Order, type OrderChannel, type OrderFilter, type OrderFulfillmentSummary, type OrderGroup, type OrderGroupDetails, type OrderGroupPayment, type OrderGroupPaymentState, type OrderGroupPaymentSummary, type OrderHistory, type OrderLineState, type OrderLineStatus, type OrderPaymentEvent, OrderQueries, type OrderSplitDetail, type OrderStatus, type OtpResult, PAYMENT_METHOD, PAYMENT_MUTATION, PAYMENT_STATE, PICKUP_TIME_TYPE, type Pagination, type PaginationParams, type Payment, type PaymentErrorDetails, type PaymentMethod, type PaymentMethodType, type PaymentProcessingState, type PaymentProvider, type PaymentResponse, type PaymentState, type PaymentStatus, type PaymentStatusResponse, type PickupTime, type PickupTimeType, type Price, type PriceAdjustment, type PriceDecisionPath, type PriceEntryType, type PricePathTaxInfo, type PriceSource, type PricingOverrides, type Product, type ProductAddOn, type ProductAvailability, type ProductStock, type ProductTimeProfile, type ProductType, type ProductVariant, type ProductVariantValue, type ProductWithDetails, QueryBuilder, type QueryRequest, type RefundOrderInput, type ReminderMethod, type ReminderSettings, type RequestOtpInput, type RescheduleBookingInput, type ResourceAssignment, type ResourceAvailabilityException, type ResourceAvailabilityRule, type ResourceType, type ResponseMetadata, type RevokeAllSessionsResult, type RevokeSessionResult, type Room, type SalesChannel, type SchedulingMetadata, type SchedulingResult, SchedulingService, type SearchOptions, type SelectedAddOnOption, type Service, type ServiceAvailabilityException, type ServiceAvailabilityParams, type ServiceAvailabilityResult, type ServiceAvailabilityRule, type ServiceCharge, type ServiceNotes, type ServiceScheduleRequest, type ServiceStaffRequirement, type ServiceStatus, type ServiceWithStaff, type Staff, type StaffAssignment, type StaffAvailabilityException, type StaffAvailabilityRule, type StaffBookingProfile, type StaffRole, type StaffScheduleItem, type Stock, type StockLevel, type StockOwnershipType, type StockStatus, type StorefrontBootstrap, type SubmitAuthorizationInput, type Table, type TableInfo, type TaxPathComponent, type TimeRange, type TimeRanges, type TimeSlot, type UICart, type UICartBusiness, type UICartCustomer, type UICartLocation, type UICartPricing, type UpdateAddressInput, type UpdateCartItemInput, type UpdateOrderStatusInput, type UpdateProfileInput, type VariantAxis, type VariantAxisSelection, type VariantAxisValue, type VariantAxisWithValues, type VariantDetails, type VariantDetailsDTO, type VariantDisplayAttribute, type VariantLocationAvailability, type VariantStock, type VariantStrategy, type VerifyOtpInput, categorizePaymentError, createCimplifyClient, detectMobileMoneyProvider, formatMoney, normalizePaymentResponse, normalizeStatusResponse, query };