@precisa-saude/fhir 0.1.0

package/dist/reference-ranges.d.cts

@@ -0,0 +1,106 @@
+/**
+ * Biomarker Reference Ranges
+ *
+ * Single source of truth for biomarker reference ranges used by both
+ * web app (for display) and API (for fallback when LLM doesn't extract ranges).
+ *
+ * Data sources (priority order):
+ * 1. Brazilian Government - SBPC/ML (Sociedade Brasileira de Patologia Clínica) guidelines
+ * 2. International Standards - WHO, clinical laboratory guidelines
+ * 3. Specific Labs - Fleury, Weinmann, Quest, LabCorp (when above unavailable)
+ */
+/**
+ * Sex-specific key for reference ranges
+ */
+type SexKey = 'M' | 'F' | 'all';
+/**
+ * Reference range configuration for a biomarker
+ */
+interface BiomarkerReferenceRange {
+    max?: number;
+    min?: number;
+    optimalMax?: number;
+    optimalMin?: number;
+    unit: string;
+    warningMax?: number;
+}
+/**
+ * A variant of a reference range that applies to a specific sex and/or age group
+ */
+interface RangeVariant {
+    ageMax?: number;
+    ageMin?: number;
+    range: BiomarkerReferenceRange;
+    sex: SexKey;
+}
+/**
+ * Extended biomarker range definition with sex/age-specific variants
+ */
+/**
+ * Direction indicates whether exceeding the reference range on one side is benign.
+ * - 'range': both above-max and below-min are abnormal (default)
+ * - 'higher-better': above-max is normal (e.g., BMC, HDL)
+ * - 'lower-better': below-min is normal (e.g., LDL, CRP)
+ */
+type RangeDirection = 'range' | 'higher-better' | 'lower-better';
+interface BiomarkerRangeDefinition {
+    default: BiomarkerReferenceRange;
+    direction?: RangeDirection;
+    source?: string;
+    variants?: RangeVariant[];
+}
+/**
+ * User context for personalized reference range lookup
+ */
+interface ReferenceRangeContext {
+    age?: number;
+    biologicalSex?: 'M' | 'F';
+}
+/**
+ * Comprehensive biomarker reference range definitions with sex/age-specific variants
+ *
+ * Each marker has a default range (used as fallback) and optional variants
+ * for sex/age-specific ranges.
+ */
+declare const biomarkerRangeDefinitions: Record<string, BiomarkerRangeDefinition>;
+/**
+ * Legacy flat reference ranges for backward compatibility
+ * This is derived from biomarkerRangeDefinitions defaults
+ */
+declare const defaultReferenceRanges: Record<string, BiomarkerReferenceRange>;
+/**
+ * Get the reference range for a biomarker code, optionally personalized for user context
+ * @param testCode - The biomarker code (e.g., "HDL", "Testosterone")
+ * @param context - Optional user context for personalized ranges
+ * @returns Reference range or undefined if not found
+ */
+declare function getReferenceRange(testCode: string, context?: ReferenceRangeContext): BiomarkerReferenceRange | undefined;
+/**
+ * Get the range direction for a biomarker code.
+ * Returns 'range' (default) if not specified.
+ */
+declare function getRangeDirection(testCode: string): RangeDirection;
+/**
+ * Get fallback reference range for a biomarker code (default only, no personalization)
+ * Used by API when LLM doesn't extract reference values
+ * @param biomarkerCode - The biomarker code
+ * @returns Reference range with min/max/unit or undefined
+ */
+declare function getFallbackReferenceRange(biomarkerCode: string): {
+    min: number;
+    max: number;
+    unit: string;
+} | undefined;
+/**
+ * Apply fallback reference ranges to biomarkers that are missing them
+ * @param biomarkers - Array of parsed biomarkers
+ * @returns Count of biomarkers that received fallback references
+ */
+declare function applyFallbackReferenceRanges<T extends {
+    code: string;
+    referenceMin?: number | null;
+    referenceMax?: number | null;
+    unit?: string;
+}>(biomarkers: T[]): number;
+
+export { type BiomarkerRangeDefinition, type BiomarkerReferenceRange, type RangeDirection, type RangeVariant, type ReferenceRangeContext, type SexKey, applyFallbackReferenceRanges, biomarkerRangeDefinitions, defaultReferenceRanges, getFallbackReferenceRange, getRangeDirection, getReferenceRange };

