@snovasys/usage-analytics-sdk 1.0.0

package/dist/clarity.cjs

@@ -0,0 +1,91 @@
+"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);
+
+// clarity.ts
+var clarity_exports = {};
+__export(clarity_exports, {
+  createClarityListener: () => createClarityListener
+});
+module.exports = __toCommonJS(clarity_exports);
+
+// src/listeners/clarity.ts
+var CLARITY_SCRIPT_BASE = "https://www.clarity.ms/tag/";
+function isBrowser() {
+  return typeof window !== "undefined";
+}
+function loadClarityScript(projectId) {
+  return new Promise((resolve) => {
+    if (!isBrowser()) {
+      resolve();
+      return;
+    }
+    if (typeof window.clarity === "function") {
+      resolve();
+      return;
+    }
+    const script = document.createElement("script");
+    script.async = true;
+    script.src = `${CLARITY_SCRIPT_BASE}${encodeURIComponent(projectId)}`;
+    script.onload = () => resolve();
+    script.onerror = () => resolve();
+    document.head.appendChild(script);
+  });
+}
+function createClarityListener(config) {
+  const projectId = config.projectId;
+  let ready = false;
+  return {
+    async init(cfg) {
+      try {
+        const c = cfg ?? config;
+        const id = c.projectId;
+        if (!id || !isBrowser()) return;
+        await loadClarityScript(id);
+        ready = true;
+      } catch {
+      }
+    },
+    track(envelope) {
+      try {
+        if (!isBrowser() || !ready || typeof window.clarity !== "function") return;
+        window.clarity("event", envelope.name);
+        if (envelope.properties && typeof window.clarity === "function") {
+          for (const [key, value] of Object.entries(envelope.properties)) {
+            if (typeof value === "string" || Array.isArray(value)) {
+              window.clarity("set", key, value);
+            }
+          }
+        }
+      } catch {
+      }
+    },
+    identify(userId, _traits) {
+      try {
+        if (!isBrowser() || !ready || typeof window.clarity !== "function") return;
+        window.clarity("identify", userId, void 0, void 0, void 0);
+      } catch {
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createClarityListener
+});
+//# sourceMappingURL=clarity.cjs.map

package/dist/clarity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../clarity.ts","../src/listeners/clarity.ts"],"sourcesContent":["/**\n * Entry point: @snovasys/usage-analytics-sdk/clarity\n * Export Clarity listener factory for manual wiring or use via built-in registry (id: clarity).\n */\nexport { createClarityListener } from './src/listeners/clarity.js';\nexport type { ClarityListenerConfig } from './src/listeners/clarity.js';\nexport type { AnalyticsListener, EventEnvelope } from './src/types/index.js';\n","import type { AnalyticsListener } from '../types/listener.js';\nimport type { EventEnvelope } from '../types/envelope.js';\n\nexport interface ClarityListenerConfig {\n  projectId: string;\n}\n\nconst CLARITY_SCRIPT_BASE = 'https://www.clarity.ms/tag/';\n\ndeclare global {\n  interface Window {\n    clarity?: (cmd: string, ...args: unknown[]) => void;\n  }\n}\n\nfunction isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nfunction loadClarityScript(projectId: string): Promise<void> {\n  return new Promise((resolve) => {\n    if (!isBrowser()) {\n      resolve();\n      return;\n    }\n    if (typeof window.clarity === 'function') {\n      resolve();\n      return;\n    }\n    const script = document.createElement('script');\n    script.async = true;\n    script.src = `${CLARITY_SCRIPT_BASE}${encodeURIComponent(projectId)}`;\n    script.onload = () => resolve();\n    script.onerror = () => resolve();\n    document.head.appendChild(script);\n  });\n}\n\n/**\n * Listener that sends events to Microsoft Clarity via script injection.\n * Loads Clarity script with projectId; track → clarity(\"event\", name); identify → clarity(\"identify\", userId, ...).\n * No-op when typeof window === 'undefined' (SSR).\n */\nexport function createClarityListener(config: ClarityListenerConfig): AnalyticsListener {\n  const projectId = config.projectId;\n  let ready = false;\n\n  return {\n    async init(cfg: unknown): Promise<void> {\n      try {\n        const c = (cfg ?? config) as ClarityListenerConfig;\n        const id = c.projectId;\n        if (!id || !isBrowser()) return;\n        await loadClarityScript(id);\n        ready = true;\n      } catch {\n        // swallow\n      }\n    },\n    track(envelope: EventEnvelope): void {\n      try {\n        if (!isBrowser() || !ready || typeof window.clarity !== 'function') return;\n        window.clarity('event', envelope.name);\n        if (envelope.properties && typeof window.clarity === 'function') {\n          for (const [key, value] of Object.entries(envelope.properties)) {\n            if (typeof value === 'string' || Array.isArray(value)) {\n              window.clarity('set', key, value);\n            }\n          }\n        }\n      } catch {\n        // swallow\n      }\n    },\n    identify(userId: string, _traits?: Record<string, unknown>): void {\n      try {\n        if (!isBrowser() || !ready || typeof window.clarity !== 'function') return;\n        window.clarity('identify', userId, undefined, undefined, undefined);\n      } catch {\n        // swallow\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,IAAM,sBAAsB;AAQ5B,SAAS,YAAqB;AAC5B,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,kBAAkB,WAAkC;AAC3D,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,QAAI,CAAC,UAAU,GAAG;AAChB,cAAQ;AACR;AAAA,IACF;AACA,QAAI,OAAO,OAAO,YAAY,YAAY;AACxC,cAAQ;AACR;AAAA,IACF;AACA,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,QAAQ;AACf,WAAO,MAAM,GAAG,mBAAmB,GAAG,mBAAmB,SAAS,CAAC;AACnE,WAAO,SAAS,MAAM,QAAQ;AAC9B,WAAO,UAAU,MAAM,QAAQ;AAC/B,aAAS,KAAK,YAAY,MAAM;AAAA,EAClC,CAAC;AACH;AAOO,SAAS,sBAAsB,QAAkD;AACtF,QAAM,YAAY,OAAO;AACzB,MAAI,QAAQ;AAEZ,SAAO;AAAA,IACL,MAAM,KAAK,KAA6B;AACtC,UAAI;AACF,cAAM,IAAK,OAAO;AAClB,cAAM,KAAK,EAAE;AACb,YAAI,CAAC,MAAM,CAAC,UAAU,EAAG;AACzB,cAAM,kBAAkB,EAAE;AAC1B,gBAAQ;AAAA,MACV,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IACA,MAAM,UAA+B;AACnC,UAAI;AACF,YAAI,CAAC,UAAU,KAAK,CAAC,SAAS,OAAO,OAAO,YAAY,WAAY;AACpE,eAAO,QAAQ,SAAS,SAAS,IAAI;AACrC,YAAI,SAAS,cAAc,OAAO,OAAO,YAAY,YAAY;AAC/D,qBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,UAAU,GAAG;AAC9D,gBAAI,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AACrD,qBAAO,QAAQ,OAAO,KAAK,KAAK;AAAA,YAClC;AAAA,UACF;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IACA,SAAS,QAAgB,SAAyC;AAChE,UAAI;AACF,YAAI,CAAC,UAAU,KAAK,CAAC,SAAS,OAAO,OAAO,YAAY,WAAY;AACpE,eAAO,QAAQ,YAAY,QAAQ,QAAW,QAAW,MAAS;AAAA,MACpE,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/clarity.d.cts

@@ -0,0 +1,19 @@
+import { A as AnalyticsListener } from './listener-CrNaKh1a.cjs';
+export { E as EventEnvelope } from './listener-CrNaKh1a.cjs';
+
+interface ClarityListenerConfig {
+    projectId: string;
+}
+declare global {
+    interface Window {
+        clarity?: (cmd: string, ...args: unknown[]) => void;
+    }
+}
+/**
+ * Listener that sends events to Microsoft Clarity via script injection.
+ * Loads Clarity script with projectId; track → clarity("event", name); identify → clarity("identify", userId, ...).
+ * No-op when typeof window === 'undefined' (SSR).
+ */
+declare function createClarityListener(config: ClarityListenerConfig): AnalyticsListener;
+
+export { AnalyticsListener, type ClarityListenerConfig, createClarityListener };

package/dist/clarity.d.ts

@@ -0,0 +1,19 @@
+import { A as AnalyticsListener } from './listener-CrNaKh1a.js';
+export { E as EventEnvelope } from './listener-CrNaKh1a.js';
+
+interface ClarityListenerConfig {
+    projectId: string;
+}
+declare global {
+    interface Window {
+        clarity?: (cmd: string, ...args: unknown[]) => void;
+    }
+}
+/**
+ * Listener that sends events to Microsoft Clarity via script injection.
+ * Loads Clarity script with projectId; track → clarity("event", name); identify → clarity("identify", userId, ...).
+ * No-op when typeof window === 'undefined' (SSR).
+ */
+declare function createClarityListener(config: ClarityListenerConfig): AnalyticsListener;
+
+export { AnalyticsListener, type ClarityListenerConfig, createClarityListener };

package/dist/clarity.js

@@ -0,0 +1,64 @@
+// src/listeners/clarity.ts
+var CLARITY_SCRIPT_BASE = "https://www.clarity.ms/tag/";
+function isBrowser() {
+  return typeof window !== "undefined";
+}
+function loadClarityScript(projectId) {
+  return new Promise((resolve) => {
+    if (!isBrowser()) {
+      resolve();
+      return;
+    }
+    if (typeof window.clarity === "function") {
+      resolve();
+      return;
+    }
+    const script = document.createElement("script");
+    script.async = true;
+    script.src = `${CLARITY_SCRIPT_BASE}${encodeURIComponent(projectId)}`;
+    script.onload = () => resolve();
+    script.onerror = () => resolve();
+    document.head.appendChild(script);
+  });
+}
+function createClarityListener(config) {
+  const projectId = config.projectId;
+  let ready = false;
+  return {
+    async init(cfg) {
+      try {
+        const c = cfg ?? config;
+        const id = c.projectId;
+        if (!id || !isBrowser()) return;
+        await loadClarityScript(id);
+        ready = true;
+      } catch {
+      }
+    },
+    track(envelope) {
+      try {
+        if (!isBrowser() || !ready || typeof window.clarity !== "function") return;
+        window.clarity("event", envelope.name);
+        if (envelope.properties && typeof window.clarity === "function") {
+          for (const [key, value] of Object.entries(envelope.properties)) {
+            if (typeof value === "string" || Array.isArray(value)) {
+              window.clarity("set", key, value);
+            }
+          }
+        }
+      } catch {
+      }
+    },
+    identify(userId, _traits) {
+      try {
+        if (!isBrowser() || !ready || typeof window.clarity !== "function") return;
+        window.clarity("identify", userId, void 0, void 0, void 0);
+      } catch {
+      }
+    }
+  };
+}
+export {
+  createClarityListener
+};
+//# sourceMappingURL=clarity.js.map

package/dist/clarity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/listeners/clarity.ts"],"sourcesContent":["import type { AnalyticsListener } from '../types/listener.js';\nimport type { EventEnvelope } from '../types/envelope.js';\n\nexport interface ClarityListenerConfig {\n  projectId: string;\n}\n\nconst CLARITY_SCRIPT_BASE = 'https://www.clarity.ms/tag/';\n\ndeclare global {\n  interface Window {\n    clarity?: (cmd: string, ...args: unknown[]) => void;\n  }\n}\n\nfunction isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nfunction loadClarityScript(projectId: string): Promise<void> {\n  return new Promise((resolve) => {\n    if (!isBrowser()) {\n      resolve();\n      return;\n    }\n    if (typeof window.clarity === 'function') {\n      resolve();\n      return;\n    }\n    const script = document.createElement('script');\n    script.async = true;\n    script.src = `${CLARITY_SCRIPT_BASE}${encodeURIComponent(projectId)}`;\n    script.onload = () => resolve();\n    script.onerror = () => resolve();\n    document.head.appendChild(script);\n  });\n}\n\n/**\n * Listener that sends events to Microsoft Clarity via script injection.\n * Loads Clarity script with projectId; track → clarity(\"event\", name); identify → clarity(\"identify\", userId, ...).\n * No-op when typeof window === 'undefined' (SSR).\n */\nexport function createClarityListener(config: ClarityListenerConfig): AnalyticsListener {\n  const projectId = config.projectId;\n  let ready = false;\n\n  return {\n    async init(cfg: unknown): Promise<void> {\n      try {\n        const c = (cfg ?? config) as ClarityListenerConfig;\n        const id = c.projectId;\n        if (!id || !isBrowser()) return;\n        await loadClarityScript(id);\n        ready = true;\n      } catch {\n        // swallow\n      }\n    },\n    track(envelope: EventEnvelope): void {\n      try {\n        if (!isBrowser() || !ready || typeof window.clarity !== 'function') return;\n        window.clarity('event', envelope.name);\n        if (envelope.properties && typeof window.clarity === 'function') {\n          for (const [key, value] of Object.entries(envelope.properties)) {\n            if (typeof value === 'string' || Array.isArray(value)) {\n              window.clarity('set', key, value);\n            }\n          }\n        }\n      } catch {\n        // swallow\n      }\n    },\n    identify(userId: string, _traits?: Record<string, unknown>): void {\n      try {\n        if (!isBrowser() || !ready || typeof window.clarity !== 'function') return;\n        window.clarity('identify', userId, undefined, undefined, undefined);\n      } catch {\n        // swallow\n      }\n    },\n  };\n}\n"],"mappings":";AAOA,IAAM,sBAAsB;AAQ5B,SAAS,YAAqB;AAC5B,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,kBAAkB,WAAkC;AAC3D,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,QAAI,CAAC,UAAU,GAAG;AAChB,cAAQ;AACR;AAAA,IACF;AACA,QAAI,OAAO,OAAO,YAAY,YAAY;AACxC,cAAQ;AACR;AAAA,IACF;AACA,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,QAAQ;AACf,WAAO,MAAM,GAAG,mBAAmB,GAAG,mBAAmB,SAAS,CAAC;AACnE,WAAO,SAAS,MAAM,QAAQ;AAC9B,WAAO,UAAU,MAAM,QAAQ;AAC/B,aAAS,KAAK,YAAY,MAAM;AAAA,EAClC,CAAC;AACH;AAOO,SAAS,sBAAsB,QAAkD;AACtF,QAAM,YAAY,OAAO;AACzB,MAAI,QAAQ;AAEZ,SAAO;AAAA,IACL,MAAM,KAAK,KAA6B;AACtC,UAAI;AACF,cAAM,IAAK,OAAO;AAClB,cAAM,KAAK,EAAE;AACb,YAAI,CAAC,MAAM,CAAC,UAAU,EAAG;AACzB,cAAM,kBAAkB,EAAE;AAC1B,gBAAQ;AAAA,MACV,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IACA,MAAM,UAA+B;AACnC,UAAI;AACF,YAAI,CAAC,UAAU,KAAK,CAAC,SAAS,OAAO,OAAO,YAAY,WAAY;AACpE,eAAO,QAAQ,SAAS,SAAS,IAAI;AACrC,YAAI,SAAS,cAAc,OAAO,OAAO,YAAY,YAAY;AAC/D,qBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,UAAU,GAAG;AAC9D,gBAAI,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AACrD,qBAAO,QAAQ,OAAO,KAAK,KAAK;AAAA,YAClC;AAAA,UACF;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IACA,SAAS,QAAgB,SAAyC;AAChE,UAAI;AACF,YAAI,CAAC,UAAU,KAAK,CAAC,SAAS,OAAO,OAAO,YAAY,WAAY;AACpE,eAAO,QAAQ,YAAY,QAAQ,QAAW,QAAW,MAAS;AAAA,MACpE,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/custom-api.cjs

@@ -0,0 +1,98 @@
+"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);
+
+// custom-api.ts
+var custom_api_exports = {};
+__export(custom_api_exports, {
+  createCustomApiListener: () => createCustomApiListener
+});
+module.exports = __toCommonJS(custom_api_exports);
+
+// src/listeners/custom-api.ts
+var DEFAULT_BATCH_SIZE = 1;
+var DEFAULT_FLUSH_INTERVAL_MS = 5e3;
+function createCustomApiListener(config) {
+  const endpoint = config.endpoint;
+  const apiKey = config.apiKey;
+  const batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;
+  const flushIntervalMs = config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+  let batch = [];
+  let flushTimer = null;
+  function scheduleFlush() {
+    if (flushTimer != null) return;
+    flushTimer = setTimeout(() => {
+      flushTimer = null;
+      sendBatch();
+    }, flushIntervalMs);
+  }
+  function sendBatch() {
+    if (batch.length === 0) return;
+    const toSend = [...batch];
+    batch = [];
+    const body = JSON.stringify(toSend.length === 1 ? toSend[0] : { events: toSend });
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
+    if (typeof fetch !== "undefined") {
+      fetch(endpoint, {
+        method: "POST",
+        headers,
+        body,
+        keepalive: true
+      }).catch(() => {
+      });
+    }
+  }
+  return {
+    init(_config) {
+    },
+    track(envelope) {
+      try {
+        batch.push(envelope);
+        if (batch.length >= batchSize) {
+          sendBatch();
+        } else if (flushIntervalMs > 0) {
+          scheduleFlush();
+        }
+      } catch {
+      }
+    },
+    flush() {
+      if (flushTimer != null) {
+        clearTimeout(flushTimer);
+        flushTimer = null;
+      }
+      sendBatch();
+      return Promise.resolve();
+    },
+    teardown() {
+      if (flushTimer != null) {
+        clearTimeout(flushTimer);
+        flushTimer = null;
+      }
+      batch.length = 0;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCustomApiListener
+});
+//# sourceMappingURL=custom-api.cjs.map

package/dist/custom-api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../custom-api.ts","../src/listeners/custom-api.ts"],"sourcesContent":["/**\n * Entry point: @snovasys/usage-analytics-sdk/custom-api\n * Export custom API listener factory for apps that send events to their backend.\n */\nexport { createCustomApiListener } from './src/listeners/custom-api.js';\nexport type { CustomApiListenerConfig } from './src/listeners/custom-api.js';\nexport type { AnalyticsListener, EventEnvelope } from './src/types/index.js';\n","import type { AnalyticsListener } from '../types/listener.js';\nimport type { EventEnvelope } from '../types/envelope.js';\n\nexport interface CustomApiListenerConfig {\n  /** Endpoint URL for POST (e.g. https://api.example.com/analytics/events). */\n  endpoint: string;\n  /** Optional API key or bearer token. */\n  apiKey?: string;\n  /** Optional: batch size before sending. Default 1 (no batching). */\n  batchSize?: number;\n  /** Optional: max ms to wait before sending a partial batch. Default 5000. */\n  flushIntervalMs?: number;\n}\n\nconst DEFAULT_BATCH_SIZE = 1;\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\n\n/**\n * Listener that POSTs events to a configurable endpoint.\n * Optional batching: accumulates events and sends when batchSize or flushIntervalMs is reached.\n */\nexport function createCustomApiListener(config: CustomApiListenerConfig): AnalyticsListener {\n  const endpoint = config.endpoint;\n  const apiKey = config.apiKey;\n  const batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;\n  const flushIntervalMs = config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;\n\n  let batch: EventEnvelope[] = [];\n  let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  function scheduleFlush(): void {\n    if (flushTimer != null) return;\n    flushTimer = setTimeout(() => {\n      flushTimer = null;\n      sendBatch();\n    }, flushIntervalMs);\n  }\n\n  function sendBatch(): void {\n    if (batch.length === 0) return;\n    const toSend = [...batch];\n    batch = [];\n    const body = JSON.stringify(toSend.length === 1 ? toSend[0] : { events: toSend });\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    };\n    if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;\n    if (typeof fetch !== 'undefined') {\n      fetch(endpoint, {\n        method: 'POST',\n        headers,\n        body,\n        keepalive: true,\n      }).catch(() => {});\n    }\n  }\n\n  return {\n    init(_config: unknown): void {\n      // config was passed at createCustomApiListener\n    },\n    track(envelope: EventEnvelope): void {\n      try {\n        batch.push(envelope);\n        if (batch.length >= batchSize) {\n          sendBatch();\n        } else if (flushIntervalMs > 0) {\n          scheduleFlush();\n        }\n      } catch {\n        // swallow\n      }\n    },\n    flush(): Promise<void> {\n      if (flushTimer != null) {\n        clearTimeout(flushTimer);\n        flushTimer = null;\n      }\n      sendBatch();\n      return Promise.resolve();\n    },\n    teardown(): void {\n      if (flushTimer != null) {\n        clearTimeout(flushTimer);\n        flushTimer = null;\n      }\n      batch.length = 0;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcA,IAAM,qBAAqB;AAC3B,IAAM,4BAA4B;AAM3B,SAAS,wBAAwB,QAAoD;AAC1F,QAAM,WAAW,OAAO;AACxB,QAAM,SAAS,OAAO;AACtB,QAAM,YAAY,OAAO,aAAa;AACtC,QAAM,kBAAkB,OAAO,mBAAmB;AAElD,MAAI,QAAyB,CAAC;AAC9B,MAAI,aAAmD;AAEvD,WAAS,gBAAsB;AAC7B,QAAI,cAAc,KAAM;AACxB,iBAAa,WAAW,MAAM;AAC5B,mBAAa;AACb,gBAAU;AAAA,IACZ,GAAG,eAAe;AAAA,EACpB;AAEA,WAAS,YAAkB;AACzB,QAAI,MAAM,WAAW,EAAG;AACxB,UAAM,SAAS,CAAC,GAAG,KAAK;AACxB,YAAQ,CAAC;AACT,UAAM,OAAO,KAAK,UAAU,OAAO,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,OAAO,CAAC;AAChF,UAAM,UAAkC;AAAA,MACtC,gBAAgB;AAAA,IAClB;AACA,QAAI,OAAQ,SAAQ,eAAe,IAAI,UAAU,MAAM;AACvD,QAAI,OAAO,UAAU,aAAa;AAChC,YAAM,UAAU;AAAA,QACd,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA,WAAW;AAAA,MACb,CAAC,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,KAAK,SAAwB;AAAA,IAE7B;AAAA,IACA,MAAM,UAA+B;AACnC,UAAI;AACF,cAAM,KAAK,QAAQ;AACnB,YAAI,MAAM,UAAU,WAAW;AAC7B,oBAAU;AAAA,QACZ,WAAW,kBAAkB,GAAG;AAC9B,wBAAc;AAAA,QAChB;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IACA,QAAuB;AACrB,UAAI,cAAc,MAAM;AACtB,qBAAa,UAAU;AACvB,qBAAa;AAAA,MACf;AACA,gBAAU;AACV,aAAO,QAAQ,QAAQ;AAAA,IACzB;AAAA,IACA,WAAiB;AACf,UAAI,cAAc,MAAM;AACtB,qBAAa,UAAU;AACvB,qBAAa;AAAA,MACf;AACA,YAAM,SAAS;AAAA,IACjB;AAAA,EACF;AACF;","names":[]}

package/dist/custom-api.d.cts

@@ -0,0 +1,20 @@
+import { A as AnalyticsListener } from './listener-CrNaKh1a.cjs';
+export { E as EventEnvelope } from './listener-CrNaKh1a.cjs';
+
+interface CustomApiListenerConfig {
+    /** Endpoint URL for POST (e.g. https://api.example.com/analytics/events). */
+    endpoint: string;
+    /** Optional API key or bearer token. */
+    apiKey?: string;
+    /** Optional: batch size before sending. Default 1 (no batching). */
+    batchSize?: number;
+    /** Optional: max ms to wait before sending a partial batch. Default 5000. */
+    flushIntervalMs?: number;
+}
+/**
+ * Listener that POSTs events to a configurable endpoint.
+ * Optional batching: accumulates events and sends when batchSize or flushIntervalMs is reached.
+ */
+declare function createCustomApiListener(config: CustomApiListenerConfig): AnalyticsListener;
+
+export { AnalyticsListener, type CustomApiListenerConfig, createCustomApiListener };

package/dist/custom-api.d.ts

@@ -0,0 +1,20 @@
+import { A as AnalyticsListener } from './listener-CrNaKh1a.js';
+export { E as EventEnvelope } from './listener-CrNaKh1a.js';
+
+interface CustomApiListenerConfig {
+    /** Endpoint URL for POST (e.g. https://api.example.com/analytics/events). */
+    endpoint: string;
+    /** Optional API key or bearer token. */
+    apiKey?: string;
+    /** Optional: batch size before sending. Default 1 (no batching). */
+    batchSize?: number;
+    /** Optional: max ms to wait before sending a partial batch. Default 5000. */
+    flushIntervalMs?: number;
+}
+/**
+ * Listener that POSTs events to a configurable endpoint.
+ * Optional batching: accumulates events and sends when batchSize or flushIntervalMs is reached.
+ */
+declare function createCustomApiListener(config: CustomApiListenerConfig): AnalyticsListener;
+
+export { AnalyticsListener, type CustomApiListenerConfig, createCustomApiListener };

package/dist/custom-api.js

@@ -0,0 +1,71 @@
+// src/listeners/custom-api.ts
+var DEFAULT_BATCH_SIZE = 1;
+var DEFAULT_FLUSH_INTERVAL_MS = 5e3;
+function createCustomApiListener(config) {
+  const endpoint = config.endpoint;
+  const apiKey = config.apiKey;
+  const batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;
+  const flushIntervalMs = config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+  let batch = [];
+  let flushTimer = null;
+  function scheduleFlush() {
+    if (flushTimer != null) return;
+    flushTimer = setTimeout(() => {
+      flushTimer = null;
+      sendBatch();
+    }, flushIntervalMs);
+  }
+  function sendBatch() {
+    if (batch.length === 0) return;
+    const toSend = [...batch];
+    batch = [];
+    const body = JSON.stringify(toSend.length === 1 ? toSend[0] : { events: toSend });
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
+    if (typeof fetch !== "undefined") {
+      fetch(endpoint, {
+        method: "POST",
+        headers,
+        body,
+        keepalive: true
+      }).catch(() => {
+      });
+    }
+  }
+  return {
+    init(_config) {
+    },
+    track(envelope) {
+      try {
+        batch.push(envelope);
+        if (batch.length >= batchSize) {
+          sendBatch();
+        } else if (flushIntervalMs > 0) {
+          scheduleFlush();
+        }
+      } catch {
+      }
+    },
+    flush() {
+      if (flushTimer != null) {
+        clearTimeout(flushTimer);
+        flushTimer = null;
+      }
+      sendBatch();
+      return Promise.resolve();
+    },
+    teardown() {
+      if (flushTimer != null) {
+        clearTimeout(flushTimer);
+        flushTimer = null;
+      }
+      batch.length = 0;
+    }
+  };
+}
+export {
+  createCustomApiListener
+};
+//# sourceMappingURL=custom-api.js.map

package/dist/custom-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/listeners/custom-api.ts"],"sourcesContent":["import type { AnalyticsListener } from '../types/listener.js';\nimport type { EventEnvelope } from '../types/envelope.js';\n\nexport interface CustomApiListenerConfig {\n  /** Endpoint URL for POST (e.g. https://api.example.com/analytics/events). */\n  endpoint: string;\n  /** Optional API key or bearer token. */\n  apiKey?: string;\n  /** Optional: batch size before sending. Default 1 (no batching). */\n  batchSize?: number;\n  /** Optional: max ms to wait before sending a partial batch. Default 5000. */\n  flushIntervalMs?: number;\n}\n\nconst DEFAULT_BATCH_SIZE = 1;\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\n\n/**\n * Listener that POSTs events to a configurable endpoint.\n * Optional batching: accumulates events and sends when batchSize or flushIntervalMs is reached.\n */\nexport function createCustomApiListener(config: CustomApiListenerConfig): AnalyticsListener {\n  const endpoint = config.endpoint;\n  const apiKey = config.apiKey;\n  const batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;\n  const flushIntervalMs = config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;\n\n  let batch: EventEnvelope[] = [];\n  let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  function scheduleFlush(): void {\n    if (flushTimer != null) return;\n    flushTimer = setTimeout(() => {\n      flushTimer = null;\n      sendBatch();\n    }, flushIntervalMs);\n  }\n\n  function sendBatch(): void {\n    if (batch.length === 0) return;\n    const toSend = [...batch];\n    batch = [];\n    const body = JSON.stringify(toSend.length === 1 ? toSend[0] : { events: toSend });\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    };\n    if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;\n    if (typeof fetch !== 'undefined') {\n      fetch(endpoint, {\n        method: 'POST',\n        headers,\n        body,\n        keepalive: true,\n      }).catch(() => {});\n    }\n  }\n\n  return {\n    init(_config: unknown): void {\n      // config was passed at createCustomApiListener\n    },\n    track(envelope: EventEnvelope): void {\n      try {\n        batch.push(envelope);\n        if (batch.length >= batchSize) {\n          sendBatch();\n        } else if (flushIntervalMs > 0) {\n          scheduleFlush();\n        }\n      } catch {\n        // swallow\n      }\n    },\n    flush(): Promise<void> {\n      if (flushTimer != null) {\n        clearTimeout(flushTimer);\n        flushTimer = null;\n      }\n      sendBatch();\n      return Promise.resolve();\n    },\n    teardown(): void {\n      if (flushTimer != null) {\n        clearTimeout(flushTimer);\n        flushTimer = null;\n      }\n      batch.length = 0;\n    },\n  };\n}\n"],"mappings":";AAcA,IAAM,qBAAqB;AAC3B,IAAM,4BAA4B;AAM3B,SAAS,wBAAwB,QAAoD;AAC1F,QAAM,WAAW,OAAO;AACxB,QAAM,SAAS,OAAO;AACtB,QAAM,YAAY,OAAO,aAAa;AACtC,QAAM,kBAAkB,OAAO,mBAAmB;AAElD,MAAI,QAAyB,CAAC;AAC9B,MAAI,aAAmD;AAEvD,WAAS,gBAAsB;AAC7B,QAAI,cAAc,KAAM;AACxB,iBAAa,WAAW,MAAM;AAC5B,mBAAa;AACb,gBAAU;AAAA,IACZ,GAAG,eAAe;AAAA,EACpB;AAEA,WAAS,YAAkB;AACzB,QAAI,MAAM,WAAW,EAAG;AACxB,UAAM,SAAS,CAAC,GAAG,KAAK;AACxB,YAAQ,CAAC;AACT,UAAM,OAAO,KAAK,UAAU,OAAO,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,OAAO,CAAC;AAChF,UAAM,UAAkC;AAAA,MACtC,gBAAgB;AAAA,IAClB;AACA,QAAI,OAAQ,SAAQ,eAAe,IAAI,UAAU,MAAM;AACvD,QAAI,OAAO,UAAU,aAAa;AAChC,YAAM,UAAU;AAAA,QACd,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA,WAAW;AAAA,MACb,CAAC,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,KAAK,SAAwB;AAAA,IAE7B;AAAA,IACA,MAAM,UAA+B;AACnC,UAAI;AACF,cAAM,KAAK,QAAQ;AACnB,YAAI,MAAM,UAAU,WAAW;AAC7B,oBAAU;AAAA,QACZ,WAAW,kBAAkB,GAAG;AAC9B,wBAAc;AAAA,QAChB;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IACA,QAAuB;AACrB,UAAI,cAAc,MAAM;AACtB,qBAAa,UAAU;AACvB,qBAAa;AAAA,MACf;AACA,gBAAU;AACV,aAAO,QAAQ,QAAQ;AAAA,IACzB;AAAA,IACA,WAAiB;AACf,UAAI,cAAc,MAAM;AACtB,qBAAa,UAAU;AACvB,qBAAa;AAAA,MACf;AACA,YAAM,SAAS;AAAA,IACjB;AAAA,EACF;AACF;","names":[]}

package/dist/ga.cjs

@@ -0,0 +1,96 @@
+"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);
+
+// ga.ts
+var ga_exports = {};
+__export(ga_exports, {
+  createGAListener: () => createGAListener
+});
+module.exports = __toCommonJS(ga_exports);
+
+// src/listeners/ga.ts
+var GTAG_SCRIPT_URL = "https://www.googletagmanager.com/gtag/js";
+function isBrowser() {
+  return typeof window !== "undefined";
+}
+function loadGtagScript(measurementId) {
+  return new Promise((resolve) => {
+    if (!isBrowser()) {
+      resolve();
+      return;
+    }
+    if (window.gtag) {
+      window.gtag("config", measurementId);
+      resolve();
+      return;
+    }
+    window.dataLayer = window.dataLayer ?? [];
+    const gtag = (...args) => {
+      window.dataLayer.push(args);
+    };
+    window.gtag = gtag;
+    gtag("js", /* @__PURE__ */ new Date());
+    const script = document.createElement("script");
+    script.async = true;
+    script.src = `${GTAG_SCRIPT_URL}?id=${encodeURIComponent(measurementId)}`;
+    script.onload = () => {
+      gtag("config", measurementId);
+      resolve();
+    };
+    script.onerror = () => resolve();
+    document.head.appendChild(script);
+  });
+}
+function createGAListener(config) {
+  const measurementId = config.measurementId;
+  let ready = false;
+  return {
+    async init(cfg) {
+      try {
+        const c = cfg ?? config;
+        const id = c.measurementId;
+        if (!id || !isBrowser()) return;
+        await loadGtagScript(id);
+        ready = true;
+      } catch {
+      }
+    },
+    track(envelope) {
+      try {
+        if (!isBrowser() || !ready || typeof window.gtag !== "function") return;
+        const params = envelope.properties ?? {};
+        if (envelope.userId) params["user_id"] = envelope.userId;
+        window.gtag("event", envelope.name, params);
+      } catch {
+      }
+    },
+    identify(userId, traits) {
+      try {
+        if (!isBrowser() || typeof window.gtag !== "function") return;
+        window.gtag("set", "user_properties", { user_id: userId, ...traits });
+      } catch {
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGAListener
+});
+//# sourceMappingURL=ga.cjs.map

package/dist/ga.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../ga.ts","../src/listeners/ga.ts"],"sourcesContent":["/**\n * Entry point: @snovasys/usage-analytics-sdk/ga\n * Export GA listener factory for manual wiring or use via built-in registry (id: ga).\n */\nexport { createGAListener } from './src/listeners/ga.js';\nexport type { GAListenerConfig } from './src/listeners/ga.js';\nexport type { AnalyticsListener, EventEnvelope } from './src/types/index.js';\n","import type { AnalyticsListener } from '../types/listener.js';\nimport type { EventEnvelope } from '../types/envelope.js';\n\nexport interface GAListenerConfig {\n  measurementId: string;\n}\n\nconst GTAG_SCRIPT_URL = 'https://www.googletagmanager.com/gtag/js';\n\ndeclare global {\n  interface Window {\n    dataLayer?: unknown[];\n    gtag?: (...args: unknown[]) => void;\n  }\n}\n\nfunction isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nfunction loadGtagScript(measurementId: string): Promise<void> {\n  return new Promise((resolve) => {\n    if (!isBrowser()) {\n      resolve();\n      return;\n    }\n    if (window.gtag) {\n      window.gtag('config', measurementId);\n      resolve();\n      return;\n    }\n    window.dataLayer = window.dataLayer ?? [];\n    const gtag = (...args: unknown[]) => {\n      window.dataLayer!.push(args);\n    };\n    window.gtag = gtag;\n    gtag('js', new Date());\n    const script = document.createElement('script');\n    script.async = true;\n    script.src = `${GTAG_SCRIPT_URL}?id=${encodeURIComponent(measurementId)}`;\n    script.onload = () => {\n      gtag('config', measurementId);\n      resolve();\n    };\n    script.onerror = () => resolve();\n    document.head.appendChild(script);\n  });\n}\n\n/**\n * Listener that sends events to Google Analytics 4 via gtag.\n * Loads gtag script with measurementId; track → gtag('event', name, properties).\n * No-op when typeof window === 'undefined' (SSR).\n */\nexport function createGAListener(config: GAListenerConfig): AnalyticsListener {\n  const measurementId = config.measurementId;\n  let ready = false;\n\n  return {\n    async init(cfg: unknown): Promise<void> {\n      try {\n        const c = (cfg ?? config) as GAListenerConfig;\n        const id = c.measurementId;\n        if (!id || !isBrowser()) return;\n        await loadGtagScript(id);\n        ready = true;\n      } catch {\n        // swallow\n      }\n    },\n    track(envelope: EventEnvelope): void {\n      try {\n        if (!isBrowser() || !ready || typeof window.gtag !== 'function') return;\n        const params = envelope.properties ?? {};\n        if (envelope.userId) (params as Record<string, unknown>)['user_id'] = envelope.userId;\n        window.gtag('event', envelope.name, params);\n      } catch {\n        // swallow\n      }\n    },\n    identify(userId: string, traits?: Record<string, unknown>): void {\n      try {\n        if (!isBrowser() || typeof window.gtag !== 'function') return;\n        window.gtag('set', 'user_properties', { user_id: userId, ...traits });\n      } catch {\n        // swallow\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,IAAM,kBAAkB;AASxB,SAAS,YAAqB;AAC5B,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,eAAe,eAAsC;AAC5D,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,QAAI,CAAC,UAAU,GAAG;AAChB,cAAQ;AACR;AAAA,IACF;AACA,QAAI,OAAO,MAAM;AACf,aAAO,KAAK,UAAU,aAAa;AACnC,cAAQ;AACR;AAAA,IACF;AACA,WAAO,YAAY,OAAO,aAAa,CAAC;AACxC,UAAM,OAAO,IAAI,SAAoB;AACnC,aAAO,UAAW,KAAK,IAAI;AAAA,IAC7B;AACA,WAAO,OAAO;AACd,SAAK,MAAM,oBAAI,KAAK,CAAC;AACrB,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,QAAQ;AACf,WAAO,MAAM,GAAG,eAAe,OAAO,mBAAmB,aAAa,CAAC;AACvE,WAAO,SAAS,MAAM;AACpB,WAAK,UAAU,aAAa;AAC5B,cAAQ;AAAA,IACV;AACA,WAAO,UAAU,MAAM,QAAQ;AAC/B,aAAS,KAAK,YAAY,MAAM;AAAA,EAClC,CAAC;AACH;AAOO,SAAS,iBAAiB,QAA6C;AAC5E,QAAM,gBAAgB,OAAO;AAC7B,MAAI,QAAQ;AAEZ,SAAO;AAAA,IACL,MAAM,KAAK,KAA6B;AACtC,UAAI;AACF,cAAM,IAAK,OAAO;AAClB,cAAM,KAAK,EAAE;AACb,YAAI,CAAC,MAAM,CAAC,UAAU,EAAG;AACzB,cAAM,eAAe,EAAE;AACvB,gBAAQ;AAAA,MACV,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IACA,MAAM,UAA+B;AACnC,UAAI;AACF,YAAI,CAAC,UAAU,KAAK,CAAC,SAAS,OAAO,OAAO,SAAS,WAAY;AACjE,cAAM,SAAS,SAAS,cAAc,CAAC;AACvC,YAAI,SAAS,OAAQ,CAAC,OAAmC,SAAS,IAAI,SAAS;AAC/E,eAAO,KAAK,SAAS,SAAS,MAAM,MAAM;AAAA,MAC5C,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IACA,SAAS,QAAgB,QAAwC;AAC/D,UAAI;AACF,YAAI,CAAC,UAAU,KAAK,OAAO,OAAO,SAAS,WAAY;AACvD,eAAO,KAAK,OAAO,mBAAmB,EAAE,SAAS,QAAQ,GAAG,OAAO,CAAC;AAAA,MACtE,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/ga.d.cts

@@ -0,0 +1,20 @@
+import { A as AnalyticsListener } from './listener-CrNaKh1a.cjs';
+export { E as EventEnvelope } from './listener-CrNaKh1a.cjs';
+
+interface GAListenerConfig {
+    measurementId: string;
+}
+declare global {
+    interface Window {
+        dataLayer?: unknown[];
+        gtag?: (...args: unknown[]) => void;
+    }
+}
+/**
+ * Listener that sends events to Google Analytics 4 via gtag.
+ * Loads gtag script with measurementId; track → gtag('event', name, properties).
+ * No-op when typeof window === 'undefined' (SSR).
+ */
+declare function createGAListener(config: GAListenerConfig): AnalyticsListener;
+
+export { AnalyticsListener, type GAListenerConfig, createGAListener };

package/dist/ga.d.ts

@@ -0,0 +1,20 @@
+import { A as AnalyticsListener } from './listener-CrNaKh1a.js';
+export { E as EventEnvelope } from './listener-CrNaKh1a.js';
+
+interface GAListenerConfig {
+    measurementId: string;
+}
+declare global {
+    interface Window {
+        dataLayer?: unknown[];
+        gtag?: (...args: unknown[]) => void;
+    }
+}
+/**
+ * Listener that sends events to Google Analytics 4 via gtag.
+ * Loads gtag script with measurementId; track → gtag('event', name, properties).
+ * No-op when typeof window === 'undefined' (SSR).
+ */
+declare function createGAListener(config: GAListenerConfig): AnalyticsListener;
+
+export { AnalyticsListener, type GAListenerConfig, createGAListener };