@terreno/rtk 0.19.0 → 0.20.0

package/dist/useTerrenoFeatureFlags.test.js

@@ -0,0 +1,160 @@
+import { afterEach, beforeEach, describe, expect, it, mock } from "bun:test";
+import EventEmitter from "node:events";
+import { NOOP_PROVIDER, OpenFeature } from "@openfeature/web-sdk";
+import { renderHook, waitFor } from "@testing-library/react-native";
+import React, { StrictMode } from "react";
+import { useTerrenoFeatureFlags } from "./useTerrenoFeatureFlags";
+const boolDef = (variant) => ({
+    defaultVariant: variant,
+    disabled: false,
+    variants: { off: false, on: true },
+});
+const buildApi = (queryResult) => {
+    const refetch = mock(() => { });
+    const useTerrenoFlagConfigurationQuery = mock(() => {
+        const hasData = Boolean(queryResult.data);
+        return {
+            data: queryResult.data,
+            error: queryResult.error,
+            isError: queryResult.isError ?? Boolean(queryResult.error),
+            isFetching: queryResult.isFetching ?? false,
+            isLoading: queryResult.isLoading ?? false,
+            isSuccess: queryResult.isSuccess ?? hasData,
+            refetch,
+        };
+    });
+    const api = {
+        injectEndpoints: mock((opts) => {
+            const builder = {
+                query: (def) => {
+                    def.query();
+                    return { useQuery: useTerrenoFlagConfigurationQuery };
+                },
+            };
+            opts.endpoints(builder);
+            return { useTerrenoFlagConfigurationQuery };
+        }),
+    };
+    return { api, refetch, useTerrenoFlagConfigurationQuery };
+};
+describe("useTerrenoFeatureFlags", () => {
+    beforeEach(async () => {
+        await OpenFeature.setProviderAndWait("feature-flags", NOOP_PROVIDER);
+        await OpenFeature.setProviderAndWait("custom-ff", NOOP_PROVIDER);
+    });
+    afterEach(async () => {
+        await OpenFeature.setProviderAndWait("feature-flags", NOOP_PROVIDER);
+        await OpenFeature.setProviderAndWait("custom-ff", NOOP_PROVIDER);
+    });
+    it("sets TypedInMemoryProvider and exposes client values after success", async () => {
+        const { api } = buildApi({ data: { alpha: boolDef("on") } });
+        const { result } = renderHook(() => useTerrenoFeatureFlags(api, { domain: "feature-flags", userId: "u1" }));
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+        expect(result.current.client.getBooleanValue("alpha", false)).toBe(true);
+        expect(result.current.flags.alpha?.defaultVariant).toBe("on");
+    });
+    it("does not leave loading stuck when skip is true", () => {
+        const { api } = buildApi({ data: { alpha: boolDef("on") } });
+        const { result } = renderHook(() => useTerrenoFeatureFlags(api, { domain: "feature-flags", skip: true, userId: "u1" }));
+        expect(result.current.isLoading).toBe(false);
+    });
+    it("does not leave loading stuck when the flag configuration query errors", () => {
+        const { api } = buildApi({
+            error: new Error("request failed"),
+            isError: true,
+            isLoading: false,
+            isSuccess: false,
+        });
+        const { result } = renderHook(() => useTerrenoFeatureFlags(api, { domain: "feature-flags", userId: "u1" }));
+        expect(result.current.isLoading).toBe(false);
+        expect(result.current.error).toBeDefined();
+    });
+    it("isolates domains so a custom domain does not read another domain's provider", async () => {
+        const { api } = buildApi({ data: { alpha: boolDef("on") } });
+        const { result } = renderHook(() => useTerrenoFeatureFlags(api, { domain: "custom-ff", userId: "u1" }));
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+        const defaultClient = OpenFeature.getClient();
+        expect(defaultClient.getBooleanValue("alpha", false)).toBe(false);
+        expect(result.current.client.getBooleanValue("alpha", false)).toBe(true);
+    });
+    it("refetches when the socket receives the configured event", async () => {
+        const socket = new EventEmitter();
+        const { api, refetch } = buildApi({ data: { alpha: boolDef("off") } });
+        const { result } = renderHook(() => useTerrenoFeatureFlags(api, {
+            domain: "feature-flags",
+            socket: {
+                off: (ev, fn) => {
+                    socket.off(ev, fn);
+                },
+                on: (ev, fn) => {
+                    socket.on(ev, fn);
+                },
+            },
+            socketEventName: "featureFlagsChanged",
+            userId: "u1",
+        }));
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+        socket.emit("featureFlagsChanged");
+        expect(refetch).toHaveBeenCalled();
+    });
+    it("survives React StrictMode double-mount without throwing", async () => {
+        const { api } = buildApi({ data: { alpha: boolDef("on") } });
+        const { result } = renderHook(() => useTerrenoFeatureFlags(api, { domain: "feature-flags", userId: "u1" }), {
+            wrapper: ({ children }) => React.createElement(StrictMode, null, children),
+        });
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+        expect(result.current.client.getBooleanValue("alpha", false)).toBe(true);
+    });
+    it("re-applies provider when fetched configuration changes", async () => {
+        const built = buildApi({ data: { alpha: boolDef("off") } });
+        const { result, rerender } = renderHook(({ data }) => {
+            built.useTerrenoFlagConfigurationQuery.mockImplementation(() => ({
+                data,
+                error: undefined,
+                isError: false,
+                isFetching: false,
+                isLoading: false,
+                isSuccess: true,
+                refetch: built.refetch,
+            }));
+            return useTerrenoFeatureFlags(built.api, { domain: "feature-flags", userId: "u1" });
+        }, { initialProps: { data: { alpha: boolDef("off") } } });
+        await waitFor(() => {
+            expect(result.current.client.getBooleanValue("alpha", false)).toBe(false);
+        });
+        rerender({ data: { alpha: boolDef("on") } });
+        await waitFor(() => {
+            expect(result.current.client.getBooleanValue("alpha", false)).toBe(true);
+        });
+    });
+});
+describe("useTerrenoFeatureFlags ref-count cleanup", () => {
+    /** Dedicated domain so parallel test files do not hold extra `feature-flags` hook refs. */
+    const refcountTestDomain = "terreno-refcount-test-isolation";
+    beforeEach(async () => {
+        await OpenFeature.setProviderAndWait(refcountTestDomain, NOOP_PROVIDER);
+    });
+    afterEach(async () => {
+        await OpenFeature.setProviderAndWait(refcountTestDomain, NOOP_PROVIDER);
+    });
+    it("installs NOOP provider after the last hook instance unmounts", async () => {
+        const { api } = buildApi({ data: { alpha: boolDef("on") } });
+        const { unmount } = renderHook(() => useTerrenoFeatureFlags(api, { domain: refcountTestDomain, userId: "u1" }));
+        await waitFor(() => {
+            expect(OpenFeature.getClient(refcountTestDomain).getBooleanValue("alpha", false)).toBe(true);
+        }, { timeout: 5000 });
+        unmount();
+        await waitFor(() => {
+            expect(OpenFeature.getClient(refcountTestDomain).getBooleanValue("alpha", false)).toBe(false);
+        }, { timeout: 5000 });
+    });
+});
+//# sourceMappingURL=useTerrenoFeatureFlags.test.js.map

