@baruk/core 0.4.2 → 0.6.0

package/dist/clients/repository.d.ts

@@ -15,6 +15,23 @@ export interface ClientRecord {
     phone: string | null;
     status: string;
     createdAt: string;
+    /** Quem, no escritório, responde por este cliente. `null` = carteira sem dono. */
+    responsibleUserId: string | null;
+    municipality: string | null;
+    stateUf: string | null;
+    legalName: string | null;
+    /** Nome fantasia. É por ele que a equipe chama o cliente no telefone. */
+    tradeName: string | null;
+    addressLine: string | null;
+    postalCode: string | null;
+    notes: string | null;
+    /** Sete dígitos do IBGE. Sem ele, nenhuma regra municipal alcança o cliente. */
+    municipalityIbgeCode: string | null;
+    /**
+     * Quando alguém do escritório conferiu o contato e liberou a comunicação
+     * externa. `null` = a régua não alcança este cliente.
+     */
+    communicationClearedAt: string | null;
     /**
      * Por quais canais dá para falar com este cliente.
      *
@@ -31,10 +48,46 @@ export interface Contactability {
     phone: ContactChannelState;
     /** Nenhum canal utilizável — o caso que exige atualização cadastral. */
     reachable: boolean;
+    /** Situação em uma palavra, para a tela e para o relatório de carga. */
+    status: ContactabilityStatus;
+    /**
+     * A automação alcança este cliente?
+     *
+     * Distinto de `reachable`: um cliente com telefone e sem e-mail tem contato
+     * cadastrado (`reachable`) e mesmo assim não recebe nada, enquanto o canal de
+     * telefone do escritório não estiver ligado.
+     */
+    automated: boolean;
 }
+/**
+ * Situação de contato do cliente, em uma palavra.
+ *
+ * `reachable` responde "tem algum contato?", que não é a mesma pergunta que o
+ * escritório faz. A pergunta dele é **"a régua de cobrança e o pedido de
+ * documento vão alcançar este cliente?"** — e a resposta depende também de quais
+ * canais o escritório tem LIGADOS.
+ *
+ * Um cliente com telefone e sem e-mail parece contactável e não é, enquanto o
+ * WhatsApp do escritório não estiver operacional. Foi exatamente o caso que a
+ * Fase 3 identificou como silencioso: o cliente entra na carteira e fica
+ * invisível para os dois motores, sem ninguém ser avisado.
+ *
+ * `phone_only` e `phone_no_channel` são separados de propósito. O primeiro é uma
+ * situação normal — o escritório fala com esse cliente por WhatsApp. O segundo é
+ * uma pendência operacional, e confundi-los faria a tela mostrar tranquilidade
+ * onde há trabalho a fazer.
+ */
+export type ContactabilityStatus = 'email_ready' | 'phone_only' | 'phone_no_channel' | 'no_channel';
 export declare function contactabilityOf(input: {
     email?: string | null;
     phone?: string | null;
+}, 
+/**
+ * Canais que o ESCRITÓRIO tem operacionais. Omitido = só e-mail, que é o
+ * estado de quem ainda não conectou telefone — e é o padrão hoje.
+ */
+channels?: {
+    phone?: boolean;
 }): Contactability;
 /**
  * Normalização de contato.
@@ -54,7 +107,29 @@ export interface CreateClientInput {
     email?: string | null;
     phone?: string | null;
     createdBy?: string | null;
+    /** Razão social, quando difere do nome pelo qual o escritório chama o cliente. */
+    legalName?: string | null;
+    tradeName?: string | null;
+    addressLine?: string | null;
+    municipality?: string | null;
+    /** UF em duas maiúsculas — o CHECK do banco recusa qualquer outra forma. */
+    stateUf?: string | null;
+    /**
+     * Código IBGE de sete dígitos do município.
+     *
+     * A coluna nasceu na 0049 e nenhum caminho de escrita a alcançava — só um
+     * `UPDATE` cru dentro de um teste. Sem ela, regra municipal nenhuma casa.
+     */
+    municipalityIbgeCode?: string | null;
+    postalCode?: string | null;
+    notes?: string | null;
+    responsibleUserId?: string | null;
+    contractStartedOn?: string | null;
+    /** Lote de importação que originou a linha. Só o importador preenche. */
+    importBatchId?: string | null;
 }
