@nebulae/tpiv2-interop-core

Tipos, interfaces y utilidades compartidas para el SDK de Interoperabilidad.

Instalación

Este paquete es una dependencia de los otros módulos y se instala automáticamente.

npm install @nebulae/tpiv2-interop-core

Contenido

Tipos Comunes

• RetryConfig: Configuración de reintentos
• TimeoutConfig: Configuración de timeouts
• InteropResponse<T>: Respuesta estándar
• TraceMetadata: Metadatos de trazabilidad
• BaseModuleConfig: Configuración base (incluye circuitBreaker?: Partial<CircuitBreakerConfig>)
• CircuitBreakerConfig: Configuración del circuit breaker
• CircuitBreakerEvent: Payload de eventos del circuit breaker
• CircuitState: 'CLOSED' | 'OPEN' | 'HALF_OPEN'

Errores

• InteropError: Error base
• AuthenticationError: Error de autenticación
• AuthorizationError: Error de autorización
• ValidationError: Error de validación
• TimeoutError: Error de timeout
• ConnectionError: Error de conexión
• ProtocolError: Error de protocolo
• ConfigurationError: Error de configuración
• MaxRetriesExceededError: Reintentos agotados
• CircuitOpenError: Circuito en estado OPEN — la operación fue rechazada antes de intentarse

Utilidades

• InteropLogger: Logger estructurado
• RetryHandler: Manejo de reintentos
• SchemaValidator: Validación de esquemas JSON
• CircuitBreaker: Circuit breaker por instancia (estados: CLOSED → OPEN → HALF_OPEN)

Uso

import {
  InteropLogger,
  RetryHandler,
  ValidationError,
} from '@nebulae/tpiv2-interop-core';

const logger = new InteropLogger({
  module: 'mi-servicio',
  correlationId: 'req-12345',
});

const retryHandler = new RetryHandler({
  maxRetries: 3,
  initialDelay: 1000,
});

API

Ver documentación completa.