flowingts 0.0.0 → 0.19.0

package/dist/core/runtime/request-handler.js

@@ -0,0 +1,256 @@
+import { randomUUID } from 'node:crypto';
+import { performance } from 'node:perf_hooks';
+import { compileChain } from '../compose.js';
+import { bodyReader } from '../body-parser.js';
+import { isJsonContentType, mediaType } from '../../utils/content-type.js';
+import { buildRouteProgram } from '../registry/route-program.js';
+import { kHooks, kPhase, kRoute, kRouted } from '../symbols.js';
+import { parseTraceparent } from '../../utils/trace-context.js';
+import { Context } from '../context.js';
+import { problem, sendError, sendProblem } from '../response/pipeline.js';
+const SAFE_REQUEST_ID = /^[A-Za-z0-9._:-]{1,128}$/;
+/**
+ * Normaliza os `parsers` do app (F-12) pelo tipo de mídia, na criação: um tipo inválido falha aqui, e não na primeira
+ * requisição. O JSON é nativo (com a proteção do S-08 e o erro `INVALID_JSON`) e não pode ser substituído.
+ */
+function compileParsers(parsers) {
+    const out = new Map();
+    for (const [type, parser] of Object.entries(parsers ?? {})) {
+        const media = mediaType(type);
+        if (!/^[a-z0-9!#$&^_.+-]+\/[a-z0-9!#$&^_.+-]+$/.test(media)) {
+            throw new Error(`[flowing] parsers: "${type}" is not a media type (use something like "application/yaml").`);
+        }
+        if (isJsonContentType(media)) {
+            throw new Error(`[flowing] parsers: "${type}" is JSON, which the framework already parses; remove it from parsers.`);
+        }
+        if (typeof parser !== 'function')
+            throw new Error(`[flowing] parsers: the parser for "${type}" must be a function.`);
+        out.set(media, parser);
+    }
+    return out;
+}
+/**
+ * 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 class RequestHandler {
+    core;
+    registry;
+    framework;
+    server;
+    observer;
+    constructor(core, registry, framework, server, observer) {
+        this.core = core;
+        this.registry = registry;
+        this.framework = framework;
+        this.server = server;
+        this.observer = observer;
+        this.readBody = bodyReader(core.opts.bodyLimit ?? 1024 * 1024, core.opts.protoPoisoning, compileParsers(core.opts.parsers));
+    }
+    /**
+     * 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() {
+        const rid = this.core.opts.requestId ?? {};
+        const header = rid.header === false ? undefined : (rid.header ?? 'x-request-id').toLowerCase();
+        const trust = rid.trustIncoming ?? true;
+        const generate = rid.generate ?? (() => randomUUID());
+        // Factory + Flyweight (F-39): a mesma configuração para todos os contextos deste listener, em vez de
+        // um objeto de opções novo a cada requisição.
+        const contextOptions = {
+            queryMaxKeys: this.core.opts.queryMaxKeys,
+            queryParser: this.core.opts.queryParser,
+            contracts: this.core.contracts,
+            logger: this.core.log,
+            trustProxy: this.core.opts.trustProxy,
+            onSend: this.core.onSendHooks,
+            ...(this.core.telemetry ? { spanIds: this.core.telemetry.spanIds } : {}),
+            onStream: (ctx) => {
+                server.streams.add(ctx);
+                ctx.res.once('close', () => server.streams.delete(ctx));
+            },
+        };
+        const server = this.server;
+        const observer = this.observer;
+        // Listener compartilhado por todas as respostas (antes, uma closure por requisição).
+        const onClose = () => {
+            // Durante o close(), cada resposta concluída libera as conexões que ficaram ociosas.
+            server.closing?.closeIdleConnections();
+        };
+        return (req, res) => {
+            const started = observer.watching ? performance.now() : -1;
+            if (server.closing)
+                res.setHeader('Connection', 'close');
+            res.on('close', onClose);
+            const incoming = header ? req.headers[header] : undefined;
+            // Sem X-Request-Id aceito, o traceId de um `traceparent` válido vira o id: logs e traces com a mesma chave.
+            const id = trust && typeof incoming === 'string' && SAFE_REQUEST_ID.test(incoming)
+                ? incoming
+                : req.headers.traceparent
+                    ? (parseTraceparent(req.headers.traceparent)?.traceId ?? generate())
+                    : generate();
+            if (header)
+                res.setHeader(header, id);
+            try {
+                const ctx = new Context(req, res, contextOptions, id);
+                // Antes da validação do Host: toda requisição observada no início também é observada no fim.
+                observer.start(ctx, started);
+                // S-09: Host ausente, malformado ou fora da lista permitida → 400, antes de qualquer middleware.
+                // Exceção: healthchecks aceitam qualquer host válido, porque sondas chegam com o IP do pod.
+                const healthProbe = this.framework.health?.bypassesHostCheck(ctx.method, ctx.path) ?? false;
+                if (!ctx.host || (this.core.allowedHosts && !healthProbe && !this.core.allowedHosts(ctx.hostname, ctx.host))) {
+                    this.core.applySecurityHeaders?.(res);
+                    sendProblem(ctx, problem(400, 'Invalid Host header', { code: 'INVALID_HOST' }), this.core.opts.formatError);
+                    return;
+                }
+                // Síncrono no caso comum: só uma requisição que de fato ficou assíncrona recebe o handler da barreira.
+                const step = observer.run(ctx, () => this.run(ctx));
+                if (step)
+                    step.then(undefined, (err) => this.fail(err, req, res, id));
+            }
+            catch (err) {
+                this.fail(err, req, res, id);
+            }
+        };
+    }
+    // Última barreira (B-08): `fail` recebe o que escapar, de forma síncrona (try/catch) ou assíncrona (.then).
+    fail(err, req, res, id) {
+        this.core.log.error({ err, reqId: id, method: req.method, url: req.url }, 'unhandled error while handling request');
+        if (!res.headersSent)
+            res.statusCode = 500;
+        if (!res.writableEnded)
+            res.end();
+    }
+    /** Cadeia global compilada; refeita só quando `app.use()` acrescenta um middleware. */
+    globalChain;
+    readBody;
+    /** O pipeline completo, como uma Promise (API pública: `app.handle()`). */
+    async handle(ctx) {
+        await this.run(ctx);
+    }
+    /**
+     * 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) {
+        // Antes de tudo, para valer inclusive em erros, 404 e preflight (S-04).
+        this.core.applySecurityHeaders?.(ctx.res);
+        try {
+            // Healthchecks antes dos middlewares globais: sondas do load balancer não têm credenciais.
+            const health = this.framework.health;
+            if (health?.handles(ctx.method, ctx.path))
+                return this.catching(ctx, this.serveHealth(ctx));
+            return this.catching(ctx, this.afterHealth(ctx));
+        }
+        catch (err) {
+            return this.runErrorHandlers(err, ctx);
+        }
+    }
+    /** Liga a parte assíncrona (se houver) ao tratamento de erros. */
+    catching(ctx, step) {
+        return step ? step.then(undefined, (err) => this.runErrorHandlers(err, ctx)) : undefined;
+    }
+    async serveHealth(ctx) {
+        if (await this.framework.health.serve(ctx, this.server.draining || this.server.closing !== undefined))
+            return;
+        await this.afterHealth(ctx);
+    }
+    afterHealth(ctx) {
+        // O body chega lido aos middlewares globais (invariante 5), sem uma camada de middleware para isso.
+        ctx[kPhase] = 'validation';
+        const reading = this.readBody(ctx);
+        if (reading)
+            return reading.then(() => this.afterBody(ctx));
+        return this.afterBody(ctx);
+    }
+    afterBody(ctx) {
+        ctx[kPhase] = 'middleware';
+        const step = this.chain()(ctx);
+        if (step)
+            return step.then(() => this.checkRouted(ctx));
+        this.checkRouted(ctx);
+        return undefined;
+    }
+    /**
+     * 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.
+     */
+    checkRouted(ctx) {
+        if (!ctx[kRouted] && !ctx.sent) {
+            ctx.log.warn({ method: ctx.method, path: ctx.path }, 'a global middleware neither called next() nor sent a response');
+            sendProblem(ctx, problem(404, undefined, { code: 'NOT_FOUND' }), this.core.opts.formatError);
+        }
+    }
+    /**
+     * 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.
+     */
+    chain() {
+        const mws = this.core.middlewares;
+        if (this.globalChain?.size !== mws.length) {
+            this.globalChain = { size: mws.length, run: compileChain([...mws], (ctx) => this.route(ctx)) };
+        }
+        return this.globalChain.run;
+    }
+    /** Fim da cadeia global: OpenAPI, roteamento, 404/405 e o programa da rota. */
+    route(ctx) {
+        ctx[kRouted] = true;
+        if (ctx.sent)
+            return undefined;
+        // Só cria a Promise do OpenAPI se ele estiver configurado (F-41).
+        if (this.framework.openapi) {
+            return this.framework.serveOpenAPI(ctx).then((served) => (served ? undefined : this.dispatch(ctx)));
+        }
+        return this.dispatch(ctx);
+    }
+    /** Roteamento, 404/405 e o programa da rota. */
+    dispatch(ctx) {
+        // F-35: hosts não diferenciam maiúsculas; as regras já são compiladas em minúsculas.
+        const hostname = ctx.hostname.toLowerCase();
+        const match = this.registry.router.find(ctx.method, ctx.path, hostname);
+        if (!match) {
+            const allowed = this.registry.router.allowedMethods(ctx.path, hostname);
+            if (allowed.length > 0) {
+                ctx.res.setHeader('Allow', allowed.join(', '));
+                // F-08: OPTIONS automático para qualquer path com rotas.
+                if (ctx.method === 'OPTIONS')
+                    return void ctx.status(204).res.end();
+                return void sendProblem(ctx, problem(405, undefined, { code: 'METHOD_NOT_ALLOWED', details: { allowed } }), this.core.opts.formatError);
+            }
+            return void sendProblem(ctx, problem(404, undefined, { code: 'NOT_FOUND' }), this.core.opts.formatError);
+        }
+        ctx.params = match.params;
+        const info = match.route.info;
+        if (info) {
+            ctx[kRoute] = info;
+            this.observer.routed(ctx, info);
+        }
+        // O programa é montado no commit do registro; o fallback cobre rotas registradas por fora dele.
+        const run = (match.route.run ??= buildRouteProgram(match.route, this.core.serializers, this.core.uploads));
+        return run(ctx);
+    }
+    /**
+     * 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).
+     */
+    async runErrorHandlers(err, ctx) {
+        this.observer.failed(ctx, err);
+        // Os da rota primeiro, do mais específico para o mais externo (F-43); depois os do app.
+        const scoped = ctx.route?.[kHooks]?.onError;
+        for (const h of scoped ? [...scoped, ...this.core.errorHandlers] : this.core.errorHandlers) {
+            try {
+                await h(err, ctx, ctx[kPhase]);
+            }
+            catch (handlerErr) {
+                ctx.log.error({ err: handlerErr, method: ctx.method, path: ctx.path }, 'onError handler failed');
+                break;
+            }
+            if (ctx.res.writableEnded)
+                return;
+        }
+        sendError(ctx, err, this.core.opts.formatError);
+    }
+}
+//# sourceMappingURL=request-handler.js.map

