@ddd-ts-kit/http 0.0.0-stage → 0.1.0

package/dist/pipeline/execute-route.js

@@ -0,0 +1,108 @@
+import { createErrorMapper } from '../error/create-error-mapper.js';
+import { toProblem } from '../error/to-problem.js';
+import { assertDeclaredResponse } from './assert-declared-response.js';
+import { CORRELATION_HEADER } from './correlation-header.js';
+import { correlationIdOf } from './correlation-id-of.js';
+import { executionOfRequest } from './execution-of-request.js';
+import { validateRequest } from './validate-request.js';
+import { wellFormedIdentifier } from './well-formed-identifier.js';
+const defaultErrorMapper = createErrorMapper();
+const JSON_CONTENT_TYPE = 'application/json; charset=utf-8';
+const PROBLEM_CONTENT_TYPE = 'application/problem+json; charset=utf-8';
+export async function executeRoute(route, request, options = {}) {
+    const requestId = (options.requestId ?? defaultRequestId)(request);
+    const correlationId = correlationIdOf(request.headers, requestId);
+    const call = { route, request, options, requestId, correlationId, reached: {} };
+    const respond = () => responded(call);
+    return options.around === undefined ? respond() : options.around(route, respond);
+}
+async function responded(call) {
+    try {
+        return answer(await handled(call), call);
+    }
+    catch (error) {
+        return refusal(error, call);
+    }
+}
+function defaultRequestId(request) {
+    return wellFormedIdentifier(request.headers['x-request-id']) ?? globalThis.crypto.randomUUID();
+}
+async function handled(call) {
+    const { route, request, options, requestId, correlationId } = call;
+    const principal = await options.resolvePrincipal?.(request.raw);
+    const input = validateRequest(route, request);
+    const { headers } = request;
+    const execution = executionOfRequest({ correlationId, headers, principal, deadline: deadlineOf(options) });
+    call.reached.execution = execution;
+    const context = {
+        requestId,
+        execution,
+        raw: request.raw,
+        ...(principal === undefined ? {} : { principal }),
+    };
+    const handle = async () => route.handle({ ...input, context });
+    const asPrincipal = () => options.withPrincipal?.(principal, handle) ?? handle();
+    const result = await (options.executionScope?.run(execution, asPrincipal) ?? asPrincipal());
+    if (options.validateResponses === true) {
+        assertDeclaredResponse(route, result);
+    }
+    return result;
+}
+function deadlineOf(options) {
+    if (options.requestTimeoutMs === undefined) {
+        return undefined;
+    }
+    const arrivedAt = options.clock?.now() ?? new Date();
+    return new Date(arrivedAt.getTime() + options.requestTimeoutMs);
+}
+function answer(result, call) {
+    return {
+        status: result.status,
+        headers: {
+            ...defaultContentType(result.body),
+            ...lowerCaseKeys(result.headers ?? {}),
+            ...identifierHeaders(call),
+        },
+        ...(result.body === undefined ? {} : { body: result.body }),
+    };
+}
+function defaultContentType(body) {
+    if (body === undefined) {
+        return {};
+    }
+    return { 'content-type': body instanceof Uint8Array ? 'application/octet-stream' : JSON_CONTENT_TYPE };
+}
+function lowerCaseKeys(headers) {
+    return Object.fromEntries(Object.entries(headers).map(([name, value]) => [name.toLowerCase(), value]));
+}
+function identifierHeaders({ requestId, correlationId }) {
+    return { 'x-request-id': requestId, [CORRELATION_HEADER]: correlationId };
+}
+function refusal(error, call) {
+    const { route, options, requestId, correlationId } = call;
+    const { execution } = call.reached;
+    const problem = toProblem(error, options.errorMapper ?? defaultErrorMapper, requestId);
+    notify(options, error, {
+        requestId,
+        correlationId,
+        operationId: route.operationId,
+        method: route.method,
+        path: route.path,
+        problem,
+        ...(execution === undefined ? {} : { execution }),
+    });
+    return {
+        status: problem.status,
+        headers: { 'content-type': PROBLEM_CONTENT_TYPE, ...identifierHeaders(call) },
+        body: problem,
+    };
+}
+function notify(options, error, context) {
+    try {
+        options.onError?.(error, context);
+    }
+    catch {
+        // A failing logger must not turn an answered request into a crash.
+    }
+}
+//# sourceMappingURL=execute-route.js.map

