@aranova/tracking-next 0.5.0 → 0.6.0

package/dist/index.mjs

@@ -206,7 +206,7 @@ function getVisitorId() {
 }
 function getOrRotateSessionId(now = Date.now()) {
   if (typeof window === "undefined")
-    return safeUuid();
+    return { id: safeUuid(), isNew: true };
   const raw = readLocalStorage(SESSION_STORAGE_KEY);
   if (raw) {
     try {
@@ -215,7 +215,7 @@ function getOrRotateSessionId(now = Date.now()) {
         if (now - parsed.last_event_at <= SESSION_IDLE_MS) {
           const refreshed = { id: parsed.id, last_event_at: now };
           writeLocalStorage(SESSION_STORAGE_KEY, JSON.stringify(refreshed));
-          return parsed.id;
+          return { id: parsed.id, isNew: false };
         }
       }
     } catch {
@@ -223,7 +223,7 @@ function getOrRotateSessionId(now = Date.now()) {
   }
   const fresh = { id: safeUuid(), last_event_at: now };
   writeLocalStorage(SESSION_STORAGE_KEY, JSON.stringify(fresh));
-  return fresh.id;
+  return { id: fresh.id, isNew: true };
 }
 
 // ../tracking-core/src/events/page-view.ts
@@ -234,7 +234,7 @@ var pageViewMetadataSchema = z.object({
     path: z.string(),
     search: z.string(),
     hash: z.string()
-  }),
+  }).strict(),
   referrer: z.string().nullable(),
   // `.nullable().optional()` — absent (undefined) OR explicit null OR a
   // real viewport object. Mirrors Pydantic's `_Viewport | None = None`
@@ -242,7 +242,7 @@ var pageViewMetadataSchema = z.object({
   viewport: z.object({
     w: z.number(),
     h: z.number()
-  }).nullable().optional()
+  }).strict().nullable().optional()
 }).strict();
 var pageViewConfigSchema = z.object({}).strict();
 
@@ -323,6 +323,56 @@ function attachBfcacheRestore(client) {
   };
 }
 
+// ../tracking-core/src/heartbeat.ts
+function serializeValue(value) {
+  if (value instanceof RegExp) return value.source;
+  if (Array.isArray(value)) return value.map(serializeValue);
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = serializeValue(v);
+    }
+    return out;
+  }
+  return value;
+}
+function buildHeartbeatMetadata(surface, sdkVersion, packageName, triggers) {
+  const automaticNames = triggers ? Object.keys(triggers.automatic) : [];
+  const manualNames = triggers?.manual ? Object.keys(triggers.manual) : [];
+  let triggerConfig = null;
+  if (triggers) {
+    const cfg = {};
+    for (const [name, config] of Object.entries(triggers.automatic)) {
+      const serialized = serializeValue(config);
+      if (Object.keys(serialized).length > 0) {
+        cfg[name] = serialized;
+      }
+    }
+    if (triggers.manual) {
+      for (const [name, config] of Object.entries(triggers.manual)) {
+        if (config === void 0) continue;
+        const serialized = serializeValue(config);
+        if (Object.keys(serialized).length > 0) {
+          cfg[name] = serialized;
+        }
+      }
+    }
+    if (Object.keys(cfg).length > 0) {
+      triggerConfig = cfg;
+    }
+  }
+  return {
+    sdk_version: sdkVersion ?? "unknown",
+    package_name: packageName,
+    surface,
+    triggers: {
+      automatic: automaticNames,
+      manual: manualNames
+    },
+    trigger_config: triggerConfig
+  };
+}
+
 // ../tracking-core/src/ingest.ts
 var DEFAULT_FLUSH_INTERVAL_MS = 2e3;
 var DEFAULT_MAX_QUEUE_SIZE = 10;
