@oystehr/sdk 4.3.7 → 4.3.9

package/dist/cjs/resources/classes/zambda-ext.cjs

@@ -1,15 +1,35 @@
 'use strict';
 
+var index = require('../../errors/index.cjs');
+
 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 index.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 index.OystehrSdkError({
+            message: 'Failed to download file',
+            code: response.status,
+            cause: response.statusText,
+        });
+    }
+    return response.arrayBuffer();
 }
 
+exports.downloadFile = downloadFile;
 exports.uploadFile = uploadFile;
 //# sourceMappingURL=zambda-ext.cjs.map

package/dist/cjs/resources/classes/zambda-ext.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"zambda-ext.cjs","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.cjs","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":["OystehrSdkError"],"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,IAAIA,qBAAe,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,IAAIA,qBAAe,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/cjs/resources/classes/zambda-ext.d.ts

@@ -4,3 +4,6 @@ export declare function uploadFile(this: SDKResource, { id, file, filename, }: {
     file: Blob;
     filename?: string | undefined;
 }): Promise<void>;
+export declare function downloadFile(this: SDKResource, { id }: {
+    id: string;
+}): Promise<ArrayBuffer>;

package/dist/cjs/resources/classes/zambda.cjs

@@ -12,6 +12,7 @@ class Zambda extends client.SDKResource {
         return this.config.services?.['zambdaApiUrl'] ?? 'https://zambda-api.zapehr.com/v1';
     }
     uploadFile = zambdaExt.uploadFile;
+    downloadFile = zambdaExt.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.
      *
