SUSHI 3.16.5 contains several fixes made by the community for the community. Many thanks to @benjaminflessner, @ElliotSilver, @grahamegrieve, and @JohnMoehrke for making this release possible! We love to see the contributions!

What's Changed

• Improve error message for unsupported versions of FHIR by @grahamegrieve in #1586
• Recognize _build.bat/sh as a standard IG script by @JohnMoehrke in #1588
• Allow base types as profiles in type constraint rules by @benjaminflessner in #1589
• Correct misleading directory creation prompt by @ElliotSilver in #1593

New Contributors

• @grahamegrieve made their first contribution in #1586
• @JohnMoehrke made their first contribution in #1588
• @benjaminflessner made their first contribution in #1589
• @ElliotSilver made their first contribution in #1593

Install or Update

SUSHI 3.16.5 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.16.5, run the following command:

$ npm install -g fsh-sushi

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.16.4...v3.16.5

SUSHI 3.16.4 includes important bug fixes that have been reported by the FSH community.

Special thanks to @Paqrat76 for contributing fixes to ensure that SUSHI propagates versions from Parent to baseDefinition and InstanceOf to meta.profile when appropriate!

What's Changed

• Export Canonical Version in Parent and InstanceOf by @Paqrat76 in #1580
• VS Caret Rule Processing: Ignore Components with Filters by @cmoesel in #1583
• Support constraining reference types with version-pinned targets by @cmoesel in #1585

New Contributors

• @Paqrat76 made their first contribution in #1580 (although, not really, since he made significant contributions in the past as @joepaquette!)

Install or Update

SUSHI 3.16.4 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.16.4, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.16.3

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.16.3...v3.16.4

SUSHI 3.16.3 updates FHIR Package Loader to version 2.2.2 in order to resolve a bug with using custom NPM registries and auth tokens. Thank you, @bkaney for the bug fix!

What's Changed

• FHIR Package Loader patch update by @cmoesel in 3abd1b9

Full Changelog: v3.16.2...v3.16.3

Install or Update

SUSHI 3.16.3 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.16.3, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.16.2

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

SUSHI 3.16.2 updates FHIR Package Loader to version 2.2.1 in order to resolve a bug with using custom NPM registries. Thank you, @bkaney for the bug fix!

What's Changed

• FHIR Package Loader patch update by @cmoesel in fde901a

Full Changelog: v3.16.1...v3.16.2

Install or Update

SUSHI 3.16.2 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.16.2, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.16.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

SUSHI 3.16.1 updates its dependency libraries to their latest versions. The fhir-package-loader v2.2.0 update brings in the following new feature for SUSHI:

• Allow users to specify an auth header to include when accessing a custom NPM registry. To do so, specify a bearer token in the FPL_REGISTRY_TOKEN environment variable (note: requires use of FPL_REGISTRY environment variable as well). Many thanks to @bkaney for this contribution to fhir-package-loader.

What's Changed

• Dependency Updates June 2025 by @cmoesel in #1573

Full Changelog: v3.16.0...v3.16.1

Install or Update

SUSHI 3.16.1 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.16.1, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.16.0

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

The SUSHI 3.16.0 release adds support for using NPM aliases when declaring dependencies. This allows authors to declare dependencies on multiple versions of the same package. The syntax for NPM aliases is alias@npm:packageId. For example:

dependencies:
  hl7.fhir.us.core: 7.0.0
  v610@npm:hl7.fhir.us.core: 6.1.0
  v311@npm:hl7.fhir.us.core: 3.1.1

Notes:

• The alias (prefix before @npm:) follows the same rules as ids, allowing for A-Z, a-z, 0-9, -, and ..
• These aliases can also be used in the longer-form dependency syntax (for manually specifying an id, uri, reason, etc.).
• The alias cannot be referenced in FSH content; its only purpose is to allow multiple versions of the same dependency package.
• When resolving versionless references to resources that are in multiple packages, SUSHI will resolve to the latest version.
• This feature is not yet fully supported in all FHIR tools. We don't recommend using it until you see an announcement on Zulip.

What's Changed

• Support for NPM aliases in dependencies by @cmoesel in #1568

Full Changelog: v3.15.1...v3.16.0

Install or Update

SUSHI 3.16.0 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.16.0, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.15.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

SUSHI 3.15.1 fixes an issue generating the ImplementationGuide JSON when dependencies are specified using the .x wildcard patch version. It also updates FHIR Package Loader to v2.1.2, which downgrades an error to a warning when a #current dependency can't be downloaded from the build server but already exists in the cache (so processing can continue).

What's Changed

• Fix bug detecting dependency uri when wildcard patch is used by @cmoesel in #1566
• Update FPL to v2.1.2 by @cmoesel in #1567

Full Changelog: 3.15.0...v3.15.1

Install or Update

SUSHI 3.15.1 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.15.1, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.15.0

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

SUSHI 3.15.0 is a minor release that moves the generated fsh-index.json file from fsh-generated to fsh-generated/data. This allows for the fsh-index.json file to be more easily leveraged by templates and tooling. Many thanks to @costateixeira for this contribution!

What's Changed

• place fsh-index.json in the data folder by @costateixeira in #1556
• Dependency Updates March 2025 by @cmoesel in #1562

Full Changelog: v3.14.0...v3.15.0

SUSHI 3.14.0 (almost pi) is a minor release with several enhancements and bug fixes. The most notable changes are:

• When resolving the Canonical keyword (e.g., Canonical(MyResource)), SUSHI now considers all canonical resources in your appropriate input/* folders and dependency packages. Previous versions only resolved canonicals for StructureDefinitions, ValueSets, and CodeSystems.
• When resolving the Canonical keyword, SUSHI will consider the target type (where the canonical is being assigned), choosing the appropriate resolution when there are multiple matches. Previous versions of SUSHI always selected the first match, even if it was of the wrong type.
• SUSHI now properly encodes URLs for cross-version extensions representing choice elements (i.e., elements with names ending in [x]). For example, the cross-version extension for R5's Questionnaire.versionAlgorithm[x] now correctly specifies its URL as http://hl7.org/fhir/5.0/StructureDefinition/extension-Questionnaire.versionAlgorithm%5Bx%5D.
• The automatic hl7.fhir.uv.tools dependency now resolves to the latest published release-specific version of the package (e.g., hl7.fhir.uv.tools.r4#0.3.0). This aligns more closely with the behavior of the IG Publisher.

What's Changed

• Support fishing all resource types from dependency packages and input/* by @cmoesel in #1548
• URL Encode Cross-Version Extension URLs by @cmoesel in #1549
• Use latest hl7.fhir.uv.tools release-specific package by @cmoesel in #1551
• Improve error message for ValueSet compose component without any concept by @KaelynJefferson in #1540
• Check exported resources for presence of multiple choice values by @mint-thompson in #1537
• Entities with same name by @KaelynJefferson in #1528

Install or Update

SUSHI 3.14.0 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.14.0, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.13.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.13.1...v3.14.0

SUSHI 3.13.1 is a patch release that fixes issues in SUSHI 3.13.0's file system interaction that occurred for users using Node 18 versions prior to Node 18.20.0.

What's Changed

• Update FPL and avoid using readdirSync w/ recursive flag by @cmoesel in #1546

Install or Update

SUSHI 3.13.1 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.13.1, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release (3.12.1, since 3.13.0 contained significant bugs in Node < 18.20.0), run the following command:

$ npm install -g fsh-sushi@3.12.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.13.0...v3.13.1