package/dist/pipeline/execute-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-route.js","sourceRoot":"","sources":["../../src/pipeline/execute-route.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/execution-of-request.d.ts

@@ -0,0 +1,16 @@
+import { type ExecutionContext } from '@ddd-ts-kit/kernel';
+import type { RawHeaders } from '../route/raw-headers.js';
+export interface RequestExecution {
+    readonly correlationId: string;
+    readonly headers: Readonly<RawHeaders>;
+    /** What `resolvePrincipal` answered: a `Session`, an `Actor`, or anything else. */
+    readonly principal: unknown;
+    readonly deadline: Date | undefined;
+}
+/**
+ * The execution context of one HTTP request. A principal shaped like a `Session` gives the
+ * session and its actor, one shaped like an `Actor` gives the actor, anything else is the
+ * anonymous actor: the pipeline does not know how the project authenticates.
+ */
+export declare function executionOfRequest(request: RequestExecution): ExecutionContext;
+//# sourceMappingURL=execution-of-request.d.ts.map

package/dist/pipeline/execution-of-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-of-request.d.ts","sourceRoot":"","sources":["../../src/pipeline/execution-of-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EAEtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,SAAS,CAAC;CACrC;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAY9E"}

package/dist/pipeline/execution-of-request.js

@@ -0,0 +1,44 @@
+import { anonymousActor, executionContext, isActor, isSession, } from '@ddd-ts-kit/kernel';
+const LANGUAGE_TAG = /^[A-Za-z]{1,8}(?:-[A-Za-z0-9]{1,8})*$/;
+/**
+ * The execution context of one HTTP request. A principal shaped like a `Session` gives the
+ * session and its actor, one shaped like an `Actor` gives the actor, anything else is the
+ * anonymous actor: the pipeline does not know how the project authenticates.
+ */
+export function executionOfRequest(request) {
+    const session = isSession(request.principal) ? request.principal : undefined;
+    const locale = session?.locale ?? preferredLanguage(request.headers['accept-language']);
+    return executionContext({
+        correlationId: request.correlationId,
+        actor: actorOfPrincipal(request.principal, session),
+        origin: 'http',
+        ...(session === undefined ? {} : { session }),
+        ...(locale === undefined ? {} : { locale }),
+        ...(request.deadline === undefined ? {} : { deadline: request.deadline }),
+    });
+}
+function actorOfPrincipal(principal, session) {
+    if (session !== undefined) {
+        return session.actor;
+    }
+    return isActor(principal) ? principal : anonymousActor();
+}
+/** The tag of `Accept-Language` with the highest quality, the first one among equals. */
+function preferredLanguage(header) {
+    if (typeof header !== 'string') {
+        return undefined;
+    }
+    const ranked = header
+        .split(',')
+        .map(weightedTag)
+        .filter(({ tag, quality }) => LANGUAGE_TAG.test(tag) && quality > 0)
+        .sort((a, b) => b.quality - a.quality);
+    return ranked[0]?.tag;
+}
+function weightedTag(range) {
+    const [tag = '', ...parameters] = range.split(';').map((part) => part.trim());
+    const weight = parameters.find((parameter) => parameter.startsWith('q='));
+    const quality = weight === undefined ? 1 : Number(weight.slice(2));
+    return { tag, quality: Number.isFinite(quality) ? quality : 0 };
+}
+//# sourceMappingURL=execution-of-request.js.map

package/dist/pipeline/execution-of-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-of-request.js","sourceRoot":"","sources":["../../src/pipeline/execution-of-request.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/raw-request.d.ts

