@baruk/core 0.1.0 → 0.2.0

package/dist/commercial-catalog/catalog.js

@@ -0,0 +1,104 @@
+/**
+ * Resolução pura do Commercial Catalog — sem DB, sem `Date.now()` interno (o
+ * instante e a `productLine` já resolvida do tenant são sempre injetados pelo
+ * consumidor). Espelha o papel de `reconcile.ts` no subscription-billing.
+ */
+function isEligible(eligibility, productLine) {
+    return !eligibility || eligibility.length === 0 || eligibility.includes(productLine);
+}
+/**
+ * Valida uma Offer contra o catálogo: elegibilidade de linha (plano/módulos),
+ * dependências reais de módulo (nunca artificiais — só o que o próprio
+ * `ModuleRecord.requiredModuleCodes` declarar), e que módulos de bundle
+ * referenciados existam entre os módulos da oferta.
+ */
+export function validateOffer(input) {
+    const { offer, plan, modules, bundles, productLine } = input;
+    const errors = [];
+    const moduleByCode = new Map(modules.map((m) => [m.code, m]));
+    if (!isEligible(plan.productLineEligibility, productLine)) {
+        errors.push({ code: 'plan_not_eligible', message: `Plano "${plan.code}" não elegível para a linha "${productLine}".` });
+    }
+    if (!isEligible(offer.productLineEligibility, productLine)) {
+        errors.push({ code: 'offer_not_eligible', message: `Oferta "${offer.code}" não elegível para a linha "${productLine}".` });
+    }
+    for (const moduleCode of offer.moduleCodes) {
+        const mod = moduleByCode.get(moduleCode);
+        if (!mod) {
+            errors.push({ code: 'module_not_found', message: `Módulo "${moduleCode}" não existe no catálogo.` });
+            continue;
+        }
+        if (!mod.isActive) {
+            errors.push({ code: 'module_inactive', message: `Módulo "${moduleCode}" está inativo.` });
+        }
+        if (!isEligible(mod.productLineEligibility, productLine)) {
+            errors.push({ code: 'module_not_eligible', message: `Módulo "${moduleCode}" não elegível para a linha "${productLine}".` });
+        }
+        for (const req of mod.requiredModuleCodes) {
+            if (!offer.moduleCodes.includes(req)) {
+                errors.push({
+                    code: 'module_dependency_missing',
+                    message: `Módulo "${moduleCode}" requer "${req}", que não está na oferta.`,
+                });
+            }
+        }
+    }
+    for (const bundleCode of offer.bundleCodes) {
+        const bundle = bundles.find((b) => b.code === bundleCode);
+        if (!bundle) {
+            errors.push({ code: 'bundle_not_found', message: `Bundle "${bundleCode}" não existe no catálogo.` });
+            continue;
+        }
+        for (const moduleCode of bundle.moduleCodes) {
+            if (!offer.moduleCodes.includes(moduleCode)) {
+                errors.push({
+                    code: 'bundle_module_missing',
+                    message: `Bundle "${bundleCode}" exige o módulo "${moduleCode}", que não está na oferta.`,
+                });
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Resolve o `PriceQuote` de uma Offer contra uma `CommercialPriceTable` vigente
+ * na data `now`. Não aplica cupom (isso é `coupon.ts`, sobre o quote resolvido).
+ * Precedência de escopo: maior `priority` primeiro; sem escopo casando, usa o
+ * item sem filtro de escopo (ALL implícito).
+ */
+export function resolvePriceQuote(offer, table, now) {
+    if (table.code !== offer.priceTableCode) {
+        throw new Error(`Offer "${offer.code}" referencia a tabela "${offer.priceTableCode}", recebida "${table.code}".`);
+    }
+    if (table.status !== 'active') {
+        throw new Error(`Tabela "${table.code}" não está ativa (status="${table.status}").`);
+    }
+    if (now < table.effectiveFrom || (table.effectiveTo != null && now > table.effectiveTo)) {
+        throw new Error(`Tabela "${table.code}" fora de vigência em ${now}.`);
+    }
+    // Bundle NÃO é alvo precificável aqui (RFC §4.4: "não calcula, só declara a
+    // combinação e a intenção de desconto"). O desconto de bundle é resolvido
+    // pelo Pricing Engine (regra sobre os módulos já precificados), fora deste
+    // MVP — por isso `bundleCodes` não entra na lista de alvos obrigatórios.
+    const targets = [
+        { targetType: 'PLAN', targetCode: offer.planCode },
+        ...offer.moduleCodes.map((code) => ({ targetType: 'MODULE', targetCode: code })),
+        ...offer.addonCodes.map((code) => ({ targetType: 'ADDON', targetCode: code })),
+    ];
+    const items = targets.map(({ targetType, targetCode }) => {
+        const found = table.items.find((i) => i.targetType === targetType && i.targetCode === targetCode);
+        if (!found) {
+            throw new Error(`Sem preço para ${targetType}:${targetCode} na tabela "${table.code}" v${table.version}.`);
+        }
+        return { targetType, targetCode, amount: found.amount };
+    });
+    const total = items.reduce((sum, i) => sum + i.amount, 0);
+    return {
+        currency: table.currency,
+        items,
+        total,
+        priceTableCode: table.code,
+        priceTableVersion: table.version,
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/commercial-catalog/catalog.js.map

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

package/dist/commercial-catalog/consumption-contracts.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Contratos de consumo — SOMENTE TIPOS (ETAPA 10 do Track A1, RFC-COMMERCIAL-
+ * MODEL-001 §8/§22). Prepara IA/WhatsApp/e-mail/storage/OCR/automações/APIs
+ * para a camada de Usage/Rating — NÃO implementa Baruk Wallet nem o Rating
+ * Engine aqui (marcos posteriores do mesmo Track A, RFC-COMMERCIAL-MODEL-001
+ * §24). Unidade comercial única: crédito (o cliente nunca vê token/provedor).
+ */
+/** As famílias de consumo já evidenciadas (RFC §28.9) — cada uma um `usageType`. */
+export type ConsumptionUsageType = 'ai.email_generation' | 'ai.whatsapp_generation' | 'ai.customer_summary' | 'ai.commercial_assistant' | 'voice.call_center_ai_per_min' | 'ocr.per_page' | 'image.processing' | 'comm.whatsapp_conversation' | 'comm.sms' | 'comm.bulk_email_per_1k' | 'automation.run' | 'api.external_call';
+/**
+ * O fato de consumo — o que o Usage Metering (marco posterior) vai emitir.
+ * `provider`/`model` nunca chegam ao cliente (unidade comercial = crédito).
+ */
+export interface ConsumptionEventContract {
+    usageType: ConsumptionUsageType;
+    tenantId: string;
+    quantity: number;
+    /** Instante do fato — injetado (mesma disciplina do subscription-billing). */
+    occurredAt: string;
+    /** Idempotência — obrigatória quando o Rating Engine existir (marco posterior). */
+    idempotencyKey: string;
+}
+/** Franquia incluída por ciclo — resolvida do Plan (§ commercial-catalog types.ts). */
+export interface ConsumptionFranchise {
+    usageType: ConsumptionUsageType | 'storage_bytes' | 'credits_generic';
+    includedPerCycle: number;
+}
+export type ExcessPolicy = 'block' | 'metered';
+export interface ConsumptionExcessRule {
+    usageType: ConsumptionUsageType | 'storage_bytes' | 'credits_generic';
+    policy: ExcessPolicy;
+}
+//# sourceMappingURL=consumption-contracts.d.ts.map

package/dist/commercial-catalog/consumption-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption-contracts.d.ts","sourceRoot":"","sources":["../../src/commercial-catalog/consumption-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oFAAoF;AACpF,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,wBAAwB,GACxB,qBAAqB,GACrB,yBAAyB,GACzB,8BAA8B,GAC9B,cAAc,GACd,kBAAkB,GAClB,4BAA4B,GAC5B,UAAU,GACV,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,oBAAoB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,oBAAoB,GAAG,eAAe,GAAG,iBAAiB,CAAC;IACtE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,oBAAoB,GAAG,eAAe,GAAG,iBAAiB,CAAC;IACtE,MAAM,EAAE,YAAY,CAAC;CACtB"}

package/dist/commercial-catalog/consumption-contracts.js

@@ -0,0 +1,9 @@
+/**
+ * Contratos de consumo — SOMENTE TIPOS (ETAPA 10 do Track A1, RFC-COMMERCIAL-
+ * MODEL-001 §8/§22). Prepara IA/WhatsApp/e-mail/storage/OCR/automações/APIs
+ * para a camada de Usage/Rating — NÃO implementa Baruk Wallet nem o Rating
+ * Engine aqui (marcos posteriores do mesmo Track A, RFC-COMMERCIAL-MODEL-001
+ * §24). Unidade comercial única: crédito (o cliente nunca vê token/provedor).
+ */
+export {};
+//# sourceMappingURL=consumption-contracts.js.map

package/dist/commercial-catalog/consumption-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption-contracts.js","sourceRoot":"","sources":["../../src/commercial-catalog/consumption-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/commercial-catalog/coupon.d.ts

@@ -0,0 +1,27 @@
+import type { CouponRecord, PriceQuote } from './types.js';
+/**
+ * Cupons — MVP (RFC-COMMERCIAL-MODEL-001 §18/§29.8): apenas os 5 efeitos já
+ * cobertos pelo `CouponRecord` (percent_off, amount_off, trial_extension,
+ * free_module_period, promotional_credit). Generalização para "Campaign" fica
+ * para quando houver variedade real de campanha (Framework Evolution Policy) —
+ * não construído aqui.
+ */
+export interface CouponApplicationError {
+    code: string;
+    message: string;
+}
+/** Valida um cupom contra a data corrente e o alvo (plano/módulos da oferta). */
+export declare function validateCoupon(coupon: CouponRecord, now: string, context: {
+    planCode: string;
+    moduleCodes: string[];
+}): CouponApplicationError[];
+/** Aplica o efeito monetário do cupom (percent_off/amount_off) sobre um PriceQuote já resolvido. */
+export declare function applyCouponToQuote(quote: PriceQuote, coupon: CouponRecord): PriceQuote;
+/** Dias de trial adicionais concedidos pelo cupom (0 se o efeito não for trial_extension). */
+export declare function couponTrialExtensionDays(coupon: CouponRecord | undefined): number;
+/** Módulo liberado temporariamente pelo cupom, se houver (free_module_period). */
+export declare function couponFreeModule(coupon: CouponRecord | undefined): {
+    moduleCode: string;
+    periodDays: number;
+} | null;
+//# sourceMappingURL=coupon.d.ts.map

package/dist/commercial-catalog/coupon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupon.d.ts","sourceRoot":"","sources":["../../src/commercial-catalog/coupon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;GAMG;AAEH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GACnD,sBAAsB,EAAE,CAmB1B;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CAYtF;AAED,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAEjF;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGpH"}

package/dist/commercial-catalog/coupon.js

@@ -0,0 +1,47 @@
+/** Valida um cupom contra a data corrente e o alvo (plano/módulos da oferta). */
+export function validateCoupon(coupon, now, context) {
+    const errors = [];
+    if (!coupon.isActive)
+        errors.push({ code: 'coupon_inactive', message: `Cupom "${coupon.code}" está inativo.` });
+    if (now < coupon.validFrom || (coupon.validTo != null && now > coupon.validTo)) {
+        errors.push({ code: 'coupon_out_of_validity', message: `Cupom "${coupon.code}" fora da validade em ${now}.` });
+    }
+    if (coupon.maxRedemptions != null && (coupon.redemptionsCount ?? 0) >= coupon.maxRedemptions) {
+        errors.push({ code: 'coupon_redemptions_exhausted', message: `Cupom "${coupon.code}" atingiu o limite de resgates.` });
+    }
+    if (coupon.appliesToPlanCodes && coupon.appliesToPlanCodes.length > 0 && !coupon.appliesToPlanCodes.includes(context.planCode)) {
+        errors.push({ code: 'coupon_plan_not_eligible', message: `Cupom "${coupon.code}" não se aplica ao plano "${context.planCode}".` });
+    }
+    if (coupon.appliesToModuleCodes && coupon.appliesToModuleCodes.length > 0) {
+        const hasAny = coupon.appliesToModuleCodes.some((m) => context.moduleCodes.includes(m));
+        if (!hasAny) {
+            errors.push({ code: 'coupon_modules_not_eligible', message: `Cupom "${coupon.code}" não se aplica aos módulos da oferta.` });
+        }
+    }
+    return errors;
+}
+/** Aplica o efeito monetário do cupom (percent_off/amount_off) sobre um PriceQuote já resolvido. */
+export function applyCouponToQuote(quote, coupon) {
+    if (coupon.effectType === 'percent_off' && coupon.percentOff != null) {
+        const factor = 1 - coupon.percentOff / 100;
+        return { ...quote, total: Math.round(quote.total * factor * 100) / 100 };
+    }
+    if (coupon.effectType === 'amount_off' && coupon.amountOff != null) {
+        return { ...quote, total: Math.max(0, quote.total - coupon.amountOff) };
+    }
+    // trial_extension / free_module_period / promotional_credit não alteram o
+    // preço do quote — afetam a duração do trial (ver `offer-application.ts`) ou
+    // concedem crédito/módulo (fora do escopo de preço).
+    return quote;
+}
+/** Dias de trial adicionais concedidos pelo cupom (0 se o efeito não for trial_extension). */
+export function couponTrialExtensionDays(coupon) {
+    return coupon?.effectType === 'trial_extension' ? (coupon.trialExtensionDays ?? 0) : 0;
+}
+/** Módulo liberado temporariamente pelo cupom, se houver (free_module_period). */
+export function couponFreeModule(coupon) {
+    if (coupon?.effectType !== 'free_module_period' || !coupon.freeModuleCode)
+        return null;
+    return { moduleCode: coupon.freeModuleCode, periodDays: coupon.freeModulePeriodDays ?? 30 };
+}
+//# sourceMappingURL=coupon.js.map

package/dist/commercial-catalog/coupon.js.map

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

package/dist/commercial-catalog/index.d.ts

@@ -0,0 +1,10 @@
+export type { ProductLineCode, ProductLineStatus, ProductLineRecord, PlanFranchises, CommercialPlan, ModuleClass, ModuleRecord, BundleRecord, CouponEffectType, CouponRecord, CommercialPriceTableStatus, CommercialPriceTargetType, CommercialPriceItem, CommercialPriceScope, CommercialPriceTable, OfferRecord, PriceQuote, } from './types.js';
+export { KNOWN_ACTIVE_PRODUCT_LINES } from './types.js';
+export type { CatalogValidationError, OfferValidationInput } from './catalog.js';
+export { validateOffer, resolvePriceQuote } from './catalog.js';
+export type { CouponApplicationError } from './coupon.js';
+export { validateCoupon, applyCouponToQuote, couponTrialExtensionDays, couponFreeModule } from './coupon.js';
+export type { ApplyOfferInput, ApplyOfferResult } from './offer-application.js';
+export { applyOffer } from './offer-application.js';
+export type { ConsumptionUsageType, ConsumptionEventContract, ConsumptionFranchise, ExcessPolicy, ConsumptionExcessRule, } from './consumption-contracts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commercial-catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commercial-catalog/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhE,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE7G,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,GACtB,MAAM,4BAA4B,CAAC"}

package/dist/commercial-catalog/index.js

@@ -0,0 +1,5 @@
+export { KNOWN_ACTIVE_PRODUCT_LINES } from './types.js';
+export { validateOffer, resolvePriceQuote } from './catalog.js';
+export { validateCoupon, applyCouponToQuote, couponTrialExtensionDays, couponFreeModule } from './coupon.js';
+export { applyOffer } from './offer-application.js';
+//# sourceMappingURL=index.js.map

package/dist/commercial-catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commercial-catalog/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG7G,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/commercial-catalog/offer-application.d.ts

@@ -0,0 +1,39 @@
+import { type ReconcileResult } from '../subscription-billing/reconcile.js';
+import type { Subscription } from '../subscription-billing/types.js';
+import { type EntitlementRecord } from '../entitlements/index.js';
+import { type CatalogValidationError } from './catalog.js';
+import type { BundleRecord, CommercialPlan, CommercialPriceTable, CouponRecord, ModuleRecord, OfferRecord, PriceQuote, ProductLineCode } from './types.js';
+/**
+ * Orquestração de "aceitar uma Offer" — o seam central do Track A1
+ * (RFC-CAPABILITY-COMMERCIAL-CATALOG-001 §8): Offer compõe, cada domínio
+ * calcula a sua parte, nenhum duplica regra do outro.
+ *
+ *   Catálogo (valida elegibilidade/dependências + resolve preço)
+ *     → Cupom (ajusta preço/trial/módulo grátis, se houver)
+ *       → Subscription Billing CERTIFICADO (`startTrial` — não reimplementado aqui)
+ *         → Entitlements (deriva o que fica habilitado)
+ */
+export interface ApplyOfferInput {
+    tenantId: string;
+    /** A linha já resolvida pelo consumidor (equivalente a `tenant.productLine`/`product_tenant` — nunca resolvida aqui). */
+    productLine: ProductLineCode;
+    offer: OfferRecord;
+    plan: CommercialPlan;
+    modules: ModuleRecord[];
+    bundles: BundleRecord[];
+    priceTable: CommercialPriceTable;
+    coupon?: CouponRecord;
+    currentEntitlements: EntitlementRecord[];
+    /** Instante do fato, ISO — injetado (nunca `Date.now()` aqui, mesma disciplina do subscription-billing). */
+    now: string;
+}
+export interface ApplyOfferResult {
+    subscription: Subscription;
+    domainEvents: ReconcileResult['domainEvents'];
+    entitlements: EntitlementRecord[];
+    quote: PriceQuote;
+    /** Não-vazio → o consumidor NÃO deve persistir subscription/entitlements (aceitação inválida). */
+    errors: CatalogValidationError[];
+}
+export declare function applyOffer(input: ApplyOfferInput): ApplyOfferResult;
+//# sourceMappingURL=offer-application.d.ts.map

package/dist/commercial-catalog/offer-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offer-application.d.ts","sourceRoot":"","sources":["../../src/commercial-catalog/offer-application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAsB,KAAK,iBAAiB,EAA0B,MAAM,0BAA0B,CAAC;AAC9G,OAAO,EAAoC,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE7F,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,yHAAyH;IACzH,WAAW,EAAE,eAAe,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,oBAAoB,CAAC;IACjC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;IACzC,4GAA4G;IAC5G,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;IAC9C,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,kGAAkG;IAClG,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAaD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAyCnE"}

package/dist/commercial-catalog/offer-application.js

@@ -0,0 +1,50 @@
+import { startTrial } from '../subscription-billing/reconcile.js';
+import { deriveEntitlements } from '../entitlements/index.js';
+import { resolvePriceQuote, validateOffer } from './catalog.js';
+import { validateCoupon, applyCouponToQuote, couponTrialExtensionDays, couponFreeModule } from './coupon.js';
+/** Aceita data pura (`YYYY-MM-DD`) ou datetime ISO completo (mesma normalização do subscription-billing). */
+function parseIso(iso) {
+    return /^\d{4}-\d{2}-\d{2}$/.test(iso) ? new Date(`${iso}T00:00:00Z`) : new Date(iso);
+}
+function addDaysIso(iso, days) {
+    const d = parseIso(iso);
+    d.setUTCDate(d.getUTCDate() + days);
+    return d.toISOString();
+}
+export function applyOffer(input) {
+    const { tenantId, productLine, offer, plan, modules, bundles, priceTable, coupon, currentEntitlements, now } = input;
+    const errors = validateOffer({ offer, plan, modules, bundles, productLine });
+    if (coupon) {
+        errors.push(...validateCoupon(coupon, now, { planCode: offer.planCode, moduleCodes: offer.moduleCodes }));
+    }
+    let quote = resolvePriceQuote(offer, priceTable, now);
+    if (coupon)
+        quote = applyCouponToQuote(quote, coupon);
+    // Trial é política da ASSINATURA, não do Plano (RFC §19): default do plano,
+    // sobrescrito pela Offer, estendido por cupom — nunca uma constante fixa.
+    const trialDays = (offer.trialDaysOverride ?? plan.defaultTrialDays) + couponTrialExtensionDays(coupon);
+    const trialEndsAt = addDaysIso(now, trialDays);
+    const { subscription, domainEvents } = startTrial(tenantId, offer.planCode, trialEndsAt, now);
+    const targetGrants = offer.moduleCodes.map((moduleCode) => ({
+        moduleCode,
+        source: 'PLAN',
+        expiresAt: null,
+    }));
+    const freeModule = couponFreeModule(coupon);
+    if (freeModule && !offer.moduleCodes.includes(freeModule.moduleCode)) {
+        targetGrants.push({
+            moduleCode: freeModule.moduleCode,
+            source: 'COUPON',
+            expiresAt: addDaysIso(now, freeModule.periodDays),
+        });
+    }
+    const entitlements = deriveEntitlements({
+        tenantId,
+        subscriptionId: subscription.subscriptionId,
+        targetGrants,
+        current: currentEntitlements,
+        now,
+    });
+    return { subscription, domainEvents, entitlements, quote, errors };
+}
+//# sourceMappingURL=offer-application.js.map

package/dist/commercial-catalog/offer-application.js.map

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

package/dist/commercial-catalog/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Commercial Catalog — contrato canônico (Track A1, derivado de
+ * RFC-CAPABILITY-COMMERCIAL-CATALOG-001 §4/§7 + RFC-COMMERCIAL-MODEL-001).
+ * Escopo: Baruk.app Representante + Indústria. Domínio PURO (sem DB, sem
+ * `Date.now()` interno) — mesmo padrão de `subscription-billing/`.
+ *
+ * Princípio transversal (nunca colapsar): Identidade (`code` estável / `name`
+ * editável) ≠ Precificação (vive na `CommercialPriceTable` versionada, NUNCA no
+ * Plan/Module) ≠ Vigência (da tabela/campanha/oferta) ≠ Elegibilidade (regras
+ * de quem pode contratar).
+ *
+ * Reconciliação Reality-First (achado do Track A1, 2026-07-22): o schema real
+ * de `manga-verde-bi` guarda `productLine` no TENANT (`tenant.productLine:
+ * 'rep' | 'ind'`, resolvido por precedência — coluna explícita > regra de
+ * founder-tenant-id), NÃO no Plan. Portanto este módulo NÃO amarra um Plan/
+ * Module a uma única linha fixa — `productLineEligibility` é uma lista
+ * OPCIONAL (undefined/vazio = elegível a todas as linhas ativas). Qual linha
+ * um tenant específico roda é resolvido pelo CONSUMIDOR (equivalente ao
+ * `product/tenant_product` do `baruk-platform`, ou ao `tenant.productLine` do
+ * mvb) — este módulo recebe a linha já resolvida, nunca a resolve sozinho.
+ */
+/**
+ * Linhas ATIVAS hoje (evidência real: `product-line.ts` do mvb só implementa
+ * 'rep'|'ind'). 'varejo' e futuras (contabilidade/saúde/agro/educação) entram
+ * como REGISTRO NOVO — nunca exigem união de tipo nova no domínio, por isso o
+ * tipo abaixo é `string` com as ativas apenas documentadas, não um union fechado.
+ */
+export type ProductLineCode = string;
+export declare const KNOWN_ACTIVE_PRODUCT_LINES: readonly ProductLineCode[];
+export type ProductLineStatus = 'active' | 'reserved';
+export interface ProductLineRecord {
+    code: ProductLineCode;
+    name: string;
+    status: ProductLineStatus;
+    metadata?: Record<string, unknown>;
+}
+export interface PlanFranchises {
+    includedUsers: number;
+    storageIncludedBytes: number;
+    includedCreditsPerCycle: number;
+}
+/**
+ * Envelope comercial. `code` é a identidade ESTÁVEL (persistida em
+ * `Subscription.items[].planKey` do subscription-billing); `name` é dado
+ * editável (Pricing Studio) — nunca usar `name` como chave.
+ */
+export interface CommercialPlan {
+    code: string;
+    name: string;
+    tier: number;
+    franchises: PlanFranchises;
+    /** Duração padrão de trial (dias) — política, sobrescrita por Coupon/campanha (§ trial). */
+    defaultTrialDays: number;
+    /** Undefined/vazio = elegível a qualquer ProductLine ativa. */
+    productLineEligibility?: ProductLineCode[];
+    isPublic: boolean;
+    isActive: boolean;
+    metadata?: Record<string, unknown>;
+}
+export type ModuleClass = 'CORE' | 'ADD_ON' | 'PREMIUM' | 'ENTERPRISE';
+export interface ModuleRecord {
+    code: string;
+    name: string;
+    class: ModuleClass;
+    /** Ex.: 'communication' — o rótulo organizador "Communication Hub" (RFC §29.4). */
+    category?: string;
+    /** Dependências reais — nunca artificiais (restrição explícita). */
+    requiredModuleCodes: string[];
+    productLineEligibility?: ProductLineCode[];
+    marketplaceVisible: boolean;
+    isActive: boolean;
+}
+export interface BundleRecord {
+    code: string;
+    name: string;
+    moduleCodes: string[];
+    /** Referência à regra de desconto resolvida pelo Pricing Engine (não aqui). */
+    discountRuleRef?: string;
+    isActive: boolean;
+}
+export type CouponEffectType = 'percent_off' | 'amount_off' | 'trial_extension' | 'free_module_period' | 'promotional_credit';
+export interface CouponRecord {
+    code: string;
+    effectType: CouponEffectType;
+    /** 0-100, só para percent_off. */
+    percentOff?: number;
+    /** Valor absoluto, só para amount_off (mesma unidade da CommercialPriceTable). */
+    amountOff?: number;
+    /** Dias adicionais de trial, só para trial_extension. */
+    trialExtensionDays?: number;
+    /** Módulo liberado temporariamente, só para free_module_period. */
+    freeModuleCode?: string;
+    freeModulePeriodDays?: number;
+    /** Créditos promocionais concedidos, só para promotional_credit. */
+    promotionalCredits?: number;
+    appliesToPlanCodes?: string[];
+    appliesToModuleCodes?: string[];
+    maxRedemptions?: number | null;
+    /** Contagem de resgates já feitos — injetada pelo consumidor (persistência fora deste domínio). */
+    redemptionsCount?: number;
+    validFrom: string;
+    validTo: string | null;
+    isActive: boolean;
+}
+export type CommercialPriceTableStatus = 'draft' | 'scheduled' | 'active' | 'superseded' | 'archived';
+export type CommercialPriceTargetType = 'PLAN' | 'MODULE' | 'BUNDLE' | 'ADDON' | 'CREDIT_PACKAGE' | 'SEAT';
+export interface CommercialPriceItem {
+    targetType: CommercialPriceTargetType;
+    targetCode: string;
+    amount: number;
+    interval: 'monthly' | 'yearly' | 'one_time';
+}
+export interface CommercialPriceScope {
+    /** Ex.: productLine, segment, tenantId — precedência por `priority` (maior vence). */
+    scopeType: 'PRODUCT_LINE' | 'SEGMENT' | 'TENANT' | 'ALL';
+    matchValue?: string;
+    priority: number;
+}
+export interface CommercialPriceTable {
+    code: string;
+    currency: string;
+    status: CommercialPriceTableStatus;
+    version: number;
+    effectiveFrom: string;
+    effectiveTo: string | null;
+    scopes: CommercialPriceScope[];
+    items: CommercialPriceItem[];
+}
+export interface OfferRecord {
+    code: string;
+    name: string;
+    planCode: string;
+    moduleCodes: string[];
+    bundleCodes: string[];
+    addonCodes: string[];
+    couponCode?: string;
+    /** Sobrescreve `CommercialPlan.defaultTrialDays` quando definido (trial é política da Offer/Subscription). */
+    trialDaysOverride?: number;
+    priceTableCode: string;
+    productLineEligibility?: ProductLineCode[];
+    isActive: boolean;
+}
+/** Resultado de resolução de preço — o `PriceQuote` referenciado pela RFC. */
+export interface PriceQuote {
+    currency: string;
+    items: Array<{
+        targetType: CommercialPriceTargetType;
+        targetCode: string;
+        amount: number;
+    }>;
+    total: number;
+    priceTableCode: string;
+    priceTableVersion: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commercial-catalog/types.d.ts.map

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

package/dist/commercial-catalog/types.js

@@ -0,0 +1,23 @@
+/**
+ * Commercial Catalog — contrato canônico (Track A1, derivado de
+ * RFC-CAPABILITY-COMMERCIAL-CATALOG-001 §4/§7 + RFC-COMMERCIAL-MODEL-001).
+ * Escopo: Baruk.app Representante + Indústria. Domínio PURO (sem DB, sem
+ * `Date.now()` interno) — mesmo padrão de `subscription-billing/`.
+ *
+ * Princípio transversal (nunca colapsar): Identidade (`code` estável / `name`
+ * editável) ≠ Precificação (vive na `CommercialPriceTable` versionada, NUNCA no
+ * Plan/Module) ≠ Vigência (da tabela/campanha/oferta) ≠ Elegibilidade (regras
+ * de quem pode contratar).
+ *
+ * Reconciliação Reality-First (achado do Track A1, 2026-07-22): o schema real
+ * de `manga-verde-bi` guarda `productLine` no TENANT (`tenant.productLine:
+ * 'rep' | 'ind'`, resolvido por precedência — coluna explícita > regra de
+ * founder-tenant-id), NÃO no Plan. Portanto este módulo NÃO amarra um Plan/
+ * Module a uma única linha fixa — `productLineEligibility` é uma lista
+ * OPCIONAL (undefined/vazio = elegível a todas as linhas ativas). Qual linha
+ * um tenant específico roda é resolvido pelo CONSUMIDOR (equivalente ao
+ * `product/tenant_product` do `baruk-platform`, ou ao `tenant.productLine` do
+ * mvb) — este módulo recebe a linha já resolvida, nunca a resolve sozinho.
+ */
+export const KNOWN_ACTIVE_PRODUCT_LINES = ['rep', 'ind'];
+//# sourceMappingURL=types.js.map

package/dist/commercial-catalog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commercial-catalog/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAYH,MAAM,CAAC,MAAM,0BAA0B,GAA+B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC"}