Skip to main content

FHIR Adapters — Release Notes

FHIR-native EHR and EMR APIs, and FHIR authoring tools.

CatalogFHIR Adapters
Catalog idlkfhir
Repositoryhttps://github.com/Linkiir/linkiir-fhir-adapters
Minimum Grid version1.0.0

Current versions​

Adapters​

AdapterCurrent versionNode type idChangelog
HAPI FHIR / OmniVera Adapter1.1.0LKFHIR_HAPI_FHIR_ADAPTERhistory
Epic FHIR Adapter1.1.0LKFHIR_EPIC_ADAPTERhistory
Cerner FHIR Adapter1.1.0LKFHIR_CERNER_FHIR_ADAPTERhistory
eCW Adapter1.1.0LKFHIR_ECW_ADAPTERhistory
ModMed Adapter1.1.0LKFHIR_MODMED_ADAPTERhistory
Athena Adapter1.1.0LKFHIR_ATHENA_ADAPTERhistory
FHIR Resource Creator1.1.0LKFHIR_FHIR_RESOURCE_CREATORhistory
FHIR Validator1.0.0LKFHIR_FHIR_VALIDATORhistory
FHIR Profiling Tools1.1.0LKFHIR_FHIR_PROFILING_TOOLShistory

Libraries​

LibraryCurrent versionChangelog
hapi_fhir1.1.0history
epic_fhir1.1.0history
cerner_fhir1.1.0history
ecw_fhir1.1.0history
modmed_fhir1.1.0history
athena_health1.1.0history
fhir_creator1.0.0history
fhir_validate1.0.0history
fhir_profiling1.1.0history
Checking what you are on

Open the node in the Builder: the adapter version it was built from is shown on the node, and Settings → Catalogs lists every node whose adapter or library has a newer release. See how to upgrade.

Adapter history​

HAPI FHIR / OmniVera Adapter​

LKFHIR_HAPI_FHIR_ADAPTER · current 1.1.0 · configuration

1.1.0​

Released 2026-10-29

  • Live Mode off now stops the requests in a running node, not only in Run Test. From Grid 1.2.0 a running node makes every request whatever live says, so earlier versions send them even with Live Mode off.
  • Uses hapi_fhir 1.1.0.
  • Requires Grid 1.2.0 or later.

1.0.1​

Released 2026-10-29

  • Requires Grid 1.2.0 or later. Nothing else changed: Live Mode off still does not stop requests in a running node. Use 1.1.0.

1.0.0​

Released 2026-09-17

  • Initial release. Polls a HAPI FHIR or Smile OmniVera endpoint on an interval and pushes each returned resource downstream as JSON.
  • FHIR R4 (4.0.1) and R5 (5.0.0), selected by the FHIR Base URL and negotiated with the fhirVersion media-type parameter.
  • Four authentication modes: none for an open test endpoint, OAuth2 Backend Services for a production OmniVera deployment, a static bearer token, and basic auth.
  • OAuth2 discovers the token endpoint from .well-known/smart-configuration when no Token URL is configured.
  • Reads the server's CapabilityStatement once per start and warns when the release it reports differs from the configured FHIR Version.
  • Follows search-result Bundle paging up to Max Pages, and pushes what it collected even when a later page fails.

Epic FHIR Adapter​

LKFHIR_EPIC_ADAPTER · current 1.1.0 · configuration

1.1.0​

Released 2026-10-29

  • Live Mode off now stops the requests in a running node, not only in Run Test. From Grid 1.2.0 a running node makes every request whatever live says, so earlier versions send them even with Live Mode off.
  • Uses epic_fhir 1.1.0.
  • Requires Grid 1.2.0 or later.

1.0.1​

Released 2026-10-29

  • Requires Grid 1.2.0 or later. Nothing else changed: Live Mode off still does not stop requests in a running node. Use 1.1.0.

1.0.0​

Released 2026-09-17

  • Initial release. Polls an Epic FHIR endpoint on an interval using SMART backend services authentication and pushes each returned resource downstream as JSON.

Cerner FHIR Adapter​

LKFHIR_CERNER_FHIR_ADAPTER · current 1.1.0 · configuration

1.1.0​

Released 2026-10-29

  • Live Mode off now stops the requests in a running node, not only in Run Test. From Grid 1.2.0 a running node makes every request whatever live says, so earlier versions send them even with Live Mode off.
  • Uses cerner_fhir 1.1.0.
  • Requires Grid 1.2.0 or later.

