@ops-ai/toggly-docusaurus-plugin 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,17 +1,49 @@
1
1
  # @ops-ai/toggly-docusaurus-plugin
2
2
 
3
+ ## Initial browser targeting context
4
+
5
+ Available since **0.9.0**.
6
+
7
+ ```tsx
8
+ import { TogglyProvider } from '@ops-ai/toggly-docusaurus-plugin/client';
9
+
10
+ <TogglyProvider config={{
11
+ appKey: 'your-app-key',
12
+ identity: 'user-123', // Stable identifier for this browser user.
13
+ instanceId: 'host-minted-token', // Optional opaque token supplied by your backend.
14
+ groups: ['beta'], // Memberships used by targeting rules.
15
+ claims: { plan: 'pro' }, // String attributes used by targeting rules.
16
+ }}>
17
+ <App />
18
+ </TogglyProvider>
19
+ ```
20
+
21
+ Supply context when the provider is first mounted so the first evaluated request
22
+ already targets that user. The client copies groups and claims; changing serialized
23
+ provider configuration replaces its owner and cache. Up to
24
+ 20 nonempty claims are sent in deterministic key order; group whitespace is trimmed.
25
+
26
+ The same `instanceId`, `identity`, `groups`, and `claims` options may be supplied in the
27
+ `@ops-ai/toggly-docusaurus-plugin` entry in `docusaurus.config.js`. Those values
28
+ are **public build-time defaults baked into the browser bundle**, not authenticated
29
+ per-user data or secrets. They do not change static build-time gating or edge
30
+ worker evaluation. Use the provider configuration for browser-user targeting.
31
+
32
+
3
33
  Docusaurus plugin and React bindings for gating documentation content with Toggly feature flags.
4
34
 
5
35
  ## Installation
6
36
 
7
37
  ```bash
8
- npm install @ops-ai/toggly-docusaurus-plugin @ops-ai/toggly-client-core
38
+ npm install @ops-ai/toggly-docusaurus-plugin
9
39
  # or
10
- pnpm add @ops-ai/toggly-docusaurus-plugin @ops-ai/toggly-client-core
40
+ pnpm add @ops-ai/toggly-docusaurus-plugin
11
41
  # or
12
- yarn add @ops-ai/toggly-docusaurus-plugin @ops-ai/toggly-client-core
42
+ yarn add @ops-ai/toggly-docusaurus-plugin
13
43
  ```
14
44
 
45
+ The plugin bundles its own flag client. You do not need `@ops-ai/toggly-client-core`.
46
+
15
47
  ## Configuration
16
48
 
17
49
  Add the plugin to your `docusaurus.config.js` or `docusaurus.config.ts`:
