@kasuvia/sdk 0.0.1 → 0.0.4

package/dist/index.d.ts

@@ -1,119 +1,22 @@
-import { AxiosInstance } from 'axios';
-import { GraphQLClient } from 'graphql-request';
-import React, { ReactNode } from 'react';
-import * as _tanstack_react_query from '@tanstack/react-query';
+import { l as ServiceLocationType, S as SdkConfig, C as CartResponse, a as CartItem, O as Order, m as CreateOrderParams, F as FindOrderParams, L as ListParams, n as PaginatedResponse, P as Product, o as Collection, W as WishlistItem, p as WishlistCheckResponse, q as WishlistListResponse, D as DVACreateRequest, s as DVADetails, T as TransactionVerifyResponse, t as PaymentInitiateRequest, v as PaymentInitiateResponse, w as ConversionQuote, x as ProductVariant, y as ShippingRatesResponse, z as SupportedLanguagesResponse, A as SupportedCurrenciesResponse, g as CreateCmsEntryParams, f as CmsEntry, h as ListCmsEntriesParams, B as CmsEntryListResponse, U as UpdateCmsEntryParams, E as CheckoutCustomer, G as ShippingLocation, H as DeliveryAddress } from './sdk-context-Cy51kEKT.js';
+export { I as Address, J as AppContextValue, K as AppState, M as BackendLanguage, N as BespokeStageKey, Q as CmsField, R as CmsIcon, V as CmsIconListResponse, X as CmsModel, Y as CmsModelPermissions, Z as CmsModelPublicApiPermissions, b as Country, e as Currency, _ as CustomField, $ as Inventory, a0 as LangCode, a1 as OrderItem, a2 as OrderStatus, a3 as ProductType, i as SdkContextValue, j as SdkProvider, k as SdkProviderProps, a4 as ServiceLocationTypeEnum, a5 as ServiceRecurringInterval, a6 as ServiceRecurringIntervalEnum, a7 as ServiceType, a8 as ServiceTypeEnum, a9 as ShippingRate, c as State, d as SupportedLang, aa as Theme, u as useSdkContext } from './sdk-context-Cy51kEKT.js';
+import 'react';
 
 /**
- * Kasuvia SDK Configuration
+ * SDK Constants
  *
- * 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;
+ * Centralized constants to avoid hardcoded strings across the codebase.
+ */
+declare const STORAGE_KEYS: {
+    readonly ACCESS_TOKEN: "kasuvia_access_token";
+    readonly REFRESH_TOKEN: "kasuvia_refresh_token";
+    readonly CHECKOUT_STATE: "kasuvia_checkout_state";
+    readonly ORDERS_LINKED: "kasuvia_orders_linked";
+    readonly STOREFRONT_STATE: "storefront_state_v3";
 };
