@terreno/rtk 0.13.0 → 0.14.0

package/dist/useServerStatus.js

@@ -0,0 +1,89 @@
+import { useCallback, useEffect, useRef } from "react";
+import { useDispatch } from "react-redux";
+import { baseUrl } from "./constants";
+import { setOnlineStatus } from "./offlineSlice";
+import { useOfflineStatus } from "./useOfflineStatus";
+const DEFAULT_POLL_INTERVAL_MS = 5000;
+const OFFLINE_POLL_INTERVAL_MS = 3000;
+/**
+ * Polls the API server health endpoint to determine actual server reachability.
+ * Dispatches setOnlineStatus(true/false) into the offline slice so the rest
+ * of the offline middleware (queue, optimistic updates, replay) reacts.
+ *
+ * Use this instead of useOfflineStatus when you want real server-connectivity
+ * detection rather than just browser navigator.onLine.
+ *
+ * @example
+ * ```typescript
+ * const {isOnline, queueLength, isSyncing, isLocalOnly} = useServerStatus({
+ *   skip: !userId,
+ * });
+ * ```
+ */
+export const useServerStatus = (options = {}) => {
+    const { healthUrl = `${baseUrl}/health`, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, offlinePollIntervalMs = OFFLINE_POLL_INTERVAL_MS, skip = false, } = options;
+    const offlineStatus = useOfflineStatus();
+    const dispatch = useDispatch();
+    const isOnlineRef = useRef(offlineStatus.isOnline);
+    isOnlineRef.current = offlineStatus.isOnline;
+    // Ping the server health endpoint; dispatch status changes
+    const checkHealth = useCallback(async () => {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 4000);
+            const response = await fetch(healthUrl, {
+                cache: "no-store",
+                method: "GET",
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (response.ok && !isOnlineRef.current) {
+                dispatch(setOnlineStatus(true));
+            }
+            else if (!response.ok && isOnlineRef.current) {
+                dispatch(setOnlineStatus(false));
+            }
+        }
+        catch {
+            if (isOnlineRef.current) {
+                dispatch(setOnlineStatus(false));
+            }
+        }
+    }, [healthUrl, dispatch]);
+    // Poll at different intervals depending on online/offline state
+    useEffect(() => {
+        if (skip || typeof window === "undefined") {
+            return;
+        }
+        // Check immediately on mount
+        void checkHealth();
+        const interval = offlineStatus.isOnline ? pollIntervalMs : offlinePollIntervalMs;
+        const id = setInterval(() => {
+            void checkHealth();
+        }, interval);
+        return () => {
+            clearInterval(id);
+        };
+    }, [skip, checkHealth, offlineStatus.isOnline, pollIntervalMs, offlinePollIntervalMs]);
+    // Also respond to browser online/offline events for instant detection
+    useEffect(() => {
+        if (skip || typeof window === "undefined") {
+            return;
+        }
+        const handleOffline = () => {
+            dispatch(setOnlineStatus(false));
+        };
+        const handleOnline = () => {
+            // Don't trust the browser event alone — verify with health check
+            void checkHealth();
+        };
+        window.addEventListener("online", handleOnline);
+        window.addEventListener("offline", handleOffline);
+        return () => {
+            window.removeEventListener("online", handleOnline);
+            window.removeEventListener("offline", handleOffline);
+        };
+    }, [skip, dispatch, checkHealth]);
+    return offlineStatus;
+};
+//# sourceMappingURL=useServerStatus.js.map

package/dist/useServerStatus.js.map

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

package/dist/useUpgradeCheck.d.ts

