feat(entitlements,campaigns): plans/quotas + campanhas, leads, lista de bloqueio

Fecha duas fases: Plans/Entitlements (agente.md secao 56-62), que tinha
ficado pra trás desde o inicio, e Campanhas/Leads/Lista de Bloqueio (secao
63-71).

## Plans/Entitlements

A ordem de implementacao da propria especificacao (secao 232) coloca
Plans/Entitlements logo depois de PostgreSQL RLS, bem antes de FreeSWITCH
— mas o build seguiu direto sem essa peca, e toda fase desde entao
documentou "quota depende de Plans/Entitlements" como pendencia
(EXTENSIONS.md, TRUNKS.md, AGENTS.md, QUEUES.md, agora todas atualizadas).
Fechado agora porque Campanhas precisa de max_campaigns e o proximo CPS
Limiter vai precisar de max_cps/max_concurrent_calls.

- plans: catalogo compartilhado entre tenants (sem RLS, nao e' tenant-
  scoped) com todos os campos de entitlement da secao 56. Campo de limite
  null = "sem limite", nunca "sem plano" — tenants.plan_id e' obrigatorio,
  nunca null (secao 56: nao espalhar `if plan == PRO` pelo codigo).
- Migration hand-escrita: cria plans, insere seed "trial", faz backfill de
  plan_id pros tenants ja existentes, so' depois torna NOT NULL (Postgres
  nao deixa NOT NULL sem default em tabela nao-vazia).
- packages/entitlements (pacote novo): assertQuota/assertFeatureEnabled,
  erros mapeados pra 403 no DomainExceptionFilter.
- Retrofit em Extensions/Trunks/Agents/Queues: contam linhas ativas e
  checam quota antes de criar.

## Campanhas, Leads, Lista de Bloqueio

Deliberadamente so' o modelo/CRUD/maquina de estados — o motor que de fato
origina chamadas (PredictiveDialerEngine, secao 72-86: dados em tempo
real, EWMA, CPS distribuido, reserva atomica de lead, lock de campanha,
bgapi originate, controle de abandono, retry) e' um sistema grande o
suficiente pra merecer fase propria (secao 72: "nao e' so' `for lead ->
originate`").

- campaigns/leads/suppression_entries (tenant-scoped, RLS).
- Maquina de estados da campanha (secao 64-66): start/pause/drain/stop com
  tabela de transicoes validas — transicao invalida retorna 400, nunca
  ignora silenciosamente. Apagar bloqueado enquanto RUNNING/DRAINING.
- packages/shared/src/phone.ts (secao 70): normalizacao dedicada,
  preparada pra E.164 completo, so' BR implementado.
- Importacao CSV em batches de 1000 (secao 69): detecta duplicado (dentro
  do CSV + contra leads existentes), checa lista de bloqueio (importa como
  DO_NOT_CALL, nao descarta), retorna {total, valid, invalid, duplicates,
  imported, suppressed}.
- Lista de bloqueio (secao 71): CRUD tenant-scoped.

Verificado ponta a ponta: campanha com queueId/trunkId invalido e
pacingMin > pacingMax rejeitados; CSV de 5 linhas (1 invalida, 1
duplicada, 1 bloqueada) importado corretamente; start->pause->drain->stop
e transicoes invalidas todas corretas; 3a campanha rejeitada por quota
(max_campaigns=2 do plano trial); 6a extensao rejeitada por quota
(max_extensions=5). Suites de teste existentes (tenant-isolation, auth)
atualizadas pro novo Tenant.planId obrigatorio e passando.

typecheck do workspace inteiro limpo.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01X1HxY46WGU4G1zmVDNKcWw

packages/entitlements/src/index.ts

@@ -0,0 +1,74 @@
+import { getPrismaClient, type Plan } from "@b2bcall/database";
+
+/**
+ * Entitlements por plano (agente.md secao 56-61): "criar sistema genérico...
+ * não espalhar `if plan == PRO` pelo código". Todo tenant tem exatamente um
+ * Plan (nunca null) — um campo de limite null significa "sem limite", nunca
+ * "sem plano".
+ */
+export class QuotaExceededError extends Error {
+  constructor(
+    public readonly quotaKey: QuotaKey,
+    public readonly limit: number,
+  ) {
+    super(`Quota excedida: ${quotaKey} (limite do plano: ${limit})`);
+    this.name = "QuotaExceededError";
+  }
+}
+
+export class FeatureNotEnabledError extends Error {
+  constructor(public readonly featureKey: FeatureKey) {
+    super(`Recurso nao habilitado no plano: ${featureKey}`);
+    this.name = "FeatureNotEnabledError";
+  }
+}
+
+/** Campos de limite (contagem) do Plan — null = sem limite. */
+export type QuotaKey =
+  | "maxExtensions"
+  | "maxAgents"
+  | "maxTrunks"
+  | "maxQueues"
+  | "maxCampaigns"
+  | "maxConcurrentCalls"
+  | "maxDailyCalls"
+  | "maxMonthlyCalls";
+
+/** Campos booleanos de feature flag do Plan. */
+export type FeatureKey =
+  | "recordingEnabled"
+  | "aiEnabled"
+  | "aiTranscriptionEnabled"
+  | "aiAnalysisEnabled"
+  | "apiAccessEnabled";
+
+export async function getPlanForTenant(tenantId: string): Promise<Plan> {
+  const prisma = getPrismaClient();
+  const tenant = await prisma.tenant.findUniqueOrThrow({
+    where: { id: tenantId },
+    include: { plan: true },
+  });
+  return tenant.plan;
+}
+
+/**
+ * Lança QuotaExceededError se `currentCount` já atingiu o limite do plano
+ * pra `key`. Chamar ANTES de criar a linha (currentCount = contagem atual,
+ * sem contar a nova) — nunca depois, pra não criar e ter que desfazer.
+ */
+export async function assertQuota(tenantId: string, key: QuotaKey, currentCount: number): Promise<void> {
+  const plan = await getPlanForTenant(tenantId);
+  const limit = plan[key];
+  if (limit === null || limit === undefined) return;
+  if (currentCount >= limit) {
+    throw new QuotaExceededError(key, limit);
+  }
+}
+
+/** Lança FeatureNotEnabledError se o plano não habilita `key`. */
+export async function assertFeatureEnabled(tenantId: string, key: FeatureKey): Promise<void> {
+  const plan = await getPlanForTenant(tenantId);
+  if (!plan[key]) {
+    throw new FeatureNotEnabledError(key);
+  }
+}