-/**
- * 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.
+ * Simplified customer auth types for kasuvia-storefront.
  * Customers only need enough to track their orders — no RBAC, MFA, or complex profiles.
  */
 /**
@@ -141,7 +44,7 @@ interface CustomerUser {
     avatar: string | null;
     provider: 'google' | 'facebook' | 'email';
 }
-/** GET/PUT /auth/profile/ — matches luxe-auth UserSerializer */
+/** GET/PUT /auth/profile/ — matches kasuvia-auth UserSerializer */
 interface AuthUserResponse {
     id: string;
     email: string;
@@ -159,6 +62,25 @@ interface UpdateProfilePayload {
     lastname?: string;
     phone?: string;
 }
+interface NotificationPreferences {
+    email_enabled: boolean;
+    sms_enabled: boolean;
+    whatsapp_enabled: boolean;
+    push_enabled: boolean;
+    email_order_confirmations: boolean;
+    email_delivery_updates: boolean;
+    email_low_stock_alerts: boolean;
+    email_payment_received: boolean;
+    push_order_confirmations: boolean;
+    push_delivery_updates: boolean;
+    push_low_stock_alerts: boolean;
+    push_payment_received: boolean;
+    whatsapp_order_confirmations: boolean;
+    whatsapp_delivery_updates: boolean;
+    whatsapp_payment_received: boolean;
+    sms_order_confirmations: boolean;
+    sms_delivery_updates: boolean;
+}
 interface BusinessContext {
     id: string;
     business_id: string;
@@ -186,8 +108,8 @@ interface CustomerLoginPayload {
 /** POST /auth/register/customer/ */
 interface CustomerRegisterPayload {
     tenant_id: string;
-    /** Full name — backend splits this into firstname and lastname on the Profile */
-    full_name: string;
+    first_name?: string;
+    last_name?: string;
     email: string;
     password: string;
 }
@@ -213,391 +135,10 @@ interface AuthContextValue {
     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>;
+    login: (payload: Omit<CustomerLoginPayload, 'tenant_id'>) => Promise<void>;
+    register: (payload: Omit<CustomerRegisterPayload, 'tenant_id'>) => Promise<{
+        requires_verification: boolean;
     }>;
-    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>;
 }
 
 /**
@@ -667,8 +208,6 @@ interface BespokeAvailability {
 /**
  * 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;
@@ -767,73 +306,6 @@ interface BespokeCapacityConfig {
     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
  */
@@ -874,68 +346,51 @@ interface StorageStats {
 
 interface BusinessConfig {
     business_id: string;
-    store_name: string;
-    store_currency: string;
+    storefront_business_id: string;
+    name: string;
+    currency: string;
+    settlement_currency: string;
+    country: string;
+    region: string;
+    is_verified: boolean;
     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;
-}
+/**
+ * Cart Service
+ *
+ * Handles cart operations for both guest and authenticated users.
+ * Stateless - all configuration passed as parameters.
+ */
 
 /**
  * Fetch guest cart from backend (Redis-backed).
  */
-declare function getGuestCart(): Promise<CartItem[]>;
+declare function getGuestCart(config: SdkConfig, guestSessionId: string): Promise<CartItem[]>;
 /**
  * Add item to guest cart (Redis-backed).
  */
-declare function addToGuestCart(item: CartItem): Promise<CartItem[]>;
+declare function addToGuestCart(config: SdkConfig, guestSessionId: string, item: CartItem): Promise<CartItem[]>;
 /**
  * Update quantity of a guest cart item.
  */
-declare function updateGuestCartItemQuantity(itemId: string, quantity: number): Promise<CartItem[]>;
+declare function updateGuestCartItemQuantity(config: SdkConfig, guestSessionId: string, itemId: string, quantity: number): Promise<CartItem[]>;
 /**
  * Remove an item from the guest cart.
  */
-declare function removeFromGuestCart(itemId: string): Promise<CartItem[]>;
+declare function removeFromGuestCart(config: SdkConfig, guestSessionId: string, itemId: string): Promise<CartItem[]>;
 /**
  * Clear the entire guest cart.
  */
-declare function clearGuestCart(): Promise<void>;
+declare function clearGuestCart(config: SdkConfig, guestSessionId: string): Promise<void>;
 /**
  * Fetch authenticated user's cart from backend.
  */
-declare function getCart(): Promise<CartResponse>;
+declare function getCart(config: SdkConfig, accessToken?: string | null): Promise<CartResponse>;
 /**
  * Add item to authenticated user's cart.
  */
-declare function addToCart(item: {
+declare function addToCart(config: SdkConfig, accessToken: string, item: {
     product_id: string;
     product_slug: string;
     product_name: string;
@@ -950,23 +405,23 @@ declare function addToCart(item: {
 /**
  * Update item quantity in authenticated user's cart.
  */
-declare function updateCartItem(itemId: string, quantity: number): Promise<CartResponse>;
+declare function updateCartItem(config: SdkConfig, accessToken: string, itemId: string, quantity: number): Promise<CartResponse>;
 /**
  * Remove item from authenticated user's cart.
  */
-declare function removeFromCart(itemId: string): Promise<CartResponse>;
+declare function removeFromCart(config: SdkConfig, accessToken: string, itemId: string): Promise<CartResponse>;
 /**
  * Clear authenticated user's cart.
  */
-declare function clearCart(): Promise<void>;
+declare function clearCart(config: SdkConfig, accessToken: string): Promise<void>;
 /**
  * Merge guest cart (from Redis) into authenticated user's DB cart.
  */
-declare function mergeGuestCart(): Promise<CartResponse>;
+declare function mergeGuestCart(config: SdkConfig, accessToken: string, guestSessionId: string): Promise<CartResponse>;
 /**
  * Convenience wrapper: merge guest cart if it has items (called post-login).
  */
-declare function mergeGuestCartIfPresent(): Promise<void>;
+declare function mergeGuestCartIfPresent(config: SdkConfig, accessToken: string, guestSessionId: string): Promise<void>;
 /**
  * Returns 0 — count is now server-driven. Use the hook instead.
  * Kept for backward compatibility.
@@ -982,157 +437,191 @@ declare function getGuestCartSubtotal(): number;
  */
 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?: {
+/**
+ * Order Service
+ *
+ * Handles order operations including creation, lookup, and tracking.
+ * Stateless - all configuration passed as parameters.
+ */
+
+declare function createOrder(config: SdkConfig, accessToken: string, payload: CreateOrderParams): Promise<Order>;
+declare function findOrder(config: SdkConfig, params: FindOrderParams & {
+    guest_token?: string;
+}): Promise<Order>;
+declare function findOrderByToken(config: SdkConfig, token: string): Promise<Order>;
+declare function getOrders(config: SdkConfig, accessToken: string, 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>;
+declare function cancelOrder(config: SdkConfig, accessToken: string, orderId: string, reason: string): Promise<Order>;
+declare function trackOrder(config: SdkConfig, orderId: string, token?: string): Promise<Order>;
+
+/**
+ * Customer auth service — all API calls scoped to this storefront's business tenant.
+ * Stateless - all configuration passed as parameters.
+ */
 
 /**
  * POST /auth/login/customer/
- * The `tenant_id` is automatically filled from config.api.storefrontBusinessId.
+ * The `tenant_id` is automatically filled from config.businessId.
  */
-declare function loginCustomer(payload: Omit<CustomerLoginPayload, 'tenant_id'>): Promise<CustomerAuthResponse>;
+declare function loginCustomer(config: SdkConfig, payload: Omit<CustomerLoginPayload, 'tenant_id'>): Promise<CustomerAuthResponse>;
 /**
  * POST /auth/register/customer/
- * The `tenant_id` is automatically filled from config.api.storefrontBusinessId.
+ * The `tenant_id` is automatically filled from config.businessId.
  */
-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>;
+declare function registerCustomer(config: SdkConfig, payload: Omit<CustomerRegisterPayload, 'tenant_id'>): Promise<CustomerAuthResponse>;
+/** POST /auth/token/refresh/
+ */
+declare function refreshToken(config: SdkConfig, refresh: string): Promise<RefreshTokenResponse>;
+/** POST /auth/logout/ — revokes the server-side session. */
+declare function logout(config: SdkConfig, refresh?: string): 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 verifySocialToken(config: SdkConfig, provider: 'google' | 'facebook', token: string): Promise<CustomerAuthResponse>;
+/** Map kasuvia-auth UserSerializer response to storefront CustomerUser. */
 declare function mapAuthUserToCustomer(data: AuthUserResponse, provider?: CustomerUser['provider']): CustomerUser;
 /** GET /auth/profile/ */
-declare function getMe(): Promise<CustomerUser>;
+declare function getMe(config?: SdkConfig, accessToken?: string): Promise<CustomerUser>;
 /** GET /auth/profile/ - alias for getMe for backward compatibility */
-declare function getAuthUser(): Promise<AuthUserResponse>;
+declare function getAuthUser(config?: SdkConfig, accessToken?: string): Promise<AuthUserResponse>;
 /** PUT /auth/profile/ — update firstname, lastname, phone */
-declare function updateProfile(payload: UpdateProfilePayload): Promise<CustomerUser>;
+declare function updateProfile(configOrPayload: SdkConfig | UpdateProfilePayload, accessTokenOrPayload?: string | UpdateProfilePayload, payloadParam?: 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<{
+declare function silentRefresh(config: SdkConfig, refresh: string): Promise<{
     user: CustomerUser;
     provider: CustomerUser['provider'];
+    newAccessToken: string;
+    newRefreshToken: string;
 } | null>;
-/** Store tokens after OAuth callback or login/register response. */
-declare function storeTokens(access: string, refresh: string, remember?: boolean): void;
+/**
+ * Store tokens in localStorage (client-side utility)
+ * This is a convenience function for storefronts to store auth tokens
+ */
+declare function storeTokens(accessToken: string, refreshToken: string): void;
+/**
+ * Clear tokens from localStorage (client-side utility)
+ */
+declare function clearTokens(): void;
+/**
+ * Get stored tokens from localStorage (client-side utility)
+ */
+declare function getStoredTokens(): {
+    accessToken: string | null;
+    refreshToken: string | null;
+};
 
 /**
  * Fetch all active products for the storefront.
  */
-declare function getStorefrontProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+declare function getStorefrontProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
 /**
  * Fetch a single product by slug for the storefront.
  */
-declare function getStorefrontProductBySlug(slug: string): Promise<Product>;
+declare function getStorefrontProductBySlug(config: SdkConfig, slug: string): Promise<Product>;
 /**
  * Fetch latest products for the storefront.
  */
-declare function getLatestProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+declare function getLatestProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
 /**
  * Fetch popular products for the storefront.
  */
-declare function getPopularProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+declare function getPopularProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
 /**
  * Fetch featured products for the storefront.
  */
-declare function getFeaturedProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+declare function getFeaturedProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
 /**
  * Fetch new products for the storefront.
  */
-declare function getNewProducts(params?: ListParams): Promise<PaginatedResponse<Product>>;
+declare function getNewProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch products currently on sale for the storefront.
+ */
+declare function getOnSaleProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch products with low stock for the storefront.
+ */
+declare function getLowStockProducts(config: SdkConfig, 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 & {
+declare function getRecommendedProducts(config: SdkConfig, params?: ListParams & {
     excludeProductId?: string;
 }): Promise<PaginatedResponse<Product>>;
 
 /**
  * Fetch paginated active collections for the storefront.
  */
-declare function getStorefrontCollections(params?: ListParams): Promise<PaginatedResponse<Collection>>;
+declare function getStorefrontCollections(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Collection>>;
 /**
  * Fetch a single collection by its slug.
  */
-declare function getStorefrontCollectionBySlug(slug: string): Promise<Collection>;
+declare function getStorefrontCollectionBySlug(config: SdkConfig, slug: string): Promise<Collection>;
 
 /**
  * Fetch the customer's wishlist for the current business.
  */
-declare function getWishlist(params?: {
+declare function getWishlist(config: SdkConfig, accessToken: string, params?: {
     page?: number;
     pageSize?: number;
 }): Promise<WishlistListResponse>;
 /**
  * Check if a product is in the customer's wishlist.
  */
-declare function checkInWishlist(productId: string): Promise<WishlistCheckResponse>;
+declare function checkInWishlist(config: SdkConfig, accessToken: string, productId: string): Promise<WishlistCheckResponse>;
 /**
  * Add a product to the customer's wishlist.
  */
-declare function addToWishlist(productId: string, notes?: string): Promise<WishlistItem>;
+declare function addToWishlist(config: SdkConfig, accessToken: string, productId: string, notes?: string): Promise<WishlistItem>;
 /**
  * Remove an item from the customer's wishlist by item ID.
  */
-declare function removeFromWishlist(itemId: string): Promise<void>;
+declare function removeFromWishlist(config: SdkConfig, accessToken: string, itemId: string): Promise<void>;
 /**
  * Remove a product from the customer's wishlist by product ID.
  */
-declare function removeProductFromWishlist(productId: string): Promise<void>;
+declare function removeProductFromWishlist(config: SdkConfig, accessToken: string, productId: string): Promise<void>;
+
+/**
+ * Payment Service
+ *
+ * Customer-facing payment API for payment initiation and verification.
+ * Stateless - all configuration passed as parameters.
+ */
 
 /**
  * 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>;
+declare function createDedicatedAccount(config: SdkConfig, accessToken: string, 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>;
+declare function initiatePayment(config: SdkConfig, accessToken: string, request: PaymentInitiateRequest): Promise<PaymentInitiateResponse>;
 /**
  * Request a 15-minute rate-locked conversion quote for non-NGN transactions.
  */
-declare function requestQuote(amount: number): Promise<ConversionQuote>;
+declare function requestQuote(config: SdkConfig, amount: number): Promise<ConversionQuote>;
 /**
  * Verify a payment after the gateway redirects back to /checkout/verify.
  */
-declare function verifyTransaction(reference: string): Promise<TransactionVerifyResponse>;
+declare function verifyTransaction(configOrReference: SdkConfig | string, reference?: string): Promise<TransactionVerifyResponse>;
 /**
  * Poll transaction status by internal transaction ID.
  */
-declare function getTransactionStatus(transactionId: string): Promise<TransactionVerifyResponse>;
+declare function getTransactionStatus(config: SdkConfig, transactionId: string): Promise<TransactionVerifyResponse>;
 declare const paymentService: {
     readonly createDedicatedAccount: typeof createDedicatedAccount;
     readonly initiatePayment: typeof initiatePayment;
@@ -1141,12 +630,19 @@ declare const paymentService: {
     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>;
+/**
+ * Consultation Service
+ *
+ * Handles consultation operations for bespoke and service products.
+ * Stateless - all configuration passed as parameters.
+ */
+
+declare function createConsultation(config: SdkConfig, accessToken: string, payload: ConsultationCreatePayload): Promise<Consultation>;
+declare function getConsultations(config: SdkConfig, accessToken: string): Promise<Consultation[]>;
+declare function getConsultation(config: SdkConfig, accessToken: string, id: string): Promise<Consultation>;
+declare function sendMessage(config: SdkConfig, accessToken: string, id: string, payload: ConsultationMessagePayload): Promise<void>;
+declare function acceptQuote(config: SdkConfig, accessToken: string, id: string, payload: ConsultationQuoteAcceptPayload): Promise<Consultation>;
+declare function rejectQuote(config: SdkConfig, accessToken: string, id: string, reason?: string): Promise<Consultation>;
 declare const consultationService: {
     createConsultation: typeof createConsultation;
     getConsultations: typeof getConsultations;
@@ -1156,6 +652,13 @@ declare const consultationService: {
     rejectQuote: typeof rejectQuote;
 };
 
+/**
+ * Logistics Service
+ *
+ * Handles shipping rates and address validation.
+ * Stateless - all configuration passed as parameters.
+ */
+
 interface CartItemPayload {
     product: {
         name: string;
@@ -1179,11 +682,11 @@ interface ShippingRatesRequest {
 /**
  * Fetch shipping rates for a cart.
  */
-declare function getShippingRates(payload: ShippingRatesRequest): Promise<ShippingRatesResponse>;
+declare function getShippingRates(config: SdkConfig, payload: ShippingRatesRequest): Promise<ShippingRatesResponse>;
 /**
  * Fetch the seller's registered shipping address.
  */
-declare function getSellerShippingAddress(): Promise<{
+declare function getSellerShippingAddress(config: SdkConfig): Promise<{
     terminal_address_id: string | null;
     address_details: {
         city: string;
@@ -1199,7 +702,7 @@ declare function getSellerShippingAddress(): Promise<{
 /**
  * Validate a shipping address.
  */
-declare function validateShippingAddress(payload: {
+declare function validateShippingAddress(config: SdkConfig, payload: {
     first_name: string;
     last_name: string;
     phone: string;
@@ -1225,19 +728,33 @@ declare const logisticsService: {
     validateShippingAddress: typeof validateShippingAddress;
 };
 
-declare function checkAvailability(product_id: string): Promise<BespokeAvailability>;
+/**
+ * Bespoke Service
+ *
+ * Handles bespoke product availability checks.
+ * Stateless - all configuration passed as parameters.
+ */
+
+declare function checkAvailability(config: SdkConfig, 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>;
+/**
+ * Service Booking Service
+ *
+ * Handles service appointments and deliverables.
+ * Stateless - all configuration passed as parameters.
+ */
+
+declare function getAvailableSlots(config: SdkConfig, product_id: string, date_from: string, date_to: string): Promise<AvailableSlot[]>;
+declare function bookAppointment(config: SdkConfig, accessToken: string, payload: ServiceAppointmentCreatePayload): Promise<ServiceAppointment>;
+declare function getAppointments(config: SdkConfig, accessToken: string): Promise<ServiceAppointment[]>;
+declare function getAppointment(config: SdkConfig, accessToken: string, id: string): Promise<ServiceAppointment>;
+declare function cancelAppointment(config: SdkConfig, accessToken: string, id: string): Promise<void>;
+declare function getDeliverables(config: SdkConfig, accessToken: string, order_id: string): Promise<ServiceDeliverable[]>;
+declare function approveDeliverable(config: SdkConfig, accessToken: string, order_id: string, deliverable_id: string): Promise<ServiceDeliverable>;
+declare function requestRevision(config: SdkConfig, accessToken: string, order_id: string, deliverable_id: string, feedback: string): Promise<ServiceDeliverable>;
 declare const serviceBookingService: {
     getAvailableSlots: typeof getAvailableSlots;
     bookAppointment: typeof bookAppointment;
@@ -1249,6 +766,13 @@ declare const serviceBookingService: {
     requestRevision: typeof requestRevision;
 };
 
+/**
+ * Notification Service
+ *
+ * Handles contact form submissions and email notifications.
+ * Stateless - all configuration passed as parameters.
+ */
+
 interface ContactFormData {
     name: string;
     email: string;
@@ -1260,17 +784,17 @@ interface ContactFormData {
     turnstile_token?: string;
 }
 /**
- * Send contact email to Luxe team.
+ * Send contact email to Kasuvia team.
  * POST /contact/send-contact-email
  */
-declare function sendContactEmail(payload: ContactFormData): Promise<{
+declare function sendContactEmail(config: SdkConfig, payload: ContactFormData): Promise<{
     detail: string;
 }>;
 /**
  * Send confirmation email to user.
  * POST /contact/send-contact-confirmation
  */
-declare function sendContactConfirmation(payload: Omit<ContactFormData, 'turnstile_token'>): Promise<{
+declare function sendContactConfirmation(config: SdkConfig, payload: Omit<ContactFormData, 'turnstile_token'>): Promise<{
     detail: string;
 }>;
 declare const notificationsService: {
@@ -1285,509 +809,69 @@ declare const notificationsService: {
  */
 declare function googleTranslate(text: string, target: string, source?: string): Promise<string>;
 
+/**
+ * Config Service
+ *
+ * Handles configuration endpoints (languages, currencies, locales, business config).
+ * Stateless - all configuration passed as parameters.
+ */
+
 /**
  * Fetch supported languages from the payment system.
- * Resolves to: {luxePaymentBackendUrl}/config/supported-languages
+ * Resolves to: {kasuviaPaymentBackendUrl}/config/supported-languages
  */
-declare function getSupportedLanguages(): Promise<SupportedLanguagesResponse>;
+declare function getSupportedLanguages(config: SdkConfig): Promise<SupportedLanguagesResponse>;
 /**
  * Fetch supported currencies from the payment system.
- * Resolves to: {luxePaymentBackendUrl}/config/supported-currencies
+ * Resolves to: {kasuviaPaymentBackendUrl}/config/supported-currencies
  */
-declare function getSupportedCurrencies(): Promise<SupportedCurrenciesResponse>;
+declare function getSupportedCurrencies(config: SdkConfig): 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
+ * Uses storefront API key header (X-Storefront-Key).
+ * Resolves to: {kasuviaAuthBackendUrl}/internal/businesses/{business_id}/
+ * This endpoint is designed for storefronts to fetch business config using their storefront API key.
  */
-declare function getBusinessConfig(): Promise<BusinessConfig>;
+declare function getBusinessConfig(config: SdkConfig): Promise<BusinessConfig>;
 declare const configService: {
     readonly getSupportedLanguages: typeof getSupportedLanguages;
     readonly getSupportedCurrencies: typeof getSupportedCurrencies;
     readonly getBusinessConfig: typeof getBusinessConfig;
 };
 
+/**
+ * CMS Service
+ *
+ * Handles CMS model and entry operations using the kasuvia-cms SDK endpoints.
+ * Protected by X-Storefront-Key and X-Business-ID headers.
+ * Stateless - all configuration passed as parameters.
+ */
+
 /**
  * List CMS entries for a specific model.
  * Requires public_api.read permission on the model.
  */
-declare function listCmsEntries(modelSlug: string, params?: ListCmsEntriesParams): Promise<CmsEntryListResponse>;
+declare function listCmsEntries(config: SdkConfig, 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>;
+declare function getCmsEntry(config: SdkConfig, 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>;
+declare function createCmsEntry(config: SdkConfig, accessToken: string, 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>;
+declare function updateCmsEntry(config: SdkConfig, accessToken: string, 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;
+declare function deleteCmsEntry(config: SdkConfig, accessToken: string, modelSlug: string, entryId: string): Promise<void>;
 
 /**
  * Cache Tiers Utility
@@ -1873,6 +957,11 @@ declare function splitFullName(fullName?: string): {
     lastname: string;
 };
 declare function getCustomerDisplayName(user: CustomerUser): string;
+/**
+ * Constructs live storefront URL for a business.
+ * If custom domain is not yet connected/verified, defaults to `https://<business_id>.kasuvia.com`.
+ */
+declare function getStorefrontUrl(businessId: string, customDomain?: string | null): string;
 
 declare function buildDeliveryAddress(customer: CheckoutCustomer, location: ShippingLocation): DeliveryAddress;
 declare function getCheckoutCustomerName(customer: CheckoutCustomer): string;
@@ -1885,7 +974,45 @@ declare function enrichCompletedOrder(order: Order, options: {
 
 /**
  * Type-safe way to extract an error message from an API error.
+ * Updated for fetch-based errors (no axios dependency).
  */
 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 };
+/**
+ * @file storage.ts
+ * @description Centralized tenant-isolated storage utility for sessionStorage and localStorage.
+ * Automatically prefixes all keys with the storefront Business ID to guarantee multi-tenant segregation.
+ * Stateless - requires businessId parameter.
+ */
+declare const sessionStore: {
+    get: (businessIdOrKey: string, key?: string) => string | null;
+    set: (businessIdOrKey: string, keyOrVal: string, val?: string) => void;
+    remove: (businessIdOrKey: string, key?: string) => void;
+    getJSON: <T = unknown>(businessIdOrKey: string, key?: string) => T | null;
+    setJSON: (businessIdOrKey: string, keyOrVal: unknown, val?: unknown) => void;
+};
+declare const localStore: {
+    get: (businessIdOrKey: string, key?: string) => string | null;
+    set: (businessIdOrKey: string, keyOrVal: string, val?: string) => void;
+    remove: (businessIdOrKey: string, key?: string) => void;
+    getJSON: <T = unknown>(businessIdOrKey: string, key?: string) => T | null;
+    setJSON: (businessIdOrKey: string, keyOrVal: unknown, val?: unknown) => void;
+};
+
+/**
+ * Form validation utilities for kasuvia-sdk
+ * Provides realtime validation for email, password, name, confirm password, and message fields
+ */
+declare function validateEmail(email: string): string | null;
+declare function validatePassword(password: string): string | null;
+declare function validateName(name: string, fieldName?: string): string | null;
+declare function validateRequired(value: string, fieldName: string): string | null;
+/**
+ * Validates the confirm-password field.
+ * Returns null (no error) when the field is empty — avoids nagging the user
+ * before they've had a chance to type anything.
+ */
+declare function validateConfirmPassword(password: string, confirmPassword: string): string | null;
+declare function validateMessage(message: string): string | null;
+
+export { type AppointmentStatus, type AuthContextValue, type AuthUserResponse, type AvailableSlot, type AvatarObject, type BespokeAvailability, type BespokeCapacityConfig, type BespokeSlotBooking, type BusinessConfig, type BusinessContext, CartItem, type CartItemPayload, CartResponse, CheckoutCustomer, CmsEntry, CmsEntryListResponse, Collection, type Consultation, type ConsultationCreatePayload, type ConsultationMessage, type ConsultationMessagePayload, type ConsultationProductType, type ConsultationQuoteAcceptPayload, type ConsultationStatus, type ContactFormData, ConversionQuote, CreateCmsEntryParams, CreateOrderParams, type CustomerAuthResponse, type CustomerLoginPayload, type CustomerProfileFields, type CustomerRegisterPayload, type CustomerUser, DVACreateRequest, DVADetails, type DeliverableApprovalPayload, type DeliverableStatus, type DeliverableStatusType, DeliveryAddress, FindOrderParams, InvalidBaseURLError, ListCmsEntriesParams, ListParams, type LogoutPayload, type MediaAsset, type MediaAssetUpdatePayload, type MediaUploadParams, type NotificationPreferences, type OTPVerifyPayload, Order, PaginatedResponse, PaymentInitiateRequest, PaymentInitiateResponse, Product, ProductVariant, type RateAddress, type RefreshTokenResponse, type ResendOTPPayload, STORAGE_KEYS, SdkConfig, type ServiceAppointment, type ServiceAppointmentCreatePayload, type ServiceDeliverable, ServiceLocationType, ShippingLocation, type ShippingRatesRequest, ShippingRatesResponse, type SlotBookingStatus, type StorageStats, SupportedCurrenciesResponse, SupportedLanguagesResponse, TransactionVerifyResponse, UpdateCmsEntryParams, type UpdateProfilePayload, WishlistCheckResponse, WishlistItem, WishlistListResponse, acceptQuote, addToCart, addToGuestCart, addToWishlist, approveDeliverable, bespokeService, bookAppointment, buildDeliveryAddress, buildFullName, cancelAppointment, cancelOrder, checkAvailability, checkInWishlist, clearCart, clearGuestCart, clearTokens, configService, consultationService, createCmsEntry, createConsultation, createDedicatedAccount, createOrder, deleteCmsEntry, enrichCompletedOrder, findOrder, findOrderByToken, getAppointment, getAppointments, getAuthUser, getAvailableSlots, getBusinessConfig, getCacheTier, getCart, getCheckoutCustomerName, getCmsEntry, getConsultation, getConsultations, getCustomerDisplayName, getDeliverables, getErrorMessage, getFeaturedProducts, getGuestCart, getGuestCartCount, getGuestCartProductType, getGuestCartSubtotal, getLatestProducts, getLowStockProducts, getMe, getNewProducts, getOnSaleProducts, getOrders, getPopularProducts, getRecommendedProducts, getSellerShippingAddress, getShippingRates, getStoredTokens, getStorefrontCollectionBySlug, getStorefrontCollections, getStorefrontProductBySlug, getStorefrontProducts, getStorefrontUrl, getSupportedCurrencies, getSupportedLanguages, getTransactionStatus, getWishlist, googleTranslate, initiatePayment, listCmsEntries, localStore, logger, loginCustomer, logisticsService, logout, mapAuthUserToCustomer, mergeGuestCart, mergeGuestCartIfPresent, notificationsService, paymentService, refreshToken, registerCustomer, rejectQuote, removeFromCart, removeFromGuestCart, removeFromWishlist, removeProductFromWishlist, requestQuote, requestRevision, sanitizeBaseUrl, sendContactConfirmation, sendContactEmail, sendMessage, serviceBookingService, sessionStore, setEnvironmentMode, setLoggerEnvironmentMode, silentRefresh, splitFullName, storeTokens, trackOrder, updateCartItem, updateCmsEntry, updateGuestCartItemQuantity, updateProfile, validateConfirmPassword, validateEmail, validateMessage, validateName, validatePassword, validateRequired, validateShippingAddress, verifySocialToken, verifyTransaction };