@terreno/rtk 0.10.0 → 0.11.0

package/dist/useFeatureFlags.js

@@ -1,22 +1,24 @@
 import { useCallback, useEffect, useMemo, useRef } from "react";
 /**
- * Creates feature flag accessors from an RTK Query API instance.
+ * Normalizes the legacy-compatible `basePathOrOptions` argument into a
+ * `{basePath, skip}` pair with defaults applied.
  *
- * Injects a `GET {basePath}/evaluate` endpoint into the API and returns
- * accessors for reading flag values. Fetches once on mount and caches via
- * RTK Query. Both `api` and `basePath` should be stable references.
- *
- * @example
- * ```typescript
- * const { getFlag, getVariant } = useFeatureFlags(terrenoApi);
- *
- * const showNewCheckout = getFlag("new-checkout-flow");       // true | false
- * const variant = getVariant("checkout-experiment");           // "control" | "variant-a" | null
- * ```
+ * - `undefined` -> `{basePath: "/feature-flags", skip: false}`
+ * - `string`    -> `{basePath: <string>, skip: false}` (legacy form)
+ * - `object`    -> `{basePath: opts.basePath ?? "/feature-flags", skip: opts.skip ?? false}`
  */
-export const useFeatureFlags = (
+export const resolveFeatureFlagsOptions = (basePathOrOptions) => {
+    const { basePath = "/feature-flags", skip = false } = typeof basePathOrOptions === "string"
+        ? { basePath: basePathOrOptions, skip: false }
+        : (basePathOrOptions ?? {});
+    return { basePath, skip };
+};
+// Overloaded signature preserves backwards compatibility with callers that
+// pass a string basePath as the second argument.
+export function useFeatureFlags(
 // biome-ignore lint/suspicious/noExplicitAny: RTK Query API generic typing is intentionally flexible here.
-api, basePath = "/feature-flags") => {
+api, basePathOrOptions) {
+    const { basePath, skip } = resolveFeatureFlagsOptions(basePathOrOptions);
     const enhancedApi = useMemo(() => api.injectEndpoints({
         endpoints: (builder) => ({
             evaluateFeatureFlags: builder.query({
@@ -30,7 +32,7 @@ api, basePath = "/feature-flags") => {
     }), [api, basePath]);
     // biome-ignore lint/suspicious/noExplicitAny: Endpoint hook is injected dynamically by RTK Query.
     const useEvaluateQuery = enhancedApi.useEvaluateFeatureFlagsQuery;
-    const { data, isLoading, error, refetch } = useEvaluateQuery();
+    const { data, isLoading, error, refetch } = useEvaluateQuery(undefined, { skip });
     const evaluateStartedAtRef = useRef(null);
     const flags = data ?? {};
     // Log when evaluate request enters loading state so client timing can be measured.
@@ -82,5 +84,5 @@ api, basePath = "/feature-flags") => {
         return null;
     }, [flags]);
     return { error, flags, getFlag, getVariant, isLoading, refetch };
-};
+}
 //# sourceMappingURL=useFeatureFlags.js.map

package/dist/useFeatureFlags.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureFlags.js","sourceRoot":"","sources":["../src/useFeatureFlags.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AAa9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;AAC7B,2GAA2G;AAC3G,GAA4B,EAC5B,QAAQ,GAAG,gBAAgB,EACJ,EAAE;IACzB,MAAM,WAAW,GAAG,OAAO,CACzB,GAAG,EAAE,CACH,GAAG,CAAC,eAAe,CAAC;QAClB,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACvB,oBAAoB,EAAE,OAAO,CAAC,KAAK,CAAmB;gBACpD,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;oBACZ,MAAM,EAAE,KAAK;oBACb,GAAG,EAAE,GAAG,QAAQ,WAAW;iBAC5B,CAAC;aACH,CAAC;SACH,CAAC;QACF,gBAAgB,EAAE,KAAK;KACxB,CAAC,EACJ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAChB,CAAC;IAEF,kGAAkG;IAClG,MAAM,gBAAgB,GAAI,WAAmB,CAAC,4BAA4B,CAAC;IAC3E,MAAM,EAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAC,GAAG,gBAAgB,EAAE,CAAC;IAC7D,MAAM,oBAAoB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEzD,MAAM,KAAK,GAAe,IAAI,IAAI,EAAE,CAAC;IAErC,mFAAmF;IACnF,SAAS,CAAC,GAAS,EAAE;QACnB,IAAI,CAAC,SAAS,IAAI,oBAAoB,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO;QACT,CAAC;QAED,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE;YACxD,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IAE1B,yEAAyE;IACzE,SAAS,CAAC,GAAS,EAAE;QACnB,IAAI,CAAC,IAAI,IAAI,oBAAoB,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACnD,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC;QAC7D,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE;YAC1D,QAAQ;YACR,UAAU;YACV,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;YAC7C,cAAc,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAE5B,2EAA2E;IAC3E,SAAS,CAAC,GAAS,EAAE;QACnB,IAAI,CAAC,KAAK,IAAI,oBAAoB,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC;QAC7D,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE;YACvD,QAAQ;YACR,UAAU;YACV,KAAK;SACN,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAEtB,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,GAAW,EAAW,EAAE;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,KAAK,KAAK,IAAI,CAAC;IACxB,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,GAAW,EAAiB,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAC,CAAC;AACjE,CAAC,CAAC"}
+{"version":3,"file":"useFeatureFlags.js","sourceRoot":"","sources":["../src/useFeatureFlags.ts"],"names":[],"mappings":"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"}

package/dist/useFeatureFlags.test.d.ts

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

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

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

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.10.0",
+    "@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.10.0"
+  "version": "0.11.0"
 }

package/src/authSlice.test.ts

@@ -449,6 +449,85 @@ describe("listener middleware side effects", () => {
     }
   });
 
