@baruk/core 0.5.0 → 0.6.0

package/dist/clients/registry/lookup.js

@@ -0,0 +1,184 @@
+import { uuidv7 } from '@baruk/shared';
+import { resolveMunicipality } from './ibge.js';
+import { cnpjDigits, isValidCnpj, } from './provider.js';
+/** Os campos do cadastro que uma consulta oficial pode preencher. */
+const CAMPOS = [
+    'legalName',
+    'tradeName',
+    'email',
+    'phone',
+    'addressLine',
+    'postalCode',
+    'municipality',
+    'stateUf',
+    'municipalityIbgeCode',
+];
+function endereco(r) {
+    const partes = [r.address.street, r.address.number, r.address.complement, r.address.district]
+        .map((p) => (p ?? '').trim())
+        .filter(Boolean);
+    return partes.length > 0 ? partes.join(', ') : null;
+}
+/** Só dígitos — CEP e telefone chegam com máscara de toda fonte. */
+function digitos(v) {
+    const d = (v ?? '').replace(/\D/g, '');
+    return d === '' ? null : d;
+}
+/**
+ * Confronta o retrato oficial com o cadastro atual e devolve PROPOSTAS.
+ *
+ * Quatro desfechos por campo, e a UI trata cada um de um jeito:
+ *
+ *   `absent`     a fonte não informou. Nada a propor.
+ *   `unchanged`  igual ao que já está. Nada a fazer.
+ *   `prefill`    o cadastro está vazio — preencher é ganho, não é conflito.
+ *   `conflict`   os dois têm valor e diferem. **Só aqui alguém precisa decidir.**
+ *
+ * Separar `prefill` de `conflict` é o que evita a tela pedir confirmação de
+ * dezoito campos quando dezessete estavam em branco.
+ */
+export function buildProposals(record, atual, ibge) {
+    const oficial = {
+        legalName: record.legalName,
+        tradeName: record.tradeName,
+        email: record.email,
+        phone: digitos(record.phone),
+        addressLine: endereco(record),
+        postalCode: digitos(record.address.zipCode),
+        municipality: record.address.municipality,
+        stateUf: record.address.uf,
+        municipalityIbgeCode: ibge.status === 'match' ? ibge.code : null,
+    };
+    return CAMPOS.map((field) => {
+        const off = oficial[field];
+        const cur = atual[field] ?? null;
+        let decision;
+        if (off === null || off === '')
+            decision = 'absent';
+        else if (cur === null || cur === '')
+            decision = 'prefill';
+        else if (String(cur).trim().toLowerCase() === String(off).trim().toLowerCase())
+            decision = 'unchanged';
+        else
+            decision = 'conflict';
+        return { field, current: cur, official: off, decision };
+    });
+}
+/**
+ * Executa a consulta e monta o resultado — sem tocar no banco.
+ *
+ * A separação é deliberada: consultar é uma operação de rede que pode falhar, e
+ * gravar é uma decisão humana que vem depois. Fundi-las faria uma consulta
+ * bem-sucedida alterar cadastro sem que ninguém tivesse confirmado.
+ */
+export async function lookupCompany(provider, cnpj, atual = {}) {
+    if (!isValidCnpj(cnpj)) {
+        return {
+            status: 'failed',
+            provider: provider.name,
+            official: provider.official,
+            reason: 'invalid_document',
+            proposals: [],
+        };
+    }
+    let resultado;
+    try {
+        resultado = await provider.lookup(cnpjDigits(cnpj));
+    }
+    catch {
+        // Nenhuma exceção de provedor atravessa: a mensagem de um cliente HTTP cita
+        // URL, e URL de provedor pode carregar credencial no query string.
+        return {
+            status: 'failed',
+            provider: provider.name,
+            official: provider.official,
+            reason: 'provider_unavailable',
+            proposals: [],
+        };
+    }
+    if (resultado.status === 'failed') {
+        return {
+            status: 'failed',
+            provider: provider.name,
+            official: provider.official,
+            reason: resultado.reason,
+            proposals: [],
+        };
+    }
+    const ibge = resolveMunicipality(resultado.record.address.municipality ?? '', resultado.record.address.uf);
+    return {
+        status: 'ok',
+        provider: provider.name,
+        official: provider.official,
+        record: resultado.record,
+        ibge,
+        proposals: buildProposals(resultado.record, atual, ibge),
+    };
+}
+/**
+ * Grava o retrato oficial ao lado do cadastro.
+ *
+ * `client` não é tocado aqui. O retrato é o que a fonte disse; aplicar sobre o
+ * cadastro é outro ato, com outra assinatura.
+ */
+export async function saveRegistrySnapshot(tx, input) {
+    const r = input.record;
+    const rows = await tx `
+    INSERT INTO client_registry_snapshot (
+      id, tenant_id, client_id, provider, provider_official, document_digits,
+      legal_name, trade_name, registration_status, opened_on, legal_nature, company_size,
+      primary_activity_code, primary_activity_text, secondary_activities,
+      street, street_number, complement, district, postal_code, municipality, state_uf,
+      phone, email, share_capital_cents, simples_optant, mei_optant
+    ) VALUES (
+      ${uuidv7()}, current_setting('app.current_tenant')::uuid, ${input.clientId},
+      ${input.provider}, ${input.official}, ${cnpjDigits(r.cnpj)},
+      ${r.legalName}, ${r.tradeName}, ${r.registrationStatus}, ${r.openedOn},
+      ${r.legalNature}, ${r.size},
+      ${r.primaryActivity?.code ?? null}, ${r.primaryActivity?.description ?? null},
+      ${tx.json(r.secondaryActivities)},
+      ${r.address.street}, ${r.address.number}, ${r.address.complement}, ${r.address.district},
+      ${digitos(r.address.zipCode)}, ${r.address.municipality}, ${r.address.uf},
+      ${digitos(r.phone)}, ${r.email},
+      ${r.shareCapital === null ? null : Math.round(r.shareCapital * 100)},
+      ${r.simplesOptant}, ${r.meiOptant}
+    )
+    RETURNING id
+  `;
+    return rows[0].id;
+}
+/**
+ * Marca a origem de um campo do cadastro.
+ *
+ * `human` vence: um campo que uma pessoa escreveu NUNCA volta a `official_lookup`
+ * por uma atualização automática. É esta função — e o `WHERE` dela — que faz
+ * `HUMAN_OVERRIDE_PRESERVED` ser uma consulta, e não uma promessa.
+ */
+export async function markFieldProvenance(tx, input) {
+    const oficial = input.origin === 'official_lookup';
+    await tx `
+    INSERT INTO client_field_provenance (
+      id, tenant_id, client_id, field, origin, provider, verified_at, updated_by
+    ) VALUES (
+      ${uuidv7()}, current_setting('app.current_tenant')::uuid, ${input.clientId},
+      ${input.field}, ${input.origin}, ${oficial ? (input.provider ?? null) : null},
+      ${oficial ? new Date().toISOString() : null}, ${input.updatedBy ?? null}
+    )
+    ON CONFLICT (tenant_id, client_id, field) DO UPDATE SET
+      origin = EXCLUDED.origin, provider = EXCLUDED.provider,
+      verified_at = EXCLUDED.verified_at, updated_by = EXCLUDED.updated_by,
+      updated_at = now()
+    -- A cláusula que preserva a decisão humana: uma atualização automática não
+    -- rebaixa um campo que alguém assumiu. Só outra pessoa faz isso.
+    WHERE client_field_provenance.origin <> 'human' OR EXCLUDED.origin = 'human'
+  `;
+}
+/** Os campos que uma pessoa assumiu — o autofill não os toca. */
+export async function humanOwnedFields(tx, clientId) {
+    const rows = await tx `
+    SELECT field FROM client_field_provenance
+     WHERE client_id = ${clientId} AND origin = 'human'
+  `;
+    return rows.map((r) => r.field);
+}
+//# sourceMappingURL=lookup.js.map

