@baruk/core 0.1.0 → 0.3.0

package/dist/subscription-billing/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/subscription-billing/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAqBvC,mGAAmG;AACnG,MAAM,CAAC,MAAM,qBAAqB,GAAuC,IAAI,GAAG,CAAC;IAC/E,4BAA4B;IAC5B,wBAAwB;IACxB,uBAAuB;IACvB,2BAA2B;IAC3B,uBAAuB;CACxB,CAAC,CAAC;AAgCH,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAkC,KAA8B;IAC/F,OAAO;QACL,OAAO,EAAE,MAAM,EAAE;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,gBAAgB,GAAG,CAAC;QACpC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAA2B;IAC1D,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAWD,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,OAAO;QACX,gFAAgF;IAClF,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,OAAO,sBAAsB;IACxB,SAAS,GAAkB,EAAE,CAAC;IAEvC,KAAK,CAAC,OAAO,CAAC,KAAkB;QAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/subscription-billing/index.d.ts

@@ -0,0 +1,18 @@
+export type { SubscriptionPeriodicity, PricingModel, Plan, SubscriptionStatus, SubscriptionItem, Subscription, BillingMode, NormalizedInvoiceStatus, NormalizedSubStatus, EnsureCustomerInput, ProviderCustomer, CreateCheckoutInput, ProviderCheckout, ProviderInvoice, EventAttribution, WebhookHeaders, NormalizedWebhookEvent, SubscriptionProviderConfig, PaymentGatewayProvider, ProviderErrorCode, } from './types.js';
+export { isRetryableProviderError, CANONICAL_PROVIDER_ERROR_MESSAGES, SUBSCRIPTION_BILLING_CONTRACT_VERSION } from './types.js';
+export type { SubscriptionEventType, DomainEvent, CreateEventInput, EventPublisher } from './events.js';
+export { createDomainEvent, isMandatoryEvent, MANDATORY_EVENT_TYPES, NoopEventPublisher, InMemoryEventPublisher } from './events.js';
+export type { ReconcileInput, ReconcileResult } from './reconcile.js';
+export { applySubscriptionEvent, changePlan, cancelSubscription, startTrial } from './reconcile.js';
+export { dunningStepsAsEvents } from './dunning.js';
+export { resolveSubscriptionBillingProvider } from './provider/registry.js';
+export type { SubscriptionProviderFactory } from './provider/registry.js';
+export { AsaasSubscriptionProvider } from './provider/asaas.js';
+export { DisabledSubscriptionProvider } from './provider/disabled.js';
+export { SAAS_PLANS, DEFAULT_TRIAL_DAYS } from './plans.js';
+export type { SaasPlanDef } from './plans.js';
+export { ensureSaasPlanCatalog, listPublicPlans, getPlan, getSubscription, getSubscriptionByTenant, upsertSubscription, listInvoices, listBillingEvents, withOperatorContext, } from './repository.js';
+export type { SaasPlanRow, SubscriptionRow, SaasInvoiceRow, BackofficeSubscriptionRow, BackofficeSummary } from './repository.js';
+export { seedSaasPlans, signupSelfService, subscriptionOverview, standingFor, entitlementsForPlan, startCheckout, processWebhook, changePlanForTenant, cancelForTenant, reactivateForTenant, backofficeListSubscriptions, backofficeOverview, backofficeListWebhookEvents, backofficeActivateSubscription, retryFailedWebhookEvents, runBillingCron, } from './service.js';
+export type { SaasBillingConfig, SignupInput, SignupResult, SubscriptionStanding, SubscriptionOverview, CheckoutResult, WebhookProcessResult, CronReport, } from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/subscription-billing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/subscription-billing/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,uBAAuB,EACvB,YAAY,EACZ,IAAI,EACJ,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,iCAAiC,EAAE,qCAAqC,EAAE,MAAM,YAAY,CAAC;AAEhI,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErI,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAClI,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAClB,2BAA2B,EAC3B,8BAA8B,EAC9B,wBAAwB,EACxB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,UAAU,GACX,MAAM,cAAc,CAAC"}

package/dist/subscription-billing/index.js

