fhirsmith 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to the Health Intersections Node Server will be documented i
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v0.8.2] - 2026-03-29
+
+### Added
+
+- Support for implicit snomed concept maps
+
+### Changed
+
+- Reverse the [interpretation of RxNorm [rel] and [rela] value sets](https://chat.fhir.org/#narrow/channel/179202-terminology/topic/Inverted.20query.20for.20RELA.20in.20using.20RxNorm.20page/with/582270767)
+- Improve modifier extension message
+- 
+### Fixed
+
+- fix missing files from npm package
+- Add missing styles to dashboard
+- $translate fixes: don't return duplicate matches, handle R4/R5 issues properly, fix missed comments and products
+- fix handling force-value-set version parameter
+
+### Tx Conformance Statement
+
+FHIRsmith passed all 1498 HL7 terminology service tests (modes tx.fhir.org+omop+general+snomed, tests v1.9.1, runner v6.9.4
+
 ## [v0.8.0] - 2026-03-27
 
 ### Added

package/README.md

@@ -10,7 +10,7 @@ This server provides a set of server-side services that are useful for the FHIR
 
 ## Services useful the community as a whole
 
-* [TX Registry](registry/readme.md) - **Terminology System Registry** as [described by the terminology ecosystem specification](https://build.fhir.org/ig/HL7/fhir-tx-ecosystem-ig)(as running at http://tx.fhir.org/tx-reg)
+* [TX Registry](registry/readme.md) - **Terminology System Registry** as [described by the terminology ecosystem specification](https://build.fhir.org/ig/HL7/fhir-tx-ecosystem-ig) (as running at http://tx.fhir.org/tx-reg)
 * [Package server](packages/readme.md) - **NPM-style FHIR package registry** with search, versioning, and downloads, consistent with the FHIR NPM Specification (as running at http://packages2.fhir.org/packages)
 * [XIG server](xig/readme.md) -  **Comprehensive FHIR IG analytics** with resource breakdowns by version, authority, and realm (as running at http://packages2.fhir.org/packages)
 * [Publisher](publisher/readme.md) - FHIR publishing services (coming)
@@ -43,6 +43,10 @@ There are 4 executable programs:
 
 Unless you're developing, you only need the first two
 
+FHIRsmith is open source - see below, and you're welcome to use it for any kind of use. Note,
+though, that if you support FHIRsmith commercially as part of a managed service or product, you 
+are required to be a Commercial Partner of HL7 - see (link to be provided).
+
 ### Quick Start
 
 * Install FHIRSmith (using docker, or an NPM release, or just get the code by git)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fhirsmith",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "A Node.js server that provides a collection of tools to serve the FHIR ecosystem",
   "main": "server.js",
   "engines": {

package/security.md

@@ -29,4 +29,7 @@ A typical NGINX configuration would be:
   limit_conn perip 50;
   limit_conn perserver 500;
 ```
+## SSL
+
+This server doesn't provide SSL support - use an NGINX reverse proxy for that.
 

package/server.js

@@ -548,8 +548,8 @@ app.get('/dashboard', async (req, res) => {
     const fstats = fs.statfsSync(folders.logsDir());
     const diskPCT = (fstats.bavail * 100) / fstats.blocks;
 
-    let content = '';
-    content += '<table border="1">';
+    let content = '<style>table.grid{margin-bottom:10px;border:1px solid black;margin-right:auto}table.grid th,table.grid td{border:1px solid silver;padding:3px 7px 2px;font-size:12px;line-height:1.4em;font-family:verdana;vertical-align:top}table.grid th{font-weight:bold}table.grid td{font-weight:normal}</style>';
+    content += '<table class="grid">';
     content += '<tr>';
     content += `<td><strong>Uptime:</strong> ${escape(uptimeStr)}</td>`;
     content += `<td><strong>Request Count:</strong> ${stats.requestCount} (static: ${stats.staticRequestCount})</td>`;

package/stats.js

@@ -118,7 +118,7 @@ class ServerStats {
     if (this.taskMap.size == 0) {
       return "";
     }
-    let html = '<table class="grid">';
+    let html = '<table class="grid" >';
     html += "<tr><th>Background Task</th><th>Status</th><th>Frequency</th><th>Last Seen</th></tr>";
     for (let m of this.taskMap.keys()) {
       let mm = this.taskMap.get(m);

package/tx/cs/cs-api.js

@@ -673,11 +673,13 @@ class CodeSystemProvider {
   /**
    * register the concept maps that are implicitly defined as part of the code system
    *
+   * @param {ConceptMap} map the map (this will have been returned from findImplicitConceptMap)
    * @param {Coding} coding the coding to translate
-   * @param {String} target
-   * @returns {CodeTranslation[]} the list of translations
+   * @param {String} target the target code system
+   * @param {boolean} reverse - if the translation is being run backwards
+   * @returns {CodeTranslation[]} the list of translations, each CodeTranslation has map, code, system, version, display, and relationship
    */
-  async getTranslations(coding, target) { return null;}
+  async getTranslations(map, coding, target, reverse) { return null;}
 
   // ==== Parameter checking methods =========
   _ensureLanguages(param) {
@@ -853,7 +855,7 @@ class CodeSystemFactoryProvider {
   }
 
   /**
-   * see comemnts for registerSupplements()
+   * see comments for registerSupplements()
    *
    * @param {CodeSystem} supplement - the supplement to flesh out
    * @returns void
@@ -865,6 +867,8 @@ class CodeSystemFactoryProvider {
   /**
    * build and return a known concept map from the URL, if there is one.
    *
+   * the conceptmap is never visible to a user; if it has an implicitSource, then
+   * provider.getTranslations will be called when it's actually used
    * @param url
    * @param version
    * @returns {ConceptMap}

package/tx/cs/cs-omop.js

@@ -660,8 +660,10 @@ class OMOPServices extends BaseCSServices {
   }
 
   // Translation support
-  async getTranslations(coding, target) {
-    
+  async getTranslations(map, coding, target) {
+    if (map == null) {
+      return;
+    }
 
     const vocabId = getVocabId(target);
     if (vocabId === -1) {
@@ -680,7 +682,7 @@ class OMOPServices extends BaseCSServices {
           reject(err);
         } else {
           const translations = rows.map(row => ({
-            uri: target,
+            system: target,
             code: row.concept_code,
             display: row.concept_name,
             relationship: 'equivalent',

package/tx/cs/cs-rxnorm.js

@@ -395,24 +395,24 @@ class RxNormServices extends CodeSystemProvider {
       } else if (this.rels.includes(prop)) {
         if (value.startsWith('CUI:')) {
           const cui = value.substring(4);
-          sql = `AND (${this.getCodeField()} IN (SELECT ${this.getCodeField()} FROM rxnconso WHERE RXCUI IN (SELECT RXCUI1 FROM rxnrel WHERE REL = $rel AND RXCUI2 = $cui2)))`;
+          sql = `AND (${this.getCodeField()} IN (SELECT ${this.getCodeField()} FROM rxnconso WHERE RXCUI IN (SELECT RXCUI2 FROM rxnrel WHERE REL = $rel AND RXCUI1 = $cui2)))`;
           params.rel = this.#sqlWrapString(prop);
           params.cui2 = this.#sqlWrapString(cui);
         } else if (value.startsWith('AUI:')) {
           const aui = value.substring(4);
-          sql = `AND (${this.getCodeField()} IN (SELECT ${this.getCodeField()} FROM rxnconso WHERE RXAUI IN (SELECT RXAUI1 FROM rxnrel WHERE REL = $rel AND RXAUI2 = $aui2)))`;
+          sql = `AND (${this.getCodeField()} IN (SELECT ${this.getCodeField()} FROM rxnconso WHERE RXAUI IN (SELECT RXAUI2 FROM rxnrel WHERE REL = $rel AND RXAUI1 = $aui2)))`;
           params.rel = this.#sqlWrapString(prop);
           params.aui2 = this.#sqlWrapString(aui);
         }
       } else if (this.reltypes.includes(prop)) {
         if (value.startsWith('CUI:')) {
           const cui = value.substring(4);
-          sql = `AND (${this.getCodeField()} IN (SELECT ${this.getCodeField()} FROM rxnconso WHERE RXCUI IN (SELECT RXCUI1 FROM rxnrel WHERE RELA = $rela AND RXCUI2 = $cui2)))`;
+          sql = `AND (${this.getCodeField()} IN (SELECT ${this.getCodeField()} FROM rxnconso WHERE RXCUI IN (SELECT RXCUI2 FROM rxnrel WHERE RELA = $rela AND RXCUI1 = $cui2)))`;
           params.rela = this.#sqlWrapString(prop);
           params.cui2 = this.#sqlWrapString(cui);
         } else if (value.startsWith('AUI:')) {
           const aui = value.substring(4);
-          sql = `AND (${this.getCodeField()} IN (SELECT ${this.getCodeField()} FROM rxnconso WHERE RXAUI IN (SELECT RXAUI1 FROM rxnrel WHERE RELA = $rela AND RXAUI2 = $aui2)))`;
+          sql = `AND (${this.getCodeField()} IN (SELECT ${this.getCodeField()} FROM rxnconso WHERE RXAUI IN (SELECT RXAUI2 FROM rxnrel WHERE RELA = $rela AND RXAUI1 = $aui2)))`;
           params.rela = this.#sqlWrapString(prop);
           params.aui2 = this.#sqlWrapString(aui);
         }
@@ -498,8 +498,6 @@ class RxNormServices extends CodeSystemProvider {
   }
 
   async filterSize(filterContext, set) {
-    
-
     if (!set.executed) {
       await this.#executeFilter(set);
     }

package/tx/cs/cs-snomed.js

@@ -12,6 +12,7 @@ const {
 const {DesignationUse} = require("../library/designations");
 const {BaseCSServices} = require("./cs-base");
 const {formatDateMMDDYYYY} = require("../../library/utilities");
+const {ConceptMap} = require("../library/conceptmap");
 
 // Context kinds matching Pascal enum
 const SnomedProviderContextKind = {
@@ -1213,6 +1214,64 @@ class SnomedProvider extends BaseCSServices {
            (cd.use.code === '900000000000013009' || cd.use.code === '900000000000003001');
   }
 
+  async getTranslations(map, coding, target, reverse) {
+    if (!map || (target && target !== this.system()) || reverse) {
+      return [];
+    }
+    let ref = this.sct.concepts.findConcept(map.id);
+    if (!ref.found) {
+      return [];
+    }
+    let rref = this.sct.refSetIndex.getRefSetByConcept(ref.index);
+    if (rref == -1) {
+      return [];
+    }
+    let refSetRecord = this.sct.refSetIndex.getReferenceSet(rref);
+    let members = this.sct.refSetMembers.getMembers(refSetRecord.membersByRef);
+    let srcConcept = this.sct.concepts.findConcept(coding.code);
+    if (!srcConcept.found) {
+      return [];
+    }
+
+    let result = [];
+    let L = 0;
+    let H = members.length - 1;
+    while (L <= H) {
+      const I = Math.floor((L + H) / 2);
+      const ref = members[I].ref;
+      if (ref < srcConcept.index) {
+        L = I + 1;
+      } else if (ref > srcConcept.index) {
+        H = I - 1;
+      } else {
+        // Found — but scan left for first match in case of duplicates
+        let first = I;
+        while (first > 0 && members[first - 1].ref === srcConcept.index) {
+          first--;
+        }
+        // Process all matching members
+        for (let i = first; i < members.length && members[i].ref === srcConcept.index; i++) {
+          let values = this.sct.refs.getReferences(members[i].values);
+          if (values && values.length >= 1) {
+            let tgtId = String(this.sct.concepts.getConceptId(values[0]));
+            let ct = {
+              map: map.vurl,
+              code: tgtId,
+              system: this.system(),
+              version : this.version(),
+              display: await this.display(tgtId),
+              relationship: map.jsonObj.relationship
+            }
+            result.push(ct);
+          }
+        }
+        break;
+      }
+    }
+
+    return result;
+  }
+
 }
 
 /**
@@ -1339,7 +1398,7 @@ class SnomedServicesFactory extends CodeSystemFactoryProvider {
         return null;
       }
       let rref = this.snomedServices.refSetIndex.getRefSetByConcept(ref.index);
-      if (rref == 0) {
+      if (rref == -1) {
         return null;
       }
       return {
@@ -1448,6 +1507,59 @@ class SnomedServicesFactory extends CodeSystemFactoryProvider {
 
     return edition + ' ' + formatDateMMDDYYYY(match[2].substring(4, 6) + match[2].substring(6, 8) + match[2].substring(0, 4));
   }
+
+  async findImplicitConceptMap(url, version) {
+    if (version && (version !== this.version())) {
+      return null;
+    }
+    if (!url || !url.startsWith(this.system()+"?fhir_cm=")) {
+      return null;
+    }
+    let id = url.substring(url.indexOf("=")+1);
+    if (['900000000000523009', '900000000000526001', '900000000000527005', '900000000000530003'].includes(id)) {
+      let name = '';
+      let relationship = '';
+      switch (id) {
+        case '900000000000523009':
+          name = 'POSSIBLY EQUIVALENT TO';
+          relationship = 'inexact';
+          break;
+        case '900000000000526001':
+          name = 'REPLACED BY';
+          relationship = 'equivalent';
+          break;
+        case '900000000000527005':
+          name = 'SAME AS';
+          relationship = 'equal';
+          break;
+        case '900000000000530003':
+          name = 'ALTERNATIVE';
+          relationship = 'inexact';
+          break;
+      }
+      let cm = {
+        resourceType: 'ConceptMap',
+        internalSource : this,
+        relationship: relationship,
+        id : id,
+        url: `${this.system}?fhir_cm=${id}`,
+        version: this.version(),
+        name: `SNOMED CT ${name} Concept Map`,
+        description: `The concept map implicitly defined by the ${name} Association Reference Set`,
+        copyright: 'This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (SNOMED International), and distributed by agreement between SNOMED International and HL7',
+        status: 'active',
+        sourceUri: `${this.system}?fhir_vs`,
+        targetUri: `${this.system}?fhir_vs`,
+        group: [{
+          source: 'http://snomed.info/sct',
+          target: 'http://snomed.info/sct'
+        }]
+      }
+      return new ConceptMap(cm);
+    } else {
+      return null;
+    }
+  }
 }
 
 function getEditionName(edition) {

package/tx/data/cs-de.json

@@ -0,0 +1,186 @@
+{
+  "resourceType" : "CodeSystem",
+  "language" : "de",
+  "id" : "de-multi",
+  "url" : "http://hl7.org/fhir/test/CodeSystem/de-multi",
+  "name" : "TestCodeSystemMultiLangDE",
+  "title" : "Testcodesystem mit mehreren Sprachen",
+  "title:en" : "Test Code System with Multiple Languages",
+  "_title" : {
+    "extension" : [{
+      "url" : "http://hl7.org/fhir/StructureDefinition/translation",
+      "extension" : [{
+        "url" : "lang",
+        "valueCode" : "en"
+      },{
+        "url" : "content",
+        "valueString" : "Test Code System with Multiple Languages"
+      }]
+    }]
+  },
+  "status" : "active",
+  "experimental" : false,
+  "date" : "2023-04-01",
+  "publisher" : "FHIR Project",
+  "caseSensitive" : true,
+  "content" : "complete",
+  "concept" : [{
+    "code" : "code1",
+    "display" : "Anzeige 1",
+    "definition" : "Mein erster Code",
+    "definition:en" : "My first code",
+    "_definition" : {
+      "extension" : [{
+        "url" : "http://hl7.org/fhir/StructureDefinition/translation",
+        "extension" : [{
+          "url" : "lang",
+          "valueCode" : "en"
+        },{
+          "url" : "content",
+          "valueString" : "My first code"
+        }]
+      }]
+    },
+    "designation" : [{
+      "language" : "en",
+      "value" : "Display 1"
+    }]
+  },
+  {
+    "code" : "code2",
+    "display" : "Anzeige 2",
+    "definition" : "Mein zweiter Code, mit Kindern",
+    "definition:en" : "My second code, with children",
+    "_definition" : {
+      "extension" : [{
+        "url" : "http://hl7.org/fhir/StructureDefinition/translation",
+        "extension" : [{
+          "url" : "lang",
+          "valueCode" : "en"
+        },{
+          "url" : "content",
+          "valueString" : "My second code, with children"
+        }]
+      }]
+    },
+    "designation" : [{
+      "language" : "de-CH",
+      "value" : "Anzeige 2"
+    },{
+      "language" : "es",
+      "value" : "Mostrar 2"
+    },{
+      "language" : "en",
+      "value" : "Display 2"
+    }],
+    "concept" : [{
+      "code" : "code2a",
+      "display" : "Anzeige 2a",
+      "definition" : "Mein erster Second-Level-Code",
+      "definition:en" : "My first second level code",
+      "_definition" : {
+        "extension" : [{
+          "url" : "http://hl7.org/fhir/StructureDefinition/translation",
+          "extension" : [{
+            "url" : "lang",
+            "valueCode" : "en"
+          },{
+            "url" : "content",
+            "valueString" : "My first second level code"
+          }]
+        }]
+      },
+      "designation" : [{
+        "language" : "en",
+        "value" : "Display 2a"
+      },{
+        "language" : "es",
+        "value" : "Mostrar 2a"
+      }],
+      "concept" : [{
+        "code" : "code2aI",
+        "display" : "Anzeige 2aI",
+        "definition" : "Mein erster Third-Level-Code",
+        "definition:en" : "My first third level code",
+        "_definition" : {
+          "extension" : [{
+            "url" : "http://hl7.org/fhir/StructureDefinition/translation",
+            "extension" : [{
+              "url" : "lang",
+              "valueCode" : "en"
+            },{
+              "url" : "content",
+              "valueString" : "My first third level code"
+            }]
+          }]
+        },
+        "designation" : [{
+          "language" : "es",
+          "value" : "Mostrar 2aI"
+        }]
+      },
+      {
+        "code" : "code2aII",
+        "display" : "Anzeige 2aII",
+        "definition" : "Mein zweiter Third-Level-Code",
+        "definition:en" : "My second third level code",
+        "_definition" : {
+          "extension" : [{
+            "url" : "http://hl7.org/fhir/StructureDefinition/translation",
+            "extension" : [{
+              "url" : "lang",
+              "valueCode" : "en"
+            },{
+              "url" : "content",
+              "valueString" : "My second third level code"
+            }]
+          }]
+        }
+      }]
+    },
+    {
+      "code" : "code2b",
+      "display" : "Anzeige 2b",
+      "definition" : "Mein zweiter Second-Level-Code",
+      "definition:en" : "My second second level code",
+      "_definition" : {
+        "extension" : [{
+          "url" : "http://hl7.org/fhir/StructureDefinition/translation",
+          "extension" : [{
+            "url" : "lang",
+            "valueCode" : "en"
+          },{
+            "url" : "content",
+            "valueString" : "My second second level code"
+          }]
+        }]
+      },
+      "designation" : [{
+        "language" : "en",
+        "value" : "Display 2b"
+      }]
+    }]
+  },
+  {
+    "code" : "code3",
+    "display" : "Anzeige 3",
+    "definition" : "Mein Third-Level-Code",
+    "definition:en" : "My Third Level Code",
+    "_definition" : {
+      "extension" : [{
+        "url" : "http://hl7.org/fhir/StructureDefinition/translation",
+        "extension" : [{
+          "url" : "lang",
+          "valueCode" : "en"
+        },{
+          "url" : "content",
+          "valueString" : "My Third Level Code"
+        }]
+      }]
+    },
+    "designation" : [{
+      "language" : "en",
+      "value" : "Display 3"
+    }]
+  }]
+}

package/tx/data/cs-extensions.json

@@ -0,0 +1,92 @@
+{
+  "resourceType" : "CodeSystem",
+  "language" : "en",
+  "id" : "extensions",
+  "url" : "http://hl7.org/fhir/test/CodeSystem/extensions",
+  "name" : "ExtensionsTestCodeSystem",
+  "title" : "Extensions Test Code System",
+  "status" : "active",
+  "experimental" : false,
+  "date" : "2023-04-01",
+  "publisher" : "FHIR Project",
+  "caseSensitive" : true,
+  "content" : "complete",
+  "property" : [{
+    "code" : "prop",
+    "uri" : "http://hl7.org/fhir/test/CodeSystem/properties#prop",
+    "type" : "code"
+  },{
+    "code" : "alternateCode",
+    "uri" : "http://hl7.org/fhir/concept-properties#alternateCode",
+    "description" : "This property contains an alternative code that may be used to identify this concept instead of the primary code",
+    "type" : "code"
+  }],
+  "concept" : [{
+    "code" : "code1",
+    "display" : "Display 1",
+    "definition" : "My first code",
+    "extension" : [{
+      "url" : "http://hl7.org/fhir/StructureDefinition/codesystem-conceptOrder",
+      "valueInteger" : 6
+    }],
+    "designation" : [{
+      "language" : "de",
+      "value" : "Mein erster Code",
+      "extension" : [{
+        "url" : "http://hl7.org/fhir/StructureDefinition/coding-sctdescid",
+        "valueId" : "234234"
+      }]
+    }]
+  },{
+    "code" : "code2",
+    "display" : "Display 2",
+    "definition" : "My second code",
+    "extension" : [{
+      "url" : "http://hl7.org/fhir/StructureDefinition/codesystem-conceptOrder",
+      "valueInteger" : 5
+    }]
+  },
+  {
+    "code" : "code3",
+    "display" : "Display 3",
+    "definition" : "My third code",
+    "extension" : [{
+      "url" : "http://hl7.org/fhir/StructureDefinition/rendering-style",
+      "valueString" : "font-weight: bold; font-decoration: strikethrough"
+    },{
+      "url" : "http://hl7.org/fhir/StructureDefinition/rendering-xhtml",
+      "valueString" : "<span style=\"color: maroon\">This is a dumb way to do things</span>"
+    },{
+      "url" : "http://hl7.org/fhir/StructureDefinition/codesystem-conceptOrder",
+      "valueInteger" : 4
+    }]
+  },
+  {
+    "code" : "code4",
+    "display" : "Display 4",
+    "definition" : "My fourth code",
+    "extension" : [{
+      "url" : "http://hl7.org/fhir/StructureDefinition/codesystem-conceptOrder",
+      "valueInteger" : 3
+    }]
+  },
+  {
+    "code" : "code5",
+    "display" : "Display 5",
+    "definition" : "My fifth code",
+    "extension" : [{
+      "url" : "http://hl7.org/fhir/StructureDefinition/codesystem-conceptOrder",
+      "valueInteger" : 2
+    }]
+  },
+  {
+    "code" : "code6",
+    "display" : "Display 6",
+    "definition" : "My sixth code",
+    "extension" : [{
+      "url" : "http://hl7.org/fhir/StructureDefinition/codesystem-conceptOrder",
+      "valueInteger" : 1
+    }]
+  }
+  ]
+}