@baruk/core 0.4.2 → 0.6.0

package/dist/subscription-billing/index.js

@@ -1,5 +1,5 @@
-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 { 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`) —
@@ -12,5 +12,6 @@ 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';
+export { seedSaasPlans, signupSelfService, provisionAccountingOffice, subscriptionOverview, standingFor, entitlementsForPlan, startCheckout, processWebhook, changePlanForTenant, cancelForTenant, reactivateForTenant, backofficeListSubscriptions, backofficeOverview, backofficeListWebhookEvents, backofficeActivateSubscription, backofficeSetPlatformBillingExemption, retryFailedWebhookEvents, runBillingCron, } from './service.js';
+export { readTenantPlatformBilling, setTenantPlatformBilling, isPlatformBillingExempt, standardPlatformBilling, PlatformBillingExemptError, } from './platform-exemption.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subscription-billing/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,wBAAwB,EACxB,iCAAiC,EACjC,qCAAqC,GACtC,MAAM,YAAY,CAAC;AAQpB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,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;AAQzB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAClB,2BAA2B,EAC3B,8BAA8B,EAC9B,qCAAqC,EACrC,wBAAwB,EACxB,cAAc,GACf,MAAM,cAAc,CAAC;AActB,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}

package/dist/subscription-billing/platform-exemption.d.ts

@@ -0,0 +1,89 @@
+import type { Tx } from '../db/client.js';
+/**
+ * A cobrança da PLATAFORMA — e a isenção do escritório fundador.
+ *
+ * ## As duas cobranças que este produto tem, e o custo de confundi-las
+ *
+ *   plataforma   Baruk → escritório, pela assinatura do Office.
+ *   escritório   escritório → clientes dele, pelos honorários.
+ *
+ * O escritório fundador não paga a primeira. As duas formas erradas de
+ * implementar isso já custaram caro em outros produtos:
+ *
+ * **Desligar o financeiro dele.** Apagaria a SEGUNDA cobrança — que é o produto
+ * inteiro, e a razão de o escritório usar o Office. Isento de assinatura não é
+ * isento de operar.
+ *
+ * **`if (tenant.code === 'sc')`.** Faz o segundo escritório fundador virar um
+ * deploy, e a decisão comercial some dentro de um `if` que ninguém audita. É por
+ * isso que este módulo não conhece nenhum código de escritório: ele lê uma linha
+ * de configuração, e quem a escreveu está gravado nela.
+ *
+ * ## Quem escreve não é quem é cobrado
+ *
+ * A 0060 dá a `tenant_platform_billing` políticas POR COMANDO: o tenant lê a
+ * própria linha; só o operador da plataforma escreve. Um controle que o
+ * controlado pudesse gravar não seria controle — todo escritório seria fundador
+ * na primeira tarde.
+ */
+export type PlatformBillingMode = 'standard' | 'exempt';
+export type PlatformExemptionReason = 'founding_tenant' | 'internal' | 'partner';
+export interface TenantPlatformBilling {
+    tenantId: string;
+    billingMode: PlatformBillingMode;
+    exemptionReason: PlatformExemptionReason | null;
+    foundingTenant: boolean;
+    grantedBy: string | null;
+    grantedAt: string | null;
+    /** Isenção com prazo. `null` = sem prazo, que é o caso do fundador. */
+    expiresOn: string | null;
+    notes: string | null;
+}
+/**
+ * A leitura padrão para quem não tem linha: cobrança normal.
+ *
+ * Ausência NUNCA vira isenção. Se a tabela sumisse, se a RLS escondesse a linha,
+ * ou se o tenant fosse novo, a resposta é a que cobra — errar para o lado de
+ * cobrar é recuperável com um estorno; errar para o lado de isentar em silêncio
+ * é receita que ninguém percebe faltando.
+ */
+export declare function standardPlatformBilling(tenantId: string): TenantPlatformBilling;
+/**
+ * Lê a configuração de cobrança do tenant corrente.
+ *
+ * Tolera a ausência da tabela (`42P01`): um banco que ainda não aplicou a 0060
+ * responde "cobrança padrão", que é o comportamento anterior — e não uma exceção
+ * que derruba o checkout.
+ */
+export declare function readTenantPlatformBilling(tx: Tx, tenantId: string): Promise<TenantPlatformBilling>;
+/**
+ * A isenção vale AGORA?
+ *
+ * Uma isenção com `expires_on` vencido volta a cobrar sozinha. Sem isso, uma
+ * cortesia de três meses concedida em janeiro seguiria valendo em dezembro, e
+ * ninguém olharia — a mesma classe de defeito do token de 60 dias que só é
+ * descoberto por uma cobrança que não saiu.
+ */
+export declare function isPlatformBillingExempt(record: TenantPlatformBilling, now?: Date): boolean;
+/** Erro de quem tenta cobrar um tenant isento. Classe, para a rota traduzir. */
+export declare class PlatformBillingExemptError extends Error {
+    readonly reason: PlatformExemptionReason | null;
+    constructor(reason: PlatformExemptionReason | null);
+}
+/**
+ * Escreve a configuração. SÓ o operador da plataforma chega aqui.
+ *
+ * A função não confere o privilégio: a RLS da 0060 confere, e é ela quem tem de
+ * conferir. Uma checagem em TypeScript aqui daria a impressão de ser o controle,
+ * e sobreviveria a alguém apagar as políticas.
+ */
+export declare function setTenantPlatformBilling(tx: Tx, input: {
+    tenantId: string;
+    billingMode: PlatformBillingMode;
+    exemptionReason?: PlatformExemptionReason | null;
+    foundingTenant?: boolean;
+    grantedBy: string | null;
+    expiresOn?: string | null;
+    notes?: string | null;
+}): Promise<TenantPlatformBilling>;
+//# sourceMappingURL=platform-exemption.d.ts.map

package/dist/subscription-billing/platform-exemption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-exemption.d.ts","sourceRoot":"","sources":["../../src/subscription-billing/platform-exemption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,mBAAmB,CAAC;IACjC,eAAe,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAW/E;AA6BD;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CAWhC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,qBAAqB,EAC7B,GAAG,GAAE,IAAiB,GACrB,OAAO,CAIT;AAED,gFAAgF;AAChF,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;gBAAtC,MAAM,EAAE,uBAAuB,GAAG,IAAI;CAI5D;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,mBAAmB,CAAC;IACjC,eAAe,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GACA,OAAO,CAAC,qBAAqB,CAAC,CAyBhC"}

package/dist/subscription-billing/platform-exemption.js

@@ -0,0 +1,113 @@
+/**
+ * A leitura padrão para quem não tem linha: cobrança normal.
+ *
+ * Ausência NUNCA vira isenção. Se a tabela sumisse, se a RLS escondesse a linha,
+ * ou se o tenant fosse novo, a resposta é a que cobra — errar para o lado de
+ * cobrar é recuperável com um estorno; errar para o lado de isentar em silêncio
+ * é receita que ninguém percebe faltando.
+ */
+export function standardPlatformBilling(tenantId) {
+    return {
+        tenantId,
+        billingMode: 'standard',
+        exemptionReason: null,
+        foundingTenant: false,
+        grantedBy: null,
+        grantedAt: null,
+        expiresOn: null,
+        notes: null,
+    };
+}
+const COLUMNS = `tenant_id, billing_mode, exemption_reason, founding_tenant,
+                 granted_by, granted_at, expires_on, notes`;
+function map(r) {
+    return {
+        tenantId: r.tenant_id,
+        billingMode: r.billing_mode,
+        exemptionReason: r.exemption_reason,
+        foundingTenant: r.founding_tenant,
+        grantedBy: r.granted_by,
+        grantedAt: r.granted_at?.toISOString() ?? null,
+        expiresOn: r.expires_on ? r.expires_on.toISOString().slice(0, 10) : null,
+        notes: r.notes,
+    };
+}
+/**
+ * Lê a configuração de cobrança do tenant corrente.
+ *
+ * Tolera a ausência da tabela (`42P01`): um banco que ainda não aplicou a 0060
+ * responde "cobrança padrão", que é o comportamento anterior — e não uma exceção
+ * que derruba o checkout.
+ */
+export async function readTenantPlatformBilling(tx, tenantId) {
+    try {
+        const rows = await tx `
+      SELECT ${tx.unsafe(COLUMNS)} FROM tenant_platform_billing WHERE tenant_id = ${tenantId}
+    `;
+        return rows[0] ? map(rows[0]) : standardPlatformBilling(tenantId);
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === '42P01' || code === '42703')
+            return standardPlatformBilling(tenantId);
+        throw err;
+    }
+}
+/**
+ * A isenção vale AGORA?
+ *
+ * Uma isenção com `expires_on` vencido volta a cobrar sozinha. Sem isso, uma
+ * cortesia de três meses concedida em janeiro seguiria valendo em dezembro, e
+ * ninguém olharia — a mesma classe de defeito do token de 60 dias que só é
+ * descoberto por uma cobrança que não saiu.
+ */
+export function isPlatformBillingExempt(record, now = new Date()) {
+    if (record.billingMode !== 'exempt')
+        return false;
+    if (!record.expiresOn)
+        return true;
+    return record.expiresOn >= now.toISOString().slice(0, 10);
+}
+/** Erro de quem tenta cobrar um tenant isento. Classe, para a rota traduzir. */
+export class PlatformBillingExemptError extends Error {
+    reason;
+    constructor(reason) {
+        super(`tenant isento da assinatura da plataforma (${reason ?? 'sem motivo registrado'})`);
+        this.reason = reason;
+        this.name = 'PlatformBillingExemptError';
+    }
+}
+/**
+ * Escreve a configuração. SÓ o operador da plataforma chega aqui.
+ *
+ * A função não confere o privilégio: a RLS da 0060 confere, e é ela quem tem de
+ * conferir. Uma checagem em TypeScript aqui daria a impressão de ser o controle,
+ * e sobreviveria a alguém apagar as políticas.
+ */
+export async function setTenantPlatformBilling(tx, input) {
+    const exempt = input.billingMode === 'exempt';
+    const rows = await tx `
+    INSERT INTO tenant_platform_billing (
+      tenant_id, billing_mode, exemption_reason, founding_tenant,
+      granted_by, granted_at, expires_on, notes
+    ) VALUES (
+      ${input.tenantId}, ${input.billingMode},
+      ${exempt ? (input.exemptionReason ?? 'internal') : null},
+      ${input.foundingTenant ?? false}, ${input.grantedBy},
+      ${exempt ? new Date().toISOString() : null},
+      ${input.expiresOn ?? null}, ${input.notes ?? null}
+    )
+    ON CONFLICT (tenant_id) DO UPDATE SET
+      billing_mode = EXCLUDED.billing_mode,
+      exemption_reason = EXCLUDED.exemption_reason,
+      founding_tenant = EXCLUDED.founding_tenant,
+      granted_by = EXCLUDED.granted_by,
+      granted_at = EXCLUDED.granted_at,
+      expires_on = EXCLUDED.expires_on,
+      notes = EXCLUDED.notes,
+      updated_at = now()
+    RETURNING ${tx.unsafe(COLUMNS)}
+  `;
+    return map(rows[0]);
+}
+//# sourceMappingURL=platform-exemption.js.map

package/dist/subscription-billing/platform-exemption.js.map

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

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

@@ -1,5 +1,6 @@
 import type { Db } from '../db/client.js';
 import type { EntitlementRecord } from '../entitlements/types.js';
+import { type PlatformBillingMode, type PlatformExemptionReason, type TenantPlatformBilling } from './platform-exemption.js';
 import type { BillingMode, SubscriptionStatus, WebhookHeaders } from './types.js';
 import { ensureSaasPlanCatalog, getPlan, listBillingEvents, listInvoices, listPublicPlans, type SaasPlanRow, type SubscriptionRow } from './repository.js';
 import { type ProductBillingRegistry } from './product-config.js';
@@ -54,6 +55,27 @@ export interface SignupResult {
     planKey: string;
     trialEndsAt: string;
 }
+export interface ProvisionOfficeInput {
+    companyName: string;
+    ownerEmail: string;
+    ownerFullName: string;
+    planKey?: string;
+    /** Usuário da operadora que provisiona — vira `invited_by` e ator da trilha. */
+    operatorUserId: string;
+    ip?: string | null;
+    userAgent?: string | null;
+}
+export interface ProvisionOfficeResult {
+    tenantId: string;
+    tenantCode: string;
+    ownerUserId: string;
+    ownerEmail: string;
+    planKey: string;
+    trialEndsAt: string;
+    /** Token de ativação do dono. A borda HTTP compõe o link e envia o e-mail. */
+    activationToken: string | null;
+}
+export declare function provisionAccountingOffice(db: Db, input: ProvisionOfficeInput, nowIso: string): Promise<ProvisionOfficeResult>;
 /**
  * Cadastro self-service (Fase 17): cria usuário + tenant em TRIAL + organização +
  * membership com papel `owner` + entitlement do produto + assinatura `trialing`.
@@ -74,6 +96,14 @@ export interface SubscriptionOverview {
     invoices: Awaited<ReturnType<typeof listInvoices>>;
     entitlements: EntitlementRecord[];
     events: Awaited<ReturnType<typeof listBillingEvents>>;
+    /**
+     * Como a PLATAFORMA cobra este escritório. Vai junto do standing porque a tela
+     * precisa das duas coisas para não mentir: um tenant isento sem assinatura tem
+     * `standing.reason = 'none'`, e mostrar só isso diria "sem assinatura" a quem
+     * está isento por decisão comercial.
+     */
+    platformBilling: TenantPlatformBilling;
+    platformBillingExempt: boolean;
 }
 export declare function subscriptionOverview(db: Db, ctx: {
     tenantId: string;
@@ -161,6 +191,50 @@ export declare function backofficeListWebhookEvents(db: Db, limit?: number): Pro
  * simula uma fatura `received` e reconcilia pelo MESMO caminho do webhook —
  * nenhuma transição de estado fora do domínio puro.
  */
+/**
+ * A operadora declara — ou revoga — a isenção da assinatura de plataforma.
+ *
+ * ## Por que esta função existe, e por que ela não existia
+ *
+ * A C1 entregou `tenant_platform_billing` com RLS por comando e testes verdes, e
+ * a tabela terminou o deploy com ZERO linhas. Não por esquecimento: não havia
+ * caminho de produto para escrevê-la. `setTenantPlatformBilling` era exportada e
+ * alcançável só por código, o que na prática significa "alguém abre um console e
+ * roda um script" — exatamente o tipo de ato que a tabela existe para tornar
+ * auditável.
+ *
+ * Um mecanismo cujo único acionamento é um script fora do produto não é um
+ * mecanismo auditável; é um mecanismo com a auditoria de fora.
+ *
+ * ## Quem pode
+ *
+ * Só a OPERADORA (allowlist de e-mails do backoffice). O tenant não escreve a
+ * própria isenção — a RLS da 0060 já garante isso, e esta rota não é uma segunda
+ * barreira, é o caminho que atravessa a primeira legitimamente, com
+ * `withOperatorContext`.
+ *
+ * ## O que fica gravado
+ *
+ * `granted_by` é o USUÁRIO operador, não um rótulo. `granted_at` sai do banco.
+ * E a trilha registra o e-mail de quem decidiu, o motivo e o tenant — porque a
+ * pergunta que alguém vai fazer daqui a um ano é "quem isentou este escritório,
+ * quando e por quê", e ela não pode depender de memória.
+ *
+ * Revogar usa a mesma porta: `billingMode: 'standard'` limpa motivo e data, e o
+ * motor volta a cobrar. Uma isenção que só se concede é uma isenção permanente
+ * por acidente.
+ */
+export declare function backofficeSetPlatformBillingExemption(db: Db, operator: {
+    email: string;
+    userId: string;
+}, input: {
+    tenantId: string;
+    billingMode: PlatformBillingMode;
+    exemptionReason?: PlatformExemptionReason | null;
+    foundingTenant?: boolean;
+    expiresOn?: string | null;
+    notes?: string | null;
+}): Promise<TenantPlatformBilling>;
 export declare function backofficeActivateSubscription(db: Db, operatorEmail: string, tenantId: string, planKey: string, nowIso: string): Promise<SubscriptionRow>;
 /**
  * Reprocessa eventos de webhook `failed` recentes (rede de segurança para o

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

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

package/dist/subscription-billing/service.js

@@ -2,16 +2,18 @@ import { ConflictError, NotFoundError, ValidationError, uuidv7 } from '@baruk/sh
 import { withContext } from '../db/context.js';
 import { appendAudit } from '../audit/audit.js';
 import { hashPassword } from '../auth/password.js';
+import { inviteUser } from '../users/repository.js';
 import { assignSystemRole, ensureMembership, ensureOrganization, ensureTenant, } from '../tenancy/provisioning.js';
 import { ensureProductCatalog, ensureTenantProduct } from '../products/repository.js';
 import { deriveEntitlements } from '../entitlements/derive.js';
 import { sendTransactionalOutbound } from '../mail/transactional-outbound.js';
 import { applySubscriptionEvent, cancelSubscription, changePlan, startTrial } from './reconcile.js';
+import { isPlatformBillingExempt, PlatformBillingExemptError, readTenantPlatformBilling, setTenantPlatformBilling, } from './platform-exemption.js';
 import { dunningStepsAsEvents } from './dunning.js';
 import { assertLiveProviderAllowed, readLiveRuntime } from '../billing/live-guard.js';
 import { resolveSubscriptionBillingProvider } from './provider/registry.js';
 import { appendDomainEvents, backofficeSummary, ensureSaasPlanCatalog, getPlan, getSubscription, insertWebhookEvent, listAllSubscriptions, listBillingEvents, listExecutedDunningSteps, listFailedWebhookEvents, listInvoices, listPublicPlans, listSubscriptionsForCron, lockTenantBilling, markWebhookEvent, recordDunningStep, setSubscriptionProviderRefs, upsertInvoice, upsertSubscription, withOperatorContext, } from './repository.js';
-import { DEFAULT_PRODUCT_KEY, SAAS_PLANS } from './plans.js';
+import { DEFAULT_PRODUCT_KEY, DEFAULT_TRIAL_DAYS, SAAS_PLANS } from './plans.js';
 import { singleProductRegistry } from './product-config.js';
 function asRegistry(source) {
     return 'resolve' in source ? source : singleProductRegistry(source);
@@ -70,6 +72,68 @@ export async function seedSaasPlans(db) {
     await ensureProductCatalog(db);
     await ensureSaasPlanCatalog(db, SAAS_PLANS);
 }
+export async function provisionAccountingOffice(db, input, nowIso) {
+    const email = input.ownerEmail.trim().toLowerCase();
+    if (!/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email))
+        throw new ValidationError('E-mail inválido');
+    if (!input.companyName.trim())
+        throw new ValidationError('Nome do escritório é obrigatório');
+    if (!input.ownerFullName.trim())
+        throw new ValidationError('Nome do responsável é obrigatório');
+    const planKey = input.planKey ?? SAAS_PLANS.find((p) => p.isActive && p.isPublic)?.key;
+    if (!planKey)
+        throw new ValidationError('Nenhum plano ativo disponível');
+    const plan = await getPlan(db, planKey);
+    if (!plan || !plan.isActive)
+        throw new ValidationError(`Plano indisponível: ${planKey}`);
+    const code = await uniqueTenantCode(db, input.companyName);
+    const tenantId = await ensureTenant(db, {
+        code,
+        displayName: input.companyName.trim(),
+        status: 'trial',
+        primaryProduct: DEFAULT_PRODUCT_KEY,
+    });
+    await ensureOrganization(db, tenantId, input.companyName.trim());
+    await ensureProductCatalog(db);
+    await ensureTenantProduct(db, tenantId, DEFAULT_PRODUCT_KEY);
+    const trialEndsAt = addDays(nowIso, plan.trialDays > 0 ? plan.trialDays : DEFAULT_TRIAL_DAYS);
+    const { subscription, domainEvents } = startTrial(tenantId, plan.key, trialEndsAt, nowIso);
+    /*
+     * Contexto do TENANT NOVO com o usuário da OPERADORA.
+     *
+     * O operador não é membro deste escritório e nunca será — ele abre o contexto
+     * para criar o convite e sai. O `invited_by` aponta para ele, que é a
+     * resposta honesta a "quem colocou esta pessoa aqui".
+     */
+    return withContext(db, { tenantId, userId: input.operatorUserId }, async (tx) => {
+        const invited = await inviteUser(tx, {
+            email,
+            fullName: input.ownerFullName.trim(),
+            roleKey: 'owner',
+            invitedBy: input.operatorUserId,
+        });
+        const row = await upsertSubscription(tx, { tenantId, planKey: plan.key, subscription });
+        await appendDomainEvents(tx, row.rowId, domainEvents);
+        await appendAudit(tx, {
+            actorId: input.operatorUserId,
+            action: 'tenant.provisioned_by_operator',
+            resourceType: 'tenant',
+            resourceId: tenantId,
+            metadata: { planKey: plan.key, trialEndsAt, tenantCode: code, ownerEmail: email },
+            ip: input.ip ?? null,
+            userAgent: input.userAgent ?? null,
+        });
+        return {
+            tenantId,
+            tenantCode: code,
+            ownerUserId: invited.userId,
+            ownerEmail: invited.email,
+            planKey: plan.key,
+            trialEndsAt,
+            activationToken: invited.activationToken,
+        };
+    });
+}
 function slugify(name) {
     return name
         .normalize('NFD')
@@ -79,6 +143,31 @@ function slugify(name) {
         .replace(/^-+|-+$/g, '')
         .slice(0, 40);
 }
+/**
+ * Código do escritório a partir do nome, único na base.
+ *
+ * Extraído do signup quando o provisionamento pela operadora passou a precisar
+ * do mesmo cálculo. Duas cópias da regra de colisão renderiam dois códigos
+ * diferentes para o mesmo nome dependendo de por qual porta o escritório
+ * entrou — e o código aparece em referência de cobrança já emitida.
+ */
+async function uniqueTenantCode(db, companyName) {
+    const base = slugify(companyName) || 'escritorio';
+    let code = base;
+    for (let i = 2;; i += 1) {
+        const clash = await db `
+      SELECT id FROM tenant WHERE lower(code) = lower(${code}) AND deleted_at IS NULL
+    `;
+        if (!clash[0])
+            break;
+        code = `${base}-${i}`;
+        if (i > 50) {
+            code = `${base}-${uuidv7().slice(-6)}`;
+            break;
+        }
+    }
+    return code;
+}
 /**
  * Cadastro self-service (Fase 17): cria usuário + tenant em TRIAL + organização +
  * membership com papel `owner` + entitlement do produto + assinatura `trialing`.
@@ -103,20 +192,7 @@ export async function signupSelfService(db, input, nowIso) {
         throw new ConflictError('Já existe uma conta com este e-mail. Faça login para continuar.');
     }
     // Código único do tenant a partir do nome (sufixo em caso de colisão).
-    const base = slugify(input.companyName) || 'escritorio';
-    let code = base;
-    for (let i = 2;; i += 1) {
-        const clash = await db `
-      SELECT id FROM tenant WHERE lower(code) = lower(${code}) AND deleted_at IS NULL
-    `;
-        if (!clash[0])
-            break;
-        code = `${base}-${i}`;
-        if (i > 50) {
-            code = `${base}-${uuidv7().slice(-6)}`;
-            break;
-        }
-    }
+    const code = await uniqueTenantCode(db, input.companyName);
     // INSERT puro (não upsert): o papel de app pode CRIAR credencial, nunca
     // sobrescrever (REVOKE UPDATE em user_credential — anti account-takeover).
     // A checagem de e-mail acima já garante que o usuário é novo.
@@ -191,12 +267,13 @@ export function entitlementsForPlan(sub, plan, nowIso) {
     });
 }
 export async function subscriptionOverview(db, ctx, nowIso) {
-    const { sub, invoices, events } = await withContext(db, ctx, async (tx) => {
+    const { sub, invoices, events, platformBilling } = await withContext(db, ctx, async (tx) => {
         const sub0 = await getSubscription(tx);
         return {
             sub: sub0,
             invoices: sub0 ? await listInvoices(tx) : [],
             events: sub0 ? await listBillingEvents(tx, 20) : [],
+            platformBilling: await readTenantPlatformBilling(tx, ctx.tenantId),
         };
     });
     // Fora da transação: getPlan usa outra conexão do pool — dentro dela seria
@@ -209,6 +286,8 @@ export async function subscriptionOverview(db, ctx, nowIso) {
         invoices,
         entitlements: entitlementsForPlan(sub, plan, nowIso),
         events,
+        platformBilling,
+        platformBillingExempt: isPlatformBillingExempt(platformBilling),
     };
 }
 /**
@@ -230,6 +309,21 @@ export async function startCheckout(db, ctx, source, planKey, _nowIso, productKe
     // A conta de gateway e a URL de retorno saem do PRODUTO do plano — nunca de
     // uma configuração global. É isso que impede o checkout de um produto voltar
     // para o domínio de outro, ou cobrar na conta errada.
+    // ═══ O portão da isenção vem ANTES do gateway ═════════════════════════════
+    //
+    // Um tenant isento da assinatura da plataforma não deve nem chegar a existir
+    // como cliente no gateway: `ensureCustomer` cria cadastro, `createCheckout`
+    // cria link de cobrança, e um link emitido é uma cobrança que alguém pode
+    // pagar. Recusar depois — ao reconciliar o webhook — já teria custado dinheiro
+    // ao escritório fundador.
+    //
+    // A isenção NÃO desliga o financeiro do escritório: `receivable`, honorários e
+    // régua continuam intactos. O que ela desliga é a cobrança que a Baruk faz ao
+    // escritório, e só ela.
+    const billing = await withContext(db, ctx, (tx) => readTenantPlatformBilling(tx, ctx.tenantId));
+    if (isPlatformBillingExempt(billing)) {
+        throw new PlatformBillingExemptError(billing.exemptionReason);
+    }
     const cfg = asRegistry(source).resolve({ productKey: plan.productKey, tenantId: ctx.tenantId });
     const provider = providerFor(cfg);
     if (provider.mode === 'disabled') {
@@ -614,6 +708,78 @@ export async function backofficeListWebhookEvents(db, limit = 100) {
  * simula uma fatura `received` e reconcilia pelo MESMO caminho do webhook —
  * nenhuma transição de estado fora do domínio puro.
  */
+/**
+ * A operadora declara — ou revoga — a isenção da assinatura de plataforma.
+ *
+ * ## Por que esta função existe, e por que ela não existia
+ *
+ * A C1 entregou `tenant_platform_billing` com RLS por comando e testes verdes, e
+ * a tabela terminou o deploy com ZERO linhas. Não por esquecimento: não havia
+ * caminho de produto para escrevê-la. `setTenantPlatformBilling` era exportada e
+ * alcançável só por código, o que na prática significa "alguém abre um console e
+ * roda um script" — exatamente o tipo de ato que a tabela existe para tornar
+ * auditável.
+ *
+ * Um mecanismo cujo único acionamento é um script fora do produto não é um
+ * mecanismo auditável; é um mecanismo com a auditoria de fora.
+ *
+ * ## Quem pode
+ *
+ * Só a OPERADORA (allowlist de e-mails do backoffice). O tenant não escreve a
+ * própria isenção — a RLS da 0060 já garante isso, e esta rota não é uma segunda
+ * barreira, é o caminho que atravessa a primeira legitimamente, com
+ * `withOperatorContext`.
+ *
+ * ## O que fica gravado
+ *
+ * `granted_by` é o USUÁRIO operador, não um rótulo. `granted_at` sai do banco.
+ * E a trilha registra o e-mail de quem decidiu, o motivo e o tenant — porque a
+ * pergunta que alguém vai fazer daqui a um ano é "quem isentou este escritório,
+ * quando e por quê", e ela não pode depender de memória.
+ *
+ * Revogar usa a mesma porta: `billingMode: 'standard'` limpa motivo e data, e o
+ * motor volta a cobrar. Uma isenção que só se concede é uma isenção permanente
+ * por acidente.
+ */
+export async function backofficeSetPlatformBillingExemption(db, operator, input) {
+    const tenants = await db `
+    SELECT id FROM tenant WHERE id = ${input.tenantId} AND deleted_at IS NULL
+  `;
+    if (!tenants[0])
+        throw new ValidationError(`Tenant desconhecido: ${input.tenantId}`);
+    const record = await withOperatorContext(db, (tx) => setTenantPlatformBilling(tx, {
+        tenantId: input.tenantId,
+        billingMode: input.billingMode,
+        exemptionReason: input.exemptionReason ?? null,
+        foundingTenant: input.foundingTenant ?? false,
+        grantedBy: operator.userId,
+        expiresOn: input.expiresOn ?? null,
+        notes: input.notes ?? null,
+    }));
+    /*
+     * A trilha é escrita no contexto do TENANT afetado, e não no do operador: é lá
+     * que alguém vai procurar por que aquele escritório não é cobrado. `audit_log`
+     * é tenant-scoped, e gravar no lugar errado é o mesmo que não gravar.
+     */
+    await withContext(db, { tenantId: input.tenantId, userId: operator.userId }, (tx) => appendAudit(tx, {
+        actorType: 'user',
+        actorId: operator.userId,
+        action: record.billingMode === 'exempt'
+            ? 'platform_billing_exemption_granted'
+            : 'platform_billing_exemption_revoked',
+        resourceType: 'tenant_platform_billing',
+        resourceId: null,
+        metadata: {
+            operatorEmail: operator.email,
+            billingMode: record.billingMode,
+            exemptionReason: record.exemptionReason,
+            foundingTenant: record.foundingTenant,
+            expiresOn: record.expiresOn,
+            notes: record.notes,
+        },
+    }));
+    return record;
+}
 export async function backofficeActivateSubscription(db, operatorEmail, tenantId, planKey, nowIso) {
     const plan = await getPlan(db, planKey);
     if (!plan)