@useinvio/nfse-sdk 1.0.2 → 1.0.3

package/README.md

@@ -439,6 +439,14 @@ const baseUrl = resolveSefinBaseUrl('restrita');
 
 ---
 
+## Observabilidade da SEFIN
+
+O SDK pode emitir métricas de latência das chamadas mTLS feitas contra a SEFIN, incluindo `p50Ms`, `p95Ms` e `p99Ms` por operação e ambiente. Essas métricas medem o round-trip externo da SEFIN, separado da latência total da sua API.
+
+Leia o guia completo em [docs/METRICS.md](./docs/METRICS.md).
+
+---
+
 ## Referência da API
 
 ### Funções principais
@@ -450,6 +458,8 @@ const baseUrl = resolveSefinBaseUrl('restrita');
 | `consultarNfse(chaveAcesso, pfx, ambiente?)` | Consulta uma NFS-e pela chave de acesso. |
 | `enviarEvento(xmlGzipB64, pfx, chaveAcesso, ambiente?)` | Envia evento fiscal (cancelamento, etc.). |
 | `buildDpsFromJson(nota)` | Monta o XML da DPS sem assinar nem enviar. |
+| `setSefinRequestObserver(observer)` | Registra um hook para observar latência/status das chamadas à SEFIN. |
+| `createSefinLatencyTracker(options?)` | Agrega amostras recentes e calcula `p50Ms`, `p95Ms` e `p99Ms`. |
 
 ### Certificado
 

package/dist/index.d.ts

@@ -6,8 +6,8 @@
  */
 export { SEFIN_BASE_URL, TP_AMB, DEFAULT_AMBIENTE, resolveSefinBaseUrl } from './config.js';
 export type { Ambiente } from './config.js';
-export { consultarNfse, enviarEvento, extrairErros } from './sefinClient.js';
-export type { SefinErro, SefinResposta } from './sefinClient.js';
+export { consultarNfse, createSefinLatencyTracker, enviarEvento, extrairErros, getSefinRequestObserver, setSefinRequestObserver, } from './sefinClient.js';
+export type { SefinErro, SefinLatencySeriesSnapshot, SefinLatencySnapshot, SefinLatencyTracker, SefinLatencyTrackerOptions, SefinOperation, SefinRequestMetric, SefinRequestObserver, SefinResposta, } from './sefinClient.js';
 export { buildDpsFromJson, buildDpsId } from './dpsJson.js';
 export type { BuiltDps, ComExt, DpsJsonInput, DpsJsonRequest, EventoServico, Intermediario, Obra, PrestadorProfile, ServicoProfile, Tomador, TotTrib, TribFed, TribMun, TribNac, Valores, } from './dpsJson.js';
 export { DpsFiscalValidationError, validateDpsJsonRequest } from './fiscalValidation.js';

package/dist/index.js

@@ -5,7 +5,7 @@
  * No database, no tenants, no business rules.
  */
 export { SEFIN_BASE_URL, TP_AMB, DEFAULT_AMBIENTE, resolveSefinBaseUrl } from './config.js';
-export { consultarNfse, enviarEvento, extrairErros } from './sefinClient.js';
+export { consultarNfse, createSefinLatencyTracker, enviarEvento, extrairErros, getSefinRequestObserver, setSefinRequestObserver, } from './sefinClient.js';
 export { buildDpsFromJson, buildDpsId } from './dpsJson.js';
 export { DpsFiscalValidationError, validateDpsJsonRequest } from './fiscalValidation.js';
 export { EmitirNotaError, emitirNfse } from './emissaoNota.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAG5F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB5D,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAG5F,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAa1B,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB5D,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/sefinClient.d.ts

@@ -10,6 +10,52 @@ export interface SefinResposta {
     /** Corpo bruto parseado (JSON) */
     body: any;
 }
