// @vitest-environment jsdom
import { act, render, waitFor } from "@testing-library/react";
import { QueryClient, useQueryClient } from "@tanstack/react-query";
import { describe, expect, it } from "vitest";
import { createServerStateScopeRuntime } from "../../src/adapters/query-cache/server-state-scope-runtime.ts";
import { createServerStateGenerationStore } from "../../src/bootstrap/server-state-generation-store.ts";
import { useApplicationQuery } from "../../src/presentation/adapters/query/application-query.ts";
import { ServerStateGenerationProvider } from "../../src/presentation/adapters/query/server-state-generation-provider.tsx";
describe("server-state generation provider", () => {
it("remounts consumers with the QueryClient owned by the READY generation", async () => {
const store = createServerStateGenerationStore(() => {
const queryClient = new QueryClient({
defaultOptions: { queries: { retry: false }, mutations: { retry: false } },
});
return {
queryClient,
queryInvalidation: {
invalidate: async () => {},
beginMutation: () => ({ release: async () => {} }),
resetLocal: async () => {
await queryClient.cancelQueries();
queryClient.clear();
},
dispose() {},
},
crossContextStatus: () => "DEGRADED_LOCAL_ONLY" as const,
};
});
let sessionListener: () => void = () => {};
let token = 0;
const scope = createServerStateScopeRuntime({
session: {
subscribe(listener) {
sessionListener = listener;
return () => {};
},
},
queryInvalidation: { resetLocal: () => store.resetCurrent() },
activateNextGeneration: () => store.activateNext(),
tokenFactory: () =>
`scope-generation-provider-${String(token++).padStart(4, "0")}`,
});
const renderedClients: QueryClient[] = [];
const mutationIntentFactory = Object.freeze({
create() {
throw new Error("mutation intent is unused by this provider test");
},
});
function Probe() {
renderedClients.push(useQueryClient());
return
generation-content
;
}
render(
scope-transition}
>
,
);
const firstClient = renderedClients.at(-1);
if (!firstClient) throw new Error("expected initial QueryClient");
act(() => sessionListener());
await waitFor(() => expect(scope.getPhase()).toBe("READY"));
await waitFor(() =>
expect(renderedClients.at(-1)).toBe(store.getSnapshot().queryClient),
);
expect(renderedClients.at(-1)).not.toBe(firstClient);
scope.dispose();
store.dispose();
});
// 1101/08-03. A raw query has no scope check of its own. It still never
// shows the previous identity's answer: FENCED unmounts it, and READY
// mounts it again on the next generation's empty QueryClient.
it("never shows a raw query's previous-session answer after a session change", async () => {
const { store, scope, notifySession } = generationRuntime();
const answers: ((value: string) => void)[] = [];
function RawProbe() {
const query = useApplicationQuery({
queryKey: ["raw-profile"],
execute: () =>
new Promise((resolve) => {
answers.push((value) => resolve({ ok: true, value }));
}),
});
return {query.data ?? "no-data"}
;
}
const view = render(
scope-transition}
>
,
);
// Signed in as the first user: the answer is cached and shown.
await waitFor(() => expect(answers).toHaveLength(1));
act(() => answers[0]?.("first-user-cached"));
expect(await view.findByText("first-user-cached")).toBeVisible();
// A refetch starts, then the session changes before it answers.
act(() => {
void store.getSnapshot().queryClient.refetchQueries();
});
await waitFor(() => expect(answers).toHaveLength(2));
act(() => notifySession());
await waitFor(() => expect(scope.getPhase()).toBe("READY"));
await waitFor(() => expect(answers).toHaveLength(3));
// The first user's late answer arrives while the next one is loading.
act(() => answers[1]?.("first-user-late"));
expect(await view.findByText("no-data")).toBeVisible();
expect(view.container).not.toHaveTextContent("first-user");
act(() => answers[2]?.("second-user"));
expect(await view.findByText("second-user")).toBeVisible();
scope.dispose();
store.dispose();
});
});
const unusedMutationIntentFactory = Object.freeze({
create(): never {
throw new Error("mutation intent is unused by this provider test");
},
});
function generationRuntime() {
const store = createServerStateGenerationStore(() => {
const queryClient = new QueryClient({
defaultOptions: { queries: { retry: false }, mutations: { retry: false } },
});
return {
queryClient,
queryInvalidation: {
invalidate: async () => {},
beginMutation: () => ({ release: async () => {} }),
resetLocal: async () => {
await queryClient.cancelQueries();
queryClient.clear();
},
dispose() {},
},
crossContextStatus: () => "DEGRADED_LOCAL_ONLY" as const,
};
});
let sessionListener: () => void = () => {};
let token = 0;
const scope = createServerStateScopeRuntime({
session: {
subscribe(listener) {
sessionListener = listener;
return () => {};
},
},
queryInvalidation: { resetLocal: () => store.resetCurrent() },
activateNextGeneration: () => store.activateNext(),
tokenFactory: () =>
`scope-generation-raw-${String(token++).padStart(4, "0")}`,
});
return { store, scope, notifySession: () => sessionListener() };
}