@@ -0,0 +1,10 @@
+import type { RawHeaders } from '../route/raw-headers.js';
+/** What an adapter extracts from its framework before handing over to `executeRoute`. */
+export interface RawRequest {
+    readonly params: unknown;
+    readonly query: unknown;
+    readonly headers: RawHeaders;
+    readonly body: unknown;
+    readonly raw: unknown;
+}
+//# sourceMappingURL=raw-request.d.ts.map

package/dist/pipeline/raw-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-request.d.ts","sourceRoot":"","sources":["../../src/pipeline/raw-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB"}

package/dist/pipeline/raw-request.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=raw-request.js.map

package/dist/pipeline/raw-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-request.js","sourceRoot":"","sources":["../../src/pipeline/raw-request.ts"],"names":[],"mappings":""}

package/dist/pipeline/report-http-errors.d.ts

@@ -0,0 +1,11 @@
+import { type ErrorReporter } from '@ddd-ts-kit/kernel';
+import type { ErrorContext } from './error-context.js';
+/**
+ * The `onError` hook that reports every request answered as a server fault: an unexpected
+ * error, or a `DomainError` whose code the error mapper answers with a 5xx. A refusal (4xx) is
+ * an answer and is left alone, and so is a failure a bus middleware already reported.
+ *
+ *     const options: ExecuteOptions = { onError: reportHttpErrors(errors) };
+ */
+export declare function reportHttpErrors(reporter: ErrorReporter): (error: unknown, context: ErrorContext) => void;
+//# sourceMappingURL=report-http-errors.d.ts.map

package/dist/pipeline/report-http-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-http-errors.d.ts","sourceRoot":"","sources":["../../src/pipeline/report-http-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAYzG"}

package/dist/pipeline/report-http-errors.js

@@ -0,0 +1,17 @@
+import { errorReportOf, reportOnce } from '@ddd-ts-kit/kernel';
+/**
+ * The `onError` hook that reports every request answered as a server fault: an unexpected
+ * error, or a `DomainError` whose code the error mapper answers with a 5xx. A refusal (4xx) is
+ * an answer and is left alone, and so is a failure a bus middleware already reported.
+ *
+ *     const options: ExecuteOptions = { onError: reportHttpErrors(errors) };
+ */
+export function reportHttpErrors(reporter) {
+    return (error, { problem, operationId, correlationId, execution }) => {
+        if (problem.status < 500) {
+            return;
+        }
+        reportOnce(reporter, error, errorReportOf(error, { origin: 'http', operation: operationId, correlationId }, execution));
+    };
+}
+//# sourceMappingURL=report-http-errors.js.map

package/dist/pipeline/report-http-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-http-errors.js","sourceRoot":"","sources":["../../src/pipeline/report-http-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAsB,MAAM,oBAAoB,CAAC;AAGnF;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAuB;IACtD,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,EAAE;QACnE,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,UAAU,CACR,QAAQ,EACR,KAAK,EACL,aAAa,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,SAAS,CAAC,CAC3F,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/pipeline/route-around.d.ts

@@ -0,0 +1,5 @@
+import type { Route } from '../route/route.js';
+import type { RouteResponse } from './route-response.js';
+/** What observes a request from outside: it is told the route that was matched and must answer what `respond` answers. */
+export type RouteAround = (route: Pick<Route, 'method' | 'path' | 'operationId'>, respond: () => Promise<RouteResponse>) => Promise<RouteResponse>;
+//# sourceMappingURL=route-around.d.ts.map

package/dist/pipeline/route-around.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-around.d.ts","sourceRoot":"","sources":["../../src/pipeline/route-around.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,0HAA0H;AAC1H,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC,EACrD,OAAO,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,KAClC,OAAO,CAAC,aAAa,CAAC,CAAC"}

package/dist/pipeline/route-around.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=route-around.js.map

package/dist/pipeline/route-around.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-around.js","sourceRoot":"","sources":["../../src/pipeline/route-around.ts"],"names":[],"mappings":""}

package/dist/pipeline/route-response.d.ts

@@ -0,0 +1,7 @@
+export interface RouteResponse {
+    readonly status: number;
+    /** Lower-case names. `content-type` is set whenever there is a body. */
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+}
+//# sourceMappingURL=route-response.d.ts.map

