@medplum/core 3.2.32 → 3.2.33

package/dist/cjs/index.d.ts

@@ -13,13 +13,16 @@ import { Communication } from '@medplum/fhirtypes';
 import { ConceptMap } from '@medplum/fhirtypes';
 import type { CustomTableLayout } from 'pdfmake/interfaces';
 import { Device } from '@medplum/fhirtypes';
+import { DiagnosticReport } from '@medplum/fhirtypes';
 import { ElementDefinition } from '@medplum/fhirtypes';
 import { ElementDefinitionBinding } from '@medplum/fhirtypes';
+import { Encounter } from '@medplum/fhirtypes';
 import { Extension } from '@medplum/fhirtypes';
 import { ExtensionValue } from '@medplum/fhirtypes';
 import { ExtractResource } from '@medplum/fhirtypes';
 import { HumanName } from '@medplum/fhirtypes';
 import { Identifier } from '@medplum/fhirtypes';
+import { ImagingStudy } from '@medplum/fhirtypes';
 import { Media } from '@medplum/fhirtypes';
 import { Money } from '@medplum/fhirtypes';
 import { Observation } from '@medplum/fhirtypes';
@@ -166,6 +169,8 @@ export declare interface AgentUpgradeResponse extends BaseAgentMessage {
 
 export declare const allOk: OperationOutcome;
 
+export declare type AnchorResourceOpenEvent<T extends FhircastAnchorResourceType> = T extends FhircastAnchorResourceType ? `${T}-open` : never;
+
 /**
  * 6.5.1. and
  * Returns true if both operands evaluate to true,
@@ -191,8 +196,6 @@ export declare function append<T>(array: T[] | undefined, value: T): T[];
  */
 export declare function applyDefaultValuesToElement(existingValue: object, elements: Record<string, InternalSchemaElement>, key?: string): object;
 
-export declare function applyDefaultValuesToElementWithVisitor(existingValue: any, path: string, element: InternalSchemaElement, elements: Record<string, InternalSchemaElement>, schema: InternalTypeSchema): any;
-
 /**
  * Adds default values to `resource` based on the supplied `schema`. Default values includes all required fixed and pattern
  * values specified on elements in the schema. If an element has a fixed/pattern value but is optional, i.e.
@@ -562,8 +565,6 @@ export declare function convertContainedResourcesToBundle(resource: Resource & {
  */
 export declare function convertToTransactionBundle(bundle: Bundle): Bundle;
 
-export declare type ConvertToUnion<T> = T[keyof T];
-
 export declare const CPT = "http://www.ama-assn.org/go/cpt";
 
 export declare interface CrawlerOptions {
@@ -675,9 +676,9 @@ export declare const created: OperationOutcome;
  * @param versionId - The current `versionId` of the anchor context. For example, in `DiagnosticReport-update`, it's the `versionId` of the `DiagnosticReport`.
  * @returns A serializable `FhircastMessagePayload`.
  */
-export declare function createFhircastMessagePayload<EventName extends FhircastEventVersionOptional>(topic: string, event: EventName, context: FhircastValidContextForEvent<EventName> | FhircastValidContextForEvent<EventName>[], versionId?: never): FhircastMessagePayload<EventName>;
+export declare function createFhircastMessagePayload<EventName extends FhircastEventVersionOptional>(topic: string, event: EventName, context: FhircastEventContext<EventName> | FhircastEventContext<EventName>[], versionId?: never): FhircastMessagePayload<EventName>;
 
-export declare function createFhircastMessagePayload<EventName extends FhircastEventVersionRequired>(topic: string, event: EventName, context: FhircastValidContextForEvent<EventName> | FhircastValidContextForEvent<EventName>[], versionId: string): FhircastMessagePayload<EventName>;
+export declare function createFhircastMessagePayload<EventName extends FhircastEventVersionRequired>(topic: string, event: EventName, context: FhircastEventContext<EventName> | FhircastEventContext<EventName>[], versionId: string): FhircastMessagePayload<EventName>;
 
 export declare interface CreateMediaOptions extends CreateBinaryOptions {
     /**
@@ -723,11 +724,18 @@ export declare function createReference<T extends Resource>(resource: T): Refere
 
 export declare function createStructureIssue(expression: string, details: string): OperationOutcomeIssue;
 
-export declare type CurrentContext<EventName extends FhircastResourceEventName = FhircastResourceEventName> = {
-    'context.type': ResourceType | '';
-    'context.versionId'?: string;
-    context: FhircastEventContext<EventName>[];
-};
+export declare type CurrentContext<T extends FhircastAnchorResourceType | '' = FhircastAnchorResourceType | ''> = T extends '' ? {
+    'context.type': '';
+    context: never[];
+} : T extends 'DiagnosticReport' ? {
+    'context.type': 'DiagnosticReport';
+    'context.versionId': string;
+    context: (FhircastEventContext<'DiagnosticReport-open'> | FhircastHubContentContext)[];
+} : T extends 'Patient' | 'Encounter' | 'ImagingStudy' ? {
+    'context.type': T;
+    'context.versionId': string;
+    context: FhircastEventContext<AnchorResourceOpenEvent<T>>;
+} : never;
 
 export declare type DataTypesMap = {
     [type: string]: InternalTypeSchema;
@@ -1094,23 +1102,28 @@ export declare const FHIRCAST_EVENT_RESOURCES: {
     readonly 'DiagnosticReport-select': {
         readonly report: {
             readonly resourceType: "DiagnosticReport";
+            readonly reference: true;
+        };
+        readonly patient: {
+            readonly resourceType: "Patient";
+            readonly optional: true;
+            readonly reference: true;
         };
         readonly select: {
             readonly resourceType: "*";
-            readonly isArray: true;
+            readonly array: true;
+            readonly reference: true;
         };
     };
     readonly 'DiagnosticReport-update': {
         readonly report: {
             readonly resourceType: "DiagnosticReport";
+            readonly reference: true;
         };
         readonly patient: {
             readonly resourceType: "Patient";
             readonly optional: true;
-        };
-        readonly study: {
-            readonly resourceType: "ImagingStudy";
-            readonly optional: true;
+            readonly reference: true;
         };
         readonly updates: {
             readonly resourceType: "Bundle";
@@ -1127,6 +1140,8 @@ export declare const FHIRCAST_EVENT_VERSION_REQUIRED: readonly ["DiagnosticRepor
 
 export declare const FHIRCAST_RESOURCE_TYPES: readonly ["Patient", "Encounter", "ImagingStudy", "DiagnosticReport", "OperationOutcome", "Bundle"];
 
+export declare type FhircastAnchorResourceType = 'Patient' | 'ImagingStudy' | 'Encounter' | 'DiagnosticReport';
+
 export declare type FhircastConnectEvent = {
     type: 'connect';
 };
@@ -1152,46 +1167,66 @@ export declare class FhircastConnection extends TypedEventTarget<FhircastSubscri
     disconnect(): void;
 }
 
+export declare type FhircastContextResourceType<EventName extends FhircastEventName, K extends FhircastEventKeys<EventName>> = (typeof FHIRCAST_EVENT_RESOURCES)[EventName][K] extends {
+    resourceType: infer R;
+} ? R : never;
+
+export declare type FhircastDiagnosticReportCloseContext = FhircastDiagnosticReportOpenContext;
+
+export declare type FhircastDiagnosticReportOpenContext = FhircastReportContext | FhircastEncounterContext | FhircastStudyContext | FhircastPatientContext;
+
+export declare type FhircastDiagnosticReportSelectContext = FhircastReportReferenceContext | FhircastPatientReferenceContext | FhircastSelectContext;
+
+export declare type FhircastDiagnosticReportUpdateContext = FhircastReportReferenceContext | FhircastPatientReferenceContext | FhircastUpdatesContext;
+
 export declare type FhircastDisconnectEvent = {
     type: 'disconnect';
 };
 
-export declare type FhircastEventContext<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = FhircastEventContextMap<EventName>[K] extends infer _Ev extends FhircastEventContextDetails ? _Ev['isArray'] extends true ? FhircastMultiResourceContext<EventName, K> : FhircastSingleResourceContext<EventName, K> : never;
+export declare type FhircastEncounterCloseContext = FhircastEncounterOpenContext;
+
+export declare type FhircastEncounterContext = {
+    key: 'encounter';
+    resource: Encounter;
+};
+
+export declare type FhircastEncounterOpenContext = FhircastEncounterContext | FhircastPatientContext;
+
+export declare type FhircastEventContext<EventName extends FhircastEventName = FhircastResourceEventName> = EventName extends 'Patient-open' ? FhircastPatientOpenContext : EventName extends 'Patient-close' ? FhircastPatientCloseContext : EventName extends 'ImagingStudy-open' ? FhircastImagingStudyOpenContext : EventName extends 'ImagingStudy-close' ? FhircastImagingStudyCloseContext : EventName extends 'Encounter-open' ? FhircastEncounterOpenContext : EventName extends 'Encounter-close' ? FhircastEncounterCloseContext : EventName extends 'DiagnosticReport-open' ? FhircastDiagnosticReportOpenContext : EventName extends 'DiagnosticReport-close' ? FhircastDiagnosticReportCloseContext : EventName extends 'DiagnosticReport-update' ? FhircastDiagnosticReportUpdateContext : EventName extends 'DiagnosticReport-select' ? FhircastDiagnosticReportSelectContext : EventName extends 'syncerror' ? FhircastSyncErrorContext : never;
 
 export declare type FhircastEventContextDetails = {
     resourceType: FhircastResourceType | '*';
     optional?: boolean;
     manyAllowed?: boolean;
-    isArray?: boolean;
+    array?: boolean;
+    reference?: boolean;
 };
 
-export declare type FhircastEventContextKey<EventName extends FhircastEventName = FhircastEventName> = keyof FhircastEventContextMap<EventName>;
-
-export declare type FhircastEventContextMap<EventName extends FhircastEventName = FhircastEventName> = (typeof FHIRCAST_EVENT_RESOURCES)[EventName];
+export declare type FhircastEventKeys<EventName extends FhircastEventName> = keyof (typeof FHIRCAST_EVENT_RESOURCES)[EventName];
 
 export declare type FhircastEventName = keyof typeof FHIRCAST_EVENT_NAMES;
 
-export declare type FhircastEventPayload<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = {
+export declare type FhircastEventPayload<EventName extends FhircastEventName = FhircastEventName> = {
     'hub.topic': string;
     'hub.event': EventName;
-    context: FhircastEventContext<EventName, K>[];
+    context: FhircastEventContext<EventName>[];
     'context.versionId'?: string;
     'context.priorVersionId'?: string;
 };
 
-export declare type FhircastEventResource<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = FhircastEventContextMap<EventName>[K] extends infer _Ev extends FhircastEventContextDetails ? FhircastEventResourceType<EventName, K> extends '*' ? Resource & {
-    id: string;
-} : Resource & {
-    resourceType: FhircastEventResourceType<EventName, K>;
-    id: string;
-} : never;
-
-export declare type FhircastEventResourceType<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = FhircastEventContextMap<EventName>[K] extends infer _Ev extends FhircastEventContextDetails ? _Ev['resourceType'] : never;
-
 export declare type FhircastEventVersionOptional = Exclude<FhircastEventName, FhircastEventVersionRequired>;
 
 export declare type FhircastEventVersionRequired = (typeof FHIRCAST_EVENT_VERSION_REQUIRED)[number];
 
+export declare type FhircastHubContentContext = {
+    key: 'content';
+    resource: Bundle;
+};
+
+export declare type FhircastImagingStudyCloseContext = FhircastImagingStudyOpenContext;
+
+export declare type FhircastImagingStudyOpenContext = FhircastStudyContext | FhircastEncounterContext | FhircastPatientContext;
+
 export declare type FhircastMessageEvent = {
     type: 'message';
     payload: FhircastMessagePayload;
@@ -1203,18 +1238,53 @@ export declare type FhircastMessagePayload<EventName extends FhircastEventName =
     event: FhircastEventPayload<EventName>;
 };
 
-export declare type FhircastMultiResourceContext<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = {
-    key: K;
-    resources: FhircastEventResource<EventName, K>[];
+export declare type FhircastMultiReferenceContext = FhircastSelectContext;
+
+export declare type FhircastOperationOutcomeContext = {
+    key: 'operationoutcome';
+    resource: OperationOutcome;
+};
+
+export declare type FhircastPatientCloseContext = FhircastPatientOpenContext;
+
+export declare type FhircastPatientContext = {
+    key: 'patient';
+    resource: Patient;
+};
+
+export declare type FhircastPatientOpenContext = FhircastPatientContext | FhircastEncounterContext;
+
+export declare type FhircastPatientReferenceContext = {
+    key: 'patient';
+    reference: Reference<Patient>;
+};
+
+export declare type FhircastReportContext = {
+    key: 'report';
+    resource: DiagnosticReport;
+};
+
+export declare type FhircastReportReferenceContext = {
+    key: 'report';
+    reference: Reference<DiagnosticReport>;
 };
 
+export declare type FhircastResourceContext = FhircastPatientContext | FhircastEncounterContext | FhircastStudyContext | FhircastReportContext | FhircastUpdatesContext | FhircastOperationOutcomeContext;
+
 export declare type FhircastResourceEventName = Exclude<FhircastEventName, 'syncerror'>;
 
 export declare type FhircastResourceType = (typeof FHIRCAST_RESOURCE_TYPES)[number];
 
-export declare type FhircastSingleResourceContext<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = {
-    key: K;
-    resource: FhircastEventResource<EventName, K>;
+export declare type FhircastSelectContext = {
+    key: 'select';
+    reference: Reference[];
+};
+
+export declare type FhircastSingleReferenceContext = FhircastReportReferenceContext | FhircastPatientReferenceContext;
+
+export declare type FhircastStudyContext = {
+    key: 'study';
+    resource: ImagingStudy;
 };
 
 export declare type FhircastSubscriptionEventMap = {
@@ -1223,9 +1293,12 @@ export declare type FhircastSubscriptionEventMap = {
     disconnect: FhircastDisconnectEvent;
 };
 
-export declare type FhircastValidContextForEvent<EventName extends FhircastEventName = FhircastEventName> = ConvertToUnion<{
-    [key in FhircastEventContextKey<EventName>]: FhircastEventContext<EventName, key>;
-}>;
+export declare type FhircastSyncErrorContext = FhircastOperationOutcomeContext;
+
+export declare type FhircastUpdatesContext = {
+    key: 'updates';
+    resource: Bundle;
+};
 
 /**
  * The FhirFilterComparison class represents a comparison expression.
@@ -3405,6 +3478,26 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @returns A Bundle of all Resources related to the Patient
      */
     readPatientEverything(id: string, options?: MedplumRequestOptions): ReadablePromise<Bundle>;
+    /**
+     * Executes the Patient "summary" operation for a patient.
+     *
+     * @example
+     * Example:
+     *
+     * ```typescript
+     * const bundle = await medplum.readPatientSummary('123');
+     * console.log(bundle);
+     * ```
+     *
+     * See International Patient Summary Implementation Guide: https://build.fhir.org/ig/HL7/fhir-ips/index.html
+     *
+     * See Patient summary operation: https://build.fhir.org/ig/HL7/fhir-ips/OperationDefinition-summary.html
+     *
+     * @param id - The Patient ID.
+     * @param options - Optional fetch options.
+     * @returns A patient summary bundle, organized into the patient summary sections.
+     */
+    readPatientSummary(id: string, options?: MedplumRequestOptions): ReadablePromise<Bundle>;
     /**
      * Creates a new FHIR resource.
      *
@@ -4008,6 +4101,15 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @returns The key value client.
      */
     get keyValue(): MedplumKeyValueClient;
+    /**
+     * Internal helper method to get a bundle from a URL.
+     * In addition to returning the bundle, it also caches all of the resources in the bundle.
+     * This should be used by any method that returns a bundle of resources to be cached.
+     * @param url - The bundle URL.
+     * @param options - Optional fetch options.
+     * @returns Promise to the bundle.
+     */
+    private getBundle;
     /**
      * Returns the cache entry if available and not expired.
      * @param key - The cache key to retrieve.

package/dist/esm/index.d.ts

@@ -13,13 +13,16 @@ import { Communication } from '@medplum/fhirtypes';
 import { ConceptMap } from '@medplum/fhirtypes';
 import type { CustomTableLayout } from 'pdfmake/interfaces';
 import { Device } from '@medplum/fhirtypes';
+import { DiagnosticReport } from '@medplum/fhirtypes';
 import { ElementDefinition } from '@medplum/fhirtypes';
 import { ElementDefinitionBinding } from '@medplum/fhirtypes';
+import { Encounter } from '@medplum/fhirtypes';
 import { Extension } from '@medplum/fhirtypes';
 import { ExtensionValue } from '@medplum/fhirtypes';
 import { ExtractResource } from '@medplum/fhirtypes';
 import { HumanName } from '@medplum/fhirtypes';
 import { Identifier } from '@medplum/fhirtypes';
+import { ImagingStudy } from '@medplum/fhirtypes';
 import { Media } from '@medplum/fhirtypes';
 import { Money } from '@medplum/fhirtypes';
 import { Observation } from '@medplum/fhirtypes';
@@ -166,6 +169,8 @@ export declare interface AgentUpgradeResponse extends BaseAgentMessage {
 
 export declare const allOk: OperationOutcome;
 
+export declare type AnchorResourceOpenEvent<T extends FhircastAnchorResourceType> = T extends FhircastAnchorResourceType ? `${T}-open` : never;
+
 /**
  * 6.5.1. and
  * Returns true if both operands evaluate to true,
@@ -191,8 +196,6 @@ export declare function append<T>(array: T[] | undefined, value: T): T[];
  */
 export declare function applyDefaultValuesToElement(existingValue: object, elements: Record<string, InternalSchemaElement>, key?: string): object;
 
-export declare function applyDefaultValuesToElementWithVisitor(existingValue: any, path: string, element: InternalSchemaElement, elements: Record<string, InternalSchemaElement>, schema: InternalTypeSchema): any;
-
 /**
  * Adds default values to `resource` based on the supplied `schema`. Default values includes all required fixed and pattern
  * values specified on elements in the schema. If an element has a fixed/pattern value but is optional, i.e.
@@ -562,8 +565,6 @@ export declare function convertContainedResourcesToBundle(resource: Resource & {
  */
 export declare function convertToTransactionBundle(bundle: Bundle): Bundle;
 
-export declare type ConvertToUnion<T> = T[keyof T];
-
 export declare const CPT = "http://www.ama-assn.org/go/cpt";
 
 export declare interface CrawlerOptions {
@@ -675,9 +676,9 @@ export declare const created: OperationOutcome;
  * @param versionId - The current `versionId` of the anchor context. For example, in `DiagnosticReport-update`, it's the `versionId` of the `DiagnosticReport`.
  * @returns A serializable `FhircastMessagePayload`.
  */
-export declare function createFhircastMessagePayload<EventName extends FhircastEventVersionOptional>(topic: string, event: EventName, context: FhircastValidContextForEvent<EventName> | FhircastValidContextForEvent<EventName>[], versionId?: never): FhircastMessagePayload<EventName>;
+export declare function createFhircastMessagePayload<EventName extends FhircastEventVersionOptional>(topic: string, event: EventName, context: FhircastEventContext<EventName> | FhircastEventContext<EventName>[], versionId?: never): FhircastMessagePayload<EventName>;
 
-export declare function createFhircastMessagePayload<EventName extends FhircastEventVersionRequired>(topic: string, event: EventName, context: FhircastValidContextForEvent<EventName> | FhircastValidContextForEvent<EventName>[], versionId: string): FhircastMessagePayload<EventName>;
+export declare function createFhircastMessagePayload<EventName extends FhircastEventVersionRequired>(topic: string, event: EventName, context: FhircastEventContext<EventName> | FhircastEventContext<EventName>[], versionId: string): FhircastMessagePayload<EventName>;
 
 export declare interface CreateMediaOptions extends CreateBinaryOptions {
     /**
@@ -723,11 +724,18 @@ export declare function createReference<T extends Resource>(resource: T): Refere
 
 export declare function createStructureIssue(expression: string, details: string): OperationOutcomeIssue;
 
-export declare type CurrentContext<EventName extends FhircastResourceEventName = FhircastResourceEventName> = {
-    'context.type': ResourceType | '';
-    'context.versionId'?: string;
-    context: FhircastEventContext<EventName>[];
-};
+export declare type CurrentContext<T extends FhircastAnchorResourceType | '' = FhircastAnchorResourceType | ''> = T extends '' ? {
+    'context.type': '';
+    context: never[];
+} : T extends 'DiagnosticReport' ? {
+    'context.type': 'DiagnosticReport';
+    'context.versionId': string;
+    context: (FhircastEventContext<'DiagnosticReport-open'> | FhircastHubContentContext)[];
+} : T extends 'Patient' | 'Encounter' | 'ImagingStudy' ? {
+    'context.type': T;
+    'context.versionId': string;
+    context: FhircastEventContext<AnchorResourceOpenEvent<T>>;
+} : never;
 
 export declare type DataTypesMap = {
     [type: string]: InternalTypeSchema;
@@ -1094,23 +1102,28 @@ export declare const FHIRCAST_EVENT_RESOURCES: {
     readonly 'DiagnosticReport-select': {
         readonly report: {
             readonly resourceType: "DiagnosticReport";
+            readonly reference: true;
+        };
+        readonly patient: {
+            readonly resourceType: "Patient";
+            readonly optional: true;
+            readonly reference: true;
         };
         readonly select: {
             readonly resourceType: "*";
-            readonly isArray: true;
+            readonly array: true;
+            readonly reference: true;
         };
     };
     readonly 'DiagnosticReport-update': {
         readonly report: {
             readonly resourceType: "DiagnosticReport";
+            readonly reference: true;
         };
         readonly patient: {
             readonly resourceType: "Patient";
             readonly optional: true;
-        };
-        readonly study: {
-            readonly resourceType: "ImagingStudy";
-            readonly optional: true;
+            readonly reference: true;
         };
         readonly updates: {
             readonly resourceType: "Bundle";
@@ -1127,6 +1140,8 @@ export declare const FHIRCAST_EVENT_VERSION_REQUIRED: readonly ["DiagnosticRepor
 
 export declare const FHIRCAST_RESOURCE_TYPES: readonly ["Patient", "Encounter", "ImagingStudy", "DiagnosticReport", "OperationOutcome", "Bundle"];
 
+export declare type FhircastAnchorResourceType = 'Patient' | 'ImagingStudy' | 'Encounter' | 'DiagnosticReport';
+
 export declare type FhircastConnectEvent = {
     type: 'connect';
 };
@@ -1152,46 +1167,66 @@ export declare class FhircastConnection extends TypedEventTarget<FhircastSubscri
     disconnect(): void;
 }
 
+export declare type FhircastContextResourceType<EventName extends FhircastEventName, K extends FhircastEventKeys<EventName>> = (typeof FHIRCAST_EVENT_RESOURCES)[EventName][K] extends {
+    resourceType: infer R;
+} ? R : never;
+
+export declare type FhircastDiagnosticReportCloseContext = FhircastDiagnosticReportOpenContext;
+
+export declare type FhircastDiagnosticReportOpenContext = FhircastReportContext | FhircastEncounterContext | FhircastStudyContext | FhircastPatientContext;
+
+export declare type FhircastDiagnosticReportSelectContext = FhircastReportReferenceContext | FhircastPatientReferenceContext | FhircastSelectContext;
+
+export declare type FhircastDiagnosticReportUpdateContext = FhircastReportReferenceContext | FhircastPatientReferenceContext | FhircastUpdatesContext;
+
 export declare type FhircastDisconnectEvent = {
     type: 'disconnect';
 };
 
-export declare type FhircastEventContext<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = FhircastEventContextMap<EventName>[K] extends infer _Ev extends FhircastEventContextDetails ? _Ev['isArray'] extends true ? FhircastMultiResourceContext<EventName, K> : FhircastSingleResourceContext<EventName, K> : never;
+export declare type FhircastEncounterCloseContext = FhircastEncounterOpenContext;
+
+export declare type FhircastEncounterContext = {
+    key: 'encounter';
+    resource: Encounter;
+};
+
+export declare type FhircastEncounterOpenContext = FhircastEncounterContext | FhircastPatientContext;
+
+export declare type FhircastEventContext<EventName extends FhircastEventName = FhircastResourceEventName> = EventName extends 'Patient-open' ? FhircastPatientOpenContext : EventName extends 'Patient-close' ? FhircastPatientCloseContext : EventName extends 'ImagingStudy-open' ? FhircastImagingStudyOpenContext : EventName extends 'ImagingStudy-close' ? FhircastImagingStudyCloseContext : EventName extends 'Encounter-open' ? FhircastEncounterOpenContext : EventName extends 'Encounter-close' ? FhircastEncounterCloseContext : EventName extends 'DiagnosticReport-open' ? FhircastDiagnosticReportOpenContext : EventName extends 'DiagnosticReport-close' ? FhircastDiagnosticReportCloseContext : EventName extends 'DiagnosticReport-update' ? FhircastDiagnosticReportUpdateContext : EventName extends 'DiagnosticReport-select' ? FhircastDiagnosticReportSelectContext : EventName extends 'syncerror' ? FhircastSyncErrorContext : never;
 
 export declare type FhircastEventContextDetails = {
     resourceType: FhircastResourceType | '*';
     optional?: boolean;
     manyAllowed?: boolean;
-    isArray?: boolean;
+    array?: boolean;
+    reference?: boolean;
 };
 
-export declare type FhircastEventContextKey<EventName extends FhircastEventName = FhircastEventName> = keyof FhircastEventContextMap<EventName>;
-
-export declare type FhircastEventContextMap<EventName extends FhircastEventName = FhircastEventName> = (typeof FHIRCAST_EVENT_RESOURCES)[EventName];
+export declare type FhircastEventKeys<EventName extends FhircastEventName> = keyof (typeof FHIRCAST_EVENT_RESOURCES)[EventName];
 
 export declare type FhircastEventName = keyof typeof FHIRCAST_EVENT_NAMES;
 
-export declare type FhircastEventPayload<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = {
+export declare type FhircastEventPayload<EventName extends FhircastEventName = FhircastEventName> = {
     'hub.topic': string;
     'hub.event': EventName;
-    context: FhircastEventContext<EventName, K>[];
+    context: FhircastEventContext<EventName>[];
     'context.versionId'?: string;
     'context.priorVersionId'?: string;
 };
 
-export declare type FhircastEventResource<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = FhircastEventContextMap<EventName>[K] extends infer _Ev extends FhircastEventContextDetails ? FhircastEventResourceType<EventName, K> extends '*' ? Resource & {
-    id: string;
-} : Resource & {
-    resourceType: FhircastEventResourceType<EventName, K>;
-    id: string;
-} : never;
-
-export declare type FhircastEventResourceType<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = FhircastEventContextMap<EventName>[K] extends infer _Ev extends FhircastEventContextDetails ? _Ev['resourceType'] : never;
-
 export declare type FhircastEventVersionOptional = Exclude<FhircastEventName, FhircastEventVersionRequired>;
 
 export declare type FhircastEventVersionRequired = (typeof FHIRCAST_EVENT_VERSION_REQUIRED)[number];
 
+export declare type FhircastHubContentContext = {
+    key: 'content';
+    resource: Bundle;
+};
+
+export declare type FhircastImagingStudyCloseContext = FhircastImagingStudyOpenContext;
+
+export declare type FhircastImagingStudyOpenContext = FhircastStudyContext | FhircastEncounterContext | FhircastPatientContext;
+
 export declare type FhircastMessageEvent = {
     type: 'message';
     payload: FhircastMessagePayload;
@@ -1203,18 +1238,53 @@ export declare type FhircastMessagePayload<EventName extends FhircastEventName =
     event: FhircastEventPayload<EventName>;
 };
 
-export declare type FhircastMultiResourceContext<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = {
-    key: K;
-    resources: FhircastEventResource<EventName, K>[];
+export declare type FhircastMultiReferenceContext = FhircastSelectContext;
+
+export declare type FhircastOperationOutcomeContext = {
+    key: 'operationoutcome';
+    resource: OperationOutcome;
+};
+
+export declare type FhircastPatientCloseContext = FhircastPatientOpenContext;
+
+export declare type FhircastPatientContext = {
+    key: 'patient';
+    resource: Patient;
+};
+
+export declare type FhircastPatientOpenContext = FhircastPatientContext | FhircastEncounterContext;
+
+export declare type FhircastPatientReferenceContext = {
+    key: 'patient';
+    reference: Reference<Patient>;
+};
+
+export declare type FhircastReportContext = {
+    key: 'report';
+    resource: DiagnosticReport;
+};
+
+export declare type FhircastReportReferenceContext = {
+    key: 'report';
+    reference: Reference<DiagnosticReport>;
 };
 
+export declare type FhircastResourceContext = FhircastPatientContext | FhircastEncounterContext | FhircastStudyContext | FhircastReportContext | FhircastUpdatesContext | FhircastOperationOutcomeContext;
+
 export declare type FhircastResourceEventName = Exclude<FhircastEventName, 'syncerror'>;
 
 export declare type FhircastResourceType = (typeof FHIRCAST_RESOURCE_TYPES)[number];
 
-export declare type FhircastSingleResourceContext<EventName extends FhircastEventName = FhircastEventName, K extends FhircastEventContextKey<EventName> = FhircastEventContextKey<EventName>> = {
-    key: K;
-    resource: FhircastEventResource<EventName, K>;
+export declare type FhircastSelectContext = {
+    key: 'select';
+    reference: Reference[];
+};
+
+export declare type FhircastSingleReferenceContext = FhircastReportReferenceContext | FhircastPatientReferenceContext;
+
+export declare type FhircastStudyContext = {
+    key: 'study';
+    resource: ImagingStudy;
 };
 
 export declare type FhircastSubscriptionEventMap = {
@@ -1223,9 +1293,12 @@ export declare type FhircastSubscriptionEventMap = {
     disconnect: FhircastDisconnectEvent;
 };
 
-export declare type FhircastValidContextForEvent<EventName extends FhircastEventName = FhircastEventName> = ConvertToUnion<{
-    [key in FhircastEventContextKey<EventName>]: FhircastEventContext<EventName, key>;
-}>;
+export declare type FhircastSyncErrorContext = FhircastOperationOutcomeContext;
+
+export declare type FhircastUpdatesContext = {
+    key: 'updates';
+    resource: Bundle;
+};
 
 /**
  * The FhirFilterComparison class represents a comparison expression.
@@ -3405,6 +3478,26 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @returns A Bundle of all Resources related to the Patient
      */
     readPatientEverything(id: string, options?: MedplumRequestOptions): ReadablePromise<Bundle>;
+    /**
+     * Executes the Patient "summary" operation for a patient.
+     *
+     * @example
+     * Example:
+     *
+     * ```typescript
+     * const bundle = await medplum.readPatientSummary('123');
+     * console.log(bundle);
+     * ```
+     *
+     * See International Patient Summary Implementation Guide: https://build.fhir.org/ig/HL7/fhir-ips/index.html
+     *
+     * See Patient summary operation: https://build.fhir.org/ig/HL7/fhir-ips/OperationDefinition-summary.html
+     *
+     * @param id - The Patient ID.
+     * @param options - Optional fetch options.
+     * @returns A patient summary bundle, organized into the patient summary sections.
+     */
+    readPatientSummary(id: string, options?: MedplumRequestOptions): ReadablePromise<Bundle>;
     /**
      * Creates a new FHIR resource.
      *
@@ -4008,6 +4101,15 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @returns The key value client.
      */
     get keyValue(): MedplumKeyValueClient;
+    /**
+     * Internal helper method to get a bundle from a URL.
+     * In addition to returning the bundle, it also caches all of the resources in the bundle.
+     * This should be used by any method that returns a bundle of resources to be cached.
+     * @param url - The bundle URL.
+     * @param options - Optional fetch options.
+     * @returns Promise to the bundle.
+     */
+    private getBundle;
     /**
      * Returns the cache entry if available and not expired.
      * @param key - The cache key to retrieve.