@medplum/core 2.0.26 → 2.0.28

package/dist/types/client.d.ts

@@ -1,7 +1,6 @@
-import { AccessPolicy, Binary, BulkDataExport, Bundle, Communication, ExtractResource, Identifier, Media, OperationOutcome, Project, ProjectMembership, ProjectSecret, Reference, Resource, ResourceType, UserConfiguration, ValueSet } from '@medplum/fhirtypes';
+import { AccessPolicy, Attachment, Binary, BulkDataExport, Bundle, Communication, ExtractResource, Identifier, Media, OperationOutcome, Project, ProjectMembership, ProjectMembershipAccess, ProjectSecret, Reference, Resource, ResourceType, UserConfiguration, ValueSet } from '@medplum/fhirtypes';
 /** @ts-ignore */
 import type { CustomTableLayout, TDocumentDefinitions, TFontDictionary } from 'pdfmake/interfaces';
-import { EventTarget } from './eventtarget';
 import { Hl7Message } from './hl7';
 import { ReadablePromise } from './readablepromise';
 import { ClientStorage } from './storage';
@@ -268,13 +267,20 @@ export interface BotEvent<T = Resource | Hl7Message | string | Record<string, an
     readonly input: T;
     readonly secrets: Record<string, ProjectSecret>;
 }
