@datalyr/api 1.2.2 → 1.2.3

package/README.md

@@ -112,6 +112,22 @@ await datalyr.page('user_123', 'Pricing', {
 });
 ```
 
+### alias()
+
+```javascript
+await datalyr.alias(newUserId: string, previousId?: string);
+```
+
+Link a new user ID to a previous one (e.g., after account merge). If `previousId` is omitted, the current anonymous ID is used. Internally sends a `$alias` event.
+
+```javascript
+// Link new ID to the current anonymous user
+await datalyr.alias('new_user_456');
+
+// Or specify the previous ID explicitly
+await datalyr.alias('new_user_456', 'old_user_123');
+```
+
 ### group()
 
 ```javascript

package/dist/index.d.mts

@@ -11,6 +11,7 @@ interface DatalyrConfig {
 interface TrackEvent {
     userId?: string;
     anonymousId?: string;
+    eventId?: string;
     event: string;
     properties?: Record<string, any>;
     context?: Record<string, any>;
@@ -40,6 +41,7 @@ declare class Datalyr {
     track(options: TrackOptions): Promise<void>;
     track(userId: string | null, event: string, properties?: any): Promise<void>;
     identify(userId: string, traits?: any): Promise<void>;
+    alias(newUserId: string, previousId?: string): Promise<void>;
     page(userId: string, name?: string, properties?: any): Promise<void>;
     group(userId: string, groupId: string, traits?: any): Promise<void>;
     private enqueue;

package/dist/index.d.ts

@@ -11,6 +11,7 @@ interface DatalyrConfig {
 interface TrackEvent {
     userId?: string;
     anonymousId?: string;
+    eventId?: string;
     event: string;
     properties?: Record<string, any>;
     context?: Record<string, any>;
@@ -40,6 +41,7 @@ declare class Datalyr {
     track(options: TrackOptions): Promise<void>;
     track(userId: string | null, event: string, properties?: any): Promise<void>;
     identify(userId: string, traits?: any): Promise<void>;
+    alias(newUserId: string, previousId?: string): Promise<void>;
     page(userId: string, name?: string, properties?: any): Promise<void>;
     group(userId: string, groupId: string, traits?: any): Promise<void>;
     private enqueue;

package/dist/index.js

@@ -24,6 +24,13 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
+function generateEventId() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "evt_" + Math.random().toString(36).substring(2) + Date.now().toString(36);
+}
+var SDK_VERSION = "1.2.3";
 var Datalyr = class {
   // Persistent anonymous ID for identity resolution
   constructor(config) {
@@ -96,13 +103,13 @@ var Datalyr = class {
       userId: userId || void 0,
       anonymousId,
       // Always include for identity resolution
+      eventId: generateEventId(),
       event: eventName,
       properties: enrichedProperties,
       context: {
         library: "@datalyr/api",
-        version: "1.2.1",
+        version: SDK_VERSION,
         source: "api"
-        // Explicitly set source for server-side API
       },
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     };
@@ -113,7 +120,17 @@ var Datalyr = class {
       throw new Error("userId is required for identify");
     }
     return this.track(userId, "$identify", {
-      $set: traits,
+      ...traits,
+      anonymous_id: this.getOrCreateAnonymousId()
+    });
+  }
+  async alias(newUserId, previousId) {
+    if (!newUserId) {
+      throw new Error("newUserId is required for alias");
+    }
+    return this.track(newUserId, "$alias", {
+      new_user_id: newUserId,
+      previous_id: previousId || this.getOrCreateAnonymousId(),
       anonymous_id: this.getOrCreateAnonymousId()
     });
   }
@@ -124,7 +141,7 @@ var Datalyr = class {
     if (!groupId) {
       throw new Error("groupId is required for group");
     }
-    return this.track(userId, "$group", { groupId, traits });
+    return this.track(userId, "$group", { groupId, ...traits });
   }
   enqueue(event) {
     if (this.queue.length >= this.maxQueueSize) {
@@ -183,7 +200,8 @@ var Datalyr = class {
         method: "POST",
         headers: {
           "X-API-Key": this.apiKey,
-          "Content-Type": "application/json"
+          "Content-Type": "application/json",
+          "User-Agent": `@datalyr/api/${SDK_VERSION}`
         },
         body: JSON.stringify(event),
         signal: controller.signal

package/dist/index.mjs

@@ -1,4 +1,11 @@
 // src/index.ts
+function generateEventId() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "evt_" + Math.random().toString(36).substring(2) + Date.now().toString(36);
+}
+var SDK_VERSION = "1.2.3";
 var Datalyr = class {
   // Persistent anonymous ID for identity resolution
   constructor(config) {
@@ -71,13 +78,13 @@ var Datalyr = class {
       userId: userId || void 0,
       anonymousId,
       // Always include for identity resolution
+      eventId: generateEventId(),
       event: eventName,
       properties: enrichedProperties,
       context: {
         library: "@datalyr/api",
-        version: "1.2.1",
+        version: SDK_VERSION,
         source: "api"
-        // Explicitly set source for server-side API
       },
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     };
@@ -88,7 +95,17 @@ var Datalyr = class {
       throw new Error("userId is required for identify");
     }
     return this.track(userId, "$identify", {
-      $set: traits,
+      ...traits,
+      anonymous_id: this.getOrCreateAnonymousId()
+    });
+  }
+  async alias(newUserId, previousId) {
+    if (!newUserId) {
+      throw new Error("newUserId is required for alias");
+    }
+    return this.track(newUserId, "$alias", {
+      new_user_id: newUserId,
+      previous_id: previousId || this.getOrCreateAnonymousId(),
       anonymous_id: this.getOrCreateAnonymousId()
     });
   }
@@ -99,7 +116,7 @@ var Datalyr = class {
     if (!groupId) {
       throw new Error("groupId is required for group");
     }
-    return this.track(userId, "$group", { groupId, traits });
+    return this.track(userId, "$group", { groupId, ...traits });
   }
   enqueue(event) {
     if (this.queue.length >= this.maxQueueSize) {
@@ -158,7 +175,8 @@ var Datalyr = class {
         method: "POST",
         headers: {
           "X-API-Key": this.apiKey,
-          "Content-Type": "application/json"
+          "Content-Type": "application/json",
+          "User-Agent": `@datalyr/api/${SDK_VERSION}`
         },
         body: JSON.stringify(event),
         signal: controller.signal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalyr/api",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Datalyr API SDK for server-side tracking",
   "main": "dist/index.js",
   "module": "dist/index.mjs",