mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-17 15:42:24 +00:00
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:
1 parent
6e72de1c35
commit
3786deb503
74 files changed
+6614
-282
No files matched your search
@@ -0,0 +1,34 @@
|
||||
/**
|
||||
* The answer of a route whose contract is published but whose behaviour has
|
||||
* not landed on this server yet.
|
||||
*
|
||||
* A route answers this only after it has authenticated the caller, resolved
|
||||
* the record, applied its module gate and validated the request exactly as
|
||||
* the published contract says, so a client already sees the real refusals
|
||||
* (401, 403, 404, 422, 429). What is missing is the effect, and the body says
|
||||
* so plainly instead of pretending: `501` with `errorCode: "not_implemented"`.
|
||||
* Nothing calls these routes in normal use: every client path to them sits
|
||||
* behind a server feature flag that stays `false` until the route is filled.
|
||||
*
|
||||
* `contract-stub-inventory.test.ts` freezes the set of route files that still
|
||||
* answer this; it has to be empty before a release is tagged.
|
||||
*/
|
||||
import { apiError } from "@/lib/api-response";
|
||||
import { annotate } from "@/lib/logging/context";
|
||||
|
||||
export const NOT_IMPLEMENTED_ERROR_CODE = "not_implemented";
|
||||
|
||||
/**
|
||||
* 501 for an operation whose contract exists and whose effect does not yet.
|
||||
* `operation` is a stable `<surface>.<noun>.<verb>` name for the wide event.
|
||||
*/
|
||||
export function notImplemented(operation: string): Response {
|
||||
annotate({
|
||||
action: { name: "contract.not_implemented" },
|
||||
meta: { operation },
|
||||
});
|
||||
return apiError("Not implemented on this server yet", 501, {
|
||||
errorCode: NOT_IMPLEMENTED_ERROR_CODE,
|
||||
operation,
|
||||
});
|
||||
}
|
||||
Reference in new issue
Block a user