flowingts 0.0.0 → 0.19.0

package/dist/core/compiler.js

@@ -0,0 +1,151 @@
+import { readOwnMetadata } from './metadata.js';
+import { joinPaths, pathParams } from '../utils/path.js';
+import { compileRouteHost } from '../utils/origin-match.js';
+import { concatHooks, emptyHooks, hookOptions, routeHooks } from './hooks.js';
+export function compileHostOption(host) {
+    if (host === undefined)
+        return [];
+    const list = Array.isArray(host) ? host : [host];
+    if (list.length === 0)
+        throw new Error('[flowing] host: the list cannot be empty.');
+    return list.map(compileRouteHost);
+}
+export const ROOT_SCOPE = { prefix: '', middlewares: [], guards: [], hooks: emptyHooks(), hosts: [] };
+/** Host herdado do grupo ou definido aqui; os dois ao mesmo tempo seria ambíguo (F-35). */
+function scopedHosts(where, inherited, own) {
+    if (own === undefined)
+        return inherited;
+    if (inherited.length > 0) {
+        throw new Error(`[flowing] ${where}: "host" is already set by an outer group (${inherited.map((h) => h.label).join(', ')}); ` +
+            'set it in only one place.');
+    }
+    return compileHostOption(own);
+}
+/** Prefixo de um grupo dentro de outro, sem barras duplicadas; vazio não altera nada. */
+export function joinPrefix(outer, inner) {
+    if (!outer)
+        return inner;
+    if (!inner)
+        return outer;
+    return joinPaths(outer, inner);
+}
+/** Escopo de um grupo aninhado em `parent`. */
+export function childScope(parent, opts) {
+    return {
+        token: { open: true },
+        hosts: scopedHosts('app.group()', parent.hosts, opts.host),
+        prefix: joinPrefix(parent.prefix, opts.prefix ?? ''),
+        middlewares: [...parent.middlewares, ...(opts.middlewares ?? [])],
+        guards: [...parent.guards, ...(opts.guards ?? [])],
+        hooks: concatHooks(parent.hooks, hookOptions(opts.hooks)),
+    };
+}
+export function createGroup(ref, options = {}, scope = ROOT_SCOPE) {
+    const isClass = typeof ref === 'function';
+    const Class = (isClass ? ref : ref.constructor);
+    const meta = readOwnMetadata(Class);
+    if (!meta?.isRouter) {
+        throw new Error(`[flowing] Class ${Class.name} is not decorated with @Router('/prefix'). ` + `Add it to register the class with app.mount().`);
+    }
+    if (options.only && options.except) {
+        throw new Error(`[flowing] app.mount(${Class.name}): use either "only" or "except", not both.`);
+    }
+    // Instâncias permitem injetar dependências pelo construtor: app.mount(new UserRoutes(repo))
+    const instance = isClass ? new Class() : ref;
+    const hosts = scopedHosts(`app.mount(${Class.name})`, scope.hosts, options.host);
+    return { name: Class.name, instance, meta, prefix: joinPrefix(scope.prefix, options.prefix ?? meta.prefix), options, scope, hosts };
+}
+/** Rotas declaradas na classe (`@Get`, `@Post`…), filtradas por `only`/`except` e `auto`. */
+export function compileAutoRoutes(group) {
+    const { meta, options } = group;
+    if (options.auto === false)
+        return [];
+    const declared = [...meta.methods].filter(([, m]) => m.method && m.path).map(([name]) => name);
+    const pick = (selector, label) => new Set(selector(group.instance).map((fn) => resolveMethod(group, fn, label, declared)));
+    const excluded = options.except ? pick(options.except, 'except') : new Set();
+    const selected = options.only ? pick(options.only, 'only') : new Set(declared.filter((n) => !excluded.has(n)));
+    return declared
+        .filter((name) => selected.has(name))
+        .map((name) => {
+        const m = meta.methods.get(name);
+        return buildRoute(group, name, m, m.method, m.path);
+    });
+}
+/** Rota mapeada no app: `.get('/legacy/:id', (r) => r.getUser, opts)` (F-30). */
+export function compileManualRoute(group, httpMethod, path, selector, options = {}) {
+    const name = resolveMethod(group, selector(group.instance), `.${httpMethod.toLowerCase()}('${path}')`);
+    return buildRoute(group, name, group.meta.methods.get(name), httpMethod, path, options);
+}
+function buildRoute(group, name, methodMeta, httpMethod, path, manual = {}) {
+    const fn = group.instance[name];
+    const { meta, options, instance, scope } = group;
+    const fullPath = joinPaths(group.prefix, path);
+    checkPath(`${group.name}.${String(name)}`, httpMethod, fullPath, methodMeta.schemas.params);
+    return {
+        method: httpMethod,
+        path: fullPath,
+        owner: group.name,
+        handlerName: String(name),
+        hosts: group.hosts,
+        handler: (ctx) => fn.call(instance, ctx),
+        schemas: methodMeta.schemas,
+        // Ordem: grupos → mount → classe → método → rota manual (F-01, F-28, F-30)
+        middlewares: [
+            ...scope.middlewares,
+            ...(options.middlewares ?? []),
+            ...meta.middlewares,
+            ...methodMeta.middlewares,
+            ...(manual.middlewares ?? []),
+        ],
+        guards: [...scope.guards, ...(options.guards ?? []), ...meta.guards, ...methodMeta.guards, ...(manual.guards ?? [])],
+        hooks: routeHooks(concatHooks(scope.hooks, hookOptions(options.hooks), meta.hooks, methodMeta.hooks, hookOptions(manual.hooks))),
+    };
+}
+/**
+ * Descobre o nome do método a partir da função devolvida pelo seletor.
+ * Só aceita métodos com algum decorator do FlowingTS (a "permissão" no nível do método).
+ */
+function resolveMethod(group, fn, where, allowed = [...group.meta.methods.keys()]) {
+    const target = group.instance;
+    const name = typeof fn === 'function' ? allowed.find((n) => target[n] === fn) : undefined;
+    if (name !== undefined)
+        return name;
+    const label = typeof fn === 'function' && fn.name ? `"${fn.name}"` : 'the selected value';
+    const available = allowed.map(String).join(', ') || '(none)';
+    const decorated = typeof fn === 'function' && [...group.meta.methods.keys()].some((n) => target[n] === fn);
+    const isMethod = typeof fn === 'function' && Object.values(Object.getOwnPropertyDescriptors(Object.getPrototypeOf(target))).some((d) => d.value === fn);
+    const reason = decorated
+        ? `${label} has no HTTP verb decorator, so it is not an automatic route; map it manually with .get()/.post()…`
+        : isMethod
+            ? `${label} has no FlowingTS decorator (@Get, @Schema, @Middlewares, @Guards…), so it cannot be exposed`
+            : `${label} is not a method of ${group.name}`;
+    const at = where.startsWith('.') ? where : ` ${where}`;
+    throw new Error(`[flowing] app.mount(${group.name})${at}: ${reason}. Available: ${available}.`);
+}
+/**
+ * Valida o path no registro e confere as chaves do schema de `params` contra os parâmetros do path,
+ * já com o prefixo do `@Router`/`mount` (F-29). Schemas sem `properties` (não JSON Schema) não são conferidos.
+ */
+function checkPath(where, method, path, params) {
+    let names;
+    try {
+        names = pathParams(path);
+    }
+    catch (err) {
+        throw new Error(`[flowing] ${where} (${method} ${path}): ${err.message}.`);
+    }
+    const props = params?.properties;
+    if (!props || typeof props !== 'object')
+        return;
+    const keys = Object.keys(props);
+    const missing = names.filter((n) => !keys.includes(n));
+    const extra = keys.filter((k) => !names.includes(k));
+    if (missing.length === 0 && extra.length === 0)
+        return;
+    const parts = [
+        missing.length ? `missing in params schema: ${missing.map((n) => `"${n}"`).join(', ')}` : '',
+        extra.length ? `not in path: ${extra.map((n) => `"${n}"`).join(', ')}` : '',
+    ].filter(Boolean);
+    throw new Error(`[flowing] ${where} (${method} ${path}): params schema does not match the path; ${parts.join('; ')}.`);
+}
+//# sourceMappingURL=compiler.js.map

