@baruk/core 0.3.0 → 0.4.2

package/dist/cjs/mail/template-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-renderer.js","sourceRoot":"","sources":["../../../src/mail/template-renderer.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,2BAA2B;IACtC,MAAM,CAAC,QAAgB,EAAE,IAA6B;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CACb,0CAA0C,QAAQ,8CAA8C,CACjG,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAC9E,CAAC;CACF;AAdD,kEAcC"}
+{"version":3,"file":"template-renderer.js","sourceRoot":"","sources":["../../../src/mail/template-renderer.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,sDAAmE;AAA1D,4HAAA,2BAA2B,OAAA"}

package/dist/cjs/mail/transactional-outbound.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * A porta ÚNICA de e-mail para os fluxos que não passam pelo motor multicanal.
+ *
+ * ## O bloqueador que este arquivo fecha
+ *
+ * `SINGLE_DISPATCH_AUTHORITY=FAIL`. O guard da rodada anterior varria só
+ * `packages/core/src` e não enxergava o que estava do lado de fora:
+ *
+ *     apps/api/src/routes/admin.ts      → sendEmail(process.env.RESEND_API_KEY, …)
+ *     apps/api/src/routes/documents.ts  → sendEmail(process.env.RESEND_API_KEY, …)
+ *     apps/api/src/routes/auth.ts       → sendEmail(process.env.RESEND_API_KEY, …)
+ *     packages/core/src/subscription-billing/service.ts → sendEmail(cfg.resendApiKey, …)
+ *
+ * Quatro caminhos de APLICAÇÃO chamando o transporte direto, cada um lendo a
+ * credencial e o remetente por conta própria. Não é um cliente provider paralelo
+ * — é o mesmo transporte —, mas é código de domínio alcançando a borda de envio
+ * sem passar por autoridade nenhuma, que é o que o adendo §12 proíbe.
+ *
+ * ## O que ela NÃO é
+ *
+ * **Não é o motor multicanal, e não finge ser.** Convite, reconvite, acesso ao
+ * Portal e recuperação de senha são comunicação de IDENTIDADE: acontecem antes de
+ * existir cliente, antes de existir consentimento de contribuinte, e — no caso do
+ * `forgot-password` — antes de existir sessão de onde tirar um tenant. Passá-los
+ * pelo `dispatch` exigiria inventar `recipientRef`, `subjectRef`, template
+ * aprovado e conta de canal para cada um; a fase que fizer isso é própria, e
+ * `AUTH_EMAIL_NOT_ON_SHARED_ENGINE` fica registrada como dívida.
+ *
+ * O que ela é: um **adapter de entrada** (§13). Fluxo legado sem cliente provider
+ * próprio, com uma porta só, nominal e vigiada.
+ *
+ * ## O que ela acrescenta de verdade
+ *
+ * Uma barreira que só renomeia o caminho não é correção. Estes fluxos ganham,
+ * aqui, três coisas que nenhum deles tinha:
+ *
+ *  1. **Idempotência de provider.** Nenhum dos quatro mandava `Idempotency-Key`.
+ *     Duplo-clique em "convidar" ou retry de cron produzia duas mensagens
+ *     idênticas na caixa de quem recebe. A chave é derivada do CONTEÚDO (ver
+ *     `identityFor`), então retry idêntico dedupe e reconvite legítimo — que
+ *     carrega um token novo — passa.
+ *  2. **Um lugar só para a credencial.** `process.env.RESEND_API_KEY` deixa de
+ *     ser lido em quatro arquivos. Quatro leituras é onde uma delas fica para
+ *     trás no dia da rotação.
+ *  3. **Um alvo só para o guard.** O guard de fronteira global proíbe `sendEmail*`
+ *     em todo o repositório exceto no transporte, nos adapters do motor e aqui.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendTransactionalOutboundWithResult = sendTransactionalOutboundWithResult;
+exports.sendTransactionalOutbound = sendTransactionalOutbound;
+const node_crypto_1 = require("node:crypto");
+const resend_js_1 = require("./resend.js");
+/**
+ * A chave que o provider vai deduplicar.
+ *
+ * Derivada do CONTEÚDO — destinatário, assunto, remetente e corpo — e não de um
+ * identificador de negócio. A escolha decide o comportamento em produção:
+ *
+ *   • retry idêntico (duplo-clique, reexecução de cron) produz a MESMA chave, e o
+ *     Resend devolve a resposta original sem mandar a segunda mensagem;
+ *   • reconvite legítimo carrega um token novo no corpo, logo uma chave nova, e
+ *     sai normalmente.
+ *
+ * Derivar de `kind + destinatário` faria o oposto e seria pior que não ter chave:
+ * o reconvite legítimo seria silenciosamente descartado pelo provider dentro da
+ * janela de 24 h, e ninguém veria — a resposta de um replay é `200`.
+ *
+ * `sha256` hexadecimal, 64 caracteres, dentro do limite de 1 a 256 do provider.
+ */
+function identityFor(req) {
+    /*
+     * Serializado como ARRAY, e não concatenado com um separador.
+     *
+     * Concatenar campos com um caractere qualquer é ambíguo: `to='a b'` com
+     * `from='c'` produz a mesma cadeia que `to='a'` com `from='b c'`, e duas
+     * mensagens diferentes ganhariam a mesma chave — o provider descartaria a
+     * segunda como replay. `JSON.stringify` de um array escapa os campos e o
+     * comprimento fica implícito na estrutura, então nenhum conteúdo consegue
+     * imitar a fronteira entre dois campos.
+     */
+    const material = JSON.stringify([
+        req.kind,
+        req.message.to,
+        req.message.from,
+        req.message.subject,
+        req.message.html,
+        req.message.text ?? null,
+    ]);
+    return (0, node_crypto_1.createHash)('sha256').update(material, 'utf8').digest('hex');
+}
+/**
+ * Envia, com o desfecho detalhado.
+ *
+ * Best-effort como sempre foi: devolve o resultado, nunca lança. Quem chama
+ * decide o que fazer — e continua podendo distinguir "o provider recusou" de "a
+ * mensagem saiu", que é a distinção que fez o Portal ficar meses sem acesso
+ * ativo quando ela não existia.
+ */
+async function sendTransactionalOutboundWithResult(req) {
+    return (0, resend_js_1.sendEmailWithResult)(req.apiKey ?? process.env.RESEND_API_KEY, req.message, {
+        idempotencyKey: identityFor(req),
+        fetchImpl: req.fetchImpl,
+    });
+}
+/**
+ * Envia e devolve só se saiu.
+ *
+ * A forma que os quatro chamadores legados já usavam (`boolean`), preservada para
+ * que a consolidação não mude a resposta de nenhuma rota — nem o `201` do
+ * convite, nem o campo `invitationEmailSent` que a tela lê.
+ */
+async function sendTransactionalOutbound(req) {
+    const result = await sendTransactionalOutboundWithResult(req);
+    return result.ok;
+}
+//# sourceMappingURL=transactional-outbound.js.map

package/dist/cjs/mail/transactional-outbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-outbound.js","sourceRoot":"","sources":["../../../src/mail/transactional-outbound.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;;AAuGH,kFAOC;AASD,8DAGC;AAxHD,6CAAyC;AACzC,2CAA2F;AAqD3F;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,WAAW,CAAC,GAA8B;IACjD;;;;;;;;;OASG;IACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,GAAG,CAAC,IAAI;QACR,GAAG,CAAC,OAAO,CAAC,EAAE;QACd,GAAG,CAAC,OAAO,CAAC,IAAI;QAChB,GAAG,CAAC,OAAO,CAAC,OAAO;QACnB,GAAG,CAAC,OAAO,CAAC,IAAI;QAChB,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI;KACzB,CAAC,CAAC;IACH,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,mCAAmC,CACvD,GAA8B;IAE9B,OAAO,IAAA,+BAAmB,EAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,EAAE;QAChF,cAAc,EAAE,WAAW,CAAC,GAAG,CAAC;QAChC,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,yBAAyB,CAAC,GAA8B;IAC5E,MAAM,MAAM,GAAG,MAAM,mCAAmC,CAAC,GAAG,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC"}

package/dist/cjs/mail/types.js

@@ -1,38 +1,11 @@
 "use strict";
-// cap.communication.transactional-email — contrato canônico (RFC-CAPABILITY-TRANSACTIONAL-EMAIL-001 v0.2).
-// Ver docs/governance/RFC-CAPABILITY-TRANSACTIONAL-EMAIL-001.md no repo baruk-ecosystem.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS = exports.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS = exports.DEFAULT_TIMEOUT_MS = exports.MIN_DEDUP_WINDOW_MS = exports.TRANSACTIONAL_EMAIL_CONTRACT_VERSION = void 0;
-exports.isRetryableError = isRetryableError;
-/**
- * Versão do contrato público desta capability (RFC-CAPABILITY-TRANSACTIONAL-EMAIL-001 §12, SemVer próprio
- * de capability — independente da versão do pacote `@baruk/core`, que versiona o motor inteiro, não uma
- * capability isolada). `0.2.1`: hardening pré-certificação (Capability Certification 001, Auditoria Codex)
- * — sanitização de segredos, dedup atômica, validação de endereço, exceções internas contidas. `0.2.2`:
- * hardening pós-Certification Round 2 — sanitização genérica estendida (URI-embedded credentials, token
- * estruturado, alta entropia) e coalescência distribuída real (espera limitada por reserva remota em
- * andamento, nunca reenvio às cegas). Nenhuma das duas mudou assinatura pública (patch, não minor/major).
- */
-exports.TRANSACTIONAL_EMAIL_CONTRACT_VERSION = '0.2.2';
-/** Janela mínima de deduplicação exigida pela RFC §4.2 (24h) — implementações podem manter por mais tempo, nunca menos. */
-exports.MIN_DEDUP_WINDOW_MS = 24 * 60 * 60 * 1000;
-/** Timeout padrão do Provider (RFC §5 — herdado empiricamente da implementação mais madura do inventário). */
-exports.DEFAULT_TIMEOUT_MS = 12_000;
-/**
- * Default de poll ao aguardar uma reserva remota em andamento num `DedupStore` `mode: 'shared'`
- * (Bloqueador 2 — Certification Round 2). Baixo o suficiente para não atrasar percebivelmente
- * o caso comum (reserva local, sem espera nenhuma).
- */
-exports.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS = 200;
-/**
- * Default de tempo máximo de espera por uma reserva remota antes de tentar assumi-la e,
- * falhando isso, devolver falha determinística retryable (Bloqueador 2 — Certification Round 2).
- * Maior que `DEFAULT_TIMEOUT_MS` — dá à instância dona tempo de terminar o próprio envio
- * (que pode levar até `DEFAULT_TIMEOUT_MS`) antes desta instância desistir de esperar.
- */
-exports.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS = 15_000;
-/** Utilitário de conveniência para o consumidor decidir retry — não usado internamente pelo core (RFC §5). */
-function isRetryableError(code) {
-    return code === 'timeout' || code === 'provider-unavailable';
-}
+exports.isRetryableError = exports.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS = exports.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS = exports.TRANSACTIONAL_EMAIL_CONTRACT_VERSION = exports.MIN_DEDUP_WINDOW_MS = exports.DEFAULT_TIMEOUT_MS = void 0;
+var communication_1 = require("@baruk/communication");
+Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: function () { return communication_1.DEFAULT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "MIN_DEDUP_WINDOW_MS", { enumerable: true, get: function () { return communication_1.MIN_DEDUP_WINDOW_MS; } });
+Object.defineProperty(exports, "TRANSACTIONAL_EMAIL_CONTRACT_VERSION", { enumerable: true, get: function () { return communication_1.TRANSACTIONAL_EMAIL_CONTRACT_VERSION; } });
+Object.defineProperty(exports, "DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS", { enumerable: true, get: function () { return communication_1.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS; } });
+Object.defineProperty(exports, "DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS", { enumerable: true, get: function () { return communication_1.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS; } });
+Object.defineProperty(exports, "isRetryableError", { enumerable: true, get: function () { return communication_1.isRetryableError; } });
 //# sourceMappingURL=types.js.map

package/dist/cjs/mail/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mail/types.ts"],"names":[],"mappings":";AAAA,2GAA2G;AAC3G,yFAAyF;;;AA8JzF,4CAEC;AAnCD;;;;;;;;GAQG;AACU,QAAA,oCAAoC,GAAG,OAAO,CAAC;AAE5D,2HAA2H;AAC9G,QAAA,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvD,8GAA8G;AACjG,QAAA,kBAAkB,GAAG,MAAM,CAAC;AAEzC;;;;GAIG;AACU,QAAA,2CAA2C,GAAG,GAAG,CAAC;AAE/D;;;;;GAKG;AACU,QAAA,sCAAsC,GAAG,MAAM,CAAC;AAE7D,8GAA8G;AAC9G,SAAgB,gBAAgB,CAAC,IAAuB;IACtD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,sBAAsB,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mail/types.ts"],"names":[],"mappings":";;;AA0BA,sDAO8B;AAN5B,mHAAA,kBAAkB,OAAA;AAClB,oHAAA,mBAAmB,OAAA;AACnB,qIAAA,oCAAoC,OAAA;AACpC,4IAAA,2CAA2C,OAAA;AAC3C,uIAAA,sCAAsC,OAAA;AACtC,iHAAA,gBAAgB,OAAA"}

package/dist/cjs/portal/provisioning.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invitePortalUser = invitePortalUser;
+exports.listPortalUsers = listPortalUsers;
+exports.revokePortalAccess = revokePortalAccess;
+const shared_1 = require("@baruk/shared");
+const audit_js_1 = require("../audit/audit.js");
+const password_reset_js_1 = require("../auth/password-reset.js");
+const repository_js_1 = require("../users/repository.js");
+const PORTAL_ROLE_KEY = 'client_titular';
+async function invitePortalUser(tx, input) {
+    const tenantId = await currentTenantId(tx);
+    // O cliente precisa existir NESTE tenant. A RLS já garantiria, mas uma
+    // mensagem clara vale mais que um erro de FK.
+    const client = await tx `
+    SELECT id FROM client WHERE id = ${input.clientId} AND deleted_at IS NULL
+  `;
+    if (!client[0])
+        throw new shared_1.NotFoundError('Cliente não encontrado');
+    const existing = await tx `
+    SELECT id, full_name, user_type, status FROM "user"
+     WHERE email = ${input.email} AND deleted_at IS NULL
+  `;
+    let userId;
+    let fullName;
+    let isNewUser;
+    // Reconvidar quem ainda não ativou precisa emitir um token novo. Sem isto o
+    // usuário fica preso: o primeiro convite não chegou (ou expirou) e nenhum
+    // reenvio produz link, porque só o cadastro inicial emitia token.
+    let isPendingActivation = false;
+    if (existing[0]) {
+        // Um e-mail de staff não vira acesso de portal por convite. Os dois tipos
+        // têm superfícies e escopos distintos, e converter silenciosamente daria a
+        // um colaborador do escritório uma sessão de cliente.
+        if (existing[0].user_type !== 'client_portal') {
+            throw new shared_1.ConflictError('Este e-mail já pertence a um usuário interno. Use um e-mail diferente para o acesso do cliente.');
+        }
+        userId = existing[0].id;
+        fullName = existing[0].full_name;
+        isNewUser = false;
+        // Só quem ainda não ativou recebe token novo. Emitir para um usuário já
+        // ativo transformaria o convite em redefinição de senha à revelia do
+        // cliente — quem convida não pode provocar isso.
+        isPendingActivation = existing[0].status === 'invited';
+    }
+    else {
+        userId = (0, shared_1.uuidv7)();
+        fullName = input.fullName;
+        isNewUser = true;
+        await tx `
+      INSERT INTO "user" (id, email, full_name, user_type, status, auth_provider)
+      VALUES (${userId}, ${input.email}, ${input.fullName}, 'client_portal', 'invited', 'password')
+    `;
+    }
+    // Membership no tenant — sem ela o usuário não resolve tenant no login.
+    const membership = await tx `
+    SELECT id FROM membership
+     WHERE user_id = ${userId} AND tenant_id = ${tenantId} AND deleted_at IS NULL
+  `;
+    if (!membership[0]) {
+        await tx `
+      INSERT INTO membership (id, tenant_id, user_id, status, invited_by)
+      VALUES (${(0, shared_1.uuidv7)()}, ${tenantId}, ${userId}, 'invited', ${input.invitedBy})
+    `;
+        await (0, repository_js_1.setUserRole)(tx, userId, PORTAL_ROLE_KEY);
+    }
+    // O vínculo com o cliente. Idempotente: reconvidar não duplica.
+    const access = await tx `
+    INSERT INTO client_portal_access (id, tenant_id, user_id, client_id, status)
+    VALUES (${(0, shared_1.uuidv7)()}, ${tenantId}, ${userId}, ${input.clientId}, 'active')
+    ON CONFLICT (tenant_id, user_id, client_id) DO UPDATE SET status = 'active'
+    RETURNING id
+  `;
+    let activationToken = null;
+    if (isNewUser || isPendingActivation) {
+        const activation = await (0, password_reset_js_1.createActivationToken)(tx, { userId, tenantId });
+        activationToken = activation.token;
+    }
+    await (0, audit_js_1.appendAudit)(tx, {
+        actorId: input.invitedBy,
+        action: 'portal_user_invited',
+        resourceType: 'client_portal_access',
+        resourceId: access[0].id,
+        // O token nunca entra na auditoria, nem em metadata: o registro é lido por
+        // gente que não deve poder assumir a conta do cliente.
+        metadata: { email: input.email, clientId: input.clientId, isNewUser, isPendingActivation },
+    });
+    return {
+        userId,
+        email: input.email,
+        fullName,
+        clientId: input.clientId,
+        activationToken,
+        alreadyHadAccess: !isNewUser && membership.length > 0,
+        isReinvite: isPendingActivation,
+    };
+}
+async function listPortalUsers(tx, clientId) {
+    const rows = await tx `
+    SELECT u.id AS user_id, u.email, u.full_name, u.status,
+           cpa.status AS access_status, u.last_login_at
+      FROM client_portal_access cpa
+      JOIN "user" u ON u.id = cpa.user_id
+     WHERE cpa.client_id = ${clientId} AND u.deleted_at IS NULL
+     ORDER BY u.full_name
+  `;
+    return rows.map((r) => ({
+        userId: r.user_id,
+        email: r.email,
+        fullName: r.full_name,
+        status: r.status,
+        accessStatus: r.access_status,
+        lastLoginAt: r.last_login_at ? r.last_login_at.toISOString() : null,
+    }));
+}
+/**
+ * Revoga o acesso. Não apaga o usuário nem a trilha: quem enviou um documento
+ * continua identificável depois de perder o acesso — é justamente isso que
+ * torna a prova utilizável meses depois.
+ */
+async function revokePortalAccess(tx, input) {
+    const rows = await tx `
+    UPDATE client_portal_access
+       SET status = 'revoked'
+     WHERE client_id = ${input.clientId} AND user_id = ${input.userId} AND status = 'active'
+    RETURNING id
+  `;
+    if (!rows[0])
+        throw new shared_1.NotFoundError('Acesso ativo não encontrado');
+    await (0, audit_js_1.appendAudit)(tx, {
+        actorId: input.revokedBy,
+        action: 'portal_access_revoked',
+        resourceType: 'client_portal_access',
+        resourceId: rows[0].id,
+        metadata: { clientId: input.clientId, userId: input.userId },
+    });
+}
+async function currentTenantId(tx) {
+    const rows = await tx `
+    SELECT current_setting('app.current_tenant')::uuid AS tenant_id
+  `;
+    return rows[0].tenant_id;
+}
+//# sourceMappingURL=provisioning.js.map

package/dist/cjs/portal/provisioning.js.map

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

package/dist/cjs/pricing-engine/canonical.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Serialização canônica (RFC-CAPABILITY-PRICING-ENGINE-001 §22.1 F2) — usada
+ * exclusivamente para compor o `fingerprint`/`quoteId` (nunca para persistir
+ * ou transportar dados). `JSON.stringify` cru depende da ordem de inserção
+ * das chaves do objeto — dois `PricingRequest` economicamente idênticos, mas
+ * construídos com `addonQuantities`/Records em ordem de chave diferente,
+ * produziam hashes diferentes antes deste módulo (achado do Design Review,
+ * §22.1). `canonicalize` ordena chaves recursivamente em qualquer nível de
+ * objeto/Record/Map aninhado — arrays preservam ordem (a ordem de array é
+ * semanticamente relevante quando existe; coleções sem ordem própria, como
+ * `bundleRules`, são pré-ordenadas pelo chamador antes de chegar aqui).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalStringify = canonicalStringify;
+function canonicalize(value) {
+    if (value instanceof Map) {
+        const entries = Array.from(value.entries())
+            .map(([k, v]) => [String(k), canonicalize(v)])
+            .sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0));
+        const record = {};
+        for (const [k, v] of entries)
+            record[k] = v;
+        return record;
+    }
+    if (Array.isArray(value)) {
+        return value.map(canonicalize);
+    }
+    if (value !== null && typeof value === 'object') {
+        const record = value;
+        const result = {};
+        for (const key of Object.keys(record).sort()) {
+            result[key] = canonicalize(record[key]);
+        }
+        return result;
+    }
+    return value;
+}
+function canonicalStringify(value) {
+    return JSON.stringify(canonicalize(value));
+}
+//# sourceMappingURL=canonical.js.map

