@databuddy/sdk 2.3.27 → 2.3.29

package/dist/core/index.mjs

@@ -1,4 +1,4 @@
-export { c as createScript, i as isScriptInjected } from '../shared/@databuddy/sdk.ClnhxS25.mjs';
+export { c as createScript, i as isScriptInjected } from '../shared/@databuddy/sdk.urY7MmVr.mjs';
 
 function detectClientId(providedClientId) {
   if (providedClientId) {

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,9 +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 format expected by /track endpoint
+     */
+    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,9 +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 format expected by /track endpoint
+     */
+    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) {
@@ -419,20 +438,39 @@ class Databuddy {
     }
     return { success: true };
   }
+  /**
+   * Convert BatchEventInput to format expected by /track endpoint
+   */
+  toTrackPayload(event) {
+    const timestamp = event.timestamp ? Math.floor(event.timestamp) : Date.now();
+    return {
+      name: event.name,
+      namespace: event.namespace ?? void 0,
+      timestamp,
+      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}/?client_id=${encodeURIComponent(this.clientId)}`;
+      const url = `${this.apiUrl}/track`;
+      const payload = this.toTrackPayload(event);
       this.logger.info("\u{1F4E4} SENDING SINGLE EVENT:", {
-        name: event.name,
-        properties: JSON.stringify(event.properties, null, 2),
-        propertiesCount: Object.keys(event.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(event)
+        body: JSON.stringify(payload)
       });
       if (!response.ok) {
         const errorText = await response.text().catch(() => "Unknown error");
@@ -551,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) {
@@ -578,25 +619,23 @@ class Databuddy {
       };
     }
     try {
-      const url = `${this.apiUrl}/batch?client_id=${encodeURIComponent(this.clientId)}`;
+      const url = `${this.apiUrl}/track`;
+      const payloads = processedEvents.map(
+        (event) => this.toTrackPayload(event)
+      );
       this.logger.info("\u{1F4E6} SENDING BATCH EVENTS:", {
-        count: processedEvents.length,
-        firstEventName: processedEvents[0]?.name,
-        firstEventProperties: JSON.stringify(
-          processedEvents[0]?.properties,
-          null,
-          2
-        ),
-        firstEventPropertiesCount: Object.keys(
-          processedEvents[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(processedEvents)
+        body: JSON.stringify(payloads)
       });
       if (!response.ok) {
         const errorText = await response.text().catch(() => "Unknown error");

package/dist/react/index.mjs

@@ -2,7 +2,7 @@
 
 import { detectClientId } from '../core/index.mjs';
 export { clear, flush, getAnonymousId, getSessionId, getTracker, getTrackingIds, getTrackingParams, isTrackerAvailable, track, trackError } from '../core/index.mjs';
-import { i as isScriptInjected, c as createScript } from '../shared/@databuddy/sdk.ClnhxS25.mjs';
+import { i as isScriptInjected, c as createScript } from '../shared/@databuddy/sdk.urY7MmVr.mjs';
 import React, { useRef, useMemo, useEffect, useSyncExternalStore, createContext, useContext } from 'react';
 import { B as BrowserFlagStorage, C as CoreFlagsManager } from '../shared/@databuddy/sdk.DE24-JrU.mjs';
 import { l as logger } from '../shared/@databuddy/sdk.CALvx07o.mjs';

package/dist/shared/@databuddy/{sdk.ClnhxS25.mjs → sdk.urY7MmVr.mjs}

@@ -1,4 +1,4 @@
-const version = "2.3.26";
+const version = "2.3.28";
 
 const INJECTED_SCRIPT_ATTRIBUTE = "data-databuddy-injected";
 function isScriptInjected() {

package/dist/vue/index.mjs

@@ -1,5 +1,5 @@
 import { defineComponent, ref, onMounted, onUnmounted, watch, reactive, watchEffect, computed } from 'vue';
-import { i as isScriptInjected, c as createScript } from '../shared/@databuddy/sdk.ClnhxS25.mjs';
+import { i as isScriptInjected, c as createScript } from '../shared/@databuddy/sdk.urY7MmVr.mjs';
 import { B as BrowserFlagStorage, C as CoreFlagsManager } from '../shared/@databuddy/sdk.DE24-JrU.mjs';
 import '../shared/@databuddy/sdk.CALvx07o.mjs';
 

package/package.json

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