@neowhale/storefront 0.2.39 → 0.2.41

package/dist/react/index.d.ts

@@ -1,536 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { F as WhaleStorefrontConfig, r as Product, P as PaymentData, O as Order, a as CartItem, T as TaxBreakdown, W as WhaleClient, f as Customer, E as EventType, g as CustomerAnalytics, d as CheckoutSession, A as Address, b as Category, c as CategoryTreeNode, l as LoyaltyAccount, m as LoyaltyReward, n as LoyaltyTransaction, v as Review, w as ReviewSummary, G as WishlistItem, R as Recommendation, k as Location, x as ShippingMethod, y as ShippingRate, D as DealValidation, C as Cart, H as ReferralStatus, I as ReferralEnrollment, i as LandingSection, Q as QRLandingData, h as LandingPageRenderData } from '../client-CUKv5fMM.js';
-import { ThemeTokens } from '@neowhale/ui';
-import * as zustand_middleware from 'zustand/middleware';
-import * as zustand from 'zustand';
-import { P as PixelManager } from '../pixel-manager-DsrUxlIB.js';
-
-interface WhaleProviderProps extends WhaleStorefrontConfig {
-    children: ReactNode;
-    /** Server-fetched products passed to client for hooks */
-    products?: Product[];
-    /** Manual theme overrides — merged with store theme fetched from storefront config */
-    theme?: Partial<ThemeTokens>;
-}
-declare function WhaleProvider({ children, products, theme: themeProp, storeId, apiKey, gatewayUrl, proxyPath, mediaSigningSecret, supabaseHost, storagePrefix, sessionTtl, debug, trackingEnabled, recordingRate, }: WhaleProviderProps): react_jsx_runtime.JSX.Element;
-
-interface CartState {
-    cartId: string | null;
-    items: CartItem[];
-    itemCount: number;
-    subtotal: number;
-    taxAmount: number;
-    total: number;
-    taxBreakdown: TaxBreakdown[];
-    cartOpen: boolean;
-    cartLoading: boolean;
-    productImages: Record<string, string>;
-    addItemInFlight: boolean;
-}
-interface CartActions {
-    openCart: () => void;
-    closeCart: () => void;
-    toggleCart: () => void;
-    initCart: () => Promise<void>;
-    syncCart: () => Promise<void>;
-    addItem: (productId: string, quantity: number, tier?: string, unitPrice?: number, imageUrl?: string | null, productName?: string) => Promise<void>;
-    updateQuantity: (itemId: string, quantity: number) => Promise<void>;
-    removeItem: (itemId: string, productName?: string) => Promise<void>;
-    clearCart: () => void;
-    checkout: (customerEmail?: string, payment?: PaymentData) => Promise<Order>;
-}
-type CartStore = ReturnType<typeof createCartStore>;
-declare function createCartStore(client: WhaleClient, storagePrefix: string, onAddToCart?: (productId: string, productName: string, quantity: number, price: number, tier?: string) => void, onRemoveFromCart?: (productId: string, productName: string) => void, onCartChange?: (cartId: string, total: number, itemCount: number) => void): Omit<zustand.StoreApi<CartState & CartActions>, "setState" | "persist"> & {
-    setState(partial: (CartState & CartActions) | Partial<CartState & CartActions> | ((state: CartState & CartActions) => (CartState & CartActions) | Partial<CartState & CartActions>), replace?: false | undefined): unknown;
-    setState(state: (CartState & CartActions) | ((state: CartState & CartActions) => CartState & CartActions), replace: true): unknown;
-    persist: {
-        setOptions: (options: Partial<zustand_middleware.PersistOptions<CartState & CartActions, {
-            cartId: string | null;
-            productImages: Record<string, string>;
-        }, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: CartState & CartActions) => void) => () => void;
-        onFinishHydration: (fn: (state: CartState & CartActions) => void) => () => void;
-        getOptions: () => Partial<zustand_middleware.PersistOptions<CartState & CartActions, {
-            cartId: string | null;
-            productImages: Record<string, string>;
-        }, unknown>>;
-    };
-};
-
-interface AuthState {
-    customer: Customer | null;
-    sessionToken: string | null;
-    sessionExpiresAt: string | null;
-    authLoading: boolean;
-}
-interface AuthActions {
-    sendOTP: (email: string) => Promise<boolean>;
-    verifyOTP: (email: string, code: string) => Promise<boolean>;
-    updateProfile: (data: {
-        first_name: string;
-        last_name: string;
-        phone?: string;
-        date_of_birth?: string;
-    }) => Promise<void>;
-    restoreSession: () => Promise<void>;
-    isSessionValid: () => boolean;
-    logout: () => void;
-    fetchCustomer: (id: string) => Promise<void>;
-}
-type AuthStore = ReturnType<typeof createAuthStore>;
-declare function createAuthStore(client: WhaleClient, storagePrefix: string): Omit<zustand.StoreApi<AuthState & AuthActions>, "setState" | "persist"> & {
-    setState(partial: (AuthState & AuthActions) | Partial<AuthState & AuthActions> | ((state: AuthState & AuthActions) => (AuthState & AuthActions) | Partial<AuthState & AuthActions>), replace?: false | undefined): unknown;
-    setState(state: (AuthState & AuthActions) | ((state: AuthState & AuthActions) => AuthState & AuthActions), replace: true): unknown;
-    persist: {
-        setOptions: (options: Partial<zustand_middleware.PersistOptions<AuthState & AuthActions, {
-            sessionToken: string | null;
-            sessionExpiresAt: string | null;
-            customer: {
-                id: string;
-                email: string | null;
-                first_name: string;
-                last_name: string;
-                phone: string | null;
-                loyalty_points: number;
-                loyalty_tier: string;
-                total_spent: number;
-                total_orders: number;
-            } | null;
-        }, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: AuthState & AuthActions) => void) => () => void;
-        onFinishHydration: (fn: (state: AuthState & AuthActions) => void) => () => void;
-        getOptions: () => Partial<zustand_middleware.PersistOptions<AuthState & AuthActions, {
-            sessionToken: string | null;
-            sessionExpiresAt: string | null;
-            customer: {
-                id: string;
-                email: string | null;
-                first_name: string;
-                last_name: string;
-                phone: string | null;
-                loyalty_points: number;
-                loyalty_tier: string;
-                total_spent: number;
-                total_orders: number;
-            } | null;
-        }, unknown>>;
-    };
-};
-
-interface WhaleContextValue {
-    client: WhaleClient;
-    config: {
-        storeId: string;
-        apiKey: string;
-        gatewayUrl: string;
-        proxyPath: string;
-        mediaSigningSecret: string;
-        supabaseHost: string;
-        storagePrefix: string;
-        sessionTtl: number;
-        debug: boolean;
-        trackingEnabled: boolean;
-        recordingRate: number;
-    };
-    cartStore: CartStore;
-    authStore: AuthStore;
-    /** Products fetched server-side and passed via provider */
-    products: Product[];
-    /** Pixel manager — set after storefront config loads */
-    pixelManager: PixelManager | null;
-}
-declare const WhaleContext: react.Context<WhaleContextValue | null>;
-
-declare function useCart(): {
-    cartId: string | null;
-    items: CartItem[];
-    itemCount: number;
-    subtotal: number;
-    taxAmount: number;
-    total: number;
-    taxBreakdown: TaxBreakdown[];
-    cartOpen: boolean;
-    cartLoading: boolean;
-    productImages: Record<string, string>;
-    addItem: (productId: string, quantity: number, tier?: string, unitPrice?: number, imageUrl?: string | null, productName?: string) => Promise<void>;
-    removeItem: (itemId: string, productName?: string) => Promise<void>;
-    updateQuantity: (itemId: string, quantity: number) => Promise<void>;
-    toggleCart: () => void;
-    openCart: () => void;
-    closeCart: () => void;
-    initCart: () => Promise<void>;
-    syncCart: () => Promise<void>;
-    clearCart: () => void;
-    checkout: (customerEmail?: string, payment?: PaymentData) => Promise<Order>;
-};
-/** Granular selector — only re-renders on count change */
-declare function useCartItemCount(): number;
-/** Granular selector — only re-renders on total change */
-declare function useCartTotal(): number;
-
-declare function useAuth(): {
-    customer: Customer | null;
-    authLoading: boolean;
-    sessionToken: string | null;
-    isAuthenticated: boolean;
-    sendCode: (email: string) => Promise<boolean>;
-    verifyCode: (email: string, code: string) => Promise<boolean>;
-    updateProfile: (data: {
-        first_name: string;
-        last_name: string;
-        phone?: string;
-        date_of_birth?: string;
-    }) => Promise<void>;
-    restoreSession: () => Promise<void>;
-    logout: () => void;
-    fetchCustomer: (id: string) => Promise<void>;
-};
-
-/**
- * Returns products passed via WhaleProvider.
- * Optionally filters by category or search.
- */
-declare function useProducts(opts?: {
-    categoryId?: string;
-    search?: string;
-}): {
-    products: Product[];
-    allProducts: Product[];
-    loading: boolean;
-};
-/**
- * Returns a single product by slug from the provider's product list.
- */
-declare function useProduct(slug: string | null | undefined): {
-    product: Product | null;
-    loading: boolean;
-};
-
-declare function useAnalytics(): {
-    track: (eventType: EventType, data?: Record<string, unknown>) => Promise<void>;
-    trackPageView: (url: string, referrer?: string) => void;
-    trackProductView: (productId: string, productName: string, category: string, price?: number) => void;
-    trackCategoryView: (categoryId: string, categoryName: string) => void;
-    trackSearch: (query: string, resultCount?: number) => void;
-    trackBeginCheckout: (cartId: string, total: number, itemCount: number) => void;
-    trackPurchase: (orderId: string, orderNumber: string, total: number) => void;
-    trackAddToCart: (productId: string, productName: string, quantity: number, price: number, tier?: string) => void;
-    trackRemoveFromCart: (productId: string, productName: string) => void;
-    linkCustomer: (customerId: string) => Promise<void>;
-    updateSessionCart: (cartId: string, cartTotal: number, cartItemCount: number) => Promise<void>;
-    updateSessionOrder: (orderId: string) => Promise<void>;
-    getOrCreateSession: () => Promise<string>;
-    captureGeolocation: (options?: {
-        timeout?: number;
-        enableHighAccuracy?: boolean;
-    }) => Promise<GeolocationPosition | null>;
-    /** Whether tracking is globally enabled for this storefront */
-    trackingEnabled: boolean;
-    /** Configured recording sample rate (0–1) for behavioral session replays */
-    recordingRate: number;
-    /** Stable visitor ID for cross-session attribution */
-    visitorId: string;
-};
-
-declare function useWhaleClient(): WhaleClient;
-
-declare function useCustomerOrders(): {
-    orders: Order[];
-    loading: boolean;
-    refresh: () => Promise<void>;
-};
-declare function useCustomerAnalytics(): {
-    analytics: CustomerAnalytics | null;
-    loading: boolean;
-};
-
-declare function useCheckout(): {
-    session: CheckoutSession | null;
-    loading: boolean;
-    error: Error | null;
-    createSession: (params: {
-        cart_id: string;
-        customer_email?: string;
-        shipping_address?: Address;
-        billing_address?: Address;
-        shipping_method_id?: string;
-        coupon_code?: string;
-        loyalty_reward_id?: string;
-        selected_product_id?: string;
-    }) => Promise<CheckoutSession>;
-    updateSession: (params: {
-        customer_email?: string;
-        shipping_address?: Address;
-        billing_address?: Address;
-        shipping_method_id?: string;
-        coupon_code?: string;
-    }) => Promise<CheckoutSession>;
-    complete: (payment?: PaymentData, opts?: {
-        loyalty_reward_id?: string;
-        selected_product_id?: string;
-    }) => Promise<Order>;
-    reset: () => void;
-};
-
-interface SearchParams {
-    query: string;
-    category_id?: string;
-    min_price?: number;
-    max_price?: number;
-    sort_by?: string;
-    sort_order?: 'asc' | 'desc';
-    limit?: number;
-}
-declare function useSearch(): {
-    results: Product[];
-    hasMore: boolean;
-    loading: boolean;
-    error: Error | null;
-    search: (params: SearchParams) => Promise<void>;
-    loadMore: (params: SearchParams) => Promise<void>;
-    clear: () => void;
-};
-
-declare function useCategories(): {
-    categories: Category[];
-    tree: CategoryTreeNode[];
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    getCategory: (id: string) => Promise<Category>;
-};
-
-declare function useLoyalty(): {
-    account: LoyaltyAccount | null;
-    rewards: LoyaltyReward[];
-    transactions: LoyaltyTransaction[];
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    redeemReward: (rewardId: string) => Promise<{
-        success: boolean;
-        points_remaining: number;
-    }>;
-    fetchProductsByCategory: (category: string, locationId: string, tier?: string) => Promise<Product[]>;
-};
-
-declare function useReviews(productId: string | null | undefined): {
-    reviews: Review[];
-    summary: ReviewSummary | null;
-    hasMore: boolean;
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    loadMore: () => Promise<void>;
-    submit: (data: {
-        rating: number;
-        title?: string;
-        body?: string;
-        customer_name?: string;
-    }) => Promise<Review>;
-};
-
-declare function useWishlist(): {
-    items: WishlistItem[];
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    add: (productId: string) => Promise<WishlistItem>;
-    remove: (productId: string) => Promise<void>;
-    has: (productId: string) => boolean;
-    toggle: (productId: string) => Promise<void>;
-};
-
-declare function useRecommendations(params?: {
-    product_id?: string;
-    customer_id?: string;
-    limit?: number;
-    type?: 'similar' | 'frequently_bought_together' | 'personalized';
-}): {
-    recommendations: Recommendation[];
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-};
-
-declare function useLocations(): {
-    locations: Location[];
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    getLocation: (id: string) => Promise<Location>;
-};
-
-declare function useShipping(): {
-    methods: ShippingMethod[];
-    rates: ShippingRate[];
-    loading: boolean;
-    error: Error | null;
-    refreshMethods: () => Promise<void>;
-    calculateRates: (params: {
-        cart_id: string;
-        shipping_address: Address;
-    }) => Promise<ShippingRate[]>;
-};
-
-declare function useDeals(): {
-    validation: DealValidation | null;
-    loading: boolean;
-    error: Error | null;
-    validate: (code: string, cartId?: string) => Promise<DealValidation>;
-    apply: (cartId: string, code: string) => Promise<Cart>;
-    remove: (cartId: string) => Promise<Cart>;
-    clear: () => void;
-};
-/** @deprecated Use useDeals instead */
-declare const useCoupons: typeof useDeals;
-
-declare function useReferral(): {
-    status: ReferralStatus | null;
-    loading: boolean;
-    error: Error | null;
-    enroll: () => Promise<ReferralEnrollment>;
-    refresh: () => Promise<void>;
-    share: () => Promise<void>;
-    attributeReferral: (code: string) => Promise<{
-        success: boolean;
-        affiliate_id?: string;
-        error?: string;
-    }>;
-    referralCode: string | null;
-    shareUrl: string | null;
-    isEnrolled: boolean;
-    referredBy: {
-        affiliate_id: string;
-        referral_code: string;
-        referrer_name: string;
-    } | null;
-};
-
-interface QRLandingPageProps {
-    code: string;
-    gatewayUrl?: string;
-    /** Override rendering for any section type */
-    renderSection?: (section: LandingSection, defaultRenderer: () => React.ReactNode) => React.ReactNode;
-    onDataLoaded?: (data: QRLandingData) => void;
-    onError?: (error: Error) => void;
-}
-declare function QRLandingPage({ code, gatewayUrl, renderSection, onDataLoaded, onError, }: QRLandingPageProps): react_jsx_runtime.JSX.Element | null;
-
-interface LandingPageProps {
-    slug: string;
-    gatewayUrl?: string;
-    renderSection?: (section: LandingSection, defaultRenderer: () => React.ReactNode) => React.ReactNode;
-    onDataLoaded?: (data: LandingPageRenderData) => void;
-    onError?: (error: Error) => void;
-    onEvent?: (event: string, data: Record<string, unknown>) => void;
-    analyticsContext?: {
-        visitorId?: string;
-        sessionId?: string;
-    };
-    enableAnalytics?: boolean;
-}
-declare function LandingPage({ slug, gatewayUrl, renderSection, onDataLoaded, onError, onEvent, analyticsContext, enableAnalytics, }: LandingPageProps): react_jsx_runtime.JSX.Element | null;
-
-interface SectionTheme {
-    bg: string;
-    fg: string;
-    accent: string;
-    surface: string;
-    muted: string;
-    fontDisplay?: string;
-    fontBody?: string;
-}
-interface ClickTrackingContext {
-    gatewayUrl?: string;
-    code?: string;
-}
-interface SectionData {
-    store?: {
-        id?: string;
-        name?: string | null;
-        logo_url?: string | null;
-        tagline?: string | null;
-        theme?: Record<string, unknown> | null;
-    } | null;
-    product?: Record<string, unknown> | null;
-    coa?: {
-        url: string;
-        viewer_url?: string | null;
-        document_name: string;
-    } | null;
-    gatewayUrl?: string;
-    landing_page?: {
-        slug?: string;
-    } | null;
-    analyticsContext?: {
-        visitorId?: string;
-        sessionId?: string;
-    };
-}
-
-/**
- * Routes a section to its renderer and tracks section visibility via IntersectionObserver.
- * Each section is wrapped in a div with data attributes for analytics targeting.
- */
-declare function SectionRenderer({ section, data, theme, tracking, onEvent, }: {
-    section: LandingSection;
-    data: SectionData;
-    theme: SectionTheme;
-    tracking?: ClickTrackingContext;
-    onEvent?: (event: string, data: Record<string, unknown>) => void;
-}): react_jsx_runtime.JSX.Element;
-
-/**
- * Auto-tracks page views on pathname change and links customer sessions.
- * Rendered internally by WhaleProvider — storefronts don't need to add this manually.
- *
- * When `config.trackingEnabled` is false the component renders nothing and
- * skips all side-effects — the underlying hook guards individual calls too,
- * but short-circuiting here avoids session creation entirely.
- */
-declare function AnalyticsTracker({ pathname }: {
-    pathname: string;
-}): null;
-
-/**
- * Hydrates cart from gateway on mount if a cartId is persisted.
- * Rendered internally by WhaleProvider.
- */
-declare function CartInitializer(): null;
-
-/**
- * Restores auth session on mount — syncs persisted token to client.
- * Rendered internally by WhaleProvider.
- */
-declare function AuthInitializer(): null;
-
-interface PixelInitializerProps {
-    onReady: (manager: PixelManager) => void;
-    onTheme?: (theme: Record<string, unknown>) => void;
-}
-/**
- * Fetches storefront config on mount and initializes pixel providers + theme.
- * Sets pixelManager on context so useAnalytics can dispatch events to it.
- * If the config includes a `theme` field, calls onTheme so the provider can apply it.
- * Rendered internally by WhaleProvider — storefronts don't need to add this manually.
- */
-declare function PixelInitializer({ onReady, onTheme }: PixelInitializerProps): null;
-
-declare function BehavioralTrackerComponent({ pathname }: {
-    pathname: string | null;
-}): null;
-
-declare function FingerprintCollector(): null;
-
-declare function SessionRecorderComponent(): null;
-
-export { AnalyticsTracker, type AuthActions, AuthInitializer, type AuthState, type AuthStore, BehavioralTrackerComponent, type CartActions, CartInitializer, type CartState, type CartStore, type ClickTrackingContext, FingerprintCollector, LandingPage, type LandingPageProps, PixelInitializer, QRLandingPage, type QRLandingPageProps, type SearchParams, SectionRenderer, type SectionTheme, SessionRecorderComponent, WhaleContext, type WhaleContextValue, WhaleProvider, type WhaleProviderProps, useAnalytics, useAuth, useCart, useCartItemCount, useCartTotal, useCategories, useCheckout, useCoupons, useCustomerAnalytics, useCustomerOrders, useDeals, useLocations, useLoyalty, useProduct, useProducts, useRecommendations, useReferral, useReviews, useSearch, useShipping, useWhaleClient, useWishlist };