package/dist/core/compiler.js.map

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

package/dist/core/compose.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from './context.ts';
+export type Middleware = (ctx: Context, next: () => Promise<void>) => Promise<void> | void;
+export declare function compose(ctx: Context, fns: Middleware[]): Promise<void>;
+/** Uma etapa do pipeline: `undefined` quando terminou de forma síncrona, ou a Promise do que é assíncrono. */
+export type Step = Promise<void> | undefined;
+/** Se `value` é uma Promise (ou um thenable), para decidir entre o caminho síncrono e o assíncrono. */
+export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
+/**
+ * Cadeia pré-compilada (Chain of Responsibility, F-39): monta, uma vez, a função que executa `fns` no modelo
+ * onion e termina em `terminal`. Sem camadas, a cadeia é o próprio terminal, que pode terminar de forma
+ * síncrona (F-41). Com camadas, os middlewares são assíncronos por contrato (`await next()`).
+ *
+ * Como no `compose`, chamar `next()` de novo depois que a cadeia seguinte já rodou não a executa outra vez.
+ */
+export declare function compileChain(fns: readonly Middleware[], terminal: (ctx: Context) => Step): (ctx: Context) => Step;
+//# sourceMappingURL=compose.d.ts.map

package/dist/core/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/core/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE3F,wBAAsB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5E;AAED,8GAA8G;AAC9G,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;AAK7C,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAI3E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAejH"}

