@ops-ai/react-router-toggly 1.2.0 → 1.5.1

package/CHANGELOG.md

@@ -1,5 +1,43 @@
+## 1.5.1
+
+2026-10-15
+
+### Fixed
+- After `dispose()`, `use()` and `captureCheck()` no longer create an
+  unmanaged reporter or attach leftover lifecycle listeners [OPS-1758].
+
+## 1.5.0
+
+2026-10-11
+
+### Added
+- `use()` for timed feature usage scopes (attempt, duration, errors) via `@ops-ai/toggly-client-telemetry` [OPS-1758].
+
 # Changelog
 
+## [1.4.0] - 2026-10-11
+
+### Added
+- Usage scope metrics on `VariantStats` (`errorCount`, `durationSumMs`,
+  `errorDurationSumMs`) and batcher APIs `recordUsageError`, `recordUsageDuration`,
+  `recordUsageScopeOutcome` (proto fields 5–7).
+
+## [1.3.1] - 2026-10-11
+
+### Fixed
+- Only call `useRouteLoaderData` when `routeId` is set and use `useInRouterContext` so SSR and non-data-router apps hydrate from `fallbackContext` / `TogglyScript` without invoking data-router hooks [OPS-1756].
+
+## [1.3.0] - 2026-10-04
+
+### Added
+- Server export of `createSegmentMembershipClient` for Backend-key targeting-list updates.
+
+
+## [1.2.1] - 2026-09-27
+
+### Fixed
+- Keep `RouterTogglyProvider` hook order stable when route selection changes while retaining loader and fallback context hydration [OPS-1451].
+- Surface invalid React Router context errors to the application's Error Boundary instead of intercepting loader hooks [OPS-1451].
 
 ## [1.2.0] - 2026-09-26
 

package/dist/client.cjs