package/dist/core/runtime/request-handler.js.map

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

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

@@ -0,0 +1,59 @@
+import http from 'node:http';
+import https from 'node:https';
+import type { AppCore } from '../app/core.ts';
+import type { ListenOptions } from '../app/options.ts';
+import type { Context } from '../context.ts';
+import { type ShutdownTarget } from '../shutdown.ts';
+import { type RequestObserver } from './observer.ts';
+import { type TlsOptions } from '../../server/tls.ts';
+/** Servidor HTTP/HTTPS do app: `listen`, `close`, troca de certificados, drain e shutdown por sinal (F-07, F-33). */
+export declare class ServerLifecycle {
+    private readonly core;
+    /** Listener `(req, res)` do app, criado a cada `listen()`. */
+    private readonly listener;
+    /** Diz se há quem observe o fim da requisição (o `ttfbMs` só é medido nesse caso). */
+    private readonly observer;
+    server: http.Server | https.Server | undefined;
+    private tlsState;
+    /**
+     * Respostas de streaming abertas (SSE, NDJSON, `Readable`), que o `close()` cancela para não esperar por
+     * elas. Só streams entram aqui: um conjunto com todas as respostas em andamento fazia cada uma sobreviver
+     * às coletas rápidas do V8 e ser promovida, junto com `req` e o parser, e dobrava o RSS de pico (F-41).
+     */
+    readonly streams: Set<Context<import("../metadata.ts").RouteSchemas>>;
+    closing: http.Server | https.Server | undefined;
+    draining: boolean;
+    private closeHooksPending;
+    /**
+     * Respostas dos servidores criados pelo `listen()`. Durante o `close()`, as que ainda não enviaram headers
+     * saem com `Connection: close`, para o cliente não reaproveitar a conexão. Assim o app não precisa guardar
+     * as respostas em andamento só para isso (F-41). Quando há quem observe o fim da requisição (`onResponse`,
+     * `logRequests`, `telemetry`), também guarda o instante dos headers, para o `ttfbMs` (F-38). No protótipo,
+     * e não um wrapper por resposta: um wrapper por instância fazia cada resposta ser promovida e dobrava o RSS.
+     */
+    private readonly responseClass;
+    constructor(core: AppCore, 
+    /** Listener `(req, res)` do app, criado a cada `listen()`. */
+    listener: () => http.RequestListener, 
+    /** Diz se há quem observe o fim da requisição (o `ttfbMs` só é medido nesse caso). */
+    observer: RequestObserver);
+    listen(options: ListenOptions & {
+        tls: TlsOptions;
+    }): Promise<https.Server>;
+    listen(options?: number | ListenOptions): Promise<http.Server>;
+    /**
+     * Troca os certificados sem reiniciar nem derrubar conexões (renovação, ACME externo). Conexões novas
+     * 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). */
+    readonly shutdownTarget: 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). */
+    runCloseHooks(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjF,qHAAqH;AACrH,qBAAa,eAAe;IAkCxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,sFAAsF;IACtF,OAAO,CAAC,QAAQ,CAAC,QAAQ;IArC3B,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAC/C,OAAO,CAAC,QAAQ,CAA6C;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,sDAAsB;IACtC,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,UAAS;IACjB,OAAO,CAAC,iBAAiB,CAAQ;IAEjC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAWzB;IAEL,YACmB,IAAI,EAAE,OAAO;IAC9B,8DAA8D;IAC7C,QAAQ,EAAE,MAAM,IAAI,CAAC,eAAe;IACrD,sFAAsF;IACrE,QAAQ,EAAE,eAAe,EAQ3C;IAEK,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;IAkCrE;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAS/B;IAED,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,cAAc,CAoBrC;IAEF;;;OAGG;IACG,KAAK,CAAC,OAAO,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB3C;IAED,sGAAsG;IAChG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAanC;CACF"}

package/dist/core/runtime/server.js

@@ -0,0 +1,180 @@
+import http from 'node:http';
+import https from 'node:https';
+import { shutdownCoordinator } from '../shutdown.js';
+import { kAbort } from '../symbols.js';
+import { markHeadersSent } from './observer.js';
+import { compileTls } from '../../server/tls.js';
+/** Servidor HTTP/HTTPS do app: `listen`, `close`, troca de certificados, drain e shutdown por sinal (F-07, F-33). */
+export class ServerLifecycle {
+    core;
+    listener;
+    observer;
+    server;
+    tlsState;
+    /**
+     * Respostas de streaming abertas (SSE, NDJSON, `Readable`), que o `close()` cancela para não esperar por
+     * elas. Só streams entram aqui: um conjunto com todas as respostas em andamento fazia cada uma sobreviver
+     * às coletas rápidas do V8 e ser promovida, junto com `req` e o parser, e dobrava o RSS de pico (F-41).
+     */
+    streams = new Set();
+    closing;
+    draining = false;
+    closeHooksPending = true;
+    /**
+     * Respostas dos servidores criados pelo `listen()`. Durante o `close()`, as que ainda não enviaram headers
+     * saem com `Connection: close`, para o cliente não reaproveitar a conexão. Assim o app não precisa guardar
+     * as respostas em andamento só para isso (F-41). Quando há quem observe o fim da requisição (`onResponse`,
+     * `logRequests`, `telemetry`), também guarda o instante dos headers, para o `ttfbMs` (F-38). No protótipo,
+     * e não um wrapper por resposta: um wrapper por instância fazia cada resposta ser promovida e dobrava o RSS.
+     */
+    responseClass = (() => {
+        const lifecycle = this;
+        class FlowingResponse extends http.ServerResponse {
+        }
+        // Atribuição no protótipo: o `writeHead` do Node tem várias sobrecargas, e só repassamos os argumentos.
+        const base = http.ServerResponse.prototype.writeHead;
+        FlowingResponse.prototype.writeHead = function (...args) {
+            if (lifecycle.closing)
+                this.shouldKeepAlive = false;
+            if (lifecycle.observer.watching)
+                markHeadersSent(this);
+            return base.apply(this, args);
+        };
+        return FlowingResponse;
+    })();
+    constructor(core, 
+    /** Listener `(req, res)` do app, criado a cada `listen()`. */
+    listener, 
+    /** Diz se há quem observe o fim da requisição (o `ttfbMs` só é medido nesse caso). */
+    observer) {
+        this.core = core;
+        this.listener = listener;
+        this.observer = observer;
+        const sd = core.opts.shutdown || {};
+        Object.assign(this.shutdownTarget, {
+            log: core.log,
+            signals: sd.signals ?? ['SIGINT', 'SIGTERM'],
+            exitOnShutdown: sd.exit ?? true,
+        });
+    }
+    async listen(options = {}) {
+        if (this.server)
+            throw new Error('[flowing] app is already listening; call app.close() first.');
+        const { port = 3000, host = '127.0.0.1', tls } = typeof options === 'number' ? { port: options } : options;
+        let server;
+        if (tls) {
+            const sni = { current: { find: () => undefined } };
+            const compiled = compileTls(tls, sni);
+            server = https.createServer({ ...compiled.options, ServerResponse: this.responseClass }, this.listener());
+            this.tlsState = { sni };
+        }
+        else {
+            server = http.createServer({ ServerResponse: this.responseClass }, this.listener());
+            this.tlsState = undefined;
+        }
+        const t = this.core.opts.timeouts ?? {};
+        server.requestTimeout = t.requestTimeout ?? 30_000;
+        server.headersTimeout = Math.min(t.headersTimeout ?? 10_000, server.requestTimeout || Infinity);
+        server.keepAliveTimeout = t.keepAliveTimeout ?? 5_000;
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(port, host, () => {
+                server.off('error', reject);
+                resolve();
+            });
+        });
+        this.server = server;
+        this.closeHooksPending = true;
+        this.draining = false;
+        if (this.core.opts.shutdown !== false)
+            shutdownCoordinator.register(this.shutdownTarget);
+        return server;
+    }
+    /**
+     * Troca os certificados sem reiniciar nem derrubar conexões (renovação, ACME externo). Conexões novas
+     * usam os novos; as abertas seguem com os antigos. Um certificado inválido lança erro e mantém os atuais.
+     */
+    reloadTLS(tls) {
+        const server = this.server;
+        if (!server || !this.tlsState || !(server instanceof https.Server)) {
+            throw new Error('[flowing] reloadTLS(): the app is not listening with { tls }.');
+        }
+        const next = { current: this.tlsState.sni.current };
+        const compiled = compileTls(tls, next); // valida tudo antes de trocar
+        if (compiled.main)
+            server.setSecureContext(compiled.main);
+        this.tlsState.sni.current = next.current;
+    }
+    /** Ponte entre este app e o coordenador de sinais (F-07). */
+    shutdownTarget = {
+        log: undefined, // definido no construtor
+        signals: [],
+        exitOnShutdown: true,
+        shutdown: async (signal) => {
+            const opts = this.core.opts.shutdown || {};
+            try {
+                this.draining = true;
+                if (opts.drainDelayMs) {
+                    this.core.log.info({ signal, drainDelayMs: opts.drainDelayMs }, 'draining before shutdown');
+                    await new Promise((r) => setTimeout(r, opts.drainDelayMs));
+                }
+                await this.close(opts.timeoutMs ?? 10_000);
+                await opts.onShutdown?.(signal);
+                return true;
+            }
+            catch (err) {
+                this.core.log.error({ err, signal }, 'error during graceful shutdown');
+                return false;
+            }
+        },
+    };
+    /**
+     * 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.
+     */
+    async close(graceMs = 10_000) {
+        const server = this.server;
+        if (!server)
+            return this.runCloseHooks();
+        this.server = undefined;
+        this.closing = server;
+        // Streams longos (SSE, NDJSON) não terminam sozinhos: o `ctx.signal` é cancelado para eles fecharem
+        // já, em vez de segurar o encerramento até o prazo. Requisições comuns seguem até terminar, e cada
+        // conexão é fechada assim que fica ociosa (listener `close` das respostas, no request-handler).
+        for (const ctx of this.streams)
+            ctx[kAbort]('SHUTDOWN');
+        const force = setTimeout(() => server.closeAllConnections(), graceMs);
+        force.unref();
+        try {
+            await new Promise((resolve, reject) => {
+                server.close((err) => (err ? reject(err) : resolve()));
+                server.closeIdleConnections();
+            });
+        }
+        finally {
+            clearTimeout(force);
+            this.closing = undefined;
+            shutdownCoordinator.unregister(this.shutdownTarget);
+        }
+        await this.runCloseHooks();
+    }
+    /** `onClose` uma vez por ciclo (até o próximo `listen`); todos rodam mesmo se algum falhar (F-04). */
+    async runCloseHooks() {
+        if (!this.closeHooksPending)
+            return;
+        this.closeHooksPending = false;
+        const errors = [];
+        for (const hook of this.core.onCloseHooks) {
+            try {
+                await hook();
+            }
+            catch (err) {
+                errors.push(err);
+                this.core.log.error({ err }, 'onClose hook failed');
+            }
+        }
+        if (errors.length > 0)
+            throw new AggregateError(errors, `[flowing] ${errors.length} onClose hook(s) failed`);
+    }
+}
+//# sourceMappingURL=server.js.map

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

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