@@ -29,10 +29,14 @@ interface UseUpgradeCheckResult {
  * - `isWarning` — the build is below the warning threshold; the caller
  *   can render a dismissible `Banner` or similar prompt.
  *
- * By default a single check runs on mount. Pass `pollingIntervalMs` and/or
- * `recheckOnForeground` to keep long-lived sessions up to date.
+ * The polling interval is server-driven: the first successful `/version-check`
+ * response returns `pollingIntervalMs` from the backend's VersionConfig and the
+ * hook uses that value for all subsequent intervals. Pass `pollingIntervalMs` in
+ * options as a local fallback that is active until the first server response
+ * arrives. Pass `recheckOnForeground` to also re-check when the app/tab
+ * returns to the foreground.
  *
- * @param options - Optional polling and foreground re-check configuration.
+ * @param options - Optional fallback polling interval and foreground re-check configuration.
  * @returns Current upgrade status, messages, and an `onUpdate` callback.
  */
 export declare const useUpgradeCheck: (options?: UseUpgradeCheckOptions) => UseUpgradeCheckResult;

package/dist/useUpgradeCheck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useUpgradeCheck.d.ts","sourceRoot":"","sources":["../src/useUpgradeCheck.ts"],"names":[],"mappings":"AAOA,UAAU,sBAAsB;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,qBAAqB;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oGAAoG;IACpG,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,sBAAsB,KAAG,qBA0GlE,CAAC"}
+{"version":3,"file":"useUpgradeCheck.d.ts","sourceRoot":"","sources":["../src/useUpgradeCheck.ts"],"names":[],"mappings":"AAWA,UAAU,sBAAsB;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,qBAAqB;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oGAAoG;IACpG,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,sBAAsB,KAAG,qBAwHlE,CAAC"}

package/dist/useUpgradeCheck.js

@@ -1,6 +1,10 @@
 import Constants from "expo-constants";
 import { useCallback, useEffect, useRef, useState } from "react";
-import { AppState, Linking } from "react-native";
+// Use a namespace import + lazy property access so per-test `mock.module` swaps
+// reach the runtime values. A destructured `import {AppState, Linking}` fails
+// bun's static-export check against react-native's CJS getter exports under the
+// version pinned in CI.
+import * as ReactNative from "react-native";
 import { useLazyGetVersionCheckQuery } from "./emptyApi";
 import { IsWeb } from "./platform";
 /**
@@ -12,23 +16,29 @@ import { IsWeb } from "./platform";
  * - `isWarning` — the build is below the warning threshold; the caller
  *   can render a dismissible `Banner` or similar prompt.
  *
- * By default a single check runs on mount. Pass `pollingIntervalMs` and/or
- * `recheckOnForeground` to keep long-lived sessions up to date.
+ * The polling interval is server-driven: the first successful `/version-check`
+ * response returns `pollingIntervalMs` from the backend's VersionConfig and the
+ * hook uses that value for all subsequent intervals. Pass `pollingIntervalMs` in
+ * options as a local fallback that is active until the first server response
+ * arrives. Pass `recheckOnForeground` to also re-check when the app/tab
+ * returns to the foreground.
  *
- * @param options - Optional polling and foreground re-check configuration.
+ * @param options - Optional fallback polling interval and foreground re-check configuration.
  * @returns Current upgrade status, messages, and an `onUpdate` callback.
  */
 export const useUpgradeCheck = (options) => {
-    const { pollingIntervalMs, recheckOnForeground = false } = options ?? {};
+    const { pollingIntervalMs: fallbackPollingIntervalMs, recheckOnForeground = false } = options ?? {};
     const [isRequired, setIsRequired] = useState(false);
     const [isWarning, setIsWarning] = useState(false);
     const [requiredMessage, setRequiredMessage] = useState();
     const [warningMessage, setWarningMessage] = useState();
     const [updateUrl, setUpdateUrl] = useState();
     const [warningCheckCount, setWarningCheckCount] = useState(0);
+    // Starts with the local fallback; updated to the server-configured value after the first response.
+    const [activePollingIntervalMs, setActivePollingIntervalMs] = useState(fallbackPollingIntervalMs);
     const [triggerVersionCheck] = useLazyGetVersionCheckQuery();
     const buildNumber = Constants.expoConfig?.extra?.buildNumber;
-    const appState = useRef(AppState.currentState);
+    const appState = useRef(ReactNative.AppState.currentState);
     // Process version-check response inline via .unwrap() so every poll trigger
     // is handled, even when RTK Query returns a structurally-shared cached response
     // (which would prevent a useEffect from re-firing).
@@ -40,7 +50,7 @@ export const useUpgradeCheck = (options) => {
         triggerVersionCheck({ platform, version: buildNumber })
             .unwrap()
             .then((data) => {
-            const { message, status, updateUrl: responseUpdateUrl } = data;
+            const { message, pollingIntervalMs: serverPollingIntervalMs, status, updateUrl: responseUpdateUrl, } = data;
             if (status === "required") {
                 setIsRequired(true);
                 setRequiredMessage(message);
@@ -58,6 +68,10 @@ export const useUpgradeCheck = (options) => {
             if (responseUpdateUrl) {
                 setUpdateUrl(responseUpdateUrl);
             }
+            // Adopt the server-configured polling interval once it's available.
+            if (serverPollingIntervalMs !== undefined) {
+                setActivePollingIntervalMs(serverPollingIntervalMs);
+            }
         })
             .catch((error) => {
             console.debug("Version check failed, continuing normally", error);
@@ -69,7 +83,7 @@ export const useUpgradeCheck = (options) => {
             return;
         }
         if (updateUrl) {
-            void Linking.openURL(updateUrl).catch((err) => {
+            void ReactNative.Linking.openURL(updateUrl).catch((err) => {
                 console.warn("Failed to open update URL", err);
             });
         }
@@ -81,20 +95,20 @@ export const useUpgradeCheck = (options) => {
     useEffect(() => {
         runCheck();
     }, [runCheck]);
-    // Periodic re-check at the configured interval
+    // Periodic re-check using the server-driven interval (falls back to the local prop until first response).
     useEffect(() => {
-        if (!pollingIntervalMs) {
+        if (!activePollingIntervalMs) {
             return;
         }
-        const interval = setInterval(runCheck, pollingIntervalMs);
+        const interval = setInterval(runCheck, activePollingIntervalMs);
         return () => clearInterval(interval);
-    }, [runCheck, pollingIntervalMs]);
+    }, [runCheck, activePollingIntervalMs]);
     // Re-check when app/tab returns to foreground
     useEffect(() => {
         if (!recheckOnForeground) {
             return;
         }
-        const subscription = AppState.addEventListener("change", (nextAppState) => {
+        const subscription = ReactNative.AppState.addEventListener("change", (nextAppState) => {
             const wasBackground = /inactive|background/.test(appState.current);
             const isNowActive = nextAppState === "active";
             if (wasBackground && isNowActive) {

package/dist/useUpgradeCheck.js.map

@@ -1 +1 @@
-{"version":3,"file":"useUpgradeCheck.js","sourceRoot":"","sources":["../src/useUpgradeCheck.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useUpgradeCheck.js","sourceRoot":"","sources":["../src/useUpgradeCheck.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC/D,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,wBAAwB;AACxB,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAC,2BAA2B,EAAC,MAAM,YAAY,CAAC;AACvD,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AA0BjC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAgC,EAAyB,EAAE;IACzF,MAAM,EAAC,iBAAiB,EAAE,yBAAyB,EAAE,mBAAmB,GAAG,KAAK,EAAC,GAAG,OAAO,IAAI,EAAE,CAAC;IAElG,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,EAAU,CAAC;IACjE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,EAAU,CAAC;IAC/D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,EAAU,CAAC;IACrD,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9D,mGAAmG;IACnG,MAAM,CAAC,uBAAuB,EAAE,0BAA0B,CAAC,GAAG,QAAQ,CACpE,yBAAyB,CAC1B,CAAC;IACF,MAAM,CAAC,mBAAmB,CAAC,GAAG,2BAA2B,EAAE,CAAC;IAC5D,MAAM,WAAW,GAAG,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,WAAiC,CAAC;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE3D,4EAA4E;IAC5E,gFAAgF;IAChF,oDAAoD;IACpD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACtD,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1C,mBAAmB,CAAC,EAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAC,CAAC;aAClD,MAAM,EAAE;aACR,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,EACJ,OAAO,EACP,iBAAiB,EAAE,uBAAuB,EAC1C,MAAM,EACN,SAAS,EAAE,iBAAiB,GAC7B,GAAG,IAAI,CAAC;YAET,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC1B,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpB,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;iBAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,YAAY,CAAC,IAAI,CAAC,CAAC;gBACnB,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBAC3B,oBAAoB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,aAAa,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAED,IAAI,iBAAiB,EAAE,CAAC;gBACtB,YAAY,CAAC,iBAAiB,CAAC,CAAC;YAClC,CAAC;YAED,oEAAoE;YACpE,IAAI,uBAAuB,KAAK,SAAS,EAAE,CAAC;gBAC1C,0BAA0B,CAAC,uBAAuB,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACjE,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,yBAAyB;IACzB,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,EAAE,CAAC;IACb,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,0GAA0G;IAC1G,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;QAChE,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,EAAE,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAExC,8CAA8C;IAC9C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,EAAE;YACpF,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACnE,MAAM,WAAW,GAAG,YAAY,KAAK,QAAQ,CAAC;YAE9C,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;gBACjC,QAAQ,EAAE,CAAC;YACb,CAAC;YAED,QAAQ,CAAC,OAAO,GAAG,YAAY,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,KAAK,IAAI,CAAC,CAAC,SAAS,CAAC;IAEvC,OAAO;QACL,SAAS;QACT,UAAU;QACV,SAAS;QACT,QAAQ;QACR,eAAe;QACf,iBAAiB;QACjB,cAAc;KACf,CAAC;AACJ,CAAC,CAAC"}

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.13.0",
+    "@terreno/ui": "0.14.0",
     "async-mutex": "^0.5.0",
     "axios": "^1.13.2",
     "axios-retry": "^4.5.0",
@@ -67,5 +67,5 @@
     "test:coverage": "bun run ../scripts/check-coverage.ts"
   },
   "types": "dist/index.d.ts",
-  "version": "0.13.0"
+  "version": "0.14.0"
 }

package/src/authSlice.test.ts

@@ -1,3 +1,4 @@
+// biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
 import {beforeEach, describe, expect, it} from "bun:test";
 import AsyncStorage from "@react-native-async-storage/async-storage";
 import {configureStore} from "@reduxjs/toolkit";
@@ -40,10 +41,7 @@ const api = createApi({
 });
 
 const createTestStore = () => {
-  const {authReducer, middleware, ...rest} = generateAuthSlice(
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock
-    api as any
-  );
+  const {authReducer, middleware, ...rest} = generateAuthSlice(api as any);
 
   return {
     ...rest,
@@ -283,29 +281,24 @@ describe("generateAuthSlice", () => {
 
 describe("selectors", () => {
   it("selectCurrentUserId returns userId", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock state
     const state = {auth: {userId: "user-123"}} as any;
     expect(selectCurrentUserId(state)).toBe("user-123");
   });
 
   it("selectCurrentUserId returns undefined when no auth state", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock state
     expect(selectCurrentUserId({} as any)).toBeUndefined();
   });
 
   it("selectIsAuthenticating returns isAuthenticating", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock state
     const state = {auth: {isAuthenticating: true}} as any;
     expect(selectIsAuthenticating(state)).toBe(true);
   });
 
   it("selectIsAuthenticating defaults to false", () => {
-    // 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);
   });
@@ -328,10 +321,8 @@ describe("EmailLoginRequest type", () => {
 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;

package/src/authSliceNative.test.ts

@@ -1,6 +1,16 @@
+// biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
 import {afterAll, afterEach, beforeEach, describe, expect, it, mock} from "bun:test";
 
+// Keep this mock a superset of the preload's react-native mock so that other
+// test files (e.g. useUpgradeCheck.test.ts) can still find AppState and Linking
+// on the cached `react-native` module after authSliceNative.test.ts runs first.
+// Bun caches the module by URL, so the last mock.module wins for subsequent loaders.
 mock.module("react-native", () => ({
+  AppState: {
+    addEventListener: () => ({remove: () => {}}),
+    currentState: "active",
+  },
+  Linking: {openURL: async () => true},
   Platform: {OS: "ios"},
   StyleSheet: {create: (s: unknown) => s},
 }));
@@ -59,10 +69,7 @@ const api = createApi({
 });
 
 const createTestStore = () => {
-  const {authReducer, middleware, authSlice} = auth.generateAuthSlice(
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock
-    api as any
-  );
+  const {authReducer, middleware, authSlice} = auth.generateAuthSlice(api as any);
   const store = configureStore({
     middleware: (getDefault) =>
       getDefault({serializableCheck: false}).concat(api.middleware, ...middleware),

package/src/betterAuthSlice.test.ts

@@ -1,3 +1,4 @@
+// biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
 import {beforeEach, describe, expect, it, mock} from "bun:test";
 import {configureStore} from "@reduxjs/toolkit";
 import {
@@ -79,7 +80,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("creates a slice with initial state", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
     const initialState = betterAuthSlice.reducer(undefined, {type: "@@INIT"});
@@ -92,7 +92,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("setSession action updates state correctly", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
     const user: BetterAuthUser = {
@@ -118,7 +117,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("clearSession action resets state", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
     // First set a session
@@ -147,7 +145,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("setLoading action updates loading state", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
     let state = betterAuthSlice.reducer(undefined, betterAuthSlice.actions.setLoading(true));
@@ -158,7 +155,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("setError action updates error state", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
     const state = betterAuthSlice.reducer(
@@ -171,7 +167,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("logout action clears session state", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
     // First set a session
@@ -200,7 +195,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("returns middleware array", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
     expect(Array.isArray(betterAuthSlice.middleware)).toBe(true);
@@ -208,20 +202,15 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("returns authClient reference", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type comparison
     expect(betterAuthSlice.authClient).toBe(mockAuthClient as any);
   });
 
   it("syncSession function updates state from auth client", async () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock for dispatched actions
     const dispatchedActions: any[] = [];
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock dispatch function
     const mockDispatch = (action: any) => {
       dispatchedActions.push(action);
     };
@@ -242,12 +231,9 @@ describe("generateBetterAuthSlice", () => {
         },
       })
     ) as unknown as typeof mockAuthClient.getSession;
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock for dispatched actions
     const dispatchedActions: any[] = [];
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock dispatch function
     const mockDispatch = (action: any) => {
       dispatchedActions.push(action);
     };
@@ -266,12 +252,9 @@ describe("generateBetterAuthSlice", () => {
     ) as unknown as typeof mockAuthClient.getSession;
     const originalConsoleError = console.error;
     console.error = mock(() => {});
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
 
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock for dispatched actions
     const dispatchedActions: any[] = [];
-    // biome-ignore lint/suspicious/noExplicitAny: Test mock dispatch function
     const mockDispatch = (action: any) => {
       dispatchedActions.push(action);
     };
@@ -287,7 +270,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("logout middleware calls signOut for slice logout action", async () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
     const store = configureStore({
       middleware: (getDefaultMiddleware) =>
@@ -312,7 +294,6 @@ describe("generateBetterAuthSlice", () => {
     console.error = (...args: unknown[]): void => {
       errorCalls.push(args);
     };
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
     const store = configureStore({
       middleware: (getDefaultMiddleware) =>
@@ -342,7 +323,6 @@ describe("generateBetterAuthSlice", () => {
     console.error = (...args: unknown[]): void => {
       errorCalls.push(args);
     };
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
     const store = configureStore({
       middleware: (getDefaultMiddleware) =>
@@ -364,7 +344,6 @@ describe("generateBetterAuthSlice", () => {
   });
 
   it("global auth/logout action signs out and clears session", async () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Mock client type
     const betterAuthSlice = generateBetterAuthSlice({authClient: mockAuthClient as any});
     const store = configureStore({
       middleware: (getDefaultMiddleware) =>
@@ -400,7 +379,6 @@ describe("generateBetterAuthSlice", () => {
 });
 
 describe("Better Auth selectors", () => {
-  // biome-ignore lint/suspicious/noExplicitAny: Test mock state factory
   const createMockState = (betterAuth: Partial<BetterAuthState> = {}): any => ({
     betterAuth: {
       error: null,
@@ -449,7 +427,6 @@ describe("Better Auth selectors", () => {
   });
 
   it("selectors handle missing betterAuth state gracefully", () => {
-    // biome-ignore lint/suspicious/noExplicitAny: Test empty state for selector edge case
     const emptyState = {} as any;
 
     expect(selectBetterAuthIsAuthenticated(emptyState)).toBe(false);
@@ -461,7 +438,6 @@ describe("Better Auth selectors", () => {
 
   it("selectBetterAuthState returns the raw betterAuth slice of state", () => {
     expect(selectBetterAuthState(createMockState({userId: "user-zzz"}))?.userId).toBe("user-zzz");
-    // biome-ignore lint/suspicious/noExplicitAny: Test empty state
     expect(selectBetterAuthState({} as any)).toBeUndefined();
   });
 });

package/src/buildNumber.test.ts

@@ -1,4 +1,7 @@
 import {afterAll, beforeEach, describe, expect, it} from "bun:test";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
 
 import {coerceBuildNumber, resolveBuildNumber} from "./buildNumber";
 
@@ -117,4 +120,20 @@ describe("resolveBuildNumber", () => {
     process.env.EXPO_PUBLIC_BUILD_NUMBER = "999";
     expect(resolveBuildNumber({override: 1})).toBe(1);
   });
+
+  it("returns undefined when git rev-list fails (no git, detached HEAD, etc.)", () => {
+    // Use a freshly-created mkdtemp directory that we know is not inside any git
+    // worktree (parents won't be a repo because we create it under the OS temp dir
+    // and no parent has a `.git` folder). This makes `git rev-list --count HEAD`
+    // exit non-zero so execSync throws, exercising the catch branch.
+    const originalCwd = process.cwd();
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "rtk-buildnumber-no-git-"));
+    process.chdir(tmpDir);
+    try {
+      expect(resolveBuildNumber()).toBeUndefined();
+    } finally {
+      process.chdir(originalCwd);
+      fs.rmSync(tmpDir, {force: true, recursive: true});
+    }
+  });
 });

package/src/constants.test.ts

@@ -5,9 +5,11 @@ import {
   baseTasksUrl,
   baseUrl,
   baseWebsocketsUrl,
+  isWebsocketsDebugEnabled,
   logAuth,
   logSocket,
   resolveBaseUrls,
+  setRealtimeDebug,
 } from "./constants";
 
 describe("resolveBaseUrls", () => {
@@ -154,7 +156,7 @@ describe("module-level exports", () => {
   });
 });
 
-describe("logAuth / logSocket", () => {
+describe("logAuth", () => {
   const originalDebug = console.debug;
   const calls: unknown[][] = [];
 
@@ -173,6 +175,22 @@ describe("logAuth / logSocket", () => {
     logAuth("auth message");
     expect(calls).toEqual([]);
   });
+});
+
+describe("logSocket", () => {
+  const originalInfo = console.info;
+  const calls: unknown[][] = [];
+
+  beforeEach(() => {
+    calls.length = 0;
+    console.info = (...args: unknown[]): void => {
+      calls.push(args);
+    };
+  });
+
+  afterEach(() => {
+    console.info = originalInfo;
+  });
 
   it("logSocket logs when passed boolean true", () => {
     logSocket(true, "socket message");
@@ -200,5 +218,40 @@ describe("logAuth / logSocket", () => {
   });
 });
 
+describe("setRealtimeDebug / isWebsocketsDebugEnabled", () => {
+  const originalInfo = console.info;
+  afterEach(() => {
+    console.info = originalInfo;
+    setRealtimeDebug(false);
+  });
+
+  it("isWebsocketsDebugEnabled returns false by default", () => {
+    expect(isWebsocketsDebugEnabled()).toBe(false);
+  });
+
+  it("setRealtimeDebug(true) makes isWebsocketsDebugEnabled return true", () => {
+    setRealtimeDebug(true);
+    expect(isWebsocketsDebugEnabled()).toBe(true);
+  });
+
+  it("setRealtimeDebug(false) disables runtime debug", () => {
+    setRealtimeDebug(true);
+    expect(isWebsocketsDebugEnabled()).toBe(true);
+    setRealtimeDebug(false);
+    expect(isWebsocketsDebugEnabled()).toBe(false);
+  });
+
+  it("logSocket logs when runtime websocket debug is enabled via setRealtimeDebug", () => {
+    const calls: unknown[][] = [];
+    console.info = (...args: unknown[]): void => {
+      calls.push(args);
+    };
+
+    setRealtimeDebug(true);
+    logSocket(undefined, "runtime debug message");
+    expect(calls).toEqual([["[websocket]", "runtime debug message"]]);
+  });
+});
+
 // Mock.module tests (expo tunnel warning, AUTH_DEBUG) moved to
 // src/isolated/constants.isolated.ts to avoid coverage tracking interference.

package/src/constants.ts

@@ -17,12 +17,23 @@ export const logAuth = (...args: string[]): void => {
 };
 
 // Handy debug logging socket events, but not enabled by default.
-// Can also be enabled by user feature flag.
+// Can also be enabled by user feature flag or runtime via setRealtimeDebug (admin config).
 const WEBSOCKETS_DEBUG = Constants.expoConfig?.extra?.WEBSOCKETS_DEBUG === "true";
 if (WEBSOCKETS_DEBUG) {
   console.debug("WEBSOCKETS_DEBUG is enabled");
 }
 
+let runtimeWebsocketsDebug = false;
+
+/** Enable websocket debug logging at runtime (e.g. from admin debug.websocketsDebug). */
+export const setRealtimeDebug = (enabled: boolean): void => {
+  runtimeWebsocketsDebug = enabled;
+};
+
+export const isWebsocketsDebugEnabled = (): boolean => {
+  return WEBSOCKETS_DEBUG || runtimeWebsocketsDebug;
+};
+
 // Handy debug logging for websockets, enabled by user.featureFlags.debugWebsockets.enabled or passing in true.
 export const logSocket = (
   user?: {featureFlags?: {debugWebsockets?: {enabled?: boolean}}} | boolean,
@@ -31,9 +42,9 @@ export const logSocket = (
   if (
     typeof user === "boolean"
       ? user
-      : user?.featureFlags?.debugWebsockets?.enabled || WEBSOCKETS_DEBUG
+      : user?.featureFlags?.debugWebsockets?.enabled || isWebsocketsDebugEnabled()
   ) {
-    console.debug(`[websocket]`, ...args);
+    console.info("[websocket]", ...args);
   }
 };