@useinvio/nfse-sdk 3.0.0 → 3.2.0

package/dist/mcpServer.js

@@ -0,0 +1,159 @@
+/**
+ * Model Context Protocol server for the NFS-e Nacional, over stdio.
+ *
+ * A tools-only MCP server needs nothing beyond JSON-RPC 2.0 over newline-delimited
+ * stdin/stdout, so this module has no dependencies besides the SDK itself.
+ * Run it with `npx -y @useinvio/nfse-mcp` (or `npx -y -p @useinvio/nfse-sdk nfse-mcp`).
+ *
+ * Configuration comes from the host environment, never from the model:
+ *   NFSE_CERT_PATH / NFSE_CERT_BASE64 + NFSE_CERT_PASSWORD / NFSE_CERT_PASSWORD_FILE
+ *   NFSE_AMBIENTE=restrita|producao      (default: restrita)
+ *   NFSE_MCP_ALLOW_WRITE=1               (enables prepare/confirm emission and cancellation)
+ *   NFSE_MCP_MOCK=1                      (in-process mock SEFIN and a test certificate; no real calls)
+ */
+import { createInterface } from 'node:readline';
+import { createNfseAgentToolkit } from './agent.js';
+import { NfseCertificate } from './certificate.js';
+export const NFSE_MCP_ENV = {
+    ambiente: 'NFSE_AMBIENTE',
+    allowWrite: 'NFSE_MCP_ALLOW_WRITE',
+    mock: 'NFSE_MCP_MOCK',
+};
+const SUPPORTED_PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05'];
+const SERVER_INFO = { name: 'nfse-nacional', title: 'NFS-e Nacional (SEFIN)', version: '0.1.0' };
+const INSTRUCTIONS = [
+    'Ferramentas para a NFS-e Nacional (SEFIN). O ambiente e o certificado sao definidos pelo host.',
+    'Antes de emitir, use validate_dps ate valid=true. Nao invente codigos fiscais (cTribNac, regime, tributacao): pergunte ao usuario.',
+    'Emissao e cancelamento tem duas etapas: prepare_* devolve um resumo; mostre-o e so chame confirm_* apos aprovacao explicita do usuario.',
+    'Depois de uma rejeicao, use explain_rejection com os codigos para explicar a regra oficial ao usuario.',
+    'Depois de timeout na emissao, nunca prepare uma nova DPS: repita confirm_nfse_emission ou use recover_nfse_by_dps.',
+].join('\n');
+function toolDescriptor(tool, protocolVersion) {
+    const modern = protocolVersion >= '2025-06-18';
+    return {
+        name: tool.name,
+        ...(modern ? { title: tool.title } : {}),
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        ...(modern ? { outputSchema: tool.outputSchema } : {}),
+        annotations: { title: tool.title, ...tool.annotations },
+    };
+}
+/**
+ * Transport-independent MCP server. `handle` takes one parsed JSON-RPC message
+ * and returns the response, or `undefined` for notifications.
+ */
+export function createNfseMcpServer(options = {}) {
+    const { tools } = createNfseAgentToolkit({ allowWrite: options.allowWrite });
+    const context = { pfx: options.certificate, ambiente: options.ambiente ?? 'restrita' };
+    let protocolVersion = SUPPORTED_PROTOCOL_VERSIONS[0];
+    async function callTool(params) {
+        const tool = tools.find((t) => t.name === params?.name);
+        if (!tool) {
+            return { content: [{ type: 'text', text: `Ferramenta desconhecida: ${String(params?.name)}` }], isError: true };
+        }
+        try {
+            const output = await tool.run(params?.arguments ?? {}, context);
+            const failed = output?.ok === false;
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                ...(protocolVersion >= '2025-06-18' ? { structuredContent: output } : {}),
+                ...(failed ? { isError: true } : {}),
+            };
+        }
+        catch (error) {
+            options.log?.(`tool ${tool.name} failed: ${error instanceof Error ? error.stack ?? error.message : String(error)}`);
+            return {
+                content: [{ type: 'text', text: `Falha de infraestrutura em ${tool.name}: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    }
+    async function handle(message) {
+        const isRequest = message.id !== undefined && message.id !== null;
+        const reply = (result) => ({ jsonrpc: '2.0', id: message.id ?? null, result });
+        const fail = (code, text) => ({ jsonrpc: '2.0', id: message.id ?? null, error: { code, message: text } });
+        switch (message.method) {
+            case 'initialize': {
+                const requested = String(message.params?.protocolVersion ?? '');
+                protocolVersion = SUPPORTED_PROTOCOL_VERSIONS.includes(requested) ? requested : SUPPORTED_PROTOCOL_VERSIONS[0];
+                return reply({
+                    protocolVersion,
+                    capabilities: { tools: { listChanged: false } },
+                    serverInfo: SERVER_INFO,
+                    instructions: INSTRUCTIONS,
+                });
+            }
+            case 'ping':
+                return reply({});
+            case 'tools/list':
+                return reply({ tools: tools.map((tool) => toolDescriptor(tool, protocolVersion)) });
+            case 'tools/call':
+                return reply(await callTool(message.params));
+            default:
+                if (!isRequest)
+                    return undefined; // notifications/initialized, notifications/cancelled, ...
+                return fail(-32601, `Method not found: ${message.method}`);
+        }
+    }
+    return { handle, tools, context };
+}
+function truthy(value) {
+    return ['1', 'true', 'yes', 'on'].includes(String(value ?? '').trim().toLowerCase());
+}
+/** Reads server options from environment variables; see the module comment. */
+export async function nfseMcpOptionsFromEnv(env = process.env) {
+    const mock = truthy(env[NFSE_MCP_ENV.mock]);
+    const ambiente = (env[NFSE_MCP_ENV.ambiente] ?? 'restrita').trim().toLowerCase();
+    if (ambiente !== 'restrita' && ambiente !== 'producao') {
+        throw new Error(`${NFSE_MCP_ENV.ambiente} deve ser "restrita" ou "producao" (recebido "${ambiente}").`);
+    }
+    if (mock && ambiente === 'producao')
+        throw new Error(`${NFSE_MCP_ENV.mock}=1 nao pode ser usado com ${NFSE_MCP_ENV.ambiente}=producao.`);
+    const hasCertificate = Boolean(env.NFSE_CERT_PATH || env.NFSE_CERT_BASE64);
+    let certificate = hasCertificate ? NfseCertificate.fromEnv(env) : undefined;
+    if (mock) {
+        const { createTestCertificate, installMockSefin } = await import('./testing.js');
+        installMockSefin();
+        certificate ??= createTestCertificate().certificate;
+    }
+    return { certificate, ambiente, allowWrite: truthy(env[NFSE_MCP_ENV.allowWrite]), mock };
+}
+/** Runs the server on stdin/stdout until stdin closes. Logs go to stderr only. */
+export async function runNfseMcpStdio(options) {
+    const log = (message) => process.stderr.write(`[nfse-mcp] ${message}\n`);
+    const resolved = options ?? await nfseMcpOptionsFromEnv();
+    const server = createNfseMcpServer({ ...resolved, log });
+    const certificate = resolved.certificate instanceof NfseCertificate ? resolved.certificate : undefined;
+    log(`ambiente=${resolved.ambiente ?? 'restrita'} escrita=${resolved.allowWrite ? 'habilitada' : 'desabilitada'} `
+        + `certificado=${certificate ? `${certificate.cnpj ?? certificate.cpf ?? 'sem documento'} (vence ${certificate.notAfter.toISOString().slice(0, 10)})` : resolved.certificate ? 'legado' : 'ausente'}`
+        + `${resolved.mock ? ' mock=SEFIN simulada' : ''}`);
+    const write = (response) => process.stdout.write(`${JSON.stringify(response)}\n`);
+    const lines = createInterface({ input: process.stdin, crlfDelay: Infinity });
+    const inflight = new Set();
+    for await (const line of lines) {
+        if (!line.trim())
+            continue;
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            write({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } });
+            continue;
+        }
+        for (const item of Array.isArray(message) ? message : [message]) {
+            if (!item || typeof item.method !== 'string')
+                continue; // responses from the client are not expected
+            const task = server.handle(item).then((response) => { if (response)
+                write(response); }, (error) => {
+                log(`request failed: ${error instanceof Error ? error.message : String(error)}`);
+                if (item.id !== undefined && item.id !== null)
+                    write({ jsonrpc: '2.0', id: item.id, error: { code: -32603, message: 'Internal error' } });
+            }).finally(() => inflight.delete(task));
+            inflight.add(task);
+        }
+    }
+    await Promise.all(inflight);
+}
+//# sourceMappingURL=mcpServer.js.map

package/dist/mcpServer.js.map

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

package/dist/nfseXml.d.ts

@@ -0,0 +1,48 @@
+import type { Ambiente } from './config.js';
+export interface NfsePessoaResumo {
+    CNPJ?: string;
+    CPF?: string;
+    NIF?: string;
+    IM?: string;
+    xNome?: string;
+}
+/** Typed view of the authorized NFS-e fields most integrations need. Values are kept as XML strings. */
+export interface NfseResumo {
+    chaveAcesso: string;
+    /** Numero da NFS-e. */
+    nNFSe: string;
+    /** Numero do documento fiscal no ADN. */
+    nDFSe: string;
+    /** Situacao (TStat), ex.: "100" = NFS-e gerada. */
+    cStat: string;
+    /** Data/hora de processamento (UTC). */
+    dhProc: string;
+    ambiente: Ambiente;
+    xLocEmi: string;
+    xLocPrestacao: string;
+    cLocIncid?: string;
+    xLocIncid?: string;
+    xTribNac: string;
+    emitente: NfsePessoaResumo;
+    tomador?: NfsePessoaResumo;
+    dps: {
+        id: string;
+        serie: string;
+        nDPS: string;
+        dhEmi: string;
+        dCompet: string;
+    };
+    valores: {
+        vServ?: string;
+        vBC?: string;
+        pAliqAplic?: string;
+        vISSQN?: string;
+        vTotalRet?: string;
+        vLiq: string;
+    };
+}
+/**
+ * Reads an authorized NFS-e XML (layout v1.01) into a typed summary.
+ * The XML is parsed without DTDs, external entities or network access.
+ */
+export declare function lerNfse(nfseXml: string): NfseResumo;

package/dist/nfseXml.js

@@ -0,0 +1,86 @@
+import { directChildren, parseNfseXml } from './xmlInspection.js';
+function child(element, ...path) {
+    let current = element;
+    for (const name of path) {
+        if (!current)
+            return undefined;
+        current = directChildren(current, name)[0];
+    }
+    return current;
+}
+function text(element, ...path) {
+    const value = child(element, ...path)?.textContent ?? undefined;
+    return value === '' ? undefined : value;
+}
+function required(element, ...path) {
+    const value = text(element, ...path);
+    if (value === undefined)
+        throw new Error(`XML da NFS-e sem o campo obrigatorio ${path.join('/')}.`);
+    return value;
+}
+function pessoa(element) {
+    if (!element)
+        return undefined;
+    const result = {};
+    for (const field of ['CNPJ', 'CPF', 'NIF', 'IM', 'xNome']) {
+        const value = text(element, field);
+        if (value !== undefined)
+            result[field] = value;
+    }
+    return result;
+}
+/**
+ * Reads an authorized NFS-e XML (layout v1.01) into a typed summary.
+ * The XML is parsed without DTDs, external entities or network access.
+ */
+export function lerNfse(nfseXml) {
+    const root = parseNfseXml(nfseXml, 'NFSe');
+    const inf = child(root, 'infNFSe');
+    const id = inf?.getAttribute('Id') ?? '';
+    if (!/^NFS\d{50}$/.test(id))
+        throw new Error('XML da NFS-e sem Id valido em <infNFSe>.');
+    const infDps = child(inf, 'DPS', 'infDPS');
+    const tpAmb = required(infDps, 'tpAmb');
+    const resumo = {
+        chaveAcesso: id.slice(3),
+        nNFSe: required(inf, 'nNFSe'),
+        nDFSe: required(inf, 'nDFSe'),
+        cStat: required(inf, 'cStat'),
+        dhProc: required(inf, 'dhProc'),
+        ambiente: tpAmb === '1' ? 'producao' : 'restrita',
+        xLocEmi: required(inf, 'xLocEmi'),
+        xLocPrestacao: required(inf, 'xLocPrestacao'),
+        xTribNac: required(inf, 'xTribNac'),
+        emitente: pessoa(child(inf, 'emit')),
+        dps: {
+            id: infDps?.getAttribute('Id') ?? '',
+            serie: required(infDps, 'serie'),
+            nDPS: required(infDps, 'nDPS'),
+            dhEmi: required(infDps, 'dhEmi'),
+            dCompet: required(infDps, 'dCompet'),
+        },
+        valores: {
+            vServ: text(infDps, 'valores', 'vServPrest', 'vServ'),
+            vBC: text(inf, 'valores', 'vBC'),
+            pAliqAplic: text(inf, 'valores', 'pAliqAplic'),
+            vISSQN: text(inf, 'valores', 'vISSQN'),
+            vTotalRet: text(inf, 'valores', 'vTotalRet'),
+            vLiq: required(inf, 'valores', 'vLiq'),
+        },
+    };
+    const cLocIncid = text(inf, 'cLocIncid');
+    const xLocIncid = text(inf, 'xLocIncid');
+    const tomador = pessoa(child(infDps, 'toma'));
+    if (cLocIncid)
+        resumo.cLocIncid = cLocIncid;
+    if (xLocIncid)
+        resumo.xLocIncid = xLocIncid;
+    if (tomador)
+        resumo.tomador = tomador;
+    for (const key of Object.keys(resumo.valores)) {
+        if (resumo.valores[key] === undefined)
+            delete resumo.valores[key];
+    }
+    return resumo;
+}
+//# sourceMappingURL=nfseXml.js.map

package/dist/nfseXml.js.map

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

package/dist/rejeicoes.d.ts

@@ -0,0 +1,50 @@
+import type { SefinErro } from './sefinClient.js';
+export { REJEICOES_FONTES } from './rejeicoesCatalog.js';
+/** One business rule from the official SEFIN/ADN annexes. Text is kept verbatim. */
+export interface RejeicaoOficial {
+    /** Error code, e.g. "E0014". */
+    codigo: string;
+    /** Official error message returned by SEFIN. */
+    mensagem: string;
+    /** Business rule that triggers the rejection. */
+    regra: string;
+    /** XML path of the field the rule checks, when the annex names one. */
+    campo?: string;
+    /** 1 = layout consistency, 2 = national rules, 3 = municipal rules. */
+    nivel?: number;
+    /** Index into {@link REJEICOES_FONTES}. */
+    fonte: number;
+    /** Annex sheet the rule comes from. */
+    planilha: string;
+}
+export interface ExplicacaoRejeicao {
+    codigo: string;
+    /** False when the code is not in the bundled catalog (e.g. a newer rule or an SDK-side code). */
+    conhecida: boolean;
+    /** What SEFIN said, when explaining a received error. */
+    descricaoRecebida?: string;
+    complemento?: string;
+    mensagemOficial?: string;
+    regra?: string;
+    campo?: string;
+    nivel?: number;
+    /** Where to look: official annex and, when known, the SDK documentation. */
+    fonte?: {
+        documento: string;
+        url: string;
+    };
+    /** Short, code-independent hint about what usually fixes this class of rule. */
+    dica?: string;
+}
+/** Looks up an official rule by code ("E0014", "e0014" or "0014"). */
+export declare function buscarRejeicao(codigo: string): RejeicaoOficial | undefined;
+/**
+ * Explains a SEFIN error code or a received `SefinErro` with the official
+ * message, rule and field from the published annexes. Never invents a cause:
+ * unknown codes come back with `conhecida: false`.
+ */
+export declare function explicarRejeicao(erro: string | SefinErro): ExplicacaoRejeicao;
+/** Explains every error of a rejection (`EmitirNotaError.erros`, `RegistrarEventoError.erros`). */
+export declare function explicarErros(erros: readonly SefinErro[]): ExplicacaoRejeicao[];
+/** All bundled official rules, sorted by code. */
+export declare function listarRejeicoes(): readonly RejeicaoOficial[];

package/dist/rejeicoes.js

@@ -0,0 +1,62 @@
+import { REJEICOES_FONTES, REJEICOES_OFICIAIS } from './rejeicoesCatalog.js';
+export { REJEICOES_FONTES } from './rejeicoesCatalog.js';
+const BY_CODE = new Map(REJEICOES_OFICIAIS.map((entry) => [entry.codigo, entry]));
+const NIVEL_DICA = {
+    1: 'Regra de leiaute: corrija o formato ou a consistência do campo indicado na DPS ou no evento.',
+    2: 'Regra nacional: confira o dado com o cadastro e a situação do contribuinte no Sistema Nacional NFS-e.',
+    3: 'Regra municipal: confira os parâmetros do município (convênio, alíquota, regimes) com consultarConvenio/consultarAliquota.',
+};
+const SDK_CODES = {
+    INVALID_AUTHORIZATION_RESPONSE: 'A SEFIN respondeu 2xx sem XML autorizado válido. O resultado é incerto: use recuperarNfsePorDps antes de reenviar.',
+    INVALID_QUERY_RESPONSE: 'A consulta respondeu sem o XML esperado. Tente novamente; se persistir, registre o corpo da resposta.',
+    DESCONHECIDO: 'A SEFIN respondeu sem um código de erro reconhecível. Veja o corpo bruto da resposta.',
+};
+function normalizeCode(codigo) {
+    const trimmed = codigo.trim().toUpperCase();
+    return /^\d{4}$/.test(trimmed) ? `E${trimmed}` : trimmed;
+}
+/** Looks up an official rule by code ("E0014", "e0014" or "0014"). */
+export function buscarRejeicao(codigo) {
+    return BY_CODE.get(normalizeCode(codigo));
+}
+/**
+ * Explains a SEFIN error code or a received `SefinErro` with the official
+ * message, rule and field from the published annexes. Never invents a cause:
+ * unknown codes come back with `conhecida: false`.
+ */
+export function explicarRejeicao(erro) {
+    const received = typeof erro === 'string' ? undefined : erro;
+    const codigo = normalizeCode(typeof erro === 'string' ? erro : erro.Codigo);
+    const entry = BY_CODE.get(codigo);
+    const result = { codigo, conhecida: Boolean(entry) };
+    if (received?.Descricao)
+        result.descricaoRecebida = received.Descricao;
+    if (received?.Complemento)
+        result.complemento = received.Complemento;
+    if (entry) {
+        result.mensagemOficial = entry.mensagem;
+        if (entry.regra)
+            result.regra = entry.regra;
+        if (entry.campo)
+            result.campo = entry.campo;
+        if (entry.nivel)
+            result.nivel = entry.nivel;
+        result.fonte = { ...REJEICOES_FONTES[entry.fonte] };
+        const dica = entry.nivel ? NIVEL_DICA[entry.nivel] : undefined;
+        if (dica)
+            result.dica = dica;
+    }
+    else if (SDK_CODES[codigo]) {
+        result.dica = SDK_CODES[codigo];
+    }
+    return result;
+}
+/** Explains every error of a rejection (`EmitirNotaError.erros`, `RegistrarEventoError.erros`). */
+export function explicarErros(erros) {
+    return erros.map((erro) => explicarRejeicao(erro));
+}
+/** All bundled official rules, sorted by code. */
+export function listarRejeicoes() {
+    return REJEICOES_OFICIAIS;
+}
+//# sourceMappingURL=rejeicoes.js.map

package/dist/rejeicoes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rejeicoes.js","sourceRoot":"","sources":["../rejeicoes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAqCzD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAElF,MAAM,UAAU,GAA2B;IACzC,CAAC,EAAE,8FAA8F;IACjG,CAAC,EAAE,uGAAuG;IAC1G,CAAC,EAAE,4HAA4H;CAChI,CAAC;AAEF,MAAM,SAAS,GAA2B;IACxC,8BAA8B,EAAE,oHAAoH;IACpJ,sBAAsB,EAAE,uGAAuG;IAC/H,YAAY,EAAE,uFAAuF;CACtG,CAAC;AAEF,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AAC3D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,MAAM,GAAuB,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IACzE,IAAI,QAAQ,EAAE,SAAS;QAAE,MAAM,CAAC,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC;IACvE,IAAI,QAAQ,EAAE,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;IACrE,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC;QACxC,IAAI,KAAK,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC5C,IAAI,KAAK,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC5C,IAAI,KAAK,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC5C,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/D,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC/B,CAAC;SAAM,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,aAAa,CAAC,KAA2B;IACvD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,eAAe;IAC7B,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/rejeicoesCatalog.d.ts

@@ -0,0 +1,10 @@
+import type { RejeicaoOficial } from './rejeicoes.js';
+/** Official spreadsheets this catalog was generated from (gov.br/nfse, documentacao atual). */
+export declare const REJEICOES_FONTES: readonly [{
+    readonly documento: "Anexo I - Leiaute e Regras de Negocio DPS/NFS-e v1.01 (09/02/2026)";
+    readonly url: "https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/anexo_i-sefin_adn-dps_nfse-snnfse-v1-01-20260209.xlsx";
+}, {
+    readonly documento: "Anexo II - Leiaute e Regras de Negocio de Eventos v1.01 (22/01/2026)";
+    readonly url: "https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/anexo_ii-sefin_adn-pedregevt_evt-snnfse-v1-01-20260122.xlsx";
+}];
+export declare const REJEICOES_OFICIAIS: readonly RejeicaoOficial[];