@terreno/rtk 0.9.3 → 0.11.0

package/dist/useFeatureFlags.test.js

@@ -0,0 +1,162 @@
+import { afterEach, beforeEach, describe, expect, it, mock } from "bun:test";
+import { renderHook } from "@testing-library/react-native";
+import { resolveFeatureFlagsOptions, useFeatureFlags } from "./useFeatureFlags";
+describe("resolveFeatureFlagsOptions", () => {
+    it("applies defaults when no argument is provided", () => {
+        expect(resolveFeatureFlagsOptions()).toEqual({
+            basePath: "/feature-flags",
+            skip: false,
+        });
+    });
+    it("applies defaults when an empty options object is provided", () => {
+        expect(resolveFeatureFlagsOptions({})).toEqual({
+            basePath: "/feature-flags",
+            skip: false,
+        });
+    });
+    it("treats a string argument as a legacy basePath with skip=false", () => {
+        expect(resolveFeatureFlagsOptions("/custom-path")).toEqual({
+            basePath: "/custom-path",
+            skip: false,
+        });
+    });
+    it("preserves an empty string basePath when passed as a legacy string argument", () => {
+        expect(resolveFeatureFlagsOptions("")).toEqual({
+            basePath: "",
+            skip: false,
+        });
+    });
+    it("uses options.basePath when provided", () => {
+        expect(resolveFeatureFlagsOptions({ basePath: "/flags" })).toEqual({
+            basePath: "/flags",
+            skip: false,
+        });
+    });
+    it("uses options.skip when provided", () => {
+        expect(resolveFeatureFlagsOptions({ skip: true })).toEqual({
+            basePath: "/feature-flags",
+            skip: true,
+        });
+    });
+    it("uses both options.basePath and options.skip when provided together", () => {
+        expect(resolveFeatureFlagsOptions({ basePath: "/flags", skip: true })).toEqual({
+            basePath: "/flags",
+            skip: true,
+        });
+    });
+    it("does not let a legacy string basePath override skip to true", () => {
+        expect(resolveFeatureFlagsOptions("/custom-path").skip).toBe(false);
+    });
+});
+const buildApi = (queryResult) => {
+    const refetch = mock(() => { });
+    const capturedQueryBuilder = [];
+    const useEvaluateFeatureFlagsQuery = mock(() => ({
+        data: queryResult.data,
+        error: queryResult.error,
+        isLoading: queryResult.isLoading ?? false,
+        refetch,
+    }));
+    const api = {
+        injectEndpoints: mock((opts) => {
+            const builder = {
+                query: (def) => {
+                    capturedQueryBuilder.push(def.query());
+                    return { useQuery: useEvaluateFeatureFlagsQuery };
+                },
+            };
+            opts.endpoints(builder);
+            return { useEvaluateFeatureFlagsQuery };
+        }),
+    };
+    return { api, capturedQueryBuilder, refetch, useEvaluateFeatureFlagsQuery };
+};
+describe("useFeatureFlags hook", () => {
+    const debugCalls = [];
+    const originalDebug = console.debug;
+    beforeEach(() => {
+        debugCalls.length = 0;
+        console.debug = (...args) => {
+            debugCalls.push(args);
+        };
+    });
+    afterEach(() => {
+        console.debug = originalDebug;
+    });
+    it("builds the evaluate endpoint with the default basePath", () => {
+        const { api, capturedQueryBuilder } = buildApi({ data: { foo: true } });
+        renderHook(() => useFeatureFlags(api));
+        expect(capturedQueryBuilder[0]).toEqual({
+            method: "GET",
+            url: "/feature-flags/evaluate",
+        });
+    });
+    it("builds the evaluate endpoint with a custom basePath from legacy string argument", () => {
+        const { api, capturedQueryBuilder } = buildApi({ data: { foo: true } });
+        renderHook(() => useFeatureFlags(api, "/flags"));
+        expect(capturedQueryBuilder[0]).toEqual({ method: "GET", url: "/flags/evaluate" });
+    });
+    it("returns flag accessors that read boolean and string values", () => {
+        const { api } = buildApi({
+            data: { booleanOff: false, booleanOn: true, variantFlag: "variant-a" },
+        });
+        const { result } = renderHook(() => useFeatureFlags(api));
+        expect(result.current.getFlag("booleanOn")).toBe(true);
+        expect(result.current.getFlag("booleanOff")).toBe(false);
+        expect(result.current.getFlag("variantFlag")).toBe(false);
+        expect(result.current.getVariant("variantFlag")).toBe("variant-a");
+        expect(result.current.getVariant("booleanOn")).toBeNull();
+        expect(result.current.getVariant("missing")).toBeNull();
+    });
+    it("returns an empty flags map when no data is available", () => {
+        const { api } = buildApi({ isLoading: true });
+        const { result } = renderHook(() => useFeatureFlags(api));
+        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 } });
+        const { result } = renderHook(() => useFeatureFlags(api));
+        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));
+        const started = debugCalls.find((args) => args[0] === "[feature-flags] evaluate request started");
+        expect(started).toBeDefined();
+    });
+    it("logs evaluate request completed when data resolves after a loading phase", () => {
+        const api = buildApi({ isLoading: true });
+        const { rerender } = renderHook(({ queryResult }) => {
+            api.useEvaluateFeatureFlagsQuery.mockImplementationOnce(() => ({
+                data: queryResult.data,
+                error: queryResult.error,
+                isLoading: queryResult.isLoading ?? false,
+                refetch: api.refetch,
+            }));
+            return useFeatureFlags(api.api);
+        }, { initialProps: { queryResult: { isLoading: true } } });
+        rerender({ queryResult: { data: { alpha: true }, isLoading: false } });
+        const completed = debugCalls.find((args) => args[0] === "[feature-flags] evaluate request completed");
+        const started = debugCalls.find((args) => args[0] === "[feature-flags] evaluate request started");
+        expect(started).toBeDefined();
+        expect(completed).toBeDefined();
+    });
+    it("logs evaluate request failed when error is returned after loading", () => {
+        const api = buildApi({ isLoading: true });
+        const { rerender } = renderHook(({ queryResult }) => {
+            api.useEvaluateFeatureFlagsQuery.mockImplementationOnce(() => ({
+                data: queryResult.data,
+                error: queryResult.error,
+                isLoading: queryResult.isLoading ?? false,
+                refetch: api.refetch,
+            }));
+            return useFeatureFlags(api.api);
+        }, { initialProps: { queryResult: { isLoading: true } } });
+        rerender({ queryResult: { error: new Error("boom"), isLoading: false } });
+        const failed = debugCalls.find((args) => args[0] === "[feature-flags] evaluate request failed");
+        expect(failed).toBeDefined();
+    });
+});
+//# sourceMappingURL=useFeatureFlags.test.js.map

