flowingts 0.0.0 → 0.19.0

package/dist/core/logger.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Contrato de logger compatível com o pino (F-06): `logger.info({ reqId }, 'mensagem')`.
+ * Para usar o pino, basta passar a instância: `createApp({ logger: pino() })`.
+ */
+export interface Logger {
+    debug(obj: object, msg?: string): void;
+    debug(msg: string): void;
+    info(obj: object, msg?: string): void;
+    info(msg: string): void;
+    warn(obj: object, msg?: string): void;
+    warn(msg: string): void;
+    error(obj: object, msg?: string): void;
+    error(msg: string): void;
+    child(bindings: Record<string, unknown>): Logger;
+    /**
+     * Opcionais, para não exigir de loggers próprios (F-38): o `consoleLogger` e o pino têm os dois. Os níveis
+     * seguem o pino e o OpenTelemetry: `trace` abaixo de `debug`, `fatal` acima de `error`.
+     */
+    trace?(obj: object, msg?: string): void;
+    trace?(msg: string): void;
+    fatal?(obj: object, msg?: string): void;
+    fatal?(msg: string): void;
+}
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' | 'silent';
+export interface ConsoleLoggerOptions {
+    /** Padrão: `info`. */
+    level?: LogLevel;
+    /**
+     * Chaves mascaradas como `[REDACTED]` em qualquer nível dos dados logados (S-11). Somadas às padrão
+     * ({@link DEFAULT_REDACT_KEYS}); `false` desliga. A comparação ignora maiúsculas, `-` e `_`, então
+     * `'apiKey'` também cobre `api_key` e `X-Api-Key`.
+     */
+    redact?: readonly string[] | false;
+    /**
+     * `'pretty'` (padrão): `[flowing] mensagem { ...dados }`, para o terminal. `'json'`: uma linha JSON por
+     * evento (`{ level, time, msg, ...dados }`), para coletores de log (Datadog, Loki, CloudWatch…).
+     */
+    format?: 'pretty' | 'json';
+    /**
+     * `'stdout'` manda todos os níveis para a saída padrão. O padrão (`'console'`) segue o `console`: `warn`,
+     * `error` e `fatal` vão para o stderr, que alguns coletores tratam inteiro como erro (F-38).
+     */
+    stream?: 'console' | 'stdout';
+}
+/** Chaves mascaradas por padrão: credenciais, cookies e tokens. */
+export declare const DEFAULT_REDACT_KEYS: readonly string[];
+/** Cópia dos dados com as chaves sensíveis mascaradas. Erros, datas e buffers passam como estão. */
+export declare function redactValue(value: unknown, keys: ReadonlySet<string>, seen?: WeakSet<object>, depth?: number): unknown;
+/**
+ * Logger padrão sobre o `console`, sem dependências. Formato: `[flowing] mensagem { ...dados }`.
+ * O core não registra headers nem body. O que você logar passa pelo `redact`: `authorization`,
+ * `cookie`, `password`, `token` e afins saem como `[REDACTED]` (S-11).
+ */
+export declare function consoleLogger(opts?: ConsoleLoggerOptions, bindings?: Record<string, unknown>): Logger;
+/** Logger que descarta tudo (`createApp({ logger: false })`). */
+export declare const silentLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IACjD;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAO1F,MAAM,WAAW,oBAAoB;IACnC,sBAAsB;IACtB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC;IACnC;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC/B;AAoBD,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAehD,CAAC;AAKF,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,kBAAwB,EAAE,KAAK,SAAI,GAAG,OAAO,CAWvH;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,oBAAyB,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAE7G;AAkED,iEAAiE;AACjE,eAAO,MAAM,YAAY,EAAE,MAQ1B,CAAC"}

package/dist/core/logger.js

