@cimplify/sdk 0.18.0 → 0.20.0

package/dist/{payment-D9FTaOse.d.mts → payment-CKqMU4xT.d.mts}

@@ -84,1118 +84,1236 @@ declare function enrichError(error: CimplifyError, options?: {
 }): CimplifyError;
 declare function isRetryableError(error: unknown): boolean;
 
-type ProductType = "product" | "service" | "digital" | "bundle" | "composite";
-type ProductRenderHint = "food" | "physical" | "general";
-type DisplayMode = "card" | "page";
-type InventoryType = "one_to_one" | "composition" | "none";
-type VariantStrategy = "fetch_all" | "use_axes";
-type DigitalProductType = "download" | "license" | "event_ticket" | "access_pass" | "gift_code";
-type DepositType = "none" | "fixed" | "percentage";
-type SalesChannel = "pos" | "online" | "marketplace" | "partners";
-type AttributeType = "text" | "textarea" | "number" | "currency" | "boolean" | "single_select" | "multi_select" | "radio" | "date" | "url" | "color" | "image" | "file";
-type AttributeAppliesTo = "product" | "variant" | "both";
-interface CustomAttributeDefinition {
-    id: string;
-    business_id: string;
-    name: string;
-    slug: string;
-    description?: string;
-    attribute_type: AttributeType;
-    options?: string[];
-    unit?: string;
-    is_required: boolean;
-    is_filterable: boolean;
-    is_visible: boolean;
-    display_order: number;
-    group_name?: string;
-    applies_to: AttributeAppliesTo;
-    created_at: string;
-    updated_at: string;
-}
-interface CustomAttributeValue {
-    definition_id: string;
-    name: string;
-    slug: string;
-    attribute_type: AttributeType;
-    group_name?: string;
-    unit?: string;
-    value: string | number | boolean | string[] | null;
-    is_filterable: boolean;
-}
-type PropertySource = "attribute" | "variant";
-interface ProductProperty {
-    name: string;
-    slug: string;
-    source: PropertySource;
-    value_type: string;
-    values: (string | number | boolean | null)[];
-    group_name?: string;
-    unit?: string;
-    is_filterable: boolean;
-}
-interface PropertyFacet {
-    name: string;
-    slug: string;
-    source: string;
-    values: FacetValue[];
-}
-interface FacetValue {
-    value: string;
-    count: number;
-}
-interface TaxonomyAttributeTemplate {
-    id: string;
-    taxonomy_id: string;
-    name: string;
-    slug: string;
-    attribute_type: "boolean" | "single_select";
-    options?: string[];
-    is_required: boolean;
-    display_order: number;
-    gpc_attribute_code?: number;
-    created_at: string;
-}
-interface Product {
-    id: string;
-    business_id: string;
-    category_id?: string;
-    name: string;
-    slug: string;
-    description?: string;
-    image_url?: string;
-    default_price: Money;
-    type: ProductType;
-    render_hint?: ProductRenderHint;
-    display_mode?: DisplayMode;
-    inventory_type: InventoryType;
-    variant_strategy: VariantStrategy;
-    inventory_status?: {
-        in_stock: boolean;
-        stock_level?: number;
-        low_stock: boolean;
+type CartStatus = "active" | "converting" | "converted" | "expired" | "abandoned";
+type CartChannel = "qr" | "taker" | "staff" | "web" | "dashboard" | "tap" | "chat";
+type PriceSource = "default_item" | "custom" | {
+    location_specific: string;
+} | {
+    variant: string;
+} | {
+    composite: string;
+} | {
+    bundle: string;
+};
+type AdjustmentType = "time_based" | {
+    location_based: string;
+} | {
+    variant_based: string;
+} | {
+    customer_segment: string;
+} | {
+    customer_loyalty: string;
+} | {
+    channel_markup: string;
+} | {
+    discount: string;
+} | {
+    bundle: string;
+} | {
+    manual: string;
+} | {
+    time_limited_promotion: {
+        promotion_id: string;
+        valid_until: string;
     };
-    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;
-    bundle_price?: Money;
-    discount_value?: Money;
-    pricing_type?: BundlePriceType;
-    components?: BundleComponentView[];
-    composite_id?: string;
-    groups?: CompositeGroupView[];
-    custom_attributes?: CustomAttributeValue[];
-    properties?: ProductProperty[];
-}
-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 PriceAdjustment {
+    adjustment_type: AdjustmentType;
+    amount: Money;
+    percentage?: Money;
+    reason: string;
+    applied_at: string;
 }
-interface VariantAxis {
-    id: string;
-    business_id: string;
-    product_id: string;
+interface TaxPathComponent {
     name: string;
-    display_order: number;
-    affects_recipe: boolean;
-    created_at: string;
-    updated_at: string;
-    metadata?: Record<string, unknown>;
-}
-interface VariantAxisWithValues extends VariantAxis {
-    values: VariantAxisValue[];
+    rate: Money;
 }
-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 PricePathTaxInfo {
+    tax_rate: Money;
+    tax_amount: Money;
+    is_inclusive: boolean;
+    components: TaxPathComponent[];
 }
-interface ProductVariantValue {
-    variant_id: string;
-    axis_value_id: string;
-    business_id: string;
-    created_at: string;
-    updated_at: string;
-    metadata?: Record<string, unknown>;
+interface PriceDecisionPath {
+    base_price_source: PriceSource;
+    adjustments: PriceAdjustment[];
+    context?: 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>;
+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;
+    pre_tax_price?: Money;
 }
-interface VariantAxisSelection {
-    [axisName: string]: string;
+type BenefitType = "percentage" | "fixed" | "points" | "free_item" | "buy_x_get_y_free";
+interface AppliedDiscount {
+    discount_id: string;
+    discount_code?: string;
+    discount_type: BenefitType;
+    discount_value: Money;
+    discount_amount: Money;
+    applied_at: string;
+    targeted_item_ids?: 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 DiscountBreakdown {
+    item_discounts: Record<string, AppliedDiscount[]>;
+    order_discounts: AppliedDiscount[];
 }
-interface AddOnWithOptions extends AddOn {
-    options: AddOnOption[];
+interface DiscountDetails {
+    discounts: AppliedDiscount[];
+    total_discount_amount: Money;
+    breakdown: DiscountBreakdown;
 }
-interface AddOnOption {
-    id: string;
+interface SelectedAddOnOption {
+    option_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>;
+    quantity: number;
+    is_required: boolean;
+    selected_at: string;
+    price_info?: ChosenPrice;
 }
-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 AddOnDetails {
+    selected_options: SelectedAddOnOption[];
+    total_add_on_price: Money;
+    add_ons: CartAddOn[];
 }
-interface Category {
-    id: string;
-    business_id: string;
+interface CartAddOn {
+    add_on_id: string;
     name: string;
-    slug: string;
-    description?: string;
-    product_count?: number;
-    created_at: string;
-    updated_at: string;
-    metadata?: Record<string, unknown>;
+    min_selections: number;
+    max_selections: number;
+    selected_options: string[];
+    is_required: boolean;
 }
-interface CategorySummary extends Category {
-    product_count: number;
+interface VariantDetails {
+    variant_id: string;
+    sku?: string;
+    properties: Record<string, string>;
 }
-interface Collection {
-    id: string;
-    business_id: string;
-    name: string;
-    slug: string;
-    description?: string;
-    tags?: string[];
-    image_url?: string;
-    channels?: SalesChannel[];
-    product_count?: number;
-    created_at: string;
-    updated_at: string;
-    metadata?: Record<string, unknown>;
+interface BundleSelectionInput {
+    component_id: string;
+    variant_id?: string;
+    quantity: number;
+    scheduled_start?: string;
+    scheduled_end?: string;
 }
-interface CollectionSummary extends Collection {
-    product_count: number;
+interface ComponentSchedulingData {
+    scheduled_start?: string;
+    scheduled_end?: string;
+    service_status: string;
+    confirmation_code?: string;
+    appointment_id?: string;
 }
-interface CollectionProduct {
-    id: string;
-    collection_id: string;
+interface BundleStoredSelection {
+    component_id: string;
     product_id: string;
-    display_order?: number;
-    created_at: string;
-    updated_at: string;
-    metadata?: Record<string, unknown>;
+    product_name: string;
+    variant_id?: string;
+    variant_name?: string;
+    quantity: number;
+    unit_price: Money;
+    product_type?: ProductType;
+    scheduling?: ComponentSchedulingData;
 }
-type BundlePriceType = "fixed" | "percentage_discount" | "fixed_discount";
-interface Bundle {
+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;
+    product_type?: ProductType;
+    scheduling?: ComponentSchedulingData;
+}
+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;
-    product_id: string;
-    name: string;
-    slug: string;
-    description?: string;
-    image_url?: string;
-    pricing_type: BundlePriceType;
-    bundle_price?: Money;
-    discount_value?: Money;
-    product_count?: number;
+    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;
+    delivery_fee: 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 BundleSummary extends Bundle {
-    product_count: number;
-}
-interface BundleProduct {
+interface CartItem {
     id: string;
-    bundle_id: string;
-    product_id: string;
-    variant_id?: string;
-    allow_variant_choice: boolean;
+    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 BundleWithDetails extends Bundle {
-    product: Product;
-    components: BundleComponentData[];
-    schedules?: ProductTimeProfile[];
-    availability?: Record<string, ProductAvailability>;
+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 BundleComponentData {
-    component: BundleProduct;
-    product: Product;
-    variants: ProductVariant[];
-    variant_axes: VariantAxis[];
-    variant_axis_values: VariantAxisValue[];
-    product_variant_values: ProductVariantValue[];
+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;
+    delivery_fee: 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 BundleComponentInfo {
+interface DisplayCartItem {
     id: string;
-    product_id: string;
-    variant_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 BundleComponentView {
+interface DisplayAddOn {
     id: string;
-    product_id: string;
-    product_name: string;
-    product_description?: string;
-    product_image_url?: string;
-    effective_price: Money;
-    quantity: number;
-    variant_id?: string;
-    allow_variant_choice: boolean;
-    available_variants: BundleComponentVariantView[];
-    variant_axes?: VariantAxisView[];
+    name: string;
+    min_selections: number;
+    max_selections: number;
+    is_required: boolean;
+    selected_options: DisplayAddOnOption[];
 }
-interface BundleComponentVariantView {
+interface DisplayAddOnOption {
     id: string;
-    is_default: boolean;
-    display_name: string;
-    price_adjustment: Money;
+    name: string;
+    price: Money;
+    quantity: number;
+    image_url?: string;
+    description?: string;
 }
-interface VariantAxisView {
-    id: string;
+interface UICartBusiness {
     name: string;
-    values: VariantAxisValueView[];
+    logo_url?: string;
+    contact_email?: string;
+    contact_phone?: string;
 }
-interface VariantAxisValueView {
-    id: string;
-    value: string;
+interface UICartLocation {
+    id?: string;
+    name?: string;
 }
-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 UICartCustomer {
+    id?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    address?: string;
 }
-interface CompositeWithDetails extends Composite {
-    product: Product;
-    groups: ComponentGroupWithComponents[];
+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 ComponentGroup {
+interface AddOnOptionDetails {
     id: string;
-    composite_id: string;
     name: string;
+    price?: Money;
+    is_required: boolean;
     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[];
+    image_url?: string;
 }
-interface CompositeGroupView {
+interface AddOnGroupDetails {
     id: string;
     name: string;
-    description?: string;
+    is_multiple_allowed: boolean;
     min_selections: number;
     max_selections: number;
-    allow_quantity: boolean;
-    max_quantity_per_component?: number;
-    display_order: number;
-    components: CompositeComponentView[];
+    required: boolean;
+    options: AddOnOptionDetails[];
 }
-interface CompositeComponentView {
+interface VariantDetailsDTO {
     id: string;
-    display_name?: string;
-    display_description?: string;
-    display_image_url?: string;
+    name: string;
     price: Money;
-    calories?: number;
-    display_order: number;
-    is_popular: boolean;
-    is_premium: boolean;
-    is_available: boolean;
-    is_archived: boolean;
+    price_adjustment: Money;
+    is_default: boolean;
 }
-interface CompositeComponent {
+interface CartItemDetails {
     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;
-}
-interface ComponentSelectionInput {
-    component_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;
-    add_on_option_id?: string;
-}
-interface CompositePriceResult {
+    variant_details?: VariantDetails;
+    variant_name?: string;
+    variant_info?: VariantDetailsDTO;
     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;
+    add_ons_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;
+    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>;
 }
-type LocationProductPrice = Price;
-interface ProductAvailability {
+interface UICart {
     id: string;
     business_id: string;
-    location_id: string;
-    product_id: string;
-    is_available: boolean;
-    is_in_stock: boolean;
+    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 ProductTimeProfile {
+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 BillingFrequency = "weekly" | "monthly" | "quarterly" | "annually";
+type BillingPlanType = "subscription" | "installment";
+type BillingMarkupType = "fixed" | "percentage";
+interface ProductBillingPlan {
     id: string;
-    business_id: string;
     product_id: string;
-    day_of_week: number;
-    start_time: string;
-    end_time: string;
+    business_id: string;
+    frequency: BillingFrequency;
+    fulfillment_frequency?: BillingFrequency | null;
+    plan_type: BillingPlanType;
+    installment_periods?: number | null;
+    trial_days: number;
+    setup_fee: number;
+    markup_type?: BillingMarkupType | null;
+    markup_amount?: number | null;
+    customer_group_id?: string | null;
+    min_quantity?: number | null;
+    min_order_value?: number | null;
+    max_cycles?: number | null;
+    is_active: boolean;
     created_at: string;
     updated_at: string;
     metadata?: Record<string, unknown>;
 }
-interface ProductTaxonomy {
+interface EligiblePlansQuery {
+    customer_id?: string;
+    quantity?: number;
+    order_value?: number;
+}
+interface FormattedPlanOption {
+    plan: ProductBillingPlan;
+    label: string;
+    pricePerPeriod: number;
+    totalPrice?: number;
+}
+
+type ProductType = "product" | "service" | "digital" | "bundle" | "composite";
+type ProductRenderHint = "food" | "physical" | "general";
+type DisplayMode = "card" | "page";
+type InventoryType = "one_to_one" | "composition" | "none";
+type VariantStrategy = "fetch_all" | "use_axes";
+type DigitalProductType = "download" | "license" | "event_ticket" | "access_pass" | "gift_code";
+type DepositType = "none" | "fixed" | "percentage";
+type DurationUnit = "minutes" | "hours" | "days" | "nights" | "weeks" | "months" | "years";
+type SalesChannel = "pos" | "online" | "marketplace" | "partners";
+type AttributeType = "text" | "textarea" | "number" | "currency" | "boolean" | "single_select" | "multi_select" | "radio" | "date" | "url" | "color" | "image" | "file" | "product_reference" | "category_reference" | "collection_reference" | "variant_reference" | "list_text" | "list_number" | "list_date" | "dimension" | "weight" | "volume";
+type AttributeAppliesTo = "product" | "variant" | "both" | "category" | "collection" | "all";
+type AttributeVisibility = "admin_only" | "storefront_read" | "public";
+type MeasurementValue = {
+    value: number;
+    unit: string;
+};
+interface AttributeValidationRules {
+    min_length?: number;
+    max_length?: number;
+    regex?: string;
+    min?: number | string;
+    max?: number | string;
+    max_precision?: number;
+    min_selections?: number;
+    max_selections?: number;
+}
+interface CustomAttributeDefinition {
     id: string;
-    code: string;
+    business_id: string;
+    namespace: string;
     name: string;
+    slug: string;
     description?: string;
-    parent_id?: string;
-    level: number;
-    is_active: boolean;
+    attribute_type: AttributeType;
+    options?: string[];
+    unit?: string;
+    validation?: AttributeValidationRules | null;
+    is_required: boolean;
+    is_filterable: boolean;
+    visibility: AttributeVisibility;
+    display_order: number;
+    group_name?: string;
+    applies_to: AttributeAppliesTo;
     created_at: string;
     updated_at: string;
 }
-interface TaxonomyWithChildren extends ProductTaxonomy {
-    children: ProductTaxonomy[];
-}
-interface ProductAvailabilityNow {
-    is_available: boolean;
-    schedules_today: ProductTimeProfile[];
+interface CustomAttributeValue {
+    definition_id: string;
+    namespace: string;
+    name: string;
+    slug: string;
+    attribute_type: AttributeType;
+    group_name?: string;
+    unit?: string;
+    value: string | number | boolean | string[] | MeasurementValue | null;
+    is_filterable: boolean;
+    visibility: AttributeVisibility;
 }
-type DealBenefitType = "percentage" | "fixed" | "free_item" | "buy_x_get_y_free" | "points";
-interface Deal {
-    id: string;
-    description: string;
-    benefit_type: DealBenefitType;
-    value: Money;
-    min_order_value?: Money;
-    buy_quantity?: number;
-    get_quantity?: number;
-    stackable: boolean;
-    starts_at: string;
-    ends_at: string;
-    product_ids: string[];
-    category_ids: string[];
-    collection_ids: string[];
+type PropertySource = "attribute" | "variant";
+interface ProductProperty {
+    name: string;
+    slug: string;
+    source: PropertySource;
+    value_type: string;
+    values: (string | number | boolean | null)[];
+    group_name?: string;
+    unit?: string;
+    is_filterable: boolean;
 }
-interface ProductDealInfo {
-    product_id: string;
-    deal_id: string;
-    deal_name: string;
-    benefit_type: DealBenefitType;
-    value: Money;
-    label: string;
+interface PropertyFacet {
+    name: string;
+    slug: string;
+    source: string;
+    values: FacetValue[];
 }
-interface DiscountValidation {
-    is_eligible: boolean;
-    discount_amount?: Money;
-    deal?: Deal;
-    ineligibility_reason?: string;
+interface FacetValue {
+    value: string;
+    count: number;
 }
-interface Tag {
+interface TaxonomyAttributeTemplate {
     id: string;
+    taxonomy_id: string;
     name: string;
     slug: string;
-    color?: string;
-    icon?: string;
-    description?: string;
-    tag_group?: string;
-    sort_order: number;
-    usage_count: number;
+    attribute_type: "boolean" | "single_select";
+    options?: string[];
+    is_required: boolean;
+    display_order: number;
+    gpc_attribute_code?: number;
     created_at: string;
-    updated_at: string;
 }
-interface TagsResponse {
-    items: Tag[];
-    total: number;
-    limit: number;
-    offset: number;
+interface KnowledgeArticle {
+    id: string;
+    title: string;
+    slug: string;
+    content: string;
+    category?: string;
+    tags: string[];
+    created_at: string;
+    updated_at: string;
 }
-
-type CartStatus = "active" | "converting" | "converted" | "expired" | "abandoned";
-type CartChannel = "qr" | "taker" | "staff" | "web" | "dashboard";
-type PriceSource = "default_item" | "custom" | {
-    location_specific: string;
-} | {
-    variant: string;
-} | {
-    composite: string;
-} | {
-    bundle: string;
-};
-type AdjustmentType = "time_based" | {
-    location_based: string;
-} | {
-    variant_based: string;
-} | {
-    customer_segment: string;
-} | {
-    customer_loyalty: string;
-} | {
-    channel_markup: string;
-} | {
-    discount: string;
-} | {
-    bundle: string;
-} | {
-    manual: string;
-} | {
-    time_limited_promotion: {
-        promotion_id: string;
-        valid_until: string;
+interface Product {
+    id: string;
+    business_id: string;
+    category_id?: string;
+    name: string;
+    slug: string;
+    description?: string;
+    image_url?: string;
+    default_price: Money;
+    type: ProductType;
+    render_hint?: ProductRenderHint;
+    display_mode?: DisplayMode;
+    inventory_type: InventoryType;
+    variant_strategy: VariantStrategy;
+    inventory_status?: {
+        in_stock: boolean;
+        stock_level?: number;
+        low_stock: boolean;
     };
-};
-interface PriceAdjustment {
-    adjustment_type: AdjustmentType;
-    amount: Money;
-    percentage?: Money;
-    reason: string;
-    applied_at: string;
+    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;
+    duration_unit?: DurationUnit;
+    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;
+    bundle_price?: Money;
+    discount_value?: Money;
+    pricing_type?: BundlePriceType;
+    components?: BundleComponentView[];
+    composite_id?: string;
+    groups?: CompositeGroupView[];
+    custom_attributes?: CustomAttributeValue[];
+    properties?: ProductProperty[];
+    billing_plans?: ProductBillingPlan[];
+    upsells?: RelatedProductView[];
+    cross_sells?: RelatedProductView[];
 }
-interface TaxPathComponent {
+interface RelatedProductView {
+    product_id: string;
     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>;
+    slug: string;
+    image_url?: string;
+    price: Money;
+    source: string;
 }
-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;
-    pre_tax_price?: Money;
+interface ProductWithDetails extends Product {
+    category?: Category;
+    variants?: VariantView[];
+    add_ons?: AddOnWithOptions[];
+    variant_axes?: VariantAxisWithValues[];
+    location_prices?: LocationProductPrice[];
+    location_availability?: ProductAvailability[];
+    time_profiles?: ProductTimeProfile[];
 }
-type BenefitType = "percentage" | "fixed" | "points" | "free_item" | "buy_x_get_y_free";
-interface AppliedDiscount {
-    discount_id: string;
-    discount_code?: string;
-    discount_type: BenefitType;
-    discount_value: Money;
-    discount_amount: Money;
-    applied_at: string;
-    targeted_item_ids?: string[];
+interface VariantView {
+    id: string;
+    name: string;
+    is_default: boolean;
+    price_adjustment: Money;
+    location_prices?: Record<string, ChosenPrice>;
+    axis_selections?: Record<string, string>;
+    display_attributes?: VariantDisplayAttribute[];
+    images?: string[];
+    duration_minutes?: number;
+    duration_unit?: DurationUnit;
+    skill_level_required?: string;
+    staff_count_override?: number;
+    capacity_override?: number;
 }
-interface DiscountBreakdown {
-    item_discounts: Record<string, AppliedDiscount[]>;
-    order_discounts: AppliedDiscount[];
+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;
+    duration_unit?: DurationUnit;
+    max_downloads?: number;
+    license_key?: string;
+    display_attributes?: VariantDisplayAttribute[];
 }
-interface DiscountDetails {
-    discounts: AppliedDiscount[];
-    total_discount_amount: Money;
-    breakdown: DiscountBreakdown;
+interface VariantDisplayAttribute {
+    axis_id: string;
+    axis_name: string;
+    value_id: string;
+    value_name: string;
 }
-interface SelectedAddOnOption {
-    option_id: string;
-    add_on_id: string;
+interface VariantAxis {
+    id: string;
+    business_id: string;
+    product_id: string;
     name: string;
-    price: Money;
-    quantity: number;
-    is_required: boolean;
-    selected_at: string;
-    price_info?: ChosenPrice;
+    display_order: number;
+    affects_recipe: boolean;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
 }
-interface AddOnDetails {
-    selected_options: SelectedAddOnOption[];
-    total_add_on_price: Money;
-    add_ons: CartAddOn[];
+interface VariantAxisWithValues extends VariantAxis {
+    values: VariantAxisValue[];
 }
-interface CartAddOn {
-    add_on_id: string;
+interface VariantAxisValue {
+    id: string;
+    business_id: string;
+    axis_id: string;
     name: string;
-    min_selections: number;
-    max_selections: number;
-    selected_options: string[];
-    is_required: boolean;
+    display_order: number;
+    color_hex?: string;
+    image_url?: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
 }
-interface VariantDetails {
+interface ProductVariantValue {
     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;
+    axis_value_id: string;
+    business_id: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
 }
-interface BundleSelectionData {
-    bundle_id: string;
-    selections: BundleStoredSelection[];
+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>;
 }
-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 VariantAxisSelection {
+    [axisName: string]: string;
 }
-interface CompositePriceBreakdown {
-    base_price: Money;
-    components_total: Money;
-    tier_applied?: string;
-    final_price: Money;
+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 CompositeSelectionData {
-    composite_id: string;
-    selections: CompositeStoredSelection[];
-    breakdown: CompositePriceBreakdown;
+interface AddOnWithOptions extends AddOn {
+    options: AddOnOption[];
 }
-
-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 {
+interface AddOnOption {
     id: string;
+    add_on_id: string;
     business_id: string;
-    customer_id?: string;
-    session_id?: string;
-    location_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;
-    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 {
+interface AddOnOptionPrice {
     id: string;
-    cart_id: string;
-    item_id: string;
-    quantity: number;
-    line_key: string;
-    configuration: LineConfiguration;
+    add_on_option_id: string;
+    location_id: string;
+    business_id: string;
     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 ProductAddOn {
+    id: string;
+    business_id: string;
+    product_id: string;
+    add_on_id: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
 }
-interface DisplayCart {
+interface Category {
     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;
+    name: string;
+    slug: string;
+    description?: string;
+    product_count?: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
 }
-interface DisplayCartItem {
+interface CategorySummary extends Category {
+    product_count: number;
+}
+interface Collection {
     id: string;
-    cart_id: string;
-    item_id: string;
-    quantity: number;
+    business_id: string;
     name: string;
+    slug: string;
     description?: string;
+    tags?: 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;
+    channels?: SalesChannel[];
+    product_count?: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
 }
-interface DisplayAddOn {
+interface CollectionSummary extends Collection {
+    product_count: number;
+}
+interface CollectionProduct {
     id: string;
-    name: string;
-    min_selections: number;
-    max_selections: number;
-    is_required: boolean;
-    selected_options: DisplayAddOnOption[];
+    collection_id: string;
+    product_id: string;
+    display_order?: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
 }
-interface DisplayAddOnOption {
+type BundlePriceType = "fixed" | "percentage_discount" | "fixed_discount";
+interface Bundle {
     id: string;
+    business_id: string;
+    product_id: string;
     name: string;
-    price: Money;
-    quantity: number;
-    image_url?: string;
+    slug: string;
     description?: string;
+    image_url?: string;
+    pricing_type: BundlePriceType;
+    bundle_price?: Money;
+    discount_value?: Money;
+    product_count?: number;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
 }
-interface UICartBusiness {
-    name: string;
-    logo_url?: string;
-    contact_email?: string;
-    contact_phone?: string;
+interface BundleSummary extends Bundle {
+    product_count: number;
 }
-interface UICartLocation {
-    id?: string;
-    name?: string;
+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 UICartCustomer {
-    id?: string;
-    name?: string;
-    email?: string;
-    phone?: string;
-    address?: string;
+interface BundleWithDetails extends Bundle {
+    product: Product;
+    components: BundleComponentData[];
+    schedules?: ProductTimeProfile[];
+    availability?: Record<string, ProductAvailability>;
 }
-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 BundleComponentData {
+    component: BundleProduct;
+    product: Product;
+    variants: ProductVariant[];
+    variant_axes: VariantAxis[];
+    variant_axis_values: VariantAxisValue[];
+    product_variant_values: ProductVariantValue[];
 }
-interface AddOnOptionDetails {
+interface BundleComponentInfo {
+    id: string;
+    product_id: string;
+    variant_id?: string;
+    quantity: number;
+}
+interface BundleComponentView {
+    id: string;
+    product_id: string;
+    product_name: string;
+    product_description?: string;
+    product_image_url?: string;
+    product_type?: ProductType;
+    effective_price: Money;
+    quantity: number;
+    variant_id?: string;
+    allow_variant_choice: boolean;
+    available_variants: BundleComponentVariantView[];
+    variant_axes?: VariantAxisView[];
+    duration_minutes?: number;
+    duration_unit?: DurationUnit;
+}
+interface BundleComponentVariantView {
+    id: string;
+    is_default: boolean;
+    display_name: string;
+    price_adjustment: Money;
+}
+interface VariantAxisView {
     id: string;
     name: string;
-    price?: Money;
-    is_required: boolean;
+    values: VariantAxisValueView[];
+}
+interface VariantAxisValueView {
+    id: string;
+    value: string;
+}
+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;
-    image_url?: 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 AddOnGroupDetails {
+interface ComponentGroupWithComponents extends ComponentGroup {
+    components: CompositeComponent[];
+}
+interface CompositeGroupView {
     id: string;
     name: string;
-    is_multiple_allowed: boolean;
+    description?: string;
     min_selections: number;
     max_selections: number;
-    required: boolean;
-    options: AddOnOptionDetails[];
+    allow_quantity: boolean;
+    max_quantity_per_component?: number;
+    display_order: number;
+    components: CompositeComponentView[];
 }
-interface VariantDetailsDTO {
+interface CompositeComponentView {
     id: string;
-    name: string;
+    display_name?: string;
+    display_description?: string;
+    display_image_url?: string;
     price: Money;
-    price_adjustment: Money;
-    is_default: boolean;
+    calories?: number;
+    display_order: number;
+    is_popular: boolean;
+    is_premium: boolean;
+    is_available: boolean;
+    is_archived: boolean;
+    product_type?: ProductType;
+    source_type?: ComponentSourceType;
 }
-interface CartItemDetails {
+interface CompositeComponent {
     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;
+    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;
+}
+interface ComponentSelectionInput {
+    component_id: string;
+    quantity: number;
     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;
+    add_on_option_id?: 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;
+}
+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>;
 }
-interface UICart {
+type LocationProductPrice = Price;
+interface ProductAvailability {
     id: string;
     business_id: string;
-    session_id?: string;
-    customer_id?: string;
-    location_id?: string;
+    location_id: string;
+    product_id: string;
+    is_available: boolean;
+    is_in_stock: boolean;
     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 UICartResponse {
-    cart: UICart;
-    cart_count: number;
-    message?: string | null;
+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 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 ProductTaxonomy {
+    id: string;
+    code: string;
+    name: string;
+    description?: string;
+    parent_id?: string;
+    level: number;
+    is_active: boolean;
+    created_at: string;
+    updated_at: 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 TaxonomyWithChildren extends ProductTaxonomy {
+    children: ProductTaxonomy[];
 }
-interface CartSummary {
-    item_count: number;
-    total_items: number;
-    subtotal: Money;
-    discount_amount: Money;
-    tax_amount: Money;
-    total: Money;
-    currency: CurrencyCode;
+interface ProductAvailabilityNow {
+    is_available: boolean;
+    schedules_today: ProductTimeProfile[];
+}
+type DealBenefitType = "percentage" | "fixed" | "free_item" | "buy_x_get_y_free" | "points";
+interface Deal {
+    id: string;
+    description: string;
+    benefit_type: DealBenefitType;
+    value: Money;
+    min_order_value?: Money;
+    buy_quantity?: number;
+    get_quantity?: number;
+    stackable: boolean;
+    starts_at: string;
+    ends_at: string;
+    product_ids: string[];
+    category_ids: string[];
+    collection_ids: string[];
+}
+interface ProductDealInfo {
+    product_id: string;
+    deal_id: string;
+    deal_name: string;
+    benefit_type: DealBenefitType;
+    value: Money;
+    label: string;
+}
+interface DiscountValidation {
+    is_eligible: boolean;
+    discount_amount?: Money;
+    deal?: Deal;
+    ineligibility_reason?: string;
+}
+interface Tag {
+    id: string;
+    name: string;
+    slug: string;
+    color?: string;
+    icon?: string;
+    description?: string;
+    tag_group?: string;
+    sort_order: number;
+    usage_count: number;
+    created_at: string;
+    updated_at: string;
+}
+interface TagsResponse {
+    items: Tag[];
+    total: number;
+    limit: number;
+    offset: number;
 }
 
-type PaymentStatus = "initialized" | "pending" | "processing" | "authorized" | "captured" | "failed" | "cancelled" | "refunded" | "unknown" | "voided" | "requires_action" | "abandoned" | "reversed" | "disputed" | "refund_pending" | "created" | "pending_confirmation" | "success" | "succeeded" | "declined" | "partially_refunded" | "partially_paid" | "paid" | "unpaid" | "requires_payment_method" | "requires_capture" | "completed" | "error";
+type PaymentStatus = "initialized" | "pending" | "processing" | "authorized" | "captured" | "failed" | "cancelled" | "refunded" | "unknown" | "voided" | "requires_action" | "abandoned" | "reversed" | "disputed" | "refund_pending";
 type PaymentProvider = "stripe" | "paystack" | "cellulant" | "mtnmomo" | "offline" | "mtn" | "vodafone" | "airtel" | "cash" | "manual";
 type PaymentMethodType = "card" | "bank_transfer" | "cash" | {
     mobile_money: {
@@ -1305,4 +1423,4 @@ interface SubmitAuthorizationInput {
     value: string;
 }
 
-export { type Collection as $, type ApiError as A, type ProductVariant as B, type CurrencyCode as C, type DisplayMode as D, ErrorCode as E, type FacetValue as F, type VariantDisplayAttribute as G, type VariantAxis as H, type InventoryType as I, type VariantAxisWithValues as J, type VariantAxisValue as K, type ProductVariantValue as L, type Money as M, type VariantLocationAvailability as N, type VariantAxisSelection as O, type PaginationParams as P, type AddOn as Q, type AddOnWithOptions as R, type SalesChannel as S, type TaxonomyAttributeTemplate as T, type AddOnOption as U, type VariantStrategy as V, type AddOnOptionPrice as W, type ProductAddOn as X, type Category as Y, ZERO as Z, type CategorySummary as _, moneyFromNumber as a, type LineConfiguration as a$, type CollectionSummary as a0, type CollectionProduct as a1, type BundlePriceType as a2, type Bundle as a3, type BundleSummary as a4, type BundleProduct as a5, type BundleWithDetails as a6, type BundleComponentData as a7, type BundleComponentInfo as a8, type BundleComponentView as a9, type ProductDealInfo as aA, type DiscountValidation as aB, type Tag as aC, type TagsResponse as aD, type CartStatus as aE, type CartChannel as aF, type PriceSource as aG, type AdjustmentType as aH, type PriceAdjustment as aI, type TaxPathComponent as aJ, type PricePathTaxInfo as aK, type PriceDecisionPath as aL, type ChosenPrice as aM, type BenefitType as aN, type AppliedDiscount as aO, type DiscountBreakdown as aP, type DiscountDetails as aQ, type SelectedAddOnOption as aR, type AddOnDetails as aS, type CartAddOn as aT, type VariantDetails as aU, type BundleSelectionInput as aV, type BundleStoredSelection as aW, type BundleSelectionData as aX, type CompositeStoredSelection as aY, type CompositePriceBreakdown as aZ, type CompositeSelectionData as a_, type BundleComponentVariantView as aa, type VariantAxisView as ab, type VariantAxisValueView as ac, type CompositePricingMode as ad, type GroupPricingBehavior as ae, type ComponentSourceType as af, type Composite as ag, type CompositeWithDetails as ah, type ComponentGroup as ai, type ComponentGroupWithComponents as aj, type CompositeGroupView as ak, type CompositeComponentView as al, type CompositeComponent as am, type ComponentSelectionInput as an, type CompositePriceResult as ao, type ComponentPriceBreakdown as ap, type PriceEntryType as aq, type Price as ar, type LocationProductPrice as as, type ProductAvailability as at, type ProductTimeProfile as au, type ProductTaxonomy as av, type TaxonomyWithChildren as aw, type ProductAvailabilityNow as ax, type DealBenefitType as ay, type Deal as az, type Pagination as b, type Cart as b0, type CartItem as b1, type CartTotals as b2, type DisplayCart as b3, type DisplayCartItem as b4, type DisplayAddOn as b5, type DisplayAddOnOption as b6, type UICartBusiness as b7, type UICartLocation as b8, type UICartCustomer as b9, type UICartPricing as ba, type AddOnOptionDetails as bb, type AddOnGroupDetails as bc, type VariantDetailsDTO as bd, type CartItemDetails as be, type UICart as bf, type UICartResponse as bg, type AddToCartInput as bh, type UpdateCartItemInput as bi, type CartSummary as bj, type PaymentStatus as bk, type PaymentProvider as bl, type PaymentMethodType as bm, type AddressAuthorizationData as bn, type AuthorizationType as bo, type PaymentProcessingState as bp, type PaymentMethod as bq, type Payment as br, type InitializePaymentResult as bs, type PaymentResponse as bt, type PaymentStatusResponse as bu, type PaymentErrorDetails as bv, type SubmitAuthorizationInput as bw, currencyCode as c, type ErrorCodeType as d, type ErrorHint as e, ERROR_HINTS as f, CimplifyError as g, isCimplifyError as h, isSupportedCurrency as i, getErrorHint as j, enrichError as k, isRetryableError as l, money as m, type ProductType as n, type ProductRenderHint as o, type DigitalProductType as p, type DepositType as q, type AttributeType as r, type AttributeAppliesTo as s, type CustomAttributeDefinition as t, type CustomAttributeValue as u, type PropertySource as v, type ProductProperty as w, type PropertyFacet as x, type Product as y, type ProductWithDetails as z };
+export { type VariantAxisSelection as $, type ApiError as A, type PropertySource as B, type ChosenPrice as C, type DisplayMode as D, ErrorCode as E, type ProductProperty as F, type PropertyFacet as G, type FacetValue as H, type InventoryType as I, type Product as J, type KnowledgeArticle as K, type ProductWithDetails as L, type Money as M, type VariantView as N, type ProductVariant as O, type PaginationParams as P, type VariantDisplayAttribute as Q, type RelatedProductView as R, type SalesChannel as S, type TaxonomyAttributeTemplate as T, type VariantAxis as U, type VariantStrategy as V, type VariantAxisWithValues as W, type VariantAxisValue as X, type ProductVariantValue as Y, ZERO as Z, type VariantLocationAvailability as _, type CurrencyCode as a, type VariantDetails as a$, type AddOn as a0, type AddOnWithOptions as a1, type AddOnOption as a2, type AddOnOptionPrice as a3, type ProductAddOn as a4, type Category as a5, type CategorySummary as a6, type Collection as a7, type CollectionSummary as a8, type CollectionProduct as a9, type LocationProductPrice as aA, type ProductAvailability as aB, type ProductTimeProfile as aC, type ProductTaxonomy as aD, type TaxonomyWithChildren as aE, type ProductAvailabilityNow as aF, type DealBenefitType as aG, type Deal as aH, type ProductDealInfo as aI, type DiscountValidation as aJ, type Tag as aK, type TagsResponse as aL, type CartStatus as aM, type CartChannel as aN, type PriceSource as aO, type AdjustmentType as aP, type PriceAdjustment as aQ, type TaxPathComponent as aR, type PricePathTaxInfo as aS, type PriceDecisionPath as aT, type BenefitType as aU, type AppliedDiscount as aV, type DiscountBreakdown as aW, type DiscountDetails as aX, type SelectedAddOnOption as aY, type AddOnDetails as aZ, type CartAddOn as a_, type BundlePriceType as aa, type Bundle as ab, type BundleSummary as ac, type BundleProduct as ad, type BundleWithDetails as ae, type BundleComponentData as af, type BundleComponentInfo as ag, type BundleComponentView as ah, type BundleComponentVariantView as ai, type VariantAxisView as aj, type VariantAxisValueView as ak, type CompositePricingMode as al, type GroupPricingBehavior as am, type ComponentSourceType as an, type Composite as ao, type CompositeWithDetails as ap, type ComponentGroup as aq, type ComponentGroupWithComponents as ar, type CompositeGroupView as as, type CompositeComponentView as at, type CompositeComponent as au, type ComponentSelectionInput as av, type CompositePriceResult as aw, type ComponentPriceBreakdown as ax, type PriceEntryType as ay, type Price as az, moneyFromNumber as b, type BundleSelectionInput as b0, type ComponentSchedulingData as b1, type BundleStoredSelection as b2, type BundleSelectionData as b3, type CompositeStoredSelection as b4, type CompositePriceBreakdown as b5, type CompositeSelectionData as b6, type LineConfiguration as b7, type Cart as b8, type CartItem as b9, type InitializePaymentResult as bA, type PaymentResponse as bB, type PaymentStatusResponse as bC, type PaymentErrorDetails as bD, type SubmitAuthorizationInput as bE, type BillingFrequency as bF, type BillingPlanType as bG, type BillingMarkupType as bH, type ProductBillingPlan as bI, type EligiblePlansQuery as bJ, type FormattedPlanOption as bK, type CartTotals as ba, type DisplayCart as bb, type DisplayCartItem as bc, type DisplayAddOn as bd, type DisplayAddOnOption as be, type UICartBusiness as bf, type UICartLocation as bg, type UICartCustomer as bh, type UICartPricing as bi, type AddOnOptionDetails as bj, type AddOnGroupDetails as bk, type VariantDetailsDTO as bl, type CartItemDetails as bm, type UICart as bn, type UICartResponse as bo, type AddToCartInput as bp, type UpdateCartItemInput as bq, type CartSummary as br, type PaymentStatus as bs, type PaymentProvider as bt, type PaymentMethodType as bu, type AddressAuthorizationData as bv, type AuthorizationType as bw, type PaymentProcessingState as bx, type PaymentMethod as by, type Payment as bz, currencyCode as c, type Pagination as d, type ErrorCodeType as e, type ErrorHint as f, ERROR_HINTS as g, CimplifyError as h, isSupportedCurrency as i, isCimplifyError as j, getErrorHint as k, enrichError as l, money as m, isRetryableError as n, type ProductType as o, type ProductRenderHint as p, type DigitalProductType as q, type DepositType as r, type DurationUnit as s, type AttributeType as t, type AttributeAppliesTo as u, type AttributeVisibility as v, type MeasurementValue as w, type AttributeValidationRules as x, type CustomAttributeDefinition as y, type CustomAttributeValue as z };