fix(api): one helper for list pages, exact cut signal, total order

listPage (src/lib/http/list-query.ts) reads one row past the limit and
cuts it back, on top of the existing list-cap signal rather than beside
it. Every capped list now gets its page there, and every read passed to
it orders by something ending in the row id, so rows that share a sort
value cannot repeat or vanish at a page boundary.

- practitioners, vaccinations and encounters were cut at their take
  with no signal; they now answer meta.truncated and accept offset, and
  their web readers walk the pages instead of stopping at the first
- symptoms/events reported hasMore on a page that was exactly full; it
  is now true only when a row past the page exists
- the document list's hand-rolled limit + 1 goes through the helper
- security-activity answers an out-of-range limit with the 422 its
  published schema already promised instead of clamping it

list-page-guard binds every apiListSuccess route to listPage, forbids
hand-cut lists and length-derived hasMore, and requires the id
tiebreaker in every listPage read.
This commit is contained in:
Marc-André Bombeck committed 2026-10-20 13:29:14 +02:00
1 parent 2265763160
commit 8db7c71b0e
35 files changed
+1024 -394

No files matched your search

@@ -14,7 +14,13 @@
*/
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { apiDelete, apiGet, apiPatch, apiPost } from "@/lib/api/api-fetch";
import {
apiDelete,
apiGet,
apiGetList,
apiPatch,
apiPost,
} from "@/lib/api/api-fetch";
import { invalidateReminderReads } from "@/hooks/use-measurement-reminders";
import {
invalidateKeys,
@@ -52,6 +58,7 @@ export interface VaccinationWriteBody {
}
const BASE = "/api/vaccinations";
const VACCINATION_PAGE_SIZE = 300;
/**
* The account's immunization log, newest dose first.
@@ -64,12 +71,33 @@ export function useVaccinations(antigenSlug?: string | null, enabled = true) {
return useQuery({
queryKey: queryKeys.vaccinationList(antigenSlug ?? null),
enabled,
queryFn: () =>
apiGet<VaccinationListDTO>(
antigenSlug
? `${BASE}?antigenSlug=${encodeURIComponent(antigenSlug)}`
: BASE,
),
// The route pages and says whether another page exists; the log is read
// to the end. `renewals` is the same on every page, so the first is kept.
queryFn: async () => {
const page = (offset: number) => {
const sp = new URLSearchParams({
limit: String(VACCINATION_PAGE_SIZE),
offset: String(offset),
});
if (antigenSlug) sp.set("antigenSlug", antigenSlug);
return apiGetList<VaccinationListDTO>(
`/api/vaccinations?${sp.toString()}`,
);
};
const first = await page(0);
const vaccinations = [...first.data.vaccinations];
let cap = first.cap;
for (
let offset = VACCINATION_PAGE_SIZE;
cap?.truncated;
offset += VACCINATION_PAGE_SIZE
) {
const next = await page(offset);
vaccinations.push(...next.data.vaccinations);
cap = next.cap;
}
return { ...first.data, vaccinations };
},
});
}