+/** UF só entra em caixa alta; o banco recusa o resto, e recusar cedo dá erro melhor. */
+export declare function normalizeUf(v: string | null | undefined): string | null;
 export declare function createClient(tx: Tx, input: CreateClientInput): Promise<ClientRecord>;
 export declare function listClients(tx: Tx): Promise<ClientRecord[]>;
 export declare function getClient(tx: Tx, id: string): Promise<ClientRecord>;
@@ -68,17 +143,64 @@ export interface ListClientsFilter {
     status?: string;
     limit?: number;
     offset?: number;
+    /**
+     * Filtra a carteira por responsável.
+     *
+     * `'unassigned'` é um valor de primeira classe e não um acaso: "quem não tem
+     * dono" é a pergunta que o escritório mais precisa fazer numa importação
+     * recém-concluída, e ela não é expressável passando um id.
+     */
+    responsibleUserId?: string | 'unassigned';
 }
+/**
+ * O escritório tem canal de telefone operacional?
+ *
+ * Decide se um cliente que só tem telefone é `phone_only` (situação normal) ou
+ * `phone_no_channel` (pendência). A consulta roda sob RLS, então enxerga só o
+ * `channel_binding` do tenant do contexto.
+ *
+ * Uma consulta por listagem, não uma por linha: a resposta é a mesma para todos
+ * os clientes do escritório.
+ */
+export declare function tenantHasPhoneChannel(tx: Tx): Promise<boolean>;
 export declare function listClientsPaged(tx: Tx, filter?: ListClientsFilter): Promise<{
     items: ClientRecord[];
     total: number;
 }>;
