@terreno/rtk 0.18.0 → 0.20.0

package/dist/useTerrenoFeatureFlags.js

@@ -0,0 +1,157 @@
+import { NOOP_PROVIDER, OpenFeature, TypedInMemoryProvider } from "@openfeature/web-sdk";
+import { useCallback, useEffect, useMemo, useState } from "react";
+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) => ({
+            terrenoFlagConfiguration: builder.query({
+                providesTags: (_result, _err, arg) => [{ id: arg.cacheKey, type: "feature-flags" }],
+                query: () => ({
+                    method: "GET",
+                    url: `${basePath}/flagConfiguration`,
+                }),
+            }),
+        }),
+        overrideExisting: false,
+    });
+    byBase.set(basePath, enhanced);
+    return enhanced;
+};
+/** In-flight `useTerrenoFeatureFlags` instances per OpenFeature domain (for last-unmount NOOP cleanup). */
+const terrenoOpenFeatureHookRefCounts = new Map();
+/** Last in-flight `setProviderAndWait` per OpenFeature domain (shared across hook instances). */
+const domainProviderSwitchPromises = new Map();
+/**
+ * Wires Terreno's bulk `/flagConfiguration` fetch into OpenFeature's
+ * {@link TypedInMemoryProvider} for the given domain. Prefer OpenFeature React
+ * hooks (`useBooleanFlagValue`, etc.) as children of `<OpenFeatureProvider>`.
+ */
+export const useTerrenoFeatureFlags = (api, options) => {
+    const basePath = options?.basePath ?? "/feature-flags";
+    const domain = options?.domain ?? "feature-flags";
+    const userId = options?.userId ?? null;
+    const skip = options?.skip === true;
+    const socket = options?.socket ?? null;
+    const socketEventName = options?.socketEventName ?? "featureFlagsChanged";
+    const enhancedApi = useMemo(() => getEnhancedApi(api, basePath), [api, basePath]);
+    const useTerrenoFlagConfigurationQuery = enhancedApi.useTerrenoFlagConfigurationQuery;
+    const { data, error, isError, isFetching, isLoading: isQueryLoading, isSuccess, refetch, } = useTerrenoFlagConfigurationQuery({ cacheKey: userId ?? "" }, { skip });
+    const [providerReady, setProviderReady] = useState(skip);
+    const client = useMemo(() => OpenFeature.getClient(domain), [domain]);
+    useEffect(() => {
+        const prev = terrenoOpenFeatureHookRefCounts.get(domain) ?? 0;
+        terrenoOpenFeatureHookRefCounts.set(domain, prev + 1);
+        return () => {
+            const current = terrenoOpenFeatureHookRefCounts.get(domain) ?? 0;
+            const next = current - 1;
+            if (next <= 0) {
+                terrenoOpenFeatureHookRefCounts.delete(domain);
+                void (async () => {
+                    const pending = domainProviderSwitchPromises.get(domain);
+                    if (pending) {
+                        await pending;
+                    }
+                    await OpenFeature.setProviderAndWait(domain, NOOP_PROVIDER);
+                })();
+            }
+            else {
+                terrenoOpenFeatureHookRefCounts.set(domain, next);
+            }
+        };
+    }, [domain]);
+    useEffect(() => {
+        if (skip) {
+            return;
+        }
+        void OpenFeature.setContext(domain, { targetingKey: userId ?? "" });
+    }, [domain, skip, userId]);
+    useEffect(() => {
+        if (skip) {
+            setProviderReady(true);
+            return;
+        }
+        setProviderReady(false);
+    }, [skip, userId]);
+    useEffect(() => {
+        if (skip || !isSuccess || !data) {
+            return;
+        }
+        let cancelled = false;
+        const applyProvider = async () => {
+            const pending = domainProviderSwitchPromises.get(domain);
+            const run = (async () => {
+                if (pending) {
+                    await pending;
+                }
+                await OpenFeature.setProviderAndWait(domain, new TypedInMemoryProvider(data));
+            })();
+            domainProviderSwitchPromises.set(domain, run);
+            try {
+                await run;
+            }
+            finally {
+                if (domainProviderSwitchPromises.get(domain) === run) {
+                    domainProviderSwitchPromises.delete(domain);
+                }
+            }
+            if (!cancelled) {
+                setProviderReady(true);
+            }
+        };
+        void applyProvider();
+        return () => {
+            cancelled = true;
+        };
+    }, [data, domain, isSuccess, skip]);
+    useEffect(() => {
+        if (!socket) {
+            return;
+        }
+        const handler = () => {
+            void refetch();
+        };
+        socket.on(socketEventName, handler);
+        return () => {
+            socket.off(socketEventName, handler);
+        };
+    }, [refetch, socket, socketEventName]);
+    const flags = data ?? {};
+    const isLoading = useMemo(() => {
+        if (skip) {
+            return false;
+        }
+        if (isError) {
+            return false;
+        }
+        if (!isSuccess || !data) {
+            return true;
+        }
+        if (isQueryLoading || isFetching) {
+            return true;
+        }
+        if (!providerReady) {
+            return true;
+        }
+        return false;
+    }, [data, isError, isFetching, isQueryLoading, isSuccess, providerReady, skip]);
+    const stableRefetch = useCallback(() => {
+        return refetch();
+    }, [refetch]);
+    return {
+        client,
+        error,
+        flags,
+        isLoading,
+        refetch: stableRefetch,
+    };
+};
+//# sourceMappingURL=useTerrenoFeatureFlags.js.map

package/dist/useTerrenoFeatureFlags.js.map

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

package/dist/useTerrenoFeatureFlags.test.d.ts

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

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

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

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":"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"}

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.18.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.18.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/isolated/constants.isolated.ts

@@ -63,4 +63,30 @@ describe("AUTH_DEBUG enabled path", () => {
       mock.module("expo-constants", () => ({default: {expoConfig: {extra: {}}}}));
     }
   });
+
+  it("emits AUTH_DEBUG enabled and WEBSOCKETS_DEBUG enabled messages on module load", async () => {
+    const debugCalls: unknown[][] = [];
+    const originalDebug = console.debug;
+    console.debug = (...args: unknown[]): void => {
+      debugCalls.push(args);
+    };
+    mock.module("expo-constants", () => ({
+      default: {expoConfig: {extra: {AUTH_DEBUG: "true", WEBSOCKETS_DEBUG: "true"}}},
+    }));
+    try {
+      const testId = `${Date.now()}-${Math.random()}`;
+      await import(`../constants?debug=${testId}`);
+      const authMsg = debugCalls.find((args) =>
+        args.some((v) => typeof v === "string" && v.includes("AUTH_DEBUG is enabled"))
+      );
+      const wsMsg = debugCalls.find((args) =>
+        args.some((v) => typeof v === "string" && v.includes("WEBSOCKETS_DEBUG is enabled"))
+      );
+      expect(authMsg).toBeDefined();
+      expect(wsMsg).toBeDefined();
+    } finally {
+      console.debug = originalDebug;
+      mock.module("expo-constants", () => ({default: {expoConfig: {extra: {}}}}));
+    }
+  });
 });

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);
+    });
+  });
+});