@hed-hog/core 0.0.399 → 0.0.400

package/dist/file/mcp-file-source.schema.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Fragmento de schema e texto de descrição que toda tool MCP que recebe arquivo espalha
+ * no seu `inputSchema`.
+ *
+ * Fica num lugar só porque é ele que o modelo lê para decidir o caminho: se cada tool
+ * descrevesse as modalidades com palavras próprias, o agente escolheria diferente em cada
+ * uma, e a mais barata (`fileId`) perderia para a mais cara (`fileBase64`) por acidente
+ * de redação.
+ */
+/** As quatro origens, em ordem de preferência. */
+export declare const FILE_SOURCE_FIELDS: readonly ["fileId", "uploadId", "fileUrl", "fileBase64"];
+export type FileSourceModality = (typeof FILE_SOURCE_FIELDS)[number];
+/**
+ * Propriedades para espalhar no `inputSchema` da tool.
+ *
+ * Nenhuma delas entra em `required`: a exigência é "exatamente uma", que JSON Schema
+ * expressaria com `oneOf` mas que nem todo cliente MCP avalia — a checagem de verdade
+ * está em `McpFileSourceService.detectModality`, e a descrição abaixo é o que faz o
+ * modelo acertar antes de chamar.
+ */
+export declare const FILE_SOURCE_SCHEMA_PROPERTIES: Record<string, any>;
+/**
+ * Bloco anexado à descrição de cada tool.
+ *
+ * Diz o teto real — `storage-max-size`, 10 MB por padrão. A descrição antiga de
+ * `finance.titles.attachments.add` anunciava ~37 MB, número derivado do
+ * `api-body-size-limit`; ele nunca valeu, porque quem barra primeiro é o
+ * `storage-max-size`, e é ele que aparece na mensagem de erro.
+ */
+export declare const FILE_SOURCE_DESCRIPTION: string;
+/** Junta a descrição própria da tool com o bloco comum. */
+export declare const withFileSourceDescription: (description: string) => string;
+//# sourceMappingURL=mcp-file-source.schema.d.ts.map

package/dist/file/mcp-file-source.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-file-source.schema.d.ts","sourceRoot":"","sources":["../../src/file/mcp-file-source.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,0DAKrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAmC7D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,QAKzB,CAAC;AAEZ,2DAA2D;AAC3D,eAAO,MAAM,yBAAyB,GAAI,aAAa,MAAM,KAAG,MACZ,CAAC"}

package/dist/file/mcp-file-source.schema.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Fragmento de schema e texto de descrição que toda tool MCP que recebe arquivo espalha
+ * no seu `inputSchema`.
+ *
+ * Fica num lugar só porque é ele que o modelo lê para decidir o caminho: se cada tool
+ * descrevesse as modalidades com palavras próprias, o agente escolheria diferente em cada
+ * uma, e a mais barata (`fileId`) perderia para a mais cara (`fileBase64`) por acidente
+ * de redação.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withFileSourceDescription = exports.FILE_SOURCE_DESCRIPTION = exports.FILE_SOURCE_SCHEMA_PROPERTIES = exports.FILE_SOURCE_FIELDS = void 0;
+/** As quatro origens, em ordem de preferência. */
+exports.FILE_SOURCE_FIELDS = [
+    'fileId',
+    'uploadId',
+    'fileUrl',
+    'fileBase64',
+];
+/**
+ * Propriedades para espalhar no `inputSchema` da tool.
+ *
+ * Nenhuma delas entra em `required`: a exigência é "exatamente uma", que JSON Schema
+ * expressaria com `oneOf` mas que nem todo cliente MCP avalia — a checagem de verdade
+ * está em `McpFileSourceService.detectModality`, e a descrição abaixo é o que faz o
+ * modelo acertar antes de chamar.
+ */
+exports.FILE_SOURCE_SCHEMA_PROPERTIES = {
+    fileId: {
+        type: 'number',
+        description: 'Preferred. ID of a file already in storage (from core.files.list, an attachments list, or core.files.upload.complete). Must have been uploaded by the caller, unless the caller is an administrator.',
+    },
+    uploadId: {
+        type: 'number',
+        description: 'ID returned by core.files.create-upload-url or core.files.upload.init, after the binary has been uploaded. Use this to send a file that is on disk without putting its bytes in the conversation.',
+    },
+    fileUrl: {
+        type: 'string',
+        description: 'Public http(s) URL the server downloads by itself. Private, loopback, link-local and cloud metadata addresses are rejected, redirects are limited, and the content type is checked against the actual bytes.',
+    },
+    fileBase64: {
+        type: 'string',
+        description: 'Base64-encoded content, sent inline. Only for small files (about 256kb): base64 of anything larger overflows the model output limit. Requires fileName and mimeType.',
+    },
+    fileName: {
+        type: 'string',
+        description: 'Original file name. Required with fileBase64; optional with fileUrl.',
+    },
+    mimeType: {
+        type: 'string',
+        description: 'MIME type, e.g. application/pdf. Required with fileBase64; optional with fileUrl. Must be allowed by the storage-accept-mimetype setting, and is verified against the real content.',
+    },
+    sha256: {
+        type: 'string',
+        description: 'Optional hex sha256 of the file. When present, content that does not hash to it is rejected.',
+    },
+};
+/**
+ * Bloco anexado à descrição de cada tool.
+ *
+ * Diz o teto real — `storage-max-size`, 10 MB por padrão. A descrição antiga de
+ * `finance.titles.attachments.add` anunciava ~37 MB, número derivado do
+ * `api-body-size-limit`; ele nunca valeu, porque quem barra primeiro é o
+ * `storage-max-size`, e é ele que aparece na mensagem de erro.
+ */
+exports.FILE_SOURCE_DESCRIPTION = [
+    'Exactly one file source is required: fileId, uploadId, fileUrl or fileBase64.',
+    'Prefer fileId; use fileBase64 only for files of a few hundred kilobytes, since the encoded content has to fit in a single tool call.',
+    'To send a local file without putting it in the conversation, call core.files.create-upload-url, PUT the binary to the URL it returns, call core.files.upload.complete, and pass the resulting fileId here.',
+    'Every path enforces the storage-accept-mimetype and storage-max-size settings (10mb by default).',
+].join(' ');
+/** Junta a descrição própria da tool com o bloco comum. */
+const withFileSourceDescription = (description) => `${description.trim()} ${exports.FILE_SOURCE_DESCRIPTION}`;
+exports.withFileSourceDescription = withFileSourceDescription;
+//# sourceMappingURL=mcp-file-source.schema.js.map

