flowingts 0.0.0 → 0.19.0

package/dist/core/uploads/receive.js

@@ -0,0 +1,342 @@
+import { randomUUID } from 'node:crypto';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { readFile, unlink } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { Busboy } from '@fastify/busboy';
+import { filetypeinfo } from 'magic-bytes.js';
+import { HttpError } from '../errors.js';
+/** Quantos bytes do começo do arquivo vão para a detecção do conteúdo e para o `verify`. */
+const HEAD_BYTES = 4100;
+const UNITS = { b: 1, kb: 1024, mb: 1024 ** 2, gb: 1024 ** 3 };
+/** `'5mb'` → 5242880. Erro de configuração aparece no registro da rota. */
+export function parseSize(size, where) {
+    if (typeof size === 'number' && Number.isFinite(size) && size > 0)
+        return Math.floor(size);
+    const m = typeof size === 'string' ? /^(\d+(?:\.\d+)?)\s*(b|kb|mb|gb)$/i.exec(size.trim()) : null;
+    if (!m)
+        throw new Error(`[flowing] ${where}: invalid size ${JSON.stringify(size)} (use a number of bytes or '5mb').`);
+    return Math.floor(Number(m[1]) * UNITS[m[2].toLowerCase()]);
+}
+/** Detector padrão: a tabela de assinaturas da `magic-bytes.js`. */
+const magicBytes = (head) => filetypeinfo(head).map((t) => t.mime ?? t.typename);
+/**
+ * Detectores de conteúdo (F-46):
+ * - `detectors.magicBytes()`: o padrão, sem dependências (centenas de assinaturas; documentos do Office só como ZIP).
+ * - `detectors.fileType(fileTypeFromBuffer)`: o `file-type`, instalado pela aplicação, para conferências mais completas
+ *   (abre o ZIP para confirmar `.docx`, `.xlsx`, `.pptx`).
+ */
+export const detectors = {
+    magicBytes: () => magicBytes,
+    fileType: (fileTypeFromBuffer) => async (head) => {
+        const found = await fileTypeFromBuffer(head);
+        return found ? [found.mime] : [];
+    },
+};
+export function uploadSettings(opts = {}) {
+    const l = opts.limits ?? {};
+    return {
+        limits: {
+            fileSize: parseSize(l.fileSize ?? '10mb', 'uploads.limits.fileSize'),
+            files: l.files ?? 10,
+            fields: l.fields ?? 50,
+            fieldSize: parseSize(l.fieldSize ?? '100kb', 'uploads.limits.fieldSize'),
+            parts: l.parts ?? 60,
+        },
+        tempDir: opts.tempDir ?? tmpdir(),
+        detect: opts.detect ?? magicBytes,
+    };
+}
+/**
+ * Resolve o `files` do contrato. Uma rota que tenta ampliar um limite global falha aqui, no registro, em vez de ser
+ * ignorada em silêncio.
+ */
+export function uploadPlan(files, settings, where) {
+    const rules = new Map();
+    for (const [name, rule] of Object.entries(files)) {
+        const maxSize = rule.maxSize === undefined ? settings.limits.fileSize : parseSize(rule.maxSize, `${where} files.${name}.maxSize`);
+        if (maxSize > settings.limits.fileSize) {
+            throw new Error(`[flowing] ${where}: files.${name}.maxSize (${maxSize} bytes) is larger than uploads.limits.fileSize ` +
+                `(${settings.limits.fileSize} bytes); a route can only restrict the global limits.`);
+        }
+        const maxCount = rule.maxCount ?? 1;
+        if (!Number.isInteger(maxCount) || maxCount < 1)
+            throw new Error(`[flowing] ${where}: files.${name}.maxCount must be a positive integer.`);
+        rules.set(name, { required: rule.required ?? false, maxSize, maxCount, types: rule.types, verify: rule.verify });
+    }
+    let largest = 0;
+    for (const r of rules.values())
+        largest = Math.max(largest, r.maxSize);
+    return { rules, settings, largest };
+}
+/** Tipos sem assinatura de conteúdo: só o tipo declarado é conferido. */
+const TEXT_LIKE = /^(text\/|application\/(json|xml|csv|x-ndjson|ld\+json)$|image\/svg\+xml$)/;
+/** Formatos que são um ZIP por dentro: o detector padrão só os reconhece como ZIP. */
+const ZIP_FAMILY = new Set([
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    'application/vnd.oasis.opendocument.text',
+    'application/vnd.oasis.opendocument.spreadsheet',
+    'application/vnd.oasis.opendocument.presentation',
+    'application/epub+zip',
+    'application/java-archive',
+]);
+const matches = (type, accepted) => accepted.some((a) => a === '*/*' || a === type || (a.endsWith('/*') && type.startsWith(a.slice(0, -1))));
+class Spooled {
+    fieldname;
+    filename;
+    mimetype;
+    encoding;
+    size;
+    path;
+    detectedType;
+    #read = false;
+    constructor(fieldname, filename, mimetype, encoding, size, detected, path) {
+        this.fieldname = fieldname;
+        this.filename = filename;
+        this.mimetype = mimetype;
+        this.encoding = encoding;
+        this.size = size;
+        this.path = path;
+        this.detectedType = detected;
+    }
+    stream() {
+        if (this.#read)
+            throw new Error(`[flowing] the file "${this.fieldname}" was already read; stream() can be called only once.`);
+        this.#read = true;
+        return createReadStream(this.path);
+    }
+    buffer() {
+        return readFile(this.path);
+    }
+}
+const UNSAFE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+/**
+ * Lê um `multipart/form-data` (F-46). Os arquivos vão para temporários com nome gerado, apagados quando a resposta
+ * termina (sucesso, erro ou cancelamento). Limites, tipos, conteúdo e obrigatórios são conferidos aqui, antes do
+ * handler; os campos de texto são validados depois pelo contrato `body`.
+ */
+export function receiveUploads(ctx, plan) {
+    const contentType = ctx.req.headers['content-type'] ?? '';
+    if (!/^multipart\/form-data\b/i.test(contentType)) {
+        return Promise.reject(new HttpError(415, 'Expected multipart/form-data', 'UNSUPPORTED_MEDIA_TYPE'));
+    }
+    const { limits, tempDir } = plan.settings;
+    const temps = [];
+    // Os temporários somem quando a resposta termina, qualquer que seja o caminho.
+    ctx.res.once('close', () => {
+        for (const path of temps)
+            unlink(path).catch(() => { });
+    });
+    return new Promise((resolve, reject) => {
+        const fields = {};
+        const files = new Map();
+        const counts = new Map();
+        const pending = [];
+        let failed;
+        let settled = false;
+        /** Gravações em andamento: fechadas na recusa, senão o descritor do temporário fica aberto. */
+        const writing = new Set();
+        const fail = (err) => {
+            if (failed || settled)
+                return;
+            failed = err;
+            ctx.req.unpipe(parser);
+            for (const out of writing)
+                out.destroy();
+            writing.clear();
+            discardRest(ctx, () => reject(err));
+        };
+        let parser;
+        try {
+            parser = new Busboy({
+                headers: ctx.req.headers,
+                limits: {
+                    fileSize: plan.largest,
+                    files: limits.files,
+                    fields: limits.fields,
+                    fieldSize: limits.fieldSize,
+                    parts: limits.parts,
+                },
+            });
+        }
+        catch {
+            return reject(new HttpError(400, 'Invalid multipart body', 'INVALID_MULTIPART'));
+        }
+        parser.on('field', (name, value, _nameTruncated, valueTruncated) => {
+            if (failed)
+                return;
+            if (valueTruncated)
+                return fail(new HttpError(413, `Field "${name}" is too large`, 'FIELD_TOO_LARGE'));
+            if (UNSAFE_KEYS.has(name))
+                return;
+            const prev = fields[name];
+            fields[name] = prev === undefined ? value : Array.isArray(prev) ? [...prev, value] : [prev, value];
+        });
+        parser.on('file', (name, stream, filename, encoding, mimetype) => {
+            // Corpo truncado: o busboy emite erro no stream da parte. Sem este listener, a exceção derrubava o processo.
+            stream.on('error', () => fail(new HttpError(400, 'Invalid multipart body', 'INVALID_MULTIPART')));
+            const rule = plan.rules.get(name);
+            if (failed || !rule) {
+                stream.resume();
+                if (!rule)
+                    fail(new HttpError(400, `Unexpected file field "${name}"`, 'UNEXPECTED_FILE'));
+                return;
+            }
+            // Contado na chegada: os arquivos terminam de gravar fora de ordem.
+            const count = (counts.get(name) ?? 0) + 1;
+            counts.set(name, count);
+            if (count > rule.maxCount) {
+                stream.resume();
+                return fail(new HttpError(400, `Too many files in "${name}" (max ${rule.maxCount})`, 'TOO_MANY_FILES'));
+            }
+            const path = join(tempDir, `flowing-upload-${randomUUID()}`);
+            temps.push(path);
+            const out = createWriteStream(path);
+            writing.add(out);
+            out.once('close', () => writing.delete(out));
+            const head = [];
+            let headSize = 0;
+            let size = 0;
+            stream.on('data', (chunk) => {
+                size += chunk.length;
+                if (headSize < HEAD_BYTES) {
+                    head.push(chunk);
+                    headSize += chunk.length;
+                }
+                if (size > rule.maxSize) {
+                    stream.unpipe(out);
+                    stream.resume();
+                    fail(new HttpError(413, `File "${name}" is too large (max ${rule.maxSize} bytes)`, 'FILE_TOO_LARGE'));
+                }
+            });
+            stream.on('limit', () => fail(new HttpError(413, `File "${name}" is too large (max ${rule.maxSize} bytes)`, 'FILE_TOO_LARGE')));
+            stream.pipe(out);
+            pending.push(new Promise((done, error) => {
+                out.on('finish', done);
+                out.on('error', error);
+            })
+                .then(async () => {
+                if (failed)
+                    return;
+                const bytes = Buffer.concat(head).subarray(0, HEAD_BYTES);
+                const detected = await checkContent(name, rule, mimetype, bytes, plan.settings.detect, {
+                    fieldname: name,
+                    filename,
+                    mimetype,
+                    encoding,
+                    size,
+                    detectedType: undefined,
+                });
+                const list = files.get(name);
+                const file = new Spooled(name, filename, mimetype, encoding, size, detected, path);
+                if (list)
+                    list.push(file);
+                else
+                    files.set(name, [file]);
+            })
+                .catch((err) => fail(err instanceof HttpError ? err : new HttpError(400, 'Invalid file', 'INVALID_FILE'))));
+        });
+        parser.on('partsLimit', () => fail(new HttpError(413, 'Too many parts', 'TOO_MANY_PARTS')));
+        parser.on('filesLimit', () => fail(new HttpError(413, 'Too many files', 'TOO_MANY_FILES')));
+        parser.on('fieldsLimit', () => fail(new HttpError(413, 'Too many fields', 'TOO_MANY_FIELDS')));
+        parser.on('error', () => fail(new HttpError(400, 'Invalid multipart body', 'INVALID_MULTIPART')));
+        parser.on('finish', () => {
+            Promise.all(pending)
+                .then(() => {
+                if (failed)
+                    return;
+                for (const [name, rule] of plan.rules) {
+                    if (rule.required && !files.get(name)?.length) {
+                        return fail(new HttpError(400, `File "${name}" is required`, 'FILE_REQUIRED'));
+                    }
+                }
+                settled = true;
+                resolve({ fields, files });
+            })
+                .catch((err) => fail(err instanceof HttpError ? err : new HttpError(400, 'Invalid file', 'INVALID_FILE')));
+        });
+        // O cliente desistiu no meio do envio: nada a validar, só limpar (o `close` da resposta apaga os temporários).
+        // A conexão caiu antes da resposta (o `aborted` da requisição é obsoleto e dispara no `inject()`).
+        ctx.res.once('close', () => fail(new HttpError(400, 'Upload aborted', 'UPLOAD_ABORTED')));
+        ctx.req.once('error', () => fail(new HttpError(400, 'Upload aborted', 'UPLOAD_ABORTED')));
+        ctx.req.pipe(parser);
+    });
+}
+/** Quanto do corpo recusado ainda vale ler e descartar antes de responder, para manter a conexão. */
+const DRAIN_LIMIT = 1024 * 1024;
+/** Por quanto tempo, no máximo: um cliente lento não segura a resposta (nem a conexão) indefinidamente. */
+const DRAIN_TIMEOUT_MS = 2000;
+/**
+ * Depois de recusar um upload, descarta o resto do corpo (lendo e jogando fora, sem acumular) antes de responder. Responder e fechar com o cliente ainda
+ * enviando faz o cliente receber EPIPE em vez do 400/413. Acima de `DRAIN_LIMIT`, responde já com
+ * `Connection: close` (como o limite do body JSON, B-12): não vale gastar banda com o que será jogado fora. O mesmo
+ * vale depois de `DRAIN_TIMEOUT_MS`. Com `Connection: close`, o Node fecha o socket ao fim da resposta: a conexão não
+ * volta ao keep-alive com bytes do corpo anterior.
+ */
+function discardRest(ctx, respond) {
+    const req = ctx.req;
+    if (req.readableEnded || req.destroyed) {
+        respond();
+        return;
+    }
+    let drained = 0;
+    let done = false;
+    const timer = setTimeout(() => finish(true), DRAIN_TIMEOUT_MS);
+    timer.unref();
+    const finish = (close) => {
+        if (done)
+            return;
+        done = true;
+        clearTimeout(timer);
+        req.off('data', onData);
+        if (close && !ctx.res.headersSent)
+            ctx.res.setHeader('Connection', 'close');
+        respond();
+    };
+    const onData = (chunk) => {
+        drained += chunk.length;
+        if (drained > DRAIN_LIMIT)
+            finish(true);
+    };
+    req.on('data', onData);
+    req.once('end', () => finish(false));
+    req.once('close', () => finish(true));
+    req.resume();
+}
+/** Confere o tipo declarado e, quando possível, o conteúdo; depois o `verify`. Devolve o tipo detectado. */
+async function checkContent(name, rule, declared, head, detect, info) {
+    const reject = (why) => {
+        throw new HttpError(400, `File "${name}" ${why}`, 'INVALID_FILE_TYPE');
+    };
+    let detectedType;
+    if (rule.types) {
+        const type = declared.toLowerCase();
+        if (!matches(type, rule.types))
+            reject(`has type "${declared}", which is not accepted`);
+        const candidates = await detect(head);
+        detectedType = candidates[0];
+        if (candidates.length > 0) {
+            const ok = candidates.some((c) => matches(c, rule.types)) || (ZIP_FAMILY.has(type) && candidates.includes('application/zip'));
+            if (!ok)
+                reject(`content does not match its type (detected "${candidates[0]}")`);
+        }
+        else if (!TEXT_LIKE.test(type) && !rule.verify) {
+            reject('content could not be recognized as an accepted type');
+        }
+    }
+    if (rule.verify) {
+        let ok = false;
+        try {
+            ok = await rule.verify(new Uint8Array(head), { ...info, detectedType });
+        }
+        catch {
+            ok = false;
+        }
+        if (!ok)
+            reject('was rejected by its verify rule');
+    }
+    return detectedType;
+}
+//# sourceMappingURL=receive.js.map

package/dist/core/uploads/receive.js.map

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

package/dist/core/uploads/types.d.ts

@@ -0,0 +1,79 @@
+import type { Readable } from 'node:stream';
+/** Tamanho em bytes, ou com unidade: `'512kb'`, `'5mb'`, `'1gb'` (base 1024). */
+export type Size = number | `${number}${'b' | 'kb' | 'mb' | 'gb'}`;
+/**
+ * Regras de um campo de arquivo no contrato da rota (F-46): `files: { pdf: { required: true, maxSize: '5mb' } }`.
+ * Tudo é conferido antes do handler; o arquivo inválido gera 400 ou 413 em Problem Details.
+ */
+export interface FileRule {
+    /** O campo precisa ter pelo menos um arquivo. Padrão: `false`. */
+    required?: boolean;
+    /** Tamanho máximo de cada arquivo. Não pode passar do limite global (`uploads.limits.fileSize`). */
+    maxSize?: Size;
+    /** Quantos arquivos o campo aceita. Padrão: 1. Use `ctx.files(nome)` quando for mais de um. */
+    maxCount?: number;
+    /**
+     * Tipos aceitos (`'application/pdf'`, `'image/*'`). Confere o tipo declarado pelo cliente e, quando o formato tem
+     * assinatura conhecida, também os primeiros bytes do arquivo (um executável com nome `.pdf` é recusado). Formatos de
+     * texto (CSV, JSON) não têm assinatura: só o tipo declarado é conferido.
+     */
+    types?: readonly string[];
+    /**
+     * Conferência própria do conteúdo, depois dos tipos: recebe os primeiros bytes do arquivo. `false` (ou um erro)
+     * recusa o arquivo com 400. Para regras que a detecção por assinatura não cobre.
+     */
+    verify?: (head: Uint8Array, file: FileInfo) => boolean | Promise<boolean>;
+}
+/** Os campos de arquivo de um contrato: nome do campo → regras. */
+export type FileRules = Readonly<Record<string, FileRule>>;
+/** O que se sabe de um arquivo recebido. */
+export interface FileInfo {
+    /** O nome do campo no formulário. */
+    readonly fieldname: string;
+    /** O nome enviado pelo cliente. É só um metadado: nunca o use como caminho no disco. */
+    readonly filename: string;
+    /** O tipo declarado pelo cliente. */
+    readonly mimetype: string;
+    /** O tipo detectado pelo conteúdo, quando o formato tem assinatura conhecida. */
+    readonly detectedType: string | undefined;
+    readonly encoding: string;
+    /** O tamanho efetivamente recebido, em bytes. */
+    readonly size: number;
+}
+/** Um arquivo recebido e validado, guardado num arquivo temporário até o fim da resposta. */
+export interface UploadedFile extends FileInfo {
+    /** O conteúdo como stream. Uso único: uma segunda chamada lança. */
+    stream(): Readable;
+    /** O conteúdo inteiro na memória. Prefira `stream()` para arquivos grandes. */
+    buffer(): Promise<Buffer>;
+}
+/**
+ * Detecta o tipo pelo conteúdo: recebe os primeiros bytes e devolve os tipos possíveis (vazio se não reconhece).
+ * O padrão usa a `magic-bytes.js`; `detectors.fileType(fileTypeFromBuffer)` liga o `file-type`.
+ */
+export type ContentDetector = (head: Uint8Array) => readonly string[] | Promise<readonly string[]>;
+/** Configuração de upload do app (`createApp({ uploads })`). */
+export interface UploadsOptions {
+    /** Limites globais; o contrato de cada rota só pode restringi-los. */
+    limits?: {
+        /** Tamanho máximo de cada arquivo. Padrão: `'10mb'`. */
+        fileSize?: Size;
+        /** Arquivos por requisição. Padrão: 10. */
+        files?: number;
+        /** Campos de texto por requisição. Padrão: 50. */
+        fields?: number;
+        /** Tamanho máximo de cada campo de texto. Padrão: `'100kb'`. */
+        fieldSize?: Size;
+        /** Partes (campos + arquivos) por requisição. Padrão: 60. */
+        parts?: number;
+    };
+    /** Pasta dos arquivos temporários. Padrão: a pasta temporária do sistema. */
+    tempDir?: string;
+    /** Detector de conteúdo. Padrão: `detectors.magicBytes()`. */
+    detect?: ContentDetector;
+}
+/** Os nomes dos campos de arquivo de um contrato; `string` quando a rota não declara `files`. */
+export type FileField<S extends {
+    files?: FileRules;
+}> = S['files'] extends FileRules ? Extract<keyof S['files'], string> : string;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/uploads/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/uploads/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,iFAAiF;AACjF,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oGAAoG;IACpG,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E;AAED,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE3D,4CAA4C;AAC5C,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,6FAA6F;AAC7F,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,oEAAoE;IACpE,MAAM,IAAI,QAAQ,CAAC;IACnB,+EAA+E;IAC/E,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;AAEnG,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,MAAM,CAAC,EAAE;QACP,wDAAwD;QACxD,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChB,2CAA2C;QAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,kDAAkD;QAClD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gEAAgE;QAChE,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,6DAA6D;QAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,iGAAiG;AACjG,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC"}

package/dist/core/uploads/types.js

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

package/dist/core/uploads/types.js.map

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

package/dist/decorators/hooks.d.ts

@@ -0,0 +1,25 @@
+import type { OnErrorHook, OnResponseHook } from '../core/app/options.ts';
+import type { OnSendHook } from '../core/context.ts';
+type ClassOrMethodContext = ClassDecoratorContext | ClassMethodDecoratorContext;
+/**
+ * `onSend` só para as rotas da classe ou do método (F-43): roda depois dos `onSend` do app, imediatamente
+ * antes de escrever a resposta. A assinatura é a do `app.onSend`.
+ *
+ * ```ts
+ * @OnSend((ctx) => void ctx.header('Cache-Control', 'private, max-age=60'))
+ * @Get('/:id/invoice') invoice() {}
+ * ```
+ */
+export declare function OnSend(...hooks: OnSendHook[]): (_value: unknown, context: ClassOrMethodContext) => void;
+/**
+ * `onResponse` só para as rotas da classe ou do método (F-43): roda exatamente uma vez quando a requisição
+ * termina (inclusive cancelada ou em stream), depois dos `onResponse` do app.
+ */
+export declare function OnResponse(...hooks: OnResponseHook[]): (_value: unknown, context: ClassOrMethodContext) => void;
+/**
+ * `onError` só para as rotas da classe ou do método (F-43): roda antes dos `onError` do app, do escopo mais
+ * específico para o mais externo. Se responder, os de fora (e a resposta padrão) não rodam.
+ */
+export declare function OnError(...hooks: OnErrorHook[]): (_value: unknown, context: ClassOrMethodContext) => void;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/decorators/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,KAAK,oBAAoB,GAAG,qBAAqB,GAAG,2BAA2B,CAAC;AAWhF;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,UAAU,EAAE,YAhB3B,OAAO,WAAW,oBAAoB,KAAG,IAAI,CAkB9D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,KAAK,EAAE,cAAc,EAAE,YAxBnC,OAAO,WAAW,oBAAoB,KAAG,IAAI,CA0B9D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,KAAK,EAAE,WAAW,EAAE,YAhC7B,OAAO,WAAW,oBAAoB,KAAG,IAAI,CAkC9D"}

package/dist/decorators/hooks.js

@@ -0,0 +1,36 @@
+import { getOrCreateMethod, metadataFor } from '../core/metadata.js';
+/** Na classe (todas as rotas) ou no método; na ordem de leitura, como `@Middlewares` e `@Guards`. */
+function register(decorator, kind, hooks) {
+    return (_value, context) => {
+        const meta = metadataFor(context, decorator);
+        const target = context.kind === 'class' ? meta : getOrCreateMethod(meta, context.name);
+        target.hooks[kind].unshift(...hooks);
+    };
+}
+/**
+ * `onSend` só para as rotas da classe ou do método (F-43): roda depois dos `onSend` do app, imediatamente
+ * antes de escrever a resposta. A assinatura é a do `app.onSend`.
+ *
+ * ```ts
+ * @OnSend((ctx) => void ctx.header('Cache-Control', 'private, max-age=60'))
+ * @Get('/:id/invoice') invoice() {}
+ * ```
+ */
+export function OnSend(...hooks) {
+    return register('OnSend', 'onSend', hooks);
+}
+/**
+ * `onResponse` só para as rotas da classe ou do método (F-43): roda exatamente uma vez quando a requisição
+ * termina (inclusive cancelada ou em stream), depois dos `onResponse` do app.
+ */
+export function OnResponse(...hooks) {
+    return register('OnResponse', 'onResponse', hooks);
+}
+/**
+ * `onError` só para as rotas da classe ou do método (F-43): roda antes dos `onError` do app, do escopo mais
+ * específico para o mais externo. Se responder, os de fora (e a resposta padrão) não rodam.
+ */
+export function OnError(...hooks) {
+    return register('OnError', 'onError', hooks);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/decorators/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/decorators/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIrE,qGAAqG;AACrG,SAAS,QAAQ,CAA8B,SAAiB,EAAE,IAAO,EAAE,KAAqB;IAC9F,OAAO,CAAC,MAAe,EAAE,OAA6B,EAAQ,EAAE;QAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACtF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,GAAG,KAAmB;IAC3C,OAAO,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAG,KAAuB;IACnD,OAAO,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAG,KAAoB;IAC7C,OAAO,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC"}

package/dist/decorators/http.d.ts

@@ -0,0 +1,21 @@
+import type { CheckParams } from '../core/infer.ts';
+import { type RouteSchemas } from '../core/metadata.ts';
+declare function methodDecorator(httpMethod: string, path: string, schemas?: RouteSchemas): <This, Args extends [any, ...unknown[]], Return>(_target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => void;
+/**
+ * Decorators de rota. O segundo argumento, opcional, são os schemas da rota: o mesmo que `@Schema`,
+ * na mesma linha do verbo.
+ *
+ * ```ts
+ * @Get('/:id', byId)
+ * getUser(ctx: Context<typeof byId>) {}
+ * ```
+ */
+type Verb = <const P extends string = '/', const S extends RouteSchemas = {}>(path?: P, schemas?: S & CheckParams<P, S>) => ReturnType<typeof methodDecorator>;
+/** Com schema de `params`, as chaves precisam ser exatamente as do path, ou o TypeScript acusa (F-29). */
+export declare const Get: Verb;
+export declare const Post: Verb;
+export declare const Put: Verb;
+export declare const Patch: Verb;
+export declare const Delete: Verb;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/decorators/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/decorators/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAgD,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEtG,iBAAS,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,IAGvE,IAAI,EAAE,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,EAAE,MAAM,WAC3C,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,WACrC,2BAA2B,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,UAQpF;AAED;;;;;;;;GAQG;AACH,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,EAAE,EAC1E,IAAI,CAAC,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,KAC5B,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAOxC,0GAA0G;AAC1G,eAAO,MAAM,GAAG,MAAc,CAAC;AAC/B,eAAO,MAAM,IAAI,MAAe,CAAC;AACjC,eAAO,MAAM,GAAG,MAAc,CAAC;AAC/B,eAAO,MAAM,KAAK,MAAgB,CAAC;AACnC,eAAO,MAAM,MAAM,MAAiB,CAAC"}

package/dist/decorators/http.js

@@ -0,0 +1,21 @@
+import { getOrCreateMethod, mergeSchemas, metadataFor } from '../core/metadata.js';
+function methodDecorator(httpMethod, path, schemas) {
+    const label = httpMethod[0] + httpMethod.slice(1).toLowerCase();
+    // biome-ignore lint/suspicious/noExplicitAny: o primeiro parâmetro precisa ser bivariante para aceitar Context<S> de qualquer S.
+    return (_target, context) => {
+        const meta = metadataFor(context, label);
+        const m = getOrCreateMethod(meta, context.name);
+        m.method = httpMethod;
+        m.path = path;
+        if (schemas)
+            mergeSchemas(m, schemas, `@${label}`);
+    };
+}
+const verb = (httpMethod) => (path, schemas) => methodDecorator(httpMethod, path ?? '/', schemas);
+/** Com schema de `params`, as chaves precisam ser exatamente as do path, ou o TypeScript acusa (F-29). */
+export const Get = verb('GET');
+export const Post = verb('POST');
+export const Put = verb('PUT');
+export const Patch = verb('PATCH');
+export const Delete = verb('DELETE');
+//# sourceMappingURL=http.js.map

package/dist/decorators/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/decorators/http.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAqB,MAAM,qBAAqB,CAAC;AAEtG,SAAS,eAAe,CAAC,UAAkB,EAAE,IAAY,EAAE,OAAsB;IAC/E,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,iIAAiI;IACjI,OAAO,CACL,OAA8C,EAC9C,OAAiF,EACjF,EAAE;QACF,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QACd,IAAI,OAAO;YAAE,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC;AAgBD,MAAM,IAAI,GACR,CAAC,UAAkB,EAAQ,EAAE,CAC7B,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAChB,eAAe,CAAC,UAAU,EAAE,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC;AAEtD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,7 @@
+export { Delete, Get, Patch, Post, Put } from './http.ts';
+export { timer, type TimerOptions } from './log.ts';
+export { Router } from './router.ts';
+export { Schema } from './schema.ts';
+export { Guards, Middlewares } from './middlewares.ts';
+export { OnError, OnResponse, OnSend } from './hooks.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/decorators/index.js

@@ -0,0 +1,7 @@
+export { Delete, Get, Patch, Post, Put } from './http.js';
+export { timer } from './log.js';
+export { Router } from './router.js';
+export { Schema } from './schema.js';
+export { Guards, Middlewares } from './middlewares.js';
+export { OnError, OnResponse, OnSend } from './hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAqB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/decorators/log.d.ts

@@ -0,0 +1,10 @@
+export interface TimerOptions {
+    /** Destino da medição. Padrão: `console.debug`. */
+    log?: (message: string, ms: number) => void;
+}
+/**
+ * Mede o tempo do handler, inclusive de handlers `async` (B-04).
+ * Uso: `@timer()` ou `@timer({ log: (msg, ms) => logger.info({ ms }, msg) })`.
+ */
+export declare function timer(opts?: TimerOptions): <This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => (this: This, ...args: Args) => Return;
+//# sourceMappingURL=log.d.ts.map

package/dist/decorators/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/decorators/log.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,GAAE,YAAiB,IAGnC,IAAI,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,UAClC,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,WACpC,2BAA2B,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,YAQ1D,IAAI,WAAW,IAAI,KAAG,MAAM,CAgBtD"}