@kasuvia/sdk 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,1891 @@
+import { AxiosInstance } from 'axios';
+import { GraphQLClient } from 'graphql-request';
+import React, { ReactNode } from 'react';
+import * as _tanstack_react_query from '@tanstack/react-query';
+
+/**
+ * Kasuvia SDK Configuration
+ *
+ * This module manages SDK initialization and runtime configuration.
+ * The SDK is client-based and runs in the browser.
+ * All backend URLs are bundled with the SDK.
+ *
+ * SECURITY NOTE: The storefront API key has limited permissions - it only provides
+ * customer-based resources from a business owner to customers, not full platform access.
+ * This key is safe to expose to the browser as a NEXT_PUBLIC_ environment variable.
+ */
+interface SdkConfig {
+    businessId: string;
+    storefrontApiKey: string;
+}
+interface SdkRuntimeConfig {
+    businessId: string;
+    storefrontApiKey: string;
+}
+/**
+ * Initialize the SDK with runtime credentials
+ * This must be called before any SDK operations
+ *
+ * IMPORTANT: In Next.js, this should be called in layout.tsx (server component)
+ * using private environment variables (kasuvia_BUSINESS_ID, kasuvia_STOREFRONT_API_KEY).
+ * The config is stored in module scope and will be available to client components
+ * through the SDK's bundled code.
+ *
+ * @param config - SDK configuration including credentials
+ */
+declare function initSdk(config: SdkConfig): void;
+/**
+ * Get the current runtime configuration
+ * Throws if SDK is not initialized
+ */
+declare function getRuntimeConfig(): SdkRuntimeConfig;
+/**
+ * Get backend URL for a specific service
+ * Internal use only - never exposed to storefront
+ */
+declare function getBackendUrl(service: 'auth' | 'store' | 'payment' | 'notifications' | 'cms'): string;
+/**
+ * Check if SDK is initialized
+ */
+declare function isInitialized(): boolean;
+/**
+ * Reset SDK configuration (mainly for testing)
+ */
+declare function resetConfig(): void;
+
+/**
+ * HTTP Client - Pre-configured Axios instances
+ *
+ * Each Axios instance is created with a default baseURL based on the static
+ * service URL. The baseURLs are complete URLs including the API version,
+ * selected based on the configured environment (development/production).
+ */
+
+declare function getOrCreateGuestSessionId(): string;
+declare function getGuestSessionId(): string | null;
+declare function clearGuestSessionId(): void;
+declare const storeManagementAxios: AxiosInstance;
+declare const publicStoreAxios: AxiosInstance;
+declare const authAxios: AxiosInstance;
+declare const paymentAxios: AxiosInstance;
+declare const cmsAxios: AxiosInstance;
+/**
+ * configureHttpClients()
+ * Updates the baseURL of all Axios instances to match the configured environment.
+ * This must be called after initSdk() to ensure the correct environment URLs are used.
+ */
+declare function configureHttpClients(): void;
+
+declare const tokenStore: {
+    readonly getAccessToken: () => string | null;
+    readonly setAccessToken: (token: string | null) => void;
+    readonly getRefreshToken: () => string | null;
+    readonly setRefreshToken: (token: string | null, remember?: boolean) => void;
+    readonly clearAll: () => void;
+    readonly hasSession: () => boolean;
+    readonly isPersistent: () => boolean;
+};
+/**
+ * Perform token refresh with queue-coalescing to avoid parallel refresh races.
+ */
+declare function refreshToken(): Promise<string>;
+
+/**
+ * GraphQL Client
+ *
+ * Provides a GraphQL client with tenant and auth headers for product queries.
+ * The endpoint URL is derived from the static BACKEND_URLS constant (eager,
+ * module-load safe). Auth headers are injected fresh on each request via a
+ * factory so the token is always current.
+ */
+
+/**
+ * Returns a GraphQL client instance with up-to-date auth headers.
+ * A new client is created on each call so token/config changes take effect
+ * immediately without requiring an explicit reset.
+ */
+declare function getGraphQLClient(): GraphQLClient;
+/**
+ * No-op — kept for backward compatibility.
+ * Clients are now stateless (created fresh on each call), so there is no
+ * cached instance to reset.
+ */
+declare function resetGraphQLClient(): void;
+
+/**
+ * Simplified customer auth types for luxe-storefront.
+ * Customers only need enough to track their orders — no RBAC, MFA, or complex profiles.
+ */
+/**
+ * Media System response object for avatar/profile picture.
+ * Stored as JSON in the backend Profile model.
+ */
+interface AvatarObject {
+    id: string;
+    alt: string;
+    url: string;
+}
+interface CustomerProfileFields {
+    firstname: string;
+    lastname: string;
+    phone: string;
+}
+interface CustomerUser {
+    id: string;
+    email: string;
+    firstname?: string;
+    lastname?: string;
+    phone?: string;
+    /** Derived display name — prefer firstname + lastname when available */
+    full_name?: string;
+    avatar: string | null;
+    provider: 'google' | 'facebook' | 'email';
+}
+/** GET/PUT /auth/profile/ — matches luxe-auth UserSerializer */
+interface AuthUserResponse {
+    id: string;
+    email: string;
+    is_google_auth_enabled?: boolean;
+    is_facebook_auth_enabled?: boolean;
+    profile?: {
+        firstname?: string;
+        lastname?: string;
+        phone?: string;
+        profile_picture?: string | null;
+    };
+}
+interface UpdateProfilePayload {
+    firstname?: string;
+    lastname?: string;
+    phone?: string;
+}
+interface BusinessContext {
+    id: string;
+    business_id: string;
+    name: string;
+    logo_picture?: string | null;
+    display_currency?: string;
+}
+interface CustomerAuthResponse {
+    access: string;
+    refresh: string;
+    user: CustomerUser;
+    business: BusinessContext;
+    is_new?: boolean;
+}
+interface RefreshTokenResponse {
+    access: string;
+    refresh?: string;
+}
+/** POST /auth/login/customer/ — field name is `tenant_id` (the business_id) */
+interface CustomerLoginPayload {
+    tenant_id: string;
+    email: string;
+    password: string;
+}
+/** POST /auth/register/customer/ */
+interface CustomerRegisterPayload {
+    tenant_id: string;
+    /** Full name — backend splits this into firstname and lastname on the Profile */
+    full_name: string;
+    email: string;
+    password: string;
+}
+/** POST /auth/verify-otp/ */
+interface OTPVerifyPayload {
+    email: string;
+    code: string;
+    purpose?: 'verify' | 'password_reset';
+}
+/** POST /auth/resend-otp/ */
+interface ResendOTPPayload {
+    email: string;
+}
+/** POST /auth/logout/ */
+interface LogoutPayload {
+    refresh?: string;
+}
+interface AuthContextValue {
+    customer: CustomerUser | null;
+    isLoading: boolean;
+    isModalOpen: boolean;
+    openModal: () => void;
+    closeModal: () => void;
+    setCustomer: (user: CustomerUser | null) => void;
+    logout: () => Promise<void>;
+}
+
+/**
+ * Shipping and delivery types for the storefront
+ */
+interface ShippingRate {
+    id: string;
+    carrier_name: string;
+    carrier_logo: string;
+    carrier_rate_description: string;
+    carrier_slug: string;
+    amount: number;
+    currency: string;
+    delivery_time: string;
+    delivery_eta: number;
+    pickup_time: string;
+    pickup_eta: number;
+    pickup_available: boolean;
+    dropoff_available?: boolean;
+    dropoff_required?: boolean;
+}
+interface ShippingRatesResponse {
+    status: boolean;
+    message: string;
+    data: ShippingRate[];
+}
+interface DeliveryAddress {
+    first_name: string;
+    last_name: string;
+    phone: string;
+    street: string;
+    city: string;
+    state: string;
+    lga: string;
+    country: string;
+    postal: string;
+}
+
+type ProductType = "physical" | "digital" | "service" | "bespoke";
+
+interface Address {
+    street: string;
+    city: string;
+    state: string;
+    country: string;
+    zip?: string;
+}
+interface Collection {
+    id: string;
+    business_id?: string;
+    name: string;
+    slug: string;
+    description?: string;
+    image?: {
+        url: string;
+        alt?: string;
+        id?: string;
+    };
+    collection_type?: string;
+    rules?: Record<string, unknown>;
+    status?: string;
+    sort_order?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface Inventory {
+    id: string;
+    product_id: string;
+    variant_id?: string;
+    quantity: number;
+    reserved: number;
+    reorder_point: number;
+    reorder_quantity: number;
+    track_quantity: boolean;
+    allow_backorder: boolean;
+    available: number;
+    is_in_stock: boolean;
+    is_low_stock: boolean;
+    updated_at: string;
+}
+interface ProductVariant {
+    id: string;
+    product_id: string;
+    sku?: string;
+    attributes: Record<string, string>;
+    price?: number;
+    images: Array<{
+        url: string;
+        alt?: string;
+        id?: string;
+    }>;
+    weight_kg?: number;
+    is_active: boolean;
+    inventory?: Inventory;
+    created_at: string;
+    updated_at: string;
+}
+interface CustomField {
+    label: string;
+    unit?: string;
+    required: boolean;
+    type?: string;
+    key?: string;
+    placeholder?: string;
+}
+interface Product {
+    id: string;
+    business_id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    brand?: string;
+    product_type: ProductType;
+    requires_shipping: boolean;
+    is_consumable: boolean;
+    is_bespoke: boolean;
+    base_price: number;
+    currency: string;
+    images: Array<{
+        url: string;
+        alt?: string;
+        id?: string;
+    }>;
+    tags: string[];
+    custom_fields: CustomField[];
+    is_published: boolean;
+    is_featured: boolean;
+    is_popular: boolean;
+    is_new: boolean;
+    is_temporary: boolean;
+    digital_file_key?: string;
+    download_limit?: number;
+    download_expires_at?: string;
+    weight_kg: number;
+    length_cm?: number;
+    width_cm?: number;
+    height_cm?: number;
+    created_at: string;
+    updated_at: string;
+    variants: ProductVariant[];
+    collections: Collection[];
+}
+interface ListParams {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+    ordering?: string;
+    collectionSlug?: string;
+    excludeProductId?: string;
+}
+interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+}
+interface CartItem {
+    id: string;
+    product_id: string;
+    product_slug: string;
+    product_name: string;
+    image?: string;
+    variant_id?: string;
+    variant_attributes?: string | Record<string, string>;
+    unit_price: number;
+    quantity: number;
+    custom_measurements?: string;
+    is_bespoke: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface CartResponse {
+    items: CartItem[];
+    subtotal: number;
+    total: number;
+    item_count: number;
+    product_type?: string;
+}
+interface WishlistItem {
+    id: string;
+    product_id: string;
+    notes?: string;
+    created_at: string;
+    product_name?: string;
+    product_slug?: string;
+    product_price?: number;
+    product_image?: string;
+}
+interface WishlistListResponse {
+    items: WishlistItem[];
+    total: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+}
+interface WishlistCheckResponse {
+    in_wishlist: boolean;
+}
+type OrderStatus = 'pending' | 'confirmed' | 'processing' | 'packed' | 'picked_up' | 'in_transit' | 'shipped' | 'delivered' | 'voided' | 'refunded' | 'failed';
+type BespokeStageKey = "received" | "development" | "finished" | "dispatched";
+interface OrderItem {
+    id: string;
+    productName: string;
+    image: string;
+    quantity: number;
+    price: number;
+}
+interface Order {
+    id: string;
+    display_id?: string;
+    items: OrderItem[];
+    total: number;
+    status: OrderStatus;
+    customerEmail: string;
+    customerName: string;
+    createdAt: number;
+    updatedAt: number;
+    deliveryMethod?: string;
+    trackingNumber?: string;
+    deliveryAddress?: string;
+    shippingAddress?: DeliveryAddress;
+    cancellationReason?: string;
+    hasBespoke?: boolean;
+    bespokeStage?: BespokeStageKey;
+    bespokeBrief?: string;
+    deliveryStatus?: string;
+    carrierName?: string;
+    terminalShipmentId?: string;
+    guestToken?: string;
+    guestEmail?: string;
+    guestPhone?: string;
+    guestName?: string;
+}
+interface CheckoutCustomer {
+    first_name: string;
+    last_name: string;
+    email: string;
+    phone: string;
+}
+interface ShippingLocation {
+    street: string;
+    city: string;
+    state: string;
+    lga: string;
+    country: string;
+    postal: string;
+}
+interface FindOrderParams {
+    email: string;
+    order_id: string;
+}
+interface CreateOrderParams {
+    customer_id?: string | null;
+    status?: string;
+    shipping_address?: DeliveryAddress;
+    checkout_session_id?: string;
+    items: Array<{
+        product_id: string;
+        product_name: string;
+        quantity: number;
+        unit_price: number;
+        variant_id?: string;
+        variant_details?: Record<string, unknown>;
+        custom_measurements?: Record<string, unknown>;
+    }>;
+    delivery_method?: string;
+    delivery_address?: string;
+    total?: number;
+    payment_method?: string;
+    shipping_rate_id?: string;
+    guest_token?: string;
+    guest_email?: string;
+    guest_phone?: string;
+    guest_name?: string;
+    product_type?: string;
+    bespoke_brief?: string;
+    bespoke_reference_images?: string[];
+    bespoke_measurements?: Record<string, string>;
+    bespoke_preferred_timeline?: string;
+    bespoke_special_instructions?: string;
+}
+
+/**
+ * @file types/payments/index.ts
+ * @description All customer-facing payment types for the Luxe Payment System.
+ *
+ * Auth model:
+ *   - X-Storefront-Key  → identifies the business storefront
+ *   - X-Business-ID     → tenant context
+ * No business-owner JWT used here — these are CUSTOMER-facing types.
+ *
+ * Payment flow:
+ *   Customer → Business Owner : Monnify (NGN) | Flutterwave (non-NGN)
+ *   Business Owner → Luxe     : Subscription (separate, JWT-auth)
+ *   Luxe → Business Owner     : Payout (separate, JWT-auth)
+ */
+interface Currency {
+    code: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    is_active: boolean;
+}
+interface SupportedCurrenciesResponse {
+    currencies: Currency[];
+}
+interface BackendLanguage {
+    code: string;
+    label: string;
+    flag: string;
+}
+interface SupportedLang {
+    code: string;
+    appCode: string;
+    label: string;
+    native: string;
+    flag: string;
+}
+interface SupportedLanguagesResponse {
+    languages: BackendLanguage[];
+}
+interface DVACreateRequest {
+    order_id?: string;
+    amount: number;
+    customer_email: string;
+    customer_name?: string;
+    /** Defaults to NGN — DVA is Monnify-only */
+    currency?: string;
+    /** Idempotency key to prevent duplicate DVA creation */
+    idempotency_key?: string;
+}
+interface PaymentInitiateRequest {
+    amount: number;
+    currency: string;
+    customer_email: string;
+    customer_name?: string;
+    order_id?: string;
+    quote_id?: string;
+    /** Window origin of the storefront — used as gateway redirect base URL */
+    storefront_origin?: string;
+    metadata?: Record<string, string | number | boolean>;
+    /** Idempotency key to prevent duplicate payment initiation */
+    idempotency_key?: string;
+}
+interface ConversionQuote {
+    id: string;
+    business_id: string;
+    from_currency: string;
+    to_currency: string;
+    rate: number;
+    original_amount: number;
+    converted_amount: number;
+    is_used: boolean;
+    expires_at: string;
+    created_at: string;
+}
+interface DVADetails {
+    account_number: string;
+    bank_name: string;
+    account_name: string;
+    reference: string;
+    amount: number;
+    transaction_id: string;
+    expires_at: string;
+}
+interface PaymentInitiateResponse {
+    id: string;
+    gateway_ref: string;
+    gateway: string;
+    status: string;
+    /** Normalised top-level checkout URL for gateway redirect */
+    checkout_url: string;
+}
+interface TransactionVerifyResponse {
+    id: string;
+    status: string;
+    amount: number;
+    currency: string;
+    gateway_ref: string;
+    gateway?: string;
+    order_id?: string;
+    escrow_status?: string;
+    escrow_release_date?: string;
+    metadata_json?: Record<string, unknown>;
+}
+
+/**
+ * Consultation types for customer-facing storefront
+ */
+type ConsultationStatus = "pending" | "quoted" | "negotiating" | "deposit_pending" | "deposit_paid" | "converting" | "converted" | "rejected";
+type ConsultationProductType = "bespoke" | "service";
+interface ConsultationMessage {
+    id: string;
+    consultation_id: string;
+    sender_id: string;
+    sender_role: "customer" | "merchant" | "system";
+    message: string;
+    attachments: string[];
+    is_read: boolean;
+    created_at: string;
+}
+interface Consultation {
+    id: string;
+    business_id: string;
+    customer_id: string;
+    product_id: string | null;
+    title: string;
+    status: ConsultationStatus;
+    product_type: ConsultationProductType;
+    quote_amount: number | null;
+    agreed_price: number | null;
+    deposit_amount: number | null;
+    deposit_required: boolean;
+    is_physical_delivery: boolean;
+    expected_delivery_type: string | null;
+    structured_details: Record<string, unknown>;
+    rejection_reason: string | null;
+    converted_order_id: string | null;
+    slot_booking_id: string | null;
+    capacity_config_id: string | null;
+    created_at: string;
+    updated_at: string;
+    messages: ConsultationMessage[];
+}
+interface ConsultationCreatePayload {
+    product_id?: string;
+    title: string;
+    description: string;
+    reference_images?: string[];
+    custom_measurements?: Record<string, string | number>;
+    preferred_timeline?: string;
+    special_instructions?: string;
+    product_type?: ConsultationProductType;
+}
+interface ConsultationMessagePayload {
+    message: string;
+    attachments?: string[];
+}
+interface ConsultationQuoteAcceptPayload {
+    agreed_price: number;
+}
+interface BespokeAvailability {
+    available_slots: number;
+    next_available_date: string | null;
+    period_end: string;
+    blocked_dates: string[];
+    production_days: number;
+    is_available: boolean;
+}
+
+/**
+ * Service booking types for customer-facing storefront
+ */
+type ServiceLocationType = "remote" | "physical" | "both";
+type ServiceType = "appointment" | "project" | "recurring";
+type AppointmentStatus = "pending" | "confirmed" | "in_progress" | "completed" | "voided" | "no_show";
+interface AvailableSlot {
+    date: string;
+    start_time: string;
+    end_time: string;
+    slots_remaining: number;
+}
+interface ServiceAppointment {
+    id: string;
+    product_id: string;
+    customer_id: string;
+    order_id: string | null;
+    status: AppointmentStatus;
+    appointment_date: string;
+    start_time: string;
+    end_time: string;
+    location_type: ServiceLocationType;
+    customer_address: Record<string, unknown> | null;
+    meeting_link: string | null;
+    customer_notes: string | null;
+    price: number;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+    voided_at: string | null;
+    cancellation_reason: string | null;
+}
+interface ServiceAppointmentCreatePayload {
+    product_id: string;
+    scheduled_date: string;
+    scheduled_time: string;
+    location_type?: ServiceLocationType;
+    customer_address?: Record<string, unknown>;
+    customer_notes?: string;
+}
+interface DeliverableStatus {
+    pending: "pending";
+    in_progress: "in_progress";
+    review: "review";
+    approved: "approved";
+    rejected: "rejected";
+}
+type DeliverableStatusType = DeliverableStatus[keyof DeliverableStatus];
+interface ServiceDeliverable {
+    id: string;
+    order_id: string;
+    title: string;
+    description: string;
+    status: DeliverableStatusType;
+    due_date: string | null;
+    submitted_at: string | null;
+    attachments: string[];
+    customer_feedback: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface DeliverableApprovalPayload {
+    approved: boolean;
+    feedback?: string;
+}
+
+/**
+ * Bespoke slot booking types for customer-facing storefront
+ */
+type SlotBookingStatus = "reserved" | "confirmed" | "completed" | "voided";
+interface BespokeSlotBooking {
+    id: string;
+    product_id: string;
+    capacity_config_id: string | null;
+    consultation_id: string | null;
+    order_id: string | null;
+    customer_id: string;
+    status: SlotBookingStatus;
+    preferred_start_date: string | null;
+    preferred_end_date: string | null;
+    estimated_completion_date: string | null;
+    notes: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface BespokeCapacityConfig {
+    id: string;
+    business_id: string;
+    product_id: string;
+    slot_period: "weekly" | "monthly" | "yearly";
+    total_slots: number;
+    slots_used: number;
+    period_start_date: string;
+    period_end_date: string;
+    production_days_per_order: number;
+    buffer_days_between_orders: number;
+    blocked_dates: string[];
+    auto_reset: boolean;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+
+/**
+ * CMS Types
+ *
+ * Types for kasuvia-cms integration - dynamic content models and entries
+ */
+interface CmsField {
+    name: string;
+    label: string;
+    type: string;
+    required: boolean;
+    config: Record<string, any>;
+    sub_fields?: CmsField[];
+}
+interface CmsModelPermissions {
+    read: boolean;
+    create: boolean;
+    update: boolean;
+    delete: boolean;
+}
+interface CmsModelPublicApiPermissions {
+    public_api: CmsModelPermissions;
+}
+interface CmsModel {
+    id: string;
+    business_id: string;
+    model_slug: string;
+    display_name: string;
+    description: string | null;
+    fields: CmsField[];
+    permissions: CmsModelPublicApiPermissions;
+}
+interface CmsEntry {
+    id: string;
+    business_id: string;
+    model_slug: string;
+    data: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+    created_by: string | null;
+}
+interface CmsEntryListResponse {
+    entries: CmsEntry[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+interface CmsIcon {
+    id: string;
+    name: string;
+    category: string;
+    tags: string[];
+}
+interface CmsIconListResponse {
+    icons: CmsIcon[];
+    total: number;
+}
+interface ListCmsEntriesParams {
+    page?: number;
+    page_size?: number;
+}
+interface CreateCmsEntryParams {
+    data: Record<string, any>;
+}
+interface UpdateCmsEntryParams {
+    data: Record<string, any>;
+}
+
+/**
+ * Media types for the storefront
+ */
+interface MediaAsset {
+    id: string;
+    url: string;
+    filename: string;
+    content_type: string;
+    size: number;
+    business_id: string;
+    affiliation: string;
+    created_at: string;
+    alt?: string;
+    description?: string;
+}
+interface MediaUploadParams {
+    business_id?: string;
+    owner_id?: string;
+    uploaded_by_name?: string;
+    affiliation?: string;
+    context: string;
+    entity_id: string;
+    alt?: string;
+    description?: string;
+    idempotency_key?: string;
+}
+interface MediaAssetUpdatePayload {
+    alt?: string;
+    description?: string;
+    affiliation?: string;
+}
+interface StorageStats {
+    total_bytes: number;
+    used_bytes: number;
+    available_bytes: number;
+    asset_count: number;
+}
+
+interface BusinessConfig {
+    business_id: string;
+    store_name: string;
+    store_currency: string;
+    is_active: boolean;
+}
+
+type Theme = "light" | "dark";
+type LangCode = "en" | "ha" | "yo" | "ig" | "fr";
+interface AppState {
+    theme: Theme;
+    lang: LangCode;
+    currency: string;
+}
+interface AppContextValue extends AppState {
+    setTheme: (t: Theme) => void;
+    setLang: (l: LangCode) => void;
+    setCurrency: (c: string) => void;
+    formatPrice: (amount: number, fromCurrency?: string) => string;
+    resetAppState: () => void;
+    t: (text: string) => string;
+    translate: (text: string) => Promise<string>;
+}
+interface Country {
+    name: string;
+    code: string;
+    dial_code: string;
+    min_age: number;
+}
+interface State {
+    name: string;
+    code: string;
+    full_iso_code: string;
+    type: string;
+}
+
+/**
+ * Fetch guest cart from backend (Redis-backed).
+ */
+declare function getGuestCart(): Promise<CartItem[]>;
+/**
+ * Add item to guest cart (Redis-backed).
+ */
+declare function addToGuestCart(item: CartItem): Promise<CartItem[]>;
+/**
+ * Update quantity of a guest cart item.
+ */
+declare function updateGuestCartItemQuantity(itemId: string, quantity: number): Promise<CartItem[]>;
+/**
+ * Remove an item from the guest cart.
+ */
+declare function removeFromGuestCart(itemId: string): Promise<CartItem[]>;
+/**
+ * Clear the entire guest cart.
+ */
+declare function clearGuestCart(): Promise<void>;
+/**
+ * Fetch authenticated user's cart from backend.
+ */
+declare function getCart(): Promise<CartResponse>;
+/**
+ * Add item to authenticated user's cart.
+ */
+declare function addToCart(item: {
+    product_id: string;
+    product_slug: string;
+    product_name: string;
+    image?: string;
+    variant_id?: string;
+    variant_attributes?: string;
+    unit_price: number;
+    quantity: number;
+    custom_measurements?: string;
+    is_bespoke: boolean;
+}): Promise<CartResponse>;
+/**
+ * Update item quantity in authenticated user's cart.
+ */
+declare function updateCartItem(itemId: string, quantity: number): Promise<CartResponse>;
+/**
+ * Remove item from authenticated user's cart.
+ */
+declare function removeFromCart(itemId: string): Promise<CartResponse>;
+/**
+ * Clear authenticated user's cart.
+ */
+declare function clearCart(): Promise<void>;
+/**
+ * Merge guest cart (from Redis) into authenticated user's DB cart.
+ */
+declare function mergeGuestCart(): Promise<CartResponse>;
+/**
+ * Convenience wrapper: merge guest cart if it has items (called post-login).
+ */
+declare function mergeGuestCartIfPresent(): Promise<void>;
+/**
+ * Returns 0 — count is now server-driven. Use the hook instead.
+ * Kept for backward compatibility.
+ */
+declare function getGuestCartCount(): number;
+/**
+ * Returns 0 — subtotal is now server-driven.
+ * Kept for backward compatibility.
+ */
+declare function getGuestCartSubtotal(): number;
+/**
+ * Derive product type from items (guest cart, no backend lookup needed).
+ */
+declare function getGuestCartProductType(): "physical" | "digital" | "bespoke";
+
+declare function createOrder(payload: CreateOrderParams): Promise<Order>;
+declare function findOrder(params: FindOrderParams): Promise<Order>;
+declare function findOrderByToken(token: string): Promise<Order>;
+declare function getOrders(params?: {
+    email?: string;
+    page?: number;
+    page_size?: number;
+}): Promise<Order[]>;
+declare function cancelOrder(orderId: string, reason: string): Promise<Order>;
+declare function trackOrder(orderId: string, token?: string): Promise<Order>;
+
+/**
+ * POST /auth/login/customer/
+ * The `tenant_id` is automatically filled from config.api.storefrontBusinessId.
+ */
+declare function loginCustomer(payload: Omit<CustomerLoginPayload, 'tenant_id'>): Promise<CustomerAuthResponse>;
+/**
+ * POST /auth/register/customer/
+ * The `tenant_id` is automatically filled from config.api.storefrontBusinessId.
+ */
+declare function registerCustomer(payload: Omit<CustomerRegisterPayload, 'tenant_id'>): Promise<CustomerAuthResponse>;
+/** POST /auth/logout/ — revokes the server-side session. Always clears local tokens. */
+declare function logout(): Promise<void>;
+/**
+ * Verify a social provider id_token (or access_token for Facebook) with the backend.
+ * The backend validates the token with the provider and creates/finds the customer.
+ *
+ * Industry-standard "ID Token Exchange" pattern:
+ *   1. Customer completes Google/Facebook sign-in on the storefront
+ *   2. Storefront receives an id_token / access_token from the provider
+ *   3. This function sends it to the backend for server-side verification
+ *   4. Backend returns our JWT tokens
+ */
+declare function verifySocialToken(provider: 'google' | 'facebook', token: string): Promise<CustomerAuthResponse>;
+/** Map luxe-auth UserSerializer response to storefront CustomerUser. */
+declare function mapAuthUserToCustomer(data: AuthUserResponse, provider?: CustomerUser['provider']): CustomerUser;
+/** GET /auth/profile/ */
+declare function getMe(): Promise<CustomerUser>;
+/** GET /auth/profile/ - alias for getMe for backward compatibility */
+declare function getAuthUser(): Promise<AuthUserResponse>;
+/** PUT /auth/profile/ — update firstname, lastname, phone */
+declare function updateProfile(payload: UpdateProfilePayload): Promise<CustomerUser>;
+/**
+ * Silently refresh the access token on app boot.
+ * Builds CustomerUser from JWT claims — no additional profile API call needed.
+ * Returns null if no refresh token exists or if the refresh fails.
+ * Includes a concurrent lock to prevent React Strict Mode from double-firing and blacklisting the token.
+ *
+ * Network error resilience:
+ * - Classifies errors as network vs auth
+ * - Retries transient network errors with exponential backoff
+ * - Immediately fails on auth errors (401/403) to avoid infinite loops
+ * - Clears auth state on any failure to ensure consistent logout behavior
+ */
+declare function silentRefresh(): Promise<{
+    user: CustomerUser;
+    provider: CustomerUser['provider'];
+} | null>;
+/** Store tokens after OAuth callback or login/register response. */
+declare function storeTokens(access: string, refresh: string, remember?: boolean): void;
+
+/**
+ * Fetch all active products for the storefront.
+ */
+declare function getStorefrontProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch a single product by slug for the storefront.
+ */
+declare function getStorefrontProductBySlug(slug: string): Promise<Product>;
+/**
+ * Fetch latest products for the storefront.
+ */
+declare function getLatestProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch popular products for the storefront.
+ */
+declare function getPopularProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch featured products for the storefront.
+ */
+declare function getFeaturedProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch new products for the storefront.
+ */
+declare function getNewProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch recommended products for the storefront.
+ * Returns featured, popular, and new products.
+ * Optionally excludes a specific product ID.
+ */
+declare function getRecommendedProducts(params?: ListParams & {
+    excludeProductId?: string;
+}): Promise<PaginatedResponse<Product>>;
+
+/**
+ * Fetch paginated active collections for the storefront.
+ */
+declare function getStorefrontCollections(params?: ListParams): Promise<PaginatedResponse<Collection>>;
+/**
+ * Fetch a single collection by its slug.
+ */
+declare function getStorefrontCollectionBySlug(slug: string): Promise<Collection>;
+
+/**
+ * Fetch the customer's wishlist for the current business.
+ */
+declare function getWishlist(params?: {
+    page?: number;
+    pageSize?: number;
+}): Promise<WishlistListResponse>;
+/**
+ * Check if a product is in the customer's wishlist.
+ */
+declare function checkInWishlist(productId: string): Promise<WishlistCheckResponse>;
+/**
+ * Add a product to the customer's wishlist.
+ */
+declare function addToWishlist(productId: string, notes?: string): Promise<WishlistItem>;
+/**
+ * Remove an item from the customer's wishlist by item ID.
+ */
+declare function removeFromWishlist(itemId: string): Promise<void>;
+/**
+ * Remove a product from the customer's wishlist by product ID.
+ */
+declare function removeProductFromWishlist(productId: string): Promise<void>;
+
+/**
+ * Create a Monnify Dedicated Virtual Account so the customer can pay via
+ * bank transfer. Note: Monnify DVA only supports NGN currency - the backend
+ * will reject non-NGN requests for this payment method.
+ */
+declare function createDedicatedAccount(request: DVACreateRequest): Promise<DVADetails>;
+/**
+ * Initiate a card payment (customer → business owner).
+ * Routes to Monnify (NGN) or Flutterwave (non-NGN) on the backend.
+ * Returns a checkout_url to redirect the customer to the gateway.
+ */
+declare function initiatePayment(request: PaymentInitiateRequest): Promise<PaymentInitiateResponse>;
+/**
+ * Request a 15-minute rate-locked conversion quote for non-NGN transactions.
+ */
+declare function requestQuote(amount: number): Promise<ConversionQuote>;
+/**
+ * Verify a payment after the gateway redirects back to /checkout/verify.
+ */
+declare function verifyTransaction(reference: string): Promise<TransactionVerifyResponse>;
+/**
+ * Poll transaction status by internal transaction ID.
+ */
+declare function getTransactionStatus(transactionId: string): Promise<TransactionVerifyResponse>;
+declare const paymentService: {
+    readonly createDedicatedAccount: typeof createDedicatedAccount;
+    readonly initiatePayment: typeof initiatePayment;
+    readonly requestQuote: typeof requestQuote;
+    readonly verifyTransaction: typeof verifyTransaction;
+    readonly getTransactionStatus: typeof getTransactionStatus;
+};
+
+declare function createConsultation(payload: ConsultationCreatePayload): Promise<Consultation>;
+declare function getConsultations(): Promise<Consultation[]>;
+declare function getConsultation(id: string): Promise<Consultation>;
+declare function sendMessage(id: string, payload: ConsultationMessagePayload): Promise<void>;
+declare function acceptQuote(id: string, payload: ConsultationQuoteAcceptPayload): Promise<Consultation>;
+declare function rejectQuote(id: string, reason?: string): Promise<Consultation>;
+declare const consultationService: {
+    createConsultation: typeof createConsultation;
+    getConsultations: typeof getConsultations;
+    getConsultation: typeof getConsultation;
+    sendMessage: typeof sendMessage;
+    acceptQuote: typeof acceptQuote;
+    rejectQuote: typeof rejectQuote;
+};
+
+interface CartItemPayload {
+    product: {
+        name: string;
+        price: number;
+        weight: number;
+    };
+    variant: ProductVariant | null;
+    quantity: number;
+}
+interface RateAddress {
+    city: string;
+    state: string;
+    country: string;
+}
+interface ShippingRatesRequest {
+    cart_items: CartItemPayload[];
+    origin_address: RateAddress;
+    destination_address: RateAddress;
+    currency?: string;
+}
+/**
+ * Fetch shipping rates for a cart.
+ */
+declare function getShippingRates(payload: ShippingRatesRequest): Promise<ShippingRatesResponse>;
+/**
+ * Fetch the seller's registered shipping address.
+ */
+declare function getSellerShippingAddress(): Promise<{
+    terminal_address_id: string | null;
+    address_details: {
+        city: string;
+        state: string;
+        country: string;
+        line1: string;
+        line2: string;
+        zip: string;
+    } | null;
+    business_id: string;
+    message: string;
+}>;
+/**
+ * Validate a shipping address.
+ */
+declare function validateShippingAddress(payload: {
+    first_name: string;
+    last_name: string;
+    phone: string;
+    address_line1: string;
+    address_line2?: string;
+    city: string;
+    state: string;
+    country: string;
+    postal_code?: string;
+}): Promise<{
+    valid: boolean;
+    message?: string;
+    data?: Array<{
+        name: string;
+        city_id: string;
+        stateCode: string;
+        countryCode: string;
+    }>;
+}>;
+declare const logisticsService: {
+    getShippingRates: typeof getShippingRates;
+    getSellerShippingAddress: typeof getSellerShippingAddress;
+    validateShippingAddress: typeof validateShippingAddress;
+};
+
+declare function checkAvailability(product_id: string): Promise<BespokeAvailability>;
+declare const bespokeService: {
+    checkAvailability: typeof checkAvailability;
+};
+
+declare function getAvailableSlots(product_id: string, date_from: string, date_to: string): Promise<AvailableSlot[]>;
+declare function bookAppointment(payload: ServiceAppointmentCreatePayload): Promise<ServiceAppointment>;
+declare function getAppointments(): Promise<ServiceAppointment[]>;
+declare function getAppointment(id: string): Promise<ServiceAppointment>;
+declare function cancelAppointment(id: string): Promise<void>;
+declare function getDeliverables(order_id: string): Promise<ServiceDeliverable[]>;
+declare function approveDeliverable(order_id: string, deliverable_id: string): Promise<ServiceDeliverable>;
+declare function requestRevision(order_id: string, deliverable_id: string, feedback: string): Promise<ServiceDeliverable>;
+declare const serviceBookingService: {
+    getAvailableSlots: typeof getAvailableSlots;
+    bookAppointment: typeof bookAppointment;
+    getAppointments: typeof getAppointments;
+    getAppointment: typeof getAppointment;
+    cancelAppointment: typeof cancelAppointment;
+    getDeliverables: typeof getDeliverables;
+    approveDeliverable: typeof approveDeliverable;
+    requestRevision: typeof requestRevision;
+};
+
+interface ContactFormData {
+    name: string;
+    email: string;
+    subject: string;
+    message: string;
+    source?: string;
+    company_name?: string;
+    current_year?: number;
+    turnstile_token?: string;
+}
+/**
+ * Send contact email to Luxe team.
+ * POST /contact/send-contact-email
+ */
+declare function sendContactEmail(payload: ContactFormData): Promise<{
+    detail: string;
+}>;
+/**
+ * Send confirmation email to user.
+ * POST /contact/send-contact-confirmation
+ */
+declare function sendContactConfirmation(payload: Omit<ContactFormData, 'turnstile_token'>): Promise<{
+    detail: string;
+}>;
+declare const notificationsService: {
+    readonly sendContactEmail: typeof sendContactEmail;
+    readonly sendContactConfirmation: typeof sendContactConfirmation;
+};
+
+/**
+ * App Service
+ *
+ * Handles translation and other app-level utilities.
+ */
+declare function googleTranslate(text: string, target: string, source?: string): Promise<string>;
+
+/**
+ * Fetch supported languages from the payment system.
+ * Resolves to: {luxePaymentBackendUrl}/config/supported-languages
+ */
+declare function getSupportedLanguages(): Promise<SupportedLanguagesResponse>;
+/**
+ * Fetch supported currencies from the payment system.
+ * Resolves to: {luxePaymentBackendUrl}/config/supported-currencies
+ */
+declare function getSupportedCurrencies(): Promise<SupportedCurrenciesResponse>;
+/**
+ * Fetch the business's public configuration, including store_currency.
+ * Uses publicStoreAxios (X-Storefront-Key + X-Business-ID — no user JWT required).
+ * Resolves to: {luxeStoreBackendUrl}/business/profile
+ */
+declare function getBusinessConfig(): Promise<BusinessConfig>;
+declare const configService: {
+    readonly getSupportedLanguages: typeof getSupportedLanguages;
+    readonly getSupportedCurrencies: typeof getSupportedCurrencies;
+    readonly getBusinessConfig: typeof getBusinessConfig;
+};
+
+/**
+ * List CMS entries for a specific model.
+ * Requires public_api.read permission on the model.
+ */
+declare function listCmsEntries(modelSlug: string, params?: ListCmsEntriesParams): Promise<CmsEntryListResponse>;
+/**
+ * Get a single CMS entry by ID.
+ * Requires public_api.read permission on the model.
+ */
+declare function getCmsEntry(modelSlug: string, entryId: string): Promise<CmsEntry>;
+/**
+ * Create a new CMS entry.
+ * Requires public_api.create permission on the model.
+ */
+declare function createCmsEntry(modelSlug: string, params: CreateCmsEntryParams): Promise<CmsEntry>;
+/**
+ * Update an existing CMS entry.
+ * Requires public_api.update permission on the model.
+ */
+declare function updateCmsEntry(modelSlug: string, entryId: string, params: UpdateCmsEntryParams): Promise<CmsEntry>;
+/**
+ * Delete a CMS entry.
+ * Requires public_api.delete permission on the model.
+ */
+declare function deleteCmsEntry(modelSlug: string, entryId: string): Promise<void>;
+
+/**
+ * Cart Hook & Context Provider
+ *
+ * React Query hooks for cart operations with unified drawer state sharing.
+ */
+
+interface UseCartReturn {
+    cart: CartResponse | undefined;
+    items: CartItem[];
+    count: number;
+    isOpen: boolean;
+    setOpen: (open: boolean) => void;
+    isLoading: boolean;
+    error: Error | null;
+    addToCart: (item: {
+        product_id: string;
+        product_slug: string;
+        product_name: string;
+        image?: string;
+        variant_id?: string;
+        variant_attributes?: string;
+        unit_price: number;
+        quantity: number;
+        custom_measurements?: string;
+        is_bespoke: boolean;
+    }) => void;
+    updateCartItem: (variables: {
+        itemId: string;
+        quantity: number;
+    }) => void;
+    removeFromCart: (itemId: string) => void;
+    clearCart: () => void;
+    clear: () => void;
+    mergeGuestCart: () => void;
+    addItem: (product: Product, variantId?: string, quantity?: number, customMeasurements?: Record<string, string>) => void;
+    updateQty: (itemId: string, quantity: number) => void;
+    removeItem: (itemId: string) => void;
+    subtotal: number;
+    productTypeMismatch: {
+        message: string;
+        existing_type: string;
+        new_type: string;
+    } | null;
+    handleClearCartAndAdd: () => void;
+    handleKeepCurrentCart: () => void;
+}
+interface CartContextValue {
+    isOpen: boolean;
+    setOpen: (open: boolean) => void;
+}
+declare const CartCtx: React.Context<CartContextValue | null> | null;
+declare function CartProvider({ children }: {
+    children: ReactNode;
+}): string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.FunctionComponentElement<React.ProviderProps<CartContextValue | null>> | null | undefined;
+declare function useCart(): UseCartReturn;
+
+declare function useOrders(params?: {
+    email?: string;
+    page?: number;
+    page_size?: number;
+}): _tanstack_react_query.UseQueryResult<NoInfer<Order[]>, Error>;
+declare function useOrdersList(params?: {
+    email?: string;
+    page?: number;
+    page_size?: number;
+}): _tanstack_react_query.UseQueryResult<NoInfer<Order[]>, Error>;
+declare function useFindOrder(params: FindOrderParams): _tanstack_react_query.UseQueryResult<NoInfer<Order>, Error>;
+declare function useOrder(params: FindOrderParams): _tanstack_react_query.UseQueryResult<NoInfer<Order>, Error>;
+declare function useOrderTracking(orderId: string, token?: string): _tanstack_react_query.UseQueryResult<NoInfer<Order>, Error>;
+declare function useCreateOrder(): _tanstack_react_query.UseMutationResult<Order, Error, CreateOrderParams, unknown>;
+declare function useCancelOrder(): _tanstack_react_query.UseMutationResult<Order, Error, {
+    orderId: string;
+    reason: string;
+}, unknown>;
+
+declare const AuthCtx: React.Context<AuthContextValue | null> | null;
+declare function AuthProvider({ children }: {
+    children: ReactNode;
+}): string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.FunctionComponentElement<React.ProviderProps<AuthContextValue | null>> | null | undefined;
+declare function useAuthUser(): _tanstack_react_query.UseQueryResult<NoInfer<AuthUserResponse>, Error>;
+declare function useLogin(): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, Error, Omit<CustomerLoginPayload, "tenant_id">, unknown>;
+declare function useRegister(): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, Error, Omit<CustomerRegisterPayload, "tenant_id">, unknown>;
+declare function useUpdateProfile(): _tanstack_react_query.UseMutationResult<CustomerUser, Error, UpdateProfilePayload, unknown>;
+declare function useLogout(): _tanstack_react_query.UseMutationResult<void, Error, void, unknown>;
+/**
+ * useAuth()
+ * Consumes the AuthCtx provider value. Falls back to local hook query if no provider exists.
+ */
+declare function useAuth(): AuthContextValue;
+
+declare function getCountries(): Promise<Country[]>;
+declare function useCountries(): _tanstack_react_query.UseQueryResult<NoInfer<Country[]>, Error>;
+
+declare function getStates(countryIso: string): Promise<State[]>;
+declare function useStates(countryIso: string): _tanstack_react_query.UseQueryResult<NoInfer<State[]>, Error>;
+
+declare function getSupportedLanguagesList(): Promise<SupportedLang[]>;
+declare function useSupportedLanguages(): _tanstack_react_query.UseQueryResult<NoInfer<SupportedLang[]>, Error>;
+
+declare function getSupportedCurrenciesList(): Promise<Currency[]>;
+declare function useCurrencies(): _tanstack_react_query.UseQueryResult<NoInfer<Currency[]>, Error>;
+
+/**
+ * Get bespoke availability for a product
+ */
+declare function useBespokeAvailability(product_id: string): _tanstack_react_query.UseQueryResult<NoInfer<BespokeAvailability>, Error>;
+
+declare const collectionKeys: {
+    all: readonly ["core", "collections"];
+    list: (params?: ListParams) => readonly ["core", "collections", "list", ListParams];
+    slug: (slug: string) => readonly ["core", "collections", "slug", string];
+};
+/**
+ * Hook to fetch paginated collections for the storefront.
+ */
+declare function useStorefrontCollections(params?: ListParams): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Collection>>, Error>;
+/**
+ * Hook to fetch a single collection by slug for the storefront.
+ */
+declare function useStorefrontCollection(slug: string): _tanstack_react_query.UseQueryResult<NoInfer<Collection>, Error>;
+
+declare const productKeys: {
+    all: readonly ["products"];
+    list: (params?: ListParams) => readonly ["products", "list", ListParams | undefined];
+    detail: (slug: string) => readonly ["products", "detail", string];
+    recommended: (params?: ListParams) => readonly ["products", "recommended", ListParams | undefined];
+    latest: (params?: ListParams) => readonly ["products", "latest", ListParams | undefined];
+    popular: (params?: ListParams) => readonly ["products", "popular", ListParams | undefined];
+    featured: (params?: ListParams) => readonly ["products", "featured", ListParams | undefined];
+    new: (params?: ListParams) => readonly ["products", "new", ListParams | undefined];
+};
+/**
+ * Hook for fetching latest products.
+ */
+declare function useLatestProducts(params?: ListParams): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
+/**
+ * Hook for fetching popular products.
+ */
+declare function usePopularProducts(params?: ListParams): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
+/**
+ * Hook for fetching featured products.
+ */
+declare function useFeaturedProducts(params?: ListParams): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
+/**
+ * Hook for fetching new products.
+ */
+declare function useNewProducts(params?: ListParams): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
+/**
+ * Hook for fetching all active storefront products.
+ */
+declare function useStorefrontProducts(params?: ListParams): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
+/**
+ * Hook for fetching a single product by slug.
+ */
+declare function useProduct(slug: string): _tanstack_react_query.UseQueryResult<NoInfer<Product>, Error>;
+/**
+ * Hook for fetching recommended products.
+ */
+declare function useRecommendedProducts(params?: ListParams): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
+
+declare const wishlistKeys: {
+    all: readonly ["wishlist"];
+    list: () => readonly ["wishlist", "list"];
+    check: (productId: string) => readonly ["wishlist", "check", string];
+};
+/**
+ * Hook for fetching the customer's wishlist.
+ * Authentication-gated only - returns empty for unauthenticated users.
+ */
+declare function useWishlist(params?: {
+    page?: number;
+    pageSize?: number;
+}): _tanstack_react_query.UseQueryResult<NoInfer<WishlistListResponse>, Error>;
+/**
+ * Hook for checking if a product is in the wishlist.
+ * Authentication-gated only - returns false for unauthenticated users.
+ */
+declare function useCheckInWishlist(productId: string): _tanstack_react_query.UseQueryResult<NoInfer<WishlistCheckResponse>, Error>;
+/**
+ * Hook for adding a product to the wishlist.
+ * Authentication-gated only - triggers login modal for unauthenticated users.
+ */
+declare function useAddToWishlist(): _tanstack_react_query.UseMutationResult<WishlistItem, Error, {
+    productId: string;
+    notes?: string;
+}, unknown>;
+/**
+ * Hook for removing an item from the wishlist by item ID.
+ */
+declare function useRemoveFromWishlist(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+/**
+ * Hook for removing a product from the wishlist by product ID.
+ */
+declare function useRemoveProductFromWishlist(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+/**
+ * Hook for getting wishlist count.
+ * Authentication-gated only - returns 0 for unauthenticated users.
+ */
+declare function useWishlistCount(): _tanstack_react_query.UseQueryResult<number, Error>;
+
+/**
+ * Get available slots for a service product
+ */
+declare function useAvailableSlots(product_id: string, date_from: string, date_to: string): _tanstack_react_query.UseQueryResult<NoInfer<AvailableSlot[]>, Error>;
+/**
+ * Book a service appointment
+ */
+declare function useBookAppointment(): _tanstack_react_query.UseMutationResult<ServiceAppointment, Error, ServiceAppointmentCreatePayload, unknown>;
+/**
+ * Get all appointments for the current user
+ */
+declare function useAppointments(): _tanstack_react_query.UseQueryResult<NoInfer<ServiceAppointment[]>, Error>;
+/**
+ * Get a single appointment by ID
+ */
+declare function useAppointment(id: string): _tanstack_react_query.UseQueryResult<NoInfer<ServiceAppointment>, Error>;
+/**
+ * Cancel an appointment
+ */
+declare function useCancelAppointment(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+/**
+ * Get deliverables for a project-based service order
+ */
+declare function useDeliverables(order_id: string): _tanstack_react_query.UseQueryResult<NoInfer<ServiceDeliverable[]>, Error>;
+/**
+ * Approve a deliverable
+ */
+declare function useApproveDeliverable(order_id: string, deliverable_id: string): _tanstack_react_query.UseMutationResult<ServiceDeliverable, Error, void, unknown>;
+/**
+ * Request revision for a deliverable
+ */
+declare function useRequestRevision(order_id: string, deliverable_id: string): _tanstack_react_query.UseMutationResult<ServiceDeliverable, Error, string, unknown>;
+
+declare function useConsultations(): _tanstack_react_query.UseQueryResult<NoInfer<Consultation[]>, Error>;
+declare function useConsultation(id: string): _tanstack_react_query.UseQueryResult<NoInfer<Consultation>, Error>;
+declare function useCreateConsultation(): _tanstack_react_query.UseMutationResult<Consultation, Error, ConsultationCreatePayload, unknown>;
+declare function useSendMessage(consultationId: string): _tanstack_react_query.UseMutationResult<void, Error, ConsultationMessagePayload, unknown>;
+declare function useAcceptQuote(consultationId: string): _tanstack_react_query.UseMutationResult<Consultation, Error, ConsultationQuoteAcceptPayload, unknown>;
+declare function useRejectQuote(consultationId: string): _tanstack_react_query.UseMutationResult<Consultation, Error, string | undefined, unknown>;
+
+interface ConsultationMessageData {
+    event: string;
+    data: {
+        consultation_id: string;
+        message_id: string;
+        sender_id: string;
+        sender_role: string;
+        message: string;
+        attachments?: Array<{
+            url: string;
+            type: string;
+            name: string;
+        }>;
+        created_at: string;
+    };
+}
+interface ConsultationQuoteData {
+    event: string;
+    data: {
+        consultation_id: string;
+        quote_amount: number;
+        deposit_amount?: number;
+        merchant_notes?: string;
+        updated_at: string;
+    };
+}
+interface ConsultationStatusData {
+    event: string;
+    data: {
+        consultation_id: string;
+        status: string;
+        updated_at: string;
+    };
+}
+interface UseConsultationStreamOptions {
+    consultationId: string;
+    onMessage?: (data: ConsultationMessageData) => void;
+    onQuote?: (data: ConsultationQuoteData) => void;
+    onStatusChange?: (data: ConsultationStatusData) => void;
+    onError?: (error: Error) => void;
+}
+declare function useConsultationStream({ consultationId, onMessage, onQuote, onStatusChange, onError, }: UseConsultationStreamOptions): {
+    isConnected: boolean;
+    lastEvent: any;
+};
+
+interface PaymentSuccessData {
+    event: string;
+    data: {
+        transaction_id: string;
+        order_id: string;
+        amount: number;
+        currency: string;
+        status: string;
+    };
+}
+interface DigitalReadyData {
+    event: string;
+    data: {
+        order_id: string;
+        business_id: string;
+        customer_id: string;
+        download_links: Array<{
+            item_id: string;
+            product_name: string;
+            url: string;
+            token: string;
+            expires_at: string;
+            max_downloads: number;
+        }>;
+        fulfilled_at: string;
+    };
+}
+interface BespokeUpdateData {
+    event: string;
+    data: {
+        order_id: string;
+        business_id: string;
+        update_type: string;
+        message: string;
+        stage?: string;
+        updated_at: string;
+    };
+}
+interface ConsultationUpdateData {
+    event: string;
+    data: {
+        consultation_id: string;
+        business_id: string;
+        customer_id: string;
+        status: string;
+        message?: string;
+        updated_at: string;
+    };
+}
+interface ServiceBookingUpdateData {
+    event: string;
+    data: {
+        booking_id: string;
+        order_id: string;
+        business_id: string;
+        customer_id: string;
+        status: string;
+        appointment_date?: string;
+        updated_at: string;
+    };
+}
+interface UseOrderStreamOptions {
+    orderId: string;
+    onPaymentComplete?: (data: PaymentSuccessData) => void;
+    onDigitalReady?: (data: DigitalReadyData) => void;
+    onBespokeUpdate?: (data: BespokeUpdateData) => void;
+    onConsultationUpdate?: (data: ConsultationUpdateData) => void;
+    onServiceBookingUpdate?: (data: ServiceBookingUpdateData) => void;
+    onError?: (error: Error) => void;
+}
+declare function useOrderStream({ orderId, onPaymentComplete, onDigitalReady, onBespokeUpdate, onConsultationUpdate, onServiceBookingUpdate, onError }: UseOrderStreamOptions): null;
+
+declare function useIsMounted(): boolean;
+
+interface GoogleTranslateOptions {
+    pageLanguage: string;
+    includedLanguages?: string;
+    autoDisplay?: boolean;
+    layout?: number;
+}
+interface GoogleTranslateElement {
+    new (options: GoogleTranslateOptions, elementId: string): void;
+}
+interface GoogleNamespace {
+    translate?: {
+        TranslateElement: GoogleTranslateElement;
+    };
+}
+declare global {
+    interface Window {
+        googleTranslateElementInit?: () => void;
+        google?: GoogleNamespace;
+    }
+}
+declare function useGoogleTranslate(appLang: string): {
+    isLoaded: boolean;
+};
+
+/**
+ * Hook for creating a Dedicated Virtual Account (DVA)
+ */
+declare function useCreateDVA(): _tanstack_react_query.UseMutationResult<DVADetails, Error, DVACreateRequest, unknown>;
+/**
+ * Hook for initiating card payment
+ */
+declare function useInitiatePayment(): _tanstack_react_query.UseMutationResult<PaymentInitiateResponse, Error, PaymentInitiateRequest, unknown>;
+/**
+ * Hook for verifying a transaction
+ */
+declare function useVerifyTransaction(): _tanstack_react_query.UseMutationResult<TransactionVerifyResponse, Error, string, unknown>;
+/**
+ * Hook for getting transaction status
+ */
+declare function useTransactionStatus(transactionId: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<NoInfer<TransactionVerifyResponse>, Error>;
+/**
+ * Hook for checking transaction status with automatic polling
+ */
+declare function usePollTransactionStatus(reference: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<NoInfer<TransactionVerifyResponse>, Error>;
+
+interface UseCmsEntriesReturn {
+    entries: CmsEntry[];
+    total: number;
+    page: number;
+    page_size: number;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to list CMS entries for a specific model.
+ */
+declare function useCmsEntries(modelSlug: string, params?: ListCmsEntriesParams): UseCmsEntriesReturn;
+interface UseCmsEntryReturn {
+    entry: CmsEntry | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Hook to get a single CMS entry by ID.
+ */
+declare function useCmsEntry(modelSlug: string, entryId: string): UseCmsEntryReturn;
+interface UseCreateCmsEntryReturn {
+    createEntry: (params: CreateCmsEntryParams) => void;
+    isLoading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook to create a new CMS entry.
+ */
+declare function useCreateCmsEntry(modelSlug: string): UseCreateCmsEntryReturn;
+interface UseUpdateCmsEntryReturn {
+    updateEntry: (entryId: string, params: UpdateCmsEntryParams) => void;
+    isLoading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook to update an existing CMS entry.
+ */
+declare function useUpdateCmsEntry(modelSlug: string): UseUpdateCmsEntryReturn;
+interface UseDeleteCmsEntryReturn {
+    deleteEntry: (entryId: string) => void;
+    isLoading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook to delete a CMS entry.
+ */
+declare function useDeleteCmsEntry(modelSlug: string): UseDeleteCmsEntryReturn;
+
+/**
+ * Cache Tiers Utility
+ *
+ * Provides cache configuration for React Query based on environment.
+ */
+declare const CACHE_TIERS: {
+    readonly none: {
+        readonly staleTime: 0;
+        readonly gcTime: 0;
+    };
+    readonly infinity: {
+        readonly staleTime: number;
+        readonly gcTime: 0;
+    };
+    readonly low: {
+        readonly staleTime: number;
+        readonly gcTime: number;
+    };
+    readonly medium: {
+        readonly staleTime: number;
+        readonly gcTime: number;
+    };
+    readonly high: {
+        readonly staleTime: number;
+        readonly gcTime: number;
+    };
+};
+type CacheTier = keyof typeof CACHE_TIERS;
+/**
+ * Set the environment mode for cache configuration
+ */
+declare function setEnvironmentMode(development: boolean): void;
+/**
+ * Get cache configuration for a given tier
+ * In development, returns 'none' tier to disable caching
+ */
+declare const getCacheTier: (tier: CacheTier) => {
+    readonly staleTime: number;
+    readonly gcTime: number;
+};
+
+/**
+ * Logger Utility
+ *
+ * Environment-gated logger that suppresses output in production.
+ */
+/**
+ * Set the environment mode for logging
+ */
+declare function setLoggerEnvironmentMode(development: boolean): void;
+declare const logger: {
+    log: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    /**
+     * Logs a warning to the console in development only.
+     * Alias for warn() for Python logging compatibility.
+     * In production, this is a no-op.
+     */
+    warning: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    createScope: (scope: string) => {
+        log: (...args: unknown[]) => void;
+        warn: (...args: unknown[]) => void;
+        warning: (...args: unknown[]) => void;
+        error: (...args: unknown[]) => void;
+        info: (...args: unknown[]) => void;
+    };
+};
+
+declare class InvalidBaseURLError extends Error {
+    constructor(message: string);
+}
+/**
+ * Normalizes a URL by trimming whitespace and stripping trailing slashes.
+ */
+declare function sanitizeBaseUrl(url: string | undefined | null, name?: string): string;
+
+declare function buildFullName(firstname?: string, lastname?: string): string | undefined;
+declare function splitFullName(fullName?: string): {
+    firstname: string;
+    lastname: string;
+};
+declare function getCustomerDisplayName(user: CustomerUser): string;
+
+declare function buildDeliveryAddress(customer: CheckoutCustomer, location: ShippingLocation): DeliveryAddress;
+declare function getCheckoutCustomerName(customer: CheckoutCustomer): string;
+declare function enrichCompletedOrder(order: Order, options: {
+    customer: CheckoutCustomer;
+    location?: ShippingLocation;
+    bespokeBrief?: string;
+    productType?: "physical" | "digital" | "bespoke" | null;
+}): Order;
+
+/**
+ * Type-safe way to extract an error message from an API error.
+ */
+declare function getErrorMessage(error: unknown, fallback?: string): string;
+
+export { type Address, type AppContextValue, type AppState, type AppointmentStatus, type AuthContextValue, AuthCtx, AuthProvider, type AuthUserResponse, type AvailableSlot, type AvatarObject, type BackendLanguage, type BespokeAvailability, type BespokeCapacityConfig, type BespokeSlotBooking, type BespokeStageKey, type BusinessConfig, type BusinessContext, type CartContextValue, CartCtx, type CartItem, type CartItemPayload, CartProvider, type CartResponse, type CheckoutCustomer, type CmsEntry, type CmsEntryListResponse, type CmsField, type CmsIcon, type CmsIconListResponse, type CmsModel, type CmsModelPermissions, type CmsModelPublicApiPermissions, type Collection, type Consultation, type ConsultationCreatePayload, type ConsultationMessage, type ConsultationMessagePayload, type ConsultationProductType, type ConsultationQuoteAcceptPayload, type ConsultationStatus, type ContactFormData, type ConversionQuote, type Country, type CreateCmsEntryParams, type CreateOrderParams, type Currency, type CustomField, type CustomerAuthResponse, type CustomerLoginPayload, type CustomerProfileFields, type CustomerRegisterPayload, type CustomerUser, type DVACreateRequest, type DVADetails, type DeliverableApprovalPayload, type DeliverableStatus, type DeliverableStatusType, type DeliveryAddress, type FindOrderParams, InvalidBaseURLError, type Inventory, type LangCode, type ListCmsEntriesParams, type ListParams, type LogoutPayload, type MediaAsset, type MediaAssetUpdatePayload, type MediaUploadParams, type OTPVerifyPayload, type Order, type OrderItem, type OrderStatus, type PaginatedResponse, type PaymentInitiateRequest, type PaymentInitiateResponse, type Product, type ProductType, type ProductVariant, type RateAddress, type RefreshTokenResponse, type ResendOTPPayload, type SdkConfig, type ServiceAppointment, type ServiceAppointmentCreatePayload, type ServiceDeliverable, type ServiceLocationType, type ServiceType, type ShippingLocation, type ShippingRatesRequest, type SlotBookingStatus, type State, type StorageStats, type SupportedCurrenciesResponse, type SupportedLang, type SupportedLanguagesResponse, type Theme, type TransactionVerifyResponse, type UpdateCmsEntryParams, type UpdateProfilePayload, type UseCartReturn, type UseCmsEntriesReturn, type UseCmsEntryReturn, type UseCreateCmsEntryReturn, type UseDeleteCmsEntryReturn, type UseUpdateCmsEntryReturn, type WishlistCheckResponse, type WishlistItem, type WishlistListResponse, acceptQuote, addToCart, addToGuestCart, addToWishlist, approveDeliverable, authAxios, bespokeService, bookAppointment, buildDeliveryAddress, buildFullName, cancelAppointment, cancelOrder, checkAvailability, checkInWishlist, clearCart, clearGuestCart, clearGuestSessionId, cmsAxios, collectionKeys, configService, configureHttpClients, consultationService, createCmsEntry, createConsultation, createDedicatedAccount, createOrder, deleteCmsEntry, enrichCompletedOrder, findOrder, findOrderByToken, getAppointment, getAppointments, getAuthUser, getAvailableSlots, getBackendUrl, getBusinessConfig, getCacheTier, getCart, getCheckoutCustomerName, getCmsEntry, getConsultation, getConsultations, getCountries, getCustomerDisplayName, getDeliverables, getErrorMessage, getFeaturedProducts, getGraphQLClient, getGuestCart, getGuestCartCount, getGuestCartProductType, getGuestCartSubtotal, getGuestSessionId, getLatestProducts, getMe, getNewProducts, getOrCreateGuestSessionId, getOrders, getPopularProducts, getRecommendedProducts, getRuntimeConfig, getSellerShippingAddress, getShippingRates, getStates, getStorefrontCollectionBySlug, getStorefrontCollections, getStorefrontProductBySlug, getStorefrontProducts, getSupportedCurrencies, getSupportedCurrenciesList, getSupportedLanguages, getSupportedLanguagesList, getTransactionStatus, getWishlist, googleTranslate, initSdk, initiatePayment, isInitialized, listCmsEntries, logger, loginCustomer, logisticsService, logout, mapAuthUserToCustomer, mergeGuestCart, mergeGuestCartIfPresent, notificationsService, paymentAxios, paymentService, productKeys, publicStoreAxios, refreshToken, registerCustomer, rejectQuote, removeFromCart, removeFromGuestCart, removeFromWishlist, removeProductFromWishlist, requestQuote, requestRevision, resetConfig, resetGraphQLClient, sanitizeBaseUrl, sendContactConfirmation, sendContactEmail, sendMessage, serviceBookingService, setEnvironmentMode, setLoggerEnvironmentMode, silentRefresh, splitFullName, storeManagementAxios, storeTokens, tokenStore, trackOrder, updateCartItem, updateCmsEntry, updateGuestCartItemQuantity, updateProfile, useAcceptQuote, useAddToWishlist, useAppointment, useAppointments, useApproveDeliverable, useAuth, useAuthUser, useAvailableSlots, useBespokeAvailability, useBookAppointment, useCancelAppointment, useCancelOrder, useCart, useCheckInWishlist, useCmsEntries, useCmsEntry, useConsultation, useConsultationStream, useConsultations, useCountries, useCreateCmsEntry, useCreateConsultation, useCreateDVA, useCreateOrder, useCurrencies, useDeleteCmsEntry, useDeliverables, useFeaturedProducts, useFindOrder, useGoogleTranslate, useInitiatePayment, useIsMounted, useLatestProducts, useLogin, useLogout, useNewProducts, useOrder, useOrderStream, useOrderTracking, useOrders, useOrdersList, usePollTransactionStatus, usePopularProducts, useProduct, useRecommendedProducts, useRegister, useRejectQuote, useRemoveFromWishlist, useRemoveProductFromWishlist, useRequestRevision, useSendMessage, useStates, useStorefrontCollection, useStorefrontCollections, useStorefrontProducts, useSupportedLanguages, useTransactionStatus, useUpdateCmsEntry, useUpdateProfile, useVerifyTransaction, useWishlist, useWishlistCount, validateShippingAddress, verifySocialToken, verifyTransaction, wishlistKeys };