@@ -75,6 +76,8 @@ class Zambda extends client.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`
@@ -83,6 +86,16 @@ class Zambda extends client.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);
+    }
 }
 
 exports.Zambda = Zambda;

package/dist/cjs/resources/classes/zambda.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"zambda.cjs","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":["SDKResource","ext.uploadFile"],"mappings":";;;;;AAAA;AAuBM,MAAO,MAAO,SAAQA,kBAAW,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,GAAGC,oBAAc;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.cjs","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":["SDKResource","ext.uploadFile","ext.downloadFile"],"mappings":";;;;;AAAA;AAyBM,MAAO,MAAO,SAAQA,kBAAW,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,GAAGC,oBAAc;AAC3B,IAAA,YAAY,GAAGC,sBAAgB;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/cjs/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/cjs/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/cjs/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/cjs/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/cjs/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/dist/esm/client/client.d.ts

@@ -1,6 +1,6 @@
 import { OystehrConfig } from '../config';
 import { Logger } from '../logger';
-import { FhirBundle, FhirResource } from '../resources/types';
+import { FhirAsyncJobHandle, FhirAsyncJobStatus, FhirBundle, FhirResource, FhirResponseMode } from '../resources/types';
 export declare const defaultProjectApiUrl = "https://project-api.zapehr.com/v1";
 /**
  * Optional parameter that can be passed to the client methods. It allows
@@ -24,9 +24,18 @@ 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>;
 export type FhirFetcherResponse<T extends FhirData<FhirResource> = any> = T;
@@ -35,14 +44,30 @@ export declare class SDKResource {
     protected readonly logger: Logger;
     constructor(config: OystehrConfig);
     protected request(path: string, method: string, baseUrlThunk: () => string): FetcherFunction;
-    protected fhirRequest<T extends FhirResource = any>(path: string, method: string): (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>;
+    };
+    protected startAsyncJob(path: string, method: string, params: Record<string, unknown>, requestMode: FhirResponseMode, request?: InternalClientRequest): Promise<FhirAsyncJobHandle>;
+    protected fetchAsyncJobStatus<T extends FhirResource>(jobId: string, request?: OystehrClientRequest): Promise<FhirAsyncJobStatus<T>>;
+    private readHeader;
+    private parseAsyncJobId;
+    private appendBulkOutputFormat;
+    private isBulkManifest;
 }
 export type FetcherError = {
     message: string;
     code: number;
 };
 export type FetcherResponse = any;
-export type FetcherFunction = (params?: Record<string, any> | [any] | InternalClientRequest, request?: InternalClientRequest) => Promise<FetcherResponse>;
+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, requestMode?: FhirResponseMode) => Promise<FetcherResponse>;
 /**
  * Adds params to a URLSearchParams object in such a way as to preserve array values.
  * @param params params

package/dist/esm/client/client.js

@@ -40,13 +40,13 @@ class SDKResource {
         };
     }
     fhirRequest(path, method) {
-        return async (params, request) => {
+        return async (params, request, requestMode) => {
             try {
                 const baseUrlThunk = () => this.config.services?.fhirApiUrl ?? defaultFhirApiUrl;
                 const configThunk = () => this.config;
                 const loggerThunk = () => 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) {
                 // FHIR API error messages are JSON strings
@@ -65,13 +65,133 @@ class SDKResource {
             }
         };
     }
+    async startAsyncJob(path, method, params, requestMode, request) {
+        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 };
+    }
+    async fetchAsyncJobStatus(jobId, request) {
+        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;
+            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,
+        };
+    }
+    readHeader(headers, name) {
+        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;
+    }
+    parseAsyncJobId(contentLocation) {
+        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];
+    }
+    appendBulkOutputFormat(path) {
+        const separator = path.includes('?') ? '&' : '?';
+        return `${path}${separator}_outputFormat=${encodeURIComponent('application/fhir+ndjson')}`;
+    }
+    isBulkManifest(body) {
+        if (body == null || typeof body !== 'object') {
+            return false;
+        }
+        const maybe = body;
+        return (typeof maybe.transactionTime === 'string' &&
+            typeof maybe.request === 'string' &&
+            typeof maybe.requiresAccessToken === 'boolean' &&
+            Array.isArray(maybe.output) &&
+            Array.isArray(maybe.error));
+    }
 }
 function isInternalClientRequest(request) {
     return ('accessToken' in request ||
         ('projectId' in request && validate(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) {
+    if (mode === 'async-bundle' || mode === 'async-bulk') {
+        return 'respond-async';
+    }
+    return undefined;
 }
 /**
  * Parse XML response in format <response><status>...</status><output>...</output></response>
@@ -94,7 +214,7 @@ function parseXmlResponse(xmlString) {
     }
 }
 function fetcher(baseUrlThunk, configThunk, loggerThunk, path, methodParam) {
-    return async (params, request) => {
+    return async (params, request, requestMode) => {
         // 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>
         // and this is the backend implementation behind it. the heuristic we're using is that if the first param is an object with an accessToken
@@ -158,6 +278,7 @@ function fetcher(baseUrlThunk, configThunk, loggerThunk, path, methodParam) {
             path,
             requestId: requestCtx?.requestId,
         });
+        const preferHeader = getPreferHeaderFromMode(requestMode);
         const headers = Object.assign(projectId
             ? {
                 'x-zapehr-project-id': projectId,
@@ -165,7 +286,7 @@ function fetcher(baseUrlThunk, configThunk, loggerThunk, path, methodParam) {
             }
             : {}, {
             'content-type': requestCtx?.contentType ?? 'application/json',
-        }, accessToken ? { Authorization: `Bearer ${accessToken}` } : {}, requestCtx?.ifMatch ? { 'If-Match': requestCtx.ifMatch } : {}, { 'x-oystehr-request-id': requestCtx?.requestId });
+        }, preferHeader ? { Prefer: preferHeader } : {}, accessToken ? { Authorization: `Bearer ${accessToken}` } : {}, requestCtx?.ifMatch ? { 'If-Match': requestCtx.ifMatch } : {}, { 'x-oystehr-request-id': requestCtx?.requestId });
         const retryConfig = {
             retries: config.retry?.retries ?? 3,
             jitter: config.retry?.jitter ?? 20,
@@ -238,6 +359,17 @@ function fetcher(baseUrlThunk, configThunk, loggerThunk, path, methodParam) {
                 url,
                 requestId: requestCtx?.requestId,
             });
+            if (requestCtx?.rawResponse) {
+                const headersRecord = {};
+                response.headers.forEach((value, key) => {
+                    headersRecord[key] = value;
+                });
+                return {
+                    status: response.status,
+                    headers: headersRecord,
+                    body: responseJson ?? responseBody,
+                };
+            }
             const isError = !response.ok || response.status >= 400;
             if (isError) {
                 const errObj = {