@launchdarkly/toolbar 2.5.4-beta.1 → 2.6.1-beta.1

package/dist/core/tests/mocks/providers.d.ts

@@ -0,0 +1,132 @@
+import { vi } from 'vitest';
+/**
+ * Shared mock factory functions for provider contexts.
+ *
+ * GLOBAL MOCKS:
+ * AnalyticsPreferencesProvider is mocked globally in vitest.setup.ts.
+ * Most test files don't need to do anything - the mock is automatic.
+ *
+ * TESTING REAL IMPLEMENTATIONS:
+ * If your test file tests the REAL implementation of a provider, add this at
+ * the top of your test file:
+ *
+ * @example
+ * vi.unmock('../ui/Toolbar/context/telemetry/AnalyticsPreferencesProvider');
+ *
+ * OVERRIDING WITH DYNAMIC VALUES:
+ * If your test needs to change mock values during execution, override the
+ * global mock with createDynamicAnalyticsPreferencesProviderMock:
+ *
+ * @example
+ * const { getMockValue, setMockValue } = vi.hoisted(() => {
+ *   let value = false;
+ *   return { getMockValue: () => value, setMockValue: (v) => { value = v; } };
+ * });
+ *
+ * vi.mock('../ui/Toolbar/context/telemetry/AnalyticsPreferencesProvider', async () => {
+ *   const { createDynamicAnalyticsPreferencesProviderMock } = await import('./mocks/providers');
+ *   return createDynamicAnalyticsPreferencesProviderMock({ getIsOptedInToAnalytics: getMockValue });
+ * });
+ */
+interface AnalyticsPreferencesMock {
+    useAnalyticsPreferences: () => {
+        isOptedInToAnalytics: boolean;
+        isOptedInToEnhancedAnalytics: boolean;
+        isOptedInToSessionReplay: boolean;
+        handleToggleAnalyticsOptOut: ReturnType<typeof vi.fn>;
+        handleToggleEnhancedAnalyticsOptOut: ReturnType<typeof vi.fn>;
+        handleToggleSessionReplayOptOut: ReturnType<typeof vi.fn>;
+    };
+    AnalyticsPreferencesProvider: ({ children }: {
+        children: React.ReactNode;
+    }) => React.ReactNode;
+}
+/**
+ * Creates a mock for AnalyticsPreferencesProvider.
+ * Used by vitest.setup.ts for global mocking.
+ */
+export declare function createAnalyticsPreferencesProviderMock(overrides?: {
+    isOptedInToAnalytics?: boolean;
+    isOptedInToEnhancedAnalytics?: boolean;
+    isOptedInToSessionReplay?: boolean;
+}): AnalyticsPreferencesMock;
+/**
+ * Creates a mock for AnalyticsPreferencesProvider with dynamic values.
+ * Use this when you need to change mock values during test execution.
+ *
+ * @example
+ * // For dynamic isOptedInToAnalytics:
+ * let mockIsOptedIn = false;
+ * vi.mock('../ui/Toolbar/context/telemetry/AnalyticsPreferencesProvider', async () => {
+ *   const { createDynamicAnalyticsPreferencesProviderMock } = await import('./mocks/providers');
+ *   return createDynamicAnalyticsPreferencesProviderMock({ getIsOptedInToAnalytics: () => mockIsOptedIn });
+ * });
+ *
+ * // For dynamic isOptedInToEnhancedAnalytics:
+ * vi.mock('../ui/Toolbar/context/telemetry/AnalyticsPreferencesProvider', async () => {
+ *   const { createDynamicAnalyticsPreferencesProviderMock } = await import('./mocks/providers');
+ *   return createDynamicAnalyticsPreferencesProviderMock({ getIsOptedInToEnhancedAnalytics: () => mockValue });
+ * });
+ *
+ * // In tests:
+ * mockIsOptedIn = true;  // Changes mock behavior
+ */
+export declare function createDynamicAnalyticsPreferencesProviderMock(options: {
+    getIsOptedInToAnalytics?: () => boolean;
+    getIsOptedInToEnhancedAnalytics?: () => boolean;
+    getIsOptedInToSessionReplay?: () => boolean;
+}): AnalyticsPreferencesMock;
+/**
+ * Creates a mock for InternalClientProvider with a customizable mock LDClient.
+ *
+ * @example
+ * const mockLDClient = { track: vi.fn(), ... };
+ * vi.mock('../../ui/Toolbar/context/telemetry/InternalClientProvider', () =>
+ *   createInternalClientProviderMock(mockLDClient)
+ * );
+ */
+export declare function createInternalClientProviderMock(mockClient?: Record<string, unknown>): {
+    useInternalClient: () => {
+        client: Record<string, unknown> | null;
+        loading: boolean;
+        error: null;
+        updateContext: ReturnType<typeof vi.fn>;
+    };
+    InternalClientProvider: ({ children }: {
+        children: React.ReactNode;
+    }) => React.ReactNode;
+};
+/**
+ * Creates a mock for DevServerProvider.
+ *
+ * @example
+ * vi.mock('../../ui/Toolbar/context/DevServerProvider', () =>
+ *   createDevServerProviderMock({ connectionStatus: 'connected' })
+ * );
+ */
+export declare function createDevServerProviderMock(overrides?: {
+    sourceEnvironmentKey?: string;
+    connectionStatus?: string;
+    flags?: Record<string, unknown>;
+    isLoading?: boolean;
+    error?: Error | null;
+}): {
+    useDevServerContext: () => {
+        state: {
+            sourceEnvironmentKey: string;
+            connectionStatus: string;
+            flags: Record<string, unknown>;
+            lastSyncTime: number;
+            isLoading: boolean;
+            error: Error | null;
+        };
+        setOverride: ReturnType<typeof vi.fn>;
+        clearOverride: ReturnType<typeof vi.fn>;
+        clearAllOverrides: ReturnType<typeof vi.fn>;
+        refresh: ReturnType<typeof vi.fn>;
+    };
+    DevServerProvider: ({ children }: {
+        children: React.ReactNode;
+    }) => React.ReactNode;
+};
+export {};