package/dist/clients/registry/lookup.js.map

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

package/dist/clients/registry/provider.d.ts

@@ -0,0 +1,124 @@
+import { isValidCnpj } from '../../import/br-documents.js';
+/**
+ * A fonte oficial de dados cadastrais de uma empresa — atrás de uma interface.
+ *
+ * ## Por que interface, e não uma chamada à Receita dentro da tela
+ *
+ * Três razões, e a terceira é a que decide:
+ *
+ * 1. a fonte muda (Serpro hoje, Conecta amanhã, um convênio estadual depois);
+ * 2. o teste precisa de um provedor determinístico, e um teste que fala com a
+ *    Receita não é um teste — é uma consulta paga com asserção em volta;
+ * 3. **a fonte oficial em tempo real exige contrato comercial.** Sem a interface,
+ *    a ausência do contrato viraria uma chamada a uma API comunitária "só por
+ *    enquanto", e o "por enquanto" de uma fonte cadastral é o que fica.
+ *
+ * ## O que este produto NÃO faz
+ *
+ * Não raspa página pública, e não elege API comunitária como fonte canônica.
+ * Dado cadastral de terceiro que decide obrigação fiscal precisa de origem
+ * nomeável — e `PROVIDER_NOT_CONFIGURED` é uma resposta melhor que um dado de
+ * procedência incerta.
+ */
+/** Situação cadastral, tal como a Receita a publica. Vocabulário fechado. */
+export type RegistrationStatus = 'ATIVA' | 'SUSPENSA' | 'INAPTA' | 'BAIXADA' | 'NULA' | 'DESCONHECIDA';
+export interface CompanyAddress {
+    street: string | null;
+    number: string | null;
+    complement: string | null;
+    district: string | null;
+    zipCode: string | null;
+    municipality: string | null;
+    uf: string | null;
+}
+export interface CompanyActivity {
+    code: string;
+    description: string | null;
+}
+/**
+ * O retrato normalizado. Todo campo é opcional porque toda fonte tem lacuna —
+ * e um campo ausente precisa ser dizível como ausente, não como vazio.
+ */
+export interface CompanyRegistryRecord {
+    cnpj: string;
+    legalName: string | null;
+    tradeName: string | null;
+    registrationStatus: RegistrationStatus;
+    openedOn: string | null;
+    legalNature: string | null;
+    size: string | null;
+    primaryActivity: CompanyActivity | null;
+    secondaryActivities: readonly CompanyActivity[];
+    address: CompanyAddress;
+    phone: string | null;
+    email: string | null;
+    shareCapital: number | null;
+    /**
+     * Optante pelo Simples / MEI, quando a FONTE informa.
+     *
+     * `null` é "a fonte não disse" e NÃO é `false`. A diferença decide regime
+     * tributário, e tratar silêncio como negativa é como um cliente do Simples
+     * vira Lucro Presumido por omissão.
+     */
+    simplesOptant: boolean | null;
+    meiOptant: boolean | null;
+}
+/** Classes de falha. Cada uma pede uma reação diferente de quem chama. */
+export type CompanyLookupFailure = 
+/** Não há provedor configurado — o caminho oficial existe e não foi contratado. */
+'provider_not_configured'
+/** O CNPJ não tem forma válida. Recusado antes de sair da máquina. */
+ | 'invalid_document'
+/** A fonte respondeu que não conhece este CNPJ. */
+ | 'not_found'
+/** Teto de consultas. Reagir esperando, nunca insistindo. */
+ | 'rate_limited'
+/** A fonte falhou ou demorou. Retentável. */
+ | 'provider_unavailable'
+/** A fonte respondeu algo que este contrato não sabe ler. Fail closed. */
+ | 'unexpected_payload';
+export type CompanyLookupResult = {
+    status: 'ok';
+    record: CompanyRegistryRecord;
+    source: string;
+    fetchedAt: string;
+} | {
+    status: 'failed';
+    reason: CompanyLookupFailure;
+    source: string;
+};
+export interface CompanyRegistryProvider {
+    /** Nome curto e estável — vai para a proveniência do dado e para a trilha. */
+    readonly name: string;
+    /** `true` só quando a fonte é oficial. A UI diz isso ao operador. */
+    readonly official: boolean;
+    lookup(cnpj: string): Promise<CompanyLookupResult>;
+}
+/**
+ * Dígitos do CNPJ, sem máscara.
+ *
+ * Delega a `onlyDigits`, e não repete o `replace`: o dia em que a normalização
+ * precisar tratar um caractere invisível colado de um PDF, ela precisa mudar
+ * num lugar só.
+ */
+export declare function cnpjDigits(value: string): string;
+/**
+ * Validade do CNPJ — reexportada, nunca reimplementada.
+ *
+ * A regra já vive em `import/br-documents.ts`, onde nasceu para a importação de
+ * carteira. Escrever uma segunda aqui produziria duas réguas para a mesma
+ * pergunta, e a divergência entre elas decidiria quais cadastros entram: um
+ * documento aceito pela importação e recusado pela consulta (ou o contrário) é
+ * um defeito que nenhum dos dois lados vê sozinho.
+ */
+export { isValidCnpj };
+/**
+ * O provedor que responde quando nenhum está configurado.
+ *
+ * Existe para que a ausência de contrato seja um estado NOMEADO do produto, e
+ * não uma exceção no meio de um formulário. Quem chama recebe
+ * `provider_not_configured` e mostra "não foi possível consultar
+ * automaticamente" — o cadastro manual segue funcionando.
+ */
+export declare const unconfiguredCompanyRegistry: CompanyRegistryProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/clients/registry/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/clients/registry/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,8BAA8B,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAC5B,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,cAAc,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,mBAAmB,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;;OAMG;IACH,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAED,0EAA0E;AAC1E,MAAM,MAAM,oBAAoB;AAC9B,mFAAmF;AACjF,yBAAyB;AAC3B,sEAAsE;GACpE,kBAAkB;AACpB,mDAAmD;GACjD,WAAW;AACb,6DAA6D;GAC3D,cAAc;AAChB,6CAA6C;GAC3C,sBAAsB;AACxB,0EAA0E;GACxE,oBAAoB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;GAQG;AACH,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,EAAE,uBAQzC,CAAC"}

