@launchdarkly/toolbar 0.11.1-beta.1 → 0.13.0-beta.1

package/README.md

@@ -60,7 +60,10 @@ function App() {
       <div>
         <h1>My App</h1>
         {/* Pass the same plugin instance to the toolbar */}
-        <LaunchDarklyToolbar flagOverridePlugin={flagOverridePlugin} />
+        <LaunchDarklyToolbar
+          flagOverridePlugin={flagOverridePlugin}
+          eventInterceptionPlugin={eventInterceptionPlugin}
+        />
       </div>
     </LDProvider>
   );
@@ -84,13 +87,14 @@ function App() {
 
 ## Props
 
-| Prop                 | Type                  | Default     | Description                                                               |
-| -------------------- | --------------------- | ----------- | ------------------------------------------------------------------------- |
-| `flagOverridePlugin` | `IFlagOverridePlugin` | `undefined` | Flag override plugin for SDK Mode. Enables flag overrides and testing     |
-| `devServerUrl`       | `string` (optional)   | `undefined` | URL of your LaunchDarkly dev server. If provided, enables Dev Server Mode |
-| `position`           | `"left" \| "right"`   | `"right"`   | Position of the toolbar on screen                                         |
-| `projectKey`         | `string` (optional)   | `undefined` | Optional project key for multi-project setups (Dev Server Mode only)      |
-| `pollIntervalInMs`   | `number` (optional)   | `5000`      | Polling interval for dev server updates (Dev Server Mode only)            |
+| Prop                      | Type                       | Default     | Description                                                               |
+| ------------------------- | -------------------------- | ----------- | ------------------------------------------------------------------------- |
+| `flagOverridePlugin`      | `IFlagOverridePlugin`      | `undefined` | Flag override plugin for SDK Mode. Enables flag overrides and testing     |
+| `eventInterceptionPlugin` | `IEventInterceptionPlugin` | `undefined` | Event interception plugin for SDK Mode. Enables Events tab functionality  |
+| `devServerUrl`            | `string` (optional)        | `undefined` | URL of your LaunchDarkly dev server. If provided, enables Dev Server Mode |
+| `position`                | `"left" \| "right"`        | `"right"`   | Position of the toolbar on screen                                         |
+| `projectKey`              | `string` (optional)        | `undefined` | Optional project key for multi-project setups (Dev Server Mode only)      |
+| `pollIntervalInMs`        | `number` (optional)        | `5000`      | Polling interval for dev server updates (Dev Server Mode only)            |
 
 ## Configuration
 
@@ -103,10 +107,10 @@ The toolbar automatically determines its mode:
 
 ### Available Features by Mode
 
-| Mode                | Available Tabs      |
-| ------------------- | ------------------- |
-| **SDK Mode**        | Overrides, Settings |
-| **Dev Server Mode** | Flags, Settings     |
+| Mode                | Available Tabs                                                                                         |
+| ------------------- | ------------------------------------------------------------------------------------------------------ |
+| **SDK Mode**        | Overrides (if `flagOverridePlugin` provided), Events (if `eventInterceptionPlugin` provided), Settings |
+| **Dev Server Mode** | Flags, Settings                                                                                        |
 
 ## Setup
 
@@ -202,7 +206,7 @@ Visibility preferences are automatically saved to localStorage.
 The package includes complete TypeScript definitions. No additional `@types` packages needed.
 
 ```tsx
-import type { LaunchDarklyToolbarProps } from '@launchdarkly/toolbar';
+import type { LaunchDarklyToolbarProps, IFlagOverridePlugin, IEventInterceptionPlugin } from '@launchdarkly/toolbar';
 ```
 
 ---

package/dist/hooks/AfterEvaluationHook.d.ts

@@ -0,0 +1,17 @@
+import type { Hook } from 'launchdarkly-js-client-sdk';
+import type { HookMetadata, EvaluationSeriesData, LDEvaluationDetail, EvaluationSeriesContext } from 'launchdarkly-js-sdk-common';
+import type { EventFilter, ProcessedEvent } from '../types/events';
+export type AfterEvaluationHookConfig = {
+    onNewEvent?: (event: ProcessedEvent) => void;
+    filter?: EventFilter;
+};
+export declare class AfterEvaluationHook implements Hook {
+    private config;
+    private idCounter;
+    constructor(config?: AfterEvaluationHookConfig);
+    getMetadata(): HookMetadata;
+    afterEvaluation(hookContext: EvaluationSeriesContext, data: EvaluationSeriesData, detail: LDEvaluationDetail): EvaluationSeriesData;
+    private shouldProcessEvent;
+    private processEvent;
+    private extractMetadata;
+}

package/dist/hooks/AfterIdentifyHook.d.ts

@@ -0,0 +1,18 @@
+import type { Hook } from 'launchdarkly-js-client-sdk';
+import type { HookMetadata, IdentifySeriesContext, IdentifySeriesData, IdentifySeriesResult } from 'launchdarkly-js-sdk-common';
+import type { EventFilter, ProcessedEvent } from '../types/events';
+export type AfterIdentifyHookConfig = {
+    onNewEvent?: (event: ProcessedEvent) => void;
+    filter?: EventFilter;
+};
+export declare class AfterIdentifyHook implements Hook {
+    private config;
+    private idCounter;
+    constructor(config?: AfterIdentifyHookConfig);
+    getMetadata(): HookMetadata;
+    afterIdentify(hookContext: IdentifySeriesContext, data: IdentifySeriesData, result: IdentifySeriesResult): IdentifySeriesData;
+    private determineContextKind;
+    private shouldProcessEvent;
+    private processEvent;
+    private extractMetadata;
+}

package/dist/hooks/AfterTrackHook.d.ts

@@ -0,0 +1,17 @@
+import type { Hook } from 'launchdarkly-js-client-sdk';
+import type { HookMetadata, TrackSeriesContext } from 'launchdarkly-js-sdk-common';
+import type { EventFilter, ProcessedEvent } from '../types/events';
+export type AfterTrackHookConfig = {
+    onNewEvent?: (event: ProcessedEvent) => void;
+    filter?: EventFilter;
+};
+export declare class AfterTrackHook implements Hook {
+    private config;
+    private idCounter;
+    constructor(config?: AfterTrackHookConfig);
+    getMetadata(): HookMetadata;
+    afterTrack(hookContext: TrackSeriesContext): void;
+    private shouldProcessEvent;
+    private processEvent;
+    private extractMetadata;
+}

package/dist/hooks/EventStore.d.ts

@@ -0,0 +1,11 @@
+import type { ProcessedEvent } from '../types/events';
+export declare class EventStore {
+    private events;
+    private listeners;
+    addEvent(event: ProcessedEvent): void;
+    getEvents(): ProcessedEvent[];
+    subscribe(listener: () => void): () => void;
+    clear(): void;
+    destroy(): void;
+    private notifyListeners;
+}

package/dist/hooks/index.d.ts

@@ -0,0 +1,7 @@
+export { AfterTrackHook } from './AfterTrackHook';
+export type { AfterTrackHookConfig } from './AfterTrackHook';
+export { AfterIdentifyHook } from './AfterIdentifyHook';
+export type { AfterIdentifyHookConfig } from './AfterIdentifyHook';
+export { AfterEvaluationHook } from './AfterEvaluationHook';
+export type { AfterEvaluationHookConfig } from './AfterEvaluationHook';
+export { EventStore } from './EventStore';

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import './globals.css';
 export { LaunchDarklyToolbar } from './ui/Toolbar/LaunchDarklyToolbar';
 export type { LaunchDarklyToolbarProps } from './ui/Toolbar/LaunchDarklyToolbar';
-export type { IFlagOverridePlugin } from './types/plugin';
-export { FlagOverridePlugin } from './plugins';
-export type { FlagOverridePluginConfig } from './plugins';
+export type { IFlagOverridePlugin, IEventInterceptionPlugin } from './types/plugin';
+export { FlagOverridePlugin, EventInterceptionPlugin } from './plugins';
+export type { FlagOverridePluginConfig, EventInterceptionPluginConfig } from './plugins';
+export { AfterEvaluationHook, AfterIdentifyHook, AfterTrackHook, EventStore } from './hooks';
+export type { AfterEvaluationHookConfig, AfterIdentifyHookConfig, AfterTrackHookConfig } from './hooks';
+export type { ProcessedEvent, EventFilter } from './types/events';