@proxima-io/storefront-core 0.3.0 → 0.8.2

package/README.md

@@ -188,6 +188,51 @@ const seo = buildPageSeo(composition.seo, website, website.locale, canonicalUrl)
 // seo.title, seo.description, seo.ogImage, seo.canonicalUrl, seo.robots, …
 ```
 
+### `buildCanonicalUrl` / `buildHreflangAlternates`
+
+Helpers for locale-prefix routing (default locale omits prefix; others use `/{locale}{path}`):
+
+```ts
+import { buildCanonicalUrl, buildHreflangAlternates } from "@proxima-io/storefront-core";
+
+const canonical = buildCanonicalUrl(website.domain, locale, "/catalogo", website.default_locale);
+const alternates = buildHreflangAlternates({
+  domain: website.domain,
+  localizedPaths: { es: "/catalogo", en: "/catalog" },
+  enabledLocales: website.enabled_locales,
+  defaultLocale: website.default_locale,
+});
+// → <link rel="canonical" /> + <link rel="alternate" hreflang="…" />
+```
+
+`fetchProximaRender` accepts optional `locale` — forwarded as `?locale=` and `Accept-Language`.
+
+### `buildEnginePageUrl` / `buildEnginePageHreflangAlternates`
+
+For engine pages (`product_detail`, `category_detail`, …) with `{slug}` templates:
+
+```ts
+import {
+  buildEnginePageHreflangAlternates,
+  buildEnginePageUrl,
+} from "@proxima-io/storefront-core";
+
+const paths = { es: "/producto/{slug}", en: "/product/{slug}" };
+const canonical = buildEnginePageUrl(domain, "en", paths, { slug: "g502" }, "es");
+// → https://shop.test/en/product/g502
+
+const alternates = buildEnginePageHreflangAlternates({
+  domain,
+  localizedPaths: paths,
+  enabledLocales: ["es", "en"],
+  defaultLocale: "es",
+  routeParams: { slug: "g502" },
+});
+```
+
+`generateSitemapXml` emits bilingual catalog URLs when `website.pages[]` includes
+`localized_paths` for `product_detail`, `category_detail`, and `brand_detail`.
+
 ### JSON-LD builders (schema.org)
 
 ```ts
@@ -401,8 +446,11 @@ BUYER_AUTH_ERRORS.VERIFY_TOKEN_INVALID    // "VERIFY_TOKEN_INVALID"
 BUYER_AUTH_ERRORS.EMAIL_ALREADY_VERIFIED  // "EMAIL_ALREADY_VERIFIED"
 BUYER_AUTH_ERRORS.EMAIL_TAKEN             // "Email already registered in this store"
 BUYER_AUTH_ERRORS.MISSING_REQUIRED_FIELDS // "MISSING_REQUIRED_FIELDS"
+BUYER_AUTH_ERRORS.CAPTCHA_REQUIRED        // "CAPTCHA_REQUIRED" (Turnstile, HTTP 422)
 ```
 
+**Helper:** `isCaptchaRequiredError(err)` — detecta `{ status: 422, data.detail: CAPTCHA_REQUIRED }` en login, registro y forgot-password.
+
 ---
 
 ## Carrito
@@ -586,29 +634,32 @@ BUYER_COOKIE_OPTIONS      // { path: '/', httpOnly: true, sameSite: 'lax', maxAg
 
 ## Analytics
 
-Cliente client-side con queue automático y flush por batch.
+Cliente singleton con batch, consent GDPR, sesión (`X-Session-ID`) y atribución first-touch (UTMs + click IDs).
+
+**Documentación completa:** [`docs/13-analytics.md`](../../docs/13-analytics.md)
 
 ```ts
 import { analytics } from '@proxima-io/storefront-core';
 
-// En SiteLayout.astro <script> — llamar una sola vez:
-analytics.init({
-  apiUrl: 'https://api.proxima.io',
-  websiteId: 'uuid-website',
-  businessId: 'uuid-negocio',
-  locale: 'es',
-  flushInterval: 3000, // ms (default: 3000)
-  debug: false,
-});
+analytics.init(
+  {
+    apiUrl: 'https://api.proxima.io',
+    websiteId: 'uuid-website',
+    businessId: 'uuid-negocio',
+    locale: 'es',
+    sessionId: 'uuid-cart-session-from-ssr',
+  },
+  { requireAnalyticsConsent: true },
+);
 