1.0.1​

Released 2026-10-29

  • Requires Grid 1.2.0 or later. Nothing else changed: Live Mode off still does not stop requests in a running node. Use 1.1.0.

1.0.0​

Released 2026-09-17

  • Initial release. Polls an Oracle Health / Cerner FHIR endpoint using a signed JWT client assertion.

eCW Adapter​

LKFHIR_ECW_ADAPTER · current 1.1.0 · configuration

1.1.0​

Released 2026-10-29

  • Live Mode off now stops the requests in a running node, not only in Run Test. From Grid 1.2.0 a running node makes every request whatever live says, so earlier versions send them even with Live Mode off.
  • Uses ecw_fhir 1.1.0.
  • Requires Grid 1.2.0 or later.

1.0.1​

Released 2026-10-29

  • Requires Grid 1.2.0 or later. Nothing else changed: Live Mode off still does not stop requests in a running node. Use 1.1.0.

1.0.0​

Released 2026-09-17

  • Initial release. Polls an eClinicalWorks FHIR endpoint, authenticating against its separate token endpoint.

ModMed Adapter​

LKFHIR_MODMED_ADAPTER · current 1.1.0 · configuration

1.1.0​

Released 2026-10-29

  • Live Mode off now stops the requests in a running node, not only in Run Test. From Grid 1.2.0 a running node makes every request whatever live says, so earlier versions send them even with Live Mode off.
  • Uses modmed_fhir 1.1.0.
  • Requires Grid 1.2.0 or later.

1.0.1​

Released 2026-10-29

  • Requires Grid 1.2.0 or later. Nothing else changed: Live Mode off still does not stop requests in a running node. Use 1.1.0.

1.0.0​

Released 2026-09-17

  • Initial release. Polls a ModMed FHIR endpoint using password and refresh-token authentication with an API key.

Athena Adapter​

LKFHIR_ATHENA_ADAPTER · current 1.1.0 · configuration

1.1.0​

Released 2026-10-29

  • Live Mode off now stops the API calls in a running node, not only in Run Test. From Grid 1.2.0 a running node makes every request whatever live says, so on 1.0.0 the calls were sent even with Live Mode off. Authentication is still always live.
  • Uses athena_health 1.1.0.
  • Requires Grid 1.2.0 or later.

1.0.0​

Released 2026-09-17

  • Initial release. Polls Athena Health for a practice, supporting both the proprietary REST API and the FHIR R4 API.

FHIR Resource Creator​

LKFHIR_FHIR_RESOURCE_CREATOR · current 1.1.0 · configuration

1.1.0​

Released 2026-09-18

  • Rebuilt on the new fhir_creator helper library with a small, readable mapping in the node script, replacing the previous mapping engine. It adds only the fields the message carries, so the output has no empty scaffolding and no null placeholders, and active: false is preserved rather than dropped.
  • No configuration fields — the mapping lives in the node script, and a template from the Profile Designer is the field reference.

1.0.0​

Released 2026-09-17

  • Initial release. Maps inbound patient data onto a FHIR R4 Patient resource and strips unused fields. No network calls.

FHIR Validator​

LKFHIR_FHIR_VALIDATOR · current 1.0.0 · configuration

1.0.0​

Released 2026-09-18

  • Initial release. Validates an inbound FHIR resource against a FHIR server's $validate operation and forwards it only when it validates.
  • Two settings — a FHIR Server URL and an optional profile canonical URL. TLS verification and the request timeout are internal defaults.
  • Strict tri-state verdict — valid, invalid, unknown — and fails closed: a timeout, an HTTP error, a malformed response, or an unresolvable profile all yield unknown, never a false verdict. HTTP 200 is not treated as the verdict (the OperationOutcome is).
  • The resource is sent byte-for-byte and forwarded unchanged on valid; anything short of a clean pass stops the node.

FHIR Profiling Tools​

LKFHIR_FHIR_PROFILING_TOOLS · current 1.1.0 · configuration

1.1.0​

Released 2026-09-18

  • Added the Profile Designer: lists a base resource's constrainable elements, compiles a constraint spec into a differential StructureDefinition, and imports an existing one while preserving it whole. The output is a differential, not a snapshot, and is not a conformance check.
  • The existing resource-template and browser UI are unchanged.

1.0.0​

Released 2026-09-17

  • Initial release. Serves a browser UI listing FHIR resources and types, and returns a JSON template for any of them.

