@tagadapay/headless-sdk 1.0.0

package/dist/core/modules/analytics.js

@@ -0,0 +1,265 @@
+/**
+ * Analytics and pixel tracking -- page views, checkout steps, conversions.
+ *
+ * Automatically loads pixel scripts (Meta, TikTok, Snapchat, GTM, GA)
+ * from your store's configuration in the CRM, then fires events to all active pixels.
+ */
+export class AnalyticsModule {
+    constructor(http, storeId) {
+        this.http = http;
+        this.storeId = storeId;
+        this.pixels = { loaded: false };
+        this.eventQueue = [];
+        this.dedupeSet = new Set();
+    }
+    /**
+     * Initialize analytics by loading pixel configuration from the store.
+     * Call this once on page load. Events fired before init completes are queued.
+     */
+    async init(opts) {
+        if (this.pixels.loaded)
+            return;
+        let config = opts?.pixelConfig;
+        if (!config) {
+            try {
+                const res = await this.http.get('/api/v1/checkout/config', { params: { storeId: this.storeId } });
+                config = res.pixels;
+            }
+            catch {
+                // graceful degradation -- analytics just won't fire pixels
+            }
+        }
+        this.pixels = { loaded: true, config };
+        if (typeof window !== 'undefined' && config) {
+            this.loadPixelScripts(config);
+        }
+        this.flushQueue();
+    }
+    // ---------------------------------------------------------------------------
+    // Standard e-commerce events
+    // ---------------------------------------------------------------------------
+    trackPageView(page) {
+        this.fireEvent('PageView', { page: page ?? this.getCurrentPath() });
+    }
+    trackViewContent(data) {
+        this.fireEvent('ViewContent', data);
+    }
+    trackAddToCart(data) {
+        this.fireEvent('AddToCart', data);
+    }
+    trackInitiateCheckout(data) {
+        this.fireEvent('InitiateCheckout', data ?? {});
+    }
+    trackAddPaymentInfo(data) {
+        this.fireEvent('AddPaymentInfo', data ?? {});
+    }
+    trackPurchase(data) {
+        this.fireEvent('Purchase', data, true);
+    }
+    trackCustomEvent(event, data) {
+        this.fireEvent(event, data ?? {});
+    }
+    /** Track a funnel step (maps to Tagada's funnel tracking endpoint). */
+    trackStep(data) {
+        this.fireEvent('FunnelStep', data);
+        this.http
+            .post('/api/v1/funnel-tracking/step', {
+            storeId: this.storeId,
+            ...data,
+        })
+            .catch(() => {
+            // best-effort -- don't block the UI
+        });
+    }
+    trackConversion(data) {
+        this.fireEvent('Conversion', data, true);
+    }
+    // ---------------------------------------------------------------------------
+    // Internals
+    // ---------------------------------------------------------------------------
+    fireEvent(event, data, dedupe = false) {
+        if (dedupe) {
+            const key = `${event}:${JSON.stringify(data)}`;
+            if (this.dedupeSet.has(key))
+                return;
+            this.dedupeSet.add(key);
+        }
+        if (!this.pixels.loaded) {
+            this.eventQueue.push({ event, data });
+            return;
+        }
+        this.sendToMeta(event, data);
+        this.sendToTikTok(event, data);
+        this.sendToSnapchat(event, data);
+        this.sendToGTM(event, data);
+        this.sendToGA(event, data);
+    }
+    flushQueue() {
+        const queue = [...this.eventQueue];
+        this.eventQueue = [];
+        for (const { event, data } of queue) {
+            this.fireEvent(event, data);
+        }
+    }
+    getCurrentPath() {
+        return typeof window !== 'undefined' ? window.location.pathname : '/';
+    }
+    // ---------------------------------------------------------------------------
+    // Pixel script loaders
+    // ---------------------------------------------------------------------------
+    loadPixelScripts(config) {
+        if (config.metaPixelId)
+            this.loadMetaPixel(config.metaPixelId);
+        if (config.tiktokPixelId)
+            this.loadTikTokPixel(config.tiktokPixelId);
+        if (config.snapchatPixelId)
+            this.loadSnapchatPixel(config.snapchatPixelId);
+        if (config.gtmId)
+            this.loadGTM(config.gtmId);
+        if (config.gaId)
+            this.loadGA(config.gaId);
+    }
+    loadMetaPixel(pixelId) {
+        if (typeof window === 'undefined')
+            return;
+        const w = window;
+        if (w.fbq)
+            return;
+        const n = (w.fbq = function (...args) {
+            n.callMethod
+                ? n.callMethod(...args)
+                : n.queue.push(args);
+        });
+        n.queue = [];
+        n.loaded = true;
+        n.version = '2.0';
+        this.injectScript('https://connect.facebook.net/en_US/fbevents.js');
+        w.fbq('init', pixelId);
+    }
+    loadTikTokPixel(pixelId) {
+        if (typeof window === 'undefined')
+            return;
+        const w = window;
+        if (w.ttq)
+            return;
+        const ttq = {};
+        ttq.methods = ['page', 'track', 'identify', 'instances', 'debug', 'on', 'off', 'once', 'ready', 'alias', 'group', 'enableCookie', 'disableCookie'];
+        ttq.setAndDefer = function (t, e) {
+            t[e] = function (...args) {
+                t.push([e, ...args]);
+            };
+        };
+        w.ttq = ttq;
+        this.injectScript('https://analytics.tiktok.com/i18n/pixel/events.js?sdkid=' + pixelId);
+    }
+    loadSnapchatPixel(pixelId) {
+        if (typeof window === 'undefined')
+            return;
+        const w = window;
+        if (w.snaptr)
+            return;
+        w.snaptr = function (...args) {
+            w.snaptr.handleRequest
+                ? w.snaptr.handleRequest(...args)
+                : w.snaptr.queue.push(args);
+        };
+        w.snaptr.queue = [];
+        this.injectScript('https://sc-static.net/scevent.min.js');
+        w.snaptr('init', pixelId);
+    }
+    loadGTM(gtmId) {
+        if (typeof window === 'undefined')
+            return;
+        const w = window;
+        w.dataLayer = w.dataLayer ?? [];
+        w.dataLayer.push({ 'gtm.start': Date.now(), event: 'gtm.js' });
+        this.injectScript(`https://www.googletagmanager.com/gtm.js?id=${gtmId}`);
+    }
+    loadGA(gaId) {
+        if (typeof window === 'undefined')
+            return;
+        this.injectScript(`https://www.googletagmanager.com/gtag/js?id=${gaId}`);
+        const w = window;
+        w.dataLayer = w.dataLayer ?? [];
+        w.gtag = function (...args) {
+            w.dataLayer.push(args);
+        };
+        w.gtag('js', new Date());
+        w.gtag('config', gaId);
+    }
+    injectScript(src) {
+        if (typeof document === 'undefined')
+            return;
+        const s = document.createElement('script');
+        s.async = true;
+        s.src = src;
+        document.head.appendChild(s);
+    }
+    // ---------------------------------------------------------------------------
+    // Event dispatchers per pixel
+    // ---------------------------------------------------------------------------
+    sendToMeta(event, data) {
+        const w = typeof window !== 'undefined' ? window : null;
+        const fbq = w?.fbq;
+        if (!fbq)
+            return;
+        const metaEventMap = {
+            PageView: 'PageView',
+            ViewContent: 'ViewContent',
+            AddToCart: 'AddToCart',
+            InitiateCheckout: 'InitiateCheckout',
+            AddPaymentInfo: 'AddPaymentInfo',
+            Purchase: 'Purchase',
+        };
+        const mapped = metaEventMap[event];
+        if (mapped) {
+            fbq('track', mapped, data);
+        }
+        else {
+            fbq('trackCustom', event, data);
+        }
+    }
+    sendToTikTok(event, data) {
+        const w = typeof window !== 'undefined' ? window : null;
+        const ttq = w?.ttq;
+        if (!ttq)
+            return;
+        if (event === 'PageView') {
+            ttq.page?.();
+        }
+        else {
+            ttq.track?.(event, data);
+        }
+    }
+    sendToSnapchat(event, data) {
+        const w = typeof window !== 'undefined' ? window : null;
+        const snaptr = w?.snaptr;
+        if (!snaptr)
+            return;
+        const snapEventMap = {
+            PageView: 'PAGE_VIEW',
+            ViewContent: 'VIEW_CONTENT',
+            AddToCart: 'ADD_CART',
+            InitiateCheckout: 'START_CHECKOUT',
+            Purchase: 'PURCHASE',
+        };
+        const mapped = snapEventMap[event];
+        if (mapped)
+            snaptr('track', mapped, data);
+    }
+    sendToGTM(event, data) {
+        const w = typeof window !== 'undefined' ? window : null;
+        const dataLayer = w?.dataLayer;
+        if (!dataLayer)
+            return;
+        dataLayer.push({ event, ...data });
+    }
+    sendToGA(event, data) {
+        const w = typeof window !== 'undefined' ? window : null;
+        const gtag = w?.gtag;
+        if (!gtag)
+            return;
+        gtag('event', event, data);
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/core/modules/analytics.js.map

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

package/dist/core/modules/checkout.d.ts

@@ -0,0 +1,67 @@
+import type { HttpClient } from '../http.js';
+import type { CheckoutSession, LineItem, ShippingRate, Address, CheckoutCustomer } from '../types.js';
+/**
+ * Manages checkout sessions -- load, update cart, apply promo codes, handle shipping.
+ *
+ * All methods talk to the TagadaPay REST API and return typed data.
+ * No local state is kept; the server is the source of truth.
+ */
+export declare class CheckoutModule {
+    private readonly http;
+    private readonly storeId;
+    private readonly onTokenChange?;
+    private sessionToken;
+    constructor(http: HttpClient, storeId: string, onTokenChange?: ((token: string) => void) | undefined);
+    /**
+     * Load an existing checkout session by its checkout token.
+     *
+     * @param checkoutToken The checkout token (from URL param `checkoutToken`).
+     * @param sessionToken The JWT session token (from URL param `token`). Required for auth.
+     *
+     * Both values come from the redirect URL returned by `createSession()`.
+     * Example URL: `/checkout?checkoutToken=abc123&token=eyJ...`
+     */
+    loadSession(checkoutToken: string, sessionToken?: string): Promise<CheckoutSession>;
+    /**
+     * Create a new checkout session.
+     *
+     * Returns a `checkoutToken` and `sessionToken` (JWT) needed for all subsequent calls.
+     * Also returns a `checkoutUrl` (the full Tagada-hosted checkout URL, for reference).
+     */
+    createSession(opts: {
+        items: LineItem[];
+        currency?: string;
+        returnUrl?: string;
+        customerEmail?: string;
+        customerFirstName?: string;
+        customerLastName?: string;
+    }): Promise<{
+        checkoutUrl: string;
+        checkoutToken: string;
+        sessionToken: string;
+        customerId: string;
+    }>;
+    /** Replace the cart items for an existing session. */
+    updateCart(sessionId: string, items: LineItem[]): Promise<CheckoutSession>;
+    /** Update customer information on the session. */
+    updateCustomer(sessionId: string, customer: Partial<CheckoutCustomer>): Promise<CheckoutSession>;
+    /** Update shipping and/or billing address on the session. */
+    updateAddress(sessionId: string, addresses: {
+        shippingAddress?: Address;
+        billingAddress?: Address;
+    }): Promise<CheckoutSession>;
+    /** Apply a promotion code to the session. */
+    applyPromoCode(sessionId: string, code: string): Promise<CheckoutSession>;
+    /** Remove the currently applied promotion code. */
+    removePromoCode(sessionId: string): Promise<CheckoutSession>;
+    /** Fetch available shipping rates for the session's address. */
+    getShippingRates(sessionId: string): Promise<ShippingRate[]>;
+    /** Select a shipping rate for the session. */
+    selectShippingRate(sessionId: string, rateId: string): Promise<CheckoutSession>;
+    /**
+     * Normalize the raw v2 API response into a cleaner CheckoutSession shape.
+     * The raw response has nested `checkoutSession` + `summary` -- we flatten it.
+     */
+    private normalizeSession;
+}
+//# sourceMappingURL=checkout.d.ts.map

package/dist/core/modules/checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../../src/core/modules/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IALjC,OAAO,CAAC,YAAY,CAAqB;gBAGtB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,aAAA;IAG1D;;;;;;;;OAQG;IACG,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAiBzF;;;;;OAKG;IACG,aAAa,CAAC,IAAI,EAAE;QACxB,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA0CrG,sDAAsD;IAChD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAQhF,kDAAkD;IAC5C,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,OAAO,CAAC,eAAe,CAAC;IAQ3B,6DAA6D;IACvD,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GACjE,OAAO,CAAC,eAAe,CAAC;IAQ3B,6CAA6C;IACvC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ/E,mDAAmD;IAC7C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAMlE,gEAAgE;IAC1D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQlE,8CAA8C;IACxC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQrF;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAwDzB"}

package/dist/core/modules/checkout.js

@@ -0,0 +1,164 @@
+/**
+ * Manages checkout sessions -- load, update cart, apply promo codes, handle shipping.
+ *
+ * All methods talk to the TagadaPay REST API and return typed data.
+ * No local state is kept; the server is the source of truth.
+ */
+export class CheckoutModule {
+    constructor(http, storeId, onTokenChange) {
+        this.http = http;
+        this.storeId = storeId;
+        this.onTokenChange = onTokenChange;
+    }
+    /**
+     * Load an existing checkout session by its checkout token.
+     *
+     * @param checkoutToken The checkout token (from URL param `checkoutToken`).
+     * @param sessionToken The JWT session token (from URL param `token`). Required for auth.
+     *
+     * Both values come from the redirect URL returned by `createSession()`.
+     * Example URL: `/checkout?checkoutToken=abc123&token=eyJ...`
+     */
+    async loadSession(checkoutToken, sessionToken) {
+        if (sessionToken) {
+            this.sessionToken = sessionToken;
+            this.onTokenChange?.(sessionToken);
+        }
+        const raw = await this.http.get(`/api/v1/checkout-sessions/${checkoutToken}/v2`, {
+            params: { skipAsyncWait: 'false' },
+            token: this.sessionToken,
+        });
+        return this.normalizeSession(raw);
+    }
+    /**
+     * Create a new checkout session.
+     *
+     * Returns a `checkoutToken` and `sessionToken` (JWT) needed for all subsequent calls.
+     * Also returns a `checkoutUrl` (the full Tagada-hosted checkout URL, for reference).
+     */
+    async createSession(opts) {
+        const lineItems = opts.items.map((i) => ({
+            variantId: i.variantId,
+            priceId: i.priceId,
+            quantity: i.quantity,
+        }));
+        const body = {
+            storeId: this.storeId,
+            lineItems,
+        };
+        if (opts.currency)
+            body.currency = opts.currency;
+        if (opts.returnUrl)
+            body.returnUrl = opts.returnUrl;
+        if (opts.customerEmail) {
+            body.customer = {
+                email: opts.customerEmail,
+                firstName: opts.customerFirstName,
+                lastName: opts.customerLastName,
+                currency: opts.currency,
+            };
+        }
+        const res = await this.http.post('/api/v1/checkout/session/init', body);
+        // Extract the JWT token from the checkoutUrl query params
+        const url = new URL(res.checkoutUrl);
+        const sessionToken = url.searchParams.get('token') ?? '';
+        this.sessionToken = sessionToken;
+        if (sessionToken)
+            this.onTokenChange?.(sessionToken);
+        return {
+            checkoutUrl: res.checkoutUrl,
+            checkoutToken: res.checkoutToken,
+            sessionToken,
+            customerId: res.customerId,
+        };
+    }
+    /** Replace the cart items for an existing session. */
+    async updateCart(sessionId, items) {
+        return this.http.post(`/api/v1/checkout-sessions/${sessionId}/items`, { items }, { token: this.sessionToken });
+    }
+    /** Update customer information on the session. */
+    async updateCustomer(sessionId, customer) {
+        return this.http.patch(`/api/v1/checkout-sessions/${sessionId}/customer`, { data: customer }, { token: this.sessionToken });
+    }
+    /** Update shipping and/or billing address on the session. */
+    async updateAddress(sessionId, addresses) {
+        return this.http.post(`/api/v1/checkout-sessions/${sessionId}/address`, { data: addresses }, { token: this.sessionToken });
+    }
+    /** Apply a promotion code to the session. */
+    async applyPromoCode(sessionId, code) {
+        return this.http.post(`/api/v1/checkout-sessions/${sessionId}/promo`, { code }, { token: this.sessionToken });
+    }
+    /** Remove the currently applied promotion code. */
+    async removePromoCode(sessionId) {
+        return this.http.delete(`/api/v1/checkout-sessions/${sessionId}/promo`, {
+            token: this.sessionToken,
+        });
+    }
+    /** Fetch available shipping rates for the session's address. */
+    async getShippingRates(sessionId) {
+        const res = await this.http.get(`/api/v1/checkout-sessions/${sessionId}/shipping-rates`, { token: this.sessionToken });
+        return res.rates;
+    }
+    /** Select a shipping rate for the session. */
+    async selectShippingRate(sessionId, rateId) {
+        return this.http.post(`/api/v1/checkout-sessions/${sessionId}/shipping-rates`, { rateId }, { token: this.sessionToken });
+    }
+    /**
+     * Normalize the raw v2 API response into a cleaner CheckoutSession shape.
+     * The raw response has nested `checkoutSession` + `summary` -- we flatten it.
+     */
+    normalizeSession(raw) {
+        const cs = raw.checkoutSession;
+        const orderSummaries = (cs.orderSummaries ?? []);
+        const summary = (raw.summary ?? cs.summary ?? orderSummaries[0] ?? {});
+        const lineItems = (cs.sessionLineItems ?? []);
+        const customer = cs.customer;
+        const items = lineItems.map((li) => {
+            const price = li.price;
+            const variant = (price?.variant ?? {});
+            const product = (variant.product ?? {});
+            const currencyOpts = (price?.currencyOptions ?? {});
+            const usd = currencyOpts.USD ?? currencyOpts[Object.keys(currencyOpts)[0]];
+            return {
+                id: li.id,
+                variantId: li.variantId,
+                priceId: li.priceId,
+                productName: (product.name ?? ''),
+                variantName: (variant.name ?? ''),
+                quantity: (li.quantity ?? 1),
+                unitAmount: usd?.amount ?? 0,
+                totalAmount: (usd?.amount ?? 0) * (li.quantity ?? 1),
+                currency: (cs.selectedPresentmentCurrency ?? 'USD'),
+                imageUrl: (variant.imageUrl ?? ''),
+            };
+        });
+        const summaryItems = (summary.items ?? []);
+        return {
+            id: cs.id,
+            storeId: cs.storeId,
+            checkoutToken: cs.checkoutToken,
+            currency: (cs.selectedPresentmentCurrency ?? 'USD'),
+            items,
+            totals: {
+                subtotal: (summary.subtotalAmount ?? 0),
+                discount: (summary.totalPromotionAmount ?? 0),
+                shipping: (summary.shippingCost ?? 0),
+                tax: (summary.totalTaxAmount ?? 0),
+                total: (summary.totalAmount ?? summaryItems.reduce((s, i) => s + (i.amount ?? 0), 0)),
+                currency: (summary.currency ?? cs.selectedPresentmentCurrency ?? 'USD'),
+            },
+            customer: customer
+                ? {
+                    id: customer.id,
+                    email: customer.email,
+                    firstName: customer.firstName,
+                    lastName: customer.lastName,
+                }
+                : undefined,
+            shippingAddress: cs.shippingAddress,
+            billingAddress: cs.billingAddress,
+            metadata: cs.metadata,
+        };
+    }
+}
+//# sourceMappingURL=checkout.js.map

package/dist/core/modules/checkout.js.map

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

package/dist/core/modules/customer.d.ts

@@ -0,0 +1,33 @@
+import type { HttpClient } from '../http.js';
+import type { Customer, Order, Subscription } from '../types.js';
+/**
+ * Customer data -- profile, orders, subscriptions.
+ *
+ * Requires either an API key or a session token for authentication.
+ */
+export declare class CustomerModule {
+    private readonly http;
+    private readonly storeId;
+    constructor(http: HttpClient, storeId: string);
+    /** Get customer profile by ID. */
+    getProfile(customerId: string): Promise<Customer>;
+    /** Get customer profile by email. */
+    getByEmail(email: string): Promise<Customer | null>;
+    /** Update customer profile fields. */
+    updateProfile(customerId: string, data: Partial<Pick<Customer, 'email' | 'firstName' | 'lastName' | 'phone' | 'metadata'>>): Promise<Customer>;
+    /** List orders for a customer. */
+    getOrders(customerId: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        orders: Order[];
+        total: number;
+    }>;
+    /** Get a single order by ID. */
+    getOrder(orderId: string): Promise<Order>;
+    /** List subscriptions for a customer. */
+    getSubscriptions(customerId: string): Promise<Subscription[]>;
+    /** Get a single subscription by ID. */
+    getSubscription(subscriptionId: string): Promise<Subscription>;
+}
+//# sourceMappingURL=customer.d.ts.map

package/dist/core/modules/customer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.d.ts","sourceRoot":"","sources":["../../../src/core/modules/customer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC,kCAAkC;IAC5B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQvD,qCAAqC;IAC/B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAYzD,sCAAsC;IAChC,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,GACvF,OAAO,CAAC,QAAQ,CAAC;IAQpB,kCAAkC;IAC5B,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAO9C,gCAAgC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAO/C,yCAAyC;IACnC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQnE,uCAAuC;IACjC,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAOrE"}

package/dist/core/modules/customer.js

@@ -0,0 +1,53 @@
+/**
+ * Customer data -- profile, orders, subscriptions.
+ *
+ * Requires either an API key or a session token for authentication.
+ */
+export class CustomerModule {
+    constructor(http, storeId) {
+        this.http = http;
+        this.storeId = storeId;
+    }
+    /** Get customer profile by ID. */
+    async getProfile(customerId) {
+        const res = await this.http.get(`/api/v1/customers/${customerId}`, { params: { storeId: this.storeId } });
+        return res.customer;
+    }
+    /** Get customer profile by email. */
+    async getByEmail(email) {
+        try {
+            const res = await this.http.get('/api/v1/customers/by-email', { params: { email, storeId: this.storeId } });
+            return res.customer;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Update customer profile fields. */
+    async updateProfile(customerId, data) {
+        const res = await this.http.patch(`/api/v1/customers/${customerId}`, { storeId: this.storeId, ...data });
+        return res.customer;
+    }
+    /** List orders for a customer. */
+    async getOrders(customerId, opts) {
+        return this.http.get(`/api/v1/customers/${customerId}/orders`, { params: { storeId: this.storeId, limit: opts?.limit, offset: opts?.offset } });
+    }
+    /** Get a single order by ID. */
+    async getOrder(orderId) {
+        const res = await this.http.get(`/api/v1/orders/${orderId}`, {
+            params: { storeId: this.storeId },
+        });
+        return res.order;
+    }
+    /** List subscriptions for a customer. */
+    async getSubscriptions(customerId) {
+        const res = await this.http.get(`/api/v1/customers/${customerId}/subscriptions`, { params: { storeId: this.storeId } });
+        return res.subscriptions;
+    }
+    /** Get a single subscription by ID. */
+    async getSubscription(subscriptionId) {
+        const res = await this.http.get(`/api/v1/subscriptions/${subscriptionId}`, { params: { storeId: this.storeId } });
+        return res.subscription;
+    }
+}
+//# sourceMappingURL=customer.js.map

package/dist/core/modules/customer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.js","sourceRoot":"","sources":["../../../src/core/modules/customer.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACzB,YACmB,IAAgB,EAChB,OAAe;QADf,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,kCAAkC;IAClC,KAAK,CAAC,UAAU,CAAC,UAAkB;QACjC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,qBAAqB,UAAU,EAAE,EACjC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CACtC,CAAC;QACF,OAAO,GAAG,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,UAAU,CAAC,KAAa;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,4BAA4B,EAC5B,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAC7C,CAAC;YACF,OAAO,GAAG,CAAC,QAAQ,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,aAAa,CACjB,UAAkB,EAClB,IAAwF;QAExF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAC/B,qBAAqB,UAAU,EAAE,EACjC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CACnC,CAAC;QACF,OAAO,GAAG,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,SAAS,CACb,UAAkB,EAClB,IAA0C;QAE1C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,qBAAqB,UAAU,SAAS,EACxC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAChF,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAmB,kBAAkB,OAAO,EAAE,EAAE;YAC7E,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SAClC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,qBAAqB,UAAU,gBAAgB,EAC/C,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CACtC,CAAC;QACF,OAAO,GAAG,CAAC,aAAa,CAAC;IAC3B,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,eAAe,CAAC,cAAsB;QAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,yBAAyB,cAAc,EAAE,EACzC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CACtC,CAAC;QACF,OAAO,GAAG,CAAC,YAAY,CAAC;IAC1B,CAAC;CACF"}