fhirsmith 0.8.5 → 0.9.0

package/CHANGELOG.md

@@ -5,6 +5,57 @@ 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.9.0] - 2026-04-09
+
+### Added
+
+- TX: VSAC upgrade to pick up more changes
+- TX: add definition of $related operation to CapabilityStatement
+
+### Changed
+
+- TX: Deal with regex Denial of Service Issue
+- TX: improve fragment handling in extensions per TI decision 
+- TX: Reduce snomed loaded versions - have already moved to affiliate managed servers
+- TX: fix bug handling excluded concepts using a filter
+- improve dashboard template
+ 
+### Fixed
+
+- Update dependencies for security fixes
+- TX: fix error in SNOMED translate for implicit concept maps
+- TX: Fix OCL cache invalidation and case-insensitive concept lookups
+- Publisher: fix handling of web templates folder
+- Publisher: fix webtemplates table headings
+
+### Tx Conformance Statement
+
+FHIRsmith passed all 1578 HL7 terminology service tests (modes tx.fhir.org+omop+general+snomed, tests v1.9.1, runner v6.9.5)
+
+## [v0.8.6] - 2026-04-06
+
+### Added
+
+- TX: Full support for $related operation
+- Add sponsor message to footer on all pages
+
+### Changed
+
+- TX: Improve $expand efficiency slightly
+- Rework logging for efficiency and configurability
+- TX: Try to make the server more resistant to running out of memory and dying
+- Improve memory reporting on dashboard and home pages
+- improve metadata display for resources
+
+### Fixed
+
+- Fix up tx test version to be correct in capabilities statement
+- Fix security warning
+
+### Tx Conformance Statement
+
+FHIRsmith passed all 1497 HL7 terminology service tests (modes tx.fhir.org+omop+general+snomed, tests v1.9.1, runner v6.9.4)
+
 ## [v0.8.5] - 2026-04-02
 
 ### Added

package/README.md

