@neowhale/storefront 0.1.0

package/dist/index.cjs

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

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,3 @@
+export { WhaleClient } from './chunk-PR4PUHVN.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/next/index.cjs

@@ -0,0 +1,123 @@
+'use strict';
+
+var chunkXMLH3TLA_cjs = require('../chunk-XMLH3TLA.cjs');
+var server = require('next/server');
+
+// src/next/headers.ts
+var securityHeaders = [
+  {
+    key: "X-DNS-Prefetch-Control",
+    value: "on"
+  },
+  {
+    key: "Strict-Transport-Security",
+    value: "max-age=63072000; includeSubDomains; preload"
+  },
+  {
+    key: "X-Content-Type-Options",
+    value: "nosniff"
+  },
+  {
+    key: "X-Frame-Options",
+    value: "SAMEORIGIN"
+  },
+  {
+    key: "X-XSS-Protection",
+    value: "1; mode=block"
+  },
+  {
+    key: "Referrer-Policy",
+    value: "strict-origin-when-cross-origin"
+  },
+  {
+    key: "Permissions-Policy",
+    value: "camera=(), microphone=(), geolocation=(self), interest-cohort=()"
+  }
+];
+function withSecurityHeaders(extra) {
+  const allHeaders = extra ? [...securityHeaders, ...extra] : securityHeaders;
+  return async () => [
+    {
+      source: "/:path*",
+      headers: allHeaders
+    }
+  ];
+}
+
+// src/next/rewrite.ts
+function whaleGatewayRewrite(gatewayUrl = "https://whale-gateway.fly.dev", proxyPath = "/api/gw") {
+  return {
+    source: `${proxyPath}/:path*`,
+    destination: `${gatewayUrl}/:path*`
+  };
+}
+
+// src/next/server.ts
+function createServerClient(config) {
+  return new chunkXMLH3TLA_cjs.WhaleClient({
+    storeId: config?.storeId || process.env.NEXT_PUBLIC_STORE_ID || "",
+    apiKey: config?.apiKey || process.env.NEXT_PUBLIC_API_KEY || "",
+    gatewayUrl: config?.gatewayUrl || process.env.NEXT_PUBLIC_API_URL || "https://whale-gateway.fly.dev",
+    proxyPath: config?.proxyPath
+  });
+}
+async function getAllProducts(options) {
+  const client = options?.client ?? createServerClient();
+  return client.getAllProducts({
+    status: "published",
+    revalidate: options?.revalidate ?? 60,
+    filter: options?.filter
+  });
+}
+
+// src/next/image-loader.ts
+var ALLOWED_WIDTHS = [64, 96, 128, 256, 384, 640, 828, 1080, 1280, 1920];
+function snapWidth(w) {
+  for (const aw of ALLOWED_WIDTHS) {
+    if (aw >= w) return aw;
+  }
+  return ALLOWED_WIDTHS[ALLOWED_WIDTHS.length - 1];
+}
+function createImageLoader(config) {
+  return ({ src, width, quality }) => {
+    if (!src.includes(config.supabaseHost)) {
+      return src;
+    }
+    const w = String(snapWidth(width));
+    const q = String(quality || 80);
+    const f = "webp";
+    const encoded = chunkXMLH3TLA_cjs.WhaleClient.encodeBase64Url(src);
+    const s = chunkXMLH3TLA_cjs.WhaleClient.signMedia(config.signingSecret, encoded, w, q, f);
+    return `${config.gatewayUrl}/v1/stores/${config.storeId}/media?url=${encoded}&w=${w}&q=${q}&f=${f}&s=${s}`;
+  };
+}
+function createAuthMiddleware(options) {
+  const { protectedPaths, loginPath, cookieName = "whale-session" } = options;
+  return function middleware(request) {
+    const { pathname } = request.nextUrl;
+    const isProtected = protectedPaths.some(
+      (p) => pathname === p || pathname.startsWith(`${p}/`)
+    );
+    if (!isProtected) {
+      return server.NextResponse.next();
+    }
+    const token = request.cookies.get(cookieName)?.value;
+    if (!token) {
+      const url = request.nextUrl.clone();
+      url.pathname = loginPath;
+      url.searchParams.set("redirect", pathname);
+      return server.NextResponse.redirect(url);
+    }
+    return server.NextResponse.next();
+  };
+}
+
+exports.createAuthMiddleware = createAuthMiddleware;
+exports.createImageLoader = createImageLoader;
+exports.createServerClient = createServerClient;
+exports.getAllProducts = getAllProducts;
+exports.securityHeaders = securityHeaders;
+exports.whaleGatewayRewrite = whaleGatewayRewrite;
+exports.withSecurityHeaders = withSecurityHeaders;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map