package/dist/useFeatureFlags.test.js.map

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

package/package.json

@@ -3,7 +3,7 @@
     "@better-auth/expo": "^1.2.8",
     "@react-native-async-storage/async-storage": "2.2.0",
     "@reduxjs/toolkit": "^2.11.1",
-    "@terreno/ui": "0.9.3",
+    "@terreno/ui": "0.11.0",
     "async-mutex": "^0.5.0",
     "axios": "^1.13.2",
     "axios-retry": "^4.5.0",
@@ -22,12 +22,14 @@
   "description": "Redux Toolkit Query utilities for @terreno/api backends",
   "devDependencies": {
     "@biomejs/biome": "^2.3.6",
+    "@testing-library/react-native": "^13.2.0",
     "@types/bun": "^1.2.4",
     "@types/luxon": "^3.7.1",
     "@types/node": "^25.0.3",
     "@types/qs": "^6.14.0",
     "@types/react": "~19.1.10",
     "react": "19.1.0",
+    "react-test-renderer": "19.1.0",
     "typescript": "~5.9.2"
   },
   "exports": {
@@ -61,8 +63,9 @@
     "lint:fix": "biome check --write .",
     "lint:unsafefix": "biome check --write --unsafe .",
     "test": "bun test",
-    "test:ci": "bun test"
+    "test:ci": "bun test",
+    "test:coverage": "bun run ../scripts/check-coverage.ts"
   },
   "types": "dist/index.d.ts",
