@baruk/core 0.4.2 → 0.6.0

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

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProposals = buildProposals;
+exports.lookupCompany = lookupCompany;
+exports.saveRegistrySnapshot = saveRegistrySnapshot;
+exports.markFieldProvenance = markFieldProvenance;
+exports.humanOwnedFields = humanOwnedFields;
+const shared_1 = require("@baruk/shared");
+const ibge_js_1 = require("./ibge.js");
+const provider_js_1 = require("./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.
+ */
+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.
+ */
+async function lookupCompany(provider, cnpj, atual = {}) {
+    if (!(0, provider_js_1.isValidCnpj)(cnpj)) {
+        return {
+            status: 'failed',
+            provider: provider.name,
+            official: provider.official,
+            reason: 'invalid_document',
+            proposals: [],
+        };
+    }
+    let resultado;
+    try {
+        resultado = await provider.lookup((0, provider_js_1.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 = (0, ibge_js_1.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.
+ */
+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 (
+      ${(0, shared_1.uuidv7)()}, current_setting('app.current_tenant')::uuid, ${input.clientId},
+      ${input.provider}, ${input.official}, ${(0, provider_js_1.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.
+ */
+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 (
+      ${(0, shared_1.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. */
+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/cjs/clients/registry/lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../../../src/clients/registry/lookup.ts"],"names":[],"mappings":";;AA4FA,wCA4BC;AASD,sCAqDC;AAQD,oDA4BC;AASD,kDA2BC;AAGD,4CAMC;AAvQD,0CAAuC;AAEvC,uCAAgE;AAChE,+CAMuB;AA0CvB,qEAAqE;AACrE,MAAM,MAAM,GAAG;IACb,WAAW;IACX,WAAW;IACX,OAAO;IACP,OAAO;IACP,aAAa;IACb,YAAY;IACZ,cAAc;IACd,SAAS;IACT,sBAAsB;CACd,CAAC;AAIX,SAAS,QAAQ,CAAC,CAAwB;IACxC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;SAC1F,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED,oEAAoE;AACpE,SAAS,OAAO,CAAC,CAAgB;IAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,cAAc,CAC5B,MAA6B,EAC7B,KAAoD,EACpD,IAAe;IAEf,MAAM,OAAO,GAAyC;QACpD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC5B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC;QAC7B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3C,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY;QACzC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;QAC1B,oBAAoB,EAAE,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;KACjE,CAAC;IAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QACjC,IAAI,QAAuB,CAAC;QAC5B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE;YAAE,QAAQ,GAAG,QAAQ,CAAC;aAC/C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE;YAAE,QAAQ,GAAG,SAAS,CAAC;aACrD,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5E,QAAQ,GAAG,WAAW,CAAC;;YACpB,QAAQ,GAAG,UAAU,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,QAAiC,EACjC,IAAY,EACZ,QAAuD,EAAE;IAEzD,IAAI,CAAC,IAAA,yBAAW,EAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM,EAAE,kBAAkB;YAC1B,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,IAAI,SAA8B,CAAC;IACnC,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAA,wBAAU,EAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,mEAAmE;QACnE,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM,EAAE,sBAAsB;YAC9B,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAA,6BAAmB,EAC9B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,EAC3C,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAC5B,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,IAAI;QACJ,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC;KACzD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CACxC,EAAM,EACN,KAA+F;IAE/F,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAkB;;;;;;;;QAQjC,IAAA,eAAM,GAAE,kDAAkD,KAAK,CAAC,QAAQ;QACxE,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,KAAK,IAAA,wBAAU,EAAC,CAAC,CAAC,IAAI,CAAC;QACxD,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,kBAAkB,KAAK,CAAC,CAAC,QAAQ;QACnE,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,IAAI;QACxB,CAAC,CAAC,eAAe,EAAE,IAAI,IAAI,IAAI,KAAK,CAAC,CAAC,eAAe,EAAE,WAAW,IAAI,IAAI;QAC1E,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,mBAA4B,CAAC;QACvC,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ;QACrF,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE;QACtE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK;QAC5B,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC;QACjE,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,SAAS;;;GAGpC,CAAC;IACF,OAAO,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,mBAAmB,CACvC,EAAM,EACN,KAMC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,iBAAiB,CAAC;IACnD,MAAM,EAAE,CAAA;;;;QAIF,IAAA,eAAM,GAAE,kDAAkD,KAAK,CAAC,QAAQ;QACxE,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QAC1E,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,SAAS,IAAI,IAAI;;;;;;;;;GAS1E,CAAC;AACJ,CAAC;AAED,iEAAiE;AAC1D,KAAK,UAAU,gBAAgB,CAAC,EAAM,EAAE,QAAgB;IAC7D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAqB;;yBAEnB,QAAQ;GAC9B,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unconfiguredCompanyRegistry = exports.isValidCnpj = void 0;
+exports.cnpjDigits = cnpjDigits;
+const br_documents_js_1 = require("../../import/br-documents.js");
+Object.defineProperty(exports, "isValidCnpj", { enumerable: true, get: function () { return br_documents_js_1.isValidCnpj; } });
+/**
+ * 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ó.
+ */
+function cnpjDigits(value) {
+    return (0, br_documents_js_1.onlyDigits)(value);
+}
+/**
+ * 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.
+ */
+exports.unconfiguredCompanyRegistry = {
+    name: 'unconfigured',
+    official: false,
+    lookup: async (cnpj) => ({
+        status: 'failed',
+        reason: (0, br_documents_js_1.isValidCnpj)(cnpj) ? 'provider_not_configured' : 'invalid_document',
+        source: 'unconfigured',
+    }),
+};
+//# sourceMappingURL=provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/clients/registry/provider.ts"],"names":[],"mappings":";;;AA0GA,gCAEC;AA5GD,kEAAuE;AAuH9D,4FAvHA,6BAAW,OAuHA;AApBpB;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,KAAa;IACtC,OAAO,IAAA,4BAAU,EAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAaD;;;;;;;GAOG;AACU,QAAA,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,IAAA,6BAAW,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,kBAAkB;QAC1E,MAAM,EAAE,cAAc;KACvB,CAAC;CACH,CAAC"}

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCompanyRegistry = resolveCompanyRegistry;
+const serpro_js_1 = require("./serpro.js");
+const synthetic_js_1 = require("./synthetic.js");
+const provider_js_1 = require("./provider.js");
+const INDISPONIVEL = (reason) => ({
+    provider: provider_js_1.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.
+ */
+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: (0, synthetic_js_1.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: (0, serpro_js_1.createSerproCompanyRegistry)({ token }),
+                enabled: true,
+                reason: 'available',
+            };
+        }
+        catch (err) {
+            if (err instanceof serpro_js_1.SerproContractUnverifiedError)
+                return INDISPONIVEL('contract_unverified');
+            throw err;
+        }
+    }
+    return INDISPONIVEL('unknown_choice');
+}
+//# sourceMappingURL=resolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../../src/clients/registry/resolve.ts"],"names":[],"mappings":";;AAoDA,wDA2BC;AA/ED,2CAAyF;AACzF,iDAA0D;AAC1D,+CAA0F;AAgC1F,MAAM,YAAY,GAAG,CAAC,MAAsC,EAAwB,EAAE,CAAC,CAAC;IACtF,QAAQ,EAAE,yCAA2B;IACrC,OAAO,EAAE,KAAK;IACd,MAAM;CACP,CAAC,CAAC;AAOH;;;;;;GAMG;AACH,SAAgB,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,IAAA,uCAAwB,GAAE,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,IAAA,uCAA2B,EAAC,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,yCAA6B;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/cjs/clients/registry/serpro.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerproContractUnverifiedError = exports.SERPRO_CONTRACT_VERIFIED = exports.SERPRO_BASE_URL = void 0;
+exports.parseSerproPayload = parseSerproPayload;
+exports.createSerproCompanyRegistry = createSerproCompanyRegistry;
+const http_js_1 = require("./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.
+ */
+exports.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.
+ */
+exports.SERPRO_CONTRACT_VERIFIED = false;
+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';
+    }
+}
+exports.SerproContractUnverifiedError = 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. */
+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.
+ */
+function createSerproCompanyRegistry(options) {
+    if (!exports.SERPRO_CONTRACT_VERIFIED)
+        throw new SerproContractUnverifiedError();
+    const base = options.baseUrl ?? exports.SERPRO_BASE_URL;
+    return (0, http_js_1.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

package/dist/cjs/clients/registry/serpro.js.map

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