-export interface InviteBody {
+export interface InviteRequest {
     resourceType: 'Patient' | 'Practitioner' | 'RelatedPerson';
     firstName: string;
     lastName: string;
     email?: string;
+    externalId?: string;
+    password?: string;
     sendEmail?: boolean;
+    membership?: Partial<ProjectMembership>;
+    /** @deprecated Use membership.accessPolicy instead. */
     accessPolicy?: Reference<AccessPolicy>;
+    /** @deprecated Use membership.access instead. */
+    access?: ProjectMembershipAccess[];
+    /** @deprecated Use membership.admin instead. */
     admin?: boolean;
 }
 /**
@@ -990,6 +996,31 @@ export declare class MedplumClient extends EventTarget {
      * @returns The result of the create operation.
      */
     createResourceIfNoneExist<T extends Resource>(resource: T, query: string, options?: RequestInit): Promise<T>;
+    /**
+     * Creates a FHIR `Attachment` with the provided data content.
+     *
+     * This is a convenience method for creating a `Binary` resource and then creating an `Attachment` element.
+     *
+     * The `data` parameter can be a string or a `File` object.
+     *
+     * A `File` object often comes from a `<input type="file">` element.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const result = await medplum.createAttachment(myFile, 'test.jpg', 'image/jpeg');
+     * console.log(result);
+     * ```
+     *
+     * 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.
+     */
+    createAttachment(data: string | File | Blob | Uint8Array, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void): Promise<Attachment>;
     /**
      * Creates a FHIR `Binary` resource with the provided data content.
      *
@@ -1565,10 +1596,10 @@ export declare class MedplumClient extends EventTarget {
     /**
      * Invite a user to a project.
      * @param projectId The project ID.
-     * @param body The InviteBody.
+     * @param body The InviteRequest.
      * @returns Promise that returns a project membership or an operation outcome.
      */
-    invite(projectId: string, body: InviteBody): Promise<ProjectMembership | OperationOutcome>;
+    invite(projectId: string, body: InviteRequest): Promise<ProjectMembership | OperationOutcome>;
     /**
      * Makes a POST request to the tokens endpoint.
      * See: https://openid.net/specs/openid-connect-core-1_0.html#TokenEndpoint

package/dist/types/config.d.ts

@@ -20,6 +20,7 @@ export interface MedplumInfraConfig {
     storagePublicKey: string;
     storageLoggingBucket?: string;
     storageLoggingPrefix?: string;
+    baseUrl: string;
     maxAzs: number;
     rdsInstances: number;
     rdsInstanceType: string;

package/dist/types/fhirpath/atoms.d.ts

@@ -93,6 +93,12 @@ export declare class AndAtom extends BooleanInfixOperatorAtom {
     constructor(left: Atom, right: Atom);
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
 }
+/**
+ * 6.5.2. or
+ * Returns false if both operands evaluate to false,
+ * true if either operand evaluates to true,
+ * and empty ({ }) otherwise:
+ */
 export declare class OrAtom extends BooleanInfixOperatorAtom {
     constructor(left: Atom, right: Atom);
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
@@ -116,7 +122,6 @@ export declare class XorAtom extends BooleanInfixOperatorAtom {
 export declare class ImpliesAtom extends BooleanInfixOperatorAtom {
     constructor(left: Atom, right: Atom);
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
-    private isValidCollectionLength;
 }
 export declare class FunctionAtom implements Atom {
     readonly name: string;

package/dist/types/fhirpath/utils.d.ts

@@ -20,6 +20,7 @@ export declare function toTypedValue(value: unknown): TypedValue;
  * @returns The converted boolean value according to FHIRPath rules.
  */
 export declare function toJsBoolean(obj: TypedValue[]): boolean;
+export declare function singleton(collection: TypedValue[], type?: string): TypedValue | undefined;
 /**
  * Returns the value of the property and the property type.
  * Some property definitions support multiple types.

package/dist/types/hl7.d.ts

@@ -37,18 +37,42 @@ export declare class Hl7Message {
      * @param context Optional HL7 parsing context.
      */
     constructor(segments: Hl7Segment[], context?: Hl7Context);
+    /**
+     * Returns the HL7 message header.
+     * @returns The HL7 message header.
+     */
+    get header(): Hl7Segment;
     /**
      * 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.
+     * @deprecated Use getSegment() instead. This method will be removed in a future release.
      */
     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.
+     * @deprecated Use getAllSegments() instead. This method will be removed in a future release.
      */
     getAll(name: string): Hl7Segment[];
+    /**
+     * Returns an HL7 segment by index or by name.
+     *
+     * When using a numeric index, the first segment (usually the MSH header segment) is at index 0.
+     *
+     * When using a string index, this method returns the first segment with the specified name.
+     *
+     * @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.
+     * @param name The HL7 segment name.
+     * @returns An array of HL7 segments with the specified name.
+     */
+    getAllSegments(name: string): Hl7Segment[];
     /**
      * Returns the HL7 message as a string.
      * @returns The HL7 message as a string.
@@ -59,6 +83,7 @@ export declare class Hl7Message {
      * @returns The HL7 "ACK" message.
      */
     buildAck(): Hl7Message;
+    private buildAckMessageType;
     /**
      * Parses an HL7 message string into an Hl7Message object.
      * @param text The HL7 message text.
@@ -77,7 +102,7 @@ export declare class Hl7Segment {
     readonly fields: Hl7Field[];
     /**
      * Creates a new HL7 segment.
-     * @param fields The HL7 fields.
+     * @param fields The HL7 fields. The first field is the segment name.
      * @param context Optional HL7 parsing context.
      */
     constructor(fields: Hl7Field[] | string[], context?: Hl7Context);
@@ -85,8 +110,42 @@ export declare class Hl7Segment {
      * Returns an HL7 field by index.
      * @param index The HL7 field index.
      * @returns The HL7 field.
+     * @deprecated Use getSegment() instead. This method includes the segment name in the index, which leads to confusing behavior. This method will be removed in a future release.
      */
     get(index: number): Hl7Field;
+    /**
+     * Returns an HL7 field by index.
+     *
+     * Note that the index is 1-based, not 0-based.
+     *
+     * For example, to get the first field, use `getField(1)`.
+     *
+     * This aligns with HL7 field names such as PID.1, PID.2, etc.
+     *
+     * Field zero is the segment name.
+     *
+     * @param index The HL7 field index.
+     * @returns The HL7 field.
+     */
+    getField(index: number): Hl7Field;
+    /**
+     * Returns an HL7 component by field index and component index.
+     *
+     * This is a shortcut for `getField(field).getComponent(component)`.
+     *
+     * Note that both indexex are 1-based, not 0-based.
+     *
+     * For example, to get the first component, use `getComponent(1, 1)`.
+     *
+     * This aligns with HL7 component names such as MSH.9.2.
+     *
+     * @param fieldIndex The HL7 field index.
+     * @param component The component index.
+     * @param subcomponent Optional subcomponent index.
+     * @param repetition Optional repetition index.
+     * @returns The string value of the specified component.
+     */
+    getComponent(fieldIndex: number, component: number, subcomponent?: number, repetition?: number): string;
     /**
      * Returns the HL7 segment as a string.
      * @returns The HL7 segment as a string.
@@ -119,8 +178,24 @@ export declare class Hl7Field {
      * @param subcomponent Optional subcomponent index.
      * @param repetition Optional repetition index.
      * @returns The string value of the specified component.
+     * @deprecated Use getComponent() instead. This method will be removed in a future release.
      */
     get(component: number, subcomponent?: number, repetition?: number): string;
+    /**
+     * Returns an HL7 component by index.
+     *
+     * Note that the index is 1-based, not 0-based.
+     *
+     * For example, to get the first component, use `getComponent(1)`.
+     *
+     * This aligns with HL7 component names such as MSH.9.2.
+     *
+     * @param component The component index.
+     * @param subcomponent Optional subcomponent index.
+     * @param repetition Optional repetition index.
+     * @returns The string value of the specified component.
+     */
+    getComponent(component: number, subcomponent?: number, repetition?: number): string;
     /**
      * Returns the HL7 field as a string.
      * @returns The HL7 field as a string.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medplum/core",
-  "version": "2.0.26",
+  "version": "2.0.28",
   "description": "Medplum TS/JS Library",
   "author": "Medplum <hello@medplum.com>",
   "license": "Apache-2.0",

package/dist/types/eventtarget.d.ts

@@ -1,13 +0,0 @@
-interface Event {
-    readonly type: string;
-    readonly defaultPrevented?: boolean;
-}
-type EventListener = (e: Event) => void;
-export declare class EventTarget {
-    private readonly listeners;
-    constructor();
-    addEventListener(type: string, callback: EventListener): void;
-    removeEventListeneer(type: string, callback: EventListener): void;
-    dispatchEvent(event: Event): boolean;
-}
-export {};