@aranova/tracking-next 0.5.0 → 0.5.1

package/dist/index.js

@@ -254,7 +254,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 {
@@ -263,7 +263,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 {
@@ -271,7 +271,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
@@ -371,6 +371,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;
@@ -450,11 +500,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 {
@@ -567,79 +639,94 @@ var ctaClickMetadataSchema = import_zod2.z.object({
 }).strict();
 var ctaClickConfigSchema = import_zod2.z.object({}).strict();
 
-// ../tracking-core/src/events/form-start.ts
+// ../tracking-core/src/events/sdk-heartbeat.ts
 var import_zod3 = require("zod");
-var formStartMetadataSchema = import_zod3.z.object({
-  form: import_zod3.z.object({
-    id: import_zod3.z.string(),
-    action: import_zod3.z.string().nullable()
-  }),
-  page: import_zod3.z.object({
-    path: import_zod3.z.string()
-  })
+var sdkHeartbeatTriggersSchema = import_zod3.z.object({
+  automatic: import_zod3.z.array(import_zod3.z.string()),
+  manual: import_zod3.z.array(import_zod3.z.string())
 }).strict();
-var formStartConfigSchema = import_zod3.z.object({
-  selector: import_zod3.z.string().optional()
+var sdkHeartbeatMetadataSchema = import_zod3.z.object({
+  sdk_version: import_zod3.z.string(),
+  package_name: import_zod3.z.string().nullable(),
+  surface: import_zod3.z.enum(["next", "react", "script"]),
+  triggers: sdkHeartbeatTriggersSchema,
+  trigger_config: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown())).nullable().optional()
 }).strict();
+var sdkHeartbeatConfigSchema = import_zod3.z.object({}).strict();
 
-// ../tracking-core/src/events/form-submit.ts
+// ../tracking-core/src/events/form-start.ts
 var import_zod4 = require("zod");
-var formSubmitMetadataSchema = import_zod4.z.object({
+var formStartMetadataSchema = import_zod4.z.object({
   form: import_zod4.z.object({
     id: import_zod4.z.string(),
-    action: import_zod4.z.string().nullable(),
-    fields: import_zod4.z.array(
-      import_zod4.z.object({
-        name: import_zod4.z.string(),
-        type: import_zod4.z.string(),
-        label: import_zod4.z.string().nullable(),
-        has_value: import_zod4.z.boolean()
-      })
-    ).optional()
+    action: import_zod4.z.string().nullable()
   }),
   page: import_zod4.z.object({
     path: import_zod4.z.string()
   })
 }).strict();
-var formSubmitConfigSchema = import_zod4.z.object({}).strict();
+var formStartConfigSchema = import_zod4.z.object({
+  selector: import_zod4.z.string().optional()
+}).strict();
 
-// ../tracking-core/src/events/multi-page-session.ts
+// ../tracking-core/src/events/form-submit.ts
 var import_zod5 = require("zod");
-var multiPageSessionMetadataSchema = import_zod5.z.object({
-  page_count: import_zod5.z.number().int().min(2),
+var formSubmitMetadataSchema = import_zod5.z.object({
+  form: import_zod5.z.object({
+    id: import_zod5.z.string(),
+    action: import_zod5.z.string().nullable(),
+    fields: import_zod5.z.array(
+      import_zod5.z.object({
+        name: import_zod5.z.string(),
+        type: import_zod5.z.string(),
+        label: import_zod5.z.string().nullable(),
+        has_value: import_zod5.z.boolean()
+      })
+    ).optional()
+  }),
   page: import_zod5.z.object({
     path: import_zod5.z.string()
   })
 }).strict();
-var multiPageSessionConfigSchema = import_zod5.z.object({
-  pageThreshold: import_zod5.z.number().int().min(2)
-}).strict();
+var formSubmitConfigSchema = import_zod5.z.object({}).strict();
 
-// ../tracking-core/src/events/phone-click.ts
+// ../tracking-core/src/events/multi-page-session.ts
 var import_zod6 = require("zod");
-var phoneClickMetadataSchema = import_zod6.z.object({
-  phone_number: import_zod6.z.string(),
+var multiPageSessionMetadataSchema = import_zod6.z.object({
+  page_count: import_zod6.z.number().int().min(2),
   page: import_zod6.z.object({
     path: import_zod6.z.string()
-  }),
-  section: import_zod6.z.string().nullable().optional()
+  })
+}).strict();
+var multiPageSessionConfigSchema = import_zod6.z.object({
+  pageThreshold: import_zod6.z.number().int().min(2)
 }).strict();
-var phoneClickConfigSchema = import_zod6.z.object({}).strict();
 
-// ../tracking-core/src/events/scroll-depth.ts
+// ../tracking-core/src/events/phone-click.ts
 var import_zod7 = require("zod");
-var scrollDepthMetadataSchema = import_zod7.z.object({
-  depth_percent: import_zod7.z.number().int().min(1).max(100),
+var phoneClickMetadataSchema = import_zod7.z.object({
+  phone_number: import_zod7.z.string(),
   page: import_zod7.z.object({
     path: import_zod7.z.string()
+  }),
+  section: import_zod7.z.string().nullable().optional()
+}).strict();
+var phoneClickConfigSchema = import_zod7.z.object({}).strict();
+
+// ../tracking-core/src/events/scroll-depth.ts
+var import_zod8 = require("zod");
+var scrollDepthMetadataSchema = import_zod8.z.object({
+  depth_percent: import_zod8.z.number().int().min(1).max(100),
+  page: import_zod8.z.object({
+    path: import_zod8.z.string()
   })
 }).strict();
-var scrollDepthConfigSchema = import_zod7.z.object({
-  thresholds: import_zod7.z.array(import_zod7.z.number().int().min(1).max(100)).min(1)
+var scrollDepthConfigSchema = import_zod8.z.object({
+  thresholds: import_zod8.z.array(import_zod8.z.number().int().min(1).max(100)).min(1)
 }).strict();
 
 // ../tracking-core/src/events/specific-page-visit.ts
-var import_zod8 = require("zod");
+var import_zod9 = require("zod");
 var SPECIFIC_PAGE_NAMES = [
   "contact_page",
   "about_page",
@@ -650,18 +737,18 @@ var SPECIFIC_PAGE_NAMES = [
   "faq_page",
   "testimonials_page"
 ];
-var specificPageNameSchema = import_zod8.z.enum(SPECIFIC_PAGE_NAMES);
-var specificPageVisitMetadataSchema = import_zod8.z.object({
+var specificPageNameSchema = import_zod9.z.enum(SPECIFIC_PAGE_NAMES);
+var specificPageVisitMetadataSchema = import_zod9.z.object({
   page_name: specificPageNameSchema,
-  page: import_zod8.z.object({
-    path: import_zod8.z.string()
+  page: import_zod9.z.object({
+    path: import_zod9.z.string()
   })
 }).strict();
-var specificPageVisitConfigSchema = import_zod8.z.object({
-  pages: import_zod8.z.array(
-    import_zod8.z.object({
+var specificPageVisitConfigSchema = import_zod9.z.object({
+  pages: import_zod9.z.array(
+    import_zod9.z.object({
       name: specificPageNameSchema,
-      pathPattern: import_zod8.z.custom((value) => value instanceof RegExp, {
+      pathPattern: import_zod9.z.custom((value) => value instanceof RegExp, {
         message: "pathPattern must be a RegExp"
       })
     })
@@ -669,15 +756,15 @@ var specificPageVisitConfigSchema = import_zod8.z.object({
 }).strict();
 
 // ../tracking-core/src/events/time-on-site.ts
-var import_zod9 = require("zod");
-var timeOnSiteMetadataSchema = import_zod9.z.object({
-  duration_ms: import_zod9.z.number().int().nonnegative(),
-  page: import_zod9.z.object({
-    path: import_zod9.z.string()
+var import_zod10 = require("zod");
+var timeOnSiteMetadataSchema = import_zod10.z.object({
+  duration_ms: import_zod10.z.number().int().nonnegative(),
+  page: import_zod10.z.object({
+    path: import_zod10.z.string()
   })
 }).strict();
-var timeOnSiteConfigSchema = import_zod9.z.object({
-  thresholdSeconds: import_zod9.z.number().int().positive()
+var timeOnSiteConfigSchema = import_zod10.z.object({
+  thresholdSeconds: import_zod10.z.number().int().positive()
 }).strict();
 
 // ../tracking-core/src/events/registry.ts
@@ -713,6 +800,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",
@@ -1055,7 +1148,7 @@ function GoogleAdsTracking({ gtagId }) {
 var import_navigation = require("next/navigation");
 
 // package.json
-var version = "0.5.0";
+var version = "0.5.1";
 
 // src/factory.tsx
 var import_react3 = require("react");
@@ -1095,6 +1188,7 @@ function createTracking(options) {
           surface: "next",
           packageName: "@aranova/tracking-next",
           sdkVersion: version,
+          triggers,
           debug
         }),
         triggers,
@@ -1108,6 +1202,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       fireManualPageView(rawClient);
@@ -1120,6 +1215,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       for (const { name, pathPattern } of specificPageVisitConfig.pages) {
@@ -1141,6 +1237,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       return attachBfcacheRestore(rawClient);
@@ -1152,6 +1249,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       return attachTimeOnSite(rawClient, timeOnSiteConfig);
@@ -1167,7 +1265,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);
@@ -1186,6 +1284,7 @@ function createTracking(options) {
             endpoint,
             surface: "next",
             packageName: "@aranova/tracking-next",
+            triggers,
             debug
           });
           rawClient.trackEvent({
@@ -1208,6 +1307,7 @@ function createTracking(options) {
         endpoint,
         surface: "next",
         packageName: "@aranova/tracking-next",
+        triggers,
         debug
       });
       const scrollDepth = triggers.automatic.scroll_depth;