@@ -48,7 +80,32 @@ module.exports = {
48
80
  - `featureFlagsRefreshInterval` (number, optional): Refresh interval in milliseconds (default: `180000` = 3 minutes)
49
81
  - `isDebug` (boolean, optional): Enable debug logging (default: `false`)
50
82
  - `connectTimeout` (number, optional): Connection timeout in milliseconds (default: `5000`)
83
+ - `instanceId` (string, optional): Host-minted identity token; nonblank tokens take precedence over browser targeting fields
51
84
  - `identity` (string, optional): User identity for targeting
85
+ - `enableTelemetry` (boolean, optional): Enable browser telemetry (default: `true` with a public application key)
86
+ - `metricsBaseUrl` (string, optional): Independent metrics base URL (default: `https://metrics.toggly.io`)
87
+ - `telemetryFlushIntervalMs` (number, optional): Base flush interval, 30000–60000 milliseconds (default: 45000), with scheduling jitter
88
+
89
+ ## Browser telemetry
90
+
91
+ Each provider owns one reporter shared by its hooks and components. Direct `getFlag` calls and actual committed UI evaluations record checks using `enabled` or `disabled`; repeated unchanged hook snapshots, internal refreshes and hydration projection are silent. Negation changes the rendered branch after the underlying check is counted. Navbar gating uses a separate short-lived client and records only mapped links it evaluates.
92
+
93
+ ```tsx
94
+ const toggly = useToggly();
95
+ toggly.recordUsage('Checkout', 'control');
96
+ toggly.recordView('Checkout', 'control');
97
+ toggly.incrementCounter('orders', 2);
98
+ toggly.setGauge('cartItems', 3);
99
+ await toggly.flushTelemetry();
100
+ ```
101
+
102
+ Usage and view are explicit events; rendering never implies either. Explicit variants use 1–64 ASCII letters, digits, underscores or hyphens. Counters accept nonnegative integer deltas and gauges finite nonnegative values. Metric names refer to configured application-level metrics. Telemetry contains application/environment and aggregate counts/values, with optional attribution: a nonblank `instanceId` is sent as `i`; otherwise `identity` is sent as `u`. Groups, claims, entity data and timestamps are excluded, and telemetry is never persisted. Server acceptance of client-supplied `u` requires the application setting, which defaults off. Only your backend may mint an instance token using a Backend key; never put that key in browser configuration. With a token, browser definitions requests send `i` and omit `u`, groups and claims, including targeting parameters in the base URL. Without a token, existing browser targeting remains available.
103
+
104
+ `metricsBaseUrl` is independent of the definitions endpoint and preserves an explicit base path. Invalid telemetry intervals use the default; invalid telemetry URLs disable reporting without affecting feature evaluation. Provider config can supply `telemetryFetch` and `onTelemetryDiagnostic` for independent transport and bounded payload-free diagnostics. Changing a definitions fetch, telemetry fetch or diagnostic callback replaces the provider owner and cancels the retired owner’s unsent telemetry.
105
+
106
+ Queues and retries are bounded and delivery is best effort. Ordinary browser flushes prefer native gzip; pagehide/hidden and final teardown use plain fetch keepalive. Provider cleanup retires its client after a microtask so React StrictMode can replay effects safely. Use `flushTelemetry()` before removing an owner when you need to await a send attempt. Different providers retain independent queues, and changed application/environment configuration never relabels old events.
107
+
108
+ With `staticGating: true`, flags remain baked into the build: no runtime definitions requests or WebSockets are opened. Actual browser evaluations still report telemetry when a public browser app key is configured. Set `enableTelemetry: false` for a fully silent static runtime. Build-only keys are not added to browser configuration to enable reporting. Changing provider identity, token, groups or claims creates a fresh target client while retaining one reporter and its queued events under their original attribution. Failed refreshes use only the new target’s defaults. App, transport or opt-out changes discard the retired reporter’s queue; ordinary unmount attempts a bounded final flush. In static mode, a changed target or provider owner uses its own `flagDefaults` rather than reusing the page’s original baked map, including when returning to a previous target. Rebuild to bake a different application’s flags. SSR and builds never create frontend telemetry, and trusted edge enforcement remains separate.
52
109
 
53
110
  ## Page-Level Gating
54
111
 
@@ -3,13 +3,14 @@
3
3
  *
4
4
  * Provides React context, hooks, and components for feature flag evaluation
5
5
  */
6
- import { ReactNode } from 'react';
7
- import { type TogglyConfig, type Flags } from '../lib/toggly-client.js';
6
+ import React, { ReactNode } from 'react';
7
+ import { type TogglyClient, type TogglyConfig, type Flags } from '../lib/toggly-client.js';
8
8
  export interface TogglyProviderProps {
9
9
  config: TogglyConfig;
10
10
  children: ReactNode;
11
11
  }
12
- export interface TogglyContextValue {
12
+ export interface TogglyContextValue extends Pick<TogglyClient, 'recordUsage' | 'recordView' | 'incrementCounter' | 'setGauge' | 'flushTelemetry'> {
13
+ evaluateFlag: (key: string, defaultValue?: boolean) => boolean;
13
14
  flags: Flags;
14
15
  isReady: boolean;
15
16
  getFlag: (key: string, defaultValue?: boolean) => Promise<boolean>;
@@ -56,7 +57,7 @@ export declare function readEdgeFlagsSnapshot(): Flags | null;
56
57
  * </TogglyProvider>
57
58
  * ```
58
59
  */
59
- export declare function TogglyProvider({ config: providedConfig, children, }: TogglyProviderProps): JSX.Element;
60
+ export declare function TogglyProvider({ config: providedConfig, children, }: TogglyProviderProps): React.JSX.Element;
60
61
  /**
61
62
  * useToggly - Hook to access Toggly context
62
63
  *
@@ -84,7 +85,7 @@ export interface FeatureProps {
84
85
  children: ReactNode;
85
86
  /** When true, render children when the feature is off */
86
87
  negate?: boolean;
87
- /** Default value if flag is not found (default: false) */
88
+ /** Explicit fallback before configured flagDefaults, then false if absent. */
88
89
  defaultValue?: boolean;
89
90
  /**
90
91
  * HTML element to use as wrapper (default: 'div').
@@ -98,7 +99,7 @@ export interface FeatureProps {
98
99
  * useful for gating list items so the entire bullet (including the marker)
99
100
  * is removed when the flag is disabled, instead of leaving an empty bullet.
100
101
  */
101
- as?: keyof JSX.IntrinsicElements;
102
+ as?: keyof React.JSX.IntrinsicElements;
102
103
  }
103
- export declare function Feature({ flag, children, negate, defaultValue, as: Element, }: FeatureProps): JSX.Element;
104
+ export declare function Feature({ flag, children, negate, defaultValue, as: Element, }: FeatureProps): React.JSX.Element;
104
105
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAc,EAOZ,SAAS,EACV,MAAM,OAAO,CAAC;AACf,OAAO,EAAyC,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAE/G,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAOD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAeD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,KAAK,GAAG,IAAI,CAWrD;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,GAAG,IAAI,CAapD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,cAAc,EACtB,QAAQ,GACT,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CA2FnC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,OAAO,GACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAuBxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,SAAS,CAAC;IACpB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,iBAAiB,CAAC;CAClC;AAwDD,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,MAAc,EACd,YAAoB,EACpB,EAAE,EAAE,OAAe,GACpB,EAAE,YAAY,GAAG,GAAG,CAAC,OAAO,CA4C5B"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EASZ,SAAS,EACV,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,KAAK,EACX,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAC9C,YAAY,EACZ,aAAa,GAAG,YAAY,GAAG,kBAAkB,GAAG,UAAU,GAAG,gBAAgB,CAClF;IACC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAC/D,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAUD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAeD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,KAAK,GAAG,IAAI,CAWrD;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,GAAG,IAAI,CAapD;AAeD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,cAAc,EACtB,QAAQ,GACT,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmCzC;AA8ID;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,OAAO,GACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAyBxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,SAAS,CAAC;IACpB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC;CACxC;AAwDD,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,MAAc,EACd,YAAY,EACZ,EAAE,EAAE,OAAe,GACpB,EAAE,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0DlC"}
@@ -4,9 +4,13 @@ import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
4
4
  *
5
5
  * Provides React context, hooks, and components for feature flag evaluation
6
6
  */
7
- import { createContext, useContext, useState, useEffect, useRef, } from 'react';
8
- import { createTogglyClient } from '../lib/toggly-client.js';
7
+ import { createContext, useContext, useState, useEffect, useLayoutEffect, useCallback, useRef, useMemo, } from 'react';
8
+ import { createProviderClient, } from '../lib/toggly-client.js';
9
+ import { createBrowserTelemetry } from '../lib/browser-telemetry.js';
9
10
  const TogglyContext = createContext(null);
11
+ // Consumer-facing flags remain a mutable copy; render reads share the private
12
+ // snapshot captured by the committed evaluator, without recording during render.
13
+ const RenderFlagsContext = createContext(null);
10
14
  /**
11
15
  * Whether this bundle was built with `staticGating: true` (flags baked at build).
12
16
  */
@@ -70,6 +74,19 @@ export function readEdgeFlagsSnapshot() {
70
74
  }
71
75
  return sanitizeFlags(raw);
72
76
  }
77
+ // Functions are omitted by JSON serialization but remain part of transport ownership.
78
+ const transportCallbacks = new WeakMap();
79
+ let nextTransportCallback = 0;
80
+ function transportCallbackKey(callback) {
81
+ if (!callback)
82
+ return 0;
83
+ let key = transportCallbacks.get(callback);
84
+ if (key === undefined) {
85
+ key = ++nextTransportCallback;
86
+ transportCallbacks.set(callback, key);
87
+ }
88
+ return key;
89
+ }
73
90
  /**
74
91
  * TogglyProvider - React context provider for Toggly feature flags
75
92
  *
@@ -92,80 +109,117 @@ export function readEdgeFlagsSnapshot() {
92
109
  * ```
93
110
  */
94
111
  export function TogglyProvider({ config: providedConfig, children, }) {
95
- // If no config provided, try to read from window
96
112
  const config = providedConfig ||
97
- (typeof window !== 'undefined'
98
- ? window.__TOGGLY_CONFIG__ || {}
99
- : {});
113
+ (typeof window !== 'undefined' ? window.__TOGGLY_CONFIG__ || {} : {});
114
+ const { identity, instanceId, groups, claims, ...transport } = config;
115
+ const key = JSON.stringify([
116
+ transport,
117
+ transportCallbackKey(config.fetch),
118
+ transportCallbackKey(config.telemetryFetch),
119
+ transportCallbackKey(config.onTelemetryDiagnostic),
120
+ ]);
121
+ const targetingKey = JSON.stringify({ identity, instanceId, groups, claims });
122
+ const pageOwner = useRef({ key, targetingKey, retired: false });
123
+ const committedTransport = useRef(key);
124
+ const useCommitEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;
125
+ useCommitEffect(() => {
126
+ committedTransport.current = key;
127
+ if (pageOwner.current.key !== key || pageOwner.current.targetingKey !== targetingKey)
128
+ pageOwner.current.retired = true;
129
+ }, [key, targetingKey]);
130
+ const usePageSnapshot = !pageOwner.current.retired &&
131
+ pageOwner.current.key === key &&
132
+ pageOwner.current.targetingKey === targetingKey;
133
+ return (_jsx(ProviderOwner, { config: config, targetingKey: targetingKey, usePageSnapshot: usePageSnapshot, shouldFlush: () => committedTransport.current === key, children: children }, key));
134
+ }
135
+ function ProviderOwner({ config, children, targetingKey, usePageSnapshot, shouldFlush, }) {
136
+ const [telemetry] = useState(() => createBrowserTelemetry(config));
137
+ const leases = useRef(0);
138
+ useEffect(() => {
139
+ leases.current++;
140
+ return () => {
141
+ leases.current--;
142
+ queueMicrotask(() => {
143
+ if (leases.current === 0)
144
+ telemetry.dispose(shouldFlush());
145
+ });
146
+ };
147
+ }, [telemetry]);
148
+ return (_jsx(TargetOwner, { config: config, telemetry: telemetry, usePageSnapshot: usePageSnapshot, children: children }, targetingKey));
149
+ }
150
+ function TargetOwner({ config, children, usePageSnapshot, telemetry, }) {
100
151
  const staticGating = isStaticGatingMode();
101
- const initialFlags = readBuildFlagsSnapshot() ?? readEdgeFlagsSnapshot() ?? {};
102
- const [client] = useState(() => {
103
- if (staticGating) {
104
- return null;
105
- }
106
- // Ensure we have a valid config
107
- if (!config || (!config.appKey && Object.keys(config).length === 0)) {
108
- console.warn('[Toggly] No config provided. Please configure the plugin in docusaurus.config.js or pass config to TogglyProvider');
109
- }
110
- return createTogglyClient(config);
111
- });
112
- const [flags, setFlags] = useState(() => initialFlags);
113
- const [isReady, setIsReady] = useState(() => staticGating || readEdgeFlagsSnapshot() !== null);
152
+ const [defaults] = useState(() => ({ ...config.flagDefaults }));
153
+ const [client] = useState(() => createProviderClient({ ...config, flagDefaults: defaults }, telemetry));
154
+ const [flags, setFlags] = useState(() => staticGating
155
+ ? usePageSnapshot
156
+ ? (readBuildFlagsSnapshot() ?? {})
157
+ : { ...config.flagDefaults }
158
+ : usePageSnapshot
159
+ ? (readEdgeFlagsSnapshot() ?? {})
160
+ : {});
161
+ const [isReady, setIsReady] = useState(() => staticGating || (usePageSnapshot && readEdgeFlagsSnapshot() !== null));
114
162
  const [error, setError] = useState(null);
115
- // Keep a ref to the latest flags so the polling interval can detect changes
116
- const flagsRef = useRef(flags);
117
- flagsRef.current = flags;
163
+ const leases = useRef(0);
118
164
  useEffect(() => {
119
- if (staticGating || !client) {
120
- return;
121
- }
122
- let pollTimer = null;
123
- client
124
- .getFlags()
125
- .then((loadedFlags) => {
126
- setFlags(loadedFlags);
165
+ leases.current++;
166
+ let active = true;
167
+ client.startTelemetry();
168
+ const apply = (latest) => {
169
+ if (!active)
170
+ return;
171
+ setFlags((previous) => JSON.stringify(previous) === JSON.stringify(latest) ? previous : latest);
127
172
  setIsReady(true);
128
- })
129
- .catch((err) => {
130
- setError(err);
131
- setIsReady(true); // Still mark as ready even on error
132
- });
133
- // Start WebSocket for live updates
134
- client.startWebSocket();
135
- // Poll periodically so React state picks up refreshes triggered by WebSocket
136
- pollTimer = setInterval(() => {
137
- client.getFlags().then((latest) => {
138
- // Only update state when flags actually changed
139
- if (JSON.stringify(latest) !== JSON.stringify(flagsRef.current)) {
140
- setFlags(latest);
173
+ };
174
+ let pollTimer;
175
+ if (!staticGating) {
176
+ client
177
+ .getFlags()
178
+ .then(apply)
179
+ .catch((err) => {
180
+ if (active) {
181
+ setError(err);
182
+ setIsReady(true);
141
183
  }
142
- }).catch(() => {
143
- // Silently ignore polling errors
144
184
  });
145
- }, config.featureFlagsRefreshInterval ?? 3 * 60 * 1000);
185
+ client.startWebSocket();
186
+ pollTimer = setInterval(() => {
187
+ void client
188
+ .getFlags()
189
+ .then(apply)
190
+ .catch(() => { });
191
+ }, config.featureFlagsRefreshInterval ?? 3 * 60 * 1000);
192
+ }
146
193
  return () => {
194
+ active = false;
195
+ leases.current--;
147
196
  client.stopWebSocket();
148
- if (pollTimer) {
149
- clearInterval(pollTimer);
150
- }
197
+ clearInterval(pollTimer);
198
+ // Effect replay reacquires the same owner synchronously. A real unmount
199
+ // releases it at the next microtask; public client.dispose remains synchronous.
200
+ queueMicrotask(() => {
201
+ if (leases.current === 0)
202
+ client.dispose();
203
+ });
151
204
  };
152
- }, [client, staticGating, config.featureFlagsRefreshInterval]);
153
- const getFlag = async (key, defaultValue) => {
154
- if (staticGating) {
155
- return flags[key] ?? defaultValue ?? false;
156
- }
157
- if (!client) {
158
- return defaultValue ?? false;
159
- }
160
- return client.getFlag(key, defaultValue);
161
- };
162
- const value = {
163
- flags,
205
+ }, [client, staticGating]);
206
+ const evaluateFlag = useCallback((key, fallback) => client.evaluateFlag(key, flags, fallback), [client, flags]);
207
+ const getFlag = useCallback(async (key, fallback) => staticGating ? evaluateFlag(key, fallback) : client.getFlag(key, fallback), [client, staticGating, evaluateFlag]);
208
+ const publicFlags = useMemo(() => ({ ...flags }), [flags]);
209
+ const renderSnapshot = useMemo(() => ({ flags, defaults }), [flags, defaults]);
210
+ const value = useMemo(() => ({
211
+ flags: publicFlags,
164
212
  isReady,
165
213
  getFlag,
214
+ evaluateFlag,
166
215
  error,
167
- };
168
- return (_jsx(TogglyContext.Provider, { value: value, children: children }));
216
+ recordUsage: client.recordUsage,
217
+ recordView: client.recordView,
218
+ incrementCounter: client.incrementCounter,
219
+ setGauge: client.setGauge,
220
+ flushTelemetry: client.flushTelemetry,
221
+ }), [client, publicFlags, isReady, getFlag, evaluateFlag, error]);
222
+ return (_jsx(RenderFlagsContext.Provider, { value: renderSnapshot, children: _jsx(TogglyContext.Provider, { value: value, children: children }) }));
169
223
  }
170
224
  /**
171
225
  * useToggly - Hook to access Toggly context
@@ -187,24 +241,22 @@ export function useToggly() {
187
241
  * @returns Object with enabled state and ready state
188
242
  */
189
243
  export function useFlag(flagKey, defaultValue) {
190
- const { flags, isReady, getFlag } = useToggly();
191
- // Lazy initializer reads the already-populated flag map (e.g. the edge
192
- // snapshot seeded by TogglyProvider) so the very first render reflects
193
- // the resolved value. This is what lets Feature components emit a tree
194
- // that matches the post-edge-strip DOM during React hydration.
195
- const [enabled, setEnabled] = useState(() => flags[flagKey] !== undefined ? flags[flagKey] : defaultValue ?? false);
244
+ const { isReady, evaluateFlag } = useToggly();
245
+ const { flags, defaults } = useContext(RenderFlagsContext);
246
+ const enabled = flags[flagKey] ?? defaultValue ?? defaults[flagKey] ?? false;
247
+ const evaluated = useRef();
196
248
  useEffect(() => {
197
- if (isReady) {
198
- // First check cached flags
199
- if (flags[flagKey] !== undefined) {
200
- setEnabled(flags[flagKey]);
201
- }
202
- else {
203
- // Fallback to async getFlag
204
- getFlag(flagKey, defaultValue).then(setEnabled);
205
- }
206
- }
207
- }, [flagKey, flags, isReady, getFlag, defaultValue]);
249
+ if (!isReady)
250
+ return;
251
+ const previous = evaluated.current;
252
+ if (previous?.flags === flags &&
253
+ previous.key === flagKey &&
254
+ previous.fallback === defaultValue &&
255
+ previous.evaluate === evaluateFlag)
256
+ return;
257
+ evaluated.current = { flags, key: flagKey, fallback: defaultValue, evaluate: evaluateFlag };
258
+ evaluateFlag(flagKey, defaultValue);
259
+ }, [flagKey, flags, isReady, evaluateFlag, defaultValue]);
208
260
  return { enabled, isReady };
209
261
  }
210
262
  /**
@@ -257,13 +309,27 @@ function getWrapperStyle(element) {
257
309
  }
258
310
  return undefined;
259
311
  }
260
- export function Feature({ flag, children, negate = false, defaultValue = false, as: Element = 'div', }) {
312
+ export function Feature({ flag, children, negate = false, defaultValue, as: Element = 'div', }) {
313
+ const context = useContext(TogglyContext);
314
+ const renderSnapshot = useContext(RenderFlagsContext);
315
+ const lastStatic = useRef();
316
+ useEffect(() => {
317
+ if (!isStaticGatingMode() || !context?.isReady)
318
+ return;
319
+ const previous = lastStatic.current;
320
+ if (previous?.evaluate === context.evaluateFlag &&
321
+ previous.flag === flag &&
322
+ previous.fallback === defaultValue)
323
+ return;
324
+ lastStatic.current = { evaluate: context.evaluateFlag, flag, fallback: defaultValue };
325
+ context.evaluateFlag(flag, defaultValue);
326
+ }, [context?.evaluateFlag, context?.isReady, flag, defaultValue]);
261
327
  const wrapperStyle = getWrapperStyle(Element);
262
- const buildFlags = readBuildFlagsSnapshot();
263
- // Build-time static gating: evaluate flags during SSG and on the client
264
- // using the same baked-in map — no runtime API, no flash.
328
+ const buildFlags = renderSnapshot?.flags ?? readBuildFlagsSnapshot();
329
+ // The original owner shares the baked SSG map. A replacement owner uses
330
+ // its own defaults so another application's snapshot cannot cross owners.
265
331
  if (isStaticGatingMode() && buildFlags) {
266
- const enabled = buildFlags[flag] ?? defaultValue;
332
+ const enabled = buildFlags[flag] ?? defaultValue ?? renderSnapshot?.defaults[flag] ?? false;
267
333
  const show = negate ? !enabled : enabled;
268
334
  if (!show) {
269
335
  return _jsx(_Fragment, {});
@@ -286,7 +352,7 @@ export function Feature({ flag, children, negate = false, defaultValue = false,
286
352
  * Client-side Feature component that uses hooks
287
353
  * Separated to avoid hooks being called during SSR
288
354
  */
289
- function FeatureClient({ flag, children, negate = false, defaultValue = false, as: Element = 'div', }) {
355
+ function FeatureClient({ flag, children, negate = false, defaultValue, as: Element = 'div', }) {
290
356
  const { enabled, isReady } = useFlag(flag, defaultValue);
291
357
  const wrapperStyle = getWrapperStyle(Element);
292
358
  const show = negate ? !enabled : enabled;
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"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"}
@@ -14,5 +14,6 @@
14
14
  * - It does not affect SSR HTML. For edge stripping, rely on the Cloudflare Worker
15
15
  * reading the same mapping and using data-feature markers if desired.
16
16
  */
17
- export {};
17
+ /** Docusaurus invokes this after SPA navigation updates the page's links. */
18
+ export declare function onRouteDidUpdate(): void;
18
19
  //# sourceMappingURL=nav-gate.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"nav-gate.d.ts","sourceRoot":"","sources":["../../src/client/nav-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}
1
+ {"version":3,"file":"nav-gate.d.ts","sourceRoot":"","sources":["../../src/client/nav-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA6EH,6EAA6E;AAC7E,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}
@@ -39,39 +39,49 @@ async function gateNavbar() {
39
39
  }
40
40
  const config = (typeof window !== 'undefined' && window.__TOGGLY_CONFIG__) || __TOGGLY_CONFIG__;
41
41
  const client = createTogglyClient(config);
42
- let flags = {};
43
42
  try {
44
- flags = await client.getFlags();
45
- }
46
- catch {
47
- // If flags cannot be fetched, fail open: do nothing to avoid hiding links incorrectly
48
- return;
49
- }
50
- // If we received no flags at all, fail open
51
- if (!flags || Object.keys(flags).length === 0) {
52
- return;
53
- }
54
- // Query all navbar links
55
- const links = Array.from(document.querySelectorAll('a.navbar__item, a.navbar__link, a.menu__link'));
56
- for (const link of links) {
57
- const path = normalizePath(link.getAttribute('href') || '');
58
- if (!path)
59
- continue;
60
- const feature = PAGE_FEATURES[path];
61
- if (!feature)
62
- continue;
63
- const enabled = flags[feature];
64
- // Hide when the feature is explicitly false or not truthy
65
- if (enabled !== true) {
66
- const parent = link.parentElement;
67
- if (parent && parent.childElementCount === 1) {
68
- parent.remove(); // remove the li if link is sole child
69
- }
70
- else {
71
- link.remove();
43
+ let flags = {};
44
+ try {
45
+ flags = await client.getFlags();
46
+ }
47
+ catch {
48
+ // If flags cannot be fetched, fail open: do nothing to avoid hiding links incorrectly
49
+ return;
50
+ }
51
+ // If we received no flags at all, fail open
52
+ if (!flags || Object.keys(flags).length === 0) {
53
+ return;
54
+ }
55
+ // Query all navbar links
56
+ const links = Array.from(document.querySelectorAll('a.navbar__item, a.navbar__link, a.menu__link'));
57
+ for (const link of links) {
58
+ const path = normalizePath(link.getAttribute('href') || '');
59
+ if (!path)
60
+ continue;
61
+ const feature = PAGE_FEATURES[path];
62
+ if (!feature)
63
+ continue;
64
+ const enabled = client.evaluateFlag(feature, flags);
65
+ // Hide when the feature is explicitly false or not truthy
66
+ if (enabled !== true) {
67
+ const parent = link.parentElement;
68
+ if (parent && parent.childElementCount === 1) {
69
+ parent.remove(); // remove the li if link is sole child
70
+ }
71
+ else {
72
+ link.remove();
73
+ }
72
74
  }
73
75
  }
74
76
  }
77
+ finally {
78
+ client.dispose();
79
+ }
80
+ }
81
+ /** Docusaurus invokes this after SPA navigation updates the page's links. */
82
+ export function onRouteDidUpdate() {
83
+ if (typeof window !== 'undefined')
84
+ void gateNavbar();
75
85
  }
76
86
  if (typeof window !== 'undefined' && document?.addEventListener) {
77
87
  document.addEventListener('DOMContentLoaded', () => {
@@ -1 +1 @@
1
- {"version":3,"file":"nav-gate.js","sourceRoot":"","sources":["../../src/client/nav-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,kBAAkB,EAAc,MAAM,yBAAyB,CAAC;AAKzE,MAAM,aAAa,GACjB,OAAO,wBAAwB,KAAK,QAAQ,IAAI,wBAAwB,KAAK,IAAI;IAC/E,CAAC,CAAC,wBAAwB;IAC1B,CAAC,CAAC,EAAE,CAAC;AAET,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,sCAAsC;QACtC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;QACrB,oCAAoC;QACpC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,KAAK,WAAW,IAAK,MAAc,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC;IACzG,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE1C,IAAI,KAAK,GAAU,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,sFAAsF;QACtF,OAAO;IACT,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,yBAAyB;IACzB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CACtB,QAAQ,CAAC,gBAAgB,CAAoB,8CAA8C,CAAC,CAC7F,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,0DAA0D;QAC1D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;YAClC,IAAI,MAAM,IAAI,MAAM,CAAC,iBAAiB,KAAK,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,sCAAsC;YACzD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAChE,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;QACjD,KAAK,UAAU,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC"}
1
+ {"version":3,"file":"nav-gate.js","sourceRoot":"","sources":["../../src/client/nav-gate.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -20,6 +20,9 @@ export interface TogglyContentRoot {
20
20
  routeBasePath: string;
21
21
  }
22
22
  export interface TogglyPluginOptions {
23
+ enableTelemetry?: boolean;
24
+ metricsBaseUrl?: string;
25
+ telemetryFlushIntervalMs?: number;
23
26
  /** Base URI for the Toggly API (default: 'https://definitions.toggly.io') */
24
27
  baseURI?: string;
25
28
  /** Application key from Toggly */
@@ -36,8 +39,14 @@ export interface TogglyPluginOptions {
36
39
  isDebug?: boolean;
37
40
  /** Connection timeout in milliseconds (default: 5000) */
38
41
  connectTimeout?: number;
42
+ /** Opaque identity token supplied by the host backend for browser targeting. */
43
+ instanceId?: string;
39
44
  /** User identity for targeting (optional) */
40
45
  identity?: string;
46
+ /** Public build-time group defaults for browser targeting, not authenticated user data. */
47
+ groups?: string[];
48
+ /** Public build-time claim defaults for browser targeting (up to 20 string claims). */
49
+ claims?: Record<string, string>;
41
50
  /**
42
51
  * Render all Feature component children during static build (SSR).
43
52
  * When true, feature-gated content renders during build so:
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAU7D;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,mFAAmF;IACnF,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAmBD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAsRR;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,GACzC,iBAAiB,EAAE,CAkBrB;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAsBxF;AAmGD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC5H,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAU7D;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,mFAAmF;IACnF,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAmBD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAoSR;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,GACzC,iBAAiB,EAAE,CAkBrB;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAsBxF;AAmGD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC5H,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC"}