@baruk/core 0.3.0 → 0.4.2

package/dist/cjs/rbac/workload.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Identidade e autorização de workload NÃO-HUMANO.
+ *
+ * O RBAC de `authorize.ts` responde "este USUÁRIO pode?". Nenhuma linha do
+ * repositório respondia "este PROCESSO pode?" — e a diferença não é
+ * acadêmica: o `TenantSecretStore` do lote C1A aceitava um `SecretAccessGrant`
+ * montado pelo próprio chamador. `principal`, `reason` e as datas eram strings
+ * e `Date`s sintaticamente válidas; qualquer módulo interno com acesso ao
+ * arquivo podia declará-las e pedir decifração. Isso é ATRIBUIÇÃO — serve para
+ * a trilha de auditoria e não serve como fronteira de segurança.
+ *
+ * Este módulo troca a declaração por três coisas que o chamador não consegue
+ * fabricar sozinho:
+ *
+ *  1. **Autenticação.** O workload apresenta um segredo próprio, verificado
+ *     contra `service_principal.secret_hash` (scrypt, o mesmo `verifyPassword`
+ *     da senha humana). Sem o segredo, não há identidade — e o segredo vive no
+ *     ambiente do deploy que roda AQUELE workload, não no código.
+ *
+ *  2. **Autorização fora do controlado.** A permissão vem de linhas em
+ *     `service_principal_grant`, e `baruk_app` tem apenas SELECT nessas tabelas
+ *     (`db/migrate.ts` §3). O processo que consome a autorização não consegue
+ *     escrevê-la: não é uma regra de tipo, é um privilégio do Postgres.
+ *
+ *  3. **Verificação por CHAMADA, dentro da transação.** A decisão não é
+ *     memorizada na composição. Revogar um principal ou um grant passa a valer
+ *     na próxima chamada, sem esperar o processo reiniciar.
+ *
+ * O objeto `WorkloadIdentity` é apenas o transporte da identidade JÁ
+ * autenticada. Ele é marcado com um símbolo privado deste módulo e registrado
+ * num `WeakSet` privado: um objeto estruturalmente idêntico, montado à mão em
+ * outro arquivo, é recusado. Mas a marca não é a fronteira — é a tranca da
+ * porta interna. A fronteira é o par (segredo, linha no banco).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKLOAD_PURPOSES = void 0;
+exports.authenticateWorkload = authenticateWorkload;
+exports.isMintedWorkloadIdentity = isMintedWorkloadIdentity;
+exports.assertMintedWorkloadIdentity = assertMintedWorkloadIdentity;
+exports.authorizeWorkload = authorizeWorkload;
+const shared_1 = require("@baruk/shared");
+const password_js_1 = require("../auth/password.js");
+exports.WORKLOAD_PURPOSES = [
+    'channel_dispatch',
+    'onboarding_seal',
+    'health_probe',
+];
+/**
+ * Marca privada. Não é exportada — logo, nenhum arquivo fora daqui consegue
+ * escrever esta propriedade de forma tipada, e `MINTED` recusa o objeto
+ * estruturalmente idêntico em tempo de execução.
+ */
+const WORKLOAD_BRAND = Symbol('baruk.workload-identity');
+const MINTED = new WeakSet();
+/** Sessão padrão: 1h. Um cron diário reautentica a cada execução; um worker, de hora em hora. */
+const DEFAULT_TTL_MS = 60 * 60 * 1000;
+/** Teto duro. Uma sessão de dias equivaleria a não ter janela nenhuma. */
+const MAX_TTL_MS = 12 * 60 * 60 * 1000;
+/**
+ * Hash descartável com o mesmo custo de um real. Existe para que "principal
+ * inexistente" e "segredo errado" levem o mesmo tempo — sem isso, a latência
+ * enumera quais principals existem.
+ */
+const DUMMY_HASH = `scrypt$16384$8$1$${'A'.repeat(22)}==$${'a'.repeat(86)}==`;
+/**
+ * Autentica um workload e emite a identidade da sessão.
+ *
+ * **Chame na RAIZ DE COMPOSIÇÃO** — o `main()` do cron, o bootstrap do worker,
+ * a borda de request já autenticada — e propague a identidade. Nenhum módulo de
+ * domínio deve chamar isto: quem PRECISA do segredo nunca deve ser quem
+ * declara ter direito a ele.
+ *
+ * Falha FECHADA e ruidosa: `UnauthorizedError`. Um workload que não autentica
+ * deve parar no boot, com o erro visível, não seguir e falhar seis passos
+ * depois como "canal indisponível".
+ *
+ * Roda FORA de contexto de tenant: `service_principal` é global, como `"user"`.
+ * A amarração ao tenant é da autorização (`authorizeWorkload`), não da identidade.
+ */
+async function authenticateWorkload(db, input) {
+    const key = input?.key?.trim() ?? '';
+    const secret = typeof input?.secret === 'string' ? input.secret : '';
+    if (!key)
+        throw new shared_1.ValidationError('key do service principal é obrigatória.');
+    if (!secret)
+        throw new shared_1.ValidationError('secret do service principal é obrigatório.');
+    const ttl = input.ttlMs ?? DEFAULT_TTL_MS;
+    if (!Number.isFinite(ttl) || ttl <= 0 || ttl > MAX_TTL_MS) {
+        throw new shared_1.ValidationError(`ttlMs fora da janela permitida (1..${MAX_TTL_MS}).`);
+    }
+    const rows = await db `
+    SELECT id, key, status, secret_hash
+    FROM service_principal
+    WHERE lower(key) = lower(${key}) AND deleted_at IS NULL
+  `;
+    const row = rows[0];
+    // Verifica SEMPRE — inclusive contra o hash descartável quando não há linha.
+    const matches = (0, password_js_1.verifyPassword)(secret, row?.secret_hash ?? DUMMY_HASH);
+    if (!row || row.status !== 'active' || !matches) {
+        throw new shared_1.UnauthorizedError('Workload não autenticado.');
+    }
+    const issuedAt = input.now ?? new Date();
+    const identity = {
+        principalId: row.id,
+        principalKey: row.key,
+        issuedAt,
+        expiresAt: new Date(issuedAt.getTime() + ttl),
+        [WORKLOAD_BRAND]: true,
+    };
+    MINTED.add(identity);
+    return identity;
+}
+/** O objeto veio de `authenticateWorkload`? Recusa qualquer imitação estrutural. */
+function isMintedWorkloadIdentity(value) {
+    return typeof value === 'object' && value !== null && MINTED.has(value);
+}
+/**
+ * Falha fechada quando a identidade não foi emitida aqui. Chamado por TODO
+ * consumidor antes de qualquer trabalho — um `ForbiddenError` no primeiro
+ * passo é a diferença entre uma tentativa recusada e um segredo entregue.
+ */
+function assertMintedWorkloadIdentity(value) {
+    if (!isMintedWorkloadIdentity(value)) {
+        throw new shared_1.ForbiddenError('WorkloadIdentity não emitida por authenticateWorkload — identidade forjada recusada.');
+    }
+}
+/**
+ * Decide se ESTE principal pode exercer ESTA permissão, NESTE tenant, para
+ * ESTE propósito, sobre ESTE recurso. Quatro dimensões conjuntivas.
+ *
+ * A quarta é o que fecha confused deputy: um workload legitimamente autorizado
+ * no tenant A a despachar canal não decifra a chave do gateway de pagamento do
+ * tenant A só porque um `credentialRef` vindo de input pediu. A autorização do
+ * workload nunca vira autorização para qualquer recurso que o input nomear.
+ *
+ * **DEVE rodar dentro de `withContext(db, { tenantId })`** — a RLS FORCE de
+ * `service_principal_grant` é a segunda camada; o predicado explícito de
+ * `tenant_id` é a primeira. As duas dizem a mesma coisa de propósito: nenhuma
+ * das duas sozinha é o desenho.
+ */
+async function authorizeWorkload(tx, identity, req) {
+    assertMintedWorkloadIdentity(identity);
+    const tenantId = req?.tenantId?.trim() ?? '';
+    const permission = req?.permission?.trim() ?? '';
+    const resource = req?.resource?.trim() ?? '';
+    const purpose = req?.purpose;
+    if (!tenantId || !permission || !resource || !exports.WORKLOAD_PURPOSES.includes(purpose)) {
+        return { allowed: false, denyReason: 'invalid_request' };
+    }
+    const now = req.now ?? new Date();
+    if (now.getTime() >= identity.expiresAt.getTime() ||
+        now.getTime() < identity.issuedAt.getTime()) {
+        return { allowed: false, denyReason: 'identity_expired' };
+    }
+    // Revogação vale AGORA, não no próximo boot: relê o principal a cada chamada.
+    const principal = await tx `
+    SELECT id FROM service_principal
+    WHERE id = ${identity.principalId} AND status = 'active' AND deleted_at IS NULL
+  `;
+    if (!principal[0]) {
+        return { allowed: false, denyReason: 'principal_unknown_or_disabled' };
+    }
+    // `left(...)` em vez de LIKE: o valor do prefixo é literal, e `_`/`%` são
+    // caracteres comuns em nome de credencial (`RESEND_API_KEY`). Um LIKE aqui
+    // transformaria um nome legítimo em curinga.
+    const grants = await tx `
+    SELECT id FROM service_principal_grant
+    WHERE tenant_id = ${tenantId}
+      AND principal_id = ${identity.principalId}
+      AND permission_key = ${permission}
+      AND purpose = ${purpose}
+      AND revoked_at IS NULL
+      AND deleted_at IS NULL
+      AND (expires_at IS NULL OR expires_at > ${now})
+      AND (
+        (resource_kind = 'exact' AND lower(resource_value) = lower(${resource}))
+        OR (
+          resource_kind = 'prefix'
+          AND left(lower(${resource}), length(lower(resource_value))) = lower(resource_value)
+        )
+      )
+    LIMIT 1
+  `;
+    const grant = grants[0];
+    if (!grant) {
+        return { allowed: false, denyReason: 'no_matching_grant' };
+    }
+    return { allowed: true, grantId: grant.id };
+}
+//# sourceMappingURL=workload.js.map

