Feat/multi server

[mechanik-daniel]

FUME Community v3.1.0: multi-server FHIR switching

Summary

This PR prepares the v3.1.0 Community release, a minor release focused entirely on multi-server FHIR support.

It adds $useFhirServer(...) so a mapping can switch the active FHIR client within the current lexical scope, using either a named connection from connections.yml or an inline URL target with per-call config.

It also adds $fhirConnectionNames() for dynamic retrieval of the available connection list from within expressions.

What changed

• Adds lexical-scope FHIR server switching via $useFhirServer(target?, config?).
• Supports named alternate connections defined in connections.yml.
• Supports inline URL targets with per-call authType, credentials, fhirVersion, and timeout.
• Adds $fhirConnectionNames() which return the list of configured connection names (strings).
• Keeps terminology and conformance operations pinned to the default server so switching only affects FHIR client operations.
• Adds URL client pooling keyed by effective inline connection config.

User-facing behavior

• $useFhirServer("myConn") switches subsequent FHIR client calls in the current lexical frame to a named connection.
• $useFhirServer("https://example.org/fhir", { ...config }) switches to an inline URL target with optional auth and timeout/version overrides.
• $useFhirServer() resets the active client back to the default server.
• The active connection is lexical: it affects later evaluation in the same block and nested scopes, but does not leak back out after that frame exits.
• $translate*() and other conformance-oriented operations remain on the default server.

Configuration surface

• New named-connection support via connections.yml.
• New/updated runtime settings for alternate connection handling, including FHIR_CONNECTIONS_FILE and FHIR_CONNECTIONS_URL_POOL_SIZE.

[Copilot]

Pull request overview

Copilot reviewed 15 out of 18 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.