@medplum/core 1.0.0 → 1.0.2

package/dist/cjs/index.js

@@ -261,6 +261,102 @@
         }
         return capitalize(builder.join(' ').trim());
     }
+    /**
+     * Returns a human-readable string for a FHIR Range datatype, taking into account comparators and one-sided ranges
+     * @param range A FHIR Range element
+     * @param exclusive If true, one-sided ranges will be rendered with the '>' or '<' bounds rather than '>=' or '<='
+     * @returns A human-readable string representation of the Range
+     */
+    function formatRange(range, precision, exclusive = false) {
+        var _a, _b, _c, _d;
+        if (exclusive && precision === undefined) {
+            throw new Error('Precision must be specified for exclusive ranges');
+        }
+        const low = (range === null || range === void 0 ? void 0 : range.low) && Object.assign({}, range.low);
+        const high = (range === null || range === void 0 ? void 0 : range.high) && Object.assign({}, range.high);
+        if (!range || ((low === null || low === void 0 ? void 0 : low.value) === undefined && (high === null || high === void 0 ? void 0 : high.value) === undefined)) {
+            return '';
+        }
+        if (((_a = range.low) === null || _a === void 0 ? void 0 : _a.value) !== undefined && ((_b = range.high) === null || _b === void 0 ? void 0 : _b.value) === undefined) {
+            if (exclusive && precision !== undefined) {
+                range.low.value = preciseDecrement(range.low.value, precision);
+                return `> ${formatQuantity(range.low, precision)}`;
+            }
+            return `>= ${formatQuantity(range.low, precision)}`;
+        }
+        if (((_c = range.low) === null || _c === void 0 ? void 0 : _c.value) === undefined && ((_d = range.high) === null || _d === void 0 ? void 0 : _d.value) !== undefined) {
+            if (exclusive && precision !== undefined) {
+                range.high.value = preciseIncrement(range.high.value, precision);
+                return `< ${formatQuantity(range.high, precision)}`;
+            }
+            return `<= ${formatQuantity(range.high, precision)}`;
+        }
+        if ((low === null || low === void 0 ? void 0 : low.unit) === (high === null || high === void 0 ? void 0 : high.unit)) {
+            low === null || low === void 0 ? true : delete low.unit;
+        }
+        return `${formatQuantity(low, precision)} - ${formatQuantity(high, precision)}`;
+    }
+    /**
+     * Returns a human-readable string for a FHIR Quantity datatype, taking into account units and comparators
+     * @param quantity A FHIR Quantity element
+     * @returns A human-readable string representation of the Quantity
+     */
+    function formatQuantity(quantity, precision) {
+        if (!quantity) {
+            return '';
+        }
+        const result = [];
+        if (quantity.comparator) {
+            result.push(quantity.comparator);
+            result.push(' ');
+        }
+        if (quantity.value !== undefined) {
+            if (precision !== undefined) {
+                result.push(quantity.value.toFixed(precision));
+            }
+            else {
+                result.push(quantity.value);
+            }
+        }
+        if (quantity.unit) {
+            if (quantity.unit !== '%' && result[result.length - 1] !== ' ') {
+                result.push(' ');
+            }
+            result.push(quantity.unit);
+        }
+        return result.join('').trim();
+    }
+    /**
+     * Returns the input number increased by the `n` units of the specified precision
+     * @param a The input number
+     * @param precision The precision in number of digits.
+     * @param n (default 1) The number of units to add
+     */
+    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 precision The precision in number of digits.
+     * @param n (default 1) The number of units to subtract
+     */
+    function preciseDecrement(a, precision, n = 1) {
+        return (toPreciseInteger$1(a, precision) - n) * Math.pow(10, -precision);
+    }
+    /**
+     * Returns an integer representation of the number with the given precision.
+     * For example, if precision is 2, then 1.2345 will be returned as 123.
+     * @param a The number.
+     * @param precision Optional precision in number of digits.
+     * @returns The integer with the given precision.
+     */
+    function toPreciseInteger$1(a, precision) {
+        if (precision === undefined) {
+            return a;
+        }
+        return Math.round(a * Math.pow(10, precision));
+    }
 
     /**
      * Creates a reference resource.
@@ -800,6 +896,15 @@
         return ((((_a = range.low) === null || _a === void 0 ? void 0 : _a.value) === undefined || preciseGreaterThanOrEquals(value, range.low.value, precision)) &&
             (((_b = range.high) === null || _b === void 0 ? void 0 : _b.value) === undefined || preciseLessThanOrEquals(value, range.high.value, precision)));
     }
+    /**
+     * Returns the input number rounded to the specified number of digits.
+     * @param a The input number.
+     * @param precision The precision in number of digits.
+     * @returns The number rounded to the specified number of digits.
+     */
+    function preciseRound(a, precision) {
+        return parseFloat(a.toFixed(precision));
+    }
     /**
      * Returns true if the two numbers are equal to the given precision.
      * @param a The first number.
@@ -6265,9 +6370,8 @@
     // PKCE auth based on:
     // https://aws.amazon.com/blogs/security/how-to-add-authentication-single-page-web-application-with-amazon-cognito-oauth2-implementation/
     var _MedplumClient_instances, _MedplumClient_fetch, _MedplumClient_createPdf, _MedplumClient_storage, _MedplumClient_requestCache, _MedplumClient_cacheTime, _MedplumClient_baseUrl, _MedplumClient_clientId, _MedplumClient_authorizeUrl, _MedplumClient_tokenUrl, _MedplumClient_logoutUrl, _MedplumClient_onUnauthenticated, _MedplumClient_accessToken, _MedplumClient_refreshToken, _MedplumClient_refreshPromise, _MedplumClient_profilePromise, _MedplumClient_profile, _MedplumClient_config, _MedplumClient_addLogin, _MedplumClient_refreshProfile, _MedplumClient_getCacheEntry, _MedplumClient_setCacheEntry, _MedplumClient_request, _MedplumClient_addFetchOptionsDefaults, _MedplumClient_setRequestContentType, _MedplumClient_setRequestBody, _MedplumClient_handleUnauthenticated, _MedplumClient_requestAuthorization, _MedplumClient_refresh, _MedplumClient_fetchTokens, _MedplumClient_verifyTokens, _MedplumClient_setupStorageListener;
-    const MEDPLUM_VERSION = "1.0.0-a614a88a";
+    const MEDPLUM_VERSION = "1.0.2-0ed0f55a";
     const DEFAULT_BASE_URL = 'https://api.medplum.com/';
-    const DEFAULT_SCOPE = 'launch/patient openid fhirUser offline_access user/*.*';
     const DEFAULT_RESOURCE_CACHE_SIZE = 1000;
     const DEFAULT_CACHE_TIME = 60000; // 60 seconds
     const JSON_CONTENT_TYPE = 'application/json';
@@ -6319,6 +6423,11 @@
      * const bundle = await medplum.search('Patient', 'name=Alice');
      * console.log(bundle.total);
      * ```
+     *
+     *  <head>
+     *    <meta name="algolia:pageRank" content="100" />
+     *  </head>
+
      */
     class MedplumClient extends EventTarget {
         constructor(options) {
@@ -6571,10 +6680,10 @@
          * @returns Promise to the authentication response.
          */
         startLogin(loginRequest) {
-            var _a, _b;
+            var _a;
             return __awaiter(this, void 0, void 0, function* () {
                 const { codeChallenge, codeChallengeMethod } = this.getCodeChallenge(loginRequest);
-                return this.post('auth/login', Object.assign(Object.assign({}, loginRequest), { clientId: (_a = loginRequest.clientId) !== null && _a !== void 0 ? _a : __classPrivateFieldGet(this, _MedplumClient_clientId, "f"), scope: (_b = loginRequest.scope) !== null && _b !== void 0 ? _b : DEFAULT_SCOPE, codeChallengeMethod,
+                return this.post('auth/login', Object.assign(Object.assign({}, loginRequest), { clientId: (_a = loginRequest.clientId) !== null && _a !== void 0 ? _a : __classPrivateFieldGet(this, _MedplumClient_clientId, "f"), scope: loginRequest.scope, codeChallengeMethod,
                     codeChallenge }));
             });
         }
@@ -6587,10 +6696,10 @@
          * @returns Promise to the authentication response.
          */
         startGoogleLogin(loginRequest) {
-            var _a, _b;
+            var _a;
             return __awaiter(this, void 0, void 0, function* () {
                 const { codeChallenge, codeChallengeMethod } = this.getCodeChallenge(loginRequest);
-                return this.post('auth/google', Object.assign(Object.assign({}, loginRequest), { clientId: (_a = loginRequest.clientId) !== null && _a !== void 0 ? _a : __classPrivateFieldGet(this, _MedplumClient_clientId, "f"), scope: (_b = loginRequest.scope) !== null && _b !== void 0 ? _b : DEFAULT_SCOPE, codeChallengeMethod,
+                return this.post('auth/google', Object.assign(Object.assign({}, loginRequest), { clientId: (_a = loginRequest.clientId) !== null && _a !== void 0 ? _a : __classPrivateFieldGet(this, _MedplumClient_clientId, "f"), scope: loginRequest.scope, codeChallengeMethod,
                     codeChallenge }));
             });
         }
@@ -6994,6 +7103,16 @@
             return this.get(this.fhirUrl(resourceType, id, '_history', vid), options);
         }
         /**
+         * Executes the Patient "everything" operation for a patient.
+         *
+         * Example:
+         *
+         * ```typescript
+         * const bundle = await medplum.readPatientEverything('123');
+         * console.log(bundle);
+         * ```
+         *
+         * See the FHIR "patient-everything" operation for full details: https://hl7.org/fhir/operation-patient-everything.html
          *
          * @category Read
          * @param id The Patient Id
@@ -7724,7 +7843,6 @@
             url.searchParams.set('state', sessionStorage.getItem('pkceState'));
             url.searchParams.set('client_id', __classPrivateFieldGet(this, _MedplumClient_clientId, "f"));
             url.searchParams.set('redirect_uri', getBaseUrl());
-            url.searchParams.set('scope', DEFAULT_SCOPE);
             url.searchParams.set('code_challenge_method', 'S256');
             url.searchParams.set('code_challenge', sessionStorage.getItem('codeChallenge'));
             window.location.assign(url.toString());
@@ -10479,30 +10597,83 @@
         return parseFhirPath(expression).eval(input);
     }
 
-    const SEGMENT_SEPARATOR = '\r';
-    const FIELD_SEPARATOR = '|';
-    const COMPONENT_SEPARATOR = '^';
+    /**
+     * The Hl7Context class represents the parsing context for an HL7 message.
+     *
+     * MSH-1:
+     * https://hl7-definition.caristix.com/v2/HL7v2.6/Fields/MSH.1
+     *
+     * MSH-2:
+     * https://hl7-definition.caristix.com/v2/HL7v2.6/Fields/MSH.2
+     *
+     * See this tutorial on MSH, and why it's a bad idea to use anything other than the default values:
+     * https://www.hl7soup.com/HL7TutorialMSH.html
+     */
+    class Hl7Context {
+        constructor(segmentSeparator = '\r', fieldSeparator = '|', componentSeparator = '^', repetitionSeparator = '~', escapeCharacter = '\\', subcomponentSeparator = '&') {
+            this.segmentSeparator = segmentSeparator;
+            this.fieldSeparator = fieldSeparator;
+            this.componentSeparator = componentSeparator;
+            this.repetitionSeparator = repetitionSeparator;
+            this.escapeCharacter = escapeCharacter;
+            this.subcomponentSeparator = subcomponentSeparator;
+        }
+        /**
+         * Returns the MSH-2 field value based on the configured separators.
+         * @returns The HL7 MSH-2 field value.
+         */
+        getMsh2() {
+            return (this.fieldSeparator +
+                this.componentSeparator +
+                this.repetitionSeparator +
+                this.escapeCharacter +
+                this.subcomponentSeparator);
+        }
+    }
     /**
      * The Hl7Message class represents one HL7 message.
      * A message is a collection of segments.
-     * Note that we do not strictly parse messages, and only use default delimeters.
      */
     class Hl7Message {
-        constructor(segments) {
+        /**
+         * Creates a new HL7 message.
+         * @param segments The HL7 segments.
+         * @param context Optional HL7 parsing context.
+         */
+        constructor(segments, context = new Hl7Context()) {
+            this.context = context;
             this.segments = segments;
         }
+        /**
+         * Returns an HL7 segment by index or by name.
+         * @param index The HL7 segment index or name.
+         * @returns The HL7 segment if found; otherwise, undefined.
+         */
         get(index) {
             if (typeof index === 'number') {
                 return this.segments[index];
             }
             return this.segments.find((s) => s.name === index);
         }
+        /**
+         * Returns all HL7 segments of a given name.
+         * @param name The HL7 segment name.
+         * @returns An array of HL7 segments with the specified name.
+         */
         getAll(name) {
             return this.segments.filter((s) => s.name === name);
         }
+        /**
+         * Returns the HL7 message as a string.
+         * @returns The HL7 message as a string.
+         */
         toString() {
-            return this.segments.map((s) => s.toString()).join(SEGMENT_SEPARATOR);
+            return this.segments.map((s) => s.toString()).join(this.context.segmentSeparator);
         }
+        /**
+         * Returns an HL7 "ACK" (acknowledgement) message for this message.
+         * @returns The HL7 "ACK" message.
+         */
         buildAck() {
             var _a, _b, _c, _d, _e, _f;
             const now = new Date();
@@ -10516,7 +10687,7 @@
             return new Hl7Message([
                 new Hl7Segment([
                     'MSH',
-                    '^~\\&',
+                    this.context.getMsh2(),
                     receivingApp,
                     receivingFacility,
                     sendingApp,
@@ -10527,62 +10698,119 @@
                     now.getTime().toString(),
                     'P',
                     versionId,
-                ]),
-                new Hl7Segment(['MSA', 'AA', controlId, 'OK']),
+                ], this.context),
+                new Hl7Segment(['MSA', 'AA', controlId, 'OK'], this.context),
             ]);
         }
+        /**
+         * Parses an HL7 message string into an Hl7Message object.
+         * @param text The HL7 message text.
+         * @returns The parsed HL7 message.
+         */
         static parse(text) {
-            if (!text.startsWith('MSH|^~\\&')) {
+            if (!text.startsWith('MSH')) {
                 const err = new Error('Invalid HL7 message');
                 err.type = 'entity.parse.failed';
                 throw err;
             }
-            return new Hl7Message(text.split(/[\r\n]+/).map((line) => Hl7Segment.parse(line)));
+            const context = new Hl7Context('\r', text.charAt(3), // Field separator, recommended "|"
+            text.charAt(4), // Component separator, recommended "^"
+            text.charAt(5), // Repetition separator, recommended "~"
+            text.charAt(6), // Escape character, recommended "\"
+            text.charAt(7) // Subcomponent separator, recommended "&"
+            );
+            return new Hl7Message(text.split(/[\r\n]+/).map((line) => Hl7Segment.parse(line, context)), context);
         }
     }
     /**
      * The Hl7Segment class represents one HL7 segment.
      * A segment is a collection of fields.
      * The name field is the first field.
-     * Note that we do not strictly parse messages, and only use default delimeters.
      */
     class Hl7Segment {
-        constructor(fields) {
+        /**
+         * Creates a new HL7 segment.
+         * @param fields The HL7 fields.
+         * @param context Optional HL7 parsing context.
+         */
+        constructor(fields, context = new Hl7Context()) {
+            this.context = context;
             if (isStringArray(fields)) {
                 this.fields = fields.map((f) => Hl7Field.parse(f));
             }
             else {
                 this.fields = fields;
             }
-            this.name = this.fields[0].components[0];
+            this.name = this.fields[0].components[0][0];
         }
+        /**
+         * Returns an HL7 field by index.
+         * @param index The HL7 field index.
+         * @returns The HL7 field.
+         */
         get(index) {
             return this.fields[index];
         }
+        /**
+         * Returns the HL7 segment as a string.
+         * @returns The HL7 segment as a string.
+         */
         toString() {
-            return this.fields.map((f) => f.toString()).join(FIELD_SEPARATOR);
+            return this.fields.map((f) => f.toString()).join(this.context.fieldSeparator);
         }
-        static parse(text) {
-            return new Hl7Segment(text.split(FIELD_SEPARATOR).map((f) => Hl7Field.parse(f)));
+        /**
+         * Parses an HL7 segment string into an Hl7Segment object.
+         * @param text The HL7 segment text.
+         * @param context Optional HL7 parsing context.
+         * @returns The parsed HL7 segment.
+         */
+        static parse(text, context = new Hl7Context()) {
+            return new Hl7Segment(text.split(context.fieldSeparator).map((f) => Hl7Field.parse(f, context)), context);
         }
     }
     /**
      * The Hl7Field class represents one HL7 field.
      * A field is a collection of components.
-     * Note that we do not strictly parse messages, and only use default delimeters.
      */
     class Hl7Field {
-        constructor(components) {
+        /**
+         * Creates a new HL7 field.
+         * @param components The HL7 components.
+         * @param context Optional HL7 parsing context.
+         */
+        constructor(components, context = new Hl7Context()) {
+            this.context = context;
             this.components = components;
         }
-        get(index) {
-            return this.components[index];
+        /**
+         * Returns an HL7 component by index.
+         * @param component The component index.
+         * @param subcomponent Optional subcomponent index.
+         * @param repetition Optional repetition index.
+         * @returns The string value of the specified component.
+         */
+        get(component, subcomponent, repetition = 0) {
+            let value = this.components[repetition][component] || '';
+            if (subcomponent !== undefined) {
+                value = value.split(this.context.subcomponentSeparator)[subcomponent] || '';
+            }
+            return value;
         }
+        /**
+         * Returns the HL7 field as a string.
+         * @returns The HL7 field as a string.
+         */
         toString() {
-            return this.components.join(COMPONENT_SEPARATOR);
+            return this.components.map((r) => r.join(this.context.componentSeparator)).join(this.context.repetitionSeparator);
         }
-        static parse(text) {
-            return new Hl7Field(text.split(COMPONENT_SEPARATOR));
+        /**
+         * Parses an HL7 field string into an Hl7Field object.
+         * @param text The HL7 field text.
+         * @param context Optional HL7 parsing context.
+         * @returns The parsed HL7 field.
+         */
+        static parse(text, context = new Hl7Context()) {
+            return new Hl7Field(text.split(context.repetitionSeparator).map((r) => r.split(context.componentSeparator)), context);
         }
     }
 
@@ -11306,7 +11534,6 @@
     exports.AndAtom = AndAtom;
     exports.ArithemticOperatorAtom = ArithemticOperatorAtom;
     exports.AsAtom = AsAtom;
-    exports.COMPONENT_SEPARATOR = COMPONENT_SEPARATOR;
     exports.ConcatAtom = ConcatAtom;
     exports.ContainsAtom = ContainsAtom;
     exports.DEFAULT_SEARCH_COUNT = DEFAULT_SEARCH_COUNT;
@@ -11316,9 +11543,9 @@
     exports.EquivalentAtom = EquivalentAtom;
     exports.FHIRPATH_KEYWORDS = FHIRPATH_KEYWORDS;
     exports.FHIRPATH_OPERATORS = FHIRPATH_OPERATORS;
-    exports.FIELD_SEPARATOR = FIELD_SEPARATOR;
     exports.FhirPathAtom = FhirPathAtom;
     exports.FunctionAtom = FunctionAtom;
+    exports.Hl7Context = Hl7Context;
     exports.Hl7Field = Hl7Field;
     exports.Hl7Message = Hl7Message;
     exports.Hl7Segment = Hl7Segment;
@@ -11334,7 +11561,6 @@
     exports.OperationOutcomeError = OperationOutcomeError;
     exports.OrAtom = OrAtom;
     exports.ReadablePromise = ReadablePromise;
-    exports.SEGMENT_SEPARATOR = SEGMENT_SEPARATOR;
     exports.SymbolAtom = SymbolAtom;
     exports.UnaryOperatorAtom = UnaryOperatorAtom;
     exports.UnionAtom = UnionAtom;
@@ -11372,6 +11598,8 @@
     exports.formatGivenName = formatGivenName;
     exports.formatHumanName = formatHumanName;
     exports.formatPeriod = formatPeriod;
+    exports.formatQuantity = formatQuantity;
+    exports.formatRange = formatRange;
     exports.formatSearchQuery = formatSearchQuery;
     exports.formatTime = formatTime;
     exports.formatTiming = formatTiming;
@@ -11422,6 +11650,7 @@
     exports.preciseGreaterThanOrEquals = preciseGreaterThanOrEquals;
     exports.preciseLessThan = preciseLessThan;
     exports.preciseLessThanOrEquals = preciseLessThanOrEquals;
+    exports.preciseRound = preciseRound;
     exports.removeDuplicates = removeDuplicates;
     exports.resolveId = resolveId;
     exports.setCodeBySystem = setCodeBySystem;