@baruk/core 0.3.1 → 0.4.2

package/dist/cjs/billing/repository.js

@@ -3,8 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createFeeAgreement = createFeeAgreement;
 exports.listFeeAgreements = listFeeAgreements;
 exports.setFeeStatus = setFeeStatus;
+exports.getFeeAgreement = getFeeAgreement;
+exports.updateFeeAgreement = updateFeeAgreement;
 exports.createCharge = createCharge;
 exports.listCharges = listCharges;
+exports.listChargesForReceivable = listChargesForReceivable;
 exports.getCharge = getCharge;
 exports.markChargePaid = markChargePaid;
 exports.markChargePaidByExternal = markChargePaidByExternal;
@@ -16,6 +19,7 @@ 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,
@@ -30,31 +34,55 @@ function mapFee(r) {
         createdAt: r.created_at.toISOString(),
     };
 }
-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 shared_1.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,
+  cl.display_name AS client_name
 `;
 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, created_by
     ) VALUES (
       ${(0, shared_1.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.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);
 }
 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);
 }
@@ -65,10 +93,64 @@ async function setFeeStatus(tx, id, status) {
   `;
     return rows.count;
 }
+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 shared_1.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.
+ */
+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 shared_1.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,
+        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,
@@ -86,6 +168,26 @@ const CHARGE_COLS = `
   id, client_id, fee_agreement_id, provider, external_id, method, amount,
   status, description, due_date, paid_at, metadata, created_at
 `;
+/**
+ * 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,
+  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
+`;
 async function createCharge(tx, input) {
     const rows = await tx `
     INSERT INTO charge (
@@ -105,21 +207,51 @@ async function createCharge(tx, input) {
 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".
+ */
+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);
+}
 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 shared_1.NotFoundError('Cobrança não encontrada');

package/dist/cjs/billing/repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/billing/repository.ts"],"names":[],"mappings":";;AAwFA,gDAcC;AAED,8CAQC;AAED,oCAMC;AA2ED,oCAeC;AASD,kCAiBC;AAED,8BAMC;AAED,wCAOC;AAGD,4DAaC;AAED,0CAMC;AAGD,wCAqBC;AAGD,0CAOC;AAvTD,0CAAsD;AAkDtD,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,MAAM,EAAE,CAAC,CAAC,OAAO;QACjB,aAAa,EAAE,CAAC,CAAC,cAAc;QAC/B,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;QACnC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAC3C,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QACrE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG;;;CAGhB,CAAC;AAgBK,KAAK,UAAU,kBAAkB,CAAC,EAAM,EAAE,KAAqB;IACpE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAU;;;;;QAKzB,IAAA,eAAM,GAAE,kDAAkD,KAAK,CAAC,QAAQ;QACxE,KAAK,CAAC,WAAW,IAAI,YAAY,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,WAAW,IAAI,SAAS;QACrF,KAAK,CAAC,MAAM,IAAI,IAAI,KAAK,KAAK,CAAC,aAAa,IAAI,KAAK,KAAK,KAAK,CAAC,QAAQ,IAAI,CAAC;QAC7E,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,KAAK,CAAC,QAAQ,IAAI,IAAI,KAAK,KAAK,CAAC,SAAS,IAAI,IAAI;;gBAEpG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;GAChC,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;AAC1B,CAAC;AAEM,KAAK,UAAU,iBAAiB,CAAC,EAAM,EAAE,QAAiB;IAC/D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAU;aACpB,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;;aAEnB,QAAQ,IAAI,IAAI,iCAAiC,QAAQ,IAAI,IAAI;;GAE3E,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,EAAM,EAAE,EAAU,EAAE,MAAiB;IACtE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAA;wCACiB,MAAM;iBAC7B,EAAE;GAChB,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAsCD,SAAS,SAAS,CAAC,CAAY;IAC7B,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,cAAc,EAAE,CAAC,CAAC,gBAAgB;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,WAAW;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QAClE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QAClD,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;QAC1B,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GAAG;;;CAGnB,CAAC;AAgBK,KAAK,UAAU,YAAY,CAAC,EAAM,EAAE,KAAwB;IACjE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAa;;;;;QAK5B,IAAA,eAAM,GAAE,kDAAkD,KAAK,CAAC,QAAQ;QACxE,KAAK,CAAC,cAAc,IAAI,IAAI,KAAK,KAAK,CAAC,QAAQ,IAAI,QAAQ,KAAK,KAAK,CAAC,UAAU,IAAI,IAAI;QACxF,KAAK,CAAC,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,SAAS;QACpE,KAAK,CAAC,WAAW,IAAI,IAAI,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI;QACnD,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAU,CAAC,KAAK,KAAK,CAAC,SAAS,IAAI,IAAI;;gBAE5D,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;GACnC,CAAC;IACF,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;AAC7B,CAAC;AASM,KAAK,UAAU,WAAW,CAC/B,EAAM,EACN,SAA4B,EAAE;IAE9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAmC;aAC7C,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;;;aAGtB,MAAM,CAAC,QAAQ,IAAI,IAAI,iCAAiC,MAAM,CAAC,QAAQ,IAAI,IAAI;aAC/E,MAAM,CAAC,MAAM,IAAI,IAAI,8BAA8B,MAAM,CAAC,MAAM,IAAI,IAAI;;YAEzE,KAAK,WAAW,MAAM;GAC/B,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,EAAM,EAAE,EAAU;IAChD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAa;aACvB,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,2BAA2B,EAAE;GAC7D,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,sBAAa,CAAC,yBAAyB,CAAC,CAAC;IACjE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,EAAM,EAAE,EAAU,EAAE,MAAe;IACtE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAA;4DACqC,MAAM,IAAI,IAAI;;iBAEzD,EAAE;GAChB,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED,gGAAgG;AACzF,KAAK,UAAU,wBAAwB,CAC5C,EAAM,EACN,QAAgB,EAChB,UAAkB,EAClB,MAAe;IAEf,MAAM,IAAI,GAAG,MAAM,EAAE,CAAA;4DACqC,MAAM,IAAI,IAAI;;uBAEnD,QAAQ,sBAAsB,UAAU;;GAE5D,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,EAAM,EAAE,EAAU,EAAE,MAAoB;IAC5E,MAAM,IAAI,GAAG,MAAM,EAAE,CAAA;iCACU,MAAM;iBACtB,EAAE;GAChB,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED,yEAAyE;AAClE,KAAK,UAAU,cAAc,CAAC,EAAM;IAMzC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAkF;;;;;;;GAOtG,CAAC;IACF,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;IACnB,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1B,YAAY,EAAE,CAAC,CAAC,aAAa;KAC9B,CAAC;AACJ,CAAC;AAED,qFAAqF;AAC9E,KAAK,UAAU,eAAe,CAAC,EAAM;IAC1C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAa;aACvB,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;;;GAGhC,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/billing/repository.ts"],"names":[],"mappings":"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"}

