sashiko 0.11.4 → 0.13.0

package/README.md

@@ -35,6 +35,7 @@ await app.listen({ port: 3000 });
 - [Mapeamento manual](#mapeamento-manual)
 - [Schemas: validação, serialização e tipos](#schemas-validação-serialização-e-tipos)
 - [Respostas e o `ctx`](#respostas-e-o-ctx)
+- [Arquivos estáticos e streaming](#arquivos-estáticos-e-streaming)
 - [Middlewares e guards](#middlewares-e-guards)
 - [Hooks de ciclo de vida](#hooks-de-ciclo-de-vida)
 - [Erros](#erros)
@@ -348,6 +349,78 @@ Outros campos: `ctx.params`, `ctx.query`, `ctx.body`, `ctx.state`, `ctx.id`, `ct
 
 > ⚠️ `ctx.send` não faz escape de HTML; escape o conteúdo dinâmico antes. `ctx.redirect` com uma URL vinda do usuário abre um _open redirect_; valide o destino.
 
+## Arquivos estáticos e streaming
+
+### Arquivos estáticos
+
+```ts
+app.static('/assets', './public', { maxAge: '7d', immutable: true });
+app.static('/', './dist', { fallback: 'index.html' }); // SPA (use securityHeaders: 'web')
+
+app.group({ host: 'cdn.exemplo.com', guards: [auth] }, (g) => g.static('/files', './uploads'));
+```
+
+- **São rotas de verdade (`GET`/`HEAD prefix/*`):** valem `group()` (host, guards, middlewares), 404/405 e a checagem de conflitos. Não entram no OpenAPI.
+- **Segurança:**
+  - o caminho precisa ficar dentro da raiz, inclusive depois de seguir symlinks;
+  - `..` (também codificado), barra invertida e byte nulo são recusados;
+  - arquivos ocultos (`.env`, `.git`) respondem 404 por padrão (`dotfiles: 'allow'` libera);
+  - diretórios nunca são listados (o `index`, padrão `index.html`, é servido quando existe).
+- **HTTP:**
+  - `ETag` e `Last-Modified`, com 304 para `If-None-Match` e `If-Modified-Since`;
+  - `Range` de um intervalo (206, ou 416 fora do arquivo), com `If-Range`, para vídeo e downloads retomáveis;
+  - `Cache-Control` por `maxAge` (`'7d'`, `'12h'`, segundos) e `immutable`;
+  - `Content-Type` por uma tabela interna, ampliável com `mimeTypes`.
+- **SPA:** `fallback` serve o arquivo só quando o path **não tem extensão** (`/pedidos/42` → `index.html`), com `no-cache`. Um asset que falta (`/app.js`) continua 404.
+- **Raiz inexistente ou `maxAge` inválido** falham na configuração.
+- **Páginas HTML:** os headers de segurança padrão (`'api'`) bloqueiam scripts. Para servir uma SPA, use `createApp({ securityHeaders: 'web' })`.
+
+Num handler, para downloads controlados pela aplicação:
+
+```ts
+@Get('/reports/:id')
+download(ctx: Context<'/reports/:id'>) {
+  return ctx.sendFile(`${ctx.params.id}.pdf`, { root: './reports', download: 'relatório.pdf' });
+}
+```
+
+Com `root`, o path é relativo e não pode sair dela. Sem `root`, ele precisa ser absoluto. `download` envia `Content-Disposition: attachment`, com o nome em UTF-8.
+
+**Compressão:** fica a cargo da aplicação ou da infraestrutura (proxy, CDN). O core não comprime respostas.
+
+### Server-Sent Events
+
+```ts
+@Get('/events')
+events(ctx: Context) {
+  const stream = ctx.sse({ heartbeatMs: 15_000 });
+  const off = bus.on('order', (o) => stream.send({ event: 'order', id: o.id, data: o }));
+  stream.onClose(off);
+}
+```
+
+- **Headers:** já vêm configurados, inclusive `X-Accel-Buffering: no` para o Nginx não segurar os eventos.
+- **Eventos:** `data` em objeto vira JSON, e texto com várias linhas é dividido. `event` e `id` com quebra de linha geram erro, porque seria injeção de evento.
+- **Conexão:** o heartbeat (`: ping`) mantém a conexão viva atrás de proxies. `stream.lastEventId` traz o `Last-Event-ID` da reconexão.
+- **Encerramento:** `stream.onClose()` roda quando o cliente desconecta, quando o handler chama `close()` ou quando o app encerra.
+
+### Respostas em stream
+
+- **`Readable`:** `ctx.send(readable, type)` ou `return readable`, com backpressure.
+- **Async iterable → NDJSON:** um handler que retorna um async generator (ou um cursor de banco) responde em `application/x-ndjson`, uma linha JSON por item:
+
+  ```ts
+  @Get('/export', { response: { 200: { contentType: 'application/x-ndjson', schema: Row } } })
+  async *export(ctx: Context) { for await (const row of db.cursor({ signal: ctx.signal })) yield row; }
+  ```
+
+  Com schema, cada item é validado e os campos não declarados são removidos. Uma rota com schema JSON comum que retorna um iterable gera erro, orientando a declarar `application/x-ndjson`.
+
+### `ctx.signal` e encerramento
+
+- **`ctx.signal`** é um `AbortSignal` cancelado quando o cliente desconecta antes do fim da resposta. Passe-o a consultas e `fetch` longos, para não continuar um trabalho que ninguém vai ler.
+- **No shutdown:** os streams já iniciados (SSE, NDJSON) recebem o cancelamento e fecham na hora, em vez de segurar o encerramento até o prazo. Requisições comuns continuam até terminar.
+
 ## Middlewares e guards
 
 Middlewares seguem o modelo do Koa: `(ctx, next) => Promise<void>`.
@@ -750,7 +823,7 @@ Checklist:
 | `logRequests`     | `false`               | Log de cada requisição concluída                                                           |
 | `requestId`       | header `x-request-id` | `header`, `trustIncoming`, `generate`                                                      |
 
-Métodos do app: `use()`, `mount()`, `group()`, `health()`, `openapi()`, `openapiDocument()`, `onError()`, `onSend()`, `onResponse()`, `onClose()`, `listen()`, `close()`, `callback()`, `inject()`, `log`. O `mount()` devolve um `MountedGroup`, com os verbos do mapeamento manual e os mesmos métodos do app, para continuar o encadeamento.
+Métodos do app: `use()`, `mount()`, `group()`, `static()`, `health()`, `openapi()`, `openapiDocument()`, `onError()`, `onSend()`, `onResponse()`, `onClose()`, `listen()`, `close()`, `callback()`, `inject()`, `log`. O `mount()` devolve um `MountedGroup`, com os verbos do mapeamento manual e os mesmos métodos do app, para continuar o encadeamento.
 
 O body só é lido como JSON quando o `Content-Type` é `application/json` ou `application/*+json`.
 

package/dist/core/app/core.d.ts

@@ -0,0 +1,23 @@
+import type http from 'node:http';
+import type { Middleware } from '../compose.ts';
+import type { Context, OnSendHook } from '../context.ts';
+import type { Logger } from '../logger.ts';
+import type { Serializer } from '../response/pipeline.ts';
+import type { AppOptions, OnCloseHook, OnResponseHook } from './options.ts';
+/**
+ * Estado compartilhado do app entre a fachada (`SashikoApp`) e os componentes internos (registro,
+ * servidor, pipeline da requisição). Só configuração e listas de hooks; nada por requisição.
+ */
+export interface AppCore {
+    readonly opts: AppOptions;
+    readonly log: Logger;
+    readonly middlewares: Middleware[];
+    readonly errorHandlers: ((err: unknown, ctx: Context) => void | Promise<void>)[];
+    readonly onSendHooks: OnSendHook[];
+    readonly onResponseHooks: OnResponseHook[];
+    readonly onCloseHooks: OnCloseHook[];
+    readonly serializers: ReadonlyMap<string, Serializer>;
+    readonly allowedHosts: ((hostname: string, host: string) => boolean) | undefined;
+    readonly applySecurityHeaders: ((res: http.ServerResponse) => void) | undefined;
+}
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/core/app/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;IACjF,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtD,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IACjF,QAAQ,CAAC,oBAAoB,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACjF"}

package/dist/core/app/core.js

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

package/dist/core/app/core.js.map

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

package/dist/core/app/options.d.ts

@@ -0,0 +1,109 @@
+import type { Context } from '../context.ts';
+import type { ErrorFormatter } from '../errors.ts';
+import type { Logger } from '../logger.ts';
+import type { Serializer } from '../response/pipeline.ts';
+import type { ShutdownOptions } from '../shutdown.ts';
+import type { TlsOptions } from '../../server/tls.ts';
+import type { ProtoPoisoning } from '../../utils/safe-json.ts';
+import type { SecurityHeadersOptions, SecurityPreset } from '../../middlewares/security-headers.ts';
+/** Depois do envio da resposta (F-04). */
+export type OnResponseHook = (ctx: Context, info: {
+    status: number;
+    ms: number;
+}) => void | Promise<void>;
+/** No `close()` do app (F-04). */
+export type OnCloseHook = () => void | Promise<void>;
+export interface ListenOptions {
+    /** Padrão: 3000. Use 0 para uma porta livre aleatória. */
+    port?: number;
+    /** Padrão: `127.0.0.1`. Use `0.0.0.0` para aceitar conexões externas (ex.: em containers). */
+    host?: string;
+    /**
+     * Sobe em HTTPS, com os mesmos timeouts, encerramento gracioso e `close()` do HTTP. Atrás de um
+     * proxy que termina o TLS (Caddy, Nginx, load balancer), não use: fique em HTTP com `trustProxy`.
+     */
+    tls?: TlsOptions;
+}
+export interface ServerTimeouts {
+    /** Tempo máximo para receber a requisição inteira. Padrão: 30s. */
+    requestTimeout?: number;
+    /** Tempo máximo para receber os headers (mitiga Slowloris). Padrão: 10s. */
+    headersTimeout?: number;
+    /** Tempo de conexão keep-alive ociosa. Padrão: 5s. */
+    keepAliveTimeout?: number;
+}
+export interface AppOptions {
+    /** Tamanho máximo do body JSON em bytes. Padrão: 1 MiB. */
+    bodyLimit?: number;
+    /**
+     * Headers de segurança aplicados a toda resposta (S-04). Padrão: `'api'`.
+     * `'web'` libera recursos do próprio site (CSP `'self'`) para quem serve páginas; `false` desliga.
+     */
+    securityHeaders?: SecurityHeadersOptions | SecurityPreset | false;
+    /**
+     * Serializadores por content type, para responder em outros formatos (F-31):
+     * `{ 'application/yaml': (data) => YAML.stringify(data) }`. JSON e valores crus já são nativos.
+     */
+    serializers?: Record<string, Serializer>;
+    /** Timeouts do servidor HTTP (S-06). */
+    timeouts?: ServerTimeouts;
+    /**
+     * Modo estrito (S-07): exige schema de `body` em POST/PUT/PATCH e schema de `response`
+     * em toda rota, falhando no `app.mount()`. Padrão: `false`.
+     */
+    requireSchemas?: boolean;
+    /**
+     * Body JSON com `__proto__` ou `constructor.prototype` (S-08): `'error'` responde 400
+     * (`PROTO_POISONING`); `'remove'` descarta as chaves e segue. Padrão: `'error'`.
+     */
+    protoPoisoning?: ProtoPoisoning;
+    /** Máximo de pares chave/valor lidos da query string. Padrão: 1000 (S-06). */
+    queryMaxKeys?: number;
+    /** Logger compatível com pino. Padrão: `consoleLogger()`; `false` desliga (F-06). */
+    logger?: Logger | false;
+    /** Loga cada requisição concluída (método, path, status, duração) em nível `info`. Padrão: `false`. */
+    logRequests?: boolean;
+    /** Request id (F-06). */
+    requestId?: RequestIdOptions;
+    /**
+     * Encerramento gracioso nos sinais do processo, ativado pelo `listen()` (F-07).
+     * Ligado por padrão (SIGINT/SIGTERM, 10s); `false` desliga.
+     */
+    shutdown?: ShutdownOptions | false;
+    /**
+     * Confia nos headers `X-Forwarded-For`, `-Host` e `-Proto` para `ctx.ip`, `ctx.host` e `ctx.protocol`
+     * (S-09). Padrão: `false`. Use `true` para confiar em toda a cadeia, ou o número de proxies à frente
+     * do app (ex.: `1` para um load balancer). Só ligue atrás de um proxy que reescreve esses headers.
+     */
+    trustProxy?: boolean | number;
+    /**
+     * Hosts aceitos (S-09). Requisições com outro `Host` (ou `X-Forwarded-Host` confiável) recebem 400.
+     * Protege contra host header injection e DNS rebinding. Padrão: qualquer host válido.
+     * - `'api.exemplo.com'` casa com o hostname (qualquer porta); `'api.exemplo.com:8443'` exige a porta;
+     * - `'*.exemplo.dev'` aceita só subdomínios;
+     * - uma RegExp precisa casar o hostname **inteiro** (como se tivesse `^…$`).
+     */
+    allowedHosts?: readonly (string | RegExp)[];
+    /**
+     * Rotas com `host` (virtual hosts) fora do `allowedHosts` nunca são alcançadas (F-35). `'error'` (padrão)
+     * falha no registro; `'warn'` só registra um aviso no log; `'off'` não confere.
+     */
+    unreachableHosts?: 'error' | 'warn' | 'off';
+    /**
+     * Personaliza o corpo de todos os erros do framework e dos `HttpError` (F-15). Padrão: Problem
+     * Details (RFC 9457) em `application/problem+json`. O retorno é enviado como `application/json`.
+     */
+    formatError?: ErrorFormatter;
+}
+export interface RequestIdOptions {
+    /** Header lido da requisição e devolvido na resposta. Padrão: `x-request-id`. `false` não envia. */
+    header?: string | false;
+    /**
+     * Reaproveita o id recebido no header (útil atrás de um gateway). Padrão: `true`.
+     * O valor só é aceito se tiver até 128 caracteres de `[A-Za-z0-9._:-]`, para evitar log injection.
+     */
+    trustIncoming?: boolean;
+    /** Gerador de ids. Padrão: `crypto.randomUUID()`. */
+    generate?: () => string;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/core/app/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/core/app/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEpG,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1G,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,sBAAsB,GAAG,cAAc,GAAG,KAAK,CAAC;IAClE;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,uGAAuG;IACvG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,GAAG,KAAK,CAAC;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC5C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IAC5C;;;OAGG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;CACzB"}

package/dist/core/app/options.js

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

package/dist/core/app/options.js.map

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

package/dist/core/app.d.ts

@@ -1,147 +1,29 @@
-import http from 'node:http';
-import https from 'node:https';
-import { type TlsOptions } from '../server/tls.ts';
+import type http from 'node:http';
+import type https from 'node:https';
+import '../shims/symbol-metadata.ts';
+import type { TlsOptions } from '../server/tls.ts';
 import { type GroupOptions, type MountOptions, type RouteScope, type RouterRef } from './compiler.ts';
-import { RouteGroupScope } from './mounted-group.ts';
-import { MountedGroup } from './mounted-group.ts';
-import { type Middleware } from './compose.ts';
-import { Context, type OnSendHook } from './context.ts';
+import { MountedGroup, RouteGroupScope } from './mounted-group.ts';
+import type { Middleware } from './compose.ts';
+import type { Context, OnSendHook } from './context.ts';
+import { type StaticOptions } from '../server/static.ts';
 import { type OpenAPIOptions } from '../openapi/generate.ts';
 import { type HealthOptions } from './health.ts';
-import '../shims/symbol-metadata.ts';
-import type { ProtoPoisoning } from '../utils/safe-json.ts';
-import { type Serializer } from './response.ts';
-import type { ErrorFormatter } from './errors.ts';
 import { type InjectOptions, type InjectResponse } from './inject.ts';
-import { type ShutdownOptions } from './shutdown.ts';
 import { type Logger } from './logger.ts';
-import { type SecurityHeadersOptions, type SecurityPreset } from '../middlewares/security-headers.ts';
-/** Depois do envio da resposta (F-04). */
-export type OnResponseHook = (ctx: Context, info: {
-    status: number;
-    ms: number;
-}) => void | Promise<void>;
-/** No `close()` do app (F-04). */
-export type OnCloseHook = () => void | Promise<void>;
-export interface ListenOptions {
-    /** Padrão: 3000. Use 0 para uma porta livre aleatória. */
-    port?: number;
-    /** Padrão: `127.0.0.1`. Use `0.0.0.0` para aceitar conexões externas (ex.: em containers). */
-    host?: string;
-    /**
-     * Sobe em HTTPS, com os mesmos timeouts, encerramento gracioso e `close()` do HTTP. Atrás de um
-     * proxy que termina o TLS (Caddy, Nginx, load balancer), não use: fique em HTTP com `trustProxy`.
-     */
-    tls?: TlsOptions;
-}
-export interface ServerTimeouts {
-    /** Tempo máximo para receber a requisição inteira. Padrão: 30s. */
-    requestTimeout?: number;
-    /** Tempo máximo para receber os headers (mitiga Slowloris). Padrão: 10s. */
-    headersTimeout?: number;
-    /** Tempo de conexão keep-alive ociosa. Padrão: 5s. */
-    keepAliveTimeout?: number;
-}
-export interface AppOptions {
-    /** Tamanho máximo do body JSON em bytes. Padrão: 1 MiB. */
-    bodyLimit?: number;
-    /**
-     * Headers de segurança aplicados a toda resposta (S-04). Padrão: `'api'`.
-     * `'web'` libera recursos do próprio site (CSP `'self'`) para quem serve páginas; `false` desliga.
-     */
-    securityHeaders?: SecurityHeadersOptions | SecurityPreset | false;
-    /**
-     * Serializadores por content type, para responder em outros formatos (F-31):
-     * `{ 'application/yaml': (data) => YAML.stringify(data) }`. JSON e valores crus já são nativos.
-     */
-    serializers?: Record<string, Serializer>;
-    /** Timeouts do servidor HTTP (S-06). */
-    timeouts?: ServerTimeouts;
-    /**
-     * Modo estrito (S-07): exige schema de `body` em POST/PUT/PATCH e schema de `response`
-     * em toda rota, falhando no `app.mount()`. Padrão: `false`.
-     */
-    requireSchemas?: boolean;
-    /**
-     * Body JSON com `__proto__` ou `constructor.prototype` (S-08): `'error'` responde 400
-     * (`PROTO_POISONING`); `'remove'` descarta as chaves e segue. Padrão: `'error'`.
-     */
-    protoPoisoning?: ProtoPoisoning;
-    /** Máximo de pares chave/valor lidos da query string. Padrão: 1000 (S-06). */
-    queryMaxKeys?: number;
-    /** Logger compatível com pino. Padrão: `consoleLogger()`; `false` desliga (F-06). */
-    logger?: Logger | false;
-    /** Loga cada requisição concluída (método, path, status, duração) em nível `info`. Padrão: `false`. */
-    logRequests?: boolean;
-    /** Request id (F-06). */
-    requestId?: RequestIdOptions;
-    /**
-     * Encerramento gracioso nos sinais do processo, ativado pelo `listen()` (F-07).
-     * Ligado por padrão (SIGINT/SIGTERM, 10s); `false` desliga.
-     */
-    shutdown?: ShutdownOptions | false;
-    /**
-     * Confia nos headers `X-Forwarded-For`, `-Host` e `-Proto` para `ctx.ip`, `ctx.host` e `ctx.protocol`
-     * (S-09). Padrão: `false`. Use `true` para confiar em toda a cadeia, ou o número de proxies à frente
-     * do app (ex.: `1` para um load balancer). Só ligue atrás de um proxy que reescreve esses headers.
-     */
-    trustProxy?: boolean | number;
-    /**
-     * Hosts aceitos (S-09). Requisições com outro `Host` (ou `X-Forwarded-Host` confiável) recebem 400.
-     * Protege contra host header injection e DNS rebinding. Padrão: qualquer host válido.
-     * - `'api.exemplo.com'` casa com o hostname (qualquer porta); `'api.exemplo.com:8443'` exige a porta;
-     * - `'*.exemplo.dev'` aceita só subdomínios;
-     * - uma RegExp precisa casar o hostname **inteiro** (como se tivesse `^…$`).
-     */
-    allowedHosts?: readonly (string | RegExp)[];
-    /**
-     * Rotas com `host` (virtual hosts) fora do `allowedHosts` nunca são alcançadas (F-35). `'error'` (padrão)
-     * falha no registro; `'warn'` só registra um aviso no log; `'off'` não confere.
-     */
-    unreachableHosts?: 'error' | 'warn' | 'off';
-    /**
-     * Personaliza o corpo de todos os erros do framework e dos `HttpError` (F-15). Padrão: Problem
-     * Details (RFC 9457) em `application/problem+json`. O retorno é enviado como `application/json`.
-     */
-    formatError?: ErrorFormatter;
-}
-export interface RequestIdOptions {
-    /** Header lido da requisição e devolvido na resposta. Padrão: `x-request-id`. `false` não envia. */
-    header?: string | false;
-    /**
-     * Reaproveita o id recebido no header (útil atrás de um gateway). Padrão: `true`.
-     * O valor só é aceito se tiver até 128 caracteres de `[A-Za-z0-9._:-]`, para evitar log injection.
-     */
-    trustIncoming?: boolean;
-    /** Gerador de ids. Padrão: `crypto.randomUUID()`. */
-    generate?: () => string;
-}
+import type { AppOptions, ListenOptions, OnCloseHook, OnResponseHook } from './app/options.ts';
+export type { AppOptions, ListenOptions, OnCloseHook, OnResponseHook, RequestIdOptions, ServerTimeouts } from './app/options.ts';
+/**
+ * O app. É uma fachada (Facade) sobre o registro de rotas, as rotas do próprio framework (health, OpenAPI),
+ * o servidor e o pipeline da requisição: a API pública fica aqui, e o trabalho fica nesses componentes.
+ */
 export declare class SashikoApp {
-    private middlewares;
-    private router;
-    private errorHandlers;
-    private readonly onSendHooks;
-    private readonly onResponseHooks;
-    private readonly onCloseHooks;
-    private readonly routes;
-    /** Registros pendentes de um `group()` em andamento (duas fases). */
-    private pending;
-    private readonly warnedHosts;
-    private draining;
-    private healthConfig;
-    private openapiConfig;
-    private closeHooksPending;
-    private applySecurityHeaders;
-    private readonly opts;
-    private readonly allowedHosts;
-    private readonly serializers;
-    private server;
-    private tlsState;
-    /** Respostas em andamento, para o encerramento gracioso não travar em conexões keep-alive. */
-    private readonly inflight;
-    private closing;
-    /** Logger do app (F-06). Use para logs fora de uma requisição. */
     readonly log: Logger;
+    private readonly core;
+    private readonly registry;
+    private readonly framework;
+    private readonly runtime;
+    private readonly requests;
     constructor(opts?: AppOptions);
     use(mw: Middleware): this;
     onError(h: (err: unknown, ctx: Context) => void | Promise<void>): this;
@@ -188,6 +70,19 @@ export declare class SashikoApp {
     group(options: GroupOptions, define: (group: RouteGroupScope) => unknown): this;
     /** @internal */
     groupIn(parent: RouteScope, options: GroupOptions, define: (group: RouteGroupScope) => unknown): void;
+    /**
+     * Serve os arquivos de `root` em `GET prefix/*` (F-13). É uma rota como as outras: vale `group()`
+     * (host, guards, middlewares), 404/405 e a checagem de conflitos. Não entra no OpenAPI.
+     *
+     * ```ts
+     * app.static('/assets', './public', { maxAge: '7d', immutable: true });
+     * app.static('/', './dist', { fallback: 'index.html' }); // SPA
+     * ```
+     * Caminhos que saem da raiz (`..`, symlinks), arquivos ocultos e diretórios sem índice respondem 404.
+     */
+    static(prefix: string, root: string, opts?: StaticOptions): this;
+    /** @internal */
+    staticIn(scope: RouteScope, prefix: string, root: string, opts: StaticOptions): void;
     /** @internal */
     mountIn(scope: RouteScope, ref: RouterRef, options?: MountOptions): MountedGroup<object>;
     /**
@@ -206,52 +101,20 @@ export declare class SashikoApp {
      * consumir rate limit); use `guards`/`middlewares` aqui para restringir.
      */
     health(opts?: HealthOptions): this;
-    /** Paths servidos pelo próprio app (`health()`, `openapi()`), que encobririam uma rota GET do usuário. */
-    private reservedPaths;
-    /** Um path do framework não pode coincidir com uma rota GET/HEAD registrada nem com outro do framework. */
-    private assertFreePaths;
     /**
      * Documento OpenAPI 3.1 das rotas registradas até agora, para gravar em arquivo ou testar (F-16).
      * Com virtual hosts, é por host (F-35): `{ host: 'api.exemplo.com' }` traz as rotas desse host e as sem
      * host; sem `host`, só as sem host. Domínios diferentes nunca se misturam num mesmo documento.
      */
     openapiDocument(opts?: OpenAPIOptions): Record<string, unknown>;
-    /**
-     * Rotas que o roteador **executaria** num host (F-35): para cada método e path, só a vencedora pela mesma
-     * prioridade do roteador (exato → curinga mais específico → RegExp → sem host). Assim o OpenAPI documenta
-     * exatamente o handler que responde. Sem `hostname`, só as rotas sem host.
-     */
-    private routesFor;
-    /** Se a requisição é para `/openapi.json` ou `/docs` (quando ligados), responde e devolve `true`. */
-    private serveOpenAPI;
-    /**
-     * Primeira fase: valida as rotas (schemas obrigatórios, hosts alcançáveis, conflitos com o roteador e
-     * dentro do próprio lote). Dentro de um `group()`, acumula; fora, efetiva na hora.
-     */
-    private stage;
-    /**
-     * Segunda fase: registra o lote no roteador. Se algo ainda falhar (um conflito que o `has()` não prevê),
-     * desfaz o que já entrou, e nenhuma rota do lote fica registrada.
-     */
-    private commit;
-    /**
-     * Um host de rota sem interseção com o `allowedHosts` nunca seria alcançado: o app responde 400 antes do
-     * roteamento (F-35). Comprovado: erro (ou aviso, com `unreachableHosts: 'warn'`). Sem como provar
-     * (RegExp em algum dos lados): aviso.
-     */
-    private checkReachableHosts;
+    /** Executa o pipeline completo para um contexto já criado. */
     handle(ctx: Context): Promise<void>;
-    /**
-     * 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;
     /**
      * 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;
-    /** Sobe o servidor HTTP e resolve quando ele está aceitando conexões (F-09). */
+    /** Sobe o servidor HTTP (ou HTTPS, com `tls`) e resolve quando ele está aceitando conexões (F-09, F-33). */
     listen(options: ListenOptions & {
         tls: TlsOptions;
     }): Promise<https.Server>;
@@ -261,15 +124,11 @@ export declare class SashikoApp {
      * usam os novos; as abertas seguem com os antigos. Um certificado inválido lança erro e mantém os atuais.
      */
     reloadTLS(tls: TlsOptions): void;
-    /** Ponte entre este app e o coordenador de sinais (F-07). */
-    private readonly shutdownTarget;
     /**
      * Para de aceitar conexões, encerra as ociosas e espera as requisições em andamento terminarem.
      * Depois de `graceMs`, força o fechamento das restantes.
      */
     close(graceMs?: number): Promise<void>;
-    /** `onClose` uma vez por ciclo (até o próximo `listen`); todos rodam mesmo se algum falhar (F-04). */
-    private runCloseHooks;
     /** Executa uma requisição em memória, sem rede. Ideal para testes (F-09). */
     inject(opts: InjectOptions | string): Promise<InjectResponse>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/core/app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/core/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAGvE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAM/F,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWjI;;;GAGG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,YAAY,IAAI,GAAE,UAAe,EAuBhC;IAED,GAAG,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAGxB;IAED,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAGrE;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAG7B;IAED;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAGrC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAG/B;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACtF,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAKzI;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,GAAG,IAAI,CAG9E;IAED,gBAAgB;IAChB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,GAAG,IAAI,CA2BpG;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,IAAI,CAGnE;IAED,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAoBnF;IAED,gBAAgB;IAChB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY,CAAC,MAAM,CAAC,CAa3F;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAI,GAAE,cAAmB,GAAG,IAAI,CAUvC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,IAAI,CAKrC;IAED;;;;OAIG;IACH,eAAe,CAAC,IAAI,GAAE,cAAmD,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElG;IAED,8DAA8D;IAC9D,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAElC;IAED;;;OAGG;IACH,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CAExE;IAED,4GAA4G;IAC5G,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,GAAG,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAK/D;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAE/B;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAErC;IAED,6EAA6E;IAC7E,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAE5D;CACF;AAED,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAEvD"}