@nextlytics/core 0.1.0-canary-1

package/dist/backends/gtm.js

@@ -0,0 +1,131 @@
+const GTM_INIT_TEMPLATE_ID = "gtm-init";
+const GTM_PAGEVIEW_TEMPLATE_ID = "gtm-pageview";
+const GTM_EVENT_TEMPLATE_ID = "gtm-event";
+function toSnakeCase(str) {
+  return str.replace(/([A-Z])/g, "_$1").toLowerCase().replace(/^_/, "");
+}
+function googleTagManagerBackend(opts) {
+  const { containerId } = opts;
+  return {
+    name: "google-tag-manager",
+    returnsClientActions: true,
+    supportsUpdates: false,
+    getClientSideTemplates() {
+      return {
+        [GTM_INIT_TEMPLATE_ID]: {
+          items: [
+            {
+              body: [
+                "window.dataLayer = window.dataLayer || [];",
+                "dataLayer.push({{json(initialData)}});",
+                "if (!window.google_tag_manager || !window.google_tag_manager['{{containerId}}']) {",
+                "  (function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':",
+                "  new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],",
+                "  j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=",
+                "  'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);",
+                "  })(window,document,'script','dataLayer','{{containerId}}');",
+                "}"
+              ].join("\n")
+            }
+          ]
+        },
+        [GTM_PAGEVIEW_TEMPLATE_ID]: {
+          items: [
+            {
+              body: [
+                "window.dataLayer = window.dataLayer || [];",
+                "dataLayer.push({{json(pageData)}});"
+              ].join("\n")
+            }
+          ]
+        },
+        [GTM_EVENT_TEMPLATE_ID]: {
+          items: [
+            {
+              body: [
+                "window.dataLayer = window.dataLayer || [];",
+                "dataLayer.push({{json(eventData)}});"
+              ].join("\n")
+            }
+          ]
+        }
+      };
+    },
+    async onEvent(event) {
+      if (event.type !== "pageView") {
+        const eventData = {
+          event: toSnakeCase(event.type),
+          eventId: event.eventId,
+          ...event.properties
+        };
+        if (event.userContext?.userId) {
+          eventData.userId = event.userContext.userId;
+        }
+        if (event.anonymousUserId) {
+          eventData.anonymousUserId = event.anonymousUserId;
+        }
+        const traits2 = event.userContext?.traits;
+        if (traits2 && Object.keys(traits2).length > 0) {
+          eventData.userTraits = traits2;
+        }
+        return {
+          items: [
+            {
+              type: "script-template",
+              templateId: GTM_EVENT_TEMPLATE_ID,
+              params: { eventData }
+            }
+          ]
+        };
+      }
+      const initialData = {};
+      if (event.userContext?.userId) {
+        initialData.userId = event.userContext.userId;
+      }
+      if (event.anonymousUserId) {
+        initialData.anonymousUserId = event.anonymousUserId;
+      }
+      const traits = event.userContext?.traits;
+      if (traits && Object.keys(traits).length > 0) {
+        initialData.userTraits = traits;
+      }
+      const pageData = {
+        event: "page_view",
+        eventId: event.eventId,
+        page_path: event.serverContext.path,
+        page_title: event.properties.title ?? void 0,
+        page_location: `${event.serverContext.host}${event.serverContext.path}`
+      };
+      if (event.clientContext) {
+        return {
+          items: [
+            {
+              type: "script-template",
+              templateId: GTM_PAGEVIEW_TEMPLATE_ID,
+              params: { pageData }
+            }
+          ]
+        };
+      }
+      return {
+        items: [
+          {
+            type: "script-template",
+            templateId: GTM_INIT_TEMPLATE_ID,
+            params: { containerId, initialData }
+          },
+          {
+            type: "script-template",
+            templateId: GTM_PAGEVIEW_TEMPLATE_ID,
+            params: { pageData }
+          }
+        ]
+      };
+    },
+    updateEvent() {
+    }
+  };
+}
+export {
+  googleTagManagerBackend
+};

package/dist/backends/lib/db.cjs

