@databuddy/sdk 2.3.29 → 2.4.0

package/dist/react/index.d.mts

@@ -1,7 +1,7 @@
-import { D as DatabuddyConfig } from '../shared/@databuddy/sdk.BsF1xr6_.mjs';
-export { 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, b as trackError } from '../shared/@databuddy/sdk.BsF1xr6_.mjs';
+import { D as DatabuddyConfig } from '../shared/@databuddy/sdk.DOtKE9NQ.mjs';
+export { f as clear, g as flush, h as getAnonymousId, i as getSessionId, j as getTracker, k as getTrackingIds, l as getTrackingParams, m as isTrackerAvailable, t as track, o as trackError } from '../shared/@databuddy/sdk.DOtKE9NQ.mjs';
 import React, { ReactNode } from 'react';
-import { F as FlagsConfig, a as FeatureState, b as FlagState, c as FlagsContext } from '../shared/@databuddy/sdk.CdLp6SQb.mjs';
+import { F as FlagsConfig, a as FlagState, b as FlagsContext } from '../shared/@databuddy/sdk.rnu91OSC.mjs';
 
 /**
  * React/Next.js component that injects the Databuddy tracking script.
@@ -38,7 +38,6 @@ import { F as FlagsConfig, a as FeatureState, b as FlagState, c as FlagsContext
  * <Databuddy
  *   clientId="your-client-id"
  *   trackWebVitals
- *   trackScrollDepth
  *   trackOutgoingLinks
  * />
  * ```
@@ -59,56 +58,14 @@ declare function Databuddy(props: DatabuddyConfig): null;
 interface FlagsProviderProps extends FlagsConfig {
     children: ReactNode;
 }
-/**
- * Flags provider component
- * Creates a manager instance and provides flag methods to children
- */
 declare function FlagsProvider({ children, ...config }: FlagsProviderProps): React.JSX.Element;
-/**
- * Access the full flags context
- * @example
- * const { isOn, getFlag, refresh } = useFlags();
- */
 declare function useFlags(): FlagsContext;
 /**
- * Get a flag's full state with loading/error handling
  * @example
  * const flag = useFlag("my-feature");
  * if (flag.loading) return <Skeleton />;
  * return flag.on ? <NewFeature /> : <OldFeature />;
  */
 declare function useFlag(key: string): FlagState;
-/**
- * Simple feature check - returns { on, loading, value, variant }
- * @example
- * const { on, loading } = useFeature("dark-mode");
- * if (loading) return <Skeleton />;
- * return on ? <DarkTheme /> : <LightTheme />;
- */
-declare function useFeature(key: string): FeatureState;
-/**
- * Boolean-only feature check with default value
- * Useful for SSR-safe rendering where you need a boolean immediately
- * @example
- * const isDarkMode = useFeatureOn("dark-mode", false);
- * return isDarkMode ? <DarkTheme /> : <LightTheme />;
- */
-declare function useFeatureOn(key: string, defaultValue?: boolean): boolean;
-/**
- * Get a flag's typed value
- * @example
- * const maxItems = useFlagValue("max-items", 10);
- * const theme = useFlagValue<"light" | "dark">("theme", "light");
- */
-declare function useFlagValue<T extends boolean | string | number = boolean>(key: string, defaultValue?: T): T;
-/**
- * Get variant for A/B testing
- * @example
- * const variant = useVariant("checkout-experiment");
- * if (variant === "control") return <OldCheckout />;
- * if (variant === "treatment-a") return <NewCheckoutA />;
- * return <NewCheckoutB />;
- */
-declare function useVariant(key: string): string | undefined;
 
-export { Databuddy, FlagsProvider, useFeature, useFeatureOn, useFlag, useFlagValue, useFlags, useVariant };
+export { Databuddy, FlagsProvider, useFlag, useFlags };

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
-import { D as DatabuddyConfig } from '../shared/@databuddy/sdk.BsF1xr6_.js';
-export { 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, b as trackError } from '../shared/@databuddy/sdk.BsF1xr6_.js';
+import { D as DatabuddyConfig } from '../shared/@databuddy/sdk.DOtKE9NQ.js';
+export { f as clear, g as flush, h as getAnonymousId, i as getSessionId, j as getTracker, k as getTrackingIds, l as getTrackingParams, m as isTrackerAvailable, t as track, o as trackError } from '../shared/@databuddy/sdk.DOtKE9NQ.js';
 import React, { ReactNode } from 'react';
