flowingts 0.0.0 → 0.19.0

package/dist/core/response/pipeline.js

@@ -0,0 +1,169 @@
+import { kContracts, kRawSend } from '../symbols.js';
+import { STATUS_CODES } from 'node:http';
+import { HttpError } from '../errors.js';
+import { isResponseContent } from '../metadata.js';
+import { Readable } from 'node:stream';
+import { isJsonContentType, mediaType, negotiate, withCharset } from '../../utils/content-type.js';
+const JSON_TYPE = 'application/json';
+/** Status padrão de uma rota (B-05): com um único 2xx declarado e sem 200, é esse 2xx. */
+export function defaultStatusFor(response) {
+    if (!response)
+        return undefined;
+    const success = Object.keys(response)
+        .map(Number)
+        .filter((st) => st >= 200 && st < 300);
+    return success.length === 1 && response[200] === undefined ? success[0] : undefined;
+}
+export function responsePlan(response, serializers) {
+    return { response, serializers, defaultStatus: defaultStatusFor(response) };
+}
+const EMPTY_SERIALIZERS = new Map();
+export function sendResult(ctx, response, result, serializers = EMPTY_SERIALIZERS, mode = 'auto', defaultStatus = defaultStatusFor(response)) {
+    if (defaultStatus !== undefined && !ctx.statusExplicit)
+        ctx.res.statusCode = defaultStatus;
+    if (result === undefined)
+        return void ctx.res.end();
+    const status = ctx.res.statusCode;
+    const entry = response?.[status];
+    if (!entry && response && Object.keys(response).length > 0) {
+        throw new Error(`[flowing] ${ctx.method} ${ctx.path}: no response schema for status ${status}`);
+    }
+    const headerType = ctx.res.getHeader('Content-Type');
+    const explicit = mode === 'json' ? JSON_TYPE : mode === 'text' ? 'text/plain' : typeof headerType === 'string' ? headerType : undefined;
+    let type;
+    let schema;
+    let jsonSchemaDeclared = false;
+    if (entry && isResponseContent(entry)) {
+        schema = entry.schema;
+        const offered = typeof entry.contentType === 'string' ? [entry.contentType] : [...entry.contentType];
+        if (offered.length > 1)
+            ctx.res.appendHeader('Vary', 'Accept');
+        const chosen = explicit ?? negotiate(ctx.get('accept'), offered);
+        if (!chosen) {
+            throw new HttpError(406, 'Not Acceptable', 'NOT_ACCEPTABLE', { details: { available: offered } });
+        }
+        type = chosen;
+    }
+    else if (entry) {
+        schema = entry;
+        jsonSchemaDeclared = true;
+        type = explicit ?? JSON_TYPE;
+    }
+    else {
+        type = explicit ?? inferType(result);
+    }
+    write(ctx, type, result, schema, mode === 'json' || (jsonSchemaDeclared && !explicit), serializers);
+}
+const NDJSON = 'application/x-ndjson';
+/** Async iterable que não é um stream (async generator, cursor de banco…) (F-13). */
+function isAsyncIterable(value) {
+    return typeof value === 'object' && value !== null && !(value instanceof Readable) && Symbol.asyncIterator in value;
+}
+function inferType(value) {
+    if (typeof value === 'string')
+        return 'text/plain';
+    if (value instanceof Uint8Array || value instanceof Readable)
+        return 'application/octet-stream';
+    if (isAsyncIterable(value))
+        return NDJSON;
+    return JSON_TYPE;
+}
+/** Cada item vira uma linha JSON (NDJSON). Com schema, cada item é validado e filtrado como uma resposta. */
+function ndjson(ctx, items, schema) {
+    const signal = ctx.signal;
+    return Readable.from((async function* () {
+        for await (const item of items) {
+            if (signal.aborted)
+                return; // cliente desconectou: para de consumir a fonte
+            yield `${schema ? ctx[kContracts].serialize(schema, item) : JSON.stringify(item)}\n`;
+        }
+    })());
+}
+function write(ctx, type, value, schema, forceJson, serializers) {
+    const header = withCharset(type);
+    const base = mediaType(type);
+    const json = isJsonContentType(base);
+    if (value instanceof Readable)
+        return void ctx[kRawSend](value, header);
+    if (isAsyncIterable(value)) {
+        if (base !== NDJSON) {
+            throw new Error(`[flowing] ${ctx.method} ${ctx.path}: an async iterable is streamed as NDJSON; declare ` +
+                `response: { 200: { contentType: '${NDJSON}', schema: Item } } (the schema of each item), or return a Readable.`);
+        }
+        return void ctx[kRawSend](ndjson(ctx, value, schema), header);
+    }
+    // Valores crus (string/Buffer) vão como estão, exceto quando a rota declarou um schema JSON:
+    // nesse caso `"olá"` continua sendo serializado como JSON, como sempre.
+    if ((typeof value === 'string' || value instanceof Uint8Array) && !forceJson) {
+        if (schema && typeof value === 'string')
+            ensureValid(ctx, schema, value);
+        return void ctx[kRawSend](value, header);
+    }
+    if (json) {
+        // Pelo ponto único de escrita (F-04): onSend e sentBody valem também para JSON.
+        return void ctx[kRawSend](schema ? ctx[kContracts].serialize(schema, value) : JSON.stringify(value), header);
+    }
+    const serializer = serializers.get(base);
+    if (!serializer) {
+        throw new Error(`[flowing] ${ctx.method} ${ctx.path}: no serializer registered for "${base}". ` +
+            `Add it to createApp({ serializers: { '${base}': (data) => ... } }).`);
+    }
+    const data = schema ? ensureValid(ctx, schema, value) : value;
+    ctx[kRawSend](Buffer.from(serializer(data)), header);
+}
+/** Valida a saída e devolve uma cópia sem campos não declarados (S-07 em qualquer formato). */
+function ensureValid(ctx, schema, value) {
+    const checked = ctx[kContracts].strip(schema, value);
+    if (!checked.ok) {
+        throw new Error(`[flowing] ${ctx.method} ${ctx.path}: response does not match its schema: ` +
+            checked.issues.map((i) => `${i.path} ${i.message}`).join('; '));
+    }
+    return checked.value;
+}
+/** Monta um Problem Details (RFC 9457). Sem `type`, usa `about:blank` e a frase do status como título. */
+export function problem(status, detail, extra = {}) {
+    const out = { type: extra.type ?? 'about:blank', title: STATUS_CODES[status] ?? 'Error', status };
+    if (detail !== undefined && detail !== out.title)
+        out.detail = detail;
+    if (extra.code !== undefined)
+        out.code = extra.code;
+    if (extra.details !== undefined)
+        out.details = extra.details;
+    return out;
+}
+/** Escreve um problema (status + corpo), sem passar pelo schema da rota (F-32). */
+export function sendProblem(ctx, body, format) {
+    ctx.res.statusCode = body.status;
+    if (format) {
+        let custom;
+        try {
+            custom = format(body, ctx);
+        }
+        catch (err) {
+            ctx.log.error({ err, method: ctx.method, path: ctx.path }, 'formatError failed; sending the default problem');
+            return void ctx[kRawSend](JSON.stringify(body), 'application/problem+json; charset=utf-8');
+        }
+        return void ctx[kRawSend](JSON.stringify(custom), 'application/json; charset=utf-8');
+    }
+    ctx[kRawSend](JSON.stringify(body), 'application/problem+json; charset=utf-8');
+}
+/**
+ * Resposta de erro padrão, no formato Problem Details (F-15). Só mensagens marcadas como `expose`
+ * chegam ao cliente; o resto vira 500 genérico e o erro original é logado no servidor (S-05).
+ */
+export function sendError(ctx, err, format) {
+    const httpErr = err instanceof HttpError ? err : undefined;
+    const status = httpErr?.status ?? 500;
+    const exposed = httpErr?.expose === true;
+    if (!exposed)
+        ctx.log.error({ err, method: ctx.method, path: ctx.path, status }, 'request failed');
+    if (ctx.res.writableEnded)
+        return;
+    if (ctx.res.headersSent)
+        return void ctx.res.end();
+    const body = exposed
+        ? problem(status, httpErr.message, { code: httpErr.code, details: httpErr.details, type: httpErr.type })
+        : problem(status);
+    sendProblem(ctx, body, format);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/core/response/pipeline.js.map

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

package/dist/core/route-table.d.ts

@@ -0,0 +1,58 @@
+import type { Middleware } from './compose.ts';
+import type { Context } from './context.ts';
+import type { Guard } from './guard.ts';
+import type { RouteSchemas } from './metadata.ts';
+import type { RouteHooks } from './hooks.ts';
+import type { kHooks } from './symbols.ts';
+export type Handler = (ctx: Context) => unknown | Promise<unknown>;
+/** Tudo o que o app precisa para executar uma rota. */
+export interface RouteDefinition {
+    handler: Handler;
+    schemas: RouteSchemas;
+    middlewares: readonly Middleware[];
+    guards: readonly Guard[];
+}
+/**
+ * A rota que atendeu a requisição, em `ctx.route` (F-38). `path` é o template com o prefixo (`/users/:id`),
+ * nunca o path recebido: é seguro como rótulo de métrica. `host` é a regra que venceu (`*.exemplo.com`),
+ * não o hostname do cliente.
+ */
+export interface RouteInfo {
+    readonly method: string;
+    readonly path: string;
+    /** Classe de origem (ou `static`). */
+    readonly owner: string;
+    /** Método da classe que trata a rota. */
+    readonly handler: string;
+    readonly host?: string;
+    /** @internal Hooks com escopo (F-43), montados no registro. */
+    readonly [kHooks]?: RouteHooks;
+}
+/** Resultado do `find()`: a rota registrada (o mesmo objeto, sem cópia) e os parâmetros desta requisição. */
+export interface RouteMatch {
+    route: RouteDefinition & {
+        run?: (ctx: Context) => Promise<void> | undefined;
+        info?: RouteInfo;
+    };
+    params: Record<string, string>;
+}
+/** Tabela de rotas interna sobre o find-my-way. */
+export declare class RouteTable {
+    private inner;
+    /** Com `host` (chave da regra), a rota só casa naquele host (F-35); sem, vale para qualquer um (fallback). */
+    on(method: string, path: string, route: RouteDefinition, host?: string): void;
+    /** Desfaz um `on()`, para o registro em duas fases. */
+    off(method: string, path: string, host?: string): void;
+    /** Já existe uma rota idêntica (método, path e host)? */
+    has(method: string, path: string, host?: string): boolean;
+    /** `hostname` é o validado pelo app (`ctx.hostname`), nunca o header cru. */
+    find(method: string, path: string, hostname?: string): RouteMatch | null;
+    /**
+     * Descobre quais métodos existem para o path informado.
+     * Estratégia: pergunta ao find-my-way método por método.
+     * O custo é O(número de métodos registrados) por lookup, o que é trivial
+     * (no máximo 7 find() O(log n) cada).
+     */
+    allowedMethods(path: string, hostname?: string): string[];
+}
+//# sourceMappingURL=route-table.d.ts.map

package/dist/core/route-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-table.d.ts","sourceRoot":"","sources":["../../src/core/route-table.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnE,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC;CAChC;AAED,6GAA6G;AAC7G,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,eAAe,GAAG;QAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IACjG,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAkDD,mDAAmD;AACnD,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAuF;IAEpG,8GAA8G;IAC9G,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAG5E;IAED,uDAAuD;IACvD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAGrD;IAED,yDAAyD;IACzD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAKxD;IAED,6EAA6E;IAC7E,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,UAAU,GAAG,IAAI,CAOnE;IAED;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,EAAE,CAUpD;CACF"}

package/dist/core/route-table.js

@@ -0,0 +1,108 @@
+// src/core/route-table.ts
+import Router from 'find-my-way';
+import { compileRouteHost, hostRank } from '../utils/origin-match.js';
+// O find-my-way exige um handler próprio; usamos só o `store`, então ele nunca é chamado.
+const NOOP = () => { };
+const PROBE_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'];
+/** Converte a chave da restrição de volta na regra (`re:fonte/flags` → RegExp). */
+function ruleFromKey(key) {
+    if (!key.startsWith('re:'))
+        return compileRouteHost(key);
+    const slash = key.lastIndexOf('/');
+    return compileRouteHost(new RegExp(key.slice(3, slash), key.slice(slash + 1)));
+}
+/**
+ * Estratégia de host própria (F-35), no lugar da embutida do find-my-way, que testa as RegExp na ordem de
+ * registro. Aqui a prioridade é a de {@link hostRank}: exato → curinga mais específico → RegExp.
+ */
+const hostStrategy = {
+    name: 'host',
+    mustMatchWhenDerived: false,
+    storage() {
+        const exact = new Map();
+        const ranked = [];
+        let seq = 0;
+        return {
+            get(hostname) {
+                const hit = exact.get(hostname);
+                if (hit !== undefined)
+                    return hit;
+                for (const r of ranked)
+                    if (r.rule.test(hostname))
+                        return r.value;
+                return null;
+            },
+            set(key, value) {
+                const rule = ruleFromKey(key);
+                if (rule.kind === 'exact')
+                    return void exact.set(rule.base, value);
+                const existing = ranked.find((r) => r.rule.key === key);
+                if (existing)
+                    return void (existing.value = value);
+                ranked.push({ rule, rank: hostRank(rule, seq++), value });
+                ranked.sort((a, b) => a.rank - b.rank);
+            },
+        };
+    },
+    validate(value) {
+        if (typeof value !== 'string')
+            throw new Error('host constraint must be a compiled host key');
+    },
+    // O app sempre informa o host validado no `find()`; o header cru nunca é usado.
+    deriveConstraint: () => '',
+};
+/** Tabela de rotas interna sobre o find-my-way. */
+export class RouteTable {
+    inner = Router({ ignoreTrailingSlash: true, constraints: { host: hostStrategy } });
+    /** Com `host` (chave da regra), a rota só casa naquele host (F-35); sem, vale para qualquer um (fallback). */
+    on(method, path, route, host) {
+        if (host === undefined)
+            this.inner.on(method, path, NOOP, route);
+        else
+            this.inner.on(method, path, { constraints: { host } }, NOOP, route);
+    }
+    /** Desfaz um `on()`, para o registro em duas fases. */
+    off(method, path, host) {
+        if (host === undefined)
+            this.inner.off(method, path);
+        else
+            this.inner.off(method, path, { host });
+    }
+    /** Já existe uma rota idêntica (método, path e host)? */
+    has(method, path, host) {
+        // Com `ignoreTrailingSlash`, `/users` e `/users/` são a mesma rota: confere as duas formas.
+        const alt = path.length > 1 && path.endsWith('/') ? path.slice(0, -1) : `${path}/`;
+        const c = host === undefined ? undefined : { host };
+        return [path, alt].some((p) => (c ? this.inner.hasRoute(method, p, c) : this.inner.hasRoute(method, p)));
+    }
+    /** `hostname` é o validado pelo app (`ctx.hostname`), nunca o header cru. */
+    find(method, path, hostname = '') {
+        const c = { host: hostname };
+        // F-08: HEAD usa o handler do GET quando não houver rota HEAD própria.
+        // O Node já descarta o corpo de respostas a HEAD.
+        const found = this.inner.find(method, path, c) ?? (method === 'HEAD' ? this.inner.find('GET', path, c) : null);
+        if (!found)
+            return null;
+        return { route: found.store, params: found.params };
+    }
+    /**
+     * Descobre quais métodos existem para o path informado.
+     * Estratégia: pergunta ao find-my-way método por método.
+     * O custo é O(número de métodos registrados) por lookup, o que é trivial
+     * (no máximo 7 find() O(log n) cada).
+     */
+    allowedMethods(path, hostname = '') {
+        const methods = new Set();
+        for (const method of PROBE_METHODS) {
+            if (this.inner.find(method, path, { host: hostname })) {
+                methods.add(method);
+            }
+        }
+        if (methods.has('GET'))
+            methods.add('HEAD');
+        if (methods.size > 0)
+            methods.add('OPTIONS');
+        return [...methods].sort();
+    }
+}
+//# sourceMappingURL=route-table.js.map

package/dist/core/route-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-table.js","sourceRoot":"","sources":["../../src/core/route-table.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,MAAM,MAAM,aAAa,CAAC;AAKjC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AAuC1F,0FAA0F;AAC1F,MAAM,IAAI,GAA0C,GAAG,EAAE,GAAE,CAAC,CAAC;AAC7D,MAAM,aAAa,GAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAEtG,mFAAmF;AACnF,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,gBAAgB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,MAAM;IACZ,oBAAoB,EAAE,KAAK;IAC3B,OAAO;QACL,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;QACzC,MAAM,MAAM,GAA4D,EAAE,CAAC;QAC3E,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,OAAO;YACL,GAAG,CAAC,QAAgB;gBAClB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAChC,IAAI,GAAG,KAAK,SAAS;oBAAE,OAAO,GAAG,CAAC;gBAClC,KAAK,MAAM,CAAC,IAAI,MAAM;oBAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;wBAAE,OAAO,CAAC,CAAC,KAAK,CAAC;gBAClE,OAAO,IAAI,CAAC;YACd,CAAC;YACD,GAAG,CAAC,GAAW,EAAE,KAAc;gBAC7B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;oBAAE,OAAO,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;gBACxD,IAAI,QAAQ;oBAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC1D,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YACzC,CAAC;SACF,CAAC;IACJ,CAAC;IACD,QAAQ,CAAC,KAAc;QACrB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAChG,CAAC;IACD,gFAAgF;IAChF,gBAAgB,EAAE,GAAG,EAAE,CAAC,EAAE;CAC3B,CAAC;AAEF,mDAAmD;AACnD,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,MAAM,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,YAAqB,EAAE,EAAE,CAAC,CAAC;IAEpG,8GAA8G;IAC9G,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,KAAsB,EAAE,IAAa;QACpE,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;;YACtE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAgB,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACrF,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,IAAa;QAC7C,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAgB,EAAE,IAAI,CAAC,CAAC;;YAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAgB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,yDAAyD;IACzD,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,IAAa;QAC7C,4FAA4F;QAC5F,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;QACnF,MAAM,CAAC,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAgB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/H,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC,MAAc,EAAE,IAAY,EAAE,QAAQ,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7B,uEAAuE;QACvE,kDAAkD;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzH,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAA4B,EAAE,MAAM,EAAE,KAAK,CAAC,MAAgC,EAAE,CAAC;IACvG,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,IAAY,EAAE,QAAQ,GAAG,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/core/runtime/observer.d.ts

@@ -0,0 +1,47 @@
+import type http from 'node:http';
+import type { AppCore } from '../app/core.ts';
+import { type Step } from '../compose.ts';
+import type { Context } from '../context.ts';
+import type { RouteInfo } from '../route-table.ts';
+/** Grava o instante em que os headers da resposta saíram (a primeira vez), para o `ttfbMs`. */
+export declare function markHeadersSent(res: http.ServerResponse): void;
+/**
+ * Observer (F-38): tudo o que acompanha a requisição sem participar dela. Os hooks `onRequest` e
+ * `onResponse`, o `logRequests` e o `telemetry` são observadores; o pipeline só avisa os momentos (início,
+ * execução, rota resolvida, erro), e o fim é detectado aqui.
+ *
+ * Também é a única fonte da regra "há quem observe o fim" (`watching`), usada pelo pipeline e pelas
+ * respostas do `listen()`. Sem observadores, nada é criado por requisição: o custo é zero.
+ */
+export declare class RequestObserver {
+    private readonly core;
+    constructor(core: AppCore);
+    /**
+     * Há quem observe o fim da requisição: `onResponse` (do app ou de alguma rota), `logRequests` ou `telemetry`.
+     * A requisição ainda não foi roteada quando isso é decidido, então um `onResponse` de rota liga a observação
+     * do app inteiro; sem nenhum, o custo continua zero.
+     */
+    get watching(): boolean;
+    /**
+     * Início da requisição, logo depois de criar o `Context` e antes da validação do `Host`: toda requisição
+     * observada no início também é observada no fim. `started` é o instante de chegada, ou `-1` se ninguém
+     * observa o fim.
+     */
+    start(ctx: Context, started: number): void;
+    /** O pipeline, dentro do contexto do span criado pelo `telemetry` (se houver). */
+    run(ctx: Context, fn: () => Step): Step;
+    /** A rota foi resolvida: o `telemetry` nomeia o span antes de a resposta sair. */
+    routed(ctx: Context, route: RouteInfo): void;
+    /** Um erro chegou ao pipeline de erros: guardado para o `onResponse` e registrado no span antes da resposta. */
+    failed(ctx: Context, err: unknown): void;
+    /**
+     * Fim da requisição: o evento `close` dispara em todos os caminhos (inclusive cancelamento, que não tem
+     * `finish`), e a trava garante uma única execução.
+     */
+    private watchEnd;
+    private endInfo;
+    private runOnResponse;
+    /** `onRequest` é síncrono: uma Promise devolvida não é esperada, mas a rejeição é logada. */
+    private runOnRequest;
+}
+//# sourceMappingURL=observer.d.ts.map

package/dist/core/runtime/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAE9D;AAMD;;;;;;;GAOG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,OAAO,EAAI;IAE9C;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAGtB;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIzC;IAED,kFAAkF;IAClF,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAGtC;IAED,kFAAkF;IAClF,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAE3C;IAED,gHAAgH;IAChH,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAGvC;IAED;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,aAAa;IAMrB,6FAA6F;IAC7F,OAAO,CAAC,YAAY;CAUrB"}

package/dist/core/runtime/observer.js

@@ -0,0 +1,125 @@
+import { performance } from 'node:perf_hooks';
+import { isPromiseLike } from '../compose.js';
+import { kError, kHeadersAt, kHooks, kPhase } from '../symbols.js';
+/** Grava o instante em que os headers da resposta saíram (a primeira vez), para o `ttfbMs`. */
+export function markHeadersSent(res) {
+    res[kHeadersAt] ??= performance.now();
+}
+function headersSentAt(res) {
+    return res[kHeadersAt];
+}
+/**
+ * Observer (F-38): tudo o que acompanha a requisição sem participar dela. Os hooks `onRequest` e
+ * `onResponse`, o `logRequests` e o `telemetry` são observadores; o pipeline só avisa os momentos (início,
+ * execução, rota resolvida, erro), e o fim é detectado aqui.
+ *
+ * Também é a única fonte da regra "há quem observe o fim" (`watching`), usada pelo pipeline e pelas
+ * respostas do `listen()`. Sem observadores, nada é criado por requisição: o custo é zero.
+ */
+export class RequestObserver {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    /**
+     * Há quem observe o fim da requisição: `onResponse` (do app ou de alguma rota), `logRequests` ou `telemetry`.
+     * A requisição ainda não foi roteada quando isso é decidido, então um `onResponse` de rota liga a observação
+     * do app inteiro; sem nenhum, o custo continua zero.
+     */
+    get watching() {
+        const core = this.core;
+        return core.onResponseHooks.length > 0 || core.scopedOnResponse > 0 || core.telemetry !== undefined || core.opts.logRequests === true;
+    }
+    /**
+     * Início da requisição, logo depois de criar o `Context` e antes da validação do `Host`: toda requisição
+     * observada no início também é observada no fim. `started` é o instante de chegada, ou `-1` se ninguém
+     * observa o fim.
+     */
+    start(ctx, started) {
+        if (started !== -1)
+            this.watchEnd(ctx, started);
+        this.core.telemetry?.onRequest(ctx);
+        if (this.core.onRequestHooks.length > 0)
+            this.runOnRequest(ctx);
+    }
+    /** O pipeline, dentro do contexto do span criado pelo `telemetry` (se houver). */
+    run(ctx, fn) {
+        const telemetry = this.core.telemetry;
+        return telemetry ? telemetry.run(ctx, fn) : fn();
+    }
+    /** A rota foi resolvida: o `telemetry` nomeia o span antes de a resposta sair. */
+    routed(ctx, route) {
+        this.core.telemetry?.onRoute(ctx, route);
+    }
+    /** Um erro chegou ao pipeline de erros: guardado para o `onResponse` e registrado no span antes da resposta. */
+    failed(ctx, err) {
+        ctx[kError] = err;
+        this.core.telemetry?.onError(ctx, err, ctx[kPhase]);
+    }
+    /**
+     * Fim da requisição: o evento `close` dispara em todos os caminhos (inclusive cancelamento, que não tem
+     * `finish`), e a trava garante uma única execução.
+     */
+    watchEnd(ctx, started) {
+        const res = ctx.res;
+        let done = false;
+        res.once('close', () => {
+            if (done)
+                return;
+            done = true;
+            const info = this.endInfo(ctx, started);
+            this.core.telemetry?.onResponse(ctx, info);
+            if (this.core.opts.logRequests) {
+                const { status, ms, abortReason } = info;
+                const entry = { method: ctx.method, path: ctx.path, status, ms, ...(abortReason ? { abortReason } : {}) };
+                ctx.log.info(entry, abortReason ? 'request aborted' : 'request completed');
+            }
+            // Os do app primeiro, depois os da rota (F-43), na ordem de fora para dentro.
+            for (const hook of this.core.onResponseHooks)
+                this.runOnResponse(hook, ctx, info);
+            const scoped = info.route?.[kHooks]?.onResponse;
+            if (scoped)
+                for (const hook of scoped)
+                    this.runOnResponse(hook, ctx, info);
+        });
+    }
+    endInfo(ctx, started) {
+        const res = ctx.res;
+        const round = (t) => Math.round((t - started) * 100) / 100;
+        const abortReason = ctx.abortReason ?? (res.writableEnded ? undefined : 'CLIENT_DISCONNECTED');
+        const status = res.statusCode;
+        const error = ctx[kError];
+        const route = ctx.route;
+        // Gravado pelas respostas do `listen()` e do `inject()`; num servidor próprio (`callback()`), fica ausente.
+        const ttfb = headersSentAt(res);
+        return {
+            status,
+            ms: round(performance.now()),
+            outcome: abortReason ? 'aborted' : status >= 500 ? 'error' : 'completed',
+            streaming: ctx.streamingResponse,
+            ...(abortReason ? { abortReason } : {}),
+            ...(ttfb === undefined ? {} : { ttfbMs: round(ttfb) }),
+            ...(route ? { route } : {}),
+            ...(error === undefined ? {} : { error, errorPhase: ctx[kPhase] }),
+        };
+    }
+    runOnResponse(hook, ctx, info) {
+        Promise.resolve()
+            .then(() => hook(ctx, info))
+            .catch((err) => ctx.log.error({ err }, 'onResponse hook failed'));
+    }
+    /** `onRequest` é síncrono: uma Promise devolvida não é esperada, mas a rejeição é logada. */
+    runOnRequest(ctx) {
+        for (const hook of this.core.onRequestHooks) {
+            try {
+                const out = hook(ctx);
+                if (isPromiseLike(out))
+                    out.then(undefined, (err) => ctx.log.error({ err }, 'onRequest hook failed'));
+            }
+            catch (err) {
+                ctx.log.error({ err }, 'onRequest hook failed');
+            }
+        }
+    }
+}
+//# sourceMappingURL=observer.js.map

package/dist/core/runtime/observer.js.map

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

package/dist/core/runtime/request-handler.d.ts

@@ -0,0 +1,62 @@
+import type http from 'node:http';
+import type { AppCore } from '../app/core.ts';
+import { type Step } from '../compose.ts';
+import { Context } from '../context.ts';
+import type { FrameworkRoutes } from '../registry/framework-routes.ts';
+import type { RouteRegistry } from '../registry/registry.ts';
+import type { RequestObserver } from './observer.ts';
+import type { ServerLifecycle } from './server.ts';
+/**
+ * Pipeline da requisição: rastreamento, request id, validação do `Host`, headers de segurança, healthchecks,
+ * middlewares globais, OpenAPI, roteamento, pipeline da rota e erros.
+ */
+export declare class RequestHandler {
+    private readonly core;
+    private readonly registry;
+    private readonly framework;
+    private readonly server;
+    private readonly observer;
+    constructor(core: AppCore, registry: RouteRegistry, framework: FrameworkRoutes, server: ServerLifecycle, observer: RequestObserver);
+    /**
+     * Listener `(req, res)` do app, para usar com qualquer servidor do Node:
+     * `https.createServer(opts, app.callback())`, `http2` em modo compat, testes etc. (F-09).
+     */
+    callback(): (req: http.IncomingMessage, res: http.ServerResponse) => void;
+    private fail;
+    /** Cadeia global compilada; refeita só quando `app.use()` acrescenta um middleware. */
+    private globalChain;
+    private readonly readBody;
+    /** O pipeline completo, como uma Promise (API pública: `app.handle()`). */
+    handle(ctx: Context): Promise<void>;
+    /**
+     * O pipeline completo. Síncrono do começo ao fim quando nada é assíncrono (sem healthcheck no path, sem
+     * body a ler, sem middlewares, handler síncrono); vira assíncrono só a partir da primeira Promise de verdade
+     * (F-41). Erros síncronos e assíncronos terminam no mesmo `runErrorHandlers`.
+     */
+    run(ctx: Context): Step;
+    /** Liga a parte assíncrona (se houver) ao tratamento de erros. */
+    private catching;
+    private serveHealth;
+    private afterHealth;
+    private afterBody;
+    /**
+     * Um middleware global que não chama next() e não responde: a rota não roda (antes, rodava mesmo assim).
+     * Para a requisição não ficar sem resposta, 404, como no Koa.
+     */
+    private checkRouted;
+    /**
+     * Cadeia global (Chain of Responsibility pré-compilada): os middlewares de `app.use()` envolvem o
+     * roteamento e a rota, como no Koa. Um `await next()` num middleware global inclui o handler.
+     */
+    private chain;
+    /** Fim da cadeia global: OpenAPI, roteamento, 404/405 e o programa da rota. */
+    private route;
+    /** Roteamento, 404/405 e o programa da rota. */
+    private dispatch;
+    /**
+     * Executa os `onError` do usuário. Se um deles lançar, o erro é logado e seguimos
+     * para a resposta padrão com o erro **original** — nunca deixamos a Promise rejeitar (B-08).
+     */
+    private runErrorHandlers;
+}
+//# sourceMappingURL=request-handler.d.ts.map

package/dist/core/runtime/request-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-handler.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/request-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAgB,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAMxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAwBnD;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,YACmB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,eAAe,EAG3C;IAED;;;OAGG;IACH,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CA+DxE;IAID,OAAO,CAAC,IAAI;IAMZ,uFAAuF;IACvF,OAAO,CAAC,WAAW,CAA4D;IAC/E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IAEvE,2EAA2E;IACrE,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAExC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAWtB;IAED,kEAAkE;IAClE,OAAO,CAAC,QAAQ;YAIF,WAAW;IAKzB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,SAAS;IAQjB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAOnB;;;OAGG;IACH,OAAO,CAAC,KAAK;IAQb,+EAA+E;IAC/E,OAAO,CAAC,KAAK;IAUb,gDAAgD;IAChD,OAAO,CAAC,QAAQ;IA6BhB;;;OAGG;YACW,gBAAgB;CAe/B"}