package/dist/core/ui/Toolbar/components/new/AnalyticsConsentToast/AnalyticsConsentToast.d.ts

@@ -0,0 +1,5 @@
+/**
+ * A toast component that appears at the bottom of the toolbar asking users
+ * to opt into analytics. Only shows the first time the toolbar is opened.
+ */
+export declare function AnalyticsConsentToast(): import("react/jsx-runtime").JSX.Element | null;

package/dist/core/ui/Toolbar/components/new/AnalyticsConsentToast/AnalyticsConsentToast.module.css.d.ts

@@ -0,0 +1,13 @@
+export declare const overlay: string;
+export declare const container: string;
+export declare const infoIcon: string;
+export declare const content: string;
+export declare const textContent: string;
+export declare const title: string;
+export declare const description: string;
+export declare const privacyLink: string;
+export declare const actions: string;
+export declare const button: string;
+export declare const primaryButton: string;
+export declare const closeButton: string;
+export declare const closeIcon: string;

package/dist/core/ui/Toolbar/components/new/AnalyticsConsentToast/index.d.ts

@@ -0,0 +1 @@
+export { AnalyticsConsentToast } from './AnalyticsConsentToast';

package/dist/core/ui/Toolbar/components/new/Settings/Privacy/PrivacySettings.d.ts

@@ -0,0 +1 @@
+export declare function PrivacySettings(): import("react/jsx-runtime").JSX.Element;

package/dist/core/ui/Toolbar/components/new/Settings/index.d.ts

@@ -1,5 +1,5 @@
-export * from './SettingsContent';
 export * from './GeneralSettings';
+export * from './Privacy/PrivacySettings';
 export * from './SettingsSection';
 export * from './SettingsItem';
 export * from './ProjectSelector';

package/dist/core/ui/Toolbar/components/new/types.d.ts

@@ -1,6 +1,6 @@
 export type FlagsSubtab = 'flags' | 'contexts';
 export type MonitoringSubtab = 'events';
