import { badRequest } from "./errors"; type JsonBodyContext = { req: { json: () => Promise } }; /** * Parse a JSON request body, tolerating an empty/invalid body, and require a * plain object. The standard guard used by mutating routes; throws the same * `badRequest("Invalid payload")` the routes previously raised inline. */ export const parseJsonObjectBody = async ( ctx: JsonBodyContext, ): Promise> => { const body = await ctx.req.json().catch(() => ({})); if (!body || typeof body !== "object" || Array.isArray(body)) { throw badRequest("Invalid payload"); } return body as Record; }; export const optionalString = (record: Record, key: string): string | undefined => typeof record[key] === "string" ? (record[key] as string) : undefined; /** * Optional string-enum field. Matches the historical inline guards: values * that are missing, non-string, or empty are treated as absent; only a * non-empty string outside `values` is rejected. */ export const optionalEnum = ( record: Record, key: string, values: readonly T[], label?: string, ): T | undefined => { const value = optionalString(record, key); if (!value) return undefined; if (!values.includes(value as T)) throw badRequest(`Invalid ${label ?? key}`); return value as T; }; /** Interpret env-var style truthy strings ("1", "true", "yes", "on"). */ export const parseBooleanFlag = (raw: unknown): boolean => { if (typeof raw === "boolean") return raw; if (raw === undefined || raw === null) return false; const normalized = String(raw).trim().toLowerCase(); return ["1", "true", "yes", "on"].includes(normalized); };