@@ -0,0 +1,150 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var db_exports = {};
+__export(db_exports, {
+  eventToJsonRow: () => eventToJsonRow,
+  eventToRow: () => eventToRow,
+  extractClientContext: () => extractClientContext,
+  generateChCreateTableSQL: () => generateChCreateTableSQL,
+  generatePgCreateTableSQL: () => generatePgCreateTableSQL,
+  isChTableNotFoundError: () => isChTableNotFoundError,
+  isPgTableNotFoundError: () => isPgTableNotFoundError,
+  tableColumns: () => tableColumns
+});
+module.exports = __toCommonJS(db_exports);
+const tableColumns = [
+  { name: "event_id", pgType: "TEXT PRIMARY KEY", chType: "String" },
+  { name: "parent_event_id", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "timestamp", pgType: "TIMESTAMPTZ", chType: "DateTime64(3)" },
+  { name: "type", pgType: "TEXT", chType: "LowCardinality(String)" },
+  { name: "anonymous_user_id", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "user_id", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "user_email", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "user_name", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "host", pgType: "TEXT", chType: "LowCardinality(String)" },
+  { name: "method", pgType: "TEXT", chType: "LowCardinality(String)" },
+  { name: "path", pgType: "TEXT", chType: "String" },
+  { name: "ip", pgType: "INET", chType: "Nullable(IPv6)" },
+  { name: "referer", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "user_agent", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "locale", pgType: "TEXT", chType: "LowCardinality(Nullable(String))" },
+  { name: "server_context", pgType: "JSONB", chType: "JSON" },
+  { name: "client_context", pgType: "JSONB", chType: "JSON" },
+  { name: "user_traits", pgType: "JSONB", chType: "JSON" },
+  { name: "properties", pgType: "JSONB", chType: "JSON" }
+];
+function extractClientContext(ctx, serverCtx) {
+  const serverReferer = serverCtx?.requestHeaders?.["referer"];
+  const serverUserAgent = serverCtx?.requestHeaders?.["user-agent"];
+  const serverLocale = serverCtx?.requestHeaders?.["accept-language"]?.split(",")[0];
+  if (!ctx) {
+    return {
+      referer: serverReferer,
+      user_agent: serverUserAgent,
+      locale: serverLocale,
+      rest: null
+    };
+  }
+  const { referer, userAgent, locale, ...rest } = ctx;
+  return {
+    referer: referer ?? serverReferer,
+    user_agent: userAgent ?? serverUserAgent,
+    locale: locale ?? serverLocale,
+    rest: Object.keys(rest).length > 0 ? rest : null
+  };
+}
+function extractCommonFields(event) {
+  const { host, method, path, ip, ...serverContextRest } = event.serverContext;
+  const clientCtx = extractClientContext(event.clientContext, event.serverContext);
+  const userTraitsRest = event.userContext?.traits ? (() => {
+    const { email: _email, name: _name, ...rest } = event.userContext.traits;
+    return Object.keys(rest).length > 0 ? rest : null;
+  })() : null;
+  return {
+    event_id: event.eventId,
+    parent_event_id: event.parentEventId ?? null,
+    timestamp: event.collectedAt,
+    type: event.type,
+    anonymous_user_id: event.anonymousUserId ?? null,
+    user_id: event.userContext?.userId ?? null,
+    user_email: event.userContext?.traits?.email ?? null,
+    user_name: event.userContext?.traits?.name ?? null,
+    host,
+    method,
+    path,
+    ip: ip || null,
+    referer: clientCtx.referer ?? null,
+    user_agent: clientCtx.user_agent ?? null,
+    locale: clientCtx.locale ?? null,
+    serverContextRest,
+    clientContextRest: clientCtx.rest,
+    userTraitsRest,
+    properties: event.properties
+  };
+}
+function eventToRow(event) {
+  const { serverContextRest, clientContextRest, userTraitsRest, properties, ...common } = extractCommonFields(event);
+  return {
+    ...common,
+    server_context: JSON.stringify(serverContextRest),
+    client_context: clientContextRest ? JSON.stringify(clientContextRest) : null,
+    user_traits: userTraitsRest ? JSON.stringify(userTraitsRest) : null,
+    properties: JSON.stringify(properties)
+  };
+}
+function eventToJsonRow(event) {
+  const { serverContextRest, clientContextRest, userTraitsRest, ...common } = extractCommonFields(event);
+  return {
+    ...common,
+    server_context: serverContextRest,
+    client_context: clientContextRest ?? {},
+    user_traits: userTraitsRest ?? {}
+  };
+}
+function generatePgCreateTableSQL(tableName) {
+  const pk = tableColumns[0];
+  const alters = tableColumns.slice(1).map((col) => `ALTER TABLE ${tableName} ADD COLUMN IF NOT EXISTS ${col.name} ${col.pgType};`).join("\n");
+  return `CREATE TABLE IF NOT EXISTS ${tableName} (${pk.name} ${pk.pgType});
+${alters}`;
+}
+function isPgTableNotFoundError(err) {
+  return err instanceof Error && err.message.includes("does not exist");
+}
+function generateChCreateTableSQL(database, tableName) {
+  const fullTable = `${database}.${tableName}`;
+  const createCols = tableColumns.filter((c) => c.name === "event_id" || c.name === "timestamp").map((c) => `${c.name} ${c.chType}`).join(", ");
+  const create = `CREATE TABLE IF NOT EXISTS ${fullTable} (${createCols}) ENGINE = ReplacingMergeTree() PARTITION BY toYYYYMM(timestamp) ORDER BY event_id;`;
+  const alters = tableColumns.filter((c) => c.name !== "event_id" && c.name !== "timestamp").map((c) => `ALTER TABLE ${fullTable} ADD COLUMN IF NOT EXISTS ${c.name} ${c.chType};`).join("\n");
+  return `${create}
+${alters}`;
+}
+function isChTableNotFoundError(text) {
+  return text.includes("UNKNOWN_TABLE") || text.includes("doesn't exist");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  eventToJsonRow,
+  eventToRow,
+  extractClientContext,
+  generateChCreateTableSQL,
+  generatePgCreateTableSQL,
+  isChTableNotFoundError,
+  isPgTableNotFoundError,
+  tableColumns
+});

