@terreno/rtk 0.19.0 → 0.20.1

package/README.md

@@ -95,3 +95,9 @@ const {socket, isSocketConnected} = useSocketConnection({
 - `generateTags` - RTK Query tag generator for cache invalidation
 - `ListResponse`, `populateId` - Mongoose list response utilities
 
+## Feature flags (OpenFeature)
+
+`useFeatureFlags` and **`useTerrenoFeatureFlags`** wire Terreno’s `GET /feature-flags/flagConfiguration` into OpenFeature. Peer dependencies: **`@openfeature/react-sdk`** and **`@openfeature/web-sdk`** (install them in your app; do not rely on transitive copies).
+
+Full upgrade steps (backend + frontend + SDK regen) live in the **Terreno root README**: [Feature flags: OpenFeature migration](../README.md#feature-flags-openfeature-migration).
+

package/dist/emptyApi.d.ts

@@ -118,7 +118,7 @@ export declare const useGetVersionCheckQuery: <R extends Record<string, any> = i
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "error" | "data" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
+}, "error" | "data" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -256,7 +256,7 @@ export declare const useGetVersionCheckQuery: <R extends Record<string, any> = i
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "error" | "data" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
+    }, "error" | "data" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -395,7 +395,7 @@ export declare const useGetVersionCheckQuery: <R extends Record<string, any> = i
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "error" | "data" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
+}, "error" | "data" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -527,7 +527,7 @@ export declare const useGetVersionCheckQuery: <R extends Record<string, any> = i
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "error" | "data" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
+    }, "error" | "data" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;

package/dist/index.d.ts

@@ -18,5 +18,6 @@ export * from "./useFeatureFlags";
 export * from "./useOfflineStatus";
 export * from "./useRealtimeDebug";
 export * from "./useServerStatus";
+export * from "./useTerrenoFeatureFlags";
 export * from "./useUpgradeCheck";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -18,5 +18,6 @@ export * from "./useFeatureFlags";
 export * from "./useOfflineStatus";
 export * from "./useRealtimeDebug";
 export * from "./useServerStatus";
+export * from "./useTerrenoFeatureFlags";
 export * from "./useUpgradeCheck";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/dist/openFeatureReactSdkSpike.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openFeatureReactSdkSpike.test.d.ts.map

package/dist/openFeatureReactSdkSpike.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openFeatureReactSdkSpike.test.d.ts","sourceRoot":"","sources":["../src/openFeatureReactSdkSpike.test.ts"],"names":[],"mappings":""}

package/dist/openFeatureReactSdkSpike.test.js

