@launchdarkly/toolbar 2.5.3-beta.1 → 2.6.0-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/Contexts/ContextItem.d.ts

@@ -1,6 +1,6 @@
-import { Context } from '../../../types/ldApi';
+import type { LDContext } from 'launchdarkly-js-client-sdk';
 interface ContextItemProps {
-    context: Context;
+    context: LDContext;
     isActiveContext: boolean;
     handleHeightChange?: (index: number, height: number) => void;
     index?: number;

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/api/ContextsProvider.d.ts

@@ -1,13 +1,13 @@
-import { Context } from '../../types/ldApi';
+import type { LDContext } from 'launchdarkly-js-client-sdk';
 interface ContextsContextType {
-    contexts: Context[];
+    contexts: LDContext[];
     filter: string;
     setFilter: (filter: string) => void;
-    addContext: (context: Context) => void;
-    removeContext: (id: string) => void;
-    updateContext: (id: string, newContext: Context) => void;
-    setContext: (context: Context) => Promise<void>;
-    activeContext: Context | null;
+    addContext: (context: LDContext) => void;
+    removeContext: (contextId: string) => void;
+    updateContext: (contextId: string, newContext: LDContext) => void;
+    setContext: (context: LDContext) => Promise<void>;
+    activeContext: LDContext | null;
     isAddFormOpen: boolean;
     setIsAddFormOpen: (isOpen: boolean) => void;
 }

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/types/ldApi.d.ts

@@ -38,10 +38,3 @@ export interface FlagsPaginationParams {
     offset?: number;
     query?: string;
 }
-export interface Context {
-    id: string;
-    kind: string;
-    key?: string;
-    name: string;
-    anonymous?: boolean;
-}

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

@@ -1,15 +1,34 @@
 import type { LDContext } from 'launchdarkly-js-client-sdk';
-import { Context } from '../types/ldApi';
 /**
- * Generates a unique ID for a context
+ * Generates a deterministic ID for a context based on its properties.
+ * The same context object will always produce the same ID.
+ * This is used to compare contexts for equality.
+ *
+ * For multi-kind contexts, the deprecated 'user' kind is excluded from
+ * hash generation to prevent false duplicate detection.
+ *
+ * Results are cached to minimize computation during React renders.
  */
-export declare function generateContextId(): string;
+export declare function generateContextId(context?: LDContext | null): string;
 /**
- * Extracts normalized context info from an LDContext
- * Handles both single-kind and multi-kind contexts
+ * Check if two contexts are the same using their generated IDs
  */
-export declare function extractContextInfo(ldContext: LDContext | undefined): Context | null;
+export declare function areContextsEqual(a: LDContext | null | undefined, b: LDContext | null | undefined): boolean;
 /**
- * Helper function to check if a given context matches the current SDK context
+ * Gets the kind of an LDContext (handles multi-kind and single-kind)
  */
-export declare function isCurrentContext(currentContext: Context | null, contextKind: string, contextKey: string): boolean;
+export declare function getContextKind(context: LDContext | null | undefined): string;
+/**
+ * Gets the key of an LDContext
+ * For multi-kind contexts, returns the key of the first nested context
+ */
+export declare function getContextKey(context: LDContext | null | undefined): string;
+/**
+ * Gets a display name for an LDContext
+ * Uses name if available, otherwise falls back to key
+ */
+export declare function getContextDisplayName(context: LDContext | null | undefined): string;
+/**
+ * Check if a context is anonymous
+ */
+export declare function isContextAnonymous(context: LDContext | null | undefined): boolean;

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

@@ -1,12 +1,11 @@
-import { Context } from '../types/ldApi';
+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;
@@ -31,7 +33,15 @@ export declare function savePreferredIde(ide: PreferredIde): void;
 export declare function loadPreferredIde(): PreferredIde;
 export declare function saveMCPAlertDismissed(dismissed: boolean): void;
 export declare function loadMCPAlertDismissed(): boolean;
-export declare function loadContexts(): Array<Context>;
-export declare function saveContexts(contexts: Array<Context>): void;
-export declare function loadActiveContext(): Context | null;
-export declare function saveActiveContext(context: Context | null): void;
+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
      */
@@ -30,6 +31,10 @@ export declare class ToolbarAnalytics {
      * Track toolbar tab navigation
      */
     trackTabChange(fromTab: string | null, toTab: string): void;
+    /**
+     * Track toolbar subtab navigation
+     */
+    trackSubtabChange(fromSubtab: string | null, toSubtab: string): void;
     /**
      * Track search usage
      */

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.3-beta.1"}');
+var package_namespaceObject = JSON.parse('{"rE":"2.6.0-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.3-beta.1"}');
+var package_namespaceObject = JSON.parse('{"rE":"2.6.0-beta.1"}');
 function useLaunchDarklyToolbar(args) {
     const { toolbarBundleUrl, enabled, ...initConfig } = args;
     const configRef = useRef(null);