Library history​

Library versions are immutable: a published version is never edited, and a fix ships as a new version. A node stays pinned to the version it was built against until you move it forward.

hapi_fhir​

current 1.1.0

1.1.0​

Released 2026-10-29

  • With live off, a request made from a running node is no longer sent: the client returns the same simulated result Run Test gives. It checks linkiir.node.dev(), so it needs Grid 1.2.0 or later. 1.0.0 remains published for nodes pinned to it.

1.0.0​

Released 2026-09-17

  • Initial release. HAPI FHIR and Smile OmniVera client. Takes the FHIR base URL whole rather than assembling a path, so it reaches the public sandbox, a self-hosted hapi-fhir-jpaserver, and an OmniVera deployment unchanged.
  • Read and write: search, searchAll with Bundle paging, read, create, update, delete, transaction, operation, capabilities, serverVersion and authenticate.
  • transactionBundle() builds an all-or-nothing Bundle, so an HL7 v2 message that maps to several resources lands completely or not at all.
  • Token caching with an expiry skew, keyed per credential and endpoint.

epic_fhir​

current 1.1.0

1.1.0​

Released 2026-10-29

  • With live off, a request made from a running node is no longer sent: the client returns the same simulated result Run Test gives. It checks linkiir.node.dev(), so it needs Grid 1.2.0 or later. 1.0.0 remains published for nodes pinned to it.

1.0.0​

Released 2026-09-17

  • Initial release. SMART backend services authentication, with search, read, create, update and operation helpers.

cerner_fhir​

current 1.1.0

1.1.0​

Released 2026-10-29

  • With live off, a request made from a running node is no longer sent: the client returns the same simulated result Run Test gives. It checks linkiir.node.dev(), so it needs Grid 1.2.0 or later. 1.0.0 remains published for nodes pinned to it.

1.0.0​

Released 2026-09-17

  • Initial release. SMART backend services authentication with a kid-headed JWT client assertion.

ecw_fhir​

current 1.1.0

1.1.0​

Released 2026-10-29

  • With live off, a request made from a running node is no longer sent: the client returns the same simulated result Run Test gives. It checks linkiir.node.dev(), so it needs Grid 1.2.0 or later. 1.0.0 remains published for nodes pinned to it.

1.0.0​

Released 2026-09-17

  • Initial release. JWT client-credentials against a separate token endpoint, plus bulk export helpers.

modmed_fhir​

current 1.1.0

1.1.0​

Released 2026-10-29

  • With live off, a request made from a running node is no longer sent: the client returns the same simulated result Run Test gives. It checks linkiir.node.dev(), so it needs Grid 1.2.0 or later. 1.0.0 remains published for nodes pinned to it.

1.0.0​

Released 2026-09-17

  • Initial release. Password and refresh-token authentication with an API key.

athena_health​

current 1.1.0

1.1.0​

Released 2026-10-29

  • With live off, a request made from a running node is no longer sent: the client returns the same simulated result Run Test gives. It checks linkiir.node.dev(), so it needs Grid 1.2.0 or later. 1.0.0 remains published for nodes pinned to it.

1.0.0​

Released 2026-09-17

  • Initial release. client_credentials OAuth for both the proprietary REST API and the FHIR R4 API.

fhir_creator​

current 1.0.0

1.0.0​

Released 2026-09-18

  • Initial release. Helpers for hand-building a FHIR resource in a node script: start a resource and append name, identifier, telecom and address, adding only populated fields, then serialize to JSON. Absent, empty and null inputs are omitted by construction, so the output needs no null cleanup. No network or authentication.

fhir_validate​

current 1.0.0

1.0.0​

Released 2026-09-18

  • Initial release. Remote FHIR $validate client. Returns a strict valid / invalid / unknown verdict and fails closed. Detects an unresolvable profile by OperationOutcome issue code, not by matching diagnostic text. Sends the resource byte-for-byte. Designed to be called from an adapter before it sends.

fhir_profiling​

current 1.1.0

1.1.0​

Released 2026-09-18

  • Added profile authoring: baseElements, buildProfile (differential StructureDefinition), and importProfile (preserves an imported definition whole), and powers the Profile Designer. 1.0.0 remains published for nodes pinned to it.

1.0.0​

Released 2026-09-17

  • Initial release. Loads FHIR specification profiles from SQLite and generates JSON templates.

Next​