@neowhale/storefront 0.2.30 → 0.2.32

package/dist/react/index.d.cts

@@ -1,11 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { F as WhaleStorefrontConfig, r as Product, P as PaymentData, O as Order, a as CartItem, T as TaxBreakdown, W as WhaleClient, f as Customer, E as EventType, g as CustomerAnalytics, d as CheckoutSession, A as Address, b as Category, c as CategoryTreeNode, l as LoyaltyAccount, m as LoyaltyReward, n as LoyaltyTransaction, v as Review, w as ReviewSummary, G as WishlistItem, R as Recommendation, k as Location, x as ShippingMethod, y as ShippingRate, D as DealValidation, C as Cart, H as ReferralStatus, I as ReferralEnrollment, i as LandingSection, Q as QRLandingData, h as LandingPageRenderData } from '../client-CwCSPAHp.cjs';
+import { F as WhaleStorefrontConfig, r as Product, P as PaymentData, O as Order, a as CartItem, T as TaxBreakdown, W as WhaleClient, f as Customer, E as EventType, g as CustomerAnalytics, d as CheckoutSession, A as Address, b as Category, c as CategoryTreeNode, l as LoyaltyAccount, m as LoyaltyReward, n as LoyaltyTransaction, v as Review, w as ReviewSummary, G as WishlistItem, R as Recommendation, k as Location, x as ShippingMethod, y as ShippingRate, D as DealValidation, C as Cart, H as ReferralStatus, I as ReferralEnrollment, i as LandingSection, Q as QRLandingData, h as LandingPageRenderData } from '../client-CUKv5fMM.cjs';
 import { ThemeTokens } from '@neowhale/ui';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
