import { describe, expect, it, vi } from "vitest"; import { createQueryClient, QUERY_CACHE_DEFAULTS, } from "../../../src/adapters/query-cache/tanstack-query-cache.ts"; import { jsonRows, networkFailure, type Transport, } from "../../helpers/traffic-test-kit.ts"; import { referenceFeatureOver } from "./reference-traffic-kit.ts"; /** * Spec ยง16. Multiple consumers of one query identity must not imply multiple * physical requests. TanStack Query owns in-flight coalescing; this suite pins * that the installed query client plus the real V3 executor keep it that way. */ describe("request deduplication and coalescing", () => { function loadSameQuery( client: ReturnType, reference: ReturnType, key: readonly unknown[] = ["reference", "list", { limit: 20 }], ) { return client.fetchQuery({ queryKey: key, queryFn: ({ signal }) => reference.listResources({ limit: 20 }, { signal }), }); } it("coalesces concurrent consumers of the same query identity", async () => { const transport = vi.fn(async () => jsonRows(3)); const reference = referenceFeatureOver(transport); const client = createQueryClient(); const results = await Promise.all([ loadSameQuery(client, reference), loadSameQuery(client, reference), loadSameQuery(client, reference), ]); expect(transport).toHaveBeenCalledTimes(1); expect(results.every((result) => result.ok)).toBe(true); client.clear(); }); it("keeps distinct query identities as distinct physical requests", async () => { const transport = vi.fn(async () => jsonRows(1)); const reference = referenceFeatureOver(transport); const client = createQueryClient(); await Promise.all([ loadSameQuery(client, reference, ["reference", "list", 1]), loadSameQuery(client, reference, ["reference", "list", 2]), ]); expect(transport).toHaveBeenCalledTimes(2); client.clear(); }); it("does not stack a query-layer retry on top of the executor retry budget", async () => { expect(QUERY_CACHE_DEFAULTS.retry).toBe(false); expect(QUERY_CACHE_DEFAULTS.mutationRetry).toBe(false); const transport = vi.fn(networkFailure); const reference = referenceFeatureOver(transport, { maxRetryAttempts: 2 }); const client = createQueryClient(); await Promise.all([ loadSameQuery(client, reference), loadSameQuery(client, reference), ]); // One coalesced logical execution: 1 attempt + at most 2 executor retries. expect(transport.mock.calls.length).toBeLessThanOrEqual(3); client.clear(); }); });