phenoml 0.0.8 → 0.0.9

package/dist/cjs/Client.js

@@ -52,8 +52,8 @@ class phenomlClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "phenoml",
-                "X-Fern-SDK-Version": "0.0.8",
-                "User-Agent": "phenoml/0.0.8",
+                "X-Fern-SDK-Version": "0.0.9",
+                "User-Agent": "phenoml/AUTO",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

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

@@ -147,6 +147,8 @@ export declare class Agent {
      *
      * @example
      *     await client.agent.chat({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         message: "What is the patient's current condition?",
      *         agent_id: "agent-123"
      *     })

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

@@ -42,6 +42,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Agent = void 0;
 const headers_js_1 = require("../../../../core/headers.js");
@@ -523,6 +534,8 @@ class Agent {
      *
      * @example
      *     await client.agent.chat({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         message: "What is the patient's current condition?",
      *         agent_id: "agent-123"
      *     })
@@ -533,7 +546,12 @@ class Agent {
     __chat(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            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() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider } = request, _body = __rest(request, ["X-Phenoml-On-Behalf-Of", "X-Phenoml-Fhir-Provider"]);
+            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, "agent/chat"),
                 method: "POST",
@@ -541,7 +559,7 @@ class Agent {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: request,
+                body: _body,
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,

package/dist/cjs/api/resources/agent/client/requests/AgentChatRequest.d.ts

@@ -1,11 +1,23 @@
 /**
  * @example
  *     {
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         message: "What is the patient's current condition?",
  *         agent_id: "agent-123"
  *     }
  */
 export interface AgentChatRequest {
+    /**
+     * 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;
     /** The message to send to the agent */
     message: string;
     /** Optional context for the conversation */

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

@@ -52,23 +52,5 @@ export declare class Construe {
      */
     extractCodes(request: phenoml.construe.ExtractRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExtractCodesResult>;
     private __extractCodes;
-    /**
-     * Creates a patient cohort based on a natural language description.
-     * Translates the description into FHIR search queries and optional SQL queries.
-     *
-     * @param {phenoml.construe.ConstrueCohortRequest} request
-     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     *
-     * @example
-     *     await client.construe.cohort({
-     *         text: "Between 20 and 40 years old with hyperlipidemia"
-     *     })
-     */
-    cohort(request: phenoml.construe.ConstrueCohortRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ConstrueCohortResponse>;
-    private __cohort;
     protected _getAuthorizationHeader(): Promise<string>;
 }

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

@@ -210,80 +210,6 @@ class Construe {
             }
         });
     }
-    /**
-     * Creates a patient cohort based on a natural language description.
-     * Translates the description into FHIR search queries and optional SQL queries.
-     *
-     * @param {phenoml.construe.ConstrueCohortRequest} request
-     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     *
-     * @example
-     *     await client.construe.cohort({
-     *         text: "Between 20 and 40 years old with hyperlipidemia"
-     *     })
-     */
-    cohort(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__cohort(request, requestOptions));
-    }
-    __cohort(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            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() }), 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, "construe/cohort"),
-                method: "POST",
-                headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
-                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
-                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-            });
-            if (_response.ok) {
-                return {
-                    data: _response.body,
-                    rawResponse: _response.rawResponse,
-                };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 400:
-                        throw new phenoml.construe.BadRequestError(_response.error.body, _response.rawResponse);
-                    case 401:
-                        throw new phenoml.construe.UnauthorizedError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new phenoml.construe.InternalServerError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.phenomlError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            switch (_response.error.reason) {
-                case "non-json":
-                    throw new errors.phenomlError({
-                        statusCode: _response.error.statusCode,
-                        body: _response.error.rawBody,
-                        rawResponse: _response.rawResponse,
-                    });
-                case "timeout":
-                    throw new errors.phenomlTimeoutError("Timeout exceeded when calling POST /construe/cohort.");
-                case "unknown":
-                    throw new errors.phenomlError({
-                        message: _response.error.errorMessage,
-                        rawResponse: _response.rawResponse,
-                    });
-            }
-        });
-    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             return `Bearer ${yield core.Supplier.get(this._options.token)}`;

package/dist/cjs/api/resources/construe/client/requests/index.d.ts

@@ -1,3 +1,2 @@
-export type { ConstrueCohortRequest } from "./ConstrueCohortRequest.js";
 export type { ExtractRequest } from "./ExtractRequest.js";
 export type { UploadRequest } from "./UploadRequest.js";

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 "./BadRequestErrorBody.js";
-export * from "./ConstrueCohortResponse.js";
 export * from "./ConstrueUploadCodeSystemResponse.js";
 export * from "./ExtractCodesResult.js";
 export * from "./ExtractedCodeResult.js";
 export * from "./ExtractRequestConfig.js";
 export * from "./ExtractRequestSystem.js";
-export * from "./InternalServerErrorBody.js";
-export * from "./UnauthorizedErrorBody.js";

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

@@ -14,12 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./BadRequestErrorBody.js"), exports);
-__exportStar(require("./ConstrueCohortResponse.js"), exports);
 __exportStar(require("./ConstrueUploadCodeSystemResponse.js"), exports);
 __exportStar(require("./ExtractCodesResult.js"), exports);
 __exportStar(require("./ExtractedCodeResult.js"), exports);
 __exportStar(require("./ExtractRequestConfig.js"), exports);
 __exportStar(require("./ExtractRequestSystem.js"), exports);
-__exportStar(require("./InternalServerErrorBody.js"), exports);
-__exportStar(require("./UnauthorizedErrorBody.js"), exports);

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

@@ -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: [{

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

@@ -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,7 +87,7 @@ 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);
@@ -94,6 +95,7 @@ class Fhir {
             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/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
@@ -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,10 +189,11 @@ 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;
+            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/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
@@ -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,10 +290,11 @@ 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;
+            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/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
@@ -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,10 +377,11 @@ 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;
+            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/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
@@ -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,10 +524,11 @@ 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;
+            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/${core.url.encodePathParam(fhirProviderId)}/fhir/${core.url.encodePathParam(fhirPath)}`),
@@ -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,10 +641,11 @@ 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;
+            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/${core.url.encodePathParam(fhirProviderId)}/fhir`),

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

@@ -2,7 +2,8 @@ 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 type * 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;
 }