+export type SefinOperation = 'transmitir_dps' | 'consultar_nfse' | 'enviar_evento';
+export interface SefinRequestMetric {
+    operation: SefinOperation;
+    ambiente?: Ambiente;
+    method: 'GET' | 'POST';
+    pathTemplate: string;
+    durationMs: number;
+    status?: number;
+    success: boolean;
+    errorName?: string;
+    errorMessage?: string;
+}
+export type SefinRequestObserver = (metric: SefinRequestMetric) => void;
+export interface SefinLatencyTrackerOptions {
+    /**
+     * Maximum number of recent latency samples kept for each operation/environment
+     * series. P99 is calculated over this rolling window.
+     */
+    maxSamplesPerSeries?: number;
+}
+export interface SefinLatencySeriesSnapshot {
+    operation: SefinOperation;
+    ambiente?: Ambiente;
+    count: number;
+    successCount: number;
+    errorCount: number;
+    sampleCount: number;
+    minMs: number;
+    maxMs: number;
+    avgMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+}
+export interface SefinLatencySnapshot {
+    generatedAt: string;
+    series: SefinLatencySeriesSnapshot[];
+}
+export interface SefinLatencyTracker {
+    observe(metric: SefinRequestMetric): void;
+    snapshot(): SefinLatencySnapshot;
+    reset(): void;
+}
+export declare function setSefinRequestObserver(observer: SefinRequestObserver | undefined): void;
+export declare function getSefinRequestObserver(): SefinRequestObserver | undefined;
+export declare function createSefinLatencyTracker(options?: SefinLatencyTrackerOptions): SefinLatencyTracker;
 /** Normaliza a lista de erros retornada pelo SEFIN em diferentes formatos. */
 export declare function extrairErros(body: any): SefinErro[];
 /** SefinNacional · POST /nfse — transporte baixo nivel de DPS ja compactada em GZip+Base64. */

package/dist/sefinClient.js

@@ -1,12 +1,94 @@
 import https from 'node:https';
+import { performance } from 'node:perf_hooks';
 import { resolveSefinBaseUrl } from './config.js';
 /** Evita que uma conexao travada com o SEFIN prenda um worker indefinidamente. */
 const SEFIN_REQUEST_TIMEOUT_MS = 60_000;
+let sefinRequestObserver;
+export function setSefinRequestObserver(observer) {
+    sefinRequestObserver = observer;
+}
+export function getSefinRequestObserver() {
+    return sefinRequestObserver;
+}
+function notifySefinRequestObserver(metric) {
+    try {
+        sefinRequestObserver?.(metric);
+    }
+    catch {
+        // Observability hooks must not change SDK transport behavior.
+    }
+}
+function percentile(sortedValues, quantile) {
+    if (!sortedValues.length)
+        return 0;
+    const index = Math.min(sortedValues.length - 1, Math.max(0, Math.ceil(sortedValues.length * quantile) - 1));
+    return sortedValues[index];
+}
+function trackerKey(metric) {
+    return `${metric.operation}:${metric.ambiente ?? 'default'}`;
+}
+export function createSefinLatencyTracker(options = {}) {
+    const maxSamplesPerSeries = Math.max(1, Math.floor(options.maxSamplesPerSeries ?? 1_000));
+    const series = new Map();
+    return {
+        observe(metric) {
+            const key = trackerKey(metric);
+            let bucket = series.get(key);
+            if (!bucket) {
+                bucket = {
+                    operation: metric.operation,
+                    ambiente: metric.ambiente,
+                    count: 0,
+                    successCount: 0,
+                    errorCount: 0,
+                    durations: [],
+                };
+                series.set(key, bucket);
+            }
+            bucket.count += 1;
+            if (metric.success)
+                bucket.successCount += 1;
+            else
+                bucket.errorCount += 1;
+            bucket.durations.push(metric.durationMs);
+            if (bucket.durations.length > maxSamplesPerSeries) {
+                bucket.durations.splice(0, bucket.durations.length - maxSamplesPerSeries);
+            }
+        },
+        snapshot() {
+            return {
+                generatedAt: new Date().toISOString(),
+                series: Array.from(series.values()).map((bucket) => {
+                    const sortedDurations = [...bucket.durations].sort((a, b) => a - b);
+                    const total = sortedDurations.reduce((sum, value) => sum + value, 0);
+                    return {
+                        operation: bucket.operation,
+                        ambiente: bucket.ambiente,
+                        count: bucket.count,
+                        successCount: bucket.successCount,
+                        errorCount: bucket.errorCount,
+                        sampleCount: sortedDurations.length,
+                        minMs: sortedDurations[0] ?? 0,
+                        maxMs: sortedDurations.at(-1) ?? 0,
+                        avgMs: sortedDurations.length ? total / sortedDurations.length : 0,
+                        p50Ms: percentile(sortedDurations, 0.50),
+                        p95Ms: percentile(sortedDurations, 0.95),
+                        p99Ms: percentile(sortedDurations, 0.99),
+                    };
+                }).sort((a, b) => (a.operation.localeCompare(b.operation) ||
+                    (a.ambiente ?? '').localeCompare(b.ambiente ?? ''))),
+            };
+        },
+        reset() {
+            series.clear();
+        },
+    };
+}
 /**
  * Requisição mTLS de baixo nível ao SefinNacional, retornando o corpo bruto (Buffer).
  * Usa key+cert PEM no handshake (o .pfx legado ICP-Brasil é rejeitado pelo TLS do Node).
  */