@@ -14,17 +14,17 @@ This server provides a set of server-side services that are useful for the FHIR
 * [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 (as running at [healthintersections.com.au](http://www.healthintersections.com.au/publisher))
-* [VCL](vcl/readme.md) - **Parse VCL expressions** into FHIR ValueSet resources (as running at http://fhir.org/vcl) 
+* [VCL](vcl/readme.md) - **Parse VCL expressions** into FHIR ValueSet resources (as running at http://fhir.org/vcl)
 * (Coming) Token services
 
 ## Summary Statement
 
-* Maintainers: Grahame Grieve, Italo Macêdo, Josh Mandel, Jose Costa Teixeira 
+* Maintainers: Grahame Grieve, Italo Macêdo, Josh Mandel, Jose Costa Teixeira
 * Issues / Discussion: Use github issues
 * License: BSD-3
-* Contribution Policy: Make PRs. PRs have to pass all the tests 
+* Contribution Policy: Make PRs. PRs have to pass all the tests
 * Security Information: See [security.md](security.md)
- 
+
 ## Build Status
 ![CI Build](https://github.com/HealthIntersections/fhirsmith/actions/workflows/ci.yml/badge.svg)
 [![Release](https://img.shields.io/github/v/release/HealthIntersections/fhirsmith?include_prereleases)](https://github.com/HealthIntersections/fhirsmith/releases)
@@ -44,15 +44,15 @@ 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 
+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)
-* Figure out the data directory 
+* Figure out the data directory
 * Provide a configuration to tell the server what to run (see documentation below, or use a [prebuilt configuration]/configurations/readme.md)
-* Run the server 
+* Run the server
 
 For further details of these steps, read on
 
@@ -128,6 +128,36 @@ Create a `config.json` file in your data directory (use `config-template.json` a
 }
 ```
 
+### Logging Configuration
+
+Add a `logging` section to `config.json` to control log behaviour. All fields are optional and have sensible defaults:
+
+```json
+{
+  "logging": {
+    "level": "info",
+    "console": true,
+    "consoleErrors": false,
+    "maxFiles": 14,
+    "maxSize": "50m",
+    "flushInterval": 2000,
+    "flushSize": 200
+  }
+}
+```
+
+| Option | Default | Description |
+|---|---|---|
+| `level` | `"info"` | Minimum level to log: `error`, `warn`, `info`, `debug`, or `verbose` |
+| `console` | `true` | Write log lines to stdout/stderr. Disable when running as a systemd service where console output goes to the journal and is redundant |
+| `consoleErrors` | `false` | Whether `error` and `warn` levels appear on the console. When `false`, errors and warnings are written to the log file only |
+| `maxFiles` | `14` | Number of daily log files to retain before old ones are deleted |
+| `maxSize` | `0` (unlimited) | Maximum size per log file before rotation. Accepts human-readable strings: `"20m"`, `"1g"`, or a raw byte count |
+| `flushInterval` | `2000` | Milliseconds between buffered writes to disk. Increase to reduce I/O under heavy load |
+| `flushSize` | `200` | Number of buffered log lines that trigger an immediate flush regardless of the timer |
+
+Log files are written to the `logs/` subdirectory of the data directory as `server-YYYY-MM-DD.log`. A `server.log` symlink always points to the current day's file, so `tail -f data/logs/server.log` tracks the active log without needing to know the date.
+
 ### Start the Server
 
 ```bash
@@ -211,8 +241,8 @@ Available tags:
 
 ### Windows Installation
 
-You can install as a windows service using [windows-install.js](utilities/windows-install.js). You might need to 
-hack that. 
+You can install as a windows service using [windows-install.js](utilities/windows-install.js). You might need to
+hack that.
 
 ## Releases
 
@@ -224,9 +254,9 @@ Each GitHub Release includes:
 - **Release notes** extracted from CHANGELOG.md
 - **Source code** archives (zip and tar.gz)
 - **Docker images** pushed to GitHub Container Registry:
-  - `ghcr.io/healthintersections/fhirsmith:latest`
-  - `ghcr.io/healthintersections/fhirsmith:vX.Y.Z`
-  - `ghcr.io/healthintersections/fhirsmith:X.Y.Z`
+    - `ghcr.io/healthintersections/fhirsmith:latest`
+    - `ghcr.io/healthintersections/fhirsmith:vX.Y.Z`
+    - `ghcr.io/healthintersections/fhirsmith:X.Y.Z`
 - **npm package** published to npmjs.org as `fhirsmith` *(if you add this)*
 
 ### Creating a Release
@@ -244,13 +274,13 @@ GitHub Actions will automatically:
 1. Update `CHANGELOG.md` with your changes under a new version section:
 ```markdown
    ## [vX.Y.Z] - YYYY-MM-DD
-   ### Added
-   - New feature description
-   ### Changed
-   - Change description
-   ### Fixed
-   - Bug fix description
-   ### Tx Conformance Statement
+### Added
+- New feature description
+### Changed
+- 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
@@ -270,9 +300,9 @@ or do it via a PR
 ```
 
 5. Monitor the release:
-   - Check [GitHub Actions](https://github.com/HealthIntersections/fhirsmith/actions) for the Release workflow
-   - Verify the [GitHub Release](https://github.com/HealthIntersections/fhirsmith/releases) was created
-   - Confirm Docker images are available at [GHCR](https://github.com/HealthIntersections/fhirsmith/pkgs/container/fhirsmith)
+    - Check [GitHub Actions](https://github.com/HealthIntersections/fhirsmith/actions) for the Release workflow
+    - Verify the [GitHub Release](https://github.com/HealthIntersections/fhirsmith/releases) was created
+    - Confirm Docker images are available at [GHCR](https://github.com/HealthIntersections/fhirsmith/pkgs/container/fhirsmith)
 
 6. Update `package.json` to have the next release version -SNAPSHOT
 

package/extension-tracker/extension-tracker-template.html

@@ -92,7 +92,9 @@
 				<p>
                     <a href="http://www.hl7.org/fhir" style="color: gold" title="Fast Healthcare Interoperability Resources - Home Page"><img border="0" src="/icon-fhir-16.png" style="vertical-align: text-bottom"/> <b>FHIR</b></a> &copy; HL7.org 2011+.  &nbsp;|&nbsp;
                     <a href="https://github.com/HealthIntersections/FHIRsmith/blob/main/README.md" style="color: gold"><img border="0" src="/FHIRsmith16.png" style="vertical-align: text-bottom"/> FHIRsmith</a>  [%ver%]  &copy; HealthIntersections.com.au 2023+ &nbsp;|&nbsp;
-                    [%total-packages%] packages tracked &nbsp;|&nbsp; ([%ms%] ms)
+                    [%total-packages%] packages tracked &nbsp;|
+                    &nbsp; ([%ms%] ms)
+                    [%sponsorMessage%]
         </p>
 			</div>  <!-- /inner-wrapper -->
 		</div>  <!-- /container -->

package/library/html-server.js

@@ -9,6 +9,8 @@ const fs = require('fs');
 const path = require('path');
 const escape = require('escape-html');
 
+let sponsorMessage = '';
+
 class HtmlServer {
   log;
 
@@ -20,6 +22,10 @@ class HtmlServer {
     this.log = logv;
   }
 
+  setSponsorMessage(msg) {
+    sponsorMessage = msg;
+  }
+
   // Template Management
   loadTemplate(templateName, templatePath) {
     try {
@@ -73,6 +79,7 @@ class HtmlServer {
       .replace(/\[%endpoint-path%\]/g, escape(renderOptions.endpointpath))
       .replace(/\[%fhir-version%\]/g, escape(renderOptions.fhirversion))
       .replace(/\[%ms%\]/g, escape(renderOptions.processingTime.toString()))
+      .replace(/\[%sponsorMessage%\]/g, sponsorMessage)
       .replace(/\[%about%\]/g, renderOptions.about || '');
     
     // Handle any custom template variables