@terreno/rtk 0.24.0 → 0.25.0

package/dist/useUpgradeCheck.test.js

@@ -0,0 +1,174 @@
+import { afterEach, beforeEach, describe, expect, it, mock } from "bun:test";
+import { configureStore } from "@reduxjs/toolkit";
+import { act, renderHook } from "@testing-library/react-native";
+import Constants from "expo-constants";
+import React from "react";
+import { Provider } from "react-redux";
+// Capture the AppState "change" handler so tests can simulate foreground transitions.
+let appStateChangeHandler;
+const appStateMock = {
+    addEventListener: (_event, handler) => {
+        appStateChangeHandler = handler;
+        return { remove: () => { } };
+    },
+    currentState: "active",
+};
+// Keep this react-native mock a superset of the preload's mock so other test
+// files still resolve AppState / Linking / Platform after this file runs.
+mock.module("react-native", () => ({
+    AppState: appStateMock,
+    Linking: { openURL: async () => true },
+    Platform: { OS: "web" },
+    StyleSheet: { create: (s) => s },
+}));
+// Force IsWeb=true regardless of load order with the native test files.
+mock.module("./platform", () => ({ IsWeb: true }));
+const { emptySplitApi } = await import("./emptyApi");
+const { useUpgradeCheck } = await import("./useUpgradeCheck");
+const constantsWithExtra = Constants;
+const createTestStore = () => configureStore({
+    middleware: (getDefaultMiddleware) => getDefaultMiddleware().concat(emptySplitApi.middleware),
+    reducer: { [emptySplitApi.reducerPath]: emptySplitApi.reducer },
+});
+const createWrapper = (store) => {
+    const Wrapper = ({ children }) => React.createElement(Provider, { children, store });
+    return Wrapper;
+};
+const mockFetchWith = (payload) => {
+    const fetchFn = mock(async () => new Response(JSON.stringify(payload), {
+        headers: { "content-type": "application/json" },
+        status: 200,
+    }));
+    globalThis.fetch = fetchFn;
+    return fetchFn;
+};
+const flush = async (ms = 60) => {
+    await act(async () => {
+        await new Promise((resolve) => setTimeout(resolve, ms));
+    });
+};
+describe("useUpgradeCheck (web)", () => {
+    let originalFetch;
+    let originalWindow;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+        originalWindow = globalThis.window;
+        appStateChangeHandler = undefined;
+        appStateMock.currentState = "active";
+        constantsWithExtra.expoConfig.extra.buildNumber = 100;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        globalThis.window = originalWindow;
+        delete constantsWithExtra.expoConfig.extra.buildNumber;
+        emptySplitApi.util.resetApiState();
+    });
+    it("does not call the backend when the build number is unavailable", async () => {
+        delete constantsWithExtra.expoConfig.extra.buildNumber;
+        const fetchFn = mockFetchWith({ status: "ok" });
+        const { result, unmount } = renderHook(() => useUpgradeCheck(), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush();
+        expect(fetchFn).not.toHaveBeenCalled();
+        expect(result.current.isRequired).toBe(false);
+        expect(result.current.isWarning).toBe(false);
+        unmount();
+    });
+    it("flags a required upgrade and adopts the server polling interval", async () => {
+        const fetchFn = mockFetchWith({
+            message: "Please update",
+            pollingIntervalMs: 999999,
+            status: "required",
+            updateUrl: "https://example.com/update",
+        });
+        const { result, unmount } = renderHook(() => useUpgradeCheck(), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush();
+        expect(fetchFn).toHaveBeenCalled();
+        expect(result.current.isRequired).toBe(true);
+        expect(result.current.requiredMessage).toBe("Please update");
+        expect(result.current.isWarning).toBe(false);
+        // On web the app can always self-update via reload.
+        expect(result.current.canUpdate).toBe(true);
+        unmount();
+    });
+    it("flags a warning upgrade and increments the warning check count", async () => {
+        const fetchFn = mockFetchWith({ message: "Update soon", status: "warning" });
+        const { result, unmount } = renderHook(() => useUpgradeCheck(), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush();
+        expect(fetchFn).toHaveBeenCalled();
+        expect(result.current.isWarning).toBe(true);
+        expect(result.current.warningMessage).toBe("Update soon");
+        expect(result.current.warningCheckCount).toBe(1);
+        expect(result.current.isRequired).toBe(false);
+        unmount();
+    });
+    it("clears upgrade state for an ok status", async () => {
+        mockFetchWith({ status: "ok" });
+        const { result, unmount } = renderHook(() => useUpgradeCheck(), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush();
+        expect(result.current.isRequired).toBe(false);
+        expect(result.current.isWarning).toBe(false);
+        unmount();
+    });
+    it("swallows version-check failures and stays in the default state", async () => {
+        const fetchFn = mock(async () => {
+            throw new Error("network down");
+        });
+        globalThis.fetch = fetchFn;
+        const { result, unmount } = renderHook(() => useUpgradeCheck(), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        // Wait long enough for RTK Query's retry backoff to exhaust and reject.
+        await flush(7000);
+        expect(result.current.isRequired).toBe(false);
+        expect(result.current.isWarning).toBe(false);
+        unmount();
+    }, 20000);
+    it("reloads the page on web when onUpdate is invoked", async () => {
+        mockFetchWith({ status: "required", updateUrl: "https://example.com/update" });
+        const reload = mock(() => { });
+        globalThis.window = { location: { reload } };
+        const { result, unmount } = renderHook(() => useUpgradeCheck(), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush();
+        act(() => {
+            result.current.onUpdate();
+        });
+        expect(reload).toHaveBeenCalledTimes(1);
+        unmount();
+    });
+    it("polls repeatedly using the fallback interval", async () => {
+        const fetchFn = mockFetchWith({ status: "ok" });
+        const { unmount } = renderHook(() => useUpgradeCheck({ pollingIntervalMs: 20 }), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush(120);
+        expect(fetchFn.mock.calls.length).toBeGreaterThan(1);
+        unmount();
+    });
+    it("re-checks when the app returns to the foreground", async () => {
+        const fetchFn = mockFetchWith({ status: "ok" });
+        const { unmount } = renderHook(() => useUpgradeCheck({ recheckOnForeground: true }), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush();
+        const initialCalls = fetchFn.mock.calls.length;
+        expect(appStateChangeHandler).toBeDefined();
+        await act(async () => {
+            appStateChangeHandler?.("background");
+            appStateChangeHandler?.("active");
+            await new Promise((resolve) => setTimeout(resolve, 30));
+        });
+        expect(fetchFn.mock.calls.length).toBeGreaterThan(initialCalls);
+        unmount();
+    });
+});
+//# sourceMappingURL=useUpgradeCheck.test.js.map

package/dist/useUpgradeCheck.test.js.map

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

package/dist/useUpgradeCheckNative.test.d.ts

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

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

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

package/dist/useUpgradeCheckNative.test.js

@@ -0,0 +1,90 @@
+import { afterEach, beforeEach, describe, expect, it, mock } from "bun:test";
+import { configureStore } from "@reduxjs/toolkit";
+import { act, renderHook } from "@testing-library/react-native";
+import Constants from "expo-constants";
+import React from "react";
+import { Provider } from "react-redux";
+const openedUrls = [];
+// Keep this react-native mock a superset of the preload's mock so other test
+// files still resolve AppState / Linking / Platform after this file runs.
+mock.module("react-native", () => ({
+    AppState: {
+        addEventListener: () => ({ remove: () => { } }),
+        currentState: "active",
+    },
+    Linking: {
+        openURL: async (url) => {
+            openedUrls.push(url);
+            return true;
+        },
+    },
+    Platform: { OS: "ios" },
+    StyleSheet: { create: (s) => s },
+}));
+// Force IsWeb=false so the mobile update path is exercised.
+mock.module("./platform", () => ({ IsWeb: false }));
+const { emptySplitApi } = await import("./emptyApi");
+const { useUpgradeCheck } = await import("./useUpgradeCheck");
+const constantsWithExtra = Constants;
+const createTestStore = () => configureStore({
+    middleware: (getDefaultMiddleware) => getDefaultMiddleware().concat(emptySplitApi.middleware),
+    reducer: { [emptySplitApi.reducerPath]: emptySplitApi.reducer },
+});
+const createWrapper = (store) => {
+    const Wrapper = ({ children }) => React.createElement(Provider, { children, store });
+    return Wrapper;
+};
+const mockFetchWith = (payload) => {
+    globalThis.fetch = mock(async () => new Response(JSON.stringify(payload), {
+        headers: { "content-type": "application/json" },
+        status: 200,
+    }));
+};
+const flush = async (ms = 60) => {
+    await act(async () => {
+        await new Promise((resolve) => setTimeout(resolve, ms));
+    });
+};
+describe("useUpgradeCheck (native)", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+        openedUrls.length = 0;
+        constantsWithExtra.expoConfig.extra.buildNumber = 100;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        delete constantsWithExtra.expoConfig.extra.buildNumber;
+        emptySplitApi.util.resetApiState();
+    });
+    it("opens the update URL on native when onUpdate is invoked", async () => {
+        mockFetchWith({ status: "required", updateUrl: "https://example.com/app-update" });
+        const { result, unmount } = renderHook(() => useUpgradeCheck(), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush();
+        // canUpdate on native depends on having a resolved update URL.
+        expect(result.current.canUpdate).toBe(true);
+        await act(async () => {
+            result.current.onUpdate();
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        });
+        expect(openedUrls).toEqual(["https://example.com/app-update"]);
+        unmount();
+    });
+    it("does not open a URL on native when no update URL is available", async () => {
+        mockFetchWith({ status: "required" });
+        const { result, unmount } = renderHook(() => useUpgradeCheck(), {
+            wrapper: createWrapper(createTestStore()),
+        });
+        await flush();
+        expect(result.current.canUpdate).toBe(false);
+        await act(async () => {
+            result.current.onUpdate();
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        });
+        expect(openedUrls).toEqual([]);
+        unmount();
+    });
+});
+//# sourceMappingURL=useUpgradeCheckNative.test.js.map

package/dist/useUpgradeCheckNative.test.js.map

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

package/package.json

@@ -4,7 +4,7 @@
     "@openfeature/core": "^1.11.0",
     "@react-native-async-storage/async-storage": "2.2.0",
     "@reduxjs/toolkit": "^2.11.1",
-    "@terreno/ui": "0.24.0",
+    "@terreno/ui": "0.25.0",
     "async-mutex": "^0.5.0",
     "axios": "^1.13.2",
     "axios-retry": "^4.5.0",
@@ -73,5 +73,5 @@
     "test:coverage": "bun run ../scripts/check-coverage.ts"
   },
   "types": "dist/index.d.ts",
-  "version": "0.24.0"
+  "version": "0.25.0"
 }

package/src/betterAuthSlice.ts

@@ -5,7 +5,12 @@
  * login/logout actions, and selectors for auth state.
  */
 
-import {createListenerMiddleware, createSlice, type PayloadAction} from "@reduxjs/toolkit";
+import {
+  createListenerMiddleware,
+  createSlice,
+  type PayloadAction,
+  type UnknownAction,
+} from "@reduxjs/toolkit";
 import {DateTime} from "luxon";
 
 import type {BetterAuthClientInterface, BetterAuthUser} from "./betterAuthTypes";
@@ -16,10 +21,13 @@ import type {BetterAuthClientInterface, BetterAuthUser} from "./betterAuthTypes"
 const LOGOUT_ACTION_TYPE = "auth/logout";
 
 /**
- * Root state type - loosely typed to avoid circular dependencies.
+ * Root state type - only the betterAuth slice is known here; other slices are
+ * allowed via the index signature so this works with any Redux store configuration.
  */
-// biome-ignore lint/suspicious/noExplicitAny: RootState is loosely typed to work with any Redux store configuration.
-type RootState = any;
+interface RootState {
+  betterAuth?: BetterAuthState;
+  [key: string]: unknown;
+}
 
 /**
  * Better Auth Redux state interface.
@@ -202,8 +210,7 @@ export const generateBetterAuthSlice = (config: GenerateBetterAuthSliceConfig) =
    * Syncs the session state from Better Auth to Redux.
    * Call this on app startup and periodically to keep state in sync.
    */
-  // biome-ignore lint/suspicious/noExplicitAny: Redux dispatch type varies by store configuration
-  const syncSession = async (dispatch: any): Promise<void> => {
+  const syncSession = async (dispatch: (action: UnknownAction) => void): Promise<void> => {
     dispatch(betterAuthSlice.actions.setLoading(true));
 
     try {
@@ -269,40 +276,34 @@ export type BetterAuthSlice = ReturnType<typeof generateBetterAuthSlice>;
  * Selects the entire Better Auth state.
  */
 export const selectBetterAuthState = (state: RootState): BetterAuthState | undefined =>
-  // biome-ignore lint/suspicious/noExplicitAny: RootState is loosely typed
-  (state as any).betterAuth;
+  state.betterAuth;
 
 /**
  * Selects whether the user is authenticated.
  */
 export const selectBetterAuthIsAuthenticated = (state: RootState): boolean =>
-  // biome-ignore lint/suspicious/noExplicitAny: RootState is loosely typed
-  (state as any).betterAuth?.isAuthenticated ?? false;
+  state.betterAuth?.isAuthenticated ?? false;
 
 /**
  * Selects the current user ID.
  */
 export const selectBetterAuthUserId = (state: RootState): string | null =>
-  // biome-ignore lint/suspicious/noExplicitAny: RootState is loosely typed
-  (state as any).betterAuth?.userId ?? null;
+  state.betterAuth?.userId ?? null;
 
 /**
  * Selects the current user data.
  */
 export const selectBetterAuthUser = (state: RootState): BetterAuthUser | null =>
-  // biome-ignore lint/suspicious/noExplicitAny: RootState is loosely typed
-  (state as any).betterAuth?.user ?? null;
+  state.betterAuth?.user ?? null;
 
 /**
  * Selects whether the auth state is loading.
  */
 export const selectBetterAuthIsLoading = (state: RootState): boolean =>
-  // biome-ignore lint/suspicious/noExplicitAny: RootState is loosely typed
-  (state as any).betterAuth?.isLoading ?? false;
+  state.betterAuth?.isLoading ?? false;
 
 /**
  * Selects the last error message.
  */
 export const selectBetterAuthError = (state: RootState): string | null =>
-  // biome-ignore lint/suspicious/noExplicitAny: RootState is loosely typed
-  (state as any).betterAuth?.error ?? null;
+  state.betterAuth?.error ?? null;

package/src/useFeatureFlags.ts

@@ -1,4 +1,5 @@
 import type {Api} from "@reduxjs/toolkit/query/react";
+import {DateTime} from "luxon";
 import {useCallback, useEffect, useMemo, useRef} from "react";
 import {useTerrenoFeatureFlags} from "./useTerrenoFeatureFlags";
 
@@ -104,7 +105,7 @@ export const useFeatureFlags = (
       return;
     }
 
-    fetchStartedAtRef.current = Date.now();
+    fetchStartedAtRef.current = DateTime.now().toMillis();
     console.debug("[feature-flags] flagConfiguration request started", {
       basePath,
     });
@@ -115,7 +116,7 @@ export const useFeatureFlags = (
       return;
     }
 
-    const durationMs = Date.now() - fetchStartedAtRef.current;
+    const durationMs = DateTime.now().toMillis() - fetchStartedAtRef.current;
     fetchStartedAtRef.current = null;
     console.debug("[feature-flags] flagConfiguration request failed", {
       basePath,
@@ -142,7 +143,7 @@ export const useFeatureFlags = (
       return;
     }
 
-    const durationMs = Date.now() - fetchStartedAtRef.current;
+    const durationMs = DateTime.now().toMillis() - fetchStartedAtRef.current;
     fetchStartedAtRef.current = null;
     console.debug("[feature-flags] flagConfiguration request completed", {
       basePath,

package/src/useRealtimeDebug.test.ts

@@ -0,0 +1,173 @@
+import {afterEach, beforeEach, describe, expect, it, mock} from "bun:test";
+import {configureStore} from "@reduxjs/toolkit";
+import {act, renderHook} from "@testing-library/react-native";
+import React from "react";
+import {Provider} from "react-redux";
+
+import {isWebsocketsDebugEnabled, setRealtimeDebug} from "./constants";
+import {offlineReducer, setOnlineStatus} from "./offlineSlice";
+import {useRealtimeDebug} from "./useRealtimeDebug";
+
+const createTestStore = (): ReturnType<typeof configureStore> =>
+  configureStore({
+    reducer: {offline: offlineReducer},
+  });
+
+const createWrapper = (
+  store: ReturnType<typeof createTestStore>
+): React.FC<{children: React.ReactNode}> => {
+  const Wrapper: React.FC<{children: React.ReactNode}> = ({children}) =>
+    React.createElement(Provider, {children, store});
+  return Wrapper;
+};
+
+const flush = async (ms = 50): Promise<void> => {
+  await act(async () => {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+  });
+};
+
+describe("useRealtimeDebug", () => {
+  let store: ReturnType<typeof createTestStore>;
+  let originalFetch: typeof globalThis.fetch;
+
+  beforeEach(() => {
+    store = createTestStore();
+    originalFetch = globalThis.fetch;
+  });
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch;
+    // Reset the module-level runtime debug flag so tests do not leak into each other.
+    setRealtimeDebug(false);
+  });
+
+  it("does not fetch when offline and returns the env-based debug value", async () => {
+    store.dispatch(setOnlineStatus(false));
+    const fetchFn = mock(async () => new Response("{}", {status: 200}));
+    globalThis.fetch = fetchFn as unknown as typeof fetch;
+
+    const {result, unmount} = renderHook(() => useRealtimeDebug("http://localhost:4000"), {
+      wrapper: createWrapper(store),
+    });
+
+    await flush();
+
+    expect(fetchFn).not.toHaveBeenCalled();
+    expect(result.current).toBe(false);
+    unmount();
+  });
+
+  it("enables debug when the health endpoint reports debug true", async () => {
+    const fetchFn = mock(async () => new Response(JSON.stringify({debug: true}), {status: 200}));
+    globalThis.fetch = fetchFn as unknown as typeof fetch;
+
+    const {result, unmount} = renderHook(() => useRealtimeDebug("http://localhost:4000"), {
+      wrapper: createWrapper(store),
+    });
+
+    await flush();
+
+    expect(fetchFn).toHaveBeenCalled();
+    const callUrl = (fetchFn.mock.calls[0] as unknown[])[0] as string;
+    expect(callUrl).toBe("http://localhost:4000/realtime/health");
+    expect(isWebsocketsDebugEnabled()).toBe(true);
+    expect(result.current).toBe(true);
+    unmount();
+  });
+
+  it("keeps debug disabled when the health endpoint reports debug false", async () => {
+    const fetchFn = mock(async () => new Response(JSON.stringify({debug: false}), {status: 200}));
+    globalThis.fetch = fetchFn as unknown as typeof fetch;
+
+    const {result, unmount} = renderHook(() => useRealtimeDebug("http://localhost:4000"), {
+      wrapper: createWrapper(store),
+    });
+
+    await flush();
+
+    expect(fetchFn).toHaveBeenCalled();
+    expect(isWebsocketsDebugEnabled()).toBe(false);
+    expect(result.current).toBe(false);
+    unmount();
+  });
+
+  it("ignores a non-ok health response", async () => {
+    const fetchFn = mock(async () => new Response("error", {status: 500}));
+    globalThis.fetch = fetchFn as unknown as typeof fetch;
+
+    const {result, unmount} = renderHook(() => useRealtimeDebug("http://localhost:4000"), {
+      wrapper: createWrapper(store),
+    });
+
+    await flush();
+
+    expect(fetchFn).toHaveBeenCalled();
+    expect(result.current).toBe(false);
+    unmount();
+  });
+
+  it("swallows fetch errors and keeps env-based debug", async () => {
+    const fetchFn = mock(async () => {
+      throw new Error("Network error");
+    });
+    globalThis.fetch = fetchFn as unknown as typeof fetch;
+
+    const {result, unmount} = renderHook(() => useRealtimeDebug("http://localhost:4000"), {
+      wrapper: createWrapper(store),
+    });
+
+    await flush();
+
+    expect(fetchFn).toHaveBeenCalled();
+    expect(result.current).toBe(false);
+    unmount();
+  });
+
+  it("does not apply the debug flag when the hook unmounts before the response resolves", async () => {
+    let resolveJson: (value: {debug: boolean}) => void = () => {};
+    const jsonPromise = new Promise<{debug: boolean}>((resolve) => {
+      resolveJson = resolve;
+    });
+    const fetchFn = mock(async () => ({json: () => jsonPromise, ok: true}));
+    globalThis.fetch = fetchFn as unknown as typeof fetch;
+
+    const {unmount} = renderHook(() => useRealtimeDebug("http://localhost:4000"), {
+      wrapper: createWrapper(store),
+    });
+
+    // Unmount while the response body is still pending, then resolve it.
+    unmount();
+    await act(async () => {
+      resolveJson({debug: true});
+      await jsonPromise;
+      await new Promise((resolve) => setTimeout(resolve, 10));
+    });
+
+    // The cancelled guard should prevent setRealtimeDebug from running.
+    expect(isWebsocketsDebugEnabled()).toBe(false);
+  });
+
+  it("re-runs the health check when the refresh key changes", async () => {
+    const fetchFn = mock(async () => new Response(JSON.stringify({debug: false}), {status: 200}));
+    globalThis.fetch = fetchFn as unknown as typeof fetch;
+
+    const {rerender, unmount} = renderHook(
+      ({key}: {key: number}) => useRealtimeDebug("http://localhost:4000", key),
+      {
+        initialProps: {key: 1},
+        wrapper: createWrapper(store),
+      }
+    );
+
+    await flush();
+    const firstCallCount = fetchFn.mock.calls.length;
+    expect(firstCallCount).toBeGreaterThan(0);
+
+    rerender({key: 2});
+    await flush();
+
+    expect(fetchFn.mock.calls.length).toBeGreaterThan(firstCallCount);
+    unmount();
+  });
+});