@neowhale/storefront 0.2.4 → 0.2.7

package/dist/react/index.d.cts

@@ -1,17 +1,20 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { m as WhaleStorefrontConfig, i as Product, P as PaymentData, O as Order, a as CartItem, T as TaxBreakdown, W as WhaleClient, c as Customer, E as EventType, d as CustomerAnalytics } from '../client-y0V1x0px.cjs';
+import { D 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, F as WishlistItem, R as Recommendation, k as Location, x as ShippingMethod, y as ShippingRate, e as CouponValidation, C as Cart, Q as QRLandingData, i as LandingSection, h as LandingPageRenderData } from '../client-KHvDGThs.cjs';
+import { ThemeTokens } from '@neowhale/ui';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
-import { P as PixelManager } from '../pixel-manager-Db6Czwr2.cjs';
+import { P as PixelManager } from '../pixel-manager-CQaginxZ.cjs';
 
 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, storeId, apiKey, gatewayUrl, proxyPath, mediaSigningSecret, supabaseHost, storagePrefix, sessionTtl, debug, trackingEnabled, recordingRate, }: WhaleProviderProps): react_jsx_runtime.JSX.Element;
+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;
@@ -229,6 +232,199 @@ declare function useCustomerAnalytics(): {
     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;
+    }) => 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) => 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;
+    }>;
+};
+
+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 useCoupons(): {
+    validation: CouponValidation | null;
+    loading: boolean;
+    error: Error | null;
+    validate: (code: string, cartId?: string) => Promise<CouponValidation>;
+    apply: (cartId: string, code: string) => Promise<Cart>;
+    remove: (cartId: string) => Promise<Cart>;
+    clear: () => void;
+};
+
+interface QRLandingPageProps {
+    /** QR code string (from URL param) */
+    code: string;
+    /** Gateway URL — defaults to https://whale-gateway.fly.dev */
+    gatewayUrl?: string;
+    /** Custom component for product display */
+    renderProduct?: (data: QRLandingData) => React.ReactNode;
+    /** Custom component for COA/lab results */
+    renderCOA?: (data: QRLandingData) => React.ReactNode;
+    /** Custom component for the full page (overrides default layout) */
+    renderPage?: (data: QRLandingData) => React.ReactNode;
+    /** Called when data is loaded */
+    onDataLoaded?: (data: QRLandingData) => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+}
+/**
+ * QR Landing Page — drop-in component that renders a branded landing page
+ * for any QR code. Fetches data from the gateway's public endpoint.
+ *
+ * Usage:
+ * ```tsx
+ * // In app/qr/[code]/page.tsx:
+ * import { QRLandingPage } from '@neowhale/storefront/react'
+ * export default function Page({ params }: { params: { code: string } }) {
+ *   return <QRLandingPage code={params.code} />
+ * }
+ * ```
+ */
+declare function QRLandingPage({ code, gatewayUrl, renderProduct, renderCOA, renderPage, onDataLoaded, onError, }: QRLandingPageProps): react_jsx_runtime.JSX.Element | null;
+
+interface LandingPageProps {
+    /** Landing page slug */
+    slug: string;
+    /** Gateway URL — defaults to https://whale-gateway.fly.dev */
+    gatewayUrl?: string;
+    /**
+     * Override rendering for any section type.
+     * Return the custom element, or call defaultRenderer() for the built-in output.
+     */
+    renderSection?: (section: LandingSection, defaultRenderer: () => React.ReactNode) => React.ReactNode;
+    /** Called when data is loaded */
+    onDataLoaded?: (data: LandingPageRenderData) => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+}
+/**
+ * LandingPage — drop-in component that renders a configurable landing page
+ * fetched from the gateway's public endpoint.
+ *
+ * Usage:
+ * ```tsx
+ * import { LandingPage } from '@neowhale/storefront/react'
+ * export default function Page({ params }: { params: { slug: string } }) {
+ *   return <LandingPage slug={params.slug} />
+ * }
+ * ```
+ */
+declare function LandingPage({ slug, gatewayUrl, renderSection, onDataLoaded, onError, }: LandingPageProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * Auto-tracks page views on pathname change and links customer sessions.
  * Rendered internally by WhaleProvider — storefronts don't need to add this manually.
@@ -253,13 +449,16 @@ declare function CartInitializer(): null;
  */
 declare function AuthInitializer(): null;
 
+interface PixelInitializerProps {
+    onReady: (manager: PixelManager) => void;
+    onTheme?: (theme: Record<string, unknown>) => void;
+}
 /**
- * Fetches storefront pixel config on mount and initializes pixel providers.
+ * 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 }: {
-    onReady: (manager: PixelManager) => void;
-}): null;
+declare function PixelInitializer({ onReady, onTheme }: PixelInitializerProps): null;
 
-export { AnalyticsTracker, type AuthActions, AuthInitializer, type AuthState, type AuthStore, type CartActions, CartInitializer, type CartState, type CartStore, PixelInitializer, WhaleContext, type WhaleContextValue, WhaleProvider, type WhaleProviderProps, useAnalytics, useAuth, useCart, useCartItemCount, useCartTotal, useCustomerAnalytics, useCustomerOrders, useProduct, useProducts, useWhaleClient };
+export { AnalyticsTracker, type AuthActions, AuthInitializer, type AuthState, type AuthStore, type CartActions, CartInitializer, type CartState, type CartStore, LandingPage, type LandingPageProps, PixelInitializer, QRLandingPage, type QRLandingPageProps, type SearchParams, WhaleContext, type WhaleContextValue, WhaleProvider, type WhaleProviderProps, useAnalytics, useAuth, useCart, useCartItemCount, useCartTotal, useCategories, useCheckout, useCoupons, useCustomerAnalytics, useCustomerOrders, useLocations, useLoyalty, useProduct, useProducts, useRecommendations, useReviews, useSearch, useShipping, useWhaleClient, useWishlist };

package/dist/react/index.d.ts

@@ -1,17 +1,20 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { m as WhaleStorefrontConfig, i as Product, P as PaymentData, O as Order, a as CartItem, T as TaxBreakdown, W as WhaleClient, c as Customer, E as EventType, d as CustomerAnalytics } from '../client-y0V1x0px.js';
+import { D 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, F as WishlistItem, R as Recommendation, k as Location, x as ShippingMethod, y as ShippingRate, e as CouponValidation, C as Cart, Q as QRLandingData, i as LandingSection, h as LandingPageRenderData } from '../client-KHvDGThs.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-CYtRIGo0.js';
+import { P as PixelManager } from '../pixel-manager-Djp4Mh9L.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, storeId, apiKey, gatewayUrl, proxyPath, mediaSigningSecret, supabaseHost, storagePrefix, sessionTtl, debug, trackingEnabled, recordingRate, }: WhaleProviderProps): react_jsx_runtime.JSX.Element;
+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;
@@ -229,6 +232,199 @@ declare function useCustomerAnalytics(): {
     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;
+    }) => 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) => 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;
+    }>;
+};
+
+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 useCoupons(): {
+    validation: CouponValidation | null;
+    loading: boolean;
+    error: Error | null;
+    validate: (code: string, cartId?: string) => Promise<CouponValidation>;
+    apply: (cartId: string, code: string) => Promise<Cart>;
+    remove: (cartId: string) => Promise<Cart>;
+    clear: () => void;
+};
+
+interface QRLandingPageProps {
+    /** QR code string (from URL param) */
+    code: string;
+    /** Gateway URL — defaults to https://whale-gateway.fly.dev */
+    gatewayUrl?: string;
+    /** Custom component for product display */
+    renderProduct?: (data: QRLandingData) => React.ReactNode;
+    /** Custom component for COA/lab results */
+    renderCOA?: (data: QRLandingData) => React.ReactNode;
+    /** Custom component for the full page (overrides default layout) */
+    renderPage?: (data: QRLandingData) => React.ReactNode;
+    /** Called when data is loaded */
+    onDataLoaded?: (data: QRLandingData) => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+}
+/**
+ * QR Landing Page — drop-in component that renders a branded landing page
+ * for any QR code. Fetches data from the gateway's public endpoint.
+ *
+ * Usage:
+ * ```tsx
+ * // In app/qr/[code]/page.tsx:
+ * import { QRLandingPage } from '@neowhale/storefront/react'
+ * export default function Page({ params }: { params: { code: string } }) {
+ *   return <QRLandingPage code={params.code} />
+ * }
+ * ```
+ */
+declare function QRLandingPage({ code, gatewayUrl, renderProduct, renderCOA, renderPage, onDataLoaded, onError, }: QRLandingPageProps): react_jsx_runtime.JSX.Element | null;
+
+interface LandingPageProps {
+    /** Landing page slug */
+    slug: string;
+    /** Gateway URL — defaults to https://whale-gateway.fly.dev */
+    gatewayUrl?: string;
+    /**
+     * Override rendering for any section type.
+     * Return the custom element, or call defaultRenderer() for the built-in output.
+     */
+    renderSection?: (section: LandingSection, defaultRenderer: () => React.ReactNode) => React.ReactNode;
+    /** Called when data is loaded */
+    onDataLoaded?: (data: LandingPageRenderData) => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+}
+/**
+ * LandingPage — drop-in component that renders a configurable landing page
+ * fetched from the gateway's public endpoint.
+ *
+ * Usage:
+ * ```tsx
+ * import { LandingPage } from '@neowhale/storefront/react'
+ * export default function Page({ params }: { params: { slug: string } }) {
+ *   return <LandingPage slug={params.slug} />
+ * }
+ * ```
+ */
+declare function LandingPage({ slug, gatewayUrl, renderSection, onDataLoaded, onError, }: LandingPageProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * Auto-tracks page views on pathname change and links customer sessions.
  * Rendered internally by WhaleProvider — storefronts don't need to add this manually.
@@ -253,13 +449,16 @@ declare function CartInitializer(): null;
  */
 declare function AuthInitializer(): null;
 
+interface PixelInitializerProps {
+    onReady: (manager: PixelManager) => void;
+    onTheme?: (theme: Record<string, unknown>) => void;
+}
 /**
- * Fetches storefront pixel config on mount and initializes pixel providers.
+ * 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 }: {
-    onReady: (manager: PixelManager) => void;
-}): null;
+declare function PixelInitializer({ onReady, onTheme }: PixelInitializerProps): null;
 
-export { AnalyticsTracker, type AuthActions, AuthInitializer, type AuthState, type AuthStore, type CartActions, CartInitializer, type CartState, type CartStore, PixelInitializer, WhaleContext, type WhaleContextValue, WhaleProvider, type WhaleProviderProps, useAnalytics, useAuth, useCart, useCartItemCount, useCartTotal, useCustomerAnalytics, useCustomerOrders, useProduct, useProducts, useWhaleClient };
+export { AnalyticsTracker, type AuthActions, AuthInitializer, type AuthState, type AuthStore, type CartActions, CartInitializer, type CartState, type CartStore, LandingPage, type LandingPageProps, PixelInitializer, QRLandingPage, type QRLandingPageProps, type SearchParams, WhaleContext, type WhaleContextValue, WhaleProvider, type WhaleProviderProps, useAnalytics, useAuth, useCart, useCartItemCount, useCartTotal, useCategories, useCheckout, useCoupons, useCustomerAnalytics, useCustomerOrders, useLocations, useLoyalty, useProduct, useProducts, useRecommendations, useReviews, useSearch, useShipping, useWhaleClient, useWishlist };