phenoml 0.0.7 → 0.0.9

package/dist/cjs/api/resources/construe/types/ExtractRequestConfig.d.ts

@@ -1,15 +1,41 @@
 export interface ExtractRequestConfig {
+    /** Method for splitting input text into chunks before code extraction */
     chunking_method?: ExtractRequestConfig.ChunkingMethod;
+    /** Maximum number of codes to extract per chunk */
     max_codes_per_chunk?: number;
+    /** Threshold for filtering similar codes (0.0-1.0) */
     code_similarity_filter?: number;
+    /**
+     * Method for validating extracted codes:
+     * * none - No validation, returns all candidate codes
+     * * simple - LLM-based validation
+     * * medication_search - LLM-based validation tailored for medication concepts
+     */
+    validation_method?: ExtractRequestConfig.ValidationMethod;
+    /** Whether to include explanations for why each code was extracted */
     include_rationale?: boolean;
+    /** Whether to include ancestor/parent codes in the results */
+    include_ancestors?: boolean;
 }
 export declare namespace ExtractRequestConfig {
+    /** Method for splitting input text into chunks before code extraction */
     const ChunkingMethod: {
         readonly None: "none";
-        readonly Sentence: "sentence";
-        readonly Paragraph: "paragraph";
+        readonly Sentences: "sentences";
+        readonly Paragraphs: "paragraphs";
         readonly Topics: "topics";
     };
     type ChunkingMethod = (typeof ChunkingMethod)[keyof typeof ChunkingMethod];
+    /**
+     * Method for validating extracted codes:
+     * * none - No validation, returns all candidate codes
+     * * simple - LLM-based validation
+     * * medication_search - LLM-based validation tailored for medication concepts
+     */
+    const ValidationMethod: {
+        readonly None: "none";
+        readonly Simple: "simple";
+        readonly MedicationSearch: "medication_search";
+    };
+    type ValidationMethod = (typeof ValidationMethod)[keyof typeof ValidationMethod];
 }

package/dist/cjs/api/resources/construe/types/ExtractRequestConfig.js

@@ -4,10 +4,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExtractRequestConfig = void 0;
 var ExtractRequestConfig;
 (function (ExtractRequestConfig) {
+    /** Method for splitting input text into chunks before code extraction */
     ExtractRequestConfig.ChunkingMethod = {
         None: "none",
-        Sentence: "sentence",
-        Paragraph: "paragraph",
+        Sentences: "sentences",
+        Paragraphs: "paragraphs",
         Topics: "topics",
     };
+    /**
+     * Method for validating extracted codes:
+     * * none - No validation, returns all candidate codes
+     * * simple - LLM-based validation
+     * * medication_search - LLM-based validation tailored for medication concepts
+     */
+    ExtractRequestConfig.ValidationMethod = {
+        None: "none",
+        Simple: "simple",
+        MedicationSearch: "medication_search",
+    };
 })(ExtractRequestConfig || (exports.ExtractRequestConfig = ExtractRequestConfig = {}));

package/dist/cjs/api/resources/construe/types/ExtractRequestSystem.d.ts

