fhir-data-utils-ts 0.6.19 → 0.6.21

package/dist/data/loinc-subject-matter-domain.data.js

@@ -0,0 +1,179 @@
+// Copyright 2026 Connecting Solution & Applications Ltd under the Apache License, Version 2.0.
+/** Official LOINC Document Ontology Subject matter domain coding system. */
+export const LoincSubjectMatterDomainSystem = 'http://loinc.org';
+/**
+ * Deduplicated LOINC Subject matter domain catalogue supplied from the LOINC
+ * Knowledge Base export. These codes classify human-health document subject
+ * domains. They are not veterinary service types.
+ */
+export const LoincSubjectMatterDomain = Object.freeze([
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP263512-8", display: "Addiction medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172912-0", display: "Addiction psychiatry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172915-3", display: "Aerospace medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345051-9", display: "Allergy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172918-7", display: "Anesthesiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172981-5", display: "Pain medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248728-0", display: "Sleep medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172919-5", display: "Audiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP439903-8", display: "Child life" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172923-7", display: "Chiropractic medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172933-6", display: "Critical care medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172934-4", display: "Dentistry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172935-1", display: "Dermatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172987-2", display: "Pediatric dermatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172940-1", display: "Emergency medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172957-5", display: "Medical toxicology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173027-6", display: "Sports medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP183499-5", display: "Trauma" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP265794-0", display: "Polytrauma" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173035-9", display: "Undersea and hyperbaric medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172942-7", display: "Ethics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172943-5", display: "Family medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172913-8", display: "Adolescent medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172947-6", display: "Geriatric medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172894-0", display: "Forensic medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172946-8", display: "General medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP433455-5", display: "Hospitalist" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP431539-8", display: "Hospice care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345043-6", display: "Immunology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP342846-5", display: "Integrative medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172911-2", display: "Acupuncture" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172952-6", display: "Internal medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172921-1", display: "Cardiovascular disease" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172927-8", display: "Clinical cardiac electrophysiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP269425-7", display: "Heart failure" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172953-4", display: "Interventional cardiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP269424-0", display: "Transplant cardiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172941-9", display: "Endocrinology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172938-5", display: "Diabetology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172945-0", display: "Gastroenterology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172950-0", display: "Hepatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP175685-9", display: "Hematology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP417851-5", display: "Bone Marrow Transplant" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172951-8", display: "Infectious disease" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP183500-0", display: "HIV" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP175686-7", display: "Medical Oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172962-5", display: "Nephrology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP263511-0", display: "Dialysis" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP418387-9", display: "Therapeutic apheresis" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173015-1", display: "Pulmonary disease" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173023-5", display: "Rheumatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP417852-3", display: "Solid organ transplant" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP439901-2", display: "Vascular Access" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172956-7", display: "Medical genetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172926-0", display: "Clinical biochemical genetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172929-4", display: "Clinical genetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP268361-5", display: "Pharmacogenomics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172958-3", display: "Mental health" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345044-4", display: "Eating disorders" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173011-0", display: "Psychiatry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172922-9", display: "Child and adolescent psychiatry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173012-8", display: "Psychology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248501-1", display: "Child and adolescent psychology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248729-8", display: "Neuropsychology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172960-9", display: "Multi-specialty program" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345048-5", display: "Aerodigestive medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP263714-0", display: "Brain injury" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP420041-8", display: "Breastfeeding" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345049-3", display: "Cleft and Craniofacial" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP417672-5", display: "Medical Aid in Dying" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172897-3", display: "Multidisciplinary" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172963-3", display: "Neurological surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345042-8", display: "Spinal surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172964-1", display: "Neurology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172931-0", display: "Clinical neurophysiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248726-4", display: "Epilepsy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172898-1", display: "Neurology w special qualifications in child neuro" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173038-3", display: "Vascular neurology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172968-2", display: "Nuclear medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172899-9", display: "Nutrition and dietetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP269243-4", display: "Obesity medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172971-6", display: "Obstetrics and gynecology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP221284-5", display: "Gynecology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP202989-2", display: "Gynecologic oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172955-9", display: "Maternal and fetal medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP221283-7", display: "Obstetrics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173020-1", display: "Reproductive endocrinology and infertility" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172973-2", display: "Occupational therapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172901-3", display: "Oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172991-4", display: "Pediatric hematology-oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173016-9", display: "Radiation oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP207940-0", display: "Surgical oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172974-0", display: "Ophthalmology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172975-7", display: "Optometry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172902-1", display: "Oral and maxillofacial surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP434806-8", display: "Orthopaedic surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173029-2", display: "Surgery of the hand" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP434870-4", display: "Orthopaedic" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172979-9", display: "Orthotics prosthetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP434767-2", display: "Osteopathic medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172980-7", display: "Otolaryngology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172994-8", display: "Pediatric otolaryngology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172982-3", display: "Palliative care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172983-1", display: "Pastoral care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172984-9", display: "Pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP208907-8", display: "Anatomic pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP208906-0", display: "Clinical pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172920-3", display: "Blood banking and transfusion medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP208902-9", display: "Chemical pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP208903-7", display: "Pathology – Medical microbiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173002-9", display: "Pediatrics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172937-7", display: "Developmental-behavioral pediatrics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172961-7", display: "Neonatal perinatal medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP192135-4", display: "Birth defects" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172985-6", display: "Pediatric cardiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172986-4", display: "Pediatric critical care medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172989-8", display: "Pediatric endocrinology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172990-6", display: "Pediatric gastroenterology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173000-3", display: "Pediatric transplant hepatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172992-2", display: "Pediatric infectious diseases" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172993-0", display: "Pediatric nephrology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172995-5", display: "Pediatric pulmonology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172997-1", display: "Pediatric rehabilitation medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172998-9", display: "Pediatric rheumatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172999-7", display: "Pediatric surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173003-7", display: "Pharmacology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP220238-2", display: "Clinical pharmacology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP447710-7", display: "Clinical pharmacy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173004-5", display: "Physical medicine and rehabilitation" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172954-2", display: "Kinesiotherapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173026-8", display: "Spinal cord injury medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173040-9", display: "Vocational rehabilitation" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173005-2", display: "Physical therapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173006-0", display: "Plastic surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP268363-1", display: "Burn management" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173008-6", display: "Podiatry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP433456-3", display: "Chiropody" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173009-4", display: "Preventive medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172972-4", display: "Occupational medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173010-2", display: "Primary care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP448682-7", display: "Preventive care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173014-4", display: "Public health" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP204156-6", display: "Community health care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP267441-6", display: "Environmental health" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173018-5", display: "Radiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172896-5", display: "Interventional radiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP448142-2", display: "Social Care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173019-3", display: "Recreational therapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173021-9", display: "Research" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173022-7", display: "Respiratory therapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173025-0", display: "Speech-language pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173028-4", display: "Surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248500-3", display: "Bariatric surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172932-8", display: "Colon and rectal surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173030-0", display: "Surgical critical care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173031-8", display: "Thoracic and cardiac surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP207300-7", display: "Cardiac surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173033-4", display: "Transplant surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP434807-6", display: "Trauma Surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173039-1", display: "Vascular surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP269976-9", display: "Thromboembolism" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173034-2", display: "Tumor board" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173036-7", display: "Urology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173001-1", display: "Pediatric urology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248732-2", display: "Womens health" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP185997-6", display: "Wound care management" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP412351-1", display: "Wound, Ostomy, and Continence Care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP448293-3", display: "Rapid response" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP450620-2", display: "Hemodynamic" }),
+]);

