@oystehr/sdk 3.0.1 → 3.0.3

package/dist/esm/resources/classes/fhir-ext.d.ts

@@ -1,3 +1,5 @@
+import { Address as AddressR4B, HumanName as HumanNameR4B } from 'fhir/r4b';
+import { Address as AddressR5, HumanName as HumanNameR5 } from 'fhir/r5';
 import { BatchInput, Bundle, FhirCreateParams, FhirDeleteParams, FhirGetParams, FhirHistoryGetParams, FhirHistorySearchParams, FhirPatchParams, FhirResource, FhirSearchParams, FhirUpdateParams } from '../..';
 import { FhirFetcherResponse, OystehrClientRequest, SDKResource } from '../../client/client';
 /**
@@ -32,3 +34,14 @@ export declare function history<T extends FhirResource>(this: SDKResource, { res
 export declare function history<T extends FhirResource>(this: SDKResource, { resourceType, id, versionId }: FhirHistoryGetParams, request?: OystehrClientRequest): Promise<FhirFetcherResponse<T>>;
 export declare const batch: <BundleContentType extends FhirResource>(this: SDKResource, input: BatchInput<BundleContentType>, request?: OystehrClientRequest) => Promise<Bundle<BundleContentType>>;
 export declare const transaction: <BundleContentType extends FhirResource>(this: SDKResource, input: BatchInput<BundleContentType>, request?: OystehrClientRequest) => Promise<Bundle<BundleContentType>>;
+export declare function formatAddress(address: AddressR4B | AddressR5, options?: {
+    all?: boolean;
+    use?: boolean;
+    lineSeparator?: string;
+}): string;
+export declare function formatHumanName(name: HumanNameR4B | HumanNameR5, options?: {
+    all?: boolean;
+    prefix?: boolean;
+    suffix?: boolean;
+    use?: boolean;
+}): string;

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

@@ -22,7 +22,7 @@ function search(params, request) {
             }, {});
         }
         const requestBundle = yield this.fhirRequest(`/${resourceType}/_search`, 'POST')(paramMap, Object.assign(Object.assign({}, request), { contentType: 'application/x-www-form-urlencoded' }));
-        const bundle = Object.assign(Object.assign({}, requestBundle), { unbundle: function () {
+        const bundle = Object.assign(Object.assign({}, requestBundle), { entry: requestBundle.entry, unbundle: function () {
                 var _a, _b;
                 return (_b = (_a = this.entry) === null || _a === void 0 ? void 0 : _a.map((entry) => entry.resource).filter((entry) => entry !== undefined)) !== null && _b !== void 0 ? _b : [];
             } });
@@ -126,6 +126,48 @@ function bundleRequest(type) {
 }
 const batch = bundleRequest('batch');
 const transaction = bundleRequest('transaction');
+function formatAddress(address, options) {
+    const builder = [];
+    if (address.line) {
+        builder.push(...address.line);
+    }
+    if (address.city || address.state || address.postalCode) {
+        const cityStateZip = [];
+        if (address.city) {
+            cityStateZip.push(address.city);
+        }
+        if (address.state) {
+            cityStateZip.push(address.state);
+        }
+        if (address.postalCode) {
+            cityStateZip.push(address.postalCode);
+        }
+        builder.push(cityStateZip.join(', '));
+    }
+    if (address.use && ((options === null || options === void 0 ? void 0 : options.all) || (options === null || options === void 0 ? void 0 : options.use))) {
+        builder.push('[' + address.use + ']');
+    }
+    return builder.join((options === null || options === void 0 ? void 0 : options.lineSeparator) || ', ').trim();
+}
+function formatHumanName(name, options) {
+    const builder = [];
+    if (name.prefix && (options === null || options === void 0 ? void 0 : options.prefix) !== false) {
+        builder.push(...name.prefix);
+    }
+    if (name.given) {
+        builder.push(...name.given);
+    }
+    if (name.family) {
+        builder.push(name.family);
+    }
+    if (name.suffix && (options === null || options === void 0 ? void 0 : options.suffix) !== false) {
+        builder.push(...name.suffix);
+    }
+    if (name.use && ((options === null || options === void 0 ? void 0 : options.all) || (options === null || options === void 0 ? void 0 : options.use))) {
+        builder.push('[' + name.use + ']');
+    }
+    return builder.join(' ').trim();
+}
 
-export { batch, create, del as delete, get, history, patch, search, transaction, update };
+export { batch, create, del as delete, formatAddress, formatHumanName, get, history, patch, search, transaction, update };
 //# sourceMappingURL=fhir-ext.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fhir-ext.js","sources":["../../../../src/resources/classes/fhir-ext.ts"],"sourcesContent":["import {\n  BatchInput,\n  BatchInputRequest,\n  Binary,\n  Bundle,\n  BundleEntry,\n  FhirBundle,\n  FhirCreateParams,\n  FhirDeleteParams,\n  FhirGetParams,\n  FhirHistoryGetParams,\n  FhirHistorySearchParams,\n  FhirPatchParams,\n  FhirResource,\n  FhirSearchParams,\n  FhirUpdateParams,\n} from '../..';\nimport { addParamsToSearch, FhirFetcherResponse, OystehrClientRequest, SDKResource } from '../../client/client';\n\n/**\n * Optional parameter that can be passed to the client methods. It allows\n * overriding the access token or project ID, and setting various headers,\n * such as 'Content-Type'. Also support enabling optimistic locking.\n */\nexport interface OystehrFHIRUpdateClientRequest extends OystehrClientRequest {\n  /**\n   * Enable optimistic locking for the request. If set to a version ID, the request will\n   * include the 'If-Match' header with that value in the FHIR optimistic-locking format.\n   * If the resource has been updated since the version provided, the request\n   * will fail with a 412 Precondition Failed error.\n   */\n  optimisticLockingVersionId?: string;\n}\n\n/**\n * Performs a FHIR search and returns the results as a Bundle resource\n *\n * @param options FHIR resource type and FHIR search parameters\n * @param request optional OystehrClientRequest object\n * @returns FHIR Bundle resource\n */\nexport async function search<T extends FhirResource>(\n  this: SDKResource,\n  params: FhirSearchParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<Bundle<T>>> {\n  const { resourceType, params: searchParams } = params;\n  let paramMap: Record<string, (string | number)[]> | undefined;\n  if (searchParams) {\n    paramMap = Object.entries(searchParams).reduce((acc, [_, param]) => {\n      if (!acc[param.name]) {\n        acc[param.name] = [];\n      }\n      acc[param.name].push(param.value);\n      return acc;\n    }, {} as Record<string, (string | number)[]>);\n  }\n  const requestBundle = await this.fhirRequest<FhirBundle<T>>(`/${resourceType}/_search`, 'POST')(paramMap, {\n    ...request,\n    contentType: 'application/x-www-form-urlencoded',\n  });\n  const bundle: Bundle<T> = {\n    ...requestBundle,\n    unbundle: function (this: Bundle<T>) {\n      return this.entry?.map((entry) => entry.resource).filter((entry): entry is T => entry !== undefined) ?? [];\n    },\n  };\n  return bundle;\n}\n\nexport async function create<T extends FhirResource>(\n  this: SDKResource,\n  params: FhirCreateParams<T>,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  const { resourceType } = params;\n  return this.fhirRequest(`/${resourceType}`, 'POST')(params as unknown as Record<string, unknown>, request);\n}\n\nexport async function get<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id }: FhirGetParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  return this.fhirRequest<T>(`/${resourceType}/${id}`, 'GET')({}, request);\n}\n\nexport async function update<T extends FhirResource>(\n  this: SDKResource,\n  params: FhirUpdateParams<T>,\n  request?: OystehrFHIRUpdateClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  const { id, resourceType } = params;\n  return this.fhirRequest(`/${resourceType}/${id}`, 'PUT')(params as unknown as Record<string, unknown>, {\n    ...request,\n    ifMatch: request?.optimisticLockingVersionId ? `W/\"${request.optimisticLockingVersionId}\"` : undefined,\n  });\n}\n\nexport async function patch<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id, operations }: FhirPatchParams,\n  request?: OystehrFHIRUpdateClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  return this.fhirRequest(`/${resourceType}/${id}`, 'PATCH')(operations, {\n    ...request,\n    contentType: 'application/json-patch+json',\n    ifMatch: request?.optimisticLockingVersionId ? `W/\"${request.optimisticLockingVersionId}\"` : undefined,\n  });\n}\n\nasync function del<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id }: FhirDeleteParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  return this.fhirRequest(`/${resourceType}/${id}`, 'DELETE')({}, request);\n}\nexport { del as delete };\n\nexport async function history<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id }: FhirHistorySearchParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<Bundle<T>>>;\nexport async function history<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id, versionId }: FhirHistoryGetParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<T>>;\nexport async function history<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id, versionId }: { resourceType: string; id: string; versionId?: string },\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<Bundle<T>> | FhirFetcherResponse<T>> {\n  return this.fhirRequest(`/${resourceType}/${id}/_history${versionId ? `/${versionId}` : ''}`, 'GET')({}, request);\n}\n\nfunction batchInputRequestToBundleEntryItem<T extends FhirResource>(\n  request: BatchInputRequest<T>\n): BundleEntry<T | Binary<T>> {\n  const { method, url } = request;\n  const baseRequest = {\n    request: {\n      method,\n      url,\n    },\n  };\n\n  // Escape query string parameters in entry.request.url\n  if (url.split('?').length > 1) {\n    const [resource, query] = url.split('?');\n    const params = query\n      .split('&')\n      .map((param) => {\n        const [name, value] = param.split('=');\n        return { name, value };\n      })\n      .reduce((acc, { name, value }) => {\n        acc[name] = value;\n        return acc;\n      }, {} as Record<string, string>);\n    const search = new URLSearchParams();\n    addParamsToSearch(params, search);\n    baseRequest.request.url = `${resource}?${search.toString()}`;\n  }\n\n  // GET, DELETE, and HEAD require no further parameters\n  if (['GET', 'DELETE', 'HEAD'].includes(method)) {\n    return baseRequest as BundleEntry<T>;\n  }\n\n  // PUT updates require a full resource\n  if (method === 'PUT') {\n    const { resource } = request;\n    return {\n      ...baseRequest,\n      resource: resource as T,\n    } as BundleEntry<T>;\n  }\n\n  // PATCH can be Binary resource or JSON patch\n  if (method === 'PATCH') {\n    if ('resource' in request) {\n      return {\n        ...baseRequest,\n        resource: request.resource,\n      } as BundleEntry<Binary<T>>;\n    }\n    return {\n      ...baseRequest,\n      resource: {\n        resourceType: 'Binary',\n        contentType: 'application/json-patch+json',\n        data: Buffer.from(JSON.stringify(request.operations), 'utf8').toString('base64'),\n      },\n    } as BundleEntry<Binary<T>>;\n  }\n\n  // POST creates require a full resource\n  if (method === 'POST') {\n    const { resource, fullUrl } = request;\n    return {\n      ...baseRequest,\n      resource: resource as T,\n      fullUrl,\n    } as BundleEntry<T>;\n  }\n  throw new Error('Unrecognized method');\n}\n\nfunction bundleRequest(type: 'batch' | 'transaction') {\n  return async function <BundleContentType extends FhirResource>(\n    this: SDKResource,\n    input: BatchInput<BundleContentType>,\n    request?: OystehrClientRequest\n  ): Promise<FhirFetcherResponse<Bundle<BundleContentType>>> {\n    return this.fhirRequest('/', 'POST')(\n      {\n        resourceType: 'Bundle',\n        type,\n        entry: input.requests.map(batchInputRequestToBundleEntryItem),\n      },\n      request\n    );\n  };\n}\n\nexport const batch = bundleRequest('batch');\nexport const transaction = bundleRequest('transaction');\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"fhir-ext.js","sources":["../../../../src/resources/classes/fhir-ext.ts"],"sourcesContent":["import { Address as AddressR4B, HumanName as HumanNameR4B } from 'fhir/r4b';\nimport { Address as AddressR5, HumanName as HumanNameR5 } from 'fhir/r5';\nimport {\n  BatchInput,\n  BatchInputRequest,\n  Binary,\n  Bundle,\n  BundleEntry,\n  FhirBundle,\n  FhirCreateParams,\n  FhirDeleteParams,\n  FhirGetParams,\n  FhirHistoryGetParams,\n  FhirHistorySearchParams,\n  FhirPatchParams,\n  FhirResource,\n  FhirSearchParams,\n  FhirUpdateParams,\n} from '../..';\nimport { addParamsToSearch, FhirFetcherResponse, OystehrClientRequest, SDKResource } from '../../client/client';\n\n/**\n * Optional parameter that can be passed to the client methods. It allows\n * overriding the access token or project ID, and setting various headers,\n * such as 'Content-Type'. Also support enabling optimistic locking.\n */\nexport interface OystehrFHIRUpdateClientRequest extends OystehrClientRequest {\n  /**\n   * Enable optimistic locking for the request. If set to a version ID, the request will\n   * include the 'If-Match' header with that value in the FHIR optimistic-locking format.\n   * If the resource has been updated since the version provided, the request\n   * will fail with a 412 Precondition Failed error.\n   */\n  optimisticLockingVersionId?: string;\n}\n\n/**\n * Performs a FHIR search and returns the results as a Bundle resource\n *\n * @param options FHIR resource type and FHIR search parameters\n * @param request optional OystehrClientRequest object\n * @returns FHIR Bundle resource\n */\nexport async function search<T extends FhirResource>(\n  this: SDKResource,\n  params: FhirSearchParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<Bundle<T>>> {\n  const { resourceType, params: searchParams } = params;\n  let paramMap: Record<string, (string | number)[]> | undefined;\n  if (searchParams) {\n    paramMap = Object.entries(searchParams).reduce((acc, [_, param]) => {\n      if (!acc[param.name]) {\n        acc[param.name] = [];\n      }\n      acc[param.name].push(param.value);\n      return acc;\n    }, {} as Record<string, (string | number)[]>);\n  }\n  const requestBundle = await this.fhirRequest<FhirBundle<T>>(`/${resourceType}/_search`, 'POST')(paramMap, {\n    ...request,\n    contentType: 'application/x-www-form-urlencoded',\n  });\n  const bundle: Bundle<T> = {\n    ...requestBundle,\n    entry: requestBundle.entry as Array<BundleEntry<T>> | undefined,\n    unbundle: function (this: { entry?: Array<BundleEntry<T>> | undefined }) {\n      return this.entry?.map((entry) => entry.resource).filter((entry): entry is T => entry !== undefined) ?? [];\n    },\n  };\n  return bundle;\n}\n\nexport async function create<T extends FhirResource>(\n  this: SDKResource,\n  params: FhirCreateParams<T>,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  const { resourceType } = params;\n  return this.fhirRequest(`/${resourceType}`, 'POST')(params as unknown as Record<string, unknown>, request);\n}\n\nexport async function get<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id }: FhirGetParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  return this.fhirRequest<T>(`/${resourceType}/${id}`, 'GET')({}, request);\n}\n\nexport async function update<T extends FhirResource>(\n  this: SDKResource,\n  params: FhirUpdateParams<T>,\n  request?: OystehrFHIRUpdateClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  const { id, resourceType } = params;\n  return this.fhirRequest(`/${resourceType}/${id}`, 'PUT')(params as unknown as Record<string, unknown>, {\n    ...request,\n    ifMatch: request?.optimisticLockingVersionId ? `W/\"${request.optimisticLockingVersionId}\"` : undefined,\n  });\n}\n\nexport async function patch<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id, operations }: FhirPatchParams,\n  request?: OystehrFHIRUpdateClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  return this.fhirRequest(`/${resourceType}/${id}`, 'PATCH')(operations, {\n    ...request,\n    contentType: 'application/json-patch+json',\n    ifMatch: request?.optimisticLockingVersionId ? `W/\"${request.optimisticLockingVersionId}\"` : undefined,\n  });\n}\n\nasync function del<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id }: FhirDeleteParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<T>> {\n  return this.fhirRequest(`/${resourceType}/${id}`, 'DELETE')({}, request);\n}\nexport { del as delete };\n\nexport async function history<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id }: FhirHistorySearchParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<Bundle<T>>>;\nexport async function history<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id, versionId }: FhirHistoryGetParams,\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<T>>;\nexport async function history<T extends FhirResource>(\n  this: SDKResource,\n  { resourceType, id, versionId }: { resourceType: string; id: string; versionId?: string },\n  request?: OystehrClientRequest\n): Promise<FhirFetcherResponse<Bundle<T>> | FhirFetcherResponse<T>> {\n  return this.fhirRequest(`/${resourceType}/${id}/_history${versionId ? `/${versionId}` : ''}`, 'GET')({}, request);\n}\n\nfunction batchInputRequestToBundleEntryItem<T extends FhirResource>(\n  request: BatchInputRequest<T>\n): BundleEntry<T | Binary<T>> {\n  const { method, url } = request;\n  const baseRequest = {\n    request: {\n      method,\n      url,\n    },\n  };\n\n  // Escape query string parameters in entry.request.url\n  if (url.split('?').length > 1) {\n    const [resource, query] = url.split('?');\n    const params = query\n      .split('&')\n      .map((param) => {\n        const [name, value] = param.split('=');\n        return { name, value };\n      })\n      .reduce((acc, { name, value }) => {\n        acc[name] = value;\n        return acc;\n      }, {} as Record<string, string>);\n    const search = new URLSearchParams();\n    addParamsToSearch(params, search);\n    baseRequest.request.url = `${resource}?${search.toString()}`;\n  }\n\n  // GET, DELETE, and HEAD require no further parameters\n  if (['GET', 'DELETE', 'HEAD'].includes(method)) {\n    return baseRequest as BundleEntry<T>;\n  }\n\n  // PUT updates require a full resource\n  if (method === 'PUT') {\n    const { resource } = request;\n    return {\n      ...baseRequest,\n      resource: resource as T,\n    } as BundleEntry<T>;\n  }\n\n  // PATCH can be Binary resource or JSON patch\n  if (method === 'PATCH') {\n    if ('resource' in request) {\n      return {\n        ...baseRequest,\n        resource: request.resource,\n      } as BundleEntry<Binary<T>>;\n    }\n    return {\n      ...baseRequest,\n      resource: {\n        resourceType: 'Binary',\n        contentType: 'application/json-patch+json',\n        data: Buffer.from(JSON.stringify(request.operations), 'utf8').toString('base64'),\n      },\n    } as BundleEntry<Binary<T>>;\n  }\n\n  // POST creates require a full resource\n  if (method === 'POST') {\n    const { resource, fullUrl } = request;\n    return {\n      ...baseRequest,\n      resource: resource as T,\n      fullUrl,\n    } as BundleEntry<T>;\n  }\n  throw new Error('Unrecognized method');\n}\n\nfunction bundleRequest(type: 'batch' | 'transaction') {\n  return async function <BundleContentType extends FhirResource>(\n    this: SDKResource,\n    input: BatchInput<BundleContentType>,\n    request?: OystehrClientRequest\n  ): Promise<FhirFetcherResponse<Bundle<BundleContentType>>> {\n    return this.fhirRequest('/', 'POST')(\n      {\n        resourceType: 'Bundle',\n        type,\n        entry: input.requests.map(batchInputRequestToBundleEntryItem),\n      },\n      request\n    );\n  };\n}\n\nexport const batch = bundleRequest('batch');\nexport const transaction = bundleRequest('transaction');\n\nexport function formatAddress(\n  address: AddressR4B | AddressR5,\n  options?: { all?: boolean; use?: boolean; lineSeparator?: string }\n): string {\n  const builder = [];\n\n  if (address.line) {\n    builder.push(...address.line);\n  }\n\n  if (address.city || address.state || address.postalCode) {\n    const cityStateZip = [];\n    if (address.city) {\n      cityStateZip.push(address.city);\n    }\n    if (address.state) {\n      cityStateZip.push(address.state);\n    }\n    if (address.postalCode) {\n      cityStateZip.push(address.postalCode);\n    }\n    builder.push(cityStateZip.join(', '));\n  }\n\n  if (address.use && (options?.all || options?.use)) {\n    builder.push('[' + address.use + ']');\n  }\n\n  return builder.join(options?.lineSeparator || ', ').trim();\n}\n\nexport function formatHumanName(\n  name: HumanNameR4B | HumanNameR5,\n  options?: {\n    all?: boolean;\n    prefix?: boolean;\n    suffix?: boolean;\n    use?: boolean;\n  }\n): string {\n  const builder = [];\n\n  if (name.prefix && options?.prefix !== false) {\n    builder.push(...name.prefix);\n  }\n\n  if (name.given) {\n    builder.push(...name.given);\n  }\n\n  if (name.family) {\n    builder.push(name.family);\n  }\n\n  if (name.suffix && options?.suffix !== false) {\n    builder.push(...name.suffix);\n  }\n\n  if (name.use && (options?.all || options?.use)) {\n    builder.push('[' + name.use + ']');\n  }\n\n  return builder.join(' ').trim();\n}\n"],"names":[],"mappings":"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"}

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

@@ -18,4 +18,6 @@ export declare class Fhir extends SDKResource {
     history: typeof ext.history;
     batch: <BundleContentType extends import("..").FhirResource>(this: SDKResource, input: import("..").BatchInput<BundleContentType>, request?: import("../../client/client").OystehrClientRequest | undefined) => Promise<import("..").Bundle<BundleContentType>>;
     transaction: <BundleContentType extends import("..").FhirResource>(this: SDKResource, input: import("..").BatchInput<BundleContentType>, request?: import("../../client/client").OystehrClientRequest | undefined) => Promise<import("..").Bundle<BundleContentType>>;
+    formatAddress: typeof ext.formatAddress;
+    formatHumanName: typeof ext.formatHumanName;
 }

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

@@ -1,5 +1,5 @@
 import { SDKResource } from '../../client/client.js';
-import { search, create, get, update, patch, delete as del, history, batch, transaction } from './fhir-ext.js';
+import { search, create, get, update, patch, delete as del, history, batch, transaction, formatAddress, formatHumanName } from './fhir-ext.js';
 
 // AUTOGENERATED -- DO NOT EDIT
 class Fhir extends SDKResource {
@@ -20,6 +20,8 @@ class Fhir extends SDKResource {
         this.history = history;
         this.batch = batch;
         this.transaction = transaction;
+        this.formatAddress = formatAddress;
+        this.formatHumanName = formatHumanName;
     }
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"fhir.js","sources":["../../../../src/resources/classes/fhir.ts"],"sourcesContent":["// AUTOGENERATED -- DO NOT EDIT\n\nimport { SDKResource } from '../../client/client';\nimport { OystehrConfig } from '../../config';\nimport * as ext from './fhir-ext';\n\nexport class Fhir extends SDKResource {\n  constructor(config: OystehrConfig) {\n    super(config);\n  }\n  /**\n   * Performs a FHIR search and returns the results as a Bundle resource\n   * @param options FHIR resource type and FHIR search parameters\n   * @param request optional OystehrClientRequest object\n   * @returns FHIR Bundle resource\n   */\n  search = ext.search;\n  create = ext.create;\n  get = ext.get;\n  update = ext.update;\n  patch = ext.patch;\n  delete = ext.delete;\n  history = ext.history;\n  batch = ext.batch;\n  transaction = ext.transaction;\n}\n"],"names":["ext.search","ext.create","ext.get","ext.update","ext.patch","ext.delete","ext.history","ext.batch","ext.transaction"],"mappings":";;;AAAA;AAMM,MAAO,IAAK,SAAQ,WAAW,CAAA;AACnC,IAAA,WAAA,CAAY,MAAqB,EAAA;QAC/B,KAAK,CAAC,MAAM,CAAC,CAAC;AAEhB;;;;;AAKG;AACH,QAAA,IAAA,CAAA,MAAM,GAAGA,MAAU,CAAC;AACpB,QAAA,IAAA,CAAA,MAAM,GAAGC,MAAU,CAAC;AACpB,QAAA,IAAA,CAAA,GAAG,GAAGC,GAAO,CAAC;AACd,QAAA,IAAA,CAAA,MAAM,GAAGC,MAAU,CAAC;AACpB,QAAA,IAAA,CAAA,KAAK,GAAGC,KAAS,CAAC;AAClB,QAAA,IAAA,CAAA,MAAM,GAAGC,GAAU,CAAC;AACpB,QAAA,IAAA,CAAA,OAAO,GAAGC,OAAW,CAAC;AACtB,QAAA,IAAA,CAAA,KAAK,GAAGC,KAAS,CAAC;AAClB,QAAA,IAAA,CAAA,WAAW,GAAGC,WAAe,CAAC;KAf7B;AAgBF;;;;"}
+{"version":3,"file":"fhir.js","sources":["../../../../src/resources/classes/fhir.ts"],"sourcesContent":["// AUTOGENERATED -- DO NOT EDIT\n\nimport { SDKResource } from '../../client/client';\nimport { OystehrConfig } from '../../config';\nimport * as ext from './fhir-ext';\n\nexport class Fhir extends SDKResource {\n  constructor(config: OystehrConfig) {\n    super(config);\n  }\n  /**\n   * Performs a FHIR search and returns the results as a Bundle resource\n   * @param options FHIR resource type and FHIR search parameters\n   * @param request optional OystehrClientRequest object\n   * @returns FHIR Bundle resource\n   */\n  search = ext.search;\n  create = ext.create;\n  get = ext.get;\n  update = ext.update;\n  patch = ext.patch;\n  delete = ext.delete;\n  history = ext.history;\n  batch = ext.batch;\n  transaction = ext.transaction;\n  formatAddress = ext.formatAddress;\n  formatHumanName = ext.formatHumanName;\n}\n"],"names":["ext.search","ext.create","ext.get","ext.update","ext.patch","ext.delete","ext.history","ext.batch","ext.transaction","ext.formatAddress","ext.formatHumanName"],"mappings":";;;AAAA;AAMM,MAAO,IAAK,SAAQ,WAAW,CAAA;AACnC,IAAA,WAAA,CAAY,MAAqB,EAAA;QAC/B,KAAK,CAAC,MAAM,CAAC,CAAC;AAEhB;;;;;AAKG;AACH,QAAA,IAAA,CAAA,MAAM,GAAGA,MAAU,CAAC;AACpB,QAAA,IAAA,CAAA,MAAM,GAAGC,MAAU,CAAC;AACpB,QAAA,IAAA,CAAA,GAAG,GAAGC,GAAO,CAAC;AACd,QAAA,IAAA,CAAA,MAAM,GAAGC,MAAU,CAAC;AACpB,QAAA,IAAA,CAAA,KAAK,GAAGC,KAAS,CAAC;AAClB,QAAA,IAAA,CAAA,MAAM,GAAGC,GAAU,CAAC;AACpB,QAAA,IAAA,CAAA,OAAO,GAAGC,OAAW,CAAC;AACtB,QAAA,IAAA,CAAA,KAAK,GAAGC,KAAS,CAAC;AAClB,QAAA,IAAA,CAAA,WAAW,GAAGC,WAAe,CAAC;AAC9B,QAAA,IAAA,CAAA,aAAa,GAAGC,aAAiB,CAAC;AAClC,QAAA,IAAA,CAAA,eAAe,GAAGC,eAAmB,CAAC;KAjBrC;AAkBF;;;;"}

package/dist/esm/resources/classes/z3-ext.d.ts

@@ -1,10 +1,32 @@
 import { SDKResource } from '../../client/client';
+import { Z3GetPresignedUrlParams, Z3GetPresignedUrlResponse } from '../types';
+/**
+ * Uploads a file to the bucket and key. Files should be Blobs.
+ *
+ * @param params upload file params
+ */
 export declare function uploadFile(this: SDKResource, { bucketName, 'objectPath+': key, file, }: {
     bucketName: string;
     'objectPath+': string;
     file: Blob;
 }): Promise<void>;
+/**
+ * Downloads an object matching the bucket and key. File content is returned as an ArrayBuffer.
+ *
+ * @param params download file params
+ */
 export declare function downloadFile(this: SDKResource, { bucketName, 'objectPath+': key, }: {
     bucketName: string;
     'objectPath+': string;
 }): Promise<ArrayBuffer>;
+/**
+ * This helper performs a `getPresignedUrl` request for Z3 URLs of the forms
+ * `https://projects-api.oystehr.com/v1/z3/<bucket>/<key>` or `z3://<bucket>/<key>`
+ * instead of the standard SDK `Z3GetPresignedUrlParams`.
+ *
+ * @param params url and action
+ */
+export declare function getPresignedUrlForZ3Url(this: SDKResource, params: {
+    url: string;
+    action: Z3GetPresignedUrlParams['action'];
+}): Promise<Z3GetPresignedUrlResponse>;

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

@@ -1,5 +1,12 @@
 import { __awaiter } from '../../node_modules/tslib/tslib.es6.js';
+import { defaultProjectApiUrl } from '../../client/client.js';
+import { OystehrSdkError } from '../../errors/index.js';
 
+/**
+ * Uploads a file to the bucket and key. Files should be Blobs.
+ *
+ * @param params upload file params
+ */
 function uploadFile({ bucketName, 'objectPath+': key, file, }) {
     return __awaiter(this, void 0, void 0, function* () {
         const uploadUrl = yield this.request('/z3/{bucketName}/{objectPath+}', 'post')({
@@ -13,6 +20,11 @@ function uploadFile({ bucketName, 'objectPath+': key, file, }) {
         });
     });
 }
+/**
+ * Downloads an object matching the bucket and key. File content is returned as an ArrayBuffer.
+ *
+ * @param params download file params
+ */
 function downloadFile({ bucketName, 'objectPath+': key, }) {
     return __awaiter(this, void 0, void 0, function* () {
         const uploadUrl = yield this.request('/z3/{bucketName}/{objectPath+}', 'post')({
@@ -29,6 +41,42 @@ function downloadFile({ bucketName, 'objectPath+': key, }) {
         return resp.arrayBuffer();
     });
 }
+/**
+ * This helper performs a `getPresignedUrl` request for Z3 URLs of the forms
+ * `https://projects-api.oystehr.com/v1/z3/<bucket>/<key>` or `z3://<bucket>/<key>`
+ * instead of the standard SDK `Z3GetPresignedUrlParams`.
+ *
+ * @param params url and action
+ */
+function getPresignedUrlForZ3Url(params) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function* () {
+        let bucket;
+        let key;
+        const url = new URL(params.url);
+        if (url.protocol === 'z3:') {
+            // remove leading forward slash
+            const z3PathParts = url.pathname.split('/').slice(1);
+            bucket = url.hostname;
+            key = z3PathParts.join('/');
+        }
+        else if (url.href.startsWith((_a = this.config.projectApiUrl) !== null && _a !== void 0 ? _a : defaultProjectApiUrl)) {
+            // remove leading `/v1/z3`
+            const httpsPathParts = url.pathname.split('/').slice(3);
+            bucket = httpsPathParts[0];
+            key = httpsPathParts.slice(1).join('/');
+        }
+        else {
+            throw new OystehrSdkError({ message: 'Invalid Z3 URL', code: 400 });
+        }
+        const requestParams = {
+            action: 'upload',
+            bucketName: bucket,
+            'objectPath+': key,
+        };
+        return this.request('/z3/{bucketName}/{objectPath+}', 'post')(requestParams);
+    });
+}
 
-export { downloadFile, uploadFile };
+export { downloadFile, getPresignedUrlForZ3Url, uploadFile };
 //# sourceMappingURL=z3-ext.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"z3-ext.js","sources":["../../../../src/resources/classes/z3-ext.ts"],"sourcesContent":["import { SDKResource } from '../../client/client';\n\nexport async function uploadFile(\n  this: SDKResource,\n  {\n    bucketName,\n    'objectPath+': key,\n    file,\n  }: {\n    bucketName: string;\n    'objectPath+': string;\n    file: Blob;\n  }\n): Promise<void> {\n  const uploadUrl = await this.request(\n    '/z3/{bucketName}/{objectPath+}',\n    'post'\n  )({\n    action: 'upload',\n    bucketName,\n    'objectPath+': key,\n  });\n  await fetch(uploadUrl.signedUrl, {\n    method: 'PUT',\n    body: file,\n  });\n}\n\nexport async function downloadFile(\n  this: SDKResource,\n  {\n    bucketName,\n    'objectPath+': key,\n  }: {\n    bucketName: string;\n    'objectPath+': string;\n  }\n): Promise<ArrayBuffer> {\n  const uploadUrl = await this.request(\n    '/z3/{bucketName}/{objectPath+}',\n    'post'\n  )({\n    action: 'download',\n    bucketName,\n    'objectPath+': key,\n  });\n  const resp = await fetch(uploadUrl.signedUrl, {\n    method: 'GET',\n  });\n  if (!resp.ok) {\n    throw new Error('Failed to download file');\n  }\n  return resp.arrayBuffer();\n}\n"],"names":[],"mappings":";;AAEM,SAAgB,UAAU,CAE9B,EACE,UAAU,EACV,aAAa,EAAE,GAAG,EAClB,IAAI,GAKL,EAAA;;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAClC,gCAAgC,EAChC,MAAM,CACP,CAAC;AACA,YAAA,MAAM,EAAE,QAAQ;YAChB,UAAU;AACV,YAAA,aAAa,EAAE,GAAG;AACnB,SAAA,CAAC,CAAC;AACH,QAAA,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE;AAC/B,YAAA,MAAM,EAAE,KAAK;AACb,YAAA,IAAI,EAAE,IAAI;AACX,SAAA,CAAC,CAAC;KACJ,CAAA,CAAA;AAAA,CAAA;AAEK,SAAgB,YAAY,CAEhC,EACE,UAAU,EACV,aAAa,EAAE,GAAG,GAInB,EAAA;;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAClC,gCAAgC,EAChC,MAAM,CACP,CAAC;AACA,YAAA,MAAM,EAAE,UAAU;YAClB,UAAU;AACV,YAAA,aAAa,EAAE,GAAG;AACnB,SAAA,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE;AAC5C,YAAA,MAAM,EAAE,KAAK;AACd,SAAA,CAAC,CAAC;AACH,QAAA,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;AACZ,YAAA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC5C,SAAA;AACD,QAAA,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;KAC3B,CAAA,CAAA;AAAA;;;;"}
+{"version":3,"file":"z3-ext.js","sources":["../../../../src/resources/classes/z3-ext.ts"],"sourcesContent":["import { defaultProjectApiUrl, SDKResource } from '../../client/client';\nimport { OystehrSdkError } from '../../errors';\nimport { Z3GetPresignedUrlParams, Z3GetPresignedUrlResponse } from '../types';\n\n/**\n * Uploads a file to the bucket and key. Files should be Blobs.\n *\n * @param params upload file params\n */\nexport async function uploadFile(\n  this: SDKResource,\n  {\n    bucketName,\n    'objectPath+': key,\n    file,\n  }: {\n    bucketName: string;\n    'objectPath+': string;\n    file: Blob;\n  }\n): Promise<void> {\n  const uploadUrl = await this.request(\n    '/z3/{bucketName}/{objectPath+}',\n    'post'\n  )({\n    action: 'upload',\n    bucketName,\n    'objectPath+': key,\n  });\n  await fetch(uploadUrl.signedUrl, {\n    method: 'PUT',\n    body: file,\n  });\n}\n\n/**\n * Downloads an object matching the bucket and key. File content is returned as an ArrayBuffer.\n *\n * @param params download file params\n */\nexport async function downloadFile(\n  this: SDKResource,\n  {\n    bucketName,\n    'objectPath+': key,\n  }: {\n    bucketName: string;\n    'objectPath+': string;\n  }\n): Promise<ArrayBuffer> {\n  const uploadUrl = await this.request(\n    '/z3/{bucketName}/{objectPath+}',\n    'post'\n  )({\n    action: 'download',\n    bucketName,\n    'objectPath+': key,\n  });\n  const resp = await fetch(uploadUrl.signedUrl, {\n    method: 'GET',\n  });\n  if (!resp.ok) {\n    throw new Error('Failed to download file');\n  }\n  return resp.arrayBuffer();\n}\n\n/**\n * This helper performs a `getPresignedUrl` request for Z3 URLs of the forms\n * `https://projects-api.oystehr.com/v1/z3/<bucket>/<key>` or `z3://<bucket>/<key>`\n * instead of the standard SDK `Z3GetPresignedUrlParams`.\n *\n * @param params url and action\n */\nexport async function getPresignedUrlForZ3Url(\n  this: SDKResource,\n  params: { url: string; action: Z3GetPresignedUrlParams['action'] }\n): Promise<Z3GetPresignedUrlResponse> {\n  let bucket: string;\n  let key: string;\n  const url = new URL(params.url);\n  if (url.protocol === 'z3:') {\n    // remove leading forward slash\n    const z3PathParts = url.pathname.split('/').slice(1);\n    bucket = url.hostname;\n    key = z3PathParts.join('/');\n  } else if (url.href.startsWith(this.config.projectApiUrl ?? defaultProjectApiUrl)) {\n    // remove leading `/v1/z3`\n    const httpsPathParts = url.pathname.split('/').slice(3);\n    bucket = httpsPathParts[0];\n    key = httpsPathParts.slice(1).join('/');\n  } else {\n    throw new OystehrSdkError({ message: 'Invalid Z3 URL', code: 400 });\n  }\n  const requestParams: Z3GetPresignedUrlParams = {\n    action: 'upload',\n    bucketName: bucket,\n    'objectPath+': key,\n  };\n  return this.request('/z3/{bucketName}/{objectPath+}', 'post')(requestParams);\n}\n"],"names":[],"mappings":";;;;AAIA;;;;AAIG;AACG,SAAgB,UAAU,CAE9B,EACE,UAAU,EACV,aAAa,EAAE,GAAG,EAClB,IAAI,GAKL,EAAA;;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAClC,gCAAgC,EAChC,MAAM,CACP,CAAC;AACA,YAAA,MAAM,EAAE,QAAQ;YAChB,UAAU;AACV,YAAA,aAAa,EAAE,GAAG;AACnB,SAAA,CAAC,CAAC;AACH,QAAA,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE;AAC/B,YAAA,MAAM,EAAE,KAAK;AACb,YAAA,IAAI,EAAE,IAAI;AACX,SAAA,CAAC,CAAC;KACJ,CAAA,CAAA;AAAA,CAAA;AAED;;;;AAIG;AACG,SAAgB,YAAY,CAEhC,EACE,UAAU,EACV,aAAa,EAAE,GAAG,GAInB,EAAA;;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAClC,gCAAgC,EAChC,MAAM,CACP,CAAC;AACA,YAAA,MAAM,EAAE,UAAU;YAClB,UAAU;AACV,YAAA,aAAa,EAAE,GAAG;AACnB,SAAA,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE;AAC5C,YAAA,MAAM,EAAE,KAAK;AACd,SAAA,CAAC,CAAC;AACH,QAAA,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;AACZ,YAAA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC5C,SAAA;AACD,QAAA,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;KAC3B,CAAA,CAAA;AAAA,CAAA;AAED;;;;;;AAMG;AACG,SAAgB,uBAAuB,CAE3C,MAAkE,EAAA;;;AAElE,QAAA,IAAI,MAAc,CAAC;AACnB,QAAA,IAAI,GAAW,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAChC,QAAA,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,EAAE;;AAE1B,YAAA,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrD,YAAA,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC;AACtB,YAAA,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7B,SAAA;AAAM,aAAA,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA,EAAA,GAAA,IAAI,CAAC,MAAM,CAAC,aAAa,MAAI,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAA,oBAAoB,CAAC,EAAE;;AAEjF,YAAA,MAAM,cAAc,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,YAAA,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;AAC3B,YAAA,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,SAAA;AAAM,aAAA;AACL,YAAA,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;AACrE,SAAA;AACD,QAAA,MAAM,aAAa,GAA4B;AAC7C,YAAA,MAAM,EAAE,QAAQ;AAChB,YAAA,UAAU,EAAE,MAAM;AAClB,YAAA,aAAa,EAAE,GAAG;SACnB,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;;AAC9E;;;;"}

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

@@ -4,8 +4,23 @@ import { OystehrConfig } from '../../config';
 import * as ext from './z3-ext';
 export declare class Z3 extends SDKResource {
     constructor(config: OystehrConfig);
+    /**
+     * Uploads a file to the bucket and key. Files should be Blobs.
+     * @param params upload file params
+     */
     uploadFile: typeof ext.uploadFile;
+    /**
+     * Downloads an object matching the bucket and key. File content is returned as an ArrayBuffer.
+     * @param params download file params
+     */
     downloadFile: typeof ext.downloadFile;
+    /**
+     * This helper performs a `getPresignedUrl` request for Z3 URLs of the forms
+     * `https://projects-api.oystehr.com/v1/z3/<bucket>/<key>` * or `z3://<bucket>/<key>`
+     * instead of the standard SDK `Z3GetPresignedUrlParams`.
+     * @param params url and action
+     */
+    getPresignedUrlForZ3Url: typeof ext.getPresignedUrlForZ3Url;
     /**
      * List all Z3 Buckets. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.
      *

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

@@ -1,12 +1,27 @@
 import { SDKResource } from '../../client/client.js';
-import { uploadFile, downloadFile } from './z3-ext.js';
+import { uploadFile, downloadFile, getPresignedUrlForZ3Url } from './z3-ext.js';
 
 // AUTOGENERATED -- DO NOT EDIT
 class Z3 extends SDKResource {
     constructor(config) {
         super(config);
+        /**
+         * Uploads a file to the bucket and key. Files should be Blobs.
+         * @param params upload file params
+         */
         this.uploadFile = uploadFile;
+        /**
+         * Downloads an object matching the bucket and key. File content is returned as an ArrayBuffer.
+         * @param params download file params
+         */
         this.downloadFile = downloadFile;
+        /**
+         * This helper performs a `getPresignedUrl` request for Z3 URLs of the forms
+         * `https://projects-api.oystehr.com/v1/z3/<bucket>/<key>` * or `z3://<bucket>/<key>`
+         * instead of the standard SDK `Z3GetPresignedUrlParams`.
+         * @param params url and action
+         */
+        this.getPresignedUrlForZ3Url = getPresignedUrlForZ3Url;
         /**
          * List all Z3 Buckets. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.
          *

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

@@ -1 +1 @@
-{"version":3,"file":"z3.js","sources":["../../../../src/resources/classes/z3.ts"],"sourcesContent":["// AUTOGENERATED -- DO NOT EDIT\n\nimport {\n  OystehrClientRequest,\n  Z3CreateBucketParams,\n  Z3CreateBucketResponse,\n  Z3DeleteBucketParams,\n  Z3DeleteObjectParams,\n  Z3GetPresignedUrlParams,\n  Z3GetPresignedUrlResponse,\n  Z3ListBucketsResponse,\n  Z3ListObjectsParams,\n  Z3ListObjectsResponse,\n} from '../..';\nimport { SDKResource } from '../../client/client';\nimport { OystehrConfig } from '../../config';\nimport * as ext from './z3-ext';\n\nexport class Z3 extends SDKResource {\n  constructor(config: OystehrConfig) {\n    super(config);\n  }\n  uploadFile = ext.uploadFile;\n  downloadFile = ext.downloadFile;\n  /**\n   * List all Z3 Buckets. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:ListBuckets`\n   * Access Policy Resource: `Z3:BucketName`\n   */\n  listBuckets = (request?: OystehrClientRequest): Promise<Z3ListBucketsResponse> => this.request('/z3', 'get')(request);\n  /**\n   * Create a Z3 Bucket with the provided name. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:CreateBucket`\n   * Access Policy Resource: `Z3:BucketName`\n   */\n  createBucket = (params: Z3CreateBucketParams, request?: OystehrClientRequest): Promise<Z3CreateBucketResponse> =>\n    this.request('/z3/{bucketName}', 'put')(params, request);\n  /**\n   * Delete the Z3 Bucket with the provided name. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:DeleteBucket`\n   * Access Policy Resource: `Z3:BucketName`\n   */\n  deleteBucket = (params: Z3DeleteBucketParams, request?: OystehrClientRequest): Promise<void> =>\n    this.request('/z3/{bucketName}', 'delete')(params, request);\n  /**\n   * List all Z3 Objects at the provided path in the Bucket with the provided name [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:ListObjects`\n   * Access Policy Resource: `Z3:BucketName:ObjectPath`\n   */\n  listObjects = (params: Z3ListObjectsParams, request?: OystehrClientRequest): Promise<Z3ListObjectsResponse> =>\n    this.request('/z3/{bucketName}/{objectPath+}', 'get')(params, request);\n  /**\n   * Get a link for downloading or uploading a Z3 Object to the provided path in the Bucket with the provided name. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:PutObject` or `Z3:GetObject`\n   * Access Policy Resource: `Z3:BucketName:ObjectPath`\n   */\n  getPresignedUrl = (\n    params: Z3GetPresignedUrlParams,\n    request?: OystehrClientRequest\n  ): Promise<Z3GetPresignedUrlResponse> => this.request('/z3/{bucketName}/{objectPath+}', 'post')(params, request);\n  /**\n   * Delete the Z3 Object at the provided path in the Bucket with the provided name. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:DeleteObject`\n   * Access Policy Resource: `Z3:BucketName:ObjectPath`\n   */\n  deleteObject = (params: Z3DeleteObjectParams, request?: OystehrClientRequest): Promise<void> =>\n    this.request('/z3/{bucketName}/{objectPath+}', 'delete')(params, request);\n}\n"],"names":["ext.uploadFile","ext.downloadFile"],"mappings":";;;AAAA;AAkBM,MAAO,EAAG,SAAQ,WAAW,CAAA;AACjC,IAAA,WAAA,CAAY,MAAqB,EAAA;QAC/B,KAAK,CAAC,MAAM,CAAC,CAAC;AAEhB,QAAA,IAAA,CAAA,UAAU,GAAGA,UAAc,CAAC;AAC5B,QAAA,IAAA,CAAA,YAAY,GAAGC,YAAgB,CAAC;AAChC;;;;;AAKG;AACH,QAAA,IAAA,CAAA,WAAW,GAAG,CAAC,OAA8B,KAAqC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AACtH;;;;;AAKG;QACH,IAAY,CAAA,YAAA,GAAG,CAAC,MAA4B,EAAE,OAA8B,KAC1E,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3D;;;;;AAKG;QACH,IAAY,CAAA,YAAA,GAAG,CAAC,MAA4B,EAAE,OAA8B,KAC1E,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC9D;;;;;AAKG;QACH,IAAW,CAAA,WAAA,GAAG,CAAC,MAA2B,EAAE,OAA8B,KACxE,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACzE;;;;;AAKG;QACH,IAAe,CAAA,eAAA,GAAG,CAChB,MAA+B,EAC/B,OAA8B,KACS,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjH;;;;;AAKG;QACH,IAAY,CAAA,YAAA,GAAG,CAAC,MAA4B,EAAE,OAA8B,KAC1E,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAnD3E;AAoDF;;;;"}
+{"version":3,"file":"z3.js","sources":["../../../../src/resources/classes/z3.ts"],"sourcesContent":["// AUTOGENERATED -- DO NOT EDIT\n\nimport {\n  OystehrClientRequest,\n  Z3CreateBucketParams,\n  Z3CreateBucketResponse,\n  Z3DeleteBucketParams,\n  Z3DeleteObjectParams,\n  Z3GetPresignedUrlParams,\n  Z3GetPresignedUrlResponse,\n  Z3ListBucketsResponse,\n  Z3ListObjectsParams,\n  Z3ListObjectsResponse,\n} from '../..';\nimport { SDKResource } from '../../client/client';\nimport { OystehrConfig } from '../../config';\nimport * as ext from './z3-ext';\n\nexport class Z3 extends SDKResource {\n  constructor(config: OystehrConfig) {\n    super(config);\n  }\n  /**\n   * Uploads a file to the bucket and key. Files should be Blobs.\n   * @param params upload file params\n   */\n  uploadFile = ext.uploadFile;\n  /**\n   * Downloads an object matching the bucket and key. File content is returned as an ArrayBuffer.\n   * @param params download file params\n   */\n  downloadFile = ext.downloadFile;\n  /**\n   * This helper performs a `getPresignedUrl` request for Z3 URLs of the forms\n   * `https://projects-api.oystehr.com/v1/z3/<bucket>/<key>` * or `z3://<bucket>/<key>`\n   * instead of the standard SDK `Z3GetPresignedUrlParams`.\n   * @param params url and action\n   */\n  getPresignedUrlForZ3Url = ext.getPresignedUrlForZ3Url;\n  /**\n   * List all Z3 Buckets. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:ListBuckets`\n   * Access Policy Resource: `Z3:BucketName`\n   */\n  listBuckets = (request?: OystehrClientRequest): Promise<Z3ListBucketsResponse> => this.request('/z3', 'get')(request);\n  /**\n   * Create a Z3 Bucket with the provided name. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:CreateBucket`\n   * Access Policy Resource: `Z3:BucketName`\n   */\n  createBucket = (params: Z3CreateBucketParams, request?: OystehrClientRequest): Promise<Z3CreateBucketResponse> =>\n    this.request('/z3/{bucketName}', 'put')(params, request);\n  /**\n   * Delete the Z3 Bucket with the provided name. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:DeleteBucket`\n   * Access Policy Resource: `Z3:BucketName`\n   */\n  deleteBucket = (params: Z3DeleteBucketParams, request?: OystehrClientRequest): Promise<void> =>\n    this.request('/z3/{bucketName}', 'delete')(params, request);\n  /**\n   * List all Z3 Objects at the provided path in the Bucket with the provided name [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:ListObjects`\n   * Access Policy Resource: `Z3:BucketName:ObjectPath`\n   */\n  listObjects = (params: Z3ListObjectsParams, request?: OystehrClientRequest): Promise<Z3ListObjectsResponse> =>\n    this.request('/z3/{bucketName}/{objectPath+}', 'get')(params, request);\n  /**\n   * Get a link for downloading or uploading a Z3 Object to the provided path in the Bucket with the provided name. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:PutObject` or `Z3:GetObject`\n   * Access Policy Resource: `Z3:BucketName:ObjectPath`\n   */\n  getPresignedUrl = (\n    params: Z3GetPresignedUrlParams,\n    request?: OystehrClientRequest\n  ): Promise<Z3GetPresignedUrlResponse> => this.request('/z3/{bucketName}/{objectPath+}', 'post')(params, request);\n  /**\n   * Delete the Z3 Object at the provided path in the Bucket with the provided name. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.\n   *\n   * Access Policy Action: `Z3:DeleteObject`\n   * Access Policy Resource: `Z3:BucketName:ObjectPath`\n   */\n  deleteObject = (params: Z3DeleteObjectParams, request?: OystehrClientRequest): Promise<void> =>\n    this.request('/z3/{bucketName}/{objectPath+}', 'delete')(params, request);\n}\n"],"names":["ext.uploadFile","ext.downloadFile","ext.getPresignedUrlForZ3Url"],"mappings":";;;AAAA;AAkBM,MAAO,EAAG,SAAQ,WAAW,CAAA;AACjC,IAAA,WAAA,CAAY,MAAqB,EAAA;QAC/B,KAAK,CAAC,MAAM,CAAC,CAAC;AAEhB;;;AAGG;AACH,QAAA,IAAA,CAAA,UAAU,GAAGA,UAAc,CAAC;AAC5B;;;AAGG;AACH,QAAA,IAAA,CAAA,YAAY,GAAGC,YAAgB,CAAC;AAChC;;;;;AAKG;AACH,QAAA,IAAA,CAAA,uBAAuB,GAAGC,uBAA2B,CAAC;AACtD;;;;;AAKG;AACH,QAAA,IAAA,CAAA,WAAW,GAAG,CAAC,OAA8B,KAAqC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AACtH;;;;;AAKG;QACH,IAAY,CAAA,YAAA,GAAG,CAAC,MAA4B,EAAE,OAA8B,KAC1E,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3D;;;;;AAKG;QACH,IAAY,CAAA,YAAA,GAAG,CAAC,MAA4B,EAAE,OAA8B,KAC1E,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC9D;;;;;AAKG;QACH,IAAW,CAAA,WAAA,GAAG,CAAC,MAA2B,EAAE,OAA8B,KACxE,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACzE;;;;;AAKG;QACH,IAAe,CAAA,eAAA,GAAG,CAChB,MAA+B,EAC/B,OAA8B,KACS,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjH;;;;;AAKG;QACH,IAAY,CAAA,YAAA,GAAG,CAAC,MAA4B,EAAE,OAA8B,KAC1E,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAlE3E;AAmEF;;;;"}

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

@@ -7,6 +7,6 @@ export interface ZambdaCreateParams {
     /**
      * The trigger method for the Zambda Function determines how the Function is invoked. Learn more about the different types here, https://docs.oystehr.com/services/zambda/#types-of-zambdas.
      */
-    triggerMethod: 'http_auth' | 'http_open' | 'subscription' | 'cron';
+    triggerMethod?: 'http_auth' | 'http_open' | 'subscription' | 'cron';
     schedule?: ZambdaSchedule;
 }

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

@@ -2,10 +2,13 @@ import type { Operation } from 'fast-json-patch';
 import type { Binary as BinaryR4B, Bundle as BundleR4B, BundleEntry as BundleEntryR4B, FhirResource as FhirResourceR4B, OperationOutcome as OperationOutcomeR4B } from 'fhir/r4b';
 import type { Binary as BinaryR5, Bundle as BundleR5, BundleEntry as BundleEntryR5, FhirResource as FhirResourceR5, OperationOutcome as OperationOutcomeR5 } from 'fhir/r5';
 export type FhirResource = FhirResourceR4B | FhirResourceR5;
-export type FhirBundle<F extends FhirResource> = F extends FhirResourceR4B ? Omit<BundleR4B<F>, 'entry'> : Omit<BundleR5<F>, 'entry'>;
-export type Bundle<F extends FhirResource> = FhirBundle<F> & {
+export type FhirBundle<F extends FhirResource> = F extends FhirResourceR4B ? BundleR4B<F> : BundleR5<F>;
+export type EntrylessFhirBundle<F extends FhirResource> = F extends FhirResourceR4B ? Omit<BundleR4B<F>, 'entry'> : Omit<BundleR5<F>, 'entry'>;
+export type Bundle<F extends FhirResource> = EntrylessFhirBundle<F> & {
     entry?: Array<BundleEntry<F>> | undefined;
-    unbundle: (this: Bundle<F>) => F[];
+    unbundle: (this: {
+        entry?: Array<BundleEntry<F>>;
+    }) => F[];
 };
 export type BundleEntry<F extends FhirResource> = F extends FhirResourceR4B ? BundleEntryR4B<F> : BundleEntryR5<F>;
 export type Binary<F extends FhirResource> = F extends FhirResourceR4B ? BinaryR4B : BinaryR5;

package/package.json

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

package/src/client/client.ts

@@ -4,7 +4,7 @@ import { OystehrFHIRError, OystehrSdkError } from '../errors';
 import { FhirBundle, FhirResource, OperationOutcome } from '../resources/types';
 
 type HttpMethod = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
-const defaultProjectApiUrl = 'https://project-api.zapehr.com/v1';
+export const defaultProjectApiUrl = 'https://project-api.zapehr.com/v1';
 const defaultFhirApiUrl = 'https://fhir-api.zapehr.com';
 const STATUS_CODES_TO_RETRY = [408, 429, 500, 502, 503, 504];
 const ERROR_CODES_TO_RETRY = [
@@ -50,7 +50,7 @@ type FhirData<T extends FhirResource> = T | T[] | FhirBundle<T>;
 export type FhirFetcherResponse<T extends FhirData<FhirResource> = any> = T;
 
 export class SDKResource {
-  private readonly config: OystehrConfig;
+  protected readonly config: OystehrConfig;
   constructor(config: OystehrConfig) {
     this.config = config;
   }

package/src/resources/classes/fhir-ext.ts

@@ -1,3 +1,5 @@
+import { Address as AddressR4B, HumanName as HumanNameR4B } from 'fhir/r4b';
+import { Address as AddressR5, HumanName as HumanNameR5 } from 'fhir/r5';
 import {
   BatchInput,
   BatchInputRequest,
@@ -61,7 +63,8 @@ export async function search<T extends FhirResource>(
   });
   const bundle: Bundle<T> = {
     ...requestBundle,
-    unbundle: function (this: Bundle<T>) {
+    entry: requestBundle.entry as Array<BundleEntry<T>> | undefined,
+    unbundle: function (this: { entry?: Array<BundleEntry<T>> | undefined }) {
       return this.entry?.map((entry) => entry.resource).filter((entry): entry is T => entry !== undefined) ?? [];
     },
   };
@@ -228,3 +231,68 @@ function bundleRequest(type: 'batch' | 'transaction') {
 
 export const batch = bundleRequest('batch');
 export const transaction = bundleRequest('transaction');
+
+export function formatAddress(
+  address: AddressR4B | AddressR5,
+  options?: { all?: boolean; use?: boolean; lineSeparator?: string }
+): string {
+  const builder = [];
+
+  if (address.line) {
+    builder.push(...address.line);
+  }
+
+  if (address.city || address.state || address.postalCode) {
+    const cityStateZip = [];
+    if (address.city) {
+      cityStateZip.push(address.city);
+    }
+    if (address.state) {
+      cityStateZip.push(address.state);
+    }
+    if (address.postalCode) {
+      cityStateZip.push(address.postalCode);
+    }
+    builder.push(cityStateZip.join(', '));
+  }
+
+  if (address.use && (options?.all || options?.use)) {
+    builder.push('[' + address.use + ']');
+  }
+
+  return builder.join(options?.lineSeparator || ', ').trim();
+}
+
+export function formatHumanName(
+  name: HumanNameR4B | HumanNameR5,
+  options?: {
+    all?: boolean;
+    prefix?: boolean;
+    suffix?: boolean;
+    use?: boolean;
+  }
+): string {
+  const builder = [];
+
+  if (name.prefix && options?.prefix !== false) {
+    builder.push(...name.prefix);
+  }
+
+  if (name.given) {
+    builder.push(...name.given);
+  }
+
+  if (name.family) {
+    builder.push(name.family);
+  }
+
+  if (name.suffix && options?.suffix !== false) {
+    builder.push(...name.suffix);
+  }
+
+  if (name.use && (options?.all || options?.use)) {
+    builder.push('[' + name.use + ']');
+  }
+
+  return builder.join(' ').trim();
+}

package/src/resources/classes/fhir.ts

@@ -23,4 +23,6 @@ export class Fhir extends SDKResource {
   history = ext.history;
   batch = ext.batch;
   transaction = ext.transaction;
+  formatAddress = ext.formatAddress;
+  formatHumanName = ext.formatHumanName;
 }

package/src/resources/classes/z3-ext.ts

@@ -1,5 +1,12 @@
-import { SDKResource } from '../../client/client';
+import { defaultProjectApiUrl, SDKResource } from '../../client/client';
+import { OystehrSdkError } from '../../errors';
+import { Z3GetPresignedUrlParams, Z3GetPresignedUrlResponse } from '../types';
 
+/**
+ * Uploads a file to the bucket and key. Files should be Blobs.
+ *
+ * @param params upload file params
+ */
 export async function uploadFile(
   this: SDKResource,
   {
@@ -26,6 +33,11 @@ export async function uploadFile(
   });
 }
 
+/**
+ * Downloads an object matching the bucket and key. File content is returned as an ArrayBuffer.
+ *
+ * @param params download file params
+ */
 export async function downloadFile(
   this: SDKResource,
   {
@@ -52,3 +64,38 @@ export async function downloadFile(
   }
   return resp.arrayBuffer();
 }
+
+/**
+ * This helper performs a `getPresignedUrl` request for Z3 URLs of the forms
+ * `https://projects-api.oystehr.com/v1/z3/<bucket>/<key>` or `z3://<bucket>/<key>`
+ * instead of the standard SDK `Z3GetPresignedUrlParams`.
+ *
+ * @param params url and action
+ */
+export async function getPresignedUrlForZ3Url(
+  this: SDKResource,
+  params: { url: string; action: Z3GetPresignedUrlParams['action'] }
+): Promise<Z3GetPresignedUrlResponse> {
+  let bucket: string;
+  let key: string;
+  const url = new URL(params.url);
+  if (url.protocol === 'z3:') {
+    // remove leading forward slash
+    const z3PathParts = url.pathname.split('/').slice(1);
+    bucket = url.hostname;
+    key = z3PathParts.join('/');
+  } else if (url.href.startsWith(this.config.projectApiUrl ?? defaultProjectApiUrl)) {
+    // remove leading `/v1/z3`
+    const httpsPathParts = url.pathname.split('/').slice(3);
+    bucket = httpsPathParts[0];
+    key = httpsPathParts.slice(1).join('/');
+  } else {
+    throw new OystehrSdkError({ message: 'Invalid Z3 URL', code: 400 });
+  }
+  const requestParams: Z3GetPresignedUrlParams = {
+    action: 'upload',
+    bucketName: bucket,
+    'objectPath+': key,
+  };
+  return this.request('/z3/{bucketName}/{objectPath+}', 'post')(requestParams);
+}

package/src/resources/classes/z3.ts

@@ -20,8 +20,23 @@ export class Z3 extends SDKResource {
   constructor(config: OystehrConfig) {
     super(config);
   }
+  /**
+   * Uploads a file to the bucket and key. Files should be Blobs.
+   * @param params upload file params
+   */
   uploadFile = ext.uploadFile;
+  /**
+   * Downloads an object matching the bucket and key. File content is returned as an ArrayBuffer.
+   * @param params download file params
+   */
   downloadFile = ext.downloadFile;
+  /**
+   * This helper performs a `getPresignedUrl` request for Z3 URLs of the forms
+   * `https://projects-api.oystehr.com/v1/z3/<bucket>/<key>` * or `z3://<bucket>/<key>`
+   * instead of the standard SDK `Z3GetPresignedUrlParams`.
+   * @param params url and action
+   */
+  getPresignedUrlForZ3Url = ext.getPresignedUrlForZ3Url;
   /**
    * List all Z3 Buckets. [Z3](https://docs.oystehr.com/services/z3/) is Oystehr's built-in and fully integrated solution for file storage.
    *