sashiko 0.12.2 → 0.13.0

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

@@ -0,0 +1,42 @@
+import type http from 'node:http';
+import type { AppCore } from '../app/core.ts';
+import { Context } from '../context.ts';
+import type { FrameworkRoutes } from '../registry/framework-routes.ts';
+import type { RouteRegistry } from '../registry/registry.ts';
+import type { ServerLifecycle } from './server.ts';
+/**
+ * Pipeline da requisição: rastreamento, request id, validação do `Host`, headers de segurança, healthchecks,
+ * middlewares globais, OpenAPI, roteamento, pipeline da rota e erros.
+ */
+export declare class RequestHandler {
+    private readonly core;
+    private readonly registry;
+    private readonly framework;
+    private readonly server;
+    constructor(core: AppCore, registry: RouteRegistry, framework: FrameworkRoutes, server: ServerLifecycle);
+    /**
+     * 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;
+    /** Última barreira (B-08): nada que aconteça numa requisição pode virar unhandledRejection. */
+    private safeHandle;
+    private fail;
+    /** Cadeia global compilada; refeita só quando `app.use()` acrescenta um middleware. */
+    private globalChain;
+    private readonly readBody;
+    handle(ctx: Context): Promise<void>;
+    /**
+     * Cadeia global (Chain of Responsibility pré-compilada): os middlewares de `app.use()` envolvem o
+     * roteamento e a rota, como no Koa. Um `await next()` num middleware global inclui o handler.
+     */
+    private chain;
+    /** Fim da cadeia global: OpenAPI, roteamento, 404/405 e o programa da rota. */
+    private route;
+    /**
+     * Executa os `onError` do usuário. Se um deles lançar, o erro é logado e seguimos
+     * para a resposta padrão com o erro **original** — nunca deixamos a Promise rejeitar (B-08).
+     */
+    private runErrorHandlers;
+}
+//# sourceMappingURL=request-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-handler.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/request-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAK9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,YACmB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,eAAe,EAGzC;IAED;;;OAGG;IACH,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CA8DxE;IAED,+FAA+F;YACjF,UAAU;IAQxB,OAAO,CAAC,IAAI;IAMZ,uFAAuF;IACvF,OAAO,CAAC,WAAW,CAAqE;IACxF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAE5D,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBxC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAK;IAQb,+EAA+E;YACjE,KAAK;IA2BnB;;;OAGG;YACW,gBAAgB;CAY/B"}

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