+/**
+ * Campo cuja AUSÊNCIA e cujo `null` significam coisas diferentes.
+ *
+ * `undefined` preserva o que está gravado; `null` apaga. A distinção existe
+ * porque endereço e jurisdição são corrigíveis: quem digitou a UF errada
+ * precisa conseguir voltar ao desconhecido, e não só sobrescrever com outro
+ * palpite. O padrão `COALESCE` dos campos antigos não sabe fazer isso — nele,
+ * `null` é indistinguível de "não mandei".
+ */
+type Erasable<T> = T | null | undefined;
 export interface UpdateClientInput {
     displayName?: string;
     legalName?: string | null;
+    tradeName?: string | null;
     email?: string | null;
     phone?: string | null;
     status?: string;
+    /**
+     * Endereço e jurisdição.
+     *
+     * Chegaram tarde de propósito? Não: chegaram tarde por omissão. O importador
+     * de CSV gravava `state_uf` desde a Fase 5, mas nem a criação avulsa nem a
+     * edição tinham onde recebê-lo — um cliente cadastrado pela tela nascia sem
+     * jurisdição e NÃO HAVIA COMO CORRIGIR sem SQL. Toda regra estadual ou
+     * municipal respondia `INSUFFICIENT_DATA` para sempre.
+     */
+    addressLine?: Erasable<string>;
+    municipality?: Erasable<string>;
+    /** Sete dígitos do IBGE. É o que casa o cliente com uma regra municipal. */
+    municipalityIbgeCode?: Erasable<string>;
+    /** UF em duas maiúsculas. Casa o cliente com uma regra estadual. */
+    stateUf?: Erasable<string>;
+    postalCode?: Erasable<string>;
+    notes?: Erasable<string>;
     /**
      * CPF/CNPJ. Faltava aqui: o cliente nascia com documento e nunca podia
      * corrigi-lo — e é justamente o campo que todo gateway de pagamento exige
@@ -92,4 +214,40 @@ export declare function updateClient(tx: Tx, id: string, input: UpdateClientInpu
 export declare function softDeleteClient(tx: Tx, id: string, deletedBy?: string | null): Promise<number>;
 /** Busca por documento normalizado (dedup de importação). Retorna id ou null. */
 export declare function findClientIdByDocument(tx: Tx, documentNumber: string): Promise<string | null>;
+/**
+ * Troca o responsável pela carteira de um cliente.
+ *
+ * Devolve quem era e quem passou a ser, para que a auditoria registre a
+ * TRANSIÇÃO e não apenas o destino. "Passou a ser da Ana" não responde a
+ * pergunta que se faz meses depois — "saiu de quem?" — e é essa que importa
+ * quando um cliente deixa de ser atendido.
+ *
+ * O usuário precisa ser membro ativo do escritório. Sem essa checagem, a FK
+ * aceitaria qualquer `user.id` do banco inteiro, inclusive de outro tenant:
+ * FKs ignoram RLS, então a barreira tem de ser explícita aqui.
+ */
+export declare function assignClientResponsible(tx: Tx, input: {
+    clientId: string;
+    responsibleUserId: string | null;
+}): Promise<{
+    clientId: string;
+    from: string | null;
+    to: string | null;
+}>;
+export interface PortfolioBucket {
+    responsibleUserId: string | null;
+    responsibleName: string | null;
+    clients: number;
+    semCanalAutomatico: number;
+}
+/**
+ * A carteira dividida por responsável.
+ *
+ * O balde `null` — clientes sem dono — vem junto, e vem por último, em vez de
+ * ser omitido. Uma carteira recém-importada é inteiramente desse balde, e uma
+ * tela que só lista responsáveis existentes mostraria zero clientes num
+ * escritório com trezentos.
+ */
+export declare function portfolioByResponsible(tx: Tx): Promise<PortfolioBucket[]>;
+export {};
 //# sourceMappingURL=repository.d.ts.map

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

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

package/dist/clients/repository.js

@@ -1,9 +1,32 @@
 import { ConflictError, NotFoundError, uuidv7 } from '@baruk/shared';
 import { toE164OrNull } from '../contacts/phone.js';
-export function contactabilityOf(input) {
+import { assertIbgeCoherent } from './ibge.js';
+export function contactabilityOf(input, 
+/**
+ * Canais que o ESCRITÓRIO tem operacionais. Omitido = só e-mail, que é o
+ * estado de quem ainda não conectou telefone — e é o padrão hoje.
+ */
+channels = {}) {
     const email = input.email?.trim() ? 'ready' : 'missing';
     const phone = input.phone?.trim() ? 'ready' : 'missing';
-    return { email, phone, reachable: email === 'ready' || phone === 'ready' };
+    const phoneChannelLigado = channels.phone === true;
+    const status = email === 'ready'
+        ? 'email_ready'
+        : phone === 'ready'
+            ? phoneChannelLigado
+                ? 'phone_only'
+                : 'phone_no_channel'
+            : 'no_channel';
+    return {
+        email,
+        phone,
+        // `reachable` mantém o significado antigo — "tem contato cadastrado" — para
+        // não mudar o comportamento de quem já o consulta. Quem quer saber se a
+        // automação alcança usa `automated`.
+        reachable: email === 'ready' || phone === 'ready',
+        status,
+        automated: status === 'email_ready' || status === 'phone_only',
+    };
 }
 /**
  * Normalização de contato.
@@ -28,7 +51,12 @@ export function normalizePhone(v) {
         return null;
     return plus ? `+${digits}` : digits;
 }
-function mapRow(r) {
+/** UF só entra em caixa alta; o banco recusa o resto, e recusar cedo dá erro melhor. */
+export function normalizeUf(v) {
+    const t = v?.trim().toUpperCase();
+    return t && /^[A-Z]{2}$/.test(t) ? t : null;
+}
+function mapRow(r, channels = {}) {
     return {
         id: r.id,
         tenantId: r.tenant_id,
@@ -39,7 +67,17 @@ function mapRow(r) {
         phone: r.phone ?? null,
         status: r.status,
         createdAt: r.created_at.toISOString(),
-        contactability: contactabilityOf({ email: r.email, phone: r.phone }),
+        responsibleUserId: r.responsible_user_id ?? null,
+        municipality: r.municipality ?? null,
+        stateUf: r.state_uf ?? null,
+        legalName: r.legal_name ?? null,
+        tradeName: r.trade_name ?? null,
+        addressLine: r.address_line ?? null,
+        postalCode: r.postal_code ?? null,
+        notes: r.notes ?? null,
+        municipalityIbgeCode: r.municipality_ibge_code ?? null,
+        communicationClearedAt: r.communication_cleared_at?.toISOString() ?? null,
+        contactability: contactabilityOf({ email: r.email, phone: r.phone }, channels),
     };
 }
 /**
@@ -57,21 +95,39 @@ function asDuplicateDocument(err) {
     }
 }
 export async function createClient(tx, input) {
+    // Antes de gravar: o código IBGE não pode contradizer a UF. Aqui o estado
+    // resultante é o próprio input — não há linha anterior com que se misturar.
+    assertIbgeCoherent(input.municipalityIbgeCode?.trim() || null, normalizeUf(input.stateUf));
     // tenant_id vem da GUC — nunca do input. A WITH CHECK da RLS recusa qualquer
     // tentativa de gravar fora do tenant corrente.
     try {
         const rows = await tx `
-      INSERT INTO client (id, tenant_id, client_type, display_name, document_number,
-                          email, phone, phone_e164, created_by)
+      INSERT INTO client (id, tenant_id, client_type, display_name, legal_name, trade_name,
+                          document_number,
+                          email, phone, phone_e164, address_line, municipality, state_uf,
+                          municipality_ibge_code,
+                          postal_code, notes, responsible_user_id, contract_started_on,
+                          import_batch_id, created_by)
       VALUES (
         ${uuidv7()},
         current_setting('app.current_tenant')::uuid,
         ${input.clientType ?? 'pj'},
         ${input.displayName},
+        ${input.legalName?.trim() || null},
+        ${input.tradeName?.trim() || null},
         ${input.documentNumber ?? null},
         ${normalizeEmail(input.email)},
         ${normalizePhone(input.phone)},
         ${toE164OrNull(input.phone)},
+        ${input.addressLine?.trim() || null},
+        ${input.municipality?.trim() || null},
+        ${normalizeUf(input.stateUf)},
+        ${input.municipalityIbgeCode?.trim() || null},
+        ${input.postalCode?.trim() || null},
+        ${input.notes?.trim() || null},
+        ${input.responsibleUserId ?? null},
+        ${input.contractStartedOn ?? null},
+        ${input.importBatchId ?? null},
         ${input.createdBy ?? null}
       )
       RETURNING id, tenant_id, client_type, display_name, document_number, email, phone,
@@ -95,7 +151,9 @@ export async function listClients(tx) {
 }
 export async function getClient(tx, id) {
     const rows = await tx `
-    SELECT id, tenant_id, client_type, display_name, document_number, email, phone, status, created_at
+    SELECT id, tenant_id, client_type, display_name, legal_name, trade_name, document_number, email, phone,
+           status, created_at, responsible_user_id, address_line, municipality, state_uf,
+           municipality_ibge_code, postal_code, notes
     FROM client
     WHERE id = ${id} AND deleted_at IS NULL
   `;
@@ -116,24 +174,68 @@ export async function renameClient(tx, id, displayName) {
   `;
     return rows.count;
 }
+/**
+ * O escritório tem canal de telefone operacional?
+ *
+ * Decide se um cliente que só tem telefone é `phone_only` (situação normal) ou
+ * `phone_no_channel` (pendência). A consulta roda sob RLS, então enxerga só o
+ * `channel_binding` do tenant do contexto.
+ *
+ * Uma consulta por listagem, não uma por linha: a resposta é a mesma para todos
+ * os clientes do escritório.
+ */
+export async function tenantHasPhoneChannel(tx) {
+    const rows = await tx `
+    SELECT count(*)::int AS n FROM channel_binding
+     WHERE channel IN ('whatsapp', 'sms') AND revoked_at IS NULL
+  `;
+    return (rows[0]?.n ?? 0) > 0;
+}
 export async function listClientsPaged(tx, filter = {}) {
     const limit = Math.min(filter.limit ?? 20, 100);
     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, email, phone, status, created_at,
+           responsible_user_id, municipality, state_uf, communication_cleared_at,
            count(*) OVER() AS total
     FROM client
     WHERE deleted_at IS NULL
       AND (${filter.status ?? null}::text IS NULL OR status = ${filter.status ?? null})
       AND (${like}::text IS NULL OR display_name ILIKE ${like} OR document_number ILIKE ${like})
+      AND (${filter.responsibleUserId ?? null}::text IS NULL
+           OR (${filter.responsibleUserId ?? null} = 'unassigned' AND responsible_user_id IS NULL)
+           OR responsible_user_id::text = ${filter.responsibleUserId ?? null})
     ORDER BY created_at DESC
     LIMIT ${limit} OFFSET ${offset}
   `;
     const total = rows[0] ? Number(rows[0].total) : 0;
-    return { items: rows.map((r) => mapRow(r)), total };
+    const phone = await tenantHasPhoneChannel(tx);
+    return { items: rows.map((r) => mapRow(r, { phone })), total };
 }
 export async function updateClient(tx, id, input) {
+    // Coerência IBGE↔UF do ESTADO RESULTANTE, não do corpo da requisição.
+    //
+    // Um PATCH que manda só `stateUf` deixa no banco o código IBGE de antes;
+    // validar apenas o payload aprovaria trocar a UF de GO para SP mantendo o
+    // município goiano gravado. Por isso lemos a linha e mesclamos antes.
+    //
+    // O SELECT só acontece quando um dos dois campos está no corpo: o PATCH
+    // comum (nome, telefone, status) continua sendo uma única query.
+    if ('municipalityIbgeCode' in input || 'stateUf' in input) {
+        const [atual] = await tx `
+      SELECT state_uf, municipality_ibge_code FROM client WHERE id = ${id} AND deleted_at IS NULL
+    `;
+        // Sem linha, quem responde é o UPDATE abaixo com 0 afetadas (404). Recusar
+        // aqui por validação transformaria "cliente não existe" em "dado inválido".
+        if (atual) {
+            const code = 'municipalityIbgeCode' in input
+                ? input.municipalityIbgeCode?.trim() || null
+                : atual.municipality_ibge_code;
+            const uf = 'stateUf' in input ? normalizeUf(input.stateUf) : atual.state_uf;
+            assertIbgeCoherent(code, uf);
+        }
+    }
     // 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
@@ -142,7 +244,8 @@ export async function updateClient(tx, id, input) {
         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),
+      legal_name   = CASE WHEN ${'legalName' in input} THEN ${input.legalName?.trim() || null}::text ELSE legal_name END,
+      trade_name   = CASE WHEN ${'tradeName' in input} THEN ${input.tradeName?.trim() || null}::text ELSE trade_name END,
       document_number = COALESCE(${input.documentNumber ?? null}::text, document_number),
       email        = COALESCE(${normalizeEmail(input.email)}::citext, email),
       phone        = COALESCE(${normalizePhone(input.phone)}::text, phone),
@@ -154,6 +257,14 @@ export async function updateClient(tx, id, input) {
       phone_e164   = CASE WHEN ${input.phone ?? null}::text IS NULL THEN phone_e164
                           ELSE ${toE164OrNull(input.phone)}::text END,
       status       = COALESCE(${input.status ?? null}::text, status),
+      -- Presença, nao valor: ausente preserva, null apaga. Um COALESCE aqui
+      -- tornaria a UF errada permanente -- so daria para troca-la por outra.
+      address_line = CASE WHEN ${'addressLine' in input} THEN ${input.addressLine?.trim() || null}::text ELSE address_line END,
+      municipality = CASE WHEN ${'municipality' in input} THEN ${input.municipality?.trim() || null}::text ELSE municipality END,
+      municipality_ibge_code = CASE WHEN ${'municipalityIbgeCode' in input} THEN ${input.municipalityIbgeCode?.trim() || null}::text ELSE municipality_ibge_code END,
+      state_uf     = CASE WHEN ${'stateUf' in input} THEN ${normalizeUf(input.stateUf)}::text ELSE state_uf END,
+      postal_code  = CASE WHEN ${'postalCode' in input} THEN ${input.postalCode?.trim() || null}::text ELSE postal_code END,
+      notes        = CASE WHEN ${'notes' in input} THEN ${input.notes?.trim() || null}::text ELSE notes END,
       updated_by   = ${input.updatedBy ?? null}::uuid,
       updated_at   = now(),
       version      = version + 1
@@ -183,4 +294,70 @@ export async function findClientIdByDocument(tx, documentNumber) {
   `;
     return rows[0]?.id ?? null;
 }
+/**
+ * Troca o responsável pela carteira de um cliente.
+ *
+ * Devolve quem era e quem passou a ser, para que a auditoria registre a
+ * TRANSIÇÃO e não apenas o destino. "Passou a ser da Ana" não responde a
+ * pergunta que se faz meses depois — "saiu de quem?" — e é essa que importa
+ * quando um cliente deixa de ser atendido.
+ *
+ * O usuário precisa ser membro ativo do escritório. Sem essa checagem, a FK
+ * aceitaria qualquer `user.id` do banco inteiro, inclusive de outro tenant:
+ * FKs ignoram RLS, então a barreira tem de ser explícita aqui.
+ */
+export async function assignClientResponsible(tx, input) {
+    if (input.responsibleUserId) {
+        const [m] = await tx `
+      SELECT count(*)::int AS n FROM membership
+       WHERE user_id = ${input.responsibleUserId}
+         AND status = 'active' AND deleted_at IS NULL
+    `;
+        if ((m?.n ?? 0) === 0) {
+            throw new NotFoundError('Usuário não é membro ativo deste escritório.');
+        }
+    }
+    const [before] = await tx `
+    SELECT responsible_user_id FROM client WHERE id = ${input.clientId} AND deleted_at IS NULL
+  `;
+    if (!before)
+        throw new NotFoundError('Cliente não encontrado.');
+    await tx `
+    UPDATE client
+       SET responsible_user_id = ${input.responsibleUserId}, updated_at = now()
+     WHERE id = ${input.clientId} AND deleted_at IS NULL
+  `;
+    return {
+        clientId: input.clientId,
+        from: before.responsible_user_id,
+        to: input.responsibleUserId,
+    };
+}
+/**
+ * A carteira dividida por responsável.
+ *
+ * O balde `null` — clientes sem dono — vem junto, e vem por último, em vez de
+ * ser omitido. Uma carteira recém-importada é inteiramente desse balde, e uma
+ * tela que só lista responsáveis existentes mostraria zero clientes num
+ * escritório com trezentos.
+ */
+export async function portfolioByResponsible(tx) {
+    const rows = await tx `
+    SELECT c.responsible_user_id,
+           u.full_name,
+           count(*)::int AS clients,
+           count(*) FILTER (WHERE c.email IS NULL)::int AS sem_canal
+      FROM client c
+      LEFT JOIN "user" u ON u.id = c.responsible_user_id
+     WHERE c.deleted_at IS NULL
+     GROUP BY c.responsible_user_id, u.full_name
+     ORDER BY (c.responsible_user_id IS NULL), u.full_name NULLS LAST
+  `;
+    return rows.map((r) => ({
+        responsibleUserId: r.responsible_user_id,
+        responsibleName: r.full_name,
+        clients: r.clients,
+        semCanalAutomatico: r.sem_canal,
+    }));
+}
 //# sourceMappingURL=repository.js.map

package/dist/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/collection/branding.d.ts

@@ -1,3 +1,4 @@
+import { ValidationError } from '@baruk/shared';
 import type { Tx } from '../db/client.js';
 /**
  * Identidade do escritório para a comunicação transacional.
@@ -69,4 +70,68 @@ export declare function getTenantBranding(tx: Tx): Promise<TenantBranding>;
  * duvidar de quem está cobrando.
  */
 export declare function senderFor(branding: TenantBranding, fallbackFrom: string): string;
+/**
+ * Entrada de configuração da marca. Todo campo é opcional; `null` LIMPA o campo
+ * e faz o leitor voltar ao padrão neutro — que é diferente de omitir, que
+ * preserva o que já estava.
+ */
+export interface BrandingInput {
+    officeName?: string | null;
+    signatureName?: string | null;
+    tagline?: string | null;
+    logoUrl?: string | null;
+    logoKind?: LogoKind | null;
+    primaryColor?: string | null;
+    secondaryColor?: string | null;
+    accentColor?: string | null;
+    backgroundColor?: string | null;
+    textColor?: string | null;
+    mutedColor?: string | null;
+    fontFamily?: string | null;
+    supportEmail?: string | null;
+    supportPhone?: string | null;
+    website?: string | null;
+}
+/**
+ * Erro de validação de marca.
+ *
+ * Estende `ValidationError` de propósito, em vez de ser um `Error` próprio: a
+ * borda HTTP já mapeia todo `AppError` para o status certo, e um erro fora
+ * dessa hierarquia sairia como 500 — culpando o servidor por um campo mal
+ * preenchido, e escondendo do formulário qual campo foi. O `field` viaja em
+ * `details` para a tela poder apontar a linha errada.
+ */
+export declare class BrandingValidationError extends ValidationError {
+    readonly field: string;
+    constructor(field: string, message: string);
+}
+/**
+ * Valida a entrada e devolve o objeto a persistir em `tenant.settings.branding`.
+ *
+ * Só as chaves PRESENTES na entrada aparecem no resultado — quem manda três
+ * campos altera três campos. `null` vira ausência do campo no armazenado, que é
+ * como o leitor representa "não configurado".
+ */
+export declare function parseBrandingInput(input: BrandingInput): Record<string, unknown>;
+/**
+ * Chaves que a marca ocupa dentro de `tenant.settings.branding`. Serve para o
+ * `null` REMOVER a chave em vez de gravar um nulo que o leitor teria de
+ * distinguir de ausente.
+ */
+export declare const BRANDING_KEYS: readonly string[];
+/**
+ * Grava a marca do tenant CORRENTE.
+ *
+ * Dois pontos que a implementação não pode perder de vista:
+ *
+ * 1. **`tenant` não tem RLS.** É a tabela raiz — a fonte da fronteira, não uma
+ *    linha protegida por ela. Por isso o `WHERE` amarra na GUC e a função NÃO
+ *    aceita `tenantId` por parâmetro: parâmetro é pedido do chamador, e pedido
+ *    do chamador não é fronteira. Sem contexto, zero linhas e erro.
+ *
+ * 2. **O merge acontece no banco, não na aplicação.** `settings` guarda mais
+ *    que a marca. Ler-modificar-escrever perderia a escrita concorrente de
+ *    outra chave; `jsonb ||` resolve dentro da própria instrução.
+ */
+export declare function updateTenantBranding(tx: Tx, input: BrandingInput): Promise<TenantBranding>;
 //# sourceMappingURL=branding.d.ts.map

package/dist/collection/branding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/collection/branding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AA4ED,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAmDvE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKhF"}
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/collection/branding.ts"],"names":[],"mappings":"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"}