-import { F as FlagsConfig, a as FeatureState, b as FlagState, c as FlagsContext } from '../shared/@databuddy/sdk.CdLp6SQb.js';
+import { F as FlagsConfig, a as FlagState, b as FlagsContext } from '../shared/@databuddy/sdk.rnu91OSC.js';
 
 /**
  * React/Next.js component that injects the Databuddy tracking script.
@@ -38,7 +38,6 @@ import { F as FlagsConfig, a as FeatureState, b as FlagState, c as FlagsContext
  * <Databuddy
  *   clientId="your-client-id"
  *   trackWebVitals
- *   trackScrollDepth
  *   trackOutgoingLinks
  * />
  * ```
@@ -59,56 +58,14 @@ declare function Databuddy(props: DatabuddyConfig): null;
 interface FlagsProviderProps extends FlagsConfig {
     children: ReactNode;
 }
-/**
- * Flags provider component
- * Creates a manager instance and provides flag methods to children
- */
 declare function FlagsProvider({ children, ...config }: FlagsProviderProps): React.JSX.Element;
-/**
- * Access the full flags context
- * @example
- * const { isOn, getFlag, refresh } = useFlags();
- */
 declare function useFlags(): FlagsContext;
 /**
- * Get a flag's full state with loading/error handling
  * @example
  * const flag = useFlag("my-feature");
  * if (flag.loading) return <Skeleton />;
  * return flag.on ? <NewFeature /> : <OldFeature />;
  */
 declare function useFlag(key: string): FlagState;
-/**
- * Simple feature check - returns { on, loading, value, variant }
- * @example
- * const { on, loading } = useFeature("dark-mode");
- * if (loading) return <Skeleton />;
- * return on ? <DarkTheme /> : <LightTheme />;
- */
-declare function useFeature(key: string): FeatureState;
-/**
- * Boolean-only feature check with default value
- * Useful for SSR-safe rendering where you need a boolean immediately
- * @example
- * const isDarkMode = useFeatureOn("dark-mode", false);
- * return isDarkMode ? <DarkTheme /> : <LightTheme />;
- */
-declare function useFeatureOn(key: string, defaultValue?: boolean): boolean;
-/**
- * Get a flag's typed value
- * @example
- * const maxItems = useFlagValue("max-items", 10);
- * const theme = useFlagValue<"light" | "dark">("theme", "light");
- */
-declare function useFlagValue<T extends boolean | string | number = boolean>(key: string, defaultValue?: T): T;
-/**
- * Get variant for A/B testing
- * @example
- * const variant = useVariant("checkout-experiment");
- * if (variant === "control") return <OldCheckout />;
- * if (variant === "treatment-a") return <NewCheckoutA />;
- * return <NewCheckoutB />;
- */
-declare function useVariant(key: string): string | undefined;
 
-export { Databuddy, FlagsProvider, useFeature, useFeatureOn, useFlag, useFlagValue, useFlags, useVariant };
+export { Databuddy, FlagsProvider, useFlag, useFlags };

package/dist/react/index.mjs

@@ -2,10 +2,10 @@
 
 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.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';