package/dist/file/mcp-file-source.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-file-source.schema.js","sourceRoot":"","sources":["../../src/file/mcp-file-source.schema.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,kDAAkD;AACrC,QAAA,kBAAkB,GAAG;IAChC,QAAQ;IACR,UAAU;IACV,SAAS;IACT,YAAY;CACJ,CAAC;AAIX;;;;;;;GAOG;AACU,QAAA,6BAA6B,GAAwB;IAChE,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,sMAAsM;KACzM;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,mMAAmM;KACtM;IACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,8MAA8M;KACjN;IACD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,sKAAsK;KACzK;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sEAAsE;KACpF;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,qLAAqL;KACxL;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,8FAA8F;KACjG;CACF,CAAC;AAEF;;;;;;;GAOG;AACU,QAAA,uBAAuB,GAAG;IACrC,+EAA+E;IAC/E,sIAAsI;IACtI,4MAA4M;IAC5M,kGAAkG;CACnG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,2DAA2D;AACpD,MAAM,yBAAyB,GAAG,CAAC,WAAmB,EAAU,EAAE,CACvE,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,+BAAuB,EAAE,CAAC;AADxC,QAAA,yBAAyB,6BACe"}

package/dist/file/mcp-file-source.service.d.ts

@@ -0,0 +1,124 @@
+import { PrismaService } from '@hed-hog/api-prisma';
+import { SettingService } from '../setting/setting.service';
+import { FileUploadTicketService } from './file-upload-ticket.service';
+import { FileService } from './file.service';
+import { FileSourceModality } from './mcp-file-source.schema';
+/**
+ * Normaliza as quatro origens de arquivo que uma tool MCP pode receber.
+ *
+ * Existe para que validação, sniffing de mimetype, auditoria e idempotência morem num
+ * ponto só. A alternativa — cada tool tratando as quatro origens por conta — garantiria
+ * que mais cedo ou mais tarde um caminho novo escapasse do `storage-accept-mimetype` ou
+ * da checagem de dono, e ninguém perceberia até virar incidente.
+ *
+ * Duas portas de saída, porque as tools consomem o arquivo de formas diferentes:
+ *
+ *   - `resolveFileId`     para quem persiste o anexo e só precisa do id;
+ *   - `resolveMulterFile` para quem quer os bytes e não guarda nada (importar extrato,
+ *                         extrair dados de uma nota com IA).
+ */
+export interface FileSourceArgs {
+    fileId?: number;
+    uploadId?: number;
+    fileUrl?: string;
+    fileBase64?: string;
+    fileName?: string;
+    mimeType?: string;
+    sha256?: string;
+    [key: string]: any;
+}
+export interface FileSourceContext {
+    userId: number;
+    toolName?: string;
+}
+export interface ResolveOptions {
+    /** Pasta no storage para as origens que ainda não têm arquivo gravado. */
+    destination: string;
+    isPrivate?: boolean;
+    /** `false` deixa a tool seguir sem arquivo (o extract-from-file aceita isso). */
+    required?: boolean;
+}
+export interface ResolvedFileSource {
+    fileId: number;
+    modality: FileSourceModality;
+    filename: string;
+    mimetype: string;
+    size: number;
+}
+export interface ResolvedFileContent {
+    file: MulterFile;
+    modality: FileSourceModality;
+    /** Preenchido quando a origem já era um arquivo armazenado. */
+    fileId?: number;
+}
+export declare class McpFileSourceService {
+    private readonly prismaService;
+    private readonly fileService;
+    private readonly uploadTickets;
+    private readonly settingService;
+    private readonly logger;
+    constructor(prismaService: PrismaService, fileService: FileService, uploadTickets: FileUploadTicketService, settingService: SettingService);
+    /**
+     * Qual origem veio, exigindo exatamente uma.
+     *
+     * Aceitar duas e escolher a "melhor" seria pior do que recusar: a chamada teria dois
+     * arquivos possíveis e o resultado dependeria de uma precedência que ninguém leu.
+     */
+    detectModality(args: FileSourceArgs, required?: boolean): FileSourceModality | null;
+    private maxBytes;
+    private allowedUrlHosts;
+    /**
+     * Valida um buffer que ainda não está no storage: tamanho, tipo declarado, tipo real e
+     * sha256 quando informado.
+     *
+     * `acceptMimetypes` sozinho não basta — ele compara a string que o cliente mandou com a
+     * allowlist, então um executável declarado como `application/pdf` passaria. O sniff é o
+     * contraditório dessa declaração.
+     */
+    private assertBufferAcceptable;
+    private toMulterFile;
+    private decodeBase64;
+    private fetchFromUrl;
+    /**
+     * Normaliza qualquer origem para um `fileId`.
+     *
+     * `fileId` e `uploadId` não regravam nada — o arquivo já está lá. `fileUrl` e
+     * `fileBase64` gravam, com o dono registrado, e é por isso que o `fileId` devolvido
+     * pode ser reaproveitado numa chamada seguinte sem novo upload.
+     */
+    resolveFileId(args: FileSourceArgs, context: FileSourceContext, options: ResolveOptions & {
+        required?: true;
+    }): Promise<ResolvedFileSource>;
+    resolveFileId(args: FileSourceArgs, context: FileSourceContext, options: ResolveOptions & {
+        required: false;
+    }): Promise<ResolvedFileSource | null>;
+    /**
+     * Normaliza qualquer origem para os bytes, sem gravar quando não é preciso.
+     *
+     * `fileId`/`uploadId` leem do storage; `fileUrl`/`fileBase64` ficam em memória — a tool
+     * que só quer ler um extrato não deve encher o acervo de arquivos que ninguém mais vai
+     * abrir.
+     */
+    resolveMulterFile(args: FileSourceArgs, context: FileSourceContext, options: Omit<ResolveOptions, 'destination'> & {
+        destination?: string;
+        required?: true;
+    }): Promise<ResolvedFileContent>;
+    resolveMulterFile(args: FileSourceArgs, context: FileSourceContext, options: Omit<ResolveOptions, 'destination'> & {
+        destination?: string;
+        required: false;
+    }): Promise<ResolvedFileContent | null>;
+    /**
+     * Registra a ingestão em `audit_log`, com a modalidade usada.
+     *
+     * `audit_log` é tabela global (só o finance escrevia nela até aqui, mas ela não é do
+     * finance), e `finance.audit-logs.list` já a lê sem filtrar por library — então a
+     * trilha das quatro modalidades fica visível por um caminho que já existe.
+     *
+     * Nunca derruba a operação: auditoria que falha e leva o anexo junto troca um problema
+     * de observabilidade por um de funcionamento.
+     */
+    private recordIngest;
+    /** Quanto do arquivo basta para reconhecer o tipo — reexportado para os testes. */
+    static readonly SNIFF_BYTES = 4096;
+}
+//# sourceMappingURL=mcp-file-source.service.d.ts.map

