@baruk/core 0.3.0 → 0.4.2

package/dist/storage/r2.js

@@ -0,0 +1,177 @@
+import { createHash, createHmac } from 'node:crypto';
+import { DEFAULT_SIGNED_URL_TTL_SECONDS, StorageError, } from './types.js';
+import { sha256Hex } from './checksum.js';
+const SERVICE = 's3';
+const UNSIGNED_PAYLOAD = 'UNSIGNED-PAYLOAD';
+export class R2StorageProvider {
+    key = 'r2';
+    cfg;
+    fetchImpl;
+    host;
+    constructor(config) {
+        if (!config.accountId || !config.accessKeyId || !config.secretAccessKey || !config.bucket) {
+            throw new 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 = 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 StorageError(`R2 recusou o upload (HTTP ${res.status})`, res.status === 403 ? 'denied' : 'unavailable');
+        }
+        return {
+            key: input.key,
+            checksumSha256: 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 ?? 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 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 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,
+            createHash('sha256').update(canonicalRequest).digest('hex'),
+        ].join('\n');
+        const kDate = createHmac('sha256', `AWS4${this.cfg.secretAccessKey}`)
+            .update(dateStamp)
+            .digest();
+        const kRegion = createHmac('sha256', kDate).update(this.cfg.region).digest();
+        const kService = createHmac('sha256', kRegion).update(SERVICE).digest();
+        const kSigning = createHmac('sha256', kService).update('aws4_request').digest();
+        return createHmac('sha256', kSigning).update(stringToSign).digest('hex');
+    }
+}
+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/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/storage/registry.d.ts

@@ -0,0 +1,23 @@
+import { type StorageProvider } from './types.js';
+/**
+ * Resolução do provider (ADR 0007 D4) — mesma forma de `resolveBillingProvider`
+ * (ADR 0005): este é o único lugar do produto que conhece nome de fornecedor.
+ *
+ * **Falha fechado.** Pedir `r2` sem configuração completa lança, em vez de cair
+ * silenciosamente no disco local. Um upload que o operador acredita estar no R2
+ * e está no disco efêmero de um contêiner é perda de documento do cliente — e
+ * seria descoberto tarde demais.
+ */
+export type StorageProviderKey = 'local' | 'r2';
+export interface StorageConfig {
+    provider?: string;
+    localRootDir?: string;
+    localSigningSecret?: string;
+    r2AccountId?: string;
+    r2AccessKeyId?: string;
+    r2SecretAccessKey?: string;
+    r2Bucket?: string;
+}
+export declare function resolveStorageProvider(config?: StorageConfig): StorageProvider;
+export declare function availableStorageProviders(): StorageProviderKey[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/storage/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/storage/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,IAAI,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,aAAkB,GAAG,eAAe,CAuClF;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,EAAE,CAEhE"}

package/dist/storage/registry.js

@@ -0,0 +1,37 @@
+import { LocalStorageProvider } from './local.js';
+import { R2StorageProvider } from './r2.js';
+import { StorageError } from './types.js';
+export 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 StorageError(`storage r2 selecionado mas a configuração está incompleta: ${missing.join(', ')}`, 'invalid');
+        }
+        return new R2StorageProvider({
+            accountId: config.r2AccountId,
+            accessKeyId: config.r2AccessKeyId,
+            secretAccessKey: config.r2SecretAccessKey,
+            bucket: config.r2Bucket,
+        });
+    }
+    if (key === 'local') {
+        return new LocalStorageProvider({
+            rootDir: config.localRootDir ?? '.storage',
+            signingSecret: config.localSigningSecret ?? 'dev-only-signing-secret',
+        });
+    }
+    throw new StorageError(`storage provider desconhecido: ${key}`, 'invalid');
+}
+export function availableStorageProviders() {
+    return ['local', 'r2'];
+}
+//# sourceMappingURL=registry.js.map

