@databuddy/sdk 2.3.1 → 2.3.21

package/dist/core/index.d.mts

@@ -1,7 +1,5 @@
-import { S as StorageInterface, F as FlagsManager, a as FlagsManagerOptions, b as FlagResult, c as FlagState, d as FlagsConfig } from '../shared/@databuddy/sdk.OK9Nbqlf.mjs';
-export { e as FlagsContext } from '../shared/@databuddy/sdk.OK9Nbqlf.mjs';
-import { D as DatabuddyConfig, a as DatabuddyTracker } from '../shared/@databuddy/sdk.CeYE_kaj.mjs';
-export { B as BaseEventProperties, d as DataAttributes, c as EventName, E as EventProperties, b as EventTypeMap, P as PropertiesForEvent, S as ScreenViewFunction, e as SetGlobalPropertiesFunction, T as TrackFunction } from '../shared/@databuddy/sdk.CeYE_kaj.mjs';
+import { D as DatabuddyConfig } from '../shared/@databuddy/sdk.BsF1xr6_.mjs';
+export { B as BaseEventProperties, n as DataAttributes, m as DatabuddyTracker, l as EventName, E as EventProperties, k as EventTypeMap, P as PropertiesForEvent, S as ScreenViewFunction, o as SetGlobalPropertiesFunction, T as TrackFunction, c as clear, f as flush, d as getAnonymousId, e as getSessionId, g as getTracker, h as getTrackingIds, j as getTrackingParams, i as isTrackerAvailable, t as track, a as trackCustomEvent, b as trackError } from '../shared/@databuddy/sdk.BsF1xr6_.mjs';
 
 /**
  * Auto-detect Databuddy client ID from environment variables
@@ -9,267 +7,7 @@ export { B as BaseEventProperties, d as DataAttributes, c as EventName, E as Eve
  */
 declare function detectClientId(providedClientId?: string): string | undefined;
 
-declare class BrowserFlagStorage implements StorageInterface {
-    private ttl;
-    get(key: string): any;
-    set(key: string, value: unknown): void;
-    getAll(): Record<string, unknown>;
-    clear(): void;
-    private getFromLocalStorage;
-    private setToLocalStorage;
-    private isExpired;
-    delete(key: string): void;
-    deleteMultiple(keys: string[]): void;
-    setAll(flags: Record<string, unknown>): void;
-    cleanupExpired(): void;
-}
-
-declare class CoreFlagsManager implements FlagsManager {
-    private config;
-    private storage?;
-    private onFlagsUpdate?;
-    private onConfigUpdate?;
-    private memoryFlags;
-    private pendingFlags;
-    constructor(options: FlagsManagerOptions);
-    private withDefaults;
-    private initialize;
-    private loadCachedFlags;
-    fetchAllFlags(): Promise<void>;
-    getFlag(key: string): Promise<FlagResult>;
-    private fetchFlag;
-    isEnabled(key: string): FlagState;
-    refresh(forceClear?: boolean): void;
-    updateUser(user: FlagsConfig["user"]): void;
-    updateConfig(config: FlagsConfig): void;
-    getMemoryFlags(): Record<string, FlagResult>;
-    getPendingFlags(): Set<string>;
-    private notifyFlagsUpdate;
-}
-
 declare function isScriptInjected(): boolean;
 declare function createScript({ scriptUrl, sdkVersion, clientSecret, filter, debug, ...props }: DatabuddyConfig): HTMLScriptElement;
 