@@ -0,0 +1,187 @@
+import { randomUUID } from 'node:crypto';
+import { performance } from 'node:perf_hooks';
+import { compileChain } from '../compose.js';
+import { bodyReader } from '../body-parser.js';
+import { buildRouteProgram } from '../registry/route-program.js';
+import { kContext, kRouted } from '../symbols.js';
+import { Context } from '../context.js';
+import { problem, sendError, sendProblem } from '../response/pipeline.js';
+const SAFE_REQUEST_ID = /^[A-Za-z0-9._:-]{1,128}$/;
+/**
+ * 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;
+    constructor(core, registry, framework, server) {
+        this.core = core;
+        this.registry = registry;
+        this.framework = framework;
+        this.server = server;
+        this.readBody = bodyReader(core.opts.bodyLimit ?? 1024 * 1024, core.opts.protoPoisoning);
+    }
+    /**
+     * 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,
+            logger: this.core.log,
+            trustProxy: this.core.opts.trustProxy,
+            onSend: this.core.onSendHooks,
+        };
+        const server = this.server;
+        // Listener compartilhado por todas as respostas (antes, uma closure por requisição).
+        const onClose = function () {
+            server.inflight.delete(this);
+            // Durante o close(), cada resposta concluída libera as conexões que ficaram ociosas.
+            server.closing?.closeIdleConnections();
+        };
+        const timed = () => this.core.opts.logRequests === true || this.core.onResponseHooks.length > 0;
+        return (req, res) => {
+            const started = timed() ? performance.now() : -1;
+            server.inflight.add(res);
+            if (server.closing)
+                res.setHeader('Connection', 'close');
+            res.on('close', onClose);
+            const incoming = header ? req.headers[header] : undefined;
+            const id = trust && typeof incoming === 'string' && SAFE_REQUEST_ID.test(incoming) ? incoming : generate();
+            if (header)
+                res.setHeader(header, id);
+            try {
+                const ctx = new Context(req, res, contextOptions, id);
+                res[kContext] = ctx;
+                // 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;
+                }
+                if (started !== -1) {
+                    res.once('finish', () => {
+                        const ms = Math.round((performance.now() - started) * 100) / 100;
+                        if (this.core.opts.logRequests) {
+                            ctx.log.info({ method: ctx.method, path: ctx.path, status: res.statusCode, ms }, 'request completed');
+                        }
+                        for (const hook of this.core.onResponseHooks) {
+                            Promise.resolve()
+                                .then(() => hook(ctx, { status: res.statusCode, ms }))
+                                .catch((err) => ctx.log.error({ err }, 'onResponse hook failed'));
+                        }
+                    });
+                }
+                void this.safeHandle(ctx, id);
+            }
+            catch (err) {
+                this.fail(err, req, res, id);
+            }
+        };
+    }
+    /** Última barreira (B-08): nada que aconteça numa requisição pode virar unhandledRejection. */
+    async safeHandle(ctx, id) {
+        try {
+            await this.handle(ctx);
+        }
+        catch (err) {
+            this.fail(err, ctx.req, ctx.res, id);
+        }
+    }
+    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;
+    async handle(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.
+            if (this.framework.health && (await this.framework.health.serve(ctx, this.server.draining || this.server.closing !== undefined)))
+                return;
+            // O body chega lido aos middlewares globais (invariante 5), sem uma camada de middleware para isso.
+            await this.readBody(ctx);
+            const chain = this.chain();
+            await chain(ctx);
+            // 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.
+            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);
+            }
+        }
+        catch (err) {
+            await this.runErrorHandlers(err, ctx);
+        }
+    }
+    /**
+     * 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. */
+    async route(ctx) {
+        ctx[kRouted] = true;
+        if (ctx.sent || (await this.framework.serveOpenAPI(ctx)))
+            return;
+        // 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;
+        // 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));
+        await 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) {
+        for (const h of this.core.errorHandlers) {
+            try {
+                await h(err, ctx);
+            }
+            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,41 @@
+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 ShutdownTarget } from '../shutdown.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;
+    server: http.Server | https.Server | undefined;
+    private tlsState;
+    /** Respostas em andamento, para o `close()` e o shutdown. */
+    readonly inflight: Set<http.ServerResponse<http.IncomingMessage>>;
+    closing: http.Server | https.Server | undefined;
+    draining: boolean;
+    private closeHooksPending;
+    constructor(core: AppCore, 
+    /** Listener `(req, res)` do app, criado a cada `listen()`. */
+    listener: () => http.RequestListener);
+    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;AAGvD,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjF,qHAAqH;AACrH,qBAAa,eAAe;IAUxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAX3B,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAC/C,OAAO,CAAC,QAAQ,CAA6C;IAC7D,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,iDAAkC;IACnD,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,UAAS;IACjB,OAAO,CAAC,iBAAiB,CAAQ;IAEjC,YACmB,IAAI,EAAE,OAAO;IAC9B,8DAA8D;IAC7C,QAAQ,EAAE,MAAM,IAAI,CAAC,eAAe,EAQtD;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,CA0B3C;IAED,sGAAsG;IAChG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAanC;CACF"}

package/dist/core/runtime/server.js

@@ -0,0 +1,155 @@
+import http from 'node:http';
+import https from 'node:https';
+import { shutdownCoordinator } from '../shutdown.js';
+import { kAbort, kContext } from '../symbols.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;
+    server;
+    tlsState;
+    /** Respostas em andamento, para o `close()` e o shutdown. */
+    inflight = new Set();
+    closing;
+    draining = false;
+    closeHooksPending = true;
+    constructor(core, 
+    /** Listener `(req, res)` do app, criado a cada `listen()`. */
+    listener) {
+        this.core = core;
+        this.listener = listener;
+        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('[sashiko] 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, this.listener());
+            this.tlsState = { sni };
+        }
+        else {
+            server = http.createServer(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('[sashiko] 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;
+        // Respostas que ainda não enviaram headers avisam o cliente para não reusar a conexão.
+        for (const res of this.inflight)
+            if (!res.headersSent)
+                res.setHeader('Connection', 'close');
+        // 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.
+        for (const res of this.inflight) {
+            const ctx = res[kContext];
+            if (ctx?.streamingResponse)
+                ctx[kAbort]('server shutting down');
+        }
+        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, `[sashiko] ${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/streaming/sse.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Server-Sent Events (F-13). Fica fora do `Context`, que só delega: o modelo da requisição não carrega a
+ * lógica de cada forma de envio.
+ */
+import type { Context } from '../context.ts';
+/** Um evento de Server-Sent Events (F-13). `data` em objeto vira JSON; strings com várias linhas são divididas. */
+export interface SseEvent {
+    data: unknown;
+    event?: string;
+    id?: string;
+    /** Sugestão de espera para o navegador reconectar, em ms. */
+    retry?: number;
+}
+/** Conexão SSE aberta por `ctx.sse()`. */
+export interface SseStream {
+    send(event: SseEvent | string): void;
+    /** Comentário (`: texto`), ignorado pelo navegador; útil como keep-alive. */
+    comment(text: string): void;
+    /** Encerra a resposta. */
+    close(): void;
+    /** Chamado quando a conexão termina: o cliente desconectou, `close()` ou encerramento do app. */
+    onClose(listener: () => void): void;
+    readonly closed: boolean;
+    /** `Last-Event-ID` enviado pelo navegador ao reconectar. */
+    readonly lastEventId: string | undefined;
+}
+export interface SseOptions {
+    /** Comentário periódico para proxies não derrubarem a conexão ociosa. Padrão: 15000 ms; `0` desliga. */
+    heartbeatMs?: number;
+    /** `retry:` enviado na abertura. */
+    retry?: number;
+}
+/** Abre a conexão SSE de `ctx`. `markStreaming` marca a resposta como stream (estado privado do `Context`). */
+export declare function openSse(ctx: Context, opts: SseOptions, markStreaming: () => void): SseStream;
+//# sourceMappingURL=sse.d.ts.map

package/dist/core/streaming/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/core/streaming/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,mHAAmH;AACnH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,6EAA6E;IAC7E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0BAA0B;IAC1B,KAAK,IAAI,IAAI,CAAC;IACd,iGAAiG;IACjG,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,wGAAwG;IACxG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD,+GAA+G;AAC/G,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,GAAG,SAAS,CAqE5F"}

package/dist/core/streaming/sse.js

@@ -0,0 +1,121 @@
+/**
+ * Campos de uma linha SSE não podem ter quebra de linha (seria injeção de evento); `id` também não pode
+ * ter U+0000, que faz o navegador ignorar o campo.
+ */
+const sseField = (name, value) => {
+    if (/[\r\n]/.test(value))
+        throw new Error(`[sashiko] ctx.sse(): "${name}" cannot contain line breaks.`);
+    if (name === 'id' && value.includes('\0'))
+        throw new Error('[sashiko] ctx.sse(): "id" cannot contain U+0000.');
+    return `${name}: ${value}\n`;
+};
+/** Maior intervalo dos timers do Node; acima disso, ele usa 1 ms (heartbeat contínuo). */
+const MAX_TIMER_MS = 2_147_483_647;
+/** `retry` e `heartbeatMs`: inteiro não negativo, como o protocolo exige, e dentro do limite dos timers. */
+const nonNegativeInt = (name, value) => {
+    if (!Number.isInteger(value) || value < 0 || value > MAX_TIMER_MS) {
+        throw new Error(`[sashiko] ctx.sse(): "${name}" must be an integer between 0 and ${MAX_TIMER_MS} (got ${value}).`);
+    }
+    return value;
+};
+/** `data` do evento: strings como estão; o resto em JSON. Valor que não vira JSON gera erro claro, sem escrever nada. */
+function sseData(data) {
+    if (typeof data === 'string')
+        return data;
+    let text;
+    try {
+        text = JSON.stringify(data);
+    }
+    catch (err) {
+        throw new Error(`[sashiko] ctx.sse(): "data" is not JSON-serializable (${err.message}).`, { cause: err });
+    }
+    if (text === undefined)
+        throw new Error(`[sashiko] ctx.sse(): "data" of type ${typeof data} is not JSON-serializable.`);
+    return text;
+}
+/** Abre a conexão SSE de `ctx`. `markStreaming` marca a resposta como stream (estado privado do `Context`). */
+export function openSse(ctx, opts, markStreaming) {
+    if (ctx.sent)
+        throw new Error('[sashiko] ctx.sse(): the response was already sent.');
+    // Valida antes de abrir a resposta: um erro aqui ainda vira um 500 normal.
+    const heartbeatMs = nonNegativeInt('heartbeatMs', opts.heartbeatMs ?? 15_000);
+    if (opts.retry !== undefined)
+        nonNegativeInt('retry', opts.retry);
+    const res = ctx.res;
+    markStreaming();
+    res.statusCode = 200;
+    res.setHeader('Content-Type', 'text/event-stream; charset=utf-8');
+    res.setHeader('Cache-Control', 'no-cache, no-transform');
+    res.setHeader('X-Accel-Buffering', 'no');
+    res.removeHeader('Content-Length');
+    res.flushHeaders();
+    const listeners = [];
+    let closed = false;
+    const finish = () => {
+        if (closed)
+            return;
+        closed = true;
+        clearInterval(heartbeat);
+        for (const l of listeners.splice(0)) {
+            try {
+                l();
+            }
+            catch (err) {
+                ctx.log.error({ err }, 'sse onClose listener failed');
+            }
+        }
+    };
+    const write = (chunk) => {
+        if (!closed && !res.writableEnded)
+            res.write(chunk);
+    };
+    const heartbeat = setInterval(() => write(': ping\n\n'), heartbeatMs || 2 ** 31 - 1);
+    heartbeat.unref();
+    if (!heartbeatMs)
+        clearInterval(heartbeat);
+    res.once('close', finish);
+    const signal = ctx.signal;
+    signal.addEventListener('abort', () => stream.close(), { once: true });
+    if (opts.retry !== undefined)
+        write(`retry: ${opts.retry}\n\n`);
+    const stream = {
+        send: (event) => {
+            const e = typeof event === 'string' ? { data: event } : event;
+            let out = '';
+            if (e.event !== undefined)
+                out += sseField('event', e.event);
+            if (e.id !== undefined)
+                out += sseField('id', e.id);
+            if (e.retry !== undefined)
+                out += `retry: ${nonNegativeInt('retry', e.retry)}\n`;
+            if (e.data === undefined)
+                throw new Error('[sashiko] ctx.sse(): "data" is required; use "" for an empty event.');
+            const text = sseData(e.data);
+            for (const line of text.split(/\r\n|\r|\n/))
+                out += `data: ${line}\n`;
+            write(`${out}\n`);
+        },
+        comment: (text) => write(`: ${text.replace(/[\r\n]+/g, ' ')}\n\n`),
+        close: () => {
+            if (!res.writableEnded)
+                res.end();
+            finish();
+        },
+        onClose: (listener) => {
+            if (closed)
+                listener();
+            else
+                listeners.push(listener);
+        },
+        get closed() {
+            return closed;
+        },
+        lastEventId: ctx.get('last-event-id'),
+    };
+    // O cliente pode ter desconectado antes do `ctx.sse()` (num `await` anterior): o 'close' e o 'abort' já
+    // passaram, e os listeners acima nunca rodariam. Encerra já, limpando o heartbeat e chamando `onClose`.
+    if (signal.aborted)
+        stream.close();
+    return stream;
+}
+//# sourceMappingURL=sse.js.map

package/dist/core/streaming/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../src/core/streaming/sse.ts"],"names":[],"mappings":"AAoCA;;;GAGG;AACH,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;IAC/C,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,+BAA+B,CAAC,CAAC;IACxG,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAC/G,OAAO,GAAG,IAAI,KAAK,KAAK,IAAI,CAAC;AAC/B,CAAC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC,4GAA4G;AAC5G,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE;IAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,YAAY,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,sCAAsC,YAAY,SAAS,KAAK,IAAI,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,yHAAyH;AACzH,SAAS,OAAO,CAAC,IAAa;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,IAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yDAA0D,GAAa,CAAC,OAAO,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACvH,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,IAAI,4BAA4B,CAAC,CAAC;IACxH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,OAAO,CAAC,GAAY,EAAE,IAAgB,EAAE,aAAyB;IAC/E,IAAI,GAAG,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrF,2EAA2E;IAC3E,MAAM,WAAW,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,aAAa,EAAE,CAAC;IAChB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;IACrB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kCAAkC,CAAC,CAAC;IAClE,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IACzD,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IACnC,GAAG,CAAC,YAAY,EAAE,CAAC;IAEnB,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,CAAC,EAAE,CAAC;YACN,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,6BAA6B,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;QAC9B,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa;YAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACrF,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,IAAI,CAAC,WAAW;QAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3C,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAc;QACxB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACd,MAAM,CAAC,GAAa,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;YACxE,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;gBAAE,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS;gBAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;gBAAE,GAAG,IAAI,UAAU,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;YACjF,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;YACjH,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;gBAAE,GAAG,IAAI,SAAS,IAAI,IAAI,CAAC;YACtE,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC;QAClE,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,CAAC,GAAG,CAAC,aAAa;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC;YAClC,MAAM,EAAE,CAAC;QACX,CAAC;QACD,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YACpB,IAAI,MAAM;gBAAE,QAAQ,EAAE,CAAC;;gBAClB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,MAAM;YACR,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC;KACtC,CAAC;IACF,wGAAwG;IACxG,wGAAwG;IACxG,IAAI,MAAM,CAAC,OAAO;QAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/symbols.d.ts

@@ -0,0 +1,14 @@
+/** Símbolos internos do core. Ficam num módulo próprio para quem os usa não depender do `Context` em tempo de execução. */
+/** @internal Envio cru, sem pipeline: usado pelo próprio pipeline, por erros e por 404/405. */
+export declare const kRawSend: unique symbol;
+/** @internal Cancela o `ctx.signal` (encerramento do app) (F-13). */
+export declare const kAbort: unique symbol;
+/** @internal Envio de arquivo em andamento, que o app aguarda mesmo sem `await` no handler (F-13). */
+export declare const kPendingSend: unique symbol;
+/** @internal Liga o contexto aos schemas de resposta da rota, antes do handler (F-32). */
+export declare const kBindResponse: unique symbol;
+/** @internal A cadeia global chegou ao roteamento (o último middleware chamou `next()`). */
+export declare const kRouted: unique symbol;
+/** @internal O `Context` de uma resposta em andamento, guardado na própria `ServerResponse` (F-39). */
+export declare const kContext: unique symbol;
+//# sourceMappingURL=symbols.d.ts.map