@oystehr/sdk 4.3.7 → 4.3.9

package/dist/esm/resources/classes/zambda-ext.js

@@ -1,13 +1,32 @@
+import { OystehrSdkError } from '../../errors/index.js';
+
 function baseUrlThunk() {
-    return this.config.services?.['projectApiUrl'] ?? 'https://project-api.zapehr.com/v1';
+    return this.config.services?.['zambdaApiUrl'] ?? 'https://zambda-api.zapehr.com/v1';
 }
 async function uploadFile({ id, file, filename, }) {
-    const uploadUrl = await this.request('/zambda/{id}/s3-upload', 'post', baseUrlThunk.bind(this))({ id, filename });
-    await fetch(uploadUrl.signedUrl, {
+    const uploadUrl = await this.request('/zambda/{id}/presigned-url', 'post', baseUrlThunk.bind(this))({ id, action: 'upload', filename });
+    const response = await fetch(uploadUrl.signedUrl, {
         method: 'PUT',
         body: file,
     });
+    if (!response.ok) {
+        throw new OystehrSdkError({ message: 'Failed to upload file', code: response.status, cause: response.statusText });
+    }
+}
+async function downloadFile({ id }) {
+    const downloadUrl = await this.request('/zambda/{id}/presigned-url', 'post', baseUrlThunk.bind(this))({ id, action: 'download' });
+    const response = await fetch(downloadUrl.signedUrl, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new OystehrSdkError({
+            message: 'Failed to download file',
+            code: response.status,
+            cause: response.statusText,
+        });
+    }
+    return response.arrayBuffer();
 }
 
-export { uploadFile };
+export { downloadFile, uploadFile };
 //# sourceMappingURL=zambda-ext.js.map

package/dist/esm/resources/classes/zambda-ext.js.map

@@ -1 +1 @@
-{"version":3,"file":"zambda-ext.js","sources":["../../../../src/resources/classes/zambda-ext.ts"],"sourcesContent":["import { SDKResource } from '../../client/client';\n\nfunction baseUrlThunk(this: SDKResource): string {\n  return this.config.services?.['projectApiUrl'] ?? 'https://project-api.zapehr.com/v1';\n}\n\nexport async function uploadFile(\n  this: SDKResource,\n  {\n    id,\n    file,\n    filename,\n  }: {\n    id: string;\n    file: Blob;\n    filename?: string | undefined;\n  }\n): Promise<void> {\n  const uploadUrl = await this.request('/zambda/{id}/s3-upload', 'post', baseUrlThunk.bind(this))({ id, filename });\n  await fetch(uploadUrl.signedUrl, {\n    method: 'PUT',\n    body: file,\n  });\n}\n"],"names":[],"mappings":"AAEA,SAAS,YAAY,GAAA;IACnB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,eAAe,CAAC,IAAI,mCAAmC;AACvF;AAEO,eAAe,UAAU,CAE9B,EACE,EAAE,EACF,IAAI,EACJ,QAAQ,GAKT,EAAA;IAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;AACjH,IAAA,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE;AAC/B,QAAA,MAAM,EAAE,KAAK;AACb,QAAA,IAAI,EAAE,IAAI;AACX,KAAA,CAAC;AACJ;;;;"}
+{"version":3,"file":"zambda-ext.js","sources":["../../../../src/resources/classes/zambda-ext.ts"],"sourcesContent":["import { SDKResource } from '../../client/client';\nimport { OystehrSdkError } from '../../errors';\n\nfunction baseUrlThunk(this: SDKResource): string {\n  return this.config.services?.['zambdaApiUrl'] ?? 'https://zambda-api.zapehr.com/v1';\n}\n\nexport async function uploadFile(\n  this: SDKResource,\n  {\n    id,\n    file,\n    filename,\n  }: {\n    id: string;\n    file: Blob;\n    filename?: string | undefined;\n  }\n): Promise<void> {\n  const uploadUrl = await this.request(\n    '/zambda/{id}/presigned-url',\n    'post',\n    baseUrlThunk.bind(this)\n  )({ id, action: 'upload', filename });\n  const response = await fetch(uploadUrl.signedUrl, {\n    method: 'PUT',\n    body: file,\n  });\n  if (!response.ok) {\n    throw new OystehrSdkError({ message: 'Failed to upload file', code: response.status, cause: response.statusText });\n  }\n}\n\nexport async function downloadFile(this: SDKResource, { id }: { id: string }): Promise<ArrayBuffer> {\n  const downloadUrl = await this.request(\n    '/zambda/{id}/presigned-url',\n    'post',\n    baseUrlThunk.bind(this)\n  )({ id, action: 'download' });\n  const response = await fetch(downloadUrl.signedUrl, {\n    method: 'GET',\n  });\n  if (!response.ok) {\n    throw new OystehrSdkError({\n      message: 'Failed to download file',\n      code: response.status,\n      cause: response.statusText,\n    });\n  }\n  return response.arrayBuffer();\n}\n"],"names":[],"mappings":";;AAGA,SAAS,YAAY,GAAA;IACnB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,cAAc,CAAC,IAAI,kCAAkC;AACrF;AAEO,eAAe,UAAU,CAE9B,EACE,EAAE,EACF,IAAI,EACJ,QAAQ,GAKT,EAAA;AAED,IAAA,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAClC,4BAA4B,EAC5B,MAAM,EACN,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CACxB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE;AAChD,QAAA,MAAM,EAAE,KAAK;AACb,QAAA,IAAI,EAAE,IAAI;AACX,KAAA,CAAC;AACF,IAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;QAChB,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;IACpH;AACF;AAEO,eAAe,YAAY,CAAoB,EAAE,EAAE,EAAkB,EAAA;IAC1E,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CACpC,4BAA4B,EAC5B,MAAM,EACN,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CACxB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE;AAClD,QAAA,MAAM,EAAE,KAAK;AACd,KAAA,CAAC;AACF,IAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;QAChB,MAAM,IAAI,eAAe,CAAC;AACxB,YAAA,OAAO,EAAE,yBAAyB;YAClC,IAAI,EAAE,QAAQ,CAAC,MAAM;YACrB,KAAK,EAAE,QAAQ,CAAC,UAAU;AAC3B,SAAA,CAAC;IACJ;AACA,IAAA,OAAO,QAAQ,CAAC,WAAW,EAAE;AAC/B;;;;"}

package/dist/esm/resources/classes/zambda.d.ts

@@ -1,4 +1,4 @@
-import { OystehrClientRequest, ZambdaCreateParams, ZambdaCreateResponse, ZambdaDeleteParams, ZambdaExecuteParams, ZambdaExecutePublicParams, ZambdaExecutePublicResponse, ZambdaExecuteResponse, ZambdaGetParams, ZambdaGetResponse, ZambdaListResponse, ZambdaS3UploadParams, ZambdaS3UploadResponse, ZambdaUpdateParams, ZambdaUpdateResponse } from '../..';
+import { OystehrClientRequest, ZambdaCreateParams, ZambdaCreateResponse, ZambdaDeleteParams, ZambdaExecuteParams, ZambdaExecutePublicParams, ZambdaExecutePublicResponse, ZambdaExecuteResponse, ZambdaGetParams, ZambdaGetPresignedUrlParams, ZambdaGetPresignedUrlResponse, ZambdaGetResponse, ZambdaListResponse, ZambdaS3UploadParams, ZambdaS3UploadResponse, ZambdaUpdateParams, ZambdaUpdateResponse } from '../..';
 import { SDKResource } from '../../client/client';
 import { OystehrConfig } from '../../config';
 import * as ext from './zambda-ext';
@@ -6,6 +6,7 @@ export declare class Zambda extends SDKResource {
     #private;
     constructor(config: OystehrConfig);
     uploadFile: typeof ext.uploadFile;
+    downloadFile: typeof ext.downloadFile;
     /**
      * Get a list of all Zambda Functions in the Project. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.
      *
@@ -55,10 +56,20 @@ export declare class Zambda extends SDKResource {
      */
     executePublic(params: ZambdaExecutePublicParams, request?: OystehrClientRequest): Promise<ZambdaExecutePublicResponse>;
     /**
+     * **Deprecated.** Use `POST /zambda/{id}/presigned-url` with `action: "upload"` instead. This endpoint will be removed in future releases.
+     *
      * Returns a URL that is used to deploy code to the Zambda Function with the provided ID. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.
      *
      * Access Policy Action: `Zambda:UpdateFunction`
      * Access Policy Resource: `Zambda:Function`
      */
     s3Upload(params: ZambdaS3UploadParams, request?: OystehrClientRequest): Promise<ZambdaS3UploadResponse>;
+    /**
+     * Returns a presigned URL to upload or download code for the Zambda Function with the provided ID. Pass `action: "upload"` to get a URL for deploying a new code zip, or `action: "download"` to get a URL for retrieving the currently deployed zip. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.
+     *
+     * Upload: Access Policy Action: `Zambda:UpdateFunction`
+     * Download: Access Policy Action: `Zambda:GetFunctionSource`
+     * Access Policy Resource: `Zambda:Function`
+     */
+    getPresignedUrl(params: ZambdaGetPresignedUrlParams, request?: OystehrClientRequest): Promise<ZambdaGetPresignedUrlResponse>;
 }

package/dist/esm/resources/classes/zambda.js

@@ -1,5 +1,5 @@
 import { SDKResource } from '../../client/client.js';
-import { uploadFile } from './zambda-ext.js';
+import { uploadFile, downloadFile } from './zambda-ext.js';
 
 // AUTOGENERATED -- DO NOT EDIT
 class Zambda extends SDKResource {
@@ -10,6 +10,7 @@ class Zambda extends SDKResource {
         return this.config.services?.['zambdaApiUrl'] ?? 'https://zambda-api.zapehr.com/v1';
     }
     uploadFile = uploadFile;
+    downloadFile = downloadFile;
     /**
      * Get a list of all Zambda Functions in the Project. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.
      *
@@ -73,6 +74,8 @@ class Zambda extends SDKResource {
         return this.request('/zambda/{id}/execute-public', 'post', this.#baseUrlThunk.bind(this))(params, request);
     }
     /**
+     * **Deprecated.** Use `POST /zambda/{id}/presigned-url` with `action: "upload"` instead. This endpoint will be removed in future releases.
+     *
      * Returns a URL that is used to deploy code to the Zambda Function with the provided ID. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.
      *
      * Access Policy Action: `Zambda:UpdateFunction`
@@ -81,6 +84,16 @@ class Zambda extends SDKResource {
     s3Upload(params, request) {
         return this.request('/zambda/{id}/s3-upload', 'post', this.#baseUrlThunk.bind(this))(params, request);
     }
+    /**
+     * Returns a presigned URL to upload or download code for the Zambda Function with the provided ID. Pass `action: "upload"` to get a URL for deploying a new code zip, or `action: "download"` to get a URL for retrieving the currently deployed zip. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.
+     *
+     * Upload: Access Policy Action: `Zambda:UpdateFunction`
+     * Download: Access Policy Action: `Zambda:GetFunctionSource`
+     * Access Policy Resource: `Zambda:Function`
+     */
+    getPresignedUrl(params, request) {
+        return this.request('/zambda/{id}/presigned-url', 'post', this.#baseUrlThunk.bind(this))(params, request);
+    }
 }
 
 export { Zambda };

package/dist/esm/resources/classes/zambda.js.map

@@ -1 +1 @@
-{"version":3,"file":"zambda.js","sources":["../../../../src/resources/classes/zambda.ts"],"sourcesContent":["// AUTOGENERATED -- DO NOT EDIT\n\nimport {\n  OystehrClientRequest,\n  ZambdaCreateParams,\n  ZambdaCreateResponse,\n  ZambdaDeleteParams,\n  ZambdaExecuteParams,\n  ZambdaExecutePublicParams,\n  ZambdaExecutePublicResponse,\n  ZambdaExecuteResponse,\n  ZambdaGetParams,\n  ZambdaGetResponse,\n  ZambdaListResponse,\n  ZambdaS3UploadParams,\n  ZambdaS3UploadResponse,\n  ZambdaUpdateParams,\n  ZambdaUpdateResponse,\n} from '../..';\nimport { SDKResource } from '../../client/client';\nimport { OystehrConfig } from '../../config';\nimport * as ext from './zambda-ext';\n\nexport class Zambda extends SDKResource {\n  constructor(config: OystehrConfig) {\n    super(config);\n  }\n  #baseUrlThunk(): string {\n    return this.config.services?.['zambdaApiUrl'] ?? 'https://zambda-api.zapehr.com/v1';\n  }\n  uploadFile = ext.uploadFile;\n  /**\n   * Get a list of all Zambda Functions in the Project. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:ListAllFunctions`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  list(request?: OystehrClientRequest): Promise<ZambdaListResponse> {\n    return this.request('/zambda', 'get', this.#baseUrlThunk.bind(this))(request);\n  }\n  /**\n   * Create a new Zambda Function. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:CreateFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  create(params: ZambdaCreateParams, request?: OystehrClientRequest): Promise<ZambdaCreateResponse> {\n    return this.request('/zambda', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Get the Zambda Function with the provided ID or name. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:GetFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  get(params: ZambdaGetParams, request?: OystehrClientRequest): Promise<ZambdaGetResponse> {\n    return this.request('/zambda/{id}', 'get', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Update the Zambda Function with the provided ID or name. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:UpdateFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  update(params: ZambdaUpdateParams, request?: OystehrClientRequest): Promise<ZambdaUpdateResponse> {\n    return this.request('/zambda/{id}', 'patch', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Delete the Zambda Function with the provided ID or name. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:DeleteFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  delete(params: ZambdaDeleteParams, request?: OystehrClientRequest): Promise<void> {\n    return this.request('/zambda/{id}', 'delete', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Execute the [Authenticated Zambda Function](https://docs.oystehr.com/oystehr/services/zambda/types/authenticated/) with the provided ID. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:InvokeFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  execute(params: ZambdaExecuteParams, request?: OystehrClientRequest): Promise<ZambdaExecuteResponse> {\n    return this.request('/zambda/{id}/execute', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Execute the [Public Zambda Function](https://docs.oystehr.com/oystehr/services/zambda/types/public/) with the provided ID. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Execute a zambda that has method http_open. This endpoint is public so there are no access policy requirements.\n   */\n  executePublic(\n    params: ZambdaExecutePublicParams,\n    request?: OystehrClientRequest\n  ): Promise<ZambdaExecutePublicResponse> {\n    return this.request('/zambda/{id}/execute-public', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Returns a URL that is used to deploy code to the Zambda Function with the provided ID. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:UpdateFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  s3Upload(params: ZambdaS3UploadParams, request?: OystehrClientRequest): Promise<ZambdaS3UploadResponse> {\n    return this.request('/zambda/{id}/s3-upload', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n}\n"],"names":["ext.uploadFile"],"mappings":";;;AAAA;AAuBM,MAAO,MAAO,SAAQ,WAAW,CAAA;AACrC,IAAA,WAAA,CAAY,MAAqB,EAAA;QAC/B,KAAK,CAAC,MAAM,CAAC;IACf;IACA,aAAa,GAAA;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,cAAc,CAAC,IAAI,kCAAkC;IACrF;AACA,IAAA,UAAU,GAAGA,UAAc;AAC3B;;;;;AAKG;AACH,IAAA,IAAI,CAAC,OAA8B,EAAA;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/E;AACA;;;;;AAKG;IACH,MAAM,CAAC,MAA0B,EAAE,OAA8B,EAAA;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IACxF;AACA;;;;;AAKG;IACH,GAAG,CAAC,MAAuB,EAAE,OAA8B,EAAA;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5F;AACA;;;;;AAKG;IACH,MAAM,CAAC,MAA0B,EAAE,OAA8B,EAAA;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9F;AACA;;;;;AAKG;IACH,MAAM,CAAC,MAA0B,EAAE,OAA8B,EAAA;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/F;AACA;;;;;AAKG;IACH,OAAO,CAAC,MAA2B,EAAE,OAA8B,EAAA;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IACrG;AACA;;;;AAIG;IACH,aAAa,CACX,MAAiC,EACjC,OAA8B,EAAA;QAE9B,OAAO,IAAI,CAAC,OAAO,CAAC,6BAA6B,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5G;AACA;;;;;AAKG;IACH,QAAQ,CAAC,MAA4B,EAAE,OAA8B,EAAA;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IACvG;AACD;;;;"}
+{"version":3,"file":"zambda.js","sources":["../../../../src/resources/classes/zambda.ts"],"sourcesContent":["// AUTOGENERATED -- DO NOT EDIT\n\nimport {\n  OystehrClientRequest,\n  ZambdaCreateParams,\n  ZambdaCreateResponse,\n  ZambdaDeleteParams,\n  ZambdaExecuteParams,\n  ZambdaExecutePublicParams,\n  ZambdaExecutePublicResponse,\n  ZambdaExecuteResponse,\n  ZambdaGetParams,\n  ZambdaGetPresignedUrlParams,\n  ZambdaGetPresignedUrlResponse,\n  ZambdaGetResponse,\n  ZambdaListResponse,\n  ZambdaS3UploadParams,\n  ZambdaS3UploadResponse,\n  ZambdaUpdateParams,\n  ZambdaUpdateResponse,\n} from '../..';\nimport { SDKResource } from '../../client/client';\nimport { OystehrConfig } from '../../config';\nimport * as ext from './zambda-ext';\n\nexport class Zambda extends SDKResource {\n  constructor(config: OystehrConfig) {\n    super(config);\n  }\n  #baseUrlThunk(): string {\n    return this.config.services?.['zambdaApiUrl'] ?? 'https://zambda-api.zapehr.com/v1';\n  }\n  uploadFile = ext.uploadFile;\n  downloadFile = ext.downloadFile;\n  /**\n   * Get a list of all Zambda Functions in the Project. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:ListAllFunctions`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  list(request?: OystehrClientRequest): Promise<ZambdaListResponse> {\n    return this.request('/zambda', 'get', this.#baseUrlThunk.bind(this))(request);\n  }\n  /**\n   * Create a new Zambda Function. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:CreateFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  create(params: ZambdaCreateParams, request?: OystehrClientRequest): Promise<ZambdaCreateResponse> {\n    return this.request('/zambda', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Get the Zambda Function with the provided ID or name. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:GetFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  get(params: ZambdaGetParams, request?: OystehrClientRequest): Promise<ZambdaGetResponse> {\n    return this.request('/zambda/{id}', 'get', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Update the Zambda Function with the provided ID or name. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:UpdateFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  update(params: ZambdaUpdateParams, request?: OystehrClientRequest): Promise<ZambdaUpdateResponse> {\n    return this.request('/zambda/{id}', 'patch', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Delete the Zambda Function with the provided ID or name. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:DeleteFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  delete(params: ZambdaDeleteParams, request?: OystehrClientRequest): Promise<void> {\n    return this.request('/zambda/{id}', 'delete', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Execute the [Authenticated Zambda Function](https://docs.oystehr.com/oystehr/services/zambda/types/authenticated/) with the provided ID. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:InvokeFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  execute(params: ZambdaExecuteParams, request?: OystehrClientRequest): Promise<ZambdaExecuteResponse> {\n    return this.request('/zambda/{id}/execute', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Execute the [Public Zambda Function](https://docs.oystehr.com/oystehr/services/zambda/types/public/) with the provided ID. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Execute a zambda that has method http_open. This endpoint is public so there are no access policy requirements.\n   */\n  executePublic(\n    params: ZambdaExecutePublicParams,\n    request?: OystehrClientRequest\n  ): Promise<ZambdaExecutePublicResponse> {\n    return this.request('/zambda/{id}/execute-public', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * **Deprecated.** Use `POST /zambda/{id}/presigned-url` with `action: \"upload\"` instead. This endpoint will be removed in future releases.\n   *\n   * Returns a URL that is used to deploy code to the Zambda Function with the provided ID. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Access Policy Action: `Zambda:UpdateFunction`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  s3Upload(params: ZambdaS3UploadParams, request?: OystehrClientRequest): Promise<ZambdaS3UploadResponse> {\n    return this.request('/zambda/{id}/s3-upload', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n  /**\n   * Returns a presigned URL to upload or download code for the Zambda Function with the provided ID. Pass `action: \"upload\"` to get a URL for deploying a new code zip, or `action: \"download\"` to get a URL for retrieving the currently deployed zip. [Zambdas](https://docs.oystehr.com/oystehr/services/zambda/) are functions that can be used to execute your code. They can be used to process data received from Oystehr's APIs or to perform operations on third-party services.\n   *\n   * Upload: Access Policy Action: `Zambda:UpdateFunction`\n   * Download: Access Policy Action: `Zambda:GetFunctionSource`\n   * Access Policy Resource: `Zambda:Function`\n   */\n  getPresignedUrl(\n    params: ZambdaGetPresignedUrlParams,\n    request?: OystehrClientRequest\n  ): Promise<ZambdaGetPresignedUrlResponse> {\n    return this.request('/zambda/{id}/presigned-url', 'post', this.#baseUrlThunk.bind(this))(params, request);\n  }\n}\n"],"names":["ext.uploadFile","ext.downloadFile"],"mappings":";;;AAAA;AAyBM,MAAO,MAAO,SAAQ,WAAW,CAAA;AACrC,IAAA,WAAA,CAAY,MAAqB,EAAA;QAC/B,KAAK,CAAC,MAAM,CAAC;IACf;IACA,aAAa,GAAA;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,cAAc,CAAC,IAAI,kCAAkC;IACrF;AACA,IAAA,UAAU,GAAGA,UAAc;AAC3B,IAAA,YAAY,GAAGC,YAAgB;AAC/B;;;;;AAKG;AACH,IAAA,IAAI,CAAC,OAA8B,EAAA;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/E;AACA;;;;;AAKG;IACH,MAAM,CAAC,MAA0B,EAAE,OAA8B,EAAA;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IACxF;AACA;;;;;AAKG;IACH,GAAG,CAAC,MAAuB,EAAE,OAA8B,EAAA;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5F;AACA;;;;;AAKG;IACH,MAAM,CAAC,MAA0B,EAAE,OAA8B,EAAA;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9F;AACA;;;;;AAKG;IACH,MAAM,CAAC,MAA0B,EAAE,OAA8B,EAAA;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/F;AACA;;;;;AAKG;IACH,OAAO,CAAC,MAA2B,EAAE,OAA8B,EAAA;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IACrG;AACA;;;;AAIG;IACH,aAAa,CACX,MAAiC,EACjC,OAA8B,EAAA;QAE9B,OAAO,IAAI,CAAC,OAAO,CAAC,6BAA6B,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5G;AACA;;;;;;;AAOG;IACH,QAAQ,CAAC,MAA4B,EAAE,OAA8B,EAAA;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IACvG;AACA;;;;;;AAMG;IACH,eAAe,CACb,MAAmC,EACnC,OAA8B,EAAA;QAE9B,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3G;AACD;;;;"}

package/dist/esm/resources/types/ZambdaGetPresignedUrlParams.d.ts

@@ -0,0 +1,11 @@
+export interface ZambdaGetPresignedUrlParams {
+    /**
+     * Whether to get a presigned URL for uploading or downloading the Zambda Function code zip.
+     */
+    action: 'upload' | 'download';
+    /**
+     * Optional filename for the Zambda Function code zip (upload only). If not provided, the filename will be randomized.
+     */
+    filename?: string;
+    id: string;
+}

package/dist/esm/resources/types/ZambdaGetPresignedUrlResponse.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The presigned URL for the requested action.
+ */
+export interface ZambdaGetPresignedUrlResponse {
+    /**
+     * The presigned URL to upload or download the Zambda Function code zip.
+     */
+    signedUrl: string;
+}

package/dist/esm/resources/types/fhir.d.ts

@@ -117,4 +117,71 @@ export type BatchInputRequest<F extends FhirResource> = BatchInputGetRequest | B
 export interface BatchInput<F extends FhirResource> {
     requests: BatchInputRequest<F>[];
 }
+export interface FhirAsyncJobHandle {
+    jobId: string;
+    contentLocation: string;
+    mode: FhirAsyncResponseMode;
+}
+export type FhirResponseMode = 'sync' | 'async-bundle' | 'async-bulk';
+export type FhirAsyncResponseMode = 'bundle' | 'bulk';
+export interface FhirAsyncCompletionBundleEntry<T extends FhirResource> {
+    response?: {
+        status?: string;
+        outcome?: OperationOutcome;
+    };
+    resource?: T | OperationOutcome;
+}
+export type FhirAsyncCompletionBundle<T extends FhirResource> = EntrylessFhirBundle<T | OperationOutcome> & {
+    resourceType: 'Bundle';
+    type: 'batch-response';
+    entry?: Array<FhirAsyncCompletionBundleEntry<T>>;
+};
+export interface FhirAsyncJobInProgress {
+    status: 202;
+    xProgress?: string;
+    retryAfter?: string;
+}
+export interface FhirAsyncJobCompletedBundle<T extends FhirResource = FhirResource> {
+    status: 200;
+    mode: 'bundle';
+    bundle: FhirAsyncCompletionBundle<T>;
+    interactionStatus?: string;
+    resource?: T | OperationOutcome;
+    outcome?: OperationOutcome;
+}
+export interface FhirAsyncBulkOutputFile {
+    type: string;
+    url: string;
+}
+export interface FhirAsyncBulkManifest {
+    transactionTime: string;
+    request: string;
+    requiresAccessToken: boolean;
+    output: FhirAsyncBulkOutputFile[];
+    error: FhirAsyncBulkOutputFile[];
+    deleted?: FhirAsyncBulkOutputFile[];
+    extension?: Record<string, unknown>;
+}
+export interface FhirAsyncJobCompletedBulk {
+    status: 200;
+    mode: 'bulk';
+    manifest: FhirAsyncBulkManifest;
+}
+export interface FhirAsyncJobExpired {
+    status: 410;
+}
+export interface FhirAsyncJobNotFound {
+    status: 404;
+}
+export interface FhirAsyncJobUnexpected {
+    status: Exclude<number, 200 | 202 | 404 | 410>;
+    body: unknown;
+}
+export type FhirAsyncJobStatus<T extends FhirResource = FhirResource> = FhirAsyncJobInProgress | FhirAsyncJobCompletedBundle<T> | FhirAsyncJobCompletedBulk | FhirAsyncJobExpired | FhirAsyncJobNotFound | FhirAsyncJobUnexpected;
+export interface FhirAsyncWaitOptions {
+    /** Poll interval in milliseconds. Defaults to 1000 (1 second). */
+    pollIntervalMs: number;
+    /** Maximum wait time in milliseconds before timing out. Defaults to 900000 (15 minutes). */
+    timeoutMs: number;
+}
 export {};

package/dist/esm/resources/types/index.d.ts

@@ -192,6 +192,8 @@ export * from './ZambdaLogStreamListParams';
 export * from './ZambdaLogStreamListResponse';
 export * from './ZambdaS3UploadParams';
 export * from './ZambdaS3UploadResponse';
+export * from './ZambdaGetPresignedUrlParams';
+export * from './ZambdaGetPresignedUrlResponse';
 export * from './ZambdaLogStreamSearchParams';
 export * from './ZambdaLogStreamSearchResponse';
 export * from './ZambdaLogStreamGetParams';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oystehr/sdk",
-  "version": "4.3.7",
+  "version": "4.3.9",
   "description": "Oystehr SDK",
   "scripts": {
     "lint": "eslint .",

package/src/client/client.ts

@@ -2,7 +2,16 @@ import { v4 as uuidv4, validate as uuidValidate } from 'uuid';
 import { OystehrConfig } from '../config';
 import { OystehrFHIRError, OystehrSdkError } from '../errors';
 import { Logger } from '../logger';
-import { FhirBundle, FhirResource, OperationOutcome } from '../resources/types';
+import {
+  FhirAsyncBulkManifest,
+  FhirAsyncCompletionBundle,
+  FhirAsyncJobHandle,
+  FhirAsyncJobStatus,
+  FhirBundle,
+  FhirResource,
+  FhirResponseMode,
+  OperationOutcome,
+} from '../resources/types';
 
 type HttpMethod = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
 export const defaultProjectApiUrl = 'https://project-api.zapehr.com/v1';
@@ -41,10 +50,19 @@ export interface OystehrClientRequest {
    * Unique identifier for this request.
    */
   requestId?: string;
+  /**
+   * Optional execution mode for FHIR requests that support async behavior.
+   * Defaults to `sync` when omitted.
+   */
+  mode?: FhirResponseMode;
 }
 
 interface InternalClientRequest extends OystehrClientRequest {
   ifMatch?: string;
+  /**
+   * Internal-only: returns raw response metadata ({ status, headers, body }) instead of throwing on non-2xx statuses.
+   */
+  rawResponse?: boolean;
 }
 
 type FhirData<T extends FhirResource> = T | T[] | FhirBundle<T>;
@@ -75,14 +93,22 @@ export class SDKResource {
     };
   }
 
-  protected fhirRequest<T extends FhirResource = any>(path: string, method: string) {
-    return async (params: any, request?: InternalClientRequest): Promise<FhirFetcherResponse<T>> => {
+  protected fhirRequest<T = FhirResource>(
+    path: string,
+    method: string
+  ): {
+    (params: any, request: InternalClientRequest & { rawResponse: true }, requestMode?: FhirResponseMode): Promise<
+      RawFetcherResponse<T>
+    >;
+    (params: any, request?: InternalClientRequest, requestMode?: FhirResponseMode): Promise<T>;
+  } {
+    return async (params: any, request?: InternalClientRequest, requestMode?: FhirResponseMode): Promise<any> => {
       try {
         const baseUrlThunk = (): string => this.config.services?.fhirApiUrl ?? defaultFhirApiUrl;
         const configThunk = (): OystehrConfig => this.config;
         const loggerThunk = (): Logger => this.logger;
         // must await here to catch
-        return await fetcher(baseUrlThunk, configThunk, loggerThunk, path, method)(params, request);
+        return await fetcher(baseUrlThunk, configThunk, loggerThunk, path, method)(params, request, requestMode);
       } catch (err: unknown) {
         // FHIR API error messages are JSON strings
         const fullError = err as { message: string | Record<string, any>; code: number; cause?: unknown };
@@ -100,13 +126,170 @@ export class SDKResource {
       }
     };
   }
+
+  protected async startAsyncJob(
+    path: string,
+    method: string,
+    params: Record<string, unknown>,
+    requestMode: FhirResponseMode,
+    request?: InternalClientRequest
+  ): Promise<FhirAsyncJobHandle> {
+    const mode = requestMode === 'async-bulk' ? 'bulk' : 'bundle';
+    const asyncPath = requestMode === 'async-bulk' ? this.appendBulkOutputFormat(path) : path;
+
+    const raw = await this.fhirRequest(asyncPath, method)(
+      params,
+      {
+        ...request,
+        rawResponse: true,
+      },
+      requestMode
+    );
+
+    if (raw.status !== 202) {
+      throw new OystehrSdkError({
+        message: `Expected start async job to return 202 Accepted, received ${raw.status}`,
+        code: raw.status,
+      });
+    }
+
+    const contentLocation = this.readHeader(raw.headers, 'content-location');
+    if (!contentLocation) {
+      throw new OystehrSdkError({
+        message: 'Start Async job response missing Content-Location header',
+        code: 500,
+      });
+    }
+
+    const jobId = this.parseAsyncJobId(contentLocation);
+    if (!jobId) {
+      throw new OystehrSdkError({
+        message: `Could not parse async job id from Content-Location: ${contentLocation}`,
+        code: 500,
+      });
+    }
+
+    return { jobId, contentLocation, mode };
+  }
+
+  protected async fetchAsyncJobStatus<T extends FhirResource>(
+    jobId: string,
+    request?: OystehrClientRequest
+  ): Promise<FhirAsyncJobStatus<T>> {
+    const raw = await this.fhirRequest(`/async-job/${jobId}`, 'GET')(
+      {},
+      {
+        ...request,
+        rawResponse: true,
+      }
+    );
+
+    if (raw.status === 202) {
+      return {
+        status: 202,
+        xProgress: this.readHeader(raw.headers, 'x-progress'),
+        retryAfter: this.readHeader(raw.headers, 'retry-after'),
+      };
+    }
+
+    if (raw.status === 410) {
+      return { status: 410 };
+    }
+
+    if (raw.status === 404) {
+      return { status: 404 };
+    }
+
+    if (raw.status === 200) {
+      if (this.isBulkManifest(raw.body)) {
+        return {
+          status: 200,
+          mode: 'bulk',
+          manifest: raw.body,
+        };
+      }
+
+      const bundle = raw.body as FhirAsyncCompletionBundle<T>;
+      if (bundle?.resourceType === 'Bundle' && bundle?.type === 'batch-response') {
+        const entry0 = bundle.entry?.[0];
+        const interactionStatus = entry0?.response?.status;
+        const resource = entry0?.resource;
+        const outcome = entry0?.response?.outcome;
+        return {
+          status: 200,
+          mode: 'bundle',
+          bundle,
+          interactionStatus,
+          resource,
+          outcome,
+        };
+      }
+
+      return {
+        status: 200,
+        body: raw.body,
+      };
+    }
+
+    return {
+      status: raw.status,
+      body: raw.body,
+    };
+  }
+
+  private readHeader(headers: Record<string, string>, name: string): string | undefined {
+    const direct = headers[name];
+    if (direct != null) {
+      return direct;
+    }
+
+    const lower = name.toLowerCase();
+    const key = Object.keys(headers).find((h) => h.toLowerCase() === lower);
+    return key ? headers[key] : undefined;
+  }
+
+  private parseAsyncJobId(contentLocation: string): string | undefined {
+    const segments = contentLocation.split('/').filter(Boolean);
+    const asyncJobIndex = segments.lastIndexOf('async-job');
+    if (asyncJobIndex < 0 || asyncJobIndex + 1 >= segments.length) {
+      return undefined;
+    }
+
+    return segments[asyncJobIndex + 1];
+  }
+
+  private appendBulkOutputFormat(path: string): string {
+    const separator = path.includes('?') ? '&' : '?';
+    return `${path}${separator}_outputFormat=${encodeURIComponent('application/fhir+ndjson')}`;
+  }
+
+  private isBulkManifest(body: unknown): body is FhirAsyncBulkManifest {
+    if (body == null || typeof body !== 'object') {
+      return false;
+    }
+
+    const maybe = body as Record<string, unknown>;
+    return (
+      typeof maybe.transactionTime === 'string' &&
+      typeof maybe.request === 'string' &&
+      typeof maybe.requiresAccessToken === 'boolean' &&
+      Array.isArray(maybe.output) &&
+      Array.isArray(maybe.error)
+    );
+  }
 }
 
 export type FetcherError = { message: string; code: number };
 export type FetcherResponse = any;
+export type RawFetcherResponse<T = unknown> = {
+  status: number;
+  headers: Record<string, string>;
+  body: T | null;
+};
 export type FetcherFunction = (
   params?: Record<string, any> | [any] | InternalClientRequest,
-  request?: InternalClientRequest
+  request?: InternalClientRequest,
+  requestMode?: FhirResponseMode
 ) => Promise<FetcherResponse>;
 
 function isInternalClientRequest(request: Record<string, any>): request is InternalClientRequest {
@@ -115,10 +298,19 @@ function isInternalClientRequest(request: Record<string, any>): request is Inter
     ('projectId' in request && uuidValidate(request.projectId)) ||
     ('contentType' in request && request.contentType?.split('/').length === 2) ||
     'requestId' in request ||
-    ('ifMatch' in request && request.ifMatch.startsWith('W/"'))
+    ('ifMatch' in request && request.ifMatch.startsWith('W/"')) ||
+    'mode' in request ||
+    'rawResponse' in request
   );
 }
 
+function getPreferHeaderFromMode(mode: FhirResponseMode | undefined): string | undefined {
+  if (mode === 'async-bundle' || mode === 'async-bulk') {
+    return 'respond-async';
+  }
+  return undefined;
+}
+
 /**
  * Parse XML response in format <response><status>...</status><output>...</output></response>
  */
@@ -151,7 +343,8 @@ function fetcher(
 ): FetcherFunction {
   return async (
     params?: Record<string, unknown> | [any] | InternalClientRequest,
-    request?: InternalClientRequest
+    request?: InternalClientRequest,
+    requestMode?: FhirResponseMode
   ): Promise<FetcherResponse> => {
     // this function supports multiple signatures. fetcher(baseUrl, path, method)(params, request) or fetcher(baseUrl, path, method)(request)
     // or fetcher(baseUrl, path, method)(params) or fetcher(baseUrl, path, method)(). the types for this are handled by Client<Path, Methods>
@@ -214,6 +407,8 @@ function fetcher(
       requestId: requestCtx?.requestId,
     });
 
+    const preferHeader = getPreferHeaderFromMode(requestMode);
+
     const headers: Record<string, string> = Object.assign(
       projectId
         ? {
@@ -224,6 +419,7 @@ function fetcher(
       {
         'content-type': requestCtx?.contentType ?? 'application/json',
       },
+      preferHeader ? { Prefer: preferHeader } : {},
       accessToken ? { Authorization: `Bearer ${accessToken}` } : {},
       requestCtx?.ifMatch ? { 'If-Match': requestCtx.ifMatch } : {},
       { 'x-oystehr-request-id': requestCtx?.requestId }
@@ -301,6 +497,17 @@ function fetcher(
         url,
         requestId: requestCtx?.requestId,
       });
+      if (requestCtx?.rawResponse) {
+        const headersRecord: Record<string, string> = {};
+        response.headers.forEach((value, key) => {
+          headersRecord[key] = value;
+        });
+        return {
+          status: response.status,
+          headers: headersRecord,
+          body: responseJson ?? responseBody,
+        } as RawFetcherResponse;
+      }
       const isError = !response.ok || response.status >= 400;
       if (isError) {
         const errObj = {