@baruk/core 0.3.1 → 0.5.0

package/dist/billing/reconcile.js

@@ -0,0 +1,138 @@
+import { randomUUID } from 'node:crypto';
+import { getReceivable, registerPayment, reverseSettlementForCharge } from './ar-repository.js';
+/**
+ * Grava o evento e diz se ele é novo.
+ *
+ * O INSERT é a trava: quem consegue inserir processa, quem colide já foi
+ * processado por outro. Fazer `SELECT` antes e `INSERT` depois deixaria uma
+ * janela entre os dois — e webhook duplicado chega em rajada, exatamente dentro
+ * dessa janela.
+ */
+export async function recordWebhookEvent(tx, input) {
+    const id = randomUUID();
+    const rows = await tx `
+    INSERT INTO webhook_event (
+      id, tenant_id, provider_account_id, provider, external_event_id, event_type, payload
+    ) VALUES (
+      ${id}, ${input.tenantId}, ${input.providerAccountId}, ${input.provider},
+      ${input.eventId}, ${input.eventType}, ${tx.json(input.payload)}
+    )
+    ON CONFLICT DO NOTHING
+    RETURNING id
+  `;
+    return { id: rows[0]?.id ?? id, isNew: Boolean(rows[0]) };
+}
+export async function markWebhookProcessed(tx, id, status) {
+    await tx `
+    UPDATE webhook_event SET status = ${status}, processed_at = now() WHERE id = ${id}
+  `;
+}
+/**
+ * Aplica o evento normalizado ao recebível.
+ *
+ * Chamada DEPOIS de `recordWebhookEvent` ter dito que o evento é novo. Ainda
+ * assim confere o estado do recebível antes de baixar: dois eventos distintos
+ * (`CONFIRMED` e `RECEIVED`) descrevem o mesmo pagamento, passam os dois pelo
+ * dedup por serem eventos diferentes, e baixariam duas vezes o mesmo dinheiro.
+ */
+export async function applyWebhookEvent(tx, event) {
+    if (!event.externalId)
+        return { outcome: 'ignored', receivableId: null, chargeId: null };
+    const rows = await tx `
+    SELECT id, receivable_id, method, amount, status
+    FROM charge WHERE external_id = ${event.externalId} AND deleted_at IS NULL
+    LIMIT 1
+  `;
+    const charge = rows[0];
+    if (!charge)
+        return { outcome: 'charge_not_found', receivableId: null, chargeId: null };
+    const ref = { receivableId: charge.receivable_id, chargeId: charge.id };
+    switch (event.type) {
+        case 'charge.paid':
+            return { ...ref, outcome: await applyPayment(tx, charge, event) };
+        case 'charge.overdue':
+            await setChargeStatus(tx, charge.id, 'overdue');
+            return { ...ref, outcome: 'overdue' };
+        case 'charge.canceled':
+            await setChargeStatus(tx, charge.id, 'canceled');
+            return { ...ref, outcome: 'canceled' };
+        // Estorno e chargeback marcam a COBRANÇA, e não desfazem a baixa.
+        //
+        // Reverter o recebível automaticamente ressuscitaria a dívida e religaria a
+        // régua contra alguém que pode estar em disputa legítima — uma cobrança
+        // automática nesse momento é o pior desfecho possível. O escritório vê o
+        // estado e decide.
+        case 'charge.refunded':
+        case 'charge.chargeback':
+            await setChargeStatus(tx, charge.id, 'refunded');
+            return { ...ref, outcome: 'refunded' };
+        /**
+         * Baixa anulada na origem — e aqui a diferença para o estorno é financeira,
+         * não de nomenclatura.
+         *
+         * No estorno o dinheiro **entrou e saiu**: a dívida foi quitada e reabri-la
+         * cobraria de novo algo que foi pago. Na anulação o dinheiro **nunca
+         * entrou**: manter o recebível quitado seria o sistema afirmando um
+         * recebimento que a própria origem já negou. Por isso este é o único dos
+         * três que reverte estado.
+         */
+        case 'charge.settlement_undone': {
+            const reversal = await reverseSettlementForCharge(tx, charge.id, 'settlement_undone');
+            return {
+                receivableId: reversal.receivableId ?? charge.receivable_id,
+                chargeId: charge.id,
+                outcome: reversal.reversedPayments > 0 ? 'reversed' : 'already_reversed',
+            };
+        }
+        default:
+            return { ...ref, outcome: 'ignored' };
+    }
+}
+async function applyPayment(tx, charge, event) {
+    if (!charge.receivable_id) {
+        // Cobrança avulsa, anterior ao Payment Rail: marca a cobrança e para. Não
+        // há recebível a baixar, e inventar um seria criar dívida que não existia.
+        await setChargeStatus(tx, charge.id, 'paid');
+        return 'paid';
+    }
+    const receivable = await getReceivable(tx, charge.receivable_id);
+    if (receivable.status === 'paid' || receivable.outstandingAmount <= 0)
+        return 'already_paid';
+    // O gateway manda o valor creditado. Ele pode ser MENOR que a cobrança
+    // (desconto, pagamento parcial de boleto) — e nesse caso a baixa é parcial, o
+    // recebível continua aberto pelo saldo, e a régua segue. Tratar todo evento
+    // de pagamento como quitação total perdoaria a diferença em silêncio.
+    const announced = event.paidAmount ?? Number(charge.amount);
+    const amount = Math.min(announced, receivable.outstandingAmount);
+    if (amount <= 0)
+        return 'already_paid';
+    await registerPayment(tx, {
+        receivableId: charge.receivable_id,
+        chargeId: charge.id,
+        amount,
+        method: charge.method,
+        paidAt: event.paidAt ?? new Date().toISOString(),
+    });
+    // `reversed_at` é zerado junto: uma cobrança revertida continua pagável no
+    // gateway, e quando o cliente de fato paga, ela volta a ser simplesmente paga.
+    // Deixar a marca de reversão numa cobrança `paid` reproduziria, ao contrário,
+    // o mesmo defeito que esta onda corrige — estado que afirma duas coisas
+    // incompatíveis ao mesmo tempo.
+    await tx `
+    UPDATE charge
+    SET status = 'paid', paid_at = ${event.paidAt ?? new Date().toISOString()},
+        reversed_at = NULL, updated_at = now()
+    WHERE id = ${charge.id}
+  `;
+    await tx `
+    UPDATE payment
+    SET provider = (SELECT provider FROM charge WHERE id = ${charge.id}),
+        provider_payment_id = ${event.externalId}
+    WHERE charge_id = ${charge.id} AND provider_payment_id IS NULL
+  `;
+    return 'paid';
+}
+async function setChargeStatus(tx, id, status) {
+    await tx `UPDATE charge SET status = ${status}, updated_at = now() WHERE id = ${id}`;
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/billing/reconcile.js.map

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

package/dist/billing/repository.d.ts

@@ -11,6 +11,18 @@ export type FeeStatus = 'active' | 'suspended' | 'canceled';
 export interface FeeAgreementRecord {
     id: string;
     clientId: string;
+    /**
+     * Nome do cliente, junto do acordo.
+     *
+     * Mesma razão de `ChargeRecord.clientName`: a tela lê "quem", não um uuid. Sem
+     * isto a página de Honorários pedia a lista de clientes só para cruzar em
+     * memória — e como a rota de clientes tem teto de 100, o acordo de um cliente
+     * fora dessa página aparecia sem nome, com um aviso de truncamento para
+     * explicar o buraco.
+     */
+    clientName: string | null;
+    /** Responsável pela execução deste serviço; `null` herda o dono do cliente. */
+    responsibleUserId: string | null;
     description: string;
     amount: number;
     periodicity: Periodicity;
@@ -27,6 +39,14 @@ export interface FeeAgreementRecord {
 export interface CreateFeeInput {
     clientId: string;
     amount: number;
+    /**
+     * Quem responde pela execução DESTE serviço.
+     *
+     * Diferente do responsável pelo cliente: um escritório pode ter uma pessoa
+     * na carteira e outra na folha do mesmo cliente. Quando não é informado, a
+     * responsabilidade continua sendo a do cliente — não se inventa um dono.
+     */
+    responsibleUserId?: string | null;
     description?: string;
     periodicity?: Periodicity;
     dueDay?: number | null;
@@ -35,15 +55,91 @@ export interface CreateFeeInput {
     finePercent?: number;
     interestPercent?: number;
     startsOn?: string | null;
+    /**
+     * Fim da vigência. A coluna existe desde a 0014 e o formulário sempre
+     * ofereceu o campo, mas nem a rota nem este INSERT o escreviam: o acordo
+     * nascia sem fim e continuava gerando competência depois da data que o
+     * operador tinha visto no resumo da confirmação. Um acordo que não termina
+     * cobra o cliente por serviço encerrado — o erro mais caro deste domínio.
+     */
+    endsOn?: string | null;
     createdBy?: string | null;
 }
 export declare function createFeeAgreement(tx: Tx, input: CreateFeeInput): Promise<FeeAgreementRecord>;
 export declare function listFeeAgreements(tx: Tx, clientId?: string): Promise<FeeAgreementRecord[]>;
 export declare function setFeeStatus(tx: Tx, id: string, status: FeeStatus): Promise<number>;
-export type ChargeStatus = 'pending' | 'sent' | 'paid' | 'overdue' | 'canceled' | 'refunded';
+export declare function getFeeAgreement(tx: Tx, id: string): Promise<FeeAgreementRecord>;
+/**
+ * Campos editáveis de um acordo já cadastrado.
+ *
+ * `undefined` = não mexe; `null` = limpa. A distinção é o que permite ao
+ * operador REMOVER um término que colocou por engano — com um único "valor
+ * ausente" para os dois casos, apagar a data seria impossível pela tela.
+ *
+ * O cliente do acordo não está aqui de propósito: mudar o devedor de um
+ * honorário que já gerou recebíveis reescreveria a história da carteira. Para
+ * isso encerra-se o acordo e abre-se outro.
+ */
+export interface UpdateFeeInput {
+    description?: string;
+    amount?: number;
+    periodicity?: Periodicity;
+    dueDay?: number | null;
+    billingMethod?: BillingMethod;
+    discount?: number;
+    finePercent?: number;
+    interestPercent?: number;
+    startsOn?: string | null;
+    endsOn?: string | null;
+}
+/**
+ * Altera o acordo daqui para a frente.
+ *
+ * Recebíveis já gerados NÃO são reescritos: a competência de julho foi emitida
+ * pelo valor de julho, e o cliente pode já tê-la pago. Alterar o passado faria
+ * o extrato do Portal deixar de bater com o boleto que a pessoa tem em mãos.
+ */
+export declare function updateFeeAgreement(tx: Tx, id: string, patch: UpdateFeeInput): Promise<FeeAgreementRecord>;
+export type ChargeStatus = 'pending' | 'sent' | 'paid' | 'overdue' | 'canceled' | 'refunded'
+/** Teve a liquidação anulada na origem — continua pagável. */
+ | 'reversed';
+export type ChargeOrigin = 'recurring' | 'one_off';
 export interface ChargeRecord {
     id: string;
     clientId: string;
+    /**
+     * Nome do cliente, junto da cobrança.
+     *
+     * A operação lê "quem me deve", não um uuid. Sem isto, toda tela precisaria
+     * buscar a lista de clientes e cruzar em memória — que é exactamente o que a
+     * página de Honorários fazia quando estourou: pedia 200 clientes a uma rota
+     * que aceita 100.
+     */
+    clientName: string | null;
+    /**
+     * A conta de pagamento que EMITIU esta cobrança.
+     *
+     * Existe para que cancelar, consultar ou estornar use a conta que originou —
+     * e não a conta que por acaso está marcada como operacional hoje. São coisas
+     * diferentes: um boleto emitido em produção não se cancela pela credencial do
+     * laboratório, e foi exatamente isso que a auditoria da Fase 10A encontrou.
+     *
+     * Nulo em cobranças anteriores ao Payment Rail e em lançamentos `manual`,
+     * que não falam com gateway nenhum.
+     */
+    providerAccountId: string | null;
+    /** Recebível que originou a cobrança (nulo em cobranças anteriores ao Payment Rail). */
+    receivableId: string | null;
+    /** Competência do recebível de origem, quando houver. */
+    competence: string | null;
+    /**
+     * De onde a cobrança nasceu.
+     *
+     * `recurring` = veio de um acordo de honorário; `one_off` = lançamento avulso.
+     * Derivado, nunca armazenado em duplicidade: a origem é o `fee_agreement_id`
+     * do recebível (ou da própria cobrança, no modelo anterior).
+     */
+    origin: ChargeOrigin;
     feeAgreementId: string | null;
     provider: string;
     externalId: string | null;
@@ -73,6 +169,13 @@ export declare function createCharge(tx: Tx, input: CreateChargeInput): Promise<
 export interface ListChargesFilter {
     clientId?: string;
     status?: ChargeStatus;
+    competence?: string;
+    origin?: ChargeOrigin;
+    /** Vencimento de/até, inclusivo. */
+    dueFrom?: string;
+    dueTo?: string;
+    /** Busca por descrição da cobrança ou nome do cliente. */
+    search?: string;
     limit?: number;
     offset?: number;
 }
@@ -80,6 +183,14 @@ export declare function listCharges(tx: Tx, filter?: ListChargesFilter): Promise
     items: ChargeRecord[];
     total: number;
 }>;
+/**
+ * Cobranças emitidas para um recebível — a cadeia dívida → instrumento.
+ *
+ * Mais de uma é o caso NORMAL, não a exceção: a primeira vence, o escritório
+ * reemite, e ambas ficam. Ordenadas da mais recente para a mais antiga porque a
+ * pergunta operacional é "qual é a que vale agora".
+ */
+export declare function listChargesForReceivable(tx: Tx, receivableId: string): Promise<ChargeRecord[]>;
 export declare function getCharge(tx: Tx, id: string): Promise<ChargeRecord>;
 export declare function markChargePaid(tx: Tx, id: string, paidAt?: string): Promise<number>;
 /** Reconciliação por webhook: encontra a cobrança pelo (provider, external_id) e marca paga. */
@@ -94,4 +205,26 @@ export declare function billingSummary(tx: Tx): Promise<{
 }>;
 /** Cobranças em aberto vencidas até `today` — usadas pela régua de inadimplência. */
 export declare function listOpenCharges(tx: Tx): Promise<ChargeRecord[]>;
+/**
+ * Quais obrigações um serviço contratado cobre.
+ *
+ * Relação N-para-N de verdade: um serviço de folha cobre eSocial, FGTS e a
+ * própria folha; e a mesma obrigação pode estar coberta por mais de um contrato
+ * ao longo do tempo. Por isso tabela de ligação, e não uma coluna.
+ *
+ * **A prévia de obrigações NÃO consome este vínculo hoje**, e isso é
+ * deliberado: quem decide a aplicabilidade continua sendo o regime mais a
+ * conferência humana do catálogo. Fazer o contrato mandar na geração mudaria a
+ * regra de aplicabilidade antes de existir a lista de serviços validada pelo
+ * escritório — seria inventar a regra em vez de descobri-la. O vínculo existe
+ * para ser preenchido e consultado; ligá-lo à geração é decisão de quem
+ * conhece a carteira.
+ */
+export declare function setFeeObligations(tx: Tx, input: {
+    feeAgreementId: string;
+    itemTypeIds: readonly string[];
+}): Promise<{
+    linked: number;
+}>;
+export declare function listFeeObligations(tx: Tx, feeAgreementId: string): Promise<string[]>;
 //# sourceMappingURL=repository.d.ts.map

package/dist/billing/repository.d.ts.map

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

package/dist/billing/repository.js

@@ -1,8 +1,9 @@
-import { NotFoundError, uuidv7 } from '@baruk/shared';
+import { NotFoundError, ValidationError, uuidv7 } from '@baruk/shared';
 function mapFee(r) {
     return {
         id: r.id,
         clientId: r.client_id,
+        clientName: r.client_name ?? null,
         description: r.description,
         amount: Number(r.amount),
         periodicity: r.periodicity,
@@ -15,33 +16,59 @@ function mapFee(r) {
         startsOn: r.starts_on ? r.starts_on.toISOString().slice(0, 10) : null,
         endsOn: r.ends_on ? r.ends_on.toISOString().slice(0, 10) : null,
         createdAt: r.created_at.toISOString(),
+        responsibleUserId: r.responsible_user_id ?? null,
     };
 }
-const FEE_COLS = `
-  id, client_id, description, amount, periodicity, due_day, billing_method,
-  discount, fine_percent, interest_percent, status, starts_on, ends_on, created_at
+/**
+ * Vigência coerente: fim nunca antes do início.
+ *
+ * Mora no domínio, e não só no schema da rota, porque um acordo com término
+ * anterior ao início nunca se aplica a competência alguma — `feeAppliesTo`
+ * devolve `false` para sempre. O escritório cadastraria um honorário que
+ * simplesmente nunca cobra, sem nenhum erro em lugar nenhum.
+ */
+function assertValidity(startsOn, endsOn) {
+    if (startsOn && endsOn && endsOn < startsOn) {
+        throw new ValidationError('Término da vigência não pode ser anterior ao início');
+    }
+}
+/** As mesmas colunas, qualificadas e com o nome do cliente ao lado. */
+const FEE_COLS_JOINED = `
+  f.id, f.client_id, f.description, f.amount, f.periodicity, f.due_day, f.billing_method,
+  f.discount, f.fine_percent, f.interest_percent, f.status, f.starts_on, f.ends_on, f.created_at,
+  f.responsible_user_id, cl.display_name AS client_name
 `;
 export async function createFeeAgreement(tx, input) {
+    assertValidity(input.startsOn, input.endsOn);
     const rows = await tx `
     INSERT INTO fee_agreement (
       id, tenant_id, client_id, description, amount, periodicity, due_day,
-      billing_method, discount, fine_percent, interest_percent, starts_on, created_by
+      billing_method, discount, fine_percent, interest_percent, starts_on, ends_on,
+      responsible_user_id, created_by
     ) VALUES (
       ${uuidv7()}, current_setting('app.current_tenant')::uuid, ${input.clientId},
       ${input.description ?? 'Honorários'}, ${input.amount}, ${input.periodicity ?? 'monthly'},
       ${input.dueDay ?? null}, ${input.billingMethod ?? 'pix'}, ${input.discount ?? 0},
-      ${input.finePercent ?? 0}, ${input.interestPercent ?? 0}, ${input.startsOn ?? null}, ${input.createdBy ?? null}
+      ${input.finePercent ?? 0}, ${input.interestPercent ?? 0}, ${input.startsOn ?? null},
+      ${input.endsOn ?? null}, ${input.responsibleUserId ?? null}, ${input.createdBy ?? null}
     )
-    RETURNING ${tx.unsafe(FEE_COLS)}
+    RETURNING id
   `;
-    return mapFee(rows[0]);
+    // Releitura em vez de `RETURNING` das colunas: um `RETURNING` não alcança o
+    // JOIN do cliente, e devolver aqui um registro sem `clientName` criaria duas
+    // formas do mesmo tipo — uma completa na leitura, outra pela metade na
+    // criação. Quem consumisse o retorno do POST veria o nome como null sem que
+    // nada estivesse errado no banco.
+    return getFeeAgreement(tx, rows[0].id);
 }
 export async function listFeeAgreements(tx, clientId) {
     const rows = await tx `
-    SELECT ${tx.unsafe(FEE_COLS)} FROM fee_agreement
-    WHERE deleted_at IS NULL
-      AND (${clientId ?? null}::uuid IS NULL OR client_id = ${clientId ?? null})
-    ORDER BY created_at DESC
+    SELECT ${tx.unsafe(FEE_COLS_JOINED)}
+      FROM fee_agreement f
+      LEFT JOIN client cl ON cl.id = f.client_id AND cl.deleted_at IS NULL
+     WHERE f.deleted_at IS NULL
+       AND (${clientId ?? null}::uuid IS NULL OR f.client_id = ${clientId ?? null})
+     ORDER BY f.created_at DESC
   `;
     return rows.map(mapFee);
 }
@@ -52,10 +79,65 @@ export async function setFeeStatus(tx, id, status) {
   `;
     return rows.count;
 }
+export async function getFeeAgreement(tx, id) {
+    const rows = await tx `
+    SELECT ${tx.unsafe(FEE_COLS_JOINED)}
+      FROM fee_agreement f
+      LEFT JOIN client cl ON cl.id = f.client_id AND cl.deleted_at IS NULL
+     WHERE f.id = ${id} AND f.deleted_at IS NULL
+  `;
+    if (!rows[0])
+        throw new NotFoundError('Honorário não encontrado');
+    return mapFee(rows[0]);
+}
+/**
+ * Altera o acordo daqui para a frente.
+ *
+ * Recebíveis já gerados NÃO são reescritos: a competência de julho foi emitida
+ * pelo valor de julho, e o cliente pode já tê-la pago. Alterar o passado faria
+ * o extrato do Portal deixar de bater com o boleto que a pessoa tem em mãos.
+ */
+export async function updateFeeAgreement(tx, id, patch) {
+    const has = (k) => patch[k] !== undefined;
+    // Sem campo nenhum, o UPDATE viraria `SET updated_at = now()` e bumparia a
+    // versão de um acordo intocado — ruído na trilha de auditoria.
+    const touched = Object.keys(patch).some((k) => has(k));
+    if (!touched)
+        return getFeeAgreement(tx, id);
+    // A vigência é validada contra o estado RESULTANTE, não contra o patch: quem
+    // muda só o término precisa ser comparado com o início que já está gravado.
+    const current = await getFeeAgreement(tx, id);
+    assertValidity(has('startsOn') ? (patch.startsOn ?? null) : current.startsOn, has('endsOn') ? (patch.endsOn ?? null) : current.endsOn);
+    const rows = await tx `
+    UPDATE fee_agreement SET
+      description      = ${has('description') ? patch.description : tx `description`},
+      amount           = ${has('amount') ? patch.amount : tx `amount`},
+      periodicity      = ${has('periodicity') ? patch.periodicity : tx `periodicity`},
+      due_day          = ${has('dueDay') ? (patch.dueDay ?? null) : tx `due_day`},
+      billing_method   = ${has('billingMethod') ? patch.billingMethod : tx `billing_method`},
+      discount         = ${has('discount') ? patch.discount : tx `discount`},
+      fine_percent     = ${has('finePercent') ? patch.finePercent : tx `fine_percent`},
+      interest_percent = ${has('interestPercent') ? patch.interestPercent : tx `interest_percent`},
+      starts_on        = ${has('startsOn') ? (patch.startsOn ?? null) : tx `starts_on`},
+      ends_on          = ${has('endsOn') ? (patch.endsOn ?? null) : tx `ends_on`},
+      updated_at = now(), version = version + 1
+    WHERE id = ${id} AND deleted_at IS NULL
+    RETURNING id
+  `;
+    if (!rows[0])
+        throw new NotFoundError('Honorário não encontrado');
+    return getFeeAgreement(tx, rows[0].id);
+}
 function mapCharge(r) {
+    const recurring = Boolean(r.receivable_fee_agreement_id ?? r.fee_agreement_id);
     return {
         id: r.id,
         clientId: r.client_id,
+        clientName: r.client_name ?? null,
+        providerAccountId: r.provider_account_id ?? null,
+        receivableId: r.receivable_id ?? null,
+        competence: r.competence ?? null,
+        origin: recurring ? 'recurring' : 'one_off',
         feeAgreementId: r.fee_agreement_id,
         provider: r.provider,
         externalId: r.external_id,
@@ -71,7 +153,27 @@ function mapCharge(r) {
 }
 const CHARGE_COLS = `
   id, client_id, fee_agreement_id, provider, external_id, method, amount,
-  status, description, due_date, paid_at, metadata, created_at
+  status, description, due_date, paid_at, metadata, created_at, provider_account_id
+`;
+/**
+ * Colunas da cobrança já acompanhadas do que a operação precisa ler.
+ *
+ * O `LEFT JOIN` é deliberado nos dois lados: cliente removido não deve fazer a
+ * cobrança desaparecer da lista financeira, e cobrança anterior ao Payment Rail
+ * não tem recebível. Em ambos os casos o campo vem nulo e a tela mostra "—".
+ */
+const CHARGE_COLS_JOINED = `
+  c.id, c.client_id, c.fee_agreement_id, c.provider, c.external_id, c.method, c.amount,
+  c.status, c.description, c.due_date, c.paid_at, c.metadata, c.created_at, c.provider_account_id,
+  cl.display_name AS client_name,
+  c.receivable_id,
+  r.competence,
+  r.fee_agreement_id AS receivable_fee_agreement_id
+`;
+const CHARGE_JOINS = `
+  FROM charge c
+  LEFT JOIN client cl ON cl.id = c.client_id AND cl.deleted_at IS NULL
+  LEFT JOIN receivable r ON r.id = c.receivable_id AND r.deleted_at IS NULL
 `;
 export async function createCharge(tx, input) {
     const rows = await tx `
@@ -92,21 +194,51 @@ export async function createCharge(tx, input) {
 export async function listCharges(tx, filter = {}) {
     const limit = Math.min(filter.limit ?? 50, 200);
     const offset = filter.offset ?? 0;
+    // `origin` é filtrado sobre a MESMA derivação que `mapCharge` usa. Repetir a
+    // regra em SQL com outro critério faria a lista e o rótulo da linha
+    // discordarem — a tela diria "avulsa" num item trazido pelo filtro
+    // "recorrente".
+    const search = filter.search?.trim();
     const rows = await tx `
-    SELECT ${tx.unsafe(CHARGE_COLS)}, count(*) OVER() AS total
-    FROM charge
-    WHERE deleted_at IS NULL
-      AND (${filter.clientId ?? null}::uuid IS NULL OR client_id = ${filter.clientId ?? null})
-      AND (${filter.status ?? null}::text IS NULL OR status = ${filter.status ?? null})
-    ORDER BY created_at DESC
+    SELECT ${tx.unsafe(CHARGE_COLS_JOINED)}, count(*) OVER() AS total
+    ${tx.unsafe(CHARGE_JOINS)}
+    WHERE c.deleted_at IS NULL
+      AND (${filter.clientId ?? null}::uuid IS NULL OR c.client_id = ${filter.clientId ?? null})
+      AND (${filter.status ?? null}::text IS NULL OR c.status = ${filter.status ?? null})
+      AND (${filter.competence ?? null}::text IS NULL OR r.competence = ${filter.competence ?? null})
+      AND (${filter.dueFrom ?? null}::date IS NULL OR c.due_date >= ${filter.dueFrom ?? null}::date)
+      AND (${filter.dueTo ?? null}::date IS NULL OR c.due_date <= ${filter.dueTo ?? null}::date)
+      AND (${filter.origin ?? null}::text IS NULL
+           OR (${filter.origin ?? null} = 'recurring')
+              = (COALESCE(r.fee_agreement_id, c.fee_agreement_id) IS NOT NULL))
+      AND (${search ?? null}::text IS NULL
+           OR c.description ILIKE '%' || ${search ?? null} || '%'
+           OR cl.display_name ILIKE '%' || ${search ?? null} || '%')
+    ORDER BY c.due_date DESC NULLS LAST, c.created_at DESC
     LIMIT ${limit} OFFSET ${offset}
   `;
     const total = rows[0] ? Number(rows[0].total) : 0;
     return { items: rows.map(mapCharge), total };
 }
+/**
+ * Cobranças emitidas para um recebível — a cadeia dívida → instrumento.
+ *
+ * Mais de uma é o caso NORMAL, não a exceção: a primeira vence, o escritório
+ * reemite, e ambas ficam. Ordenadas da mais recente para a mais antiga porque a
+ * pergunta operacional é "qual é a que vale agora".
+ */
+export async function listChargesForReceivable(tx, receivableId) {
+    const rows = await tx `
+    SELECT ${tx.unsafe(CHARGE_COLS_JOINED)} ${tx.unsafe(CHARGE_JOINS)}
+     WHERE c.receivable_id = ${receivableId} AND c.deleted_at IS NULL
+     ORDER BY c.created_at DESC
+  `;
+    return rows.map(mapCharge);
+}
 export async function getCharge(tx, id) {
     const rows = await tx `
-    SELECT ${tx.unsafe(CHARGE_COLS)} FROM charge WHERE id = ${id} AND deleted_at IS NULL
+    SELECT ${tx.unsafe(CHARGE_COLS_JOINED)} ${tx.unsafe(CHARGE_JOINS)}
+     WHERE c.id = ${id} AND c.deleted_at IS NULL
   `;
     if (!rows[0])
         throw new NotFoundError('Cobrança não encontrada');
@@ -164,4 +296,45 @@ export async function listOpenCharges(tx) {
   `;
     return rows.map(mapCharge);
 }
+/**
+ * Quais obrigações um serviço contratado cobre.
+ *
+ * Relação N-para-N de verdade: um serviço de folha cobre eSocial, FGTS e a
+ * própria folha; e a mesma obrigação pode estar coberta por mais de um contrato
+ * ao longo do tempo. Por isso tabela de ligação, e não uma coluna.
+ *
+ * **A prévia de obrigações NÃO consome este vínculo hoje**, e isso é
+ * deliberado: quem decide a aplicabilidade continua sendo o regime mais a
+ * conferência humana do catálogo. Fazer o contrato mandar na geração mudaria a
+ * regra de aplicabilidade antes de existir a lista de serviços validada pelo
+ * escritório — seria inventar a regra em vez de descobri-la. O vínculo existe
+ * para ser preenchido e consultado; ligá-lo à geração é decisão de quem
+ * conhece a carteira.
+ */
+export async function setFeeObligations(tx, input) {
+    await tx `
+    DELETE FROM fee_agreement_obligation WHERE fee_agreement_id = ${input.feeAgreementId}
+  `;
+    let linked = 0;
+    for (const itemTypeId of input.itemTypeIds) {
+        const rows = await tx `
+      INSERT INTO fee_agreement_obligation (id, tenant_id, fee_agreement_id, item_type_id)
+      VALUES (${uuidv7()}, current_setting('app.current_tenant')::uuid,
+              ${input.feeAgreementId}, ${itemTypeId})
+      ON CONFLICT DO NOTHING
+      RETURNING id
+    `;
+        if (rows[0])
+            linked++;
+    }
+    return { linked };
+}
+export async function listFeeObligations(tx, feeAgreementId) {
+    const rows = await tx `
+    SELECT item_type_id FROM fee_agreement_obligation
+     WHERE fee_agreement_id = ${feeAgreementId}
+     ORDER BY created_at
+  `;
+    return rows.map((r) => r.item_type_id);
+}
 //# sourceMappingURL=repository.js.map