@@ -186,6 +186,7 @@ function createBrowserTelemetry(config) {
     }
   };
   const getReporter = () => {
+    if (disposed) return void 0;
     if (!reporter) {
       reporter = togglyClientTelemetry.createTelemetryReporter({
         appKey: config.appKey,
@@ -207,6 +208,7 @@ function createBrowserTelemetry(config) {
   };
   function replay(entry) {
     const target = getReporter();
+    if (!target) return;
     target.setContext(entry.context);
     if (entry.kind === "feature") {
       const methods = ["recordCheck", "recordUsage", "recordView"];
@@ -274,6 +276,28 @@ function createBrowserTelemetry(config) {
   }
   const api = {
     recordUsage: (key, variant = "enabled") => feature(key, variant, 1),
+    use: (key, fn, variant = "enabled") => {
+      if (!usage || disposed) {
+        return togglyClientTelemetry.runFeatureUsageScope(
+          { recordAttempt: () => {
+          }, recordSuccessDuration: () => {
+          }, recordFailure: () => {
+          } },
+          fn
+        );
+      }
+      const target = getReporter();
+      if (!target) {
+        return togglyClientTelemetry.runFeatureUsageScope(
+          { recordAttempt: () => {
+          }, recordSuccessDuration: () => {
+          }, recordFailure: () => {
+          } },
+          fn
+        );
+      }
+      return target.use(key, fn, variant);
+    },
     recordView: (key, variant = "enabled") => feature(key, variant, 2),
     incrementCounter: (key, value = 1) => event({ partition, context, key, kind: "counter", values: [value] }),
     setGauge: (key, value) => event({ partition, context, key, kind: "gauge", values: [value] }),
@@ -293,7 +317,10 @@ function createBrowserTelemetry(config) {
       if (disposed || !usage) return () => {
       };
       if (active) {
-        const record = getReporter().captureCheck();
+        const target = getReporter();
+        if (!target) return () => {
+        };
+        const record = target.captureCheck();
         return (key, result) => record(key, checkVariantLabel(result));
       }
       const attribution = context;
@@ -320,7 +347,7 @@ function createBrowserTelemetry(config) {
 
 // src/client/sdk-identity.ts
 var SDK_ID = "react-router";
-var SDK_VERSION = "1.2.0";
+var SDK_VERSION = "1.5.0";
 function appendSdkQueryParams(params) {
   params.set("sdk", SDK_ID);
   params.set("sdkVersion", SDK_VERSION);
@@ -1053,40 +1080,97 @@ function FeatureGate({
   const enabled = useFeatureGate(featureKeys, requirement, negate, context, contextKind);
   return enabled ? /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children }) : null;
 }
-function RouterTogglyProvider({
+function resolveServerContext(data, fallbackContext) {
+  const serverContext = data?.[TOGGLY_LOADER_KEY];
+  return serverContext ?? fallbackContext;
+}
+function buildMergedConfig(config, serverContext) {
+  return config ?? (serverContext ? {
+    appKey: serverContext.appKey,
+    environment: serverContext.environment
+  } : void 0);
+}
+function RouterTogglyProviderInner({
+  children,
+  serverContext,
+  config,
+  ...props
+}) {
+  const mergedConfig = buildMergedConfig(config, serverContext);
+  return /* @__PURE__ */ jsxRuntime.jsx(TogglyProvider, { serverContext, config: mergedConfig, ...props, children });
+}
+function RouterTogglyProviderWithData({
+  children,
+  data,
+  fallbackContext,
+  config,
+  ...props
+}) {
+  const serverContext = resolveServerContext(data, fallbackContext);
+  return /* @__PURE__ */ jsxRuntime.jsx(RouterTogglyProviderInner, { serverContext, config, ...props, children });
+}
+function RouterTogglyProviderFromRoute({
   children,
   routeId,
   fallbackContext,
   config,
   ...props
 }) {
-  let serverContext;
-  try {
-    if (routeId) {
-      const routeData = reactRouter.useRouteLoaderData(routeId);
-      serverContext = routeData?.[TOGGLY_LOADER_KEY];
-    } else {
-      const loaderData = reactRouter.useLoaderData();
-      serverContext = loaderData?.[TOGGLY_LOADER_KEY];
+  const routeData = reactRouter.useRouteLoaderData(routeId);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    RouterTogglyProviderWithData,
+    {
+      data: routeData,
+      fallbackContext,
+      config,
+      ...props,
+      children
     }
-  } catch {
-    serverContext = fallbackContext;
-  }
-  serverContext = serverContext ?? fallbackContext;
-  const mergedConfig = config ?? (serverContext ? {
-    appKey: serverContext.appKey,
-    environment: serverContext.environment
-  } : void 0);
+  );
+}
+function RouterTogglyProviderFromLoader({
+  children,
+  fallbackContext,
+  config,
+  ...props
+}) {
+  const loaderData = reactRouter.useLoaderData();
   return /* @__PURE__ */ jsxRuntime.jsx(
-    TogglyProvider,
+    RouterTogglyProviderWithData,
     {
-      serverContext,
-      config: mergedConfig,
+      data: loaderData,
+      fallbackContext,
+      config,
       ...props,
       children
     }
   );
 }
+function RouterTogglyProviderStatic({
+  children,
+  fallbackContext,
+  config,
+  ...props
+}) {
+  const serverContext = fallbackContext ?? getWindowTogglyData();
+  return /* @__PURE__ */ jsxRuntime.jsx(RouterTogglyProviderInner, { serverContext, config, ...props, children });
+}
+function RouterTogglyProvider({
+  children,
+  routeId,
+  fallbackContext,
+  config,
+  ...props
+}) {
+  const inRouter = reactRouter.useInRouterContext();
+  if (routeId && inRouter) {
+    return /* @__PURE__ */ jsxRuntime.jsx(RouterTogglyProviderFromRoute, { routeId, fallbackContext, config, ...props, children });
+  }
+  if (inRouter) {
+    return /* @__PURE__ */ jsxRuntime.jsx(RouterTogglyProviderFromLoader, { fallbackContext, config, ...props, children });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(RouterTogglyProviderStatic, { fallbackContext, config, ...props, children });
+}
 function useTogglyLoaderData() {
   const loaderData = reactRouter.useLoaderData();
   return {