@neowhale/storefront 0.2.30 → 0.2.31

package/dist/react/index.d.cts

@@ -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

@@ -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

@@ -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() {
@@ -2900,6 +2902,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 +2918,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 +3470,8 @@ function LandingPage({
   renderSection,
   onDataLoaded,
   onError,
-  onEvent
+  onEvent,
+  analyticsContext
 }) {
   const [state, setState] = useState("loading");
   const [data, setData] = useState(null);
@@ -3508,13 +3519,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 +3541,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" } }) }),