@medplum/core 0.5.0 → 0.9.0

package/dist/esm/index.js

@@ -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,55 @@ 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';
+    }
+}
 /**
  * FHIR JSON stringify.
  * Removes properties with empty string values.
@@ -261,7 +329,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).
@@ -414,7 +490,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 +498,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
@@ -634,10 +719,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('/')
@@ -1066,13 +1152,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 +1266,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);
+    }
+    /**
+     * 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);
     }
-    post(url, body, contentType) {
-        return __classPrivateFieldGet(this, _MedplumClient_instances, "m", _MedplumClient_request).call(this, 'POST', url, contentType, body);
+    /**
+     * 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 +1444,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(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.
      */
-    search(search) {
-        return this.get(this.fhirUrl(search.resourceType) + formatSearchQuery(search));
+    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 +1560,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 +1591,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 +1616,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 +1752,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 +1944,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 +1976,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 +1995,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 +2011,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 +2040,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,11 +2048,12 @@ _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
@@ -1520,32 +2065,40 @@ _MedplumClient_fetch = new WeakMap(), _MedplumClient_storage = new WeakMap(), _M
         }
         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 = {};
     }
-    return options;
-}, _MedplumClient_handleUnauthenticated = function _MedplumClient_handleUnauthenticated(method, url, contentType, body) {
+    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;
+    }
+    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 +2120,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 +2215,209 @@ function getBaseUrl() {
     return window.location.protocol + '//' + window.location.host + '/';
 }
 
+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 +2544,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 { LegacyRepositoryClient, MedplumClient, OperationOutcomeError, Operator, PropertyType, SearchParameterType, accessDenied, allOk, arrayBufferToBase64, arrayBufferToHex, assertOk, badRequest, buildTypeName, calculateAge, calculateAgeString, 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 };
 //# sourceMappingURL=index.js.map