@medplum/core 0.5.2 → 0.9.2

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-/*! *****************************************************************************
+/******************************************************************************
 Copyright (c) Microsoft Corporation.
 
 Permission to use, copy, modify, and/or distribute this software for any
@@ -167,6 +167,7 @@ function isProfileResource(resource) {
  * @return Human friendly display string.
  */
 function getDisplayString(resource) {
+    var _a, _b;
     if (isProfileResource(resource)) {
         const profileName = getProfileResourceDisplayString(resource);
         if (profileName) {
@@ -179,6 +180,11 @@ function getDisplayString(resource) {
             return deviceName;
         }
     }
+    if (resource.resourceType === 'Observation') {
+        if ('code' in resource && ((_a = resource.code) === null || _a === void 0 ? void 0 : _a.text)) {
+            return (_b = resource.code) === null || _b === void 0 ? void 0 : _b.text;
+        }
+    }
     if (resource.resourceType === 'User') {
         if (resource.email) {
             return resource.email;
@@ -223,12 +229,25 @@ function getImageSrc(resource) {
         const photos = resource.photo;
         if (photos) {
             for (const photo of photos) {
-                if (photo.url && photo.contentType && photo.contentType.startsWith('image/')) {
-                    return photo.url;
+                const url = getPhotoImageSrc(photo);
+                if (url) {
+                    return url;
                 }
             }
         }
     }
+    if (resource.resourceType === 'Bot' && resource.photo) {
+        const url = getPhotoImageSrc(resource.photo);
+        if (url) {
+            return url;
+        }
+    }
+    return undefined;
+}
+function getPhotoImageSrc(photo) {
+    if (photo.url && photo.contentType && photo.contentType.startsWith('image/')) {
+        return photo.url;
+    }
     return undefined;
 }
 /**
@@ -241,6 +260,96 @@ function getImageSrc(resource) {
 function getDateProperty(date) {
     return date ? new Date(date) : undefined;
 }
+/**
+ * Calculates the age in years from the birth date.
+ * @param birthDateStr The birth date or start date in ISO-8601 format YYYY-MM-DD.
+ * @param endDateStr Optional end date in ISO-8601 format YYYY-MM-DD. Default value is today.
+ * @returns The age in years, months, and days.
+ */
+function calculateAge(birthDateStr, endDateStr) {
+    const startDate = new Date(birthDateStr);
+    startDate.setUTCHours(0, 0, 0, 0);
+    const endDate = endDateStr ? new Date(endDateStr) : new Date();
+    endDate.setUTCHours(0, 0, 0, 0);
+    const startYear = startDate.getUTCFullYear();
+    const startMonth = startDate.getUTCMonth();
+    const startDay = startDate.getUTCDate();
+    const endYear = endDate.getUTCFullYear();
+    const endMonth = endDate.getUTCMonth();
+    const endDay = endDate.getUTCDate();
+    let years = endYear - startYear;
+    if (endMonth < startMonth || (endMonth === startMonth && endDay < startDay)) {
+        years--;
+    }
+    let months = endYear * 12 + endMonth - (startYear * 12 + startMonth);
+    if (endDay < startDay) {
+        months--;
+    }
+    const days = Math.floor((endDate.getTime() - startDate.getTime()) / (1000 * 60 * 60 * 24));
+    return { years, months, days };
+}
+/**
+ * Calculates the age string for display using the age appropriate units.
+ * If the age is greater than or equal to 2 years, then the age is displayed in years.
+ * If the age is greater than or equal to 1 month, then the age is displayed in months.
+ * Otherwise, the age is displayed in days.
+ * @param birthDateStr The birth date or start date in ISO-8601 format YYYY-MM-DD.
+ * @param endDateStr Optional end date in ISO-8601 format YYYY-MM-DD. Default value is today.
+ * @returns The age string.
+ */
+function calculateAgeString(birthDateStr, endDateStr) {
+    const { years, months, days } = calculateAge(birthDateStr, endDateStr);
+    if (years >= 2) {
+        return years.toString().padStart(3, '0') + 'Y';
+    }
+    else if (months >= 1) {
+        return months.toString().padStart(3, '0') + 'M';
+    }
+    else {
+        return days.toString().padStart(3, '0') + 'D';
+    }
+}
+/**
+ * Returns all questionnaire answers as a map by link ID.
+ * @param response The questionnaire response resource.
+ * @returns Questionnaire answers mapped by link ID.
+ */
+function getQuestionnaireAnswers(response) {
+    const result = {};
+    buildQuestionnaireAnswerItems(response.item, result);
+    return result;
+}
+/**
+ * Recursively builds the questionnaire answer items map.
+ * @param item The current questionnaire response item.
+ * @param result The cumulative result map.
+ */
+function buildQuestionnaireAnswerItems(items, result) {
+    if (items) {
+        for (const item of items) {
+            if (item.linkId && item.answer && item.answer.length > 0) {
+                result[item.linkId] = item.answer[0];
+            }
+            buildQuestionnaireAnswerItems(item.item, result);
+        }
+    }
+}
+/**
+ * Returns an extension value by extension URLs.
+ * @param resource The base resource.
+ * @param urls Array of extension URLs.  Each entry represents a nested extension.
+ * @returns The extension value if found; undefined otherwise.
+ */
+function getExtensionValue(resource, ...urls) {
+    var _a;
+    // Let curr be the current resource or extension. Extensions can be nested.
+    let curr = resource;
+    // For each of the urls, try to find a matching nested extension.
+    for (let i = 0; i < urls.length && curr; i++) {
+        curr = (_a = curr === null || curr === void 0 ? void 0 : curr.extension) === null || _a === void 0 ? void 0 : _a.find((e) => e.url === urls[i]);
+    }
+    return curr === null || curr === void 0 ? void 0 : curr.valueString;
+}
 /**
  * FHIR JSON stringify.
  * Removes properties with empty string values.
@@ -261,7 +370,15 @@ function stringify(value, pretty) {
  * @param {*} v Property value.
  */
 function stringifyReplacer(k, v) {
-    return isEmpty(v) ? undefined : v;
+    return !isArrayKey(k) && isEmpty(v) ? undefined : v;
+}
+/**
+ * Returns true if the key is an array key.
+ * @param k The property key.
+ * @returns True if the key is an array key.
+ */
+function isArrayKey(k) {
+    return !!k.match(/\d+$/);
 }
 /**
  * Returns true if the value is empty (null, undefined, empty string, or empty object).
@@ -278,39 +395,78 @@ function isEmpty(v) {
 /**
  * Resource equality.
  * Ignores meta.versionId and meta.lastUpdated.
- * See: https://dmitripavlutin.com/how-to-compare-objects-in-javascript/#4-deep-equality
  * @param object1 The first object.
  * @param object2 The second object.
  * @returns True if the objects are equal.
  */
 function deepEquals(object1, object2, path) {
-    let keys1 = Object.keys(object1);
-    let keys2 = Object.keys(object2);
-    if (path === 'meta') {
-        keys1 = keys1.filter((k) => k !== 'versionId' && k !== 'lastUpdated' && k !== 'author');
-        keys2 = keys2.filter((k) => k !== 'versionId' && k !== 'lastUpdated' && k !== 'author');
+    if (object1 === object2) {
+        return true;
+    }
+    if (isEmpty(object1) && isEmpty(object2)) {
+        return true;
+    }
+    if (isEmpty(object1) || isEmpty(object2)) {
+        return false;
+    }
+    if (Array.isArray(object1) && Array.isArray(object2)) {
+        return deepEqualsArray(object1, object2);
+    }
+    if (Array.isArray(object1) || Array.isArray(object2)) {
+        return false;
     }
-    if (keys1.length !== keys2.length) {
+    if (isObject(object1) && isObject(object2)) {
+        return deepEqualsObject(object1, object2, path);
+    }
+    if (isObject(object1) || isObject(object2)) {
+        return false;
+    }
+    return false;
+}
+function deepEqualsArray(array1, array2) {
+    if (array1.length !== array2.length) {
         return false;
     }
-    for (const key of keys1) {
+    for (let i = 0; i < array1.length; i++) {
+        if (!deepEquals(array1[i], array2[i])) {
+            return false;
+        }
+    }
+    return true;
+}
+function deepEqualsObject(object1, object2, path) {
+    const keySet = new Set();
+    Object.keys(object1).forEach((k) => keySet.add(k));
+    Object.keys(object2).forEach((k) => keySet.add(k));
+    if (path === 'meta') {
+        keySet.delete('versionId');
+        keySet.delete('lastUpdated');
+        keySet.delete('author');
+    }
+    for (const key of keySet) {
         const val1 = object1[key];
         const val2 = object2[key];
-        if (isObject(val1) && isObject(val2)) {
-            if (!deepEquals(val1, val2, key)) {
-                return false;
-            }
-        }
-        else {
-            if (val1 !== val2) {
-                return false;
-            }
+        if (!deepEquals(val1, val2, key)) {
+            return false;
         }
     }
     return true;
 }
-function isObject(object) {
-    return object !== null && typeof object === 'object';
+/**
+ * Returns true if the input is an object.
+ * @param object The candidate object.
+ * @returns True if the input is a non-null non-undefined object.
+ */
+function isObject(obj) {
+    return obj !== null && typeof obj === 'object';
+}
+/**
+ * Returns true if the input array is an array of strings.
+ * @param arr Input array.
+ * @returns True if the input array is an array of strings.
+ */
+function isStringArray(arr) {
+    return arr.every((e) => typeof e === 'string');
 }
 // Precompute hex octets
 // See: https://stackoverflow.com/a/55200387
@@ -414,7 +570,7 @@ _EventTarget_listeners = new WeakMap();
  */
 function decodePayload(payload) {
     const cleanedPayload = payload.replace(/-/g, '+').replace(/_/g, '/');
-    const decodedPayload = window.atob(cleanedPayload);
+    const decodedPayload = decodeBase64(cleanedPayload);
     const uriEncodedPayload = Array.from(decodedPayload).reduce((acc, char) => {
         const uriEncodedChar = ('00' + char.charCodeAt(0).toString(16)).slice(-2);
         return `${acc}%${uriEncodedChar}`;
@@ -422,6 +578,15 @@ function decodePayload(payload) {
     const jsonPayload = decodeURIComponent(uriEncodedPayload);
     return JSON.parse(jsonPayload);
 }
+function decodeBase64(data) {
+    if (typeof window !== 'undefined') {
+        return window.atob(data);
+    }
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(data, 'base64').toString('binary');
+    }
+    throw new Error('Unable to decode base64');
+}
 /**
  * Parses the JWT payload.
  * @param token JWT token
@@ -580,6 +745,7 @@ class OperationOutcomeError extends Error {
     }
 }
 
+const DEFAULT_SEARCH_COUNT = 20;
 /**
  * Search operators.
  * These operators represent "modifiers" and "prefixes" in FHIR search.
@@ -634,10 +800,11 @@ const PREFIX_OPERATORS = [
  *
  * See the FHIR search spec: http://hl7.org/fhir/r4/search.html
  *
- * @param location The URL to parse.
+ * @param url The URL to parse.
  * @returns Parsed search definition.
  */
-function parseSearchDefinition(location) {
+function parseSearchDefinition(url) {
+    const location = new URL(url, 'https://example.com/');
     const resourceType = location.pathname
         .replace(/(^\/)|(\/$)/g, '') // Remove leading and trailing slashes
         .split('/')
@@ -646,15 +813,15 @@ function parseSearchDefinition(location) {
     let filters = undefined;
     let sortRules = undefined;
     let fields = undefined;
-    let page = undefined;
+    let offset = undefined;
     let count = undefined;
     let total = undefined;
     params.forEach((value, key) => {
         if (key === '_fields') {
             fields = value.split(',');
         }
-        else if (key === '_page') {
-            page = parseInt(value);
+        else if (key === '_offset') {
+            offset = parseInt(value);
         }
         else if (key === '_count') {
             count = parseInt(value);
@@ -675,7 +842,7 @@ function parseSearchDefinition(location) {
         resourceType,
         filters,
         fields,
-        page,
+        offset,
         count,
         total,
         sortRules,
@@ -751,13 +918,13 @@ function formatSearchQuery(definition) {
     if (definition.sortRules && definition.sortRules.length > 0) {
         params.push(formatSortRules(definition.sortRules));
     }
-    if (definition.page && definition.page > 0) {
-        params.push('_page=' + definition.page);
+    if (definition.offset !== undefined) {
+        params.push('_offset=' + definition.offset);
     }
-    if (definition.count && definition.count > 0) {
+    if (definition.count !== undefined) {
         params.push('_count=' + definition.count);
     }
-    if (definition.total) {
+    if (definition.total !== undefined) {
         params.push('_total=' + encodeURIComponent(definition.total));
     }
     if (params.length === 0) {
@@ -1066,13 +1233,61 @@ function getPropertyDisplayName(property) {
 
 // PKCE auth ased on:
 // https://aws.amazon.com/blogs/security/how-to-add-authentication-single-page-web-application-with-amazon-cognito-oauth2-implementation/
-var _MedplumClient_instances, _MedplumClient_fetch, _MedplumClient_storage, _MedplumClient_schema, _MedplumClient_resourceCache, _MedplumClient_baseUrl, _MedplumClient_clientId, _MedplumClient_authorizeUrl, _MedplumClient_tokenUrl, _MedplumClient_logoutUrl, _MedplumClient_onUnauthenticated, _MedplumClient_accessToken, _MedplumClient_refreshToken, _MedplumClient_refreshPromise, _MedplumClient_profilePromise, _MedplumClient_profile, _MedplumClient_config, _MedplumClient_addLogin, _MedplumClient_refreshProfile, _MedplumClient_request, _MedplumClient_buildFetchOptions, _MedplumClient_handleUnauthenticated, _MedplumClient_startPkce, _MedplumClient_requestAuthorization, _MedplumClient_refresh, _MedplumClient_fetchTokens, _MedplumClient_verifyTokens, _MedplumClient_setupStorageListener;
+var _MedplumClient_instances, _MedplumClient_fetch, _MedplumClient_storage, _MedplumClient_schema, _MedplumClient_resourceCache, _MedplumClient_baseUrl, _MedplumClient_clientId, _MedplumClient_authorizeUrl, _MedplumClient_tokenUrl, _MedplumClient_logoutUrl, _MedplumClient_onUnauthenticated, _MedplumClient_accessToken, _MedplumClient_refreshToken, _MedplumClient_refreshPromise, _MedplumClient_profilePromise, _MedplumClient_profile, _MedplumClient_config, _MedplumClient_addLogin, _MedplumClient_refreshProfile, _MedplumClient_request, _MedplumClient_addFetchOptionsDefaults, _MedplumClient_setRequestContentType, _MedplumClient_setRequestBody, _MedplumClient_handleUnauthenticated, _MedplumClient_startPkce, _MedplumClient_requestAuthorization, _MedplumClient_refresh, _MedplumClient_fetchTokens, _MedplumClient_verifyTokens, _MedplumClient_setupStorageListener;
 const DEFAULT_BASE_URL = 'https://api.medplum.com/';
 const DEFAULT_SCOPE = 'launch/patient openid fhirUser offline_access user/*.*';
 const DEFAULT_RESOURCE_CACHE_SIZE = 1000;
 const JSON_CONTENT_TYPE = 'application/json';
 const FHIR_CONTENT_TYPE = 'application/fhir+json';
 const PATCH_CONTENT_TYPE = 'application/json-patch+json';
+/**
+ * The MedplumClient class provides a client for the Medplum FHIR server.
+ *
+ * The client can be used in the browser, in a NodeJS application, or in a Medplum Bot.
+ *
+ * The client provides helpful methods for common operations such as:
+ *   1) Authenticating
+ *   2) Creating resources
+ *   2) Reading resources
+ *   3) Updating resources
+ *   5) Deleting resources
+ *   6) Searching
+ *   7) Making GraphQL queries
+ *
+ * Here is a quick example of how to use the client:
+ *
+ * ```typescript
+ * import { MedplumClient } from '@medplum/core';
+ * const medplum = new MedplumClient();
+ * ```
+ *
+ * Create a `Patient`:
+ *
+ * ```typescript
+ * const patient = await medplum.createResource({
+ *   resourceType: 'Patient',
+ *   name: [{
+ *     given: ['Alice'],
+ *     family: 'Smith'
+ *   }]
+ * });
+ * ```
+ *
+ * Read a `Patient` by ID:
+ *
+ * ```typescript
+ * const patient = await medplum.readResource('Patient', '123');
+ * console.log(patient.name[0].given[0]);
+ * ```
+ *
+ * Search for a `Patient` by name:
+ *
+ * ```typescript
+ * const bundle = await medplum.search('Patient?name=Alice');
+ * console.log(bundle.total);
+ * ```
+ *
+ */
 class MedplumClient extends EventTarget {
     constructor(options) {
         var _a;
@@ -1132,17 +1347,94 @@ class MedplumClient extends EventTarget {
         __classPrivateFieldSet(this, _MedplumClient_config, undefined, "f");
         this.dispatchEvent({ type: 'change' });
     }
-    get(url) {
-        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'GET', url);
+    /**
+     * Makes an HTTP GET request to the specified URL.
+     *
+     * This is a lower level method for custom requests.
+     * For common operations, we recommend using higher level methods
+     * such as `readResource()`, `search()`, etc.
+     *
+     * @param url The target URL.
+     * @param options Optional fetch options.
+     * @returns Promise to the response content.
+     */
+    get(url, options = {}) {
+        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'GET', url, options);
     }
-    post(url, body, contentType) {
-        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'POST', url, contentType, body);
+    /**
+     * Makes an HTTP POST request to the specified URL.
+     *
+     * This is a lower level method for custom requests.
+     * For common operations, we recommend using higher level methods
+     * such as `createResource()`.
+     *
+     * @param url The target URL.
+     * @param body The content body. Strings and `File` objects are passed directly. Other objects are converted to JSON.
+     * @param contentType The content type to be included in the "Content-Type" header.
+     * @param options Optional fetch options.
+     * @returns Promise to the response content.
+     */
+    post(url, body, contentType, options = {}) {
+        if (body) {
+            __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_setRequestBody).call(this, options, body);
+        }
+        if (contentType) {
+            __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_setRequestContentType).call(this, options, contentType);
+        }
+        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'POST', url, options);
+    }
+    /**
+     * Makes an HTTP PUT request to the specified URL.
+     *
+     * This is a lower level method for custom requests.
+     * For common operations, we recommend using higher level methods
+     * such as `updateResource()`.
+     *
+     * @param url The target URL.
+     * @param body The content body. Strings and `File` objects are passed directly. Other objects are converted to JSON.
+     * @param contentType The content type to be included in the "Content-Type" header.
+     * @param options Optional fetch options.
+     * @returns Promise to the response content.
+     */
+    put(url, body, contentType, options = {}) {
+        if (body) {
+            __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_setRequestBody).call(this, options, body);
+        }
+        if (contentType) {
+            __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_setRequestContentType).call(this, options, contentType);
+        }
+        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'PUT', url, options);
     }
-    put(url, body, contentType) {
-        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'PUT', url, contentType, body);
+    /**
+     * Makes an HTTP PATCH request to the specified URL.
+     *
+     * This is a lower level method for custom requests.
+     * For common operations, we recommend using higher level methods
+     * such as `patchResource()`.
+     *
+     * @param url The target URL.
+     * @param operations Array of JSONPatch operations.
+     * @param options Optional fetch options.
+     * @returns Promise to the response content.
+     */
+    patch(url, operations, options = {}) {
+        __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_setRequestBody).call(this, options, operations);
+        __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_setRequestContentType).call(this, options, PATCH_CONTENT_TYPE);
+        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'PATCH', url, options);
     }
-    delete(url) {
-        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'DELETE', url);
+    /**
+     * Makes an HTTP DELETE request to the specified URL.
+     *
+     * This is a lower level method for custom requests.
+     * For common operations, we recommend using higher level methods
+     * such as `deleteResource()`.
+     *
+     * @param url The target URL.
+     * @param options Optional fetch options.
+     * @returns Promise to the response content.
+     */
+    delete(url, options = {}) {
+        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'DELETE', url, options);
     }
     /**
      * Tries to register a new user.
@@ -1233,11 +1525,114 @@ class MedplumClient extends EventTarget {
     }
     /**
      * Sends a FHIR search request.
-     * @param search The search query.
+     *
+     * Example using a FHIR search string:
+     *
+     * ```typescript
+     * const bundle = await client.search('Patient?name=Alice');
+     * console.log(bundle);
+     * ```
+     *
+     * Example using a structured search:
+     *
+     * ```typescript
+     * const bundle = await client.search({
+     *   resourceType: 'Patient',
+     *   filters: [{
+     *     code: 'name',
+     *     operator: 'eq',
+     *     value: 'Alice',
+     *   }]
+     * });
+     * console.log(bundle);
+     * ```
+     *
+     * The return value is a FHIR bundle:
+     *
+     * ```json
+     * {
+     *    "resourceType": "Bundle",
+     *    "type": "searchest",
+     *    "total": 1,
+     *    "entry": [
+     *       {
+     *          "resource": {
+     *             "resourceType": "Patient",
+     *             "name": [
+     *                {
+     *                   "given": [
+     *                      "George"
+     *                   ],
+     *                   "family": "Washington"
+     *                }
+     *             ],
+     *          }
+     *       }
+     *    ]
+     * }
+     * ```
+     *
+     * See FHIR search for full details: https://www.hl7.org/fhir/search.html
+     *
+     * @param query The search query as either a string or a structured search object.
      * @returns Promise to the search result bundle.
      */
-    search(search) {
-        return this.get(this.fhirUrl(search.resourceType) + formatSearchQuery(search));
+    search(query, options = {}) {
+        return this.get(typeof query === 'string' ? 'fhir/R4/' + query : this.fhirUrl(query.resourceType) + formatSearchQuery(query), options);
+    }
+    /**
+     * Sends a FHIR search request for a single resource.
+     *
+     * This is a convenience method for `search()` that returns the first resource rather than a `Bundle`.
+     *
+     * Example using a FHIR search string:
+     *
+     * ```typescript
+     * const patient = await client.searchOne('Patient?identifier=123');
+     * console.log(patient);
+     * ```
+     *
+     * The return value is the resource, if available; otherwise, undefined.
+     *
+     * See FHIR search for full details: https://www.hl7.org/fhir/search.html
+     *
+     * @param query The search query as either a string or a structured search object.
+     * @returns Promise to the search result bundle.
+     */
+    searchOne(query, options = {}) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const search = typeof query === 'string' ? parseSearchDefinition(query) : query;
+            search.count = 1;
+            const bundle = yield this.search(search, options);
+            return (_b = (_a = bundle.entry) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.resource;
+        });
+    }
+    /**
+     * Sends a FHIR search request for an array of resources.
+     *
+     * This is a convenience method for `search()` that returns the resources as an array rather than a `Bundle`.
+     *
+     * Example using a FHIR search string:
+     *
+     * ```typescript
+     * const patients = await client.searchResources('Patient?name=Alice');
+     * console.log(patients);
+     * ```
+     *
+     * The return value is an array of resources.
+     *
+     * See FHIR search for full details: https://www.hl7.org/fhir/search.html
+     *
+     * @param query The search query as either a string or a structured search object.
+     * @returns Promise to the search result bundle.
+     */
+    searchResources(query, options = {}) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const bundle = yield this.search(query, options);
+            return (_b = (_a = bundle.entry) === null || _a === void 0 ? void 0 : _a.map((entry) => entry.resource)) !== null && _b !== void 0 ? _b : [];
+        });
     }
     /**
      * Searches a ValueSet resource using the "expand" operation.
@@ -1246,10 +1641,10 @@ class MedplumClient extends EventTarget {
      * @param filter The search string.
      * @returns Promise to expanded ValueSet.
      */
-    searchValueSet(system, filter) {
+    searchValueSet(system, filter, options = {}) {
         return this.get(this.fhirUrl('ValueSet', '$expand') +
             `?url=${encodeURIComponent(system)}` +
-            `&filter=${encodeURIComponent(filter)}`);
+            `&filter=${encodeURIComponent(filter)}`, options);
     }
     /**
      * Returns a cached resource if it is available.
@@ -1277,7 +1672,23 @@ class MedplumClient extends EventTarget {
         }
         return undefined;
     }
-    read(resourceType, id) {
+    /**
+     * Reads a resource by resource type and ID.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const patient = await medplum.readResource('Patient', '123');
+     * console.log(patient);
+     * ```
+     *
+     * See the FHIR "read" operation for full details: https://www.hl7.org/fhir/http.html#read
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The resource ID.
+     * @returns The resource if available; undefined otherwise.
+     */
+    readResource(resourceType, id) {
         const cacheKey = resourceType + '/' + id;
         const promise = this.get(this.fhirUrl(resourceType, id)).then((resource) => {
             __classPrivateFieldGet(this, _MedplumClient_resourceCache, "f").set(cacheKey, resource);
@@ -1286,18 +1697,74 @@ class MedplumClient extends EventTarget {
         __classPrivateFieldGet(this, _MedplumClient_resourceCache, "f").set(cacheKey, promise);
         return promise;
     }
+    /**
+     * Reads a resource by resource type and ID using the in-memory resource cache.
+     *
+     * If the resource is not available in the cache, it will be read from the server.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const patient = await medplum.readCached('Patient', '123');
+     * console.log(patient);
+     * ```
+     *
+     * See the FHIR "read" operation for full details: https://www.hl7.org/fhir/http.html#read
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The resource ID.
+     * @returns The resource if available; undefined otherwise.
+     */
     readCached(resourceType, id) {
         const cached = __classPrivateFieldGet(this, _MedplumClient_resourceCache, "f").get(resourceType + '/' + id);
-        return cached ? Promise.resolve(cached) : this.read(resourceType, id);
+        return cached ? Promise.resolve(cached) : this.readResource(resourceType, id);
     }
+    /**
+     * Reads a resource by `Reference`.
+     *
+     * This is a convenience method for `readResource()` that accepts a `Reference` object.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const serviceRequest = await medplum.readResource('ServiceRequest', '123');
+     * const patient = await medplum.readReference(serviceRequest.subject);
+     * console.log(patient);
+     * ```
+     *
+     * See the FHIR "read" operation for full details: https://www.hl7.org/fhir/http.html#read
+     *
+     * @param reference The FHIR reference object.
+     * @returns The resource if available; undefined otherwise.
+     */
     readReference(reference) {
         const refString = reference === null || reference === void 0 ? void 0 : reference.reference;
         if (!refString) {
             return Promise.reject('Missing reference');
         }
         const [resourceType, id] = refString.split('/');
-        return this.read(resourceType, id);
+        return this.readResource(resourceType, id);
     }
+    /**
+     * Reads a resource by `Reference` using the in-memory resource cache.
+     *
+     * This is a convenience method for `readResource()` that accepts a `Reference` object.
+     *
+     * If the resource is not available in the cache, it will be read from the server.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const serviceRequest = await medplum.readResource('ServiceRequest', '123');
+     * const patient = await medplum.readCachedReference(serviceRequest.subject);
+     * console.log(patient);
+     * ```
+     *
+     * See the FHIR "read" operation for full details: https://www.hl7.org/fhir/http.html#read
+     *
+     * @param reference The FHIR reference object.
+     * @returns The resource if available; undefined otherwise.
+     */
     readCachedReference(reference) {
         const refString = reference === null || reference === void 0 ? void 0 : reference.reference;
         if (!refString) {
@@ -1366,38 +1833,181 @@ class MedplumClient extends EventTarget {
             return __classPrivateFieldGet(this, _MedplumClient_schema, "f");
         });
     }
+    /**
+     * Reads resource history by resource type and ID.
+     *
+     * The return value is a bundle of all versions of the resource.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const history = await medplum.readHistory('Patient', '123');
+     * console.log(history);
+     * ```
+     *
+     * See the FHIR "history" operation for full details: https://www.hl7.org/fhir/http.html#history
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The resource ID.
+     * @returns The resource if available; undefined otherwise.
+     */
     readHistory(resourceType, id) {
         return this.get(this.fhirUrl(resourceType, id, '_history'));
     }
+    /**
+     * Reads a specific version of a resource by resource type, ID, and version ID.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const version = await medplum.readVersion('Patient', '123', '456');
+     * console.log(version);
+     * ```
+     *
+     * See the FHIR "vread" operation for full details: https://www.hl7.org/fhir/http.html#vread
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The resource ID.
+     * @returns The resource if available; undefined otherwise.
+     */
+    readVersion(resourceType, id, vid) {
+        return this.get(this.fhirUrl(resourceType, id, '_history', vid));
+    }
     readPatientEverything(id) {
         return this.get(this.fhirUrl('Patient', id, '$everything'));
     }
-    create(resource) {
+    /**
+     * Creates a new FHIR resource.
+     *
+     * The return value is the newly created resource, including the ID and meta.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const result = await medplum.createResource({
+     *   resourceType: 'Patient',
+     *   name: [{
+     *    family: 'Smith',
+     *    given: ['John']
+     *   }]
+     * });
+     * console.log(result.id);
+     * ```
+     *
+     * See the FHIR "create" operation for full details: https://www.hl7.org/fhir/http.html#create
+     *
+     * @param resource The FHIR resource to create.
+     * @returns The result of the create operation.
+     */
+    createResource(resource) {
         if (!resource.resourceType) {
-            throw new Error('Missing resourceType');
+            return Promise.reject('Missing resourceType');
         }
         return this.post(this.fhirUrl(resource.resourceType), resource);
     }
+    /**
+     * Creates a FHIR `Binary` resource with the provided data content.
+     *
+     * The return value is the newly created resource, including the ID and meta.
+     *
+     * The `data` parameter can be a string or a `File` object.
+     *
+     * A `File` object often comes from a `<input type="file">` element.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const result = await medplum.createBinary(myFile, 'test.jpg', 'image/jpeg');
+     * console.log(result.id);
+     * ```
+     *
+     * See the FHIR "create" operation for full details: https://www.hl7.org/fhir/http.html#create
+     *
+     * @param resource The FHIR resource to create.
+     * @returns The result of the create operation.
+     */
     createBinary(data, filename, contentType) {
         return this.post(this.fhirUrl('Binary') + '?_filename=' + encodeURIComponent(filename), data, contentType);
     }
-    update(resource) {
+    /**
+     * Updates a FHIR resource.
+     *
+     * The return value is the updated resource, including the ID and meta.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const result = await medplum.updateResource({
+     *   resourceType: 'Patient',
+     *   id: '123',
+     *   name: [{
+     *    family: 'Smith',
+     *    given: ['John']
+     *   }]
+     * });
+     * console.log(result.meta.versionId);
+     * ```
+     *
+     * See the FHIR "update" operation for full details: https://www.hl7.org/fhir/http.html#update
+     *
+     * @param resource The FHIR resource to update.
+     * @returns The result of the update operation.
+     */
+    updateResource(resource) {
         if (!resource.resourceType) {
-            throw new Error('Missing resourceType');
+            return Promise.reject('Missing resourceType');
         }
         if (!resource.id) {
-            throw new Error('Missing id');
+            return Promise.reject('Missing id');
         }
         return this.put(this.fhirUrl(resource.resourceType, resource.id), resource);
     }
-    patch(resourceType, id, operations) {
-        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'PATCH', this.fhirUrl(resourceType, id), PATCH_CONTENT_TYPE, operations);
+    /**
+     * Updates a FHIR resource using JSONPatch operations.
+     *
+     * The return value is the updated resource, including the ID and meta.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const result = await medplum.patchResource('Patient', '123', [
+     *   {op: 'replace', path: '/name/0/family', value: 'Smith'},
+     * ]);
+     * console.log(result.meta.versionId);
+     * ```
+     *
+     * See the FHIR "update" operation for full details: https://www.hl7.org/fhir/http.html#patch
+     *
+     * See the JSONPatch specification for full details: https://tools.ietf.org/html/rfc6902
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The resource ID.
+     * @param operations The JSONPatch operations.
+     * @returns The result of the patch operations.
+     */
+    patchResource(resourceType, id, operations) {
+        return this.patch(this.fhirUrl(resourceType, id), operations);
     }
+    /**
+     * Deletes a FHIR resource by resource type and ID.
+     *
+     * Example:
+     *
+     * ```typescript
+     * await medplum.deleteResource('Patient', '123');
+     * ```
+     *
+     * See the FHIR "delete" operation for full details: https://www.hl7.org/fhir/http.html#delete
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The resource ID.
+     * @returns The result of the delete operation.
+     */
     deleteResource(resourceType, id) {
         return this.delete(this.fhirUrl(resourceType, id));
     }
-    graphql(query) {
-        return this.post(this.fhirUrl('$graphql'), { query }, JSON_CONTENT_TYPE);
+    graphql(query, options) {
+        return this.post(this.fhirUrl('$graphql'), { query }, JSON_CONTENT_TYPE, options);
     }
     getActiveLogin() {
         return __classPrivateFieldGet(this, _MedplumClient_storage, "f").getObject('activeLogin');
@@ -1415,6 +2025,12 @@ class MedplumClient extends EventTarget {
             yield __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_refreshProfile).call(this);
         });
     }
+    setAccessToken(accessToken) {
+        __classPrivateFieldSet(this, _MedplumClient_accessToken, accessToken, "f");
+        __classPrivateFieldSet(this, _MedplumClient_refreshToken, undefined, "f");
+        __classPrivateFieldSet(this, _MedplumClient_profile, undefined, "f");
+        __classPrivateFieldSet(this, _MedplumClient_config, undefined, "f");
+    }
     getLogins() {
         var _a;
         return (_a = __classPrivateFieldGet(this, _MedplumClient_storage, "f").getObject('logins')) !== null && _a !== void 0 ? _a : [];
@@ -1441,12 +2057,12 @@ class MedplumClient extends EventTarget {
      * @param url The URL to request.
      * @returns Promise to the response body as a blob.
      */
-    download(url) {
+    download(url, options = {}) {
         return __awaiter(this, void 0, void 0, function* () {
             if (__classPrivateFieldGet(this, _MedplumClient_refreshPromise, "f")) {
                 yield __classPrivateFieldGet(this, _MedplumClient_refreshPromise, "f");
             }
-            const options = __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_buildFetchOptions).call(this, 'GET');
+            __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_addFetchOptionsDefaults).call(this, options);
             const response = yield __classPrivateFieldGet(this, _MedplumClient_fetch, "f").call(this, url, options);
             return response.blob();
         });
@@ -1460,12 +2076,12 @@ class MedplumClient extends EventTarget {
         const pkceState = __classPrivateFieldGet(this, _MedplumClient_storage, "f").getString('pkceState');
         if (!pkceState) {
             this.clear();
-            throw new Error('Invalid PCKE state');
+            return Promise.reject('Invalid PCKE state');
         }
         const codeVerifier = __classPrivateFieldGet(this, _MedplumClient_storage, "f").getString('codeVerifier');
         if (!codeVerifier) {
             this.clear();
-            throw new Error('Invalid PCKE code verifier');
+            return Promise.reject('Invalid PCKE code verifier');
         }
         return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_fetchTokens).call(this, 'grant_type=authorization_code' +
             (__classPrivateFieldGet(this, _MedplumClient_clientId, "f") ? '&client_id=' + encodeURIComponent(__classPrivateFieldGet(this, _MedplumClient_clientId, "f")) : '') +
@@ -1476,6 +2092,15 @@ class MedplumClient extends EventTarget {
             '&code=' +
             encodeURIComponent(code));
     }
+    clientCredentials(clientId, clientSecret) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_fetchTokens).call(this, 'grant_type=client_credentials' +
+                '&client_id=' +
+                encodeURIComponent(clientId) +
+                '&client_secret=' +
+                encodeURIComponent(clientSecret));
+        });
+    }
 }
 _MedplumClient_fetch = new WeakMap(), _MedplumClient_storage = new WeakMap(), _MedplumClient_schema = new WeakMap(), _MedplumClient_resourceCache = new WeakMap(), _MedplumClient_baseUrl = new WeakMap(), _MedplumClient_clientId = new WeakMap(), _MedplumClient_authorizeUrl = new WeakMap(), _MedplumClient_tokenUrl = new WeakMap(), _MedplumClient_logoutUrl = new WeakMap(), _MedplumClient_onUnauthenticated = new WeakMap(), _MedplumClient_accessToken = new WeakMap(), _MedplumClient_refreshToken = new WeakMap(), _MedplumClient_refreshPromise = new WeakMap(), _MedplumClient_profilePromise = new WeakMap(), _MedplumClient_profile = new WeakMap(), _MedplumClient_config = new WeakMap(), _MedplumClient_instances = new WeakSet(), _MedplumClient_addLogin = function _MedplumClient_addLogin(newLogin) {
     const logins = this.getLogins().filter((login) => { var _a, _b; return ((_a = login.profile) === null || _a === void 0 ? void 0 : _a.reference) !== ((_b = newLogin.profile) === null || _b === void 0 ? void 0 : _b.reference); });
@@ -1496,7 +2121,7 @@ _MedplumClient_fetch = new WeakMap(), _MedplumClient_storage = new WeakMap(), _M
         }), "f");
         return __classPrivateFieldGet(this, _MedplumClient_profilePromise, "f");
     });
-}, _MedplumClient_request = function _MedplumClient_request(method, url, contentType, body) {
+}, _MedplumClient_request = function _MedplumClient_request(method, url, options = {}) {
     return __awaiter(this, void 0, void 0, function* () {
         if (__classPrivateFieldGet(this, _MedplumClient_refreshPromise, "f")) {
             yield __classPrivateFieldGet(this, _MedplumClient_refreshPromise, "f");
@@ -1504,48 +2129,57 @@ _MedplumClient_fetch = new WeakMap(), _MedplumClient_storage = new WeakMap(), _M
         if (!url.startsWith('http')) {
             url = __classPrivateFieldGet(this, _MedplumClient_baseUrl, "f") + url;
         }
-        const options = __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_buildFetchOptions).call(this, method, contentType, body);
+        options.method = method;
+        __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_addFetchOptionsDefaults).call(this, options);
         const response = yield __classPrivateFieldGet(this, _MedplumClient_fetch, "f").call(this, url, options);
         if (response.status === 401) {
             // Refresh and try again
-            return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_handleUnauthenticated).call(this, method, url, contentType, body);
+            return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_handleUnauthenticated).call(this, method, url, options);
         }
         if (response.status === 204 || response.status === 304) {
             // No content or change
             return undefined;
         }
         const obj = yield response.json();
-        if (obj.resourceType === 'OperationOutcome' && !isOk(obj)) {
+        if ((obj === null || obj === void 0 ? void 0 : obj.resourceType) === 'OperationOutcome' && !isOk(obj)) {
             return Promise.reject(obj);
         }
         return obj;
     });
-}, _MedplumClient_buildFetchOptions = function _MedplumClient_buildFetchOptions(method, contentType, body) {
-    const headers = {
-        'Content-Type': contentType || FHIR_CONTENT_TYPE,
-    };
+}, _MedplumClient_addFetchOptionsDefaults = function _MedplumClient_addFetchOptionsDefaults(options) {
+    if (!options.headers) {
+        options.headers = {};
+    }
+    const headers = options.headers;
+    if (!headers['Content-Type']) {
+        headers['Content-Type'] = FHIR_CONTENT_TYPE;
+    }
     if (__classPrivateFieldGet(this, _MedplumClient_accessToken, "f")) {
         headers['Authorization'] = 'Bearer ' + __classPrivateFieldGet(this, _MedplumClient_accessToken, "f");
     }
-    const options = {
-        method: method,
-        cache: 'no-cache',
-        credentials: 'include',
-        headers,
-    };
-    if (body) {
-        if (typeof body === 'string' || (typeof File !== 'undefined' && body instanceof File)) {
-            options.body = body;
-        }
-        else {
-            options.body = stringify(body);
-        }
+    if (!options.cache) {
+        options.cache = 'no-cache';
+    }
+    if (!options.credentials) {
+        options.credentials = 'include';
+    }
+}, _MedplumClient_setRequestContentType = function _MedplumClient_setRequestContentType(options, contentType) {
+    if (!options.headers) {
+        options.headers = {};
+    }
+    const headers = options.headers;
+    headers['Content-Type'] = contentType;
+}, _MedplumClient_setRequestBody = function _MedplumClient_setRequestBody(options, data) {
+    if (typeof data === 'string' || (typeof File !== 'undefined' && data instanceof File)) {
+        options.body = data;
     }
-    return options;
-}, _MedplumClient_handleUnauthenticated = function _MedplumClient_handleUnauthenticated(method, url, contentType, body) {
+    else if (data) {
+        options.body = stringify(data);
+    }
+}, _MedplumClient_handleUnauthenticated = function _MedplumClient_handleUnauthenticated(method, url, options) {
     return __awaiter(this, void 0, void 0, function* () {
         return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_refresh).call(this)
-            .then(() => __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, method, url, contentType, body))
+            .then(() => __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, method, url, options))
             .catch((error) => {
             this.clear();
             if (__classPrivateFieldGet(this, _MedplumClient_onUnauthenticated, "f")) {
@@ -1567,7 +2201,7 @@ _MedplumClient_fetch = new WeakMap(), _MedplumClient_storage = new WeakMap(), _M
 }, _MedplumClient_requestAuthorization = function _MedplumClient_requestAuthorization() {
     return __awaiter(this, void 0, void 0, function* () {
         if (!__classPrivateFieldGet(this, _MedplumClient_authorizeUrl, "f")) {
-            throw new Error('Missing authorize URL');
+            return Promise.reject('Missing authorize URL');
         }
         __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_startPkce).call(this);
         window.location.assign(__classPrivateFieldGet(this, _MedplumClient_authorizeUrl, "f") +
@@ -1662,6 +2296,316 @@ function getBaseUrl() {
     return window.location.protocol + '//' + window.location.host + '/';
 }
 
+const SEGMENT_SEPARATOR = '\r';
+const FIELD_SEPARATOR = '|';
+const COMPONENT_SEPARATOR = '^';
+/**
+ * The Hl7Message class represents one HL7 message.
+ * A message is a collection of segments.
+ * Note that we do not strictly parse messages, and only use default delimeters.
+ */
+class Hl7Message {
+    constructor(segments) {
+        this.segments = segments;
+    }
+    get(index) {
+        if (typeof index === 'number') {
+            return this.segments[index];
+        }
+        return this.segments.find((s) => s.name === index);
+    }
+    getAll(name) {
+        return this.segments.filter((s) => s.name === name);
+    }
+    toString() {
+        return this.segments.map((s) => s.toString()).join(SEGMENT_SEPARATOR);
+    }
+    buildAck() {
+        var _a, _b, _c, _d, _e, _f;
+        const now = new Date();
+        const msh = this.get('MSH');
+        const sendingApp = ((_a = msh === null || msh === void 0 ? void 0 : msh.get(2)) === null || _a === void 0 ? void 0 : _a.toString()) || '';
+        const sendingFacility = ((_b = msh === null || msh === void 0 ? void 0 : msh.get(3)) === null || _b === void 0 ? void 0 : _b.toString()) || '';
+        const receivingApp = ((_c = msh === null || msh === void 0 ? void 0 : msh.get(4)) === null || _c === void 0 ? void 0 : _c.toString()) || '';
+        const receivingFacility = ((_d = msh === null || msh === void 0 ? void 0 : msh.get(5)) === null || _d === void 0 ? void 0 : _d.toString()) || '';
+        const controlId = ((_e = msh === null || msh === void 0 ? void 0 : msh.get(9)) === null || _e === void 0 ? void 0 : _e.toString()) || '';
+        const versionId = ((_f = msh === null || msh === void 0 ? void 0 : msh.get(12)) === null || _f === void 0 ? void 0 : _f.toString()) || '2.5.1';
+        return new Hl7Message([
+            new Hl7Segment([
+                'MSH',
+                '^~\\&',
+                receivingApp,
+                receivingFacility,
+                sendingApp,
+                sendingFacility,
+                now.toISOString(),
+                '',
+                'ACK',
+                now.getTime().toString(),
+                'P',
+                versionId,
+            ]),
+            new Hl7Segment(['MSA', 'AA', controlId, 'OK']),
+        ]);
+    }
+    static parse(text) {
+        if (!text.startsWith('MSH|^~\\&')) {
+            const err = new Error('Invalid HL7 message');
+            err.type = 'entity.parse.failed';
+            throw err;
+        }
+        return new Hl7Message(text.split(/[\r\n]+/).map((line) => Hl7Segment.parse(line)));
+    }
+}
+/**
+ * The Hl7Segment class represents one HL7 segment.
+ * A segment is a collection of fields.
+ * The name field is the first field.
+ * Note that we do not strictly parse messages, and only use default delimeters.
+ */
+class Hl7Segment {
+    constructor(fields) {
+        if (isStringArray(fields)) {
+            this.fields = fields.map((f) => Hl7Field.parse(f));
+        }
+        else {
+            this.fields = fields;
+        }
+        this.name = this.fields[0].components[0];
+    }
+    get(index) {
+        return this.fields[index];
+    }
+    toString() {
+        return this.fields.map((f) => f.toString()).join(FIELD_SEPARATOR);
+    }
+    static parse(text) {
+        return new Hl7Segment(text.split(FIELD_SEPARATOR).map((f) => Hl7Field.parse(f)));
+    }
+}
+/**
+ * The Hl7Field class represents one HL7 field.
+ * A field is a collection of components.
+ * Note that we do not strictly parse messages, and only use default delimeters.
+ */
+class Hl7Field {
+    constructor(components) {
+        this.components = components;
+    }
+    get(index) {
+        return this.components[index];
+    }
+    toString() {
+        return this.components.join(COMPONENT_SEPARATOR);
+    }
+    static parse(text) {
+        return new Hl7Field(text.split(COMPONENT_SEPARATOR));
+    }
+}
+
+var _LegacyRepositoryClient_client;
+/**
+ * The LegacyRepositoryClient is a supplementary API client that matches the legacy "Repository" API.
+ * The "Repository" API is deprecated and will be removed in a future release.
+ * This LegacyRepositoryClient is also deprecated and will be removed in a future release.
+ * @deprecated
+ */
+class LegacyRepositoryClient {
+    constructor(client) {
+        _LegacyRepositoryClient_client.set(this, void 0);
+        __classPrivateFieldSet(this, _LegacyRepositoryClient_client, client, "f");
+    }
+    /**
+     * Creates a resource.
+     *
+     * See: https://www.hl7.org/fhir/http.html#create
+     *
+     * @param resource The resource to create.
+     * @returns Operation outcome and the new resource.
+     * @deprecated
+     */
+    createResource(resource) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").createResource(resource);
+                return [created, result];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+    /**
+     * Returns a resource.
+     *
+     * See: https://www.hl7.org/fhir/http.html#read
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The FHIR resource ID.
+     * @returns Operation outcome and a resource.
+     * @deprecated
+     */
+    readResource(resourceType, id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const resource = yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").readResource(resourceType, id);
+                return [allOk, resource];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+    /**
+     * Returns a resource by FHIR reference.
+     *
+     * See: https://www.hl7.org/fhir/http.html#read
+     *
+     * @param reference The FHIR reference.
+     * @returns Operation outcome and a resource.
+     * @deprecated
+     */
+    readReference(reference) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const resource = yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").readReference(reference);
+                return [allOk, resource];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+    /**
+     * Returns resource history.
+     *
+     * See: https://www.hl7.org/fhir/http.html#history
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The FHIR resource ID.
+     * @returns Operation outcome and a history bundle.
+     * @deprecated
+     */
+    readHistory(resourceType, id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const resource = yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").readHistory(resourceType, id);
+                return [allOk, resource];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+    /**
+     * Returns a resource version.
+     *
+     * See: https://www.hl7.org/fhir/http.html#vread
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The FHIR resource ID.
+     * @param vid The version ID.
+     * @returns Operation outcome and a resource.
+     * @deprecated
+     */
+    readVersion(resourceType, id, vid) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const resource = yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").readVersion(resourceType, id, vid);
+                return [allOk, resource];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+    /**
+     * Updates a resource.
+     *
+     * See: https://www.hl7.org/fhir/http.html#update
+     *
+     * @param resource The resource to update.
+     * @returns Operation outcome and the updated resource.
+     * @deprecated
+     */
+    updateResource(resource) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const updated = yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").updateResource(resource);
+                return [allOk, updated];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+    /**
+     * Deletes a resource.
+     *
+     * See: https://www.hl7.org/fhir/http.html#delete
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The resource ID.
+     * @returns Operation outcome.
+     * @deprecated
+     */
+    deleteResource(resourceType, id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").deleteResource(resourceType, id);
+                return [allOk, undefined];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+    /**
+     * Patches a resource.
+     *
+     * See: https://www.hl7.org/fhir/http.html#patch
+     *
+     * @param resourceType The FHIR resource type.
+     * @param id The resource ID.
+     * @param patch Array of JSONPatch operations.
+     * @returns Operation outcome and the resource.
+     * @deprecated
+     */
+    patchResource(resourceType, id, patch) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const resource = yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").patchResource(resourceType, id, patch);
+                return [allOk, resource];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+    /**
+     * Searches for resources.
+     *
+     * See: https://www.hl7.org/fhir/http.html#search
+     *
+     * @param searchRequest The search request.
+     * @returns The search result bundle.
+     * @deprecated
+     */
+    search(query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const searchRequest = typeof query === 'string' ? parseSearchDefinition(query) : query;
+            try {
+                const bundle = yield __classPrivateFieldGet(this, _LegacyRepositoryClient_client, "f").search(searchRequest);
+                return [allOk, bundle];
+            }
+            catch (error) {
+                return [error, undefined];
+            }
+        });
+    }
+}
+_LegacyRepositoryClient_client = new WeakMap();
+
 var SearchParameterType;
 (function (SearchParameterType) {
     SearchParameterType["BOOLEAN"] = "BOOLEAN";
@@ -1788,5 +2732,5 @@ function simplifyExpression(input) {
     return result;
 }
 
-export { MedplumClient, OperationOutcomeError, Operator, PropertyType, SearchParameterType, accessDenied, allOk, arrayBufferToBase64, arrayBufferToHex, assertOk, badRequest, buildTypeName, capitalize, createReference, createSchema, createTypeSchema, created, deepEquals, formatAddress, formatFamilyName, formatGivenName, formatHumanName, formatSearchQuery, getDateProperty, getDisplayString, getExpressionForResourceType, getImageSrc, getPropertyDisplayName, getReferenceString, getSearchParameterDetails, getStatus, gone, indexSearchParameter, indexStructureDefinition, isGone, isLowerCase, isNotFound, isOk, isProfileResource, notFound, notModified, parseSearchDefinition, resolveId, stringify };
+export { COMPONENT_SEPARATOR, DEFAULT_SEARCH_COUNT, FIELD_SEPARATOR, Hl7Field, Hl7Message, Hl7Segment, LegacyRepositoryClient, MedplumClient, OperationOutcomeError, Operator, PropertyType, SEGMENT_SEPARATOR, SearchParameterType, accessDenied, allOk, arrayBufferToBase64, arrayBufferToHex, assertOk, badRequest, buildTypeName, calculateAge, calculateAgeString, capitalize, createReference, createSchema, createTypeSchema, created, deepEquals, formatAddress, formatFamilyName, formatGivenName, formatHumanName, formatSearchQuery, getDateProperty, getDisplayString, getExpressionForResourceType, getExtensionValue, getImageSrc, getPropertyDisplayName, getQuestionnaireAnswers, getReferenceString, getSearchParameterDetails, getStatus, gone, indexSearchParameter, indexStructureDefinition, isGone, isLowerCase, isNotFound, isObject, isOk, isProfileResource, isStringArray, notFound, notModified, parseSearchDefinition, resolveId, stringify };
 //# sourceMappingURL=index.js.map