@neowhale/storefront 0.1.2 → 0.2.1

package/dist/client-y0V1x0px.d.ts

@@ -0,0 +1,305 @@
+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 };

package/dist/index.cjs

@@ -1,12 +1,21 @@
 'use strict';
 
-var chunkXMLH3TLA_cjs = require('./chunk-XMLH3TLA.cjs');
+var chunkDAM7NZCI_cjs = require('./chunk-DAM7NZCI.cjs');
+var chunkOP4LOUCV_cjs = require('./chunk-OP4LOUCV.cjs');
 
 
 
+Object.defineProperty(exports, "PixelManager", {
+  enumerable: true,
+  get: function () { return chunkDAM7NZCI_cjs.PixelManager; }
+});
 Object.defineProperty(exports, "WhaleClient", {
   enumerable: true,
-  get: function () { return chunkXMLH3TLA_cjs.WhaleClient; }
+  get: function () { return chunkOP4LOUCV_cjs.WhaleClient; }
+});
+Object.defineProperty(exports, "resilientSend", {
+  enumerable: true,
+  get: function () { return chunkOP4LOUCV_cjs.resilientSend; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,269 +1,16 @@
-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;
-}
-type EventType = 'page_view' | 'product_view' | 'add_to_cart' | 'remove_from_cart' | 'begin_checkout' | 'purchase' | 'category_view' | 'search';
+export { A as Address, C as Cart, a as CartItem, b as Category, c as Customer, d as CustomerAnalytics, E as EventType, L as ListResponse, e as Location, O as Order, f as OrderItem, P as PaymentData, g as PixelConfig, h as PricingTier, i as Product, j as ProductVariation, S as SendCodeResponse, k as StorefrontConfig, l as StorefrontSession, T as TaxBreakdown, V as VerifyCodeResponse, W as WhaleClient, m as WhaleStorefrontConfig } from './client-y0V1x0px.cjs';
+export { P as PixelManager } from './pixel-manager-Db6Czwr2.cjs';
 
-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;
-    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(url: string): string;
-    static signMedia(signingSecret: string, encodedUrl: string, w: string, q: string, f: string): string;
-}
+/**
+ * Resilient HTTP sender for analytics/event payloads.
+ *
+ * Retries transient (5xx / network) failures with linear back-off,
+ * then falls back to navigator.sendBeacon so the event still lands
+ * even when the tab is being unloaded.
+ *
+ * 4xx responses are NOT retried — they indicate a client error that
+ * won't resolve by resending.
+ */
+declare function resilientSend(url: string, payload: object, headers: Record<string, string>): Promise<void>;
 
-export { type Address, type Cart, type CartItem, type Category, type Customer, type CustomerAnalytics, type EventType, type ListResponse, type Location, type Order, type OrderItem, type PaymentData, type PricingTier, type Product, type ProductVariation, type SendCodeResponse, type StorefrontSession, type TaxBreakdown, type VerifyCodeResponse, WhaleClient, type WhaleStorefrontConfig };
+export { resilientSend };