@@ -0,0 +1,29 @@
+import { afterEach, beforeEach, describe, expect, it } from "bun:test";
+import { OpenFeatureProvider, useBooleanFlagValue } from "@openfeature/react-sdk";
+import { NOOP_PROVIDER, OpenFeature, TypedInMemoryProvider } from "@openfeature/web-sdk";
+import { renderHook, waitFor } from "@testing-library/react-native";
+import React from "react";
+const SPIKE_DOMAIN = "openfeature-rn-spike";
+describe("@openfeature/react-sdk with React Native test renderer", () => {
+    beforeEach(async () => {
+        await OpenFeature.setProviderAndWait(SPIKE_DOMAIN, new TypedInMemoryProvider({
+            "demo-flag": {
+                defaultVariant: "on",
+                disabled: false,
+                variants: { off: false, on: true },
+            },
+        }));
+    });
+    afterEach(async () => {
+        await OpenFeature.setProviderAndWait(SPIKE_DOMAIN, NOOP_PROVIDER);
+    });
+    it("exposes useBooleanFlagValue when wrapped by OpenFeatureProvider", async () => {
+        const { result } = renderHook(() => useBooleanFlagValue("demo-flag", false), {
+            wrapper: ({ children }) => React.createElement(OpenFeatureProvider, { domain: SPIKE_DOMAIN }, children),
+        });
+        await waitFor(() => {
+            expect(result.current).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=openFeatureReactSdkSpike.test.js.map

package/dist/openFeatureReactSdkSpike.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openFeatureReactSdkSpike.test.js","sourceRoot":"","sources":["../src/openFeatureReactSdkSpike.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAC,MAAM,UAAU,CAAC;AACrE,OAAO,EAAC,mBAAmB,EAAE,mBAAmB,EAAC,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAC,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAC,UAAU,EAAE,OAAO,EAAC,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAE5C,QAAQ,CAAC,wDAAwD,EAAE,GAAG,EAAE;IACtE,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,WAAW,CAAC,kBAAkB,CAClC,YAAY,EACZ,IAAI,qBAAqB,CAAC;YACxB,WAAW,EAAE;gBACX,cAAc,EAAE,IAAI;gBACpB,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,EAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAC;aACjC;SACF,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,WAAW,CAAC,kBAAkB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,EAAC,MAAM,EAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE;YACzE,OAAO,EAAE,CAAC,EAAC,QAAQ,EAA8B,EAAE,EAAE,CACnD,KAAK,CAAC,aAAa,CAAC,mBAAmB,EAAE,EAAC,MAAM,EAAE,YAAY,EAAC,EAAE,QAAQ,CAAC;SAC7E,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/useFeatureFlags.d.ts

@@ -4,17 +4,17 @@ interface FlagValues {
 }
 type FlagsApi = Api<any, any, any, any>;
 interface UseFeatureFlagsResult {
+    error: unknown;
     flags: FlagValues;
     getFlag: (key: string) => boolean;
     getVariant: (key: string) => string | null;
     isLoading: boolean;
-    error: unknown;
     refetch: () => void;
 }
 /**
  * Creates feature flag accessors from an RTK Query API instance.
  *
- * Injects a `GET {basePath}/evaluate` endpoint into the API and returns
+ * Injects a `GET {basePath}/flagConfiguration` endpoint into the API and returns
  * accessors for reading flag values. Fetches once on mount and caches via
  * RTK Query. Both `api` and `basePath` should be stable references.
  *
@@ -27,29 +27,29 @@ interface UseFeatureFlagsResult {
  * ```
  */
 export interface UseFeatureFlagsOptions {
-    /**
-     * Base path for the feature-flags endpoint. Defaults to "/feature-flags".
-     */
     basePath?: string;
-    /**
-     * When true, the underlying evaluate query is not fired. Use this to avoid
-     * fetching before the user is authenticated.
-     */
+    domain?: string;
     skip?: boolean;
+    socket?: {
+        off: (event: string, handler: (...args: unknown[]) => void) => void;
+        on: (event: string, handler: (...args: unknown[]) => void) => void;
+    } | null;
+    socketEventName?: string;
+    userId?: string | null;
 }
 interface ResolvedFeatureFlagsOptions {
     basePath: string;
+    domain: string;
     skip: boolean;
+    socket?: UseFeatureFlagsOptions["socket"];
+    socketEventName?: string;
+    userId?: string | null;
 }
 /**
  * Normalizes the legacy-compatible `basePathOrOptions` argument into a
- * `{basePath, skip}` pair with defaults applied.
- *
- * - `undefined` -> `{basePath: "/feature-flags", skip: false}`
- * - `string`    -> `{basePath: <string>, skip: false}` (legacy form)
- * - `object`    -> `{basePath: opts.basePath ?? "/feature-flags", skip: opts.skip ?? false}`
+ * `{basePath, skip, ...}` pair with defaults applied.
  */
 export declare const resolveFeatureFlagsOptions: (basePathOrOptions?: string | UseFeatureFlagsOptions) => ResolvedFeatureFlagsOptions;
-export declare function useFeatureFlags(api: FlagsApi, basePathOrOptions?: string | UseFeatureFlagsOptions): UseFeatureFlagsResult;
+export declare const useFeatureFlags: (api: FlagsApi, basePathOrOptions?: string | UseFeatureFlagsOptions) => UseFeatureFlagsResult;
 export {};
 //# sourceMappingURL=useFeatureFlags.d.ts.map

package/dist/useFeatureFlags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureFlags.d.ts","sourceRoot":"","sources":["../src/useFeatureFlags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,8BAA8B,CAAC;AAGtD,UAAU,UAAU;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;CACxC;AAGD,KAAK,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAuCxC,UAAU,qBAAqB;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,2BAA2B;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,oBAAoB,MAAM,GAAG,sBAAsB,KAClD,2BAMF,CAAC;AAIF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,EACb,iBAAiB,CAAC,EAAE,MAAM,GAAG,sBAAsB,GAClD,qBAAqB,CAyEvB"}
+{"version":3,"file":"useFeatureFlags.d.ts","sourceRoot":"","sources":["../src/useFeatureFlags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,8BAA8B,CAAC;AAItD,UAAU,UAAU;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;CACxC;AAGD,KAAK,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAExC,UAAU,qBAAqB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;QACpE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;KACpE,GAAG,IAAI,CAAC;IACT,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,UAAU,2BAA2B;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACrC,oBAAoB,MAAM,GAAG,sBAAsB,KAClD,2BAaF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,KAAK,QAAQ,EACb,oBAAoB,MAAM,GAAG,sBAAsB,KAClD,qBAoGF,CAAC"}

package/dist/useFeatureFlags.js

@@ -1,107 +1,94 @@
-import { useCallback, useEffect, useRef } from "react";
-/**
- * Cache the enhanced api per (api, basePath). `injectEndpoints` logs a console
- * error in development whenever an endpoint with the same name is re-injected
- * with `overrideExisting: false`, so calling it on every render of every
- * consumer would flood the console. WeakMap-by-api lets the GC reclaim entries
- * when the api object is unreachable.
- */
-const enhancedApiCache = new WeakMap();
-const getEnhancedApi = (api, basePath) => {
-    let byBase = enhancedApiCache.get(api);
-    if (!byBase) {
-        byBase = new Map();
-        enhancedApiCache.set(api, byBase);
-    }
-    const cached = byBase.get(basePath);
-    if (cached) {
-        return cached;
-    }
-    const enhanced = api.injectEndpoints({
-        endpoints: (builder) => ({
-            evaluateFeatureFlags: builder.query({
-                query: () => ({
-                    method: "GET",
-                    url: `${basePath}/evaluate`,
-                }),
-            }),
-        }),
-        overrideExisting: false,
-    });
-    byBase.set(basePath, enhanced);
-    return enhanced;
-};
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useTerrenoFeatureFlags } from "./useTerrenoFeatureFlags";
 /**
  * Normalizes the legacy-compatible `basePathOrOptions` argument into a
- * `{basePath, skip}` pair with defaults applied.
- *
- * - `undefined` -> `{basePath: "/feature-flags", skip: false}`
- * - `string`    -> `{basePath: <string>, skip: false}` (legacy form)
- * - `object`    -> `{basePath: opts.basePath ?? "/feature-flags", skip: opts.skip ?? false}`
+ * `{basePath, skip, ...}` pair with defaults applied.
  */
 export const resolveFeatureFlagsOptions = (basePathOrOptions) => {
-    const { basePath = "/feature-flags", skip = false } = typeof basePathOrOptions === "string"
+    const raw = typeof basePathOrOptions === "string"
         ? { basePath: basePathOrOptions, skip: false }
         : (basePathOrOptions ?? {});
-    return { basePath, skip };
+    return {
+        basePath: raw.basePath ?? "/feature-flags",
+        domain: raw.domain ?? "feature-flags",
+        skip: raw.skip ?? false,
+        socket: raw.socket,
+        socketEventName: raw.socketEventName,
+        userId: raw.userId,
+    };
 };
-// Overloaded signature preserves backwards compatibility with callers that
-// pass a string basePath as the second argument.
-export function useFeatureFlags(api, basePathOrOptions) {
-    const { basePath, skip } = resolveFeatureFlagsOptions(basePathOrOptions);
-    const enhancedApi = getEnhancedApi(api, basePath);
-    const useEvaluateQuery = enhancedApi.useEvaluateFeatureFlagsQuery;
-    const { data, isLoading, error, refetch } = useEvaluateQuery(undefined, { skip });
-    const evaluateStartedAtRef = useRef(null);
-    const flags = data ?? {};
-    // Log when evaluate request enters loading state so client timing can be measured.
+export const useFeatureFlags = (api, basePathOrOptions) => {
+    const { basePath, domain, skip, socket, socketEventName, userId } = resolveFeatureFlagsOptions(basePathOrOptions);
+    const { client, error, flags: rawFlags, isLoading, refetch, } = useTerrenoFeatureFlags(api, {
+        basePath,
+        domain,
+        skip,
+        socket,
+        socketEventName,
+        userId,
+    });
+    const fetchStartedAtRef = useRef(null);
     useEffect(() => {
-        if (!isLoading || evaluateStartedAtRef.current !== null) {
+        if (!isLoading || fetchStartedAtRef.current !== null) {
             return;
         }
-        evaluateStartedAtRef.current = Date.now();
-        console.debug("[feature-flags] evaluate request started", {
+        fetchStartedAtRef.current = Date.now();
+        console.debug("[feature-flags] flagConfiguration request started", {
             basePath,
         });
     }, [basePath, isLoading]);
-    // Log evaluate success with duration and number of resolved flag values.
     useEffect(() => {
-        if (!data || evaluateStartedAtRef.current === null) {
+        if (!error || fetchStartedAtRef.current === null) {
             return;
         }
-        const durationMs = Date.now() - evaluateStartedAtRef.current;
-        evaluateStartedAtRef.current = null;
-        console.debug("[feature-flags] evaluate request completed", {
+        const durationMs = Date.now() - fetchStartedAtRef.current;
+        fetchStartedAtRef.current = null;
+        console.debug("[feature-flags] flagConfiguration request failed", {
             basePath,
             durationMs,
-            evaluatedFlagCount: Object.keys(flags).length,
-            evaluatedFlags: flags,
+            error,
         });
-    }, [basePath, data, flags]);
-    // Log evaluate failures with duration so request issues can be correlated.
+    }, [basePath, error]);
+    const flatFlags = useMemo(() => {
+        const out = {};
+        for (const [key, def] of Object.entries(rawFlags)) {
+            const value = def.variants[def.defaultVariant];
+            out[key] = value ?? null;
+        }
+        return out;
+    }, [rawFlags]);
     useEffect(() => {
-        if (!error || evaluateStartedAtRef.current === null) {
+        if (Object.keys(flatFlags).length === 0 || fetchStartedAtRef.current === null) {
+            return;
+        }
+        if (isLoading) {
             return;
         }
-        const durationMs = Date.now() - evaluateStartedAtRef.current;
-        evaluateStartedAtRef.current = null;
-        console.debug("[feature-flags] evaluate request failed", {
+        const durationMs = Date.now() - fetchStartedAtRef.current;
+        fetchStartedAtRef.current = null;
+        console.debug("[feature-flags] flagConfiguration request completed", {
             basePath,
             durationMs,
-            error,
+            evaluatedFlagCount: Object.keys(flatFlags).length,
+            evaluatedFlags: flatFlags,
         });
-    }, [basePath, error]);
+    }, [basePath, flatFlags, isLoading]);
     const getFlag = useCallback((key) => {
-        const value = flags[key];
-        return value === true;
-    }, [flags]);
+        return client.getBooleanValue(key, false);
+    }, [client]);
     const getVariant = useCallback((key) => {
-        const value = flags[key];
-        if (typeof value === "string") {
-            return value;
+        if (!rawFlags[key]) {
+            return null;
+        }
+        const value = client.getStringValue(key, "");
+        if (value === "") {
+            return null;
         }
-        return null;
-    }, [flags]);
-    return { error, flags, getFlag, getVariant, isLoading, refetch };
-}
+        return value;
+    }, [client, rawFlags]);
+    const stableRefetch = useCallback(() => {
+        void refetch();
+    }, [refetch]);
+    return { error, flags: flatFlags, getFlag, getVariant, isLoading, refetch: stableRefetch };
+};
 //# sourceMappingURL=useFeatureFlags.js.map

package/dist/useFeatureFlags.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureFlags.js","sourceRoot":"","sources":["../src/useFeatureFlags.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useFeatureFlags.js","sourceRoot":"","sources":["../src/useFeatureFlags.ts"],"names":[],"mappings":"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"}