-function sefinRequest(opts, pfx, baseOverride) {
+function sefinRequest(opts, pfx, metricOpts, baseOverride) {
     const url = new URL(`${baseOverride ?? resolveSefinBaseUrl()}${opts.path}`);
     const payload = opts.jsonBody != null ? JSON.stringify(opts.jsonBody) : undefined;
     const headers = {
@@ -28,16 +110,49 @@ function sefinRequest(opts, pfx, baseOverride) {
         timeout: SEFIN_REQUEST_TIMEOUT_MS,
     };
     return new Promise((resolve, reject) => {
+        const startedAt = performance.now();
+        let metricSent = false;
+        const emitMetric = (metric) => {
+            if (metricSent)
+                return;
+            metricSent = true;
+            notifySefinRequestObserver({
+                ...metric,
+                durationMs: performance.now() - startedAt,
+            });
+        };
         const req = https.request(options, (res) => {
             const chunks = [];
             res.on('data', (c) => chunks.push(c));
-            res.on('end', () => resolve({
-                status: res.statusCode ?? 0,
-                contentType: String(res.headers['content-type'] ?? ''),
-                buffer: Buffer.concat(chunks),
-            }));
+            res.on('end', () => {
+                const status = res.statusCode ?? 0;
+                emitMetric({
+                    operation: metricOpts.operation,
+                    ambiente: metricOpts.ambiente,
+                    method: opts.method,
+                    pathTemplate: metricOpts.pathTemplate,
+                    status,
+                    success: status >= 200 && status < 300,
+                });
+                resolve({
+                    status,
+                    contentType: String(res.headers['content-type'] ?? ''),
+                    buffer: Buffer.concat(chunks),
+                });
+            });
+        });
+        req.on('error', (error) => {
+            emitMetric({
+                operation: metricOpts.operation,
+                ambiente: metricOpts.ambiente,
+                method: opts.method,
+                pathTemplate: metricOpts.pathTemplate,
+                success: false,
+                errorName: error.name,
+                errorMessage: error.message,
+            });
+            reject(error);
         });
-        req.on('error', reject);
         req.on('timeout', () => {
             req.destroy(new Error(`SEFIN request timed out after ${SEFIN_REQUEST_TIMEOUT_MS}ms`));
         });
@@ -104,12 +219,12 @@ export function extrairErros(body) {
 /** SefinNacional · POST /nfse — transporte baixo nivel de DPS ja compactada em GZip+Base64. */
 export async function transmitirDpsCompactada(dpsXmlGZipB64, pfx, ambiente) {
     const base = ambiente ? resolveSefinBaseUrl(ambiente) : undefined;
-    return parseJson(await sefinRequest({ method: 'POST', path: '/nfse', jsonBody: { dpsXmlGZipB64 } }, pfx, base));
+    return parseJson(await sefinRequest({ method: 'POST', path: '/nfse', jsonBody: { dpsXmlGZipB64 } }, pfx, { operation: 'transmitir_dps', ambiente, pathTemplate: '/nfse' }, base));
 }
 /** SefinNacional · GET /nfse/{chave} — consulta a NFS-e pela chave de acesso (50 dígitos). */
 export async function consultarNfse(chave, pfx, ambiente) {
     const base = ambiente ? resolveSefinBaseUrl(ambiente) : undefined;
-    return parseJson(await sefinRequest({ method: 'GET', path: `/nfse/${chave}` }, pfx, base));
+    return parseJson(await sefinRequest({ method: 'GET', path: `/nfse/${chave}` }, pfx, { operation: 'consultar_nfse', ambiente, pathTemplate: '/nfse/{chave}' }, base));
 }
 /** SefinNacional · POST /nfse/{chave}/eventos — registra evento fiscal da NFS-e. */
 export async function enviarEvento(pedRegXmlGZipB64, pfx, chaveAcesso, ambiente) {
@@ -118,6 +233,6 @@ export async function enviarEvento(pedRegXmlGZipB64, pfx, chaveAcesso, ambiente)
         method: 'POST',
         path: `/nfse/${chaveAcesso}/eventos`,
         jsonBody: { pedRegXmlGZipB64 },
-    }, pfx, base));
+    }, pfx, { operation: 'enviar_evento', ambiente, pathTemplate: '/nfse/{chave}/eventos' }, base));
 }
 //# sourceMappingURL=sefinClient.js.map

