@baruk/core 0.4.2 → 0.6.0

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

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOOKUP_CIRCUIT_OPEN_MS = exports.LOOKUP_CIRCUIT_THRESHOLD = exports.LOOKUP_CACHE_TTL_MS = exports.LOOKUP_QUOTA_WINDOW_MS = exports.LOOKUP_QUOTA_LIMIT = void 0;
+exports.resetLookupCircuits = resetLookupCircuits;
+exports.lookupCompanyRegistry = lookupCompanyRegistry;
+const shared_1 = require("@baruk/shared");
+const audit_js_1 = require("../../audit/audit.js");
+const ibge_js_1 = require("./ibge.js");
+const lookup_js_1 = require("./lookup.js");
+const provider_js_1 = require("./provider.js");
+/**
+ * A consulta com as três defesas que o provedor não dá.
+ *
+ * Nenhuma delas é sobre a rede estar lenta. As três são sobre o que uma
+ * consulta barata e repetível permite fazer:
+ *
+ * **Cota** — um CNPJ tem 14 dígitos e o dígito verificador reduz o espaço a
+ * ~10^12, mas uma varredura por faixa é perfeitamente viável. Sem teto, a
+ * primeira conta comprometida vira um raspador do cadastro nacional financiado
+ * pelo contrato do escritório. O teto é por TENANT, não por usuário: quem varre
+ * cria usuários.
+ *
+ * **Cache** — a mesma tela consultada duas vezes em cinco minutos não pode
+ * gastar duas requisições de um contrato pago. E o cache é só de SUCESSO:
+ * cachear uma indisponibilidade de um minuto a deixaria colada no CNPJ pelo
+ * resto do TTL, e o operador veria "provedor fora do ar" com o provedor no ar.
+ *
+ * **Disjuntor** — mesma política do motor fiscal (três falhas seguidas, espera
+ * que dobra), mas em memória de processo, e é uma escolha, não um esquecimento:
+ * a consulta de CNPJ é interativa. Alguém está olhando a tela. Persistir o
+ * estado faria uma queda de dez minutos do provedor manter a tela recusando
+ * depois que ele voltou, e o operador não tem como saber que a recusa é nossa.
+ */
+/** Teto de consultas por tenant na janela. */
+exports.LOOKUP_QUOTA_LIMIT = 120;
+exports.LOOKUP_QUOTA_WINDOW_MS = 60 * 60_000;
+/** Quanto tempo um retrato bem-sucedido responde sem tocar a rede. */
+exports.LOOKUP_CACHE_TTL_MS = 15 * 60_000;
+/** Falhas seguidas que abrem o disjuntor — mesma régua do motor fiscal. */
+exports.LOOKUP_CIRCUIT_THRESHOLD = 3;
+exports.LOOKUP_CIRCUIT_OPEN_MS = 2 * 60_000;
+/**
+ * Estado por (processo, provedor). Um `Map` de módulo, e não um campo de
+ * instância: o serviço é chamado por função, sem objeto de longa vida onde
+ * pendurar isso.
+ */
+const circuits = new Map();
+/** Só para os testes: um disjuntor herdado entre casos esconderia o defeito. */
+function resetLookupCircuits() {
+    circuits.clear();
+}
+function circuitAllows(provider, now) {
+    const c = circuits.get(provider);
+    return !c || c.openUntil <= now;
+}
+function circuitRecord(provider, ok, now) {
+    if (ok) {
+        circuits.delete(provider);
+        return;
+    }
+    const c = circuits.get(provider) ?? { failures: 0, openUntil: 0 };
+    c.failures += 1;
+    if (c.failures >= exports.LOOKUP_CIRCUIT_THRESHOLD) {
+        // O expoente conta as falhas ALÉM do limite, como no motor fiscal: sem
+        // isso a terceira falha já pediria a espera de uma décima segunda.
+        const excedente = Math.min(c.failures - exports.LOOKUP_CIRCUIT_THRESHOLD, 4);
+        c.openUntil = now + exports.LOOKUP_CIRCUIT_OPEN_MS * 2 ** excedente;
+    }
+    circuits.set(provider, c);
+}
+/**
+ * Falhas que contam contra o PROVEDOR.
+ *
+ * Um CNPJ que não existe é resposta correta de um provedor saudável — contá-la
+ * abriria o disjuntor para o escritório inteiro porque alguém digitou errado
+ * três vezes. `invalid_document` sequer chega à rede.
+ */
+function countsAgainstProvider(reason) {
+    return reason === 'provider_unavailable' || reason === 'unexpected_payload';
+}
+async function quotaUsed(tx, since) {
+    const [row] = await tx `
+    SELECT count(*)::text AS n FROM client_registry_lookup
+     WHERE created_at >= ${since}
+  `;
+    return Number(row?.n ?? '0');
+}
+async function cached(tx, documento, provider, since) {
+    const [row] = await tx `
+    SELECT payload FROM client_registry_lookup
+     WHERE document_digits = ${documento} AND provider = ${provider}
+       AND outcome = 'ok' AND created_at >= ${since}
+     ORDER BY created_at DESC
+     LIMIT 1
+  `;
+    return row?.payload ?? null;
+}
+async function recordLookup(tx, input) {
+    await tx `
+    INSERT INTO client_registry_lookup (
+      id, tenant_id, document_digits, provider, outcome, failure_reason, payload, requested_by
+    ) VALUES (
+      ${(0, shared_1.uuidv7)()}, ${input.tenantId}, ${input.documento}, ${input.provider},
+      ${input.outcome}, ${input.reason ?? null},
+      ${input.payload ? tx.json(input.payload) : null}, ${input.actorId}
+    )
+  `;
+}
+function montar(record, provider, current, served) {
+    const ibge = (0, ibge_js_1.resolveMunicipality)(record.address.municipality ?? '', record.address.uf);
+    return {
+        status: 'ok',
+        provider: provider.name,
+        official: provider.official,
+        record,
+        ibge,
+        proposals: (0, lookup_js_1.buildProposals)(record, current, ibge),
+        served,
+    };
+}
+/**
+ * Consulta o CNPJ com cota, cache, disjuntor e trilha — e NÃO grava cadastro.
+ *
+ * O que ela devolve são propostas. Aplicá-las é outro ato, com outra assinatura
+ * e outra permissão: quem pode consultar não necessariamente pode alterar o
+ * cadastro de um cliente.
+ */
+async function lookupCompanyRegistry(tx, provider, req) {
+    const agora = req.now ?? new Date();
+    const ms = agora.getTime();
+    const documento = (0, provider_js_1.cnpjDigits)(req.cnpj);
+    const current = req.current ?? {};
+    const recusar = async (reason, opts = { registra: true }) => {
+        if (opts.registra) {
+            await recordLookup(tx, {
+                tenantId: req.tenantId,
+                documento,
+                provider: provider.name,
+                outcome: 'failed',
+                reason,
+                actorId: req.actorId,
+            });
+        }
+        await (0, audit_js_1.appendAudit)(tx, {
+            actorId: req.actorId,
+            action: 'cnpj_lookup_failed',
+            resourceType: 'client_registry_lookup',
+            resourceId: null,
+            // O documento inteiro NÃO entra na trilha: ele identifica uma empresa, e
+            // a trilha é lida por gente que não precisa saber por quem se perguntou.
+            // O sufixo basta para casar dois eventos da mesma consulta.
+            metadata: { provider: provider.name, reason, documentTail: documento.slice(-6) },
+        });
+        return {
+            status: 'failed',
+            provider: provider.name,
+            official: provider.official,
+            reason,
+            proposals: [],
+            served: 'network',
+        };
+    };
+    // Documento inválido nem chega à contagem: reprovar aqui não gasta cota nem
+    // toca o provedor, e um dígito errado não pode consumir o orçamento de quem
+    // digitou certo depois.
+    if (!(0, provider_js_1.isValidCnpj)(documento))
+        return recusar('invalid_document', { registra: false });
+    const usadas = await quotaUsed(tx, new Date(ms - exports.LOOKUP_QUOTA_WINDOW_MS));
+    if (usadas >= exports.LOOKUP_QUOTA_LIMIT)
+        return recusar('quota_exceeded', { registra: false });
+    const doCache = await cached(tx, documento, provider.name, new Date(ms - exports.LOOKUP_CACHE_TTL_MS));
+    if (doCache) {
+        await (0, audit_js_1.appendAudit)(tx, {
+            actorId: req.actorId,
+            action: 'cnpj_lookup_success',
+            resourceType: 'client_registry_lookup',
+            resourceId: null,
+            metadata: { provider: provider.name, served: 'cache', documentTail: documento.slice(-6) },
+        });
+        return montar(doCache, provider, current, 'cache');
+    }
+    if (!circuitAllows(provider.name, ms))
+        return recusar('circuit_open', { registra: false });
+    await (0, audit_js_1.appendAudit)(tx, {
+        actorId: req.actorId,
+        action: 'cnpj_lookup_requested',
+        resourceType: 'client_registry_lookup',
+        resourceId: null,
+        metadata: { provider: provider.name, documentTail: documento.slice(-6) },
+    });
+    let resultado;
+    try {
+        resultado = await provider.lookup(documento);
+    }
+    catch {
+        // Nenhuma exceção de provedor atravessa com a sua mensagem: um cliente HTTP
+        // cita a URL, e URL de provedor pode carregar credencial no query string.
+        circuitRecord(provider.name, false, ms);
+        return recusar('provider_unavailable');
+    }
+    if (resultado.status === 'failed') {
+        if (countsAgainstProvider(resultado.reason))
+            circuitRecord(provider.name, false, ms);
+        return recusar(resultado.reason);
+    }
+    circuitRecord(provider.name, true, ms);
+    await recordLookup(tx, {
+        tenantId: req.tenantId,
+        documento,
+        provider: provider.name,
+        outcome: 'ok',
+        payload: resultado.record,
+        actorId: req.actorId,
+    });
+    await (0, audit_js_1.appendAudit)(tx, {
+        actorId: req.actorId,
+        action: 'cnpj_lookup_success',
+        resourceType: 'client_registry_lookup',
+        resourceId: null,
+        metadata: {
+            provider: provider.name,
+            official: provider.official,
+            served: 'network',
+            registrationStatus: resultado.record.registrationStatus,
+            documentTail: documento.slice(-6),
+        },
+    });
+    return montar(resultado.record, provider, current, 'network');
+}
+//# sourceMappingURL=service.js.map

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

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

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

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYNTHETIC_CNPJ = void 0;
+exports.syntheticCompanyRegistry = syntheticCompanyRegistry;
+const provider_js_1 = require("./provider.js");
+/**
+ * Um provedor de mentira, para provar o produto sem contrato.
+ *
+ * ## Por que ele é `official: false`, e por que isso importa
+ *
+ * Todo retrato que ele devolve entra no banco carimbado como NÃO oficial. Sem
+ * esse carimbo, um dado sintético usado num ambiente de demonstração ficaria
+ * indistinguível de um dado da Receita — e a etiqueta de proveniência, que
+ * existe justamente para dizer o quanto se confia num campo, viraria decoração.
+ *
+ * ## Os cenários vivem no número
+ *
+ * Cada CNPJ da tabela abaixo É um caso de teste: empresa baixada, sem nome
+ * fantasia, sem e-mail, Simples que a fonte não informou, município que o IBGE
+ * não conhece. Espalhar isso por mocks locais faria cada teste inventar a sua
+ * própria versão de "empresa inapta" — e duas versões divergentes de um mesmo
+ * conceito é como um bug passa entre elas.
+ */
+const BASE = {
+    cnpj: '',
+    legalName: 'EMPRESA SINTETICA LTDA',
+    tradeName: 'SINTETICA',
+    registrationStatus: 'ATIVA',
+    openedOn: '2015-03-10',
+    legalNature: '206-2 - Sociedade Empresária Limitada',
+    size: 'ME',
+    primaryActivity: { code: '4712100', description: 'Comércio varejista de mercadorias em geral' },
+    secondaryActivities: [],
+    address: {
+        street: 'Rua das Provas',
+        number: '100',
+        complement: null,
+        district: 'Setor Central',
+        zipCode: '74000-000',
+        municipality: 'Goiânia',
+        uf: 'GO',
+    },
+    phone: '(62) 3000-0000',
+    email: 'contato@sintetica.example',
+    shareCapital: 50000,
+    simplesOptant: true,
+    meiOptant: false,
+};
+/** Cenários felizes: o CNPJ escolhe qual retrato volta. */
+const RETRATOS = {
+    // Ativa, completa, optante do Simples — o caso comum.
+    '11222333000181': {},
+    // Gêmeas da anterior, e existem por uma razão de teste: o cache é por
+    // (tenant, documento), então um caso que precisa MESMO tocar a rede não pode
+    // reusar um CNPJ que outro caso já consultou.
+    '30000000000152': { tradeName: 'SINTETICA II' },
+    '30000000000233': { tradeName: 'SINTETICA III' },
+    // Sem nome fantasia: a tela não pode mostrar "undefined" nem cair para a
+    // razão social sem dizer que caiu.
+    '11444777000161': { tradeName: null, legalName: 'COMERCIO SEM FANTASIA LTDA' },
+    // Sem e-mail e sem telefone: os dois campos que o escritório mais preenche à
+    // mão, e que a fonte oficial mais frequentemente não tem.
+    '19131243000197': { email: null, phone: null },
+    // Baixada — não é erro de consulta. A empresa existe e está encerrada, e o
+    // cadastro não pode tratar isso como "não encontrado".
+    '34028316000103': { registrationStatus: 'BAIXADA', tradeName: 'ENCERRADA' },
+    // Inapta: opera, mas com pendência. Distinta de baixada.
+    '33000167000101': { registrationStatus: 'INAPTA' },
+    // Vários CNAEs secundários: a tela precisa caber mais de um.
+    '60746948000112': {
+        secondaryActivities: [
+            { code: '4711302', description: 'Comércio varejista de mercadorias em geral' },
+            { code: '5620104', description: 'Fornecimento de alimentos preparados' },
+            { code: '8299799', description: 'Outras atividades de serviços prestados' },
+        ],
+    },
+    // MEI. `simplesOptant` também é true: todo MEI é do Simples, e uma fonte que
+    // dissesse MEI sem dizer Simples estaria incompleta, não negando.
+    '45283163000167': { meiOptant: true, simplesOptant: true, size: 'MEI' },
+    // NÃO optante do Simples. Isto é a fonte DIZENDO "não" — e continua não
+    // dizendo nada sobre Real ou Presumido. Ver `NON_SIMPLES_TAX_REGIME_NOT_INFERRED`.
+    '47960950000121': { simplesOptant: false, size: 'DEMAIS' },
+    // A fonte SILENCIOU sobre o regime. `null` não é `false`: aqui o produto tem
+    // de dizer "não informado", nunca "não é do Simples".
+    '07526557000100': { simplesOptant: null, meiOptant: null },
+    // Município que o IBGE não resolve pelo nome que a fonte usou. O código não
+    // pode ser adivinhado — a tela pergunta.
+    '02558157000162': {
+        address: { ...BASE.address, municipality: 'Vila Que Nao Existe', uf: 'GO' },
+    },
+    // Município ambíguo sem UF confiável: "Bom Jesus" existe em cinco estados.
+    '61695227000193': {
+        address: { ...BASE.address, municipality: 'Bom Jesus', uf: null },
+    },
+};
+/** Cenários de falha: o CNPJ escolhe qual defeito o provedor apresenta. */
+const FALHAS = {
+    '00000000000191': 'not_found',
+    '15436940000103': 'rate_limited',
+    '92660406000119': 'provider_unavailable',
+    '76535764000143': 'timeout',
+    '05570714000159': 'garbage',
+};
+function syntheticCompanyRegistry(options = {}) {
+    return {
+        name: 'synthetic',
+        official: false,
+        async lookup(input) {
+            const cnpj = (0, provider_js_1.cnpjDigits)(input);
+            const source = 'synthetic';
+            const recusa = (reason) => ({
+                status: 'failed',
+                reason,
+                source,
+            });
+            options.onCall?.(cnpj);
+            if (options.force)
+                return recusa(options.force);
+            if (!(0, provider_js_1.isValidCnpj)(cnpj))
+                return recusa('invalid_document');
+            const falha = FALHAS[cnpj];
+            if (falha === 'timeout') {
+                // Uma exceção CRUA, como a rede produz. O serviço tem de classificá-la
+                // sozinho: um provedor real não devolve `{status:'failed'}` educado
+                // quando o socket morre.
+                throw new Error('ETIMEDOUT synthetic://registry');
+            }
+            if (falha === 'garbage')
+                return recusa('unexpected_payload');
+            if (falha)
+                return recusa(falha);
+            const patch = RETRATOS[cnpj];
+            if (!patch)
+                return recusa('not_found');
+            return {
+                status: 'ok',
+                record: { ...BASE, ...patch, cnpj },
+                source,
+                fetchedAt: new Date().toISOString(),
+            };
+        },
+    };
+}
+/** Os CNPJs sintéticos, nomeados — para o teste citar o caso, não o número. */
+exports.SYNTHETIC_CNPJ = {
+    ativaCompleta: '11222333000181',
+    ativaSemCache: '30000000000152',
+    ativaSemCache2: '30000000000233',
+    semNomeFantasia: '11444777000161',
+    semContato: '19131243000197',
+    baixada: '34028316000103',
+    inapta: '33000167000101',
+    variosCnae: '60746948000112',
+    mei: '45283163000167',
+    naoOptanteSimples: '47960950000121',
+    regimeNaoInformado: '07526557000100',
+    municipioDesconhecido: '02558157000162',
+    municipioAmbiguo: '61695227000193',
+    naoEncontrada: '00000000000191',
+    limiteExcedido: '15436940000103',
+    provedorForaDoAr: '92660406000119',
+    tempoEsgotado: '76535764000143',
+    respostaIlegivel: '05570714000159',
+};
+//# sourceMappingURL=synthetic.js.map

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

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