package/dist/backends/lib/db.d.mts

@@ -0,0 +1,121 @@
+import { NextlyticsEvent, ClientContext, ServerEventContext } from '../../types.mjs';
+import 'next/dist/server/web/spec-extension/cookies';
+import 'next/server';
+
+declare const tableColumns: readonly [{
+    readonly name: "event_id";
+    readonly pgType: "TEXT PRIMARY KEY";
+    readonly chType: "String";
+}, {
+    readonly name: "parent_event_id";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "timestamp";
+    readonly pgType: "TIMESTAMPTZ";
+    readonly chType: "DateTime64(3)";
+}, {
+    readonly name: "type";
+    readonly pgType: "TEXT";
+    readonly chType: "LowCardinality(String)";
+}, {
+    readonly name: "anonymous_user_id";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "user_id";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "user_email";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "user_name";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "host";
+    readonly pgType: "TEXT";
+    readonly chType: "LowCardinality(String)";
+}, {
+    readonly name: "method";
+    readonly pgType: "TEXT";
+    readonly chType: "LowCardinality(String)";
+}, {
+    readonly name: "path";
+    readonly pgType: "TEXT";
+    readonly chType: "String";
+}, {
+    readonly name: "ip";
+    readonly pgType: "INET";
+    readonly chType: "Nullable(IPv6)";
+}, {
+    readonly name: "referer";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "user_agent";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "locale";
+    readonly pgType: "TEXT";
+    readonly chType: "LowCardinality(Nullable(String))";
+}, {
+    readonly name: "server_context";
+    readonly pgType: "JSONB";
+    readonly chType: "JSON";
+}, {
+    readonly name: "client_context";
+    readonly pgType: "JSONB";
+    readonly chType: "JSON";
+}, {
+    readonly name: "user_traits";
+    readonly pgType: "JSONB";
+    readonly chType: "JSON";
+}, {
+    readonly name: "properties";
+    readonly pgType: "JSONB";
+    readonly chType: "JSON";
+}];
+type ColumnName = (typeof tableColumns)[number]["name"];
+type ClientContextColumns = {
+    referer: string | undefined;
+    user_agent: string | undefined;
+    locale: string | undefined;
+    rest: Record<string, unknown> | null;
+};
+declare function extractClientContext(ctx: ClientContext | undefined, serverCtx?: ServerEventContext): ClientContextColumns;
+/** For PostgreSQL - JSON fields as strings */
+declare function eventToRow(event: NextlyticsEvent): Record<ColumnName, unknown>;
+/** For ClickHouse/PostgREST - JSON fields as objects */
+declare function eventToJsonRow(event: NextlyticsEvent): Record<ColumnName, unknown>;
+declare function generatePgCreateTableSQL(tableName: string): string;
+declare function isPgTableNotFoundError(err: unknown): boolean;
+declare function generateChCreateTableSQL(database: string, tableName: string): string;
+declare function isChTableNotFoundError(text: string): boolean;
+/** Row type returned from analytics table queries */
+interface AnalyticsEventRow {
+    event_id: string;
+    parent_event_id: string | null;
+    timestamp: string;
+    type: string;
+    anonymous_user_id: string | null;
+    user_id: string | null;
+    user_email: string | null;
+    user_name: string | null;
+    host: string;
+    method: string;
+    path: string;
+    ip: string | null;
+    referer: string | null;
+    user_agent: string | null;
+    locale: string | null;
+    server_context: Record<string, unknown>;
+    client_context: Record<string, unknown>;
+    user_traits: Record<string, unknown>;
+    properties: Record<string, unknown>;
+}
+
+export { type AnalyticsEventRow, type ClientContextColumns, type ColumnName, eventToJsonRow, eventToRow, extractClientContext, generateChCreateTableSQL, generatePgCreateTableSQL, isChTableNotFoundError, isPgTableNotFoundError, tableColumns };