package/dist/sefinClient.js.map

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

package/docs/METRICS.md

@@ -0,0 +1,205 @@
+# Metricas da SEFIN
+
+O SDK pode medir a latencia das chamadas mTLS feitas contra a SEFIN Nacional. Essas metricas ajudam a responder perguntas como:
+
+- qual e o P99 de `POST /nfse` no ambiente restrito?
+- as consultas por chave estao ficando lentas?
+- quantas chamadas externas falharam no processo atual?
+- a lentidao vem da SEFIN ou da minha API?
+
+As metricas sao emitidas pelo SDK, mas nao sao enviadas para nenhum servico automaticamente. A aplicacao que usa o SDK decide se quer guardar em memoria, registrar em logs, exportar para Prometheus, enviar para Datadog/New Relic/Grafana, ou expor em um endpoint interno.
+
+## O que e medido
+
+Cada chamada externa feita pelo `sefinClient.ts` pode emitir um evento com:
+
+| Campo | Descricao |
+|---|---|
+| `operation` | Operacao logica do SDK. |
+| `ambiente` | `restrita` ou `producao`, quando informado. |
+| `method` | Metodo HTTP usado contra a SEFIN. |
+| `pathTemplate` | Caminho sem dados sensiveis, por exemplo `/nfse/{chave}`. |
+| `durationMs` | Tempo total do round-trip externo em milissegundos. |
+| `status` | Status HTTP retornado pela SEFIN, quando houve resposta. |
+| `success` | `true` para HTTP 2xx; `false` para HTTP nao 2xx, timeout ou erro de rede. |
+| `errorName` | Nome do erro local, quando a chamada falha antes de uma resposta HTTP. |
+| `errorMessage` | Mensagem do erro local, quando aplicavel. |
+
+Operacoes emitidas:
+
+| Operacao | Endpoint SEFIN |
+|---|---|
+| `transmitir_dps` | `POST /nfse` |
+| `consultar_nfse` | `GET /nfse/{chave}` |
+| `enviar_evento` | `POST /nfse/{chave}/eventos` |
+
+## O que nao e medido
+
+Essas metricas nao medem a latencia total da sua API. Elas medem apenas a dependencia externa SEFIN.
+
+Exemplo:
+
+```txt
+Cliente -> sua API:                 20ms
+sua API -> SEFIN -> sua API:      4200ms
+sua API -> banco/logs/outros:       80ms
+latencia total da sua API:        4300ms
+latencia SEFIN medida pelo SDK:   4200ms
+```
+
+Tambem nao ha persistencia automatica. O agregador em memoria zera quando o processo Node reinicia.
+
+## Uso basico
+
+Registre um observer uma vez na inicializacao da aplicacao, antes de fazer chamadas como `emitirNfse`, `consultarNfse` ou `enviarEvento`.
+
+```ts
+import {
+  createSefinLatencyTracker,
+  setSefinRequestObserver,
+} from '@useinvio/nfse-sdk';
+
+export const sefinLatency = createSefinLatencyTracker({
+  maxSamplesPerSeries: 1000,
+});
+
+setSefinRequestObserver((metric) => {
+  sefinLatency.observe(metric);
+});
+```
+
+Depois, leia o snapshot onde fizer sentido para sua aplicacao:
+
+```ts
+const snapshot = sefinLatency.snapshot();
+
+console.log(snapshot.series);
+```
+
+Exemplo de retorno:
+
+```ts
+{
+  generatedAt: '2026-07-09T12:00:00.000Z',
+  series: [
+    {
+      operation: 'transmitir_dps',
+      ambiente: 'restrita',
+      count: 120,
+      successCount: 118,
+      errorCount: 2,
+      sampleCount: 120,
+      minMs: 180,
+      maxMs: 8100,
+      avgMs: 940.2,
+      p50Ms: 430,
+      p95Ms: 2200,
+      p99Ms: 5100
+    }
+  ]
+}
+```
+
+## Como interpretar P99
+
+`p99Ms` significa que 99% das chamadas observadas naquela serie foram mais rapidas ou iguais a esse valor.
+
+Se `transmitir_dps` em `restrita` tem `p99Ms = 5100`, a leitura pratica e:
+
+```txt
+99% das transmissoes de DPS para a SEFIN restrita responderam em ate 5100ms.
+```
+
+Um `p99Ms` alto com `p50Ms` baixo indica cauda longa: a maioria das chamadas e rapida, mas uma pequena parte fica muito lenta. Em integracoes fiscais isso costuma aparecer por fila, instabilidade, timeout, validacao pesada ou oscilacao da dependencia externa.
+
+## Series
+
+O tracker agrega por:
+
+```txt
+operation + ambiente
+```
+
+Assim, `transmitir_dps` em `restrita` nao se mistura com `consultar_nfse` em `producao`.
+
+## Janela movel
+
+`maxSamplesPerSeries` controla quantas duracoes recentes ficam guardadas por serie.
+
+```ts
+const sefinLatency = createSefinLatencyTracker({
+  maxSamplesPerSeries: 5000,
+});
+```
+
+Com `5000`, cada combinacao `operation + ambiente` calcula os percentis usando no maximo as ultimas 5000 amostras daquela serie. O contador `count` continua acumulando o total observado desde o ultimo `reset`, mas `p50Ms`, `p95Ms`, `p99Ms`, `minMs`, `maxMs` e `avgMs` usam a janela de amostras mantida em memoria.
+
+## Logs estruturados
+
+Voce pode registrar cada chamada em log e tambem alimentar o tracker:
+
+```ts
+setSefinRequestObserver((metric) => {
+  sefinLatency.observe(metric);
+
+  logger.info({
+    event: 'sefin_request',
+    operation: metric.operation,
+    ambiente: metric.ambiente,
+    status: metric.status,
+    success: metric.success,
+    durationMs: metric.durationMs,
+    errorName: metric.errorName,
+  });
+});
+```
+
+Evite registrar payload fiscal, XML, certificado, chave privada ou dados sensiveis. O SDK ja usa `pathTemplate` para evitar colocar a chave de acesso no nome da serie.
+
+## Endpoint interno na sua API
+
+Se quiser consultar essas metricas pela sua API, crie um endpoint protegido que retorne o snapshot:
+
+```ts
+import { sefinLatency } from './observability/sefinMetrics.js';
+
+app.get('/internal/metrics/sefin', async (_request, reply) => {
+  return reply.send(sefinLatency.snapshot());
+});
+```
+
+Esse endpoint deve ser interno ou protegido por autenticacao forte. As metricas nao carregam XML nem certificado, mas podem revelar volume, estabilidade e comportamento operacional do seu sistema.
+
+## Prometheus e outros coletores
+
+O SDK nao depende de Prometheus. Para Prometheus, voce pode converter o snapshot para o formato esperado pela sua biblioteca de metricas.
+
+Exemplo conceitual:
+
+```txt
+sefin_request_duration_p99_ms{operation="transmitir_dps",ambiente="restrita"} 5100
+sefin_request_success_total{operation="transmitir_dps",ambiente="restrita"} 118
+sefin_request_error_total{operation="transmitir_dps",ambiente="restrita"} 2
+```
+
+Se voce ja usa OpenTelemetry, Datadog, New Relic, Grafana Cloud ou outro coletor, use `setSefinRequestObserver` como ponto de saida e envie `durationMs`, `operation`, `ambiente`, `status` e `success`.
+
+## Reset
+
+O tracker pode ser zerado:
+
+```ts
+sefinLatency.reset();
+```
+
+Isso remove as series e amostras em memoria. Use com cuidado em producao, porque o snapshot perde a janela atual de percentis.
+
+## Cuidados
+
+- Registre o observer uma unica vez por processo.
+- Nao crie um tracker novo a cada request HTTP.
+- Use `maxSamplesPerSeries` conforme o volume esperado e a memoria disponivel.
+- Lembre que processos diferentes tem snapshots diferentes. Em varios containers/replicas, cada processo enxerga apenas as chamadas que ele executou.
+- Para historico entre deploys/restarts, envie as metricas para um sistema externo.
+- Para saber os erros oficiais mais comuns da SEFIN, use a resposta de negocio e `extrairErros(body)` no seu fluxo. As metricas de latencia focam em tempo, status e sucesso/falha da chamada externa.
+

