@aranova/tracking-next 0.2.3 → 0.4.0

package/dist/server.d.mts

@@ -1 +1,5 @@
-export { g as getTrackingParamsServer } from './server-BMTa7njW.mjs';
+import { b as TrackingParams } from './types-Gp0ioRiQ.mjs';
+
+declare function getTrackingParamsServer(): TrackingParams;
+
+export { getTrackingParamsServer };

package/dist/server.d.ts

@@ -1 +1,5 @@
-export { g as getTrackingParamsServer } from './server-BMTa7njW.js';
+import { b as TrackingParams } from './types-Gp0ioRiQ.js';
+
+declare function getTrackingParamsServer(): TrackingParams;
+
+export { getTrackingParamsServer };

package/dist/server.js

@@ -57,6 +57,118 @@ function getTrackingParamsFromCookieReader(readCookie) {
   }, createEmptyTrackingParams());
 }
 
+// ../tracking-core/src/session.ts
+var SESSION_IDLE_MS = 30 * 60 * 1e3;
+
+// ../tracking-core/src/events/page-view.ts
+var import_zod = require("zod");
+var pageViewMetadataSchema = import_zod.z.object({
+  page: import_zod.z.object({
+    title: import_zod.z.string().nullable(),
+    path: import_zod.z.string(),
+    search: import_zod.z.string(),
+    hash: import_zod.z.string()
+  }),
+  referrer: import_zod.z.string().nullable(),
+  // `.nullable().optional()` — absent (undefined) OR explicit null OR a
+  // real viewport object. Mirrors Pydantic's `_Viewport | None = None`
+  // on the backend side so the drift test stays clean.
+  viewport: import_zod.z.object({
+    w: import_zod.z.number(),
+    h: import_zod.z.number()
+  }).nullable().optional()
+}).strict();
+var pageViewConfigSchema = import_zod.z.object({}).strict();
+
+// ../tracking-core/src/events/contact-page-visit.ts
+var import_zod2 = require("zod");
+var contactPageVisitMetadataSchema = import_zod2.z.object({
+  page: import_zod2.z.object({
+    path: import_zod2.z.string()
+  })
+}).strict();
+var contactPageVisitConfigSchema = import_zod2.z.object({
+  // RegExp is runtime-only so we wrap it via z.custom. Consumers pass a
+  // real regex at createTracking() time; the factory validates with this
+  // schema and then keeps the live RegExp reference for runtime matching.
+  pathPattern: import_zod2.z.custom(
+    (value) => value instanceof RegExp,
+    { message: "pathPattern must be a RegExp" }
+  )
+}).strict();
+
+// ../tracking-core/src/events/form-submit.ts
+var import_zod3 = require("zod");
+var formSubmitMetadataSchema = 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()
+  })
+}).strict();
+var formSubmitConfigSchema = import_zod3.z.object({}).strict();
+
+// ../tracking-core/src/events/phone-click.ts
+var import_zod4 = require("zod");
+var phoneClickMetadataSchema = import_zod4.z.object({
+  element: import_zod4.z.object({
+    tag: import_zod4.z.string(),
+    text: import_zod4.z.string().nullable(),
+    href: import_zod4.z.string()
+  }),
+  page: import_zod4.z.object({
+    path: import_zod4.z.string()
+  })
+}).strict();
+var phoneClickConfigSchema = import_zod4.z.object({}).strict();
+
+// ../tracking-core/src/events/time-on-site.ts
+var import_zod5 = require("zod");
+var timeOnSiteMetadataSchema = import_zod5.z.object({
+  duration_ms: import_zod5.z.number().int().nonnegative(),
+  page: import_zod5.z.object({
+    path: import_zod5.z.string()
+  })
+}).strict();
+var timeOnSiteConfigSchema = import_zod5.z.object({
+  thresholdSeconds: import_zod5.z.number().int().positive()
+}).strict();
+
+// ../tracking-core/src/events/registry.ts
+var EVENT_REGISTRY = {
+  // --- automatic triggers ---
+  page_view: {
+    kind: "automatic",
+    metadataSchema: pageViewMetadataSchema,
+    configSchema: pageViewConfigSchema
+  },
+  time_on_site: {
+    kind: "automatic",
+    metadataSchema: timeOnSiteMetadataSchema,
+    configSchema: timeOnSiteConfigSchema
+  },
+  contact_page_visit: {
+    kind: "automatic",
+    metadataSchema: contactPageVisitMetadataSchema,
+    configSchema: contactPageVisitConfigSchema
+  },
+  // --- manual triggers ---
+  form_submit: {
+    kind: "manual",
+    metadataSchema: formSubmitMetadataSchema,
+    configSchema: formSubmitConfigSchema
+  },
+  phone_click: {
+    kind: "manual",
+    metadataSchema: phoneClickMetadataSchema,
+    configSchema: phoneClickConfigSchema
+  }
+};
+var ALL_AUTOMATIC_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "automatic").map(([name]) => name);
+var ALL_MANUAL_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "manual").map(([name]) => name);
+
 // src/server.ts
 function getCookieStore() {
   return (0, import_headers.cookies)();

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts","../../tracking-core/src/tracking.ts"],"sourcesContent":["import 'server-only';\n\nimport { cookies } from 'next/headers';\n\nimport { getTrackingParamsFromCookieReader, type TrackingParams } from '../../tracking-core/src/index';\n\ninterface CookieValue {\n  value: string;\n}\n\ninterface CookieStore {\n  get(name: string): CookieValue | undefined;\n}\n\nfunction getCookieStore(): CookieStore {\n  return cookies() as unknown as CookieStore;\n}\n\nexport function getTrackingParamsServer(): TrackingParams {\n  const cookieStore = getCookieStore();\n  return getTrackingParamsFromCookieReader((key) => cookieStore.get(key)?.value);\n}\n","import type { TrackingParams } from './types';\n\nexport const TRACKING_COOKIE_MAX_AGE_SECONDS = 7_776_000;\n\nexport const TRACKING_PARAM_KEYS = [\n  'gclid',\n  'fbclid',\n  'utm_source',\n  'utm_medium',\n  'utm_campaign',\n  'utm_term',\n  'utm_content',\n] as const;\n\nexport type TrackingParamKey = (typeof TRACKING_PARAM_KEYS)[number];\n\nexport function createEmptyTrackingParams(): TrackingParams {\n  return {\n    gclid: null,\n    fbclid: null,\n    utm_source: null,\n    utm_medium: null,\n    utm_campaign: null,\n    utm_term: null,\n    utm_content: null,\n  };\n}\n\nexport function normalizeTrackingCookieValue(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function getTrackingParamsFromCookieReader(\n  readCookie: (key: TrackingParamKey) => unknown,\n): TrackingParams {\n  return TRACKING_PARAM_KEYS.reduce<TrackingParams>((params, key) => {\n    params[key] = normalizeTrackingCookieValue(readCookie(key));\n    return params;\n  }, createEmptyTrackingParams());\n}\n\nexport function getTrackingQueryValues(\n  searchParams: Pick<URLSearchParams, 'get'>,\n): Partial<Record<TrackingParamKey, string>> {\n  return TRACKING_PARAM_KEYS.reduce<Partial<Record<TrackingParamKey, string>>>((params, key) => {\n    const value = searchParams.get(key);\n\n    if (typeof value === 'string' && value.trim().length > 0) {\n      params[key] = value;\n    }\n\n    return params;\n  }, {});\n}\n\nexport function getCookieValueFromDocument(key: TrackingParamKey): string | null {\n  if (typeof document === 'undefined')\n    return null;\n\n  const cookies = document.cookie ? document.cookie.split('; ') : [];\n  const match = cookies.find((cookie) => cookie.startsWith(`${key}=`));\n\n  if (!match)\n    return null;\n\n  const [, rawValue = ''] = match.split('=');\n  return normalizeTrackingCookieValue(decodeURIComponent(rawValue));\n}\n\nexport function setTrackingCookie(\n  key: TrackingParamKey,\n  value: string,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): void {\n  if (typeof document === 'undefined')\n    return;\n\n  const encodedValue = encodeURIComponent(value);\n  document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;\n}\n\nexport function persistTrackingParamsFromSearchParams(\n  searchParams: Pick<URLSearchParams, 'get'>,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): Partial<Record<TrackingParamKey, string>> {\n  const trackingValues = getTrackingQueryValues(searchParams);\n\n  Object.entries(trackingValues).forEach(([key, value]) => {\n    setTrackingCookie(key as TrackingParamKey, value, maxAgeSeconds);\n  });\n\n  return trackingValues;\n}\n\nexport function captureTrackingParamsFromLocation(\n  url = typeof window === 'undefined' ? '' : window.location.href,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): TrackingParams {\n  const resolvedUrl = typeof window === 'undefined'\n    ? new URL(url || 'https://example.invalid')\n    : new URL(url, window.location.origin);\n  persistTrackingParamsFromSearchParams(resolvedUrl.searchParams, maxAgeSeconds);\n  return getTrackingParamsFromCookieReader(getCookieValueFromDocument);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAO;AAEP,qBAAwB;;;ACEjB,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,SAAS,4BAA4C;AAC1D,SAAO;AAAA,IACL,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,UAAU;AAAA,IACV,aAAa;AAAA,EACf;AACF;AAEO,SAAS,6BAA6B,OAA+B;AAC1E,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;AAEO,SAAS,kCACd,YACgB;AAChB,SAAO,oBAAoB,OAAuB,CAAC,QAAQ,QAAQ;AACjE,WAAO,GAAG,IAAI,6BAA6B,WAAW,GAAG,CAAC;AAC1D,WAAO;AAAA,EACT,GAAG,0BAA0B,CAAC;AAChC;;;ADzBA,SAAS,iBAA8B;AACrC,aAAO,wBAAQ;AACjB;AAEO,SAAS,0BAA0C;AACxD,QAAM,cAAc,eAAe;AACnC,SAAO,kCAAkC,CAAC,QAAQ,YAAY,IAAI,GAAG,GAAG,KAAK;AAC/E;","names":[]}
+{"version":3,"sources":["../src/server.ts","../../tracking-core/src/tracking.ts","../../tracking-core/src/session.ts","../../tracking-core/src/events/page-view.ts","../../tracking-core/src/events/contact-page-visit.ts","../../tracking-core/src/events/form-submit.ts","../../tracking-core/src/events/phone-click.ts","../../tracking-core/src/events/time-on-site.ts","../../tracking-core/src/events/registry.ts"],"sourcesContent":["import 'server-only';\n\nimport { cookies } from 'next/headers';\n\nimport { getTrackingParamsFromCookieReader, type TrackingParams } from '../../tracking-core/src/index';\n\ninterface CookieValue {\n  value: string;\n}\n\ninterface CookieStore {\n  get(name: string): CookieValue | undefined;\n}\n\nfunction getCookieStore(): CookieStore {\n  return cookies() as unknown as CookieStore;\n}\n\nexport function getTrackingParamsServer(): TrackingParams {\n  const cookieStore = getCookieStore();\n  return getTrackingParamsFromCookieReader((key) => cookieStore.get(key)?.value);\n}\n","import type { TrackingParams } from './types';\n\nexport const TRACKING_COOKIE_MAX_AGE_SECONDS = 7_776_000;\n\nexport const TRACKING_PARAM_KEYS = [\n  'gclid',\n  'fbclid',\n  'utm_source',\n  'utm_medium',\n  'utm_campaign',\n  'utm_term',\n  'utm_content',\n] as const;\n\nexport type TrackingParamKey = (typeof TRACKING_PARAM_KEYS)[number];\n\nexport function createEmptyTrackingParams(): TrackingParams {\n  return {\n    gclid: null,\n    fbclid: null,\n    utm_source: null,\n    utm_medium: null,\n    utm_campaign: null,\n    utm_term: null,\n    utm_content: null,\n  };\n}\n\nexport function normalizeTrackingCookieValue(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function getTrackingParamsFromCookieReader(\n  readCookie: (key: TrackingParamKey) => unknown,\n): TrackingParams {\n  return TRACKING_PARAM_KEYS.reduce<TrackingParams>((params, key) => {\n    params[key] = normalizeTrackingCookieValue(readCookie(key));\n    return params;\n  }, createEmptyTrackingParams());\n}\n\nexport function getTrackingQueryValues(\n  searchParams: Pick<URLSearchParams, 'get'>,\n): Partial<Record<TrackingParamKey, string>> {\n  return TRACKING_PARAM_KEYS.reduce<Partial<Record<TrackingParamKey, string>>>((params, key) => {\n    const value = searchParams.get(key);\n\n    if (typeof value === 'string' && value.trim().length > 0) {\n      params[key] = value;\n    }\n\n    return params;\n  }, {});\n}\n\nexport function getCookieValueFromDocument(key: TrackingParamKey): string | null {\n  if (typeof document === 'undefined')\n    return null;\n\n  const cookies = document.cookie ? document.cookie.split('; ') : [];\n  const match = cookies.find((cookie) => cookie.startsWith(`${key}=`));\n\n  if (!match)\n    return null;\n\n  const [, rawValue = ''] = match.split('=');\n  return normalizeTrackingCookieValue(decodeURIComponent(rawValue));\n}\n\nexport function setTrackingCookie(\n  key: TrackingParamKey,\n  value: string,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): void {\n  if (typeof document === 'undefined')\n    return;\n\n  const encodedValue = encodeURIComponent(value);\n  document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;\n}\n\nexport function persistTrackingParamsFromSearchParams(\n  searchParams: Pick<URLSearchParams, 'get'>,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): Partial<Record<TrackingParamKey, string>> {\n  const trackingValues = getTrackingQueryValues(searchParams);\n\n  Object.entries(trackingValues).forEach(([key, value]) => {\n    setTrackingCookie(key as TrackingParamKey, value, maxAgeSeconds);\n  });\n\n  return trackingValues;\n}\n\nexport function captureTrackingParamsFromLocation(\n  url = typeof window === 'undefined' ? '' : window.location.href,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): TrackingParams {\n  const resolvedUrl = typeof window === 'undefined'\n    ? new URL(url || 'https://example.invalid')\n    : new URL(url, window.location.origin);\n  persistTrackingParamsFromSearchParams(resolvedUrl.searchParams, maxAgeSeconds);\n  return getTrackingParamsFromCookieReader(getCookieValueFromDocument);\n}\n","// Visitor + session identity for the tracking SDK.\n//\n// Visitor: persistent localStorage UUID, never expires until the user clears\n// browser storage. Used for cross-session correlation.\n//\n// Session: rolling 30-minute idle window. Regenerated when more than\n// SESSION_IDLE_MS has passed since the last event. Matches the behavior of\n// GA4, PostHog, Mixpanel, etc., so analytics is comparable.\n\nexport const VISITOR_STORAGE_KEY = 'aranova_tracking_visitor';\nexport const SESSION_STORAGE_KEY = 'aranova_tracking_session';\nexport const SESSION_IDLE_MS = 30 * 60 * 1000;\n\nexport interface StoredSession {\n  id: string;\n  last_event_at: number;\n}\n\nfunction safeUuid(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function')\n    return crypto.randomUUID();\n  // Fallback for ancient browsers — not cryptographically perfect but unique enough.\n  return `${Date.now().toString(16)}-${Math.random().toString(16).slice(2)}-${Math.random().toString(16).slice(2)}`;\n}\n\nfunction readLocalStorage(key: string): string | null {\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeLocalStorage(key: string, value: string): void {\n  try {\n    window.localStorage.setItem(key, value);\n  } catch {\n    // Storage may be denied (private mode, blocked cookies, quota). Caller is\n    // responsible for degrading gracefully.\n  }\n}\n\nexport function getVisitorId(): string {\n  if (typeof window === 'undefined')\n    return safeUuid();\n\n  const existing = readLocalStorage(VISITOR_STORAGE_KEY);\n  if (existing && existing.length > 0)\n    return existing;\n\n  const fresh = safeUuid();\n  writeLocalStorage(VISITOR_STORAGE_KEY, fresh);\n  return fresh;\n}\n\nexport function getOrRotateSessionId(now: number = Date.now()): string {\n  if (typeof window === 'undefined')\n    return safeUuid();\n\n  const raw = readLocalStorage(SESSION_STORAGE_KEY);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw) as Partial<StoredSession>;\n      if (typeof parsed.id === 'string' && typeof parsed.last_event_at === 'number') {\n        if (now - parsed.last_event_at <= SESSION_IDLE_MS) {\n          const refreshed: StoredSession = { id: parsed.id, last_event_at: now };\n          writeLocalStorage(SESSION_STORAGE_KEY, JSON.stringify(refreshed));\n          return parsed.id;\n        }\n      }\n    } catch {\n      // Fall through to a fresh session.\n    }\n  }\n\n  const fresh: StoredSession = { id: safeUuid(), last_event_at: now };\n  writeLocalStorage(SESSION_STORAGE_KEY, JSON.stringify(fresh));\n  return fresh.id;\n}\n\n/** Test/debug helper — wipes both ids. */\nexport function resetTrackingIdentity(): void {\n  if (typeof window === 'undefined')\n    return;\n  try {\n    window.localStorage.removeItem(VISITOR_STORAGE_KEY);\n    window.localStorage.removeItem(SESSION_STORAGE_KEY);\n  } catch {\n    // ignored\n  }\n}\n","import { z } from 'zod';\n\n// page_view is automatic and auto-emitted by attachAutoPageView() on initial\n// load, SPA route changes (pushState / replaceState / popstate), and bfcache\n// restore (pageshow with event.persisted === true).\n\nexport const pageViewMetadataSchema = z\n  .object({\n    page: z.object({\n      title: z.string().nullable(),\n      path: z.string(),\n      search: z.string(),\n      hash: z.string(),\n    }),\n    referrer: z.string().nullable(),\n    // `.nullable().optional()` — absent (undefined) OR explicit null OR a\n    // real viewport object. Mirrors Pydantic's `_Viewport | None = None`\n    // on the backend side so the drift test stays clean.\n    viewport: z\n      .object({\n        w: z.number(),\n        h: z.number(),\n      })\n      .nullable()\n      .optional(),\n  })\n  .strict();\n\nexport type PageViewMetadata = z.infer<typeof pageViewMetadataSchema>;\n\n// No configurable options today, but must be registered for the SDK to attach\n// the auto-page-view handler. Reserved for future options like `throttleMs`\n// or `includeHash`.\nexport const pageViewConfigSchema = z.object({}).strict();\nexport type PageViewConfig = z.infer<typeof pageViewConfigSchema>;\n","import { z } from 'zod';\n\n// contact_page_visit is automatic. The SDK observes every page_view fire and\n// emits a second contact_page_visit event whenever the current pathname\n// matches the consumer-provided `pathPattern`. Lets clients track \"did a\n// visitor reach our contact/booking page\" without writing a listener\n// themselves. pathPattern is a client-side-only RegExp so it isn't shipped\n// over the wire — only the matched metadata is.\n\nexport const contactPageVisitMetadataSchema = z\n  .object({\n    page: z.object({\n      path: z.string(),\n    }),\n  })\n  .strict();\n\nexport type ContactPageVisitMetadata = z.infer<typeof contactPageVisitMetadataSchema>;\n\nexport const contactPageVisitConfigSchema = z\n  .object({\n    // RegExp is runtime-only so we wrap it via z.custom. Consumers pass a\n    // real regex at createTracking() time; the factory validates with this\n    // schema and then keeps the live RegExp reference for runtime matching.\n    pathPattern: z.custom<RegExp>(\n      (value) => value instanceof RegExp,\n      { message: 'pathPattern must be a RegExp' },\n    ),\n  })\n  .strict();\nexport type ContactPageVisitConfig = z.infer<typeof contactPageVisitConfigSchema>;\n","import { z } from 'zod';\n\n// form_submit is manual — the SDK never auto-fires this. Consumer code calls\n// `tracking.trackEvent('form_submit', { form, page })` from their own submit\n// handler. Registering it enables the type-level permission; omitting it\n// turns manual calls into a compile error.\n\nexport const formSubmitMetadataSchema = z\n  .object({\n    form: z.object({\n      id: z.string(),\n      action: z.string().nullable(),\n    }),\n    page: z.object({\n      path: z.string(),\n    }),\n  })\n  .strict();\n\nexport type FormSubmitMetadata = z.infer<typeof formSubmitMetadataSchema>;\n\nexport const formSubmitConfigSchema = z.object({}).strict();\nexport type FormSubmitConfig = z.infer<typeof formSubmitConfigSchema>;\n","import { z } from 'zod';\n\n// phone_click is manual. Consumer code calls trackEvent('phone_click', ...)\n// from a click handler on a tel: anchor or similar. Registering it enables\n// the type-level permission to fire the event.\n\nexport const phoneClickMetadataSchema = z\n  .object({\n    element: z.object({\n      tag: z.string(),\n      text: z.string().nullable(),\n      href: z.string(),\n    }),\n    page: z.object({\n      path: z.string(),\n    }),\n  })\n  .strict();\n\nexport type PhoneClickMetadata = z.infer<typeof phoneClickMetadataSchema>;\n\nexport const phoneClickConfigSchema = z.object({}).strict();\nexport type PhoneClickConfig = z.infer<typeof phoneClickConfigSchema>;\n","import { z } from 'zod';\n\n// time_on_site is automatic. The SDK starts a visibility-aware timer on page\n// load and fires once when the visible-time threshold is crossed. The timer\n// pauses when the tab goes hidden so a user who walks away from a tab\n// doesn't generate fake engagement.\n\nexport const timeOnSiteMetadataSchema = z\n  .object({\n    duration_ms: z.number().int().nonnegative(),\n    page: z.object({\n      path: z.string(),\n    }),\n  })\n  .strict();\n\nexport type TimeOnSiteMetadata = z.infer<typeof timeOnSiteMetadataSchema>;\n\nexport const timeOnSiteConfigSchema = z\n  .object({\n    thresholdSeconds: z.number().int().positive(),\n  })\n  .strict();\nexport type TimeOnSiteConfig = z.infer<typeof timeOnSiteConfigSchema>;\n","import type { z } from 'zod';\n\nimport {\n  contactPageVisitConfigSchema,\n  contactPageVisitMetadataSchema,\n  type ContactPageVisitConfig,\n  type ContactPageVisitMetadata,\n} from './contact-page-visit';\nimport {\n  formSubmitConfigSchema,\n  formSubmitMetadataSchema,\n  type FormSubmitConfig,\n  type FormSubmitMetadata,\n} from './form-submit';\nimport {\n  pageViewConfigSchema,\n  pageViewMetadataSchema,\n  type PageViewConfig,\n  type PageViewMetadata,\n} from './page-view';\nimport {\n  phoneClickConfigSchema,\n  phoneClickMetadataSchema,\n  type PhoneClickConfig,\n  type PhoneClickMetadata,\n} from './phone-click';\nimport {\n  timeOnSiteConfigSchema,\n  timeOnSiteMetadataSchema,\n  type TimeOnSiteConfig,\n  type TimeOnSiteMetadata,\n} from './time-on-site';\n\n// Event kind — automatic events are fired by the SDK itself when their\n// client-side signal fires (page_view on navigation, time_on_site on timer,\n// etc). Manual events are only fireable via explicit consumer code.\nexport type EventKind = 'automatic' | 'manual';\n\n// The registry is the single client-side source of truth for \"what events\n// exist, what shape does their metadata take, and what kind are they\". The\n// backend mirror lives in apps/api/src/schemas/tracking_events.py and is\n// kept in sync via the drift test in apps/api/tests/test_event_schema_drift.py.\nexport const EVENT_REGISTRY = {\n  // --- automatic triggers ---\n  page_view: {\n    kind: 'automatic',\n    metadataSchema: pageViewMetadataSchema,\n    configSchema: pageViewConfigSchema,\n  },\n  time_on_site: {\n    kind: 'automatic',\n    metadataSchema: timeOnSiteMetadataSchema,\n    configSchema: timeOnSiteConfigSchema,\n  },\n  contact_page_visit: {\n    kind: 'automatic',\n    metadataSchema: contactPageVisitMetadataSchema,\n    configSchema: contactPageVisitConfigSchema,\n  },\n  // --- manual triggers ---\n  form_submit: {\n    kind: 'manual',\n    metadataSchema: formSubmitMetadataSchema,\n    configSchema: formSubmitConfigSchema,\n  },\n  phone_click: {\n    kind: 'manual',\n    metadataSchema: phoneClickMetadataSchema,\n    configSchema: phoneClickConfigSchema,\n  },\n} as const;\n\nexport type EventName = keyof typeof EVENT_REGISTRY;\n\n// Narrow the event name union based on `kind`.\nexport type AutomaticEventName = {\n  [K in EventName]: (typeof EVENT_REGISTRY)[K]['kind'] extends 'automatic' ? K : never;\n}[EventName];\n\nexport type ManualEventName = {\n  [K in EventName]: (typeof EVENT_REGISTRY)[K]['kind'] extends 'manual' ? K : never;\n}[EventName];\n\n// Map an event name to its explicit metadata / config TS type. We pull the\n// inferred types directly from the per-event files rather than deriving\n// via `z.infer<typeof EVENT_REGISTRY[K]['metadataSchema']>` so that error\n// messages name the event-specific type (PageViewMetadata, not an\n// anonymous zod inference).\ntype MetadataByName = {\n  page_view: PageViewMetadata;\n  time_on_site: TimeOnSiteMetadata;\n  contact_page_visit: ContactPageVisitMetadata;\n  form_submit: FormSubmitMetadata;\n  phone_click: PhoneClickMetadata;\n};\n\ntype ConfigByName = {\n  page_view: PageViewConfig;\n  time_on_site: TimeOnSiteConfig;\n  contact_page_visit: ContactPageVisitConfig;\n  form_submit: FormSubmitConfig;\n  phone_click: PhoneClickConfig;\n};\n\nexport type EventMetadata<K extends EventName> = MetadataByName[K];\nexport type EventConfig<K extends EventName> = ConfigByName[K];\n\n// Runtime constant arrays for iteration at consumer / factory time.\nexport const ALL_AUTOMATIC_EVENT_NAMES: readonly AutomaticEventName[] = (\n  Object.entries(EVENT_REGISTRY) as Array<[EventName, (typeof EVENT_REGISTRY)[EventName]]>\n)\n  .filter(([, def]) => def.kind === 'automatic')\n  .map(([name]) => name) as AutomaticEventName[];\n\nexport const ALL_MANUAL_EVENT_NAMES: readonly ManualEventName[] = (\n  Object.entries(EVENT_REGISTRY) as Array<[EventName, (typeof EVENT_REGISTRY)[EventName]]>\n)\n  .filter(([, def]) => def.kind === 'manual')\n  .map(([name]) => name) as ManualEventName[];\n\n// The shape passed to createTracking({ triggers: ... }).\n//\n// `automatic.page_view` is **required** — if you're installing tracking you\n// always want page views, and forgetting to register it is a footgun we\n// prefer to catch at compile time. Every other automatic event is optional.\n// Manual events are all optional — register only the ones you actually\n// intend to fire from consumer code.\nexport type TriggerRegistryConfig = {\n  automatic: {\n    page_view: EventConfig<'page_view'>;\n  } & Partial<{\n    time_on_site: EventConfig<'time_on_site'>;\n    contact_page_visit: EventConfig<'contact_page_visit'>;\n  }>;\n  // `manual` is itself optional — most consumers will only fire automatic\n  // events. Omitting this property is the same as `manual: {}` (no\n  // manually-fireable events registered).\n  manual?: Partial<{\n    form_submit: EventConfig<'form_submit'>;\n    phone_click: EventConfig<'phone_click'>;\n  }>;\n};\n\n// Given a registry, which manual event names did the consumer actually\n// register? These are the only ones `trackEvent()` will accept as its\n// first argument. `NonNullable` collapses the case where `manual` was\n// omitted entirely.\nexport type RegisteredManualEvents<TRegistry extends TriggerRegistryConfig> =\n  Extract<keyof NonNullable<TRegistry['manual']>, ManualEventName>;\n\n// Given a registry, which automatic event names did the consumer register?\n// Used by the factory to decide which auto-trigger attach helpers to wire up.\nexport type RegisteredAutomaticEvents<TRegistry extends TriggerRegistryConfig> =\n  Extract<keyof TRegistry['automatic'], AutomaticEventName>;\n\n// Internal helper used by the factory: given a registry, return the full\n// discriminated union of valid (eventName, metadata) pairs the consumer\n// can pass to trackEvent().\nexport type TrackableEvent<TRegistry extends TriggerRegistryConfig> = {\n  [K in RegisteredManualEvents<TRegistry>]: {\n    eventType: K;\n    metadata: EventMetadata<K>;\n  };\n}[RegisteredManualEvents<TRegistry>];\n\n// Runtime helper: look up a schema pair by name. Cast through `unknown`\n// because the registry is `as const` and TS loses the specific schema type\n// when indexing via a dynamic key.\nexport function getEventDefinition(name: EventName): {\n  kind: EventKind;\n  metadataSchema: z.ZodTypeAny;\n  configSchema: z.ZodTypeAny;\n} {\n  return EVENT_REGISTRY[name] as unknown as {\n    kind: EventKind;\n    metadataSchema: z.ZodTypeAny;\n    configSchema: z.ZodTypeAny;\n  };\n}\n"],"mappings":"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","names":["import_zod","import_zod","import_zod","import_zod"]}

package/dist/server.mjs

@@ -33,6 +33,118 @@ function getTrackingParamsFromCookieReader(readCookie) {
   }, createEmptyTrackingParams());
 }
 
+// ../tracking-core/src/session.ts
+var SESSION_IDLE_MS = 30 * 60 * 1e3;
+
+// ../tracking-core/src/events/page-view.ts
+import { z } from "zod";
+var pageViewMetadataSchema = z.object({
+  page: z.object({
+    title: z.string().nullable(),
+    path: z.string(),
+    search: z.string(),
+    hash: z.string()
+  }),
+  referrer: z.string().nullable(),
+  // `.nullable().optional()` — absent (undefined) OR explicit null OR a
+  // real viewport object. Mirrors Pydantic's `_Viewport | None = None`
+  // on the backend side so the drift test stays clean.
+  viewport: z.object({
+    w: z.number(),
+    h: z.number()
+  }).nullable().optional()
+}).strict();
+var pageViewConfigSchema = z.object({}).strict();
+
+// ../tracking-core/src/events/contact-page-visit.ts
+import { z as z2 } from "zod";
+var contactPageVisitMetadataSchema = z2.object({
+  page: z2.object({
+    path: z2.string()
+  })
+}).strict();
+var contactPageVisitConfigSchema = z2.object({
+  // RegExp is runtime-only so we wrap it via z.custom. Consumers pass a
+  // real regex at createTracking() time; the factory validates with this
+  // schema and then keeps the live RegExp reference for runtime matching.
+  pathPattern: z2.custom(
+    (value) => value instanceof RegExp,
+    { message: "pathPattern must be a RegExp" }
+  )
+}).strict();
+
+// ../tracking-core/src/events/form-submit.ts
+import { z as z3 } from "zod";
+var formSubmitMetadataSchema = z3.object({
+  form: z3.object({
+    id: z3.string(),
+    action: z3.string().nullable()
+  }),
+  page: z3.object({
+    path: z3.string()
+  })
+}).strict();
+var formSubmitConfigSchema = z3.object({}).strict();
+
+// ../tracking-core/src/events/phone-click.ts
+import { z as z4 } from "zod";
+var phoneClickMetadataSchema = z4.object({
+  element: z4.object({
+    tag: z4.string(),
+    text: z4.string().nullable(),
+    href: z4.string()
+  }),
+  page: z4.object({
+    path: z4.string()
+  })
+}).strict();
+var phoneClickConfigSchema = z4.object({}).strict();
+
+// ../tracking-core/src/events/time-on-site.ts
+import { z as z5 } from "zod";
+var timeOnSiteMetadataSchema = z5.object({
+  duration_ms: z5.number().int().nonnegative(),
+  page: z5.object({
+    path: z5.string()
+  })
+}).strict();
+var timeOnSiteConfigSchema = z5.object({
+  thresholdSeconds: z5.number().int().positive()
+}).strict();
+
+// ../tracking-core/src/events/registry.ts
+var EVENT_REGISTRY = {
+  // --- automatic triggers ---
+  page_view: {
+    kind: "automatic",
+    metadataSchema: pageViewMetadataSchema,
+    configSchema: pageViewConfigSchema
+  },
+  time_on_site: {
+    kind: "automatic",
+    metadataSchema: timeOnSiteMetadataSchema,
+    configSchema: timeOnSiteConfigSchema
+  },
+  contact_page_visit: {
+    kind: "automatic",
+    metadataSchema: contactPageVisitMetadataSchema,
+    configSchema: contactPageVisitConfigSchema
+  },
+  // --- manual triggers ---
+  form_submit: {
+    kind: "manual",
+    metadataSchema: formSubmitMetadataSchema,
+    configSchema: formSubmitConfigSchema
+  },
+  phone_click: {
+    kind: "manual",
+    metadataSchema: phoneClickMetadataSchema,
+    configSchema: phoneClickConfigSchema
+  }
+};
+var ALL_AUTOMATIC_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "automatic").map(([name]) => name);
+var ALL_MANUAL_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "manual").map(([name]) => name);
+
 // src/server.ts
 function getCookieStore() {
   return cookies();

package/dist/server.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts","../../tracking-core/src/tracking.ts"],"sourcesContent":["import 'server-only';\n\nimport { cookies } from 'next/headers';\n\nimport { getTrackingParamsFromCookieReader, type TrackingParams } from '../../tracking-core/src/index';\n\ninterface CookieValue {\n  value: string;\n}\n\ninterface CookieStore {\n  get(name: string): CookieValue | undefined;\n}\n\nfunction getCookieStore(): CookieStore {\n  return cookies() as unknown as CookieStore;\n}\n\nexport function getTrackingParamsServer(): TrackingParams {\n  const cookieStore = getCookieStore();\n  return getTrackingParamsFromCookieReader((key) => cookieStore.get(key)?.value);\n}\n","import type { TrackingParams } from './types';\n\nexport const TRACKING_COOKIE_MAX_AGE_SECONDS = 7_776_000;\n\nexport const TRACKING_PARAM_KEYS = [\n  'gclid',\n  'fbclid',\n  'utm_source',\n  'utm_medium',\n  'utm_campaign',\n  'utm_term',\n  'utm_content',\n] as const;\n\nexport type TrackingParamKey = (typeof TRACKING_PARAM_KEYS)[number];\n\nexport function createEmptyTrackingParams(): TrackingParams {\n  return {\n    gclid: null,\n    fbclid: null,\n    utm_source: null,\n    utm_medium: null,\n    utm_campaign: null,\n    utm_term: null,\n    utm_content: null,\n  };\n}\n\nexport function normalizeTrackingCookieValue(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function getTrackingParamsFromCookieReader(\n  readCookie: (key: TrackingParamKey) => unknown,\n): TrackingParams {\n  return TRACKING_PARAM_KEYS.reduce<TrackingParams>((params, key) => {\n    params[key] = normalizeTrackingCookieValue(readCookie(key));\n    return params;\n  }, createEmptyTrackingParams());\n}\n\nexport function getTrackingQueryValues(\n  searchParams: Pick<URLSearchParams, 'get'>,\n): Partial<Record<TrackingParamKey, string>> {\n  return TRACKING_PARAM_KEYS.reduce<Partial<Record<TrackingParamKey, string>>>((params, key) => {\n    const value = searchParams.get(key);\n\n    if (typeof value === 'string' && value.trim().length > 0) {\n      params[key] = value;\n    }\n\n    return params;\n  }, {});\n}\n\nexport function getCookieValueFromDocument(key: TrackingParamKey): string | null {\n  if (typeof document === 'undefined')\n    return null;\n\n  const cookies = document.cookie ? document.cookie.split('; ') : [];\n  const match = cookies.find((cookie) => cookie.startsWith(`${key}=`));\n\n  if (!match)\n    return null;\n\n  const [, rawValue = ''] = match.split('=');\n  return normalizeTrackingCookieValue(decodeURIComponent(rawValue));\n}\n\nexport function setTrackingCookie(\n  key: TrackingParamKey,\n  value: string,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): void {\n  if (typeof document === 'undefined')\n    return;\n\n  const encodedValue = encodeURIComponent(value);\n  document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;\n}\n\nexport function persistTrackingParamsFromSearchParams(\n  searchParams: Pick<URLSearchParams, 'get'>,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): Partial<Record<TrackingParamKey, string>> {\n  const trackingValues = getTrackingQueryValues(searchParams);\n\n  Object.entries(trackingValues).forEach(([key, value]) => {\n    setTrackingCookie(key as TrackingParamKey, value, maxAgeSeconds);\n  });\n\n  return trackingValues;\n}\n\nexport function captureTrackingParamsFromLocation(\n  url = typeof window === 'undefined' ? '' : window.location.href,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): TrackingParams {\n  const resolvedUrl = typeof window === 'undefined'\n    ? new URL(url || 'https://example.invalid')\n    : new URL(url, window.location.origin);\n  persistTrackingParamsFromSearchParams(resolvedUrl.searchParams, maxAgeSeconds);\n  return getTrackingParamsFromCookieReader(getCookieValueFromDocument);\n}\n"],"mappings":";AAAA,OAAO;AAEP,SAAS,eAAe;;;ACEjB,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,SAAS,4BAA4C;AAC1D,SAAO;AAAA,IACL,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,UAAU;AAAA,IACV,aAAa;AAAA,EACf;AACF;AAEO,SAAS,6BAA6B,OAA+B;AAC1E,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;AAEO,SAAS,kCACd,YACgB;AAChB,SAAO,oBAAoB,OAAuB,CAAC,QAAQ,QAAQ;AACjE,WAAO,GAAG,IAAI,6BAA6B,WAAW,GAAG,CAAC;AAC1D,WAAO;AAAA,EACT,GAAG,0BAA0B,CAAC;AAChC;;;ADzBA,SAAS,iBAA8B;AACrC,SAAO,QAAQ;AACjB;AAEO,SAAS,0BAA0C;AACxD,QAAM,cAAc,eAAe;AACnC,SAAO,kCAAkC,CAAC,QAAQ,YAAY,IAAI,GAAG,GAAG,KAAK;AAC/E;","names":[]}
+{"version":3,"sources":["../src/server.ts","../../tracking-core/src/tracking.ts","../../tracking-core/src/session.ts","../../tracking-core/src/events/page-view.ts","../../tracking-core/src/events/contact-page-visit.ts","../../tracking-core/src/events/form-submit.ts","../../tracking-core/src/events/phone-click.ts","../../tracking-core/src/events/time-on-site.ts","../../tracking-core/src/events/registry.ts"],"sourcesContent":["import 'server-only';\n\nimport { cookies } from 'next/headers';\n\nimport { getTrackingParamsFromCookieReader, type TrackingParams } from '../../tracking-core/src/index';\n\ninterface CookieValue {\n  value: string;\n}\n\ninterface CookieStore {\n  get(name: string): CookieValue | undefined;\n}\n\nfunction getCookieStore(): CookieStore {\n  return cookies() as unknown as CookieStore;\n}\n\nexport function getTrackingParamsServer(): TrackingParams {\n  const cookieStore = getCookieStore();\n  return getTrackingParamsFromCookieReader((key) => cookieStore.get(key)?.value);\n}\n","import type { TrackingParams } from './types';\n\nexport const TRACKING_COOKIE_MAX_AGE_SECONDS = 7_776_000;\n\nexport const TRACKING_PARAM_KEYS = [\n  'gclid',\n  'fbclid',\n  'utm_source',\n  'utm_medium',\n  'utm_campaign',\n  'utm_term',\n  'utm_content',\n] as const;\n\nexport type TrackingParamKey = (typeof TRACKING_PARAM_KEYS)[number];\n\nexport function createEmptyTrackingParams(): TrackingParams {\n  return {\n    gclid: null,\n    fbclid: null,\n    utm_source: null,\n    utm_medium: null,\n    utm_campaign: null,\n    utm_term: null,\n    utm_content: null,\n  };\n}\n\nexport function normalizeTrackingCookieValue(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function getTrackingParamsFromCookieReader(\n  readCookie: (key: TrackingParamKey) => unknown,\n): TrackingParams {\n  return TRACKING_PARAM_KEYS.reduce<TrackingParams>((params, key) => {\n    params[key] = normalizeTrackingCookieValue(readCookie(key));\n    return params;\n  }, createEmptyTrackingParams());\n}\n\nexport function getTrackingQueryValues(\n  searchParams: Pick<URLSearchParams, 'get'>,\n): Partial<Record<TrackingParamKey, string>> {\n  return TRACKING_PARAM_KEYS.reduce<Partial<Record<TrackingParamKey, string>>>((params, key) => {\n    const value = searchParams.get(key);\n\n    if (typeof value === 'string' && value.trim().length > 0) {\n      params[key] = value;\n    }\n\n    return params;\n  }, {});\n}\n\nexport function getCookieValueFromDocument(key: TrackingParamKey): string | null {\n  if (typeof document === 'undefined')\n    return null;\n\n  const cookies = document.cookie ? document.cookie.split('; ') : [];\n  const match = cookies.find((cookie) => cookie.startsWith(`${key}=`));\n\n  if (!match)\n    return null;\n\n  const [, rawValue = ''] = match.split('=');\n  return normalizeTrackingCookieValue(decodeURIComponent(rawValue));\n}\n\nexport function setTrackingCookie(\n  key: TrackingParamKey,\n  value: string,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): void {\n  if (typeof document === 'undefined')\n    return;\n\n  const encodedValue = encodeURIComponent(value);\n  document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;\n}\n\nexport function persistTrackingParamsFromSearchParams(\n  searchParams: Pick<URLSearchParams, 'get'>,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): Partial<Record<TrackingParamKey, string>> {\n  const trackingValues = getTrackingQueryValues(searchParams);\n\n  Object.entries(trackingValues).forEach(([key, value]) => {\n    setTrackingCookie(key as TrackingParamKey, value, maxAgeSeconds);\n  });\n\n  return trackingValues;\n}\n\nexport function captureTrackingParamsFromLocation(\n  url = typeof window === 'undefined' ? '' : window.location.href,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): TrackingParams {\n  const resolvedUrl = typeof window === 'undefined'\n    ? new URL(url || 'https://example.invalid')\n    : new URL(url, window.location.origin);\n  persistTrackingParamsFromSearchParams(resolvedUrl.searchParams, maxAgeSeconds);\n  return getTrackingParamsFromCookieReader(getCookieValueFromDocument);\n}\n","// Visitor + session identity for the tracking SDK.\n//\n// Visitor: persistent localStorage UUID, never expires until the user clears\n// browser storage. Used for cross-session correlation.\n//\n// Session: rolling 30-minute idle window. Regenerated when more than\n// SESSION_IDLE_MS has passed since the last event. Matches the behavior of\n// GA4, PostHog, Mixpanel, etc., so analytics is comparable.\n\nexport const VISITOR_STORAGE_KEY = 'aranova_tracking_visitor';\nexport const SESSION_STORAGE_KEY = 'aranova_tracking_session';\nexport const SESSION_IDLE_MS = 30 * 60 * 1000;\n\nexport interface StoredSession {\n  id: string;\n  last_event_at: number;\n}\n\nfunction safeUuid(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function')\n    return crypto.randomUUID();\n  // Fallback for ancient browsers — not cryptographically perfect but unique enough.\n  return `${Date.now().toString(16)}-${Math.random().toString(16).slice(2)}-${Math.random().toString(16).slice(2)}`;\n}\n\nfunction readLocalStorage(key: string): string | null {\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeLocalStorage(key: string, value: string): void {\n  try {\n    window.localStorage.setItem(key, value);\n  } catch {\n    // Storage may be denied (private mode, blocked cookies, quota). Caller is\n    // responsible for degrading gracefully.\n  }\n}\n\nexport function getVisitorId(): string {\n  if (typeof window === 'undefined')\n    return safeUuid();\n\n  const existing = readLocalStorage(VISITOR_STORAGE_KEY);\n  if (existing && existing.length > 0)\n    return existing;\n\n  const fresh = safeUuid();\n  writeLocalStorage(VISITOR_STORAGE_KEY, fresh);\n  return fresh;\n}\n\nexport function getOrRotateSessionId(now: number = Date.now()): string {\n  if (typeof window === 'undefined')\n    return safeUuid();\n\n  const raw = readLocalStorage(SESSION_STORAGE_KEY);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw) as Partial<StoredSession>;\n      if (typeof parsed.id === 'string' && typeof parsed.last_event_at === 'number') {\n        if (now - parsed.last_event_at <= SESSION_IDLE_MS) {\n          const refreshed: StoredSession = { id: parsed.id, last_event_at: now };\n          writeLocalStorage(SESSION_STORAGE_KEY, JSON.stringify(refreshed));\n          return parsed.id;\n        }\n      }\n    } catch {\n      // Fall through to a fresh session.\n    }\n  }\n\n  const fresh: StoredSession = { id: safeUuid(), last_event_at: now };\n  writeLocalStorage(SESSION_STORAGE_KEY, JSON.stringify(fresh));\n  return fresh.id;\n}\n\n/** Test/debug helper — wipes both ids. */\nexport function resetTrackingIdentity(): void {\n  if (typeof window === 'undefined')\n    return;\n  try {\n    window.localStorage.removeItem(VISITOR_STORAGE_KEY);\n    window.localStorage.removeItem(SESSION_STORAGE_KEY);\n  } catch {\n    // ignored\n  }\n}\n","import { z } from 'zod';\n\n// page_view is automatic and auto-emitted by attachAutoPageView() on initial\n// load, SPA route changes (pushState / replaceState / popstate), and bfcache\n// restore (pageshow with event.persisted === true).\n\nexport const pageViewMetadataSchema = z\n  .object({\n    page: z.object({\n      title: z.string().nullable(),\n      path: z.string(),\n      search: z.string(),\n      hash: z.string(),\n    }),\n    referrer: z.string().nullable(),\n    // `.nullable().optional()` — absent (undefined) OR explicit null OR a\n    // real viewport object. Mirrors Pydantic's `_Viewport | None = None`\n    // on the backend side so the drift test stays clean.\n    viewport: z\n      .object({\n        w: z.number(),\n        h: z.number(),\n      })\n      .nullable()\n      .optional(),\n  })\n  .strict();\n\nexport type PageViewMetadata = z.infer<typeof pageViewMetadataSchema>;\n\n// No configurable options today, but must be registered for the SDK to attach\n// the auto-page-view handler. Reserved for future options like `throttleMs`\n// or `includeHash`.\nexport const pageViewConfigSchema = z.object({}).strict();\nexport type PageViewConfig = z.infer<typeof pageViewConfigSchema>;\n","import { z } from 'zod';\n\n// contact_page_visit is automatic. The SDK observes every page_view fire and\n// emits a second contact_page_visit event whenever the current pathname\n// matches the consumer-provided `pathPattern`. Lets clients track \"did a\n// visitor reach our contact/booking page\" without writing a listener\n// themselves. pathPattern is a client-side-only RegExp so it isn't shipped\n// over the wire — only the matched metadata is.\n\nexport const contactPageVisitMetadataSchema = z\n  .object({\n    page: z.object({\n      path: z.string(),\n    }),\n  })\n  .strict();\n\nexport type ContactPageVisitMetadata = z.infer<typeof contactPageVisitMetadataSchema>;\n\nexport const contactPageVisitConfigSchema = z\n  .object({\n    // RegExp is runtime-only so we wrap it via z.custom. Consumers pass a\n    // real regex at createTracking() time; the factory validates with this\n    // schema and then keeps the live RegExp reference for runtime matching.\n    pathPattern: z.custom<RegExp>(\n      (value) => value instanceof RegExp,\n      { message: 'pathPattern must be a RegExp' },\n    ),\n  })\n  .strict();\nexport type ContactPageVisitConfig = z.infer<typeof contactPageVisitConfigSchema>;\n","import { z } from 'zod';\n\n// form_submit is manual — the SDK never auto-fires this. Consumer code calls\n// `tracking.trackEvent('form_submit', { form, page })` from their own submit\n// handler. Registering it enables the type-level permission; omitting it\n// turns manual calls into a compile error.\n\nexport const formSubmitMetadataSchema = z\n  .object({\n    form: z.object({\n      id: z.string(),\n      action: z.string().nullable(),\n    }),\n    page: z.object({\n      path: z.string(),\n    }),\n  })\n  .strict();\n\nexport type FormSubmitMetadata = z.infer<typeof formSubmitMetadataSchema>;\n\nexport const formSubmitConfigSchema = z.object({}).strict();\nexport type FormSubmitConfig = z.infer<typeof formSubmitConfigSchema>;\n","import { z } from 'zod';\n\n// phone_click is manual. Consumer code calls trackEvent('phone_click', ...)\n// from a click handler on a tel: anchor or similar. Registering it enables\n// the type-level permission to fire the event.\n\nexport const phoneClickMetadataSchema = z\n  .object({\n    element: z.object({\n      tag: z.string(),\n      text: z.string().nullable(),\n      href: z.string(),\n    }),\n    page: z.object({\n      path: z.string(),\n    }),\n  })\n  .strict();\n\nexport type PhoneClickMetadata = z.infer<typeof phoneClickMetadataSchema>;\n\nexport const phoneClickConfigSchema = z.object({}).strict();\nexport type PhoneClickConfig = z.infer<typeof phoneClickConfigSchema>;\n","import { z } from 'zod';\n\n// time_on_site is automatic. The SDK starts a visibility-aware timer on page\n// load and fires once when the visible-time threshold is crossed. The timer\n// pauses when the tab goes hidden so a user who walks away from a tab\n// doesn't generate fake engagement.\n\nexport const timeOnSiteMetadataSchema = z\n  .object({\n    duration_ms: z.number().int().nonnegative(),\n    page: z.object({\n      path: z.string(),\n    }),\n  })\n  .strict();\n\nexport type TimeOnSiteMetadata = z.infer<typeof timeOnSiteMetadataSchema>;\n\nexport const timeOnSiteConfigSchema = z\n  .object({\n    thresholdSeconds: z.number().int().positive(),\n  })\n  .strict();\nexport type TimeOnSiteConfig = z.infer<typeof timeOnSiteConfigSchema>;\n","import type { z } from 'zod';\n\nimport {\n  contactPageVisitConfigSchema,\n  contactPageVisitMetadataSchema,\n  type ContactPageVisitConfig,\n  type ContactPageVisitMetadata,\n} from './contact-page-visit';\nimport {\n  formSubmitConfigSchema,\n  formSubmitMetadataSchema,\n  type FormSubmitConfig,\n  type FormSubmitMetadata,\n} from './form-submit';\nimport {\n  pageViewConfigSchema,\n  pageViewMetadataSchema,\n  type PageViewConfig,\n  type PageViewMetadata,\n} from './page-view';\nimport {\n  phoneClickConfigSchema,\n  phoneClickMetadataSchema,\n  type PhoneClickConfig,\n  type PhoneClickMetadata,\n} from './phone-click';\nimport {\n  timeOnSiteConfigSchema,\n  timeOnSiteMetadataSchema,\n  type TimeOnSiteConfig,\n  type TimeOnSiteMetadata,\n} from './time-on-site';\n\n// Event kind — automatic events are fired by the SDK itself when their\n// client-side signal fires (page_view on navigation, time_on_site on timer,\n// etc). Manual events are only fireable via explicit consumer code.\nexport type EventKind = 'automatic' | 'manual';\n\n// The registry is the single client-side source of truth for \"what events\n// exist, what shape does their metadata take, and what kind are they\". The\n// backend mirror lives in apps/api/src/schemas/tracking_events.py and is\n// kept in sync via the drift test in apps/api/tests/test_event_schema_drift.py.\nexport const EVENT_REGISTRY = {\n  // --- automatic triggers ---\n  page_view: {\n    kind: 'automatic',\n    metadataSchema: pageViewMetadataSchema,\n    configSchema: pageViewConfigSchema,\n  },\n  time_on_site: {\n    kind: 'automatic',\n    metadataSchema: timeOnSiteMetadataSchema,\n    configSchema: timeOnSiteConfigSchema,\n  },\n  contact_page_visit: {\n    kind: 'automatic',\n    metadataSchema: contactPageVisitMetadataSchema,\n    configSchema: contactPageVisitConfigSchema,\n  },\n  // --- manual triggers ---\n  form_submit: {\n    kind: 'manual',\n    metadataSchema: formSubmitMetadataSchema,\n    configSchema: formSubmitConfigSchema,\n  },\n  phone_click: {\n    kind: 'manual',\n    metadataSchema: phoneClickMetadataSchema,\n    configSchema: phoneClickConfigSchema,\n  },\n} as const;\n\nexport type EventName = keyof typeof EVENT_REGISTRY;\n\n// Narrow the event name union based on `kind`.\nexport type AutomaticEventName = {\n  [K in EventName]: (typeof EVENT_REGISTRY)[K]['kind'] extends 'automatic' ? K : never;\n}[EventName];\n\nexport type ManualEventName = {\n  [K in EventName]: (typeof EVENT_REGISTRY)[K]['kind'] extends 'manual' ? K : never;\n}[EventName];\n\n// Map an event name to its explicit metadata / config TS type. We pull the\n// inferred types directly from the per-event files rather than deriving\n// via `z.infer<typeof EVENT_REGISTRY[K]['metadataSchema']>` so that error\n// messages name the event-specific type (PageViewMetadata, not an\n// anonymous zod inference).\ntype MetadataByName = {\n  page_view: PageViewMetadata;\n  time_on_site: TimeOnSiteMetadata;\n  contact_page_visit: ContactPageVisitMetadata;\n  form_submit: FormSubmitMetadata;\n  phone_click: PhoneClickMetadata;\n};\n\ntype ConfigByName = {\n  page_view: PageViewConfig;\n  time_on_site: TimeOnSiteConfig;\n  contact_page_visit: ContactPageVisitConfig;\n  form_submit: FormSubmitConfig;\n  phone_click: PhoneClickConfig;\n};\n\nexport type EventMetadata<K extends EventName> = MetadataByName[K];\nexport type EventConfig<K extends EventName> = ConfigByName[K];\n\n// Runtime constant arrays for iteration at consumer / factory time.\nexport const ALL_AUTOMATIC_EVENT_NAMES: readonly AutomaticEventName[] = (\n  Object.entries(EVENT_REGISTRY) as Array<[EventName, (typeof EVENT_REGISTRY)[EventName]]>\n)\n  .filter(([, def]) => def.kind === 'automatic')\n  .map(([name]) => name) as AutomaticEventName[];\n\nexport const ALL_MANUAL_EVENT_NAMES: readonly ManualEventName[] = (\n  Object.entries(EVENT_REGISTRY) as Array<[EventName, (typeof EVENT_REGISTRY)[EventName]]>\n)\n  .filter(([, def]) => def.kind === 'manual')\n  .map(([name]) => name) as ManualEventName[];\n\n// The shape passed to createTracking({ triggers: ... }).\n//\n// `automatic.page_view` is **required** — if you're installing tracking you\n// always want page views, and forgetting to register it is a footgun we\n// prefer to catch at compile time. Every other automatic event is optional.\n// Manual events are all optional — register only the ones you actually\n// intend to fire from consumer code.\nexport type TriggerRegistryConfig = {\n  automatic: {\n    page_view: EventConfig<'page_view'>;\n  } & Partial<{\n    time_on_site: EventConfig<'time_on_site'>;\n    contact_page_visit: EventConfig<'contact_page_visit'>;\n  }>;\n  // `manual` is itself optional — most consumers will only fire automatic\n  // events. Omitting this property is the same as `manual: {}` (no\n  // manually-fireable events registered).\n  manual?: Partial<{\n    form_submit: EventConfig<'form_submit'>;\n    phone_click: EventConfig<'phone_click'>;\n  }>;\n};\n\n// Given a registry, which manual event names did the consumer actually\n// register? These are the only ones `trackEvent()` will accept as its\n// first argument. `NonNullable` collapses the case where `manual` was\n// omitted entirely.\nexport type RegisteredManualEvents<TRegistry extends TriggerRegistryConfig> =\n  Extract<keyof NonNullable<TRegistry['manual']>, ManualEventName>;\n\n// Given a registry, which automatic event names did the consumer register?\n// Used by the factory to decide which auto-trigger attach helpers to wire up.\nexport type RegisteredAutomaticEvents<TRegistry extends TriggerRegistryConfig> =\n  Extract<keyof TRegistry['automatic'], AutomaticEventName>;\n\n// Internal helper used by the factory: given a registry, return the full\n// discriminated union of valid (eventName, metadata) pairs the consumer\n// can pass to trackEvent().\nexport type TrackableEvent<TRegistry extends TriggerRegistryConfig> = {\n  [K in RegisteredManualEvents<TRegistry>]: {\n    eventType: K;\n    metadata: EventMetadata<K>;\n  };\n}[RegisteredManualEvents<TRegistry>];\n\n// Runtime helper: look up a schema pair by name. Cast through `unknown`\n// because the registry is `as const` and TS loses the specific schema type\n// when indexing via a dynamic key.\nexport function getEventDefinition(name: EventName): {\n  kind: EventKind;\n  metadataSchema: z.ZodTypeAny;\n  configSchema: z.ZodTypeAny;\n} {\n  return EVENT_REGISTRY[name] as unknown as {\n    kind: EventKind;\n    metadataSchema: z.ZodTypeAny;\n    configSchema: z.ZodTypeAny;\n  };\n}\n"],"mappings":"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","names":["z","z","z","z"]}

package/dist/{server-BMTa7njW.d.mts → types-Gp0ioRiQ.d.mts}

@@ -19,6 +19,7 @@ interface TrackingClientContext {
 }
 interface TrackingSessionUpsertPayload {
     session_id: string;
+    visitor_id: string | null;
     gclid: string | null;
     fbclid: string | null;
     utm_source: string | null;
@@ -58,10 +59,9 @@ declare global {
             getTrackingParams: () => TrackingParams;
             getConsentState: () => ConsentState;
             setConsentState: (state: 'granted' | 'denied') => void;
+            trackEvent: (eventType: string, metadata: Record<string, unknown>) => void;
         };
     }
 }
 
-declare function getTrackingParamsServer(): TrackingParams;
-
-export { type ConsentState as C, type TrackingInstallSurface as T, type TrackingClientContext as a, type TrackingParams as b, type TrackingEventCreatePayload as c, type TrackingSessionUpsertPayload as d, type TrackingInitConfig as e, getTrackingParamsServer as g };
+export type { ConsentState as C, TrackingInstallSurface as T, TrackingClientContext as a, TrackingParams as b, TrackingEventCreatePayload as c, TrackingSessionUpsertPayload as d, TrackingInitConfig as e };

package/dist/{server-BMTa7njW.d.ts → types-Gp0ioRiQ.d.ts}

@@ -19,6 +19,7 @@ interface TrackingClientContext {
 }
 interface TrackingSessionUpsertPayload {
     session_id: string;
+    visitor_id: string | null;
     gclid: string | null;
     fbclid: string | null;
     utm_source: string | null;
@@ -58,10 +59,9 @@ declare global {
             getTrackingParams: () => TrackingParams;
             getConsentState: () => ConsentState;
             setConsentState: (state: 'granted' | 'denied') => void;
+            trackEvent: (eventType: string, metadata: Record<string, unknown>) => void;
         };
     }
 }
 
-declare function getTrackingParamsServer(): TrackingParams;
-
-export { type ConsentState as C, type TrackingInstallSurface as T, type TrackingClientContext as a, type TrackingParams as b, type TrackingEventCreatePayload as c, type TrackingSessionUpsertPayload as d, type TrackingInitConfig as e, getTrackingParamsServer as g };
+export type { ConsentState as C, TrackingInstallSurface as T, TrackingClientContext as a, TrackingParams as b, TrackingEventCreatePayload as c, TrackingSessionUpsertPayload as d, TrackingInitConfig as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aranova/tracking-next",
-  "version": "0.2.3",
+  "version": "0.4.0",
   "private": false,
   "description": "Next.js tracking utilities for Aranova client sites",
   "files": [
@@ -44,7 +44,8 @@
     "react": ">=18.0.0"
   },
   "dependencies": {
-    "server-only": "^0.0.1"
+    "server-only": "^0.0.1",
+    "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/react": "^19.2.2",