feat(api): publish the v1.43 contract with routes that answer 501 until filled

Every new endpoint of the contract exists, wrapped in apiHandler, with its
authentication, module gate and request validation, and answers
501 not_implemented until its behaviour lands. The OpenAPI document carries
the new operations and schemas and the additive response fields on the
changed routes. The four server feature flags are published as false.

contract-stub-inventory.test.ts registers the stubbed routes; each one
leaves the register with the change that fills it. The route, sharing,
session, security, module-gate and outcome inventories name the new routes
deliberately, and the error-code catalogue lists the codes the routes emit
today.
This commit is contained in:
Marc-André Bombeck committed 2026-10-15 21:49:02 +02:00
1 parent 6e72de1c35
commit 3786deb503
74 files changed
+6614 -282

No files matched your search

+50
View File
@@ -0,0 +1,50 @@
/**
* `POST /api/labs/{id}/links` — file documents (the report it was read
* from) or visits against a lab result.
* `DELETE /api/labs/{id}/links` — unfile them.
*
* `{ targetKind, targetIds }` in, `{ changed, unknown }` out, through the
* shared link service like the visit and vaccination link routes; an id that
* names nothing this account owns comes back in `unknown`. Own account only,
* as the other link routes.
*/
import { NextRequest } from "next/server";
import { apiHandler, requireAuth } from "@/lib/api-handler";
import { returnAllZodIssues, safeJson } from "@/lib/api-response";
import { notImplemented } from "@/lib/http/not-implemented";
import { labResultLinkSchema } from "@/lib/validations/relation-links";
type RouteParams = { params: Promise<{ id: string }> };
async function handle(
request: NextRequest,
{ params }: RouteParams,
verb: "link" | "unlink",
): Promise<Response> {
await requireAuth();
await params;
const { data: body, error: jsonError } = await safeJson(request, {
maxBytes: 16 * 1024,
});
if (jsonError) return jsonError;
const parsed = labResultLinkSchema.safeParse(body);
if (!parsed.success) {
return returnAllZodIssues(parsed.error, 422, {
errorCode: "labs.link.invalid",
});
}
return notImplemented(`labs.link.${verb}`);
}
export const POST = apiHandler(
async (request: NextRequest, context: RouteParams) =>
handle(request, context, "link"),
);
export const DELETE = apiHandler(
async (request: NextRequest, context: RouteParams) =>
handle(request, context, "unlink"),
);