package/dist/cjs/clients/repository.js

@@ -1,5 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.contactabilityOf = contactabilityOf;
+exports.normalizeEmail = normalizeEmail;
+exports.normalizePhone = normalizePhone;
 exports.createClient = createClient;
 exports.listClients = listClients;
 exports.getClient = getClient;
@@ -9,6 +12,35 @@ exports.updateClient = updateClient;
 exports.softDeleteClient = softDeleteClient;
 exports.findClientIdByDocument = findClientIdByDocument;
 const shared_1 = require("@baruk/shared");
+const phone_js_1 = require("../contacts/phone.js");
+function contactabilityOf(input) {
+    const email = input.email?.trim() ? 'ready' : 'missing';
+    const phone = input.phone?.trim() ? 'ready' : 'missing';
+    return { email, phone, reachable: email === 'ready' || phone === 'ready' };
+}
+/**
+ * Normalização de contato.
+ *
+ * E-mail vira minúsculo e sem espaços — a coluna é `citext`, mas quem lê o dado
+ * fora do banco não herda essa insensibilidade. Telefone guarda só dígitos e um
+ * `+` inicial: máscara é apresentação, e comparar "(62) 99999-9999" com
+ * "+5562999999999" é o tipo de divergência que só aparece quando a mensagem não
+ * chega.
+ */
+function normalizeEmail(v) {
+    const t = v?.trim().toLowerCase();
+    return t ? t : null;
+}
+function normalizePhone(v) {
+    if (!v)
+        return null;
+    const trimmed = v.trim();
+    const plus = trimmed.startsWith('+');
+    const digits = trimmed.replace(/\D/g, '');
+    if (!digits)
+        return null;
+    return plus ? `+${digits}` : digits;
+}
 function mapRow(r) {
     return {
         id: r.id,
@@ -16,30 +48,58 @@ function mapRow(r) {
         clientType: r.client_type,
         displayName: r.display_name,
         documentNumber: r.document_number,
+        email: r.email ?? null,
+        phone: r.phone ?? null,
         status: r.status,
         createdAt: r.created_at.toISOString(),
+        contactability: contactabilityOf({ email: r.email, phone: r.phone }),
     };
 }
+/**
+ * Traduz a violação de documento duplicado.
+ *
+ * O banco impede dois clientes com o mesmo CPF/CNPJ no tenant — regra correta,
+ * e o escritório precisa saber que foi ISSO. Sem tradução, a rota devolvia 500
+ * genérico: quem cadastrava via um "erro interno" onde havia um cadastro já
+ * existente, e não tinha como descobrir.
+ */
+function asDuplicateDocument(err) {
+    const e = err;
+    if (e?.code === '23505' && (e.constraint_name ?? '').includes('document')) {
+        throw new shared_1.ConflictError('Já existe um cliente com este CPF/CNPJ neste escritório.');
+    }
+}
 async function createClient(tx, input) {
     // tenant_id vem da GUC — nunca do input. A WITH CHECK da RLS recusa qualquer
     // tentativa de gravar fora do tenant corrente.
-    const rows = await tx `
-    INSERT INTO client (id, tenant_id, client_type, display_name, document_number, created_by)
-    VALUES (
-      ${(0, shared_1.uuidv7)()},
-      current_setting('app.current_tenant')::uuid,
-      ${input.clientType ?? 'pj'},
-      ${input.displayName},
-      ${input.documentNumber ?? null},
-      ${input.createdBy ?? null}
-    )
-    RETURNING id, tenant_id, client_type, display_name, document_number, status, created_at
-  `;
-    return mapRow(rows[0]);
+    try {
+        const rows = await tx `
+      INSERT INTO client (id, tenant_id, client_type, display_name, document_number,
+                          email, phone, phone_e164, created_by)
+      VALUES (
+        ${(0, shared_1.uuidv7)()},
+        current_setting('app.current_tenant')::uuid,
+        ${input.clientType ?? 'pj'},
+        ${input.displayName},
+        ${input.documentNumber ?? null},
+        ${normalizeEmail(input.email)},
+        ${normalizePhone(input.phone)},
+        ${(0, phone_js_1.toE164OrNull)(input.phone)},
+        ${input.createdBy ?? null}
+      )
+      RETURNING id, tenant_id, client_type, display_name, document_number, email, phone,
+                status, created_at
+    `;
+        return mapRow(rows[0]);
+    }
+    catch (err) {
+        asDuplicateDocument(err);
+        throw err;
+    }
 }
 async function listClients(tx) {
     const rows = await tx `
-    SELECT id, tenant_id, client_type, display_name, document_number, status, created_at
+    SELECT id, tenant_id, client_type, display_name, document_number, email, phone, status, created_at
     FROM client
     WHERE deleted_at IS NULL
     ORDER BY created_at DESC
@@ -48,7 +108,7 @@ async function listClients(tx) {
 }
 async function getClient(tx, id) {
     const rows = await tx `
-    SELECT id, tenant_id, client_type, display_name, document_number, status, created_at
+    SELECT id, tenant_id, client_type, display_name, document_number, email, phone, status, created_at
     FROM client
     WHERE id = ${id} AND deleted_at IS NULL
   `;
@@ -74,7 +134,7 @@ async function listClientsPaged(tx, filter = {}) {
     const offset = filter.offset ?? 0;
     const like = filter.search ? `%${filter.search}%` : null;
     const rows = await tx `
-    SELECT id, tenant_id, client_type, display_name, document_number, status, created_at,
+    SELECT id, tenant_id, client_type, display_name, document_number, email, phone, status, created_at,
            count(*) OVER() AS total
     FROM client
     WHERE deleted_at IS NULL
@@ -87,14 +147,25 @@ async function listClientsPaged(tx, filter = {}) {
     return { items: rows.map((r) => mapRow(r)), total };
 }
 async function updateClient(tx, id, input) {
+    // Corrigir um documento para um que já existe cai na mesma violação — e o
+    // escritório precisa da mesma explicação, não de um 500.
     // Casts explícitos: parâmetros NULL sem tipo quebram COALESCE ("could not
     // determine data type of parameter") no PostgreSQL.
-    const rows = await tx `
+    try {
+        const rows = await tx `
     UPDATE client SET
       display_name = COALESCE(${input.displayName ?? null}::text, display_name),
       legal_name   = COALESCE(${input.legalName ?? null}::text, legal_name),
-      email        = COALESCE(${input.email ?? null}::citext, email),
-      phone        = COALESCE(${input.phone ?? null}::text, phone),
+      document_number = COALESCE(${input.documentNumber ?? null}::text, document_number),
+      email        = COALESCE(${normalizeEmail(input.email)}::citext, email),
+      phone        = COALESCE(${normalizePhone(input.phone)}::text, phone),
+      -- Derivado, nunca digitado. A coluna phone guarda o que o operador
+      -- escreveu e continua sendo dele; phone_e164 e a forma que os providers
+      -- exigem. So e recalculado quando o telefone vem no corpo: ausente
+      -- preserva o valor, e um telefone que nao parseia zera o canonico em vez
+      -- de manter um E.164 velho apontando para outro numero.
+      phone_e164   = CASE WHEN ${input.phone ?? null}::text IS NULL THEN phone_e164
+                          ELSE ${(0, phone_js_1.toE164OrNull)(input.phone)}::text END,
       status       = COALESCE(${input.status ?? null}::text, status),
       updated_by   = ${input.updatedBy ?? null}::uuid,
       updated_at   = now(),
@@ -102,7 +173,12 @@ async function updateClient(tx, id, input) {
     WHERE id = ${id} AND deleted_at IS NULL
     RETURNING id
   `;
-    return rows.count;
+        return rows.count;
+    }
+    catch (err) {
+        asDuplicateDocument(err);
+        throw err;
+    }
 }
 async function softDeleteClient(tx, id, deletedBy) {
     const rows = await tx `

package/dist/cjs/clients/repository.js.map

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

package/dist/cjs/collection/branding.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTenantBranding = getTenantBranding;
+exports.senderFor = senderFor;
+/**
+ * Padrão neutro do produto — deliberadamente SEM marca.
+ *
+ * Um tenant sem branding configurado não deve herdar a identidade de outro
+ * escritório nem a do Baruk: o cinza-azulado abaixo não pertence a marca
+ * nenhuma, e é o sinal visível de que falta configurar.
+ */
+const NEUTRAL_PRIMARY = '#2b3440';
+const NEUTRAL_ACCENT = '#4a5563';
+const NEUTRAL_BACKGROUND = '#eef1f4';
+const NEUTRAL_TEXT = '#2b3440';
+const NEUTRAL_MUTED = '#6b7684';
+/** Famílias que existem em qualquer cliente de e-mail — o fim de toda stack. */
+const UNIVERSAL_FALLBACK = `-apple-system,'Segoe UI',Helvetica,Arial,sans-serif`;
+/**
+ * Cor só entra se for hex válido.
+ *
+ * O valor vem de configuração editável e é interpolado dentro de um atributo
+ * `style` — aceitar texto livre deixaria o tenant injetar CSS, ou fechar o
+ * atributo e injetar markup, na mensagem que sai em nome dele.
+ */
+function safeColor(v, fallback) {
+    return typeof v === 'string' && /^#[0-9a-fA-F]{6}$/.test(v) ? v : fallback;
+}
+/** URL só entra se for https — evita `javascript:` e `data:` no `src`/`href`. */
+function safeUrl(v) {
+    if (typeof v !== 'string')
+        return null;
+    return /^https:\/\/[^\s"'<>]+$/i.test(v) ? v : null;
+}
+/**
+ * Logo só entra se for uma imagem que cliente de e-mail sabe desenhar.
+ *
+ * SVG é o formato em que os kits de marca vivem — e é justamente o que Gmail e
+ * Outlook não renderizam em e-mail. Aceitar o SVG produziria o pior resultado
+ * possível: um cabeçalho vazio, sem imagem e sem o nome que o fallback teria
+ * escrito. Rasterize antes; aqui, entra PNG ou JPG.
+ */
+function safeLogoUrl(v) {
+    const url = safeUrl(v);
+    if (!url)
+        return null;
+    const path = url.split(/[?#]/)[0] ?? '';
+    return /\.(png|jpe?g)$/i.test(path) ? url : null;
+}
+/**
+ * A stack de fontes vai para dentro de um atributo `style`.
+ *
+ * Aspas duplas, `;`, `{` e `}` deixariam o tenant fechar a declaração e escrever
+ * CSS próprio na mensagem que sai em nome dele. Sobram letras, dígitos, espaço,
+ * hífen, vírgula, ponto e aspa simples — o que um `font-family` legítimo usa.
+ */
+function safeFontFamily(v) {
+    if (typeof v !== 'string')
+        return UNIVERSAL_FALLBACK;
+    const t = v.trim().slice(0, 160);
+    if (!t || !/^[A-Za-z0-9 ,.'-]+$/.test(t))
+        return UNIVERSAL_FALLBACK;
+    // A queda universal é acrescentada sempre: uma stack que termina numa webfont
+    // vira Times New Roman no Outlook, e o e-mail perde a hierarquia inteira.
+    return `${t},${UNIVERSAL_FALLBACK}`;
+}
+function safeLogoKind(v) {
+    return v === 'lockup' ? 'lockup' : 'symbol';
+}
+function safeText(v, max = 160) {
+    if (typeof v !== 'string')
+        return null;
+    const t = v.trim().slice(0, max);
+    return t ? t : null;
+}
+async function getTenantBranding(tx) {
+    /*
+     * O tenant CORRENTE, e não "o primeiro que aparecer".
+     *
+     * A consulta era `SELECT display_name, settings FROM tenant LIMIT 1`, sem
+     * `WHERE`. Parecia segura porque toda leitura tenant-scoped deste produto
+     * passa por `withContext` — mas `tenant` é a tabela RAIZ e **não tem RLS**:
+     * ela é a fonte da própria fronteira, não uma linha protegida por ela. Sem
+     * `WHERE`, a política que protege todas as outras tabelas não protege esta, e
+     * o `LIMIT 1` devolve um escritório arbitrário.
+     *
+     * A consequência é a pior possível para uma régua de cobrança: o e-mail sai
+     * com o nome, a logomarca e as cores de OUTRO escritório. Nunca apareceu
+     * porque a base de produção tem um tenant operando — ou seja, o defeito estava
+     * esperando o segundo cliente.
+     *
+     * Sem contexto de tenant a consulta devolve zero linhas de propósito, e o
+     * branding cai no padrão NEUTRO — que não pertence a marca nenhuma. Um default
+     * que herda a marca do vizinho é o defeito, não o conserto.
+     */
+    const rows = await tx `
+    SELECT display_name, settings FROM tenant
+     WHERE id = NULLIF(current_setting('app.current_tenant', true), '')::uuid
+     LIMIT 1
+  `;
+    const row = rows[0];
+    const raw = (row?.settings?.branding ?? {});
+    const officeName = safeText(raw.officeName) ?? row?.display_name ?? 'Seu escritório contábil';
+    const primary = safeColor(raw.primaryColor, NEUTRAL_PRIMARY);
+    return {
+        officeName,
+        signatureName: safeText(raw.signatureName) ?? officeName,
+        tagline: safeText(raw.tagline, 120),
+        logoUrl: safeLogoUrl(raw.logoUrl),
+        logoKind: safeLogoKind(raw.logoKind),
+        primaryColor: primary,
+        // Secundária cai na primária: um tenant que configurou só uma cor fica
+        // coerente, em vez de ganhar um segundo tom que ninguém escolheu.
+        secondaryColor: safeColor(raw.secondaryColor, primary),
+        accentColor: safeColor(raw.accentColor, NEUTRAL_ACCENT),
+        backgroundColor: safeColor(raw.backgroundColor, NEUTRAL_BACKGROUND),
+        textColor: safeColor(raw.textColor, NEUTRAL_TEXT),
+        mutedColor: safeColor(raw.mutedColor, NEUTRAL_MUTED),
+        fontFamily: safeFontFamily(raw.fontFamily),
+        supportEmail: safeText(raw.supportEmail, 120),
+        supportPhone: safeText(raw.supportPhone, 40),
+        website: safeUrl(raw.website),
+        locale: 'pt-BR',
+    };
+}
+/**
+ * Remetente no formato `Nome <endereço>`.
+ *
+ * O endereço continua sendo o do domínio verificado no provider — trocá-lo
+ * quebraria a entrega. O que muda é o NOME exibido: as mensagens saíam como
+ * "Baruk Contábil" e assinavam "SC Organização Contábil", o que faz o cliente
+ * duvidar de quem está cobrando.
+ */
+function senderFor(branding, fallbackFrom) {
+    const address = /<([^>]+)>/.exec(fallbackFrom)?.[1] ?? fallbackFrom;
+    // Aspas e `<` no nome quebrariam o cabeçalho do e-mail.
+    const name = branding.officeName.replace(/["<>\\]/g, '').trim();
+    return name ? `${name} <${address}>` : fallbackFrom;
+}
+//# sourceMappingURL=branding.js.map

package/dist/cjs/collection/branding.js.map

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