flowingts 0.0.0 → 0.19.0

package/dist/core/errors.d.ts

@@ -0,0 +1,50 @@
+import type { Context } from './context.ts';
+export interface HttpErrorOptions {
+    /**
+     * Se a mensagem pode ser enviada ao cliente.
+     * Padrão: `true` para 4xx e `false` para 5xx, para não vazar detalhes internos (S-05).
+     */
+    expose?: boolean;
+    cause?: unknown;
+    /** Dados extras enviados ao cliente junto da mensagem (ex.: erros de validação). */
+    details?: unknown;
+    /** URI que identifica o tipo do problema (RFC 9457). Padrão: `'about:blank'`. */
+    type?: string;
+}
+/**
+ * Corpo de erro no formato Problem Details (RFC 9457), enviado como `application/problem+json`.
+ * `code` e `details` são membros de extensão do FlowingTS.
+ */
+export interface ProblemDetails {
+    /** URI do tipo do problema. `'about:blank'` quando o status já diz tudo. */
+    type: string;
+    /** Resumo do tipo do problema; com `about:blank`, é a frase do status (`'Not Found'`). */
+    title: string;
+    status: number;
+    /** Explicação desta ocorrência. Omitido em 5xx não expostos. */
+    detail?: string;
+    /** Código estável para o cliente tratar o erro (`'VALIDATION_ERROR'`). */
+    code?: string;
+    /** Dados extras, como os erros de validação. */
+    details?: unknown;
+}
+/**
+ * Personaliza o corpo de erro. Recebe o problema já montado (e sem dados internos em 5xx) e
+ * devolve o corpo a enviar como JSON. Use para manter um formato legado ou adicionar campos.
+ */
+export type ErrorFormatter = (problem: ProblemDetails, ctx: Context) => unknown;
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    readonly expose: boolean;
+    readonly details: unknown;
+    readonly type: string | undefined;
+    constructor(status: number, message: string, code?: string, options?: HttpErrorOptions);
+}
+export declare function isHttpError(err: unknown): err is HttpError;
+export declare const notFound: (msg?: string) => HttpError;
+export declare const badRequest: (msg?: string) => HttpError;
+export declare const unauthorized: (msg?: string) => HttpError;
+export declare const forbidden: (msg?: string) => HttpError;
+export declare const internal: (msg?: string) => HttpError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;AAEhF,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,EAQzF;CACF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS,CAE1D;AAED,eAAO,MAAM,QAAQ,6BAA8D,CAAC;AACpF,eAAO,MAAM,UAAU,6BAAkE,CAAC;AAC1F,eAAO,MAAM,YAAY,6BAAoE,CAAC;AAC9F,eAAO,MAAM,SAAS,6BAA8D,CAAC;AACrF,eAAO,MAAM,QAAQ,6BAAyE,CAAC"}

package/dist/core/errors.js

@@ -0,0 +1,25 @@
+export class HttpError extends Error {
+    status;
+    code;
+    expose;
+    details;
+    type;
+    constructor(status, message, code, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'HttpError';
+        this.status = status;
+        this.code = code;
+        this.expose = options.expose ?? status < 500;
+        this.details = options.details;
+        this.type = options.type;
+    }
+}
+export function isHttpError(err) {
+    return err instanceof HttpError;
+}
+export const notFound = (msg = 'Not Found') => new HttpError(404, msg, 'NOT_FOUND');
+export const badRequest = (msg = 'Bad Request') => new HttpError(400, msg, 'BAD_REQUEST');
+export const unauthorized = (msg = 'Unauthorized') => new HttpError(401, msg, 'UNAUTHORIZED');
+export const forbidden = (msg = 'Forbidden') => new HttpError(403, msg, 'FORBIDDEN');
+export const internal = (msg = 'Internal Server Error') => new HttpError(500, msg, 'INTERNAL');
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAuCA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,MAAM,CAAS;IACf,IAAI,CAAqB;IACzB,MAAM,CAAU;IAChB,OAAO,CAAU;IACjB,IAAI,CAAqB;IAElC,YAAY,MAAc,EAAE,OAAe,EAAE,IAAa,EAAE,OAAO,GAAqB,EAAE;QACxF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,GAAG,GAAG,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,GAAG,YAAY,SAAS,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,GAAG,WAAW,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,GAAG,aAAa,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAG,GAAG,cAAc,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,GAAG,WAAW,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,GAAG,uBAAuB,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC"}