+  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[] = [];

package/src/authSliceNative.test.ts

@@ -0,0 +1,187 @@
+import {afterAll, afterEach, beforeEach, describe, expect, it, mock} from "bun:test";
+
+mock.module("react-native", () => ({
+  Platform: {OS: "ios"},
+  StyleSheet: {create: (s: unknown) => s},
+}));
+
+// Force IsWeb=false regardless of whether ./platform was already imported
+// elsewhere in the test run. `mock.module` is hoisted in bun, so this takes
+// effect before the dynamic imports below.
+mock.module("./platform", () => ({IsWeb: false}));
+
+const secureCalls = {
+  delete: [] as string[],
+  get: [] as string[],
+  set: [] as Array<[string, string]>,
+};
+
+mock.module("expo-secure-store", () => ({
+  deleteItemAsync: async (key: string): Promise<void> => {
+    secureCalls.delete.push(key);
+  },
+  getItemAsync: async (key: string): Promise<string | null> => {
+    secureCalls.get.push(key);
+    return null;
+  },
+  setItemAsync: async (key: string, value: string): Promise<void> => {
+    secureCalls.set.push([key, value]);
+  },
+}));
+
+const auth = await import("./authSlice");
+
+const {configureStore} = await import("@reduxjs/toolkit");
+const {createApi, fetchBaseQuery} = await import("@reduxjs/toolkit/query/react");
+
+const api = createApi({
+  baseQuery: fetchBaseQuery({baseUrl: "/"}),
+  endpoints: (builder) => ({
+    emailLogin: builder.mutation({
+      query: (body: {email: string; password: string}) => ({
+        body,
+        method: "POST",
+        url: "auth/login",
+      }),
+    }),
+    emailSignUp: builder.mutation({
+      query: (body: {email: string; password: string}) => ({
+        body,
+        method: "POST",
+        url: "auth/signup",
+      }),
+    }),
+    googleLogin: builder.mutation({
+      query: (body: {idToken: string}) => ({body, method: "POST", url: "auth/google"}),
+    }),
+  }),
+  reducerPath: "terreno-rtk",
+});
+
+const createTestStore = () => {
+  const {authReducer, middleware, authSlice} = auth.generateAuthSlice(
+    // biome-ignore lint/suspicious/noExplicitAny: Test mock
+    api as any
+  );
+  const store = configureStore({
+    middleware: (getDefault) =>
+      getDefault({serializableCheck: false}).concat(api.middleware, ...middleware),
+    reducer: {
+      [api.reducerPath]: api.reducer,
+      auth: authReducer,
+    },
+  });
+  return {authSlice, store};
+};
+
+const flushAsyncListeners = async (): Promise<void> => {
+  await Promise.resolve();
+  await new Promise((resolve) => setTimeout(resolve, 0));
+};
+
+describe("native listener middleware side effects", () => {
+  const originalDebug = console.debug;
+  const originalError = console.error;
+  const debugCalls: unknown[][] = [];
+  const errorCalls: unknown[][] = [];
+
+  beforeEach(() => {
+    debugCalls.length = 0;
+    errorCalls.length = 0;
+    secureCalls.delete = [];
+    secureCalls.get = [];
+    secureCalls.set = [];
+    console.debug = (...args: unknown[]): void => {
+      debugCalls.push(args);
+    };
+    console.error = (...args: unknown[]): void => {
+      errorCalls.push(args);
+    };
+  });
+
+  afterEach(() => {
+    console.debug = originalDebug;
+    console.error = originalError;
+  });
+
+  afterAll(() => {
+    // Restore mocks to the values the rest of the suite expects.
+    mock.module("react-native", () => ({
+      Platform: {OS: "web"},
+      StyleSheet: {create: (s: unknown) => s},
+    }));
+    mock.module("./platform", () => ({IsWeb: true}));
+    mock.module("expo-secure-store", () => ({
+      deleteItemAsync: async () => {},
+      getItemAsync: async () => null,
+      setItemAsync: async () => {},
+    }));
+  });
+
+  it("stores tokens in SecureStore on native login", async () => {
+    const {store} = createTestStore();
+    store.dispatch({
+      meta: {arg: {endpointName: "emailLogin", type: "mutation"}, requestId: "native-login-1"},
+      payload: {refreshToken: "native-refresh", token: "native-auth", userId: "native-user"},
+      type: "terreno-rtk/executeMutation/fulfilled",
+    });
+    await flushAsyncListeners();
+    expect(secureCalls.set).toEqual([
+      ["AUTH_TOKEN", "native-auth"],
+      ["REFRESH_TOKEN", "native-refresh"],
+    ]);
+    expect(store.getState().auth.userId).toBe("native-user");
+  });
+
+  it("logs and rethrows when SecureStore fails on native login", async () => {
+    mock.module("expo-secure-store", () => ({
+      deleteItemAsync: async (key: string): Promise<void> => {
+        secureCalls.delete.push(key);
+      },
+      getItemAsync: async (): Promise<string | null> => null,
+      setItemAsync: async (): Promise<void> => {
+        throw new Error("secure-store-fail");
+      },
+    }));
+    const {store} = createTestStore();
+    store.dispatch({
+      meta: {arg: {endpointName: "emailLogin", type: "mutation"}, requestId: "native-login-err"},
+      payload: {refreshToken: "r", token: "t", userId: "u"},
+      type: "terreno-rtk/executeMutation/fulfilled",
+    });
+    await flushAsyncListeners();
+    const found = errorCalls.find((args) =>
+      args.some((v) => typeof v === "string" && v.includes("Error setting auth token"))
+    );
+    expect(found).toBeDefined();
+    // Reset setItemAsync back so other tests aren't affected.
+    mock.module("expo-secure-store", () => ({
+      deleteItemAsync: async (key: string): Promise<void> => {
+        secureCalls.delete.push(key);
+      },
+      getItemAsync: async (): Promise<string | null> => null,
+      setItemAsync: async (key: string, value: string): Promise<void> => {
+        secureCalls.set.push([key, value]);
+      },
+    }));
+  });
+
+  it("removes tokens from SecureStore on native logout", async () => {
+    const {store, authSlice} = createTestStore();
+    store.dispatch(authSlice.actions.logout());
+    await flushAsyncListeners();
+    expect(secureCalls.delete).toEqual(["AUTH_TOKEN", "REFRESH_TOKEN"]);
+  });
+
+  it("warns when native login response is missing a token", async () => {
+    const {store} = createTestStore();
+    store.dispatch({
+      meta: {arg: {endpointName: "emailLogin", type: "mutation"}, requestId: "native-login-2"},
+      payload: {refreshToken: "r", token: null, userId: "u-missing"},
+      type: "terreno-rtk/executeMutation/fulfilled",
+    });
+    await flushAsyncListeners();
+    // Nothing should have been written to SecureStore since the outer token check filters.
+    expect(secureCalls.set).toEqual([]);
+  });
+});