package/dist/cjs/rbac/workload.js.map

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

package/dist/cjs/storage/checksum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256Hex = sha256Hex;
+const node_crypto_1 = require("node:crypto");
+/**
+ * SHA-256 em hex minúsculo — a forma exigida pelo CHECK de `blob.checksum_sha256`.
+ *
+ * É o identificador de conteúdo que sustenta duas coisas na ADR 0007: a
+ * deduplicação por tenant e a prova de que a versão baixada é byte-idêntica à
+ * que foi enviada.
+ */
+function sha256Hex(data) {
+    return (0, node_crypto_1.createHash)('sha256').update(data).digest('hex');
+}
+//# sourceMappingURL=checksum.js.map

package/dist/cjs/storage/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../../src/storage/checksum.ts"],"names":[],"mappings":";;AASA,8BAEC;AAXD,6CAAyC;AAEzC;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,IAAgB;IACxC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/cjs/storage/key.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStorageKey = buildStorageKey;
+exports.sanitizeSegment = sanitizeSegment;
+exports.sanitizeFilename = sanitizeFilename;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Construção da chave de objeto (ADR 0007 D7).
+ *
+ * Formato:
+ *   {tenant_id}/{client_id}/{yyyy}/{mm}/{category}/{document_id}/{version}-{rand}
+ *
+ * Três propriedades que a forma garante:
+ *
+ * 1. **Tenant no primeiro segmento** — a fronteira fica legível no próprio
+ *    bucket e permite política de acesso por prefixo no provedor.
+ * 2. **Não previsível** — o sufixo aleatório impede que alguém que conheça os
+ *    ids enumere objetos. A URL assinada já expira, mas defesa em profundidade
+ *    custa 8 bytes.
+ * 3. **Sem nome de arquivo do cliente** — o `original_filename` vive na tabela
+ *    `document_version`, nunca na chave. Nome vindo do cliente não é identidade
+ *    de objeto e é o vetor clássico de path traversal.
+ */
+function buildStorageKey(input) {
+    const { tenantId, clientId, documentId, versionNo } = input;
+    // Competência dá a partição temporal quando existe; senão, a data corrente.
+    // O formato YYYY-MM já é validado no banco, então o split é seguro.
+    let yyyy;
+    let mm;
+    if (input.competenceLabel && /^\d{4}-\d{2}$/.test(input.competenceLabel)) {
+        [yyyy, mm] = input.competenceLabel.split('-');
+    }
+    else {
+        const now = new Date();
+        yyyy = String(now.getUTCFullYear());
+        mm = String(now.getUTCMonth() + 1).padStart(2, '0');
+    }
+    const category = sanitizeSegment(input.categoryKey ?? 'geral');
+    const rand = (0, node_crypto_1.randomBytes)(8).toString('hex');
+    return `${tenantId}/${clientId}/${yyyy}/${mm}/${category}/${documentId}/${versionNo}-${rand}`;
+}
+/**
+ * Reduz um segmento a `[a-z0-9_-]`. Qualquer outra coisa — inclusive `.` e `/` —
+ * é descartada, o que torna `../` impossível de construir por aqui.
+ */
+function sanitizeSegment(value) {
+    const cleaned = value
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/[^a-z0-9_-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 48);
+    return cleaned.length > 0 ? cleaned : 'geral';
+}
+/**
+ * Higieniza o nome exibido ao usuário. Não participa da chave de storage — é só
+ * o rótulo guardado em `document_version.original_filename` e devolvido no
+ * download. Remove diretório, controla o comprimento e recusa nome vazio.
+ */
+function sanitizeFilename(value) {
+    const base = value.split(/[\\/]/).pop() ?? '';
+    const cleaned = base
+        // eslint-disable-next-line no-control-regex
+        .replace(/[\u0000-\u001f\u007f]/g, '')
+        .replace(/^\.+/, '')
+        .trim()
+        .slice(0, 180);
+    return cleaned.length > 0 ? cleaned : 'arquivo';
+}
+//# sourceMappingURL=key.js.map