package/dist/cjs/pricing-engine/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../../src/pricing-engine/canonical.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAyBH,gDAEC;AAzBD,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;aACxC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAU,CAAC;aACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/cjs/pricing-engine/errors.js

@@ -41,7 +41,12 @@ class PricingEngineError extends Error {
         this.ruleIds = ruleIds;
     }
     toJSON() {
-        return { code: this.code, errorClass: this.errorClass, message: this.message, ruleIds: this.ruleIds };
+        return {
+            code: this.code,
+            errorClass: this.errorClass,
+            message: this.message,
+            ruleIds: this.ruleIds,
+        };
     }
 }
 exports.PricingEngineError = PricingEngineError;

package/dist/cjs/pricing-engine/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/pricing-engine/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA6BH,MAAM,WAAW,GAAgD;IAC/D,2BAA2B,EAAE,eAAe;IAC5C,iBAAiB,EAAE,YAAY;IAC/B,kBAAkB,EAAE,YAAY;IAChC,mBAAmB,EAAE,WAAW;IAChC,mBAAmB,EAAE,UAAU;IAC/B,gBAAgB,EAAE,eAAe;IACjC,uBAAuB,EAAE,WAAW;IACpC,gBAAgB,EAAE,YAAY;IAC9B,gBAAgB,EAAE,sBAAsB;IACxC,qBAAqB,EAAE,YAAY;IACnC,mBAAmB,EAAE,UAAU;IAC/B,mBAAmB,EAAE,YAAY;IACjC,6BAA6B,EAAE,eAAe;IAC9C,oBAAoB,EAAE,eAAe;IACrC,qBAAqB,EAAE,WAAW;IAClC,wBAAwB,EAAE,YAAY;CACvC,CAAC;AAEF,MAAa,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAmB;IACvB,UAAU,CAAoB;IACvC,2EAA2E;IAClE,OAAO,CAAW;IAE3B,YAAY,IAAsB,EAAE,OAAe,EAAE,UAAoB,EAAE;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACxG,CAAC;CACF;AAjBD,gDAiBC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/pricing-engine/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA8BH,MAAM,WAAW,GAAgD;IAC/D,2BAA2B,EAAE,eAAe;IAC5C,iBAAiB,EAAE,YAAY;IAC/B,kBAAkB,EAAE,YAAY;IAChC,mBAAmB,EAAE,WAAW;IAChC,mBAAmB,EAAE,UAAU;IAC/B,gBAAgB,EAAE,eAAe;IACjC,uBAAuB,EAAE,WAAW;IACpC,gBAAgB,EAAE,YAAY;IAC9B,gBAAgB,EAAE,sBAAsB;IACxC,qBAAqB,EAAE,YAAY;IACnC,mBAAmB,EAAE,UAAU;IAC/B,mBAAmB,EAAE,YAAY;IACjC,6BAA6B,EAAE,eAAe;IAC9C,oBAAoB,EAAE,eAAe;IACrC,qBAAqB,EAAE,WAAW;IAClC,wBAAwB,EAAE,YAAY;CACvC,CAAC;AAEF,MAAa,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAmB;IACvB,UAAU,CAAoB;IACvC,2EAA2E;IAClE,OAAO,CAAW;IAE3B,YAAY,IAAsB,EAAE,OAAe,EAAE,UAAoB,EAAE;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM;QAMJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AA3BD,gDA2BC"}