+import { i as isScriptInjected, c as createScript } from '../shared/@databuddy/sdk.P9GHqNXr.mjs';
+import React, { useMemo, useRef, useEffect, useSyncExternalStore, useContext, createContext } from 'react';
+import { B as BrowserFlagStorage } from '../shared/@databuddy/sdk.GM10R1Kp.mjs';
+import { B as BrowserFlagsManager, l as logger } from '../shared/@databuddy/sdk.Ugr1p2j9.mjs';
 
 function Databuddy(props) {
   const clientId = detectClientId(props.clientId);
@@ -25,66 +25,32 @@ function Databuddy(props) {
 }
 
 const FlagsReactContext = createContext(null);
-function createFlagState(result, isLoading, isPending) {
+function toFlagState(result, isLoading, isPending) {
   if (isPending) {
-    return {
-      on: false,
-      enabled: false,
-      status: "pending",
-      loading: true,
-      isLoading: true,
-      isReady: false
-    };
+    return { on: false, status: "pending", loading: true };
   }
   if (isLoading || !result) {
-    return {
-      on: false,
-      enabled: false,
-      status: "loading",
-      loading: true,
-      isLoading: true,
-      isReady: false
-    };
+    return { on: false, status: "loading", loading: true };
   }
   const status = result.reason === "ERROR" ? "error" : "ready";
   return {
     on: result.enabled,
-    enabled: result.enabled,
     status,
     loading: false,
-    isLoading: false,
-    isReady: true,
     value: result.value,
     variant: result.variant
   };
 }
 function FlagsProvider({ children, ...config }) {
-  const storeRef = useRef({ flags: {}, isReady: false });
-  const listenersRef = useRef(/* @__PURE__ */ new Set());
   const manager = useMemo(() => {
     const storage = config.skipStorage ? void 0 : new BrowserFlagStorage();
-    return new CoreFlagsManager({
-      config,
-      storage,
-      onFlagsUpdate: (flags) => {
-        storeRef.current = { ...storeRef.current, flags };
-        for (const listener of listenersRef.current) {
-          listener();
-        }
-      },
-      onReady: () => {
-        storeRef.current = { ...storeRef.current, isReady: true };
-        for (const listener of listenersRef.current) {
-          listener();
-        }
-      }
-    });
+    return new BrowserFlagsManager({ config, storage });
   }, [config.clientId]);
   const prevConfigRef = useRef(config);
   useEffect(() => {
-    const prevConfig = prevConfigRef.current;
-    const configChanged = prevConfig.apiUrl !== config.apiUrl || prevConfig.isPending !== config.isPending || prevConfig.user?.userId !== config.user?.userId || prevConfig.user?.email !== config.user?.email || prevConfig.environment !== config.environment || prevConfig.disabled !== config.disabled || prevConfig.autoFetch !== config.autoFetch || prevConfig.cacheTtl !== config.cacheTtl || prevConfig.staleTime !== config.staleTime;
-    if (configChanged) {
+    const prev = prevConfigRef.current;
+    const changed = prev.apiUrl !== config.apiUrl || prev.isPending !== config.isPending || prev.user?.userId !== config.user?.userId || prev.user?.email !== config.user?.email || prev.environment !== config.environment || prev.disabled !== config.disabled || prev.autoFetch !== config.autoFetch || prev.cacheTtl !== config.cacheTtl || prev.staleTime !== config.staleTime;
+    if (changed) {
       prevConfigRef.current = config;
       manager.updateConfig(config);
     }
@@ -94,39 +60,29 @@ function FlagsProvider({ children, ...config }) {
       manager.destroy();
     };
   }, [manager]);
-  const subscribe = useMemo(
-    () => (callback) => {
-      listenersRef.current.add(callback);
-      return () => {
-        listenersRef.current.delete(callback);
-      };
-    },
-    []
+  const store = useSyncExternalStore(
+    manager.subscribe,
+    manager.getSnapshot,
+    manager.getSnapshot
   );
-  const getSnapshot = useMemo(() => () => storeRef.current, []);
-  const store = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
   const contextValue = useMemo(
     () => ({
-      // Cleaner API: getFlag returns FlagState
       getFlag: (key) => {
         const result = store.flags[key];
         const managerState = manager.isEnabled(key);
-        return createFlagState(
+        return toFlagState(
           result,
-          managerState.isLoading,
+          managerState.loading,
           config.isPending ?? false
         );
       },
-      // Simple boolean check
       isOn: (key) => {
         const result = store.flags[key];
         if (result) {
           return result.enabled;
         }
-        const state = manager.isEnabled(key);
-        return state.enabled;
+        return manager.isEnabled(key).on;
       },
-      // Get typed value
       getValue: (key, defaultValue) => {
         const result = store.flags[key];
         if (result) {
@@ -134,22 +90,11 @@ function FlagsProvider({ children, ...config }) {
         }
         return manager.getValue(key, defaultValue);
       },
-      // Async fetch
       fetchFlag: (key) => manager.getFlag(key),
       fetchAllFlags: () => manager.fetchAllFlags(),
       updateUser: (user) => manager.updateUser(user),
       refresh: (forceClear = false) => manager.refresh(forceClear),
-      isReady: store.isReady,
-      // Deprecated: kept for backwards compatibility
-      isEnabled: (key) => {
-        const result = store.flags[key];
-        const managerState = manager.isEnabled(key);
-        return createFlagState(
-          result,
-          managerState.isLoading,
-          config.isPending ?? false
-        );
-      }
+      isReady: store.isReady
     }),
     [manager, store, config.isPending]
   );
@@ -160,8 +105,7 @@ function useFlags() {
   if (!context) {
     logger.warn("useFlags called outside FlagsProvider");
     return {
-      isEnabled: () => createFlagState(void 0, false, false),
-      getFlag: () => createFlagState(void 0, false, false),
+      getFlag: () => toFlagState(void 0, false, false),
       isOn: () => false,
       getValue: (_key, defaultValue) => defaultValue ?? false,
       fetchFlag: async () => ({
@@ -185,31 +129,5 @@ function useFlag(key) {
   const { getFlag } = useFlags();
   return getFlag(key);
 }
-function useFeature(key) {
-  const flag = useFlag(key);
-  return {
-    on: flag.on,
-    loading: flag.loading,
-    status: flag.status,
-    value: flag.value,
-    variant: flag.variant
-  };
-}
-function useFeatureOn(key, defaultValue = false) {
-  const { isOn, isReady } = useFlags();
-  const flag = useFlag(key);
-  if (flag.loading || !isReady) {
-    return defaultValue;
-  }
-  return isOn(key);
-}
-function useFlagValue(key, defaultValue) {
-  const { getValue } = useFlags();
-  return getValue(key, defaultValue);
-}
-function useVariant(key) {
-  const flag = useFlag(key);
-  return flag.variant;
-}
 
-export { Databuddy, FlagsProvider, useFeature, useFeatureOn, useFlag, useFlagValue, useFlags, useVariant };
+export { Databuddy, FlagsProvider, useFlag, useFlags };

package/dist/shared/@databuddy/{sdk.BsF1xr6_.d.ts → sdk.DOtKE9NQ.d.mts}

@@ -8,7 +8,6 @@
  *   apiUrl="https://basket.databuddy.cc"
  *   trackWebVitals
  *   trackErrors
- *   trackScrollDepth
  *   samplingRate={0.5}
  * />
  * ```
@@ -18,7 +17,7 @@ interface DatabuddyConfig {
      * 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'
+     * Example: UUID-style or short public id (dashboard client ID).
      */
     clientId?: string;
     /**
@@ -71,10 +70,6 @@ interface DatabuddyConfig {
      * Track user interactions (default: false).
      */
     trackInteractions?: boolean;
-    /**
-     * Track scroll depth (default: false).
-     */
-    trackScrollDepth?: boolean;
     /**
      * Track page performance metrics (default: true).
      */
@@ -93,7 +88,7 @@ interface DatabuddyConfig {
      */
     samplingRate?: number;
     /**
-     * Enable retries for failed requests (default: false).
+     * Enable retries for failed requests (default: true).
      */
     enableRetries?: boolean;
     /**
@@ -193,19 +188,18 @@ interface EventProperties extends BaseEventProperties {
  */
 interface EventTypeMap {
     screen_view: {
+        page_count?: number;
         time_on_page?: number;
         scroll_depth?: number;
         interaction_count?: number;
-        has_exit_intent?: boolean;
-        is_bounce?: 0 | 1;
     };
     page_exit: {
+        path?: string;
+        timestamp?: number;
         time_on_page: number;
         scroll_depth: number;
         interaction_count: number;
-        has_exit_intent: boolean;
         page_count: number;
-        is_bounce: 0 | 1;
     };
     button_click: {
         button_text?: string;
@@ -583,5 +577,5 @@ declare function getTrackingIds(urlParams?: URLSearchParams): {
  */
 declare function getTrackingParams(urlParams?: URLSearchParams): string;
 
-export { trackCustomEvent as a, trackError as b, clear as c, getAnonymousId as d, getSessionId as e, flush as f, getTracker as g, getTrackingIds as h, isTrackerAvailable as i, getTrackingParams as j, track as t };
-export type { BaseEventProperties as B, DatabuddyConfig as D, EventProperties as E, PropertiesForEvent as P, ScreenViewFunction as S, TrackFunction as T, EventTypeMap as k, EventName as l, DatabuddyTracker as m, DataAttributes as n, SetGlobalPropertiesFunction as o };
+export { clear as f, flush as g, getAnonymousId as h, getSessionId as i, getTracker as j, getTrackingIds as k, getTrackingParams as l, isTrackerAvailable as m, trackCustomEvent as n, trackError as o, track as t };
+export type { BaseEventProperties as B, DatabuddyConfig as D, EventName as E, PropertiesForEvent as P, ScreenViewFunction as S, TrackFunction as T, DataAttributes as a, DatabuddyTracker as b, EventProperties as c, EventTypeMap as d, SetGlobalPropertiesFunction as e };

package/dist/shared/@databuddy/{sdk.BsF1xr6_.d.mts → sdk.DOtKE9NQ.d.ts}

@@ -8,7 +8,6 @@
  *   apiUrl="https://basket.databuddy.cc"
  *   trackWebVitals
  *   trackErrors
- *   trackScrollDepth
  *   samplingRate={0.5}
  * />
  * ```
@@ -18,7 +17,7 @@ interface DatabuddyConfig {
      * 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'
+     * Example: UUID-style or short public id (dashboard client ID).
      */
     clientId?: string;
     /**
@@ -71,10 +70,6 @@ interface DatabuddyConfig {
      * Track user interactions (default: false).
      */
     trackInteractions?: boolean;
-    /**
-     * Track scroll depth (default: false).
-     */
-    trackScrollDepth?: boolean;
     /**
      * Track page performance metrics (default: true).
      */
@@ -93,7 +88,7 @@ interface DatabuddyConfig {
      */
     samplingRate?: number;
     /**
-     * Enable retries for failed requests (default: false).
+     * Enable retries for failed requests (default: true).
      */
     enableRetries?: boolean;
     /**
@@ -193,19 +188,18 @@ interface EventProperties extends BaseEventProperties {
  */
 interface EventTypeMap {
     screen_view: {
+        page_count?: number;
         time_on_page?: number;
         scroll_depth?: number;
         interaction_count?: number;
-        has_exit_intent?: boolean;
-        is_bounce?: 0 | 1;
     };
     page_exit: {
+        path?: string;
+        timestamp?: number;
         time_on_page: number;
         scroll_depth: number;
         interaction_count: number;
-        has_exit_intent: boolean;
         page_count: number;
-        is_bounce: 0 | 1;
     };
     button_click: {
         button_text?: string;
@@ -583,5 +577,5 @@ declare function getTrackingIds(urlParams?: URLSearchParams): {
  */
 declare function getTrackingParams(urlParams?: URLSearchParams): string;
 
-export { trackCustomEvent as a, trackError as b, clear as c, getAnonymousId as d, getSessionId as e, flush as f, getTracker as g, getTrackingIds as h, isTrackerAvailable as i, getTrackingParams as j, track as t };
-export type { BaseEventProperties as B, DatabuddyConfig as D, EventProperties as E, PropertiesForEvent as P, ScreenViewFunction as S, TrackFunction as T, EventTypeMap as k, EventName as l, DatabuddyTracker as m, DataAttributes as n, SetGlobalPropertiesFunction as o };
+export { clear as f, flush as g, getAnonymousId as h, getSessionId as i, getTracker as j, getTrackingIds as k, getTrackingParams as l, isTrackerAvailable as m, trackCustomEvent as n, trackError as o, track as t };
+export type { BaseEventProperties as B, DatabuddyConfig as D, EventName as E, PropertiesForEvent as P, ScreenViewFunction as S, TrackFunction as T, DataAttributes as a, DatabuddyTracker as b, EventProperties as c, EventTypeMap as d, SetGlobalPropertiesFunction as e };

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

@@ -0,0 +1,46 @@
+const isBrowser = typeof window !== "undefined" && typeof localStorage !== "undefined";
+const STORAGE_KEY = "db-flags";
+const DEFAULT_TTL = 24 * 60 * 60 * 1e3;
+class BrowserFlagStorage {
+  ttl;
+  constructor(ttl = DEFAULT_TTL) {
+    this.ttl = ttl;
+  }
+  getAll() {
+    if (!isBrowser) {
+      return {};
+    }
+    try {
+      const raw = localStorage.getItem(STORAGE_KEY);
+      if (!raw) {
+        return {};
+      }
+      const blob = JSON.parse(raw);
+      if (Date.now() - blob.savedAt > this.ttl) {
+        localStorage.removeItem(STORAGE_KEY);
+        return {};
+      }
+      return blob.flags;
+    } catch {
+      return {};
+    }
+  }
+  setAll(flags) {
+    if (!isBrowser) {
+      return;
+    }
+    try {
+      const blob = { flags, savedAt: Date.now() };
+      localStorage.setItem(STORAGE_KEY, JSON.stringify(blob));
+    } catch {
+    }
+  }
+  clear() {
+    if (!isBrowser) {
+      return;
+    }
+    localStorage.removeItem(STORAGE_KEY);
+  }
+}
+
+export { BrowserFlagStorage as B };

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

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