@@ -402,11 +452,33 @@ function createTrackingClient(config) {
   let firstPage = null;
   let destroyed = false;
   const visitorId = getVisitorId();
-  let sessionId = getOrRotateSessionId();
+  const initialSession = getOrRotateSessionId();
+  let sessionId = initialSession.id;
   if (typeof window !== "undefined")
     firstPage = window.location.href;
+  function enqueueHeartbeat() {
+    const metadata = buildHeartbeatMetadata(
+      config.surface,
+      sdkVersion,
+      packageName,
+      config.triggers ?? null
+    );
+    queue.push({
+      event_type: "sdk_heartbeat",
+      page_url: typeof window === "undefined" ? null : window.location.href,
+      metadata,
+      occurred_at: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  if (initialSession.isNew) {
+    enqueueHeartbeat();
+  }
   function buildSessionPayload() {
-    sessionId = getOrRotateSessionId();
+    const rotated = getOrRotateSessionId();
+    if (rotated.isNew && rotated.id !== sessionId) {
+      enqueueHeartbeat();
+    }
+    sessionId = rotated.id;
     const params = readTrackingParams();
     const context = buildContext(config.surface, sdkVersion, packageName);
     return {
@@ -513,85 +585,110 @@ var ctaClickMetadataSchema = z2.object({
   cta_name: z2.string(),
   page: z2.object({
     path: z2.string()
-  }),
+  }).strict(),
   section: z2.string().nullable().optional(),
   destination_url: z2.string().nullable().optional()
 }).strict();
 var ctaClickConfigSchema = z2.object({}).strict();
 
-// ../tracking-core/src/events/form-start.ts
+// ../tracking-core/src/events/sdk-heartbeat.ts
 import { z as z3 } from "zod";
-var formStartMetadataSchema = z3.object({
-  form: z3.object({
-    id: z3.string(),
-    action: z3.string().nullable()
-  }),
-  page: z3.object({
-    path: z3.string()
-  })
+var sdkHeartbeatTriggersSchema = z3.object({
+  automatic: z3.array(z3.string()),
+  manual: z3.array(z3.string())
 }).strict();
-var formStartConfigSchema = z3.object({
-  selector: z3.string().optional()
+var sdkHeartbeatMetadataSchema = z3.object({
+  sdk_version: z3.string(),
+  package_name: z3.string().nullable(),
+  surface: z3.enum(["next", "react", "script"]),
+  triggers: sdkHeartbeatTriggersSchema,
+  trigger_config: z3.record(z3.string(), z3.record(z3.string(), z3.unknown())).nullable().optional()
 }).strict();
+var sdkHeartbeatConfigSchema = z3.object({}).strict();
 
-// ../tracking-core/src/events/form-submit.ts
+// ../tracking-core/src/events/form-start.ts
 import { z as z4 } from "zod";
-var formSubmitMetadataSchema = z4.object({
+var formStartMetadataSchema = z4.object({
   form: z4.object({
     id: z4.string(),
-    action: z4.string().nullable(),
-    fields: z4.array(
-      z4.object({
-        name: z4.string(),
-        type: z4.string(),
-        label: z4.string().nullable(),
-        has_value: z4.boolean()
-      })
-    ).optional()
-  }),
+    action: z4.string().nullable()
+  }).strict(),
   page: z4.object({
     path: z4.string()
-  })
+  }).strict()
+}).strict();
+var formStartConfigSchema = z4.object({
+  selector: z4.string().optional()
 }).strict();
-var formSubmitConfigSchema = z4.object({}).strict();
 
-// ../tracking-core/src/events/multi-page-session.ts
+// ../tracking-core/src/events/form-submit.ts
 import { z as z5 } from "zod";
-var multiPageSessionMetadataSchema = z5.object({
-  page_count: z5.number().int().min(2),
+var jsonValueSchema = z5.lazy(
+  () => z5.union([
+    z5.string(),
+    z5.number().finite(),
+    z5.boolean(),
+    z5.null(),
+    z5.array(jsonValueSchema),
+    z5.record(jsonValueSchema)
+  ])
+);
+var formSubmitMetadataSchema = z5.object({
+  form: z5.object({
+    id: z5.string(),
+    action: z5.string().nullable(),
+    fields: z5.array(
+      z5.object({
+        name: z5.string(),
+        type: z5.string(),
+        label: z5.string().nullable(),
+        value: jsonValueSchema
+      }).strict()
+    ).optional()
+  }).strict(),
   page: z5.object({
     path: z5.string()
-  })
-}).strict();
-var multiPageSessionConfigSchema = z5.object({
-  pageThreshold: z5.number().int().min(2)
+  }).strict()
 }).strict();
+var formSubmitConfigSchema = z5.object({}).strict();
 
-// ../tracking-core/src/events/phone-click.ts
+// ../tracking-core/src/events/multi-page-session.ts
 import { z as z6 } from "zod";
-var phoneClickMetadataSchema = z6.object({
-  phone_number: z6.string(),
+var multiPageSessionMetadataSchema = z6.object({
+  page_count: z6.number().int().min(2),
   page: z6.object({
     path: z6.string()
-  }),
-  section: z6.string().nullable().optional()
+  }).strict()
+}).strict();
+var multiPageSessionConfigSchema = z6.object({
+  pageThreshold: z6.number().int().min(2)
 }).strict();
-var phoneClickConfigSchema = z6.object({}).strict();
 
-// ../tracking-core/src/events/scroll-depth.ts
+// ../tracking-core/src/events/phone-click.ts
 import { z as z7 } from "zod";
-var scrollDepthMetadataSchema = z7.object({
-  depth_percent: z7.number().int().min(1).max(100),
+var phoneClickMetadataSchema = z7.object({
+  phone_number: z7.string(),
   page: z7.object({
     path: z7.string()
-  })
+  }).strict(),
+  section: z7.string().nullable().optional()
 }).strict();
-var scrollDepthConfigSchema = z7.object({
-  thresholds: z7.array(z7.number().int().min(1).max(100)).min(1)
+var phoneClickConfigSchema = z7.object({}).strict();
+
+// ../tracking-core/src/events/scroll-depth.ts
+import { z as z8 } from "zod";
+var scrollDepthMetadataSchema = z8.object({
+  depth_percent: z8.number().int().min(1).max(100),
+  page: z8.object({
+    path: z8.string()
+  }).strict()
+}).strict();
+var scrollDepthConfigSchema = z8.object({
+  thresholds: z8.array(z8.number().int().min(1).max(100)).min(1)
 }).strict();
 
 // ../tracking-core/src/events/specific-page-visit.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var SPECIFIC_PAGE_NAMES = [
   "contact_page",
   "about_page",
@@ -602,34 +699,34 @@ var SPECIFIC_PAGE_NAMES = [
   "faq_page",
   "testimonials_page"
 ];
-var specificPageNameSchema = z8.enum(SPECIFIC_PAGE_NAMES);
-var specificPageVisitMetadataSchema = z8.object({
+var specificPageNameSchema = z9.enum(SPECIFIC_PAGE_NAMES);
+var specificPageVisitMetadataSchema = z9.object({
   page_name: specificPageNameSchema,
-  page: z8.object({
-    path: z8.string()
-  })
+  page: z9.object({
+    path: z9.string()
+  }).strict()
 }).strict();
-var specificPageVisitConfigSchema = z8.object({
-  pages: z8.array(
-    z8.object({
+var specificPageVisitConfigSchema = z9.object({
+  pages: z9.array(
+    z9.object({
       name: specificPageNameSchema,
-      pathPattern: z8.custom((value) => value instanceof RegExp, {
+      pathPattern: z9.custom((value) => value instanceof RegExp, {
         message: "pathPattern must be a RegExp"
       })
-    })
+    }).strict()
   ).min(1)
 }).strict();
 
 // ../tracking-core/src/events/time-on-site.ts
-import { z as z9 } from "zod";
-var timeOnSiteMetadataSchema = z9.object({
-  duration_ms: z9.number().int().nonnegative(),
-  page: z9.object({
-    path: z9.string()
-  })
+import { z as z10 } from "zod";
+var timeOnSiteMetadataSchema = z10.object({
+  duration_ms: z10.number().int().nonnegative(),
+  page: z10.object({
+    path: z10.string()
+  }).strict()
 }).strict();
-var timeOnSiteConfigSchema = z9.object({
-  thresholdSeconds: z9.number().int().positive()
+var timeOnSiteConfigSchema = z10.object({
+  thresholdSeconds: z10.number().int().positive()
 }).strict();
 
 // ../tracking-core/src/events/registry.ts
@@ -665,6 +762,12 @@ var EVENT_REGISTRY = {
     metadataSchema: formStartMetadataSchema,
     configSchema: formStartConfigSchema
   },
+  // --- SDK-internal automatic (not consumer-configurable) ---
+  sdk_heartbeat: {
+    kind: "automatic",
+    metadataSchema: sdkHeartbeatMetadataSchema,
+    configSchema: sdkHeartbeatConfigSchema
+  },
   // --- manual triggers ---
   form_submit: {
     kind: "manual",
@@ -1007,7 +1110,7 @@ function GoogleAdsTracking({ gtagId }) {
 import { usePathname, useSearchParams } from "next/navigation";
 
 // package.json
-var version = "0.5.0";
+var version = "0.6.0";
 
 // src/factory.tsx
 import {
@@ -1053,6 +1156,7 @@ function createTracking(options) {
           surface: "next",
           packageName: "@aranova/tracking-next",
           sdkVersion: version,
+          triggers,
           debug
         }),
         triggers,
@@ -1066,6 +1170,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       fireManualPageView(rawClient);
@@ -1078,6 +1183,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       for (const { name, pathPattern } of specificPageVisitConfig.pages) {
@@ -1099,6 +1205,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       return attachBfcacheRestore(rawClient);
@@ -1110,6 +1217,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       return attachTimeOnSite(rawClient, timeOnSiteConfig);
@@ -1125,7 +1233,7 @@ function createTracking(options) {
       const MPS_FIRED_KEY = "aranova_tracking_mps_fired";
       try {
         const store = window.sessionStorage;
-        const currentSession = getOrRotateSessionId();
+        const currentSession = getOrRotateSessionId().id;
         const storedSession = store.getItem(MPS_SESSION_KEY);
         if (storedSession !== currentSession) {
           store.setItem(MPS_SESSION_KEY, currentSession);
@@ -1144,6 +1252,7 @@ function createTracking(options) {
             endpoint,
             surface: "next",
             packageName: "@aranova/tracking-next",
+            triggers,
             debug
           });
           rawClient.trackEvent({
@@ -1166,6 +1275,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       const scrollDepth = triggers.automatic.scroll_depth;