package/dist/core/compose.js

@@ -0,0 +1,41 @@
+export async function compose(ctx, fns) {
+    let i = 0;
+    const dispatch = async () => {
+        if (i >= fns.length)
+            return;
+        const fn = fns[i++];
+        await fn(ctx, dispatch);
+    };
+    await dispatch();
+}
+/** Promise já resolvida, compartilhada: `next()` de uma etapa síncrona devolve esta, sem alocar (F-41). */
+const DONE = Promise.resolve();
+/** Se `value` é uma Promise (ou um thenable), para decidir entre o caminho síncrono e o assíncrono. */
+export function isPromiseLike(value) {
+    return (value !== null && (typeof value === 'object' || typeof value === 'function') && typeof value.then === 'function');
+}
+/**
+ * Cadeia pré-compilada (Chain of Responsibility, F-39): monta, uma vez, a função que executa `fns` no modelo
+ * onion e termina em `terminal`. Sem camadas, a cadeia é o próprio terminal, que pode terminar de forma
+ * síncrona (F-41). Com camadas, os middlewares são assíncronos por contrato (`await next()`).
+ *
+ * Como no `compose`, chamar `next()` de novo depois que a cadeia seguinte já rodou não a executa outra vez.
+ */
+export function compileChain(fns, terminal) {
+    let run = terminal;
+    for (let i = fns.length - 1; i >= 0; i--) {
+        const fn = fns[i];
+        const inner = run;
+        run = async (ctx) => {
+            let called = false;
+            await fn(ctx, () => {
+                if (called)
+                    return DONE;
+                called = true;
+                return inner(ctx) ?? DONE;
+            });
+        };
+    }
+    return run;
+}
+//# sourceMappingURL=compose.js.map