package/dist/clients/registry/provider.js

@@ -0,0 +1,39 @@
+import { isValidCnpj, onlyDigits } from '../../import/br-documents.js';
+/**
+ * Dígitos do CNPJ, sem máscara.
+ *
+ * Delega a `onlyDigits`, e não repete o `replace`: o dia em que a normalização
+ * precisar tratar um caractere invisível colado de um PDF, ela precisa mudar
+ * num lugar só.
+ */
+export function cnpjDigits(value) {
+    return onlyDigits(value);
+}
+/**
+ * Validade do CNPJ — reexportada, nunca reimplementada.
+ *
+ * A regra já vive em `import/br-documents.ts`, onde nasceu para a importação de
+ * carteira. Escrever uma segunda aqui produziria duas réguas para a mesma
+ * pergunta, e a divergência entre elas decidiria quais cadastros entram: um
+ * documento aceito pela importação e recusado pela consulta (ou o contrário) é
+ * um defeito que nenhum dos dois lados vê sozinho.
+ */
+export { isValidCnpj };
+/**
+ * O provedor que responde quando nenhum está configurado.
+ *
+ * Existe para que a ausência de contrato seja um estado NOMEADO do produto, e
+ * não uma exceção no meio de um formulário. Quem chama recebe
+ * `provider_not_configured` e mostra "não foi possível consultar
+ * automaticamente" — o cadastro manual segue funcionando.
+ */
+export const unconfiguredCompanyRegistry = {
+    name: 'unconfigured',
+    official: false,
+    lookup: async (cnpj) => ({
+        status: 'failed',
+        reason: isValidCnpj(cnpj) ? 'provider_not_configured' : 'invalid_document',
+        source: 'unconfigured',
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/clients/registry/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/clients/registry/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAmGvE;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA4B;IAClE,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC;QAC/B,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,kBAAkB;QAC1E,MAAM,EAAE,cAAc;KACvB,CAAC;CACH,CAAC"}

package/dist/clients/registry/resolve.d.ts

@@ -0,0 +1,36 @@
+import { type CompanyRegistryProvider } from './provider.js';
+/**
+ * Qual provedor este ambiente tem — e por que ele pode não ter nenhum.
+ *
+ * ## A ausência é um estado do produto, não um defeito
+ *
+ * Não há contrato com fonte oficial hoje. A resposta a isso não é adiar a
+ * funcionalidade nem improvisar com um agregador: é fazer "sem fonte oficial"
+ * ser uma resposta que o produto sabe dar. A tela de cadastro continua
+ * funcionando — o operador digita tudo à mão, como digita hoje — e diz por que
+ * o botão de consulta não está lá.
+ *
+ * O ganho de nomear o estado é que ligar a fonte, quando o contrato existir,
+ * é uma variável de ambiente. Não é uma refatoração.
+ */
+export type RegistryProviderChoice = 'none' | 'synthetic' | 'serpro';
+export interface RegistryAvailability {
+    provider: CompanyRegistryProvider;
+    /** `true` quando há um provedor que de fato consulta alguma coisa. */
+    enabled: boolean;
+    /** Por que não está disponível — o texto que a tela explica ao operador. */
+    reason: 'available' | 'not_configured' | 'contract_unverified' | 'missing_credential' | 'unknown_choice';
+}
+export interface RegistryEnv {
+    COMPANY_REGISTRY_PROVIDER?: string | undefined;
+    SERPRO_CONSULTA_CNPJ_TOKEN?: string | undefined;
+}
+/**
+ * Resolve o provedor a partir do ambiente.
+ *
+ * O padrão é `none`. Um padrão que tentasse adivinhar — "tem token? então usa"
+ * — ligaria consulta paga em qualquer ambiente onde a variável vazasse, e a
+ * primeira fatura seria a notificação.
+ */
+export declare function resolveCompanyRegistry(env?: RegistryEnv): RegistryAvailability;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/clients/registry/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/clients/registry/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,MAAM,EACF,WAAW,GACX,gBAAgB,GAChB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,CAAC;CACtB;AAQD,MAAM,WAAW,WAAW;IAC1B,yBAAyB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,WAAyB,GAAG,oBAAoB,CA2B3F"}

package/dist/clients/registry/resolve.js

@@ -0,0 +1,44 @@
+import { createSerproCompanyRegistry, SerproContractUnverifiedError } from './serpro.js';
+import { syntheticCompanyRegistry } from './synthetic.js';
+import { unconfiguredCompanyRegistry } from './provider.js';
+const INDISPONIVEL = (reason) => ({
+    provider: unconfiguredCompanyRegistry,
+    enabled: false,
+    reason,
+});
+/**
+ * Resolve o provedor a partir do ambiente.
+ *
+ * O padrão é `none`. Um padrão que tentasse adivinhar — "tem token? então usa"
+ * — ligaria consulta paga em qualquer ambiente onde a variável vazasse, e a
+ * primeira fatura seria a notificação.
+ */
+export function resolveCompanyRegistry(env = process.env) {
+    const escolha = (env.COMPANY_REGISTRY_PROVIDER ?? 'none').trim().toLowerCase();
+    if (escolha === '' || escolha === 'none')
+        return INDISPONIVEL('not_configured');
+    if (escolha === 'synthetic') {
+        // Sintético é `official: false` na origem, e o carimbo acompanha todo dado
+        // que ele produzir. Ver `synthetic.ts`.
+        return { provider: syntheticCompanyRegistry(), enabled: true, reason: 'available' };
+    }
+    if (escolha === 'serpro') {
+        const token = (env.SERPRO_CONSULTA_CNPJ_TOKEN ?? '').trim();
+        if (token === '')
+            return INDISPONIVEL('missing_credential');
+        try {
+            return {
+                provider: createSerproCompanyRegistry({ token }),
+                enabled: true,
+                reason: 'available',
+            };
+        }
+        catch (err) {
+            if (err instanceof SerproContractUnverifiedError)
+                return INDISPONIVEL('contract_unverified');
+            throw err;
+        }
+    }
+    return INDISPONIVEL('unknown_choice');
+}
+//# sourceMappingURL=resolve.js.map

package/dist/clients/registry/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/clients/registry/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAgC,MAAM,eAAe,CAAC;AAgC1F,MAAM,YAAY,GAAG,CAAC,MAAsC,EAAwB,EAAE,CAAC,CAAC;IACtF,QAAQ,EAAE,2BAA2B;IACrC,OAAO,EAAE,KAAK;IACd,MAAM;CACP,CAAC,CAAC;AAOH;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAmB,OAAO,CAAC,GAAG;IACnE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,yBAAyB,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE/E,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAEhF,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,2EAA2E;QAC3E,wCAAwC;QACxC,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,YAAY,CAAC,oBAAoB,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,OAAO;gBACL,QAAQ,EAAE,2BAA2B,CAAC,EAAE,KAAK,EAAE,CAAC;gBAChD,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,6BAA6B;gBAAE,OAAO,YAAY,CAAC,qBAAqB,CAAC,CAAC;YAC7F,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,gBAAgB,CAAC,CAAC;AACxC,CAAC"}

package/dist/clients/registry/serpro.d.ts

@@ -0,0 +1,57 @@
+import type { CompanyRegistryProvider, CompanyRegistryRecord } from './provider.js';
+/**
+ * Serpro — Consulta CNPJ. Escrito, e deliberadamente fechado.
+ *
+ * ## Por que existe um adaptador que ninguém pode ligar
+ *
+ * A descoberta desta rodada encontrou exatamente três fontes oficiais de dado
+ * cadastral de CNPJ, e nenhuma delas está disponível para este produto hoje:
+ *
+ *   - **Conecta gov.br (Receita Federal)** — restrita a órgãos públicos. A SC é
+ *     uma empresa privada. Não é questão de pedir acesso; é fora do escopo.
+ *   - **Serpro Consulta CNPJ** — oficial e disponível, mediante **contrato
+ *     comercial**. Há período de avaliação (30 dias / 3.000 consultas), que
+ *     também exige cadastro e aceite de termos por uma pessoa jurídica.
+ *   - **Dados Abertos da RFB** — oficial, mas são dumps CSV mensais. Servem
+ *     para conferência em lote; não respondem "consulte este CNPJ agora".
+ *
+ * Agregadores comunitários gratuitos resolveriam o problema técnico hoje e
+ * criariam outro: o dado não teria autoria, e a etiqueta de proveniência diria
+ * "oficial" sobre algo que ninguém oficial afirmou. Ficam fora.
+ *
+ * ## Por que não basta ter o token
+ *
+ * **Os nomes dos campos da resposta não foram conferidos contra o serviço
+ * real.** O `parse` abaixo é a melhor leitura da documentação pública, e uma
+ * leitura não conferida que roda em produção é como um campo silenciosamente
+ * vazio vira "a Receita não informou" — indistinguível de uma ausência
+ * verdadeira, e muito pior, porque ninguém vai procurar.
+ *
+ * Enquanto `SERPRO_CONTRACT_VERIFIED` for `false`, este provedor não é
+ * construível, mesmo com credencial. Ligar exige DUAS coisas: o contrato
+ * (humano, externo) e a conferência do envelope contra uma resposta real.
+ */
+export declare const SERPRO_BASE_URL = "https://gateway.apiserpro.serpro.gov.br/consulta-cnpj-df/v2";
+/**
+ * O envelope de resposta foi conferido contra o serviço real?
+ *
+ * Vira `true` numa mudança de código com a evidência anexada — nunca por
+ * variável de ambiente. Uma flag de ambiente permitiria ligar em produção o que
+ * ninguém verificou, que é precisamente o que esta constante impede.
+ */
+export declare const SERPRO_CONTRACT_VERIFIED = false;
+export declare class SerproContractUnverifiedError extends Error {
+    constructor();
+}
+/** Leitura da documentação pública. NÃO conferida contra resposta real. */
+export declare function parseSerproPayload(body: unknown): CompanyRegistryRecord | null;
+export interface SerproOptions {
+    token: string;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Constrói o provedor do Serpro. Recusa enquanto o contrato não for conferido.
+ */
+export declare function createSerproCompanyRegistry(options: SerproOptions): CompanyRegistryProvider;
+//# sourceMappingURL=serpro.d.ts.map

package/dist/clients/registry/serpro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serpro.d.ts","sourceRoot":"","sources":["../../../src/clients/registry/serpro.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EAEtB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,eAAO,MAAM,eAAe,gEAAgE,CAAC;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C,qBAAa,6BAA8B,SAAQ,KAAK;;CAQvD;AAkCD,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,GAAG,IAAI,CA+C9E;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,aAAa,GAAG,uBAAuB,CAa3F"}

package/dist/clients/registry/serpro.js

@@ -0,0 +1,143 @@
+import { createHttpCompanyRegistry } from './http.js';
+/**
+ * Serpro — Consulta CNPJ. Escrito, e deliberadamente fechado.
+ *
+ * ## Por que existe um adaptador que ninguém pode ligar
+ *
+ * A descoberta desta rodada encontrou exatamente três fontes oficiais de dado
+ * cadastral de CNPJ, e nenhuma delas está disponível para este produto hoje:
+ *
+ *   - **Conecta gov.br (Receita Federal)** — restrita a órgãos públicos. A SC é
+ *     uma empresa privada. Não é questão de pedir acesso; é fora do escopo.
+ *   - **Serpro Consulta CNPJ** — oficial e disponível, mediante **contrato
+ *     comercial**. Há período de avaliação (30 dias / 3.000 consultas), que
+ *     também exige cadastro e aceite de termos por uma pessoa jurídica.
+ *   - **Dados Abertos da RFB** — oficial, mas são dumps CSV mensais. Servem
+ *     para conferência em lote; não respondem "consulte este CNPJ agora".
+ *
+ * Agregadores comunitários gratuitos resolveriam o problema técnico hoje e
+ * criariam outro: o dado não teria autoria, e a etiqueta de proveniência diria
+ * "oficial" sobre algo que ninguém oficial afirmou. Ficam fora.
+ *
+ * ## Por que não basta ter o token
+ *
+ * **Os nomes dos campos da resposta não foram conferidos contra o serviço
+ * real.** O `parse` abaixo é a melhor leitura da documentação pública, e uma
+ * leitura não conferida que roda em produção é como um campo silenciosamente
+ * vazio vira "a Receita não informou" — indistinguível de uma ausência
+ * verdadeira, e muito pior, porque ninguém vai procurar.
+ *
+ * Enquanto `SERPRO_CONTRACT_VERIFIED` for `false`, este provedor não é
+ * construível, mesmo com credencial. Ligar exige DUAS coisas: o contrato
+ * (humano, externo) e a conferência do envelope contra uma resposta real.
+ */
+export const SERPRO_BASE_URL = 'https://gateway.apiserpro.serpro.gov.br/consulta-cnpj-df/v2';
+/**
+ * O envelope de resposta foi conferido contra o serviço real?
+ *
+ * Vira `true` numa mudança de código com a evidência anexada — nunca por
+ * variável de ambiente. Uma flag de ambiente permitiria ligar em produção o que
+ * ninguém verificou, que é precisamente o que esta constante impede.
+ */
+export const SERPRO_CONTRACT_VERIFIED = false;
+export class SerproContractUnverifiedError extends Error {
+    constructor() {
+        super('o envelope de resposta do Serpro Consulta CNPJ não foi conferido contra o serviço real; ' +
+            'o provedor permanece fechado até que seja');
+        this.name = 'SerproContractUnverifiedError';
+    }
+}
+function texto(v) {
+    const s = typeof v === 'string' ? v.trim() : typeof v === 'number' ? String(v) : '';
+    return s === '' ? null : s;
+}
+/**
+ * Situação cadastral pelo código da RFB.
+ *
+ * Código desconhecido vira `DESCONHECIDA`, e não `ATIVA`. Tratar o desconhecido
+ * como ativo faria uma empresa baixada entrar na carteira como operante — e o
+ * motor fiscal passaria a gerar obrigação para quem não tem mais nenhuma.
+ */
+function situacao(codigo) {
+    switch (texto(codigo)) {
+        case '2':
+            return 'ATIVA';
+        case '3':
+            return 'SUSPENSA';
+        case '4':
+            return 'INAPTA';
+        case '8':
+            return 'BAIXADA';
+        case '1':
+            return 'NULA';
+        default:
+            return 'DESCONHECIDA';
+    }
+}
+const bag = (v) => (v && typeof v === 'object' ? v : {});
+/** Leitura da documentação pública. NÃO conferida contra resposta real. */
+export function parseSerproPayload(body) {
+    const b = bag(body);
+    const ni = texto(b.ni);
+    if (!ni)
+        return null;
+    const end = bag(b.endereco);
+    const principal = bag(b.cnaePrincipal);
+    const telefone = Array.isArray(b.telefones) ? bag(b.telefones[0]) : {};
+    const ddd = texto(telefone.ddd);
+    const numero = texto(telefone.numero);
+    return {
+        cnpj: ni,
+        legalName: texto(b.nomeEmpresarial),
+        tradeName: texto(b.nomeFantasia),
+        registrationStatus: situacao(bag(b.situacaoCadastral).codigo),
+        openedOn: texto(b.dataAbertura),
+        legalNature: texto(bag(b.naturezaJuridica).descricao),
+        size: texto(b.porte),
+        primaryActivity: texto(principal.codigo)
+            ? { code: texto(principal.codigo), description: texto(principal.descricao) }
+            : null,
+        secondaryActivities: (Array.isArray(b.cnaeSecundarias) ? b.cnaeSecundarias : [])
+            .map((c) => bag(c))
+            .filter((c) => texto(c.codigo))
+            .map((c) => ({ code: texto(c.codigo), description: texto(c.descricao) })),
+        address: {
+            street: texto(end.logradouro),
+            number: texto(end.numero),
+            complement: texto(end.complemento),
+            district: texto(end.bairro),
+            zipCode: texto(end.cep),
+            municipality: texto(bag(end.municipio).descricao) ?? texto(end.municipio),
+            uf: texto(end.uf),
+        },
+        phone: ddd && numero ? `${ddd}${numero}` : numero,
+        email: texto(b.correioEletronico),
+        shareCapital: typeof b.capitalSocial === 'number' ? b.capitalSocial : null,
+        // ═══ O silêncio, preservado ═══════════════════════════════════════════
+        // Esta consulta NÃO informa opção pelo Simples nem MEI. `null` diz isso.
+        // Preencher `false` aqui — "a resposta não citou, então não é" — faria um
+        // optante do Simples ser tratado como Lucro Presumido pelo motor fiscal,
+        // por uma dedução que nenhuma fonte fez.
+        simplesOptant: null,
+        meiOptant: null,
+    };
+}
+/**
+ * Constrói o provedor do Serpro. Recusa enquanto o contrato não for conferido.
+ */
+export function createSerproCompanyRegistry(options) {
+    if (!SERPRO_CONTRACT_VERIFIED)
+        throw new SerproContractUnverifiedError();
+    const base = options.baseUrl ?? SERPRO_BASE_URL;
+    return createHttpCompanyRegistry({
+        name: 'serpro',
+        official: true,
+        buildUrl: (cnpj) => `${base}/basica/${cnpj}`,
+        // A credencial vive AQUI e só aqui. Nunca na URL: query string entra em log
+        // de proxy, em `Referer` e em mensagem de erro.
+        headers: () => ({ authorization: `Bearer ${options.token}` }),
+        parse: parseSerproPayload,
+        ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+    });
+}
+//# sourceMappingURL=serpro.js.map