package/dist/core/shutdown.d.ts

@@ -0,0 +1,41 @@
+import type { Logger } from './logger.ts';
+export interface ShutdownOptions {
+    /** Sinais tratados. Padrão: `['SIGINT', 'SIGTERM']`. */
+    signals?: readonly NodeJS.Signals[];
+    /**
+     * Espera antes de parar de aceitar conexões, com o `/readyz` já em 503, para o load balancer tirar
+     * a instância de rotação (Kubernetes, ECS…). Padrão: 0.
+     */
+    drainDelayMs?: number;
+    /** Prazo para as requisições em andamento terminarem. Padrão: 10s. */
+    timeoutMs?: number;
+    /** Executado depois que o servidor fecha (banco, filas…). Se lançar, o processo sai com código 1. */
+    onShutdown?: (signal: NodeJS.Signals) => void | Promise<void>;
+    /** Chama `process.exit` ao final. Padrão: `true`. Use `false` se outro código controla o processo. */
+    exit?: boolean;
+}
+/** O que o coordenador precisa de cada app que está ouvindo. */
+export interface ShutdownTarget {
+    readonly log: Logger;
+    /** Fecha o app e roda o `onShutdown`; resolve com `false` se algo falhou. */
+    shutdown(signal: NodeJS.Signals): Promise<boolean>;
+    /** Se este app quer `process.exit` ao final. */
+    readonly exitOnShutdown: boolean;
+    readonly signals: readonly NodeJS.Signals[];
+}
+/**
+ * Coordena o encerramento de todos os apps ouvindo no processo (F-07):
+ * um único listener por sinal, compartilhado, removido quando o último app fecha.
+ */
+declare class ShutdownCoordinator {
+    private readonly targets;
+    private readonly listeners;
+    private shuttingDown;
+    register(target: ShutdownTarget): void;
+    unregister(target: ShutdownTarget): void;
+    private prune;
+    private onSignal;
+}
+export declare const shutdownCoordinator: ShutdownCoordinator;
+export {};
+//# sourceMappingURL=shutdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,sGAAsG;IACtG,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,gDAAgD;IAChD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,YAAY,CAAS;IAE7B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAQrC;IAED,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAKvC;IAED,OAAO,CAAC,KAAK;YASC,QAAQ;CAgBvB;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}

