0.1.1 • Published yesterday

@monitor-sefaz/contracts

Licence

MIT

Version

0.1.1

Deps

Size

79 kB

Vulns

Weekly

Stars

Summary Dependency Versions

@monitor-sefaz/contracts

Schemas Zod e DTOs compartilhados do Monitor SEFAZ: status de serviço, resumo agregado, histórico, incidentes e eventos de notificação.

É o contrato entre o coletor, a API, o Cloudflare Worker e o dashboard — quem consome a API pública do monitor pode validar as respostas com os mesmos schemas que o servidor usa para produzi-las.

Instalação

npm i @monitor-sefaz/contracts

Uso

import { statusSnapshotSchema, summarySchema, isUp } from '@monitor-sefaz/contracts';

const snapshot = statusSnapshotSchema.parse(await res.json());

// "No ar" inclui contingência: a SEFAZ responde e ainda dá para emitir.
const noAr = snapshot.services.filter((s) => isUp(s.state));

Estados possíveis: OPERATIONAL, CONTINGENCY, SLOWDOWN, DOWN, ERROR.

Validação resiliente

Para um painel, uma resposta parcialmente inválida é melhor que uma tela de erro. O schema resiliente descarta os itens ruins e mantém o resto:

import { resilientStatusSnapshotSchema } from '@monitor-sefaz/contracts';

const snapshot = resilientStatusSnapshotSchema.parse(data); // serviços inválidos são omitidos

O histórico acumulado pelo Worker não é um ponto por checagem: o estado é guardado como run-length (segmento novo só quando muda) e a latência é agregada por hora. Isso mantém 72h de 135 serviços em ~230 KB em vez de megabytes, sem perder o instante exato de cada queda.

import {
  compactHistorySchema,
  expandCompactHistory,
  LATENCY_BUCKET_MS,
} from '@monitor-sefaz/contracts';

const history = compactHistorySchema.parse(await res.json());

// Expande de volta para pontos, na resolução que você precisa.
const detalhe = expandCompactHistory(history, 'NFe:SP');
const grosso = expandCompactHistory(history, 'NFe:SP', { stepMs: LATENCY_BUCKET_MS });