@terreno/rtk 0.9.3 → 0.11.0

package/dist/constants.test.js

@@ -0,0 +1,195 @@
+import { afterEach, beforeEach, describe, expect, it, mock } from "bun:test";
+import { AUTH_DEBUG, baseTasksUrl, baseUrl, baseWebsocketsUrl, logAuth, logSocket, resolveBaseUrls, } from "./constants";
+describe("resolveBaseUrls", () => {
+    it("treats an empty envApiUrl as unset and falls back to localhost", () => {
+        const urls = resolveBaseUrls({
+            envApiUrl: "",
+            expoConstants: { expoConfig: { extra: {} } },
+            isDev: false,
+        });
+        expect(urls.baseUrl).toBe("http://localhost:4000");
+        expect(urls.baseWebsocketsUrl).toBe("ws://localhost:4000/");
+        expect(urls.baseTasksUrl).toBe("http://localhost:4000/tasks");
+    });
+    it("treats an empty BASE_URL extra as unset and falls back to localhost in non-dev", () => {
+        const urls = resolveBaseUrls({
+            expoConstants: { expoConfig: { extra: { BASE_URL: "" } } },
+            isDev: false,
+        });
+        expect(urls.baseUrl).toBe("http://localhost:4000");
+    });
+    it("uses env override when provided", () => {
+        const urls = resolveBaseUrls({
+            envApiUrl: "https://api.example.com",
+            expoConstants: { expoConfig: { extra: {} } },
+            isDev: false,
+        });
+        expect(urls.baseUrl).toBe("https://api.example.com");
+        expect(urls.baseWebsocketsUrl).toBe("https://ws.example.com/");
+        expect(urls.baseTasksUrl).toBe("https://tasks.example.com/tasks");
+    });
+    it("uses hostUri in dev mode", () => {
+        const urls = resolveBaseUrls({
+            expoConstants: { expoConfig: { extra: {}, hostUri: "10.0.0.12:8081" } },
+            isDev: true,
+        });
+        expect(urls.baseUrl).toBe("http://10.0.0.12:4000");
+        expect(urls.baseWebsocketsUrl).toBe("ws://10.0.0.12:4000/");
+        expect(urls.baseTasksUrl).toBe("http://10.0.0.12:4000/tasks");
+    });
+    it("falls back to experienceUrl in dev mode when hostUri missing", () => {
+        const urls = resolveBaseUrls({
+            expoConstants: {
+                experienceUrl: "exp://192.168.1.20:19000",
+                expoConfig: { extra: {} },
+            },
+            isDev: true,
+        });
+        expect(urls.baseUrl).toBe("http://192.168.1.20:4000");
+        expect(urls.baseWebsocketsUrl).toBe("ws://192.168.1.20:4000/");
+        expect(urls.baseTasksUrl).toBe("http://192.168.1.20:4000/tasks");
+    });
+    it("falls back to localhost in dev mode when nothing else is available", () => {
+        const urls = resolveBaseUrls({
+            expoConstants: { expoConfig: { extra: {} } },
+            isDev: true,
+        });
+        expect(urls.baseUrl).toBe("http://localhost:4000");
+        expect(urls.baseWebsocketsUrl).toBe("ws://localhost:4000/");
+        expect(urls.baseTasksUrl).toBe("http://localhost:4000/tasks");
+    });
+    it("uses BASE_URL from extra when not in dev mode", () => {
+        const urls = resolveBaseUrls({
+            expoConstants: { expoConfig: { extra: { BASE_URL: "https://api.prod.com" } } },
+            isDev: false,
+        });
+        expect(urls.baseUrl).toBe("https://api.prod.com");
+        expect(urls.baseWebsocketsUrl).toBe("https://ws.prod.com/");
+        expect(urls.baseTasksUrl).toBe("https://tasks.prod.com/tasks");
+    });
+    it("falls back to hostUri when BASE_URL absent in non-dev", () => {
+        const urls = resolveBaseUrls({
+            expoConstants: { expoConfig: { extra: {}, hostUri: "172.16.0.3:8081" } },
+            isDev: false,
+        });
+        expect(urls.baseUrl).toBe("http://172.16.0.3:4000");
+        expect(urls.baseWebsocketsUrl).toBe("ws://172.16.0.3:4000/");
+        expect(urls.baseTasksUrl).toBe("http://172.16.0.3:4000/tasks");
+    });
+    it("falls back to experienceUrl in non-dev when hostUri absent", () => {
+        const urls = resolveBaseUrls({
+            expoConstants: {
+                experienceUrl: "exp://10.1.2.3:19000",
+                expoConfig: { extra: {} },
+            },
+            isDev: false,
+        });
+        expect(urls.baseUrl).toBe("http://10.1.2.3:4000");
+    });
+    it("defaults to localhost in non-dev when nothing is configured", () => {
+        const urls = resolveBaseUrls({
+            expoConstants: { expoConfig: { extra: {} } },
+            isDev: false,
+        });
+        expect(urls.baseUrl).toBe("http://localhost:4000");
+    });
+});
+describe("module-level exports", () => {
+    it("exports baseUrl / websockets / tasks URLs that resolve to localhost with default mocks", () => {
+        expect(baseUrl).toBe("http://localhost:4000");
+        expect(baseWebsocketsUrl).toBe("ws://localhost:4000/");
+        expect(baseTasksUrl).toBe("http://localhost:4000/tasks");
+    });
+    it("AUTH_DEBUG is false by default with test-preload mocks", () => {
+        expect(AUTH_DEBUG).toBe(false);
+    });
+});
+describe("logAuth / logSocket", () => {
+    const originalDebug = console.debug;
+    const calls = [];
+    beforeEach(() => {
+        calls.length = 0;
+        console.debug = (...args) => {
+            calls.push(args);
+        };
+    });
+    afterEach(() => {
+        console.debug = originalDebug;
+    });
+    it("logAuth is a no-op when AUTH_DEBUG is disabled", () => {
+        logAuth("auth message");
+        expect(calls).toEqual([]);
+    });
+    it("logSocket logs when passed boolean true", () => {
+        logSocket(true, "socket message");
+        expect(calls).toEqual([["[websocket]", "socket message"]]);
+    });
+    it("logSocket does not log when passed boolean false", () => {
+        logSocket(false, "suppressed");
+        expect(calls).toEqual([]);
+    });
+    it("logSocket logs when user has debugWebsockets feature flag enabled", () => {
+        logSocket({ featureFlags: { debugWebsockets: { enabled: true } } }, "enabled");
+        expect(calls).toEqual([["[websocket]", "enabled"]]);
+    });
+    it("logSocket does not log when user has debugWebsockets disabled", () => {
+        logSocket({ featureFlags: { debugWebsockets: { enabled: false } } }, "disabled");
+        expect(calls).toEqual([]);
+    });
+    it("logSocket does not log with undefined user", () => {
+        logSocket(undefined, "no user");
+        expect(calls).toEqual([]);
+    });
+});
+describe("expo tunnel warning", () => {
+    it("warns when expoGoConfig.debuggerHost contains exp.direct", async () => {
+        const errorCalls = [];
+        const originalError = console.error;
+        console.error = (...args) => {
+            errorCalls.push(args);
+        };
+        mock.module("expo-constants", () => ({
+            default: {
+                expoConfig: { extra: {} },
+                expoGoConfig: { debuggerHost: "abc.exp.direct" },
+            },
+        }));
+        try {
+            const testId = `${Date.now()}-${Math.random()}`;
+            await import(`./constants?case=${testId}`);
+            const warning = errorCalls.find((args) => args.some((v) => typeof v === "string" && v.includes("Expo Tunnel is not currently")));
+            expect(warning).toBeDefined();
+        }
+        finally {
+            console.error = originalError;
+            mock.module("expo-constants", () => ({ default: { expoConfig: { extra: {} } } }));
+        }
+    });
+});
+describe("AUTH_DEBUG enabled path", () => {
+    it("logs debug messages from logAuth when AUTH_DEBUG is true on module load", async () => {
+        const debugCalls = [];
+        const originalDebug = console.debug;
+        console.debug = (...args) => {
+            debugCalls.push(args);
+        };
+        mock.module("expo-constants", () => ({
+            default: { expoConfig: { extra: { AUTH_DEBUG: "true", WEBSOCKETS_DEBUG: "true" } } },
+        }));
+        try {
+            const testId = `${Date.now()}-${Math.random()}`;
+            const loaded = (await import(`./constants?case=${testId}`));
+            expect(loaded.AUTH_DEBUG).toBe(true);
+            const preLength = debugCalls.length;
+            loaded.logAuth("hello");
+            expect(debugCalls.length).toBe(preLength + 1);
+            loaded.logSocket(undefined, "ws on");
+            expect(debugCalls.some((args) => args[0] === "[websocket]" && args[1] === "ws on")).toBe(true);
+        }
+        finally {
+            console.debug = originalDebug;
+            mock.module("expo-constants", () => ({ default: { expoConfig: { extra: {} } } }));
+        }
+    });
+});
+//# sourceMappingURL=constants.test.js.map

