@cimplify/sdk 0.19.0 → 0.20.0

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

@@ -84,1128 +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 KnowledgeArticle {
-    id: string;
-    title: string;
-    slug: string;
-    content: string;
-    category?: string;
-    tags: string[];
-    created_at: string;
-    updated_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;
+    price: Money;
+    quantity: number;
     is_required: boolean;
-    is_mutually_exclusive: boolean;
-    created_at: string;
-    updated_at: string;
-    metadata?: Record<string, unknown>;
+    selected_at: string;
+    price_info?: ChosenPrice;
 }
-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 AddOnDetails {
+    selected_options: SelectedAddOnOption[];
+    total_add_on_price: Money;
+    add_ons: CartAddOn[];
 }
-interface ProductAddOn {
-    id: string;
-    business_id: string;
-    product_id: string;
+interface CartAddOn {
     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;
-    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 BundleComponentData {
-    component: BundleProduct;
-    product: Product;
-    variants: ProductVariant[];
-    variant_axes: VariantAxis[];
-    variant_axis_values: VariantAxisValue[];
-    product_variant_values: ProductVariantValue[];
+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 BundleComponentInfo {
+interface DisplayCart {
     id: string;
-    product_id: string;
-    variant_id?: string;
-    quantity: number;
+    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 BundleComponentView {
+interface DisplayCartItem {
     id: string;
-    product_id: string;
-    product_name: string;
-    product_description?: string;
-    product_image_url?: string;
-    effective_price: Money;
+    cart_id: string;
+    item_id: string;
     quantity: number;
-    variant_id?: string;
-    allow_variant_choice: boolean;
-    available_variants: BundleComponentVariantView[];
-    variant_axes?: VariantAxisView[];
+    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 BundleComponentVariantView {
+interface DisplayAddOn {
     id: string;
-    is_default: boolean;
-    display_name: string;
-    price_adjustment: Money;
+    name: string;
+    min_selections: number;
+    max_selections: number;
+    is_required: boolean;
+    selected_options: DisplayAddOnOption[];
 }
-interface VariantAxisView {
+interface DisplayAddOnOption {
     id: string;
     name: string;
-    values: VariantAxisValueView[];
+    price: Money;
+    quantity: number;
+    image_url?: string;
+    description?: string;
 }
-interface VariantAxisValueView {
-    id: string;
-    value: string;
+interface UICartBusiness {
+    name: string;
+    logo_url?: string;
+    contact_email?: string;
+    contact_phone?: 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 UICartLocation {
+    id?: string;
+    name?: string;
 }
-interface CompositeWithDetails extends Composite {
-    product: Product;
-    groups: ComponentGroupWithComponents[];
+interface UICartCustomer {
+    id?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    address?: string;
 }
-interface ComponentGroup {
+interface UICartPricing {
+    subtotal: Money;
+    tax_amount: Money;
+    service_charge: Money;
+    total_discounts: Money;
+    total_price: Money;
+    tax_rate?: Money;
+    service_charge_rate?: Money;
+    currency: CurrencyCode;
+}
+interface AddOnOptionDetails {
     id: string;
-    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: {
@@ -1315,4 +1423,4 @@ interface SubmitAuthorizationInput {
     value: string;
 }
 
-export { type CategorySummary 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 KnowledgeArticle as K, type VariantAxisValue as L, type Money as M, type ProductVariantValue as N, type VariantLocationAvailability as O, type PaginationParams as P, type VariantAxisSelection as Q, type AddOn as R, type SalesChannel as S, type TaxonomyAttributeTemplate as T, type AddOnWithOptions as U, type VariantStrategy as V, type AddOnOption as W, type AddOnOptionPrice as X, type ProductAddOn as Y, ZERO as Z, type Category as _, moneyFromNumber as a, type CompositeSelectionData as a$, type Collection as a0, type CollectionSummary as a1, type CollectionProduct as a2, type BundlePriceType as a3, type Bundle as a4, type BundleSummary as a5, type BundleProduct as a6, type BundleWithDetails as a7, type BundleComponentData as a8, type BundleComponentInfo as a9, type Deal as aA, type ProductDealInfo as aB, type DiscountValidation as aC, type Tag as aD, type TagsResponse as aE, type CartStatus as aF, type CartChannel as aG, type PriceSource as aH, type AdjustmentType as aI, type PriceAdjustment as aJ, type TaxPathComponent as aK, type PricePathTaxInfo as aL, type PriceDecisionPath as aM, type ChosenPrice as aN, type BenefitType as aO, type AppliedDiscount as aP, type DiscountBreakdown as aQ, type DiscountDetails as aR, type SelectedAddOnOption as aS, type AddOnDetails as aT, type CartAddOn as aU, type VariantDetails as aV, type BundleSelectionInput as aW, type BundleStoredSelection as aX, type BundleSelectionData as aY, type CompositeStoredSelection as aZ, type CompositePriceBreakdown as a_, type BundleComponentView as aa, type BundleComponentVariantView as ab, type VariantAxisView as ac, type VariantAxisValueView as ad, type CompositePricingMode as ae, type GroupPricingBehavior as af, type ComponentSourceType as ag, type Composite as ah, type CompositeWithDetails as ai, type ComponentGroup as aj, type ComponentGroupWithComponents as ak, type CompositeGroupView as al, type CompositeComponentView as am, type CompositeComponent as an, type ComponentSelectionInput as ao, type CompositePriceResult as ap, type ComponentPriceBreakdown as aq, type PriceEntryType as ar, type Price as as, type LocationProductPrice as at, type ProductAvailability as au, type ProductTimeProfile as av, type ProductTaxonomy as aw, type TaxonomyWithChildren as ax, type ProductAvailabilityNow as ay, type DealBenefitType as az, type Pagination as b, type LineConfiguration as b0, type Cart as b1, type CartItem as b2, type CartTotals as b3, type DisplayCart as b4, type DisplayCartItem as b5, type DisplayAddOn as b6, type DisplayAddOnOption as b7, type UICartBusiness as b8, type UICartLocation as b9, type UICartCustomer as ba, type UICartPricing as bb, type AddOnOptionDetails as bc, type AddOnGroupDetails as bd, type VariantDetailsDTO as be, type CartItemDetails as bf, type UICart as bg, type UICartResponse as bh, type AddToCartInput as bi, type UpdateCartItemInput as bj, type CartSummary as bk, type PaymentStatus as bl, type PaymentProvider as bm, type PaymentMethodType as bn, type AddressAuthorizationData as bo, type AuthorizationType as bp, type PaymentProcessingState as bq, type PaymentMethod as br, type Payment as bs, type InitializePaymentResult as bt, type PaymentResponse as bu, type PaymentStatusResponse as bv, type PaymentErrorDetails as bw, type SubmitAuthorizationInput as bx, 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 };