-// En cualquier componente client-side:
-analytics.track('product_view', { product_slug: 'titan-mx-pro' });
+analytics.track('product_view', { product_slug: 'titan-mx-pro', price: 199.9 });
 analytics.track('add_to_cart', { product_slug, variant_id: 42, price: 199.90 });
 analytics.track('order_completed', { order_id: 'ord_123', order_total: 399.80 });
-analytics.track('search', { query: 'zapatillas', results_count: 24 });
 ```
 
-- `page_view` se dispara automáticamente al iniciar y en cada `astro:page-load`.
-- Los eventos se encolan y se envían en batch a `POST /api/v1/store/events`.
-- Al cerrar la pestaña (`visibilitychange: hidden`) se usa `navigator.sendBeacon`.
-- Es seguro llamar `analytics.track()` antes de `analytics.init()` — los eventos se reproducen al inicializar.
+- Endpoint: **`POST /api/v1/storefront/events`** con headers `X-Business-ID` + `X-Session-ID`.
+- `page_view` automático en init y `astro:page-load`.
+- Flush periódico + `fetch(..., { keepalive: true })` al ocultar la pestaña.
+- `captureSessionAttribution()` / `getSessionAttribution()` — ver doc § Marketing attribution.
+- Helpers de consent: `acceptAllCookieConsent()`, `isAnalyticsConsentGranted()`, etc.
+- Catálogo completo de eventos (`checkout_started`, `filter_applied`, `promotion_view`, …) en la doc.

package/dist/addresses/address-book.d.ts

@@ -0,0 +1,36 @@
+import type { ProximaApiConfig, ProximaWebsiteResponse } from '../types/cms.js';
+import type { AddressInput, CustomerAddress, UbigeoResult } from '../types/address.js';
+/** Fetch all saved addresses for the authenticated customer. */
+export declare function fetchCustomerAddresses(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
+    token: string;
+}): Promise<CustomerAddress[]>;
+/** Save a new address to the customer's address book. */
+export declare function createCustomerAddress(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
+    token: string;
+    address: AddressInput;
+}): Promise<CustomerAddress>;
+/** Partially update a saved address. Only the fields included in `address` are changed. */
+export declare function updateCustomerAddress(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
+    token: string;
+    addressId: number;
+    address: Partial<AddressInput>;
+}): Promise<CustomerAddress>;
+/** Delete a saved address. Throws if the address does not exist. */
+export declare function deleteCustomerAddress(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
+    token: string;
+    addressId: number;
+}): Promise<void>;
+/** Mark an address as the customer's default. The previous default is unset automatically. */
+export declare function setDefaultAddress(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
+    token: string;
+    addressId: number;
+}): Promise<CustomerAddress>;
+/**
+ * Search Peruvian ubigeo codes (department/province/district) by name.
+ * Use this to power the address form's location selector.
+ * Returns an empty array on error instead of throwing.
+ */
+export declare function searchUbigeo(config: Pick<ProximaApiConfig, "baseUrl">, params: {
+    q: string;
+}): Promise<UbigeoResult[]>;
+//# sourceMappingURL=address-book.d.ts.map

package/dist/addresses/address-book.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-book.d.ts","sourceRoot":"","sources":["../../src/addresses/address-book.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMvF,gEAAgE;AAChE,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,EACpD,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,eAAe,EAAE,CAAC,CAO5B;AAED,yDAAyD;AACzD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,EACpD,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAC/C,OAAO,CAAC,eAAe,CAAC,CAW1B;AAED,2FAA2F;AAC3F,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,EACpD,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CAAE,GAC3E,OAAO,CAAC,eAAe,CAAC,CAW1B;AAED,oEAAoE;AACpE,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,EACpD,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,8FAA8F;AAC9F,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,EACpD,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC,eAAe,CAAC,CAW1B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAMzB"}

package/dist/addresses/address-book.js

@@ -0,0 +1,62 @@
+import { StorefrontEndpoints, createStorefrontClient } from '../api/index.js';
+// ---------------------------------------------------------------------------
+// Address Book
+// ---------------------------------------------------------------------------
+/** Fetch all saved addresses for the authenticated customer. */
+export async function fetchCustomerAddresses(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.buyer.addresses(), {
+        businessId: website.business_id,
+        token: params.token,
+        failPrefix: 'fetchCustomerAddresses failed',
+    });
+}
+/** Save a new address to the customer's address book. */
+export async function createCustomerAddress(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.post(StorefrontEndpoints.buyer.addresses(), params.address, {
+        businessId: website.business_id,
+        token: params.token,
+        failLabel: 'createCustomerAddress failed',
+    });
+}
+/** Partially update a saved address. Only the fields included in `address` are changed. */
+export async function updateCustomerAddress(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.patch(StorefrontEndpoints.buyer.address(params.addressId), params.address, {
+        businessId: website.business_id,
+        token: params.token,
+        failLabel: 'updateCustomerAddress failed',
+    });
+}
+/** Delete a saved address. Throws if the address does not exist. */
+export async function deleteCustomerAddress(config, website, params) {
+    const client = createStorefrontClient(config);
+    await client.delete(StorefrontEndpoints.buyer.address(params.addressId), {
+        businessId: website.business_id,
+        token: params.token,
+        failPrefix: 'deleteCustomerAddress failed',
+    });
+}
+/** Mark an address as the customer's default. The previous default is unset automatically. */
+export async function setDefaultAddress(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.post(StorefrontEndpoints.buyer.defaultAddress(params.addressId), undefined, {
+        businessId: website.business_id,
+        token: params.token,
+        failPrefix: 'setDefaultAddress failed',
+    });
+}
+/**
+ * Search Peruvian ubigeo codes (department/province/district) by name.
+ * Use this to power the address form's location selector.
+ * Returns an empty array on error instead of throwing.
+ */
+export async function searchUbigeo(config, params) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.ubigeos(), {
+        query: { q: params.q },
+        fallback: [],
+    });
+}
+//# sourceMappingURL=address-book.js.map

package/dist/addresses/address-book.js.map

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

package/dist/analytics/analytics.d.ts

@@ -0,0 +1,28 @@
+import type { StorefrontAnalyticsConfig, StorefrontEventPayload, StorefrontEventType } from '../types/analytics.js';
+export interface StorefrontAnalyticsInitOptions {
+    /**
+     * When true, `init()` buffers until the shopper grants analytics consent
+     * (`acceptAllCookieConsent()`). Pair with a cookie banner UI.
+     */
+    requireAnalyticsConsent?: boolean;
+}
+declare class ProximaAnalytics {
+    private config;
+    private pendingConfig;
+    private queue;
+    private preInitQueue;
+    private timer;
+    private initialized;
+    private consentRequired;
+    init(config: StorefrontAnalyticsConfig, options?: StorefrontAnalyticsInitOptions): void;
+    /** Resume init after the shopper grants analytics consent. */
+    resumeFromConsent(): void;
+    private start;
+    track(type: StorefrontEventType, payload?: StorefrontEventPayload): void;
+    flush(beacon?: boolean): void;
+    destroy(): void;
+}
+/** Singleton analytics client. Call `analytics.init()` once from SiteLayout. */
+export declare const analytics: ProximaAnalytics;
+export {};
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpH,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAYD,cAAM,gBAAgB;IACpB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,YAAY,CAA4D;IAChF,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;IAEhC,IAAI,CAAC,MAAM,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,IAAI;IAUvF,8DAA8D;IAC9D,iBAAiB,IAAI,IAAI;IASzB,OAAO,CAAC,KAAK;IAyBb,KAAK,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,GAAE,sBAA2B,GAAG,IAAI;IAwB5E,KAAK,CAAC,MAAM,UAAQ,GAAG,IAAI;IAqB3B,OAAO,IAAI,IAAI;CAUhB;AAED,gFAAgF;AAChF,eAAO,MAAM,SAAS,kBAAyB,CAAC"}

package/dist/analytics/analytics.js

@@ -0,0 +1,124 @@
+import { StorefrontEndpoints } from '../api/endpoints.js';
+import { isAnalyticsConsentGranted, onCookieConsentChanged } from '../cookie-consent/consent.js';
+import { getSessionAttribution, captureSessionAttribution } from './attribution.js';
+import { resolveAnalyticsSessionId } from './session.js';
+class ProximaAnalytics {
+    config = null;
+    pendingConfig = null;
+    queue = [];
+    preInitQueue = [];
+    timer = null;
+    initialized = false;
+    consentRequired = false;
+    init(config, options) {
+        if (typeof window === 'undefined')
+            return;
+        if (options?.requireAnalyticsConsent) {
+            this.consentRequired = true;
+            this.pendingConfig = config;
+            if (!isAnalyticsConsentGranted())
+                return;
+        }
+        this.start(config);
+    }
+    /** Resume init after the shopper grants analytics consent. */
+    resumeFromConsent() {
+        if (typeof window === 'undefined')
+            return;
+        if (this.initialized)
+            return;
+        if (!this.consentRequired || !isAnalyticsConsentGranted())
+            return;
+        const config = this.pendingConfig ?? this.config;
+        if (!config)
+            return;
+        this.start(config);
+    }
+    start(config) {
+        if (typeof window === 'undefined')
+            return;
+        this.config = config;
+        this.pendingConfig = null;
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        captureSessionAttribution();
+        for (const [type, payload] of this.preInitQueue.splice(0)) {
+            this.track(type, payload);
+        }
+        const firePageView = () => this.track('page_view');
+        firePageView();
+        document.addEventListener('astro:page-load', firePageView);
+        const interval = config.flushInterval ?? 3000;
+        this.timer = setInterval(() => this.flush(), interval);
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden')
+                this.flush(true);
+        });
+    }
+    track(type, payload = {}) {
+        if (typeof window === 'undefined')
+            return;
+        if (!this.config) {
+            this.preInitQueue.push([type, payload]);
+            return;
+        }
+        const attribution = getSessionAttribution();
+        const hasAttribution = Object.keys(attribution).length > 0;
+        const mergedPayload = hasAttribution
+            ? { ...payload, attribution }
+            : payload;
+        const event = {
+            event_type: type,
+            occurred_at: new Date().toISOString(),
+            website_id: this.config.websiteId,
+            path: window.location.pathname,
+            referrer: document.referrer || undefined,
+            locale: this.config.locale,
+            payload: mergedPayload,
+        };
+        this.queue.push(event);
+        if (this.config.debug)
+            console.debug('[proxima:analytics] queued', event);
+    }
+    flush(beacon = false) {
+        if (!this.config || this.queue.length === 0)
+            return;
+        const batch = this.queue.splice(0);
+        const url = `${this.config.apiUrl.replace(/\/$/, '')}${StorefrontEndpoints.analytics.events()}`;
+        const body = JSON.stringify({ events: batch });
+        const sessionId = resolveAnalyticsSessionId(this.config);
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Business-ID': this.config.businessId,
+            'X-Session-ID': sessionId,
+        };
+        if (this.config.debug) {
+            console.debug(`[proxima:analytics] flushing ${batch.length} event(s) → ${url}`);
+        }
+        void fetch(url, { method: 'POST', headers, body, keepalive: true }).catch(() => {
+            if (beacon)
+                this.queue.unshift(...batch);
+        });
+    }
+    destroy() {
+        if (this.timer !== null)
+            clearInterval(this.timer);
+        this.timer = null;
+        this.initialized = false;
+        this.consentRequired = false;
+        this.pendingConfig = null;
+        this.config = null;
+        this.queue = [];
+        this.preInitQueue = [];
+    }
+}
+/** Singleton analytics client. Call `analytics.init()` once from SiteLayout. */
+export const analytics = new ProximaAnalytics();
+if (typeof window !== 'undefined') {
+    onCookieConsentChanged((state) => {
+        if (state.analytics)
+            analytics.resumeFromConsent();
+    });
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics/analytics.js.map

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

package/dist/analytics/attribution.d.ts

@@ -0,0 +1,28 @@
+/** Session-scoped first-touch marketing attribution (UTMs + ad click IDs). */
+export declare const ATTRIBUTION_STORAGE_KEY = "pxa_session_attribution";
+export interface SessionAttribution {
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_content?: string;
+    utm_term?: string;
+    gclid?: string;
+    fbclid?: string;
+    msclkid?: string;
+    /** Path + query of the landing hit in this tab session. */
+    landing_path?: string;
+    /** document.referrer on the landing hit. */
+    landing_referrer?: string;
+}
+/** Best-effort channel guess when paid UTMs are absent (organic/social/direct). */
+export declare function inferAttributionFromReferrer(referrer: string): Partial<SessionAttribution>;
+/**
+ * Capture first-touch attribution for the current browser tab session.
+ * UTMs / click IDs from the landing URL win; subsequent navigations keep the snapshot.
+ */
+export declare function captureSessionAttribution(): SessionAttribution;
+/** Returns the stored session attribution (capturing on first call). */
+export declare function getSessionAttribution(): SessionAttribution;
+/** Test helper — clears stored attribution. */
+export declare function clearSessionAttribution(): void;
+//# sourceMappingURL=attribution.d.ts.map

package/dist/analytics/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../src/analytics/attribution.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA+CD,mFAAmF;AACnF,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkB1F;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,kBAAkB,CAuB9D;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED,+CAA+C;AAC/C,wBAAgB,uBAAuB,IAAI,IAAI,CAO9C"}

package/dist/analytics/attribution.js

@@ -0,0 +1,116 @@
+/** Session-scoped first-touch marketing attribution (UTMs + ad click IDs). */
+export const ATTRIBUTION_STORAGE_KEY = 'pxa_session_attribution';
+const UTM_KEYS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_content', 'utm_term'];
+const CLICK_ID_KEYS = ['gclid', 'fbclid', 'msclkid'];
+const MAX_VALUE_LEN = 256;
+function trimValue(raw) {
+    const value = raw?.trim();
+    if (!value)
+        return undefined;
+    return value.length > MAX_VALUE_LEN ? value.slice(0, MAX_VALUE_LEN) : value;
+}
+function readStored() {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        const raw = window.localStorage?.getItem(ATTRIBUTION_STORAGE_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeStored(value) {
+    if (typeof window === 'undefined' || !window.localStorage)
+        return;
+    try {
+        window.localStorage.setItem(ATTRIBUTION_STORAGE_KEY, JSON.stringify(value));
+    }
+    catch {
+        /* private mode */
+    }
+}
+function readFromSearchParams(search) {
+    const out = {};
+    for (const key of UTM_KEYS) {
+        const value = trimValue(search.get(key));
+        if (value)
+            out[key] = value;
+    }
+    for (const key of CLICK_ID_KEYS) {
+        const value = trimValue(search.get(key));
+        if (value)
+            out[key] = value;
+    }
+    return out;
+}
+/** Best-effort channel guess when paid UTMs are absent (organic/social/direct). */
+export function inferAttributionFromReferrer(referrer) {
+    if (!referrer.trim())
+        return {};
+    try {
+        const host = new URL(referrer).hostname.replace(/^www\./i, '').toLowerCase();
+        if (host === 't.co' || host.endsWith('.twitter.com') || host === 'twitter.com' || host === 'x.com') {
+            return { utm_source: 'twitter', utm_medium: 'social' };
+        }
+        if (host.includes('google.'))
+            return { utm_source: 'google', utm_medium: 'organic' };
+        if (host.includes('facebook.com') || host.includes('instagram.com') || host.includes('l.facebook.com')) {
+            return { utm_source: 'facebook', utm_medium: 'social' };
+        }
+        if (host.includes('bing.com'))
+            return { utm_source: 'bing', utm_medium: 'organic' };
+        if (host.includes('tiktok.com'))
+            return { utm_source: 'tiktok', utm_medium: 'social' };
+        if (host.includes('youtube.com'))
+            return { utm_source: 'youtube', utm_medium: 'social' };
+        return { utm_source: host, utm_medium: 'referral' };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Capture first-touch attribution for the current browser tab session.
+ * UTMs / click IDs from the landing URL win; subsequent navigations keep the snapshot.
+ */
+export function captureSessionAttribution() {
+    if (typeof window === 'undefined')
+        return {};
+    const stored = readStored();
+    if (stored)
+        return stored;
+    const href = window.location.href;
+    const url = new URL(href);
+    const fromUrl = readFromSearchParams(url.searchParams);
+    const landingReferrer = document.referrer?.trim() || undefined;
+    const attribution = {
+        landing_path: `${url.pathname}${url.search}`,
+        landing_referrer: landingReferrer,
+        ...fromUrl,
+    };
+    if (!attribution.utm_source && landingReferrer) {
+        Object.assign(attribution, inferAttributionFromReferrer(landingReferrer));
+    }
+    writeStored(attribution);
+    return attribution;
+}
+/** Returns the stored session attribution (capturing on first call). */
+export function getSessionAttribution() {
+    return captureSessionAttribution();
+}
+/** Test helper — clears stored attribution. */
+export function clearSessionAttribution() {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.localStorage.removeItem(ATTRIBUTION_STORAGE_KEY);
+    }
+    catch {
+        /* ignore */
+    }
+}
+//# sourceMappingURL=attribution.js.map

package/dist/analytics/attribution.js.map

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

package/dist/analytics/session.d.ts

@@ -0,0 +1,12 @@
+import type { StorefrontAnalyticsConfig } from '../types/analytics.js';
+export declare const ANALYTICS_SESSION_STORAGE_KEY = "pxa_analytics_session";
+export interface ResolveAnalyticsSessionIdOptions {
+    cookieName?: string;
+    storageKey?: string;
+}
+/**
+ * Resolve the browser session id sent as `X-Session-ID` on analytics batches.
+ * Priority: config.sessionId → config.getSessionId() → readable cart cookie → localStorage UUID.
+ */
+export declare function resolveAnalyticsSessionId(config?: Pick<StorefrontAnalyticsConfig, 'sessionId' | 'getSessionId' | 'cartSessionCookieName'>, options?: ResolveAnalyticsSessionIdOptions): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/analytics/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/analytics/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvE,eAAO,MAAM,6BAA6B,0BAA0B,CAAC;AAsCrE,MAAM,WAAW,gCAAgC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,WAAW,GAAG,cAAc,GAAG,uBAAuB,CAAC,EAChG,OAAO,CAAC,EAAE,gCAAgC,GACzC,MAAM,CAuBR"}

package/dist/analytics/session.js

@@ -0,0 +1,62 @@
+export const ANALYTICS_SESSION_STORAGE_KEY = 'pxa_analytics_session';
+const DEFAULT_CART_SESSION_COOKIE = 'cart_session_id';
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function isBrowser() {
+    return typeof window !== 'undefined';
+}
+function readCookie(name) {
+    if (!isBrowser())
+        return null;
+    const prefix = `${name}=`;
+    for (const part of document.cookie.split(';')) {
+        const trimmed = part.trim();
+        if (trimmed.startsWith(prefix)) {
+            return decodeURIComponent(trimmed.slice(prefix.length));
+        }
+    }
+    return null;
+}
+function isUuid(value) {
+    return UUID_RE.test(value);
+}
+function createSessionId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Resolve the browser session id sent as `X-Session-ID` on analytics batches.
+ * Priority: config.sessionId → config.getSessionId() → readable cart cookie → localStorage UUID.
+ */
+export function resolveAnalyticsSessionId(config, options) {
+    const explicit = config?.sessionId?.trim();
+    if (explicit && isUuid(explicit))
+        return explicit;
+    const fromGetter = config?.getSessionId?.()?.trim();
+    if (fromGetter && isUuid(fromGetter))
+        return fromGetter;
+    const cookieName = config?.cartSessionCookieName ?? options?.cookieName ?? DEFAULT_CART_SESSION_COOKIE;
+    const fromCookie = readCookie(cookieName)?.trim();
+    if (fromCookie && isUuid(fromCookie))
+        return fromCookie;
+    if (!isBrowser())
+        return createSessionId();
+    const storageKey = options?.storageKey ?? ANALYTICS_SESSION_STORAGE_KEY;
+    try {
+        const stored = localStorage.getItem(storageKey)?.trim();
+        if (stored && isUuid(stored))
+            return stored;
+        const created = createSessionId();
+        localStorage.setItem(storageKey, created);
+        return created;
+    }
+    catch {
+        return createSessionId();
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/analytics/session.js.map

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