package/dist/file/mcp-file-source.service.d.ts.map

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

package/dist/file/mcp-file-source.service.js

@@ -0,0 +1,262 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var McpFileSourceService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpFileSourceService = void 0;
+const api_prisma_1 = require("@hed-hog/api-prisma");
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const setting_service_1 = require("../setting/setting.service");
+const file_upload_ticket_service_1 = require("./file-upload-ticket.service");
+const file_service_1 = require("./file.service");
+const mcp_file_source_schema_1 = require("./mcp-file-source.schema");
+const mimetype_sniff_util_1 = require("./mimetype-sniff.util");
+const remote_fetch_util_1 = require("./remote-fetch.util");
+let McpFileSourceService = McpFileSourceService_1 = class McpFileSourceService {
+    constructor(prismaService, fileService, uploadTickets, settingService) {
+        this.prismaService = prismaService;
+        this.fileService = fileService;
+        this.uploadTickets = uploadTickets;
+        this.settingService = settingService;
+        this.logger = new common_1.Logger(McpFileSourceService_1.name);
+    }
+    /**
+     * Qual origem veio, exigindo exatamente uma.
+     *
+     * Aceitar duas e escolher a "melhor" seria pior do que recusar: a chamada teria dois
+     * arquivos possíveis e o resultado dependeria de uma precedência que ninguém leu.
+     */
+    detectModality(args, required = true) {
+        const present = mcp_file_source_schema_1.FILE_SOURCE_FIELDS.filter((field) => {
+            const value = args === null || args === void 0 ? void 0 : args[field];
+            return value !== undefined && value !== null && value !== '';
+        });
+        if (present.length > 1) {
+            throw new common_1.BadRequestException(`Provide exactly one file source, got ${present.length}: ${present.join(', ')}`);
+        }
+        if (present.length === 0) {
+            if (required) {
+                throw new common_1.BadRequestException(`A file source is required: one of ${mcp_file_source_schema_1.FILE_SOURCE_FIELDS.join(', ')}`);
+            }
+            return null;
+        }
+        return present[0];
+    }
+    async maxBytes() {
+        const settings = await this.settingService.getSettingValues(['storage-max-size']);
+        return Number(settings['storage-max-size']) || 10485760;
+    }
+    async allowedUrlHosts() {
+        const settings = await this.settingService.getSettingValues([
+            'mcp-file-url-allowed-hosts',
+        ]);
+        const raw = settings['mcp-file-url-allowed-hosts'];
+        return String(raw !== null && raw !== void 0 ? raw : '')
+            .split(',')
+            .map((host) => host.trim())
+            .filter(Boolean);
+    }
+    /**
+     * Valida um buffer que ainda não está no storage: tamanho, tipo declarado, tipo real e
+     * sha256 quando informado.
+     *
+     * `acceptMimetypes` sozinho não basta — ele compara a string que o cliente mandou com a
+     * allowlist, então um executável declarado como `application/pdf` passaria. O sniff é o
+     * contraditório dessa declaração.
+     */
+    async assertBufferAcceptable(buffer, mimetype, expectedSha256) {
+        const maxBytes = await this.maxBytes();
+        if (buffer.length === 0) {
+            throw new common_1.BadRequestException(`File content is empty`);
+        }
+        if (buffer.length > maxBytes) {
+            throw new common_1.BadRequestException(`File too large: ${buffer.length} bytes. The storage-max-size setting allows ${maxBytes}.`);
+        }
+        if (!(await this.fileService.acceptMimetypes(mimetype))) {
+            throw new common_1.BadRequestException(`Invalid file type: ${mimetype}`);
+        }
+        const conflict = (0, mimetype_sniff_util_1.findMimetypeConflict)(mimetype, buffer);
+        if (conflict) {
+            throw new common_1.BadRequestException(`Declared mimeType ${mimetype} but the content is ${conflict}`);
+        }
+        if (expectedSha256) {
+            const actual = (0, crypto_1.createHash)('sha256').update(buffer).digest('hex');
+            if (actual.toLowerCase() !== expectedSha256.toLowerCase()) {
+                throw new common_1.BadRequestException(`sha256 mismatch: declared ${expectedSha256}, content hashes to ${actual}`);
+            }
+        }
+    }
+    toMulterFile(buffer, filename, mimetype) {
+        return {
+            fieldname: 'file',
+            originalname: filename,
+            encoding: '7bit',
+            mimetype,
+            size: buffer.length,
+            destination: '',
+            filename,
+            path: '',
+            buffer,
+        };
+    }
+    decodeBase64(args) {
+        if (!args.fileName || !args.mimeType) {
+            throw new common_1.BadRequestException(`fileBase64 requires fileName and mimeType`);
+        }
+        const buffer = Buffer.from(String(args.fileBase64), 'base64');
+        // `Buffer.from(x, 'base64')` nunca reclama: entrada inválida vira bytes truncados em
+        // silêncio. Reencodar e comparar é o que separa um base64 verdadeiro de um texto
+        // qualquer que o modelo tenha emitido no lugar.
+        if (buffer.length === 0) {
+            throw new common_1.BadRequestException(`fileBase64 decoded to zero bytes`);
+        }
+        const normalized = String(args.fileBase64).replace(/\s/g, '');
+        if (buffer.toString('base64').replace(/=+$/, '') !== normalized.replace(/=+$/, '')) {
+            throw new common_1.BadRequestException(`fileBase64 is not valid base64 (it may have been truncated in transit)`);
+        }
+        return { buffer, filename: args.fileName, mimetype: args.mimeType };
+    }
+    async fetchFromUrl(args) {
+        const result = await (0, remote_fetch_util_1.fetchRemoteFile)(String(args.fileUrl), {
+            maxBytes: await this.maxBytes(),
+            allowedHosts: await this.allowedUrlHosts(),
+        });
+        // Nome e tipo declarados ganham do que o servidor remoto disse: quem chama sabe o que
+        // pediu, e o `Content-Type` de um link de compartilhamento costuma vir genérico. O
+        // conteúdo real ainda é conferido depois, contra o que tiver sobrado aqui.
+        const fallbackName = decodeURIComponent(new URL(result.finalUrl).pathname.split('/').pop() || '') ||
+            'download';
+        return {
+            buffer: result.buffer,
+            filename: args.fileName || fallbackName,
+            mimetype: args.mimeType || result.contentType || 'application/octet-stream',
+            host: result.finalHost,
+        };
+    }
+    async resolveFileId(args, context, options) {
+        var _a, _b;
+        const modality = this.detectModality(args, options.required !== false);
+        if (!modality) {
+            return null;
+        }
+        let file;
+        let sourceHost;
+        if (modality === 'fileId') {
+            file = await this.fileService.assertFileUsable(Number(args.fileId), context.userId);
+        }
+        else if (modality === 'uploadId') {
+            file = await this.uploadTickets.complete(Number(args.uploadId), context.userId);
+        }
+        else {
+            const fetched = modality === 'fileUrl'
+                ? await this.fetchFromUrl(args)
+                : this.decodeBase64(args);
+            sourceHost = fetched.host;
+            await this.assertBufferAcceptable(fetched.buffer, fetched.mimetype, args.sha256);
+            file = await this.fileService.upload(options.destination, this.toMulterFile(fetched.buffer, fetched.filename, fetched.mimetype), undefined, {
+                isPrivate: (_a = options.isPrivate) !== null && _a !== void 0 ? _a : false,
+                createdByUserId: context.userId,
+            });
+        }
+        const resolved = {
+            fileId: file.id,
+            modality,
+            filename: file.filename,
+            mimetype: await this.fileService.mimetypeNameById(file.mimetype_id),
+            size: (_b = file.size) !== null && _b !== void 0 ? _b : 0,
+        };
+        await this.recordIngest(resolved, context, sourceHost);
+        return resolved;
+    }
+    async resolveMulterFile(args, context, options) {
+        const modality = this.detectModality(args, options.required !== false);
+        if (!modality) {
+            return null;
+        }
+        if (modality === 'fileId' || modality === 'uploadId') {
+            const stored = modality === 'fileId'
+                ? await this.fileService.assertFileUsable(Number(args.fileId), context.userId)
+                : await this.uploadTickets.complete(Number(args.uploadId), context.userId);
+            const buffer = await this.fileService.bufferById(stored.id, await this.maxBytes());
+            const mimetype = await this.fileService.mimetypeNameById(stored.mimetype_id);
+            await this.recordIngest({
+                fileId: stored.id,
+                modality,
+                filename: stored.filename,
+                mimetype,
+                size: buffer.length,
+            }, context);
+            return {
+                file: this.toMulterFile(buffer, stored.filename, mimetype),
+                modality,
+                fileId: stored.id,
+            };
+        }
+        const fetched = modality === 'fileUrl' ? await this.fetchFromUrl(args) : this.decodeBase64(args);
+        await this.assertBufferAcceptable(fetched.buffer, fetched.mimetype, args.sha256);
+        await this.recordIngest({
+            fileId: 0,
+            modality,
+            filename: fetched.filename,
+            mimetype: fetched.mimetype,
+            size: fetched.buffer.length,
+        }, context, fetched.host);
+        return {
+            file: this.toMulterFile(fetched.buffer, fetched.filename, fetched.mimetype),
+            modality,
+        };
+    }
+    /**
+     * Registra a ingestão em `audit_log`, com a modalidade usada.
+     *
+     * `audit_log` é tabela global (só o finance escrevia nela até aqui, mas ela não é do
+     * finance), e `finance.audit-logs.list` já a lê sem filtrar por library — então a
+     * trilha das quatro modalidades fica visível por um caminho que já existe.
+     *
+     * Nunca derruba a operação: auditoria que falha e leva o anexo junto troca um problema
+     * de observabilidade por um de funcionamento.
+     */
+    async recordIngest(resolved, context, sourceHost) {
+        var _a;
+        try {
+            await this.prismaService.audit_log.create({
+                data: {
+                    actor_user_id: context.userId || null,
+                    action: 'MCP_FILE_INGEST',
+                    entity_table: 'file',
+                    entity_id: String(resolved.fileId || ''),
+                    summary: `Ingested ${resolved.filename} via ${resolved.modality}${context.toolName ? ` for ${context.toolName}` : ''}`,
+                    after_data: JSON.stringify(Object.assign({ modality: resolved.modality, tool: (_a = context.toolName) !== null && _a !== void 0 ? _a : null, file_id: resolved.fileId || null, filename: resolved.filename, mimetype: resolved.mimetype, bytes: resolved.size }, (sourceHost ? { source_host: sourceHost } : {}))),
+                },
+            });
+        }
+        catch (error) {
+            this.logger.warn(`Failed to record MCP file ingest: ${error.message}`);
+        }
+    }
+};
+exports.McpFileSourceService = McpFileSourceService;
+/** Quanto do arquivo basta para reconhecer o tipo — reexportado para os testes. */
+McpFileSourceService.SNIFF_BYTES = mimetype_sniff_util_1.MIMETYPE_SNIFF_BYTES;
+exports.McpFileSourceService = McpFileSourceService = McpFileSourceService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)((0, common_1.forwardRef)(() => file_service_1.FileService))),
+    __param(2, (0, common_1.Inject)((0, common_1.forwardRef)(() => file_upload_ticket_service_1.FileUploadTicketService))),
+    __param(3, (0, common_1.Inject)((0, common_1.forwardRef)(() => setting_service_1.SettingService))),
+    __metadata("design:paramtypes", [api_prisma_1.PrismaService,
+        file_service_1.FileService,
+        file_upload_ticket_service_1.FileUploadTicketService,
+        setting_service_1.SettingService])
+], McpFileSourceService);
+//# sourceMappingURL=mcp-file-source.service.js.map