@@ -0,0 +1,16 @@
+export { isRetryableProviderError, CANONICAL_PROVIDER_ERROR_MESSAGES, SUBSCRIPTION_BILLING_CONTRACT_VERSION } from './types.js';
+export { createDomainEvent, isMandatoryEvent, MANDATORY_EVENT_TYPES, NoopEventPublisher, InMemoryEventPublisher } from './events.js';
+export { applySubscriptionEvent, changePlan, cancelSubscription, startTrial } from './reconcile.js';
+// 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.
+export { dunningStepsAsEvents } from './dunning.js';
+export { resolveSubscriptionBillingProvider } from './provider/registry.js';
+export { AsaasSubscriptionProvider } from './provider/asaas.js';
+export { DisabledSubscriptionProvider } from './provider/disabled.js';
+// ── BILL-01 (Fase 17): persistência + serviço do Billing SaaS ────────────────
+export { SAAS_PLANS, DEFAULT_TRIAL_DAYS } from './plans.js';
+export { ensureSaasPlanCatalog, listPublicPlans, getPlan, getSubscription, getSubscriptionByTenant, upsertSubscription, listInvoices, listBillingEvents, withOperatorContext, } from './repository.js';
+export { seedSaasPlans, signupSelfService, subscriptionOverview, standingFor, entitlementsForPlan, startCheckout, processWebhook, changePlanForTenant, cancelForTenant, reactivateForTenant, backofficeListSubscriptions, backofficeOverview, backofficeListWebhookEvents, backofficeActivateSubscription, retryFailedWebhookEvents, runBillingCron, } from './service.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subscription-billing/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,wBAAwB,EAAE,iCAAiC,EAAE,qCAAqC,EAAE,MAAM,YAAY,CAAC;AAGhI,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGrI,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpG,6EAA6E;AAC7E,gFAAgF;AAChF,0EAA0E;AAC1E,2BAA2B;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,OAAO,EACP,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAClB,2BAA2B,EAC3B,8BAA8B,EAC9B,wBAAwB,EACxB,cAAc,GACf,MAAM,cAAc,CAAC"}

package/dist/subscription-billing/plans.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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).
+ */
+/**
+ * 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.
+ */
+export declare const DEFAULT_PRODUCT_KEY = "contabil";
+export interface SaasPlanDef {
+    /** Produto dono do plano. Ausente = `contabil` (todo o catálogo atual). */
+    productKey?: string;
+    key: string;
+    name: string;
+    description: string;
+    amountCents: number;
+    periodicity: 'monthly' | 'quarterly' | 'yearly';
+    trialDays: number;
+    modules: string[];
+    limits: Record<string, number>;
+    isPublic: boolean;
+    isActive: boolean;
+    sortOrder: number;
+}
+export declare const DEFAULT_TRIAL_DAYS = 14;
+export declare const SAAS_PLANS: readonly SaasPlanDef[];
+//# sourceMappingURL=plans.d.ts.map

package/dist/subscription-billing/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/subscription-billing/plans.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,UAAU,EAAE,SAAS,WAAW,EAkE5C,CAAC"}

package/dist/subscription-billing/plans.js