package/dist/pipeline/route-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-response.d.ts","sourceRoot":"","sources":["../../src/pipeline/route-response.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/pipeline/route-response.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=route-response.js.map

package/dist/pipeline/route-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-response.js","sourceRoot":"","sources":["../../src/pipeline/route-response.ts"],"names":[],"mappings":""}

package/dist/pipeline/serialize-body.d.ts

@@ -0,0 +1,7 @@
+import type { RouteResponse } from './route-response.js';
+/**
+ * The bytes every adapter writes, so the three frameworks answer identically. A string or
+ * binary body is sent as is when the handler chose its own content type; anything else is JSON.
+ */
+export declare function serializeBody(response: RouteResponse): string | Uint8Array | undefined;
+//# sourceMappingURL=serialize-body.d.ts.map

package/dist/pipeline/serialize-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-body.d.ts","sourceRoot":"","sources":["../../src/pipeline/serialize-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CActF"}

package/dist/pipeline/serialize-body.js

@@ -0,0 +1,16 @@
+/**
+ * The bytes every adapter writes, so the three frameworks answer identically. A string or
+ * binary body is sent as is when the handler chose its own content type; anything else is JSON.
+ */
+export function serializeBody(response) {
+    const { body } = response;
+    if (body === undefined) {
+        return undefined;
+    }
+    if (body instanceof Uint8Array) {
+        return body;
+    }
+    const isJson = /[/+]json\b/.test(response.headers['content-type'] ?? '');
+    return typeof body === 'string' && !isJson ? body : JSON.stringify(body);
+}
+//# sourceMappingURL=serialize-body.js.map

package/dist/pipeline/serialize-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-body.js","sourceRoot":"","sources":["../../src/pipeline/serialize-body.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAuB;IACnD,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;IAE1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IAEzE,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC3E,CAAC"}

package/dist/pipeline/validate-request.d.ts

@@ -0,0 +1,8 @@
+import type { Route } from '../route/route.js';
+import type { RawRequest } from './raw-request.js';
+type Part = 'params' | 'query' | 'headers' | 'body';
+type ValidatedRequest = Record<Part, unknown>;
+/** Every part through its schema; the issues of all parts are reported together. */
+export declare function validateRequest(route: Route, request: RawRequest): ValidatedRequest;
+export {};
+//# sourceMappingURL=validate-request.d.ts.map

package/dist/pipeline/validate-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-request.d.ts","sourceRoot":"","sources":["../../src/pipeline/validate-request.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,KAAK,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,KAAK,gBAAgB,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAQ9C,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,gBAAgB,CAenF"}

package/dist/pipeline/validate-request.js

@@ -0,0 +1,30 @@
+import { ValidationError } from '@ddd-ts-kit/validation';
+/** Every part through its schema; the issues of all parts are reported together. */
+export function validateRequest(route, request) {
+    const reading = { route, request, issues: [] };
+    const input = {
+        params: parsePart(reading, 'params'),
+        query: parsePart(reading, 'query'),
+        headers: parsePart(reading, 'headers'),
+        body: parsePart(reading, 'body'),
+    };
+    if (reading.issues.length > 0) {
+        throw new ValidationError(reading.issues, 'The request is not valid.');
+    }
+    return input;
+}
+function parsePart({ route, request, issues }, part) {
+    const schema = route.request?.[part];
+    if (schema === undefined) {
+        return request[part];
+    }
+    const result = schema.parse(request[part]);
+    if (result.ok) {
+        return result.value;
+    }
+    for (const issue of result.error) {
+        issues.push({ ...issue, path: issue.path === '' ? part : `${part}.${issue.path}` });
+    }
+    return undefined;
+}
+//# sourceMappingURL=validate-request.js.map