package/dist/useTerrenoFeatureFlags.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerrenoFeatureFlags.test.js","sourceRoot":"","sources":["../src/useTerrenoFeatureFlags.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAC,MAAM,UAAU,CAAC;AAC3E,OAAO,YAAY,MAAM,aAAa,CAAC;AACvC,OAAO,EAAC,aAAa,EAAE,WAAW,EAAC,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAC,UAAU,EAAE,OAAO,EAAC,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AAExC,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAoBhE,MAAM,OAAO,GAAG,CAAC,OAAqB,EAAE,EAAE,CAAC,CAAC;IAC1C,cAAc,EAAE,OAAO;IACvB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,EAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAC;CACjC,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,WAAwB,EAAE,EAAE;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,gCAAgC,GAAG,IAAI,CAAC,GAAG,EAAE;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;YAC1D,UAAU,EAAE,WAAW,CAAC,UAAU,IAAI,KAAK;YAC3C,SAAS,EAAE,WAAW,CAAC,SAAS,IAAI,KAAK;YACzC,SAAS,EAAE,WAAW,CAAC,SAAS,IAAI,OAAO;YAC3C,OAAO;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG;QACV,eAAe,EAAE,IAAI,CAAC,CAAC,IAA6C,EAAE,EAAE;YACtE,MAAM,OAAO,GAAG;gBACd,KAAK,EAAE,CAAC,GAAiD,EAAE,EAAE;oBAC3D,GAAG,CAAC,KAAK,EAAE,CAAC;oBACZ,OAAO,EAAC,QAAQ,EAAE,gCAAgC,EAAC,CAAC;gBACtD,CAAC;aACF,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,EAAC,gCAAgC,EAAC,CAAC;QAC5C,CAAC,CAAC;KACH,CAAC;IACF,OAAO,EAAC,GAAG,EAAE,OAAO,EAAE,gCAAgC,EAAC,CAAC;AAC1D,CAAC,CAAC;AAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,WAAW,CAAC,kBAAkB,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QACrE,MAAM,WAAW,CAAC,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,WAAW,CAAC,kBAAkB,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QACrE,MAAM,WAAW,CAAC,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,EAAC,GAAG,EAAC,GAAG,QAAQ,CAAC,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAC,EAAC,CAAC,CAAC;QACvD,MAAM,EAAC,MAAM,EAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAC/B,sBAAsB,CAAC,GAAY,EAAE,EAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAC9E,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,EAAC,GAAG,EAAC,GAAG,QAAQ,CAAC,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAC,EAAC,CAAC,CAAC;QACvD,MAAM,EAAC,MAAM,EAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAC/B,sBAAsB,CAAC,GAAY,EAAE,EAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAC1F,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,EAAC,GAAG,EAAC,GAAG,QAAQ,CAAC;YACrB,KAAK,EAAE,IAAI,KAAK,CAAC,gBAAgB,CAAC;YAClC,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,MAAM,EAAC,MAAM,EAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAC/B,sBAAsB,CAAC,GAAY,EAAE,EAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAC9E,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,EAAC,GAAG,EAAC,GAAG,QAAQ,CAAC,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAC,EAAC,CAAC,CAAC;QACvD,MAAM,EAAC,MAAM,EAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAC/B,sBAAsB,CAAC,GAAY,EAAE,EAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAC1E,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;QAC9C,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,EAAC,GAAG,EAAE,OAAO,EAAC,GAAG,QAAQ,CAAC,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAC,EAAC,CAAC,CAAC;QACjE,MAAM,EAAC,MAAM,EAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAC/B,sBAAsB,CAAC,GAAY,EAAE;YACnC,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE;gBACN,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;oBACd,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACrB,CAAC;gBACD,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;oBACb,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACpB,CAAC;aACF;YACD,eAAe,EAAE,qBAAqB;YACtC,MAAM,EAAE,IAAI;SACb,CAAC,CACH,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,EAAC,GAAG,EAAC,GAAG,QAAQ,CAAC,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAC,EAAC,CAAC,CAAC;QACvD,MAAM,EAAC,MAAM,EAAC,GAAG,UAAU,CACzB,GAAG,EAAE,CAAC,sBAAsB,CAAC,GAAY,EAAE,EAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,EACnF;YACE,OAAO,EAAE,CAAC,EAAC,QAAQ,EAA8B,EAAE,EAAE,CACnD,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC;SAClD,CACF,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAC,EAAC,CAAC,CAAC;QACxD,MAAM,EAAC,MAAM,EAAE,QAAQ,EAAC,GAAG,UAAU,CACnC,CAAC,EAAC,IAAI,EAAmC,EAAE,EAAE;YAC3C,KAAK,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC/D,IAAI;gBACJ,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,KAAK;gBACjB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC,CAAC;YACJ,OAAO,sBAAsB,CAAC,KAAK,CAAC,GAAY,EAAE,EAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAAC;QAC7F,CAAC,EACD,EAAC,YAAY,EAAE,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAC,EAAC,EAAC,CAChD,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAC,EAAC,CAAC,CAAC;QACzC,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,2FAA2F;IAC3F,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;IAE7D,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,WAAW,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,WAAW,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,EAAC,GAAG,EAAC,GAAG,QAAQ,CAAC,EAAC,IAAI,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAC,EAAC,CAAC,CAAC;QACvD,MAAM,EAAC,OAAO,EAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAChC,sBAAsB,CAAC,GAAY,EAAE,EAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CACjF,CAAC;QACF,MAAM,OAAO,CACX,GAAG,EAAE;YACH,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CACpF,IAAI,CACL,CAAC;QACJ,CAAC,EACD,EAAC,OAAO,EAAE,IAAI,EAAC,CAChB,CAAC;QACF,OAAO,EAAE,CAAC;QACV,MAAM,OAAO,CACX,GAAG,EAAE;YACH,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CACpF,KAAK,CACN,CAAC;QACJ,CAAC,EACD,EAAC,OAAO,EAAE,IAAI,EAAC,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "dependencies": {
     "@better-auth/expo": "^1.2.8",
+    "@openfeature/core": "^1.11.0",
     "@react-native-async-storage/async-storage": "2.2.0",
     "@reduxjs/toolkit": "^2.11.1",
-    "@terreno/ui": "0.19.0",
+    "@terreno/ui": "0.20.0",
     "async-mutex": "^0.5.0",
     "axios": "^1.13.2",
     "axios-retry": "^4.5.0",
@@ -22,6 +23,8 @@
   "description": "Redux Toolkit Query utilities for @terreno/api backends",
   "devDependencies": {
     "@biomejs/biome": "^2.3.6",
+    "@openfeature/react-sdk": "^1.4.0",
+    "@openfeature/web-sdk": "^1.9.0",
     "@testing-library/react-native": "^13.2.0",
     "@types/bun": "^1.2.4",
     "@types/luxon": "^3.7.1",
@@ -50,6 +53,8 @@
   "main": "dist/index.js",
   "name": "@terreno/rtk",
   "peerDependencies": {
+    "@openfeature/react-sdk": "^1.4.0",
+    "@openfeature/web-sdk": "^1.9.0",
     "react": "19.1.0"
   },
   "publishConfig": {
@@ -67,5 +72,5 @@
     "test:coverage": "bun run ../scripts/check-coverage.ts"
   },
   "types": "dist/index.d.ts",
-  "version": "0.19.0"
+  "version": "0.20.0"
 }

package/src/index.ts

@@ -18,4 +18,5 @@ export * from "./useFeatureFlags";
 export * from "./useOfflineStatus";
 export * from "./useRealtimeDebug";
 export * from "./useServerStatus";
+export * from "./useTerrenoFeatureFlags";
 export * from "./useUpgradeCheck";

package/src/openFeatureReactSdkSpike.test.ts

@@ -0,0 +1,36 @@
+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}: {children: React.ReactNode}) =>
+        React.createElement(OpenFeatureProvider, {domain: SPIKE_DOMAIN}, children),
+    });
+    await waitFor(() => {
+      expect(result.current).toBe(true);
+    });
+  });
+});