package/dist/storage/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/storage/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAwB,MAAM,YAAY,CAAC;AAuBhE,MAAM,UAAU,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,YAAY,CACpB,8DAA8D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAClF,SAAS,CACV,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,iBAAiB,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,oBAAoB,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,YAAY,CAAC,kCAAkC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/storage/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Contrato de storage de objetos (ADR 0007 D4).
+ *
+ * Mesma forma do Billing Provider Pattern (ADR 0005): o domínio conhece a
+ * interface, nunca o fornecedor. `local` é o default seguro — o produto roda em
+ * desenvolvimento e em teste sem nenhuma conta externa; `r2` é produção.
+ *
+ * O domínio Documents nunca importa SDK de fornecedor. Se um dia trocarmos R2
+ * por outro S3-compatible, só este diretório muda.
+ */
+export interface PutObjectInput {
+    /** Chave completa, já namespaced por tenant (ver `buildStorageKey`). */
+    key: string;
+    body: Uint8Array;
+    contentType: string;
+}
+export interface PutObjectResult {
+    key: string;
+    /** SHA-256 em hex minúsculo, calculado pelo chamador antes do put. */
+    checksumSha256: string;
+    sizeBytes: number;
+}
+export interface SignedUrlOptions {
+    /**
+     * Validade em segundos. O default de 300s é decisão da ADR 0007 D6: curto o
+     * bastante para que o vazamento do link não vire acesso permanente.
+     */
+    expiresInSeconds?: number;
+    /** Nome sugerido no download; vai no `response-content-disposition`. */
+    downloadFilename?: string;
+}
+export interface ObjectHead {
+    exists: boolean;
+    sizeBytes?: number;
+    contentType?: string;
+}
+export interface StorageProvider {
+    /** Identificador persistido em `blob.storage_provider`. */
+    readonly key: 'local' | 'r2' | 's3';
+    put(input: PutObjectInput): Promise<PutObjectResult>;
+    /**
+     * URL temporária de leitura. NUNCA retorna URL pública permanente — o bucket
+     * é privado e o link expira (ADR 0007 D6).
+     */
+    getSignedUrl(key: string, options?: SignedUrlOptions): Promise<string>;
+    head(key: string): Promise<ObjectHead>;
+    /**
+     * Remoção física. Só é chamada pelo job de retenção, nunca pelo fluxo de UI
+     * (ADR 0007). A exclusão no produto é soft delete no `document`.
+     */
+    delete(key: string): Promise<void>;
+}
+export declare class StorageError extends Error {
+    readonly code: 'not-found' | 'unavailable' | 'denied' | 'invalid';
+    constructor(message: string, code: 'not-found' | 'unavailable' | 'denied' | 'invalid');
+}
+/** Validade padrão de URL assinada, em segundos (ADR 0007 D6). */
+export declare const DEFAULT_SIGNED_URL_TTL_SECONDS = 300;
+/** Teto de tamanho por arquivo. Acima disso, o upload é recusado na borda. */
+export declare const MAX_UPLOAD_BYTES: number;
+/**
+ * Tipos aceitos. Allowlist, nunca denylist: um tipo desconhecido é recusado, e
+ * não aceito por omissão.
+ */
+export declare const ALLOWED_MIME_TYPES: readonly string[];
+export declare function isAllowedMimeType(mime: string): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACrD;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACvC;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,qBAAa,YAAa,SAAQ,KAAK;IAGnC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS;gBADjE,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS;CAKpE;AAED,kEAAkE;AAClE,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAc/C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/storage/types.js

