@medplum/core 0.5.2 → 0.9.0

package/dist/cjs/index.js

@@ -173,6 +173,7 @@
      * @return Human friendly display string.
      */
     function getDisplayString(resource) {
+        var _a, _b;
         if (isProfileResource(resource)) {
             const profileName = getProfileResourceDisplayString(resource);
             if (profileName) {
@@ -185,6 +186,11 @@
                 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;
@@ -229,12 +235,25 @@
             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;
     }
     /**
@@ -247,6 +266,55 @@
     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.
@@ -267,7 +335,15 @@
      * @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).
@@ -420,7 +496,7 @@
      */
     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}`;
@@ -428,6 +504,15 @@
         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
@@ -640,10 +725,11 @@
      *
      * 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('/')
@@ -1072,13 +1158,61 @@
 
     // 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;
@@ -1138,17 +1272,94 @@
             __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.
@@ -1239,11 +1450,114 @@
         }
         /**
          * 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.
@@ -1252,10 +1566,10 @@
          * @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.
@@ -1283,7 +1597,23 @@
             }
             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);
@@ -1292,18 +1622,74 @@
             __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) {
@@ -1372,38 +1758,181 @@
                 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');
@@ -1421,6 +1950,12 @@
                 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 : [];
@@ -1447,12 +1982,12 @@
          * @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();
             });
@@ -1466,12 +2001,12 @@
             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")) : '') +
@@ -1482,6 +2017,15 @@
                 '&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); });
@@ -1502,7 +2046,7 @@
             }), "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");
@@ -1510,11 +2054,12 @@
             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
@@ -1526,32 +2071,40 @@
             }
             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")) {
@@ -1573,7 +2126,7 @@
     }, _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") +
@@ -1668,6 +2221,209 @@
         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();
+
     exports.SearchParameterType = void 0;
     (function (SearchParameterType) {
         SearchParameterType["BOOLEAN"] = "BOOLEAN";
@@ -1794,6 +2550,7 @@
         return result;
     }
 
+    exports.LegacyRepositoryClient = LegacyRepositoryClient;
     exports.MedplumClient = MedplumClient;
     exports.OperationOutcomeError = OperationOutcomeError;
     exports.accessDenied = accessDenied;
@@ -1803,6 +2560,8 @@
     exports.assertOk = assertOk;
     exports.badRequest = badRequest;
     exports.buildTypeName = buildTypeName;
+    exports.calculateAge = calculateAge;
+    exports.calculateAgeString = calculateAgeString;
     exports.capitalize = capitalize;
     exports.createReference = createReference;
     exports.createSchema = createSchema;