@medplum/core 5.1.9 → 5.1.11

package/dist/cjs/index.d.ts

@@ -2368,6 +2368,9 @@ export declare interface Hl7DateParseOptions {
 export declare class Hl7Field {
     readonly context: Hl7Context;
     readonly components: string[][];
+    /** @internal */
+    onModified?: () => void;
+    private cachedString;
     /**
      * Creates a new HL7 field.
      * @param components - The HL7 components.
@@ -2420,6 +2423,7 @@ export declare class Hl7Field {
      * @returns true if the component was set, false otherwise
      */
     setComponent(component: number, value: string, subcomponent?: number, repetition?: number): boolean;
+    private invalidateCache;
 }
 
 /**
@@ -2428,13 +2432,42 @@ export declare class Hl7Field {
  */
 export declare class Hl7Message {
     readonly context: Hl7Context;
-    readonly segments: Hl7Segment[];
+    /**
+     * Internal lazy-parsed segment storage. Entries are `string` until they
+     * are accessed (via {@link getSegment}, {@link getAllSegments}, {@link header},
+     * or the public {@link segments} getter), at which point they are parsed in
+     * place and replaced with their {@link Hl7Segment} form.
+     */
+    private readonly _segments;
+    /**
+     * Maps segment name → indices into {@link _segments}. Storing indices (rather
+     * than references to the segments themselves) keeps this map in sync with
+     * {@link _segments} without needing a per-parse update step, and is immune to
+     * collisions when two segments have identical raw text.
+     */
+    private segmentsByName;
+    private cachedString;
+    /** Becomes true once every entry in `_segments` has been parsed. */
+    private allSegmentsParsed;
     /**
      * Creates a new HL7 message.
+     *
+     * Segment strings are not parsed until they are accessed via {@link getSegment},
+     * {@link getAllSegments}, {@link header}, or the {@link segments} getter.
+     *
      * @param segments - The HL7 segments.
      * @param context - Optional HL7 parsing context.
      */
-    constructor(segments: Hl7Segment[], context?: Hl7Context);
+    constructor(segments: (Hl7Segment | string)[], context?: Hl7Context);
+    /**
+     * Returns all HL7 segments, parsing any unparsed segment strings on first access.
+     *
+     * Prefer {@link getSegment} or {@link getAllSegments} when you only need a subset
+     * of segments; those methods avoid parsing unrelated segments.
+     *
+     * @returns The HL7 segments array.
+     */
+    get segments(): Hl7Segment[];
     /**
      * Returns the HL7 message header.
      * @returns The HL7 message header.
@@ -2461,18 +2494,35 @@ export declare class Hl7Message {
      *
      * When using a string index, this method returns the first segment with the specified name.
      *
+     * Segments are lazily parsed; the requested segment is parsed and cached on demand.
+     *
      * @param index - The HL7 segment index or name.
      * @returns The HL7 segment if found; otherwise, undefined.
      */
     getSegment(index: number | string): Hl7Segment | undefined;
     /**
      * Returns all HL7 segments of a given name.
+     *
+     * Only the segments that match the requested name are parsed, which avoids parsing
+     * unrelated segments when scanning a message.
+     *
      * @param name - The HL7 segment name.
      * @returns An array of HL7 segments with the specified name.
      */
     getAllSegments(name: string): Hl7Segment[];
+    /**
+     * Parses the segment at the given index (if not already parsed), caches it back into
+     * the segments array, and wires up the onModified callback.
+     * @param index - The HL7 segment index.
+     * @returns The parsed HL7 segment, or undefined if the index is out of range.
+     */
+    private parseSegment;
     /**
      * Returns the HL7 message as a string.
+     *
+     * Unparsed segments are emitted directly from their original string form, which
+     * preserves the source text without forcing a parse.
+     *
      * @returns The HL7 message as a string.
      */
     toString(): string;
@@ -2499,6 +2549,9 @@ export declare class Hl7Message {
      * @returns true if the segment was set, false otherwise
      */
     setSegment(index: number | string, segment: Hl7Segment): boolean;
+    private findSegmentIndexByName;
+    private invalidateCache;
+    private bindSegments;
 }
 
 /**
@@ -2509,13 +2562,37 @@ export declare class Hl7Message {
 export declare class Hl7Segment {
     readonly context: Hl7Context;
     readonly name: string;
-    readonly fields: Hl7Field[];
+    /**
+     * Internal lazy-parsed field storage. Entries are `string` until they are
+     * accessed (via {@link getField} or the public {@link fields} getter), at
+     * which point they are parsed in place and replaced with their
+     * {@link Hl7Field} form.
+     */
+    private readonly _fields;
+    /** Becomes true once every entry in `_fields` has been parsed. */
+    private allFieldsParsed;
+    private cachedString;
+    /** @internal */
+    onModified?: () => void;
     /**
      * Creates a new HL7 segment.
+     *
+     * Field strings are not parsed until they are accessed via {@link getField}
+     * or via the {@link fields} getter.
+     *
      * @param fields - The HL7 fields. The first field is the segment name.
      * @param context - Optional HL7 parsing context.
      */
-    constructor(fields: Hl7Field[] | string[], context?: Hl7Context);
+    constructor(fields: (Hl7Field | string)[], context?: Hl7Context);
+    /**
+     * Returns all HL7 fields, parsing any unparsed field strings on first access.
+     *
+     * Prefer {@link getField} when you only need a subset of fields; that method
+     * avoids parsing unrelated fields.
+     *
+     * @returns The HL7 fields array.
+     */
+    get fields(): Hl7Field[];
     /**
      * Returns an HL7 field by index.
      * @param index - The HL7 field index.
@@ -2534,10 +2611,19 @@ export declare class Hl7Segment {
      *
      * Field zero is the segment name.
      *
+     * Fields are lazily parsed; the requested field is parsed and cached on demand.
+     *
      * @param index - The HL7 field index.
      * @returns The HL7 field.
      */
     getField(index: number): Hl7Field;
+    /**
+     * Parses the field at the given index (if not already parsed), caches it back into
+     * the fields array, and wires up the onModified callback.
+     * @param index - The HL7 field index.
+     * @returns The parsed HL7 field, or undefined if the index is out of range.
+     */
+    private parseField;
     /**
      * Returns an HL7 component by field index and component index.
      *
@@ -2558,6 +2644,10 @@ export declare class Hl7Segment {
     getComponent(fieldIndex: number, component: number, subcomponent?: number, repetition?: number): string;
     /**
      * Returns the HL7 segment as a string.
+     *
+     * Unparsed fields are emitted directly from their original string form, which
+     * preserves the source text without forcing a parse.
+     *
      * @returns The HL7 segment as a string.
      */
     toString(): string;
@@ -2588,6 +2678,8 @@ export declare class Hl7Segment {
      * @returns true if the component was set, false otherwise
      */
     setComponent(fieldIndex: number, component: number, value: string, subcomponent?: number, repetition?: number): boolean;
+    private invalidateCache;
+    private bindFields;
 }
 
 export declare const HTTP_HL7_ORG = "http://hl7.org";
@@ -4907,10 +4999,27 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     refreshIfExpired(gracePeriod?: number): Promise<void>;
     /**
      * Tries to refresh the auth tokens.
+     *
+     * When `navigator.locks` is available, the network call is wrapped in a Web Lock
+     * scoped to this client's storage namespace. This serializes refresh attempts across
+     * browser tabs/windows on the same origin so a single-use refresh token is not
+     * consumed by more than one tab. Tabs that wait on the lock re-read the latest
+     * tokens from storage when they acquire it and skip the network call if another tab
+     * has already refreshed.
+     *
+     * @param gracePeriod - Optional grace period in milliseconds threaded through to the post-lock authentication check.
      * @returns The refresh promise if available; otherwise undefined.
      * @see https://openid.net/specs/openid-connect-core-1_0.html#RefreshTokens
      */
     private refresh;
+    /**
+     * Acquires a cross-tab Web Lock (when available) and performs the token refresh.
+     * Tabs that wait on the lock check storage on acquisition and skip the network call
+     * if a peer tab has already produced a fresh access token.
+     * @param gracePeriod - Optional grace period in milliseconds used by the post-lock authentication check to decide whether the current token still has enough life left to skip the network refresh.
+     * @returns Promise that resolves when the refresh (or short-circuit) is complete.
+     */
+    private runRefreshWithLock;
     /**
      * Starts a new OAuth2 client credentials flow.
      *
@@ -5533,6 +5642,7 @@ export declare interface MedplumInfraConfig {
     loadBalancerSecurityGroupId?: string;
     loadBalancerLoggingBucket?: string;
     loadBalancerLoggingPrefix?: string;
+    loadBalancerAlgorithm?: 'round_robin' | 'least_outstanding_requests' | 'weighted_random';
     clamscanEnabled: boolean;
     clamscanLoggingBucket: string;
     clamscanLoggingPrefix: string;
@@ -5758,6 +5868,7 @@ export declare interface MedplumSourceInfraConfig {
     loadBalancerSecurityGroupId?: ValueOrExternalSecret<string>;
     loadBalancerLoggingBucket?: ValueOrExternalSecret<string>;
     loadBalancerLoggingPrefix?: ValueOrExternalSecret<string>;
+    loadBalancerAlgorithm?: ValueOrExternalSecret<'round_robin' | 'least_outstanding_requests' | 'weighted_random'>;
     clamscanEnabled: ValueOrExternalSecret<boolean>;
     clamscanLoggingBucket: ValueOrExternalSecret<string>;
     clamscanLoggingPrefix: ValueOrExternalSecret<string>;

package/dist/esm/index.d.ts

@@ -2368,6 +2368,9 @@ export declare interface Hl7DateParseOptions {
 export declare class Hl7Field {
     readonly context: Hl7Context;
     readonly components: string[][];
+    /** @internal */
+    onModified?: () => void;
+    private cachedString;
     /**
      * Creates a new HL7 field.
      * @param components - The HL7 components.
@@ -2420,6 +2423,7 @@ export declare class Hl7Field {
      * @returns true if the component was set, false otherwise
      */
     setComponent(component: number, value: string, subcomponent?: number, repetition?: number): boolean;
+    private invalidateCache;
 }
 
 /**
@@ -2428,13 +2432,42 @@ export declare class Hl7Field {
  */
 export declare class Hl7Message {
     readonly context: Hl7Context;
-    readonly segments: Hl7Segment[];
+    /**
+     * Internal lazy-parsed segment storage. Entries are `string` until they
+     * are accessed (via {@link getSegment}, {@link getAllSegments}, {@link header},
+     * or the public {@link segments} getter), at which point they are parsed in
+     * place and replaced with their {@link Hl7Segment} form.
+     */
+    private readonly _segments;
+    /**
+     * Maps segment name → indices into {@link _segments}. Storing indices (rather
+     * than references to the segments themselves) keeps this map in sync with
+     * {@link _segments} without needing a per-parse update step, and is immune to
+     * collisions when two segments have identical raw text.
+     */
+    private segmentsByName;
+    private cachedString;
+    /** Becomes true once every entry in `_segments` has been parsed. */
+    private allSegmentsParsed;
     /**
      * Creates a new HL7 message.
+     *
+     * Segment strings are not parsed until they are accessed via {@link getSegment},
+     * {@link getAllSegments}, {@link header}, or the {@link segments} getter.
+     *
      * @param segments - The HL7 segments.
      * @param context - Optional HL7 parsing context.
      */
-    constructor(segments: Hl7Segment[], context?: Hl7Context);
+    constructor(segments: (Hl7Segment | string)[], context?: Hl7Context);
+    /**
+     * Returns all HL7 segments, parsing any unparsed segment strings on first access.
+     *
+     * Prefer {@link getSegment} or {@link getAllSegments} when you only need a subset
+     * of segments; those methods avoid parsing unrelated segments.
+     *
+     * @returns The HL7 segments array.
+     */
+    get segments(): Hl7Segment[];
     /**
      * Returns the HL7 message header.
      * @returns The HL7 message header.
@@ -2461,18 +2494,35 @@ export declare class Hl7Message {
      *
      * When using a string index, this method returns the first segment with the specified name.
      *
+     * Segments are lazily parsed; the requested segment is parsed and cached on demand.
+     *
      * @param index - The HL7 segment index or name.
      * @returns The HL7 segment if found; otherwise, undefined.
      */
     getSegment(index: number | string): Hl7Segment | undefined;
     /**
      * Returns all HL7 segments of a given name.
+     *
+     * Only the segments that match the requested name are parsed, which avoids parsing
+     * unrelated segments when scanning a message.
+     *
      * @param name - The HL7 segment name.
      * @returns An array of HL7 segments with the specified name.
      */
     getAllSegments(name: string): Hl7Segment[];
+    /**
+     * Parses the segment at the given index (if not already parsed), caches it back into
+     * the segments array, and wires up the onModified callback.
+     * @param index - The HL7 segment index.
+     * @returns The parsed HL7 segment, or undefined if the index is out of range.
+     */
+    private parseSegment;
     /**
      * Returns the HL7 message as a string.
+     *
+     * Unparsed segments are emitted directly from their original string form, which
+     * preserves the source text without forcing a parse.
+     *
      * @returns The HL7 message as a string.
      */
     toString(): string;
@@ -2499,6 +2549,9 @@ export declare class Hl7Message {
      * @returns true if the segment was set, false otherwise
      */
     setSegment(index: number | string, segment: Hl7Segment): boolean;
+    private findSegmentIndexByName;
+    private invalidateCache;
+    private bindSegments;
 }
 
 /**
@@ -2509,13 +2562,37 @@ export declare class Hl7Message {
 export declare class Hl7Segment {
     readonly context: Hl7Context;
     readonly name: string;
-    readonly fields: Hl7Field[];
+    /**
+     * Internal lazy-parsed field storage. Entries are `string` until they are
+     * accessed (via {@link getField} or the public {@link fields} getter), at
+     * which point they are parsed in place and replaced with their
+     * {@link Hl7Field} form.
+     */
+    private readonly _fields;
+    /** Becomes true once every entry in `_fields` has been parsed. */
+    private allFieldsParsed;
+    private cachedString;
+    /** @internal */
+    onModified?: () => void;
     /**
      * Creates a new HL7 segment.
+     *
+     * Field strings are not parsed until they are accessed via {@link getField}
+     * or via the {@link fields} getter.
+     *
      * @param fields - The HL7 fields. The first field is the segment name.
      * @param context - Optional HL7 parsing context.
      */
-    constructor(fields: Hl7Field[] | string[], context?: Hl7Context);
+    constructor(fields: (Hl7Field | string)[], context?: Hl7Context);
+    /**
+     * Returns all HL7 fields, parsing any unparsed field strings on first access.
+     *
+     * Prefer {@link getField} when you only need a subset of fields; that method
+     * avoids parsing unrelated fields.
+     *
+     * @returns The HL7 fields array.
+     */
+    get fields(): Hl7Field[];
     /**
      * Returns an HL7 field by index.
      * @param index - The HL7 field index.
@@ -2534,10 +2611,19 @@ export declare class Hl7Segment {
      *
      * Field zero is the segment name.
      *
+     * Fields are lazily parsed; the requested field is parsed and cached on demand.
+     *
      * @param index - The HL7 field index.
      * @returns The HL7 field.
      */
     getField(index: number): Hl7Field;
+    /**
+     * Parses the field at the given index (if not already parsed), caches it back into
+     * the fields array, and wires up the onModified callback.
+     * @param index - The HL7 field index.
+     * @returns The parsed HL7 field, or undefined if the index is out of range.
+     */
+    private parseField;
     /**
      * Returns an HL7 component by field index and component index.
      *
@@ -2558,6 +2644,10 @@ export declare class Hl7Segment {
     getComponent(fieldIndex: number, component: number, subcomponent?: number, repetition?: number): string;
     /**
      * Returns the HL7 segment as a string.
+     *
+     * Unparsed fields are emitted directly from their original string form, which
+     * preserves the source text without forcing a parse.
+     *
      * @returns The HL7 segment as a string.
      */
     toString(): string;
@@ -2588,6 +2678,8 @@ export declare class Hl7Segment {
      * @returns true if the component was set, false otherwise
      */
     setComponent(fieldIndex: number, component: number, value: string, subcomponent?: number, repetition?: number): boolean;
+    private invalidateCache;
+    private bindFields;
 }
 
 export declare const HTTP_HL7_ORG = "http://hl7.org";
@@ -4907,10 +4999,27 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     refreshIfExpired(gracePeriod?: number): Promise<void>;
     /**
      * Tries to refresh the auth tokens.
+     *
+     * When `navigator.locks` is available, the network call is wrapped in a Web Lock
+     * scoped to this client's storage namespace. This serializes refresh attempts across
+     * browser tabs/windows on the same origin so a single-use refresh token is not
+     * consumed by more than one tab. Tabs that wait on the lock re-read the latest
+     * tokens from storage when they acquire it and skip the network call if another tab
+     * has already refreshed.
+     *
+     * @param gracePeriod - Optional grace period in milliseconds threaded through to the post-lock authentication check.
      * @returns The refresh promise if available; otherwise undefined.
      * @see https://openid.net/specs/openid-connect-core-1_0.html#RefreshTokens
      */
     private refresh;
+    /**
+     * Acquires a cross-tab Web Lock (when available) and performs the token refresh.
+     * Tabs that wait on the lock check storage on acquisition and skip the network call
+     * if a peer tab has already produced a fresh access token.
+     * @param gracePeriod - Optional grace period in milliseconds used by the post-lock authentication check to decide whether the current token still has enough life left to skip the network refresh.
+     * @returns Promise that resolves when the refresh (or short-circuit) is complete.
+     */
+    private runRefreshWithLock;
     /**
      * Starts a new OAuth2 client credentials flow.
      *
@@ -5533,6 +5642,7 @@ export declare interface MedplumInfraConfig {
     loadBalancerSecurityGroupId?: string;
     loadBalancerLoggingBucket?: string;
     loadBalancerLoggingPrefix?: string;
+    loadBalancerAlgorithm?: 'round_robin' | 'least_outstanding_requests' | 'weighted_random';
     clamscanEnabled: boolean;
     clamscanLoggingBucket: string;
     clamscanLoggingPrefix: string;
@@ -5758,6 +5868,7 @@ export declare interface MedplumSourceInfraConfig {
     loadBalancerSecurityGroupId?: ValueOrExternalSecret<string>;
     loadBalancerLoggingBucket?: ValueOrExternalSecret<string>;
     loadBalancerLoggingPrefix?: ValueOrExternalSecret<string>;
+    loadBalancerAlgorithm?: ValueOrExternalSecret<'round_robin' | 'least_outstanding_requests' | 'weighted_random'>;
     clamscanEnabled: ValueOrExternalSecret<boolean>;
     clamscanLoggingBucket: ValueOrExternalSecret<string>;
     clamscanLoggingPrefix: ValueOrExternalSecret<string>;