@@ -0,0 +1,45 @@
+/**
+ * Contrato de storage de objetos (ADR 0007 D4).
+ *
+ * Mesma forma do Billing Provider Pattern (ADR 0005): o domínio conhece a
+ * interface, nunca o fornecedor. `local` é o default seguro — o produto roda em
+ * desenvolvimento e em teste sem nenhuma conta externa; `r2` é produção.
+ *
+ * O domínio Documents nunca importa SDK de fornecedor. Se um dia trocarmos R2
+ * por outro S3-compatible, só este diretório muda.
+ */
+export class StorageError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'StorageError';
+    }
+}
+/** Validade padrão de URL assinada, em segundos (ADR 0007 D6). */
+export const DEFAULT_SIGNED_URL_TTL_SECONDS = 300;
+/** Teto de tamanho por arquivo. Acima disso, o upload é recusado na borda. */
+export const MAX_UPLOAD_BYTES = 25 * 1024 * 1024;
+/**
+ * Tipos aceitos. Allowlist, nunca denylist: um tipo desconhecido é recusado, e
+ * não aceito por omissão.
+ */
+export const ALLOWED_MIME_TYPES = [
+    'application/pdf',
+    'image/jpeg',
+    'image/png',
+    'image/webp',
+    'text/xml',
+    'application/xml',
+    'text/plain',
+    'text/csv',
+    'application/vnd.ms-excel',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    'application/msword',
+    'application/zip',
+];
+export function isAllowedMimeType(mime) {
+    return ALLOWED_MIME_TYPES.includes(mime.toLowerCase().split(';')[0].trim());
+}
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiDH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG1B;IAFX,YACE,OAAe,EACN,IAAwD;QAEjE,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,SAAI,GAAJ,IAAI,CAAoD;QAGjE,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,iBAAiB;IACjB,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,UAAU;IACV,iBAAiB;IACjB,YAAY;IACZ,UAAU;IACV,0BAA0B;IAC1B,mEAAmE;IACnE,yEAAyE;IACzE,oBAAoB;IACpB,iBAAiB;CAClB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/subscription-billing/provider/asaas.d.ts

@@ -10,6 +10,20 @@ export declare class AsaasSubscriptionProvider implements PaymentGatewayProvider
     private call;
     ensureCustomer(input: EnsureCustomerInput): Promise<ProviderCustomer>;
     createCheckout(input: CreateCheckoutInput): Promise<ProviderCheckout>;
+    /**
+     * `DELETE /subscriptions/{id}` — o ASAAS não emite mais cobrança da assinatura
+     * depois disso. As cobranças já geradas e ainda em aberto permanecem, que é o
+     * comportamento correto: o que foi devido antes do cancelamento continua devido.
+     *
+     * Idempotente por desenho. Assinatura inexistente devolve `alreadyCanceled`
+     * em vez de erro — o chamador quer o estado final ("não cobra mais"), e um
+     * retry depois de sucesso parcial não pode virar falha. Só erro real de
+     * gateway (rede, timeout, 5xx) propaga, e aí o cancelamento não é consolidado.
+     */
+    cancelSubscription(externalId: string): Promise<{
+        status: 'canceled';
+        alreadyCanceled: boolean;
+    }>;
     getPayment(externalId: string): Promise<ProviderInvoice | null>;
     /** Autenticidade — SEMPRE antes de `parseWebhookEvent` (RFC §7, passo separado). */
     verifyWebhook(headers: WebhookHeaders, _rawBody: string): boolean;