package/dist/pipeline/validate-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-request.js","sourceRoot":"","sources":["../../src/pipeline/validate-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwB,MAAM,wBAAwB,CAAC;AAc/E,oFAAoF;AACpF,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,OAAmB;IAC/D,MAAM,OAAO,GAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAExD,MAAM,KAAK,GAAG;QACZ,MAAM,EAAE,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;QACpC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;QAClC,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;QACtC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;KACjC,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAW,EAAE,IAAU;IAChE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAErC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/pipeline/well-formed-identifier.d.ts

@@ -0,0 +1,3 @@
+/** A header value usable as an identifier in logs and response headers, else `undefined`. */
+export declare function wellFormedIdentifier(value: string | string[] | undefined): string | undefined;
+//# sourceMappingURL=well-formed-identifier.d.ts.map

package/dist/pipeline/well-formed-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-formed-identifier.d.ts","sourceRoot":"","sources":["../../src/pipeline/well-formed-identifier.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7F"}

package/dist/pipeline/well-formed-identifier.js

@@ -0,0 +1,6 @@
+const IDENTIFIER_PATTERN = /^[A-Za-z0-9._:-]{1,128}$/;
+/** A header value usable as an identifier in logs and response headers, else `undefined`. */
+export function wellFormedIdentifier(value) {
+    return typeof value === 'string' && IDENTIFIER_PATTERN.test(value) ? value : undefined;
+}
+//# sourceMappingURL=well-formed-identifier.js.map

package/dist/pipeline/well-formed-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-formed-identifier.js","sourceRoot":"","sources":["../../src/pipeline/well-formed-identifier.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD,6FAA6F;AAC7F,MAAM,UAAU,oBAAoB,CAAC,KAAoC;IACvE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACzF,CAAC"}

package/dist/route/assert-unique-routes.d.ts

@@ -0,0 +1,3 @@
+import type { Route } from './route.js';
+export declare function assertUniqueRoutes(routes: readonly Route[]): void;
+//# sourceMappingURL=assert-unique-routes.d.ts.map

package/dist/route/assert-unique-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-unique-routes.d.ts","sourceRoot":"","sources":["../../src/route/assert-unique-routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI,CAsBjE"}

package/dist/route/assert-unique-routes.js

@@ -0,0 +1,22 @@
+import { DuplicateRouteError } from './duplicate-route-error.js';
+export function assertUniqueRoutes(routes) {
+    const operationIds = new Set();
+    const endpoints = new Map();
+    for (const route of routes) {
+        if (operationIds.has(route.operationId)) {
+            throw new DuplicateRouteError(`Duplicate operationId "${route.operationId}".`);
+        }
+        operationIds.add(route.operationId);
+        const key = routeKey(route);
+        const other = endpoints.get(key);
+        if (other !== undefined) {
+            throw new DuplicateRouteError(`"${route.operationId}" and "${other}" both declare ${route.method} ${route.path}.`);
+        }
+        endpoints.set(key, route.operationId);
+    }
+}
+/** `/orders/:orderId` and `/orders/:id` are the same endpoint for a router. */
+function routeKey(route) {
+    return `${route.method} ${route.path.replace(/:[^/]+/g, ':')}`;
+}
+//# sourceMappingURL=assert-unique-routes.js.map

package/dist/route/assert-unique-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-unique-routes.js","sourceRoot":"","sources":["../../src/route/assert-unique-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIjE,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,mBAAmB,CAAC,0BAA0B,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;QACjF,CAAC;QAED,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAEpC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,mBAAmB,CAC3B,IAAI,KAAK,CAAC,WAAW,UAAU,KAAK,kBAAkB,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,CACpF,CAAC;QACJ,CAAC;QAED,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAS,QAAQ,CAAC,KAAgB;IAChC,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/route/define-route.d.ts

@@ -0,0 +1,7 @@
+import type { RequestSchemas } from './request-schemas.js';
+import type { ResponsesSpec } from './responses-spec.js';
+import type { RouteHandler } from './route-handler.js';
+import type { RouteSpec } from './route-spec.js';
+import type { Route } from './route.js';
+export declare function defineRoute<const Request extends RequestSchemas, const Responses extends ResponsesSpec>(spec: RouteSpec<Request, Responses>, handler: RouteHandler<Request, Responses>): Route;
+//# sourceMappingURL=define-route.d.ts.map