-export type SettingsSubtab = 'general';
+export type SettingsSubtab = 'general' | 'privacy';
 export type InteractiveSubtab = 'workflows';
 export type SubTab = FlagsSubtab | MonitoringSubtab | SettingsSubtab | InteractiveSubtab;
 export interface TabConfig {

package/dist/core/ui/Toolbar/context/state/ToolbarStateProvider.d.ts

@@ -10,6 +10,9 @@ export interface ToolbarStateContextValue {
     reloadOnFlagChangeIsEnabled: boolean;
     isAutoCollapseEnabled: boolean;
     mode: ToolbarMode;
+    isOptedInToAnalytics: boolean;
+    isOptedInToEnhancedAnalytics: boolean;
+    isOptedInToSessionReplay: boolean;
     toolbarRef: React.RefObject<HTMLDivElement | null>;
     handleTabChange: (tabId: string) => void;
     handleClose: () => void;
@@ -19,6 +22,9 @@ export interface ToolbarStateContextValue {
     handleCircleClick: () => void;
     setIsAnimating: Dispatch<SetStateAction<boolean>>;
     setSearchIsExpanded: Dispatch<SetStateAction<boolean>>;
+    handleToggleAnalyticsOptOut: (enabled: boolean) => void;
+    handleToggleEnhancedAnalyticsOptOut: (enabled: boolean) => void;
+    handleToggleSessionReplayOptOut: (enabled: boolean) => void;
 }
 export interface ToolbarStateProviderProps {
     children: ReactNode;

package/dist/core/ui/Toolbar/context/telemetry/AnalyticsPreferencesProvider.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+export interface AnalyticsPreferencesContextValue {
+    isOptedInToAnalytics: boolean;
+    isOptedInToEnhancedAnalytics: boolean;
+    isOptedInToSessionReplay: boolean;
+    handleToggleAnalyticsOptOut: (enabled: boolean) => void;
+    handleToggleEnhancedAnalyticsOptOut: (enabled: boolean) => void;
+    handleToggleSessionReplayOptOut: (enabled: boolean) => void;
+}
+export interface AnalyticsPreferencesProviderProps {
+    children: ReactNode;
+}
+export declare function AnalyticsPreferencesProvider({ children }: AnalyticsPreferencesProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useAnalyticsPreferences(): AnalyticsPreferencesContextValue;

package/dist/core/ui/Toolbar/context/telemetry/index.d.ts

@@ -1,3 +1,4 @@
 export * from './TelemetryBundleProvider';
 export * from './AnalyticsProvider';
 export * from './InternalClientProvider';
+export * from './AnalyticsPreferencesProvider';

package/dist/core/ui/Toolbar/utils/localStorage.d.ts

@@ -1,12 +1,11 @@
 import type { LDContext } from 'launchdarkly-js-client-sdk';
 import { ToolbarPosition } from '../types/toolbar';
 export declare const TOOLBAR_STORAGE_KEYS: {
-    readonly ENVIRONMENT: "ld-toolbar-environment";
     readonly SETTINGS: "ld-toolbar-settings";
     readonly DISABLED: "ld-toolbar-disabled";
-    readonly PROJECT: "ld-toolbar-project";
     readonly STARRED_FLAGS: "ld-toolbar-starred-flags";
     readonly MCP_ALERT_DISMISSED: "ld-toolbar-mcp-alert-dismissed";
+    readonly ANALYTICS_CONSENT_SHOWN: "ld-toolbar-analytics-consent-shown";
     readonly CONTEXTS: "ld-toolbar-contexts";
     readonly ACTIVE_CONTEXT: "ld-toolbar-active-context";
 };
@@ -17,6 +16,9 @@ export interface ToolbarSettings {
     reloadOnFlagChange: boolean;
     autoCollapse: boolean;
     preferredIde: PreferredIde;
+    isOptedInToAnalytics: boolean;
+    isOptedInToEnhancedAnalytics: boolean;
+    isOptedInToSessionReplay: boolean;
 }
 export declare const DEFAULT_SETTINGS: ToolbarSettings;
 export declare function saveToolbarPosition(position: ToolbarPosition): void;
@@ -35,3 +37,11 @@ export declare function loadContexts(): Array<LDContext>;
 export declare function saveContexts(contexts: Array<LDContext>): void;
 export declare function loadActiveContext(): LDContext | null;
 export declare function saveActiveContext(context: LDContext | null): void;
+export declare function saveIsOptedInToAnalytics(isOptedInToAnalytics: boolean): void;
+export declare function loadIsOptedInToAnalytics(): boolean;
+export declare function saveIsOptedInToEnhancedAnalytics(isOptedInToEnhancedAnalytics: boolean): void;
+export declare function saveIsOptedInToSessionReplay(isOptedInToSessionReplay: boolean): void;
+export declare function loadIsOptedInToSessionReplay(): boolean;
+export declare function loadIsOptedInToEnhancedAnalytics(): boolean;
+export declare function saveAnalyticsConsentShown(shown: boolean): void;
+export declare function loadAnalyticsConsentShown(): boolean;

package/dist/core/utils/analytics.d.ts

@@ -8,8 +8,9 @@ export declare const ANALYTICS_EVENT_PREFIX = "ld.toolbar";
 export declare class ToolbarAnalytics {
     private ldClient;
     private mode;
+    private isOptedInToAnalytics;
     private searchDebounceTimer;
-    constructor(ldClient?: LDClient | null, mode?: ToolbarMode);
+    constructor(ldClient?: LDClient | null, mode?: ToolbarMode, isOptedInToAnalytics?: boolean);
     /**
      * Internal method to send tracking events
      */

package/dist/index.cjs

@@ -552,7 +552,7 @@ async function lazyLoad(signal, url) {
         throw new Error(`Could not load LaunchDarkly developer toolbar bundle from ${url}`);
     }
 }
-var package_namespaceObject = JSON.parse('{"rE":"2.5.4-beta.1"}');
+var package_namespaceObject = JSON.parse('{"rE":"2.6.1-beta.1"}');
 function useLaunchDarklyToolbar(args) {
     const { toolbarBundleUrl, enabled, ...initConfig } = args;
     const configRef = (0, external_react_namespaceObject.useRef)(null);

package/dist/js/index.js

@@ -518,7 +518,7 @@ async function lazyLoad(signal, url) {
         throw new Error(`Could not load LaunchDarkly developer toolbar bundle from ${url}`);
     }
 }
-var package_namespaceObject = JSON.parse('{"rE":"2.5.4-beta.1"}');
+var package_namespaceObject = JSON.parse('{"rE":"2.6.1-beta.1"}');
 function useLaunchDarklyToolbar(args) {
     const { toolbarBundleUrl, enabled, ...initConfig } = args;
     const configRef = useRef(null);

package/dist/js/react.js

@@ -49,7 +49,7 @@ async function lazyLoad(signal, url) {
         throw new Error(`Could not load LaunchDarkly developer toolbar bundle from ${url}`);
     }
 }
-var package_namespaceObject = JSON.parse('{"rE":"2.5.4-beta.1"}');
+var package_namespaceObject = JSON.parse('{"rE":"2.6.1-beta.1"}');
 function useLaunchDarklyToolbar(args) {
     const { toolbarBundleUrl, enabled, ...initConfig } = args;
     const configRef = useRef(null);

package/dist/react.cjs

@@ -78,7 +78,7 @@ async function lazyLoad(signal, url) {
         throw new Error(`Could not load LaunchDarkly developer toolbar bundle from ${url}`);
     }
 }
-var package_namespaceObject = JSON.parse('{"rE":"2.5.4-beta.1"}');
+var package_namespaceObject = JSON.parse('{"rE":"2.6.1-beta.1"}');
 function useLaunchDarklyToolbar(args) {
     const { toolbarBundleUrl, enabled, ...initConfig } = args;
     const configRef = (0, external_react_namespaceObject.useRef)(null);

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@launchdarkly/toolbar",
-  "version": "2.5.4-beta.1",
+  "version": "2.6.1-beta.1",
   "description": "A framework-agnostic developer toolbar for interacting with LaunchDarkly during development",
   "keywords": [
     "launchdarkly",
@@ -91,7 +91,7 @@
     }
   },
   "devDependencies": {
-    "@codemirror/commands": "^6.10.0",
+    "@codemirror/commands": "^6.10.1",
     "@codemirror/lang-json": "^6.0.2",
     "@codemirror/language": "^6.11.3",
     "@codemirror/lint": "^6.9.2",
@@ -114,7 +114,7 @@
     "@storybook/addon-onboarding": "^10.1.7",
     "@storybook/blocks": "^9.0.0-alpha.17",
     "@storybook/react": "^10.0.8",
-    "@storybook/react-vite": "^10.1.8",
+    "@storybook/react-vite": "^10.1.10",
     "@storybook/test": "^9.0.0-alpha.2",
     "@tanstack/react-virtual": "^3.13.13",
     "@testing-library/jest-dom": "^6.9.1",
@@ -134,7 +134,7 @@
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "storybook": "^10.1.4",
-    "storybook-addon-rslib": "^3.1.0",
+    "storybook-addon-rslib": "^3.2.0",
     "storybook-react-rsbuild": "^3.1.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.15"

package/dist/core/ui/Toolbar/components/new/Settings/SettingsContent.d.ts

@@ -1 +0,0 @@
-export declare function SettingsContent(): import("react/jsx-runtime").JSX.Element;