package/dist/constants.test.js.map

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

package/dist/mongooseSlice.test.d.ts

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

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

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

package/dist/mongooseSlice.test.js

@@ -0,0 +1,39 @@
+import { describe, expect, it } from "bun:test";
+import { populateId } from "./mongooseSlice";
+describe("populateId", () => {
+    const items = [
+        { _id: "a", name: "alpha" },
+        { _id: "b", name: "beta" },
+        { _id: "c", name: "gamma" },
+    ];
+    const response = {
+        data: items,
+        limit: 10,
+        more: false,
+        page: 1,
+        total: items.length,
+    };
+    it("returns the matching object by id", () => {
+        expect(populateId("b", response)).toEqual({ _id: "b", name: "beta" });
+    });
+    it("returns undefined when id is missing", () => {
+        expect(populateId(undefined, response)).toBeUndefined();
+    });
+    it("returns undefined when objs is missing", () => {
+        expect(populateId("a")).toBeUndefined();
+    });
+    it("returns undefined when objs has no data", () => {
+        expect(populateId("a", {})).toBeUndefined();
+    });
+    it("returns undefined when no item matches", () => {
+        expect(populateId("z", response)).toBeUndefined();
+    });
+    it("handles sparse arrays without throwing", () => {
+        const sparse = {
+            // biome-ignore lint/suspicious/noExplicitAny: Simulating malformed API payloads.
+            data: [undefined, { _id: "found" }],
+        };
+        expect(populateId("found", sparse)).toEqual({ _id: "found" });
+    });
+});
+//# sourceMappingURL=mongooseSlice.test.js.map

