Files
clean-architecture-frontend…/tests/features/reference-feature/reference-request-deduplication.test.ts

79 lines
2.6 KiB
TypeScript

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<typeof createQueryClient>,
reference: ReturnType<typeof referenceFeatureOver>,
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<Transport>(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<Transport>(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<Transport>(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();
});
});