@nebulae/tpiv2-interop-xroad

Cliente X-Road para interoperabilidad con servicios gubernamentales.

Instalación

npm install @nebulae/tpiv2-interop-xroad @nebulae/tpiv2-interop-auth

Uso

Cliente X-Road Básico

import { XRoadClient } from '@nebulae/tpiv2-interop-xroad';

const client = new XRoadClient({
  serverUrl: 'https://xroad.example.com',
  protocol: '6.0',
  client: {
    instance: 'CO',
    memberClass: 'GOV',
    memberCode: 'TPI V2',
    subsystem: 'TPI V2',
  },
});

const response = await client.invoke({
  service: {
    instance: 'CO',
    memberClass: 'GOV',
    memberCode: 'REGISTRADURIA',
    subsystem: 'validacion',
    serviceCode: 'validarIdentidad',
    serviceVersion: 'v1',
  },
  parameters: {
    tipoDocumento: 'CC',
    numeroDocumento: '123456789',
  },
});

Con Firmas Digitales

const client = new XRoadClient({
  serverUrl: 'https://xroad.example.com',
  client: { /* ... */ },
  signatureConfig: {
    enabled: true,
    algorithm: 'SHA256',
    privateKey: '-----BEGIN PRIVATE KEY-----...',
    certificate: '-----BEGIN CERTIFICATE-----...',
  },
});

Listar Servicios

const servicios = await client.listServices();
console.log('Servicios disponibles:', servicios);

API

Ver documentación completa.