-  "version": "0.9.3"
+  "version": "0.11.0"
 }

package/src/authSlice.test.ts

@@ -1,12 +1,18 @@
 import {beforeEach, describe, expect, it} from "bun:test";
+import AsyncStorage from "@react-native-async-storage/async-storage";
 import {configureStore} from "@reduxjs/toolkit";
 import {createApi, fetchBaseQuery} from "@reduxjs/toolkit/query/react";
 
 import {
   type EmailLoginRequest,
   generateAuthSlice,
+  generateProfileEndpoints,
+  getAuthToken,
   selectCurrentUserId,
   selectIsAuthenticating,
+  selectLastTokenRefreshTimestamp,
+  useSelectCurrentUserId,
+  useSelectIsAuthenticating,
 } from "./authSlice";
 
 // Create a real RTK Query API with the endpoints that generateAuthSlice expects
@@ -49,6 +55,11 @@ const createTestStore = () => {
   };
 };
 
+const flushAsyncListeners = async (): Promise<void> => {
+  await Promise.resolve();
+  await new Promise((resolve) => setTimeout(resolve, 0));
+};
+
 describe("generateAuthSlice", () => {
   let store: ReturnType<typeof createTestStore>["store"];
   let authSlice: ReturnType<typeof createTestStore>["authSlice"];
@@ -289,6 +300,12 @@ describe("selectors", () => {
     // biome-ignore lint/suspicious/noExplicitAny: Test mock state
     expect(selectIsAuthenticating({} as any)).toBe(false);
   });
+
+  it("selectLastTokenRefreshTimestamp returns timestamp", () => {
+    // biome-ignore lint/suspicious/noExplicitAny: Test mock state
+    const state = {auth: {lastTokenRefreshTimestamp: 12345}} as any;
+    expect(selectLastTokenRefreshTimestamp(state)).toBe(12345);
+  });
 });
 
 describe("EmailLoginRequest type", () => {
@@ -304,3 +321,284 @@ describe("EmailLoginRequest type", () => {
     expect(request.password).toBe("pass");
   });
 });