package/llms.txt

@@ -0,0 +1,80 @@
+# @useinvio/nfse-sdk LLM Guide
+
+This is a TypeScript SDK for Brazil's NFS-e Nacional (SEFIN). It handles the protocol layer for issuing and querying national service invoices: DPS JSON/XML generation, XMLDSIG signing, GZip/Base64 compression, mTLS transport, and structured SEFIN rejection extraction.
+
+It is not a fiscal decision engine. Do not infer tax codes, accounting rules, tenant state, invoice numbering policy, or legal advice from this SDK.
+
+## Start Here
+
+- `README.md`: primary Portuguese documentation and examples.
+- `ENGLISH.md`: English documentation with the same conceptual flow.
+- `docs/METRICS.md`: detailed SEFIN latency metrics guide, including observer setup, P99 interpretation, in-memory snapshots, and export guidance.
+- `index.ts`: public exports. Treat this as the supported API surface.
+- `examples/`: runnable usage examples.
+- `JSON_MAPPING.md`: mapping notes for the declarative JSON input.
+- `test/`: behavior examples and regression coverage.
+
+## Public Entry Points
+
+- `NfseClient`: resource-oriented client. Configure certificate, environment, and defaults once, then use `client.invoices.create(...)`, `client.invoices.buildDpsJson(...)`, and `client.invoices.get(...)`.
+- `emitirNfse(input, pfx, options?)`: issue an invoice from a DPS XML string or `DpsJsonRequest`.
+- `buildDpsFromJson(input)`: build unsigned DPS XML from declarative JSON.
+- `buildDpsId(prestador, nDPS, serie?)`: derive the 45-character DPS Id.
+- `loadPfx(...)` and `loadPfxFromBuffer(...)`: extract key/certificate material from an A1/PFX certificate.
+- `consultarNfse(...)`, `enviarEvento(...)`, `extrairErros(...)`: lower-level SEFIN helpers.
+- `setSefinRequestObserver(...)` and `createSefinLatencyTracker(...)`: observe SEFIN round-trip latency and compute rolling `p50Ms`/`p95Ms`/`p99Ms` by operation/environment.
+- `gzipBase64(...)`, `gunzipBase64(...)`, `signDps(...)`, `verifyDps(...)`: protocol utilities for custom flows.
+
+## File Map
+
+- `client.ts`: friendly client API and default merging.
+- `emissaoNota.ts`: central issue flow: prepare input, sign DPS, gzip/base64, transmit, unzip authorized XML, normalize errors.
+- `dpsJson.ts`: JSON-to-DPS XML builder, XML escaping, DPS Id generation, value formatting, and XML block assembly.
+- `fiscalValidation.ts`: structural and layout-oriented validation for the JSON input. This intentionally rejects unsupported or ambiguous fiscal shapes.
+- `sefinClient.ts`: HTTPS mTLS requests to SEFIN, latency observation, response parsing, error normalization, invoice query, issue transport, and event transport.
+- `config.ts`: SEFIN base URLs, environment names, and `tpAmb` mapping.
+- `loadPfx.ts`: PFX/A1 certificate decoding with `node-forge`.
+- `signXml.ts`: XMLDSIG signing and verification helpers.
+- `gzipB64.ts`: GZip/Base64 helpers.
+
+## Core Data Shape
+
+Declarative issuing uses `DpsJsonRequest`:
+
+- `ambiente`: optional, `restrita` or `producao`; defaults to `restrita`.
+- `prestador`: issuer profile such as `cnpj`, `cLocEmi`, `serie`, `opSimpNac`, and `regEspTrib`.
+- `servico`: service defaults such as `cTribNac`, `xDescServ`, `cLocPrestacao`, and optional `cNBS`.
+- `emissao`: invoice-specific data such as `nDPS`, dates, `valores`, optional parties, municipal/federal taxation blocks, and `totTrib`.
+
+Keep values as strings when they represent fiscal codes, identifiers, decimals, or exact XML values. Many fields are numeric-looking but must preserve leading zeroes.
+
+## Important Invariants
+
+- Node.js >= 20 and ESM are expected.
+- Public imports should come from the package root (`index.ts` exports), not internal files, unless you are editing the SDK itself.
+- `DEFAULT_AMBIENTE` is `restrita`; `NfseClient` also accepts `sandbox` and `production` aliases.
+- `buildDpsFromJson` validates first via `validateDpsJsonRequest`.
+- The SDK intentionally avoids silent fiscal defaults for required tax fields such as `tributacaoMunicipal` and `totTrib`.
+- `emissao.totTrib` follows an `xs:choice`: provide exactly one branch among value totals, percentage totals, `indTotTrib`, or `pTotTribSN`.
+- `buildDpsId` must return a 45-character Id beginning with `DPS`.
+- `emitirNfse` signs the DPS before transport and throws `EmitirNotaError` when SEFIN rejects or no authorized XML is returned.
+- `sefinClient.ts` uses PEM key/cert material for mTLS, not the raw PFX in the Node TLS handshake.
+- SEFIN latency metrics are emitted for the external request only; keep them separate from API route latency when integrating observability.
+
+## Change Guidance for LLMs
+
+- Preserve the public API names exported by `index.ts` unless the task explicitly asks for a breaking change.
+- Prefer adding or adjusting focused tests in `test/` when changing XML generation, validation, signing, transport parsing, or client defaults.
+- When adding support for a new NFS-e layout field, update the TypeScript interface, validation rules, builder output, docs/examples, and tests together.
+- Do not add fiscal assumptions to make examples pass. Required fiscal choices should stay explicit in user input.
+- Be careful with XML ordering. The generated order should follow the SEFIN schema, and tests may compare XML snippets.
+- Do not hand-wave certificate handling. PFX content may arrive as a `Buffer` or base64 string.
+- Network calls to SEFIN should stay isolated in `sefinClient.ts` so tests can mock transport boundaries.
+
+## Useful Commands
+
+```bash
+npm run build
+npm run typecheck
+npm test
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useinvio/nfse-sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "TypeScript SDK for Brazil's national NFS-e: JSON to DPS/XML, XMLDSIG, GZip/Base64, mTLS and SEFIN errors.",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,6 +21,7 @@
     "examples/README.md",
     "README.md",
     "JSON_MAPPING.md",
+    "llms.txt",
     "LICENSE"
   ],
   "scripts": {