package/dist/backends/lib/db.d.ts

@@ -0,0 +1,121 @@
+import { NextlyticsEvent, ClientContext, ServerEventContext } from '../../types.js';
+import 'next/dist/server/web/spec-extension/cookies';
+import 'next/server';
+
+declare const tableColumns: readonly [{
+    readonly name: "event_id";
+    readonly pgType: "TEXT PRIMARY KEY";
+    readonly chType: "String";
+}, {
+    readonly name: "parent_event_id";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "timestamp";
+    readonly pgType: "TIMESTAMPTZ";
+    readonly chType: "DateTime64(3)";
+}, {
+    readonly name: "type";
+    readonly pgType: "TEXT";
+    readonly chType: "LowCardinality(String)";
+}, {
+    readonly name: "anonymous_user_id";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "user_id";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "user_email";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "user_name";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "host";
+    readonly pgType: "TEXT";
+    readonly chType: "LowCardinality(String)";
+}, {
+    readonly name: "method";
+    readonly pgType: "TEXT";
+    readonly chType: "LowCardinality(String)";
+}, {
+    readonly name: "path";
+    readonly pgType: "TEXT";
+    readonly chType: "String";
+}, {
+    readonly name: "ip";
+    readonly pgType: "INET";
+    readonly chType: "Nullable(IPv6)";
+}, {
+    readonly name: "referer";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "user_agent";
+    readonly pgType: "TEXT";
+    readonly chType: "Nullable(String)";
+}, {
+    readonly name: "locale";
+    readonly pgType: "TEXT";
+    readonly chType: "LowCardinality(Nullable(String))";
+}, {
+    readonly name: "server_context";
+    readonly pgType: "JSONB";
+    readonly chType: "JSON";
+}, {
+    readonly name: "client_context";
+    readonly pgType: "JSONB";
+    readonly chType: "JSON";
+}, {
+    readonly name: "user_traits";
+    readonly pgType: "JSONB";
+    readonly chType: "JSON";
+}, {
+    readonly name: "properties";
+    readonly pgType: "JSONB";
+    readonly chType: "JSON";
+}];
+type ColumnName = (typeof tableColumns)[number]["name"];
+type ClientContextColumns = {
+    referer: string | undefined;
+    user_agent: string | undefined;
+    locale: string | undefined;
+    rest: Record<string, unknown> | null;
+};
+declare function extractClientContext(ctx: ClientContext | undefined, serverCtx?: ServerEventContext): ClientContextColumns;
+/** For PostgreSQL - JSON fields as strings */
+declare function eventToRow(event: NextlyticsEvent): Record<ColumnName, unknown>;
+/** For ClickHouse/PostgREST - JSON fields as objects */
+declare function eventToJsonRow(event: NextlyticsEvent): Record<ColumnName, unknown>;
+declare function generatePgCreateTableSQL(tableName: string): string;
+declare function isPgTableNotFoundError(err: unknown): boolean;
+declare function generateChCreateTableSQL(database: string, tableName: string): string;
+declare function isChTableNotFoundError(text: string): boolean;
+/** Row type returned from analytics table queries */
+interface AnalyticsEventRow {
+    event_id: string;
+    parent_event_id: string | null;
+    timestamp: string;
+    type: string;
+    anonymous_user_id: string | null;
+    user_id: string | null;
+    user_email: string | null;
+    user_name: string | null;
+    host: string;
+    method: string;
+    path: string;
+    ip: string | null;
+    referer: string | null;
+    user_agent: string | null;
+    locale: string | null;
+    server_context: Record<string, unknown>;
+    client_context: Record<string, unknown>;
+    user_traits: Record<string, unknown>;
+    properties: Record<string, unknown>;
+}
+
+export { type AnalyticsEventRow, type ClientContextColumns, type ColumnName, eventToJsonRow, eventToRow, extractClientContext, generateChCreateTableSQL, generatePgCreateTableSQL, isChTableNotFoundError, isPgTableNotFoundError, tableColumns };