package/dist/file/mcp-file-source.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-file-source.service.js","sourceRoot":"","sources":["../../src/file/mcp-file-source.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAoD;AACpD,2CAMwB;AACxB,mCAAoC;AACpC,gEAA4D;AAC5D,6EAAuE;AACvE,iDAA6C;AAC7C,qEAGkC;AAClC,+DAAmF;AACnF,2DAAsD;AAyD/C,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAG/B,YACmB,aAA4B,EAE7C,WAAyC,EAEzC,aAAuD,EAEvD,cAA+C;QAN9B,kBAAa,GAAb,aAAa,CAAe;QAE5B,gBAAW,GAAX,WAAW,CAAa;QAExB,kBAAa,GAAb,aAAa,CAAyB;QAEtC,mBAAc,GAAd,cAAc,CAAgB;QAThC,WAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAU7D,CAAC;IAEJ;;;;;OAKG;IACH,cAAc,CAAC,IAAoB,EAAE,QAAQ,GAAG,IAAI;QAClD,MAAM,OAAO,GAAG,2CAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YAClD,MAAM,KAAK,GAAG,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAG,KAAK,CAAC,CAAC;YAC5B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,4BAAmB,CAC3B,wCAAwC,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,4BAAmB,CAC3B,qCAAqC,2CAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAClF,OAAO,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC;YAC1D,4BAA4B;SAC7B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,4BAA4B,CAAC,CAAC;QAEnD,OAAO,MAAM,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,EAAE,CAAC;aACrB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,sBAAsB,CAClC,MAAc,EACd,QAAgB,EAChB,cAAuB;QAEvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,4BAAmB,CAAC,uBAAuB,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,4BAAmB,CAC3B,mBAAmB,MAAM,CAAC,MAAM,+CAA+C,QAAQ,GAAG,CAC3F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,4BAAmB,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,0CAAoB,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAExD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,4BAAmB,CAC3B,qBAAqB,QAAQ,uBAAuB,QAAQ,EAAE,CAC/D,CAAC;QACJ,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEjE,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1D,MAAM,IAAI,4BAAmB,CAC3B,6BAA6B,cAAc,uBAAuB,MAAM,EAAE,CAC3E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAEO,YAAY,CAClB,MAAc,EACd,QAAgB,EAChB,QAAgB;QAEhB,OAAO;YACL,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,QAAQ;YACtB,QAAQ,EAAE,MAAM;YAChB,QAAQ;YACR,IAAI,EAAE,MAAM,CAAC,MAAM;YACnB,WAAW,EAAE,EAAE;YACf,QAAQ;YACR,IAAI,EAAE,EAAE;YACR,MAAM;SACP,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,IAAoB;QACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,4BAAmB,CAC3B,2CAA2C,CAC5C,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE9D,qFAAqF;QACrF,iFAAiF;QACjF,gDAAgD;QAChD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,4BAAmB,CAAC,kCAAkC,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAE9D,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,4BAAmB,CAC3B,wEAAwE,CACzE,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IACtE,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,IAAoB;QAEpB,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAe,EAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YACzD,QAAQ,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE;YAC/B,YAAY,EAAE,MAAM,IAAI,CAAC,eAAe,EAAE;SAC3C,CAAC,CAAC;QAEH,sFAAsF;QACtF,mFAAmF;QACnF,2EAA2E;QAC3E,MAAM,YAAY,GAChB,kBAAkB,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC5E,UAAU,CAAC;QAEb,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,YAAY;YACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,WAAW,IAAI,0BAA0B;YAC3E,IAAI,EAAE,MAAM,CAAC,SAAS;SACvB,CAAC;IACJ,CAAC;IAsBD,KAAK,CAAC,aAAa,CACjB,IAAoB,EACpB,OAA0B,EAC1B,OAAuB;;QAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC;QAEvE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAS,CAAC;QACd,IAAI,UAA8B,CAAC;QAEnC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtF,CAAC;aAAM,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GACX,QAAQ,KAAK,SAAS;gBACpB,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAE9B,UAAU,GAAI,OAAe,CAAC,IAAI,CAAC;YAEnC,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAEjF,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAClC,OAAO,CAAC,WAAW,EACnB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EACrE,SAAS,EACT;gBACE,SAAS,EAAE,MAAA,OAAO,CAAC,SAAS,mCAAI,KAAK;gBACrC,eAAe,EAAE,OAAO,CAAC,MAAM;aAChC,CACF,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAuB;YACnC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,QAAQ;YACR,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC;YACnE,IAAI,EAAE,MAAA,IAAI,CAAC,IAAI,mCAAI,CAAC;SACrB,CAAC;QAEF,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEvD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAmBD,KAAK,CAAC,iBAAiB,CACrB,IAAoB,EACpB,OAA0B,EAC1B,OAAuE;QAEvE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC;QAEvE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,MAAM,GACV,QAAQ,KAAK,QAAQ;gBACnB,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC;gBAC9E,CAAC,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAE/E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAE7E,MAAM,IAAI,CAAC,YAAY,CACrB;gBACE,MAAM,EAAE,MAAM,CAAC,EAAE;gBACjB,QAAQ;gBACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ;gBACR,IAAI,EAAE,MAAM,CAAC,MAAM;aACpB,EACD,OAAO,CACR,CAAC;YAEF,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAC1D,QAAQ;gBACR,MAAM,EAAE,MAAM,CAAC,EAAE;aAClB,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GACX,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnF,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjF,MAAM,IAAI,CAAC,YAAY,CACrB;YACE,MAAM,EAAE,CAAC;YACT,QAAQ;YACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;SAC5B,EACD,OAAO,EACN,OAAe,CAAC,IAAI,CACtB,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;YAC3E,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACK,KAAK,CAAC,YAAY,CACxB,QAA4B,EAC5B,OAA0B,EAC1B,UAAmB;;QAEnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC;gBACxC,IAAI,EAAE;oBACJ,aAAa,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;oBACrC,MAAM,EAAE,iBAAiB;oBACzB,YAAY,EAAE,MAAM;oBACpB,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;oBACxC,OAAO,EAAE,YAAY,QAAQ,CAAC,QAAQ,QAAQ,QAAQ,CAAC,QAAQ,GAC7D,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAClD,EAAE;oBACF,UAAU,EAAE,IAAI,CAAC,SAAS,iBACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,IAAI,EAAE,MAAA,OAAO,CAAC,QAAQ,mCAAI,IAAI,EAC9B,OAAO,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI,EAChC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,KAAK,EAAE,QAAQ,CAAC,IAAI,IACjB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAClD;iBACH;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;;AA9WU,oDAAoB;AAgX/B,mFAAmF;AACnE,gCAAW,GAAG,0CAAoB,AAAvB,CAAwB;+BAjXxC,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,0BAAW,CAAC,CAAC,CAAA;IAErC,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,oDAAuB,CAAC,CAAC,CAAA;IAEjD,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,gCAAc,CAAC,CAAC,CAAA;qCALT,0BAAa;QAEf,0BAAW;QAET,oDAAuB;QAEtB,gCAAc;GAVtC,oBAAoB,CAkXhC"}