package/dist/cjs/pricing-engine/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compareQuotes = exports.normalizeCanonicalQuote = exports.computePricingQuote = exports.computeProration = exports.resolveBundleDiscount = exports.freeModuleCodesForBundle = exports.assertBundleModulesCovered = exports.PRICING_RULE_STEPS_IN_ORDER = exports.PRICING_ENGINE_VERSION = exports.PricingEngineError = exports.clampNonNegative = exports.prorateByDays = exports.applyPercent = exports.multiplyByQuantity = exports.subtractCents = exports.addCents = exports.centsToReais = exports.reaisToCents = exports.roundHalfEven = void 0;
+exports.runShadowComparison = exports.computeShadowMetrics = exports.categorizeDiffs = exports.normalizeLegacyQuote = exports.toPricingRequest = exports.STORAGE_ADDON_TARGET_CODE = exports.compareQuotes = exports.normalizeCanonicalQuote = exports.computePricingQuote = exports.computeProration = exports.resolveBundleDiscount = exports.freeModuleCodesForBundle = exports.assertBundleModulesCovered = exports.PRICING_RULE_STEPS_IN_ORDER = exports.PRICING_ENGINE_VERSION = exports.PricingEngineError = exports.clampNonNegative = exports.prorateByDays = exports.applyPercent = exports.multiplyByQuantity = exports.subtractCents = exports.addCents = exports.centsToReais = exports.reaisToCents = exports.roundHalfEven = void 0;
 var money_js_1 = require("./money.js");
 Object.defineProperty(exports, "roundHalfEven", { enumerable: true, get: function () { return money_js_1.roundHalfEven; } });
 Object.defineProperty(exports, "reaisToCents", { enumerable: true, get: function () { return money_js_1.reaisToCents; } });
