@analytics-compliance/analytics-sdk 0.1.0

package/README.md

@@ -0,0 +1,130 @@
+# @yourorg/analytics-sdk
+
+Analytics SDK for sending client events to your ingestion service.
+
+## What this SDK sends
+
+- Required from client app:
+  - `clientName`
+  - `clientId`
+  - `pageView` (per event or default)
+- Optional from client app:
+  - `user`
+  - `content`
+- Added by SDK:
+  - `sessionId`
+  - `device` (`deviceType`, `osName`, `osVersion`, `browserName`, `browserVersion`)
+- Added by ingestion (server side):
+  - `ip`, `city`, `country`
+
+## Install
+
+```bash
+npm i @yourorg/analytics-sdk
+```
+
+## Quick Start
+
+```ts
+import { createAnalytics } from "@yourorg/analytics-sdk";
+
+const analytics = createAnalytics({
+  endpoint: "https://your-ingestion.example.com/events",
+  clientId: "ci_a12345c5-3dggkdab222",
+  clientName: "onlearn-web",
+  apiKey: "your-api-key"
+});
+
+analytics.initial({
+  pageView: "/ebook-detail"
+});
+
+analytics.setUser({
+  userId: "usr_123",
+  userType: "teacher"
+});
+
+analytics.setContent({
+  itemId: "prod_xyz-123",
+  fileType: "pptx"
+});
+
+await analytics.trackPageView();
+await analytics.trackDownloaded();
+await analytics.trackCustom("custom.anyAction", {
+  meta: { buttonId: "download-now" }
+});
+```
+
+## SDK API
+
+- `initial({ pageView?, user?, content? })`
+- `setPageView(pageView)`
+- `setUser(user?)`
+- `setContent(content?)`
+- `getSession()`
+- `getDevice()`
+- `track(eventName, input?)`
+- `trackPageView(input?)`
+- `trackSearched(input?)`
+- `trackDownloaded(input?)`
+- `trackClicked(input?)`
+- `trackSubmitted(input?)`
+- `trackLogin(input?)`
+- `trackSessionStart(input?)`
+- `trackCustom(customEventName, input?)`
+
+## Plug this SDK into other projects
+
+### Option A: Published package (recommended)
+
+1. Publish this package to npm (or private registry)
+2. In client project:
+
+```bash
+npm i @yourorg/analytics-sdk
+```
+
+3. Import and use as shown above
+
+### Option B: Local package during development
+
+In this SDK project:
+
+```bash
+npm run build
+npm pack
+```
+
+Then in client project install the generated `.tgz` file:
+
+```bash
+npm i ../path-to-sdk/yourorg-analytics-sdk-1.0.0.tgz
+```
+
+### Option C: npm link for active local development
+
+In SDK project:
+
+```bash
+npm link
+```
+
+In client project:
+
+```bash
+npm link @yourorg/analytics-sdk
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+## Publish (manual)
+
+```bash
+npm login
+npm publish --access public
+```

package/dist/index.cjs

@@ -0,0 +1,205 @@
+"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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createAnalytics: () => createAnalytics
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/device.ts
+function parseOs(userAgent) {
+  if (/Windows NT/i.test(userAgent)) {
+    const match = userAgent.match(/Windows NT ([\d.]+)/i);
+    return { osName: "Windows", osVersion: match?.[1] ?? "unknown" };
+  }
+  if (/Android/i.test(userAgent)) {
+    const match = userAgent.match(/Android ([\d.]+)/i);
+    return { osName: "Android", osVersion: match?.[1] ?? "unknown" };
+  }
+  if (/iPhone|iPad|iPod/i.test(userAgent)) {
+    const match = userAgent.match(/OS ([\d_]+)/i);
+    return { osName: "iOS", osVersion: (match?.[1] ?? "unknown").split("_").join(".") };
+  }
+  if (/Mac OS X/i.test(userAgent)) {
+    const match = userAgent.match(/Mac OS X ([\d_]+)/i);
+    return { osName: "macOS", osVersion: (match?.[1] ?? "unknown").split("_").join(".") };
+  }
+  if (/Linux/i.test(userAgent)) {
+    return { osName: "Linux", osVersion: "unknown" };
+  }
+  return { osName: "unknown", osVersion: "unknown" };
+}
+function parseBrowser(userAgent) {
+  const candidates = [
+    { name: "Edge", regex: /Edg\/([\d.]+)/i },
+    { name: "Chrome", regex: /Chrome\/([\d.]+)/i },
+    { name: "Firefox", regex: /Firefox\/([\d.]+)/i },
+    { name: "Safari", regex: /Version\/([\d.]+).*Safari/i }
+  ];
+  for (const candidate of candidates) {
+    const match = userAgent.match(candidate.regex);
+    if (match) {
+      return { browserName: candidate.name, browserVersion: match[1] };
+    }
+  }
+  return { browserName: "unknown", browserVersion: "unknown" };
+}
+function detectDeviceType(userAgent) {
+  if (/Tablet|iPad/i.test(userAgent)) return "tablet";
+  if (/Mobile|Android|iPhone|iPod/i.test(userAgent)) return "mobile";
+  if (!userAgent) return "unknown";
+  return "desktop";
+}
+function getDeviceInfo() {
+  if (typeof navigator === "undefined") {
+    return {
+      deviceType: "unknown",
+      osName: "unknown",
+      osVersion: "unknown",
+      browserName: "unknown",
+      browserVersion: "unknown"
+    };
+  }
+  const userAgent = navigator.userAgent ?? "";
+  const os = parseOs(userAgent);
+  const browser = parseBrowser(userAgent);
+  return {
+    deviceType: detectDeviceType(userAgent),
+    osName: os.osName,
+    osVersion: os.osVersion,
+    browserName: browser.browserName,
+    browserVersion: browser.browserVersion
+  };
+}
+
+// src/session.ts
+var SESSION_STORAGE_KEY = "analytics_sdk_session_id";
+function generateId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `ses_${Date.now()}_${Math.random().toString(16).slice(2)}`;
+}
+function getOrCreateSessionId() {
+  if (typeof sessionStorage === "undefined") {
+    return generateId();
+  }
+  const existing = sessionStorage.getItem(SESSION_STORAGE_KEY);
+  if (existing) return existing;
+  const next = generateId();
+  sessionStorage.setItem(SESSION_STORAGE_KEY, next);
+  return next;
+}
+
+// src/sdk.ts
+function ensureRequiredConfig(config) {
+  if (!config.endpoint) throw new Error("Analytics SDK: endpoint is required");
+  if (!config.clientId) throw new Error("Analytics SDK: clientId is required");
+  if (!config.clientName) throw new Error("Analytics SDK: clientName is required");
+}
+function generateEventId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `evt_${Date.now()}_${Math.random().toString(16).slice(2)}`;
+}
+async function postEvent(fetchImpl, endpoint, payload, apiKey) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (apiKey) headers["X-API-Key"] = apiKey;
+  const response = await fetchImpl(endpoint, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(payload),
+    keepalive: true
+  });
+  if (!response.ok) {
+    throw new Error(`Analytics SDK: ingestion error (${response.status})`);
+  }
+}
+function createAnalytics(config) {
+  ensureRequiredConfig(config);
+  const fetchImpl = config.fetchImpl ?? fetch;
+  let currentPageView = config.defaultPageView;
+  let currentUser = config.user;
+  let currentContent = config.content;
+  const getSession = () => getOrCreateSessionId();
+  const getDevice = () => getDeviceInfo();
+  const buildPayload = (eventName, input) => {
+    const normalizedEventName = (eventName || "custom").trim();
+    if (!normalizedEventName) {
+      throw new Error("Analytics SDK: eventName must not be empty");
+    }
+    return {
+      eventId: generateEventId(),
+      eventName: normalizedEventName,
+      eventTime: (/* @__PURE__ */ new Date()).toISOString(),
+      sessionId: getSession(),
+      clientId: config.clientId,
+      clientName: config.clientName,
+      pageView: input?.pageView ?? currentPageView,
+      user: input?.user ?? currentUser,
+      content: input?.content ?? currentContent,
+      // ip/city/country intentionally omitted here and expected from ingestion side.
+      device: getDevice(),
+      meta: input?.meta
+    };
+  };
+  const track = async (eventName, input) => {
+    const payload = buildPayload(eventName, input);
+    await postEvent(fetchImpl, config.endpoint, payload, config.apiKey);
+  };
+  const initial = (input) => {
+    if (input?.pageView) currentPageView = input.pageView;
+    if (input?.user) currentUser = input.user;
+    if (input?.content) currentContent = input.content;
+    getSession();
+  };
+  return {
+    initial,
+    setPageView: (pageView) => {
+      currentPageView = pageView;
+    },
+    setUser: (user) => {
+      currentUser = user;
+    },
+    setContent: (content) => {
+      currentContent = content;
+    },
+    getSession,
+    getDevice,
+    track,
+    trackPageView: (input) => track("event.pageView", input),
+    trackSearched: (input) => track("event.searched", input),
+    trackDownloaded: (input) => track("event.downloaded", input),
+    trackClicked: (input) => track("event.clicked", input),
+    trackSubmitted: (input) => track("event.submitted", input),
+    trackLogin: (input) => track("event.login", input),
+    trackSessionStart: (input) => track("event.sessionStart", input),
+    trackCustom: (customEventName, input) => track(customEventName || "custom", input)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAnalytics
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/device.ts","../src/session.ts","../src/sdk.ts"],"sourcesContent":["export { createAnalytics } from \"./sdk\";\nexport type {\n  AnalyticsEventPayload,\n  AnalyticsSdkConfig,\n  KnownEventName,\n  SdkContent,\n  SdkDevice,\n  SdkUser,\n  TrackInput\n} from \"./types\";\n","import type { SdkDevice } from \"./types\";\n\nfunction parseOs(userAgent: string): Pick<SdkDevice, \"osName\" | \"osVersion\"> {\n  if (/Windows NT/i.test(userAgent)) {\n    const match = userAgent.match(/Windows NT ([\\d.]+)/i);\n    return { osName: \"Windows\", osVersion: match?.[1] ?? \"unknown\" };\n  }\n  if (/Android/i.test(userAgent)) {\n    const match = userAgent.match(/Android ([\\d.]+)/i);\n    return { osName: \"Android\", osVersion: match?.[1] ?? \"unknown\" };\n  }\n  if (/iPhone|iPad|iPod/i.test(userAgent)) {\n    const match = userAgent.match(/OS ([\\d_]+)/i);\n    return { osName: \"iOS\", osVersion: (match?.[1] ?? \"unknown\").split(\"_\").join(\".\") };\n  }\n  if (/Mac OS X/i.test(userAgent)) {\n    const match = userAgent.match(/Mac OS X ([\\d_]+)/i);\n    return { osName: \"macOS\", osVersion: (match?.[1] ?? \"unknown\").split(\"_\").join(\".\") };\n  }\n  if (/Linux/i.test(userAgent)) {\n    return { osName: \"Linux\", osVersion: \"unknown\" };\n  }\n  return { osName: \"unknown\", osVersion: \"unknown\" };\n}\n\nfunction parseBrowser(userAgent: string): Pick<SdkDevice, \"browserName\" | \"browserVersion\"> {\n  const candidates: Array<{ name: string; regex: RegExp }> = [\n    { name: \"Edge\", regex: /Edg\\/([\\d.]+)/i },\n    { name: \"Chrome\", regex: /Chrome\\/([\\d.]+)/i },\n    { name: \"Firefox\", regex: /Firefox\\/([\\d.]+)/i },\n    { name: \"Safari\", regex: /Version\\/([\\d.]+).*Safari/i }\n  ];\n\n  for (const candidate of candidates) {\n    const match = userAgent.match(candidate.regex);\n    if (match) {\n      return { browserName: candidate.name, browserVersion: match[1] };\n    }\n  }\n\n  return { browserName: \"unknown\", browserVersion: \"unknown\" };\n}\n\nfunction detectDeviceType(userAgent: string): SdkDevice[\"deviceType\"] {\n  if (/Tablet|iPad/i.test(userAgent)) return \"tablet\";\n  if (/Mobile|Android|iPhone|iPod/i.test(userAgent)) return \"mobile\";\n  if (!userAgent) return \"unknown\";\n  return \"desktop\";\n}\n\nexport function getDeviceInfo(): SdkDevice {\n  if (typeof navigator === \"undefined\") {\n    return {\n      deviceType: \"unknown\",\n      osName: \"unknown\",\n      osVersion: \"unknown\",\n      browserName: \"unknown\",\n      browserVersion: \"unknown\"\n    };\n  }\n\n  const userAgent = navigator.userAgent ?? \"\";\n  const os = parseOs(userAgent);\n  const browser = parseBrowser(userAgent);\n\n  return {\n    deviceType: detectDeviceType(userAgent),\n    osName: os.osName,\n    osVersion: os.osVersion,\n    browserName: browser.browserName,\n    browserVersion: browser.browserVersion\n  };\n}\n","const SESSION_STORAGE_KEY = \"analytics_sdk_session_id\";\n\nfunction generateId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n\n  return `ses_${Date.now()}_${Math.random().toString(16).slice(2)}`;\n}\n\nexport function getOrCreateSessionId(): string {\n  if (typeof sessionStorage === \"undefined\") {\n    return generateId();\n  }\n\n  const existing = sessionStorage.getItem(SESSION_STORAGE_KEY);\n  if (existing) return existing;\n\n  const next = generateId();\n  sessionStorage.setItem(SESSION_STORAGE_KEY, next);\n  return next;\n}\n","import { getDeviceInfo } from \"./device\";\nimport { getOrCreateSessionId } from \"./session\";\nimport type {\n  AnalyticsEventPayload,\n  AnalyticsSdkConfig,\n  KnownEventName,\n  SdkContent,\n  SdkUser,\n  TrackInput\n} from \"./types\";\n\nfunction ensureRequiredConfig(config: AnalyticsSdkConfig): void {\n  if (!config.endpoint) throw new Error(\"Analytics SDK: endpoint is required\");\n  if (!config.clientId) throw new Error(\"Analytics SDK: clientId is required\");\n  if (!config.clientName) throw new Error(\"Analytics SDK: clientName is required\");\n}\n\nfunction generateEventId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n\n  return `evt_${Date.now()}_${Math.random().toString(16).slice(2)}`;\n}\n\nasync function postEvent(\n  fetchImpl: typeof fetch,\n  endpoint: string,\n  payload: AnalyticsEventPayload,\n  apiKey?: string\n): Promise<void> {\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"application/json\"\n  };\n\n  if (apiKey) headers[\"X-API-Key\"] = apiKey;\n\n  const response = await fetchImpl(endpoint, {\n    method: \"POST\",\n    headers,\n    body: JSON.stringify(payload),\n    keepalive: true\n  });\n\n  if (!response.ok) {\n    throw new Error(`Analytics SDK: ingestion error (${response.status})`);\n  }\n}\n\nexport interface AnalyticsSdk {\n  initial: (input?: Pick<TrackInput, \"pageView\" | \"user\" | \"content\">) => void;\n  setPageView: (pageView: string) => void;\n  setUser: (user?: SdkUser) => void;\n  setContent: (content?: SdkContent) => void;\n  getSession: () => string;\n  getDevice: () => ReturnType<typeof getDeviceInfo>;\n  track: (eventName: KnownEventName | string, input?: TrackInput) => Promise<void>;\n  trackPageView: (input?: TrackInput) => Promise<void>;\n  trackSearched: (input?: TrackInput) => Promise<void>;\n  trackDownloaded: (input?: TrackInput) => Promise<void>;\n  trackClicked: (input?: TrackInput) => Promise<void>;\n  trackSubmitted: (input?: TrackInput) => Promise<void>;\n  trackLogin: (input?: TrackInput) => Promise<void>;\n  trackSessionStart: (input?: TrackInput) => Promise<void>;\n  trackCustom: (customEventName: string, input?: TrackInput) => Promise<void>;\n}\n\nexport function createAnalytics(config: AnalyticsSdkConfig): AnalyticsSdk {\n  ensureRequiredConfig(config);\n\n  const fetchImpl = config.fetchImpl ?? fetch;\n\n  let currentPageView = config.defaultPageView;\n  let currentUser = config.user;\n  let currentContent = config.content;\n\n  const getSession = (): string => getOrCreateSessionId();\n  const getDevice = () => getDeviceInfo();\n\n  const buildPayload = (eventName: string, input?: TrackInput): AnalyticsEventPayload => {\n    const normalizedEventName = (eventName || \"custom\").trim();\n    if (!normalizedEventName) {\n      throw new Error(\"Analytics SDK: eventName must not be empty\");\n    }\n\n    return {\n      eventId: generateEventId(),\n      eventName: normalizedEventName,\n      eventTime: new Date().toISOString(),\n      sessionId: getSession(),\n      clientId: config.clientId,\n      clientName: config.clientName,\n      pageView: input?.pageView ?? currentPageView,\n      user: input?.user ?? currentUser,\n      content: input?.content ?? currentContent,\n      // ip/city/country intentionally omitted here and expected from ingestion side.\n      device: getDevice(),\n      meta: input?.meta\n    };\n  };\n\n  const track = async (eventName: KnownEventName | string, input?: TrackInput): Promise<void> => {\n    const payload = buildPayload(eventName, input);\n    await postEvent(fetchImpl, config.endpoint, payload, config.apiKey);\n  };\n\n  const initial = (input?: Pick<TrackInput, \"pageView\" | \"user\" | \"content\">): void => {\n    if (input?.pageView) currentPageView = input.pageView;\n    if (input?.user) currentUser = input.user;\n    if (input?.content) currentContent = input.content;\n    getSession();\n  };\n\n  return {\n    initial,\n    setPageView: (pageView: string): void => {\n      currentPageView = pageView;\n    },\n    setUser: (user?: SdkUser): void => {\n      currentUser = user;\n    },\n    setContent: (content?: SdkContent): void => {\n      currentContent = content;\n    },\n    getSession,\n    getDevice,\n    track,\n    trackPageView: (input?: TrackInput) => track(\"event.pageView\", input),\n    trackSearched: (input?: TrackInput) => track(\"event.searched\", input),\n    trackDownloaded: (input?: TrackInput) => track(\"event.downloaded\", input),\n    trackClicked: (input?: TrackInput) => track(\"event.clicked\", input),\n    trackSubmitted: (input?: TrackInput) => track(\"event.submitted\", input),\n    trackLogin: (input?: TrackInput) => track(\"event.login\", input),\n    trackSessionStart: (input?: TrackInput) => track(\"event.sessionStart\", input),\n    trackCustom: (customEventName: string, input?: TrackInput) => track(customEventName || \"custom\", input)\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,71 @@
+type KnownEventName = "event.pageView" | "event.searched" | "event.downloaded" | "event.clicked" | "event.submitted" | "event.login" | "event.sessionStart";
+interface SdkUser {
+    userId?: string;
+    email?: string;
+    userType?: string;
+    roles?: string[];
+    schoolId?: string;
+    schoolNameTh?: string;
+    schoolNameEn?: string;
+    [key: string]: unknown;
+}
+type SdkContent = Record<string, unknown>;
+interface SdkDevice {
+    deviceType: "mobile" | "tablet" | "desktop" | "unknown";
+    osName: string;
+    osVersion: string;
+    browserName: string;
+    browserVersion: string;
+}
+interface AnalyticsSdkConfig {
+    endpoint: string;
+    clientId: string;
+    clientName: string;
+    apiKey?: string;
+    defaultPageView?: string;
+    user?: SdkUser;
+    content?: SdkContent;
+    fetchImpl?: typeof fetch;
+}
+interface TrackInput {
+    pageView?: string;
+    user?: SdkUser;
+    content?: SdkContent;
+    meta?: Record<string, unknown>;
+}
+interface AnalyticsEventPayload {
+    eventId: string;
+    eventName: string;
+    eventTime: string;
+    sessionId: string;
+    clientId: string;
+    clientName: string;
+    pageView?: string;
+    user?: SdkUser;
+    content?: SdkContent;
+    device: SdkDevice;
+    meta?: Record<string, unknown>;
+}
+
+declare function getDeviceInfo(): SdkDevice;
+
+interface AnalyticsSdk {
+    initial: (input?: Pick<TrackInput, "pageView" | "user" | "content">) => void;
+    setPageView: (pageView: string) => void;
+    setUser: (user?: SdkUser) => void;
+    setContent: (content?: SdkContent) => void;
+    getSession: () => string;
+    getDevice: () => ReturnType<typeof getDeviceInfo>;
+    track: (eventName: KnownEventName | string, input?: TrackInput) => Promise<void>;
+    trackPageView: (input?: TrackInput) => Promise<void>;
+    trackSearched: (input?: TrackInput) => Promise<void>;
+    trackDownloaded: (input?: TrackInput) => Promise<void>;
+    trackClicked: (input?: TrackInput) => Promise<void>;
+    trackSubmitted: (input?: TrackInput) => Promise<void>;
+    trackLogin: (input?: TrackInput) => Promise<void>;
+    trackSessionStart: (input?: TrackInput) => Promise<void>;
+    trackCustom: (customEventName: string, input?: TrackInput) => Promise<void>;
+}
+declare function createAnalytics(config: AnalyticsSdkConfig): AnalyticsSdk;
+
+export { type AnalyticsEventPayload, type AnalyticsSdkConfig, type KnownEventName, type SdkContent, type SdkDevice, type SdkUser, type TrackInput, createAnalytics };

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+type KnownEventName = "event.pageView" | "event.searched" | "event.downloaded" | "event.clicked" | "event.submitted" | "event.login" | "event.sessionStart";
+interface SdkUser {
+    userId?: string;
+    email?: string;
+    userType?: string;
+    roles?: string[];
+    schoolId?: string;
+    schoolNameTh?: string;
+    schoolNameEn?: string;
+    [key: string]: unknown;
+}
+type SdkContent = Record<string, unknown>;
+interface SdkDevice {
+    deviceType: "mobile" | "tablet" | "desktop" | "unknown";
+    osName: string;
+    osVersion: string;
+    browserName: string;
+    browserVersion: string;
+}
+interface AnalyticsSdkConfig {
+    endpoint: string;
+    clientId: string;
+    clientName: string;
+    apiKey?: string;
+    defaultPageView?: string;
+    user?: SdkUser;
+    content?: SdkContent;
+    fetchImpl?: typeof fetch;
+}
+interface TrackInput {
+    pageView?: string;
+    user?: SdkUser;
+    content?: SdkContent;
+    meta?: Record<string, unknown>;
+}
+interface AnalyticsEventPayload {
+    eventId: string;
+    eventName: string;
+    eventTime: string;
+    sessionId: string;
+    clientId: string;
+    clientName: string;
+    pageView?: string;
+    user?: SdkUser;
+    content?: SdkContent;
+    device: SdkDevice;
+    meta?: Record<string, unknown>;
+}
+
+declare function getDeviceInfo(): SdkDevice;
+
+interface AnalyticsSdk {
+    initial: (input?: Pick<TrackInput, "pageView" | "user" | "content">) => void;
+    setPageView: (pageView: string) => void;
+    setUser: (user?: SdkUser) => void;
+    setContent: (content?: SdkContent) => void;
+    getSession: () => string;
+    getDevice: () => ReturnType<typeof getDeviceInfo>;
+    track: (eventName: KnownEventName | string, input?: TrackInput) => Promise<void>;
+    trackPageView: (input?: TrackInput) => Promise<void>;
+    trackSearched: (input?: TrackInput) => Promise<void>;
+    trackDownloaded: (input?: TrackInput) => Promise<void>;
+    trackClicked: (input?: TrackInput) => Promise<void>;
+    trackSubmitted: (input?: TrackInput) => Promise<void>;
+    trackLogin: (input?: TrackInput) => Promise<void>;
+    trackSessionStart: (input?: TrackInput) => Promise<void>;
+    trackCustom: (customEventName: string, input?: TrackInput) => Promise<void>;
+}
+declare function createAnalytics(config: AnalyticsSdkConfig): AnalyticsSdk;
+
+export { type AnalyticsEventPayload, type AnalyticsSdkConfig, type KnownEventName, type SdkContent, type SdkDevice, type SdkUser, type TrackInput, createAnalytics };

package/dist/index.js

@@ -0,0 +1,178 @@
+// src/device.ts
+function parseOs(userAgent) {
+  if (/Windows NT/i.test(userAgent)) {
+    const match = userAgent.match(/Windows NT ([\d.]+)/i);
+    return { osName: "Windows", osVersion: match?.[1] ?? "unknown" };
+  }
+  if (/Android/i.test(userAgent)) {
+    const match = userAgent.match(/Android ([\d.]+)/i);
+    return { osName: "Android", osVersion: match?.[1] ?? "unknown" };
+  }
+  if (/iPhone|iPad|iPod/i.test(userAgent)) {
+    const match = userAgent.match(/OS ([\d_]+)/i);
+    return { osName: "iOS", osVersion: (match?.[1] ?? "unknown").split("_").join(".") };
+  }
+  if (/Mac OS X/i.test(userAgent)) {
+    const match = userAgent.match(/Mac OS X ([\d_]+)/i);
+    return { osName: "macOS", osVersion: (match?.[1] ?? "unknown").split("_").join(".") };
+  }
+  if (/Linux/i.test(userAgent)) {
+    return { osName: "Linux", osVersion: "unknown" };
+  }
+  return { osName: "unknown", osVersion: "unknown" };
+}
+function parseBrowser(userAgent) {
+  const candidates = [
+    { name: "Edge", regex: /Edg\/([\d.]+)/i },
+    { name: "Chrome", regex: /Chrome\/([\d.]+)/i },
+    { name: "Firefox", regex: /Firefox\/([\d.]+)/i },
+    { name: "Safari", regex: /Version\/([\d.]+).*Safari/i }
+  ];
+  for (const candidate of candidates) {
+    const match = userAgent.match(candidate.regex);
+    if (match) {
+      return { browserName: candidate.name, browserVersion: match[1] };
+    }
+  }
+  return { browserName: "unknown", browserVersion: "unknown" };
+}
+function detectDeviceType(userAgent) {
+  if (/Tablet|iPad/i.test(userAgent)) return "tablet";
+  if (/Mobile|Android|iPhone|iPod/i.test(userAgent)) return "mobile";
+  if (!userAgent) return "unknown";
+  return "desktop";
+}
+function getDeviceInfo() {
+  if (typeof navigator === "undefined") {
+    return {
+      deviceType: "unknown",
+      osName: "unknown",
+      osVersion: "unknown",
+      browserName: "unknown",
+      browserVersion: "unknown"
+    };
+  }
+  const userAgent = navigator.userAgent ?? "";
+  const os = parseOs(userAgent);
+  const browser = parseBrowser(userAgent);
+  return {
+    deviceType: detectDeviceType(userAgent),
+    osName: os.osName,
+    osVersion: os.osVersion,
+    browserName: browser.browserName,
+    browserVersion: browser.browserVersion
+  };
+}
+
+// src/session.ts
+var SESSION_STORAGE_KEY = "analytics_sdk_session_id";
+function generateId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `ses_${Date.now()}_${Math.random().toString(16).slice(2)}`;
+}
+function getOrCreateSessionId() {
+  if (typeof sessionStorage === "undefined") {
+    return generateId();
+  }
+  const existing = sessionStorage.getItem(SESSION_STORAGE_KEY);
+  if (existing) return existing;
+  const next = generateId();
+  sessionStorage.setItem(SESSION_STORAGE_KEY, next);
+  return next;
+}
+
+// src/sdk.ts
+function ensureRequiredConfig(config) {
+  if (!config.endpoint) throw new Error("Analytics SDK: endpoint is required");
+  if (!config.clientId) throw new Error("Analytics SDK: clientId is required");
+  if (!config.clientName) throw new Error("Analytics SDK: clientName is required");
+}
+function generateEventId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `evt_${Date.now()}_${Math.random().toString(16).slice(2)}`;
+}
+async function postEvent(fetchImpl, endpoint, payload, apiKey) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (apiKey) headers["X-API-Key"] = apiKey;
+  const response = await fetchImpl(endpoint, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(payload),
+    keepalive: true
+  });
+  if (!response.ok) {
+    throw new Error(`Analytics SDK: ingestion error (${response.status})`);
+  }
+}
+function createAnalytics(config) {
+  ensureRequiredConfig(config);
+  const fetchImpl = config.fetchImpl ?? fetch;
+  let currentPageView = config.defaultPageView;
+  let currentUser = config.user;
+  let currentContent = config.content;
+  const getSession = () => getOrCreateSessionId();
+  const getDevice = () => getDeviceInfo();
+  const buildPayload = (eventName, input) => {
+    const normalizedEventName = (eventName || "custom").trim();
+    if (!normalizedEventName) {
+      throw new Error("Analytics SDK: eventName must not be empty");
+    }
+    return {
+      eventId: generateEventId(),
+      eventName: normalizedEventName,
+      eventTime: (/* @__PURE__ */ new Date()).toISOString(),
+      sessionId: getSession(),
+      clientId: config.clientId,
+      clientName: config.clientName,
+      pageView: input?.pageView ?? currentPageView,
+      user: input?.user ?? currentUser,
+      content: input?.content ?? currentContent,
+      // ip/city/country intentionally omitted here and expected from ingestion side.
+      device: getDevice(),
+      meta: input?.meta
+    };
+  };
+  const track = async (eventName, input) => {
+    const payload = buildPayload(eventName, input);
+    await postEvent(fetchImpl, config.endpoint, payload, config.apiKey);
+  };
+  const initial = (input) => {
+    if (input?.pageView) currentPageView = input.pageView;
+    if (input?.user) currentUser = input.user;
+    if (input?.content) currentContent = input.content;
+    getSession();
+  };
+  return {
+    initial,
+    setPageView: (pageView) => {
+      currentPageView = pageView;
+    },
+    setUser: (user) => {
+      currentUser = user;
+    },
+    setContent: (content) => {
+      currentContent = content;
+    },
+    getSession,
+    getDevice,
+    track,
+    trackPageView: (input) => track("event.pageView", input),
+    trackSearched: (input) => track("event.searched", input),
+    trackDownloaded: (input) => track("event.downloaded", input),
+    trackClicked: (input) => track("event.clicked", input),
+    trackSubmitted: (input) => track("event.submitted", input),
+    trackLogin: (input) => track("event.login", input),
+    trackSessionStart: (input) => track("event.sessionStart", input),
+    trackCustom: (customEventName, input) => track(customEventName || "custom", input)
+  };
+}
+export {
+  createAnalytics
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/device.ts","../src/session.ts","../src/sdk.ts"],"sourcesContent":["import type { SdkDevice } from \"./types\";\n\nfunction parseOs(userAgent: string): Pick<SdkDevice, \"osName\" | \"osVersion\"> {\n  if (/Windows NT/i.test(userAgent)) {\n    const match = userAgent.match(/Windows NT ([\\d.]+)/i);\n    return { osName: \"Windows\", osVersion: match?.[1] ?? \"unknown\" };\n  }\n  if (/Android/i.test(userAgent)) {\n    const match = userAgent.match(/Android ([\\d.]+)/i);\n    return { osName: \"Android\", osVersion: match?.[1] ?? \"unknown\" };\n  }\n  if (/iPhone|iPad|iPod/i.test(userAgent)) {\n    const match = userAgent.match(/OS ([\\d_]+)/i);\n    return { osName: \"iOS\", osVersion: (match?.[1] ?? \"unknown\").split(\"_\").join(\".\") };\n  }\n  if (/Mac OS X/i.test(userAgent)) {\n    const match = userAgent.match(/Mac OS X ([\\d_]+)/i);\n    return { osName: \"macOS\", osVersion: (match?.[1] ?? \"unknown\").split(\"_\").join(\".\") };\n  }\n  if (/Linux/i.test(userAgent)) {\n    return { osName: \"Linux\", osVersion: \"unknown\" };\n  }\n  return { osName: \"unknown\", osVersion: \"unknown\" };\n}\n\nfunction parseBrowser(userAgent: string): Pick<SdkDevice, \"browserName\" | \"browserVersion\"> {\n  const candidates: Array<{ name: string; regex: RegExp }> = [\n    { name: \"Edge\", regex: /Edg\\/([\\d.]+)/i },\n    { name: \"Chrome\", regex: /Chrome\\/([\\d.]+)/i },\n    { name: \"Firefox\", regex: /Firefox\\/([\\d.]+)/i },\n    { name: \"Safari\", regex: /Version\\/([\\d.]+).*Safari/i }\n  ];\n\n  for (const candidate of candidates) {\n    const match = userAgent.match(candidate.regex);\n    if (match) {\n      return { browserName: candidate.name, browserVersion: match[1] };\n    }\n  }\n\n  return { browserName: \"unknown\", browserVersion: \"unknown\" };\n}\n\nfunction detectDeviceType(userAgent: string): SdkDevice[\"deviceType\"] {\n  if (/Tablet|iPad/i.test(userAgent)) return \"tablet\";\n  if (/Mobile|Android|iPhone|iPod/i.test(userAgent)) return \"mobile\";\n  if (!userAgent) return \"unknown\";\n  return \"desktop\";\n}\n\nexport function getDeviceInfo(): SdkDevice {\n  if (typeof navigator === \"undefined\") {\n    return {\n      deviceType: \"unknown\",\n      osName: \"unknown\",\n      osVersion: \"unknown\",\n      browserName: \"unknown\",\n      browserVersion: \"unknown\"\n    };\n  }\n\n  const userAgent = navigator.userAgent ?? \"\";\n  const os = parseOs(userAgent);\n  const browser = parseBrowser(userAgent);\n\n  return {\n    deviceType: detectDeviceType(userAgent),\n    osName: os.osName,\n    osVersion: os.osVersion,\n    browserName: browser.browserName,\n    browserVersion: browser.browserVersion\n  };\n}\n","const SESSION_STORAGE_KEY = \"analytics_sdk_session_id\";\n\nfunction generateId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n\n  return `ses_${Date.now()}_${Math.random().toString(16).slice(2)}`;\n}\n\nexport function getOrCreateSessionId(): string {\n  if (typeof sessionStorage === \"undefined\") {\n    return generateId();\n  }\n\n  const existing = sessionStorage.getItem(SESSION_STORAGE_KEY);\n  if (existing) return existing;\n\n  const next = generateId();\n  sessionStorage.setItem(SESSION_STORAGE_KEY, next);\n  return next;\n}\n","import { getDeviceInfo } from \"./device\";\nimport { getOrCreateSessionId } from \"./session\";\nimport type {\n  AnalyticsEventPayload,\n  AnalyticsSdkConfig,\n  KnownEventName,\n  SdkContent,\n  SdkUser,\n  TrackInput\n} from \"./types\";\n\nfunction ensureRequiredConfig(config: AnalyticsSdkConfig): void {\n  if (!config.endpoint) throw new Error(\"Analytics SDK: endpoint is required\");\n  if (!config.clientId) throw new Error(\"Analytics SDK: clientId is required\");\n  if (!config.clientName) throw new Error(\"Analytics SDK: clientName is required\");\n}\n\nfunction generateEventId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n\n  return `evt_${Date.now()}_${Math.random().toString(16).slice(2)}`;\n}\n\nasync function postEvent(\n  fetchImpl: typeof fetch,\n  endpoint: string,\n  payload: AnalyticsEventPayload,\n  apiKey?: string\n): Promise<void> {\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"application/json\"\n  };\n\n  if (apiKey) headers[\"X-API-Key\"] = apiKey;\n\n  const response = await fetchImpl(endpoint, {\n    method: \"POST\",\n    headers,\n    body: JSON.stringify(payload),\n    keepalive: true\n  });\n\n  if (!response.ok) {\n    throw new Error(`Analytics SDK: ingestion error (${response.status})`);\n  }\n}\n\nexport interface AnalyticsSdk {\n  initial: (input?: Pick<TrackInput, \"pageView\" | \"user\" | \"content\">) => void;\n  setPageView: (pageView: string) => void;\n  setUser: (user?: SdkUser) => void;\n  setContent: (content?: SdkContent) => void;\n  getSession: () => string;\n  getDevice: () => ReturnType<typeof getDeviceInfo>;\n  track: (eventName: KnownEventName | string, input?: TrackInput) => Promise<void>;\n  trackPageView: (input?: TrackInput) => Promise<void>;\n  trackSearched: (input?: TrackInput) => Promise<void>;\n  trackDownloaded: (input?: TrackInput) => Promise<void>;\n  trackClicked: (input?: TrackInput) => Promise<void>;\n  trackSubmitted: (input?: TrackInput) => Promise<void>;\n  trackLogin: (input?: TrackInput) => Promise<void>;\n  trackSessionStart: (input?: TrackInput) => Promise<void>;\n  trackCustom: (customEventName: string, input?: TrackInput) => Promise<void>;\n}\n\nexport function createAnalytics(config: AnalyticsSdkConfig): AnalyticsSdk {\n  ensureRequiredConfig(config);\n\n  const fetchImpl = config.fetchImpl ?? fetch;\n\n  let currentPageView = config.defaultPageView;\n  let currentUser = config.user;\n  let currentContent = config.content;\n\n  const getSession = (): string => getOrCreateSessionId();\n  const getDevice = () => getDeviceInfo();\n\n  const buildPayload = (eventName: string, input?: TrackInput): AnalyticsEventPayload => {\n    const normalizedEventName = (eventName || \"custom\").trim();\n    if (!normalizedEventName) {\n      throw new Error(\"Analytics SDK: eventName must not be empty\");\n    }\n\n    return {\n      eventId: generateEventId(),\n      eventName: normalizedEventName,\n      eventTime: new Date().toISOString(),\n      sessionId: getSession(),\n      clientId: config.clientId,\n      clientName: config.clientName,\n      pageView: input?.pageView ?? currentPageView,\n      user: input?.user ?? currentUser,\n      content: input?.content ?? currentContent,\n      // ip/city/country intentionally omitted here and expected from ingestion side.\n      device: getDevice(),\n      meta: input?.meta\n    };\n  };\n\n  const track = async (eventName: KnownEventName | string, input?: TrackInput): Promise<void> => {\n    const payload = buildPayload(eventName, input);\n    await postEvent(fetchImpl, config.endpoint, payload, config.apiKey);\n  };\n\n  const initial = (input?: Pick<TrackInput, \"pageView\" | \"user\" | \"content\">): void => {\n    if (input?.pageView) currentPageView = input.pageView;\n    if (input?.user) currentUser = input.user;\n    if (input?.content) currentContent = input.content;\n    getSession();\n  };\n\n  return {\n    initial,\n    setPageView: (pageView: string): void => {\n      currentPageView = pageView;\n    },\n    setUser: (user?: SdkUser): void => {\n      currentUser = user;\n    },\n    setContent: (content?: SdkContent): void => {\n      currentContent = content;\n    },\n    getSession,\n    getDevice,\n    track,\n    trackPageView: (input?: TrackInput) => track(\"event.pageView\", input),\n    trackSearched: (input?: TrackInput) => track(\"event.searched\", input),\n    trackDownloaded: (input?: TrackInput) => track(\"event.downloaded\", input),\n    trackClicked: (input?: TrackInput) => track(\"event.clicked\", input),\n    trackSubmitted: (input?: TrackInput) => track(\"event.submitted\", input),\n    trackLogin: (input?: TrackInput) => track(\"event.login\", input),\n    trackSessionStart: (input?: TrackInput) => track(\"event.sessionStart\", input),\n    trackCustom: (customEventName: string, input?: TrackInput) => track(customEventName || \"custom\", input)\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@analytics-compliance/analytics-sdk",
+  "version": "0.1.0",
+  "description": "Lightweight analytics SDK for sending client events to ingestion service.",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}