package/dist/mongooseSlice.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongooseSlice.test.js","sourceRoot":"","sources":["../src/mongooseSlice.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAC,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAoB,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAE9D,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,MAAM,KAAK,GAAG;QACZ,EAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAC;QACzB,EAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAC;QACxB,EAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAC;KAC1B,CAAC;IACF,MAAM,QAAQ,GAAyC;QACrD,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAgC;YAC1C,iFAAiF;YACjF,IAAI,EAAE,CAAC,SAAgB,EAAE,EAAC,GAAG,EAAE,OAAO,EAAC,CAAC;SACzC,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAC,GAAG,EAAE,OAAO,EAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tagGenerator.test.d.ts

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

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

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

package/dist/tagGenerator.test.js

@@ -0,0 +1,96 @@
+import { describe, expect, it } from "bun:test";
+import { generateTags } from "./tagGenerator";
+describe("generateTags", () => {
+    const tagTypes = ["users", "posts", "conversations", "messages"];
+    it("assigns invalidatesTags for getConversations endpoint", () => {
+        const api = {
+            endpoints: {
+                getConversations: {},
+            },
+        };
+        const tags = generateTags(api, tagTypes);
+        // getConversations matches both the special case AND the list-endpoint branch,
+        // so the list-endpoint branch wins as the final assignment. The special case
+        // still executes for coverage, but the final value is the list providesTags.
+        expect(tags.getConversations).toBeDefined();
+        expect(typeof tags.getConversations.providesTags).toBe("function");
+    });
+    it("assigns providesTags on list get endpoints", () => {
+        const api = {
+            endpoints: {
+                getUsers: {},
+            },
+        };
+        const tags = generateTags(api, tagTypes);
+        expect(typeof tags.getUsers.providesTags).toBe("function");
+        // Exercise the returned provides function with and without data
+        const providesFn = tags.getUsers.providesTags;
+        expect(providesFn(null)).toEqual(["users"]);
+        expect(providesFn({ data: [{ _id: "1" }, { _id: "2" }] })).toEqual([
+            { id: "1", type: "users" },
+            { id: "2", type: "users" },
+            "users",
+        ]);
+        expect(providesFn({})).toEqual(["users"]);
+    });
+    it("assigns providesTags on read (ById) get endpoints", () => {
+        const api = {
+            endpoints: {
+                getUserById: {},
+            },
+        };
+        const tags = generateTags(api, tagTypes);
+        expect(typeof tags.getUserById.providesTags).toBe("function");
+        const providesFn = tags.getUserById.providesTags;
+        expect(providesFn(null)).toEqual(["users"]);
+        expect(providesFn({ _id: "abc" })).toEqual([{ id: "abc", type: "users" }]);
+    });
+    it("assigns invalidatesTags on patch endpoints", () => {
+        const api = {
+            endpoints: {
+                patchUserById: {},
+            },
+        };
+        const tags = generateTags(api, tagTypes);
+        expect(typeof tags.patchUserById.invalidatesTags).toBe("function");
+        const invalidateFn = tags.patchUserById.invalidatesTags;
+        expect(invalidateFn(null)).toEqual(["users"]);
+        expect(invalidateFn({ data: [{ _id: "x" }] })).toEqual([{ id: "x", type: "users" }, "users"]);
+    });
+    it("assigns invalidatesTags on delete endpoints", () => {
+        const api = {
+            endpoints: {
+                deletePostById: {},
+            },
+        };
+        const tags = generateTags(api, tagTypes);
+        expect(typeof tags.deletePostById.invalidatesTags).toBe("function");
+        const invalidateFn = tags.deletePostById.invalidatesTags;
+        expect(invalidateFn(null)).toEqual(["posts"]);
+    });
+    it("skips endpoints with no matching tag", () => {
+        const api = {
+            endpoints: {
+                getUnknownThing: {},
+                patchOrphan: {},
+            },
+        };
+        const tags = generateTags(api, tagTypes);
+        expect(tags.getUnknownThing).toBeUndefined();
+        expect(tags.patchOrphan).toBeUndefined();
+    });
+    it("returns an empty object for an empty endpoint list", () => {
+        const tags = generateTags({ endpoints: {} }, tagTypes);
+        expect(tags).toEqual({});
+    });
+    it("ignores endpoints that are not get/patch/delete", () => {
+        const api = {
+            endpoints: {
+                postUser: {},
+            },
+        };
+        const tags = generateTags(api, tagTypes);
+        expect(tags.postUser).toBeUndefined();
+    });
+});
+//# sourceMappingURL=tagGenerator.test.js.map