package/dist/core/guard.d.ts

@@ -0,0 +1,10 @@
+import type { Context } from './context.ts';
+import type { Middleware } from './compose.ts';
+/**
+ * Decide se a requisição pode seguir para o handler (F-01).
+ * Retorne `false` para responder 403, ou lance um `HttpError` (ex.: `unauthorized()`) para outro status.
+ */
+export type Guard = (ctx: Context) => boolean | Promise<boolean>;
+/** Executa os guards em ordem; o primeiro que negar interrompe a requisição. */
+export declare function guardsMiddleware(guards: readonly Guard[]): Middleware;
+//# sourceMappingURL=guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/core/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEjE,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,UAAU,CAQrE"}

package/dist/core/guard.js

@@ -0,0 +1,14 @@
+import { HttpError } from './errors.js';
+import { kPhase } from './symbols.js';
+/** Executa os guards em ordem; o primeiro que negar interrompe a requisição. */
+export function guardsMiddleware(guards) {
+    return async (ctx, next) => {
+        ctx[kPhase] = 'guard';
+        for (const guard of guards) {
+            if (!(await guard(ctx)))
+                throw new HttpError(403, 'Forbidden', 'FORBIDDEN');
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=guard.js.map

package/dist/core/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/core/guard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQtC,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/health.d.ts

@@ -0,0 +1,37 @@
+import type { Context } from './context.ts';
+import { type Middleware } from './compose.ts';
+import { type Guard } from './guard.ts';
+import type { Logger } from './logger.ts';
+/** Uma verificação de prontidão: lance um erro ou devolva `false` para indicar falha. */
+export type HealthCheck = () => unknown | Promise<unknown>;
+export interface HealthOptions {
+    /** Liveness. Padrão: `'/livez'`; `false` desliga. */
+    live?: string | false;
+    /** Readiness. Padrão: `'/readyz'`; `false` desliga. */
+    ready?: string | false;
+    /** Verificações do `/readyz`, rodadas em paralelo: `{ db: () => db.ping() }`. */
+    checks?: Record<string, HealthCheck>;
+    /** Tempo máximo de cada verificação. Padrão: 2000 ms. */
+    timeoutMs?: number;
+    /** Rodam antes de responder (os middlewares globais não rodam nestas rotas). */
+    middlewares?: readonly Middleware[];
+    guards?: readonly Guard[];
+    /**
+     * Responde mesmo com um `Host` fora do `allowedHosts`. Sondas de orquestradores chegam com o IP do pod
+     * no `Host` (Kubernetes, ECS). Um `Host` malformado continua recebendo 400. Padrão: `true`.
+     */
+    anyHost?: boolean;
+}
+/** @internal */
+export interface HealthConfig {
+    /** Responde se a requisição for para uma das rotas; devolve `true` nesse caso. */
+    serve(ctx: Context, shuttingDown: boolean): Promise<boolean>;
+    /** Paths das rotas ligadas, na forma canônica. */
+    readonly paths: readonly string[];
+    /** A requisição é para um dos healthchecks (checagem síncrona, sem Promise). */
+    handles(method: string, path: string): boolean;
+    /** A requisição é para um healthcheck que aceita qualquer host? */
+    bypassesHostCheck(method: string, path: string): boolean;
+}
+export declare function compileHealth(opts: HealthOptions, log: Logger): HealthConfig;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/core/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAoB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gFAAgF;IAChF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/C,mEAAmE;IACnE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1D;AAeD,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAqD5E"}

package/dist/core/health.js

@@ -0,0 +1,68 @@
+import { compose } from './compose.js';
+import { kRawSend } from './symbols.js';
+import { guardsMiddleware } from './guard.js';
+import { canonicalPath } from '../utils/path.js';
+function withTimeout(check, ms) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve('timeout'), ms);
+    });
+    const run = Promise.resolve()
+        .then(check)
+        .then((v) => (v === false ? 'error' : 'ok'));
+    return Promise.race([run, timeout]).finally(() => clearTimeout(timer));
+}
+export function compileHealth(opts, log) {
+    const live = opts.live === undefined ? '/livez' : opts.live;
+    const ready = opts.ready === undefined ? '/readyz' : opts.ready;
+    if (live && ready && canonicalPath(live) === canonicalPath(ready)) {
+        throw new Error(`[flowing] health(): "live" and "ready" cannot both be "${live}".`);
+    }
+    const livePath = live === false ? undefined : canonicalPath(live);
+    const readyPath = ready === false ? undefined : canonicalPath(ready);
+    const anyHost = opts.anyHost ?? true;
+    const isHealth = (method, path) => (method === 'GET' || method === 'HEAD') && (canonicalPath(path) === livePath || canonicalPath(path) === readyPath);
+    const checks = Object.entries(opts.checks ?? {});
+    const timeoutMs = opts.timeoutMs ?? 2000;
+    const pipeline = [...(opts.middlewares ?? [])];
+    if (opts.guards?.length)
+        pipeline.push(guardsMiddleware(opts.guards));
+    const reply = (ctx, status, body) => {
+        ctx.res.statusCode = status;
+        ctx.res.setHeader('Cache-Control', 'no-store');
+        ctx[kRawSend](JSON.stringify(body), 'application/json; charset=utf-8');
+    };
+    return {
+        paths: [livePath, readyPath].filter((p) => p !== undefined),
+        handles: isHealth,
+        bypassesHostCheck: (method, path) => anyHost && isHealth(method, path),
+        async serve(ctx, shuttingDown) {
+            if (!isHealth(ctx.method, ctx.path))
+                return false;
+            const isLive = canonicalPath(ctx.path) === livePath;
+            await compose(ctx, [
+                ...pipeline,
+                async () => {
+                    if (isLive)
+                        return reply(ctx, 200, { status: 'ok' });
+                    if (shuttingDown)
+                        return reply(ctx, 503, { status: 'shutting_down' });
+                    const results = await Promise.all(checks.map(async ([name, check]) => {
+                        const result = await withTimeout(check, timeoutMs).catch((err) => {
+                            // O motivo vai para o log, nunca para a resposta (pode conter host, usuário do banco…).
+                            log.warn({ err, check: name }, 'health check failed');
+                            return 'error';
+                        });
+                        if (result === 'timeout')
+                            log.warn({ check: name, timeoutMs }, 'health check timed out');
+                        return [name, result];
+                    }));
+                    const failed = results.some(([, r]) => r !== 'ok');
+                    reply(ctx, failed ? 503 : 200, { status: failed ? 'error' : 'ok', checks: Object.fromEntries(results) });
+                },
+            ]);
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/core/health.js.map

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

package/dist/core/hooks.d.ts

@@ -0,0 +1,34 @@
+import type { OnErrorHook, OnResponseHook } from './app/options.ts';
+import type { OnSendHook } from './context.ts';
+/**
+ * Hooks com escopo (F-43): os mesmos `onSend`, `onResponse` e `onError` do app, declarados num grupo, num
+ * `mount()`, numa classe, num método ou numa rota manual. Só rodam quando uma rota daquele escopo atendeu.
+ */
+export interface HookOptions {
+    onSend?: OnSendHook | readonly OnSendHook[];
+    onResponse?: OnResponseHook | readonly OnResponseHook[];
+    onError?: OnErrorHook | readonly OnErrorHook[];
+}
+/** Hooks acumulados de um escopo, de fora para dentro. */
+export interface ScopedHooks {
+    onSend: OnSendHook[];
+    onResponse: OnResponseHook[];
+    onError: OnErrorHook[];
+}
+/**
+ * As listas prontas de uma rota, montadas no registro (nada por requisição). `onError` já vem do mais
+ * específico para o mais externo, que é a ordem de execução.
+ */
+export interface RouteHooks {
+    readonly onSend: readonly OnSendHook[];
+    readonly onResponse: readonly OnResponseHook[];
+    readonly onError: readonly OnErrorHook[];
+}
+export declare const emptyHooks: () => ScopedHooks;
+/** Normaliza as opções (`fn` ou `[fn, fn]`) em listas. */
+export declare function hookOptions(opts: HookOptions | undefined): ScopedHooks;
+/** Junta escopos na ordem de fora para dentro. */
+export declare function concatHooks(...scopes: readonly ScopedHooks[]): ScopedHooks;
+/** As listas finais da rota, ou `undefined` se ela não tem nenhum hook (o caso comum). */
+export declare function routeHooks(scoped: ScopedHooks): RouteHooks | undefined;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC;IAC5C,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,CAAC;IACxD,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,WAAW,EAAE,CAAC;CAChD;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;CAC1C;AAED,eAAO,MAAM,UAAU,QAAO,WAA4D,CAAC;AAI3F,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,CAEtE;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CAQ1E;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAOtE"}

package/dist/core/hooks.js

@@ -0,0 +1,27 @@
+export const emptyHooks = () => ({ onSend: [], onResponse: [], onError: [] });
+const list = (value) => (value === undefined ? [] : Array.isArray(value) ? [...value] : [value]);
+/** Normaliza as opções (`fn` ou `[fn, fn]`) em listas. */
+export function hookOptions(opts) {
+    return { onSend: list(opts?.onSend), onResponse: list(opts?.onResponse), onError: list(opts?.onError) };
+}
+/** Junta escopos na ordem de fora para dentro. */
+export function concatHooks(...scopes) {
+    const out = emptyHooks();
+    for (const s of scopes) {
+        out.onSend.push(...s.onSend);
+        out.onResponse.push(...s.onResponse);
+        out.onError.push(...s.onError);
+    }
+    return out;
+}
+/** As listas finais da rota, ou `undefined` se ela não tem nenhum hook (o caso comum). */
+export function routeHooks(scoped) {
+    if (scoped.onSend.length + scoped.onResponse.length + scoped.onError.length === 0)
+        return undefined;
+    return Object.freeze({
+        onSend: Object.freeze([...scoped.onSend]),
+        onResponse: Object.freeze([...scoped.onResponse]),
+        onError: Object.freeze([...scoped.onError].reverse()),
+    });
+}
+//# sourceMappingURL=hooks.js.map

package/dist/core/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,UAAU,GAAG,GAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;AAE3F,MAAM,IAAI,GAAG,CAAI,KAAmC,EAAO,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAU,CAAC,CAAC,CAAC;AAE5I,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,IAA6B;IACvD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;AAC1G,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,GAAG,MAA8B;IAC3D,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7B,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QACrC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACpG,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACjD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;KACtD,CAAC,CAAC;AACL,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,30 @@
+import '../shims/symbol-metadata.ts';
+export { createApp, FlowingApp, type AppOptions, type ListenOptions, type OnCloseHook, type OnErrorHook, type OnRequestHook, type OnResponseHook, type ResponseInfo, type RequestIdOptions, type ServerTimeouts, } from './app.ts';
+export type { InjectOptions, InjectResponse } from './inject.ts';
+export type { GroupOptions, HostOption, ManualRouteOptions, MethodSelector, MethodsSelector, MountOptions, RouterRef } from './compiler.ts';
+export type { HookOptions } from './hooks.ts';
+export type { QueryParser } from '../utils/query.ts';
+export { type Contracts, contracts, type StandardContractsOptions, type StandardSchemaV1 } from './contracts.ts';
+export { detectors } from './uploads/receive.ts';
+export type { ContentDetector, FileInfo, FileRule, FileRules, Size, UploadedFile, UploadsOptions } from './uploads/types.ts';
+export type { BodyParser } from './body-parser.ts';
+export { MountedGroup, RouteGroupScope } from './mounted-group.ts';
+export type { Middleware } from './compose.ts';
+export type { Guard } from './guard.ts';
+export type { CheckParams, InferBody, InferHeaders, InferParams, InferQuery, InferResponse, InferSchema, ParamsOf, PathParams, } from './infer.ts';
+export type { ShutdownOptions } from './shutdown.ts';
+export type { HealthCheck, HealthOptions } from './health.ts';
+export type { Serializer } from './response/pipeline.ts';
+export type { CookieOptions } from '../utils/cookie.ts';
+export type { TlsCertificate, TlsOptions } from '../server/tls.ts';
+export type { FileOptions, SendFileOptions, StaticOptions } from '../server/static.ts';
+export { consoleLogger, DEFAULT_REDACT_KEYS, redactValue, silentLogger, type ConsoleLoggerOptions, type Logger, type LogLevel, } from './logger.ts';
+export { Context, type BodyFor, type OnSendHook, type SendPayload, type ContextOptions, type ContextState, type DeclaredStatus, type ParamsFor, type SchemasOf, type SseEvent, type SseOptions, type SseStream, type StatusContext, } from './context.ts';
+export { badRequest, forbidden, HttpError, internal, isHttpError, notFound, unauthorized, type ErrorFormatter, type HttpErrorOptions, type ProblemDetails, } from './errors.ts';
+export { isResponseContent, ROUTER_METADATA, readOwnMetadata, type ResponseContent, type ResponseEntry, type RouterMetadata, type MethodMetadata, type RouteSchemas, } from './metadata.ts';
+export type { Handler, RouteInfo } from './route-table.ts';
+export { type AbortCode, type ErrorPhase, RequestAbortedError } from './abort.ts';
+export type { TraceContext } from '../utils/trace-context.ts';
+export type { TelemetryApi, TelemetrySpan } from './telemetry.ts';
+export type { ValidationIssue, ValidationTarget } from '../schema/validation.ts';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/core/index.js

@@ -0,0 +1,11 @@
+import '../shims/symbol-metadata.js';
+export { createApp, FlowingApp, } from './app.js';
+export { contracts } from './contracts.js';
+export { detectors } from './uploads/receive.js';
+export { MountedGroup, RouteGroupScope } from './mounted-group.js';
+export { consoleLogger, DEFAULT_REDACT_KEYS, redactValue, silentLogger, } from './logger.js';
+export { Context, } from './context.js';
+export { badRequest, forbidden, HttpError, internal, isHttpError, notFound, unauthorized, } from './errors.js';
+export { isResponseContent, ROUTER_METADATA, readOwnMetadata, } from './metadata.js';
+export { RequestAbortedError } from './abort.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AAErC,OAAO,EACL,SAAS,EACT,UAAU,GAUX,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAkB,SAAS,EAAwD,MAAM,gBAAgB,CAAC;AACjH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAoBnE,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,YAAY,GAIb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,OAAO,GAaR,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,YAAY,GAIb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,GAMhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAmC,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/infer.d.ts

@@ -0,0 +1,68 @@
+import type { RouteSchemas } from './metadata.ts';
+/**
+ * Inferência estrutural de tipos a partir de schemas (F-02), sem importar nenhuma biblioteca:
+ * - TypeBox: lê o campo fantasma `static` (o mesmo que `Static<T>` usa).
+ * - Standard Schema (Zod, Valibot, ArkType): lê `~standard.types.output` (prepara a F-27).
+ * Qualquer outro schema cai no `Fallback`.
+ */
+export type InferSchema<T, Fallback = unknown> = [NonNullable<T>] extends [never] ? Fallback : NonNullable<T> extends {
+    '~standard': {
+        types?: {
+            output: infer O;
+        } | undefined;
+    };
+} ? O : NonNullable<T> extends {
+    static: unknown;
+} ? (NonNullable<T> & {
+    params: [];
+})['static'] : Fallback;
+/** Tipo de `ctx.params` para os schemas `S`. */
+export type InferParams<S extends RouteSchemas> = InferSchema<S['params'], Record<string, string>>;
+/** Tipo de `ctx.query` para os schemas `S`. */
+export type InferQuery<S extends RouteSchemas> = InferSchema<S['query'], Record<string, string | string[]>>;
+/** Tipo de `ctx.body` para os schemas `S`. */
+export type InferBody<S extends RouteSchemas> = InferSchema<S['body'], unknown>;
+/** Tipo dos headers validados para os schemas `S`. */
+export type InferHeaders<S extends RouteSchemas> = InferSchema<S['headers'], Record<string, string | string[] | undefined>>;
+/**
+ * União dos tipos de resposta declarados (ou de um status específico).
+ * Útil para anotar o retorno do handler: `create(ctx): InferResponse<typeof create, 201>`.
+ */
+export type InferResponse<S extends RouteSchemas, Status extends number = number> = S['response'] extends Record<number, unknown> ? {
+    [K in keyof S['response'] & Status]: InferSchema<UnwrapResponse<S['response'][K]>>;
+}[keyof S['response'] & Status] : unknown;
+/** `{ contentType, schema }` → `schema`; um schema JSON direto continua como está (F-31). */
+type UnwrapResponse<E> = E extends {
+    contentType: unknown;
+    schema: infer S;
+} ? S : E extends {
+    contentType: unknown;
+} ? undefined : E;
+/** Corta o nome de um parâmetro no primeiro delimitador do find-my-way (`/`, `-`, `.`, `(`). */
+type ParamHead<R extends string, Acc extends string = ''> = R extends `${infer C}${infer T}` ? C extends '/' | '-' | '.' | '(' ? [Acc, R] : ParamHead<T, `${Acc}${C}`> : [Acc, ''];
+/** Descarta a regex de um parâmetro (`(^\\d+)…` → `…`). */
+type SkipRegex<R extends string> = R extends `(${string})${infer Rest}` ? Rest : R;
+type ParamNames<P extends string> = P extends `${string}:${infer R}` ? R extends `:${infer Escaped}` ? ParamNames<Escaped> : ParamHead<R> extends [infer N extends string, infer Rest extends string] ? N | ParamNames<SkipRegex<Rest>> : never : never;
+/**
+ * Nomes dos parâmetros de um path: `PathParams<'/:orgId/users/:id'>` → `'orgId' | 'id'`.
+ * Regex (`/:id(^\\d+)`) é ignorada, e o curinga final (`/files/*`) vira `'*'`.
+ * Com um `string` não literal, resulta em `string`.
+ */
+export type PathParams<P extends string> = string extends P ? string : ParamNames<P> | (P extends `${string}*` ? '*' : never);
+/** `ctx.params` a partir só do path: `{ orgId: string; id: string }`. */
+export type ParamsOf<P extends string> = string extends P ? Record<string, string> : {
+    [K in PathParams<P>]: string;
+};
+type SchemaKeys<T> = [T] extends [undefined] ? never : keyof InferSchema<T, Record<never, never>> & string;
+/**
+ * Confere, em compilação, que todo parâmetro do path está no schema de `params` (F-29). Chaves a mais
+ * no schema podem vir do prefixo do `@Router`/`mount`, que o decorator não enxerga: essas são
+ * conferidas no registro. Resulta em `unknown` quando está tudo certo (ou não dá para saber).
+ */
+export type CheckParams<P extends string, S> = string extends P ? unknown : S extends {
+    params: infer T;
+} ? [Exclude<PathParams<P>, SchemaKeys<T>>] extends [never] ? unknown : {
+    params: `Missing in params schema: "${Exclude<PathParams<P>, SchemaKeys<T>>}"`;
+} : unknown;
+export {};
+//# sourceMappingURL=infer.d.ts.map

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

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

package/dist/core/infer.js

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

package/dist/core/infer.js.map

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

package/dist/core/inject.d.ts

@@ -0,0 +1,27 @@
+import http from 'node:http';
+export interface InjectOptions {
+    method?: string;
+    /** Caminho com query string, ex.: `/users?limit=10`. */
+    url: string;
+    headers?: Record<string, string>;
+    /** Objetos são enviados como JSON (com `content-type` automático); strings e Buffers vão crus. */
+    body?: unknown;
+    /** IP simulado do cliente (`ctx.ip`). Padrão: `127.0.0.1`. */
+    remoteAddress?: string;
+}
+export interface InjectResponse {
+    status: number;
+    headers: http.OutgoingHttpHeaders;
+    /** Corpo como texto. */
+    body: string;
+    json<T = unknown>(): T;
+}
+type Listener = (req: http.IncomingMessage, res: http.ServerResponse) => void;
+/**
+ * Executa uma requisição direto no listener do app, sem abrir porta nem usar a rede (F-09).
+ * Cria `IncomingMessage`/`ServerResponse` reais sobre um socket desconectado e captura o que
+ * o app escreve na resposta.
+ */
+export declare function inject(listener: Listener, opts: InjectOptions): Promise<InjectResponse>;
+export {};
+//# sourceMappingURL=inject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/core/inject.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kGAAkG;IAClG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAClC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC;CACxB;AAED,KAAK,QAAQ,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CA8EvF"}

package/dist/core/inject.js

@@ -0,0 +1,85 @@
+import http from 'node:http';
+import { Socket } from 'node:net';
+import { markHeadersSent } from './runtime/observer.js';
+/**
+ * Executa uma requisição direto no listener do app, sem abrir porta nem usar a rede (F-09).
+ * Cria `IncomingMessage`/`ServerResponse` reais sobre um socket desconectado e captura o que
+ * o app escreve na resposta.
+ */
+export function inject(listener, opts) {
+    return new Promise((resolve, reject) => {
+        const socket = new Socket();
+        Object.defineProperty(socket, 'remoteAddress', { value: opts.remoteAddress ?? '127.0.0.1' });
+        const req = new http.IncomingMessage(socket);
+        req.method = (opts.method ?? 'GET').toUpperCase();
+        req.url = opts.url;
+        req.httpVersion = '1.1';
+        req.httpVersionMajor = 1;
+        req.httpVersionMinor = 1;
+        const headers = { host: 'localhost' };
+        for (const [k, v] of Object.entries(opts.headers ?? {}))
+            headers[k.toLowerCase()] = v;
+        let payload;
+        if (opts.body !== undefined) {
+            if (typeof opts.body === 'string' || Buffer.isBuffer(opts.body)) {
+                payload = Buffer.from(opts.body);
+            }
+            else {
+                payload = Buffer.from(JSON.stringify(opts.body));
+                headers['content-type'] ??= 'application/json';
+            }
+            headers['content-length'] = String(payload.length);
+        }
+        req.headers = headers;
+        if (payload)
+            req.push(payload);
+        req.push(null);
+        const res = new http.ServerResponse(req);
+        // O instante dos headers, para o `ttfbMs` (F-38); no `listen()`, quem grava é o protótipo da resposta.
+        const writeHead = res.writeHead;
+        res.writeHead = function (...args) {
+            markHeadersSent(this);
+            return writeHead.apply(this, args);
+        };
+        const chunks = [];
+        const noBody = req.method === 'HEAD';
+        const collect = (chunk, encoding) => {
+            if (noBody || chunk === undefined || chunk === null || typeof chunk === 'function')
+                return;
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk), (typeof encoding === 'string' ? encoding : 'utf8')));
+        };
+        // Sem socket conectado, o 'finish' não dispara: interceptamos write/end para capturar o corpo
+        // e chamamos os originais para manter headersSent/writableEnded corretos.
+        const write = res.write.bind(res);
+        const end = res.end.bind(res);
+        res.write = ((chunk, encoding, cb) => {
+            collect(chunk, encoding);
+            return write(chunk, encoding, cb);
+        });
+        res.end = ((chunk, encoding, cb) => {
+            collect(chunk, encoding);
+            const out = end(chunk, encoding, cb);
+            const body = Buffer.concat(chunks).toString('utf8');
+            // Sem socket, 'finish' e 'close' nunca seriam emitidos: emite os dois, como numa conexão real,
+            // para `onResponse`, `logRequests` e a limpeza das respostas em andamento rodarem também no inject.
+            setImmediate(() => {
+                res.emit('finish');
+                res.emit('close');
+            });
+            resolve({
+                status: res.statusCode,
+                headers: res.getHeaders(),
+                body,
+                json: () => JSON.parse(body),
+            });
+            return out;
+        });
+        try {
+            listener(req, res);
+        }
+        catch (err) {
+            reject(err);
+        }
+    });
+}
+//# sourceMappingURL=inject.js.map

package/dist/core/inject.js.map

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