package/dist/core/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/core/compose.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAY,EAAE,GAAiB;IAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO;QAC5B,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;QACrB,MAAM,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1B,CAAC,CAAC;IACF,MAAM,QAAQ,EAAE,CAAC;AACnB,CAAC;AAKD,2GAA2G;AAC3G,MAAM,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;AAE9C,uGAAuG;AACvG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,UAAU,CACzI,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAA0B,EAAE,QAAgC;IACvF,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACnB,MAAM,KAAK,GAAG,GAAG,CAAC;QAClB,GAAG,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE;YAClB,IAAI,MAAM,GAAG,KAAK,CAAC;YACnB,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;gBACjB,IAAI,MAAM;oBAAE,OAAO,IAAI,CAAC;gBACxB,MAAM,GAAG,IAAI,CAAC;gBACd,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,290 @@
+import type { IncomingMessage, OutgoingHttpHeader, ServerResponse } from 'node:http';
+import { Readable } from 'node:stream';
+import { type QueryParser } from '../utils/query.ts';
+import { type CookieOptions } from '../utils/cookie.ts';
+import { type Logger } from './logger.ts';
+import type { InferBody, InferParams, InferQuery, InferResponse, ParamsOf } from './infer.ts';
+import type { RouteSchemas } from './metadata.ts';
+import type { FileField, UploadedFile } from './uploads/types.ts';
+import { type ResponsePlan } from './response/pipeline.ts';
+import { type AbortCode, type ErrorPhase } from './abort.ts';
+import type { RouteInfo } from './route-table.ts';
+import { type TraceContext } from '../utils/trace-context.ts';
+import { kAbort, kBindResponse, kContracts, kError, kPendingSend, kPhase, kRawSend, kRoute, kRouted, kTelemetry, kFiles } from './symbols.ts';
+import { type SendFileOptions } from '../server/static.ts';
+import { type SseOptions, type SseStream } from './streaming/sse.ts';
+import { type Contracts } from './contracts.ts';
+export type { SseEvent, SseOptions, SseStream } from './streaming/sse.ts';
+export { kAbort, kBindResponse, kPendingSend, kRawSend } from './symbols.ts';
+type RawBody = string | Uint8Array | Readable;
+/** Corpo e tipo de uma resposta prestes a ser escrita (F-04). */
+export interface SendPayload {
+    body: string | Uint8Array;
+    contentType: string;
+}
+/**
+ * Roda imediatamente antes de escrever uma resposta com corpo (exceto streams), inclusive em
+ * erros e 404. É síncrono; pode alterar headers e devolver outro payload (F-04).
+ */
+export type OnSendHook = (ctx: Context, payload: SendPayload) => SendPayload | void;
+/** Status aceitos por `ctx.status()`: os declarados no schema de resposta, ou qualquer um sem schema (F-32). */
+export type DeclaredStatus<S extends RouteSchemas> = S['response'] extends Record<number, unknown> ? keyof S['response'] & number : number;
+/** Corpo esperado para o status `St`: o do schema, ou qualquer valor sem schema (F-32). */
+export type BodyFor<S extends RouteSchemas, St extends number> = S['response'] extends Record<number, unknown> ? InferResponse<S, St> : unknown;
+/**
+ * Contexto depois de `ctx.status(St)`: `json()` e `send()` exigem o corpo do status escolhido (F-32).
+ *
+ * ```ts
+ * return ctx.status(202).json({ jobId });   // o TypeScript confere o corpo contra o schema do 202
+ * ```
+ */
+export type StatusContext<S extends RouteSchemas | string, St extends number> = Omit<Context<S>, 'json' | 'send'> & {
+    json(body: BodyFor<SchemasOf<S>, St>): Context<S>;
+    send(body: BodyFor<SchemasOf<S>, St> | RawBody, contentType?: string): Context<S>;
+};
+/** Um path no lugar dos schemas (`Context<'/:id'>`) equivale a uma rota sem schemas (F-29). */
+export type SchemasOf<S extends RouteSchemas | string> = S extends string ? {} : S;
+/** `ctx.params`: pelo path (`Context<'/:id'>`) ou pelo schema `params`. */
+export type ParamsFor<S extends RouteSchemas | string> = S extends string ? ParamsOf<S> : InferParams<SchemasOf<S>>;
+/**
+ * Estado por requisição, compartilhado entre middlewares, guards e handlers.
+ * Estenda com declaration merging para ter tipos (F-01):
+ *
+ * ```ts
+ * declare module 'flowingts' {
+ *   interface ContextState { user?: { id: string; role: 'admin' | 'user' } }
+ * }
+ * ```
+ */
+export interface ContextState {
+    [key: string]: unknown;
+}
+export interface ContextOptions {
+    queryMaxKeys?: number | undefined;
+    /** O motor dos contratos do app (F-27); sem ele, o nativo. */
+    contracts?: Contracts | undefined;
+    /** Parser de query próprio (F-26); sem ele, o padrão com `queryMaxKeys`. */
+    queryParser?: QueryParser | undefined;
+    /** Id da requisição; o app gera ou reaproveita o header recebido (F-06). */
+    id?: string | undefined;
+    /** Logger do app; o contexto cria um filho com o `reqId`. */
+    logger?: Logger | undefined;
+    /** Confiança nos headers `X-Forwarded-*` (S-09). Padrão: `false`. */
+    trustProxy?: boolean | number | undefined;
+    /** Hooks `onSend` do app (F-04). */
+    onSend?: readonly OnSendHook[] | undefined;
+    /**
+     * Ids do span desta requisição, para o `ctx.log` (F-38). Quem fornece é o `telemetry`; o `Context` não
+     * depende dele.
+     */
+    spanIds?: ((ctx: Context) => {
+        traceId: string;
+        spanId: string;
+    } | undefined) | undefined;
+    /** Avisado quando a resposta vira stream, para o `close()` do app cancelar streams abertos. */
+    onStream?: ((ctx: Context) => void) | undefined;
+}
+/**
+ * Contexto da requisição. Passe os schemas da rota no genérico para tipar
+ * `params`, `query` e `body` a partir do `@Schema` (F-02):
+ *
+ * ```ts
+ * const create = { body: CreateUserSchema, response: { 201: UserSchema } } satisfies RouteSchemas;
+ * @Post('/') @Schema(create) createUser(ctx: Context<typeof create>) { ctx.body.name }
+ * @Get('/:id') get(ctx: Context<'/:id'>) { ctx.params.id }
+ * ```
+ */
+/** Arquivo de um campo: obrigatório → sempre presente (F-46). */
+type FileOf<S extends RouteSchemas, K extends string> = NonNullable<S['files']>[K] extends {
+    required: true;
+} ? UploadedFile : UploadedFile | undefined;
+export declare class Context<S extends RouteSchemas | string = RouteSchemas> {
+    readonly req: IncomingMessage;
+    readonly res: ServerResponse;
+    readonly method: string;
+    readonly path: string;
+    /** Id da requisição, também enviado no header `X-Request-Id` (F-06). */
+    readonly id: string;
+    /** Parâmetros de rota; tipados pelo schema `params` quando informado em `Context<S>`. */
+    get params(): ParamsFor<S>;
+    set params(value: ParamsFor<S>);
+    private routeParams;
+    /**
+     * A rota que atende esta requisição (F-38): template com o prefixo, classe, método e a regra de host que
+     * venceu. `undefined` antes do roteamento e quando nenhuma rota atende (404, 405, healthcheck, OpenAPI).
+     * Use `ctx.route.path` como rótulo de métrica, nunca `ctx.path`.
+     */
+    get route(): RouteInfo | undefined;
+    /** @internal */
+    [kRoute]: RouteInfo | undefined;
+    /** @internal O motor dos contratos do app (F-27). */
+    get [kContracts](): Contracts;
+    /** @internal Etapa atual do pipeline, para a fase do `onError` (F-38). */
+    [kPhase]: ErrorPhase;
+    /** @internal A cadeia global chegou ao roteamento (o último middleware chamou `next()`). */
+    [kRouted]: boolean;
+    /** @internal O erro tratado pelo pipeline de erros, para o `onResponse` (F-38). */
+    [kError]: unknown;
+    /** @internal Estado do `telemetry` desta requisição; só o módulo do telemetry lê e escreve (F-38). */
+    [kTelemetry]: unknown;
+    /** @internal Arquivos do upload (F-46); definido só nas rotas com `files`, e então o body veio de um formulário. */
+    [kFiles]: ReadonlyMap<string, readonly UploadedFile[]> | undefined;
+    /** Query string; tipada pelo schema `query` (já com coerção e defaults aplicados). Lida no primeiro acesso. */
+    get query(): InferQuery<SchemasOf<S>>;
+    set query(value: InferQuery<SchemasOf<S>>);
+    /** URL completa da requisição, com o host validado (S-09). Criada no primeiro acesso. */
+    get url(): URL;
+    /** Logger da requisição, já com `reqId` (F-06). Criado no primeiro acesso. */
+    get log(): Logger;
+    /**
+     * Contexto de trace W3C recebido no `traceparent` (F-38), já validado: `{ traceId, parentSpanId, sampled,
+     * tracestate }`, ou `undefined` se não veio ou é inválido. Os logs do `ctx.log` levam o `traceId`.
+     */
+    get trace(): TraceContext | undefined;
+    private traceContext;
+    /**
+     * Configuração do app, **a mesma referência** para todas as requisições (Flyweight, F-41): o `Context` lê
+     * dela em vez de copiar `trustProxy`, `onSend`, `queryMaxKeys` e o logger campo a campo.
+     */
+    private readonly opts;
+    private readonly target;
+    private parsedQuery;
+    private fullUrl;
+    private requestLog;
+    private memoHost;
+    private memoHostname;
+    private memoProtocol;
+    /**
+     * Um arquivo do upload, já recebido e validado pelo contrato `files` (F-46). Com `required: true`, nunca é
+     * `undefined`. Para campos com `maxCount` maior que 1, use `files()`.
+     */
+    file<K extends FileField<SchemasOf<S>>>(name: K): FileOf<SchemasOf<S>, K>;
+    /** Todos os arquivos de um campo do upload (F-46), na ordem em que chegaram; vazio se nenhum veio. */
+    files<K extends FileField<SchemasOf<S>>>(name: K): readonly UploadedFile[];
+    /** Body; tipado pelo schema `body`. */
+    body: InferBody<SchemasOf<S>>;
+    /** Estado por requisição, criado no primeiro acesso (F-41). */
+    get state(): ContextState;
+    set state(value: ContextState);
+    private requestState;
+    /** `true` quando o handler chamou `ctx.status()`. Usado para escolher o schema de resposta (B-05). */
+    statusExplicit: boolean;
+    private streaming;
+    private abortController;
+    /**
+     * Cancelado quando o cliente desconecta antes do fim da resposta, ou quando o app está encerrando
+     * (F-13). Passe para consultas e `fetch` longos: `db.query(sql, { signal: ctx.signal })`.
+     */
+    get signal(): AbortSignal;
+    /**
+     * Por que esta requisição foi cancelada (`CLIENT_DISCONNECTED`, `SHUTDOWN`), ou `undefined` se não foi.
+     * Atalho tipado para `ctx.signal.reason.code` (F-38).
+     */
+    get abortReason(): AbortCode | undefined;
+    /** @internal `true` em respostas de streaming (SSE, NDJSON, `Readable`) já iniciadas. */
+    get streamingResponse(): boolean;
+    private markStreaming;
+    /** @internal */
+    [kAbort](code: AbortCode): void;
+    /**
+     * Abre uma conexão de Server-Sent Events (F-13). A resposta fica aberta até `close()`, a desconexão do
+     * cliente ou o encerramento do app, que fecha estas conexões primeiro para o shutdown não esperar por elas.
+     *
+     * ```ts
+     * const stream = ctx.sse();
+     * const off = bus.on('order', (o) => stream.send({ event: 'order', id: o.id, data: o }));
+     * stream.onClose(off);
+     * ```
+     */
+    sse(opts?: SseOptions): SseStream;
+    /**
+     * Envia um arquivo com `Content-Type`, `ETag`/`Last-Modified` (304) e `Range` (206), em stream (F-13).
+     * Com `root`, o path é relativo e não pode sair dela; sem `root`, precisa ser absoluto.
+     * Arquivo inexistente responde 404.
+     */
+    sendFile(path: string, opts?: SendFileOptions): Promise<void>;
+    /** @internal */
+    [kPendingSend]: Promise<void> | undefined;
+    /**
+     * Corpo exatamente como foi escrito (F-04), depois do envio. Fica `undefined` em streams e em
+     * respostas sem corpo. Útil para cache: `await next(); store.set(key, ctx.sentBody)`.
+     */
+    get sentBody(): Buffer | undefined;
+    set sentBody(value: Buffer | undefined);
+    private sentRaw;
+    private sentBuffer;
+    /** `Content-Type` da resposta enviada, junto com `sentBody`. */
+    sentType: string | undefined;
+    private bound;
+    /**
+     * @param opts configuração; o app passa **o mesmo objeto** para todas as requisições (Flyweight), e o
+     *   que muda por requisição (`id`) vem à parte.
+     */
+    constructor(req: IncomingMessage, res: ServerResponse, opts?: ContextOptions, id?: string);
+    /**
+     * IP do cliente. Por padrão, o do socket. Com `trustProxy`, vem do `X-Forwarded-For`, que só deve
+     * ser ligado atrás de um proxy que reescreve esse header (S-09).
+     */
+    get ip(): string;
+    /**
+     * Host da requisição (`api.exemplo.com:8080`), **validado**: um valor inválido vira `''`.
+     * Com `trustProxy`, vem do `X-Forwarded-Host`. Para links absolutos, prefira uma URL base
+     * configurada em vez do host pedido pelo cliente (S-09).
+     */
+    get host(): string;
+    /** `host` sem a porta. */
+    get hostname(): string;
+    /** `https` se a conexão for TLS ou, com `trustProxy`, se o `X-Forwarded-Proto` disser; senão `http`. */
+    get protocol(): 'http' | 'https';
+    /**
+     * Define o status. Com schemas de resposta, aceita só os status declarados e o encadeamento tipa o
+     * corpo: `ctx.status(202).json({ jobId })` (F-32).
+     */
+    status<const St extends DeclaredStatus<SchemasOf<S>>>(code: St): StatusContext<S, St>;
+    /**
+     * `true` quando a resposta já foi enviada (ou está sendo, no caso de streams).
+     * Depois disso o framework não escreve mais nada na resposta.
+     */
+    get sent(): boolean;
+    /** Lê um header da requisição (case-insensitive). Headers repetidos são unidos com `, `. */
+    get(name: string): string | undefined;
+    private parsedCookies;
+    /** Cookies da requisição (objeto sem protótipo; em nomes repetidos vale o primeiro). */
+    get cookies(): Readonly<Record<string, string>>;
+    /**
+     * Adiciona um `Set-Cookie`. Padrões: `HttpOnly`, `Secure`, `SameSite=Lax` e `Path=/`.
+     * Se usar cookies para autenticar, ative também o middleware `csrf()`.
+     */
+    setCookie(name: string, value: string, opts?: CookieOptions): this;
+    /** Remove um cookie. Informe o mesmo `path` e `domain` usados ao criá-lo. */
+    clearCookie(name: string, opts?: Omit<CookieOptions, 'maxAge' | 'expires'>): this;
+    /** Define um header da resposta. */
+    header(name: string, value: OutgoingHttpHeader): this;
+    /**
+     * Envia JSON. No handler, passa pelo mesmo pipeline do `return`: schema do status, remoção de
+     * campos não declarados e status padrão (F-32).
+     */
+    json(data: unknown): this;
+    /** Resposta em texto puro (`text/plain; charset=utf-8`), pelo mesmo pipeline do `return`. */
+    text(data: string): this;
+    /**
+     * Envia o corpo pelo mesmo pipeline do `return` (F-32): com `contentType` informado, usa esse tipo;
+     * senão, a negociação do `Accept` ou o tipo do valor (string, Buffer, stream, objeto → JSON).
+     * Para HTML, faça o escape do conteúdo dinâmico antes: o framework não faz isso por você (S-02).
+     */
+    send(body: unknown, contentType?: string): this;
+    private dispatch;
+    /** @internal Liga os schemas de resposta da rota (o app chama antes do handler). */
+    [kBindResponse](plan: ResponsePlan): void;
+    /** @internal Envio cru, sem schema: string, bytes ou stream. */
+    [kRawSend](body: RawBody, contentType?: string): this;
+    /** Aplica os `onSend` do app e depois os da rota (F-43); se algum lançar, loga e envia o payload original (F-04). */
+    private runOnSend;
+    /**
+     * Redireciona (padrão 302). Não use `url` vinda do usuário sem validar: isso abre um
+     * open redirect. Prefira caminhos relativos ou uma lista de destinos permitidos.
+     */
+    redirect(url: string, status?: 301 | 302 | 303 | 307 | 308): this;
+    throw(status: number, message: string, code?: string): never;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

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