@medplum/core 2.0.17 → 2.0.18

package/dist/cjs/index.cjs

@@ -1555,7 +1555,7 @@
      *
      * When using MedplumClient in the browser, it will be backed by browser localStorage.
      *
-     * When Using MedplumClient in the server, it will be backed by the MemoryStorage class.
+     * When Using MedplumClient in the server, it will be backed by the MemoryStorage class.  For example, the Medplum CLI uses `FileSystemStorage`.
      */
     class ClientStorage {
         constructor() {
@@ -6404,7 +6404,7 @@
     const globalSchema = baseSchema;
 
     // PKCE auth based on:
-    const MEDPLUM_VERSION = "2.0.17-5c5ebbda";
+    const MEDPLUM_VERSION = "2.0.18-e7b9bd9c" ;
     const DEFAULT_BASE_URL = 'https://api.medplum.com/';
     const DEFAULT_RESOURCE_CACHE_SIZE = 1000;
     const DEFAULT_CACHE_TIME = 60000; // 60 seconds
@@ -7980,6 +7980,9 @@
                 // No content or change
                 return undefined;
             }
+            if (response.status === 404) {
+                throw new OperationOutcomeError(normalizeOperationOutcome(notFound));
+            }
             let obj = undefined;
             try {
                 obj = await response.json();
@@ -8204,6 +8207,14 @@
         }
         /**
          * Starts a new OAuth2 client credentials flow.
+         *
+         * ```typescript
+         * await medplum.startClientLogin(process.env.MEDPLUM_CLIENT_ID, process.env.MEDPLUM_CLIENT_SECRET)
+         * // Example Search
+         * await medplum.searchResources('Patient')
+         * ```
+         *
+         *
          * See: https://datatracker.ietf.org/doc/html/rfc6749#section-4.4
          * @category Authentication
          * @param clientId The client ID.
@@ -8221,6 +8232,13 @@
         }
         /**
          * Sets the client ID and secret for basic auth.
+         *
+         *  ```typescript
+         * medplum.setBasicAuth(process.env.MEDPLUM_CLIENT_ID, process.env.MEDPLUM_CLIENT_SECRET)
+         * // Example Search
+         * await medplum.searchResources('Patient')
+         * ```
+         *
          * @category Authentication
          * @param clientId The client ID.
          * @param clientSecret The client secret.
@@ -12276,6 +12294,8 @@
         Operator["MISSING"] = "missing";
         // Reference
         Operator["IDENTIFIER"] = "identifier";
+        // _include and _revinclude
+        Operator["ITERATE"] = "iterate";
     })(exports.Operator || (exports.Operator = {}));
     /**
      * Parameter names may specify a modifier as a suffix.
@@ -12294,6 +12314,7 @@
         'of-type': exports.Operator.OF_TYPE,
         missing: exports.Operator.MISSING,
         identifier: exports.Operator.IDENTIFIER,
+        iterate: exports.Operator.ITERATE,
     };
     /**
      * For the ordered parameter types of number, date, and quantity,
@@ -12387,12 +12408,32 @@
                 searchRequest.total = 'estimate';
                 searchRequest.count = 0;
                 break;
-            case '_include':
-                searchRequest.include = value;
+            case '_include': {
+                const target = parseIncludeTarget(value);
+                if (modifier === 'iterate') {
+                    target.modifier = exports.Operator.ITERATE;
+                }
+                if (searchRequest.include) {
+                    searchRequest.include.push(target);
+                }
+                else {
+                    searchRequest.include = [target];
+                }
                 break;
-            case '_revinclude':
-                searchRequest.revInclude = value;
+            }
+            case '_revinclude': {
+                const target = parseIncludeTarget(value);
+                if (modifier === 'iterate') {
+                    target.modifier = exports.Operator.ITERATE;
+                }
+                if (searchRequest.revInclude) {
+                    searchRequest.revInclude.push(target);
+                }
+                else {
+                    searchRequest.revInclude = [target];
+                }
                 break;
+            }
             case '_fields':
                 searchRequest.fields = value.split(',');
                 break;
@@ -12506,6 +12547,34 @@
     function parseModifier(modifier) {
         return MODIFIER_OPERATORS[modifier] || exports.Operator.EQUALS;
     }
+    function parseIncludeTarget(input) {
+        const parts = input.split(':');
+        parts.forEach((p) => {
+            if (p === '*') {
+                throw new OperationOutcomeError(badRequest(`'*' is not supported as a value for search inclusion parameters`));
+            }
+        });
+        if (parts.length === 1) {
+            // Full wildcard, not currently supported
+            throw new OperationOutcomeError(badRequest(`Invalid include value '${input}': must be of the form ResourceType:search-parameter`));
+        }
+        else if (parts.length === 2) {
+            return {
+                resourceType: parts[0],
+                searchParam: parts[1],
+            };
+        }
+        else if (parts.length === 3) {
+            return {
+                resourceType: parts[0],
+                searchParam: parts[1],
+                targetType: parts[2],
+            };
+        }
+        else {
+            throw new OperationOutcomeError(badRequest(`Invalid include value '${input}'`));
+        }
+    }
     function addFilter(searchRequest, filter) {
         if (searchRequest.filters) {
             searchRequest.filters.push(filter);