@@ -8,6 +8,8 @@ export interface ExtractRequestSystem {
      * * ICD-10-CM - version 2025
      * * ICD-10-PCS - version 2025
      * * LOINC - version 2.78
+     * * HPO - version 2025
+     * * CPT - version 2025
      *
      * Custom systems:
      * * Any valid system name configured in your environment. Must have self-hosted construe module.

package/dist/cjs/api/resources/construe/types/index.d.ts

@@ -1,9 +1,5 @@
 export * from "./ConstrueUploadCodeSystemResponse.js";
-export * from "./ConstrueCohortResponse.js";
-export * from "./BadRequestErrorBody.js";
-export * from "./UnauthorizedErrorBody.js";
-export * from "./InternalServerErrorBody.js";
-export * from "./ExtractRequestSystem.js";
-export * from "./ExtractRequestConfig.js";
 export * from "./ExtractCodesResult.js";
 export * from "./ExtractedCodeResult.js";
+export * from "./ExtractRequestConfig.js";
+export * from "./ExtractRequestSystem.js";

package/dist/cjs/api/resources/construe/types/index.js

@@ -15,11 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ConstrueUploadCodeSystemResponse.js"), exports);
-__exportStar(require("./ConstrueCohortResponse.js"), exports);
-__exportStar(require("./BadRequestErrorBody.js"), exports);
-__exportStar(require("./UnauthorizedErrorBody.js"), exports);
-__exportStar(require("./InternalServerErrorBody.js"), exports);
-__exportStar(require("./ExtractRequestSystem.js"), exports);
-__exportStar(require("./ExtractRequestConfig.js"), exports);
 __exportStar(require("./ExtractCodesResult.js"), exports);
 __exportStar(require("./ExtractedCodeResult.js"), exports);
+__exportStar(require("./ExtractRequestConfig.js"), exports);
+__exportStar(require("./ExtractRequestSystem.js"), exports);

package/dist/cjs/api/resources/fhir/client/Client.d.ts

@@ -9,7 +9,7 @@ export declare namespace Fhir {
 }
 export declare class Fhir {
     protected readonly _options: Fhir.Options;
-    constructor(_options?: Fhir.Options);
+    constructor(_options: Fhir.Options);
     /**
      * Retrieves FHIR resources from the specified provider. Supports both individual resource retrieval and search operations based on the FHIR path and query parameters.
      *
@@ -33,7 +33,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.search("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
      *     })
      */
     search(fhirProviderId: string, fhirPath: string, request?: phenoml.fhir.FhirSearchRequest, requestOptions?: Fhir.RequestOptions): core.HttpResponsePromise<phenoml.fhir.FhirSearchResponse>;
@@ -60,7 +61,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.create("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: {
      *             resourceType: "Patient",
      *             name: [
@@ -100,7 +102,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.upsert("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: {
      *             resourceType: "Patient",
      *             id: "123",
@@ -143,7 +146,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.delete("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
      *     })
      */
     delete(fhirProviderId: string, fhirPath: string, request?: phenoml.fhir.FhirDeleteRequest, requestOptions?: Fhir.RequestOptions): core.HttpResponsePromise<Record<string, unknown>>;
@@ -176,7 +180,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: [{
      *                 op: "replace",
      *                 path: "/name/0/family",
@@ -186,7 +191,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: [{
      *                 op: "add",
      *                 path: "/telecom/-",
@@ -200,7 +206,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: [{
      *                 op: "replace",
      *                 path: "/name/0/family",
@@ -220,7 +227,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: [{
      *                 op: "test",
      *                 path: "/gender",
@@ -253,7 +261,8 @@ export declare class Fhir {
      *
      * @example
      *     await client.fhir.executeBundle("550e8400-e29b-41d4-a716-446655440000", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: {
      *             resourceType: "Bundle",
      *             entry: [{
@@ -290,5 +299,5 @@ export declare class Fhir {
      */
     executeBundle(fhirProviderId: string, request: phenoml.fhir.FhirExecuteBundleRequest, requestOptions?: Fhir.RequestOptions): core.HttpResponsePromise<phenoml.fhir.FhirBundle>;
     private __executeBundle;
-    protected _getAuthorizationHeader(): Promise<string | undefined>;
+    protected _getAuthorizationHeader(): Promise<string>;
 }

package/dist/cjs/api/resources/fhir/client/Client.js

@@ -44,14 +44,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Fhir = void 0;
-const environments = __importStar(require("../../../../environments.js"));
+const headers_js_1 = require("../../../../core/headers.js");
 const core = __importStar(require("../../../../core/index.js"));
-const phenoml = __importStar(require("../../../index.js"));
 const json_js_1 = require("../../../../core/json.js");
-const headers_js_1 = require("../../../../core/headers.js");
+const environments = __importStar(require("../../../../environments.js"));
 const errors = __importStar(require("../../../../errors/index.js"));
+const phenoml = __importStar(require("../../../index.js"));
 class Fhir {
-    constructor(_options = {}) {
+    constructor(_options) {
         this._options = _options;
     }
     /**
@@ -77,7 +77,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.search("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
      *     })
      */
     search(fhirProviderId, fhirPath, request = {}, requestOptions) {
@@ -86,17 +87,18 @@ class Fhir {
     __search(fhirProviderId_1, fhirPath_1) {
         return __awaiter(this, arguments, void 0, function* (fhirProviderId, fhirPath, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { query_parameters: queryParameters, "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf } = request;
+            const { query_parameters: queryParameters, "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider, } = request;
             const _queryParams = {};
             if (queryParameters != null) {
-                _queryParams["query_parameters"] = (0, json_js_1.toJson)(queryParameters);
+                _queryParams.query_parameters = (0, json_js_1.toJson)(queryParameters);
             }
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
                 Authorization: yield this._getAuthorizationHeader(),
                 "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
             }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${encodeURIComponent(fhirProviderId)}/fhir/${encodeURIComponent(fhirPath)}`),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -164,7 +166,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.create("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: {
      *             resourceType: "Patient",
      *             name: [
@@ -186,13 +189,14 @@ class Fhir {
     __create(fhirProviderId, fhirPath, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, body: _body } = request;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider, body: _body, } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
                 Authorization: yield this._getAuthorizationHeader(),
                 "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
             }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${encodeURIComponent(fhirProviderId)}/fhir/${encodeURIComponent(fhirPath)}`),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/fhir+json",
@@ -261,7 +265,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.upsert("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: {
      *             resourceType: "Patient",
      *             id: "123",
@@ -285,13 +290,14 @@ class Fhir {
     __upsert(fhirProviderId, fhirPath, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, body: _body } = request;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider, body: _body, } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
                 Authorization: yield this._getAuthorizationHeader(),
                 "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
             }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${encodeURIComponent(fhirProviderId)}/fhir/${encodeURIComponent(fhirPath)}`),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
                 method: "PUT",
                 headers: _headers,
                 contentType: "application/fhir+json",
@@ -361,7 +367,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.delete("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
      *     })
      */
     delete(fhirProviderId, fhirPath, request = {}, requestOptions) {
@@ -370,13 +377,14 @@ class Fhir {
     __delete(fhirProviderId_1, fhirPath_1) {
         return __awaiter(this, arguments, void 0, function* (fhirProviderId, fhirPath, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf } = request;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
                 Authorization: yield this._getAuthorizationHeader(),
                 "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
             }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${encodeURIComponent(fhirProviderId)}/fhir/${encodeURIComponent(fhirPath)}`),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
                 method: "DELETE",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -450,7 +458,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: [{
      *                 op: "replace",
      *                 path: "/name/0/family",
@@ -460,7 +469,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: [{
      *                 op: "add",
      *                 path: "/telecom/-",
@@ -474,7 +484,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: [{
      *                 op: "replace",
      *                 path: "/name/0/family",
@@ -494,7 +505,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: [{
      *                 op: "test",
      *                 path: "/gender",
@@ -512,13 +524,14 @@ class Fhir {
     __patch(fhirProviderId, fhirPath, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, body: _body } = request;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider, body: _body, } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
                 Authorization: yield this._getAuthorizationHeader(),
                 "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
             }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${encodeURIComponent(fhirProviderId)}/fhir/${encodeURIComponent(fhirPath)}`),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
                 method: "PATCH",
                 headers: _headers,
                 contentType: "application/json-patch+json",
@@ -586,7 +599,8 @@ class Fhir {
      *
      * @example
      *     await client.fhir.executeBundle("550e8400-e29b-41d4-a716-446655440000", {
-     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         body: {
      *             resourceType: "Bundle",
      *             entry: [{
@@ -627,13 +641,14 @@ class Fhir {
     __executeBundle(fhirProviderId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, body: _body } = request;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider, body: _body, } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
                 Authorization: yield this._getAuthorizationHeader(),
                 "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
             }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${encodeURIComponent(fhirProviderId)}/fhir`),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `fhir-provider/${core.url.encodePathParam(fhirProviderId)}/fhir`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/fhir+json",
@@ -682,11 +697,7 @@ class Fhir {
     }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
-            const bearer = yield core.Supplier.get(this._options.token);
-            if (bearer != null) {
-                return `Bearer ${bearer}`;
-            }
-            return undefined;
+            return `Bearer ${yield core.Supplier.get(this._options.token)}`;
         });
     }
 }

package/dist/cjs/api/resources/fhir/client/index.d.ts

@@ -1,2 +1 @@
-export {};
 export * from "./requests/index.js";

package/dist/cjs/api/resources/fhir/client/requests/FhirCreateRequest.d.ts

@@ -1,8 +1,9 @@
-import * as phenoml from "../../../../index.js";
+import type * as phenoml from "../../../../index.js";
 /**
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         body: {
  *             resourceType: "Patient",
  *             name: [
@@ -19,7 +20,15 @@ import * as phenoml from "../../../../index.js";
  *     }
  */
 export interface FhirCreateRequest {
-    /** Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity. */
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
     "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
     body: phenoml.fhir.FhirResource;
 }

package/dist/cjs/api/resources/fhir/client/requests/FhirDeleteRequest.d.ts

@@ -1,10 +1,19 @@
 /**
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
  *     }
  */
 export interface FhirDeleteRequest {
-    /** Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity. */
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
     "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
 }

package/dist/cjs/api/resources/fhir/client/requests/FhirExecuteBundleRequest.d.ts

@@ -1,8 +1,9 @@
-import * as phenoml from "../../../../index.js";
+import type * as phenoml from "../../../../index.js";
 /**
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         body: {
  *             resourceType: "Bundle",
  *             entry: [{
@@ -38,7 +39,15 @@ import * as phenoml from "../../../../index.js";
  *     }
  */
 export interface FhirExecuteBundleRequest {
-    /** Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity. */
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
     "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
     body: phenoml.fhir.FhirBundle;
 }

package/dist/cjs/api/resources/fhir/client/requests/FhirPatchRequest.d.ts

@@ -1,8 +1,9 @@
-import * as phenoml from "../../../../index.js";
+import type * as phenoml from "../../../../index.js";
 /**
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         body: [{
  *                 op: "replace",
  *                 path: "/name/0/family",
@@ -12,7 +13,8 @@ import * as phenoml from "../../../../index.js";
  *
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         body: [{
  *                 op: "add",
  *                 path: "/telecom/-",
@@ -26,7 +28,8 @@ import * as phenoml from "../../../../index.js";
  *
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         body: [{
  *                 op: "replace",
  *                 path: "/name/0/family",
@@ -46,7 +49,8 @@ import * as phenoml from "../../../../index.js";
  *
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         body: [{
  *                 op: "test",
  *                 path: "/gender",
@@ -59,8 +63,16 @@ import * as phenoml from "../../../../index.js";
  *     }
  */
 export interface FhirPatchRequest {
-    /** Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity. */
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
     "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
     /** Array of JSON Patch operations following RFC 6902 */
     body: phenoml.fhir.FhirPatchRequestBodyItem[];
 }

package/dist/cjs/api/resources/fhir/client/requests/FhirSearchRequest.d.ts

@@ -1,12 +1,14 @@
 /**
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
  *     }
  *
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
  *     }
  */
 export interface FhirSearchRequest {
@@ -18,6 +20,14 @@ export interface FhirSearchRequest {
      * - Search prefixes for dates, numbers, quantities (eq, ne, gt, ge, lt, le, sa, eb, ap)
      */
     query_parameters?: Record<string, string | undefined>;
-    /** Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity. */
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
     "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
 }