package/dist/subscription-billing/provider/asaas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asaas.d.ts","sourceRoot":"","sources":["../../../src/subscription-billing/provider/asaas.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EAGnB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AA4FrB,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,MAAM,EAAE,0BAA0B;YAShC,IAAI;IAoCZ,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUrE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBrE,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAKrE,oFAAoF;IACpF,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOjE;;;;;;;OAOG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI;CAmDnE"}
+{"version":3,"file":"asaas.d.ts","sourceRoot":"","sources":["../../../src/subscription-billing/provider/asaas.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EAGnB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AA4FrB,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,MAAM,EAAE,0BAA0B;YAShC,IAAI;IAiDZ,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUrE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgB3E;;;;;;;;;OASG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC;IAgBtD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAQrE,oFAAoF;IACpF,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IASjE;;;;;;;OAOG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI;CAwDnE"}

package/dist/subscription-billing/provider/asaas.js

@@ -118,8 +118,13 @@ export class AsaasSubscriptionProvider {
                 // mesma invariante ja endurecida em 2 rounds de Certification (mail/, RFC §9).
                 const errors = json['errors'];
                 const detail = errors?.[0]?.description ?? `HTTP ${res.status}`;
-                logSanitized(`[subscription-billing] asaas ${method} ${path} falhou:`, detail, [this.apiKey, this.webhookSecret]);
-                throw new AsaasProviderError('falha ao contatar o provider de pagamento.');
+                logSanitized(`[subscription-billing] asaas ${method} ${path} falhou:`, detail, [
+                    this.apiKey,
+                    this.webhookSecret,
+                ]);
+                // 404 preserva o status: quem cancela precisa distinguir "não existe
+                // mais" (objetivo já atendido) de falha real de gateway.
+                throw new AsaasProviderError('falha ao contatar o provider de pagamento.', res.status === 404 ? 404 : 502);
             }
             return json;
         }
@@ -129,10 +134,7 @@ export class AsaasSubscriptionProvider {
             if (err instanceof Error && err.name === 'AbortError') {
                 throw new AsaasProviderError(`timeout apos ${TIMEOUT_MS}ms`, 504);
             }
-            logSanitized(`[subscription-billing] asaas ${method} ${path} erro de rede:`, err instanceof Error ? err.message : String(err), [
-                this.apiKey,
-                this.webhookSecret,
-            ]);
+            logSanitized(`[subscription-billing] asaas ${method} ${path} erro de rede:`, err instanceof Error ? err.message : String(err), [this.apiKey, this.webhookSecret]);
             throw new AsaasProviderError('falha de rede ao contatar o provider de pagamento.');
         }
         finally {
@@ -163,6 +165,29 @@ export class AsaasSubscriptionProvider {
         });
         return { externalId: link.id, url: link.url };
     }
+    /**
+     * `DELETE /subscriptions/{id}` — o ASAAS não emite mais cobrança da assinatura
+     * depois disso. As cobranças já geradas e ainda em aberto permanecem, que é o
+     * comportamento correto: o que foi devido antes do cancelamento continua devido.
+     *
+     * Idempotente por desenho. Assinatura inexistente devolve `alreadyCanceled`
+     * em vez de erro — o chamador quer o estado final ("não cobra mais"), e um
+     * retry depois de sucesso parcial não pode virar falha. Só erro real de
+     * gateway (rede, timeout, 5xx) propaga, e aí o cancelamento não é consolidado.
+     */
+    async cancelSubscription(externalId) {
+        try {
+            const res = await this.call('DELETE', `/subscriptions/${encodeURIComponent(externalId)}`);
+            return { status: 'canceled', alreadyCanceled: res.deleted === false };
+        }
+        catch (err) {
+            // 404: já não existe no gateway — o objetivo ("não cobra mais") está atendido.
+            if (err instanceof AsaasProviderError && err.status === 404) {
+                return { status: 'canceled', alreadyCanceled: true };
+            }
+            throw err;
+        }
+    }
     async getPayment(externalId) {
         const p = await this.call('GET', `/payments/${encodeURIComponent(externalId)}`);
         return normalizeAsaasPayment(p);
@@ -173,7 +198,7 @@ export class AsaasSubscriptionProvider {
         if (!this.webhookSecret)
             return false; // sem token configurado → nunca confia no evento
         const received = headers['asaas-access-token'] ?? headers['Asaas-Access-Token'] ?? '';
-        return typeof received === 'string' && received.length > 0 && safeEqual(received, this.webhookSecret);
+        return (typeof received === 'string' && received.length > 0 && safeEqual(received, this.webhookSecret));
     }
     /**
      * Reescrito a partir do mapeamento real e ja validado em producao do Golden Project

package/dist/subscription-billing/provider/asaas.js.map

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

package/dist/subscription-billing/provider/disabled.d.ts

@@ -24,6 +24,15 @@ export declare class DisabledSubscriptionProvider implements PaymentGatewayProvi
     ensureCustomer(_input: EnsureCustomerInput): Promise<ProviderCustomer>;
     createCheckout(_input: CreateCheckoutInput): Promise<ProviderCheckout>;
     getPayment(_externalId: string): Promise<ProviderInvoice | null>;
+    /**
+     * Sem gateway não há recorrência a cancelar — o objetivo ("não gerar cobrança
+     * futura") já é verdade. Devolve sucesso para que o cancelamento local não
+     * fique bloqueado quando o billing está desligado.
+     */
+    cancelSubscription(_externalId: string): Promise<{
+        status: 'canceled';
+        alreadyCanceled: boolean;
+    }>;
     verifyWebhook(_headers: WebhookHeaders, _rawBody: string): boolean;
     parseWebhookEvent(_payload: unknown): NormalizedWebhookEvent | null;
 }

