@databuddy/sdk 2.3.28 → 2.3.29

package/dist/node/index.d.mts

@@ -13,8 +13,14 @@ interface Logger {
  */
 type Middleware = (event: BatchEventInput) => BatchEventInput | null | Promise<BatchEventInput | null>;
 interface DatabuddyConfig {
-    /** Client ID from Databuddy dashboard */
-    clientId: string;
+    /** API key for authentication (dbdy_xxx) */
+    apiKey: string;
+    /** Optional default website ID to scope events to */
+    websiteId?: string;
+    /** Optional default namespace for logical grouping (e.g., 'billing', 'auth', 'api') */
+    namespace?: string;
+    /** Optional default source identifier for events (e.g., 'backend', 'webhook', 'cli') */
+    source?: string;
     /** Custom API endpoint (default: https://basket.databuddy.cc) */
     apiUrl?: string;
     /** Enable debug logging */
@@ -49,6 +55,12 @@ interface CustomEventInput {
     timestamp?: number | null;
     /** Event properties/metadata */
     properties?: Record<string, unknown> | null;
+    /** Website ID to scope the event to (overrides default) */
+    websiteId?: string | null;
+    /** Namespace for logical grouping (overrides default) */
+    namespace?: string | null;
+    /** Source identifier (overrides default) */
+    source?: string | null;
 }
 interface EventResponse {
     /** Whether the event was successfully sent */
@@ -73,6 +85,12 @@ interface BatchEventInput {
     timestamp?: number | null;
     /** Event properties/metadata */
     properties?: Record<string, unknown> | null;
+    /** Website ID to scope the event to */
+    websiteId?: string | null;
+    /** Namespace for logical grouping */
+    namespace?: string | null;
+    /** Source identifier */
+    source?: string | null;
 }
 /**
  * Global properties that will be attached to all events
@@ -207,7 +225,10 @@ declare function createServerFlagsManagerInMemory(config: FlagsConfig): ServerFl
 /** biome-ignore-all lint/performance/noBarrelFile: im a big fan of barrels */
 
 declare class Databuddy {
-    private readonly clientId;
+    private readonly apiKey;
+    private readonly websiteId?;
+    private readonly namespace?;
+    private readonly source?;
     private readonly apiUrl;
     private readonly logger;
     private readonly enableBatching;
@@ -231,13 +252,20 @@ declare class Databuddy {
      *   name: 'user_signup',
      *   properties: { plan: 'pro', source: 'web' }
      * });
+     *
+     * // With website scope
+     * await client.track({
+     *   name: 'page_view',
+     *   websiteId: 'website-uuid',
+     *   properties: { path: '/pricing' }
+     * });
      * ```
      */
     track(event: CustomEventInput): Promise<EventResponse>;
     /**
-     * Convert BatchEventInput to CustomEventSpan format expected by /events endpoint
+     * Convert BatchEventInput to format expected by /track endpoint
      */
-    private toCustomEventSpan;
+    private toTrackPayload;
     private send;
     private scheduleFlush;
     /**

package/dist/node/index.d.ts

@@ -13,8 +13,14 @@ interface Logger {
  */
 type Middleware = (event: BatchEventInput) => BatchEventInput | null | Promise<BatchEventInput | null>;
 interface DatabuddyConfig {
-    /** Client ID from Databuddy dashboard */
-    clientId: string;
+    /** API key for authentication (dbdy_xxx) */
+    apiKey: string;
+    /** Optional default website ID to scope events to */
+    websiteId?: string;
+    /** Optional default namespace for logical grouping (e.g., 'billing', 'auth', 'api') */
+    namespace?: string;
+    /** Optional default source identifier for events (e.g., 'backend', 'webhook', 'cli') */
+    source?: string;
     /** Custom API endpoint (default: https://basket.databuddy.cc) */
     apiUrl?: string;
     /** Enable debug logging */
@@ -49,6 +55,12 @@ interface CustomEventInput {
     timestamp?: number | null;
     /** Event properties/metadata */
     properties?: Record<string, unknown> | null;
+    /** Website ID to scope the event to (overrides default) */
+    websiteId?: string | null;
+    /** Namespace for logical grouping (overrides default) */
+    namespace?: string | null;
+    /** Source identifier (overrides default) */
+    source?: string | null;
 }
 interface EventResponse {
     /** Whether the event was successfully sent */
@@ -73,6 +85,12 @@ interface BatchEventInput {
     timestamp?: number | null;
     /** Event properties/metadata */
     properties?: Record<string, unknown> | null;
+    /** Website ID to scope the event to */
+    websiteId?: string | null;
+    /** Namespace for logical grouping */
+    namespace?: string | null;
+    /** Source identifier */
+    source?: string | null;
 }
 /**
  * Global properties that will be attached to all events
@@ -207,7 +225,10 @@ declare function createServerFlagsManagerInMemory(config: FlagsConfig): ServerFl
 /** biome-ignore-all lint/performance/noBarrelFile: im a big fan of barrels */
 
 declare class Databuddy {
-    private readonly clientId;
+    private readonly apiKey;
+    private readonly websiteId?;
+    private readonly namespace?;
+    private readonly source?;
     private readonly apiUrl;
     private readonly logger;
     private readonly enableBatching;
@@ -231,13 +252,20 @@ declare class Databuddy {
      *   name: 'user_signup',
      *   properties: { plan: 'pro', source: 'web' }
      * });
+     *
+     * // With website scope
+     * await client.track({
+     *   name: 'page_view',
+     *   websiteId: 'website-uuid',
+     *   properties: { path: '/pricing' }
+     * });
      * ```
      */
     track(event: CustomEventInput): Promise<EventResponse>;
     /**
-     * Convert BatchEventInput to CustomEventSpan format expected by /events endpoint
+     * Convert BatchEventInput to format expected by /track endpoint
      */
-    private toCustomEventSpan;
+    private toTrackPayload;
     private send;
     private scheduleFlush;
     /**

package/dist/node/index.mjs

@@ -320,7 +320,10 @@ const DEFAULT_BATCH_TIMEOUT = 2e3;
 const DEFAULT_MAX_QUEUE_SIZE = 1e3;
 const DEFAULT_MAX_DEDUPLICATION_CACHE_SIZE = 1e4;
 class Databuddy {
-  clientId;
+  apiKey;
+  websiteId;
+  namespace;
+  source;
   apiUrl;
   logger;
   enableBatching;
@@ -334,10 +337,13 @@ class Databuddy {
   deduplicationCache = /* @__PURE__ */ new Set();
   maxDeduplicationCacheSize;
   constructor(config) {
-    if (!config.clientId || typeof config.clientId !== "string") {
-      throw new Error("clientId is required and must be a string");
+    if (!config.apiKey || typeof config.apiKey !== "string") {
+      throw new Error("apiKey is required and must be a string");
     }
-    this.clientId = config.clientId.trim();
+    this.apiKey = config.apiKey.trim();
+    this.websiteId = config.websiteId?.trim();
+    this.namespace = config.namespace?.trim();
+    this.source = config.source?.trim();
     this.apiUrl = config.apiUrl?.trim() || DEFAULT_API_URL;
     this.enableBatching = config.enableBatching !== false;
     this.batchSize = Math.min(config.batchSize || DEFAULT_BATCH_SIZE, 100);
@@ -354,7 +360,10 @@ class Databuddy {
       this.logger = createNoopLogger();
     }
     this.logger.info("Initialized", {
-      clientId: this.clientId,
+      hasApiKey: true,
+      websiteId: this.websiteId,
+      namespace: this.namespace,
+      source: this.source,
       apiUrl: this.apiUrl,
       enableBatching: this.enableBatching,
       batchSize: this.batchSize,
@@ -373,6 +382,13 @@ class Databuddy {
    *   name: 'user_signup',
    *   properties: { plan: 'pro', source: 'web' }
    * });
+   *
+   * // With website scope
+   * await client.track({
+   *   name: 'page_view',
+   *   websiteId: 'website-uuid',
+   *   properties: { path: '/pricing' }
+   * });
    * ```
    */
   async track(event) {
@@ -392,7 +408,10 @@ class Databuddy {
       properties: {
         ...this.globalProperties,
         ...event.properties || {}
-      }
+      },
+      websiteId: event.websiteId ?? this.websiteId,
+      namespace: event.namespace ?? this.namespace,
+      source: event.source ?? this.source
     };
     const processedEvent = await this.applyMiddleware(batchEvent);
     if (!processedEvent) {
@@ -420,34 +439,38 @@ class Databuddy {
     return { success: true };
   }
   /**
-   * Convert BatchEventInput to CustomEventSpan format expected by /events endpoint
+   * Convert BatchEventInput to format expected by /track endpoint
    */
-  toCustomEventSpan(event) {
+  toTrackPayload(event) {
     const timestamp = event.timestamp ? Math.floor(event.timestamp) : Date.now();
     return {
+      name: event.name,
+      namespace: event.namespace ?? void 0,
       timestamp,
-      path: "",
-      eventName: event.name,
-      anonymousId: event.anonymousId ?? null,
-      sessionId: event.sessionId ?? null,
-      properties: event.properties ?? null
+      properties: event.properties ?? void 0,
+      anonymousId: event.anonymousId ?? void 0,
+      sessionId: event.sessionId ?? void 0,
+      websiteId: event.websiteId ?? void 0,
+      source: event.source ?? void 0
     };
   }
   async send(event) {
     try {
-      const url = `${this.apiUrl}/events?client_id=${encodeURIComponent(this.clientId)}`;
-      const customEventSpan = this.toCustomEventSpan(event);
+      const url = `${this.apiUrl}/track`;
+      const payload = this.toTrackPayload(event);
       this.logger.info("\u{1F4E4} SENDING SINGLE EVENT:", {
-        eventName: customEventSpan.eventName,
-        properties: JSON.stringify(customEventSpan.properties, null, 2),
-        propertiesCount: Object.keys(customEventSpan.properties || {}).length
+        name: payload.name,
+        websiteId: payload.websiteId,
+        source: payload.source,
+        properties: JSON.stringify(payload.properties, null, 2)
       });
       const response = await fetch(url, {
         method: "POST",
         headers: {
-          "Content-Type": "application/json"
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`
         },
-        body: JSON.stringify([customEventSpan])
+        body: JSON.stringify(payload)
       });
       if (!response.ok) {
         const errorText = await response.text().catch(() => "Unknown error");
@@ -566,7 +589,10 @@ class Databuddy {
       properties: {
         ...this.globalProperties,
         ...event.properties || {}
-      }
+      },
+      websiteId: event.websiteId ?? this.websiteId,
+      namespace: event.namespace ?? this.namespace,
+      source: event.source ?? this.source
     }));
     const processedEvents = [];
     for (const event of enrichedEvents) {
@@ -593,28 +619,23 @@ class Databuddy {
       };
     }
     try {
-      const url = `${this.apiUrl}/events?client_id=${encodeURIComponent(this.clientId)}`;
-      const customEventSpans = processedEvents.map(
-        (event) => this.toCustomEventSpan(event)
+      const url = `${this.apiUrl}/track`;
+      const payloads = processedEvents.map(
+        (event) => this.toTrackPayload(event)
       );
       this.logger.info("\u{1F4E6} SENDING BATCH EVENTS:", {
-        count: customEventSpans.length,
-        firstEventName: customEventSpans[0]?.eventName,
-        firstEventProperties: JSON.stringify(
-          customEventSpans[0]?.properties,
-          null,
-          2
-        ),
-        firstEventPropertiesCount: Object.keys(
-          customEventSpans[0]?.properties || {}
-        ).length
+        count: payloads.length,
+        firstEventName: payloads[0]?.name,
+        firstWebsiteId: payloads[0]?.websiteId,
+        firstSource: payloads[0]?.source
       });
       const response = await fetch(url, {
         method: "POST",
         headers: {
-          "Content-Type": "application/json"
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`
         },
-        body: JSON.stringify(customEventSpans)
+        body: JSON.stringify(payloads)
       });
       if (!response.ok) {
         const errorText = await response.text().catch(() => "Unknown error");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@databuddy/sdk",
-  "version": "2.3.28",
+  "version": "2.3.29",
   "description": "Official Databuddy Analytics SDK",
   "main": "./dist/core/index.mjs",
   "types": "./dist/core/index.d.ts",