@@ -0,0 +1,134 @@
+const LEVELS = { trace: 5, debug: 10, info: 20, warn: 30, error: 40, fatal: 50, silent: 99 };
+/** Método do `console` de cada nível (`trace` e `fatal` não existem lá com esse sentido). */
+const CONSOLE_METHOD = { trace: 'debug', debug: 'debug', info: 'info', warn: 'warn', error: 'error', fatal: 'error' };
+/** `JSON.stringify` que não falha: erros viram `{ type, message, stack }` e ciclos viram `[Circular]`. */
+function toJsonLine(record) {
+    const seen = new WeakSet();
+    return JSON.stringify(record, (_key, value) => {
+        if (value instanceof Error) {
+            const out = { type: value.name, message: value.message, stack: value.stack };
+            for (const [k, v] of Object.entries(value))
+                out[k] = v;
+            return out;
+        }
+        if (typeof value === 'bigint')
+            return value.toString();
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value))
+                return '[Circular]';
+            seen.add(value);
+        }
+        return value;
+    });
+}
+/** Chaves mascaradas por padrão: credenciais, cookies e tokens. */
+export const DEFAULT_REDACT_KEYS = [
+    'authorization',
+    'proxy-authorization',
+    'cookie',
+    'set-cookie',
+    'x-api-key',
+    'api-key',
+    'password',
+    'passwd',
+    'secret',
+    'client-secret',
+    'token',
+    'access-token',
+    'refresh-token',
+    'id-token',
+];
+const REDACTED = '[REDACTED]';
+const normalizeKey = (key) => key.toLowerCase().replace(/[^a-z0-9]/g, '');
+/** Cópia dos dados com as chaves sensíveis mascaradas. Erros, datas e buffers passam como estão. */
+export function redactValue(value, keys, seen = new WeakSet(), depth = 0) {
+    if (typeof value !== 'object' || value === null || depth > 10)
+        return value;
+    if (value instanceof Error || value instanceof Date || ArrayBuffer.isView(value))
+        return value;
+    if (seen.has(value))
+        return '[Circular]';
+    seen.add(value);
+    if (Array.isArray(value))
+        return value.map((v) => redactValue(v, keys, seen, depth + 1));
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        out[k] = keys.has(normalizeKey(k)) ? REDACTED : redactValue(v, keys, seen, depth + 1);
+    }
+    return out;
+}
+/**
+ * Logger padrão sobre o `console`, sem dependências. Formato: `[flowing] mensagem { ...dados }`.
+ * O core não registra headers nem body. O que você logar passa pelo `redact`: `authorization`,
+ * `cookie`, `password`, `token` e afins saem como `[REDACTED]` (S-11).
+ */
+export function consoleLogger(opts = {}, bindings = {}) {
+    return new ConsoleLogger(compileConsoleConfig(opts), bindings);
+}
+function compileConsoleConfig(opts) {
+    return {
+        min: LEVELS[opts.level ?? 'info'],
+        keys: opts.redact === false ? undefined : new Set([...DEFAULT_REDACT_KEYS, ...(opts.redact ?? [])].map(normalizeKey)),
+        json: opts.format === 'json',
+        stdout: opts.stream === 'stdout',
+    };
+}
+/**
+ * Um `child()` por requisição custa só este objeto com as bindings: os métodos ficam no protótipo e a
+ * configuração (nível, `Set` do redact, formato) é a mesma do logger pai.
+ */
+class ConsoleLogger {
+    cfg;
+    bindings;
+    constructor(cfg, bindings) {
+        this.cfg = cfg;
+        this.bindings = bindings;
+    }
+    trace(objOrMsg, msg) {
+        this.emit('trace', objOrMsg, msg);
+    }
+    debug(objOrMsg, msg) {
+        this.emit('debug', objOrMsg, msg);
+    }
+    info(objOrMsg, msg) {
+        this.emit('info', objOrMsg, msg);
+    }
+    warn(objOrMsg, msg) {
+        this.emit('warn', objOrMsg, msg);
+    }
+    error(objOrMsg, msg) {
+        this.emit('error', objOrMsg, msg);
+    }
+    fatal(objOrMsg, msg) {
+        this.emit('fatal', objOrMsg, msg);
+    }
+    child(extra) {
+        return new ConsoleLogger(this.cfg, { ...this.bindings, ...extra });
+    }
+    emit(level, objOrMsg, msg) {
+        if (LEVELS[level] < this.cfg.min)
+            return;
+        const [data, text] = typeof objOrMsg === 'string' ? [{}, objOrMsg] : [objOrMsg, msg ?? ''];
+        const merged = { ...this.bindings, ...data };
+        const keys = this.cfg.keys;
+        const safe = (keys ? redactValue(merged, keys) : merged);
+        const out = this.cfg.stdout ? 'log' : CONSOLE_METHOD[level];
+        if (this.cfg.json) {
+            console[out](toJsonLine({ level, time: new Date().toISOString(), msg: text, ...safe }));
+        }
+        else {
+            console[out](`[flowing] ${text}`, safe);
+        }
+    }
+}
+/** Logger que descarta tudo (`createApp({ logger: false })`). */
+export const silentLogger = {
+    trace() { },
+    debug() { },
+    info() { },
+    warn() { },
+    error() { },
+    fatal() { },
+    child: () => silentLogger,
+};
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAEvH,6FAA6F;AAC7F,MAAM,cAAc,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAW,CAAC;AAuB/H,0GAA0G;AAC1G,SAAS,UAAU,CAAC,MAA+B;IACjD,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAc,EAAE,EAAE;QACrD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YACtG,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACvD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,YAAY,CAAC;YACzC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,eAAe;IACf,qBAAqB;IACrB,QAAQ;IACR,YAAY;IACZ,WAAW;IACX,SAAS;IACT,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,eAAe;IACf,OAAO;IACP,cAAc;IACd,eAAe;IACf,UAAU;CACX,CAAC;AAEF,MAAM,QAAQ,GAAG,YAAY,CAAC;AAC9B,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAElF,oGAAoG;AACpG,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,IAAyB,EAAE,IAAI,GAAG,IAAI,OAAO,EAAU,EAAE,KAAK,GAAG,CAAC;IAC5G,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,YAAY,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/F,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAI,GAAyB,EAAE,EAAE,QAAQ,GAA4B,EAAE;IACnG,OAAO,IAAI,aAAa,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAUD,SAAS,oBAAoB,CAAC,IAA0B;IACtD,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC;QACjC,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,mBAAmB,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACrH,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,MAAM;QAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,QAAQ;KACjC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,aAAa;IAEE,GAAG;IACH,QAAQ;IAF3B,YACmB,GAAkB,EAClB,QAAiC;mBADjC,GAAG;wBACH,QAAQ;IACxB,CAAC;IAEJ,KAAK,CAAC,QAAyB,EAAE,GAAY;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,QAAyB,EAAE,GAAY;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,QAAyB,EAAE,GAAY;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,CAAC,QAAyB,EAAE,GAAY;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,CAAC,QAAyB,EAAE,GAAY;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,QAAyB,EAAE,GAAY;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,KAA8B;QAClC,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAEO,IAAI,CAAC,KAAkC,EAAE,QAAyB,EAAE,GAAY;QACtF,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG;YAAE,OAAO;QACzC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAA4B,CAAC;QACpF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,CAAC,aAAa,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,KAAK,KAAI,CAAC;IACV,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;IACV,KAAK,KAAI,CAAC;IACV,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY;CAC1B,CAAC"}

