@drivemetadata-ai/sdk 0.1.1-beta.1 → 0.1.1-beta.2

package/README.md

@@ -5,19 +5,19 @@ Enterprise-grade analytics, behavior intelligence, and customer data collection
 ## Install
 
 ```bash
-npm install @drivemetadata/sdk
+npm install @drivemetadata-ai/sdk
 ```
 
 ## Browser
 
 ```ts
-import { initDmdSDK } from '@drivemetadata/sdk/browser';
+import { initDmdSDK } from '@drivemetadata-ai/sdk/browser';
 
 const dmd = initDmdSDK({
   clientId: 'client_xxx',
   workspaceId: 'workspace_xxx',
   appId: 'app_xxx',
-  writeKey: 'public_write_key',
+  token: 'public_token',
   consent: {
     analytics: 'pending',
     advertising: 'denied',
@@ -37,7 +37,7 @@ await dmd.flush();
 ## React
 
 ```tsx
-import { DmdProvider, useTrackEvent } from '@drivemetadata/sdk/react';
+import { DmdProvider, useTrackEvent } from '@drivemetadata-ai/sdk/react';
 
 function ProductButton() {
   const track = useTrackEvent();
@@ -55,27 +55,30 @@ export function App() {
 
 ## Next.js
 
-Use `@drivemetadata/sdk/next` from a client component.
+Use `@drivemetadata-ai/sdk/next` from a client component.
 
 ```tsx
 'use client';
 
-import { DmdProvider } from '@drivemetadata/sdk/next';
+import { DmdProvider } from '@drivemetadata-ai/sdk/next';
 ```
 
 ## Angular
 
 ```ts
-import { DmdAnalyticsService, provideDmdAnalytics } from '@drivemetadata/sdk/angular';
+import { DmdAnalyticsService, provideDmdAnalytics } from '@drivemetadata-ai/sdk/angular';
 ```
 
 ## Node.js
 
 ```ts
-import { createDmdServerClient } from '@drivemetadata/sdk/node';
+import { createDmdServerClient } from '@drivemetadata-ai/sdk/node';
 
 const dmd = createDmdServerClient({
-  writeKey: process.env.DMD_SERVER_WRITE_KEY!
+  clientId: 'client_xxx',
+  workspaceId: 'workspace_xxx',
+  appId: 'app_xxx',
+  token: process.env.DMD_SERVER_TOKEN!
 });
 
 await dmd.track({
@@ -87,20 +90,20 @@ await dmd.track({
 
 ## Runtime Entries
 
-- `@drivemetadata/sdk/browser`
-- `@drivemetadata/sdk/react`
-- `@drivemetadata/sdk/next`
-- `@drivemetadata/sdk/angular`
-- `@drivemetadata/sdk/node`
+- `@drivemetadata-ai/sdk/browser`
+- `@drivemetadata-ai/sdk/react`
+- `@drivemetadata-ai/sdk/next`
+- `@drivemetadata-ai/sdk/angular`
+- `@drivemetadata-ai/sdk/node`
 
 ## Documentation
 
+- Complete integration guide: `docs/integration.md`
 - Browser npm SDK: `docs/npm-browser-sdk.md`
 - React and Next.js: `docs/react-next-integration.md`
 - Angular: `docs/angular-integration.md`
 - Node/server: `docs/node-server-integration.md`
 - Security and privacy: `docs/security-privacy.md`
-- CDN to npm migration: `docs/migration-cdn-to-npm.md`
 
 ## License
 

package/dist/angular/index.cjs

@@ -38,53 +38,62 @@ module.exports = __toCommonJS(angular_exports);
 // src/angular/dmd-analytics.service.ts
 var import_core2 = require("@angular/core");
 
-// src/core/config.ts
-function requireString(value, field) {
-  if (typeof value !== "string" || value.trim() === "") {
-    throw new Error(`DMD SDK config ${field} is required`);
+// src/core/backend-payload.ts
+function formatUtcTimestamp(value) {
+  if (typeof value !== "string") return (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, 19);
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return date.toISOString().replace("T", " ").slice(0, 19);
+}
+function cleanObject(value) {
+  if (Array.isArray(value)) {
+    const cleaned = value.map((item) => cleanObject(item)).filter((item) => item !== null && item !== void 0 && item !== "");
+    return cleaned.length > 0 ? cleaned : void 0;
+  }
+  if (value && typeof value === "object") {
+    const cleaned = Object.fromEntries(
+      Object.entries(value).map(([key, item]) => [key, cleanObject(item)]).filter(([, item]) => {
+        if (item === null || item === void 0 || item === "") return false;
+        if (typeof item === "object" && !Array.isArray(item) && Object.keys(item).length === 0) return false;
+        return true;
+      })
+    );
+    return Object.keys(cleaned).length > 0 ? cleaned : void 0;
   }
   return value;
 }
-function normalizeBrowserConfig(config) {
-  const writeKey = config.writeKey || config.token;
-  const legacyConfig = {
-    client_id: requireString(config.clientId, "clientId"),
-    workspace_id: requireString(config.workspaceId, "workspaceId"),
-    app_id: requireString(config.appId, "appId"),
-    token: requireString(writeKey, "writeKey")
+function createBackendCollectorPayload(input) {
+  const eventData = input.eventData && typeof input.eventData === "object" ? input.eventData : {};
+  const page2 = eventData.page && typeof eventData.page === "object" ? eventData.page : {};
+  const timestamp = formatUtcTimestamp(eventData.timestamp ?? input.timestamp);
+  const normalizedEventData = {
+    ...eventData,
+    timestamp,
+    requestSentAt: formatUtcTimestamp(eventData.requestSentAt ?? input.requestSentAt ?? timestamp),
+    requestReceivedAt: formatUtcTimestamp(eventData.requestReceivedAt ?? input.requestReceivedAt ?? timestamp)
+  };
+  const metaData = {
+    ...normalizedEventData,
+    requestId: input.requestId,
+    timestamp,
+    eventType: input.eventType,
+    requestFrom: input.requestFrom ?? "3",
+    clientId: input.clientId,
+    workspaceId: input.workspaceId,
+    token: input.token,
+    anonymousId: eventData.anonymousId ?? input.anonymousId,
+    sessionId: eventData.sessionId ?? input.sessionId,
+    ua: input.ua,
+    appDetails: { app_id: input.appId },
+    page: { ...page2, url: page2.url ?? input.pageUrl },
+    requestSentAt: normalizedEventData.requestSentAt,
+    requestReceivedAt: normalizedEventData.requestReceivedAt
   };
-  if (config.apiHost !== void 0) legacyConfig.api_host = config.apiHost;
-  if (config.uiHost !== void 0) legacyConfig.ui_host = config.uiHost;
-  if (config.deeplink !== void 0) legacyConfig.deeplink = config.deeplink;
-  if (config.debug !== void 0) legacyConfig.debug = config.debug;
-  if (config.consent !== void 0) legacyConfig.consent = config.consent;
-  if (config.gdprConsent !== void 0) legacyConfig.gdprConsent = config.gdprConsent;
-  if (config.autocapture !== void 0) legacyConfig.autocapture = config.autocapture;
-  if (config.capturePageview !== void 0) legacyConfig.capture_pageview = config.capturePageview;
-  if (config.capturePageleave !== void 0) legacyConfig.capture_pageleave = config.capturePageleave;
-  if (config.captureDeadClicks !== void 0) legacyConfig.capture_dead_clicks = config.captureDeadClicks;
-  if (config.crossSubdomainCookie !== void 0) legacyConfig.cross_subdomain_cookie = config.crossSubdomainCookie;
-  if (config.disablePersistence !== void 0) legacyConfig.disable_persistence = config.disablePersistence;
-  if (config.disableSurveys !== void 0) legacyConfig.disable_surveys = config.disableSurveys;
-  if (config.disableSessionRecording !== void 0) legacyConfig.disable_session_recording = config.disableSessionRecording;
-  if (config.enableHeatmaps !== void 0) legacyConfig.enable_heatmaps = config.enableHeatmaps;
-  if (config.maskAllText !== void 0) legacyConfig.mask_all_text = config.maskAllText;
-  if (config.maskAllElementAttributes !== void 0) {
-    legacyConfig.mask_all_element_attributes = config.maskAllElementAttributes;
-  }
-  if (config.persistence !== void 0) legacyConfig.persistence = config.persistence;
-  if (config.propertyDenylist !== void 0) legacyConfig.property_denylist = config.propertyDenylist;
-  if (config.sessionIdleTimeoutSeconds !== void 0) {
-    legacyConfig.session_idle_timeout_seconds = config.sessionIdleTimeoutSeconds;
-  }
-  if (config.beforeSend !== void 0) legacyConfig.before_send = config.beforeSend;
-  return legacyConfig;
+  const payload = { metaData };
+  return cleanObject(payload);
 }
 
 // src/core/environment.ts
-function isBrowserRuntime() {
-  return typeof window !== "undefined" && typeof document !== "undefined";
-}
 function getBrowserWindow() {
   return typeof window === "undefined" ? void 0 : window;
 }
@@ -144,8 +153,9 @@ function stableStringify(value) {
   );
 }
 function createIdempotencyKey(payload, messageId) {
-  const event = String(payload.event ?? payload.type ?? "event");
-  const properties = payload.properties;
+  const metaData = payload.metaData;
+  const event = String(metaData?.eventType ?? payload.event ?? payload.type ?? "event");
+  const properties = metaData ?? payload.properties;
   const orderId = properties?.orderId ?? properties?.order_id ?? properties?.transaction_id;
   if (orderId !== void 0) return `${event}:${String(orderId)}`;
   return `${event}:${stableStringify(properties ?? {}) || messageId}`;
@@ -246,7 +256,17 @@ function createDeliveryManager(config) {
     persistQueue();
   }
   function withEnvelope(payload) {
-    const messageId = String(payload.messageId ?? createId("msg"));
+    const metaData = payload.metaData;
+    const messageId = String(metaData?.requestId ?? payload.messageId ?? createId("msg"));
+    if (metaData) {
+      return {
+        ...payload,
+        metaData: {
+          ...metaData,
+          requestId: messageId
+        }
+      };
+    }
     return {
       ...payload,
       messageId,
@@ -272,7 +292,7 @@ function createDeliveryManager(config) {
       const body = withEnvelope(payload);
       if (payloadByteLength(body) > maxPayloadBytes) {
         recordDrop({
-          messageId: String(body.messageId),
+          messageId: String(body.metaData?.requestId ?? body.messageId),
           reason: "payload_too_large",
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
         });
@@ -285,7 +305,7 @@ function createDeliveryManager(config) {
         const deliveryError = error instanceof Error ? error : new Error(String(error));
         recordError(deliveryError);
         enqueue({
-          messageId: String(body.messageId),
+          messageId: String(body.metaData?.requestId ?? body.messageId),
           savedAt: Date.now(),
           attempts: 1,
           lastError: deliveryError.message,
@@ -460,6 +480,12 @@ function endpointFromConfig(config) {
   const host = config.apiHost ?? "https://sdk.drivemetadata.com/v2";
   return `${host.replace(/\/$/, "")}/data-collector`;
 }
+function requireConfigString(value, field) {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new Error(`DMD SDK config ${field} is required`);
+  }
+  return value;
+}
 function getBrowserStorage() {
   const browserWindow = getBrowserWindow();
   try {
@@ -474,6 +500,10 @@ var DriveMetaDataSDK = class {
     this.queue = [];
     this.offline = false;
     this.droppedEvents = 0;
+    requireConfigString(config.clientId, "clientId");
+    requireConfigString(config.workspaceId, "workspaceId");
+    requireConfigString(config.appId, "appId");
+    requireConfigString(config.writeKey || config.token, "writeKey or token");
     this.config = config;
     this.endpoint = endpointFromConfig(config);
     const storage = getBrowserStorage();
@@ -497,6 +527,7 @@ var DriveMetaDataSDK = class {
     this.maxRetryDelayMs = config.delivery?.maxRetryDelayMs ?? 3e4;
     this.writeKey = config.writeKey || config.token || "";
     this.identity = { anonymousId: createId2("anon") };
+    this.sessionId = createId2("session");
     this.consentState = normalizeConsent(config.gdprConsent ?? config.consent);
     this.gdprConsent = this.consentState.analytics;
     if (!config.delivery?.disableLifecycleFlush) {
@@ -642,7 +673,8 @@ var DriveMetaDataSDK = class {
       workspaceId: this.config.workspaceId,
       appId: this.config.appId,
       writeKey: this.writeKey,
-      consent: this.consentState
+      consent: this.consentState,
+      sessionId: this.sessionId
     };
     if (this.identity.userId !== void 0) prepared.userId = this.identity.userId;
     if (this.identity.groupId !== void 0) prepared.groupId = this.identity.groupId;
@@ -666,7 +698,31 @@ var DriveMetaDataSDK = class {
     if (!validation.ok) {
       this.lastError = `DMD SDK schema warning: ${validation.errors.join(", ")}`;
     }
-    this.sendEvent(prepared);
+    this.sendEvent(this.toCollectorPayload(prepared));
+  }
+  toCollectorPayload(prepared) {
+    const browserWindow = getBrowserWindow();
+    return createBackendCollectorPayload({
+      requestId: prepared.messageId,
+      timestamp: prepared.timestamp,
+      eventType: prepared.event,
+      clientId: prepared.clientId,
+      workspaceId: prepared.workspaceId,
+      token: prepared.writeKey,
+      anonymousId: prepared.anonymousId,
+      sessionId: prepared.sessionId,
+      ua: browserWindow?.navigator?.userAgent,
+      appId: prepared.appId,
+      pageUrl: browserWindow?.location?.href,
+      eventData: {
+        ...prepared.properties,
+        anonymousId: prepared.anonymousId,
+        sessionId: prepared.sessionId,
+        timestamp: prepared.timestamp,
+        requestSentAt: prepared.timestamp,
+        requestReceivedAt: prepared.timestamp
+      }
+    });
   }
   recordDrop(type, reason, event) {
     this.droppedEvents += 1;
@@ -680,22 +736,6 @@ var DriveMetaDataSDK = class {
   }
 };
 
-// src/browser/legacy-loader.ts
-function getLegacySdkInstanceFromWindow() {
-  const browserWindow = getBrowserWindow();
-  return browserWindow?.__DriveMetaDataSDKInstance;
-}
-function ensureLegacySdkLoaded() {
-  if (!isBrowserRuntime()) {
-    throw new Error("DMD legacy SDK is only available in a browser runtime");
-  }
-  const browserWindow = getBrowserWindow();
-  if (!browserWindow?.DriveMetaDataSDK) {
-    throw new Error("DMD legacy SDK constructor is missing from window.DriveMetaDataSDK");
-  }
-  return browserWindow.DriveMetaDataSDK;
-}
-
 // src/browser/client.ts
 var singleton;
 var publicSingleton;
@@ -704,56 +744,34 @@ var lastError;
 var lastDroppedEvent;
 function createPublicClient(instance) {
   return {
-    __legacy: instance,
     track(event, properties, options) {
-      if (instance.trackEvent) {
-        instance.trackEvent(event, properties, options);
-        return;
-      }
-      instance.sendEvent?.({ eventName: event, event, properties, options });
+      instance.trackEvent(event, properties, options);
     },
     identify(userId, traits, options) {
-      if (instance.identify) {
-        instance.identify(userId, traits, options);
-        return;
-      }
-      instance.identifyUser?.(userId, traits);
+      instance.identify(userId, traits, options);
     },
     page(name, properties, options) {
-      if (instance.page) {
-        instance.page(name, properties, options);
-        return;
-      }
-      instance.trackPageview?.();
+      instance.page(name, properties, options);
     },
     group(groupId, traits, options) {
-      instance.group?.(groupId, traits, options);
+      instance.group(groupId, traits, options);
     },
     alias(previousId, userId, options) {
-      instance.alias?.(previousId, userId, options);
+      instance.alias(previousId, userId, options);
     },
     async flush() {
-      await instance.flush?.();
+      await instance.flush();
     },
     reset() {
-      instance.reset?.();
+      instance.reset();
       singleton = void 0;
       publicSingleton = void 0;
     },
     setConsent(consent) {
-      if (instance.setConsent) {
-        instance.setConsent(consent);
-        return;
-      }
-      if (typeof consent === "string") {
-        instance.gdprConsent = consent;
-      }
+      instance.setConsent(consent);
     },
     getHealth() {
-      if (instance.getHealth) {
-        return instance.getHealth();
-      }
-      return getDmdHealth();
+      return instance.getHealth();
     }
   };
 }
@@ -778,23 +796,8 @@ function initDmdSDK(config) {
   if (publicSingleton) {
     return publicSingleton;
   }
-  const legacyConfig = normalizeBrowserConfig(config);
-  const existingInstance = getLegacySdkInstanceFromWindow();
-  if (existingInstance) {
-    return setSingleton(existingInstance);
-  }
   try {
-    let instance;
-    try {
-      const LegacySdk = ensureLegacySdkLoaded();
-      instance = new LegacySdk(legacyConfig);
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("constructor is missing")) {
-        instance = new DriveMetaDataSDK(config);
-      } else {
-        throw error;
-      }
-    }
+    const instance = new DriveMetaDataSDK(config);
     return setSingleton(instance);
   } catch (error) {
     lastError = error instanceof Error ? error.message : String(error);
@@ -861,14 +864,14 @@ function setConsent(consent) {
   getDmdSDK()?.setConsent(consent);
 }
 function getDmdHealth() {
-  if (singleton?.getHealth) {
+  if (singleton) {
     return singleton.getHealth();
   }
   const health = {
-    initialized: Boolean(singleton?.initialized ?? singleton),
-    consent: singleton?.gdprConsent ?? "pending",
-    queueSize: singleton?.queue?.length ?? 0,
-    offline: Boolean(singleton?.offline),
+    initialized: false,
+    consent: "pending",
+    queueSize: 0,
+    offline: false,
     droppedEvents
   };
   if (lastError !== void 0) {