@neowhale/storefront 0.2.5 → 0.2.7

package/dist/client-y0V1x0px.d.ts

@@ -1,305 +0,0 @@
-interface PixelConfig {
-    provider: string;
-    pixel_id: string;
-}
-interface StorefrontConfig {
-    object: 'storefront_config';
-    pixels: PixelConfig[];
-}
-
-interface PricingTier {
-    id: string;
-    unit: string;
-    label: string;
-    quantity: number;
-    sort_order: number;
-    default_price: number;
-}
-interface ProductVariation {
-    id: string;
-    product_id: string;
-    name: string;
-    sku: string | null;
-    price: number;
-    stock_quantity: number;
-    attributes: Record<string, string>;
-}
-interface Product {
-    id: string;
-    name: string;
-    slug: string;
-    sku: string | null;
-    description: string | null;
-    status: string;
-    type: string;
-    primary_category_id: string;
-    featured_image: string | null;
-    image_gallery: string[];
-    pricing_data: PricingTier[] | {
-        mode?: string;
-        tiers?: PricingTier[];
-    } | null;
-    custom_fields: Record<string, string | null>;
-    stock_quantity?: number;
-}
-interface Category {
-    id: string;
-    name: string;
-    slug: string;
-}
-interface CartItem {
-    id: string;
-    product_id: string;
-    product_name: string;
-    image_url: string | null;
-    quantity: number;
-    unit_price: number;
-    tier_label: string | null;
-    line_total: number;
-}
-interface TaxBreakdown {
-    name: string;
-    rate: number;
-    type: string;
-    rate_decimal: number;
-}
-interface Cart {
-    id: string;
-    items: CartItem[];
-    item_count: number;
-    subtotal: number;
-    tax_rate: number;
-    tax_amount: number;
-    total: number;
-    tax_breakdown: TaxBreakdown[];
-    discount_amount: number;
-    customer_email: string | null;
-}
-interface Order {
-    id: string;
-    order_number: string;
-    status: string;
-    total_amount: number;
-    subtotal: number;
-    tax_amount: number;
-    discount_amount: number;
-    item_count?: number;
-    created_at: string;
-    payment_status?: string;
-    fulfillment_status?: string;
-    items?: OrderItem[];
-}
-interface OrderItem {
-    id: string;
-    product_name: string;
-    quantity: number;
-    unit_price?: number;
-    cost_per_unit?: number;
-    line_total: number;
-}
-interface Customer {
-    id: string;
-    first_name: string;
-    last_name: string;
-    email: string | null;
-    phone: string | null;
-    loyalty_points: number;
-    loyalty_tier: string;
-    total_spent: number;
-    total_orders: number;
-    lifetime_value?: number;
-    street_address?: string | null;
-    city?: string | null;
-    state?: string | null;
-    postal_code?: string | null;
-    date_of_birth?: string | null;
-    created_at?: string;
-    is_staff?: boolean;
-    email_consent?: boolean;
-    sms_consent?: boolean;
-}
-interface Address {
-    firstName: string;
-    lastName: string;
-    address: string;
-    city: string;
-    state: string;
-    zip: string;
-    country: string;
-}
-interface PaymentData {
-    payment_method: 'card' | 'cash';
-    opaque_data?: {
-        dataDescriptor: string;
-        dataValue: string;
-    };
-    billTo?: Address;
-    shipTo?: Address;
-}
-interface CustomerAnalytics {
-    customer_id: string;
-    customer_name: string;
-    total_orders: number;
-    lifetime_revenue: number;
-    avg_order_value: number;
-    ltv_tier: string;
-    rfm_segment: string;
-    churn_risk: string;
-    last_order_date: string;
-    recency_days: number;
-}
-interface Location {
-    id: string;
-    name: string;
-    address?: string;
-    city?: string;
-    state?: string;
-    zip?: string;
-    phone?: string;
-    is_active?: boolean;
-}
-interface SendCodeResponse {
-    sent: boolean;
-}
-interface VerifyCodeResponse {
-    object: string;
-    token_hash: string;
-    needs_profile: boolean;
-    customer: Customer | null;
-}
-interface StorefrontSession {
-    id: string;
-    store_id: string;
-    customer_id?: string;
-    started_at: string;
-    last_active_at: string;
-}
-interface ListResponse<T> {
-    object: 'list';
-    data: T[];
-    has_more: boolean;
-    cursors?: {
-        before?: string;
-        after?: string;
-    };
-    url?: string;
-}
-interface WhaleStorefrontConfig {
-    /** Store UUID */
-    storeId: string;
-    /** API key (wk_live_... or wk_test_...) */
-    apiKey: string;
-    /** Gateway base URL. Defaults to https://whale-gateway.fly.dev */
-    gatewayUrl?: string;
-    /** Client-side proxy path. Defaults to /api/gw */
-    proxyPath?: string;
-    /** Media signing secret for image/video proxy */
-    mediaSigningSecret?: string;
-    /** Supabase host for media URL detection */
-    supabaseHost?: string;
-    /** localStorage key prefix. Defaults to "whale" */
-    storagePrefix?: string;
-    /** Analytics session TTL in ms. Defaults to 30 minutes */
-    sessionTtl?: number;
-    /** Enable debug logging */
-    debug?: boolean;
-    /**
-     * Master toggle for all tracking (analytics, pixels, behavioral).
-     * When false every tracking call is a no-op.
-     * Defaults to true; can also be set via NEXT_PUBLIC_TRACKING_ENABLED env var.
-     */
-    trackingEnabled?: boolean;
-    /**
-     * Fraction of sessions that record full behavioral replays (0 – 1).
-     * 0 = never, 1 = every session. Defaults to 0.1 (10 %).
-     * Can also be set via NEXT_PUBLIC_RECORDING_RATE env var.
-     */
-    recordingRate?: number;
-}
-type EventType = 'page_view' | 'product_view' | 'add_to_cart' | 'remove_from_cart' | 'begin_checkout' | 'purchase' | 'category_view' | 'search';
-
-/**
- * Extended query methods and static utilities for WhaleClient.
- * Extracted from client.ts to keep the core under 300 lines.
- */
-
-/**
- * Base64url-encode a URL string (works in both Node and browser).
- */
-declare function encodeBase64Url(url: string): string;
-/**
- * Quad-FNV (128-bit) media signing — matches gateway's media-signature.ts.
- */
-declare function signMedia(signingSecret: string, encodedUrl: string, w: string, q: string, f: string): string;
-
-declare class WhaleClient {
-    readonly storeId: string;
-    readonly apiKey: string;
-    readonly gatewayUrl: string;
-    readonly proxyPath: string;
-    private _sessionToken;
-    constructor(config: WhaleStorefrontConfig);
-    setSessionToken(token: string | null): void;
-    getSessionToken(): string | null;
-    private get baseUrl();
-    private request;
-    listProducts(params?: {
-        limit?: number;
-        starting_after?: string;
-        status?: string;
-    }): Promise<ListResponse<Product>>;
-    getProduct(id: string): Promise<Product>;
-    getAllProducts(options?: {
-        status?: string;
-        maxPages?: number;
-        revalidate?: number;
-        filter?: (product: Product) => boolean;
-    }): Promise<Product[]>;
-    createCart(customerEmail?: string): Promise<Cart>;
-    getCart(cartId: string): Promise<Cart>;
-    addToCart(cartId: string, productId: string, quantity: number, options?: {
-        tier?: string;
-        unitPrice?: number;
-    }): Promise<CartItem>;
-    updateCartItem(cartId: string, itemId: string, quantity: number): Promise<Cart>;
-    removeCartItem(cartId: string, itemId: string): Promise<void>;
-    checkout(cartId: string, customerEmail?: string, payment?: PaymentData): Promise<Order>;
-    findCustomer(query: string): Promise<Customer[]>;
-    getCustomer(id: string): Promise<Customer>;
-    createCustomer(data: {
-        first_name: string;
-        last_name: string;
-        email: string;
-        phone?: string;
-    }): Promise<Customer>;
-    listOrders(params?: {
-        customer_id?: string;
-        limit?: number;
-        starting_after?: string;
-    }): Promise<ListResponse<Order>>;
-    getOrder(id: string): Promise<Order>;
-    getCustomerOrders(customerId: string): Promise<Order[]>;
-    sendCode(email: string): Promise<SendCodeResponse>;
-    verifyCode(email: string, code: string): Promise<VerifyCodeResponse>;
-    getCustomerAnalytics(customerId: string, customerName?: string): Promise<CustomerAnalytics | null>;
-    listLocations(): Promise<ListResponse<Location>>;
-    getCOAEmbedUrl(productId: string): string;
-    fetchStorefrontConfig(): Promise<StorefrontConfig>;
-    createSession(params: {
-        user_agent?: string;
-        referrer?: string;
-    }): Promise<StorefrontSession>;
-    updateSession(sessionId: string, params: {
-        last_active_at?: string;
-        customer_id?: string;
-    }): Promise<StorefrontSession>;
-    trackEvent(params: {
-        session_id: string;
-        event_type: EventType;
-        event_data?: Record<string, unknown>;
-    }): Promise<void>;
-    static encodeBase64Url: typeof encodeBase64Url;
-    static signMedia: typeof signMedia;
-}
-
-export { type Address as A, type Cart as C, type EventType as E, type ListResponse as L, type Order as O, type PaymentData as P, type SendCodeResponse as S, type TaxBreakdown as T, type VerifyCodeResponse as V, WhaleClient as W, type CartItem as a, type Category as b, type Customer as c, type CustomerAnalytics as d, type Location as e, type OrderItem as f, type PixelConfig as g, type PricingTier as h, type Product as i, type ProductVariation as j, type StorefrontConfig as k, type StorefrontSession as l, type WhaleStorefrontConfig as m };