fhirsmith 0.5.6 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,44 @@ 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.7.0] - 2026-03-13
+
+### Added
+- Add support for serving for OCL TX content (h/t Italo Macêdo from the OCL team)
+- Add default configurations (wip)
+
+### Changed
+- Make web-crawlers more robust after tx.fhir.org crash
+- Don't accept NPM packages that have .js code or install scripts
+
+### Fixed 
+- Fix many bugs in expansion and validation for value sets that include two different versions of the same code system
+- Fix CodeSystem search on system parameter to reduce user confusion
+- Fix CodeSystem search such that default search is without any specified source
+- Fix headers sent multiple times error
+
+### Tx Conformance Statement
+
+FHIRsmith passed all 1452 HL7 terminology service tests (modes tx.fhir.org+omop+general+snomed, tests v1.9.1-SNAPSHOT, runner v6.8.2)
+
+## [v0.6.0] - 2026-03-06
+
+### Added
+- Add support to packages server for scoped packages
+- Add support for exclusions and content tracking in tx-registry
+- Add support for serving a host
+
+### Changed
+- fix error in SCT expression validation
+- fix null error in search
+- fix search for code systems with uppercase letters in their name
+- rework html interface for CodeSystem and ValueSet
+- further work on publisehr
+
+### Tx Conformance Statement
+
+FHIRsmith passed all 1382 HL7 terminology service tests (modes tx.fhir.org,omop,general,snomed, tests v1.9.0, runner v6.8.2)
+
 ## [v0.5.6] - 2026-02-26
 
 ### Changed

package/README.md

@@ -229,6 +229,8 @@ GitHub Actions will automatically:
    - Change description
    ### Fixed
    - Bug fix description
+   ### Tx Conformance Statement
+     {copy content from text-cases-summary.txt}
 ```
 2. Update `package.json` to have the same release version
 

package/configurations/projector.json

@@ -0,0 +1,21 @@
+{
+  "hostName" : "NPM Publisher",
+  "server": {
+    "port": 3001,
+    "cors": {
+      "origin": true,
+      "credentials": true
+    }
+  },
+  "modules": {
+    "npmprojector": {
+      "enabled": false,
+      "fhirVersion": "r4",
+      "basePath": "/us-core",
+      "npm": "hl7.fhir.us.core#7.0.1",
+      "resourceFolders": ["data"],
+      "searchParametersFolder": "data",
+      "debounceMs": 500
+    }
+  }
+}

package/configurations/readme.md

@@ -0,0 +1,5 @@
+This folder contains some basic starter configurations:
+
+* Terminology server: see tx-config.json for a vanilla server that doesn't contain any licensed content
+* NPM web server: see projector.json for a basic configuration to make a package available online
+

package/library/html-server.js

@@ -72,7 +72,8 @@ class HtmlServer {
       .replace(/\[%total-packages%\]/g, escape(renderOptions.totalPackages.toLocaleString()))
       .replace(/\[%endpoint-path%\]/g, escape(renderOptions.endpointpath))
       .replace(/\[%fhir-version%\]/g, escape(renderOptions.fhirversion))
-      .replace(/\[%ms%\]/g, escape(renderOptions.processingTime.toString()));
+      .replace(/\[%ms%\]/g, escape(renderOptions.processingTime.toString()))
+      .replace(/\[%about%\]/g, renderOptions.about || '');
     
     // Handle any custom template variables
     if (options.templateVars) {

package/library/package-manager.js

@@ -380,7 +380,6 @@ class PackageManager {
             return cachedPath;
         }
 
-        console.log("Fetch Package "+packageId+"#"+version);
         // Not in cache, fetch from servers
         const packageData = await this.fetchFromServers(packageId, resolvedVersion);
 
@@ -593,42 +592,46 @@ class PackageManager {
      * @returns {Promise<string>} Path to extracted package folder
      */
     async fetchUrl(url) {
-        console.log("Fetch Package from URL: " + url);
-        const client = new CIBuildClient();
-        const packageData = await client.fetchFromUrlSpecific(url);
-
-        // Extract to a temp location to read package.json for name and version
-        const tempKey = `_url_temp_${Date.now()}`;
-        const tempPath = await this.extractToCache(tempKey, 'url', packageData);
-        const tempFullPath = path.join(this.cacheFolder, tempPath);
-
-        // Read package name and version from the extracted package
-        const pkgJsonPath = path.join(tempFullPath, 'package', 'package.json');
-        const pkgJson = JSON.parse(await fs.readFile(pkgJsonPath, 'utf8'));
-        const packageId = pkgJson.name;
-        const version = pkgJson.version;
-
-        if (!packageId || !version) {
-            throw new Error(`Package at ${url} has no name or version in package.json`);
-        }
+        try {
+            const client = new CIBuildClient();
+            const packageData = await client.fetchFromUrlSpecific(url);
+
+            // Extract to a temp location to read package.json for name and version
+            const tempKey = `_url_temp_${Date.now()}`;
+            const tempPath = await this.extractToCache(tempKey, 'url', packageData);
+            const tempFullPath = path.join(this.cacheFolder, tempPath);
+
+            // Read package name and version from the extracted package
+            const pkgJsonPath = path.join(tempFullPath, 'package', 'package.json');
+            const pkgJson = JSON.parse(await fs.readFile(pkgJsonPath, 'utf8'));
+            const packageId = pkgJson.name;
+            const version = pkgJson.version;
+
+            if (!packageId || !version) {
+                throw new Error(`Package at ${url} has no name or version in package.json`);
+            }
 
-        // Use the same cache key format as npm packages
-        const finalName = `${packageId}#${version}`;
-        const finalPath = path.join(this.cacheFolder, finalName);
+            // Use the same cache key format as npm packages
+            const finalName = `${packageId}#${version}`;
+            const finalPath = path.join(this.cacheFolder, finalName);
 
