npm - @medplum/core - Versions diffs - 1.0.0 → 1.0.1 - Mend

@medplum/core 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

package/dist/cjs/client.d.ts CHANGED Viewed

@@ -136,10 +136,7 @@ export interface CreatePdfFunction {
         [name: string]: CustomTableLayout;
     } | undefined, fonts?: TFontDictionary | undefined): Promise<any>;
 }
-export interface LoginRequest {
-    readonly email: string;
-    readonly password: string;
-    readonly remember?: boolean;
+export interface BaseLoginRequest {
     readonly projectId?: string;
     readonly clientId?: string;
     readonly resourceType?: string;
@@ -147,6 +144,13 @@ export interface LoginRequest {
     readonly nonce?: string;
     readonly codeChallenge?: string;
     readonly codeChallengeMethod?: string;
+    readonly googleClientId?: string;
+    readonly launch?: string;
+}
+export interface EmailPasswordLoginRequest extends BaseLoginRequest {
+    readonly email: string;
+    readonly password: string;
+    readonly remember?: boolean;
 }
 export interface NewUserRequest {
     readonly firstName: string;
@@ -170,16 +174,9 @@ export interface GoogleCredentialResponse {
     readonly clientId: string;
     readonly credential: string;
 }
-export interface GoogleLoginRequest {
+export interface GoogleLoginRequest extends BaseLoginRequest {
     readonly googleClientId: string;
     readonly googleCredential: string;
-    readonly projectId?: string;
-    readonly clientId?: string;
-    readonly resourceType?: string;
-    readonly scope?: string;
-    readonly nonce?: string;
-    readonly codeChallenge?: string;
-    readonly codeChallengeMethod?: string;
     readonly createUser?: boolean;
 }
 export interface LoginAuthenticationResponse {
@@ -318,6 +315,11 @@ export interface MailOptions {
  * const bundle = await medplum.search('Patient', 'name=Alice');
  * console.log(bundle.total);
  * ```
+ *
+ *  <head>
+ *    <meta name="algolia:pageRank" content="100" />
+ *  </head>
  */
 export declare class MedplumClient extends EventTarget {
     #private;
@@ -454,7 +456,7 @@ export declare class MedplumClient extends EventTarget {
      * @param loginRequest Login request including email and password.
      * @returns Promise to the authentication response.
      */
-    startLogin(loginRequest: LoginRequest): Promise<LoginAuthenticationResponse>;
+    startLogin(loginRequest: EmailPasswordLoginRequest): Promise<LoginAuthenticationResponse>;
     /**
      * Tries to sign in with Google authentication.
      * The response parameter is the result of a Google authentication.
@@ -464,7 +466,7 @@ export declare class MedplumClient extends EventTarget {
      * @returns Promise to the authentication response.
      */
     startGoogleLogin(loginRequest: GoogleLoginRequest): Promise<LoginAuthenticationResponse>;
-    getCodeChallenge(loginRequest: LoginRequest | GoogleLoginRequest): {
+    getCodeChallenge(loginRequest: BaseLoginRequest): {
         codeChallenge?: string;
         codeChallengeMethod?: string;
     };
@@ -724,6 +726,16 @@ export declare class MedplumClient extends EventTarget {
      */
     readVersion<K extends ResourceType>(resourceType: K, id: string, vid: string, options?: RequestInit): ReadablePromise<ExtractResource<K>>;
     /**
+     * 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

package/dist/cjs/format.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import { Address, HumanName, Period, Timing } from '@medplum/fhirtypes';
+import { Address, HumanName, Period, Timing, Range, Quantity } from '@medplum/fhirtypes';
 export interface AddressFormatOptions {
     all?: boolean;
     use?: boolean;
@@ -19,3 +19,15 @@ export declare function formatTime(time: string | undefined, options?: Intl.Date
 export declare function formatDateTime(dateTime: string | undefined, options?: Intl.DateTimeFormatOptions): string;
 export declare function formatPeriod(period: Period | undefined): string;
 export declare function formatTiming(timing: Timing | undefined): string;
+/**
+ * Returns a human-readable string for a FHIR Range datatype, taking into account comparators and one-sided ranges
+ * @param range A FHIR Range element
+ * @returns A human-readable string representation of the Range
+ */
+export declare function formatRange(range: Range | undefined): string;
+/**
+ * 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
+ */
+export declare function formatQuantity(quantity: Quantity | undefined, precision?: number): string;

package/dist/cjs/hl7.d.ts CHANGED Viewed

@@ -1,43 +1,136 @@
-export declare const SEGMENT_SEPARATOR = "\r";
-export declare const FIELD_SEPARATOR = "|";
-export declare 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
+ */
+export declare class Hl7Context {
+    readonly segmentSeparator: string;
+    readonly fieldSeparator: string;
+    readonly componentSeparator: string;
+    readonly repetitionSeparator: string;
+    readonly escapeCharacter: string;
+    readonly subcomponentSeparator: string;
+    constructor(segmentSeparator?: string, fieldSeparator?: string, componentSeparator?: string, repetitionSeparator?: string, escapeCharacter?: string, subcomponentSeparator?: string);
+    /**
+     * Returns the MSH-2 field value based on the configured separators.
+     * @returns The HL7 MSH-2 field value.
+     */
+    getMsh2(): string;
+}
 /**
  * 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.
  */
 export declare class Hl7Message {
+    readonly context: Hl7Context;
     readonly segments: Hl7Segment[];
-    constructor(segments: Hl7Segment[]);
+    /**
+     * Creates a new HL7 message.
+     * @param segments The HL7 segments.
+     * @param context Optional HL7 parsing context.
+     */
+    constructor(segments: Hl7Segment[], context?: Hl7Context);
+    /**
+     * 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: number | string): Hl7Segment | undefined;
+    /**
+     * 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: string): Hl7Segment[];
+    /**
+     * Returns the HL7 message as a string.
+     * @returns The HL7 message as a string.
+     */
     toString(): string;
+    /**
+     * Returns an HL7 "ACK" (acknowledgement) message for this message.
+     * @returns The HL7 "ACK" message.
+     */
     buildAck(): Hl7Message;
+    /**
+     * Parses an HL7 message string into an Hl7Message object.
+     * @param text The HL7 message text.
+     * @returns The parsed HL7 message.
+     */
     static parse(text: string): Hl7Message;
 }
 /**
  * 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.
  */
 export declare class Hl7Segment {
+    readonly context: Hl7Context;
     readonly name: string;
     readonly fields: Hl7Field[];
-    constructor(fields: Hl7Field[] | string[]);
+    /**
+     * Creates a new HL7 segment.
+     * @param fields The HL7 fields.
+     * @param context Optional HL7 parsing context.
+     */
+    constructor(fields: Hl7Field[] | string[], context?: Hl7Context);
+    /**
+     * Returns an HL7 field by index.
+     * @param index The HL7 field index.
+     * @returns The HL7 field.
+     */
     get(index: number): Hl7Field;
+    /**
+     * Returns the HL7 segment as a string.
+     * @returns The HL7 segment as a string.
+     */
     toString(): string;
-    static parse(text: string): Hl7Segment;
+    /**
+     * 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: string, context?: Hl7Context): Hl7Segment;
 }
 /**
  * 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.
  */
 export declare class Hl7Field {
-    readonly components: string[];
-    constructor(components: string[]);
-    get(index: number): string;
+    readonly context: Hl7Context;
+    readonly components: string[][];
+    /**
+     * Creates a new HL7 field.
+     * @param components The HL7 components.
+     * @param context Optional HL7 parsing context.
+     */
+    constructor(components: string[][], context?: Hl7Context);
+    /**
+     * 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: number, subcomponent?: number, repetition?: number): string;
+    /**
+     * Returns the HL7 field as a string.
+     * @returns The HL7 field as a string.
+     */
     toString(): string;
-    static parse(text: string): Hl7Field;
+    /**
+     * 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: string, context?: Hl7Context): Hl7Field;
 }

package/dist/cjs/index.js CHANGED Viewed

@@ -261,6 +261,54 @@
         }
         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
+     * @returns A human-readable string representation of the Range
+     */
+    function formatRange(range) {
+        var _a, _b, _c, _d, _e, _f;
+        if (!range || (((_a = range.low) === null || _a === void 0 ? void 0 : _a.value) === undefined && ((_b = range.high) === null || _b === void 0 ? void 0 : _b.value) === undefined)) {
+            return '';
+        }
+        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) {
+            return `>= ${formatQuantity(range.low)}`;
+        }
+        if (((_e = range.low) === null || _e === void 0 ? void 0 : _e.value) === undefined && ((_f = range.high) === null || _f === void 0 ? void 0 : _f.value) !== undefined) {
+            return `<= ${formatQuantity(range.high)}`;
+        }
+        return `${formatQuantity(range.low)} - ${formatQuantity(range.high)}`;
+    }
+    /**
+     * 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();
+    }
     /**
      * Creates a reference resource.
@@ -800,6 +848,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 +6322,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.1-69d972ca";
     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 +6375,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 +6632,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 +6648,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 +7055,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 +7795,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 +10549,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 +10639,7 @@
             return new Hl7Message([
                 new Hl7Segment([
                     'MSH',
-                    '^~\\&',
+                    this.context.getMsh2(),
                     receivingApp,
                     receivingFacility,
                     sendingApp,
@@ -10527,62 +10650,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 +11486,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 +11495,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 +11513,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 +11550,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 +11602,7 @@
     exports.preciseGreaterThanOrEquals = preciseGreaterThanOrEquals;
     exports.preciseLessThan = preciseLessThan;
     exports.preciseLessThanOrEquals = preciseLessThanOrEquals;
+    exports.preciseRound = preciseRound;
     exports.removeDuplicates = removeDuplicates;
     exports.resolveId = resolveId;
     exports.setCodeBySystem = setCodeBySystem;