package/dist/reference-ranges.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Biomarker Reference Ranges
+ *
+ * Single source of truth for biomarker reference ranges used by both
+ * web app (for display) and API (for fallback when LLM doesn't extract ranges).
+ *
+ * Data sources (priority order):
+ * 1. Brazilian Government - SBPC/ML (Sociedade Brasileira de Patologia Clínica) guidelines
+ * 2. International Standards - WHO, clinical laboratory guidelines
+ * 3. Specific Labs - Fleury, Weinmann, Quest, LabCorp (when above unavailable)
+ */
+/**
+ * Sex-specific key for reference ranges
+ */
+type SexKey = 'M' | 'F' | 'all';
+/**
+ * Reference range configuration for a biomarker
+ */
+interface BiomarkerReferenceRange {
+    max?: number;
+    min?: number;
+    optimalMax?: number;
+    optimalMin?: number;
+    unit: string;
+    warningMax?: number;
+}
+/**
+ * A variant of a reference range that applies to a specific sex and/or age group
+ */
+interface RangeVariant {
+    ageMax?: number;
+    ageMin?: number;
+    range: BiomarkerReferenceRange;
+    sex: SexKey;
+}
+/**
+ * Extended biomarker range definition with sex/age-specific variants
+ */
+/**
+ * Direction indicates whether exceeding the reference range on one side is benign.
+ * - 'range': both above-max and below-min are abnormal (default)
+ * - 'higher-better': above-max is normal (e.g., BMC, HDL)
+ * - 'lower-better': below-min is normal (e.g., LDL, CRP)
+ */
+type RangeDirection = 'range' | 'higher-better' | 'lower-better';
+interface BiomarkerRangeDefinition {
+    default: BiomarkerReferenceRange;
+    direction?: RangeDirection;
+    source?: string;
+    variants?: RangeVariant[];
+}
+/**
+ * User context for personalized reference range lookup
+ */
+interface ReferenceRangeContext {
+    age?: number;
+    biologicalSex?: 'M' | 'F';
+}
+/**
+ * Comprehensive biomarker reference range definitions with sex/age-specific variants
+ *
+ * Each marker has a default range (used as fallback) and optional variants
+ * for sex/age-specific ranges.
+ */
+declare const biomarkerRangeDefinitions: Record<string, BiomarkerRangeDefinition>;
+/**
+ * Legacy flat reference ranges for backward compatibility
+ * This is derived from biomarkerRangeDefinitions defaults
+ */
+declare const defaultReferenceRanges: Record<string, BiomarkerReferenceRange>;
+/**
+ * Get the reference range for a biomarker code, optionally personalized for user context
+ * @param testCode - The biomarker code (e.g., "HDL", "Testosterone")
+ * @param context - Optional user context for personalized ranges
+ * @returns Reference range or undefined if not found
+ */
+declare function getReferenceRange(testCode: string, context?: ReferenceRangeContext): BiomarkerReferenceRange | undefined;
+/**
+ * Get the range direction for a biomarker code.
+ * Returns 'range' (default) if not specified.
+ */
+declare function getRangeDirection(testCode: string): RangeDirection;
+/**
+ * Get fallback reference range for a biomarker code (default only, no personalization)
+ * Used by API when LLM doesn't extract reference values
+ * @param biomarkerCode - The biomarker code
+ * @returns Reference range with min/max/unit or undefined
+ */
+declare function getFallbackReferenceRange(biomarkerCode: string): {
+    min: number;
+    max: number;
+    unit: string;
+} | undefined;
+/**
+ * Apply fallback reference ranges to biomarkers that are missing them
+ * @param biomarkers - Array of parsed biomarkers
+ * @returns Count of biomarkers that received fallback references
+ */
+declare function applyFallbackReferenceRanges<T extends {
+    code: string;
+    referenceMin?: number | null;
+    referenceMax?: number | null;
+    unit?: string;
+}>(biomarkers: T[]): number;
+
+export { type BiomarkerRangeDefinition, type BiomarkerReferenceRange, type RangeDirection, type RangeVariant, type ReferenceRangeContext, type SexKey, applyFallbackReferenceRanges, biomarkerRangeDefinitions, defaultReferenceRanges, getFallbackReferenceRange, getRangeDirection, getReferenceRange };

package/dist/reference-ranges.js

@@ -0,0 +1,18 @@
+import {
+  applyFallbackReferenceRanges,
+  biomarkerRangeDefinitions,
+  defaultReferenceRanges,
+  getFallbackReferenceRange,
+  getRangeDirection,
+  getReferenceRange
+} from "./chunk-FDOBUUGY.js";
+import "./chunk-VPMT4MRS.js";
+export {
+  applyFallbackReferenceRanges,
+  biomarkerRangeDefinitions,
+  defaultReferenceRanges,
+  getFallbackReferenceRange,
+  getRangeDirection,
+  getReferenceRange
+};
+//# sourceMappingURL=reference-ranges.js.map

package/dist/reference-ranges.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/units.cjs

@@ -0,0 +1,19 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+var _chunkGFXKYXHWcjs = require('./chunk-GFXKYXHW.cjs');
+
+
+
+
+
+
+
+
+exports.BIOMARKER_DEFAULT_UNIT = _chunkGFXKYXHWcjs.BIOMARKER_DEFAULT_UNIT; exports.BIOMARKER_UNITS = _chunkGFXKYXHWcjs.BIOMARKER_UNITS; exports.UNIT_TO_UCUM = _chunkGFXKYXHWcjs.UNIT_TO_UCUM; exports.getCanonicalUnit = _chunkGFXKYXHWcjs.getCanonicalUnit; exports.getDefaultUnit = _chunkGFXKYXHWcjs.getDefaultUnit; exports.getSIUnit = _chunkGFXKYXHWcjs.getSIUnit; exports.unitToUCUM = _chunkGFXKYXHWcjs.unitToUCUM;
+//# sourceMappingURL=units.cjs.map

package/dist/units.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/rafael/Github/precisa-saude/fhir-brasil/packages/core/dist/units.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,4ZAAC","file":"/Users/rafael/Github/precisa-saude/fhir-brasil/packages/core/dist/units.cjs"}

package/dist/units.d.cts

@@ -0,0 +1,46 @@
+/**
+ * Unit Mappings and Biomarker Unit Definitions
+ *
+ * Maps units to UCUM format, provides default units for biomarkers,
+ * and defines canonical/SI unit configurations with aliases.
+ */
+/**
+ * Map units to UCUM (Unified Code for Units of Measure)
+ * See: https://ucum.org/
+ */
+declare const UNIT_TO_UCUM: Record<string, string>;
+/**
+ * Default units for biomarkers when source data doesn't provide one
+ * These are the most common units used in Brazilian labs
+ */
+declare const BIOMARKER_DEFAULT_UNIT: Record<string, string>;
+/**
+ * Convert unit to UCUM format
+ */
+declare function unitToUCUM(unit: string): string;
+/**
+ * Get default unit for a biomarker code
+ * @param biomarkerCode - The biomarker code (e.g., "Glucose", "HbA1c")
+ * @returns The default unit or empty string if not found
+ */
+declare function getDefaultUnit(biomarkerCode: string): string;
+/** Biomarker unit definitions — canonical units match reference-ranges.ts (BR conventional). */
+interface BiomarkerUnitConfig {
+    aliases: Record<string, string>;
+    canonicalUcum: string;
+    canonicalUnit: string;
+    molecularWeight?: number;
+    siUcum: string;
+    siUnit: string;
+}
+declare const BIOMARKER_UNITS: Record<string, BiomarkerUnitConfig>;
+/**
+ * Get the canonical unit for a biomarker code.
+ */
+declare function getCanonicalUnit(code: string): string | null;
+/**
+ * Get the SI unit for a biomarker code.
+ */
+declare function getSIUnit(code: string): string | null;
+
+export { BIOMARKER_DEFAULT_UNIT, BIOMARKER_UNITS, type BiomarkerUnitConfig, UNIT_TO_UCUM, getCanonicalUnit, getDefaultUnit, getSIUnit, unitToUCUM };

package/dist/units.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Unit Mappings and Biomarker Unit Definitions
+ *
+ * Maps units to UCUM format, provides default units for biomarkers,
+ * and defines canonical/SI unit configurations with aliases.
+ */
+/**
+ * Map units to UCUM (Unified Code for Units of Measure)
+ * See: https://ucum.org/
+ */
+declare const UNIT_TO_UCUM: Record<string, string>;
+/**
+ * Default units for biomarkers when source data doesn't provide one
+ * These are the most common units used in Brazilian labs
+ */
+declare const BIOMARKER_DEFAULT_UNIT: Record<string, string>;
+/**
+ * Convert unit to UCUM format
+ */
+declare function unitToUCUM(unit: string): string;
+/**
+ * Get default unit for a biomarker code
+ * @param biomarkerCode - The biomarker code (e.g., "Glucose", "HbA1c")
+ * @returns The default unit or empty string if not found
+ */
+declare function getDefaultUnit(biomarkerCode: string): string;
+/** Biomarker unit definitions — canonical units match reference-ranges.ts (BR conventional). */
+interface BiomarkerUnitConfig {
+    aliases: Record<string, string>;
+    canonicalUcum: string;
+    canonicalUnit: string;
+    molecularWeight?: number;
+    siUcum: string;
+    siUnit: string;
+}
+declare const BIOMARKER_UNITS: Record<string, BiomarkerUnitConfig>;
+/**
+ * Get the canonical unit for a biomarker code.
+ */
+declare function getCanonicalUnit(code: string): string | null;
+/**
+ * Get the SI unit for a biomarker code.
+ */
+declare function getSIUnit(code: string): string | null;
+
+export { BIOMARKER_DEFAULT_UNIT, BIOMARKER_UNITS, type BiomarkerUnitConfig, UNIT_TO_UCUM, getCanonicalUnit, getDefaultUnit, getSIUnit, unitToUCUM };

package/dist/units.js

@@ -0,0 +1,19 @@
+import {
+  BIOMARKER_DEFAULT_UNIT,
+  BIOMARKER_UNITS,
+  UNIT_TO_UCUM,
+  getCanonicalUnit,
+  getDefaultUnit,
+  getSIUnit,
+  unitToUCUM
+} from "./chunk-VPMT4MRS.js";
+export {
+  BIOMARKER_DEFAULT_UNIT,
+  BIOMARKER_UNITS,
+  UNIT_TO_UCUM,
+  getCanonicalUnit,
+  getDefaultUnit,
+  getSIUnit,
+  unitToUCUM
+};
+//# sourceMappingURL=units.js.map

package/dist/units.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/validators.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunk3ILBFLVQcjs = require('./chunk-3ILBFLVQ.cjs');
+
+
+
+
+exports.validateFHIRDiagnosticReport = _chunk3ILBFLVQcjs.validateFHIRDiagnosticReport; exports.validateFHIRImportBundle = _chunk3ILBFLVQcjs.validateFHIRImportBundle; exports.validateFHIRObservation = _chunk3ILBFLVQcjs.validateFHIRObservation;
+//# sourceMappingURL=validators.cjs.map

package/dist/validators.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/rafael/Github/precisa-saude/fhir-brasil/packages/core/dist/validators.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACF,kPAAC","file":"/Users/rafael/Github/precisa-saude/fhir-brasil/packages/core/dist/validators.cjs"}

package/dist/validators.d.cts

@@ -0,0 +1,23 @@
+import { j as FHIRDiagnosticReport, a as FHIRObservation } from './fhir-types-D9hUzGrc.cjs';
+import { ImportError } from './importer.cjs';
+
+/**
+ * FHIR Validators
+ *
+ * Validation functions for FHIR R4 resources.
+ */
+
+/**
+ * Validate FHIR DiagnosticReport
+ */
+declare function validateFHIRDiagnosticReport(report: FHIRDiagnosticReport): string[];
+/**
+ * Validate FHIR Observation
+ */
+declare function validateFHIRObservation(observation: FHIRObservation): string[];
+/**
+ * Validate that the input is a structurally valid FHIR Bundle
+ */
+declare function validateFHIRImportBundle(data: unknown): ImportError[];
+
+export { validateFHIRDiagnosticReport, validateFHIRImportBundle, validateFHIRObservation };

package/dist/validators.d.ts

@@ -0,0 +1,23 @@
+import { j as FHIRDiagnosticReport, a as FHIRObservation } from './fhir-types-D9hUzGrc.js';
+import { ImportError } from './importer.js';
+
+/**
+ * FHIR Validators
+ *
+ * Validation functions for FHIR R4 resources.
+ */
+
+/**
+ * Validate FHIR DiagnosticReport
+ */
+declare function validateFHIRDiagnosticReport(report: FHIRDiagnosticReport): string[];
+/**
+ * Validate FHIR Observation
+ */
+declare function validateFHIRObservation(observation: FHIRObservation): string[];
+/**
+ * Validate that the input is a structurally valid FHIR Bundle
+ */
+declare function validateFHIRImportBundle(data: unknown): ImportError[];
+
+export { validateFHIRDiagnosticReport, validateFHIRImportBundle, validateFHIRObservation };

package/dist/validators.js

@@ -0,0 +1,11 @@
+import {
+  validateFHIRDiagnosticReport,
+  validateFHIRImportBundle,
+  validateFHIRObservation
+} from "./chunk-N3ZCOLG2.js";
+export {
+  validateFHIRDiagnosticReport,
+  validateFHIRImportBundle,
+  validateFHIRObservation
+};
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@precisa-saude/fhir",
+  "version": "0.1.0",
+  "description": "Brazilian FHIR R4 types, biomarker definitions, reference ranges, and converters",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./biomarkers": {
+      "import": {
+        "types": "./dist/biomarkers.d.ts",
+        "default": "./dist/biomarkers.js"
+      },
+      "require": {
+        "types": "./dist/biomarkers.d.cts",
+        "default": "./dist/biomarkers.cjs"
+      }
+    },
+    "./reference-ranges": {
+      "import": {
+        "types": "./dist/reference-ranges.d.ts",
+        "default": "./dist/reference-ranges.js"
+      },
+      "require": {
+        "types": "./dist/reference-ranges.d.cts",
+        "default": "./dist/reference-ranges.cjs"
+      }
+    },
+    "./converter": {
+      "import": {
+        "types": "./dist/converter.d.ts",
+        "default": "./dist/converter.js"
+      },
+      "require": {
+        "types": "./dist/converter.d.cts",
+        "default": "./dist/converter.cjs"
+      }
+    },
+    "./importer": {
+      "import": {
+        "types": "./dist/importer.d.ts",
+        "default": "./dist/importer.js"
+      },
+      "require": {
+        "types": "./dist/importer.d.cts",
+        "default": "./dist/importer.cjs"
+      }
+    },
+    "./units": {
+      "import": {
+        "types": "./dist/units.d.ts",
+        "default": "./dist/units.js"
+      },
+      "require": {
+        "types": "./dist/units.d.cts",
+        "default": "./dist/units.cjs"
+      }
+    },
+    "./validators": {
+      "import": {
+        "types": "./dist/validators.d.ts",
+        "default": "./dist/validators.js"
+      },
+      "require": {
+        "types": "./dist/validators.d.cts",
+        "default": "./dist/validators.cjs"
+      }
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist .turbo"
+  },
+  "keywords": ["fhir", "r4", "brazil", "biomarker", "loinc", "sbpc-ml", "health"],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/precisa-saude/fhir-brasil.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "~5.7.3",
+    "vitest": "^2.1.8"
+  }
+}