@precisa-saude/fhir 0.32.0 → 0.33.0

package/dist/{chunk-44QMNDOI.cjs → chunk-ZCIZUBMR.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunk3ILBFLVQcjs = require('./chunk-3ILBFLVQ.cjs');
+var _chunkOAFAERDYcjs = require('./chunk-OAFAERDY.cjs');
 
 
 
@@ -11,7 +11,7 @@ var _chunkOR67NJDZcjs = require('./chunk-OR67NJDZ.cjs');
 
 
 
-var _chunkMKH4Q735cjs = require('./chunk-MKH4Q735.cjs');
+var _chunkT75NZM56cjs = require('./chunk-T75NZM56.cjs');
 
 // src/importer.ts
 var MAX_OBSERVATIONS = 5e3;
@@ -33,11 +33,11 @@ function resolveBiomarkerCode(observation) {
   } else {
     reason = "No code found in observation coding";
   }
-  const fromLoinc = loincCode ? _chunkMKH4Q735cjs.loincToCode.call(void 0, loincCode) : void 0;
+  const fromLoinc = loincCode ? _chunkT75NZM56cjs.loincToCode.call(void 0, loincCode) : void 0;
   if (fromLoinc) return { internalCode: fromLoinc, loincCode, reason };
-  if (declaredCode && _chunkMKH4Q735cjs.isValidCode.call(void 0, declaredCode)) {
-    const canonical = _chunkMKH4Q735cjs.normalizeCode.call(void 0, declaredCode);
-    return { internalCode: canonical, loincCode: _chunkMKH4Q735cjs.codeToLoinc.call(void 0, canonical), reason };
+  if (declaredCode && _chunkT75NZM56cjs.isValidCode.call(void 0, declaredCode)) {
+    const canonical = _chunkT75NZM56cjs.normalizeCode.call(void 0, declaredCode);
+    return { internalCode: canonical, loincCode: _chunkT75NZM56cjs.codeToLoinc.call(void 0, canonical), reason };
   }
   return { loincCode, reason };
 }
@@ -74,7 +74,7 @@ function mapFHIRObservationToInternal(observation, index) {
       skipped: { index, loincCode, reason, resourceType: "Observation" }
     };
   }
-  const definition = _chunkMKH4Q735cjs.getDefinitionByCode.call(void 0, internalCode);
+  const definition = _chunkT75NZM56cjs.getDefinitionByCode.call(void 0, internalCode);
   let value;
   let unit = "";
   let isQualitative = false;