package/dist/core/shutdown.js

@@ -0,0 +1,53 @@
+/**
+ * Coordena o encerramento de todos os apps ouvindo no processo (F-07):
+ * um único listener por sinal, compartilhado, removido quando o último app fecha.
+ */
+class ShutdownCoordinator {
+    targets = new Set();
+    listeners = new Map();
+    shuttingDown = false;
+    register(target) {
+        this.targets.add(target);
+        for (const signal of target.signals) {
+            if (this.listeners.has(signal))
+                continue;
+            const listener = () => void this.onSignal(signal);
+            this.listeners.set(signal, listener);
+            process.on(signal, listener);
+        }
+    }
+    unregister(target) {
+        this.targets.delete(target);
+        // Durante um encerramento, os listeners ficam até o fim: o segundo sinal precisa ser ouvido
+        // enquanto o onShutdown ainda roda (ex.: fechando o banco).
+        if (!this.shuttingDown)
+            this.prune();
+    }
+    prune() {
+        const stillUsed = new Set([...this.targets].flatMap((t) => t.signals));
+        for (const [signal, listener] of this.listeners) {
+            if (stillUsed.has(signal))
+                continue;
+            process.off(signal, listener);
+            this.listeners.delete(signal);
+        }
+    }
+    async onSignal(signal) {
+        const targets = [...this.targets].filter((t) => t.signals.includes(signal));
+        if (this.shuttingDown) {
+            // Segundo sinal durante o encerramento: o usuário quer sair já (Ctrl+C duplo).
+            targets[0]?.log.warn({ signal }, 'second signal received, forcing exit');
+            process.exit(1);
+        }
+        this.shuttingDown = true;
+        targets[0]?.log.info({ signal }, 'shutting down gracefully');
+        const results = await Promise.all(targets.map((t) => t.shutdown(signal)));
+        const ok = results.every(Boolean);
+        this.shuttingDown = false;
+        this.prune();
+        if (targets.some((t) => t.exitOnShutdown))
+            process.exit(ok ? 0 : 1);
+    }
+}
+export const shutdownCoordinator = new ShutdownCoordinator();
+//# sourceMappingURL=shutdown.js.map

package/dist/core/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,MAAM,mBAAmB;IACN,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC3D,YAAY,GAAG,KAAK,CAAC;IAE7B,QAAQ,CAAC,MAAsB;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YACzC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACrC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,UAAU,CAAC,MAAsB;QAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,4FAA4F;QAC5F,4DAA4D;QAC5D,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACvC,CAAC;IAEO,KAAK;QACX,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YACpC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,MAAsB;QAC3C,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,+EAA+E;YAC/E,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,sCAAsC,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAE7D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC"}