+
+describe("generateProfileEndpoints", () => {
+  it("builds endpoint query payloads", () => {
+    const builder = {
+      // biome-ignore lint/suspicious/noExplicitAny: Testing generated endpoint configs
+      mutation: (config: any) => config,
+    };
+    // biome-ignore lint/suspicious/noExplicitAny: Lightweight fake builder for unit test
+    const endpoints = generateProfileEndpoints(builder as any, "todos");
+    const createEmailUserQuery = endpoints.createEmailUser.query;
+    const emailLoginQuery = endpoints.emailLogin.query;
+    const emailSignUpQuery = endpoints.emailSignUp.query;
+    const googleLoginQuery = endpoints.googleLogin.query;
+    const resetPasswordQuery = endpoints.resetPassword.query;
+
+    expect(createEmailUserQuery).toBeDefined();
+    expect(emailLoginQuery).toBeDefined();
+    expect(emailSignUpQuery).toBeDefined();
+    expect(googleLoginQuery).toBeDefined();
+    expect(resetPasswordQuery).toBeDefined();
+
+    if (
+      !createEmailUserQuery ||
+      !emailLoginQuery ||
+      !emailSignUpQuery ||
+      !googleLoginQuery ||
+      !resetPasswordQuery
+    ) {
+      throw new Error("Expected all generated profile endpoint queries to be defined");
+    }
+
+    expect(endpoints.createEmailUser.invalidatesTags).toEqual(["todos", "conversations"]);
+    expect(
+      createEmailUserQuery({
+        email: "new@example.com",
+        password: "secret",
+        role: "admin",
+      })
+    ).toEqual({
+      body: {email: "new@example.com", password: "secret", role: "admin"},
+      method: "POST",
+      url: "auth/signup",
+    });
+
+    expect(endpoints.emailLogin.extraOptions).toEqual({maxRetries: 0});
+    expect(emailLoginQuery({email: "a@example.com", password: "pw"})).toEqual({
+      body: {email: "a@example.com", password: "pw", username: undefined},
+      method: "POST",
+      url: "auth/login",
+    });
+
+    expect(
+      emailSignUpQuery({
+        email: "signup@example.com",
+        name: "New User",
+        password: "pw",
+      })
+    ).toEqual({
+      body: {email: "signup@example.com", name: "New User", password: "pw"},
+      method: "POST",
+      url: "auth/signup",
+    });
+
+    expect(googleLoginQuery({idToken: "id-token"})).toEqual({
+      body: {idToken: "id-token"},
+      method: "POST",
+      url: "/auth/google",
+    });
+
+    expect(
+      resetPasswordQuery({
+        _id: "u-1",
+        email: "user@example.com",
+        newPassword: "new-secret",
+        oldPassword: "old-secret",
+        password: "current-secret",
+      })
+    ).toEqual({
+      body: {
+        _id: "u-1",
+        email: "user@example.com",
+        newPassword: "new-secret",
+        oldPassword: "old-secret",
+        password: "current-secret",
+      },
+      method: "POST",
+      url: "/resetPassword",
+    });
+  });
+});
+
+describe("listener middleware side effects", () => {
+  it("stores tokens in AsyncStorage on web login when window exists", async () => {
+    const {store} = createTestStore();
+    const setItemCalls: Array<[string, string]> = [];
+    const originalSetItem = AsyncStorage.setItem;
+    const globalWithWindow = globalThis as {window?: unknown};
+    const originalWindow = globalWithWindow.window;
+
+    AsyncStorage.setItem = async (key: string, value: string): Promise<void> => {
+      setItemCalls.push([key, value]);
+    };
+    globalWithWindow.window = {};
+
+    try {
+      store.dispatch({
+        meta: {arg: {endpointName: "emailLogin", type: "mutation"}, requestId: "listener-login-1"},
+        payload: {refreshToken: "refresh-token", token: "auth-token", userId: "user-123"},
+        type: "terreno-rtk/executeMutation/fulfilled",
+      });
+
+      await flushAsyncListeners();
+
+      expect(setItemCalls).toEqual([
+        ["AUTH_TOKEN", "auth-token"],
+        ["REFRESH_TOKEN", "refresh-token"],
+      ]);
+      expect(store.getState().auth.userId).toBe("user-123");
+    } finally {
+      AsyncStorage.setItem = originalSetItem;
+      if (typeof originalWindow === "undefined") {
+        delete globalWithWindow.window;
+      } else {
+        globalWithWindow.window = originalWindow;
+      }
+    }
+  });
+
+  it("re-throws and logs when AsyncStorage.setItem fails on web login", async () => {
+    const {store} = createTestStore();
+    const originalSetItem = AsyncStorage.setItem;
+    const originalConsoleError = console.error;
+    const globalWithWindow = globalThis as {window?: unknown};
+    const originalWindow = globalWithWindow.window;
+    const errorCalls: unknown[][] = [];
+
+    console.error = (...args: unknown[]): void => {
+      errorCalls.push(args);
+    };
+    AsyncStorage.setItem = async (): Promise<void> => {
+      throw new Error("storage quota exceeded");
+    };
+    globalWithWindow.window = {};
+
+    try {
+      store.dispatch({
+        meta: {
+          arg: {endpointName: "emailLogin", type: "mutation"},
+          requestId: "listener-login-error",
+        },
+        payload: {refreshToken: "refresh-token", token: "auth-token", userId: "user-err"},
+        type: "terreno-rtk/executeMutation/fulfilled",
+      });
+
+      await flushAsyncListeners();
+
+      const loggedErrorMessage = errorCalls.find((args) =>
+        args.some(
+          (value) => typeof value === "string" && value.includes("Error setting auth token")
+        )
+      );
+      expect(loggedErrorMessage).toBeDefined();
+    } finally {
+      AsyncStorage.setItem = originalSetItem;
+      console.error = originalConsoleError;
+      if (typeof originalWindow === "undefined") {
+        delete globalWithWindow.window;
+      } else {
+        globalWithWindow.window = originalWindow;
+      }
+    }
+  });
+
+  it("skips storing auth tokens when window is undefined (SSR context)", async () => {
+    const {store} = createTestStore();
+    const setItemCalls: Array<[string, string]> = [];
+    const originalSetItem = AsyncStorage.setItem;
+    const globalWithWindow = globalThis as {window?: unknown};
+    const originalWindow = globalWithWindow.window;
+
+    AsyncStorage.setItem = async (key: string, value: string): Promise<void> => {
+      setItemCalls.push([key, value]);
+    };
+    delete globalWithWindow.window;
+
+    try {
+      store.dispatch({
+        meta: {
+          arg: {endpointName: "emailSignUp", type: "mutation"},
+          requestId: "listener-ssr-1",
+        },
+        payload: {refreshToken: "r", token: "t", userId: "user-ssr"},
+        type: "terreno-rtk/executeMutation/fulfilled",
+      });
+
+      await flushAsyncListeners();
+
+      expect(setItemCalls).toEqual([]);
+      expect(store.getState().auth.userId).toBe("user-ssr");
+    } finally {
+      AsyncStorage.setItem = originalSetItem;
+      if (typeof originalWindow !== "undefined") {
+        globalWithWindow.window = originalWindow;
+      }
+    }
+  });
+
+  it("removes tokens from AsyncStorage on web logout when window exists", async () => {
+    const {store, authSlice} = createTestStore();
+    const removeItemCalls: string[] = [];
+    const originalRemoveItem = AsyncStorage.removeItem;
+    const globalWithWindow = globalThis as {window?: unknown};
+    const originalWindow = globalWithWindow.window;
+
+    AsyncStorage.removeItem = async (key: string): Promise<void> => {
+      removeItemCalls.push(key);
+    };
+    globalWithWindow.window = {};
+
+    try {
+      store.dispatch(authSlice.actions.logout());
+      await flushAsyncListeners();
+
+      expect(removeItemCalls).toEqual(["AUTH_TOKEN", "REFRESH_TOKEN"]);
+    } finally {
+      AsyncStorage.removeItem = originalRemoveItem;
+      if (typeof originalWindow === "undefined") {
+        delete globalWithWindow.window;
+      } else {
+        globalWithWindow.window = originalWindow;
+      }
+    }
+  });
+});
+
+describe("hook wrappers", () => {
+  it("throws when hook selectors are called outside React render", () => {
+    expect(() => useSelectCurrentUserId()).toThrow();
+    expect(() => useSelectIsAuthenticating()).toThrow();
+  });
+});
+
+describe("getAuthToken", () => {
+  it("reads AUTH_TOKEN from AsyncStorage when window exists", async () => {
+    const originalGetItem = AsyncStorage.getItem;
+    const globalWithWindow = globalThis as {window?: unknown};
+    const originalWindow = globalWithWindow.window;
+
+    AsyncStorage.getItem = async (key: string): Promise<string | null> => {
+      return key === "AUTH_TOKEN" ? "stored-auth-token" : null;
+    };
+    globalWithWindow.window = {};
+
+    try {
+      const token = await getAuthToken();
+      expect(token).toBe("stored-auth-token");
+    } finally {
+      AsyncStorage.getItem = originalGetItem;
+      if (typeof originalWindow === "undefined") {
+        delete globalWithWindow.window;
+      } else {
+        globalWithWindow.window = originalWindow;
+      }
+    }
+  });
+
+  it("returns null when window is unavailable in SSR context", async () => {
+    const globalWithWindow = globalThis as {window?: unknown};
+    const originalWindow = globalWithWindow.window;
+
+    delete globalWithWindow.window;
+    try {
+      const token = await getAuthToken();
+      expect(token).toBeNull();
+    } finally {
+      if (typeof originalWindow !== "undefined") {
+        globalWithWindow.window = originalWindow;
+      }
+    }
+  });
+});