-/**
- * Checks if the Databuddy tracker script has loaded and is available.
- * Use this before calling tracking functions in conditional scenarios.
- *
- * @returns `true` if tracker is available, `false` if not loaded or on server
- *
- * @example
- * ```ts
- * import { isTrackerAvailable, track } from "@databuddy/sdk";
- *
- * if (isTrackerAvailable()) {
- *   track("feature_used", { feature: "export" });
- * }
- * ```
- */
-declare function isTrackerAvailable(): boolean;
-/**
- * Returns the raw Databuddy tracker instance for advanced use cases.
- * Prefer using the exported functions (`track`, `flush`, etc.) instead.
- *
- * @returns Tracker instance or `null` if not available
- *
- * @example
- * ```ts
- * import { getTracker, getAnonymousId, getSessionId } from "@databuddy/sdk";
- *
- * const tracker = getTracker();
- * if (tracker) {
- *   // Access tracker methods
- *   tracker.track("event", { prop: "value" });
- *
- *   // Get IDs using dedicated functions
- *   const anonId = getAnonymousId();
- *   const sessionId = getSessionId();
- * }
- * ```
- */
-declare function getTracker(): DatabuddyTracker | null;
-/**
- * Tracks a custom event with optional properties.
- * Events are batched and sent efficiently to minimize network overhead.
- * Safe to call on server (no-op) or before tracker loads.
- *
- * @param name - Event name (e.g., "button_click", "purchase", "signup")
- * @param properties - Key-value pairs of event data
- *
- * @example
- * ```ts
- * import { track } from "@databuddy/sdk";
- *
- * // Simple event
- * track("signup_started");
- *
- * // Event with properties
- * track("item_purchased", {
- *   itemId: "sku-123",
- *   price: 29.99,
- *   currency: "USD"
- * });
- *
- * // In a React component
- * function CheckoutButton() {
- *   return (
- *     <button onClick={() => track("checkout_clicked", { cartSize: 3 })}>
- *       Checkout
- *     </button>
- *   );
- * }
- * ```
- */
-declare function track(name: string, properties?: Record<string, unknown>): void;
-/** @deprecated Use `track()` instead. Will be removed in v3.0. */
-declare function trackCustomEvent(name: string, properties?: Record<string, unknown>): void;
-/**
- * Clears the current user session and generates new anonymous/session IDs.
- * Use after logout to ensure the next user gets a fresh identity.
- *
- * @example
- * ```ts
- * import { clear } from "@databuddy/sdk";
- *
- * async function handleLogout() {
- *   await signOut();
- *   clear(); // Reset tracking identity
- *   router.push("/login");
- * }
- * ```
- */
-declare function clear(): void;
-/**
- * Forces all queued events to be sent immediately.
- * Useful before navigation or when you need to ensure events are captured.
- *
- * @example
- * ```ts
- * import { track, flush } from "@databuddy/sdk";
- *
- * function handleExternalLink(url: string) {
- *   track("external_link_clicked", { url });
- *   flush(); // Ensure event is sent before leaving
- *   window.location.href = url;
- * }
- * ```
- */
-declare function flush(): void;
-/**
- * Tracks an error event. Convenience wrapper around `track("error", ...)`.
- *
- * @param message - Error message
- * @param properties - Additional error context (filename, line number, stack trace)
- *
- * @example
- * ```ts
- * import { trackError } from "@databuddy/sdk";
- *
- * try {
- *   await riskyOperation();
- * } catch (error) {
- *   trackError(error.message, {
- *     stack: error.stack,
- *     error_type: error.name,
- *     context: "checkout_flow"
- *   });
- * }
- * ```
- */
-declare function trackError(message: string, properties?: {
-    filename?: string;
-    lineno?: number;
-    colno?: number;
-    stack?: string;
-    error_type?: string;
-    [key: string]: string | number | boolean | null | undefined;
-}): void;
-/**
- * Gets the anonymous user ID. Persists across sessions via localStorage.
- * Useful for server-side identification or cross-domain tracking.
- *
- * @param urlParams - Optional URLSearchParams to check for `anonId` param (highest priority)
- * @returns Anonymous ID or `null` if unavailable
- *
- * Priority: URL params → tracker instance → localStorage
- *
- * @example
- * ```ts
- * import { getAnonymousId } from "@databuddy/sdk";
- *
- * // Get from tracker
- * const anonId = getAnonymousId();
- *
- * // Check URL params first (for cross-domain tracking)
- * const params = new URLSearchParams(window.location.search);
- * const anonId = getAnonymousId(params);
- *
- * // Pass to server
- * await fetch("/api/identify", {
- *   body: JSON.stringify({ anonId })
- * });
- * ```
- */
-declare function getAnonymousId(urlParams?: URLSearchParams): string | null;
-/**
- * Gets the current session ID. Resets after 30 min of inactivity.
- * Useful for correlating events within a single browsing session.
- *
- * @param urlParams - Optional URLSearchParams to check for `sessionId` param (highest priority)
- * @returns Session ID or `null` if unavailable
- *
- * Priority: URL params → tracker instance → sessionStorage
- *
- * @example
- * ```ts
- * import { getSessionId } from "@databuddy/sdk";
- *
- * const sessionId = getSessionId();
- * console.log("Current session:", sessionId);
- * ```
- */
-declare function getSessionId(urlParams?: URLSearchParams): string | null;
-/**
- * Gets both anonymous ID and session ID in a single call.
- *
- * @param urlParams - Optional URLSearchParams to check for tracking params
- * @returns Object with `anonId` and `sessionId` (either may be null)
- *
- * @example
- * ```ts
- * import { getTrackingIds } from "@databuddy/sdk";
- *
- * const { anonId, sessionId } = getTrackingIds();
- *
- * // Send to your backend
- * await api.identify({ anonId, sessionId, userId: user.id });
- * ```
- */
-declare function getTrackingIds(urlParams?: URLSearchParams): {
-    anonId: string | null;
-    sessionId: string | null;
-};
-/**
- * Returns tracking IDs as a URL query string for cross-domain tracking.
- * Append to URLs when linking to other domains you own.
- *
- * @param urlParams - Optional URLSearchParams to preserve existing params
- * @returns Query string like `"anonId=xxx&sessionId=yyy"` or empty string
- *
- * @example
- * ```ts
- * import { getTrackingParams } from "@databuddy/sdk";
- *
- * // Link to subdomain with tracking continuity
- * const params = getTrackingParams();
- * const url = `https://app.example.com/dashboard${params ? `?${params}` : ""}`;
- *
- * // In a component
- * <a href={`https://shop.example.com?${getTrackingParams()}`}>
- *   Visit Shop
- * </a>
- * ```
- */
-declare function getTrackingParams(urlParams?: URLSearchParams): string;
-
-export { BrowserFlagStorage, CoreFlagsManager, DatabuddyConfig, DatabuddyTracker, FlagResult, FlagState, FlagsConfig, FlagsManager, FlagsManagerOptions, StorageInterface, clear, createScript, detectClientId, flush, getAnonymousId, getSessionId, getTracker, getTrackingIds, getTrackingParams, isScriptInjected, isTrackerAvailable, track, trackCustomEvent, trackError };
+export { DatabuddyConfig, createScript, detectClientId, isScriptInjected };