package/dist/cjs/storage/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../../src/storage/key.ts"],"names":[],"mappings":";;AAmBA,0CA0BC;AAMD,0CAUC;AAOD,4CASC;AA7ED,6CAA0C;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAAC,KAO/B;IACC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAE5D,4EAA4E;IAC5E,oEAAoE;IACpE,IAAI,IAAY,CAAC;IACjB,IAAI,EAAU,CAAC;IACf,IAAI,KAAK,CAAC,eAAe,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;QACzE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;QACpC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAA,yBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE5C,OAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,IAAI,IAAI,EAAE,IAAI,QAAQ,IAAI,UAAU,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;AAChG,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK;SAClB,WAAW,EAAE;SACb,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI;QAClB,4CAA4C;SAC3C,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC;SACrC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/dist/cjs/storage/local.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStorageProvider = void 0;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const types_js_1 = require("./types.js");
+const checksum_js_1 = require("./checksum.js");
+/**
+ * Provider de sistema de arquivos — o default seguro (ADR 0007 D4).
+ *
+ * Usado em desenvolvimento e em toda a suíte de testes: nenhum teste depende de
+ * R2 real, o que mantém o CI offline e determinístico.
+ *
+ * A "URL assinada" aqui é um caminho relativo da própria API com token HMAC e
+ * expiração — mesma semântica do presigned do R2 (link temporário, sem
+ * credencial embutida), servido pelo backend em vez do provedor.
+ */
+class LocalStorageProvider {
+    key = 'local';
+    root;
+    signingSecret;
+    constructor(options) {
+        this.root = (0, node_path_1.resolve)(options.rootDir);
+        this.signingSecret = options.signingSecret;
+    }
+    /**
+     * Resolve a chave para um caminho absoluto e recusa qualquer coisa que escape
+     * da raiz. A chave já é construída por `buildStorageKey`, mas este guard não
+     * confia nisso: um provider de storage é o último lugar onde se deve supor
+     * que a entrada é boa.
+     */
+    pathFor(key) {
+        if (key.includes('\0'))
+            throw new types_js_1.StorageError('chave inválida', 'invalid');
+        const target = (0, node_path_1.resolve)((0, node_path_1.join)(this.root, (0, node_path_1.normalize)(key)));
+        if (target !== this.root && !target.startsWith(this.root + node_path_1.sep)) {
+            throw new types_js_1.StorageError('chave fora da raiz de storage', 'invalid');
+        }
+        return target;
+    }
+    async put(input) {
+        const target = this.pathFor(input.key);
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)(target), { recursive: true });
+        await (0, promises_1.writeFile)(target, input.body);
+        return {
+            key: input.key,
+            checksumSha256: (0, checksum_js_1.sha256Hex)(input.body),
+            sizeBytes: input.body.byteLength,
+        };
+    }
+    async getSignedUrl(key, options) {
+        const ttl = options?.expiresInSeconds ?? types_js_1.DEFAULT_SIGNED_URL_TTL_SECONDS;
+        const expiresAt = Math.floor(Date.now() / 1000) + ttl;
+        const signature = this.sign(key, expiresAt);
+        const params = new URLSearchParams({ key, expires: String(expiresAt), sig: signature });
+        if (options?.downloadFilename)
+            params.set('filename', options.downloadFilename);
+        return `/v1/documents/blob?${params.toString()}`;
+    }
+    async head(key) {
+        try {
+            const info = await (0, promises_1.stat)(this.pathFor(key));
+            return { exists: true, sizeBytes: info.size };
+        }
+        catch {
+            return { exists: false };
+        }
+    }
+    async delete(key) {
+        await (0, promises_1.rm)(this.pathFor(key), { force: true });
+    }
+    /** Lê o objeto. Só o LocalStorageProvider expõe isso — o R2 serve direto. */
+    async read(key) {
+        try {
+            return new Uint8Array(await (0, promises_1.readFile)(this.pathFor(key)));
+        }
+        catch {
+            throw new types_js_1.StorageError('objeto não encontrado', 'not-found');
+        }
+    }
+    sign(key, expiresAt) {
+        return (0, node_crypto_1.createHmac)('sha256', this.signingSecret).update(`${key}:${expiresAt}`).digest('hex');
+    }
+    /**
+     * Valida assinatura e expiração. Comparação em tempo constante — um HMAC
+     * comparado com `===` vaza o prefixo correto byte a byte.
+     */
+    verifySignature(key, expiresAt, signature) {
+        if (!Number.isFinite(expiresAt) || expiresAt < Math.floor(Date.now() / 1000))
+            return false;
+        const expected = Buffer.from(this.sign(key, expiresAt), 'utf8');
+        const received = Buffer.from(signature, 'utf8');
+        if (expected.length !== received.length)
+            return false;
+        return (0, node_crypto_1.timingSafeEqual)(expected, received);
+    }
+}
+exports.LocalStorageProvider = LocalStorageProvider;
+//# sourceMappingURL=local.js.map

