@fhiron/sdk 0.1.0

package/src/_linter/examples.js

@@ -0,0 +1,270 @@
+// Fhiron linter — ejemplos válidos por resourceType.
+//
+// Para `fhiron_get_example`: cuando el agente IA necesita "un Patient CL Core
+// válido", llama esta tool y obtiene un recurso completo y conforme. Evita
+// alucinaciones de URLs canónicas, codes, systems y formato de RUN.
+//
+// Cada ejemplo:
+//   - Pasa lintResource() sin errores.
+//   - Usa systems canónicos CL Core v1.9.4.
+//   - Usa códigos reales (LOINC, SNOMED, CIE-10, TFC, DEIS).
+//   - Es minimalista — solo los campos necesarios para que valide.
+
+"use strict";
+
+const { CS } = require("./catalog.js");
+
+const EXAMPLES = {
+  Patient: {
+    resourceType: "Patient",
+    identifier: [{
+      system: CS("CSTipoIdentificador"),
+      value: "12345678-5",
+    }],
+    name: [{
+      family: "Pérez González",
+      given: ["María", "Fernanda"],
+    }],
+    gender: "female",
+    birthDate: "1985-03-15",
+    address: [{
+      line: ["Av. Providencia 1234"],
+      city: "Providencia",
+      state: "Región Metropolitana",
+      country: "CL",
+    }],
+  },
+
+  Practitioner: {
+    resourceType: "Practitioner",
+    identifier: [{
+      system: CS("CSTipoIdentificador"),
+      value: "11111111-1",
+    }],
+    name: [{
+      family: "Soto Vargas",
+      given: ["Carlos"],
+      prefix: ["Dr."],
+    }],
+    qualification: [{
+      code: { text: "Médico Cirujano" },
+    }],
+  },
+
+  Observation: {
+    resourceType: "Observation",
+    status: "final",
+    category: [{
+      coding: [{
+        system: "http://terminology.hl7.org/CodeSystem/observation-category",
+        code: "vital-signs",
+      }],
+    }],
+    code: {
+      coding: [{
+        system: "http://loinc.org",
+        code: "29463-7",
+        display: "Peso corporal",
+      }],
+    },
+    subject: { reference: "Patient/123" },
+    effectiveDateTime: "2026-04-29T10:30:00-04:00",
+    valueQuantity: {
+      value: 72.5,
+      unit: "kg",
+      system: "http://unitsofmeasure.org",
+      code: "kg",
+    },
+  },
+
+  Medication: {
+    resourceType: "Medication",
+    code: {
+      coding: [{
+        system: "http://www.whocc.no/atc",
+        code: "C09AA02",
+        display: "Enalapril 10 mg comprimido",
+      }],
+    },
+    form: { text: "Comprimido" },
+  },
+
+  MedicationRequest: {
+    resourceType: "MedicationRequest",
+    status: "active",
+    intent: "order",
+    subject: { reference: "Patient/123" },
+    authoredOn: "2026-04-29",
+    requester: { reference: "Practitioner/456" },
+    medicationCodeableConcept: {
+      coding: [{
+        system: "http://www.whocc.no/atc",
+        code: "C09AA02",
+        display: "Enalapril 10 mg",
+      }],
+    },
+    dosageInstruction: [{
+      text: "1 comprimido cada 24 horas, vía oral",
+      timing: { repeat: { frequency: 1, period: 1, periodUnit: "d" } },
+      route: { coding: [{ system: "http://snomed.info/sct", code: "26643006", display: "Vía oral" }] },
+    }],
+  },
+
+  Encounter: {
+    resourceType: "Encounter",
+    status: "finished",
+    class: {
+      system: "http://terminology.hl7.org/CodeSystem/v3-ActCode",
+      code: "AMB",
+      display: "ambulatorio",
+    },
+    subject: { reference: "Patient/123" },
+    period: {
+      start: "2026-04-29T09:00:00-04:00",
+      end: "2026-04-29T09:30:00-04:00",
+    },
+    serviceProvider: { reference: "Organization/hospital" },
+  },
+
+  Condition: {
+    resourceType: "Condition",
+    clinicalStatus: {
+      coding: [{
+        system: "http://terminology.hl7.org/CodeSystem/condition-clinical",
+        code: "active",
+      }],
+    },
+    code: {
+      coding: [{
+        system: "http://hl7.org/fhir/sid/icd-10",
+        code: "I10",
+        display: "Hipertensión esencial (primaria)",
+      }],
+    },
+    subject: { reference: "Patient/123" },
+    recordedDate: "2026-04-29",
+  },
+
+  AllergyIntolerance: {
+    resourceType: "AllergyIntolerance",
+    clinicalStatus: {
+      coding: [{
+        system: "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
+        code: "active",
+      }],
+    },
+    code: {
+      coding: [{
+        system: "http://snomed.info/sct",
+        code: "256349002",
+        display: "Maní",
+      }],
+    },
+    patient: { reference: "Patient/123" },
+    recordedDate: "2026-04-29",
+  },
+
+  Procedure: {
+    resourceType: "Procedure",
+    status: "completed",
+    code: {
+      coding: [{
+        system: "http://snomed.info/sct",
+        code: "80146002",
+        display: "Apendicectomía",
+      }],
+    },
+    subject: { reference: "Patient/123" },
+    performedDateTime: "2026-04-29T11:00:00-04:00",
+  },
+
+  Coverage: {
+    resourceType: "Coverage",
+    status: "active",
+    beneficiary: { reference: "Patient/123" },
+    payor: [{ reference: "Organization/fonasa" }],
+    period: { start: "2026-01-01" },
+  },
+
+  Organization: {
+    resourceType: "Organization",
+    name: "Hospital Clínico Universidad de Chile",
+    address: [{
+      line: ["Santos Dumont 999"],
+      city: "Independencia",
+      country: "CL",
+    }],
+  },
+
+  Immunization: {
+    resourceType: "Immunization",
+    status: "completed",
+    vaccineCode: {
+      coding: [{
+        system: "http://hl7.org/fhir/sid/cvx",
+        code: "208",
+        display: "Vacuna COVID-19 ARNm (LNP-S, PF) 30 mcg/0,3 mL",
+      }],
+    },
+    patient: { reference: "Patient/123" },
+    occurrenceDateTime: "2026-04-29",
+    performer: [{ actor: { reference: "Practitioner/456" } }],
+  },
+
+  DiagnosticReport: {
+    resourceType: "DiagnosticReport",
+    status: "final",
+    code: {
+      coding: [{
+        system: "http://loinc.org",
+        code: "11502-2",
+        display: "Informe de laboratorio",
+      }],
+    },
+    subject: { reference: "Patient/123" },
+    effectiveDateTime: "2026-04-29",
+    issued: "2026-04-29T15:00:00-04:00",
+  },
+
+  Bundle: {
+    resourceType: "Bundle",
+    type: "collection",
+    entry: [{
+      resource: {
+        resourceType: "Patient",
+        identifier: [{ system: CS("CSTipoIdentificador"), value: "12345678-5" }],
+        name: [{ family: "Pérez", given: ["María"] }],
+        gender: "female",
+      },
+    }],
+  },
+};
+
+/**
+ * Devuelve un ejemplo válido CL Core v1.9.4 para el resourceType pedido.
+ * Devuelve null si el resourceType no está cubierto.
+ *
+ * @param {string} resourceType
+ * @returns {object|null}
+ */
+function getExample(resourceType) {
+  if (!resourceType || typeof resourceType !== "string") return null;
+  const tpl = EXAMPLES[resourceType];
+  if (!tpl) return null;
+  // Devolver una copia para que el caller pueda mutar sin contaminar la plantilla.
+  return JSON.parse(JSON.stringify(tpl));
+}
+
+/**
+ * Lista los resourceTypes con ejemplo disponible.
+ * @returns {string[]}
+ */
+function listExamples() {
+  return Object.keys(EXAMPLES);
+}
+
+module.exports = {
+  EXAMPLES,
+  getExample,
+  listExamples,
+};