package/dist/file/mimetype-sniff.util.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Identifica o tipo real de um arquivo pelos primeiros bytes, para que o mimetype
+ * declarado por quem envia não seja a única palavra sobre o que está sendo gravado.
+ *
+ * Hoje o `Content-Type` do multipart é a fonte de verdade sempre que vem concreto
+ * (`resolveEffectiveMimetype` no `FileService` só recorre ao conteúdo quando o caller
+ * manda vazio ou `application/octet-stream`), então um executável enviado como
+ * `image/png` passa direto pelo `storage-accept-mimetype`. Nas origens novas do MCP o
+ * cliente escolhe livremente o `mimeType`, o que tornaria essa brecha trivial de usar.
+ *
+ * Cobre o conjunto de opções do `storage-accept-mimetype` e nada além: a função não é
+ * um detector geral, é o contraditório do que foi declarado. Quando o formato não está
+ * nesta lista ela devolve `null`, e quem chama mantém o tipo declarado — recusar o que
+ * não se sabe reconhecer barraria CSV, OFX e afins, que são justamente o insumo do
+ * `statements.import`.
+ *
+ * Não usa `file-type`: da v19 em diante o pacote é ESM puro e quebraria o build CJS
+ * destas libraries. Os formatos aqui têm assinatura estável e curta.
+ *
+ * Existem dois primos, e a diferença entre eles e este é de política, não de descuido:
+ * `cms/src/form/cms-form-file-sniffer.ts` e
+ * `operations/src/task-intake/task-intake-file-sniffer.ts` usam allowlist **fechada** —
+ * o que não é reconhecido é recusado — porque servem endpoints anônimos, onde o mimetype
+ * declarado não vale nada e o conjunto aceito é estreito (print e vídeo do problema).
+ * Aqui a política é aberta: o caminho é autenticado e precisa continuar aceitando CSV e
+ * OFX, que não têm assinatura, para o `finance.statements.import`. Unificar os três
+ * significaria parametrizar essa política através de uma fronteira de segurança, e
+ * afrouxar por acidente o endpoint anônimo é o risco que isso carrega — é mudança
+ * própria, não carona nesta.
+ */
+/** Quanto do início do arquivo basta para todas as assinaturas abaixo. */
+export declare const MIMETYPE_SNIFF_BYTES = 4096;
+/**
+ * Tipo real do conteúdo, ou `null` quando a assinatura não é reconhecida.
+ *
+ * Só precisa dos primeiros bytes — passe o cabeçalho quando o arquivo for grande, e
+ * nunca o arquivo inteiro só para chamar esta função.
+ */
+export declare function detectMimetypeFromBytes(buffer: Buffer): string | null;
+/**
+ * Confronta o tipo declarado com o que os bytes dizem.
+ *
+ * Devolve `null` quando não há conflito, ou uma descrição do que o conteúdo realmente é —
+ * é ela que a mensagem de erro mostra, porque "declarado X, conteúdo Y" é o que permite
+ * corrigir a chamada.
+ *
+ * A regra tem dois lados, e o segundo é o que fecha o buraco:
+ *
+ *   1. assinatura reconhecida que contradiz o declarado → conflito;
+ *   2. assinatura NÃO reconhecida, mas o tipo declarado é um dos verificáveis → também
+ *      conflito. Sem isso, bastaria declarar `application/pdf` num executável para
+ *      passar: ele não tem assinatura de PDF, mas também não tem nenhuma das que o
+ *      sniffer conhece, e "desconhecido" seria lido como "sem objeção".
+ *
+ * Conteúdo sem assinatura declarado como `text/csv` continua passando, que é o caso do
+ * `finance.statements.import`.
+ *
+ * ZIP merece nota: um `.docx` declarado como `application/zip` não é conflito, já que ele
+ * é literalmente um zip. O contrário também não, pelo mesmo motivo.
+ */
+export declare function findMimetypeConflict(declared: string, buffer: Buffer): string | null;
+//# sourceMappingURL=mimetype-sniff.util.d.ts.map

package/dist/file/mimetype-sniff.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype-sniff.util.d.ts","sourceRoot":"","sources":["../../src/file/mimetype-sniff.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,OAAO,CAAC;AA+CzC;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2DrE;AAkED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CA8Bf"}