export type QueryErrorKind = "malformed" | "missing" | "not_integer" | "out_of_range";export class QueryError extends Error { readonly param?: string; readonly raw?: string; readonly value?: number; constructor( public readonly kind: QueryErrorKind, detail: { param?: string; raw?: string; value?: number } = {}, ) { super(kind); Object.assign(this, detail); }}const decode = (s: string): string | undefined => { try { return decodeURIComponent(s.replace(/\+/g, " ")); } catch { return undefined; }};/** Returns undefined when the parameter is absent. Throws QueryError ("malformed"). */export function getParam(query: string, name: string): string | undefined { const q = query.startsWith("?") ? query.slice(1) : query; for (const segment of q.split("&")) { if (segment === "") continue; const eq = segment.indexOf("="); const key = decode(eq < 0 ? segment : segment.slice(0, eq)); if (key === undefined || key !== name) continue; const value = decode(eq < 0 ? "" : segment.slice(eq + 1)); if (value === undefined) throw new QueryError("malformed", { param: name }); return value; } return undefined;}/** Throws QueryError. */export function getIntParam(query: string, name: string, range: { min: number; max: number }): number { const raw = getParam(query, name); if (raw === undefined) throw new QueryError("missing"); if (!/^-?[0-9]+$/.test(raw)) throw new QueryError("not_integer", { raw }); const value = Number(raw); if (value < range.min || value > range.max) throw new QueryError("out_of_range", { value }); return value;}