@@ -0,0 +1,85 @@
+/**
+ * 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).
+ */
+/**
+ * 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.
+ */
+export const DEFAULT_PRODUCT_KEY = 'contabil';
+export const DEFAULT_TRIAL_DAYS = 14;
+export const SAAS_PLANS = [
+    {
+        key: 'starter',
+        name: 'Starter',
+        description: 'Para escritórios começando a digitalizar a operação.',
+        amountCents: 9700,
+        periodicity: 'monthly',
+        trialDays: 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: 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: 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: 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/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;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAkB9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,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,kBAAkB;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,kBAAkB;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,kBAAkB;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,kBAAkB;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/subscription-billing/product-config.d.ts

@@ -0,0 +1,61 @@
+import type { SaasBillingConfig } from './service.js';
+/**
+ * Nível 2 do Programa Billing Multi-Produto — **Product Billing**.
+ *
+ * O Billing Core (nível 1) é só tecnologia: gateway, webhook, checkout, régua,
+ * máquina de estados. Ele não sabe o que é "Baruk Office" nem "Dental". Quem
+ * sabe é este descritor: cada PRODUTO do ecossistema tem a sua conta de
+ * gateway, a sua base pública, o seu remetente e a sua política de suspensão.
+ *
+ * Isso substitui a configuração global única (`BILLING_API_KEY`,
+ * `BARUK_WEB_URL`, …), que tornava impossível dois produtos cobrarem ao mesmo
+ * tempo — e, pior, faria o checkout de um produto retornar para o domínio de
+ * outro.
+ *
+ * Isolamento financeiro (decisão de 2026-07-31): produtos compartilham
+ * TECNOLOGIA, nunca dinheiro. Cada `ProductBillingConfig` aponta para uma conta
+ * de gateway distinta; nenhum caminho de código soma, cruza ou concilia valores
+ * entre produtos.
+ *
+ * O nível 3 (**Tenant Billing** — cada escritório contábil com a sua própria
+ * conta ASAAS) entra por trás desta mesma interface: `resolve()` recebe um
+ * `tenantId` opcional e hoje o ignora. Quando `payment_provider_account` +
+ * Vault existirem, é aqui que a credencial do tenant sobrepõe a do produto, sem
+ * que nenhum chamador mude.
+ */
+export interface ProductBillingConfig extends SaasBillingConfig {
+    /** Produto dono desta configuração (`product.key`). */
+    productKey: string;
+}
+/** Contexto de resolução. `tenantId` reservado para o nível 3 (Tenant Billing). */
+export interface BillingConfigScope {
+    productKey: string;
+    tenantId?: string;
+}
+export interface ProductBillingRegistry {
+    /**
+     * Configuração financeira do escopo pedido.
+     * @throws ValidationError se o produto não estiver configurado — cobrar com a
+     * conta errada é pior do que não cobrar.
+     */
+    resolve(scope: BillingConfigScope): ProductBillingConfig;
+    has(productKey: string): boolean;
+    /** Produtos configurados, em ordem estável. */
+    productKeys(): string[];
+}
+/**
+ * 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ó.
+ */
+export declare function createProductBillingRegistry(configs: readonly ProductBillingConfig[], options?: {
+    fallbackProductKey?: string;
+}): ProductBillingRegistry;
+/**
+ * Registry de um produto só — atalho para ambientes de um produto e para os
+ * testes que já existiam antes do multi-produto.
+ */
+export declare function singleProductRegistry(config: SaasBillingConfig, productKey?: string): ProductBillingRegistry;
+//# sourceMappingURL=product-config.d.ts.map

package/dist/subscription-billing/product-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-config.d.ts","sourceRoot":"","sources":["../../src/subscription-billing/product-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IACzD,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,+CAA+C;IAC/C,WAAW,IAAI,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,sBAAsB,CAgCxB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,UAAU,GAAE,MAA4B,GACvC,sBAAsB,CAIxB"}

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

@@ -0,0 +1,50 @@
+import { ValidationError } from '@baruk/shared';
+import { DEFAULT_PRODUCT_KEY } from './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ó.
+ */
+export function createProductBillingRegistry(configs, options = {}) {
+    const byKey = new Map();
+    for (const cfg of configs) {
+        if (!cfg.productKey)
+            throw new ValidationError('ProductBillingConfig sem productKey');
+        if (byKey.has(cfg.productKey)) {
+            throw new 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 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 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.
+ */
+export function singleProductRegistry(config, productKey = DEFAULT_PRODUCT_KEY) {
+    return createProductBillingRegistry([{ ...config, productKey }], {
+        fallbackProductKey: productKey,
+    });
+}
+//# sourceMappingURL=product-config.js.map

package/dist/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":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAiDjD;;;;;;GAMG;AACH,MAAM,UAAU,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,eAAe,CAAC,qCAAqC,CAAC,CAAC;QACtF,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,eAAe,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,eAAe,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,eAAe,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,MAAM,UAAU,qBAAqB,CACnC,MAAyB,EACzB,aAAqB,mBAAmB;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/subscription-billing/provider/asaas.d.ts

@@ -0,0 +1,26 @@
+import type { BillingMode, CreateCheckoutInput, EnsureCustomerInput, NormalizedWebhookEvent, PaymentGatewayProvider, ProviderCheckout, SubscriptionProviderConfig, ProviderCustomer, ProviderInvoice, WebhookHeaders } from '../types.js';
+export declare class AsaasSubscriptionProvider implements PaymentGatewayProvider {
+    readonly name = "asaas";
+    readonly mode: BillingMode;
+    private readonly apiKey;
+    private readonly webhookSecret?;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(config: SubscriptionProviderConfig);
+    private call;
+    ensureCustomer(input: EnsureCustomerInput): Promise<ProviderCustomer>;
+    createCheckout(input: CreateCheckoutInput): Promise<ProviderCheckout>;
+    getPayment(externalId: string): Promise<ProviderInvoice | null>;
+    /** Autenticidade — SEMPRE antes de `parseWebhookEvent` (RFC §7, passo separado). */
+    verifyWebhook(headers: WebhookHeaders, _rawBody: string): boolean;
+    /**
+     * 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: unknown): NormalizedWebhookEvent | null;
+}
+//# sourceMappingURL=asaas.d.ts.map

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

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

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

@@ -0,0 +1,229 @@
+import { timingSafeEqual } from 'node:crypto';
+import { AppError } from '@baruk/shared';
+import { logSanitized } from '../../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 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 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,
+    };
+}
+export 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}`;
+                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);
+            }
+            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',
+        };
+    }
+}
+//# sourceMappingURL=asaas.js.map

package/dist/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/subscription-billing/provider/disabled.d.ts

@@ -0,0 +1,30 @@
+import type { CreateCheckoutInput, EnsureCustomerInput, NormalizedWebhookEvent, PaymentGatewayProvider, ProviderCheckout, ProviderCustomer, ProviderInvoice, WebhookHeaders } from '../types.js';
+/**
+ * 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.
+ */
+export declare class DisabledSubscriptionProvider implements PaymentGatewayProvider {
+    readonly name: string;
+    readonly mode: "disabled";
+    constructor(name?: string);
+    /**
+     * 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.
+     */
+    ensureCustomer(_input: EnsureCustomerInput): Promise<ProviderCustomer>;
+    createCheckout(_input: CreateCheckoutInput): Promise<ProviderCheckout>;
+    getPayment(_externalId: string): Promise<ProviderInvoice | null>;
+    verifyWebhook(_headers: WebhookHeaders, _rawBody: string): boolean;
+    parseWebhookEvent(_payload: unknown): NormalizedWebhookEvent | null;
+}
+//# sourceMappingURL=disabled.d.ts.map

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

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