@baruk/core 0.1.0 → 0.2.0

package/dist/cjs/subscription-billing/index.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBillingCron = exports.retryFailedWebhookEvents = exports.backofficeActivateSubscription = exports.backofficeListWebhookEvents = exports.backofficeOverview = exports.backofficeListSubscriptions = exports.reactivateForTenant = exports.cancelForTenant = exports.changePlanForTenant = exports.processWebhook = exports.startCheckout = exports.entitlementsForPlan = exports.standingFor = exports.subscriptionOverview = exports.signupSelfService = exports.seedSaasPlans = exports.withOperatorContext = exports.listBillingEvents = exports.listInvoices = exports.upsertSubscription = exports.getSubscriptionByTenant = exports.getSubscription = exports.getPlan = exports.listPublicPlans = exports.ensureSaasPlanCatalog = exports.DEFAULT_TRIAL_DAYS = exports.SAAS_PLANS = exports.DisabledSubscriptionProvider = exports.AsaasSubscriptionProvider = exports.resolveSubscriptionBillingProvider = exports.dunningStepsAsEvents = exports.startTrial = exports.cancelSubscription = exports.changePlan = exports.applySubscriptionEvent = exports.InMemoryEventPublisher = exports.NoopEventPublisher = exports.MANDATORY_EVENT_TYPES = exports.isMandatoryEvent = exports.createDomainEvent = exports.SUBSCRIPTION_BILLING_CONTRACT_VERSION = exports.CANONICAL_PROVIDER_ERROR_MESSAGES = exports.isRetryableProviderError = void 0;
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "isRetryableProviderError", { enumerable: true, get: function () { return types_js_1.isRetryableProviderError; } });
+Object.defineProperty(exports, "CANONICAL_PROVIDER_ERROR_MESSAGES", { enumerable: true, get: function () { return types_js_1.CANONICAL_PROVIDER_ERROR_MESSAGES; } });
+Object.defineProperty(exports, "SUBSCRIPTION_BILLING_CONTRACT_VERSION", { enumerable: true, get: function () { return types_js_1.SUBSCRIPTION_BILLING_CONTRACT_VERSION; } });
+var events_js_1 = require("./events.js");
+Object.defineProperty(exports, "createDomainEvent", { enumerable: true, get: function () { return events_js_1.createDomainEvent; } });
+Object.defineProperty(exports, "isMandatoryEvent", { enumerable: true, get: function () { return events_js_1.isMandatoryEvent; } });
+Object.defineProperty(exports, "MANDATORY_EVENT_TYPES", { enumerable: true, get: function () { return events_js_1.MANDATORY_EVENT_TYPES; } });
+Object.defineProperty(exports, "NoopEventPublisher", { enumerable: true, get: function () { return events_js_1.NoopEventPublisher; } });
+Object.defineProperty(exports, "InMemoryEventPublisher", { enumerable: true, get: function () { return events_js_1.InMemoryEventPublisher; } });
+var reconcile_js_1 = require("./reconcile.js");
+Object.defineProperty(exports, "applySubscriptionEvent", { enumerable: true, get: function () { return reconcile_js_1.applySubscriptionEvent; } });
+Object.defineProperty(exports, "changePlan", { enumerable: true, get: function () { return reconcile_js_1.changePlan; } });
+Object.defineProperty(exports, "cancelSubscription", { enumerable: true, get: function () { return reconcile_js_1.cancelSubscription; } });
+Object.defineProperty(exports, "startTrial", { enumerable: true, get: function () { return reconcile_js_1.startTrial; } });
+// DEFAULT_DUNNING_STEPS/DunningStep/DunningStepDue sao os MESMOS simbolos ja
+// exportados por `../billing/dunning.js` no barrel do pacote (`src/index.ts`) —
+// nao redeclarados aqui para nao colidir. So a funcao nova (genuina desta
+// Capability) e exportada.
+var dunning_js_1 = require("./dunning.js");
+Object.defineProperty(exports, "dunningStepsAsEvents", { enumerable: true, get: function () { return dunning_js_1.dunningStepsAsEvents; } });
+var registry_js_1 = require("./provider/registry.js");
+Object.defineProperty(exports, "resolveSubscriptionBillingProvider", { enumerable: true, get: function () { return registry_js_1.resolveSubscriptionBillingProvider; } });
+var asaas_js_1 = require("./provider/asaas.js");
+Object.defineProperty(exports, "AsaasSubscriptionProvider", { enumerable: true, get: function () { return asaas_js_1.AsaasSubscriptionProvider; } });
+var disabled_js_1 = require("./provider/disabled.js");
+Object.defineProperty(exports, "DisabledSubscriptionProvider", { enumerable: true, get: function () { return disabled_js_1.DisabledSubscriptionProvider; } });
+// ── BILL-01 (Fase 17): persistência + serviço do Billing SaaS ────────────────
+var plans_js_1 = require("./plans.js");
+Object.defineProperty(exports, "SAAS_PLANS", { enumerable: true, get: function () { return plans_js_1.SAAS_PLANS; } });
+Object.defineProperty(exports, "DEFAULT_TRIAL_DAYS", { enumerable: true, get: function () { return plans_js_1.DEFAULT_TRIAL_DAYS; } });
+var repository_js_1 = require("./repository.js");
+Object.defineProperty(exports, "ensureSaasPlanCatalog", { enumerable: true, get: function () { return repository_js_1.ensureSaasPlanCatalog; } });
+Object.defineProperty(exports, "listPublicPlans", { enumerable: true, get: function () { return repository_js_1.listPublicPlans; } });
+Object.defineProperty(exports, "getPlan", { enumerable: true, get: function () { return repository_js_1.getPlan; } });
+Object.defineProperty(exports, "getSubscription", { enumerable: true, get: function () { return repository_js_1.getSubscription; } });
+Object.defineProperty(exports, "getSubscriptionByTenant", { enumerable: true, get: function () { return repository_js_1.getSubscriptionByTenant; } });
+Object.defineProperty(exports, "upsertSubscription", { enumerable: true, get: function () { return repository_js_1.upsertSubscription; } });
+Object.defineProperty(exports, "listInvoices", { enumerable: true, get: function () { return repository_js_1.listInvoices; } });
+Object.defineProperty(exports, "listBillingEvents", { enumerable: true, get: function () { return repository_js_1.listBillingEvents; } });
+Object.defineProperty(exports, "withOperatorContext", { enumerable: true, get: function () { return repository_js_1.withOperatorContext; } });
+var service_js_1 = require("./service.js");
+Object.defineProperty(exports, "seedSaasPlans", { enumerable: true, get: function () { return service_js_1.seedSaasPlans; } });
+Object.defineProperty(exports, "signupSelfService", { enumerable: true, get: function () { return service_js_1.signupSelfService; } });
+Object.defineProperty(exports, "subscriptionOverview", { enumerable: true, get: function () { return service_js_1.subscriptionOverview; } });
+Object.defineProperty(exports, "standingFor", { enumerable: true, get: function () { return service_js_1.standingFor; } });
+Object.defineProperty(exports, "entitlementsForPlan", { enumerable: true, get: function () { return service_js_1.entitlementsForPlan; } });
+Object.defineProperty(exports, "startCheckout", { enumerable: true, get: function () { return service_js_1.startCheckout; } });
+Object.defineProperty(exports, "processWebhook", { enumerable: true, get: function () { return service_js_1.processWebhook; } });
+Object.defineProperty(exports, "changePlanForTenant", { enumerable: true, get: function () { return service_js_1.changePlanForTenant; } });
+Object.defineProperty(exports, "cancelForTenant", { enumerable: true, get: function () { return service_js_1.cancelForTenant; } });
+Object.defineProperty(exports, "reactivateForTenant", { enumerable: true, get: function () { return service_js_1.reactivateForTenant; } });
+Object.defineProperty(exports, "backofficeListSubscriptions", { enumerable: true, get: function () { return service_js_1.backofficeListSubscriptions; } });
+Object.defineProperty(exports, "backofficeOverview", { enumerable: true, get: function () { return service_js_1.backofficeOverview; } });
+Object.defineProperty(exports, "backofficeListWebhookEvents", { enumerable: true, get: function () { return service_js_1.backofficeListWebhookEvents; } });
+Object.defineProperty(exports, "backofficeActivateSubscription", { enumerable: true, get: function () { return service_js_1.backofficeActivateSubscription; } });
+Object.defineProperty(exports, "retryFailedWebhookEvents", { enumerable: true, get: function () { return service_js_1.retryFailedWebhookEvents; } });
+Object.defineProperty(exports, "runBillingCron", { enumerable: true, get: function () { return service_js_1.runBillingCron; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/subscription-billing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/subscription-billing/index.ts"],"names":[],"mappings":";;;AAuBA,uCAAgI;AAAvH,oHAAA,wBAAwB,OAAA;AAAE,6HAAA,iCAAiC,OAAA;AAAE,iIAAA,qCAAqC,OAAA;AAG3G,yCAAqI;AAA5H,8GAAA,iBAAiB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAG/G,+CAAoG;AAA3F,sHAAA,sBAAsB,OAAA;AAAE,0GAAA,UAAU,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAAE,0GAAA,UAAU,OAAA;AAE3E,6EAA6E;AAC7E,gFAAgF;AAChF,0EAA0E;AAC1E,2BAA2B;AAC3B,2CAAoD;AAA3C,kHAAA,oBAAoB,OAAA;AAE7B,sDAA4E;AAAnE,iIAAA,kCAAkC,OAAA;AAE3C,gDAAgE;AAAvD,qHAAA,yBAAyB,OAAA;AAClC,sDAAsE;AAA7D,2HAAA,4BAA4B,OAAA;AAErC,gFAAgF;AAChF,uCAA4D;AAAnD,sGAAA,UAAU,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAEvC,iDAUyB;AATvB,sHAAA,qBAAqB,OAAA;AACrB,gHAAA,eAAe,OAAA;AACf,wGAAA,OAAO,OAAA;AACP,gHAAA,eAAe,OAAA;AACf,wHAAA,uBAAuB,OAAA;AACvB,mHAAA,kBAAkB,OAAA;AAClB,6GAAA,YAAY,OAAA;AACZ,kHAAA,iBAAiB,OAAA;AACjB,oHAAA,mBAAmB,OAAA;AAGrB,2CAiBsB;AAhBpB,2GAAA,aAAa,OAAA;AACb,+GAAA,iBAAiB,OAAA;AACjB,kHAAA,oBAAoB,OAAA;AACpB,yGAAA,WAAW,OAAA;AACX,iHAAA,mBAAmB,OAAA;AACnB,2GAAA,aAAa,OAAA;AACb,4GAAA,cAAc,OAAA;AACd,iHAAA,mBAAmB,OAAA;AACnB,6GAAA,eAAe,OAAA;AACf,iHAAA,mBAAmB,OAAA;AACnB,yHAAA,2BAA2B,OAAA;AAC3B,gHAAA,kBAAkB,OAAA;AAClB,yHAAA,2BAA2B,OAAA;AAC3B,4HAAA,8BAA8B,OAAA;AAC9B,sHAAA,wBAAwB,OAAA;AACxB,4GAAA,cAAc,OAAA"}

package/dist/cjs/subscription-billing/plans.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Catálogo padrão de planos do SaaS (Concern A). Fonte declarativa — o seed
+ * materializa em `saas_plan` de forma idempotente (mesmo padrão de
+ * `products/catalog.ts` e do RBAC). Preço em CENTAVOS de BRL (v0.1 flat).
+ *
+ * `modules` alimenta os Entitlements finos (EntitlementSource 'PLAN');
+ * `limits` são as franquias por plano (commercial-catalog: PlanFranchises).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SAAS_PLANS = exports.DEFAULT_TRIAL_DAYS = exports.DEFAULT_PRODUCT_KEY = void 0;
+/**
+ * Produto dono do plano (`product.key` — ver `products/catalog.ts`). O motor de
+ * Billing é infraestrutura compartilhada do ecossistema; o catálogo comercial
+ * não é. Planos do Baruk Office, do Rep, do Ind e do futuro Varejo coexistem na
+ * mesma tabela, separados por esta chave, e `key` só precisa ser único dentro
+ * do produto.
+ */
+exports.DEFAULT_PRODUCT_KEY = 'contabil';
+exports.DEFAULT_TRIAL_DAYS = 14;
+exports.SAAS_PLANS = [
+    {
+        key: 'starter',
+        name: 'Starter',
+        description: 'Para escritórios começando a digitalizar a operação.',
+        amountCents: 9700,
+        periodicity: 'monthly',
+        trialDays: exports.DEFAULT_TRIAL_DAYS,
+        modules: ['clients', 'requests', 'portal'],
+        limits: { users: 3, clients: 50, storageGb: 5 },
+        isPublic: true,
+        isActive: true,
+        sortOrder: 1,
+    },
+    {
+        key: 'pro',
+        name: 'Pro',
+        description: 'Operação completa: portal do cliente, financeiro e auditoria.',
+        amountCents: 24700,
+        periodicity: 'monthly',
+        trialDays: exports.DEFAULT_TRIAL_DAYS,
+        modules: ['clients', 'requests', 'portal', 'billing', 'audit', 'notifications'],
+        limits: { users: 10, clients: 300, storageGb: 25 },
+        isPublic: true,
+        isActive: true,
+        sortOrder: 2,
+    },
+    {
+        key: 'enterprise',
+        name: 'Enterprise',
+        description: 'Times grandes, múltiplas unidades e necessidades sob medida.',
+        amountCents: 59700,
+        periodicity: 'monthly',
+        trialDays: exports.DEFAULT_TRIAL_DAYS,
+        modules: [
+            'clients',
+            'requests',
+            'portal',
+            'billing',
+            'audit',
+            'notifications',
+            'crm',
+            'compliance',
+        ],
+        limits: { users: 50, clients: 2000, storageGb: 100 },
+        isPublic: true,
+        isActive: true,
+        sortOrder: 3,
+    },
+    // Plano anual do Pro — mesma franquia, 2 meses de desconto (12x → 10x).
+    // NÃO CONTRATÁVEL na v0.1: o checkout certificado cria link RECURRENT MENSAL
+    // (asaas.ts, subscriptionCycle fixo) — vender anual cobraria 12x o valor.
+    // Reativar quando o contrato de checkout suportar ciclo (v0.2).
+    {
+        key: 'pro-anual',
+        name: 'Pro Anual',
+        description: 'Plano Pro com cobrança anual — economize 2 mensalidades.',
+        amountCents: 247000,
+        periodicity: 'yearly',
+        trialDays: exports.DEFAULT_TRIAL_DAYS,
+        modules: ['clients', 'requests', 'portal', 'billing', 'audit', 'notifications'],
+        limits: { users: 10, clients: 300, storageGb: 25 },
+        isPublic: false,
+        isActive: false,
+        sortOrder: 4,
+    },
+];
+//# sourceMappingURL=plans.js.map

package/dist/cjs/subscription-billing/plans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.js","sourceRoot":"","sources":["../../../src/subscription-billing/plans.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAG,UAAU,CAAC;AAkBjC,QAAA,kBAAkB,GAAG,EAAE,CAAC;AAExB,QAAA,UAAU,GAA2B;IAChD;QACE,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sDAAsD;QACnE,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE,0BAAkB;QAC7B,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC;QAC1C,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE;QAC/C,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,CAAC;KACb;IACD;QACE,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,+DAA+D;QAC5E,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE,0BAAkB;QAC7B,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC;QAC/E,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE;QAClD,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,CAAC;KACb;IACD;QACE,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE,0BAAkB;QAC7B,OAAO,EAAE;YACP,SAAS;YACT,UAAU;YACV,QAAQ;YACR,SAAS;YACT,OAAO;YACP,eAAe;YACf,KAAK;YACL,YAAY;SACb;QACD,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE;QACpD,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,CAAC;KACb;IACD,wEAAwE;IACxE,6EAA6E;IAC7E,0EAA0E;IAC1E,gEAAgE;IAChE;QACE,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,0BAAkB;QAC7B,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC;QAC/E,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE;QAClD,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,CAAC;KACb;CACF,CAAC"}

package/dist/cjs/subscription-billing/product-config.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProductBillingRegistry = createProductBillingRegistry;
+exports.singleProductRegistry = singleProductRegistry;
+const shared_1 = require("@baruk/shared");
+const plans_js_1 = require("./plans.js");
+/**
+ * Registry imutável a partir de uma lista de configurações por produto.
+ *
+ * Sem `fallbackProductKey`, pedir um produto não configurado é erro. Com ele, o
+ * produto indicado responde pelos demais — usado só na transição, enquanto os
+ * ambientes ainda têm uma conta só.
+ */
+function createProductBillingRegistry(configs, options = {}) {
+    const byKey = new Map();
+    for (const cfg of configs) {
+        if (!cfg.productKey)
+            throw new shared_1.ValidationError('ProductBillingConfig sem productKey');
+        if (byKey.has(cfg.productKey)) {
+            throw new shared_1.ValidationError(`Configuração de billing duplicada para o produto ${cfg.productKey}`);
+        }
+        byKey.set(cfg.productKey, cfg);
+    }
+    const fallback = options.fallbackProductKey;
+    if (fallback && !byKey.has(fallback)) {
+        throw new shared_1.ValidationError(`fallbackProductKey '${fallback}' não está configurado`);
+    }
+    return {
+        resolve({ productKey }) {
+            const direct = byKey.get(productKey);
+            if (direct)
+                return direct;
+            if (fallback) {
+                const shared = byKey.get(fallback);
+                // A config emprestada responde pelo produto pedido, mas se declara como
+                // tal — quem audita um checkout vê o produto real, não o fallback.
+                return { ...shared, productKey };
+            }
+            throw new shared_1.ValidationError(`Produto sem configuração de billing: ${productKey}`);
+        },
+        has: (productKey) => byKey.has(productKey),
+        productKeys: () => [...byKey.keys()],
+    };
+}
+/**
+ * Registry de um produto só — atalho para ambientes de um produto e para os
+ * testes que já existiam antes do multi-produto.
+ */
+function singleProductRegistry(config, productKey = plans_js_1.DEFAULT_PRODUCT_KEY) {
+    return createProductBillingRegistry([{ ...config, productKey }], {
+        fallbackProductKey: productKey,
+    });
+}
+//# sourceMappingURL=product-config.js.map

package/dist/cjs/subscription-billing/product-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-config.js","sourceRoot":"","sources":["../../../src/subscription-billing/product-config.ts"],"names":[],"mappings":";;AA0DA,oEAmCC;AAMD,sDAOC;AA1GD,0CAAgD;AAEhD,yCAAiD;AAiDjD;;;;;;GAMG;AACH,SAAgB,4BAA4B,CAC1C,OAAwC,EACxC,UAA2C,EAAE;IAE7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,MAAM,IAAI,wBAAe,CAAC,qCAAqC,CAAC,CAAC;QACtF,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,wBAAe,CACvB,oDAAoD,GAAG,CAAC,UAAU,EAAE,CACrE,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAC5C,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,wBAAe,CAAC,uBAAuB,QAAQ,wBAAwB,CAAC,CAAC;IACrF,CAAC;IAED,OAAO;QACL,OAAO,CAAC,EAAE,UAAU,EAAsB;YACxC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC1B,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;gBACpC,wEAAwE;gBACxE,mEAAmE;gBACnE,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC;YACnC,CAAC;YACD,MAAM,IAAI,wBAAe,CAAC,wCAAwC,UAAU,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,GAAG,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;QAClD,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,MAAyB,EACzB,aAAqB,8BAAmB;IAExC,OAAO,4BAA4B,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE;QAC/D,kBAAkB,EAAE,UAAU;KAC/B,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsaasSubscriptionProvider = void 0;
+const node_crypto_1 = require("node:crypto");
+const shared_1 = require("@baruk/shared");
+const sanitize_js_1 = require("../../mail/sanitize.js");
+/**
+ * Adapter ASAAS — Golden Provider (RFC §7). A Capability NUNCA importa este
+ * arquivo fora de `registry.ts` — trocar de gateway e trocar a string
+ * registrada, sem tocar em regra de dominio (ADR-ECO-0019, ja validado em
+ * `cap.communication.transactional-email` e no `dental-platform-engine`
+ * real, RFC §3). `apiKey` nunca hardcoded (vem de `SubscriptionProviderConfig`, Vault na
+ * borda do consumidor); `fetchImpl` injetavel para teste sem rede.
+ */
+const SANDBOX_BASE = 'https://api-sandbox.asaas.com/v3';
+const LIVE_BASE = 'https://api.asaas.com/v3';
+const TIMEOUT_MS = 12_000;
+class AsaasProviderError extends shared_1.AppError {
+    constructor(message, status = 502) {
+        super(`Provider de pagamento: ${message}`, { status, code: 'billing_provider_error' });
+    }
+}
+function safeEqual(a, b) {
+    const ba = Buffer.from(a);
+    const bb = Buffer.from(b);
+    if (ba.length !== bb.length)
+        return false;
+    return (0, node_crypto_1.timingSafeEqual)(ba, bb);
+}
+/**
+ * Mapeia o vocabulario do ASAAS para o enum NORMALIZADO PELO DOMINIO (RFC §6) — nunca
+ * o contrario. Alinhado ao mapeamento real e ja validado em producao do Golden Project
+ * (`dental-platform-engine/gateway/asaas-map.ts`, RFC §10) — cobre `REFUND_REQUESTED`/
+ * `CHARGEBACK_*`/`CANCELED` explicito e e case-insensitive (ASAAS nao garante caixa
+ * consistente entre ambientes).
+ */
+function normalizeAsaasStatus(status) {
+    switch ((status ?? '').toUpperCase()) {
+        case 'PENDING':
+        case 'AWAITING_RISK_ANALYSIS':
+            return 'pending';
+        case 'CONFIRMED':
+            return 'confirmed';
+        case 'RECEIVED':
+        case 'RECEIVED_IN_CASH':
+            return 'received';
+        case 'OVERDUE':
+            return 'overdue';
+        case 'REFUNDED':
+        case 'REFUND_REQUESTED':
+        case 'CHARGEBACK_REQUESTED':
+        case 'CHARGEBACK_DISPUTE':
+            return 'refunded';
+        case 'DELETED':
+        case 'CANCELED':
+            return 'canceled';
+        default:
+            return 'failed';
+    }
+}
+/** Mesma origem do mapeamento acima — status de ASSINATURA (evento `kind: 'subscription'`). */
+function normalizeAsaasSubscriptionStatus(status) {
+    switch ((status ?? '').toUpperCase()) {
+        case 'ACTIVE':
+            return 'active';
+        case 'EXPIRED':
+        case 'OVERDUE':
+            return 'past_due';
+        case 'INACTIVE':
+        case 'CANCELED':
+            return 'canceled';
+        default:
+            return 'active';
+    }
+}
+function normalizeAsaasPayment(p) {
+    return {
+        externalId: String(p['id']),
+        status: normalizeAsaasStatus(p['status']),
+        value: Number(p['value'] ?? 0),
+        billingType: p['billingType'] ?? null,
+        dueDate: p['dueDate'] ?? null,
+        paidAt: p['paymentDate'] ?? null,
+        externalSubscriptionId: p['subscription'] ?? null,
+        invoiceUrl: p['invoiceUrl'] ?? null,
+        bankSlipUrl: p['bankSlipUrl'] ?? null,
+        pixPayload: p['pixCopyAndPaste'] ?? null,
+        description: p['description'] ?? null,
+    };
+}
+class AsaasSubscriptionProvider {
+    name = 'asaas';
+    mode;
+    apiKey;
+    webhookSecret;
+    baseUrl;
+    fetchImpl;
+    constructor(config) {
+        if (!config.apiKey)
+            throw new AsaasProviderError('apiKey ausente (configure no Vault).', 500);
+        this.apiKey = config.apiKey;
+        this.webhookSecret = config.webhookSecret;
+        this.mode = config.mode ?? 'sandbox';
+        this.baseUrl = config.baseUrl ?? (this.mode === 'live' ? LIVE_BASE : SANDBOX_BASE);
+        this.fetchImpl = config.fetchImpl ?? fetch;
+    }
+    async call(method, path, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        try {
+            const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                method,
+                headers: { 'content-type': 'application/json', access_token: this.apiKey },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            const text = await res.text();
+            const json = text ? JSON.parse(text) : {};
+            if (!res.ok) {
+                // Nunca propaga o corpo bruto do provider (pode conter a propria apiKey ecoada) —
+                // mesma invariante ja endurecida em 2 rounds de Certification (mail/, RFC §9).
+                const errors = json['errors'];
+                const detail = errors?.[0]?.description ?? `HTTP ${res.status}`;
+                (0, sanitize_js_1.logSanitized)(`[subscription-billing] asaas ${method} ${path} falhou:`, detail, [this.apiKey, this.webhookSecret]);
+                throw new AsaasProviderError('falha ao contatar o provider de pagamento.');
+            }
+            return json;
+        }
+        catch (err) {
+            if (err instanceof AsaasProviderError)
+                throw err;
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new AsaasProviderError(`timeout apos ${TIMEOUT_MS}ms`, 504);
+            }
+            (0, sanitize_js_1.logSanitized)(`[subscription-billing] asaas ${method} ${path} erro de rede:`, err instanceof Error ? err.message : String(err), [
+                this.apiKey,
+                this.webhookSecret,
+            ]);
+            throw new AsaasProviderError('falha de rede ao contatar o provider de pagamento.');
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async ensureCustomer(input) {
+        const created = await this.call('POST', '/customers', {
+            name: input.name,
+            email: input.email ?? undefined,
+            cpfCnpj: input.taxId ?? undefined,
+            externalReference: input.tenantId,
+        });
+        return { externalId: created.id };
+    }
+    async createCheckout(input) {
+        // Payment link hospedado, recorrente — cobre o caso de subscription (RFC §7).
+        // Cobranca direta PIX/boleto sem redirect e do Concern B, fora de escopo (RFC §7).
+        const link = await this.call('POST', '/paymentLinks', {
+            name: input.description,
+            billingType: 'UNDEFINED',
+            chargeType: 'RECURRENT',
+            subscriptionCycle: 'MONTHLY',
+            value: input.amountBRL,
+            dueDateLimitDays: 7,
+            externalReference: `${input.tenantId}:${input.planKey}`,
+            callback: { successUrl: input.returnUrl, autoRedirect: true },
+        });
+        return { externalId: link.id, url: link.url };
+    }
+    async getPayment(externalId) {
+        const p = await this.call('GET', `/payments/${encodeURIComponent(externalId)}`);
+        return normalizeAsaasPayment(p);
+    }
+    /** Autenticidade — SEMPRE antes de `parseWebhookEvent` (RFC §7, passo separado). */
+    verifyWebhook(headers, _rawBody) {
+        void _rawBody;
+        if (!this.webhookSecret)
+            return false; // sem token configurado → nunca confia no evento
+        const received = headers['asaas-access-token'] ?? headers['Asaas-Access-Token'] ?? '';
+        return typeof received === 'string' && received.length > 0 && safeEqual(received, this.webhookSecret);
+    }
+    /**
+     * Reescrito a partir do mapeamento real e ja validado em producao do Golden Project
+     * (`dental-platform-engine/gateway/asaas-map.ts`, RFC §10) — a versao anterior
+     * zerava `paymentLinkId`/`externalReference`/`externalCustomerId` (nunca extraia do
+     * payload real), o que quebraria a atribuicao de tenant (`resolveContext`) de
+     * qualquer consumidor que dependesse desses campos. Tambem nao tratava eventos
+     * `kind: 'subscription'`, so `kind: 'invoice'`.
+     */
+    parseWebhookEvent(payload) {
+        const p = payload;
+        if (!p || typeof p !== 'object' || !p.event)
+            return null;
+        const eventType = p.event;
+        const paymentId = p.payment?.['id'];
+        if (typeof paymentId === 'string') {
+            // ASAAS envia o objeto `payment` completo no webhook (mesmo shape de GET /payments/{id}) —
+            // reusa o mesmo mapeador do gateway, sem duplicar a normalizacao (RFC §6).
+            const invoice = normalizeAsaasPayment(p.payment);
+            const externalEventId = p.id ?? `${eventType}:${paymentId}:${p.dateCreated ?? ''}`;
+            return {
+                externalEventId,
+                eventType,
+                kind: 'invoice',
+                invoice,
+                externalCustomerId: p.payment['customer'] ?? null,
+                externalReference: p.payment['externalReference'] ?? null,
+                paymentLinkId: p.payment['paymentLink'] ?? null,
+            };
+        }
+        if (p.subscription?.id) {
+            const externalEventId = p.id ?? `${eventType}:${p.subscription.id}:${p.dateCreated ?? ''}`;
+            return {
+                externalEventId,
+                eventType,
+                kind: 'subscription',
+                subscription: {
+                    externalId: p.subscription.id,
+                    status: normalizeAsaasSubscriptionStatus(p.subscription.status),
+                },
+                externalCustomerId: p.subscription.customer ?? null,
+                externalReference: p.subscription.externalReference ?? null,
+            };
+        }
+        // Evento reconhecido mas sem recurso acionavel → 'unknown' (ainda assim deduplicavel/logavel).
+        return {
+            externalEventId: p.id ?? `${eventType}:${p.dateCreated ?? ''}`,
+            eventType,
+            kind: 'unknown',
+        };
+    }
+}
+exports.AsaasSubscriptionProvider = AsaasSubscriptionProvider;
+//# sourceMappingURL=asaas.js.map

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

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

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

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisabledSubscriptionProvider = void 0;
+/**
+ * Provider `disabled` — estado de primeira classe (RFC §7): sem apiKey
+ * configurada, o registry resolve para este stub. NUNCA toca a rede, nunca
+ * cobra. Preserva o comportamento de dry-run que o `dental-platform-engine`
+ * ja usa em producao hoje (RFC §3).
+ *
+ * `name` e injetavel (default `'disabled'`) para preservar qual provider FOI
+ * PEDIDO mesmo sem chave configurada (ex.: `resolveSubscriptionBillingProvider('asaas', {})`
+ * → `name: 'asaas'`) — o Golden Project (`dental`) grava `provider.name` em registros
+ * de DB (`CheckoutSession`, `BillingCustomer` etc.) e precisa do nome pedido, nao do
+ * literal `'disabled'`, para manter consistencia quando a chave for configurada depois.
+ */
+class DisabledSubscriptionProvider {
+    name;
+    mode = 'disabled';
+    constructor(name = 'disabled') {
+        this.name = name;
+    }
+    /**
+     * Lanca erro deliberadamente (nao devolve stub) — contrato ja validado e testado no
+     * Golden Project (`dental-platform-engine`, RFC §10): `ensureCustomer` so e chamado
+     * apos o chamador checar `mode !== 'disabled'`; chegar aqui e um bug de chamada, e
+     * falhar alto e melhor do que persistir um `externalId` fake que parece real.
+     */
+    async ensureCustomer(_input) {
+        void _input;
+        throw new Error('Gateway de pagamento nao configurado (modo desabilitado).');
+    }
+    async createCheckout(_input) {
+        return { externalId: null, url: null };
+    }
+    async getPayment(_externalId) {
+        return null;
+    }
+    verifyWebhook(_headers, _rawBody) {
+        return false; // nenhum webhook e confiavel quando desabilitado — nao ha token para validar
+    }
+    parseWebhookEvent(_payload) {
+        return null;
+    }
+}
+exports.DisabledSubscriptionProvider = DisabledSubscriptionProvider;
+//# sourceMappingURL=disabled.js.map

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

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

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSubscriptionBillingProvider = resolveSubscriptionBillingProvider;
+const shared_1 = require("@baruk/shared");
+const asaas_js_1 = require("./asaas.js");
+const disabled_js_1 = require("./disabled.js");
+const FACTORIES = {
+    asaas: (config) => new asaas_js_1.AsaasSubscriptionProvider(config),
+    disabled: () => new disabled_js_1.DisabledSubscriptionProvider(),
+};
+/**
+ * Resolve o Provider por nome (RFC §7) — nenhum outro modulo importa
+ * `provider/asaas.ts` diretamente. Sem `apiKey` configurada, resolve para
+ * `disabled` automaticamente, independente do nome pedido — nunca cobra por
+ * falta de configuracao (mesmo padrao best-effort de `cap.communication.transactional-email`).
+ */
+function resolveSubscriptionBillingProvider(name, config) {
+    if (!config.apiKey || config.mode === 'disabled') {
+        // Preserva o nome pedido mesmo desabilitado (ver `disabled.ts`) — consumidores que
+        // gravam `provider.name` em DB precisam do nome configurado, nao do literal `'disabled'`.
+        return new disabled_js_1.DisabledSubscriptionProvider(name);
+    }
+    const factory = FACTORIES[name];
+    if (!factory) {
+        throw new shared_1.ValidationError(`Provider de pagamento desconhecido: "${name}".`);
+    }
+    return factory(config);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/subscription-billing/provider/registry.ts"],"names":[],"mappings":";;AAkBA,gFAWC;AA7BD,0CAAgD;AAEhD,yCAAuD;AACvD,+CAA6D;AAI7D,MAAM,SAAS,GAAgD;IAC7D,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,oCAAyB,CAAC,MAAM,CAAC;IACxD,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,0CAA4B,EAAE;CACnD,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,kCAAkC,CAAC,IAAY,EAAE,MAAkC;IACjG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjD,mFAAmF;QACnF,0FAA0F;QAC1F,OAAO,IAAI,0CAA4B,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,wBAAe,CAAC,wCAAwC,IAAI,IAAI,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC"}