package/dist/route/define-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-route.d.ts","sourceRoot":"","sources":["../../src/route/define-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,wBAAgB,WAAW,CAAC,KAAK,CAAC,OAAO,SAAS,cAAc,EAAE,KAAK,CAAC,SAAS,SAAS,aAAa,EACrG,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,EACnC,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,GACxC,KAAK,CAUP"}

package/dist/route/define-route.js

@@ -0,0 +1,17 @@
+const PATH_PATTERN = /^\/$|^(\/(:[A-Za-z_][A-Za-z0-9_]*|[A-Za-z0-9._~-]+))+$/;
+export function defineRoute(spec, handler) {
+    if (!PATH_PATTERN.test(spec.path)) {
+        throw new Error(`Route "${spec.operationId}": the path "${spec.path}" must be made of literal segments and ":name" parameters.`);
+    }
+    assertSecurityDeclared(spec);
+    return { ...spec, handle: handler };
+}
+// Checked at run time too: a JavaScript caller, or a spec built dynamically, gets no compile error.
+function assertSecurityDeclared(spec) {
+    const { security } = spec;
+    if (security === false || (Array.isArray(security) && security.length > 0)) {
+        return;
+    }
+    throw new Error(`Route "${spec.operationId}": declare "security" with the names of its security schemes, or false for a public route.`);
+}
+//# sourceMappingURL=define-route.js.map

package/dist/route/define-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-route.js","sourceRoot":"","sources":["../../src/route/define-route.ts"],"names":[],"mappings":"AAMA,MAAM,YAAY,GAAG,wDAAwD,CAAC;AAE9E,MAAM,UAAU,WAAW,CACzB,IAAmC,EACnC,OAAyC;IAEzC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,CAAC,WAAW,gBAAgB,IAAI,CAAC,IAAI,4DAA4D,CAChH,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAE7B,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,oGAAoG;AACpG,SAAS,sBAAsB,CAAC,IAAsE;IACpG,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE1B,IAAI,QAAQ,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,CAAC,WAAW,4FAA4F,CACvH,CAAC;AACJ,CAAC"}

package/dist/route/define-routes.d.ts

@@ -0,0 +1,4 @@
+import type { Route } from './route.js';
+/** Gathers routes (or groups of routes) into one list and refuses duplicates. */
+export declare function defineRoutes(...routes: readonly (Route | readonly Route[])[]): readonly Route[];
+//# sourceMappingURL=define-routes.d.ts.map

package/dist/route/define-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-routes.d.ts","sourceRoot":"","sources":["../../src/route/define-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,GAAG,MAAM,EAAE,SAAS,CAAC,KAAK,GAAG,SAAS,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,KAAK,EAAE,CAM/F"}

package/dist/route/define-routes.js

@@ -0,0 +1,11 @@
+import { assertUniqueRoutes } from './assert-unique-routes.js';
+/** Gathers routes (or groups of routes) into one list and refuses duplicates. */
+export function defineRoutes(...routes) {
+    const flat = routes.flatMap((entry) => (isRouteList(entry) ? entry : [entry]));
+    assertUniqueRoutes(flat);
+    return flat;
+}
+function isRouteList(entry) {
+    return Array.isArray(entry);
+}
+//# sourceMappingURL=define-routes.js.map

package/dist/route/define-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-routes.js","sourceRoot":"","sources":["../../src/route/define-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,GAAG,MAA6C;IAC3E,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAoB,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEjG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAEzB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,KAA+B;IAClD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/route/duplicate-route-error.d.ts

@@ -0,0 +1,4 @@
+export declare class DuplicateRouteError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=duplicate-route-error.d.ts.map

package/dist/route/duplicate-route-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-route-error.d.ts","sourceRoot":"","sources":["../../src/route/duplicate-route-error.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/dist/route/duplicate-route-error.js

@@ -0,0 +1,7 @@
+export class DuplicateRouteError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DuplicateRouteError';
+    }
+}
+//# sourceMappingURL=duplicate-route-error.js.map

