@databuddy/sdk 2.0.0 → 2.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@databuddy/sdk?style=flat-square)](https://www.npmjs.com/package/@databuddy/sdk)
 [![License](https://img.shields.io/npm/l/@databuddy/sdk?style=flat-square)](./LICENSE)
-[![Docs](https://img.shields.io/badge/docs-databuddy.cc-blue?style=flat-square)](https://docs.databuddy.cc)
+[![Docs](https://img.shields.io/badge/docs-databuddy.cc-blue?style=flat-square)](https://www.databuddy.cc/docs)
 
 > **The easiest, privacy-first way to add analytics to your web app.**
 
@@ -16,6 +16,7 @@
 - 🧩 **Drop-in React/Next.js component: `<Databuddy />`**
 - 🛡️ **Privacy-first: anonymized by default, sampling, batching, and more**
 - 🛠️ **Type-safe config and autocompletion**
+- 📋 **Observability: logging, error tracking, and distributed tracing**
 
 ---
 
@@ -120,7 +121,7 @@ A: In your [Databuddy dashboard](https://app.databuddy.cc).
 
 ## 📚 Documentation & Support
 
-- [Databuddy Docs](https://docs.databuddy.cc)
+- [Databuddy Docs](https://www.databuddy.cc/docs)
 - [Dashboard](https://app.databuddy.cc)
 - [Contact Support](https://www.databuddy.cc/contact)
 

package/dist/core/index.d.mts

@@ -1,5 +1,11 @@
-import { D as DatabuddyConfig, a as DatabuddyTracker, T as TrackFunction, b as Databuddy$1 } from '../shared/@databuddy/sdk.Sqo9i0iN.mjs';
-export { B as BaseEventProperties, e as DataAttributes, d as EventName, E as EventProperties, c as EventTypeMap, P as PropertiesForEvent, S as ScreenViewFunction, f as SetGlobalPropertiesFunction } from '../shared/@databuddy/sdk.Sqo9i0iN.mjs';
+import { D as DatabuddyConfig, a as DatabuddyTracker, T as TrackFunction, b as Databuddy$1 } from '../shared/@databuddy/sdk.ClgMzRh8.mjs';
+export { B as BaseEventProperties, e as DataAttributes, d as EventName, E as EventProperties, c as EventTypeMap, P as PropertiesForEvent, S as ScreenViewFunction, f as SetGlobalPropertiesFunction } from '../shared/@databuddy/sdk.ClgMzRh8.mjs';
+
+/**
+ * Auto-detect Databuddy client ID from environment variables
+ * Supports Next.js, Nuxt, and other frameworks
+ */
+declare function detectClientId(providedClientId?: string): string | undefined;
 
 declare function isScriptInjected(): boolean;
 declare function createScript({ scriptUrl, sdkVersion, ...props }: DatabuddyConfig): HTMLScriptElement;
@@ -46,4 +52,4 @@ declare function trackError(message: string, properties?: {
  */
 declare const Databuddy: typeof Databuddy$1;
 
-export { Databuddy, DatabuddyConfig, DatabuddyTracker, TrackFunction, clear, createScript, flush, getTracker, isScriptInjected, isTrackerAvailable, track, trackError };
+export { Databuddy, DatabuddyConfig, DatabuddyTracker, TrackFunction, clear, createScript, detectClientId, flush, getTracker, isScriptInjected, isTrackerAvailable, track, trackError };

package/dist/core/index.d.ts

@@ -1,5 +1,11 @@
-import { D as DatabuddyConfig, a as DatabuddyTracker, T as TrackFunction, b as Databuddy$1 } from '../shared/@databuddy/sdk.Sqo9i0iN.js';
-export { B as BaseEventProperties, e as DataAttributes, d as EventName, E as EventProperties, c as EventTypeMap, P as PropertiesForEvent, S as ScreenViewFunction, f as SetGlobalPropertiesFunction } from '../shared/@databuddy/sdk.Sqo9i0iN.js';
+import { D as DatabuddyConfig, a as DatabuddyTracker, T as TrackFunction, b as Databuddy$1 } from '../shared/@databuddy/sdk.ClgMzRh8.js';
+export { B as BaseEventProperties, e as DataAttributes, d as EventName, E as EventProperties, c as EventTypeMap, P as PropertiesForEvent, S as ScreenViewFunction, f as SetGlobalPropertiesFunction } from '../shared/@databuddy/sdk.ClgMzRh8.js';
+
+/**
+ * Auto-detect Databuddy client ID from environment variables
+ * Supports Next.js, Nuxt, and other frameworks
+ */
+declare function detectClientId(providedClientId?: string): string | undefined;
 
 declare function isScriptInjected(): boolean;
 declare function createScript({ scriptUrl, sdkVersion, ...props }: DatabuddyConfig): HTMLScriptElement;
@@ -46,4 +52,4 @@ declare function trackError(message: string, properties?: {
  */
 declare const Databuddy: typeof Databuddy$1;
 
-export { Databuddy, DatabuddyConfig, DatabuddyTracker, TrackFunction, clear, createScript, flush, getTracker, isScriptInjected, isTrackerAvailable, track, trackError };
+export { Databuddy, DatabuddyConfig, DatabuddyTracker, TrackFunction, clear, createScript, detectClientId, flush, getTracker, isScriptInjected, isTrackerAvailable, track, trackError };

package/dist/core/index.mjs

@@ -1,5 +1,6 @@
+import { D as Databuddy$1 } from '../shared/@databuddy/sdk.B72MFYNj.mjs';
+export { d as detectClientId } from '../shared/@databuddy/sdk.B72MFYNj.mjs';
 export { c as createScript, i as isScriptInjected } from '../shared/@databuddy/sdk.CtTNAIIE.mjs';
-import { Databuddy as Databuddy$1 } from '../react/index.mjs';
 
 function isTrackerAvailable() {
   return typeof window !== "undefined" && (!!window.databuddy || !!window.db);

package/dist/react/index.d.mts

@@ -1 +1 @@
-export { b as Databuddy } from '../shared/@databuddy/sdk.Sqo9i0iN.mjs';
+export { b as Databuddy } from '../shared/@databuddy/sdk.ClgMzRh8.mjs';

package/dist/react/index.d.ts

@@ -1 +1 @@
-export { b as Databuddy } from '../shared/@databuddy/sdk.Sqo9i0iN.js';
+export { b as Databuddy } from '../shared/@databuddy/sdk.ClgMzRh8.js';

package/dist/react/index.mjs

@@ -1,13 +1,4 @@
 'use client';
 
-import { i as isScriptInjected, c as createScript } from '../shared/@databuddy/sdk.CtTNAIIE.mjs';
-
-function Databuddy(props) {
-  if (typeof window !== "undefined" && !props.disabled && !isScriptInjected()) {
-    const script = createScript(props);
-    document.head.appendChild(script);
-  }
-  return null;
-}
-
-export { Databuddy };
+export { D as Databuddy } from '../shared/@databuddy/sdk.B72MFYNj.mjs';
+import '../shared/@databuddy/sdk.CtTNAIIE.mjs';

package/dist/shared/@databuddy/sdk.B72MFYNj.mjs

@@ -0,0 +1,44 @@
+import { i as isScriptInjected, c as createScript } from './sdk.CtTNAIIE.mjs';
+
+function detectClientId(providedClientId) {
+  if (providedClientId) {
+    return providedClientId;
+  }
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.NEXT_PUBLIC_DATABUDDY_CLIENT_ID || process.env.NUXT_PUBLIC_DATABUDDY_CLIENT_ID || process.env.VITE_DATABUDDY_CLIENT_ID || process.env.REACT_APP_DATABUDDY_CLIENT_ID;
+  }
+  if (typeof window !== "undefined") {
+    const nextEnv = window.__NEXT_DATA__?.env?.NEXT_PUBLIC_DATABUDDY_CLIENT_ID;
+    if (nextEnv) {
+      return nextEnv;
+    }
+    const nuxtEnv = window.__NUXT__?.env?.NUXT_PUBLIC_DATABUDDY_CLIENT_ID;
+    if (nuxtEnv) {
+      return nuxtEnv;
+    }
+    const viteEnv = window.__VITE_ENV__?.VITE_DATABUDDY_CLIENT_ID;
+    if (viteEnv) {
+      return viteEnv;
+    }
+  }
+  return;
+}
+
+function Databuddy(props) {
+  const clientId = detectClientId(props.clientId);
+  if (!clientId) {
+    if (typeof window !== "undefined" && !props.disabled) {
+      console.warn(
+        "Databuddy: No client ID found. Please provide clientId prop or set NEXT_PUBLIC_DATABUDDY_CLIENT_ID environment variable."
+      );
+    }
+    return null;
+  }
+  if (typeof window !== "undefined" && !props.disabled && !isScriptInjected()) {
+    const script = createScript({ ...props, clientId });
+    document.head.appendChild(script);
+  }
+  return null;
+}
+
+export { Databuddy as D, detectClientId as d };

package/dist/shared/@databuddy/{sdk.Sqo9i0iN.d.mts → sdk.ClgMzRh8.d.mts}

@@ -4,11 +4,12 @@
  */
 interface DatabuddyConfig {
     /**
-     * Your Databuddy project client ID (required).
+     * Your Databuddy project client ID.
+     * If not provided, will automatically detect from NEXT_PUBLIC_DATABUDDY_CLIENT_ID environment variable.
      * Get this from your Databuddy dashboard.
      * Example: '3ed1fce1-5a56-4cbc-a917-66864f6d18e3'
      */
-    clientId: string;
+    clientId?: string;
     /**
      * (Advanced) Your Databuddy client secret for server-side operations.
      * Not required for browser usage.
@@ -95,6 +96,34 @@ interface DatabuddyConfig {
      * Track JavaScript errors (default: false).
      */
     trackErrors?: boolean;
+    /**
+     * Enable observability features (logging, error tracking, tracing) (default: false).
+     */
+    enableObservability?: boolean;
+    /**
+     * Service name for observability events.
+     */
+    observabilityService?: string;
+    /**
+     * Environment for observability events.
+     */
+    observabilityEnvironment?: string;
+    /**
+     * Service version for observability events.
+     */
+    observabilityVersion?: string;
+    /**
+     * Enable structured logging (default: false).
+     */
+    enableLogging?: boolean;
+    /**
+     * Enable distributed tracing (default: false).
+     */
+    enableTracing?: boolean;
+    /**
+     * Enable error tracking (default: false).
+     */
+    enableErrorTracking?: boolean;
     /**
      * Sampling rate for events (0.0 to 1.0, default: 1.0).
      * Example: 0.5 = 50% of events sent.
@@ -301,6 +330,7 @@ type SetGlobalPropertiesFunction = (properties: EventProperties) => void;
  * <Databuddy /> component for Next.js/React apps
  * Injects the databuddy.js script with all config as data attributes
  * Usage: <Databuddy clientId="..." trackScreenViews trackPerformance ... />
+ * Or simply: <Databuddy /> (auto-detects clientId from environment variables)
  */
 declare function Databuddy(props: DatabuddyConfig): null;
 

package/dist/shared/@databuddy/{sdk.Sqo9i0iN.d.ts → sdk.ClgMzRh8.d.ts}

@@ -4,11 +4,12 @@
  */
 interface DatabuddyConfig {
     /**
-     * Your Databuddy project client ID (required).
+     * Your Databuddy project client ID.
+     * If not provided, will automatically detect from NEXT_PUBLIC_DATABUDDY_CLIENT_ID environment variable.
      * Get this from your Databuddy dashboard.
      * Example: '3ed1fce1-5a56-4cbc-a917-66864f6d18e3'
      */
-    clientId: string;
+    clientId?: string;
     /**
      * (Advanced) Your Databuddy client secret for server-side operations.
      * Not required for browser usage.
@@ -95,6 +96,34 @@ interface DatabuddyConfig {
      * Track JavaScript errors (default: false).
      */
     trackErrors?: boolean;
+    /**
+     * Enable observability features (logging, error tracking, tracing) (default: false).
+     */
+    enableObservability?: boolean;
+    /**
+     * Service name for observability events.
+     */
+    observabilityService?: string;
+    /**
+     * Environment for observability events.
+     */
+    observabilityEnvironment?: string;
+    /**
+     * Service version for observability events.
+     */
+    observabilityVersion?: string;
+    /**
+     * Enable structured logging (default: false).
+     */
+    enableLogging?: boolean;
+    /**
+     * Enable distributed tracing (default: false).
+     */
+    enableTracing?: boolean;
+    /**
+     * Enable error tracking (default: false).
+     */
+    enableErrorTracking?: boolean;
     /**
      * Sampling rate for events (0.0 to 1.0, default: 1.0).
      * Example: 0.5 = 50% of events sent.
@@ -301,6 +330,7 @@ type SetGlobalPropertiesFunction = (properties: EventProperties) => void;
  * <Databuddy /> component for Next.js/React apps
  * Injects the databuddy.js script with all config as data attributes
  * Usage: <Databuddy clientId="..." trackScreenViews trackPerformance ... />
+ * Or simply: <Databuddy /> (auto-detects clientId from environment variables)
  */
 declare function Databuddy(props: DatabuddyConfig): null;
 

package/dist/vue/index.d.mts

@@ -1,10 +1,10 @@
 import * as vue from 'vue';
 
 declare const Databuddy: vue.DefineComponent<{
-    clientId: {
+    clientId?: {
         type: StringConstructor;
-        required: true;
-    };
+        required: false;
+    } | undefined;
     clientSecret?: {
         type: StringConstructor;
         required: false;
@@ -85,6 +85,34 @@ declare const Databuddy: vue.DefineComponent<{
         type: BooleanConstructor;
         required: false;
     } | undefined;
+    enableObservability?: {
+        type: BooleanConstructor;
+        required: false;
+    } | undefined;
+    observabilityService?: {
+        type: StringConstructor;
+        required: false;
+    } | undefined;
+    observabilityEnvironment?: {
+        type: StringConstructor;
+        required: false;
+    } | undefined;
+    observabilityVersion?: {
+        type: StringConstructor;
+        required: false;
+    } | undefined;
+    enableLogging?: {
+        type: BooleanConstructor;
+        required: false;
+    } | undefined;
+    enableTracing?: {
+        type: BooleanConstructor;
+        required: false;
+    } | undefined;
+    enableErrorTracking?: {
+        type: BooleanConstructor;
+        required: false;
+    } | undefined;
     samplingRate?: {
         type: NumberConstructor;
         required: false;
@@ -113,13 +141,12 @@ declare const Databuddy: vue.DefineComponent<{
         type: NumberConstructor;
         required: false;
     } | undefined;
-}, () => null, unknown, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, Record<string, any>, string, vue.VNodeProps & vue.AllowedComponentProps & vue.ComponentCustomProps, Readonly<{
-    clientId: string;
-} & {
+}, () => null, unknown, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, Record<string, any>, string, vue.VNodeProps & vue.AllowedComponentProps & vue.ComponentCustomProps, Readonly<{} & {
+    sdk?: string | undefined;
+    clientId?: string | undefined;
     clientSecret?: string | undefined;
     apiUrl?: string | undefined;
     scriptUrl?: string | undefined;
-    sdk?: string | undefined;
     sdkVersion?: string | undefined;
     disabled?: boolean | undefined;
     waitForProfile?: boolean | undefined;
@@ -136,6 +163,13 @@ declare const Databuddy: vue.DefineComponent<{
     trackPerformance?: boolean | undefined;
     trackWebVitals?: boolean | undefined;
     trackErrors?: boolean | undefined;
+    enableObservability?: boolean | undefined;
+    observabilityService?: string | undefined;
+    observabilityEnvironment?: string | undefined;
+    observabilityVersion?: string | undefined;
+    enableLogging?: boolean | undefined;
+    enableTracing?: boolean | undefined;
+    enableErrorTracking?: boolean | undefined;
     samplingRate?: number | undefined;
     enableRetries?: boolean | undefined;
     maxRetries?: number | undefined;

package/dist/vue/index.d.ts

@@ -1,10 +1,10 @@
 import * as vue from 'vue';
 
 declare const Databuddy: vue.DefineComponent<{
-    clientId: {
+    clientId?: {
         type: StringConstructor;
-        required: true;
-    };
+        required: false;
+    } | undefined;
     clientSecret?: {
         type: StringConstructor;
         required: false;
@@ -85,6 +85,34 @@ declare const Databuddy: vue.DefineComponent<{
         type: BooleanConstructor;
         required: false;
     } | undefined;
+    enableObservability?: {
+        type: BooleanConstructor;
+        required: false;
+    } | undefined;
+    observabilityService?: {
+        type: StringConstructor;
+        required: false;
+    } | undefined;
+    observabilityEnvironment?: {
+        type: StringConstructor;
+        required: false;
+    } | undefined;
+    observabilityVersion?: {
+        type: StringConstructor;
+        required: false;
+    } | undefined;
+    enableLogging?: {
+        type: BooleanConstructor;
+        required: false;
+    } | undefined;
+    enableTracing?: {
+        type: BooleanConstructor;
+        required: false;
+    } | undefined;
+    enableErrorTracking?: {
+        type: BooleanConstructor;
+        required: false;
+    } | undefined;
     samplingRate?: {
         type: NumberConstructor;
         required: false;
@@ -113,13 +141,12 @@ declare const Databuddy: vue.DefineComponent<{
         type: NumberConstructor;
         required: false;
     } | undefined;
-}, () => null, unknown, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, Record<string, any>, string, vue.VNodeProps & vue.AllowedComponentProps & vue.ComponentCustomProps, Readonly<{
-    clientId: string;
-} & {
+}, () => null, unknown, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, Record<string, any>, string, vue.VNodeProps & vue.AllowedComponentProps & vue.ComponentCustomProps, Readonly<{} & {
+    sdk?: string | undefined;
+    clientId?: string | undefined;
     clientSecret?: string | undefined;
     apiUrl?: string | undefined;
     scriptUrl?: string | undefined;
-    sdk?: string | undefined;
     sdkVersion?: string | undefined;
     disabled?: boolean | undefined;
     waitForProfile?: boolean | undefined;
@@ -136,6 +163,13 @@ declare const Databuddy: vue.DefineComponent<{
     trackPerformance?: boolean | undefined;
     trackWebVitals?: boolean | undefined;
     trackErrors?: boolean | undefined;
+    enableObservability?: boolean | undefined;
+    observabilityService?: string | undefined;
+    observabilityEnvironment?: string | undefined;
+    observabilityVersion?: string | undefined;
+    enableLogging?: boolean | undefined;
+    enableTracing?: boolean | undefined;
+    enableErrorTracking?: boolean | undefined;
     samplingRate?: number | undefined;
     enableRetries?: boolean | undefined;
     maxRetries?: number | undefined;

package/package.json

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