@baruk/core 0.1.0 → 0.2.0

package/dist/pricing-engine/money.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Money — contrato monetário seguro do Pricing Engine (RFC-CAPABILITY-PRICING-
+ * ENGINE-001 §4, herdado de RFC-CAPABILITY-MERCHANT-BILLING-CORE-001 §5).
+ *
+ * Unidade mínima: CENTAVOS, sempre inteiro. Nenhuma fração é acumulada sem
+ * arredondar — cada operação que introduz fração (percentual, prorata por
+ * dias) arredonda IMEDIATAMENTE por half-even (bankers') no ponto de uso.
+ * Isto é o que garante "arredondamento uma vez, no fim" nas somas finais: as
+ * frações já foram eliminadas antes de somar.
+ *
+ * Reutilizado por bundle.ts, coupon.ts, proration.ts e pipeline.ts — nenhum
+ * outro Money é criado em `@baruk/core` (nem o `ChargeRecord.amount`/
+ * `CommercialPriceItem.amount` existentes, que guardam REAIS como
+ * conveniência de schema, nem um terceiro tipo). Este módulo é o único que
+ * precisa de aritmética encadeada (percentual → prorata → soma), por isso é
+ * o único ponto onde a disciplina de centavos inteiros se paga.
+ */
+export type Cents = number;
+/** Arredondamento half-even (bankers') — determinístico, não depende de ordem de chamadas. */
+export declare function roundHalfEven(value: number): number;
+export declare function reaisToCents(reais: number): Cents;
+export declare function centsToReais(cents: Cents): number;
+export declare function addCents(...values: Cents[]): Cents;
+export declare function subtractCents(a: Cents, b: Cents): Cents;
+/** Multiplica por uma quantidade inteira (assentos, unidades) — sem fração, nada a arredondar. */
+export declare function multiplyByQuantity(cents: Cents, quantity: number): Cents;
+/** Aplica um percentual (0-100) com arredondamento half-even no ponto de aplicação. */
+export declare function applyPercent(cents: Cents, percent: number): Cents;
+/** Prorata por fração de dias — arredondamento half-even no ponto de aplicação. */
+export declare function prorateByDays(cents: Cents, daysNumerator: number, daysDenominator: number): Cents;
+export declare function clampNonNegative(cents: Cents): Cents;
+//# sourceMappingURL=money.d.ts.map

package/dist/pricing-engine/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../src/pricing-engine/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAEjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEjD;AAED,wBAAgB,QAAQ,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAElD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK,CAEvD;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAExE;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAEjE;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,CAKjG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAEpD"}

package/dist/pricing-engine/money.js

@@ -0,0 +1,58 @@
+/**
+ * Money — contrato monetário seguro do Pricing Engine (RFC-CAPABILITY-PRICING-
+ * ENGINE-001 §4, herdado de RFC-CAPABILITY-MERCHANT-BILLING-CORE-001 §5).
+ *
+ * Unidade mínima: CENTAVOS, sempre inteiro. Nenhuma fração é acumulada sem
+ * arredondar — cada operação que introduz fração (percentual, prorata por
+ * dias) arredonda IMEDIATAMENTE por half-even (bankers') no ponto de uso.
+ * Isto é o que garante "arredondamento uma vez, no fim" nas somas finais: as
+ * frações já foram eliminadas antes de somar.
+ *
+ * Reutilizado por bundle.ts, coupon.ts, proration.ts e pipeline.ts — nenhum
+ * outro Money é criado em `@baruk/core` (nem o `ChargeRecord.amount`/
+ * `CommercialPriceItem.amount` existentes, que guardam REAIS como
+ * conveniência de schema, nem um terceiro tipo). Este módulo é o único que
+ * precisa de aritmética encadeada (percentual → prorata → soma), por isso é
+ * o único ponto onde a disciplina de centavos inteiros se paga.
+ */
+/** Arredondamento half-even (bankers') — determinístico, não depende de ordem de chamadas. */
+export function roundHalfEven(value) {
+    const floor = Math.floor(value);
+    const diff = value - floor;
+    if (diff < 0.5)
+        return floor;
+    if (diff > 0.5)
+        return floor + 1;
+    return floor % 2 === 0 ? floor : floor + 1;
+}
+export function reaisToCents(reais) {
+    return roundHalfEven(reais * 100);
+}
+export function centsToReais(cents) {
+    return cents / 100;
+}
+export function addCents(...values) {
+    return values.reduce((sum, v) => sum + v, 0);
+}
+export function subtractCents(a, b) {
+    return a - b;
+}
+/** Multiplica por uma quantidade inteira (assentos, unidades) — sem fração, nada a arredondar. */
+export function multiplyByQuantity(cents, quantity) {
+    return cents * quantity;
+}
+/** Aplica um percentual (0-100) com arredondamento half-even no ponto de aplicação. */
+export function applyPercent(cents, percent) {
+    return roundHalfEven((cents * percent) / 100);
+}
+/** Prorata por fração de dias — arredondamento half-even no ponto de aplicação. */
+export function prorateByDays(cents, daysNumerator, daysDenominator) {
+    if (daysDenominator <= 0) {
+        throw new Error('prorateByDays: daysDenominator deve ser positivo.');
+    }
+    return roundHalfEven((cents * daysNumerator) / daysDenominator);
+}
+export function clampNonNegative(cents) {
+    return Math.max(0, cents);
+}
+//# sourceMappingURL=money.js.map

package/dist/pricing-engine/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../src/pricing-engine/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,8FAA8F;AAC9F,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;IAC3B,IAAI,IAAI,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,IAAI,GAAG,GAAG;QAAE,OAAO,KAAK,GAAG,CAAC,CAAC;IACjC,OAAO,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,aAAa,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,OAAO,KAAK,GAAG,GAAG,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAG,MAAe;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAQ,EAAE,CAAQ;IAC9C,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,KAAY,EAAE,QAAgB;IAC/D,OAAO,KAAK,GAAG,QAAQ,CAAC;AAC1B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,OAAe;IACxD,OAAO,aAAa,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,aAAqB,EAAE,eAAuB;IACxF,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,aAAa,CAAC,CAAC,KAAK,GAAG,aAAa,CAAC,GAAG,eAAe,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/pricing-engine/pipeline.d.ts

@@ -0,0 +1,3 @@
+import { type EngineResult, type PricingQuote, type PricingRequest } from './types.js';
+export declare function computePricingQuote(request: PricingRequest): EngineResult<PricingQuote>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pricing-engine/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pricing-engine/pipeline.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,YAAY,EAGjB,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAoHpB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,CAOvF"}

package/dist/pricing-engine/pipeline.js

@@ -0,0 +1,327 @@
+import { createHash } from 'node:crypto';
+import { addCents, applyPercent, clampNonNegative, multiplyByQuantity, reaisToCents, subtractCents } from './money.js';
+import { PricingEngineError } from './errors.js';
+import { assertBundleModulesCovered, freeModuleCodesForBundle, resolveBundleDiscount } from './bundle.js';
+import { PRICING_ENGINE_VERSION, } from './types.js';
+/**
+ * Pipeline determinístico do Pricing Engine (RFC-CAPABILITY-PRICING-ENGINE-001
+ * §8, ETAPA 5). A ordem abaixo é a ORDEM OFICIAL DA RFC (não a restatada na
+ * ETAPA 5 do prompt de implementação, que diverge em 2 pontos — ver
+ * correspondência documentada em RFC-CAPABILITY-PRICING-ENGINE-001 §8 e no
+ * relatório de entrega): 1.plano 2.módulo 3.quantidade 4.add-on 5.bundle
+ * 6.desconto negociado (percentual, cumulativo) 7.cupom 8.campanha
+ * 9.crédito promocional (reservado) 10.contrato negociado/grandfathering
+ * (FIXA/SOBREPÕE) 11.impostos 12.arredondamento.
+ *
+ * Cada etapa 5-8 opera SEQUENCIALMENTE sobre o total corrente ("sobre o
+ * resultado até aqui", RFC §8 passo 7) — não sobre a base original — porque
+ * a ordem já é fixa e explícita (a RFC elimina ambiguidade por ORDEM, não por
+ * uma base comum). Erros de contrato são sempre RETORNADOS
+ * (`EngineResult`), nunca lançados na fronteira pública (RFC §2/§7) —
+ * internamente usamos `throw PricingEngineError` e capturamos em
+ * `computePricingQuote`.
+ */
+function fingerprintOf(request) {
+    const basis = {
+        tenantId: request.tenantId,
+        productLine: request.productLine,
+        offerCode: request.offer.code,
+        planCode: request.plan.code,
+        moduleCodes: [...request.offer.moduleCodes].sort(),
+        bundleCodes: [...request.offer.bundleCodes].sort(),
+        addonCodes: [...request.offer.addonCodes].sort(),
+        priceTableCode: request.priceTable.code,
+        priceTableVersion: request.priceTable.version,
+        billingCycle: request.billingCycle,
+        extraSeats: request.extraSeats ?? 0,
+        addonQuantities: request.addonQuantities ?? {},
+        couponCode: request.coupon?.code ?? null,
+        campaignCode: request.campaign?.code ?? null,
+        negotiatedContractTenantId: request.negotiatedContract?.tenantId ?? null,
+        negotiatedDiscountPercent: request.negotiatedContract?.discountPercent ?? null,
+        negotiatedFixedTotalCents: request.negotiatedContract?.fixedTotalCents ?? null,
+        trialActive: request.trial?.active ?? false,
+        now: request.now,
+    };
+    return createHash('sha256').update(JSON.stringify(basis)).digest('hex');
+}
+function catalogFingerprint(plan, modules, bundles) {
+    const basis = {
+        plan: { code: plan.code, tier: plan.tier, franchises: plan.franchises },
+        modules: modules.map((m) => ({ code: m.code, class: m.class })).sort((a, b) => a.code.localeCompare(b.code)),
+        bundles: bundles
+            .map((b) => ({ code: b.code, moduleCodes: [...b.moduleCodes].sort() }))
+            .sort((a, b) => a.code.localeCompare(b.code)),
+    };
+    return createHash('sha256').update(JSON.stringify(basis)).digest('hex');
+}
+function addHours(iso, hours) {
+    const d = /^\d{4}-\d{2}-\d{2}$/.test(iso) ? new Date(`${iso}T00:00:00Z`) : new Date(iso);
+    d.setUTCHours(d.getUTCHours() + hours);
+    return d.toISOString();
+}
+function itemOf(origin, targetCode, quantity, unitPriceCents, subtotalCents) {
+    return { origin, targetCode, quantity, unitPriceCents, subtotalCents: subtotalCents ?? unitPriceCents * quantity };
+}
+/**
+ * Busca o preço por `targetType`+`targetCode` **filtrado pelo `billingCycle`**
+ * (mensal/anual) — o mesmo `targetCode` pode ter duas entradas na tabela
+ * (`interval: 'monthly'` e `interval: 'yearly'`), e ignorar `interval` faria
+ * o lookup pegar a primeira entrada arbitrária (bug real corrigido antes dos
+ * cenários Rep/Ind da ETAPA 12, que exigem cotação mensal E anual).
+ */
+function findPriceItemReais(table, targetType, targetCode, billingCycle) {
+    const item = table.items.find((i) => i.targetType === targetType && i.targetCode === targetCode && i.interval === billingCycle);
+    if (!item) {
+        throw new PricingEngineError('price-rule-missing', `Sem preço para ${targetType}:${targetCode} (ciclo=${billingCycle}) na tabela "${table.code}" v${table.version}.`);
+    }
+    return item.amount;
+}
+/**
+ * Aplicabilidade de escopo (RFC §16.1 divergência #1 — o que `resolvePriceQuote`
+ * mínimo do Catálogo NÃO faz). `scopes` é declarado na TABELA (não por item —
+ * `CommercialPriceItem` não tem campo de escopo); interpretação: tabela sem
+ * `scopes` = ALL (compatível com o resolvedor mínimo); com `scopes`, aplica-se
+ * se QUALQUER escopo casar (TENANT por `tenantId`, PRODUCT_LINE por
+ * `productLine`, ALL sempre casa). SEGMENT nunca casa nesta fase (sem contexto
+ * de segmento no `PricingRequest` — decisão explícita, não um bug silencioso).
+ */
+function isTableApplicable(table, tenantId, productLine) {
+    if (!table.scopes || table.scopes.length === 0)
+        return true;
+    return table.scopes.some((s) => {
+        if (s.scopeType === 'ALL')
+            return true;
+        if (s.scopeType === 'TENANT')
+            return s.matchValue === tenantId;
+        if (s.scopeType === 'PRODUCT_LINE')
+            return s.matchValue === productLine;
+        return false;
+    });
+}
+function mustFindModule(modules, code) {
+    const mod = modules.find((m) => m.code === code);
+    if (!mod)
+        throw new PricingEngineError('price-rule-missing', `Módulo "${code}" não existe no catálogo recebido.`);
+    return mod;
+}
+function mustFindBundle(bundles, code) {
+    const bundle = bundles.find((b) => b.code === code);
+    if (!bundle)
+        throw new PricingEngineError('invalid-bundle', `Bundle "${code}" não existe no catálogo recebido.`);
+    return bundle;
+}
+export function computePricingQuote(request) {
+    try {
+        return { ok: true, value: computeInternal(request) };
+    }
+    catch (err) {
+        if (err instanceof PricingEngineError)
+            return { ok: false, error: err.toJSON() };
+        throw err;
+    }
+}
+function computeInternal(request) {
+    const { tenantId, productLine, offer, plan, modules, bundles, priceTable, bundleRules = [], extraSeats = 0, addonQuantities = {}, negotiatedContract, coupon, campaign, trial, now, billingCycle, quoteValidityHours = 24, } = request;
+    if (priceTable.code !== offer.priceTableCode) {
+        throw new PricingEngineError('price-rule-missing', `Offer "${offer.code}" referencia a tabela "${offer.priceTableCode}", recebida "${priceTable.code}".`);
+    }
+    if (priceTable.status !== 'active') {
+        throw new PricingEngineError('catalog-version-not-found', `Tabela "${priceTable.code}" não está ativa (status="${priceTable.status}").`);
+    }
+    if (now < priceTable.effectiveFrom || (priceTable.effectiveTo != null && now > priceTable.effectiveTo)) {
+        throw new PricingEngineError('invalid-effective-date', `Tabela "${priceTable.code}" fora de vigência em ${now}.`);
+    }
+    if (!isTableApplicable(priceTable, tenantId, productLine)) {
+        throw new PricingEngineError('catalog-version-not-found', `Tabela "${priceTable.code}" não se aplica ao escopo tenant="${tenantId}"/productLine="${productLine}".`);
+    }
+    if (negotiatedContract && (now < negotiatedContract.validFrom || (negotiatedContract.validTo != null && now > negotiatedContract.validTo))) {
+        throw new PricingEngineError('negotiated-contract-invalid', `Contrato negociado do tenant "${negotiatedContract.tenantId}" fora de vigência em ${now}.`);
+    }
+    const warnings = [];
+    const appliedRules = [];
+    const items = [];
+    // Passo 1 — BASE_PLAN_PRICE
+    items.push(itemOf('plan', offer.planCode, 1, reaisToCents(findPriceItemReais(priceTable, 'PLAN', offer.planCode, billingCycle))));
+    appliedRules.push('BASE_PLAN_PRICE');
+    // Módulos free_module de bundle precisam ser conhecidos ANTES de precificar (passo 2 não pode cobrar 2x depois descontar).
+    const freeModuleCodes = new Set();
+    for (const bundleCode of offer.bundleCodes) {
+        const bundle = mustFindBundle(bundles, bundleCode);
+        const rule = bundleRules.find((r) => r.bundleCode === bundleCode);
+        for (const code of freeModuleCodesForBundle(bundle, rule))
+            freeModuleCodes.add(code);
+    }
+    // Passo 2 — MODULE_PRICE
+    const chargedModuleCodes = new Set();
+    for (const moduleCode of offer.moduleCodes) {
+        mustFindModule(modules, moduleCode);
+        if (chargedModuleCodes.has(moduleCode)) {
+            throw new PricingEngineError('duplicate-charge-item', `Módulo "${moduleCode}" duplicado na oferta "${offer.code}".`);
+        }
+        chargedModuleCodes.add(moduleCode);
+        const unitCents = freeModuleCodes.has(moduleCode) ? 0 : reaisToCents(findPriceItemReais(priceTable, 'MODULE', moduleCode, billingCycle));
+        items.push(itemOf('module', moduleCode, 1, unitCents));
+    }
+    if (offer.moduleCodes.length > 0)
+        appliedRules.push('MODULE_PRICE');
+    // Passo 3 — QUANTITY_PRICE (assentos excedentes da franquia — delta já calculado pelo consumidor)
+    if (extraSeats > 0) {
+        const unitCents = reaisToCents(findPriceItemReais(priceTable, 'SEAT', 'extra_seat', billingCycle));
+        items.push(itemOf('seat', 'extra_seat', extraSeats, unitCents, multiplyByQuantity(unitCents, extraSeats)));
+        appliedRules.push('QUANTITY_PRICE');
+    }
+    // Passo 4 — ADDON_PRICE
+    for (const addonCode of offer.addonCodes) {
+        const qty = addonQuantities[addonCode] ?? 1;
+        const unitCents = reaisToCents(findPriceItemReais(priceTable, 'ADDON', addonCode, billingCycle));
+        items.push(itemOf('addon', addonCode, qty, unitCents, multiplyByQuantity(unitCents, qty)));
+    }
+    if (offer.addonCodes.length > 0)
+        appliedRules.push('ADDON_PRICE');
+    const subtotalCents = addCents(...items.map((i) => i.subtotalCents));
+    const discounts = [];
+    let runningCents = subtotalCents;
+    // Exclusividade (§8): cupom/campanha `exclusive` suprime bundle+desconto negociado (passos 5/6).
+    // Dois exclusivos → prioridade explícita decide; empate → erro (nunca escolha silenciosa).
+    const exclusiveCandidates = [];
+    if (coupon?.exclusive)
+        exclusiveCandidates.push({ key: 'coupon', priority: coupon.priority ?? 0, code: coupon.code });
+    if (campaign?.exclusive)
+        exclusiveCandidates.push({ key: 'campaign', priority: campaign.priority ?? 0, code: campaign.code });
+    let suppressBundleAndNegotiated = false;
+    let ignoredExclusiveKey = null;
+    if (exclusiveCandidates.length === 1) {
+        suppressBundleAndNegotiated = true;
+    }
+    else if (exclusiveCandidates.length === 2) {
+        const a = exclusiveCandidates[0];
+        const b = exclusiveCandidates[1];
+        if (a.priority === b.priority) {
+            throw new PricingEngineError('conflicting-rules', `Cupom "${a.code}" e campanha "${b.code}" são ambos exclusivos com a mesma prioridade (${a.priority}) — conflito não resolvível automaticamente.`, [a.code, b.code]);
+        }
+        suppressBundleAndNegotiated = true;
+        ignoredExclusiveKey = a.priority > b.priority ? 'campaign' : 'coupon';
+    }
+    // Passo 5 — BUNDLE_DISCOUNT
+    if (offer.bundleCodes.length > 0) {
+        for (const bundleCode of offer.bundleCodes) {
+            assertBundleModulesCovered(mustFindBundle(bundles, bundleCode), chargedModuleCodes);
+        }
+    }
+    if (!suppressBundleAndNegotiated) {
+        for (const bundleCode of offer.bundleCodes) {
+            const bundle = mustFindBundle(bundles, bundleCode);
+            const rule = bundleRules.find((r) => r.bundleCode === bundleCode);
+            const amount = resolveBundleDiscount(bundle, rule, items);
+            if (amount != null && amount > 0) {
+                const applied = Math.min(amount, runningCents);
+                discounts.push({ ruleId: bundleCode, step: 'BUNDLE_DISCOUNT', kind: 'bundle', amountCents: applied, appliesTo: bundle.moduleCodes });
+                runningCents = subtractCents(runningCents, applied);
+            }
+        }
+        if (offer.bundleCodes.length > 0)
+            appliedRules.push('BUNDLE_DISCOUNT');
+    }
+    else if (offer.bundleCodes.length > 0) {
+        warnings.push('Desconto de bundle suprimido: regra exclusiva de cupom/campanha está ativa.');
+    }
+    // Passo 6 — NEGOTIATED_DISCOUNT (percentual, cumulativo — distinto do override do passo 10)
+    if (negotiatedContract?.discountPercent != null) {
+        if (!suppressBundleAndNegotiated) {
+            const amount = applyPercent(runningCents, negotiatedContract.discountPercent);
+            const applied = Math.min(amount, runningCents);
+            discounts.push({
+                ruleId: `negotiated:${tenantId}`,
+                step: 'NEGOTIATED_DISCOUNT',
+                kind: 'negotiated_percent',
+                amountCents: applied,
+                appliesTo: ['*'],
+            });
+            runningCents = subtractCents(runningCents, applied);
+            appliedRules.push('NEGOTIATED_DISCOUNT');
+        }
+        else {
+            warnings.push('Desconto negociado (percentual) suprimido por regra exclusiva de cupom/campanha.');
+        }
+    }
+    // Passo 7 — COUPON (sobre o resultado até aqui — RFC §8)
+    if (coupon) {
+        if (ignoredExclusiveKey !== 'coupon') {
+            const raw = coupon.effectType === 'percent_off' ? applyPercent(runningCents, coupon.percentOff ?? 0) : (coupon.amountOffCents ?? 0);
+            const applied = Math.min(Math.max(raw, 0), runningCents);
+            discounts.push({ ruleId: coupon.code, step: 'COUPON', kind: coupon.effectType, amountCents: applied, appliesTo: ['*'] });
+            runningCents = subtractCents(runningCents, applied);
+            appliedRules.push('COUPON');
+        }
+        else {
+            warnings.push(`Cupom "${coupon.code}" ignorado: campanha exclusiva de maior prioridade está ativa.`);
+        }
+    }
+    // Passo 8 — CAMPAIGN
+    if (campaign) {
+        if (ignoredExclusiveKey !== 'campaign') {
+            const raw = campaign.effectType === 'percent_off' ? applyPercent(runningCents, campaign.percentOff ?? 0) : (campaign.amountOffCents ?? 0);
+            const applied = Math.min(Math.max(raw, 0), runningCents);
+            discounts.push({ ruleId: campaign.code, step: 'CAMPAIGN', kind: campaign.effectType, amountCents: applied, appliesTo: ['*'] });
+            runningCents = subtractCents(runningCents, applied);
+            appliedRules.push('CAMPAIGN');
+        }
+        else {
+            warnings.push(`Campanha "${campaign.code}" ignorada: cupom exclusivo de maior prioridade está ativa.`);
+        }
+    }
+    // Passo 9 — PROMOTIONAL_CREDIT (reservado — só preenchido quando Wallet/Rating existirem, RFC §12)
+    const promotionalCreditsCents = 0;
+    appliedRules.push('PROMOTIONAL_CREDIT');
+    // Passo 10 — CONTRACT_OVERRIDE_OR_GRANDFATHERING (fixa/sobrepõe o total — nunca um desconto adicional)
+    if (negotiatedContract?.fixedTotalCents != null) {
+        runningCents = negotiatedContract.fixedTotalCents;
+        appliedRules.push('CONTRACT_OVERRIDE_OR_GRANDFATHERING');
+    }
+    runningCents = clampNonNegative(runningCents);
+    const totalDiscountCents = clampNonNegative(subtractCents(subtotalCents, runningCents));
+    // Passo 11 — TAX (MVP: passthrough/zero configurável — política fiscal fora do escopo, RFC §5)
+    const taxes = [];
+    const totalTaxCents = 0;
+    appliedRules.push('TAX');
+    // Passo 12 — ROUNDING (cada etapa já arredondou half-even no ponto de uso — nada fracionário resta a arredondar)
+    const totalBeforeTrial = addCents(runningCents, totalTaxCents);
+    appliedRules.push('ROUNDING');
+    const trialActive = trial?.active ?? false;
+    const totalCents = trialActive ? 0 : totalBeforeTrial;
+    const postTrialTotalCents = trialActive ? totalBeforeTrial : null;
+    const fingerprint = fingerprintOf(request);
+    const quoteId = `pq_${fingerprint.slice(0, 24)}`;
+    return {
+        quoteId,
+        engineVersion: PRICING_ENGINE_VERSION,
+        tenantId,
+        productLine,
+        offerCode: offer.code,
+        priceTableCode: priceTable.code,
+        priceTableVersion: priceTable.version,
+        catalogVersion: catalogFingerprint(plan, modules, bundles),
+        pricingPolicyVersion: PRICING_ENGINE_VERSION,
+        currency: priceTable.currency,
+        now,
+        effectiveAt: now,
+        expiresAt: addHours(now, quoteValidityHours),
+        items,
+        discounts,
+        taxes,
+        promotionalCreditsCents,
+        subtotalCents,
+        totalDiscountCents,
+        totalTaxCents,
+        totalCents,
+        postTrialTotalCents,
+        trial: trial ?? null,
+        appliedRules,
+        warnings,
+        fingerprint,
+        auditMetadata: {},
+        proration: null,
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pricing-engine/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/pricing-engine/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AACnI,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC1G,OAAO,EACL,sBAAsB,GAQvB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;GAiBG;AAEH,SAAS,aAAa,CAAC,OAAuB;IAC5C,MAAM,KAAK,GAAG;QACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI;QAC7B,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI;QAC3B,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE;QAClD,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE;QAClD,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE;QAChD,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI;QACvC,iBAAiB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO;QAC7C,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;QACnC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,EAAE;QAC9C,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI;QACxC,YAAY,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,IAAI;QAC5C,0BAA0B,EAAE,OAAO,CAAC,kBAAkB,EAAE,QAAQ,IAAI,IAAI;QACxE,yBAAyB,EAAE,OAAO,CAAC,kBAAkB,EAAE,eAAe,IAAI,IAAI;QAC9E,yBAAyB,EAAE,OAAO,CAAC,kBAAkB,EAAE,eAAe,IAAI,IAAI;QAC9E,WAAW,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK;QAC3C,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;IACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,kBAAkB,CAAC,IAA4B,EAAE,OAAuB,EAAE,OAAuB;IACxG,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;QACvE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5G,OAAO,EAAE,OAAO;aACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;aACtE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;KAChD,CAAC;IACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,KAAa;IAC1C,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACzF,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,MAAM,CAAC,MAAkB,EAAE,UAAkB,EAAE,QAAgB,EAAE,cAAqB,EAAE,aAAqB;IACpH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;AACrH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,KAAmC,EAAE,UAAkB,EAAE,UAAkB,EAAE,YAAkC;IACzI,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;IAChI,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,EACpB,kBAAkB,UAAU,IAAI,UAAU,WAAW,YAAY,gBAAgB,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,GAAG,CAClH,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,KAAmC,EAAE,QAAgB,EAAE,WAAmB;IACnG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,IAAI,CAAC,CAAC,SAAS,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QACvC,IAAI,CAAC,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC;QAC/D,IAAI,CAAC,CAAC,SAAS,KAAK,cAAc;YAAE,OAAO,CAAC,CAAC,UAAU,KAAK,WAAW,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,OAAuB,EAAE,IAAY;IAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,EAAE,WAAW,IAAI,oCAAoC,CAAC,CAAC;IAClH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,OAAuB,EAAE,IAAY;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,WAAW,IAAI,oCAAoC,CAAC,CAAC;IACjH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACzD,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,kBAAkB;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACjF,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAuB;IAC9C,MAAM,EACJ,QAAQ,EACR,WAAW,EACX,KAAK,EACL,IAAI,EACJ,OAAO,EACP,OAAO,EACP,UAAU,EACV,WAAW,GAAG,EAAE,EAChB,UAAU,GAAG,CAAC,EACd,eAAe,GAAG,EAAE,EACpB,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,KAAK,EACL,GAAG,EACH,YAAY,EACZ,kBAAkB,GAAG,EAAE,GACxB,GAAG,OAAO,CAAC;IAEZ,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,cAAc,EAAE,CAAC;QAC7C,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,EACpB,UAAU,KAAK,CAAC,IAAI,0BAA0B,KAAK,CAAC,cAAc,gBAAgB,UAAU,CAAC,IAAI,IAAI,CACtG,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,kBAAkB,CAAC,2BAA2B,EAAE,WAAW,UAAU,CAAC,IAAI,6BAA6B,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;IAC3I,CAAC;IACD,IAAI,GAAG,GAAG,UAAU,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,IAAI,IAAI,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACvG,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,EAAE,WAAW,UAAU,CAAC,IAAI,yBAAyB,GAAG,GAAG,CAAC,CAAC;IACpH,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,kBAAkB,CAC1B,2BAA2B,EAC3B,WAAW,UAAU,CAAC,IAAI,qCAAqC,QAAQ,kBAAkB,WAAW,IAAI,CACzG,CAAC;IACJ,CAAC;IACD,IAAI,kBAAkB,IAAI,CAAC,GAAG,GAAG,kBAAkB,CAAC,SAAS,IAAI,CAAC,kBAAkB,CAAC,OAAO,IAAI,IAAI,IAAI,GAAG,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC3I,MAAM,IAAI,kBAAkB,CAC1B,6BAA6B,EAC7B,iCAAiC,kBAAkB,CAAC,QAAQ,yBAAyB,GAAG,GAAG,CAC5F,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAsB,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAuB,EAAE,CAAC;IAErC,4BAA4B;IAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,YAAY,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAClI,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAErC,2HAA2H;IAC3H,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QAClE,KAAK,MAAM,IAAI,IAAI,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC;YAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvF,CAAC;IAED,yBAAyB;IACzB,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC7C,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QAC3C,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACpC,IAAI,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,kBAAkB,CAAC,uBAAuB,EAAE,WAAW,UAAU,0BAA0B,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;QACvH,CAAC;QACD,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,kBAAkB,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QACzI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAEpE,kGAAkG;IAClG,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,YAAY,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;QACnG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3G,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACtC,CAAC;IAED,wBAAwB;IACxB,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,YAAY,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;QACjG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,kBAAkB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAElE,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IACrE,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,IAAI,YAAY,GAAG,aAAa,CAAC;IAEjC,iGAAiG;IACjG,2FAA2F;IAC3F,MAAM,mBAAmB,GAA0E,EAAE,CAAC;IACtG,IAAI,MAAM,EAAE,SAAS;QAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACtH,IAAI,QAAQ,EAAE,SAAS;QAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9H,IAAI,2BAA2B,GAAG,KAAK,CAAC;IACxC,IAAI,mBAAmB,GAAiC,IAAI,CAAC;IAC7D,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,2BAA2B,GAAG,IAAI,CAAC;IACrC,CAAC;SAAM,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAE,CAAC;QAClC,MAAM,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAE,CAAC;QAClC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,kBAAkB,CAC1B,mBAAmB,EACnB,UAAU,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,IAAI,kDAAkD,CAAC,CAAC,QAAQ,8CAA8C,EACjJ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CACjB,CAAC;QACJ,CAAC;QACD,2BAA2B,GAAG,IAAI,CAAC;QACnC,mBAAmB,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,CAAC;IAED,4BAA4B;IAC5B,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YAC3C,0BAA0B,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACjC,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC1D,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;gBAC/C,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;gBACrI,YAAY,GAAG,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzE,CAAC;SAAM,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAC/F,CAAC;IAED,4FAA4F;IAC5F,IAAI,kBAAkB,EAAE,eAAe,IAAI,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,2BAA2B,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAC/C,SAAS,CAAC,IAAI,CAAC;gBACb,MAAM,EAAE,cAAc,QAAQ,EAAE;gBAChC,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EAAE,OAAO;gBACpB,SAAS,EAAE,CAAC,GAAG,CAAC;aACjB,CAAC,CAAC;YACH,YAAY,GAAG,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACpD,YAAY,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC;YACpI,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YACzD,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzH,YAAY,GAAG,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACpD,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,IAAI,gEAAgE,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,mBAAmB,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,EAAE,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC;YAC1I,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YACzD,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/H,YAAY,GAAG,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACpD,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,IAAI,6DAA6D,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;IAED,mGAAmG;IACnG,MAAM,uBAAuB,GAAG,CAAC,CAAC;IAClC,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAExC,uGAAuG;IACvG,IAAI,kBAAkB,EAAE,eAAe,IAAI,IAAI,EAAE,CAAC;QAChD,YAAY,GAAG,kBAAkB,CAAC,eAAe,CAAC;QAClD,YAAY,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC3D,CAAC;IAED,YAAY,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,aAAa,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IAExF,+FAA+F;IAC/F,MAAM,KAAK,GAA0B,EAAE,CAAC;IACxC,MAAM,aAAa,GAAG,CAAC,CAAC;IACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzB,iHAAiH;IACjH,MAAM,gBAAgB,GAAG,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAC/D,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE9B,MAAM,WAAW,GAAG,KAAK,EAAE,MAAM,IAAI,KAAK,CAAC;IAC3C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACtD,MAAM,mBAAmB,GAAG,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;IAElE,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAEjD,OAAO;QACL,OAAO;QACP,aAAa,EAAE,sBAAsB;QACrC,QAAQ;QACR,WAAW;QACX,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,cAAc,EAAE,UAAU,CAAC,IAAI;QAC/B,iBAAiB,EAAE,UAAU,CAAC,OAAO;QACrC,cAAc,EAAE,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;QAC1D,oBAAoB,EAAE,sBAAsB;QAC5C,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,GAAG;QACH,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;QAC5C,KAAK;QACL,SAAS;QACT,KAAK;QACL,uBAAuB;QACvB,aAAa;QACb,kBAAkB;QAClB,aAAa;QACb,UAAU;QACV,mBAAmB;QACnB,KAAK,EAAE,KAAK,IAAI,IAAI;QACpB,YAAY;QACZ,QAAQ;QACR,WAAW;QACX,aAAa,EAAE,EAAE;QACjB,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/pricing-engine/proration.d.ts

@@ -0,0 +1,3 @@
+import type { ProrationInput, ProrationResult } from './types.js';
+export declare function computeProration(input: ProrationInput): ProrationResult;
+//# sourceMappingURL=proration.d.ts.map

package/dist/pricing-engine/proration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proration.d.ts","sourceRoot":"","sources":["../../src/pricing-engine/proration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AA+BnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CA6BvE"}

package/dist/pricing-engine/proration.js

@@ -0,0 +1,50 @@
+import { PricingEngineError } from './errors.js';
+import { prorateByDays, subtractCents } from './money.js';
+/**
+ * Proração (RFC §11, ETAPA 9) — PURA e determinística. Datas são sempre
+ * comparadas via `Date`/epoch-ms (nunca comparação frágil de string — mesma
+ * disciplina de `parseIso` do subscription-billing), o que resolve
+ * corretamente meses com dias diferentes, fim de mês e ano bissexto sem
+ * lógica de calendário adicional (a diferença em ms já contém isso).
+ */
+/** Aceita data pura (`YYYY-MM-DD`) ou datetime ISO completo (mesma normalização do subscription-billing/commercial-catalog). */
+function parseIso(iso) {
+    return /^\d{4}-\d{2}-\d{2}$/.test(iso) ? new Date(`${iso}T00:00:00Z`) : new Date(iso);
+}
+function daysBetween(a, b) {
+    return Math.round((parseIso(b).getTime() - parseIso(a).getTime()) / 86_400_000);
+}
+const DEFAULT_TIMING = {
+    upgrade: 'immediate',
+    add_module: 'immediate',
+    seats_up: 'immediate',
+    cycle_change: 'immediate',
+    reactivate: 'immediate',
+    downgrade: 'next_renewal',
+    remove_module: 'next_renewal',
+    seats_down: 'next_renewal',
+    cancel: 'immediate',
+};
+export function computeProration(input) {
+    const { reason, cycleStart, cycleEnd, now, oldValueCents, newValueCents } = input;
+    const daysInCycle = daysBetween(cycleStart, cycleEnd);
+    if (daysInCycle <= 0) {
+        throw new PricingEngineError('proration-invalid', `Ciclo inválido: "${cycleStart}" a "${cycleEnd}" não é um intervalo positivo.`);
+    }
+    const daysSinceStart = daysBetween(cycleStart, now);
+    if (daysSinceStart < 0) {
+        throw new PricingEngineError('proration-invalid', `Proração retroativa proibida: "now" (${now}) é anterior ao início do ciclo (${cycleStart}).`);
+    }
+    const timing = input.timingPolicy ?? DEFAULT_TIMING[reason];
+    const daysElapsed = Math.min(daysInCycle, daysSinceStart);
+    const daysRemaining = daysInCycle - daysElapsed;
+    if (timing === 'next_renewal') {
+        // Mudança só produz efeito no próximo ciclo — nenhum ajuste financeiro agora.
+        return { reason, effective: timing, daysRemaining, daysInCycle, creditCents: 0, debitCents: 0, netCents: 0 };
+    }
+    const creditCents = prorateByDays(oldValueCents, daysRemaining, daysInCycle);
+    const debitCents = reason === 'cancel' ? 0 : prorateByDays(newValueCents, daysRemaining, daysInCycle);
+    const netCents = subtractCents(debitCents, creditCents);
+    return { reason, effective: timing, daysRemaining, daysInCycle, creditCents, debitCents, netCents };
+}
+//# sourceMappingURL=proration.js.map

package/dist/pricing-engine/proration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proration.js","sourceRoot":"","sources":["../../src/pricing-engine/proration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D;;;;;;GAMG;AAEH,gIAAgI;AAChI,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,cAAc,GAAsD;IACxE,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,WAAW;IACvB,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,WAAW;IACzB,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,cAAc;IACzB,aAAa,EAAE,cAAc;IAC7B,UAAU,EAAE,cAAc;IAC1B,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAElF,MAAM,WAAW,GAAG,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,EAAE,oBAAoB,UAAU,QAAQ,QAAQ,gCAAgC,CAAC,CAAC;IACpI,CAAC;IACD,MAAM,cAAc,GAAG,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,kBAAkB,CAC1B,mBAAmB,EACnB,wCAAwC,GAAG,oCAAoC,UAAU,IAAI,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAEhD,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC9B,8EAA8E;QAC9E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC/G,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,aAAa,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,aAAa,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IACtG,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAExD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AACtG,CAAC"}

package/dist/pricing-engine/shadow.d.ts

@@ -0,0 +1,51 @@
+import type { Cents } from './money.js';
+import type { PricingQuote } from './types.js';
+/**
+ * Shadow Comparison — SOMENTE o contrato técnico (RFC-CAPABILITY-PRICING-
+ * ENGINE-001 §13, ETAPA 13). Compara a saída do Pricing Engine canônico
+ * contra uma saída normalizada equivalente (ex.: o cálculo vivo do
+ * `manga-verde-bi`), SEM integrar com `manga-verde-bi` nesta sessão, SEM
+ * cobrar, SEM escrever dado de produção — `compareQuotes` é uma função pura
+ * de diff sobre dois objetos já normalizados injetados pelo chamador. O
+ * adapter mvb→`NormalizedQuoteForComparison` é trabalho de P4 (fora do
+ * escopo P1-P3), não construído aqui.
+ */
+export type ShadowComparisonStatus = 'match' | 'mismatch' | 'not-comparable' | 'error';
+/** Forma normalizada e mínima necessária para comparar — tanto o canônico quanto o shadow devem produzir isto. */
+export interface NormalizedQuoteForComparison {
+    currency: string;
+    items: Array<{
+        targetCode: string;
+        amountCents: Cents;
+    }>;
+    totalDiscountCents: Cents;
+    totalCents: Cents;
+}
+export interface QuoteItemDiff {
+    targetCode: string;
+    canonicalCents: Cents | null;
+    shadowCents: Cents | null;
+    diffCents: Cents;
+}
+export interface ShadowComparisonResult {
+    status: ShadowComparisonStatus;
+    quoteId: string;
+    toleranceCents: Cents;
+    subtotalDiffCents: Cents;
+    discountDiffCents: Cents;
+    totalDiffCents: Cents;
+    itemDiffs: QuoteItemDiff[];
+    divergentRules: string[];
+    errorCode?: string;
+    errorMessage?: string;
+}
+export declare function normalizeCanonicalQuote(quote: PricingQuote): NormalizedQuoteForComparison;
+/**
+ * Compara canônico vs shadow. `toleranceCents` (default 0 — igualdade exata
+ * em centavos, RFC §13 "igualdade exata em centavos no total") permite uma
+ * folga configurável para cenários de arredondamento de terceiros ainda não
+ * alinhados. Divergência de decomposição é logada mesmo com total igual
+ * (`itemDiffs`), para achar regra faltante sem esperar o total divergir.
+ */
+export declare function compareQuotes(quoteId: string, canonical: NormalizedQuoteForComparison, shadow: NormalizedQuoteForComparison, toleranceCents?: Cents): ShadowComparisonResult;
+//# sourceMappingURL=shadow.d.ts.map

package/dist/pricing-engine/shadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/pricing-engine/shadow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;GASG;AAEH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,UAAU,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAEvF,kHAAkH;AAClH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IACzD,kBAAkB,EAAE,KAAK,CAAC;IAC1B,UAAU,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,KAAK,CAAC;IACtB,iBAAiB,EAAE,KAAK,CAAC;IACzB,iBAAiB,EAAE,KAAK,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC;IACtB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,4BAA4B,CAOzF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,4BAA4B,EACvC,MAAM,EAAE,4BAA4B,EACpC,cAAc,GAAE,KAAS,GACxB,sBAAsB,CAwCxB"}

package/dist/pricing-engine/shadow.js

@@ -0,0 +1,54 @@
+import { PricingEngineError } from './errors.js';
+export function normalizeCanonicalQuote(quote) {
+    return {
+        currency: quote.currency,
+        items: quote.items.map((i) => ({ targetCode: i.targetCode, amountCents: i.subtotalCents })),
+        totalDiscountCents: quote.totalDiscountCents,
+        totalCents: quote.totalCents,
+    };
+}
+/**
+ * Compara canônico vs shadow. `toleranceCents` (default 0 — igualdade exata
+ * em centavos, RFC §13 "igualdade exata em centavos no total") permite uma
+ * folga configurável para cenários de arredondamento de terceiros ainda não
+ * alinhados. Divergência de decomposição é logada mesmo com total igual
+ * (`itemDiffs`), para achar regra faltante sem esperar o total divergir.
+ */
+export function compareQuotes(quoteId, canonical, shadow, toleranceCents = 0) {
+    if (canonical.currency !== shadow.currency) {
+        const err = new PricingEngineError('currency-mismatch', `Moedas incompatíveis: canônico="${canonical.currency}", shadow="${shadow.currency}".`);
+        return {
+            status: 'not-comparable',
+            quoteId,
+            toleranceCents,
+            subtotalDiffCents: 0,
+            discountDiffCents: 0,
+            totalDiffCents: 0,
+            itemDiffs: [],
+            divergentRules: [],
+            errorCode: err.code,
+            errorMessage: err.message,
+        };
+    }
+    const targetCodes = new Set([...canonical.items.map((i) => i.targetCode), ...shadow.items.map((i) => i.targetCode)]);
+    const itemDiffs = [];
+    const divergentRules = [];
+    for (const targetCode of targetCodes) {
+        const canonicalItem = canonical.items.find((i) => i.targetCode === targetCode) ?? null;
+        const shadowItem = shadow.items.find((i) => i.targetCode === targetCode) ?? null;
+        const canonicalCents = canonicalItem?.amountCents ?? null;
+        const shadowCents = shadowItem?.amountCents ?? null;
+        const diffCents = (canonicalCents ?? 0) - (shadowCents ?? 0);
+        itemDiffs.push({ targetCode, canonicalCents, shadowCents, diffCents });
+        if (Math.abs(diffCents) > toleranceCents)
+            divergentRules.push(targetCode);
+    }
+    const subtotalCanonical = canonical.items.reduce((s, i) => s + i.amountCents, 0);
+    const subtotalShadow = shadow.items.reduce((s, i) => s + i.amountCents, 0);
+    const subtotalDiffCents = subtotalCanonical - subtotalShadow;
+    const discountDiffCents = canonical.totalDiscountCents - shadow.totalDiscountCents;
+    const totalDiffCents = canonical.totalCents - shadow.totalCents;
+    const status = Math.abs(totalDiffCents) <= toleranceCents && divergentRules.length === 0 ? 'match' : 'mismatch';
+    return { status, quoteId, toleranceCents, subtotalDiffCents, discountDiffCents, totalDiffCents, itemDiffs, divergentRules };
+}
+//# sourceMappingURL=shadow.js.map