-import { P as PixelManager } from '../pixel-manager-ti1xc1eC.cjs';
+import { P as PixelManager } from '../pixel-manager-oZStK6GU.cjs';
 
 interface WhaleProviderProps extends WhaleStorefrontConfig {
     children: ReactNode;
@@ -236,6 +236,8 @@ declare function useAnalytics(): {
     trackingEnabled: boolean;
     /** Configured recording sample rate (0–1) for behavioral session replays */
     recordingRate: number;
+    /** Stable visitor ID for cross-session attribution */
+    visitorId: string;
 };
 
 declare function useWhaleClient(): WhaleClient;
@@ -430,8 +432,12 @@ interface LandingPageProps {
     onDataLoaded?: (data: LandingPageRenderData) => void;
     onError?: (error: Error) => void;
     onEvent?: (event: string, data: Record<string, unknown>) => void;
+    analyticsContext?: {
+        visitorId?: string;
+        sessionId?: string;
+    };
 }
-declare function LandingPage({ slug, gatewayUrl, renderSection, onDataLoaded, onError, onEvent, }: LandingPageProps): react_jsx_runtime.JSX.Element | null;
+declare function LandingPage({ slug, gatewayUrl, renderSection, onDataLoaded, onError, onEvent, analyticsContext, }: LandingPageProps): react_jsx_runtime.JSX.Element | null;
 
 interface SectionTheme {
     bg: string;

package/dist/react/index.d.ts

@@ -1,11 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { F as WhaleStorefrontConfig, r as Product, P as PaymentData, O as Order, a as CartItem, T as TaxBreakdown, W as WhaleClient, f as Customer, E as EventType, g as CustomerAnalytics, d as CheckoutSession, A as Address, b as Category, c as CategoryTreeNode, l as LoyaltyAccount, m as LoyaltyReward, n as LoyaltyTransaction, v as Review, w as ReviewSummary, G as WishlistItem, R as Recommendation, k as Location, x as ShippingMethod, y as ShippingRate, D as DealValidation, C as Cart, H as ReferralStatus, I as ReferralEnrollment, i as LandingSection, Q as QRLandingData, h as LandingPageRenderData } from '../client-CwCSPAHp.js';
+import { F as WhaleStorefrontConfig, r as Product, P as PaymentData, O as Order, a as CartItem, T as TaxBreakdown, W as WhaleClient, f as Customer, E as EventType, g as CustomerAnalytics, d as CheckoutSession, A as Address, b as Category, c as CategoryTreeNode, l as LoyaltyAccount, m as LoyaltyReward, n as LoyaltyTransaction, v as Review, w as ReviewSummary, G as WishlistItem, R as Recommendation, k as Location, x as ShippingMethod, y as ShippingRate, D as DealValidation, C as Cart, H as ReferralStatus, I as ReferralEnrollment, i as LandingSection, Q as QRLandingData, h as LandingPageRenderData } from '../client-CUKv5fMM.js';
 import { ThemeTokens } from '@neowhale/ui';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
-import { P as PixelManager } from '../pixel-manager-LiLpBmPy.js';
+import { P as PixelManager } from '../pixel-manager-DsrUxlIB.js';
 
 interface WhaleProviderProps extends WhaleStorefrontConfig {
     children: ReactNode;
@@ -236,6 +236,8 @@ declare function useAnalytics(): {
     trackingEnabled: boolean;
     /** Configured recording sample rate (0–1) for behavioral session replays */
     recordingRate: number;
+    /** Stable visitor ID for cross-session attribution */
+    visitorId: string;
 };
 
 declare function useWhaleClient(): WhaleClient;
@@ -430,8 +432,12 @@ interface LandingPageProps {
     onDataLoaded?: (data: LandingPageRenderData) => void;
     onError?: (error: Error) => void;
     onEvent?: (event: string, data: Record<string, unknown>) => void;
+    analyticsContext?: {
+        visitorId?: string;
+        sessionId?: string;
+    };
 }
-declare function LandingPage({ slug, gatewayUrl, renderSection, onDataLoaded, onError, onEvent, }: LandingPageProps): react_jsx_runtime.JSX.Element | null;
+declare function LandingPage({ slug, gatewayUrl, renderSection, onDataLoaded, onError, onEvent, analyticsContext, }: LandingPageProps): react_jsx_runtime.JSX.Element | null;
 
 interface SectionTheme {
     bg: string;

package/dist/react/index.js

@@ -1,5 +1,5 @@
 import { PixelManager } from '../chunk-MZO7BCGU.js';
-import { resilientSend, WhaleClient } from '../chunk-WNZOA4FB.js';
+import { resilientSend, WhaleClient } from '../chunk-2XODSXJT.js';
 import { createContext, useContext, useRef, useCallback, useEffect, useState, useMemo } from 'react';
 import { usePathname } from 'next/navigation';
 import { createStore } from 'zustand/vanilla';
@@ -553,7 +553,9 @@ function useAnalytics() {
     /** Whether tracking is globally enabled for this storefront */
     trackingEnabled,
     /** Configured recording sample rate (0–1) for behavioral session replays */
-    recordingRate: config.recordingRate
+    recordingRate: config.recordingRate,
+    /** Stable visitor ID for cross-session attribution */
+    visitorId: getVisitorId(config.storagePrefix)
   };
 }
 function useAuth() {
@@ -1864,6 +1866,7 @@ function useCustomerAnalytics() {
 function useCheckout() {
   const ctx = useContext(WhaleContext);
   if (!ctx) throw new Error("useCheckout must be used within <WhaleProvider>");
+  const { visitorId, getOrCreateSession: getAnalyticsSession } = useAnalytics();
   const [session, setSession] = useState(null);
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState(null);
@@ -1871,7 +1874,12 @@ function useCheckout() {
     setLoading(true);
     setError(null);
     try {
-      const data = await ctx.client.createCheckoutSession(params);
+      const analyticsSessionId = await getAnalyticsSession().catch(() => void 0);
+      const data = await ctx.client.createCheckoutSession({
+        ...params,
+        visitor_id: visitorId,
+        session_id: analyticsSessionId?.startsWith("local-") ? void 0 : analyticsSessionId
+      });
       setSession(data);
       return data;
     } catch (err) {
@@ -2900,6 +2908,8 @@ function LeadCaptureSection({ section, data, theme, onEvent }) {
     if (!email || !storeId) return;
     setStatus("loading");
     setErrorMsg("");
+    const urlParams = typeof window !== "undefined" ? new URLSearchParams(window.location.search) : null;
+    const analyticsData = data.analyticsContext;
     try {
       const res = await fetch(`${gatewayUrl}/v1/stores/${storeId}/storefront/leads`, {
         method: "POST",
@@ -2914,7 +2924,13 @@ function LeadCaptureSection({ section, data, theme, onEvent }) {
             const t = [...c.tags || []];
             if (newsletterOptIn) t.push(c.newsletter_tag || "newsletter-subscriber");
             return t.length > 0 ? t : void 0;
-          })()
+          })(),
+          visitor_id: analyticsData?.visitorId || void 0,
+          session_id: analyticsData?.sessionId || void 0,
+          utm_source: urlParams?.get("utm_source") || void 0,
+          utm_medium: urlParams?.get("utm_medium") || void 0,
+          utm_campaign: urlParams?.get("utm_campaign") || void 0,
+          utm_content: urlParams?.get("utm_content") || void 0
         })
       });
       if (!res.ok) {
@@ -3460,7 +3476,8 @@ function LandingPage({
   renderSection,
   onDataLoaded,
   onError,
-  onEvent
+  onEvent,
+  analyticsContext
 }) {
   const [state, setState] = useState("loading");
   const [data, setData] = useState(null);
@@ -3508,13 +3525,14 @@ function LandingPage({
   if (state === "expired") return /* @__PURE__ */ jsx(DefaultExpired2, {});
   if (state === "error") return /* @__PURE__ */ jsx(DefaultError2, { message: errorMsg });
   if (!data) return null;
-  return /* @__PURE__ */ jsx(PageLayout, { data, gatewayUrl, renderSection, onEvent });
+  return /* @__PURE__ */ jsx(PageLayout, { data, gatewayUrl, renderSection, onEvent, analyticsContext });
 }
 function PageLayout({
   data,
   gatewayUrl,
   renderSection,
-  onEvent
+  onEvent,
+  analyticsContext
 }) {
   const { landing_page: lp, store } = data;
   const theme = {
@@ -3529,7 +3547,7 @@ function PageLayout({
   const fontFamily = lp.font_family || theme.fontDisplay || "system-ui, -apple-system, sans-serif";
   const logoUrl = store?.logo_url;
   const sorted = [...lp.sections].sort((a, b) => a.order - b.order);
-  const sectionData = { ...data, gatewayUrl, landing_page: { slug: lp.slug } };
+  const sectionData = { ...data, gatewayUrl, landing_page: { slug: lp.slug }, analyticsContext };
   return /* @__PURE__ */ jsxs("div", { style: { minHeight: "100dvh", background: theme.bg, color: theme.fg, fontFamily }, children: [
     lp.custom_css && /* @__PURE__ */ jsx("style", { children: lp.custom_css }),
     logoUrl && /* @__PURE__ */ jsx("div", { style: { padding: "1.5rem", display: "flex", justifyContent: "center" }, children: /* @__PURE__ */ jsx("img", { src: logoUrl, alt: store?.name || "Store", style: { height: 40, objectFit: "contain" } }) }),