package/dist/core/index.d.ts

@@ -1,7 +1,5 @@
-import { S as StorageInterface, F as FlagsManager, a as FlagsManagerOptions, b as FlagResult, c as FlagState, d as FlagsConfig } from '../shared/@databuddy/sdk.OK9Nbqlf.js';
-export { e as FlagsContext } from '../shared/@databuddy/sdk.OK9Nbqlf.js';
-import { D as DatabuddyConfig, a as DatabuddyTracker } from '../shared/@databuddy/sdk.CeYE_kaj.js';
-export { B as BaseEventProperties, d as DataAttributes, c as EventName, E as EventProperties, b as EventTypeMap, P as PropertiesForEvent, S as ScreenViewFunction, e as SetGlobalPropertiesFunction, T as TrackFunction } from '../shared/@databuddy/sdk.CeYE_kaj.js';
+import { D as DatabuddyConfig } from '../shared/@databuddy/sdk.BsF1xr6_.js';
+export { B as BaseEventProperties, n as DataAttributes, m as DatabuddyTracker, l as EventName, E as EventProperties, k as EventTypeMap, P as PropertiesForEvent, S as ScreenViewFunction, o as SetGlobalPropertiesFunction, T as TrackFunction, c as clear, f as flush, d as getAnonymousId, e as getSessionId, g as getTracker, h as getTrackingIds, j as getTrackingParams, i as isTrackerAvailable, t as track, a as trackCustomEvent, b as trackError } from '../shared/@databuddy/sdk.BsF1xr6_.js';
 
 /**
  * Auto-detect Databuddy client ID from environment variables
@@ -9,267 +7,7 @@ export { B as BaseEventProperties, d as DataAttributes, c as EventName, E as Eve
  */
 declare function detectClientId(providedClientId?: string): string | undefined;
 
-declare class BrowserFlagStorage implements StorageInterface {
-    private ttl;
-    get(key: string): any;
-    set(key: string, value: unknown): void;
-    getAll(): Record<string, unknown>;
-    clear(): void;
-    private getFromLocalStorage;
-    private setToLocalStorage;
-    private isExpired;
-    delete(key: string): void;
-    deleteMultiple(keys: string[]): void;
-    setAll(flags: Record<string, unknown>): void;
-    cleanupExpired(): void;
-}
-
-declare class CoreFlagsManager implements FlagsManager {
-    private config;
-    private storage?;
-    private onFlagsUpdate?;
-    private onConfigUpdate?;
-    private memoryFlags;
-    private pendingFlags;
-    constructor(options: FlagsManagerOptions);
-    private withDefaults;
-    private initialize;
-    private loadCachedFlags;
-    fetchAllFlags(): Promise<void>;
-    getFlag(key: string): Promise<FlagResult>;
-    private fetchFlag;
-    isEnabled(key: string): FlagState;
-    refresh(forceClear?: boolean): void;
-    updateUser(user: FlagsConfig["user"]): void;
-    updateConfig(config: FlagsConfig): void;
-    getMemoryFlags(): Record<string, FlagResult>;
-    getPendingFlags(): Set<string>;
-    private notifyFlagsUpdate;
-}
-
 declare function isScriptInjected(): boolean;
 declare function createScript({ scriptUrl, sdkVersion, clientSecret, filter, debug, ...props }: DatabuddyConfig): HTMLScriptElement;
 