package/dist/core/metadata.d.ts

@@ -0,0 +1,83 @@
+import type { FileRules } from './uploads/types.ts';
+import type { Middleware } from './compose.ts';
+import type { Guard } from './guard.ts';
+import { type ScopedHooks } from './hooks.ts';
+export declare const ROUTER_METADATA: unique symbol;
+/**
+ * Resposta com tipo de conteúdo declarado (F-31). Sem `contentType`, a entrada é um schema JSON.
+ *
+ * ```ts
+ * response: { 200: { contentType: ['application/json', 'text/csv'], schema: Users } }
+ * ```
+ */
+export interface ResponseContent {
+    /** Um tipo ou a lista de tipos oferecidos; com vários, o cliente escolhe pelo `Accept`. */
+    contentType: string | readonly string[];
+    /** Schema dos dados. Em formatos não JSON, valida e remove campos antes do serializador. */
+    schema?: object;
+}
+/** Schema JSON (como sempre) ou `{ contentType, schema? }`. */
+export type ResponseEntry = object | ResponseContent;
+export interface RouteSchemas {
+    params?: object;
+    body?: object;
+    query?: object;
+    headers?: object;
+    response?: Record<number, ResponseEntry>;
+    /** Campos de arquivo (`multipart/form-data`): nome do campo → regras. Os campos de texto vão no `body`. */
+    files?: FileRules;
+}
+export declare function isResponseContent(entry: unknown): entry is ResponseContent;
+export interface MethodMetadata {
+    method?: string;
+    path?: string;
+    schemas: RouteSchemas;
+    handlerName?: string | symbol;
+    /** `@Middlewares` no método (F-01). */
+    middlewares: Middleware[];
+    /** `@Guards` no método (F-01). */
+    guards: Guard[];
+    /** `@OnSend`, `@OnResponse` e `@OnError` no método (F-43). */
+    hooks: ScopedHooks;
+}
+export interface RouterMetadata {
+    /** `true` apenas quando a própria classe recebeu `@Router` (não herda). */
+    isRouter: boolean;
+    prefix: string;
+    methods: Map<string | symbol, MethodMetadata>;
+    /** `@Middlewares` na classe: valem para todas as rotas da classe (F-01). */
+    middlewares: Middleware[];
+    /** `@Guards` na classe (F-01). */
+    guards: Guard[];
+    /** Hooks da classe (F-43). */
+    hooks: ScopedHooks;
+}
+/**
+ * Retorna a metadata **própria** da classe.
+ *
+ * Em subclasses, `context.metadata` herda do pai via protótipo. Ler a chave direto
+ * devolveria o objeto do pai, e qualquer escrita o corromperia (B-09). Por isso
+ * clonamos a metadata herdada na primeira escrita (copy-on-write): a subclasse
+ * herda as rotas do pai, mas nunca altera a classe base.
+ */
+export declare function getOrCreateMetadata(meta: DecoratorMetadataObject): RouterMetadata;
+/** Lê a metadata própria de uma classe já decorada, sem criar nem herdar. */
+export declare function readOwnMetadata(Class: object): RouterMetadata | undefined;
+/**
+ * Ponto de entrada dos decorators: valida o ambiente e devolve a metadata própria da classe.
+ *
+ * - R-02: com `experimentalDecorators`, o TypeScript chama o decorator com
+ *   `(target, propertyKey, descriptor)` em vez de `(value, context)`.
+ * - R-01: sem `Symbol.metadata`, o `context.metadata` chega `undefined` e não há onde guardar as rotas.
+ *
+ * Nos dois casos, falhamos cedo com uma mensagem que diz como resolver.
+ */
+export declare function metadataFor(context: unknown, decorator: string): RouterMetadata;
+/**
+ * Junta schemas vindos de `@Get(path, schemas)` e de `@Schema(...)` no mesmo método.
+ * Partes diferentes se combinam; a mesma parte declarada duas vezes é erro, para não haver
+ * dúvida sobre qual vale.
+ */
+export declare function mergeSchemas(method: MethodMetadata, schemas: RouteSchemas, where: string): void;
+export declare function getOrCreateMethod(meta: RouterMetadata, name: string | symbol): MethodMetadata;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/core/metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACvE,eAAO,MAAM,eAAe,eAA+B,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,WAAW,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACxC,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,eAAe,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,2GAA2G;IAC3G,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAI1E;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,uCAAuC;IACvC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kCAAkC;IAClC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kCAAkC;IAClC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,8BAA8B;IAC9B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,CAqBjF;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAKzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAe/E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAW/F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAO7F"}