package/dist/tagGenerator.test.js.map

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

package/dist/testPreload.test.d.ts

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

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

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

package/dist/testPreload.test.js

@@ -0,0 +1,27 @@
+import { describe, expect, it } from "bun:test";
+// Invoke the mocked module factories registered in test-preload.ts so
+// their bodies (and returned functions) are recognised as covered.
+describe("test-preload default mocks", () => {
+    it("expo-secure-store mock returns a no-op store", async () => {
+        const SecureStore = await import("expo-secure-store");
+        await SecureStore.setItemAsync("k", "v");
+        await SecureStore.deleteItemAsync("k");
+        expect(await SecureStore.getItemAsync("k")).toBeNull();
+    });
+    it("AsyncStorage mock returns a no-op store", async () => {
+        const AsyncStorage = (await import("@react-native-async-storage/async-storage")).default;
+        await AsyncStorage.setItem("k", "v");
+        await AsyncStorage.removeItem("k");
+        expect(await AsyncStorage.getItem("k")).toBeNull();
+    });
+    it("expo-network mock reports a connected network", async () => {
+        const network = await import("expo-network");
+        const state = await network.getNetworkStateAsync();
+        expect(state.isConnected).toBe(true);
+    });
+    it("expo-constants mock exposes an empty config", async () => {
+        const Constants = (await import("expo-constants")).default;
+        expect(Constants.expoConfig?.extra).toBeDefined();
+    });
+});
+//# sourceMappingURL=testPreload.test.js.map

