phenoml 0.0.3 → 0.0.6

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

@@ -0,0 +1,693 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fhir = void 0;
+const environments = __importStar(require("../../../../environments.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 errors = __importStar(require("../../../../errors/index.js"));
+class Fhir {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    /**
+     * Retrieves FHIR resources from the specified provider. Supports both individual resource retrieval and search operations based on the FHIR path and query parameters.
+     *
+     * The request is proxied to the configured FHIR server with appropriate authentication headers.
+     *
+     * @param {string} fhirProviderId - The ID of the FHIR provider to use. Can be either:
+     *                                  - A UUID representing the provider ID
+     *                                  - A provider name (legacy support - will just use the most recently updated provider with this name)
+     * @param {string} fhirPath - The FHIR resource path to operate on. This follows FHIR RESTful API conventions.
+     *                            Examples:
+     *                            - "Patient" (for resource type operations)
+     *                            - "Patient/123" (for specific resource operations)
+     *                            - "Patient/123/_history" (for history operations)
+     * @param {phenoml.fhir.FhirSearchRequest} request
+     * @param {Fhir.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.fhir.BadRequestError}
+     * @throws {@link phenoml.fhir.UnauthorizedError}
+     * @throws {@link phenoml.fhir.NotFoundError}
+     * @throws {@link phenoml.fhir.InternalServerError}
+     *
+     * @example
+     *     await client.fhir.search("550e8400-e29b-41d4-a716-446655440000", "Patient", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+     *     })
+     */
+    search(fhirProviderId, fhirPath, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__search(fhirProviderId, fhirPath, request, requestOptions));
+    }
+    __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 _queryParams = {};
+            if (queryParameters != null) {
+                _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)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : 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)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                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.fhir.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.fhir.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new phenoml.fhir.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.fhir.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 GET /fhir-provider/{fhir_provider_id}/fhir/{fhir_path}.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Creates a new FHIR resource on the specified provider. The request body should contain a valid FHIR resource in JSON format.
+     *
+     * The request is proxied to the configured FHIR server with appropriate authentication headers.
+     *
+     * @param {string} fhirProviderId - The ID of the FHIR provider to use. Can be either:
+     *                                  - A UUID representing the provider ID
+     *                                  - A provider name (legacy support - will just use the most recently updated provider with this name)
+     * @param {string} fhirPath - The FHIR resource path to operate on. This follows FHIR RESTful API conventions.
+     *                            Examples:
+     *                            - "Patient" (for resource type operations)
+     *                            - "Patient/123" (for specific resource operations)
+     *                            - "Patient/123/_history" (for history operations)
+     * @param {phenoml.fhir.FhirCreateRequest} request
+     * @param {Fhir.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.fhir.BadRequestError}
+     * @throws {@link phenoml.fhir.UnauthorizedError}
+     * @throws {@link phenoml.fhir.InternalServerError}
+     *
+     * @example
+     *     await client.fhir.create("550e8400-e29b-41d4-a716-446655440000", "Patient", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         body: {
+     *             resourceType: "Patient",
+     *             name: [
+     *                 {
+     *                     "family": "Doe",
+     *                     "given": [
+     *                         "Jane"
+     *                     ]
+     *                 }
+     *             ],
+     *             gender: "female",
+     *             birthDate: "1990-01-01"
+     *         }
+     *     })
+     */
+    create(fhirProviderId, fhirPath, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__create(fhirProviderId, fhirPath, request, requestOptions));
+    }
+    __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)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : 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)}`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/fhir+json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                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,
+            });
+            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.fhir.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.fhir.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.fhir.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 /fhir-provider/{fhir_provider_id}/fhir/{fhir_path}.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Creates or updates a FHIR resource on the specified provider. If the resource exists, it will be updated; otherwise, it will be created.
+     *
+     * The request is proxied to the configured FHIR server with appropriate authentication headers.
+     *
+     * @param {string} fhirProviderId - The ID of the FHIR provider to use. Can be either:
+     *                                  - A UUID representing the provider ID
+     *                                  - A provider name (legacy support - will just use the most recently updated provider with this name)
+     * @param {string} fhirPath - The FHIR resource path to operate on. This follows FHIR RESTful API conventions.
+     *                            Examples:
+     *                            - "Patient" (for resource type operations)
+     *                            - "Patient/123" (for specific resource operations)
+     *                            - "Patient/123/_history" (for history operations)
+     * @param {phenoml.fhir.FhirUpsertRequest} request
+     * @param {Fhir.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.fhir.BadRequestError}
+     * @throws {@link phenoml.fhir.UnauthorizedError}
+     * @throws {@link phenoml.fhir.InternalServerError}
+     *
+     * @example
+     *     await client.fhir.upsert("550e8400-e29b-41d4-a716-446655440000", "Patient", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         body: {
+     *             resourceType: "Patient",
+     *             id: "123",
+     *             name: [
+     *                 {
+     *                     "family": "Doe",
+     *                     "given": [
+     *                         "John",
+     *                         "Updated"
+     *                     ]
+     *                 }
+     *             ],
+     *             gender: "male",
+     *             birthDate: "1985-05-15"
+     *         }
+     *     })
+     */
+    upsert(fhirProviderId, fhirPath, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__upsert(fhirProviderId, fhirPath, request, requestOptions));
+    }
+    __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)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : 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)}`),
+                method: "PUT",
+                headers: _headers,
+                contentType: "application/fhir+json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                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,
+            });
+            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.fhir.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.fhir.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.fhir.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 PUT /fhir-provider/{fhir_provider_id}/fhir/{fhir_path}.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Deletes a FHIR resource from the specified provider.
+     *
+     * The request is proxied to the configured FHIR server with appropriate authentication headers.
+     *
+     * @param {string} fhirProviderId - The ID of the FHIR provider to use. Can be either:
+     *                                  - A UUID representing the provider ID
+     *                                  - A provider name (legacy support - will just use the most recently updated provider with this name)
+     * @param {string} fhirPath - The FHIR resource path to operate on. This follows FHIR RESTful API conventions.
+     *                            Examples:
+     *                            - "Patient" (for resource type operations)
+     *                            - "Patient/123" (for specific resource operations)
+     *                            - "Patient/123/_history" (for history operations)
+     * @param {phenoml.fhir.FhirDeleteRequest} request
+     * @param {Fhir.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.fhir.BadRequestError}
+     * @throws {@link phenoml.fhir.UnauthorizedError}
+     * @throws {@link phenoml.fhir.NotFoundError}
+     * @throws {@link phenoml.fhir.InternalServerError}
+     *
+     * @example
+     *     await client.fhir.delete("550e8400-e29b-41d4-a716-446655440000", "Patient", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+     *     })
+     */
+    delete(fhirProviderId, fhirPath, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(fhirProviderId, fhirPath, request, requestOptions));
+    }
+    __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)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : 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)}`),
+                method: "DELETE",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                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.fhir.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.fhir.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new phenoml.fhir.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.fhir.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 DELETE /fhir-provider/{fhir_provider_id}/fhir/{fhir_path}.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Partially updates a FHIR resource on the specified provider using JSON Patch operations as defined in RFC 6902.
+     *
+     * The request body should contain an array of JSON Patch operations. Each operation specifies:
+     * - `op`: The operation type (add, remove, replace, move, copy, test)
+     * - `path`: JSON Pointer to the target location in the resource
+     * - `value`: The value to use (required for add, replace, and test operations)
+     *
+     * The request is proxied to the configured FHIR server with appropriate authentication headers.
+     *
+     * @param {string} fhirProviderId - The ID of the FHIR provider to use. Can be either:
+     *                                  - A UUID representing the provider ID
+     *                                  - A provider name (legacy support - will just use the most recently updated provider with this name)
+     * @param {string} fhirPath - The FHIR resource path to operate on. This follows FHIR RESTful API conventions.
+     *                            Examples:
+     *                            - "Patient" (for resource type operations)
+     *                            - "Patient/123" (for specific resource operations)
+     *                            - "Patient/123/_history" (for history operations)
+     * @param {phenoml.fhir.FhirPatchRequest} request
+     * @param {Fhir.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.fhir.BadRequestError}
+     * @throws {@link phenoml.fhir.UnauthorizedError}
+     * @throws {@link phenoml.fhir.NotFoundError}
+     * @throws {@link phenoml.fhir.InternalServerError}
+     *
+     * @example
+     *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         body: [{
+     *                 op: "replace",
+     *                 path: "/name/0/family",
+     *                 value: "NewFamilyName"
+     *             }]
+     *     })
+     *
+     * @example
+     *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         body: [{
+     *                 op: "add",
+     *                 path: "/telecom/-",
+     *                 value: {
+     *                     "system": "phone",
+     *                     "value": "+1-555-123-4567",
+     *                     "use": "home"
+     *                 }
+     *             }]
+     *     })
+     *
+     * @example
+     *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         body: [{
+     *                 op: "replace",
+     *                 path: "/name/0/family",
+     *                 value: "Smith"
+     *             }, {
+     *                 op: "add",
+     *                 path: "/telecom/-",
+     *                 value: {
+     *                     "system": "email",
+     *                     "value": "john.smith@example.com"
+     *                 }
+     *             }, {
+     *                 op: "remove",
+     *                 path: "/address/0"
+     *             }]
+     *     })
+     *
+     * @example
+     *     await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         body: [{
+     *                 op: "test",
+     *                 path: "/gender",
+     *                 value: "male"
+     *             }, {
+     *                 op: "replace",
+     *                 path: "/gender",
+     *                 value: "female"
+     *             }]
+     *     })
+     */
+    patch(fhirProviderId, fhirPath, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__patch(fhirProviderId, fhirPath, request, requestOptions));
+    }
+    __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)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : 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)}`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json-patch+json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                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,
+            });
+            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.fhir.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.fhir.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new phenoml.fhir.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.fhir.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 PATCH /fhir-provider/{fhir_provider_id}/fhir/{fhir_path}.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Executes a FHIR Bundle transaction or batch operation on the specified provider. This allows multiple FHIR resources to be processed in a single request.
+     *
+     * The request body should contain a valid FHIR Bundle resource with transaction or batch type.
+     *
+     * The request is proxied to the configured FHIR server with appropriate authentication headers.
+     *
+     * @param {string} fhirProviderId - The ID of the FHIR provider to use. Can be either:
+     *                                  - A UUID representing the provider ID
+     *                                  - A provider name (legacy support - will just use the most recently updated provider with this name)
+     * @param {phenoml.fhir.FhirExecuteBundleRequest} request
+     * @param {Fhir.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.fhir.BadRequestError}
+     * @throws {@link phenoml.fhir.UnauthorizedError}
+     * @throws {@link phenoml.fhir.InternalServerError}
+     *
+     * @example
+     *     await client.fhir.executeBundle("550e8400-e29b-41d4-a716-446655440000", {
+     *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+     *         body: {
+     *             resourceType: "Bundle",
+     *             entry: [{
+     *                     resource: {
+     *                         "resourceType": "Patient",
+     *                         "name": [
+     *                             {
+     *                                 "family": "Doe",
+     *                                 "given": [
+     *                                     "John"
+     *                                 ]
+     *                             }
+     *                         ]
+     *                     },
+     *                     request: {
+     *                         method: "POST",
+     *                         url: "Patient"
+     *                     }
+     *                 }, {
+     *                     resource: {
+     *                         "resourceType": "Observation",
+     *                         "status": "final",
+     *                         "subject": {
+     *                             "reference": "Patient/123"
+     *                         }
+     *                     },
+     *                     request: {
+     *                         method: "POST",
+     *                         url: "Observation"
+     *                     }
+     *                 }]
+     *         }
+     *     })
+     */
+    executeBundle(fhirProviderId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__executeBundle(fhirProviderId, request, requestOptions));
+    }
+    __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)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : 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`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/fhir+json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                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,
+            });
+            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.fhir.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.fhir.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.fhir.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 /fhir-provider/{fhir_provider_id}/fhir.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _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;
+        });
+    }
+}
+exports.Fhir = Fhir;