package/dist/fhir-search-parameters.d.ts

@@ -8,7 +8,7 @@ export type FhirSearchParameter = Readonly<{
     system?: string;
     unit?: string;
 }>;
-/** Parses one typed FHIR query value without the lossy integer coercion of the retired UHC helper. */
+/** Parses one typed FHIR query value without lossy integer coercion. */
 export declare function parseFhirSearchParameter(input: Readonly<{
     name: string;
     type: FhirSearchParameterType;

package/dist/fhir-search-parameters.js

@@ -1,5 +1,5 @@
 const PREFIX = /^(eq|ne|gt|lt|ge|le|sa|eb|ap)/;
-/** Parses one typed FHIR query value without the lossy integer coercion of the retired UHC helper. */
+/** Parses one typed FHIR query value without lossy integer coercion. */
 export function parseFhirSearchParameter(input) {
     const name = required(input.name, 'fhir_search_name_required');
     const raw = required(input.value, 'fhir_search_value_required');

package/dist/imaging-types.d.ts

@@ -1,4 +1,4 @@
-/** Type-only DICOMDIR tree contract recovered from the retired UHC package. */
+/** Type-only DICOMDIR tree contract. */
 export interface DicomDirectoryNode {
     id: string;
     uid: string;

package/dist/search-models/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Resource-specific search models recovered from the original UHC package.
+ * Resource-specific FHIR search models.
  * Runtime parsing and serialization use `fhir-search-parameters`; these are
  * compile-time compatibility surfaces, not a second query implementation.
  */

package/dist/search-models/index.js

@@ -1,5 +1,5 @@
 /**
- * Resource-specific search models recovered from the original UHC package.
+ * Resource-specific FHIR search models.
  * Runtime parsing and serialization use `fhir-search-parameters`; these are
  * compile-time compatibility surfaces, not a second query implementation.
  */

package/docs/CARE_EMERGENCY_ALERT_CONTRACTS.md

@@ -1,7 +1,7 @@
 # Care, emergency and population-alert FHIR contracts
 
-This package owns only the product-neutral FHIR representation used by the
-three SOSChain journeys that are first proven in VetChain and PetChain.
+This package owns only the product-neutral FHIR representation used by three
+care and emergency journeys.
 Authorization, controller discovery, encryption, transport, storage and UI
 policy remain in their owning product or service layers.
 

package/docs/CLINICAL_TYPED_ACCESSOR_BOUNDARY.md

@@ -24,19 +24,14 @@ The layer split is:
 fhir-data-utils-ts
   canonical claims + R4/R5/R6 import/export
         ↓
-sos-data-utils-ts
-  product-neutral multichannel field schemas
-        ↓
-sos-sdk-core-ts / sos-sdk-node-ts
-  shared orchestration and runtime adapters
-        ↓
-vet-* / uhc-*
-  product forms, portal editors and telephone/chat dialogue
+downstream libraries
+  multichannel schemas, mutable editors, orchestration and product policy
 ```
 
-When Vet or UHC adds a visual, chat or telephone editor for one of these
-fields, it must consume the canonical claim key from this package. It must not
-maintain a second literal, converter or incompatible getter/setter model.
+When a downstream application adds a visual, chat or telephone editor for one
+of these fields, it must consume the canonical claim key from this package. It
+must not maintain a second literal, converter or incompatible getter/setter
+model.
 
 The mutable GDC Bundle API remains documented separately in
 [`gdc-common-utils-ts`](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/docs/101-CLINICAL-ENTRY-GETTERS-SETTERS.md)

package/docs/COMMUNICATION_BUNDLE_CONTRACT.md

@@ -1,9 +1,9 @@
 # Communication Bundle contract
 
 Every cross-participant clinical or administrative exchange uses the same
-two-level FHIR envelope. This is the portable contract for Vet, UHC and
-SOSChain channels; HTTP, DIDComm, encryption and recipient resolution remain
-in their owning SDK or service.
+two-level FHIR envelope. This is the portable contract for downstream
+channels; HTTP, DIDComm, encryption and recipient resolution remain in their
+owning library or service.
 
 ```text
 outer Bundle (type=batch)
@@ -45,10 +45,9 @@ The validator fails closed when the outer resource is not a batch Bundle, an out
 batch entry lacks its request, the Communication has anything other than one
 FHIR Bundle attachment, or the inner Bundle violates its declared type.
 
-`sos-sdk-core` owns the high-level Bundle and Communication editor/reader used
-by SOS, Vet and UHC. `sos-data-utils` owns its cross-sector input contracts and
-fixtures. The historical `gdc-*` editors remain compatibility surfaces until
-their consumers migrate; this package neither imports nor wraps them.
+Downstream libraries own high-level Bundle and Communication editors/readers,
+cross-sector input contracts, fixtures, transport and product policy. This
+package neither imports nor wraps those consumer surfaces.
 
 At the GW persistence boundary, the validated native resources are projected
 to independent `resource.meta.claims` rows. Direct flat-claim CRUD is an

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fhir-data-utils-ts",
-  "version": "0.6.19",
+  "version": "0.6.21",
   "description": "FHIR-version-neutral flat-claim and SearchParameter data utilities",
   "license": "Apache-2.0",
   "type": "module",

package/docs/UHC_FHIR_UTILS_MIGRATION.md

@@ -1,181 +0,0 @@
-# UHC FHIR utilities migration
-
-`uhc-fhir-utils-typescript` is an archaeological source, not a dependency of
-this package. Its useful behavior must be recovered behind neutral, typed and
-version-explicit contracts. Its product branding, obsolete security choices
-and transport assumptions must not be copied.
-
-The wider historical lineage began with early helpers in
-`uhc-helpers-typescript`, was then split and improved across
-`uhc-common-models-typescript`, `uhc-common-utils-typescript`,
-`data-utils-typescript` and the crypto utilities, and later contributed to
-`gdc-common-utils-ts`. For SHC and DGC, the later split packages are the
-preferred behavioural and type evidence; the early helper remains UI-flow
-evidence only.
-
-## Migration rules
-
-1. Add the smallest failing contract test here before porting behavior.
-2. Use official FHIR R4/R5/R6 structures at import/export boundaries and flat
-   claims as the version-neutral representation between those boundaries.
-3. Copy no raw claim, terminology, identifier or profile literal into a
-   consumer. Define it once in its owning neutral or sector data package.
-4. Preserve historical inputs with explicit read adapters. New writers emit
-   only the current canonical representation.
-5. Do not change `gdc-*` while those repositories are frozen. They are
-   read-only compatibility evidence until every consumer uses this package.
-
-## Reuse, rewrite or retire
-
-| Old area | Decision | Current destination or gate |
-| --- | --- | --- |
-| `Bundle` and `Composition` traversal | Rewrite from tests | Neutral graph and explicit R4/R5/R6 adapters; preserve author, attester and section boundaries |
-| `gdc-common-utils-ts` Communication attached-Bundle editor/reader | Preserve as read-only migration evidence | Neutral validation/projection tools live here; the replacement high-level editor/reader belongs to `sos-sdk-core`, with shared input contracts in `sos-data-utils` |
-| `CodeableConcept`, `Identifier`, `Reference`, `Quantity` | Rewrite and reuse behavior | Small typed value modules with round-trip tests |
-| `Observation` and resource parameter models | Rewrite | Canonical claim catalogs plus version-specific projection adapters |
-| `Parameters` conversion | Rewrite | A typed FHIR Parameters module; never a transport-specific envelope |
-| Anonymization field inventory | Test input only | A separately reviewed policy contract; old field lists do not become policy automatically |
-| ATC, LOINC, SNOMED and EMA JSON | Validate before reuse | Terminology service fixtures, never authoritative embedded catalogs |
-| DICOM parsing | Extract later | Separate imaging package; do not add `dicom-parser` to the neutral core |
-| ImagingStudy metadata | Rewrite | Neutral flat claims and R4 projection for subject, encounter, modality, procedure and protected endpoint references; DICOM bytes remain outside |
-| SHA-1 attachment hashing | Retire | No compatibility writer; historical read/verification belongs in a versioned adapter |
-| `MessageHeader` transport conventions | Retire | Transport is outside the FHIR data contract |
-| UHC-branded templates and defaults | Retire or move downstream | Product policy belongs in UHC packages, not here |
-| Babel/Yarn/Jest build plumbing and broad `any` models | Retire | Node 24, TypeScript strict mode and `node:test` |
-
-## Completed source inventory
-
-| Source | Migrated here | Deliberately remains outside |
-| --- | --- | --- |
-| `gdc-common-utils-ts` interoperable claims | All product-neutral claim catalogs, specs and claim helpers, including Consent and the complete SOS Task surface | Schema.org/Gaia-X mapping and runtime policy |
-| `gdc-common-utils-ts` converters | Every product-neutral R4/R5 converter present there; Observation component writing was corrected to use a resource graph | Network, persistence and authorization orchestration |
-| `uhc-fhir-utils-typescript` models | ATC/FHIR/LOINC/SNOMED model types, all resource search parameter enums and template interfaces, strict replacement FHIR primitives | Embedded terminology JSON is not authoritative data |
-| `uhc-fhir-utils-typescript` helpers | Coding/token, Identifier, Reference, Quantity, telecom, RelatedPerson search projection and non-mutating Bundle traversal/classification/reference lookup | Message transport, SHA-1 writers, COVID-era product presets and mutation-heavy manager facades |
-| Later UHC data/common packages | SHC and EU DGC QR prefix classification plus repository-safe examples | Signature verification, issuer trust, credential import and authorization remain separate future contracts |
-| `uhc-fhir-utils-typescript` imaging | DICOMDIR structural types only | Byte parsing and pixel extraction require a separately versioned imaging package |
-| `sos-data-utils-ts` | Cross-sector terminology contract and fixtures, Immunization graph and reminder planning | SOS authorization, repository and emergency policy |
-| `vet-data-utils-ts` | Product-neutral FHIR R5 Group and ResearchStudy contracts/search projections | Animal identity, veterinary sections, species, insurance, payment and other Vet policy |
-| Provider catalogs | R4 HealthcareService claims/converter, geocoded Location claims, one-department professional Group normalization and reviewed C80-to-LOINC candidate mappings | Schema.org images/logo storage, marketplace sector policy, endpoint authorization and communication routing |
-| UHC/Vet SDKs | No transport client was copied | SMART clients, Oracle clients, BFF calls and product workflows remain SDK responsibilities |
-
-The frozen `gdc-*` implementation remains compatibility evidence. New Vet,
-UHC and SOS code uses the replacement high-level API in `sos-sdk-core`, which
-composes the neutral tools exported here. Neither shared replacement package
-imports `gdc-*`. DIDComm wrapping, post-quantum encryption, endpoint selection
-and delivery retries remain in the SDK/service layer.
-
-The migration surface is executable rather than documentary only:
-
-- every migrated claim family has a named catalog and shared list helpers;
-- every migrated product-neutral converter participates in the converter
-  round-trip matrix, with rich optional-field fixtures for complex resources;
-- Encounter retains its originating Appointment and ImagingStudy retains
-  searchable metadata without embedding DICOM object bytes;
-- FHIR primitives, typed searches, Bundle traversal and fallback conversion
-  have strict success and rejection tests;
-- Communication exchange is authored and read only as outer batch Bundle to
-  Communication to inner document/batch/collection Bundle, with files modeled
-  as inner DocumentReference resources;
-- Immunization graphs and reminders live once under `src/builders/`; the former
-  root modules are deprecated re-export shims;
-- Group and ResearchStudy expose named claim constants, preserve member/party
-  correlation as separate rows and reject authorization-shaped data;
-- Organization departments remain distinct from offered HealthcareServices;
-  every independently schedulable service keeps its own stable identity and
-  Location references, while professional Group ownership remains explicit;
-- `buildServiceScheduleFlatGraph(...)` and the R5 Schedule/Slot adapters keep
-  per-service planning horizons and slot intervals shared between Vet and UHC;
-- schedulable child Locations preserve `partOf`, while Schedule actors can
-  combine the service with Location, Device and PractitionerRole capacity;
-  and
-- `npm run check` enforces minimum line, function and branch coverage across
-  converters, builders and core FHIR modules.
-
-This inventory is a boundary decision, not permission to leave another copy in
-new code. Consumers must move to this package bottom-up after its immutable
-release. Existing packages may retain compatibility re-exports only during
-that promotion.
-
-## Observation and component contract
-
-FHIR blood pressure is one native `Observation` with systolic and diastolic
-entries in `Observation.component[]`. Canonical flat storage is instead a
-resource graph: the primary Observation owns `Observation.has-member`, and
-each referenced reduced Observation owns its identifier, subject, category,
-date, component code, numeric value and unit. Reduced entries deliberately
-carry no `Observation.status`, so normal top-level listings ignore them while
-component-level indexes can query their ordinary Observation claims.
-
-The R4/R5 export adapter resolves the primary entry's members and reconstructs
-one native `Observation.component[]`; it does not export three independent
-native Observations. Component entries do not use `is-contained`,
-`contained-parent-reference` or `contained-reference-list`.
-
-Diagnostic laboratory authoring is owned here by
-`buildDiagnosticReportFlatGraph(...)`: `DiagnosticReport.code` identifies the
-report/panel, independent Observation entries carry atomic results, and
-independent DocumentReference entries carry PDF/image evidence. Sector roles,
-confirmation, ledger eligibility, consent and research policy remain outside
-this package.
-
-Aligned JSON arrays and the older comma-separated `Observation.component-*`
-claims are accepted only by the migration reader. No current writer emits
-either representation.
-
-The historical `Observation.bp-systolic-number` and
-`Observation.bp-diastolic-number` fields are accepted only when reading data
-that has no component graph or historical component claims. New writers and
-generic component indexes never emit them. This prevents a new custom claim
-family for every assessment scale.
-
-## Consumer promotion sequence
-
-1. Release this package, pin the immutable version in the lowest downstream
-   package, and run that consumer's complete local matrix.
-2. Remove the corresponding frozen dependency only after no consumer imports
-   that family from it.
-3. Migrate imaging/DICOM byte parsing and terminology payloads as separate changes because
-   they have different dependencies, security rules and release gates.
-
-## Ownership map for new work
-
-| Change | Owning surface |
-| --- | --- |
-| Add or rename a flat storage key | `src/claims/<resource>-claims.ts` |
-| Convert a native R4/R5 resource | `src/converters/convert-<resource>.ts` |
-| Author several correlated resources | `src/builders/` |
-| Preserve an obsolete input | Explicit read-only compatibility adapter |
-| Add transport, SMART or persistence behavior | Owning SDK/service, never this package |
-| Add sector terminology or policy | SOS, Vet or UHC data package |
-| Configure an R5 SubscriptionTopic/Subscription | Native builder and official search catalog in `subscription-r5`; registration remains in the owning service |
-| Persist or deliver a subscription event | GW/BFF transport and storage, never this package |
-
-Converters and builders import catalog symbols. Tests may spell native FHIR
-wire fields, but do not duplicate flat-claim paths except when proving that a
-malformed or invented path is rejected.
-
-## Schema-driven editor boundary
-
-`clinicalArtifactFhirR4ToFlat(...)` and
-`clinicalArtifactEditorClaimsFromFhirR4(...)` are import/read adapters. They
-turn a native FHIR R4 clinical resource into canonical flat claims and never
-own a portal form, authorization or transport decision.
-
-The cross-channel JSON Schema and the `BundleEditor`/`BundleReader` round trip
-belong to `sos-data-utils-ts`. A shared React component consumes both layers:
-FHIR conversion for native imports, then the SOS JSON Schema to select and
-validate editable values and create the claims-first changes Bundle. Portals
-must not add resource-specific claim mappers between those shared layers.
-
-## Subscription notification boundary
-
-FHIR R5 `SubscriptionTopic` and `Subscription` are native configuration
-resources, not flat clinical persistence. This package owns their strict typed
-builders, the official R5 resource-specific SearchParameter catalogs and the
-parser for `Bundle[type=subscription-notification]`. It also owns the minimal
-claims-first terminal Task `Communication` shape so producers and receivers do
-not duplicate claim paths.
-
-HTTP delivery, authentication, durable outbox/inbox storage and browser or
-email/push fan-out remain in GW, DataConv and the product BFFs. The neutral
-package contains no HTTP client and no gateway policy.