@@ -27,4 +27,15 @@ Object.defineProperty(exports, "computePricingQuote", { enumerable: true, get: f
 var shadow_js_1 = require("./shadow.js");
 Object.defineProperty(exports, "normalizeCanonicalQuote", { enumerable: true, get: function () { return shadow_js_1.normalizeCanonicalQuote; } });
 Object.defineProperty(exports, "compareQuotes", { enumerable: true, get: function () { return shadow_js_1.compareQuotes; } });
+var shadow_adapter_js_1 = require("./shadow-adapter.js");
+Object.defineProperty(exports, "STORAGE_ADDON_TARGET_CODE", { enumerable: true, get: function () { return shadow_adapter_js_1.STORAGE_ADDON_TARGET_CODE; } });
+Object.defineProperty(exports, "toPricingRequest", { enumerable: true, get: function () { return shadow_adapter_js_1.toPricingRequest; } });
+var shadow_normalizer_js_1 = require("./shadow-normalizer.js");
+Object.defineProperty(exports, "normalizeLegacyQuote", { enumerable: true, get: function () { return shadow_normalizer_js_1.normalizeLegacyQuote; } });
+var shadow_diff_js_1 = require("./shadow-diff.js");
+Object.defineProperty(exports, "categorizeDiffs", { enumerable: true, get: function () { return shadow_diff_js_1.categorizeDiffs; } });
+var shadow_metrics_js_1 = require("./shadow-metrics.js");
+Object.defineProperty(exports, "computeShadowMetrics", { enumerable: true, get: function () { return shadow_metrics_js_1.computeShadowMetrics; } });
+var shadow_facade_js_1 = require("./shadow-facade.js");
+Object.defineProperty(exports, "runShadowComparison", { enumerable: true, get: function () { return shadow_facade_js_1.runShadowComparison; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/pricing-engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pricing-engine/index.ts"],"names":[],"mappings":";;;AACA,uCAUoB;AATlB,yGAAA,aAAa,OAAA;AACb,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AACZ,oGAAA,QAAQ,OAAA;AACR,yGAAA,aAAa,OAAA;AACb,8GAAA,kBAAkB,OAAA;AAClB,wGAAA,YAAY,OAAA;AACZ,yGAAA,aAAa,OAAA;AACb,4GAAA,gBAAgB,OAAA;AAIlB,yCAAiD;AAAxC,+GAAA,kBAAkB,OAAA;AAsB3B,uCAAiF;AAAxE,kHAAA,sBAAsB,OAAA;AAAE,uHAAA,2BAA2B,OAAA;AAE5D,yCAA0G;AAAjG,uHAAA,0BAA0B,OAAA;AAAE,qHAAA,wBAAwB,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AACpF,+CAAkD;AAAzC,gHAAA,gBAAgB,OAAA;AACzB,6CAAoD;AAA3C,kHAAA,mBAAmB,OAAA;AAG5B,yCAAqE;AAA5D,oHAAA,uBAAuB,OAAA;AAAE,0GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pricing-engine/index.ts"],"names":[],"mappings":";;;AACA,uCAUoB;AATlB,yGAAA,aAAa,OAAA;AACb,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AACZ,oGAAA,QAAQ,OAAA;AACR,yGAAA,aAAa,OAAA;AACb,8GAAA,kBAAkB,OAAA;AAClB,wGAAA,YAAY,OAAA;AACZ,yGAAA,aAAa,OAAA;AACb,4GAAA,gBAAgB,OAAA;AAIlB,yCAAiD;AAAxC,+GAAA,kBAAkB,OAAA;AAsB3B,uCAAiF;AAAxE,kHAAA,sBAAsB,OAAA;AAAE,uHAAA,2BAA2B,OAAA;AAE5D,yCAIqB;AAHnB,uHAAA,0BAA0B,OAAA;AAC1B,qHAAA,wBAAwB,OAAA;AACxB,kHAAA,qBAAqB,OAAA;AAEvB,+CAAkD;AAAzC,gHAAA,gBAAgB,OAAA;AACzB,6CAAoD;AAA3C,kHAAA,mBAAmB,OAAA;AAQ5B,yCAAqE;AAA5D,oHAAA,uBAAuB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAgB/C,yDAAkF;AAAzE,8HAAA,yBAAyB,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AACpD,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,mDAAmD;AAA1C,iHAAA,eAAe,OAAA;AAExB,yDAA2D;AAAlD,yHAAA,oBAAoB,OAAA;AAE7B,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA"}