babelfhir-ts 1.0.30 → 1.0.31

package/README.md

@@ -58,7 +58,7 @@ Download and process a package directly from a registry (defaults to `https://pa
 babelfhir-ts --package hl7.fhir.us.core@8.0.0
 ```
 
-Download, pocess and install a processed package into your current project:
+Download, process and install a processed package into your current project:
 
 ```bash
 babelfhir-ts install hl7.fhir.us.core@8.0.0
@@ -132,7 +132,7 @@ babelfhir-ts [options] [<input> [output]]
 
 - **Directory** – scan all `.tgz`, `.zip`, or `.json` files inside the folder
 - **Archive** – process a FHIR NPM package in `.tgz` or `.zip` format
-- **StructureDefinition JSON** – generate code for a single profile definitio
+- **StructureDefinition JSON** – generate code for a single profile definition
 
 ## Scripts for contributors
 
@@ -141,7 +141,7 @@ babelfhir-ts [options] [<input> [output]]
 | `npm run generate`           | Execute the CLI against the local `input/` folder and refresh `output/`. |
 | `npm run generate:check`     | End-to-end check: generate, type-check, and lint the emitted output.         |
 | `npm test`                   | Type-check and run all Vitest suites (coverage enabled).                     |
-| `npm run download-validator` | Fetch the official HL7 validation jar used for parity testing.               |
+| `npm test validatorParity`   | Run validator parity tests against Firely .NET SDK validator.                |
 
 ## Caching notes
 
@@ -165,12 +165,21 @@ BabelFHIR-TS is a code generation tool that parses FHIR StructureDefinitions and
 
 ### Validation Scope
 
-- **High-level checks only**: The generated `validate()` functions execute FHIRPath expressions from profile invariants but do **not** perform:
-  - Terminology expansion or ValueSet validation
-  - Reference resolution (checking that referenced resources exist)
-  - Full cardinality enforcement for complex slicing scenarios
-  - Server-side business logic or workflow rules
-- **Use the official validator**: For production conformance testing, use the [HL7 FHIR Validator](https://github.com/hapifhir/org.hl7.fhir.core) alongside BabelFHIR-TS.
+The generated `validate()` methods DO check:
+- **FHIRPath constraints** from StructureDefinition invariants
+- **Cardinality rules** (min/max occurrences)
+- **Required fields** from profiles
+- **Pattern constraints** (patternCodeableConcept, patternCoding)
+- **Slice validation** for common patterns (coding arrays, BackboneElement slices)
+- **Data type correctness** (string, number, boolean, etc.)
+
+The generated validators DO NOT check:
+- **Terminology validation** (ValueSet expansion, code system membership) - requires terminology server
+- **Reference resolution** (checking that referenced resources exist) - requires FHIR server
+- **Complex discriminator types** (type, profile, exists, position) - only pattern/value discriminators supported
+- **Cross-resource business rules** - application-specific logic
+
+For comprehensive conformance testing, use the official [HL7 FHIR Validator](https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator) or [Firely .NET SDK](https://fire.ly/products/firely-net-sdk/).
 
 ### TypeScript Limitations
 
@@ -188,7 +197,7 @@ BabelFHIR-TS is a code generation tool that parses FHIR StructureDefinitions and
   
   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 [HL7 FHIR Validator](https://github.com/hapifhir/org.hl7.fhir.core) or [Firely .NET SDK](https://fire.ly/products/firely-net-sdk/) as the source of truth.
+- **`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) or [Firely .NET SDK](https://fire.ly/products/firely-net-sdk/) as the source of truth.
 
 ### FHIR Version Support
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "babelfhir-ts",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "description": "BabelFHIR-TS: generate TypeScript interfaces, validators, and helper classes from FHIR R4 StructureDefinitions (profiles) directly inside package archives.",
   "type": "module",
   "main": "out/main.js",
@@ -31,7 +31,6 @@
     "generate": "tsx src/main.ts",
     "generate:check": "npm run generate && npm run typecheck && npm run typecheck:output && npm run lint:output",
     "generate:fhir-module": "node scripts/generate-fhir-r4-module.js",
-    "download-validator": "tsx scripts/download-validator.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -50,12 +49,12 @@
   "license": "ISC",
   "repository": {
     "type": "git",
-    "url": "https://github.com/quotentiroler/BabelFHIR-ts.git"
+    "url": "https://github.com/quotentiroler/BabelFHIR-TS.git"
   },
   "bugs": {
-    "url": "https://github.com/quotentiroler/BabelFHIR-ts/issues"
+    "url": "https://github.com/quotentiroler/BabelFHIR-TS/issues"
   },
-  "homepage": "https://github.com/quotentiroler/BabelFHIR-ts#readme",
+  "homepage": "https://github.com/quotentiroler/BabelFHIR-TS#readme",
   "engines": {
     "node": ">=18.0.0",
     "npm": ">=9.0.0"