package/dist/backends/lib/db.js

@@ -0,0 +1,119 @@
+const tableColumns = [
+  { name: "event_id", pgType: "TEXT PRIMARY KEY", chType: "String" },
+  { name: "parent_event_id", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "timestamp", pgType: "TIMESTAMPTZ", chType: "DateTime64(3)" },
+  { name: "type", pgType: "TEXT", chType: "LowCardinality(String)" },
+  { name: "anonymous_user_id", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "user_id", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "user_email", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "user_name", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "host", pgType: "TEXT", chType: "LowCardinality(String)" },
+  { name: "method", pgType: "TEXT", chType: "LowCardinality(String)" },
+  { name: "path", pgType: "TEXT", chType: "String" },
+  { name: "ip", pgType: "INET", chType: "Nullable(IPv6)" },
+  { name: "referer", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "user_agent", pgType: "TEXT", chType: "Nullable(String)" },
+  { name: "locale", pgType: "TEXT", chType: "LowCardinality(Nullable(String))" },
+  { name: "server_context", pgType: "JSONB", chType: "JSON" },
+  { name: "client_context", pgType: "JSONB", chType: "JSON" },
+  { name: "user_traits", pgType: "JSONB", chType: "JSON" },
+  { name: "properties", pgType: "JSONB", chType: "JSON" }
+];
+function extractClientContext(ctx, serverCtx) {
+  const serverReferer = serverCtx?.requestHeaders?.["referer"];
+  const serverUserAgent = serverCtx?.requestHeaders?.["user-agent"];
+  const serverLocale = serverCtx?.requestHeaders?.["accept-language"]?.split(",")[0];
+  if (!ctx) {
+    return {
+      referer: serverReferer,
+      user_agent: serverUserAgent,
+      locale: serverLocale,
+      rest: null
+    };
+  }
+  const { referer, userAgent, locale, ...rest } = ctx;
+  return {
+    referer: referer ?? serverReferer,
+    user_agent: userAgent ?? serverUserAgent,
+    locale: locale ?? serverLocale,
+    rest: Object.keys(rest).length > 0 ? rest : null
+  };
+}
+function extractCommonFields(event) {
+  const { host, method, path, ip, ...serverContextRest } = event.serverContext;
+  const clientCtx = extractClientContext(event.clientContext, event.serverContext);
+  const userTraitsRest = event.userContext?.traits ? (() => {
+    const { email: _email, name: _name, ...rest } = event.userContext.traits;
+    return Object.keys(rest).length > 0 ? rest : null;
+  })() : null;
+  return {
+    event_id: event.eventId,
+    parent_event_id: event.parentEventId ?? null,
+    timestamp: event.collectedAt,
+    type: event.type,
+    anonymous_user_id: event.anonymousUserId ?? null,
+    user_id: event.userContext?.userId ?? null,
+    user_email: event.userContext?.traits?.email ?? null,
+    user_name: event.userContext?.traits?.name ?? null,
+    host,
+    method,
+    path,
+    ip: ip || null,
+    referer: clientCtx.referer ?? null,
+    user_agent: clientCtx.user_agent ?? null,
+    locale: clientCtx.locale ?? null,
+    serverContextRest,
+    clientContextRest: clientCtx.rest,
+    userTraitsRest,
+    properties: event.properties
+  };
+}
+function eventToRow(event) {
+  const { serverContextRest, clientContextRest, userTraitsRest, properties, ...common } = extractCommonFields(event);
+  return {
+    ...common,
+    server_context: JSON.stringify(serverContextRest),
+    client_context: clientContextRest ? JSON.stringify(clientContextRest) : null,
+    user_traits: userTraitsRest ? JSON.stringify(userTraitsRest) : null,
+    properties: JSON.stringify(properties)
+  };
+}
+function eventToJsonRow(event) {
+  const { serverContextRest, clientContextRest, userTraitsRest, ...common } = extractCommonFields(event);
+  return {
+    ...common,
+    server_context: serverContextRest,
+    client_context: clientContextRest ?? {},
+    user_traits: userTraitsRest ?? {}
+  };
+}
+function generatePgCreateTableSQL(tableName) {
+  const pk = tableColumns[0];
+  const alters = tableColumns.slice(1).map((col) => `ALTER TABLE ${tableName} ADD COLUMN IF NOT EXISTS ${col.name} ${col.pgType};`).join("\n");
+  return `CREATE TABLE IF NOT EXISTS ${tableName} (${pk.name} ${pk.pgType});
+${alters}`;
+}
+function isPgTableNotFoundError(err) {
+  return err instanceof Error && err.message.includes("does not exist");
+}
+function generateChCreateTableSQL(database, tableName) {
+  const fullTable = `${database}.${tableName}`;
+  const createCols = tableColumns.filter((c) => c.name === "event_id" || c.name === "timestamp").map((c) => `${c.name} ${c.chType}`).join(", ");
+  const create = `CREATE TABLE IF NOT EXISTS ${fullTable} (${createCols}) ENGINE = ReplacingMergeTree() PARTITION BY toYYYYMM(timestamp) ORDER BY event_id;`;
+  const alters = tableColumns.filter((c) => c.name !== "event_id" && c.name !== "timestamp").map((c) => `ALTER TABLE ${fullTable} ADD COLUMN IF NOT EXISTS ${c.name} ${c.chType};`).join("\n");
+  return `${create}
+${alters}`;
+}
+function isChTableNotFoundError(text) {
+  return text.includes("UNKNOWN_TABLE") || text.includes("doesn't exist");
+}
+export {
+  eventToJsonRow,
+  eventToRow,
+  extractClientContext,
+  generateChCreateTableSQL,
+  generatePgCreateTableSQL,
+  isChTableNotFoundError,
+  isPgTableNotFoundError,
+  tableColumns
+};

package/dist/backends/logging.cjs

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var logging_exports = {};
+__export(logging_exports, {
+  loggingBackend: () => loggingBackend
+});
+module.exports = __toCommonJS(logging_exports);
+function loggingBackend() {
+  return {
+    name: "logging",
+    supportsUpdates: true,
+    async onEvent(event) {
+      const { type, eventId, serverContext, ...rest } = event;
+      const method = serverContext?.method || "";
+      const path = serverContext?.path || "";
+      const route = method && path ? `${method} ${path}` : "";
+      console.log(`[Nextlytics Log] ${type}${route ? ` ${route}` : ""} (${eventId})`);
+      console.log(JSON.stringify({ serverContext, ...rest }, null, 2));
+    },
+    updateEvent(eventId, patch) {
+      console.log(`[Nextlytics Log] Update ${eventId}`);
+      console.log(JSON.stringify(patch, null, 2));
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loggingBackend
+});