-/**
- * Checks if the Databuddy tracker script has loaded and is available.
- * Use this before calling tracking functions in conditional scenarios.
- *
- * @returns `true` if tracker is available, `false` if not loaded or on server
- *
- * @example
- * ```ts
- * import { isTrackerAvailable, track } from "@databuddy/sdk";
- *
- * if (isTrackerAvailable()) {
- *   track("feature_used", { feature: "export" });
- * }
- * ```
- */
-declare function isTrackerAvailable(): boolean;
-/**
- * Returns the raw Databuddy tracker instance for advanced use cases.
- * Prefer using the exported functions (`track`, `flush`, etc.) instead.
- *
- * @returns Tracker instance or `null` if not available
- *
- * @example
- * ```ts
- * import { getTracker, getAnonymousId, getSessionId } from "@databuddy/sdk";
- *
- * const tracker = getTracker();
- * if (tracker) {
- *   // Access tracker methods
- *   tracker.track("event", { prop: "value" });
- *
- *   // Get IDs using dedicated functions
- *   const anonId = getAnonymousId();
- *   const sessionId = getSessionId();
- * }
- * ```
- */
-declare function getTracker(): DatabuddyTracker | null;
-/**
- * Tracks a custom event with optional properties.
- * Events are batched and sent efficiently to minimize network overhead.
- * Safe to call on server (no-op) or before tracker loads.
- *
- * @param name - Event name (e.g., "button_click", "purchase", "signup")
- * @param properties - Key-value pairs of event data
- *
- * @example
- * ```ts
- * import { track } from "@databuddy/sdk";
- *
- * // Simple event
- * track("signup_started");
- *
- * // Event with properties
- * track("item_purchased", {
- *   itemId: "sku-123",
- *   price: 29.99,
- *   currency: "USD"
- * });
- *
- * // In a React component
- * function CheckoutButton() {
- *   return (
- *     <button onClick={() => track("checkout_clicked", { cartSize: 3 })}>
- *       Checkout
- *     </button>
- *   );
- * }
- * ```
- */
-declare function track(name: string, properties?: Record<string, unknown>): void;
-/** @deprecated Use `track()` instead. Will be removed in v3.0. */
-declare function trackCustomEvent(name: string, properties?: Record<string, unknown>): void;
-/**
- * Clears the current user session and generates new anonymous/session IDs.
- * Use after logout to ensure the next user gets a fresh identity.
- *
- * @example
- * ```ts
- * import { clear } from "@databuddy/sdk";
- *
- * async function handleLogout() {
- *   await signOut();
- *   clear(); // Reset tracking identity
- *   router.push("/login");
- * }
- * ```
- */
-declare function clear(): void;
-/**
- * Forces all queued events to be sent immediately.
- * Useful before navigation or when you need to ensure events are captured.
- *
- * @example
- * ```ts
- * import { track, flush } from "@databuddy/sdk";
- *
- * function handleExternalLink(url: string) {
- *   track("external_link_clicked", { url });
- *   flush(); // Ensure event is sent before leaving
- *   window.location.href = url;
- * }
- * ```
- */
-declare function flush(): void;
-/**
- * Tracks an error event. Convenience wrapper around `track("error", ...)`.
- *
- * @param message - Error message
- * @param properties - Additional error context (filename, line number, stack trace)
- *
- * @example
- * ```ts
- * import { trackError } from "@databuddy/sdk";
- *
- * try {
- *   await riskyOperation();
- * } catch (error) {
- *   trackError(error.message, {
- *     stack: error.stack,
- *     error_type: error.name,
- *     context: "checkout_flow"
- *   });
- * }
- * ```
- */
-declare function trackError(message: string, properties?: {
-    filename?: string;
-    lineno?: number;
-    colno?: number;
-    stack?: string;
-    error_type?: string;
-    [key: string]: string | number | boolean | null | undefined;
-}): void;
-/**
- * Gets the anonymous user ID. Persists across sessions via localStorage.
- * Useful for server-side identification or cross-domain tracking.
- *
- * @param urlParams - Optional URLSearchParams to check for `anonId` param (highest priority)
- * @returns Anonymous ID or `null` if unavailable
- *
- * Priority: URL params → tracker instance → localStorage
- *
- * @example
- * ```ts
- * import { getAnonymousId } from "@databuddy/sdk";
- *
- * // Get from tracker
- * const anonId = getAnonymousId();
- *
- * // Check URL params first (for cross-domain tracking)
- * const params = new URLSearchParams(window.location.search);
- * const anonId = getAnonymousId(params);
- *
- * // Pass to server
- * await fetch("/api/identify", {
- *   body: JSON.stringify({ anonId })
- * });
- * ```
- */
-declare function getAnonymousId(urlParams?: URLSearchParams): string | null;
-/**
- * Gets the current session ID. Resets after 30 min of inactivity.
- * Useful for correlating events within a single browsing session.
- *
- * @param urlParams - Optional URLSearchParams to check for `sessionId` param (highest priority)
- * @returns Session ID or `null` if unavailable
- *
- * Priority: URL params → tracker instance → sessionStorage
- *
- * @example
- * ```ts
- * import { getSessionId } from "@databuddy/sdk";
- *
- * const sessionId = getSessionId();
- * console.log("Current session:", sessionId);
- * ```
- */
-declare function getSessionId(urlParams?: URLSearchParams): string | null;
-/**
- * Gets both anonymous ID and session ID in a single call.
- *
- * @param urlParams - Optional URLSearchParams to check for tracking params
- * @returns Object with `anonId` and `sessionId` (either may be null)
- *
- * @example
- * ```ts
- * import { getTrackingIds } from "@databuddy/sdk";
- *
- * const { anonId, sessionId } = getTrackingIds();
- *
- * // Send to your backend
- * await api.identify({ anonId, sessionId, userId: user.id });
- * ```
- */
-declare function getTrackingIds(urlParams?: URLSearchParams): {
-    anonId: string | null;
-    sessionId: string | null;
-};
-/**
- * Returns tracking IDs as a URL query string for cross-domain tracking.
- * Append to URLs when linking to other domains you own.
- *
- * @param urlParams - Optional URLSearchParams to preserve existing params
- * @returns Query string like `"anonId=xxx&sessionId=yyy"` or empty string
- *
- * @example
- * ```ts
- * import { getTrackingParams } from "@databuddy/sdk";
- *
- * // Link to subdomain with tracking continuity
- * const params = getTrackingParams();
- * const url = `https://app.example.com/dashboard${params ? `?${params}` : ""}`;
- *
- * // In a component
- * <a href={`https://shop.example.com?${getTrackingParams()}`}>
- *   Visit Shop
- * </a>
- * ```
- */
-declare function getTrackingParams(urlParams?: URLSearchParams): string;
-
-export { BrowserFlagStorage, CoreFlagsManager, DatabuddyConfig, DatabuddyTracker, FlagResult, FlagState, FlagsConfig, FlagsManager, FlagsManagerOptions, StorageInterface, clear, createScript, detectClientId, flush, getAnonymousId, getSessionId, getTracker, getTrackingIds, getTrackingParams, isScriptInjected, isTrackerAvailable, track, trackCustomEvent, trackError };
+export { DatabuddyConfig, createScript, detectClientId, isScriptInjected };

package/dist/core/index.mjs

@@ -1,5 +1,28 @@
-export { d as detectClientId } from '../shared/@databuddy/sdk.BUsPV0LH.mjs';
-export { B as BrowserFlagStorage, C as CoreFlagsManager, c as createScript, i as isScriptInjected } from '../shared/@databuddy/sdk.ByNF_UxE.mjs';
+export { c as createScript, i as isScriptInjected } from '../shared/@databuddy/sdk.C8vEu9Y4.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 isTrackerAvailable() {
   return typeof window !== "undefined" && (!!window.databuddy || !!window.db);
@@ -89,4 +112,4 @@ function getTrackingParams(urlParams) {
   return params.toString();
 }
 
-export { clear, flush, getAnonymousId, getSessionId, getTracker, getTrackingIds, getTrackingParams, isTrackerAvailable, track, trackCustomEvent, trackError };
+export { clear, detectClientId, flush, getAnonymousId, getSessionId, getTracker, getTrackingIds, getTrackingParams, isTrackerAvailable, track, trackCustomEvent, trackError };