package/dist/subscription-billing/provider/disabled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disabled.d.ts","sourceRoot":"","sources":["../../../src/subscription-billing/provider/disabled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;GAWG;AACH,qBAAa,4BAA6B,YAAW,sBAAsB;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;gBAExB,IAAI,SAAa;IAI7B;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKtE,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAItE,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAItE,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlE,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI;CAGpE"}
+{"version":3,"file":"disabled.d.ts","sourceRoot":"","sources":["../../../src/subscription-billing/provider/disabled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;GAWG;AACH,qBAAa,4BAA6B,YAAW,sBAAsB;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;gBAExB,IAAI,SAAa;IAI7B;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKtE,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAItE,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAItE;;;;OAIG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC;IAI5D,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlE,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI;CAGpE"}

package/dist/subscription-billing/provider/disabled.js

@@ -32,6 +32,14 @@ export class DisabledSubscriptionProvider {
     async getPayment(_externalId) {
         return null;
     }
+    /**
+     * Sem gateway não há recorrência a cancelar — o objetivo ("não gerar cobrança
+     * futura") já é verdade. Devolve sucesso para que o cancelamento local não
+     * fique bloqueado quando o billing está desligado.
+     */
+    async cancelSubscription(_externalId) {
+        return { status: 'canceled', alreadyCanceled: true };
+    }
     verifyWebhook(_headers, _rawBody) {
         return false; // nenhum webhook e confiavel quando desabilitado — nao ha token para validar
     }

package/dist/subscription-billing/provider/disabled.js.map

@@ -1 +1 @@
-{"version":3,"file":"disabled.js","sourceRoot":"","sources":["../../../src/subscription-billing/provider/disabled.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,4BAA4B;IAC9B,IAAI,CAAS;IACb,IAAI,GAAG,UAAmB,CAAC;IAEpC,YAAY,IAAI,GAAG,UAAU;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,MAA2B;QAC9C,KAAK,MAAM,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAA2B;QAC9C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,WAAmB;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,QAAwB,EAAE,QAAgB;QACtD,OAAO,KAAK,CAAC,CAAC,6EAA6E;IAC7F,CAAC;IAED,iBAAiB,CAAC,QAAiB;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"disabled.js","sourceRoot":"","sources":["../../../src/subscription-billing/provider/disabled.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,4BAA4B;IAC9B,IAAI,CAAS;IACb,IAAI,GAAG,UAAmB,CAAC;IAEpC,YAAY,IAAI,GAAG,UAAU;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,MAA2B;QAC9C,KAAK,MAAM,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAA2B;QAC9C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,WAAmB;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB,CACtB,WAAmB;QAEnB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IACvD,CAAC;IAED,aAAa,CAAC,QAAwB,EAAE,QAAgB;QACtD,OAAO,KAAK,CAAC,CAAC,6EAA6E;IAC7F,CAAC;IAED,iBAAiB,CAAC,QAAiB;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/subscription-billing/provider/registry.d.ts

@@ -5,6 +5,16 @@ export type SubscriptionProviderFactory = (config: SubscriptionProviderConfig) =
  * `provider/asaas.ts` diretamente. Sem `apiKey` configurada, resolve para
  * `disabled` automaticamente, independente do nome pedido — nunca cobra por
  * falta de configuracao (mesmo padrao best-effort de `cap.communication.transactional-email`).
+ *
+ * Modo `live` passa pela MESMA grade do trilho merchant. Esta camada de billing
+ * tinha caminho próprio até o gateway e nenhuma grade: a contenção era o valor
+ * de uma única variável de ambiente. Agora um provedor live sequer é
+ * CONSTRUÍDO fora de uma aplicação declarada como produção — o gateway não
+ * chega a ser chamado porque o objeto que fala com ele não existe.
+ *
+ * A grade é `resolve`, não `charge`: pausar emissão não pode impedir de
+ * verificar webhook e reconhecer dinheiro que já entrou. A chave geral entra
+ * onde a cobrança nasce (`startCheckout`).
  */
 export declare function resolveSubscriptionBillingProvider(name: string, config: SubscriptionProviderConfig): PaymentGatewayProvider;
 //# sourceMappingURL=registry.d.ts.map

package/dist/subscription-billing/provider/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/subscription-billing/provider/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAItF,MAAM,MAAM,2BAA2B,GAAG,CAAC,MAAM,EAAE,0BAA0B,KAAK,sBAAsB,CAAC;AAOzG;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,0BAA0B,GAAG,sBAAsB,CAW3H"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/subscription-billing/provider/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAItF,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,EAAE,0BAA0B,KAC/B,sBAAsB,CAAC;AAO5B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,0BAA0B,GACjC,sBAAsB,CAiBxB"}

package/dist/subscription-billing/provider/registry.js

@@ -1,4 +1,5 @@
 import { ValidationError } from '@baruk/shared';
+import { assertLiveProviderAllowed, readLiveRuntime } from '../../billing/live-guard.js';
 import { AsaasSubscriptionProvider } from './asaas.js';
 import { DisabledSubscriptionProvider } from './disabled.js';
 const FACTORIES = {
@@ -10,6 +11,16 @@ const FACTORIES = {
  * `provider/asaas.ts` diretamente. Sem `apiKey` configurada, resolve para
  * `disabled` automaticamente, independente do nome pedido — nunca cobra por
  * falta de configuracao (mesmo padrao best-effort de `cap.communication.transactional-email`).
+ *
+ * Modo `live` passa pela MESMA grade do trilho merchant. Esta camada de billing
+ * tinha caminho próprio até o gateway e nenhuma grade: a contenção era o valor
+ * de uma única variável de ambiente. Agora um provedor live sequer é
+ * CONSTRUÍDO fora de uma aplicação declarada como produção — o gateway não
+ * chega a ser chamado porque o objeto que fala com ele não existe.
+ *
+ * A grade é `resolve`, não `charge`: pausar emissão não pode impedir de
+ * verificar webhook e reconhecer dinheiro que já entrou. A chave geral entra
+ * onde a cobrança nasce (`startCheckout`).
  */
 export function resolveSubscriptionBillingProvider(name, config) {
     if (!config.apiKey || config.mode === 'disabled') {
@@ -17,6 +28,12 @@ export function resolveSubscriptionBillingProvider(name, config) {
         // gravam `provider.name` em DB precisam do nome configurado, nao do literal `'disabled'`.
         return new DisabledSubscriptionProvider(name);
     }
+    // A grade vem DEPOIS do rebaixamento: sem credencial não existe dinheiro
+    // possível, e transformar "produto sem chave própria" em exceção quebraria o
+    // isolamento multi-produto, que depende de ficar desabilitado em silêncio.
+    if (config.mode === 'live') {
+        assertLiveProviderAllowed('live', readLiveRuntime(), 'resolve');
+    }
     const factory = FACTORIES[name];
     if (!factory) {
         throw new ValidationError(`Provider de pagamento desconhecido: "${name}".`);