@tagadapay/headless-sdk 1.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,276 @@
+export type Environment = 'production' | 'development' | 'local';
+export interface HeadlessConfig {
+    /** Your TagadaPay store ID (e.g. "store_abc123"). */
+    storeId: string;
+    /** Environment. Defaults to "production". */
+    environment?: Environment;
+    /** Public API key for authenticated requests. Optional -- many flows use checkout tokens instead. */
+    apiKey?: string;
+    /** Override the base API URL. Auto-resolved from environment if omitted. */
+    baseUrl?: string;
+    /** Request timeout in ms. Default 30000. */
+    timeout?: number;
+}
+export interface HttpRequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    body?: unknown;
+    headers?: Record<string, string>;
+    params?: Record<string, string | number | boolean | undefined>;
+    /** Override the auth token for this single request. */
+    token?: string;
+    signal?: AbortSignal;
+}
+export interface LineItem {
+    variantId: string;
+    priceId?: string;
+    quantity: number;
+}
+export interface CheckoutSession {
+    id: string;
+    storeId: string;
+    checkoutToken: string;
+    currency: string;
+    items: CheckoutLineItem[];
+    totals: CheckoutTotals;
+    customer?: CheckoutCustomer;
+    shippingAddress?: Address;
+    billingAddress?: Address;
+    promotionCode?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CheckoutLineItem {
+    id: string;
+    variantId: string;
+    priceId?: string;
+    productName: string;
+    variantName: string;
+    quantity: number;
+    unitAmount: number;
+    totalAmount: number;
+    currency: string;
+    imageUrl?: string;
+    recurring?: {
+        interval: string;
+        intervalCount: number;
+    };
+}
+export interface CheckoutTotals {
+    subtotal: number;
+    discount: number;
+    shipping: number;
+    tax: number;
+    total: number;
+    currency: string;
+}
+export interface CheckoutCustomer {
+    id?: string;
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+}
+export interface Address {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+}
+export interface ShippingRate {
+    id: string;
+    name: string;
+    description?: string;
+    amount: number;
+    currency: string;
+    estimatedDays?: number;
+}
+export interface PaymentMethodConfig {
+    enabled: boolean;
+    method: string;
+    provider?: string;
+    type?: string;
+    label?: string;
+    logoUrl?: string;
+    description?: string;
+    express?: boolean;
+    paymentFlowId?: string;
+    processorId?: string;
+    integrationId?: string;
+    publishableKey?: string;
+    metadata?: Record<string, unknown>;
+}
+export type PaymentSetupConfig = Record<string, PaymentMethodConfig>;
+export interface ExpressMethod {
+    type: string;
+    available: boolean;
+    processorId?: string;
+    publishableKey?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ExpressMethods {
+    applePay?: ExpressMethod;
+    googlePay?: ExpressMethod;
+    paypal?: ExpressMethod;
+    klarna?: ExpressMethod;
+    link?: ExpressMethod;
+}
+export interface StoreConfig {
+    threedsEnabled: boolean;
+    paymentFlowId?: string;
+    [key: string]: unknown;
+}
+export interface PayResult {
+    payment: {
+        id: string;
+        amount: number;
+        currency: string;
+        status: 'succeeded' | 'pending' | 'failed' | 'declined' | 'requires_action';
+        requireAction?: 'none' | 'threeds_auth' | 'redirect';
+        requireActionData?: {
+            type: string;
+            redirectUrl?: string;
+            metadata?: Record<string, unknown>;
+        };
+    };
+}
+export interface PayOptions {
+    checkoutSessionId: string;
+    /** Base64-encoded TagadaToken from tokenizeCard(). Instrument is auto-created. */
+    tagadaToken?: string;
+    /** Existing payment instrument ID (skip instrument creation). */
+    paymentInstrumentId?: string;
+    paymentFlowId?: string;
+    threedsSessionId?: string;
+    processorId?: string;
+    paymentMethod?: string;
+    isExpress?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface PayDirectOptions {
+    checkoutSessionId: string;
+    paymentInstrumentId?: string;
+    paymentFlowId?: string;
+    processorId?: string;
+    paymentMethod?: string;
+    isExpress?: boolean;
+    threedsSessionId?: string;
+}
+export interface CreateInstrumentOptions {
+    tagadaToken: string;
+    storeId: string;
+    customerData?: {
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+    };
+    customerId?: string;
+}
+export interface PaymentInstrument {
+    id: string;
+    type: string;
+    customerId: string;
+    card?: {
+        last4: string;
+        brand: string;
+        expMonth: number;
+        expYear: number;
+    };
+}
+export interface ThreedsSession {
+    id: string;
+    externalSessionId: string;
+    provider: string;
+    status: string;
+    paymentInstrumentId: string;
+}
+export interface PaymentStatus {
+    id: string;
+    amount: number;
+    currency: string;
+    status: 'succeeded' | 'pending' | 'failed' | 'declined';
+    requireAction?: string;
+}
+export interface AnalyticsEvent {
+    event: string;
+    data?: Record<string, unknown>;
+    timestamp?: number;
+}
+export interface PixelConfig {
+    metaPixelId?: string;
+    tiktokPixelId?: string;
+    snapchatPixelId?: string;
+    pinterestTagId?: string;
+    gtmId?: string;
+    gaId?: string;
+}
+export interface Offer {
+    id: string;
+    type: 'upsell' | 'downsell' | 'orderbump';
+    title: string;
+    titleTrans?: Record<string, string>;
+    description?: string;
+    lineItems: OfferLineItem[];
+    pricing?: {
+        amount: number;
+        currency: string;
+        compareAtAmount?: number;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface OfferLineItem {
+    priceId: string;
+    quantity: number;
+    productName?: string;
+    variantName?: string;
+    amount?: number;
+}
+export interface OfferResult {
+    success: boolean;
+    orderId?: string;
+    paymentId?: string;
+    error?: string;
+}
+export interface Customer {
+    id: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+}
+export interface Order {
+    id: string;
+    storeId: string;
+    customerId: string;
+    amount: number;
+    currency: string;
+    status: string;
+    items: OrderItem[];
+    createdAt: string;
+}
+export interface OrderItem {
+    id: string;
+    productName: string;
+    variantName: string;
+    quantity: number;
+    unitAmount: number;
+    totalAmount: number;
+}
+export interface Subscription {
+    id: string;
+    customerId: string;
+    storeId: string;
+    status: 'trialing' | 'active' | 'past_due' | 'paused' | 'canceled';
+    priceId: string;
+    currency: string;
+    amount: number;
+    interval: string;
+    intervalCount: number;
+    currentPeriodStart: string;
+    currentPeriodEnd: string;
+    cancelAtPeriodEnd: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './core/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/react/hooks/useAnalytics.d.ts

@@ -0,0 +1,59 @@
+import type { PixelConfig } from '../../core/types.js';
+export interface UseAnalyticsReturn {
+    trackPageView: (page?: string) => void;
+    trackViewContent: (data: {
+        productId?: string;
+        variantId?: string;
+        value?: number;
+        currency?: string;
+    }) => void;
+    trackAddToCart: (data: {
+        variantId: string;
+        quantity?: number;
+        amount?: number;
+        currency?: string;
+    }) => void;
+    trackInitiateCheckout: (data?: {
+        sessionId?: string;
+        value?: number;
+        currency?: string;
+    }) => void;
+    trackAddPaymentInfo: (data?: {
+        paymentMethod?: string;
+    }) => void;
+    trackPurchase: (data: {
+        orderId: string;
+        amount: number;
+        currency: string;
+    }) => void;
+    trackStep: (data: {
+        stepName: string;
+        stepIndex?: number;
+    }) => void;
+    trackConversion: (data: {
+        orderId: string;
+        amount: number;
+        currency: string;
+    }) => void;
+    trackCustomEvent: (event: string, data?: Record<string, unknown>) => void;
+}
+/**
+ * React hook for analytics and pixel tracking.
+ *
+ * Auto-initializes on mount, loading pixel config from the store.
+ * All track methods fire events to configured pixels (Meta, TikTok, Snap, GTM, GA).
+ *
+ * @example
+ * ```tsx
+ * const { trackPageView, trackPurchase } = useAnalytics();
+ *
+ * useEffect(() => { trackPageView('/checkout'); }, []);
+ *
+ * // After payment
+ * trackPurchase({ orderId: 'ord_xxx', amount: 4900, currency: 'USD' });
+ * ```
+ */
+export declare function useAnalytics(opts?: {
+    pixelConfig?: PixelConfig;
+}): UseAnalyticsReturn;
+//# sourceMappingURL=useAnalytics.d.ts.map

package/dist/react/hooks/useAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useAnalytics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gBAAgB,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAChH,cAAc,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7G,qBAAqB,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClG,mBAAmB,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,aAAa,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrF,SAAS,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACpE,eAAe,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvF,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,kBAAkB,CAuErF"}

package/dist/react/hooks/useAnalytics.js

@@ -0,0 +1,49 @@
+import { useEffect, useCallback, useRef } from 'react';
+import { useHeadlessClient } from '../provider.js';
+/**
+ * React hook for analytics and pixel tracking.
+ *
+ * Auto-initializes on mount, loading pixel config from the store.
+ * All track methods fire events to configured pixels (Meta, TikTok, Snap, GTM, GA).
+ *
+ * @example
+ * ```tsx
+ * const { trackPageView, trackPurchase } = useAnalytics();
+ *
+ * useEffect(() => { trackPageView('/checkout'); }, []);
+ *
+ * // After payment
+ * trackPurchase({ orderId: 'ord_xxx', amount: 4900, currency: 'USD' });
+ * ```
+ */
+export function useAnalytics(opts) {
+    const client = useHeadlessClient();
+    const initRef = useRef(false);
+    useEffect(() => {
+        if (initRef.current)
+            return;
+        initRef.current = true;
+        client.analytics.init({ pixelConfig: opts?.pixelConfig });
+    }, [client, opts?.pixelConfig]);
+    const trackPageView = useCallback((page) => client.analytics.trackPageView(page), [client]);
+    const trackViewContent = useCallback((data) => client.analytics.trackViewContent(data), [client]);
+    const trackAddToCart = useCallback((data) => client.analytics.trackAddToCart(data), [client]);
+    const trackInitiateCheckout = useCallback((data) => client.analytics.trackInitiateCheckout(data), [client]);
+    const trackAddPaymentInfo = useCallback((data) => client.analytics.trackAddPaymentInfo(data), [client]);
+    const trackPurchase = useCallback((data) => client.analytics.trackPurchase(data), [client]);
+    const trackStep = useCallback((data) => client.analytics.trackStep(data), [client]);
+    const trackConversion = useCallback((data) => client.analytics.trackConversion(data), [client]);
+    const trackCustomEvent = useCallback((event, data) => client.analytics.trackCustomEvent(event, data), [client]);
+    return {
+        trackPageView,
+        trackViewContent,
+        trackAddToCart,
+        trackInitiateCheckout,
+        trackAddPaymentInfo,
+        trackPurchase,
+        trackStep,
+        trackConversion,
+        trackCustomEvent,
+    };
+}
+//# sourceMappingURL=useAnalytics.js.map

package/dist/react/hooks/useAnalytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.js","sourceRoot":"","sources":["../../../src/react/hooks/useAnalytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAenD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,IAAoC;IAC/D,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO;QAC5B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5D,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAEhC,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,IAAa,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,EACvD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,gBAAgB,GAAG,WAAW,CAClC,CAAC,IAAmF,EAAE,EAAE,CACtF,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,EACzC,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,IAAkF,EAAE,EAAE,CACrF,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,EACvC,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,qBAAqB,GAAG,WAAW,CACvC,CAAC,IAAgE,EAAE,EAAE,CACnE,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAC9C,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,mBAAmB,GAAG,WAAW,CACrC,CAAC,IAAiC,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,EACjF,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,IAA2D,EAAE,EAAE,CAC9D,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,EACtC,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,IAA8C,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EACpF,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,eAAe,GAAG,WAAW,CACjC,CAAC,IAA2D,EAAE,EAAE,CAC9D,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,EACxC,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,gBAAgB,GAAG,WAAW,CAClC,CAAC,KAAa,EAAE,IAA8B,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,EACjG,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,aAAa;QACb,gBAAgB;QAChB,cAAc;QACd,qBAAqB;QACrB,mBAAmB;QACnB,aAAa;QACb,SAAS;QACT,eAAe;QACf,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/react/hooks/useCheckout.d.ts

@@ -0,0 +1,45 @@
+import type { CheckoutSession, LineItem, ShippingRate, Address, CheckoutCustomer } from '../../core/types.js';
+export interface UseCheckoutReturn {
+    session: CheckoutSession | null;
+    isLoading: boolean;
+    error: Error | null;
+    /** Reload the session from the server. */
+    refresh: () => Promise<void>;
+    /** Create a new checkout session (auto-loads it after creation). */
+    createSession: (opts: {
+        items: LineItem[];
+        currency?: string;
+        returnUrl?: string;
+        customerEmail?: string;
+    }) => Promise<void>;
+    /** Replace cart items. */
+    updateCart: (items: LineItem[]) => Promise<void>;
+    /** Update customer info on the session. */
+    updateCustomer: (customer: Partial<CheckoutCustomer>) => Promise<void>;
+    /** Update address on the session. */
+    updateAddress: (addresses: {
+        shippingAddress?: Address;
+        billingAddress?: Address;
+    }) => Promise<void>;
+    /** Apply a promo code. */
+    applyPromo: (code: string) => Promise<void>;
+    /** Remove the applied promo code. */
+    removePromo: () => Promise<void>;
+    /** Fetch shipping rates. */
+    getShippingRates: () => Promise<ShippingRate[]>;
+    /** Select a shipping rate. */
+    selectShippingRate: (rateId: string) => Promise<void>;
+}
+/**
+ * React hook for checkout session management.
+ *
+ * @param checkoutToken - The checkout token from the URL (e.g. `?checkoutToken=xxx`).
+ * @param sessionToken - Optional JWT session token (from URL param `token`).
+ *
+ * @example
+ * ```tsx
+ * const { session, isLoading, applyPromo, createSession } = useCheckout(checkoutToken, sessionToken);
+ * ```
+ */
+export declare function useCheckout(checkoutToken: string | null | undefined, sessionToken?: string): UseCheckoutReturn;
+//# sourceMappingURL=useCheckout.d.ts.map

package/dist/react/hooks/useCheckout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckout.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useCheckout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE9G,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,oEAAoE;IACpE,aAAa,EAAE,CAAC,IAAI,EAAE;QACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,0BAA0B;IAC1B,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,2CAA2C;IAC3C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,qCAAqC;IACrC,aAAa,EAAE,CAAC,SAAS,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrG,0BAA0B;IAC1B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,qCAAqC;IACrC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,4BAA4B;IAC5B,gBAAgB,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChD,8BAA8B;IAC9B,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,YAAY,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAwGnB"}

package/dist/react/hooks/useCheckout.js

@@ -0,0 +1,113 @@
+import { useState, useEffect, useCallback } from 'react';
+import { useHeadlessClient } from '../provider.js';
+/**
+ * React hook for checkout session management.
+ *
+ * @param checkoutToken - The checkout token from the URL (e.g. `?checkoutToken=xxx`).
+ * @param sessionToken - Optional JWT session token (from URL param `token`).
+ *
+ * @example
+ * ```tsx
+ * const { session, isLoading, applyPromo, createSession } = useCheckout(checkoutToken, sessionToken);
+ * ```
+ */
+export function useCheckout(checkoutToken, sessionToken) {
+    const client = useHeadlessClient();
+    const [session, setSession] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const loadSession = useCallback(async () => {
+        if (!checkoutToken)
+            return;
+        setIsLoading(true);
+        setError(null);
+        try {
+            const s = await client.checkout.loadSession(checkoutToken, sessionToken);
+            setSession(s);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, checkoutToken, sessionToken]);
+    useEffect(() => {
+        loadSession();
+    }, [loadSession]);
+    const createSession = useCallback(async (opts) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await client.checkout.createSession(opts);
+            const newUrl = new URL(window.location.href);
+            newUrl.searchParams.set('checkoutToken', result.checkoutToken);
+            newUrl.searchParams.set('token', result.sessionToken);
+            window.history.replaceState({}, '', newUrl.toString());
+            const s = await client.checkout.loadSession(result.checkoutToken, result.sessionToken);
+            setSession(s);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client]);
+    const updateCart = useCallback(async (items) => {
+        if (!session)
+            return;
+        const updated = await client.checkout.updateCart(session.id, items);
+        setSession(updated);
+    }, [client, session]);
+    const updateCustomer = useCallback(async (customer) => {
+        if (!session)
+            return;
+        const updated = await client.checkout.updateCustomer(session.id, customer);
+        setSession(updated);
+    }, [client, session]);
+    const updateAddress = useCallback(async (addresses) => {
+        if (!session)
+            return;
+        const updated = await client.checkout.updateAddress(session.id, addresses);
+        setSession(updated);
+    }, [client, session]);
+    const applyPromo = useCallback(async (code) => {
+        if (!session)
+            return;
+        const updated = await client.checkout.applyPromoCode(session.id, code);
+        setSession(updated);
+    }, [client, session]);
+    const removePromo = useCallback(async () => {
+        if (!session)
+            return;
+        const updated = await client.checkout.removePromoCode(session.id);
+        setSession(updated);
+    }, [client, session]);
+    const getShippingRates = useCallback(async () => {
+        if (!session)
+            return [];
+        return client.checkout.getShippingRates(session.id);
+    }, [client, session]);
+    const selectShippingRate = useCallback(async (rateId) => {
+        if (!session)
+            return;
+        const updated = await client.checkout.selectShippingRate(session.id, rateId);
+        setSession(updated);
+    }, [client, session]);
+    return {
+        session,
+        isLoading,
+        error,
+        refresh: loadSession,
+        createSession,
+        updateCart,
+        updateCustomer,
+        updateAddress,
+        applyPromo,
+        removePromo,
+        getShippingRates,
+        selectShippingRate,
+    };
+}
+//# sourceMappingURL=useCheckout.js.map

package/dist/react/hooks/useCheckout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckout.js","sourceRoot":"","sources":["../../../src/react/hooks/useCheckout.ts"],"names":[],"mappings":"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"}

package/dist/react/hooks/useCustomer.d.ts

@@ -0,0 +1,28 @@
+import type { Customer, Order, Subscription } from '../../core/types.js';
+export interface UseCustomerReturn {
+    customer: Customer | null;
+    orders: Order[];
+    subscriptions: Subscription[];
+    isLoading: boolean;
+    error: Error | null;
+    /** Load customer profile by ID. */
+    loadCustomer: (customerId: string) => Promise<void>;
+    /** Load customer orders. */
+    loadOrders: (customerId: string) => Promise<void>;
+    /** Load customer subscriptions. */
+    loadSubscriptions: (customerId: string) => Promise<void>;
+    /** Update customer profile. */
+    updateProfile: (customerId: string, data: Partial<Pick<Customer, 'email' | 'firstName' | 'lastName' | 'phone'>>) => Promise<void>;
+}
+/**
+ * React hook for customer data -- profile, orders, subscriptions.
+ *
+ * @param customerId - Auto-loads the customer profile when provided.
+ *
+ * @example
+ * ```tsx
+ * const { customer, orders, loadOrders } = useCustomer(session?.customer?.id);
+ * ```
+ */
+export declare function useCustomer(customerId?: string | null): UseCustomerReturn;
+//# sourceMappingURL=useCustomer.d.ts.map

package/dist/react/hooks/useCustomer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCustomer.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useCustomer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,mCAAmC;IACnC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,4BAA4B;IAC5B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,mCAAmC;IACnC,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,+BAA+B;IAC/B,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnI;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAkEzE"}