package/dist/cjs/storage/local.js.map

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

package/dist/cjs/storage/r2.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R2StorageProvider = void 0;
+const node_crypto_1 = require("node:crypto");
+const types_js_1 = require("./types.js");
+const checksum_js_1 = require("./checksum.js");
+const SERVICE = 's3';
+const UNSIGNED_PAYLOAD = 'UNSIGNED-PAYLOAD';
+class R2StorageProvider {
+    key = 'r2';
+    cfg;
+    fetchImpl;
+    host;
+    constructor(config) {
+        if (!config.accountId || !config.accessKeyId || !config.secretAccessKey || !config.bucket) {
+            throw new types_js_1.StorageError('configuração R2 incompleta', 'invalid');
+        }
+        this.cfg = {
+            accountId: config.accountId,
+            accessKeyId: config.accessKeyId,
+            secretAccessKey: config.secretAccessKey,
+            bucket: config.bucket,
+            region: config.region ?? 'auto',
+        };
+        this.fetchImpl = config.fetchImpl ?? fetch;
+        this.host = `${this.cfg.accountId}.r2.cloudflarestorage.com`;
+    }
+    objectUrl(key) {
+        return `https://${this.host}/${this.cfg.bucket}/${encodeKey(key)}`;
+    }
+    async put(input) {
+        const url = this.objectUrl(input.key);
+        const payloadHash = (0, node_crypto_1.createHash)('sha256').update(input.body).digest('hex');
+        const headers = this.signedHeaders('PUT', new URL(url), payloadHash, {
+            'content-type': input.contentType,
+            'content-length': String(input.body.byteLength),
+        });
+        const res = await this.fetchImpl(url, {
+            method: 'PUT',
+            headers,
+            body: input.body,
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!res.ok) {
+            throw new types_js_1.StorageError(`R2 recusou o upload (HTTP ${res.status})`, res.status === 403 ? 'denied' : 'unavailable');
+        }
+        return {
+            key: input.key,
+            checksumSha256: (0, checksum_js_1.sha256Hex)(input.body),
+            sizeBytes: input.body.byteLength,
+        };
+    }
+    /**
+     * Presigned GET por query string (SigV4). O link carrega a assinatura e a
+     * expiração — nunca a credencial.
+     */
+    async getSignedUrl(key, options) {
+        const expires = Math.min(options?.expiresInSeconds ?? types_js_1.DEFAULT_SIGNED_URL_TTL_SECONDS, 604_800);
+        const url = new URL(this.objectUrl(key));
+        const { amzDate, dateStamp } = timestamps();
+        const credentialScope = `${dateStamp}/${this.cfg.region}/${SERVICE}/aws4_request`;
+        url.searchParams.set('X-Amz-Algorithm', 'AWS4-HMAC-SHA256');
+        url.searchParams.set('X-Amz-Credential', `${this.cfg.accessKeyId}/${credentialScope}`);
+        url.searchParams.set('X-Amz-Date', amzDate);
+        url.searchParams.set('X-Amz-Expires', String(expires));
+        url.searchParams.set('X-Amz-SignedHeaders', 'host');
+        if (options?.downloadFilename) {
+            url.searchParams.set('response-content-disposition', `attachment; filename="${options.downloadFilename.replace(/"/g, '')}"`);
+        }
+        const canonicalRequest = [
+            'GET',
+            url.pathname,
+            canonicalQuery(url.searchParams),
+            `host:${this.host}\n`,
+            'host',
+            UNSIGNED_PAYLOAD,
+        ].join('\n');
+        const signature = this.calculateSignature(canonicalRequest, amzDate, dateStamp, credentialScope);
+        url.searchParams.set('X-Amz-Signature', signature);
+        return url.toString();
+    }
+    async head(key) {
+        const url = this.objectUrl(key);
+        const headers = this.signedHeaders('HEAD', new URL(url), UNSIGNED_PAYLOAD, {});
+        const res = await this.fetchImpl(url, {
+            method: 'HEAD',
+            headers,
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (res.status === 404)
+            return { exists: false };
+        if (!res.ok)
+            throw new types_js_1.StorageError(`R2 head falhou (HTTP ${res.status})`, 'unavailable');
+        const len = res.headers.get('content-length');
+        return {
+            exists: true,
+            sizeBytes: len ? Number(len) : undefined,
+            contentType: res.headers.get('content-type') ?? undefined,
+        };
+    }
+    async delete(key) {
+        const url = this.objectUrl(key);
+        const headers = this.signedHeaders('DELETE', new URL(url), UNSIGNED_PAYLOAD, {});
+        const res = await this.fetchImpl(url, {
+            method: 'DELETE',
+            headers,
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok && res.status !== 404) {
+            throw new types_js_1.StorageError(`R2 delete falhou (HTTP ${res.status})`, 'unavailable');
+        }
+    }
+    signedHeaders(method, url, payloadHash, extra) {
+        const { amzDate, dateStamp } = timestamps();
+        const credentialScope = `${dateStamp}/${this.cfg.region}/${SERVICE}/aws4_request`;
+        const headers = {
+            host: this.host,
+            'x-amz-content-sha256': payloadHash,
+            'x-amz-date': amzDate,
+            ...extra,
+        };
+        const sortedKeys = Object.keys(headers)
+            .map((k) => k.toLowerCase())
+            .sort();
+        const canonicalHeaders = sortedKeys.map((k) => `${k}:${headers[k].trim()}\n`).join('');
+        const signedHeaderList = sortedKeys.join(';');
+        const canonicalRequest = [
+            method,
+            url.pathname,
+            canonicalQuery(url.searchParams),
+            canonicalHeaders,
+            signedHeaderList,
+            payloadHash,
+        ].join('\n');
+        const signature = this.calculateSignature(canonicalRequest, amzDate, dateStamp, credentialScope);
+        return {
+            ...headers,
+            authorization: `AWS4-HMAC-SHA256 Credential=${this.cfg.accessKeyId}/${credentialScope}, ` +
+                `SignedHeaders=${signedHeaderList}, Signature=${signature}`,
+        };
+    }
+    calculateSignature(canonicalRequest, amzDate, dateStamp, credentialScope) {
+        const stringToSign = [
+            'AWS4-HMAC-SHA256',
+            amzDate,
+            credentialScope,
+            (0, node_crypto_1.createHash)('sha256').update(canonicalRequest).digest('hex'),
+        ].join('\n');
+        const kDate = (0, node_crypto_1.createHmac)('sha256', `AWS4${this.cfg.secretAccessKey}`)
+            .update(dateStamp)
+            .digest();
+        const kRegion = (0, node_crypto_1.createHmac)('sha256', kDate).update(this.cfg.region).digest();
+        const kService = (0, node_crypto_1.createHmac)('sha256', kRegion).update(SERVICE).digest();
+        const kSigning = (0, node_crypto_1.createHmac)('sha256', kService).update('aws4_request').digest();
+        return (0, node_crypto_1.createHmac)('sha256', kSigning).update(stringToSign).digest('hex');
+    }
+}
+exports.R2StorageProvider = R2StorageProvider;
+function timestamps() {
+    const amzDate = new Date().toISOString().replace(/[:-]|\.\d{3}/g, '');
+    return { amzDate, dateStamp: amzDate.slice(0, 8) };
+}
+/** Cada segmento é codificado; a barra separadora, não. */
+function encodeKey(key) {
+    return key.split('/').map(encodeURIComponent).join('/');
+}
+/** SigV4 exige query ordenada e RFC3986-encoded. */
+function canonicalQuery(params) {
+    const pairs = [];
+    params.forEach((value, name) => {
+        if (name === 'X-Amz-Signature')
+            return;
+        pairs.push([name, value]);
+    });
+    pairs.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return pairs.map(([k, v]) => `${rfc3986(k)}=${rfc3986(v)}`).join('&');
+}
+function rfc3986(value) {
+    return encodeURIComponent(value).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+//# sourceMappingURL=r2.js.map

package/dist/cjs/storage/r2.js.map

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

package/dist/cjs/storage/registry.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveStorageProvider = resolveStorageProvider;
+exports.availableStorageProviders = availableStorageProviders;
+const local_js_1 = require("./local.js");
+const r2_js_1 = require("./r2.js");
+const types_js_1 = require("./types.js");
+function resolveStorageProvider(config = {}) {
+    const key = (config.provider ?? 'local').toLowerCase();
+    if (key === 'r2') {
+        const missing = [
+            ['DOCUMENTS_R2_ACCOUNT_ID', config.r2AccountId],
+            ['DOCUMENTS_R2_ACCESS_KEY_ID', config.r2AccessKeyId],
+            ['DOCUMENTS_R2_SECRET_ACCESS_KEY', config.r2SecretAccessKey],
+            ['DOCUMENTS_R2_BUCKET', config.r2Bucket],
+        ]
+            .filter(([, value]) => !value)
+            .map(([name]) => name);
+        if (missing.length > 0) {
+            // A mensagem nomeia as variáveis ausentes e nunca o valor de nenhuma.
+            throw new types_js_1.StorageError(`storage r2 selecionado mas a configuração está incompleta: ${missing.join(', ')}`, 'invalid');
+        }
+        return new r2_js_1.R2StorageProvider({
+            accountId: config.r2AccountId,
+            accessKeyId: config.r2AccessKeyId,
+            secretAccessKey: config.r2SecretAccessKey,
+            bucket: config.r2Bucket,
+        });
+    }
+    if (key === 'local') {
+        return new local_js_1.LocalStorageProvider({
+            rootDir: config.localRootDir ?? '.storage',
+            signingSecret: config.localSigningSecret ?? 'dev-only-signing-secret',
+        });
+    }
+    throw new types_js_1.StorageError(`storage provider desconhecido: ${key}`, 'invalid');
+}
+function availableStorageProviders() {
+    return ['local', 'r2'];
+}
+//# sourceMappingURL=registry.js.map

package/dist/cjs/storage/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/storage/registry.ts"],"names":[],"mappings":";;AAyBA,wDAuCC;AAED,8DAEC;AApED,yCAAkD;AAClD,mCAA4C;AAC5C,yCAAgE;AAuBhE,SAAgB,sBAAsB,CAAC,SAAwB,EAAE;IAC/D,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAEvD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,OAAO,GACX;YACE,CAAC,yBAAyB,EAAE,MAAM,CAAC,WAAW,CAAC;YAC/C,CAAC,4BAA4B,EAAE,MAAM,CAAC,aAAa,CAAC;YACpD,CAAC,gCAAgC,EAAE,MAAM,CAAC,iBAAiB,CAAC;YAC5D,CAAC,qBAAqB,EAAE,MAAM,CAAC,QAAQ,CAAC;SAE3C;aACE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;aAC7B,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAEzB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,sEAAsE;YACtE,MAAM,IAAI,uBAAY,CACpB,8DAA8D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAClF,SAAS,CACV,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,yBAAiB,CAAC;YAC3B,SAAS,EAAE,MAAM,CAAC,WAAY;YAC9B,WAAW,EAAE,MAAM,CAAC,aAAc;YAClC,eAAe,EAAE,MAAM,CAAC,iBAAkB;YAC1C,MAAM,EAAE,MAAM,CAAC,QAAS;SACzB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,+BAAoB,CAAC;YAC9B,OAAO,EAAE,MAAM,CAAC,YAAY,IAAI,UAAU;YAC1C,aAAa,EAAE,MAAM,CAAC,kBAAkB,IAAI,yBAAyB;SACtE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,uBAAY,CAAC,kCAAkC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,yBAAyB;IACvC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzB,CAAC"}