Skip to main content
El SDK es el canal para embeber la validación FHIR® dentro del código de tu aplicación. Mientras el MCP vive en tu agente y la CLI en tu terminal, el SDK corre en el runtime de tu producto: en el camino crítico, justo antes de persistir un recurso o reenviarlo a un EHR.
CanalDónde correPaquete
MCPDentro del agente (Claude Code, Cursor, Continue.dev, JetBrains AI).@fhiron/mcp-connector
CLITerminal, CI/CD, pre-commit hooks.@fhiron/cli
SDKEl runtime de tu app (Node/TypeScript).@fhiron/sdk
Los tres consumen la misma API, descuentan la misma cuota del tenant y usan el mismo motor: CL Core v1.9.4 más los perfiles MINSAL.

​
Qué resuelve

  • Validar en el camino crítico. Antes de hacer POST de un Encounter a tu EHR o al Gateway, valídalo y rechaza lo que no cumple CL Core en el momento.
  • Errores en español, tipados. Recibes los hallazgos ya traducidos, con referencia al perfil que falla, listos para mostrar en tu propia UI.
  • Cero boilerplate. No armas fetch, headers, ni manejo de 401/429/timeouts. Una línea para construir el cliente.
  • Autocompletado. Tipos .d.ts incluidos: tu editor sabe qué campos tiene un issue y qué errores puedes capturar.

​
Ejemplo mínimo

import { Fhiron } from '@fhiron/sdk';

const fhiron = new Fhiron({ apiKey: process.env.FHIRON_API_KEY });

const encounter = {
  resourceType: 'Encounter',
  status: 'finished',
  class: { system: 'http://terminology.hl7.org/CodeSystem/v3-ActCode', code: 'AMB' },
  subject: { reference: 'Patient/123' },
};

const result = await fhiron.validate(encounter);

if (!result.ok) {
  for (const issue of result.errors) {
    console.log(`${issue.path}: ${issue.message}`);
  }
}

​
Dos modos de validación

MétodoRedCuotaQué cubre
lint(resource)NoNo descuentaEstructura, cardinalidades, RUN, comuna, terminología conocida. Inmediato.
validate(resource)SíDescuenta 1Motor HAPI + perfiles CL Core completos. La validación canónica.
lint es ideal para feedback en vivo (un editor, un formulario); validate es la verificación oficial contra el motor. Ver lint y validate.

​
Requisitos

  • Node 18 o superior (usa el fetch global).
  • Una API key de tu tenant (dashboard).
  • ESM y CommonJS soportados.

​
Próximo paso

Empieza por la instalación.