@medplum/core 2.0.21 → 2.0.22

package/dist/cjs/index.cjs

@@ -4,6 +4,37 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.medplum = global.medplum || {}, global.medplum.core = {})));
 })(this, (function (exports) { 'use strict';
 
+    /**
+     * Decodes a base64 string.
+     * Handles both browser and Node environments.
+     * @param data The base-64 encoded input string.
+     * @returns The decoded string.
+     */
+    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');
+    }
+    /**
+     * Encodes a base64 string.
+     * Handles both browser and Node environments.
+     * @param data The unencoded input string.
+     * @returns The base-64 encoded string.
+     */
+    function encodeBase64(data) {
+        if (typeof window !== 'undefined') {
+            return window.btoa(data);
+        }
+        if (typeof Buffer !== 'undefined') {
+            return Buffer.from(data, 'binary').toString('base64');
+        }
+        throw new Error('Unable to encode base64');
+    }
+
     /**
      * More on Bundles can be found here
      * http://hl7.org/fhir/R4/bundle.html
@@ -454,18 +485,20 @@
     }
     /**
      * Returns the input number increased by the `n` units of the specified precision
-     * @param a The input number
+     * @param a The input number.
      * @param precision The precision in number of digits.
-     * @param n (default 1) The number of units to add
+     * @param n (default 1) The number of units to add.
+     * @returns The result of the increment.
      */
     function preciseIncrement(a, precision, n = 1) {
         return (toPreciseInteger$1(a, precision) + n) * Math.pow(10, -precision);
     }
     /**
      * Returns the input number decreased by the `n` units of the specified precision
-     * @param a The input number
+     * @param a The input number.
      * @param precision The precision in number of digits.
-     * @param n (default 1) The number of units to subtract
+     * @param n (default 1) The number of units to subtract.
+     * @returns The result of the decrement.
      */
     function preciseDecrement(a, precision, n = 1) {
         return (toPreciseInteger$1(a, precision) - n) * Math.pow(10, -precision);
@@ -523,7 +556,7 @@
     /**
      * Returns a display string for the resource.
      * @param resource The input resource.
-     * @return Human friendly display string.
+     * @returns Human friendly display string.
      */
     function getDisplayString(resource) {
         if (isProfileResource(resource)) {
@@ -680,7 +713,7 @@
     }
     /**
      * Recursively builds the questionnaire answer items map.
-     * @param item The current questionnaire response item.
+     * @param items The current questionnaire response items.
      * @param result The cumulative result map.
      */
     function buildQuestionnaireAnswerItems(items, result) {
@@ -699,7 +732,6 @@
      * If multiple identifiers exist with the same system, the first one is returned.
      *
      * If the system is not found, then returns undefined.
-     *
      * @param resource The resource to check.
      * @param system The identifier system.
      * @returns The identifier value if found; otherwise undefined.
@@ -763,8 +795,9 @@
      * Evaluates JSON key/value pairs for FHIR JSON stringify.
      * Removes properties with empty string values.
      * Removes objects with zero properties.
-     * @param {string} k Property key.
-     * @param {*} v Property value.
+     * @param k Property key.
+     * @param v Property value.
+     * @returns The replaced value.
      */
     function stringifyReplacer(k, v) {
         return !isArrayKey(k) && isEmpty(v) ? undefined : v;
@@ -794,6 +827,7 @@
      * Ignores meta.versionId and meta.lastUpdated.
      * @param object1 The first object.
      * @param object2 The second object.
+     * @param path Optional path string.
      * @returns True if the objects are equal.
      */
     function deepEquals$1(object1, object2, path) {
@@ -859,7 +893,6 @@
      *
      * See: https://web.dev/structured-clone/
      * See: https://stackoverflow.com/questions/40488190/how-is-structured-clone-algorithm-different-from-deep-copy
-     *
      * @param input The input to clone.
      * @returns A deep clone of the input.
      */
@@ -876,7 +909,7 @@
     }
     /**
      * Returns true if the input is an object.
-     * @param object The candidate object.
+     * @param obj The candidate object.
      * @returns True if the input is a non-null non-undefined object.
      */
     function isObject$1(obj) {
@@ -961,6 +994,7 @@
      * @param definition The observation definition.
      * @param patient The patient.
      * @param value The observation value.
+     * @param category Optional interval category restriction.
      * @returns The observation interval if found; otherwise undefined.
      */
     function findObservationInterval(definition, patient, value, category) {
@@ -1113,6 +1147,7 @@
 
     /**
      * Returns a cryptographically secure random string.
+     * @returns A cryptographically secure random string.
      */
     function getRandomString() {
         const randomItems = new Uint32Array(28);
@@ -1121,7 +1156,8 @@
     }
     /**
      * Encrypts a string with SHA256 encryption.
-     * @param str
+     * @param str The unencrypted input string.
+     * @returns The encrypted value in an ArrayBuffer.
      */
     async function encryptSHA256(str) {
         return crypto.subtle.digest('SHA-256', new TextEncoder().encode(str));
@@ -1161,41 +1197,11 @@
         }
     }
 
-    /**
-     * Decodes a base64 string.
-     * Handles both browser and Node environments.
-     * @param data The base-64 encoded input string.
-     * @returns The decoded string.
-     */
-    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');
-    }
-    /**
-     * Encodes a base64 string.
-     * Handles both browser and Node environments.
-     * @param data The unencoded input string.
-     * @returns The base-64 encoded string.
-     */
-    function encodeBase64(data) {
-        if (typeof window !== 'undefined') {
-            return window.btoa(data);
-        }
-        if (typeof Buffer !== 'undefined') {
-            return Buffer.from(data, 'binary').toString('base64');
-        }
-        throw new Error('Unable to encode base64');
-    }
-
     /**
      * Decodes a section of a JWT.
      * See: https://tools.ietf.org/html/rfc7519
-     * @param payload
+     * @param payload The JWT payload string.
+     * @returns Collection of key value claims in the JWT payload.
      */
     function decodePayload(payload) {
         const cleanedPayload = payload.replace(/-/g, '+').replace(/_/g, '/');
@@ -1209,7 +1215,8 @@
     }
     /**
      * Parses the JWT payload.
-     * @param token JWT token
+     * @param token JWT token.
+     * @returns Collection of key value claims in the JWT payload.
      */
     function parseJWTPayload(token) {
         const [_header, payload, _signature] = token.split('.');
@@ -1604,6 +1611,7 @@
         }
         /**
          * Returns the number of key/value pairs.
+         * @returns The number of key/value pairs.
          */
         get length() {
             return this.data.size;
@@ -1616,12 +1624,16 @@
         }
         /**
          * Returns the current value associated with the given key, or null if the given key does not exist.
+         * @param key The specified storage key.
+         * @returns The current value associated with the given key, or null if the given key does not exist.
          */
         getItem(key) {
             return this.data.get(key) ?? null;
         }
         /**
          * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+         * @param key The storage key.
+         * @param value The new value.
          */
         setItem(key, value) {
             if (value) {
@@ -1633,12 +1645,15 @@
         }
         /**
          * Removes the key/value pair with the given key, if a key/value pair with the given key exists.
+         * @param key The storage key.
          */
         removeItem(key) {
             this.data.delete(key);
         }
         /**
          * Returns the name of the nth key, or null if n is greater than or equal to the number of key/value pairs.
+         * @param index The numeric index.
+         * @returns The nth key.
          */
         key(index) {
             return Array.from(this.data.keys())[index];
@@ -6181,6 +6196,7 @@
     }
     /**
      * Indexes PropertySchema from an ElementDefinition.
+     * @param structureDefinition The input StructureDefinition.
      * @param element The input ElementDefinition.
      * @see {@link IndexedStructureDefinition} for more details on indexed StructureDefinitions.
      */
@@ -6417,7 +6433,7 @@
 
     // PKCE auth based on:
     // https://aws.amazon.com/blogs/security/how-to-add-authentication-single-page-web-application-with-amazon-cognito-oauth2-implementation/
-    const MEDPLUM_VERSION = "2.0.21-87271fa1" ;
+    const MEDPLUM_VERSION = "2.0.22-f51ac45a" ;
     const DEFAULT_BASE_URL = 'https://api.medplum.com/';
     const DEFAULT_RESOURCE_CACHE_SIZE = 1000;
     const DEFAULT_CACHE_TIME = 60000; // 60 seconds
@@ -6504,7 +6520,6 @@
      *  <head>
      *    <meta name="algolia:pageRank" content="100" />
      *  </head>
-
      */
     class MedplumClient extends EventTarget {
         constructor(options) {
@@ -6571,6 +6586,9 @@
          * @category Authentication
          */
         clearActiveLogin() {
+            if (this.basicAuth) {
+                return;
+            }
             this.storage.setString('activeLogin', undefined);
             this.requestCache?.clear();
             this.accessToken = undefined;
@@ -6616,7 +6634,6 @@
          * This is a lower level method for custom requests.
          * For common operations, we recommend using higher level methods
          * such as `readResource()`, `search()`, etc.
-         *
          * @category HTTP
          * @param url The target URL.
          * @param options Optional fetch options.
@@ -6656,7 +6673,6 @@
          * This is a lower level method for custom requests.
          * For common operations, we recommend using higher level methods
          * such as `createResource()`.
-         *
          * @category HTTP
          * @param url The target URL.
          * @param body The content body. Strings and `File` objects are passed directly. Other objects are converted to JSON.
@@ -6681,7 +6697,6 @@
          * This is a lower level method for custom requests.
          * For common operations, we recommend using higher level methods
          * such as `updateResource()`.
-         *
          * @category HTTP
          * @param url The target URL.
          * @param body The content body. Strings and `File` objects are passed directly. Other objects are converted to JSON.
@@ -6706,7 +6721,6 @@
          * This is a lower level method for custom requests.
          * For common operations, we recommend using higher level methods
          * such as `patchResource()`.
-         *
          * @category HTTP
          * @param url The target URL.
          * @param operations Array of JSONPatch operations.
@@ -6727,13 +6741,12 @@
          * This is a lower level method for custom requests.
          * For common operations, we recommend using higher level methods
          * such as `deleteResource()`.
-         *
          * @category HTTP
          * @param url The target URL.
          * @param options Optional fetch options.
          * @returns Promise to the response content.
          */
-        delete(url, options = {}) {
+        delete(url, options) {
             url = url.toString();
             this.invalidateUrl(url);
             return this.request('DELETE', url, options);
@@ -6744,53 +6757,54 @@
          * This method is part of the two different user registration flows:
          * 1) New Practitioner and new Project
          * 2) New Patient registration
-         *
          * @category Authentication
          * @param newUserRequest Register request including email and password.
+         * @param options Optional fetch options.
          * @returns Promise to the authentication response.
          */
-        async startNewUser(newUserRequest) {
+        async startNewUser(newUserRequest, options) {
             const { codeChallengeMethod, codeChallenge } = await this.startPkce();
             return this.post('auth/newuser', {
                 ...newUserRequest,
                 codeChallengeMethod,
                 codeChallenge,
-            });
+            }, undefined, options);
         }
         /**
          * Initiates a new project flow.
          *
          * This requires a partial login from `startNewUser` or `startNewGoogleUser`.
-         *
          * @param newProjectRequest Register request including email and password.
+         * @param options Optional fetch options.
          * @returns Promise to the authentication response.
          */
-        async startNewProject(newProjectRequest) {
-            return this.post('auth/newproject', newProjectRequest);
+        async startNewProject(newProjectRequest, options) {
+            return this.post('auth/newproject', newProjectRequest, undefined, options);
         }
         /**
          * Initiates a new patient flow.
          *
          * This requires a partial login from `startNewUser` or `startNewGoogleUser`.
-         *
          * @param newPatientRequest Register request including email and password.
+         * @param options Optional fetch options.
          * @returns Promise to the authentication response.
          */
-        async startNewPatient(newPatientRequest) {
-            return this.post('auth/newpatient', newPatientRequest);
+        async startNewPatient(newPatientRequest, options) {
+            return this.post('auth/newpatient', newPatientRequest, undefined, options);
         }
         /**
          * Initiates a user login flow.
          * @category Authentication
          * @param loginRequest Login request including email and password.
+         * @param options Optional fetch options.
          * @returns Promise to the authentication response.
          */
-        async startLogin(loginRequest) {
+        async startLogin(loginRequest, options) {
             return this.post('auth/login', {
                 ...(await this.ensureCodeChallenge(loginRequest)),
                 clientId: loginRequest.clientId ?? this.clientId,
                 scope: loginRequest.scope,
-            });
+            }, undefined, options);
         }
         /**
          * Tries to sign in with Google authentication.
@@ -6798,14 +6812,15 @@
          * See: https://developers.google.com/identity/gsi/web/guides/handle-credential-responses-js-functions
          * @category Authentication
          * @param loginRequest Login request including Google credential response.
+         * @param options Optional fetch options.
          * @returns Promise to the authentication response.
          */
-        async startGoogleLogin(loginRequest) {
+        async startGoogleLogin(loginRequest, options) {
             return this.post('auth/google', {
                 ...(await this.ensureCodeChallenge(loginRequest)),
                 clientId: loginRequest.clientId ?? this.clientId,
                 scope: loginRequest.scope,
-            });
+            }, undefined, options);
         }
         /**
          * Returns the PKCE code challenge and method.
@@ -6836,6 +6851,7 @@
          * This may result in navigating away to the sign in page.
          * @category Authentication
          * @param loginParams Optional login parameters.
+         * @returns The user profile resource if available.
          */
         async signInWithRedirect(loginParams) {
             const urlParams = new URLSearchParams(window.location.search);
@@ -6872,6 +6888,7 @@
          * Exchange an external access token for a Medplum access token.
          * @param token The access token that was generated by the external identity provider.
          * @param clientId The ID of the `ClientApplication` in your Medplum project that will be making the exchange request.
+         * @returns The user profile resource.
          * @category Authentication
          */
         async exchangeExternalAccessToken(token, clientId) {
@@ -6970,14 +6987,13 @@
          * ```
          *
          * See FHIR search for full details: https://www.hl7.org/fhir/search.html
-         *
          * @category Search
          * @param resourceType The FHIR resource type.
          * @param query Optional FHIR search query or structured query object. Can be any valid input to the URLSearchParams() constructor.
          * @param options Optional fetch options.
          * @returns Promise to the search result bundle.
          */
-        search(resourceType, query, options = {}) {
+        search(resourceType, query, options) {
             const url = this.fhirSearchUrl(resourceType, query);
             const cacheKey = url.toString() + '-search';
             const cached = this.getCacheEntry(cacheKey, options);
@@ -7011,14 +7027,13 @@
          * The return value is the resource, if available; otherwise, undefined.
          *
          * See FHIR search for full details: https://www.hl7.org/fhir/search.html
-         *
          * @category Search
          * @param resourceType The FHIR resource type.
          * @param query Optional FHIR search query or structured query object. Can be any valid input to the URLSearchParams() constructor.
          * @param options Optional fetch options.
          * @returns Promise to the first search result.
          */
-        searchOne(resourceType, query, options = {}) {
+        searchOne(resourceType, query, options) {
             const url = this.fhirSearchUrl(resourceType, query);
             url.searchParams.set('_count', '1');
             url.searchParams.sort();
@@ -7046,14 +7061,13 @@
          * The return value is an array of resources.
          *
          * See FHIR search for full details: https://www.hl7.org/fhir/search.html
-         *
          * @category Search
          * @param resourceType The FHIR resource type.
          * @param query Optional FHIR search query or structured query object. Can be any valid input to the URLSearchParams() constructor.
          * @param options Optional fetch options.
          * @returns Promise to the array of search results.
          */
-        searchResources(resourceType, query, options = {}) {
+        searchResources(resourceType, query, options) {
             const url = this.fhirSearchUrl(resourceType, query);
             const cacheKey = url.toString() + '-searchResources';
             const cached = this.getCacheEntry(cacheKey, options);
@@ -7078,14 +7092,13 @@
          *  }
          * }
          * ```
-         *
          * @category Search
          * @param resourceType The FHIR resource type.
          * @param query Optional FHIR search query or structured query object. Can be any valid input to the URLSearchParams() constructor.
          * @param options Optional fetch options.
-         * @returns An async generator, where each result is an array of resources for each page.
+         * @yields An async generator, where each result is an array of resources for each page.
          */
-        async *searchResourcePages(resourceType, query, options = {}) {
+        async *searchResourcePages(resourceType, query, options) {
             let url = this.fhirSearchUrl(resourceType, query);
             while (url) {
                 const searchParams = new URL(url).searchParams;
@@ -7101,14 +7114,13 @@
         /**
          * Searches a ValueSet resource using the "expand" operation.
          * See: https://www.hl7.org/fhir/operation-valueset-expand.html
-         *
          * @category Search
          * @param system The ValueSet system url.
          * @param filter The search string.
          * @param options Optional fetch options.
          * @returns Promise to expanded ValueSet.
          */
-        searchValueSet(system, filter, options = {}) {
+        searchValueSet(system, filter, options) {
             const url = this.fhirUrl('ValueSet', '$expand');
             url.searchParams.set('url', system);
             url.searchParams.set('filter', filter);
@@ -7128,8 +7140,7 @@
         /**
          * Returns a cached resource if it is available.
          * @category Caching
-         * @param resourceType The FHIR resource type.
-         * @param id The FHIR resource ID.
+         * @param reference The FHIR reference.
          * @returns The resource if it is available in the cache; undefined otherwise.
          */
         getCachedReference(reference) {
@@ -7157,14 +7168,13 @@
          * ```
          *
          * See the FHIR "read" operation for full details: https://www.hl7.org/fhir/http.html#read
-         *
          * @category Read
          * @param resourceType The FHIR resource type.
          * @param id The resource ID.
          * @param options Optional fetch options.
          * @returns The resource if available; undefined otherwise.
          */
-        readResource(resourceType, id, options = {}) {
+        readResource(resourceType, id, options) {
             return this.get(this.fhirUrl(resourceType, id), options);
         }
         /**
@@ -7181,13 +7191,12 @@
          * ```
          *
          * See the FHIR "read" operation for full details: https://www.hl7.org/fhir/http.html#read
-         *
          * @category Read
          * @param reference The FHIR reference object.
          * @param options Optional fetch options.
          * @returns The resource if available; undefined otherwise.
          */
-        readReference(reference, options = {}) {
+        readReference(reference, options) {
             const refString = reference?.reference;
             if (!refString) {
                 return new ReadablePromise(Promise.reject(new Error('Missing reference')));
@@ -7283,14 +7292,13 @@
          * ```
          *
          * See the FHIR "history" operation for full details: https://www.hl7.org/fhir/http.html#history
-         *
          * @category Read
          * @param resourceType The FHIR resource type.
          * @param id The resource ID.
          * @param options Optional fetch options.
          * @returns Promise to the resource history.
          */
-        readHistory(resourceType, id, options = {}) {
+        readHistory(resourceType, id, options) {
             return this.get(this.fhirUrl(resourceType, id, '_history'), options);
         }
         /**
@@ -7304,7 +7312,6 @@
          * ```
          *
          * See the FHIR "vread" operation for full details: https://www.hl7.org/fhir/http.html#vread
-         *
          * @category Read
          * @param resourceType The FHIR resource type.
          * @param id The resource ID.
@@ -7312,7 +7319,7 @@
          * @param options Optional fetch options.
          * @returns The resource if available; undefined otherwise.
          */
-        readVersion(resourceType, id, vid, options = {}) {
+        readVersion(resourceType, id, vid, options) {
             return this.get(this.fhirUrl(resourceType, id, '_history', vid), options);
         }
         /**
@@ -7326,13 +7333,12 @@
          * ```
          *
          * See the FHIR "patient-everything" operation for full details: https://hl7.org/fhir/operation-patient-everything.html
-         *
          * @category Read
          * @param id The Patient Id
          * @param options Optional fetch options.
          * @returns A Bundle of all Resources related to the Patient
          */
-        readPatientEverything(id, options = {}) {
+        readPatientEverything(id, options) {
             return this.get(this.fhirUrl('Patient', id, '$everything'), options);
         }
         /**
@@ -7354,17 +7360,17 @@
          * ```
          *
          * See the FHIR "create" operation for full details: https://www.hl7.org/fhir/http.html#create
-         *
          * @category Create
          * @param resource The FHIR resource to create.
+         * @param options Optional fetch options.
          * @returns The result of the create operation.
          */
-        createResource(resource) {
+        createResource(resource, options) {
             if (!resource.resourceType) {
                 throw new Error('Missing resourceType');
             }
             this.invalidateSearches(resource.resourceType);
-            return this.post(this.fhirUrl(resource.resourceType), resource);
+            return this.post(this.fhirUrl(resource.resourceType), resource, undefined, options);
         }
         /**
          * Conditionally create a new FHIR resource only if some equivalent resource does not already exist on the server.
@@ -7400,14 +7406,15 @@
          * The query parameter only contains the search parameters (what would be in the URL following the "?").
          *
          * See the FHIR "conditional create" operation for full details: https://www.hl7.org/fhir/http.html#ccreate
-         *
          * @category Create
          * @param resource The FHIR resource to create.
          * @param query The search query for an equivalent resource (should not include resource type or "?").
+         * @param options Optional fetch options.
          * @returns The result of the create operation.
          */
-        async createResourceIfNoneExist(resource, query) {
-            return ((await this.searchOne(resource.resourceType, query)) ?? this.createResource(resource));
+        async createResourceIfNoneExist(resource, query, options) {
+            return ((await this.searchOne(resource.resourceType, query, options)) ??
+                this.createResource(resource, options));
         }
         /**
          * Creates a FHIR `Binary` resource with the provided data content.
@@ -7426,11 +7433,11 @@
          * ```
          *
          * See the FHIR "create" operation for full details: https://www.hl7.org/fhir/http.html#create
-         *
          * @category Create
          * @param data The binary data to upload.
          * @param filename Optional filename for the binary.
          * @param contentType Content type for the binary.
+         * @param onProgress Optional callback for progress events.
          * @returns The result of the create operation.
          */
         createBinary(data, filename, contentType, onProgress) {
@@ -7489,9 +7496,11 @@
          * ```
          *
          * See the pdfmake document definition for full details: https://pdfmake.github.io/docs/0.1/document-definition-object/
-         *
          * @category Media
          * @param docDefinition The PDF document definition.
+         * @param filename Optional filename for the PDF binary resource.
+         * @param tableLayouts Optional pdfmake custom table layout.
+         * @param fonts Optional pdfmake custom font dictionary.
          * @returns The result of the create operation.
          */
         async createPdf(docDefinition, filename, tableLayouts, fonts) {
@@ -7505,13 +7514,13 @@
          * Creates a FHIR `Communication` resource with the provided data content.
          *
          * This is a convenience method to handle commmon cases where a `Communication` resource is created with a `payload`.
-         *
          * @category Create
          * @param resource The FHIR resource to comment on.
          * @param text The text of the comment.
+         * @param options Optional fetch options.
          * @returns The result of the create operation.
          */
-        createComment(resource, text) {
+        createComment(resource, text, options) {
             const profile = this.getProfile();
             let encounter = undefined;
             let subject = undefined;
@@ -7534,7 +7543,7 @@
                 sender: profile ? createReference(profile) : undefined,
                 sent: new Date().toISOString(),
                 payload: [{ contentString: text }],
-            });
+            }, options);
         }
         /**
          * Updates a FHIR resource.
@@ -7556,12 +7565,12 @@
          * ```
          *
          * See the FHIR "update" operation for full details: https://www.hl7.org/fhir/http.html#update
-         *
          * @category Write
          * @param resource The FHIR resource to update.
+         * @param options Optional fetch options.
          * @returns The result of the update operation.
          */
-        async updateResource(resource) {
+        async updateResource(resource, options) {
             if (!resource.resourceType) {
                 throw new Error('Missing resourceType');
             }
@@ -7569,7 +7578,7 @@
                 throw new Error('Missing id');
             }
             this.invalidateSearches(resource.resourceType);
-            let result = await this.put(this.fhirUrl(resource.resourceType, resource.id), resource);
+            let result = await this.put(this.fhirUrl(resource.resourceType, resource.id), resource, undefined, options);
             if (!result) {
                 // On 304 not modified, result will be undefined
                 // Return the user input instead
@@ -7596,16 +7605,16 @@
          * 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
-         *
          * @category Write
          * @param resourceType The FHIR resource type.
          * @param id The resource ID.
          * @param operations The JSONPatch operations.
+         * @param options Optional fetch options.
          * @returns The result of the patch operations.
          */
-        patchResource(resourceType, id, operations) {
+        patchResource(resourceType, id, operations, options) {
             this.invalidateSearches(resourceType);
-            return this.patch(this.fhirUrl(resourceType, id), operations);
+            return this.patch(this.fhirUrl(resourceType, id), operations, options);
         }
         /**
          * Deletes a FHIR resource by resource type and ID.
@@ -7617,16 +7626,16 @@
          * ```
          *
          * See the FHIR "delete" operation for full details: https://www.hl7.org/fhir/http.html#delete
-         *
          * @category Delete
          * @param resourceType The FHIR resource type.
          * @param id The resource ID.
+         * @param options Optional fetch options.
          * @returns The result of the delete operation.
          */
-        deleteResource(resourceType, id) {
+        deleteResource(resourceType, id, options) {
             this.deleteCacheEntry(this.fhirUrl(resourceType, id).toString());
             this.invalidateSearches(resourceType);
-            return this.delete(this.fhirUrl(resourceType, id));
+            return this.delete(this.fhirUrl(resourceType, id), options);
         }
         /**
          * Executes the validate operation with the provided resource.
@@ -7641,12 +7650,12 @@
          * ```
          *
          * See the FHIR "$validate" operation for full details: https://www.hl7.org/fhir/resource-operation-validate.html
-         *
          * @param resource The FHIR resource.
+         * @param options Optional fetch options.
          * @returns The validate operation outcome.
          */
-        validateResource(resource) {
-            return this.post(this.fhirUrl(resource.resourceType, '$validate'), resource);
+        validateResource(resource, options) {
+            return this.post(this.fhirUrl(resource.resourceType, '$validate'), resource, undefined, options);
         }
         /**
          * Executes a bot by ID or Identifier.
@@ -7656,7 +7665,7 @@
          * @param options Optional fetch options.
          * @returns The Bot return value.
          */
-        executeBot(idOrIdentifier, body, contentType, options = {}) {
+        executeBot(idOrIdentifier, body, contentType, options) {
             let url;
             if (typeof idOrIdentifier === 'string') {
                 const id = idOrIdentifier;
@@ -7716,7 +7725,7 @@
          * @param options Optional fetch options.
          * @returns The FHIR batch/transaction response bundle.
          */
-        executeBatch(bundle, options = {}) {
+        executeBatch(bundle, options) {
             return this.post(this.fhirBaseUrl.slice(0, -1), bundle, undefined, options);
         }
         /**
@@ -7753,11 +7762,12 @@
          *
          * See options here: https://nodemailer.com/extras/mailcomposer/
          * @category Media
-         * @param options The MailComposer options.
+         * @param email The MailComposer options.
+         * @param options Optional fetch options.
          * @returns Promise to the operation outcome.
          */
-        sendEmail(email) {
-            return this.post('email/v1/send', email, 'application/json');
+        sendEmail(email, options) {
+            return this.post('email/v1/send', email, 'application/json', options);
         }
         /**
          * Executes a GraphQL query.
@@ -7799,7 +7809,6 @@
          * See the GraphQL documentation for more details: https://graphql.org/learn/
          *
          * See the FHIR GraphQL documentation for FHIR specific details: https://www.hl7.org/fhir/graphql.html
-         *
          * @category Read
          * @param query The GraphQL query.
          * @param operationName Optional GraphQL operation name.
@@ -7814,15 +7823,15 @@
          *
          * Executes the $graph operation on this resource to fetch a Bundle of resources linked to the target resource
          * according to a graph definition
-      
          * @category Read
          * @param resourceType The FHIR resource type.
          * @param id The resource ID.
          * @param graphName `name` parameter of the GraphDefinition
+         * @param options Optional fetch options.
          * @returns A Bundle
          */
-        readResourceGraph(resourceType, id, graphName) {
-            return this.get(`${this.fhirUrl(resourceType, id)}/$graph?graph=${graphName}`);
+        readResourceGraph(resourceType, id, graphName, options) {
+            return this.get(`${this.fhirUrl(resourceType, id)}/$graph?graph=${graphName}`, options);
         }
         /**
          * @category Authentication
@@ -7832,11 +7841,16 @@
             return this.storage.getObject('activeLogin');
         }
         /**
+         * Sets the active login.
+         * @param login The new active login state.
          * @category Authentication
          */
         async setActiveLogin(login) {
             this.clearActiveLogin();
             this.accessToken = login.accessToken;
+            if (this.basicAuth) {
+                return;
+            }
             this.refreshToken = login.refreshToken;
             this.storage.setObject('activeLogin', login);
             this.addLogin(login);
@@ -7845,6 +7859,7 @@
         }
         /**
          * Returns the current access token.
+         * @returns The current access token.
          * @category Authentication
          */
         getAccessToken() {
@@ -7852,6 +7867,7 @@
         }
         /**
          * Sets the current access token.
+         * @param accessToken The new access token.
          * @category Authentication
          */
         setAccessToken(accessToken) {
@@ -7861,6 +7877,8 @@
             this.config = undefined;
         }
         /**
+         * Returns the list of available logins.
+         * @returns The list of available logins.
          * @category Authentication
          */
         getLogins() {
@@ -7873,6 +7891,9 @@
         }
         async refreshProfile() {
             this.profilePromise = new Promise((resolve, reject) => {
+                if (this.basicAuth) {
+                    return;
+                }
                 this.get('auth/me')
                     .then((result) => {
                     this.profilePromise = undefined;
@@ -7886,18 +7907,26 @@
             return this.profilePromise;
         }
         /**
+         * Returns true if the client is waiting for authentication.
+         * @returns True if the client is waiting for authentication.
          * @category Authentication
          */
         isLoading() {
             return !!this.profilePromise;
         }
         /**
+         * Returns the current user profile resource if available.
+         * This method does not wait for loading promises.
+         * @returns The current user profile resource if available.
          * @category User Profile
          */
         getProfile() {
             return this.profile;
         }
         /**
+         * Returns the current user profile resource if available.
+         * This method waits for loading promises.
+         * @returns The current user profile resource if available.
          * @category User Profile
          */
         async getProfileAsync() {
@@ -7907,6 +7936,8 @@
             return this.getProfile();
         }
         /**
+         * Returns the current user configuration if available.
+         * @returns The current user configuration if available.
          * @category User Profile
          */
         getUserConfiguration() {
@@ -7914,9 +7945,9 @@
         }
         /**
          * Downloads the URL as a blob.
-         *
          * @category Read
          * @param url The URL to request.
+         * @param options Optional fetch request init options.
          * @returns Promise to the response body as a blob.
          */
         async download(url, options = {}) {
@@ -7930,12 +7961,13 @@
         /**
          * Upload media to the server and create a Media instance for the uploaded content.
          * @param contents The contents of the media file, as a string, Uint8Array, File, or Blob.
-         * @param contentType The media type of the content
-         * @param filename The name of the file to be uploaded, or undefined if not applicable
-         * @param additionalFields  Additional fields for Media
+         * @param contentType The media type of the content.
+         * @param filename The name of the file to be uploaded, or undefined if not applicable.
+         * @param additionalFields Additional fields for Media.
+         * @param options Optional fetch options.
          * @returns Promise that resolves to the created Media
          */
-        async uploadMedia(contents, contentType, filename, additionalFields) {
+        async uploadMedia(contents, contentType, filename, additionalFields, options) {
             const binary = await this.createBinary(contents, filename, contentType);
             return this.createResource({
                 ...additionalFields,
@@ -7945,11 +7977,10 @@
                     url: 'Binary/' + binary.id,
                     title: filename,
                 },
-            });
+            }, options);
         }
         /**
          * Performs Bulk Data Export operation request flow. See The FHIR "Bulk Data Export" for full details: https://build.fhir.org/ig/HL7/bulk-data/export.html#bulk-data-export
-         *
          * @param exportLevel Optional export level. Defaults to system level export. 'Group/:id' - Group of Patients, 'Patient' - All Patients.
          * @param resourceTypes A string of comma-delimited FHIR resource types.
          * @param since Resources will be included in the response if their state has changed after the supplied time (e.g. if Resource.meta.lastUpdated is later than the supplied _since time).
@@ -7965,7 +7996,6 @@
             if (since) {
                 url.searchParams.set('_since', since);
             }
-            options.method = exportLevel ? 'GET' : 'POST';
             this.addFetchOptionsDefaults(options);
             const headers = options.headers;
             headers['Prefer'] = 'respond-async';
@@ -8029,10 +8059,10 @@
         }
         /**
          * Makes an HTTP request.
-         * @param {string} method
-         * @param {string} url
-         * @param {string=} contentType
-         * @param {Object=} body
+         * @param method The HTTP method (GET, POST, etc).
+         * @param url The target URL.
+         * @param options Optional fetch request init options.
+         * @returns The JSON content body if available.
          */
         async request(method, url, options = {}) {
             if (this.refreshPromise) {
@@ -8097,9 +8127,7 @@
             let resultResponse;
             const retryDelay = 200;
             while (checkStatus) {
-                const fetchOptions = {
-                    method: 'GET',
-                };
+                const fetchOptions = {};
                 this.addFetchOptionsDefaults(fetchOptions);
                 const statusResponse = await this.fetchWithRetry(statusUrl, fetchOptions);
                 if (statusResponse.status !== 202) {
@@ -8175,7 +8203,7 @@
             if (this.accessToken) {
                 headers['Authorization'] = 'Bearer ' + this.accessToken;
             }
-            if (this.basicAuth) {
+            else if (this.basicAuth) {
                 headers['Authorization'] = 'Basic ' + this.basicAuth;
             }
             if (!options.cache) {
@@ -8219,8 +8247,8 @@
          * Otherwise, calls unauthenticated callbacks and rejects.
          * @param method The HTTP method of the original request.
          * @param url The URL of the original request.
-         * @param contentType The content type of the original request.
-         * @param body The body of the original request.
+         * @param options Optional fetch request init options.
+         * @returns The result of the retry.
          */
         handleUnauthenticated(method, url, options) {
             if (this.refresh()) {
@@ -8236,6 +8264,7 @@
          * Starts a new PKCE flow.
          * These PKCE values are stateful, and must survive redirects and page refreshes.
          * @category Authentication
+         * @returns The PKCE code challenge details.
          */
         async startPkce() {
             const pkceState = getRandomString();
@@ -8250,7 +8279,8 @@
         /**
          * Redirects the user to the login screen for authorization.
          * Clears all auth state including local storage and session storage.
-         * See: https://openid.net/specs/openid-connect-core-1_0.html#AuthorizationEndpoint
+         * @param loginParams The authorization login parameters.
+         * @see https://openid.net/specs/openid-connect-core-1_0.html#AuthorizationEndpoint
          */
         async requestAuthorization(loginParams) {
             const loginRequest = await this.ensureCodeChallenge(loginParams || {});
@@ -8269,6 +8299,7 @@
          * See: https://openid.net/specs/openid-connect-core-1_0.html#TokenRequest
          * @param code The authorization code received by URL parameter.
          * @param loginParams Optional login parameters.
+         * @returns The user profile resource.
          * @category Authentication
          */
         processCode(code, loginParams) {
@@ -8287,7 +8318,8 @@
         }
         /**
          * Tries to refresh the auth tokens.
-         * See: https://openid.net/specs/openid-connect-core-1_0.html#RefreshTokens
+         * @returns The refresh promise if available; otherwise undefined.
+         * @see https://openid.net/specs/openid-connect-core-1_0.html#RefreshTokens
          */
         refresh() {
             if (this.refreshPromise) {
@@ -8340,7 +8372,6 @@
          * // Example Search
          * await medplum.searchResources('Patient')
          * ```
-         *
          * @category Authentication
          * @param clientId The client ID.
          * @param clientSecret The client secret.
@@ -8363,14 +8394,20 @@
          * Makes a POST request to the tokens endpoint.
          * See: https://openid.net/specs/openid-connect-core-1_0.html#TokenEndpoint
          * @param formBody Token parameters in URL encoded format.
+         * @returns The user profile resource.
          */
         async fetchTokens(formBody) {
-            const response = await this.fetch(this.tokenUrl, {
+            const options = {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
                 body: formBody,
                 credentials: 'include',
-            });
+            };
+            const headers = options.headers;
+            if (this.basicAuth) {
+                headers['Authorization'] = `Basic ${this.basicAuth}`;
+            }
+            const response = await this.fetch(this.tokenUrl, options);
             if (!response.ok) {
                 this.clearActiveLogin();
                 throw new Error('Failed to fetch tokens');
@@ -8383,7 +8420,8 @@
          * Verifies the tokens received from the auth server.
          * Validates the JWT against the JWKS.
          * See: https://openid.net/specs/openid-connect-core-1_0.html#TokenEndpoint
-         * @param tokens
+         * @param tokens The token response.
+         * @returns Promise to complete.
          */
         async verifyTokens(tokens) {
             const token = tokens.access_token;
@@ -8394,7 +8432,14 @@
                 throw new Error('Token expired');
             }
             // Verify app_client_id
-            if (this.clientId && tokenPayload.client_id !== this.clientId) {
+            // external tokenPayload
+            if (tokenPayload.cid) {
+                if (tokenPayload.cid !== this.clientId) {
+                    this.clearActiveLogin();
+                    throw new Error('Token was not issued for this audience');
+                }
+            }
+            else if (this.clientId && tokenPayload.client_id !== this.clientId) {
                 this.clearActiveLogin();
                 throw new Error('Token was not issued for this audience');
             }
@@ -8448,6 +8493,7 @@
     }
     /**
      * Returns the base URL for the current page.
+     * @returns The window origin string.
      * @category HTTP
      */
     function getWindowOrigin() {
@@ -9209,6 +9255,7 @@
 
     /**
      * Temporary placholder for unimplemented methods.
+     * @returns Empty array.
      */
     const stub = () => [];
     const functions = {
@@ -9220,7 +9267,6 @@
          * Returns true if the input collection is empty ({ }) and false otherwise.
          *
          * See: https://hl7.org/fhirpath/#empty-boolean
-         *
          * @param input The input collection.
          * @returns True if the input collection is empty ({ }) and false otherwise.
          */
@@ -9237,9 +9283,8 @@
          * for where(criteria).exists().
          *
          * See: https://hl7.org/fhirpath/#existscriteria-expression-boolean
-         *
-         * @param input
-         * @param criteria
+         * @param input The input collection.
+         * @param criteria Optional criteria applied to the collection.
          * @returns True if the collection has unknown elements, and false otherwise.
          */
         exists: (input, criteria) => {
@@ -9257,7 +9302,6 @@
          * If the input collection is empty ({ }), the result is true.
          *
          * See: https://hl7.org/fhirpath/#allcriteria-expression-boolean
-         *
          * @param input The input collection.
          * @param criteria The evaluation criteria.
          * @returns True if for every element in the input collection, criteria evaluates to true.
@@ -9271,9 +9315,7 @@
          * If the input is empty ({ }), the result is true.
          *
          * See: https://hl7.org/fhirpath/#alltrue-boolean
-         *
          * @param input The input collection.
-         * @param criteria The evaluation criteria.
          * @returns True if all the items are true.
          */
         allTrue: (input) => {
@@ -9289,9 +9331,7 @@
          * If all the items are false, or if the input is empty ({ }), the result is false.
          *
          * See: https://hl7.org/fhirpath/#anytrue-boolean
-         *
          * @param input The input collection.
-         * @param criteria The evaluation criteria.
          * @returns True if unknown of the items are true.
          */
         anyTrue: (input) => {
@@ -9308,9 +9348,7 @@
          * If the input is empty ({ }), the result is true.
          *
          * See: https://hl7.org/fhirpath/#allfalse-boolean
-         *
          * @param input The input collection.
-         * @param criteria The evaluation criteria.
          * @returns True if all the items are false.
          */
         allFalse: (input) => {
@@ -9326,9 +9364,7 @@
          * If all the items are true, or if the input is empty ({ }), the result is false.
          *
          * See: https://hl7.org/fhirpath/#anyfalse-boolean
-         *
          * @param input The input collection.
-         * @param criteria The evaluation criteria.
          * @returns True if for every element in the input collection, criteria evaluates to true.
          */
         anyFalse: (input) => {
@@ -9368,7 +9404,6 @@
          * Returns 0 when the input collection is empty.
          *
          * See: https://hl7.org/fhirpath/#count-integer
-         *
          * @param input The input collection.
          * @returns The integer count of the number of items in the input collection.
          */
@@ -9386,7 +9421,6 @@
          * preserved in the result.
          *
          * See: https://hl7.org/fhirpath/#distinct-collection
-         *
          * @param input The input collection.
          * @returns The integer count of the number of items in the input collection.
          */
@@ -9405,7 +9439,6 @@
          * as defined below.
          *
          * See: https://hl7.org/fhirpath/#isdistinct-boolean
-         *
          * @param input The input collection.
          * @returns The integer count of the number of items in the input collection.
          */
@@ -9428,9 +9461,8 @@
          * consistent with singleton evaluation of collections behavior.
          *
          * See: https://hl7.org/fhirpath/#wherecriteria-expression-collection
-         *
          * @param input The input collection.
-         * @param condition The condition atom.
+         * @param criteria The condition atom.
          * @returns A collection containing only those elements in the input collection for which the stated criteria expression evaluates to true.
          */
         where: (input, criteria) => {
@@ -9446,6 +9478,9 @@
          * the input collection is empty ({ }), the result is empty as well.
          *
          * See: http://hl7.org/fhirpath/#selectprojection-expression-collection
+         * @param input The input collection.
+         * @param criteria The condition atom.
+         * @returns A collection containing only those elements in the input collection for which the stated criteria expression evaluates to true.
          */
         select: (input, criteria) => {
             return input.map((e) => criteria.eval([e])).flat();
@@ -9465,6 +9500,9 @@
          * must resolve to the name of a type in a model
          *
          * See: http://hl7.org/fhirpath/#oftypetype-type-specifier-collection
+         * @param input The input collection.
+         * @param criteria The condition atom.
+         * @returns A collection containing only those elements in the input collection that are of the given type or a subclass thereof.
          */
         ofType: (input, criteria) => {
             return input.filter((e) => e.type === criteria.name);
@@ -9480,7 +9518,6 @@
          * about cardinality is violated at run-time.
          *
          * See: https://hl7.org/fhirpath/#single-collection
-         *
          * @param input The input collection.
          * @returns The single item in the input if there is just one item.
          */
@@ -9495,7 +9532,6 @@
          * This function is equivalent to item[0], so it will return an empty collection if the input collection has no items.
          *
          * See: https://hl7.org/fhirpath/#first-collection
-         *
          * @param input The input collection.
          * @returns A collection containing only the first item in the input collection.
          */
@@ -9507,7 +9543,6 @@
          * Will return an empty collection if the input collection has no items.
          *
          * See: https://hl7.org/fhirpath/#last-collection
-         *
          * @param input The input collection.
          * @returns A collection containing only the last item in the input collection.
          */
@@ -9519,7 +9554,6 @@
          * Will return an empty collection if the input collection has no items, or only one item.
          *
          * See: https://hl7.org/fhirpath/#tail-collection
-         *
          * @param input The input collection.
          * @returns A collection containing all but the first item in the input collection.
          */
@@ -9533,8 +9567,8 @@
          * If num is less than or equal to zero, the input collection is simply returned.
          *
          * See: https://hl7.org/fhirpath/#skipnum-integer-collection
-         *
          * @param input The input collection.
+         * @param num The atom representing the number of elements to skip.
          * @returns A collection containing all but the first item in the input collection.
          */
         skip: (input, num) => {
@@ -9557,8 +9591,8 @@
          * take returns an empty collection.
          *
          * See: https://hl7.org/fhirpath/#takenum-integer-collection
-         *
          * @param input The input collection.
+         * @param num The atom representing the number of elements to take.
          * @returns A collection containing the first num items in the input collection.
          */
         take: (input, num) => {
@@ -9580,6 +9614,9 @@
          * Order of items is not guaranteed to be preserved in the result of this function.
          *
          * See: http://hl7.org/fhirpath/#intersectother-collection-collection
+         * @param input The input collection.
+         * @param other The atom representing the collection of elements to intersect.
+         * @returns A collection containing the elements that are in both collections.
          */
         intersect: (input, other) => {
             if (!other) {
@@ -9601,6 +9638,9 @@
          * e.g. (1 | 2 | 3).exclude(2) returns (1 | 3).
          *
          * See: http://hl7.org/fhirpath/#excludeother-collection-collection
+         * @param input The input collection.
+         * @param other The atom representing the collection of elements to exclude.
+         * @returns A collection containing the elements that are in the input collection but not the other collection.
          */
         exclude: (input, other) => {
             if (!other) {
@@ -9628,6 +9668,9 @@
          * In other words, this function returns the distinct list of elements from both inputs.
          *
          * See: http://hl7.org/fhirpath/#unionother-collection
+         * @param input The input collection.
+         * @param other The atom representing the collection of elements to merge.
+         * @returns A collection containing the elements that represent the union of both collections.
          */
         union: (input, other) => {
             if (!other) {
@@ -9644,6 +9687,9 @@
          * There is no expectation of order in the resulting collection.
          *
          * See: http://hl7.org/fhirpath/#combineother-collection-collection
+         * @param input The input collection.
+         * @param other The atom representing the collection of elements to merge.
+         * @returns A collection containing the elements that represent the combination of both collections including duplicates.
          */
         combine: (input, other) => {
             if (!other) {
@@ -9672,12 +9718,11 @@
          * true-result should only be evaluated if the criterion evaluates to true,
          * and otherwise-result should only be evaluated otherwise. For implementations,
          * this means delaying evaluation of the arguments.
-         *
-         * @param input
-         * @param criterion
-         * @param trueResult
-         * @param otherwiseResult
-         * @returns
+         * @param input The input collection.
+         * @param criterion The atom representing the conditional.
+         * @param trueResult The atom to be used if the conditional evaluates to true.
+         * @param otherwiseResult Optional atom to be used if the conditional evaluates to false.
+         * @returns The result of the iif function.
          */
         iif: (input, criterion, trueResult, otherwiseResult) => {
             const evalResult = criterion.eval(input);
@@ -9704,9 +9749,8 @@
          * If the item is not one the above types, or the item is a String, Integer, or Decimal, but is not equal to one of the possible values convertible to a Boolean, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#toboolean-boolean
-         *
-         * @param input
-         * @returns
+         * @param input The input collection.
+         * @returns The input converted to boolean value.
          */
         toBoolean: (input) => {
             if (input.length === 0) {
@@ -9748,9 +9792,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: http://hl7.org/fhirpath/#convertstoboolean-boolean
-         *
-         * @param input
-         * @returns
+         * @param input The input collection.
+         * @returns True if the input can be converted to boolean.
          */
         convertsToBoolean: (input) => {
             if (input.length === 0) {
@@ -9775,7 +9818,6 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#tointeger-integer
-         *
          * @param input The input collection.
          * @returns The string representation of the input.
          */
@@ -9809,9 +9851,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#convertstointeger-boolean
-         *
          * @param input The input collection.
-         * @returns
+         * @returns True if the input can be converted to an integer.
          */
         convertsToInteger: (input) => {
             if (input.length === 0) {
@@ -9834,6 +9875,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#todate-date
+         * @param input The input collection.
+         * @returns The value converted to a date if possible; otherwise empty array.
          */
         toDate: (input) => {
             if (input.length === 0) {
@@ -9860,6 +9903,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#convertstodate-boolean
+         * @param input The input collection.
+         * @returns True if the item can be converted to a date.
          */
         convertsToDate: (input) => {
             if (input.length === 0) {
@@ -9868,26 +9913,25 @@
             return booleanToTypedValue(functions.toDate(input).length === 1);
         },
         /**
-       * If the input collection contains a single item, this function will return a single datetime if:
-       *   1) the item is a DateTime
-       *   2) the item is a Date, in which case the result is a DateTime with the year, month, and day of the Date, and the time components empty (not set to zero)
-       *   3) the item is a String and is convertible to a DateTime
-       *
-       * If the item is not one of the above types, the result is empty.
-       *
-       * If the item is a String, but the string is not convertible to a DateTime (using the format YYYY-MM-DDThh:mm:ss.fff(+|-)hh:mm), the result is empty.
-       *
-       * If the item contains a partial datetime (e.g. '2012-01-01T10:00'), the result is a partial datetime.
-       *
-       * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
-       *
-       * If the input collection is empty, the result is empty.
-      
-       * See: https://hl7.org/fhirpath/#todatetime-datetime
-       *
-       * @param input
-       * @returns
-       */
+         * If the input collection contains a single item, this function will return a single datetime if:
+         *   1) the item is a DateTime
+         *   2) the item is a Date, in which case the result is a DateTime with the year, month, and day of the Date, and the time components empty (not set to zero)
+         *   3) the item is a String and is convertible to a DateTime
+         *
+         * If the item is not one of the above types, the result is empty.
+         *
+         * If the item is a String, but the string is not convertible to a DateTime (using the format YYYY-MM-DDThh:mm:ss.fff(+|-)hh:mm), the result is empty.
+         *
+         * If the item contains a partial datetime (e.g. '2012-01-01T10:00'), the result is a partial datetime.
+         *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * If the input collection is empty, the result is empty.
+         *
+         * See: https://hl7.org/fhirpath/#todatetime-datetime
+         * @param input The input collection.
+         * @returns The value converted to a dateTime if possible; otherwise empty array.
+         */
         toDateTime: (input) => {
             if (input.length === 0) {
                 return [];
@@ -9911,9 +9955,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#convertstodatetime-boolean
-         *
-         * @param input
-         * @returns
+         * @param input The input collection.
+         * @returns True if the item can be converted to a dateTime.
          */
         convertsToDateTime: (input) => {
             if (input.length === 0) {
@@ -9935,9 +9978,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#decimal-conversion-functions
-         *
          * @param input The input collection.
-         * @returns
+         * @returns The value converted to a decimal if possible; otherwise empty array.
          */
         toDecimal: (input) => {
             if (input.length === 0) {
@@ -9956,22 +9998,21 @@
             return [];
         },
         /**
-       * If the input collection contains a single item, this function will true if:
-       *   1) the item is an Integer or Decimal
-       *   2) the item is a String and is convertible to a Decimal
-       *   3) the item is a Boolean
-       *
-       * If the item is not one of the above types, or is not convertible to a Decimal (using the regex format (\\+|-)?\d+(\.\d+)?), the result is false.
-       *
-       * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
-       *
-       * If the input collection is empty, the result is empty.
-      
-       * See: https://hl7.org/fhirpath/#convertstodecimal-boolean
-       *
-       * @param input The input collection.
-       * @returns
-       */
+         * If the input collection contains a single item, this function will true if:
+         *   1) the item is an Integer or Decimal
+         *   2) the item is a String and is convertible to a Decimal
+         *   3) the item is a Boolean
+         *
+         * If the item is not one of the above types, or is not convertible to a Decimal (using the regex format (\\+|-)?\d+(\.\d+)?), the result is false.
+         *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * If the input collection is empty, the result is empty.
+         *
+         * See: https://hl7.org/fhirpath/#convertstodecimal-boolean
+         * @param input The input collection.
+         * @returns True if the item can be converted to a decimal.
+         */
         convertsToDecimal: (input) => {
             if (input.length === 0) {
                 return [];
@@ -9988,9 +10029,8 @@
          * If the item is not one of the above types, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#quantity-conversion-functions
-         *
          * @param input The input collection.
-         * @returns
+         * @returns The value converted to a quantity if possible; otherwise empty array.
          */
         toQuantity: (input) => {
             if (input.length === 0) {
@@ -10030,9 +10070,8 @@
          * If the unit argument is provided, it must be the string representation of a UCUM code (or a FHIRPath calendar duration keyword), and is used to determine whether the input quantity can be converted to the given unit, according to the unit conversion rules specified by UCUM. If the input quantity can be converted, the result is true, otherwise, the result is false.
          *
          * See: https://hl7.org/fhirpath/#convertstoquantityunit-string-boolean
-         *
          * @param input The input collection.
-         * @returns
+         * @returns True if the item can be converted to a quantity.
          */
         convertsToQuantity: (input) => {
             if (input.length === 0) {
@@ -10052,7 +10091,6 @@
          * If the item is not one of the above types, the result is false.
          *
          * See: https://hl7.org/fhirpath/#tostring-string
-         *
          * @param input The input collection.
          * @returns The string representation of the input.
          */
@@ -10085,9 +10123,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#tostring-string
-         *
          * @param input The input collection.
-         * @returns
+         * @returns True if the item can be converted to a string
          */
         convertsToString: (input) => {
             if (input.length === 0) {
@@ -10111,9 +10148,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#totime-time
-         *
-         * @param input
-         * @returns
+         * @param input The input collection.
+         * @returns The value converted to a time if possible; otherwise empty array.
          */
         toTime: (input) => {
             if (input.length === 0) {
@@ -10140,9 +10176,8 @@
          * If the input collection is empty, the result is empty.
          *
          * See: https://hl7.org/fhirpath/#convertstotime-boolean
-         *
-         * @param input
-         * @returns
+         * @param input The input collection.
+         * @returns True if the item can be converted to a time.
          */
         convertsToTime: (input) => {
             if (input.length === 0) {
@@ -10165,12 +10200,12 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#indexofsubstring-string-integer
-         *
          * @param input The input collection.
+         * @param searchStringAtom The substring to search for.
          * @returns The index of the substring.
          */
-        indexOf: (input, substringAtom) => {
-            return applyStringFunc((str, substring) => str.indexOf(substring), input, substringAtom);
+        indexOf: (input, searchStringAtom) => {
+            return applyStringFunc((str, substring) => str.indexOf(substring), input, searchStringAtom);
         },
         /**
          * Returns the part of the string starting at position start (zero-based). If length is given, will return at most length number of characters from the input string.
@@ -10182,9 +10217,10 @@
          * If an empty length is provided, the behavior is the same as if length had not been provided.
          *
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
-         *
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @param startAtom The start index atom.
+         * @param lengthAtom Optional length atom.
+         * @returns The substring.
          */
         substring: (input, startAtom, lengthAtom) => {
             return applyStringFunc((str, start, length) => {
@@ -10194,71 +10230,134 @@
             }, input, startAtom, lengthAtom);
         },
         /**
+         * Returns true when the input string starts with the given prefix.
+         *
+         * If prefix is the empty string (''), the result is true.
+         *
+         * If the input collection is empty, the result is empty.
          *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * See: https://hl7.org/fhirpath/#startswithprefix-string-boolean
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @param prefixAtom The prefix substring to test.
+         * @returns True if the input string starts with the given prefix string.
          */
         startsWith: (input, prefixAtom) => {
             return applyStringFunc((str, prefix) => str.startsWith(prefix), input, prefixAtom);
         },
         /**
+         * Returns true when the input string ends with the given suffix.
+         *
+         * If suffix is the empty string (''), the result is true.
          *
+         * If the input collection is empty, the result is empty.
+         *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * See: https://hl7.org/fhirpath/#endswithsuffix-string-boolean
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @param suffixAtom The suffix substring to test.
+         * @returns True if the input string ends with the given suffix string.
          */
         endsWith: (input, suffixAtom) => {
             return applyStringFunc((str, suffix) => str.endsWith(suffix), input, suffixAtom);
         },
         /**
+         * Returns true when the given substring is a substring of the input string.
          *
+         * If substring is the empty string (''), the result is true.
+         *
+         * If the input collection is empty, the result is empty.
+         *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * See: https://hl7.org/fhirpath/#containssubstring-string-boolean
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @param substringAtom The substring to test.
+         * @returns True if the input string contains the given substring.
          */
         contains: (input, substringAtom) => {
             return applyStringFunc((str, substring) => str.includes(substring), input, substringAtom);
         },
         /**
+         * Returns the input string with all characters converted to upper case.
          *
+         * If the input collection is empty, the result is empty.
+         *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * See: https://hl7.org/fhirpath/#upper-string
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @returns The string converted to upper case.
          */
         upper: (input) => {
             return applyStringFunc((str) => str.toUpperCase(), input);
         },
         /**
+         * Returns the input string with all characters converted to lower case.
+         *
+         * If the input collection is empty, the result is empty.
          *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * See: https://hl7.org/fhirpath/#lower-string
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @returns The string converted to lower case.
          */
         lower: (input) => {
             return applyStringFunc((str) => str.toLowerCase(), input);
         },
         /**
+         * Returns the input string with all instances of pattern replaced with substitution. If the substitution is the empty string (''),
+         * instances of pattern are removed from the result. If pattern is the empty string (''), every character in the input string is
+         * surrounded by the substitution, e.g. 'abc'.replace('','x') becomes 'xaxbxcx'.
+         *
+         * If the input collection, pattern, or substitution are empty, the result is empty ({ }).
          *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * See: https://hl7.org/fhirpath/#replacepattern-string-substitution-string-string
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @param patternAtom The pattern to search for.
+         * @param substitionAtom The substition to replace with.
+         * @returns The string with all instances of the search pattern replaced with the substitution string.
          */
         replace: (input, patternAtom, substitionAtom) => {
             return applyStringFunc((str, pattern, substition) => str.replaceAll(pattern, substition), input, patternAtom, substitionAtom);
         },
         /**
+         * Returns true when the value matches the given regular expression. Regular expressions should function consistently, regardless of any culture- and locale-specific settings in the environment, should be case-sensitive, use 'single line' mode and allow Unicode characters.
+         *
+         * If the input collection or regex are empty, the result is empty ({ }).
          *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * See: https://hl7.org/fhirpath/#matchesregex-string-boolean
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @param regexAtom The regular expression atom.
+         * @returns True if the input string matches the given regular expression.
          */
         matches: (input, regexAtom) => {
             return applyStringFunc((str, regex) => !!str.match(regex), input, regexAtom);
         },
         /**
+         * Matches the input using the regular expression in regex and replaces each match with the substitution string. The substitution may refer to identified match groups in the regular expression.
          *
+         * If the input collection, regex, or substitution are empty, the result is empty ({ }).
+         *
+         * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
+         *
+         * See: https://hl7.org/fhirpath/#replacematchesregex-string-substitution-string-string
          * @param input The input collection.
-         * @returns The index of the substring.
+         * @param regexAtom The regular expression atom.
+         * @param substitionAtom The substition to replace with.
+         * @returns The string with all instances of the search pattern replaced with the substitution string.
          */
         replaceMatches: (input, regexAtom, substitionAtom) => {
             return applyStringFunc((str, pattern, substition) => str.replaceAll(pattern, substition), input, regexAtom, substitionAtom);
         },
         /**
-         *
          * @param input The input collection.
          * @returns The index of the substring.
          */
@@ -10269,8 +10368,8 @@
          * Returns the list of characters in the input string. If the input collection is empty ({ }), the result is empty.
          *
          * See: https://hl7.org/fhirpath/#tochars-collection
-         *
          * @param input The input collection.
+         * @returns Array of characters.
          */
         toChars: (input) => {
             return applyStringFunc((str) => (str ? str.split('') : undefined), input);
@@ -10286,7 +10385,6 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#abs-integer-decimal-quantity
-         *
          * @param input The input collection.
          * @returns A collection containing the result.
          */
@@ -10301,7 +10399,6 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#ceiling-integer
-         *
          * @param input The input collection.
          * @returns A collection containing the result.
          */
@@ -10318,7 +10415,6 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#exp-decimal
-         *
          * @param input The input collection.
          * @returns A collection containing the result.
          */
@@ -10333,7 +10429,6 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#floor-integer
-         *
          * @param input The input collection.
          * @returns A collection containing the result.
          */
@@ -10350,7 +10445,6 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#ln-decimal
-         *
          * @param input The input collection.
          * @returns A collection containing the result.
          */
@@ -10369,8 +10463,8 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#logbase-decimal-decimal
-         *
          * @param input The input collection.
+         * @param baseAtom The logarithm base.
          * @returns A collection containing the result.
          */
         log: (input, baseAtom) => {
@@ -10386,8 +10480,8 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#powerexponent-integer-decimal-integer-decimal
-         *
          * @param input The input collection.
+         * @param expAtom The exponent power.
          * @returns A collection containing the result.
          */
         power: (input, expAtom) => {
@@ -10405,7 +10499,6 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#roundprecision-integer-decimal
-         *
          * @param input The input collection.
          * @returns A collection containing the result.
          */
@@ -10424,7 +10517,6 @@
          * Note that this function is equivalent to raising a number of the power of 0.5 using the power() function.
          *
          * See: https://hl7.org/fhirpath/#sqrt-decimal
-         *
          * @param input The input collection.
          * @returns A collection containing the result.
          */
@@ -10439,7 +10531,6 @@
          * If the input collection contains multiple items, the evaluation of the expression will end and signal an error to the calling environment.
          *
          * See: https://hl7.org/fhirpath/#truncate-integer
-         *
          * @param input The input collection.
          * @returns A collection containing the result.
          */
@@ -10465,9 +10556,9 @@
          * function unchanged.
          *
          * See: https://hl7.org/fhirpath/#tracename-string-projection-expression-collection
-         *
          * @param input The input collection.
          * @param nameAtom The log name.
+         * @returns The input collection.
          */
         trace: (input, nameAtom) => {
             console.log('trace', input, nameAtom);
@@ -10477,6 +10568,7 @@
          * Returns the current date and time, including timezone offset.
          *
          * See: https://hl7.org/fhirpath/#now-datetime
+         * @returns The current dateTime.
          */
         now: () => {
             return [{ type: exports.PropertyType.dateTime, value: new Date().toISOString() }];
@@ -10485,6 +10577,7 @@
          * Returns the current time.
          *
          * See: https://hl7.org/fhirpath/#timeofday-time
+         * @returns The current time string.
          */
         timeOfDay: () => {
             return [{ type: exports.PropertyType.time, value: new Date().toISOString().substring(11) }];
@@ -10493,6 +10586,7 @@
          * Returns the current date.
          *
          * See: https://hl7.org/fhirpath/#today-date
+         * @returns The current date string.
          */
         today: () => {
             return [{ type: exports.PropertyType.date, value: new Date().toISOString().substring(0, 10) }];
@@ -10504,6 +10598,11 @@
          *
          * IBM FHIR issue: https://github.com/IBM/FHIR/issues/1014
          * IBM FHIR PR: https://github.com/IBM/FHIR/pull/1023
+         * @param input The input collection.
+         * @param startAtom The start date/time.
+         * @param endAtom The end date/time.
+         * @param unitsAtom Which units to return ("years", "months", or "days").
+         * @returns The Quantity of time between the two dates.
          */
         between: (input, startAtom, endAtom, unitsAtom) => {
             const startDate = functions.toDateTime(startAtom.eval(input));
@@ -10532,10 +10631,9 @@
          * For implementations with compile-time typing, this requires special-case
          * handling when processing the argument to treat it as a type specifier rather
          * than an identifier expression:
-         *
-         * @param input
-         * @param typeAtom
-         * @returns
+         * @param input The input collection.
+         * @param typeAtom The desired type.
+         * @returns True if the input element is of the desired type.
          */
         is: (input, typeAtom) => {
             let typeName = '';
@@ -10557,9 +10655,8 @@
          * 6.5.3. not() : Boolean
          *
          * Returns true if the input collection evaluates to false, and false if it evaluates to true. Otherwise, the result is empty ({ }):
-         *
-         * @param input
-         * @returns
+         * @param input The input collection.
+         * @returns True if the input evaluates to false.
          */
         not: (input) => {
             return functions.toBoolean(input).map((value) => ({ type: exports.PropertyType.boolean, value: !value.value }));
@@ -10572,7 +10669,7 @@
          * For each item in the collection, if it is a string that is a uri (or canonical or url), locate the target of the reference, and add it to the resulting collection. If the item does not resolve to a resource, the item is ignored and nothing is added to the output collection.
          * The items in the collection may also represent a Reference, in which case the Reference.reference is resolved.
          * @param input The input collection.
-         * @returns
+         * @returns The resolved resource.
          */
         resolve: (input) => {
             return input
@@ -10627,9 +10724,8 @@
          * https://hl7.org/fhirpath/modelinfo.xsd
          *
          * See: https://hl7.org/fhirpath/#model-information
-         *
          * @param input The input collection.
-         * @returns
+         * @returns The type of the input value.
          */
         type: (input) => {
             return input.map(({ value }) => {
@@ -11831,7 +11927,7 @@
     /**
      * Formats a search definition object into a query string.
      * Note: The return value does not include the resource type.
-     * @param {!SearchRequest} definition The search definition.
+     * @param definition The search definition.
      * @returns Formatted URL.
      */
     function formatSearchQuery(definition) {
@@ -12219,7 +12315,7 @@
      * Returns a formatted string representing the date in ISO-8601 format.
      * @param hl7Date Date string.
      * @param options Optional configuration Object
-     * @returns
+     * @returns The date in ISO-8601 format.
      */
     function parseHl7Date(hl7Date, options) {
         if (!hl7Date) {
@@ -12308,7 +12404,6 @@
      * const medplum = new MedplumClient();
      * await medplum.requestSchema('Patient');
      * ```
-     *
      * @param resourceType The candidate resource type string.
      * @returns True if the resource type is a valid FHIR resource type.
      */
@@ -12348,9 +12443,7 @@
      * const medplum = new MedplumClient();
      * await medplum.requestSchema('Patient');
      * ```
-     *
      * @param resourceType The candidate resource type string.
-     * @returns True if the resource type is a valid FHIR resource type.
      */
     function validateResourceType(resourceType) {
         if (!resourceType) {
@@ -12390,9 +12483,7 @@
      * const medplum = new MedplumClient();
      * await medplum.requestSchema('Patient');
      * ```
-     *
-     * @param resourceType The candidate resource type string.
-     * @returns True if the resource type is a valid FHIR resource type.
+     * @param resource The candidate resource.
      */
     function validateResource(resource) {
         new FhirSchemaValidator(resource).validate();
@@ -12555,10 +12646,10 @@
          *   2) a JSON property with _ prepended to the name of the element, which, if present, contains the value's id and/or extensions
          *
          * See: https://hl7.org/fhir/json.html#primitive
-         *
          * @param path The path to the property
-         * @param key
-         * @param typedValue
+         * @param key The key in the current typed value.
+         * @param typedValue The current typed value.
+         * @returns True if the primitive element is valid.
          */
         checkPrimitiveElement(path, key, typedValue) {
             // Primitive element starts with underscore
@@ -12611,7 +12702,6 @@
      * Recursively checks for null values in an object.
      *
      * Note that "null" is a special value in JSON that is not allowed in FHIR.
-     *
      * @param value Input value of any type.
      * @param path Path string to the value for OperationOutcome.
      * @param issues Output list of issues.
@@ -12675,7 +12765,6 @@
      *   1) The "date" type includes "date", "datetime", and "period".
      *   2) The "token" type includes enums and booleans.
      *   3) Arrays/multiple values are not reflected at all.
-     *
      * @param resourceType The root resource type.
      * @param searchParam The search parameter.
      * @returns The search parameter type details.
@@ -12835,6 +12924,7 @@
     /**
      * Determines if the resource matches the search filter.
      * @param resource The resource that was created or updated.
+     * @param searchRequest The search request.
      * @param filter One of the filters of a subscription criteria.
      * @returns True if the resource satisfies the search filter.
      */
@@ -13051,8 +13141,10 @@
     exports.createReference = createReference;
     exports.createStructureIssue = createStructureIssue;
     exports.created = created;
+    exports.decodeBase64 = decodeBase64;
     exports.deepClone = deepClone;
     exports.deepEquals = deepEquals$1;
+    exports.encodeBase64 = encodeBase64;
     exports.evalFhirPath = evalFhirPath;
     exports.evalFhirPathTyped = evalFhirPathTyped;
     exports.fhirPathArrayEquals = fhirPathArrayEquals;