package/dist/route/duplicate-route-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-route-error.js","sourceRoot":"","sources":["../../src/route/duplicate-route-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/route/handler-input.d.ts

@@ -0,0 +1,23 @@
+import type { Schema } from '@ddd-ts-kit/validation';
+import type { RawHeaders } from './raw-headers.js';
+import type { RequestContext } from './request-context.js';
+import type { RequestSchemas } from './request-schemas.js';
+interface PartDefaults {
+    params: Record<string, string>;
+    query: Record<string, unknown>;
+    headers: RawHeaders;
+    body: unknown;
+}
+type PartOf<Request, Part extends keyof PartDefaults> = Request extends {
+    readonly [K in Part]: Schema<infer T>;
+} ? T : PartDefaults[Part];
+/** What a handler receives: each part has the type its schema produces. */
+export interface HandlerInput<Request extends RequestSchemas = RequestSchemas> {
+    readonly params: PartOf<Request, 'params'>;
+    readonly query: PartOf<Request, 'query'>;
+    readonly headers: PartOf<Request, 'headers'>;
+    readonly body: PartOf<Request, 'body'>;
+    readonly context: RequestContext;
+}
+export {};
+//# sourceMappingURL=handler-input.d.ts.map

package/dist/route/handler-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-input.d.ts","sourceRoot":"","sources":["../../src/route/handler-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,SAAS,MAAM,YAAY,IAAI,OAAO,SAAS;IACtE,QAAQ,EAAE,CAAC,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;CACtC,GACG,CAAC,GACD,YAAY,CAAC,IAAI,CAAC,CAAC;AAEvB,2EAA2E;AAC3E,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC"}

package/dist/route/handler-input.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=handler-input.js.map

package/dist/route/handler-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-input.js","sourceRoot":"","sources":["../../src/route/handler-input.ts"],"names":[],"mappings":""}

package/dist/route/handler-result.d.ts

@@ -0,0 +1,20 @@
+import type { Schema } from '@ddd-ts-kit/validation';
+import type { ResponsesSpec } from './responses-spec.js';
+type StatusOf<Key> = Key extends number ? Key : Key extends `${infer Status extends number}` ? Status : never;
+type ResultFor<Status, Spec> = Spec extends {
+    readonly body: Schema<infer T>;
+} ? {
+    readonly status: StatusOf<Status>;
+    readonly body: T;
+    readonly headers?: Record<string, string>;
+} : {
+    readonly status: StatusOf<Status>;
+    readonly body?: undefined;
+    readonly headers?: Record<string, string>;
+};
+/** What a handler returns: one of the declared statuses, with the body its schema describes. */
+export type HandlerResult<Responses extends ResponsesSpec = ResponsesSpec> = {
+    [Status in keyof Responses]: ResultFor<Status, Responses[Status]>;
+}[keyof Responses];
+export {};
+//# sourceMappingURL=handler-result.d.ts.map

package/dist/route/handler-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-result.d.ts","sourceRoot":"","sources":["../../src/route/handler-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,KAAK,QAAQ,CAAC,GAAG,IAAI,GAAG,SAAS,MAAM,GAAG,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,MAAM,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9G,KAAK,SAAS,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClG;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEhH,gGAAgG;AAChG,MAAM,MAAM,aAAa,CAAC,SAAS,SAAS,aAAa,GAAG,aAAa,IAAI;KAC1E,MAAM,IAAI,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAClE,CAAC,MAAM,SAAS,CAAC,CAAC"}

package/dist/route/handler-result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=handler-result.js.map

package/dist/route/handler-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-result.js","sourceRoot":"","sources":["../../src/route/handler-result.ts"],"names":[],"mappings":""}

package/dist/route/http-method.d.ts

@@ -0,0 +1,2 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+//# sourceMappingURL=http-method.d.ts.map

package/dist/route/http-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-method.d.ts","sourceRoot":"","sources":["../../src/route/http-method.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC"}

package/dist/route/http-method.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-method.js.map