-        // If it already exists, the same package is already loaded - that's a config error
-        try {
-            await fs.access(finalPath);
-            await fs.rm(tempFullPath, { recursive: true, force: true });
-            throw new Error(`Package ${finalName} already exists in cache. Check library config for duplicates (url: ${url})`);
-        } catch (e) {
-            if (e.message.includes('already exists')) throw e;
-            // Doesn't exist yet, rename temp to final
-            await fs.rename(tempFullPath, finalPath);
-        }
+            // If it already exists, the same package is already loaded - that's a config error
+            try {
+                await fs.access(finalPath);
+                await fs.rm(tempFullPath, { recursive: true, force: true });
+                throw new Error(`Package ${finalName} already exists in cache. Check library config for duplicates (url: ${url})`);
+            } catch (e) {
+                if (e.message.includes('already exists')) throw e;
+                // Doesn't exist yet, rename temp to final
+                await fs.rename(tempFullPath, finalPath);
+            }
 
-        this.totalDownloaded = this.totalDownloaded + packageData.length;
-        return finalName;
+            this.totalDownloaded = this.totalDownloaded + packageData.length;
+            return finalName;
+        } catch (error) {
+            console.error(`Error fetching package from URL ${url}: ${error.message}`);
+            throw error;
+        }
     }
 
     /**

package/library/utilities.js

@@ -274,4 +274,13 @@ class ArrayMatcher {
   }
 }
 
-module.exports = { Utilities, ArrayMatcher, validateParameter, validateOptionalParameter, validateArrayParameter, validateResource, strToBool, getValuePrimitive, getValueDT, getValueName, isAbsoluteUrl };
+const months = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec'];
+
+function formatDateMMDDYYYY(s) {
+  const mm = parseInt(s.substring(0, 2), 10);
+  const dd = s.substring(2, 4);
+  const yyyy = s.substring(4, 8);
+  return dd + '-' + months[mm - 1] + ' ' + yyyy;
+}
+
+module.exports = { Utilities, ArrayMatcher, validateParameter, validateOptionalParameter, validateArrayParameter, validateResource, strToBool, getValuePrimitive, getValueDT, getValueName, isAbsoluteUrl, formatDateMMDDYYYY };

package/library/version-utilities.js

@@ -1051,6 +1051,91 @@ class VersionUtilities {
             return url;
         }
     }
+
+
+    static isAnInteger(version) {
+        return /^\d+$/.test(version);
+    }
+
+    static appearsToBeDate(version) {
+        if (!version || typeof version !== 'string') return false;
+        // Strip optional time portion (T...) before checking
+        const datePart = version.split('T')[0];
+        return /^\d{4}-?\d{2}(-?\d{2})?$/.test(datePart);
+
+    }
+
+    static guessVersionAlgorithmFromVersion(version) {
+        if (VersionUtilities.isSemVerWithWildcards(version)) {
+            return 'semver';
+        }
+        if (this.appearsToBeDate(version)) {
+            return 'date';
+        }
+        if (this.isAnInteger(version)) {
+            return 'integer';
+        }
+        return 'alpha';
+    }
+
+    static dateIsMoreRecent(date, date2) {
+        return VersionUtilities.normaliseDateString(date) > VersionUtilities.normaliseDateString(date2);
+    }
+
+    static normaliseDateString(date) {
+        // Strip time portion, then remove dashes so all formats compare uniformly as YYYYMMDD or YYYYMM
+        return date.split('T')[0].replace(/-/g, '');
+    }
+
+
+    /**
+     * guesses the correct format, then compares accordingly
+     */
+    static compareVersionsGeneral(version1, version2) {
+        if (version1 && version2) {
+            if (version1 == version2) {
+                return 0;
+            }
+            const fmt1 = VersionUtilities.guessVersionAlgorithmFromVersion(version1);
+            const fmt2 = VersionUtilities.guessVersionAlgorithmFromVersion(version2);
+            if (fmt1 != fmt2) {
+                return version1.localeCompare(version2);
+            }
+            switch (fmt1) {
+                case 'semver': {
+                    let b1 = VersionUtilities.isThisOrLater(version1, version2, VersionPrecision.PATCH);
+                    let b2 = VersionUtilities.isThisOrLater(version2, version1, VersionPrecision.PATCH);
+                    if (b1 && b2) {
+                        return 0;
+                    } else if (b2) {
+                        return 1;
+                    } else {
+                        return -1;
+                    }
+                }
+                case 'date':
+                    if (VersionUtilities.dateIsMoreRecent(version1, version2)) {
+                        return 1;
+                    } else if (VersionUtilities.dateIsMoreRecent(version2, version1)) {
+                        return -1;
+                    } else {
+                        return 0;
+                    }
+                case 'integer':
+                    return parseInt(version1, 10) - parseInt(version2, 10);
+                case 'alpha':
+                    return version1.localeCompare(version2);
+                default:
+                    return version1.localeCompare(version2);
+            }
+        } else if (version1) {
+            return 1;
+        } else if (version2) {
+            return -1;
+        } else {
+            return 0;
+        }
+    }
 }
 
 module.exports = { VersionUtilities, VersionPrecision, SemverParser };

package/package.json

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