babelfhir-ts 1.0.35 → 1.0.36

package/README.md

@@ -23,9 +23,30 @@
 - **Install any FHIR profile as a node module**—use `babelfhir-ts install` to add Implementation Guides directly to your project
 
 <!-- PARITY-BADGES:START - Do not remove or modify this section -->
-## Pipeline Parity Results
+## Continuous Validation
 
-BabelFHIR-TS validators achieve **100% parity** with the Firely .NET SDK validator across major Implementation Guides:
+Every pull request runs two independent CI pipelines that validate generated code against real-world FHIR Implementation Guides. For each IG, the pipeline:
+
+1. Downloads the FHIR package from a registry
+2. Generates TypeScript interfaces, validators, and classes
+3. Compiles the output with `tsc` (zero errors required)
+4. Generates `empty()` and `random()` test resources for every profile
+5. Validates those resources against two external FHIR validators
+
+### Tested Implementation Guides
+
+| Implementation Guide | Package | Profiles |
+|---|---|---|
+| US Core | `hl7.fhir.us.core@8.0.0` | Patient, Condition, Observation, Encounter, … |
+| ISiK Basis (Germany) | `de.gematik.isik-basismodul@4.0.3` | ISiKPatient, ISiKDiagnose, … |
+| IPS (International Patient Summary) | `hl7.fhir.uv.ips@2.0.0` | Composition, MedicationStatement, … |
+| SMART App Launch | `hl7.fhir.uv.smart-app-launch@2.2.0` | WellKnown endpoints |
+| CH Core (Switzerland) | `ch.fhir.ig.ch-core@5.0.0` | CHCorePatient, CHCoreEncounter, … |
+| DaVinci PAS | `hl7.fhir.us.davinci-pas@2.0.1` | PASClaim, PASClaimResponse, … |
+
+### Validation with Firely .NET SDK
+
+The first pipeline validates generated resources using the [Firely .NET SDK validator](https://docs.fire.ly/projects/Firely-NET-SDK/) (v3.0.1). Results are published as live badges:
 
 ![US Core 8.0.0](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f/raw/badge-us-core.json)
 ![ISiK Basis 4.0.3](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f/raw/badge-isik-basis.json)
@@ -33,14 +54,11 @@ BabelFHIR-TS validators achieve **100% parity** with the Firely .NET SDK validat
 ![SMART 2.2.0](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f/raw/badge-smart.json)
 ![CH Core 5.0.0](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f/raw/badge-ch-core.json)
 
-> **11 profiles excluded** due to [Firely SDK bugs](./docs/FIRELY-VALIDATOR-BUGS.md) — validated successfully with HL7 Java Validator.
-
-📊 **[Full Report](https://gist.github.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f)** · *Last updated: Dec 10, 2025*
+> 11 profiles are excluded from this pipeline due to schema loading issues in the Firely SDK. These profiles validate successfully with the HL7 Java Validator below. Details in [docs/FIRELY-VALIDATOR-BUGS.md](./docs/FIRELY-VALIDATOR-BUGS.md).
 
-<!-- HL7-PARITY-BADGES:START - Do not remove or modify this section -->
-### HL7 Java Validator Parity
+### Validation with HL7 Java Validator
 
-Generated `random()` and `empty()` methods also pass structural validation with the [official HL7 FHIR Validator](https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator):
+The second pipeline validates using the [official HL7 FHIR Validator](https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator) (v6.3.11), the reference implementation for FHIR conformance checking:
 
 ![US Core 8.0.0](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f/raw/badge-hl7-us-core.json)
 ![ISiK Basis 4.0.3](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f/raw/badge-hl7-isik-basis.json)
@@ -48,9 +66,9 @@ Generated `random()` and `empty()` methods also pass structural validation with
 ![SMART 2.2.0](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f/raw/badge-hl7-smart.json)
 ![CH Core 5.0.0](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f/raw/badge-hl7-ch-core.json)
 
-> **Note:** Terminology validation (codes bound to ValueSets) requires a terminology server. The HL7 validator validates terminology bindings against `tx.fhir.org` by default, which may report errors for generated placeholder codes. Use `--tx-server https://tx.fhir.org/r4` during generation to expand ValueSets and use real codes.
+> Terminology validation requires a tx server. The pipeline uses `--tx-server https://tx.fhir.org/r4` during generation to expand ValueSets and produce valid codes.
 
-📊 **[Full Report](https://gist.github.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f)** · *Last updated: Jan 24, 2026*
+📊 **[Full Report & Badge Data](https://gist.github.com/quotentiroler/e9bc625cfe88a0a67a73abc06660f40f)**
 <!-- HL7-PARITY-BADGES:END -->
 <!-- PARITY-BADGES:END -->
 
@@ -233,7 +251,7 @@ For comprehensive conformance testing, use the official [HL7 FHIR Validator](htt
   - Reference integrity constraints
 
   Use `random()` for development, testing, and prototyping, but always validate production data on the FHIR server side.
-- **`validate()` parity**: The generated validation methods execute FHIRPath expressions and check constraints from StructureDefinitions, but are **only guaranteed to match** the Firely .NET SDK validator for scenarios covered by our test suite (see GitHub actions). Edge cases, complex slicing patterns, or profiles not in our test pipeline may produce different results. For production conformance testing, use the official [HL7 FHIR Validator](https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator) as the source of truth.
+- **`validate()` coverage**: The generated validation methods execute FHIRPath expressions and check constraints from StructureDefinitions. They are tested against the HL7 Java Validator and the Firely .NET SDK for the Implementation Guides listed in the [Continuous Validation](#continuous-validation) section. Edge cases, complex slicing patterns, or profiles not in the CI pipeline may produce different results. For production conformance testing, use the official [HL7 FHIR Validator](https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator) as the source of truth.
 
 ### FHIR Version Support
 
@@ -242,7 +260,7 @@ For comprehensive conformance testing, use the official [HL7 FHIR Validator](htt
 
 ### Reporting Issues
 
-If you encounter an Implementation Guide that doesn't generate correctly, please [open an issue](https://github.com/quotentiroler/BabelFHIR-ts/issues) with:
+If you encounter an Implementation Guide that doesn't generate correctly, please [open an issue](https://github.com/Max-Health-Inc/BabelFHIR-TS/issues) with:
 
 - The package name and version
 - The specific StructureDefinition URL
@@ -266,6 +284,6 @@ For security issues, please see [SECURITY.md](SECURITY.md) for our security poli
 ## Links
 
 - [npm package](https://www.npmjs.com/package/babelfhir-ts)
-- [GitHub repository](https://github.com/quotentiroler/BabelFHIR-ts)
-- [Issue tracker](https://github.com/quotentiroler/BabelFHIR-ts/issues)
+- [GitHub repository](https://github.com/Max-Health-Inc/BabelFHIR-TS)
+- [Issue tracker](https://github.com/Max-Health-Inc/BabelFHIR-TS/issues)
 - [Changelog](CHANGELOG.md)

package/out/src/generator/index.js

@@ -1280,7 +1280,7 @@ export async function generateIntoPackage(packageArchivePath, outArchivePath, fl
             license: 'MIT',
             // fhirpath is required at runtime by validators; keep as peer so host decides version
             peerDependencies: {
-                'fhirpath': '^4.0.0'
+                'fhirpath': '^3.0.0 || ^4.0.0'
             },
             // Type definitions for FHIR are needed for the .d.ts files
             dependencies: {
@@ -1291,10 +1291,14 @@ export async function generateIntoPackage(packageArchivePath, outArchivePath, fl
         fs.writeFileSync(generatedPackageJsonPath, JSON.stringify(generatedPackageJson, null, 2));
         logger.log(`Created package.json in generated folder: ${packageName}-generated@${packageVersion}`);
         // Copy fhir-r4.d.ts ambient module declaration to support fhir/r4 imports
-        // The file is at out/fhir-r4.d.ts (root of compiled output)
-        const fhirR4DtsSource = path.join(path.dirname(path.dirname(fileURLToPath(import.meta.url))), 'fhir-r4.d.ts');
+        // In dev: src/generator/ -> src/fhir-r4.d.ts. In compiled: out/src/generator/ -> out/fhir-r4.d.ts
+        const _selfDir = path.dirname(fileURLToPath(import.meta.url));
+        const fhirR4DtsSource = [
+            path.join(_selfDir, '..', 'fhir-r4.d.ts'),
+            path.join(_selfDir, '..', '..', 'fhir-r4.d.ts'),
+        ].find(p => fs.existsSync(p));
         const fhirR4DtsDest = path.join(outputDir, 'fhir-r4.d.ts');
-        if (fs.existsSync(fhirR4DtsSource)) {
+        if (fhirR4DtsSource) {
             fs.copyFileSync(fhirR4DtsSource, fhirR4DtsDest);
             logger.log('Copied fhir-r4.d.ts ambient module declaration');
         }

package/out/src/main.js

@@ -5,11 +5,25 @@ import { getCacheConfig, getFhirPackagesCacheDir, clearAllCaches, ensureCacheDir
 import { fetchArrayBuffer } from "./generator/fetchUtils.js";
 import fs from 'fs';
 import path from 'path';
-import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
 import { spawn } from 'child_process';
 import { logger } from './logger.js';
-const require = createRequire(import.meta.url);
-const packageJson = require('../package.json');
+// Resolve package.json relative to this file — works from both src/ (dev) and out/src/ (compiled)
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const _pkgJsonPath = [
+    path.resolve(__dirname, '../package.json'),
+    path.resolve(__dirname, '../../package.json'),
+].find(p => {
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf8')).name === 'babelfhir-ts';
+    }
+    catch {
+        return false;
+    }
+});
+if (!_pkgJsonPath)
+    throw new Error('Cannot find babelfhir-ts package.json');
+const packageJson = JSON.parse(fs.readFileSync(_pkgJsonPath, 'utf8'));
 function printUsage() {
     console.log("BabelFHIR-TS: Generate TypeScript interfaces from FHIR StructureDefinitions");
     console.log("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "babelfhir-ts",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "BabelFHIR-TS: generate TypeScript interfaces, validators, and helper classes from FHIR R4 StructureDefinitions (profiles) directly inside package archives.",
   "type": "module",
   "main": "out/src/main.js",