package/src/useFeatureFlags.test.ts

@@ -1,19 +1,31 @@
 import {afterEach, beforeEach, describe, expect, it, mock} from "bun:test";
-import {renderHook} from "@testing-library/react-native";
+import {NOOP_PROVIDER, OpenFeature} from "@openfeature/web-sdk";
+import {renderHook, waitFor} from "@testing-library/react-native";
 
 import {resolveFeatureFlagsOptions, useFeatureFlags} from "./useFeatureFlags";
 
-type FlagValues = Record<string, boolean | string | null>;
+type TerrenoFlagConfiguration = Record<
+  string,
+  {
+    defaultVariant: string;
+    disabled: boolean;
+    variants: Record<string, boolean | string>;
+  }
+>;
+
 type QueryResult = {
-  data?: FlagValues;
+  data?: TerrenoFlagConfiguration;
   error?: unknown;
+  isFetching?: boolean;
   isLoading?: boolean;
+  isSuccess?: boolean;
 };
 
 describe("resolveFeatureFlagsOptions", () => {
   it("applies defaults when no argument is provided", () => {
     expect(resolveFeatureFlagsOptions()).toEqual({
       basePath: "/feature-flags",
+      domain: "feature-flags",
       skip: false,
     });
   });
@@ -21,6 +33,7 @@ describe("resolveFeatureFlagsOptions", () => {
   it("applies defaults when an empty options object is provided", () => {
     expect(resolveFeatureFlagsOptions({})).toEqual({
       basePath: "/feature-flags",
+      domain: "feature-flags",
       skip: false,
     });
   });
@@ -28,6 +41,7 @@ describe("resolveFeatureFlagsOptions", () => {
   it("treats a string argument as a legacy basePath with skip=false", () => {
     expect(resolveFeatureFlagsOptions("/custom-path")).toEqual({
       basePath: "/custom-path",
+      domain: "feature-flags",
       skip: false,
     });
   });
@@ -35,6 +49,7 @@ describe("resolveFeatureFlagsOptions", () => {
   it("preserves an empty string basePath when passed as a legacy string argument", () => {
     expect(resolveFeatureFlagsOptions("")).toEqual({
       basePath: "",
+      domain: "feature-flags",
       skip: false,
     });
   });
@@ -42,6 +57,7 @@ describe("resolveFeatureFlagsOptions", () => {
   it("uses options.basePath when provided", () => {
     expect(resolveFeatureFlagsOptions({basePath: "/flags"})).toEqual({
       basePath: "/flags",
+      domain: "feature-flags",
       skip: false,
     });
   });
@@ -49,6 +65,7 @@ describe("resolveFeatureFlagsOptions", () => {
   it("uses options.skip when provided", () => {
     expect(resolveFeatureFlagsOptions({skip: true})).toEqual({
       basePath: "/feature-flags",
+      domain: "feature-flags",
       skip: true,
     });
   });
@@ -56,6 +73,7 @@ describe("resolveFeatureFlagsOptions", () => {
   it("uses both options.basePath and options.skip when provided together", () => {
     expect(resolveFeatureFlagsOptions({basePath: "/flags", skip: true})).toEqual({
       basePath: "/flags",
+      domain: "feature-flags",
       skip: true,
     });
   });
@@ -65,69 +83,120 @@ describe("resolveFeatureFlagsOptions", () => {
   });
 });
 
+const boolDef = (variant: "on" | "off") => ({
+  defaultVariant: variant,
+  disabled: false,
+  variants: {off: false, on: true},
+});
+
 const buildApi = (queryResult: QueryResult) => {
   const refetch = mock(() => {});
   const capturedQueryBuilder: Array<{method: string; url: string}> = [];
-  const useEvaluateFeatureFlagsQuery = mock(() => ({
-    data: queryResult.data,
-    error: queryResult.error,
-    isLoading: queryResult.isLoading ?? false,
-    refetch,
-  }));
+  const useTerrenoFlagConfigurationQuery = mock(() => {
+    const hasData = Boolean(queryResult.data);
+    return {
+      data: queryResult.data,
+      error: queryResult.error,
+      isFetching: queryResult.isFetching ?? false,
+      isLoading: queryResult.isLoading ?? false,
+      isSuccess: queryResult.isSuccess ?? hasData,
+      refetch,
+    };
+  });
   const api = {
     injectEndpoints: mock((opts: {endpoints: (builder: unknown) => void}) => {
       const builder = {
         query: (def: {query: () => {method: string; url: string}}) => {
           capturedQueryBuilder.push(def.query());
-          return {useQuery: useEvaluateFeatureFlagsQuery};
+          return {useQuery: useTerrenoFlagConfigurationQuery};
         },
       };
       opts.endpoints(builder);
-      return {useEvaluateFeatureFlagsQuery};
+      return {useTerrenoFlagConfigurationQuery};
     }),
   };
-  return {api, capturedQueryBuilder, refetch, useEvaluateFeatureFlagsQuery};
+  return {api, capturedQueryBuilder, refetch, useTerrenoFlagConfigurationQuery};
 };
 
 describe("useFeatureFlags hook", () => {
   const debugCalls: unknown[][] = [];
   const originalDebug = console.debug;
 
-  beforeEach(() => {
+  beforeEach(async () => {
     debugCalls.length = 0;
     console.debug = (...args: unknown[]): void => {
       debugCalls.push(args);
     };
+    await OpenFeature.setProviderAndWait("feature-flags", NOOP_PROVIDER);
   });
 
-  afterEach(() => {
+  afterEach(async () => {
     console.debug = originalDebug;
+    await OpenFeature.setProviderAndWait("feature-flags", NOOP_PROVIDER);
   });
 
-  it("builds the evaluate endpoint with the default basePath", () => {
-    const {api, capturedQueryBuilder} = buildApi({data: {foo: true}});
-    renderHook(() => useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0]));
+  it("builds the flagConfiguration endpoint with the default basePath", () => {
+    const {api, capturedQueryBuilder} = buildApi({data: {foo: boolDef("on")}});
+    renderHook(() =>
+      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0], {
+        userId: "u1",
+      })
+    );
     expect(capturedQueryBuilder[0]).toEqual({
       method: "GET",
-      url: "/feature-flags/evaluate",
+      url: "/feature-flags/flagConfiguration",
     });
   });
 
-  it("builds the evaluate endpoint with a custom basePath from legacy string argument", () => {
-    const {api, capturedQueryBuilder} = buildApi({data: {foo: true}});
+  it("builds the flagConfiguration endpoint with a custom basePath from legacy string argument", () => {
+    const {api, capturedQueryBuilder} = buildApi({data: {foo: boolDef("on")}});
     renderHook(() =>
       useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0], "/flags")
     );
-    expect(capturedQueryBuilder[0]).toEqual({method: "GET", url: "/flags/evaluate"});
+    expect(capturedQueryBuilder[0]).toEqual({method: "GET", url: "/flags/flagConfiguration"});
   });
 
-  it("returns flag accessors that read boolean and string values", () => {
+  it("projects FlagConfiguration to flat flags like the legacy /evaluate map", async () => {
     const {api} = buildApi({
-      data: {booleanOff: false, booleanOn: true, variantFlag: "variant-a"},
+      data: {
+        b1: boolDef("on"),
+        v1: {
+          defaultVariant: "compact",
+          disabled: false,
+          variants: {compact: "compact", detailed: "detailed"},
+        },
+      },
     });
     const {result} = renderHook(() =>
-      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0])
+      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0], {userId: "u1"})
     );
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+    expect(result.current.flags).toEqual({
+      b1: true,
+      v1: "compact",
+    });
+  });
+
+  it("returns flag accessors that read boolean and string values", async () => {
+    const {api} = buildApi({
+      data: {
+        booleanOff: boolDef("off"),
+        booleanOn: boolDef("on"),
+        variantFlag: {
+          defaultVariant: "variant-a",
+          disabled: false,
+          variants: {compact: "compact", detailed: "detailed", "variant-a": "variant-a"},
+        },
+      },
+    });
+    const {result} = renderHook(() =>
+      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0], {userId: "u1"})
+    );
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
     expect(result.current.getFlag("booleanOn")).toBe(true);
     expect(result.current.getFlag("booleanOff")).toBe(false);
     expect(result.current.getFlag("variantFlag")).toBe(false);
@@ -137,98 +206,115 @@ describe("useFeatureFlags hook", () => {
   });
 
   it("returns an empty flags map when no data is available", () => {
-    const {api} = buildApi({isLoading: true});
+    const {api} = buildApi({isLoading: true, isSuccess: false});
     const {result} = renderHook(() =>
-      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0])
+      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0], {userId: "u1"})
     );
     expect(result.current.flags).toEqual({});
     expect(result.current.isLoading).toBe(true);
   });
 
-  it("exposes refetch from the underlying query hook", () => {
-    const {api, refetch} = buildApi({data: {foo: true}});
+  it("exposes refetch from the underlying query hook", async () => {
+    const {api, refetch} = buildApi({data: {foo: boolDef("on")}});
     const {result} = renderHook(() =>
-      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0])
+      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0], {userId: "u1"})
     );
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
     result.current.refetch();
     expect(refetch).toHaveBeenCalled();
   });
 
-  it("logs evaluate request started when loading begins without prior data", () => {
-    const {api} = buildApi({isLoading: true});
-    renderHook(() => useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0]));
+  it("logs flagConfiguration request started when loading begins without prior data", () => {
+    const {api} = buildApi({isLoading: true, isSuccess: false});
+    renderHook(() =>
+      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0], {userId: "u1"})
+    );
     const started = debugCalls.find(
-      (args) => args[0] === "[feature-flags] evaluate request started"
+      (args) => args[0] === "[feature-flags] flagConfiguration request started"
     );
     expect(started).toBeDefined();
   });
 
-  it("logs evaluate request completed when data resolves after a loading phase", () => {
-    const api = buildApi({isLoading: true});
+  it("logs flagConfiguration request completed when data resolves after a loading phase", async () => {
+    const api = buildApi({isLoading: true, isSuccess: false});
     const {rerender} = renderHook(
       ({queryResult}: {queryResult: QueryResult}) => {
-        api.useEvaluateFeatureFlagsQuery.mockImplementationOnce(() => ({
+        api.useTerrenoFlagConfigurationQuery.mockImplementationOnce(() => ({
           data: queryResult.data,
           error: queryResult.error,
+          isFetching: queryResult.isFetching ?? false,
           isLoading: queryResult.isLoading ?? false,
+          isSuccess: queryResult.isSuccess ?? Boolean(queryResult.data),
           refetch: api.refetch,
         }));
-        return useFeatureFlags(api.api as unknown as Parameters<typeof useFeatureFlags>[0]);
+        return useFeatureFlags(api.api as unknown as Parameters<typeof useFeatureFlags>[0], {
+          userId: "u1",
+        });
       },
-      {initialProps: {queryResult: {isLoading: true}}}
-    );
-    rerender({queryResult: {data: {alpha: true}, isLoading: false}});
-    const completed = debugCalls.find(
-      (args) => args[0] === "[feature-flags] evaluate request completed"
+      {initialProps: {queryResult: {isLoading: true, isSuccess: false}}}
     );
+    rerender({queryResult: {data: {alpha: boolDef("on")}, isLoading: false, isSuccess: true}});
+    await waitFor(() => {
+      const completed = debugCalls.find(
+        (args) => args[0] === "[feature-flags] flagConfiguration request completed"
+      );
+      expect(completed).toBeDefined();
+    });
     const started = debugCalls.find(
-      (args) => args[0] === "[feature-flags] evaluate request started"
+      (args) => args[0] === "[feature-flags] flagConfiguration request started"
     );
     expect(started).toBeDefined();
-    expect(completed).toBeDefined();
   });
 
-  it("injects the evaluate endpoint only once per (api, basePath)", () => {
+  it("injects the flagConfiguration endpoint only once per (api, basePath)", () => {
     let injectCallCount = 0;
     const refetch = mock(() => {});
-    const useEvaluateFeatureFlagsQuery = mock(() => ({
+    const useTerrenoFlagConfigurationQuery = mock(() => ({
       data: {},
       error: undefined,
+      isFetching: false,
       isLoading: false,
+      isSuccess: true,
       refetch,
     }));
     const api = {
       injectEndpoints: () => {
         injectCallCount += 1;
-        return {useEvaluateFeatureFlagsQuery};
+        return {useTerrenoFlagConfigurationQuery};
       },
     };
     const {rerender} = renderHook(() =>
-      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0])
+      useFeatureFlags(api as unknown as Parameters<typeof useFeatureFlags>[0], {userId: "u1"})
     );
     rerender(undefined);
     rerender(undefined);
-    // The hook reuses the cached enhanced api after the first render so the
-    // dev-mode RTK warning about re-injecting endpoints never fires.
     expect(injectCallCount).toBe(1);
   });
 
-  it("logs evaluate request failed when error is returned after loading", () => {
-    const api = buildApi({isLoading: true});
+  it("logs flagConfiguration request failed when error is returned after loading", () => {
+    const api = buildApi({isLoading: true, isSuccess: false});
     const {rerender} = renderHook(
       ({queryResult}: {queryResult: QueryResult}) => {
-        api.useEvaluateFeatureFlagsQuery.mockImplementationOnce(() => ({
+        api.useTerrenoFlagConfigurationQuery.mockImplementationOnce(() => ({
           data: queryResult.data,
           error: queryResult.error,
+          isFetching: queryResult.isFetching ?? false,
           isLoading: queryResult.isLoading ?? false,
+          isSuccess: queryResult.isSuccess ?? false,
           refetch: api.refetch,
         }));
-        return useFeatureFlags(api.api as unknown as Parameters<typeof useFeatureFlags>[0]);
+        return useFeatureFlags(api.api as unknown as Parameters<typeof useFeatureFlags>[0], {
+          userId: "u1",
+        });
       },
-      {initialProps: {queryResult: {isLoading: true}}}
+      {initialProps: {queryResult: {isLoading: true, isSuccess: false}}}
+    );
+    rerender({queryResult: {error: new Error("boom"), isLoading: false, isSuccess: false}});
+    const failed = debugCalls.find(
+      (args) => args[0] === "[feature-flags] flagConfiguration request failed"
     );
-    rerender({queryResult: {error: new Error("boom"), isLoading: false}});
-    const failed = debugCalls.find((args) => args[0] === "[feature-flags] evaluate request failed");
     expect(failed).toBeDefined();
   });
 });