@medplum/core 3.1.8 → 3.1.9

package/dist/cjs/index.d.ts

@@ -124,7 +124,7 @@ export declare interface AgentHeartbeatResponse extends BaseAgentMessage {
 
 export declare type AgentMessage = AgentRequestMessage | AgentResponseMessage;
 
-export declare interface AgentReloadConfigRequest extends BaseAgentMessage {
+export declare interface AgentReloadConfigRequest extends BaseAgentRequestMessage {
     type: 'agent:reloadconfig:request';
 }
 
@@ -133,9 +133,9 @@ export declare interface AgentReloadConfigResponse extends BaseAgentMessage {
     statusCode: number;
 }
 
-export declare type AgentRequestMessage = AgentConnectRequest | AgentHeartbeatRequest | AgentTransmitRequest | AgentReloadConfigRequest;
+export declare type AgentRequestMessage = AgentConnectRequest | AgentHeartbeatRequest | AgentTransmitRequest | AgentReloadConfigRequest | AgentUpgradeRequest;
 
-export declare type AgentResponseMessage = AgentConnectResponse | AgentHeartbeatResponse | AgentTransmitResponse | AgentReloadConfigResponse | AgentError;
+export declare type AgentResponseMessage = AgentConnectResponse | AgentHeartbeatResponse | AgentTransmitResponse | AgentReloadConfigResponse | AgentUpgradeResponse | AgentError;
 
 export declare interface AgentTransmitRequest extends BaseAgentRequestMessage {
     type: 'agent:transmit:request';
@@ -154,6 +154,16 @@ export declare interface AgentTransmitResponse extends BaseAgentMessage {
     body: string;
 }
 
+export declare interface AgentUpgradeRequest extends BaseAgentRequestMessage {
+    type: 'agent:upgrade:request';
+    version?: string;
+}
+
+export declare interface AgentUpgradeResponse extends BaseAgentMessage {
+    type: 'agent:upgrade:response';
+    statusCode: number;
+}
+
 export declare const allOk: OperationOutcome;
 
 /**
@@ -233,6 +243,14 @@ export declare function assertContextVersionOptional(event: string): asserts eve
  */
 export declare function assertOk<T>(outcome: OperationOutcome, resource: T | undefined): asserts resource is T;
 
+export declare interface AsyncResourceVisitor {
+    onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
+    onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
+    onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
+    onExitResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
+    visitPropertyAsync: (parent: TypedValueWithPath, key: string, path: string, value: TypedValueWithPath | TypedValueWithPath[], schema: InternalTypeSchema) => Promise<void>;
+}
+
 export declare interface Atom {
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
     toString(): string;
@@ -517,6 +535,8 @@ export declare const CPT = "http://www.ama-assn.org/go/cpt";
 
 export declare function crawlResource(resource: Resource, visitor: ResourceVisitor, schema?: InternalTypeSchema, initialPath?: string): void;
 
+export declare function crawlResource(resource: Resource, visitor: AsyncResourceVisitor, options: ResourceCrawlerOptions): Promise<void>;
+
 /**
  * Binary upload options.
  */
@@ -1587,6 +1607,8 @@ export declare interface GetTypedPropertyValueOptions {
     profileUrl?: string;
 }
 
+export declare function getTypedPropertyValueWithPath(input: TypedValue | TypedValueWithPath, path: string, options?: GetTypedPropertyValueOptions): TypedValueWithPath[] | TypedValueWithPath;
+
 /**
  * Returns the value of the property and the property type using a type schema.
  * @param typedValue - The base context (FHIR resource or backbone element).
@@ -2453,6 +2475,14 @@ export declare interface MailOptions {
     readonly attachments?: MailAttachment[];
 }
 
+/**
+ * Returns a Map of resources from a bundle, using the specified identifier system as the key.
+ * @param resourceBundle - The bundle of resources.
+ * @param identifierSystem - The identifier system to use for keys.
+ * @returns Map of resources keyed by identifier value for the specified system.
+ */
+export declare function mapByIdentifier<T extends Resource = Resource>(resourceBundle: Bundle<T>, identifierSystem: string): Map<string, T>;
+
 export declare interface Marker {
     index: number;
     line: number;
@@ -3987,9 +4017,10 @@ export declare class MedplumClient extends EventTarget_2 {
      *
      * @category Subscriptions
      * @param criteria - The criteria to subscribe to.
+     * @param subscriptionProps - Optional properties to add to the created `Subscription` resource.
      * @returns a `SubscriptionEmitter` that emits `Bundle` resources containing changes to resources based on the given criteria.
      */
-    subscribeToCriteria(criteria: string): SubscriptionEmitter;
+    subscribeToCriteria(criteria: string, subscriptionProps?: Partial<Subscription>): SubscriptionEmitter;
     /**
      * Unsubscribes from the given criteria.
      *
@@ -3998,8 +4029,9 @@ export declare class MedplumClient extends EventTarget_2 {
      *
      * @category Subscriptions
      * @param criteria - The criteria to unsubscribe from.
+     * @param subscriptionProps - The optional properties that `subscribeToCriteria` was called with.
      */
-    unsubscribeFromCriteria(criteria: string): void;
+    unsubscribeFromCriteria(criteria: string, subscriptionProps?: Partial<Subscription>): void;
     /**
      * Get the master `SubscriptionEmitter` for the `SubscriptionManager`.
      *
@@ -4883,65 +4915,65 @@ export declare const projectAdminResourceTypes: string[];
  * The list here includes additions found from StructureDefinition resources.
  */
 export declare const PropertyType: {
-    Address: string;
-    Age: string;
-    Annotation: string;
-    Attachment: string;
-    BackboneElement: string;
-    CodeableConcept: string;
-    Coding: string;
-    ContactDetail: string;
-    ContactPoint: string;
-    Contributor: string;
-    Count: string;
-    DataRequirement: string;
-    Distance: string;
-    Dosage: string;
-    Duration: string;
-    Expression: string;
-    Extension: string;
-    HumanName: string;
-    Identifier: string;
-    MarketingStatus: string;
-    Meta: string;
-    Money: string;
-    Narrative: string;
-    ParameterDefinition: string;
-    Period: string;
-    Population: string;
-    ProdCharacteristic: string;
-    ProductShelfLife: string;
-    Quantity: string;
-    Range: string;
-    Ratio: string;
-    Reference: string;
-    RelatedArtifact: string;
-    SampledData: string;
-    Signature: string;
-    SubstanceAmount: string;
-    SystemString: string;
-    Timing: string;
-    TriggerDefinition: string;
-    UsageContext: string;
-    base64Binary: string;
-    boolean: string;
-    canonical: string;
-    code: string;
-    date: string;
-    dateTime: string;
-    decimal: string;
-    id: string;
-    instant: string;
-    integer: string;
-    markdown: string;
-    oid: string;
-    positiveInt: string;
-    string: string;
-    time: string;
-    unsignedInt: string;
-    uri: string;
-    url: string;
-    uuid: string;
+    readonly Address: "Address";
+    readonly Age: "Age";
+    readonly Annotation: "Annotation";
+    readonly Attachment: "Attachment";
+    readonly BackboneElement: "BackboneElement";
+    readonly CodeableConcept: "CodeableConcept";
+    readonly Coding: "Coding";
+    readonly ContactDetail: "ContactDetail";
+    readonly ContactPoint: "ContactPoint";
+    readonly Contributor: "Contributor";
+    readonly Count: "Count";
+    readonly DataRequirement: "DataRequirement";
+    readonly Distance: "Distance";
+    readonly Dosage: "Dosage";
+    readonly Duration: "Duration";
+    readonly Expression: "Expression";
+    readonly Extension: "Extension";
+    readonly HumanName: "HumanName";
+    readonly Identifier: "Identifier";
+    readonly MarketingStatus: "MarketingStatus";
+    readonly Meta: "Meta";
+    readonly Money: "Money";
+    readonly Narrative: "Narrative";
+    readonly ParameterDefinition: "ParameterDefinition";
+    readonly Period: "Period";
+    readonly Population: "Population";
+    readonly ProdCharacteristic: "ProdCharacteristic";
+    readonly ProductShelfLife: "ProductShelfLife";
+    readonly Quantity: "Quantity";
+    readonly Range: "Range";
+    readonly Ratio: "Ratio";
+    readonly Reference: "Reference";
+    readonly RelatedArtifact: "RelatedArtifact";
+    readonly SampledData: "SampledData";
+    readonly Signature: "Signature";
+    readonly SubstanceAmount: "SubstanceAmount";
+    readonly SystemString: "http://hl7.org/fhirpath/System.String";
+    readonly Timing: "Timing";
+    readonly TriggerDefinition: "TriggerDefinition";
+    readonly UsageContext: "UsageContext";
+    readonly base64Binary: "base64Binary";
+    readonly boolean: "boolean";
+    readonly canonical: "canonical";
+    readonly code: "code";
+    readonly date: "date";
+    readonly dateTime: "dateTime";
+    readonly decimal: "decimal";
+    readonly id: "id";
+    readonly instant: "instant";
+    readonly integer: "integer";
+    readonly markdown: "markdown";
+    readonly oid: "oid";
+    readonly positiveInt: "positiveInt";
+    readonly string: "string";
+    readonly time: "time";
+    readonly unsignedInt: "unsignedInt";
+    readonly uri: "uri";
+    readonly url: "url";
+    readonly uuid: "uuid";
 };
 
 /**
@@ -5062,6 +5094,12 @@ export declare type ResourceArray<T extends Resource = Resource> = T[] & {
     bundle: Bundle<T>;
 };
 
+export declare type ResourceCrawlerOptions = {
+    skipMissingProperties?: boolean;
+    schema?: InternalTypeSchema;
+    initialPath?: string;
+};
+
 export declare type ResourceMatchesSubscriptionCriteria = {
     resource: Resource;
     subscription: Subscription;
@@ -5077,7 +5115,7 @@ export declare interface ResourceVisitor {
     onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
     onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
     onExitResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    visitProperty?: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
+    visitProperty: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
 }
 
 export declare type ResourceWithCode = Resource & Code;
@@ -5378,9 +5416,14 @@ export declare class SubscriptionManager {
     private setupWebSocketListeners;
     private emitConnect;
     private emitError;
+    private maybeEmitDisconnect;
     private getTokenForCriteria;
-    addCriteria(criteria: string): SubscriptionEmitter;
-    removeCriteria(criteria: string): void;
+    private maybeGetCriteriaEntry;
+    private getAllCriteriaEmitters;
+    private addCriteriaEntry;
+    private removeCriteriaEntry;
+    addCriteria(criteria: string, subscriptionProps?: Partial<Subscription>): SubscriptionEmitter;
+    removeCriteria(criteria: string, subscriptionProps?: Partial<Subscription>): void;
     closeWebSocket(): void;
     getCriteriaCount(): number;
     getMasterEmitter(): SubscriptionEmitter;

package/dist/esm/index.d.ts

@@ -124,7 +124,7 @@ export declare interface AgentHeartbeatResponse extends BaseAgentMessage {
 
 export declare type AgentMessage = AgentRequestMessage | AgentResponseMessage;
 
-export declare interface AgentReloadConfigRequest extends BaseAgentMessage {
+export declare interface AgentReloadConfigRequest extends BaseAgentRequestMessage {
     type: 'agent:reloadconfig:request';
 }
 
@@ -133,9 +133,9 @@ export declare interface AgentReloadConfigResponse extends BaseAgentMessage {
     statusCode: number;
 }
 
-export declare type AgentRequestMessage = AgentConnectRequest | AgentHeartbeatRequest | AgentTransmitRequest | AgentReloadConfigRequest;
+export declare type AgentRequestMessage = AgentConnectRequest | AgentHeartbeatRequest | AgentTransmitRequest | AgentReloadConfigRequest | AgentUpgradeRequest;
 
-export declare type AgentResponseMessage = AgentConnectResponse | AgentHeartbeatResponse | AgentTransmitResponse | AgentReloadConfigResponse | AgentError;
+export declare type AgentResponseMessage = AgentConnectResponse | AgentHeartbeatResponse | AgentTransmitResponse | AgentReloadConfigResponse | AgentUpgradeResponse | AgentError;
 
 export declare interface AgentTransmitRequest extends BaseAgentRequestMessage {
     type: 'agent:transmit:request';
@@ -154,6 +154,16 @@ export declare interface AgentTransmitResponse extends BaseAgentMessage {
     body: string;
 }
 
+export declare interface AgentUpgradeRequest extends BaseAgentRequestMessage {
+    type: 'agent:upgrade:request';
+    version?: string;
+}
+
+export declare interface AgentUpgradeResponse extends BaseAgentMessage {
+    type: 'agent:upgrade:response';
+    statusCode: number;
+}
+
 export declare const allOk: OperationOutcome;
 
 /**
@@ -233,6 +243,14 @@ export declare function assertContextVersionOptional(event: string): asserts eve
  */
 export declare function assertOk<T>(outcome: OperationOutcome, resource: T | undefined): asserts resource is T;
 
+export declare interface AsyncResourceVisitor {
+    onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
+    onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
+    onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
+    onExitResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
+    visitPropertyAsync: (parent: TypedValueWithPath, key: string, path: string, value: TypedValueWithPath | TypedValueWithPath[], schema: InternalTypeSchema) => Promise<void>;
+}
+
 export declare interface Atom {
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
     toString(): string;
@@ -517,6 +535,8 @@ export declare const CPT = "http://www.ama-assn.org/go/cpt";
 
 export declare function crawlResource(resource: Resource, visitor: ResourceVisitor, schema?: InternalTypeSchema, initialPath?: string): void;
 
+export declare function crawlResource(resource: Resource, visitor: AsyncResourceVisitor, options: ResourceCrawlerOptions): Promise<void>;
+
 /**
  * Binary upload options.
  */
@@ -1587,6 +1607,8 @@ export declare interface GetTypedPropertyValueOptions {
     profileUrl?: string;
 }
 
+export declare function getTypedPropertyValueWithPath(input: TypedValue | TypedValueWithPath, path: string, options?: GetTypedPropertyValueOptions): TypedValueWithPath[] | TypedValueWithPath;
+
 /**
  * Returns the value of the property and the property type using a type schema.
  * @param typedValue - The base context (FHIR resource or backbone element).
@@ -2453,6 +2475,14 @@ export declare interface MailOptions {
     readonly attachments?: MailAttachment[];
 }
 
+/**
+ * Returns a Map of resources from a bundle, using the specified identifier system as the key.
+ * @param resourceBundle - The bundle of resources.
+ * @param identifierSystem - The identifier system to use for keys.
+ * @returns Map of resources keyed by identifier value for the specified system.
+ */
+export declare function mapByIdentifier<T extends Resource = Resource>(resourceBundle: Bundle<T>, identifierSystem: string): Map<string, T>;
+
 export declare interface Marker {
     index: number;
     line: number;
@@ -3987,9 +4017,10 @@ export declare class MedplumClient extends EventTarget_2 {
      *
      * @category Subscriptions
      * @param criteria - The criteria to subscribe to.
+     * @param subscriptionProps - Optional properties to add to the created `Subscription` resource.
      * @returns a `SubscriptionEmitter` that emits `Bundle` resources containing changes to resources based on the given criteria.
      */
-    subscribeToCriteria(criteria: string): SubscriptionEmitter;
+    subscribeToCriteria(criteria: string, subscriptionProps?: Partial<Subscription>): SubscriptionEmitter;
     /**
      * Unsubscribes from the given criteria.
      *
@@ -3998,8 +4029,9 @@ export declare class MedplumClient extends EventTarget_2 {
      *
      * @category Subscriptions
      * @param criteria - The criteria to unsubscribe from.
+     * @param subscriptionProps - The optional properties that `subscribeToCriteria` was called with.
      */
-    unsubscribeFromCriteria(criteria: string): void;
+    unsubscribeFromCriteria(criteria: string, subscriptionProps?: Partial<Subscription>): void;
     /**
      * Get the master `SubscriptionEmitter` for the `SubscriptionManager`.
      *
@@ -4883,65 +4915,65 @@ export declare const projectAdminResourceTypes: string[];
  * The list here includes additions found from StructureDefinition resources.
  */
 export declare const PropertyType: {
-    Address: string;
-    Age: string;
-    Annotation: string;
-    Attachment: string;
-    BackboneElement: string;
-    CodeableConcept: string;
-    Coding: string;
-    ContactDetail: string;
-    ContactPoint: string;
-    Contributor: string;
-    Count: string;
-    DataRequirement: string;
-    Distance: string;
-    Dosage: string;
-    Duration: string;
-    Expression: string;
-    Extension: string;
-    HumanName: string;
-    Identifier: string;
-    MarketingStatus: string;
-    Meta: string;
-    Money: string;
-    Narrative: string;
-    ParameterDefinition: string;
-    Period: string;
-    Population: string;
-    ProdCharacteristic: string;
-    ProductShelfLife: string;
-    Quantity: string;
-    Range: string;
-    Ratio: string;
-    Reference: string;
-    RelatedArtifact: string;
-    SampledData: string;
-    Signature: string;
-    SubstanceAmount: string;
-    SystemString: string;
-    Timing: string;
-    TriggerDefinition: string;
-    UsageContext: string;
-    base64Binary: string;
-    boolean: string;
-    canonical: string;
-    code: string;
-    date: string;
-    dateTime: string;
-    decimal: string;
-    id: string;
-    instant: string;
-    integer: string;
-    markdown: string;
-    oid: string;
-    positiveInt: string;
-    string: string;
-    time: string;
-    unsignedInt: string;
-    uri: string;
-    url: string;
-    uuid: string;
+    readonly Address: "Address";
+    readonly Age: "Age";
+    readonly Annotation: "Annotation";
+    readonly Attachment: "Attachment";
+    readonly BackboneElement: "BackboneElement";
+    readonly CodeableConcept: "CodeableConcept";
+    readonly Coding: "Coding";
+    readonly ContactDetail: "ContactDetail";
+    readonly ContactPoint: "ContactPoint";
+    readonly Contributor: "Contributor";
+    readonly Count: "Count";
+    readonly DataRequirement: "DataRequirement";
+    readonly Distance: "Distance";
+    readonly Dosage: "Dosage";
+    readonly Duration: "Duration";
+    readonly Expression: "Expression";
+    readonly Extension: "Extension";
+    readonly HumanName: "HumanName";
+    readonly Identifier: "Identifier";
+    readonly MarketingStatus: "MarketingStatus";
+    readonly Meta: "Meta";
+    readonly Money: "Money";
+    readonly Narrative: "Narrative";
+    readonly ParameterDefinition: "ParameterDefinition";
+    readonly Period: "Period";
+    readonly Population: "Population";
+    readonly ProdCharacteristic: "ProdCharacteristic";
+    readonly ProductShelfLife: "ProductShelfLife";
+    readonly Quantity: "Quantity";
+    readonly Range: "Range";
+    readonly Ratio: "Ratio";
+    readonly Reference: "Reference";
+    readonly RelatedArtifact: "RelatedArtifact";
+    readonly SampledData: "SampledData";
+    readonly Signature: "Signature";
+    readonly SubstanceAmount: "SubstanceAmount";
+    readonly SystemString: "http://hl7.org/fhirpath/System.String";
+    readonly Timing: "Timing";
+    readonly TriggerDefinition: "TriggerDefinition";
+    readonly UsageContext: "UsageContext";
+    readonly base64Binary: "base64Binary";
+    readonly boolean: "boolean";
+    readonly canonical: "canonical";
+    readonly code: "code";
+    readonly date: "date";
+    readonly dateTime: "dateTime";
+    readonly decimal: "decimal";
+    readonly id: "id";
+    readonly instant: "instant";
+    readonly integer: "integer";
+    readonly markdown: "markdown";
+    readonly oid: "oid";
+    readonly positiveInt: "positiveInt";
+    readonly string: "string";
+    readonly time: "time";
+    readonly unsignedInt: "unsignedInt";
+    readonly uri: "uri";
+    readonly url: "url";
+    readonly uuid: "uuid";
 };
 
 /**
@@ -5062,6 +5094,12 @@ export declare type ResourceArray<T extends Resource = Resource> = T[] & {
     bundle: Bundle<T>;
 };
 
+export declare type ResourceCrawlerOptions = {
+    skipMissingProperties?: boolean;
+    schema?: InternalTypeSchema;
+    initialPath?: string;
+};
+
 export declare type ResourceMatchesSubscriptionCriteria = {
     resource: Resource;
     subscription: Subscription;
@@ -5077,7 +5115,7 @@ export declare interface ResourceVisitor {
     onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
     onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
     onExitResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    visitProperty?: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
+    visitProperty: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
 }
 
 export declare type ResourceWithCode = Resource & Code;
@@ -5378,9 +5416,14 @@ export declare class SubscriptionManager {
     private setupWebSocketListeners;
     private emitConnect;
     private emitError;
+    private maybeEmitDisconnect;
     private getTokenForCriteria;
-    addCriteria(criteria: string): SubscriptionEmitter;
-    removeCriteria(criteria: string): void;
+    private maybeGetCriteriaEntry;
+    private getAllCriteriaEmitters;
+    private addCriteriaEntry;
+    private removeCriteriaEntry;
+    addCriteria(criteria: string, subscriptionProps?: Partial<Subscription>): SubscriptionEmitter;
+    removeCriteria(criteria: string, subscriptionProps?: Partial<Subscription>): void;
     closeWebSocket(): void;
     getCriteriaCount(): number;
     getMasterEmitter(): SubscriptionEmitter;