@@ -126,7 +126,7 @@ function mapFHIRObservationToInternal(observation, index) {
   return { observation: imported };
 }
 function processImportBundle(data) {
-  const validationErrors = _chunk3ILBFLVQcjs.validateFHIRImportBundle.call(void 0, data);
+  const validationErrors = _chunkOAFAERDYcjs.validateFHIRImportBundle.call(void 0, data);
   if (validationErrors.length > 0) {
     return {
       errors: validationErrors,
@@ -162,4 +162,4 @@ function processImportBundle(data) {
 
 
 exports.MAX_OBSERVATIONS = MAX_OBSERVATIONS; exports.MAX_FILE_SIZE = MAX_FILE_SIZE; exports.extractObservationsFromBundle = extractObservationsFromBundle; exports.mapFHIRObservationToInternal = mapFHIRObservationToInternal; exports.processImportBundle = processImportBundle;
-//# sourceMappingURL=chunk-44QMNDOI.cjs.map
+//# sourceMappingURL=chunk-ZCIZUBMR.cjs.map

package/dist/{chunk-44QMNDOI.cjs.map → chunk-ZCIZUBMR.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/fhir-brasil/fhir-brasil/packages/core/dist/chunk-44QMNDOI.cjs","../src/importer.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACA;ACgDA,IAAM,iBAAA,EAAmB,GAAA;AACzB,IAAM,cAAA,EAAgB,GAAA,EAAK,KAAA,EAAO,IAAA;AAclC,SAAS,oBAAA,CAAqB,WAAA,EAI5B;AACA,EAAA,MAAM,OAAA,mCAAS,WAAA,mBAAY,IAAA,6BAAM,QAAA,UAAU,CAAC,GAAA;AAC5C,EAAA,MAAM,UAAA,kBAAY,MAAA,qBAAO,IAAA,mBAAK,CAAC,CAAA,EAAA,GAAM,CAAA,CAAE,OAAA,IAAW,8BAAY,CAAA,6BAAG,MAAA;AACjE,EAAA,MAAM,aAAA,kBAAe,MAAA,qBAAO,IAAA,mBAAK,CAAC,CAAA,EAAA,GAAM,CAAA,CAAE,OAAA,IAAW,uCAAqB,CAAA,6BAAG,MAAA;AAE7E,EAAA,MAAM,UAAA,EAAY;AAAA,IAChB,GAAI,UAAA,EAAY,CAAC,CAAA,MAAA,EAAS,SAAS,CAAA,CAAA;AACf,IAAA;AACtB,EAAA;AAOI,EAAA;AACsB,EAAA;AACE,IAAA;AACE,EAAA;AACO,IAAA;AAC1B,IAAA;AACJ,EAAA;AACI,IAAA;AACX,EAAA;AAE8B,EAAA;AACN,EAAA;AAEQ,EAAA;AAOE,IAAA;AAIE,IAAA;AACpC,EAAA;AAE2B,EAAA;AAC7B;AAKmE;AACxC,EAAA;AACU,EAAA;AACA,EAAA;AAC5B,EAAA;AACT;AAK8C;AAIH,EAAA;AACR,EAAA;AAEA,EAAA;AACH,IAAA;AACP,IAAA;AACc,MAAA;AACjC,MAAA;AACF,IAAA;AAEmB,IAAA;AAEjB,MAAA;AACF,IAAA;AAE2B,IAAA;AACQ,MAAA;AACjC,MAAA;AACF,IAAA;AAEmD,IAAA;AACrD,EAAA;AAE+B,EAAA;AACjC;AAME;AAGiC,EAAA;AAEd,EAAA;AACV,IAAA;AACwB,MAAA;AAC/B,IAAA;AACF,EAAA;AAEmB,EAAA;AAGf,EAAA;AACO,EAAA;AACS,EAAA;AAEW,EAAA;AACK,IAAA;AACD,IAAA;AACC,EAAA;AACd,IAAA;AACJ,IAAA;AACX,EAAA;AACE,IAAA;AACI,MAAA;AACP,QAAA;AACA,QAAA;AACQ,QAAA;AACM,QAAA;AAChB,MAAA;AACF,IAAA;AACF,EAAA;AAGmC,EAAA;AACd,EAAA;AACZ,IAAA;AACI,MAAA;AACP,QAAA;AACA,QAAA;AACQ,QAAA;AACM,QAAA;AAChB,MAAA;AACF,IAAA;AACF,EAAA;AAGI,EAAA;AACA,EAAA;AACiC,EAAA;AACR,IAAA;AACA,IAAA;AAC7B,EAAA;AAEsC,EAAA;AACrB,IAAA;AAEK,IAAA;AACpB,IAAA;AAC6B,IAAA;AAC7B,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACkC,IAAA;AAClC,IAAA;AACF,EAAA;AAE+B,EAAA;AACjC;AAKqE;AAE1C,EAAA;AACQ,EAAA;AACxB,IAAA;AACG,MAAA;AACG,MAAA;AACD,MAAA;AACM,MAAA;AAClB,IAAA;AACF,EAAA;AAEe,EAAA;AAGmB,EAAA;AAGO,EAAA;AACK,EAAA;AAEb,EAAA;AAChB,IAAA;AAEc,IAAA;AACK,MAAA;AAC3B,IAAA;AACyB,MAAA;AAChC,IAAA;AACF,EAAA;AAEO,EAAA;AACI,IAAA;AACT,IAAA;AACS,IAAA;AACoB,IAAA;AAC/B,EAAA;AACF;ADnIuC;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/fhir-brasil/fhir-brasil/packages/core/dist/chunk-44QMNDOI.cjs","sourcesContent":[null,"/**\n * FHIR Importer\n *\n * Parses FHIR R4 Bundles and extracts Observation resources with known LOINC codes,\n * mapping them to internal biomarker codes for storage as lab results.\n */\n\nimport {\n  codeToLoinc,\n  getDefinitionByCode,\n  isValidCode,\n  loincToCode,\n  normalizeCode,\n} from './biomarkers';\nimport { BIOMARKER_CODE_SYSTEM, LOINC_SYSTEM } from './code-systems';\nimport type { FHIRBundle, FHIRObservation } from './fhir-types';\nimport { validateFHIRImportBundle } from './validators';\n\nexport interface ImportedObservation {\n  biomarkerCode: string;\n  biomarkerName: string;\n  collectionDate: string;\n  flag: 'H' | 'L' | '';\n  isQualitative: boolean;\n  /** Ausente nos biomarcadores sem LOINC publicado, como composição corporal. */\n  loincCode?: string;\n  referenceMax?: number;\n  referenceMin?: number;\n  unit: string;\n  value: number | string;\n}\n\nexport interface SkippedEntry {\n  index: number;\n  loincCode?: string;\n  reason: string;\n  resourceType?: string;\n}\n\nexport interface ImportError {\n  details: string;\n  field: string;\n}\n\nexport interface FHIRImportResult {\n  errors: ImportError[];\n  imported: ImportedObservation[];\n  skipped: SkippedEntry[];\n  totalProcessed: number;\n}\n\n/**\n * Limites de importação.\n *\n * Uma Observation exportada ocupa cerca de 1,25KB em JSON compacto e 2,75KB\n * quando o arquivo vem indentado, medido sobre um histórico real de 998\n * Observations em 61 laudos. Nesse tamanho, 5000 Observations dão 6,0MB\n * compactos ou 13,1MB indentados, e por isso o teto de arquivo é 15MB: cobre\n * as duas formas com folga.\n *\n * Na densidade desse mesmo histórico (16 Observations por laudo), 5000\n * equivalem a cerca de 300 laudos.\n */\nconst MAX_OBSERVATIONS = 5000;\nconst MAX_FILE_SIZE = 15 * 1024 * 1024; // 15MB\n\n/**\n * Resolve o código interno do biomarcador a partir do `code.coding`.\n *\n * LOINC primeiro, que é o vocabulário que arquivos de terceiros usam. Quando\n * não resolve, cai para o coding de códigos internos, presente nos arquivos\n * exportados pela própria plataforma.\n *\n * O fallback cobre dois casos: biomarcadores sem LOINC publicado (composição\n * corporal, densidade óssea, escore de cálcio) e arquivos antigos, exportados\n * quando esses biomarcadores saíam com o placeholder `99999-9`, que não\n * resolve para nada.\n */\nfunction resolveBiomarkerCode(observation: FHIRObservation): {\n  internalCode?: string;\n  loincCode?: string;\n  reason: string;\n} {\n  const coding = observation.code?.coding ?? [];\n  const loincCode = coding.find((c) => c.system === LOINC_SYSTEM)?.code;\n  const declaredCode = coding.find((c) => c.system === BIOMARKER_CODE_SYSTEM)?.code;\n\n  const seenCodes = [\n    ...(loincCode ? [`LOINC ${loincCode}`] : []),\n    ...(declaredCode ? [`biomarker code ${declaredCode}`] : []),\n  ];\n\n  // Três motivos distintos de descarte, que antes se confundiam num só. Sem\n  // essa separação, um arquivo em SNOMED relatava \"nenhum código encontrado\",\n  // sugerindo `coding` vazio quando na verdade o código existia e estava num\n  // system que não tratamos. Para importação de terceiros, é a diferença entre\n  // um diagnóstico acionável e um enigma.\n  let reason: string;\n  if (seenCodes.length > 0) {\n    reason = `Unknown code: ${seenCodes.join(', ')}`;\n  } else if (coding.length > 0) {\n    const systems = [...new Set(coding.map((c) => c.system ?? '(sem system)'))];\n    reason = `No code in a supported system (found: ${systems.join(', ')})`;\n  } else {\n    reason = 'No code found in observation coding';\n  }\n\n  const fromLoinc = loincCode ? loincToCode(loincCode) : undefined;\n  if (fromLoinc) return { internalCode: fromLoinc, loincCode, reason };\n\n  if (declaredCode && isValidCode(declaredCode)) {\n    // `isValidCode` aceita alias, mas alias não serve como código armazenado:\n    // 49 definições têm um, e tanto `codeToLoinc` quanto as faixas de\n    // referência são indexadas só pelo canônico. Sem normalizar, `VLDL_Cholesterol`\n    // entraria no lugar de `VLDL` e perderia o LOINC 13458-5 que ele tem.\n    // Importar um Bundle é fronteira de dados, que é onde `normalizeCode` deve\n    // ser aplicado.\n    const canonical = normalizeCode(declaredCode);\n\n    // `codeToLoinc` devolve undefined para quem não tem LOINC, que é o caso\n    // esperado aqui. O campo fica de fora em vez de receber um valor inventado.\n    return { internalCode: canonical, loincCode: codeToLoinc(canonical), reason };\n  }\n\n  return { loincCode, reason };\n}\n\n/**\n * Extract interpretation flag from Observation\n */\nfunction extractFlag(observation: FHIRObservation): 'H' | 'L' | '' {\n  const code = observation.interpretation?.[0]?.coding?.[0]?.code;\n  if (code === 'H' || code === 'HH') return 'H';\n  if (code === 'L' || code === 'LL') return 'L';\n  return '';\n}\n\n/**\n * Extract Observation resources from a FHIR Bundle\n */\nexport function extractObservationsFromBundle(bundle: FHIRBundle): {\n  observations: FHIRObservation[];\n  skipped: SkippedEntry[];\n} {\n  const observations: FHIRObservation[] = [];\n  const skipped: SkippedEntry[] = [];\n\n  for (let i = 0; i < bundle.entry.length; i++) {\n    const entry = bundle.entry[i]!;\n    if (!entry.resource) {\n      skipped.push({ index: i, reason: 'Entry has no resource' });\n      continue;\n    }\n\n    if (entry.resource.resourceType !== 'Observation') {\n      // Non-observation resources are silently skipped (Patient, DiagnosticReport, etc.)\n      continue;\n    }\n\n    if (observations.length >= MAX_OBSERVATIONS) {\n      skipped.push({ index: i, reason: `Maximum of ${MAX_OBSERVATIONS} observations exceeded` });\n      continue;\n    }\n\n    observations.push(entry.resource as FHIRObservation);\n  }\n\n  return { observations, skipped };\n}\n\n/**\n * Map a FHIR Observation to internal format using LOINC→biomarker code lookup\n */\nexport function mapFHIRObservationToInternal(\n  observation: FHIRObservation,\n  index: number,\n): { observation: ImportedObservation } | { skipped: SkippedEntry } {\n  const { internalCode, loincCode, reason } = resolveBiomarkerCode(observation);\n\n  if (!internalCode) {\n    return {\n      skipped: { index, loincCode, reason, resourceType: 'Observation' },\n    };\n  }\n\n  const definition = getDefinitionByCode(internalCode);\n\n  // Extract value\n  let value: number | string;\n  let unit = '';\n  let isQualitative = false;\n\n  if (observation.valueQuantity?.value !== undefined) {\n    value = observation.valueQuantity.value;\n    unit = observation.valueQuantity.unit || observation.valueQuantity.code || '';\n  } else if (observation.valueString) {\n    value = observation.valueString;\n    isQualitative = true;\n  } else {\n    return {\n      skipped: {\n        index,\n        loincCode,\n        reason: 'Observation has no value (valueQuantity or valueString)',\n        resourceType: 'Observation',\n      },\n    };\n  }\n\n  // Extract collection date (effectiveDateTime or effectivePeriod.start)\n  const collectionDate = observation.effectiveDateTime || observation.effectivePeriod?.start || '';\n  if (!collectionDate) {\n    return {\n      skipped: {\n        index,\n        loincCode,\n        reason: 'Observation has no effectiveDateTime or effectivePeriod.start',\n        resourceType: 'Observation',\n      },\n    };\n  }\n\n  // Extract reference ranges\n  let referenceMin: number | undefined;\n  let referenceMax: number | undefined;\n  if (observation.referenceRange?.[0]) {\n    referenceMin = observation.referenceRange[0].low?.value;\n    referenceMax = observation.referenceRange[0].high?.value;\n  }\n\n  const imported: ImportedObservation = {\n    biomarkerCode: internalCode,\n    biomarkerName:\n      definition?.names.pt[0] || definition?.names.en[0] || observation.code.text || internalCode,\n    collectionDate,\n    flag: extractFlag(observation),\n    isQualitative,\n    loincCode,\n    referenceMax,\n    referenceMin,\n    unit: unit || definition?.unit || '',\n    value,\n  };\n\n  return { observation: imported };\n}\n\n/**\n * Process a complete FHIR Bundle for import\n */\nexport function processImportBundle(data: unknown): FHIRImportResult {\n  // Structural validation\n  const validationErrors = validateFHIRImportBundle(data);\n  if (validationErrors.length > 0) {\n    return {\n      errors: validationErrors,\n      imported: [],\n      skipped: [],\n      totalProcessed: 0,\n    };\n  }\n\n  const bundle = data as FHIRBundle;\n\n  // Extract observations\n  const { observations, skipped } = extractObservationsFromBundle(bundle);\n\n  // Map each observation to internal format\n  const imported: ImportedObservation[] = [];\n  const allSkipped: SkippedEntry[] = [...skipped];\n\n  for (let i = 0; i < observations.length; i++) {\n    const result = mapFHIRObservationToInternal(observations[i]!, i);\n\n    if ('observation' in result) {\n      imported.push(result.observation);\n    } else {\n      allSkipped.push(result.skipped);\n    }\n  }\n\n  return {\n    errors: [],\n    imported,\n    skipped: allSkipped,\n    totalProcessed: observations.length,\n  };\n}\n\nexport { MAX_FILE_SIZE, MAX_OBSERVATIONS };\n"]}
+{"version":3,"sources":["/home/runner/work/fhir-brasil/fhir-brasil/packages/core/dist/chunk-ZCIZUBMR.cjs","../src/importer.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACA;ACgDA,IAAM,iBAAA,EAAmB,GAAA;AACzB,IAAM,cAAA,EAAgB,GAAA,EAAK,KAAA,EAAO,IAAA;AAclC,SAAS,oBAAA,CAAqB,WAAA,EAI5B;AACA,EAAA,MAAM,OAAA,mCAAS,WAAA,mBAAY,IAAA,6BAAM,QAAA,UAAU,CAAC,GAAA;AAC5C,EAAA,MAAM,UAAA,kBAAY,MAAA,qBAAO,IAAA,mBAAK,CAAC,CAAA,EAAA,GAAM,CAAA,CAAE,OAAA,IAAW,8BAAY,CAAA,6BAAG,MAAA;AACjE,EAAA,MAAM,aAAA,kBAAe,MAAA,qBAAO,IAAA,mBAAK,CAAC,CAAA,EAAA,GAAM,CAAA,CAAE,OAAA,IAAW,uCAAqB,CAAA,6BAAG,MAAA;AAE7E,EAAA,MAAM,UAAA,EAAY;AAAA,IAChB,GAAI,UAAA,EAAY,CAAC,CAAA,MAAA,EAAS,SAAS,CAAA,CAAA;AACf,IAAA;AACtB,EAAA;AAOI,EAAA;AACsB,EAAA;AACE,IAAA;AACE,EAAA;AACO,IAAA;AAC1B,IAAA;AACJ,EAAA;AACI,IAAA;AACX,EAAA;AAE8B,EAAA;AACN,EAAA;AAEQ,EAAA;AAOE,IAAA;AAIE,IAAA;AACpC,EAAA;AAE2B,EAAA;AAC7B;AAKmE;AACxC,EAAA;AACU,EAAA;AACA,EAAA;AAC5B,EAAA;AACT;AAK8C;AAIH,EAAA;AACR,EAAA;AAEA,EAAA;AACH,IAAA;AACP,IAAA;AACc,MAAA;AACjC,MAAA;AACF,IAAA;AAEmB,IAAA;AAEjB,MAAA;AACF,IAAA;AAE2B,IAAA;AACQ,MAAA;AACjC,MAAA;AACF,IAAA;AAEmD,IAAA;AACrD,EAAA;AAE+B,EAAA;AACjC;AAME;AAGiC,EAAA;AAEd,EAAA;AACV,IAAA;AACwB,MAAA;AAC/B,IAAA;AACF,EAAA;AAEmB,EAAA;AAGf,EAAA;AACO,EAAA;AACS,EAAA;AAEW,EAAA;AACK,IAAA;AACD,IAAA;AACC,EAAA;AACd,IAAA;AACJ,IAAA;AACX,EAAA;AACE,IAAA;AACI,MAAA;AACP,QAAA;AACA,QAAA;AACQ,QAAA;AACM,QAAA;AAChB,MAAA;AACF,IAAA;AACF,EAAA;AAGmC,EAAA;AACd,EAAA;AACZ,IAAA;AACI,MAAA;AACP,QAAA;AACA,QAAA;AACQ,QAAA;AACM,QAAA;AAChB,MAAA;AACF,IAAA;AACF,EAAA;AAGI,EAAA;AACA,EAAA;AACiC,EAAA;AACR,IAAA;AACA,IAAA;AAC7B,EAAA;AAEsC,EAAA;AACrB,IAAA;AAEK,IAAA;AACpB,IAAA;AAC6B,IAAA;AAC7B,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACkC,IAAA;AAClC,IAAA;AACF,EAAA;AAE+B,EAAA;AACjC;AAKqE;AAE1C,EAAA;AACQ,EAAA;AACxB,IAAA;AACG,MAAA;AACG,MAAA;AACD,MAAA;AACM,MAAA;AAClB,IAAA;AACF,EAAA;AAEe,EAAA;AAGmB,EAAA;AAGO,EAAA;AACK,EAAA;AAEb,EAAA;AAChB,IAAA;AAEc,IAAA;AACK,MAAA;AAC3B,IAAA;AACyB,MAAA;AAChC,IAAA;AACF,EAAA;AAEO,EAAA;AACI,IAAA;AACT,IAAA;AACS,IAAA;AACoB,IAAA;AAC/B,EAAA;AACF;ADnIuC;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/fhir-brasil/fhir-brasil/packages/core/dist/chunk-ZCIZUBMR.cjs","sourcesContent":[null,"/**\n * FHIR Importer\n *\n * Parses FHIR R4 Bundles and extracts Observation resources with known LOINC codes,\n * mapping them to internal biomarker codes for storage as lab results.\n */\n\nimport {\n  codeToLoinc,\n  getDefinitionByCode,\n  isValidCode,\n  loincToCode,\n  normalizeCode,\n} from './biomarkers';\nimport { BIOMARKER_CODE_SYSTEM, LOINC_SYSTEM } from './code-systems';\nimport type { FHIRBundle, FHIRObservation } from './fhir-types';\nimport { validateFHIRImportBundle } from './validators';\n\nexport interface ImportedObservation {\n  biomarkerCode: string;\n  biomarkerName: string;\n  collectionDate: string;\n  flag: 'H' | 'L' | '';\n  isQualitative: boolean;\n  /** Ausente nos biomarcadores sem LOINC publicado, como composição corporal. */\n  loincCode?: string;\n  referenceMax?: number;\n  referenceMin?: number;\n  unit: string;\n  value: number | string;\n}\n\nexport interface SkippedEntry {\n  index: number;\n  loincCode?: string;\n  reason: string;\n  resourceType?: string;\n}\n\nexport interface ImportError {\n  details: string;\n  field: string;\n}\n\nexport interface FHIRImportResult {\n  errors: ImportError[];\n  imported: ImportedObservation[];\n  skipped: SkippedEntry[];\n  totalProcessed: number;\n}\n\n/**\n * Limites de importação.\n *\n * Uma Observation exportada ocupa cerca de 1,25KB em JSON compacto e 2,75KB\n * quando o arquivo vem indentado, medido sobre um histórico real de 998\n * Observations em 61 laudos. Nesse tamanho, 5000 Observations dão 6,0MB\n * compactos ou 13,1MB indentados, e por isso o teto de arquivo é 15MB: cobre\n * as duas formas com folga.\n *\n * Na densidade desse mesmo histórico (16 Observations por laudo), 5000\n * equivalem a cerca de 300 laudos.\n */\nconst MAX_OBSERVATIONS = 5000;\nconst MAX_FILE_SIZE = 15 * 1024 * 1024; // 15MB\n\n/**\n * Resolve o código interno do biomarcador a partir do `code.coding`.\n *\n * LOINC primeiro, que é o vocabulário que arquivos de terceiros usam. Quando\n * não resolve, cai para o coding de códigos internos, presente nos arquivos\n * exportados pela própria plataforma.\n *\n * O fallback cobre dois casos: biomarcadores sem LOINC publicado (composição\n * corporal, densidade óssea, escore de cálcio) e arquivos antigos, exportados\n * quando esses biomarcadores saíam com o placeholder `99999-9`, que não\n * resolve para nada.\n */\nfunction resolveBiomarkerCode(observation: FHIRObservation): {\n  internalCode?: string;\n  loincCode?: string;\n  reason: string;\n} {\n  const coding = observation.code?.coding ?? [];\n  const loincCode = coding.find((c) => c.system === LOINC_SYSTEM)?.code;\n  const declaredCode = coding.find((c) => c.system === BIOMARKER_CODE_SYSTEM)?.code;\n\n  const seenCodes = [\n    ...(loincCode ? [`LOINC ${loincCode}`] : []),\n    ...(declaredCode ? [`biomarker code ${declaredCode}`] : []),\n  ];\n\n  // Três motivos distintos de descarte, que antes se confundiam num só. Sem\n  // essa separação, um arquivo em SNOMED relatava \"nenhum código encontrado\",\n  // sugerindo `coding` vazio quando na verdade o código existia e estava num\n  // system que não tratamos. Para importação de terceiros, é a diferença entre\n  // um diagnóstico acionável e um enigma.\n  let reason: string;\n  if (seenCodes.length > 0) {\n    reason = `Unknown code: ${seenCodes.join(', ')}`;\n  } else if (coding.length > 0) {\n    const systems = [...new Set(coding.map((c) => c.system ?? '(sem system)'))];\n    reason = `No code in a supported system (found: ${systems.join(', ')})`;\n  } else {\n    reason = 'No code found in observation coding';\n  }\n\n  const fromLoinc = loincCode ? loincToCode(loincCode) : undefined;\n  if (fromLoinc) return { internalCode: fromLoinc, loincCode, reason };\n\n  if (declaredCode && isValidCode(declaredCode)) {\n    // `isValidCode` aceita alias, mas alias não serve como código armazenado:\n    // 49 definições têm um, e tanto `codeToLoinc` quanto as faixas de\n    // referência são indexadas só pelo canônico. Sem normalizar, `VLDL_Cholesterol`\n    // entraria no lugar de `VLDL` e perderia o LOINC 13458-5 que ele tem.\n    // Importar um Bundle é fronteira de dados, que é onde `normalizeCode` deve\n    // ser aplicado.\n    const canonical = normalizeCode(declaredCode);\n\n    // `codeToLoinc` devolve undefined para quem não tem LOINC, que é o caso\n    // esperado aqui. O campo fica de fora em vez de receber um valor inventado.\n    return { internalCode: canonical, loincCode: codeToLoinc(canonical), reason };\n  }\n\n  return { loincCode, reason };\n}\n\n/**\n * Extract interpretation flag from Observation\n */\nfunction extractFlag(observation: FHIRObservation): 'H' | 'L' | '' {\n  const code = observation.interpretation?.[0]?.coding?.[0]?.code;\n  if (code === 'H' || code === 'HH') return 'H';\n  if (code === 'L' || code === 'LL') return 'L';\n  return '';\n}\n\n/**\n * Extract Observation resources from a FHIR Bundle\n */\nexport function extractObservationsFromBundle(bundle: FHIRBundle): {\n  observations: FHIRObservation[];\n  skipped: SkippedEntry[];\n} {\n  const observations: FHIRObservation[] = [];\n  const skipped: SkippedEntry[] = [];\n\n  for (let i = 0; i < bundle.entry.length; i++) {\n    const entry = bundle.entry[i]!;\n    if (!entry.resource) {\n      skipped.push({ index: i, reason: 'Entry has no resource' });\n      continue;\n    }\n\n    if (entry.resource.resourceType !== 'Observation') {\n      // Non-observation resources are silently skipped (Patient, DiagnosticReport, etc.)\n      continue;\n    }\n\n    if (observations.length >= MAX_OBSERVATIONS) {\n      skipped.push({ index: i, reason: `Maximum of ${MAX_OBSERVATIONS} observations exceeded` });\n      continue;\n    }\n\n    observations.push(entry.resource as FHIRObservation);\n  }\n\n  return { observations, skipped };\n}\n\n/**\n * Map a FHIR Observation to internal format using LOINC→biomarker code lookup\n */\nexport function mapFHIRObservationToInternal(\n  observation: FHIRObservation,\n  index: number,\n): { observation: ImportedObservation } | { skipped: SkippedEntry } {\n  const { internalCode, loincCode, reason } = resolveBiomarkerCode(observation);\n\n  if (!internalCode) {\n    return {\n      skipped: { index, loincCode, reason, resourceType: 'Observation' },\n    };\n  }\n\n  const definition = getDefinitionByCode(internalCode);\n\n  // Extract value\n  let value: number | string;\n  let unit = '';\n  let isQualitative = false;\n\n  if (observation.valueQuantity?.value !== undefined) {\n    value = observation.valueQuantity.value;\n    unit = observation.valueQuantity.unit || observation.valueQuantity.code || '';\n  } else if (observation.valueString) {\n    value = observation.valueString;\n    isQualitative = true;\n  } else {\n    return {\n      skipped: {\n        index,\n        loincCode,\n        reason: 'Observation has no value (valueQuantity or valueString)',\n        resourceType: 'Observation',\n      },\n    };\n  }\n\n  // Extract collection date (effectiveDateTime or effectivePeriod.start)\n  const collectionDate = observation.effectiveDateTime || observation.effectivePeriod?.start || '';\n  if (!collectionDate) {\n    return {\n      skipped: {\n        index,\n        loincCode,\n        reason: 'Observation has no effectiveDateTime or effectivePeriod.start',\n        resourceType: 'Observation',\n      },\n    };\n  }\n\n  // Extract reference ranges\n  let referenceMin: number | undefined;\n  let referenceMax: number | undefined;\n  if (observation.referenceRange?.[0]) {\n    referenceMin = observation.referenceRange[0].low?.value;\n    referenceMax = observation.referenceRange[0].high?.value;\n  }\n\n  const imported: ImportedObservation = {\n    biomarkerCode: internalCode,\n    biomarkerName:\n      definition?.names.pt[0] || definition?.names.en[0] || observation.code.text || internalCode,\n    collectionDate,\n    flag: extractFlag(observation),\n    isQualitative,\n    loincCode,\n    referenceMax,\n    referenceMin,\n    unit: unit || definition?.unit || '',\n    value,\n  };\n\n  return { observation: imported };\n}\n\n/**\n * Process a complete FHIR Bundle for import\n */\nexport function processImportBundle(data: unknown): FHIRImportResult {\n  // Structural validation\n  const validationErrors = validateFHIRImportBundle(data);\n  if (validationErrors.length > 0) {\n    return {\n      errors: validationErrors,\n      imported: [],\n      skipped: [],\n      totalProcessed: 0,\n    };\n  }\n\n  const bundle = data as FHIRBundle;\n\n  // Extract observations\n  const { observations, skipped } = extractObservationsFromBundle(bundle);\n\n  // Map each observation to internal format\n  const imported: ImportedObservation[] = [];\n  const allSkipped: SkippedEntry[] = [...skipped];\n\n  for (let i = 0; i < observations.length; i++) {\n    const result = mapFHIRObservationToInternal(observations[i]!, i);\n\n    if ('observation' in result) {\n      imported.push(result.observation);\n    } else {\n      allSkipped.push(result.skipped);\n    }\n  }\n\n  return {\n    errors: [],\n    imported,\n    skipped: allSkipped,\n    totalProcessed: observations.length,\n  };\n}\n\nexport { MAX_FILE_SIZE, MAX_OBSERVATIONS };\n"]}