package/dist/core/metadata.js

@@ -0,0 +1,91 @@
+import { concatHooks, emptyHooks } from './hooks.js';
+export const ROUTER_METADATA = Symbol.for('flowing:router');
+export function isResponseContent(entry) {
+    if (typeof entry !== 'object' || entry === null || !('contentType' in entry))
+        return false;
+    const ct = entry.contentType;
+    return typeof ct === 'string' || Array.isArray(ct);
+}
+/**
+ * Retorna a metadata **própria** da classe.
+ *
+ * Em subclasses, `context.metadata` herda do pai via protótipo. Ler a chave direto
+ * devolveria o objeto do pai, e qualquer escrita o corromperia (B-09). Por isso
+ * clonamos a metadata herdada na primeira escrita (copy-on-write): a subclasse
+ * herda as rotas do pai, mas nunca altera a classe base.
+ */
+export function getOrCreateMetadata(meta) {
+    if (Object.hasOwn(meta, ROUTER_METADATA)) {
+        return meta[ROUTER_METADATA];
+    }
+    const inherited = meta[ROUTER_METADATA];
+    const own = {
+        isRouter: false,
+        prefix: '',
+        methods: new Map([...(inherited?.methods ?? [])].map(([name, m]) => [
+            name,
+            { ...m, schemas: { ...m.schemas }, middlewares: [...m.middlewares], guards: [...m.guards], hooks: concatHooks(m.hooks) },
+        ])),
+        // A subclasse herda os middlewares/guards de classe do pai e pode acrescentar os seus.
+        middlewares: [...(inherited?.middlewares ?? [])],
+        guards: [...(inherited?.guards ?? [])],
+        hooks: concatHooks(inherited?.hooks ?? emptyHooks()),
+    };
+    meta[ROUTER_METADATA] = own;
+    return own;
+}
+/** Lê a metadata própria de uma classe já decorada, sem criar nem herdar. */
+export function readOwnMetadata(Class) {
+    if (!Object.hasOwn(Class, Symbol.metadata))
+        return undefined;
+    const meta = Class[Symbol.metadata];
+    if (!meta || !Object.hasOwn(meta, ROUTER_METADATA))
+        return undefined;
+    return meta[ROUTER_METADATA];
+}
+/**
+ * Ponto de entrada dos decorators: valida o ambiente e devolve a metadata própria da classe.
+ *
+ * - R-02: com `experimentalDecorators`, o TypeScript chama o decorator com
+ *   `(target, propertyKey, descriptor)` em vez de `(value, context)`.
+ * - R-01: sem `Symbol.metadata`, o `context.metadata` chega `undefined` e não há onde guardar as rotas.
+ *
+ * Nos dois casos, falhamos cedo com uma mensagem que diz como resolver.
+ */
+export function metadataFor(context, decorator) {
+    if (typeof context !== 'object' || context === null || !('kind' in context)) {
+        throw new Error(`[flowing] @${decorator} received legacy decorator arguments. FlowingTS uses standard (TC39) ` +
+            `decorators: remove "experimentalDecorators" (and "emitDecoratorMetadata") from your tsconfig.json.`);
+    }
+    const meta = context.metadata;
+    if (!meta) {
+        throw new Error(`[flowing] @${decorator}: decorator metadata is unavailable (Symbol.metadata is not defined). ` +
+            `Import 'flowingts' before declaring routers, or use TypeScript >= 5.2 / a runtime with decorator metadata.`);
+    }
+    return getOrCreateMetadata(meta);
+}
+/**
+ * Junta schemas vindos de `@Get(path, schemas)` e de `@Schema(...)` no mesmo método.
+ * Partes diferentes se combinam; a mesma parte declarada duas vezes é erro, para não haver
+ * dúvida sobre qual vale.
+ */
+export function mergeSchemas(method, schemas, where) {
+    for (const key of Object.keys(schemas)) {
+        if (schemas[key] === undefined)
+            continue;
+        if (method.schemas[key] !== undefined) {
+            throw new Error(`[flowing] ${where}: schema "${key}" is declared twice for ${String(method.handlerName)}. ` +
+                `Declare each part either in the HTTP decorator or in @Schema, not both.`);
+        }
+    }
+    method.schemas = { ...method.schemas, ...schemas };
+}
+export function getOrCreateMethod(meta, name) {
+    let m = meta.methods.get(name);
+    if (!m) {
+        m = { schemas: {}, handlerName: name, middlewares: [], guards: [], hooks: emptyHooks() };
+        meta.methods.set(name, m);
+    }
+    return m;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/core/metadata.js.map

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

package/dist/core/mounted-group.d.ts

@@ -0,0 +1,77 @@
+import type http from 'node:http';
+import type https from 'node:https';
+import type { TlsOptions } from '../server/tls.ts';
+import type { FlowingApp } from './app.ts';
+import { type GroupOptions, type ManualRouteOptions, type MethodSelector, type MountOptions, type RouteGroup, type RouteScope } from './compiler.ts';
+import type { InjectOptions, InjectResponse } from './inject.ts';
+import type { ListenOptions } from './app.ts';
+import type { Logger } from './logger.ts';
+import type { Middleware } from './compose.ts';
+import type { OnSendHook } from './context.ts';
+import type { OnCloseHook, OnErrorHook, OnRequestHook, OnResponseHook } from './app.ts';
+import type { OpenAPIOptions } from '../openapi/generate.ts';
+import type { HealthOptions } from './health.ts';
+import type { StaticOptions } from '../server/static.ts';
+/**
+ * Retorno de `app.mount()` (F-30): permite mapear manualmente métodos do grupo e continuar
+ * encadeando chamadas do app.
+ *
+ * ```ts
+ * app
+ *   .mount(new UserRoutes(repo))
+ *   .get('/legacy/:id', (r) => r.getUser, { guards: [isAdmin] })
+ *   .mount(HealthRoutes);
+ * ```
+ */
+export declare class MountedGroup<T extends object> {
+    #private;
+    readonly app: FlowingApp;
+    /** @internal Criado por `app.mount()`. */
+    constructor(app: FlowingApp, group: RouteGroup, register: (group: RouteGroup, method: string, path: string, select: MethodSelector<object>, opts?: ManualRouteOptions) => void, scope?: RouteScope);
+    /** Mapeia `GET path` (relativo ao prefixo do grupo) para o método selecionado. */
+    get(path: string, select: MethodSelector<T>, opts?: ManualRouteOptions): this;
+    post(path: string, select: MethodSelector<T>, opts?: ManualRouteOptions): this;
+    put(path: string, select: MethodSelector<T>, opts?: ManualRouteOptions): this;
+    patch(path: string, select: MethodSelector<T>, opts?: ManualRouteOptions): this;
+    delete(path: string, select: MethodSelector<T>, opts?: ManualRouteOptions): this;
+    mount<U extends object>(ref: new () => U, options?: MountOptions<U>): MountedGroup<U>;
+    mount<U extends object>(ref: U extends abstract new (...args: never) => unknown ? never : U, options?: MountOptions<U>): MountedGroup<U>;
+    /** Arquivos estáticos no mesmo escopo deste `mount()` (o grupo atual, ou o app). */
+    static(prefix: string, root: string, opts?: StaticOptions): this;
+    /** Grupo aninhado no grupo atual (ou no app, fora de um grupo). */
+    group(options: GroupOptions, define: (group: RouteGroupScope) => unknown): this;
+    use(mw: Middleware): FlowingApp;
+    openapi(opts?: OpenAPIOptions): FlowingApp;
+    health(opts?: HealthOptions): FlowingApp;
+    openapiDocument(opts?: OpenAPIOptions): Record<string, unknown>;
+    onError(h: OnErrorHook): FlowingApp;
+    onSend(hook: OnSendHook): FlowingApp;
+    onRequest(hook: OnRequestHook): FlowingApp;
+    onResponse(hook: OnResponseHook): FlowingApp;
+    onClose(hook: OnCloseHook): FlowingApp;
+    listen(options: ListenOptions & {
+        tls: TlsOptions;
+    }): Promise<https.Server>;
+    listen(options?: number | ListenOptions): Promise<http.Server>;
+    reloadTLS(tls: TlsOptions): void;
+    close(graceMs?: number): Promise<void>;
+    callback(): (req: http.IncomingMessage, res: http.ServerResponse) => void;
+    inject(opts: InjectOptions | string): Promise<InjectResponse>;
+    get log(): Logger;
+}
+/**
+ * O `g` de `app.group(opts, (g) => …)`: só registra rotas, todas com o prefixo, os middlewares e os guards
+ * do grupo. Middlewares globais e hooks continuam no app (`app.use()`, `app.onError()`…).
+ */
+export declare class RouteGroupScope {
+    #private;
+    /** @internal Criado por `app.group()`. */
+    constructor(app: FlowingApp, scope: RouteScope);
+    mount<U extends object>(ref: new () => U, options?: MountOptions<U>): MountedGroup<U>;
+    mount<U extends object>(ref: U extends abstract new (...args: never) => unknown ? never : U, options?: MountOptions<U>): MountedGroup<U>;
+    /** Arquivos estáticos dentro do grupo: herdam prefixo, host, guards e middlewares. */
+    static(prefix: string, root: string, opts?: StaticOptions): this;
+    /** Grupo aninhado: prefixos se somam, middlewares e guards se acumulam de fora para dentro. */
+    group(options: GroupOptions, define: (group: RouteGroupScope) => unknown): this;
+}
+//# sourceMappingURL=mounted-group.d.ts.map

package/dist/core/mounted-group.d.ts.map

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

package/dist/core/mounted-group.js

@@ -0,0 +1,131 @@
+import { ROOT_SCOPE, } from './compiler.js';
+/**
+ * Retorno de `app.mount()` (F-30): permite mapear manualmente métodos do grupo e continuar
+ * encadeando chamadas do app.
+ *
+ * ```ts
+ * app
+ *   .mount(new UserRoutes(repo))
+ *   .get('/legacy/:id', (r) => r.getUser, { guards: [isAdmin] })
+ *   .mount(HealthRoutes);
+ * ```
+ */
+export class MountedGroup {
+    app;
+    #group;
+    #register;
+    /** @internal Criado por `app.mount()`. */
+    constructor(app, group, register, scope = ROOT_SCOPE) {
+        this.app = app;
+        this.#group = group;
+        this.#register = register;
+        this.#scope = scope;
+    }
+    #scope;
+    #map(method, path, select, opts) {
+        this.#register(this.#group, method, path, select, opts);
+        return this;
+    }
+    /** Mapeia `GET path` (relativo ao prefixo do grupo) para o método selecionado. */
+    get(path, select, opts) {
+        return this.#map('GET', path, select, opts);
+    }
+    post(path, select, opts) {
+        return this.#map('POST', path, select, opts);
+    }
+    put(path, select, opts) {
+        return this.#map('PUT', path, select, opts);
+    }
+    patch(path, select, opts) {
+        return this.#map('PATCH', path, select, opts);
+    }
+    delete(path, select, opts) {
+        return this.#map('DELETE', path, select, opts);
+    }
+    mount(ref, options) {
+        // Dentro de um `group()`, o próximo `mount()` continua no mesmo grupo.
+        return this.app.mountIn(this.#scope, ref, options);
+    }
+    /** Arquivos estáticos no mesmo escopo deste `mount()` (o grupo atual, ou o app). */
+    static(prefix, root, opts) {
+        this.app.staticIn(this.#scope, prefix, root, opts ?? {});
+        return this;
+    }
+    /** Grupo aninhado no grupo atual (ou no app, fora de um grupo). */
+    group(options, define) {
+        this.app.groupIn(this.#scope, options, define);
+        return this;
+    }
+    use(mw) {
+        return this.app.use(mw);
+    }
+    openapi(opts) {
+        return this.app.openapi(opts);
+    }
+    health(opts) {
+        return this.app.health(opts);
+    }
+    openapiDocument(opts) {
+        return this.app.openapiDocument(opts);
+    }
+    onError(h) {
+        return this.app.onError(h);
+    }
+    onSend(hook) {
+        return this.app.onSend(hook);
+    }
+    onRequest(hook) {
+        return this.app.onRequest(hook);
+    }
+    onResponse(hook) {
+        return this.app.onResponse(hook);
+    }
+    onClose(hook) {
+        return this.app.onClose(hook);
+    }
+    listen(options) {
+        return this.app.listen(options);
+    }
+    reloadTLS(tls) {
+        this.app.reloadTLS(tls);
+    }
+    close(graceMs) {
+        return this.app.close(graceMs);
+    }
+    callback() {
+        return this.app.callback();
+    }
+    inject(opts) {
+        return this.app.inject(opts);
+    }
+    get log() {
+        return this.app.log;
+    }
+}
+/**
+ * O `g` de `app.group(opts, (g) => …)`: só registra rotas, todas com o prefixo, os middlewares e os guards
+ * do grupo. Middlewares globais e hooks continuam no app (`app.use()`, `app.onError()`…).
+ */
+export class RouteGroupScope {
+    #app;
+    #scope;
+    /** @internal Criado por `app.group()`. */
+    constructor(app, scope) {
+        this.#app = app;
+        this.#scope = scope;
+    }
+    mount(ref, options) {
+        return this.#app.mountIn(this.#scope, ref, options);
+    }
+    /** Arquivos estáticos dentro do grupo: herdam prefixo, host, guards e middlewares. */
+    static(prefix, root, opts) {
+        this.#app.staticIn(this.#scope, prefix, root, opts ?? {});
+        return this;
+    }
+    /** Grupo aninhado: prefixos se somam, middlewares e guards se acumulam de fora para dentro. */
+    group(options, define) {
+        this.#app.groupIn(this.#scope, options, define);
+        return this;
+    }
+}
+//# sourceMappingURL=mounted-group.js.map

package/dist/core/mounted-group.js.map

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

package/dist/core/registry/framework-routes.d.ts

@@ -0,0 +1,28 @@
+import type { AppCore } from '../app/core.ts';
+import { type Middleware } from '../compose.ts';
+import type { Context } from '../context.ts';
+import type { HealthConfig } from '../health.ts';
+import { type OpenAPIOptions } from '../../openapi/generate.ts';
+import type { RouteRegistry } from './registry.ts';
+export type OpenAPIConfig = {
+    opts: OpenAPIOptions;
+    path: string;
+    docs: string | false;
+    pipeline: Middleware[];
+    cache: Map<string, string>;
+};
+/** Rotas servidas pelo próprio app: healthchecks e OpenAPI (documento e página). */
+export declare class FrameworkRoutes {
+    private readonly core;
+    private readonly registry;
+    health: HealthConfig | undefined;
+    openapi: OpenAPIConfig | undefined;
+    constructor(core: AppCore, registry: RouteRegistry);
+    /** Paths servidos pelo próprio app (`health()`, `openapi()`), que encobririam uma rota GET do usuário. */
+    reservedPaths(except?: 'health' | 'openapi'): Map<string, string>;
+    /** Um path do framework não pode coincidir com uma rota GET/HEAD registrada nem com outro do framework. */
+    assertFreePaths(where: string, paths: readonly string[], kind: 'health' | 'openapi'): void;
+    /** Se a requisição é para `/openapi.json` ou `/docs` (quando ligados), responde e devolve `true`. */
+    serveOpenAPI(ctx: Context): Promise<boolean>;
+}
+//# sourceMappingURL=framework-routes.d.ts.map