package/dist/testPreload.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testPreload.test.js","sourceRoot":"","sources":["../src/testPreload.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAC,MAAM,UAAU,CAAC;AAE9C,sEAAsE;AACtE,mEAAmE;AACnE,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACtD,MAAM,WAAW,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzC,MAAM,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC,CAAC,OAAO,CAAC;QACzF,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,SAAS,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3D,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/useFeatureFlags.d.ts

@@ -23,6 +23,30 @@ interface UseFeatureFlagsResult {
  * const variant = getVariant("checkout-experiment");           // "control" | "variant-a" | null
  * ```
  */
-export declare const useFeatureFlags: (api: Api<any, any, any, any>, basePath?: string) => UseFeatureFlagsResult;
+export interface UseFeatureFlagsOptions {
+    /**
+     * Base path for the feature-flags endpoint. Defaults to "/feature-flags".
+     */
+    basePath?: string;
+    /**
+     * When true, the underlying evaluate query is not fired. Use this to avoid
+     * fetching before the user is authenticated.
+     */
+    skip?: boolean;
+}
+interface ResolvedFeatureFlagsOptions {
+    basePath: string;
+    skip: boolean;
+}
+/**
+ * Normalizes the legacy-compatible `basePathOrOptions` argument into a
+ * `{basePath, skip}` pair with defaults applied.
+ *
+ * - `undefined` -> `{basePath: "/feature-flags", skip: false}`
+ * - `string`    -> `{basePath: <string>, skip: false}` (legacy form)
+ * - `object`    -> `{basePath: opts.basePath ?? "/feature-flags", skip: opts.skip ?? false}`
+ */
+export declare const resolveFeatureFlagsOptions: (basePathOrOptions?: string | UseFeatureFlagsOptions) => ResolvedFeatureFlagsOptions;
+export declare function useFeatureFlags(api: Api<any, any, any, any>, basePathOrOptions?: string | UseFeatureFlagsOptions): UseFeatureFlagsResult;
 export {};
 //# sourceMappingURL=useFeatureFlags.d.ts.map

package/dist/useFeatureFlags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureFlags.d.ts","sourceRoot":"","sources":["../src/useFeatureFlags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,8BAA8B,CAAC;AAGtD,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;AAE1D,UAAU,qBAAqB;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAE1B,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC5B,iBAA2B,KAC1B,qBAuFF,CAAC"}
+{"version":3,"file":"useFeatureFlags.d.ts","sourceRoot":"","sources":["../src/useFeatureFlags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,8BAA8B,CAAC;AAGtD,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;AAE1D,UAAU,qBAAqB;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,2BAA2B;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,oBAAoB,MAAM,GAAG,sBAAsB,KAClD,2BAMF,CAAC;AAIF,wBAAgB,eAAe,CAE7B,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,sBAAsB,GAClD,qBAAqB,CAyFvB"}

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