@medplum/core 3.3.0 → 4.0.1

package/dist/esm/index.d.ts

@@ -262,9 +262,6 @@ export declare interface AsyncCrawlerVisitor {
     visitPropertyAsync: (parent: TypedValueWithPath, key: string, path: string, value: TypedValueWithPath | TypedValueWithPath[], schema: InternalTypeSchema) => Promise<void>;
 }
 
-/** @deprecated - Use AsyncCrawlerVisitor instead */
-export declare type AsyncResourceVisitor = AsyncCrawlerVisitor;
-
 export declare interface Atom {
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
     toString(): string;
@@ -581,45 +578,6 @@ export declare interface CrawlerVisitor {
     visitProperty: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
 }
 
-/**
- * Crawls the resource synchronously.
- * @param resource - The resource to crawl.
- * @param visitor - The visitor functions to apply while crawling.
- * @param schema - The schema to use for the resource.
- * @param initialPath - The path within the resource form which to start crawling.
- * @deprecated - Use crawlTypedValue instead
- */
-export declare function crawlResource(resource: Resource, visitor: CrawlerVisitor, schema?: InternalTypeSchema, initialPath?: string): void;
-
-/**
- * Crawls the resource asynchronously.
- * @param resource - The resource to crawl.
- * @param visitor - The visitor functions to apply while crawling.
- * @param options - Options for how to crawl the resource.
- * @returns void
- * @deprecated - Use crawlTypedValueAsync instead
- */
-export declare function crawlResource(resource: Resource, visitor: AsyncCrawlerVisitor, options: CrawlerOptions): Promise<void>;
-
-/**
- * Crawls the resource synchronously.
- * @param resource - The resource to crawl.
- * @param visitor - The visitor functions to apply while crawling.
- * @param options - Options for how to crawl the resource.
- * @deprecated - Use crawlTypedValue instead
- */
-export declare function crawlResource(resource: Resource, visitor: CrawlerVisitor, options?: CrawlerOptions): void;
-
-/**
- * Crawls the resource asynchronously.
- * @param resource - The resource to crawl.
- * @param visitor - The visitor functions to apply while crawling.
- * @param options - Options for how to crawl the resource.
- * @returns Promise
- * @deprecated - Use crawlTypedValueAsync instead
- */
-export declare function crawlResourceAsync(resource: Resource, visitor: AsyncCrawlerVisitor, options: CrawlerOptions): Promise<void>;
-
 /**
  * Crawls the typed value synchronously.
  * @param typedValue - The typed value to crawl.
@@ -1111,8 +1069,8 @@ export declare const FHIRCAST_EVENT_RESOURCES: {
         };
         readonly select: {
             readonly resourceType: "*";
-            readonly array: true;
             readonly reference: true;
+            readonly manyAllowed: true;
         };
     };
     readonly 'DiagnosticReport-update': {
@@ -1157,8 +1115,8 @@ export declare type FhircastConnectEvent = {
  * To close the connection, call `connection.disconnect()` and listen to the `disconnect` event to know when the connection has been disconnected.
  */
 export declare class FhircastConnection extends TypedEventTarget<FhircastSubscriptionEventMap> {
-    subRequest: SubscriptionRequest;
-    private websocket;
+    readonly subRequest: SubscriptionRequest;
+    private readonly websocket;
     /**
      * Creates a new `FhircastConnection`.
      * @param subRequest - The subscription request to initialize the connection from.
@@ -1238,8 +1196,6 @@ export declare type FhircastMessagePayload<EventName extends FhircastEventName =
     event: FhircastEventPayload<EventName>;
 };
 
-export declare type FhircastMultiReferenceContext = FhircastSelectContext;
-
 export declare type FhircastOperationOutcomeContext = {
     key: 'operationoutcome';
     resource: OperationOutcome;
@@ -1259,6 +1215,8 @@ export declare type FhircastPatientReferenceContext = {
     reference: Reference<Patient>;
 };
 
+export declare type FhircastReferenceContext = FhircastReportReferenceContext | FhircastPatientReferenceContext | FhircastSelectContext;
+
 export declare type FhircastReportContext = {
     key: 'report';
     resource: DiagnosticReport;
@@ -1277,11 +1235,9 @@ export declare type FhircastResourceType = (typeof FHIRCAST_RESOURCE_TYPES)[numb
 
 export declare type FhircastSelectContext = {
     key: 'select';
-    reference: Reference[];
+    reference: Reference;
 };
 
-export declare type FhircastSingleReferenceContext = FhircastReportReferenceContext | FhircastPatientReferenceContext;
-
 export declare type FhircastStudyContext = {
     key: 'study';
     resource: ImagingStudy;
@@ -1454,10 +1410,19 @@ export declare function findObservationInterval(definition: ObservationDefinitio
  * Tries to find an observation reference range for the given patient and condition names.
  * @param definition - The observation definition.
  * @param patient - The patient.
- * @param names - The condition names.
+ * @param names - Optional condition names.
  * @returns The observation interval if found; otherwise undefined.
  */
-export declare function findObservationReferenceRange(definition: ObservationDefinition, patient: Patient, names: string[]): ObservationDefinitionQualifiedInterval | undefined;
+export declare function findObservationReferenceRange(definition: ObservationDefinition, patient: Patient, names?: string[]): ObservationDefinitionQualifiedInterval | undefined;
+
+/**
+ * Returns all matching observation reference range for the given patient and condition names.
+ * @param definition - The observation definition.
+ * @param patient - The patient.
+ * @param names - Optional condition names.
+ * @returns The observation intervals if found; otherwise an empty array.
+ */
+export declare function findObservationReferenceRanges(definition: ObservationDefinition, patient: Patient, names?: string[]): ObservationDefinitionQualifiedInterval[];
 
 /**
  * Finds the first resource in the input array that matches the specified code and system.
@@ -1786,7 +1751,11 @@ export declare function getRandomString(): string;
  * @param input - The FHIR resource or reference.
  * @returns A reference string of the form resourceType/id.
  */
-export declare function getReferenceString(input: Reference | Resource): string;
+export declare function getReferenceString(input: (Reference & {
+    reference: string;
+}) | WithId<Resource>): string;
+
+export declare function getReferenceString(input: Reference | Resource): string | undefined;
 
 /**
  * Returns an array of all resource types.
@@ -2452,7 +2421,7 @@ export declare function isQuantityEquivalent(x: Quantity, y: Quantity): boolean;
 export declare function isRedirect(outcome: OperationOutcome): boolean;
 
 /**
- * Typeguard to validate that an object is a FHIR resource
+ * Type guard to validate that an object is a FHIR reference
  * @param value - The object to check
  * @returns True if the input is of type 'object' and contains property 'reference'
  */
@@ -2461,11 +2430,12 @@ export declare function isReference(value: unknown): value is Reference & {
 };
 
 /**
- * Typeguard to validate that an object is a FHIR resource
+ * Type guard to validate that an object is a FHIR resource
  * @param value - The object to check
+ * @param resourceType - Checks that the resource is of the given type
  * @returns True if the input is of type 'object' and contains property 'resourceType'
  */
-export declare function isResource(value: unknown): value is Resource;
+export declare function isResource<T extends Resource>(value: unknown, resourceType?: T['resourceType']): value is T;
 
 /**
  * Returns true if the given string is a valid FHIR resource type.
@@ -2488,6 +2458,8 @@ export declare function isResourceType(resourceType: string): boolean;
  */
 export declare function isResourceTypeSchema(typeSchema: InternalTypeSchema): boolean;
 
+export declare function isResourceWithId<T extends Resource>(resource: unknown, resourceType?: T['resourceType']): resource is WithId<T>;
+
 export declare function isSliceDefinitionWithTypes(slice: SliceDefinition): slice is SliceDefinitionWithTypes;
 
 /**
@@ -2613,6 +2585,50 @@ export declare type IWebSocketEventMap = {
     open: Event;
 };
 
+/**
+ * Recognized JWT Claims Set members, any other members may also be present.
+ * @see {@link https://github.com/panva/jose/blob/main/src/types.d.ts#L532}
+ */
+export declare interface JWTPayload {
+    /**
+     * JWT Issuer
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.1|RFC7519#section-4.1.1}
+     */
+    iss?: string;
+    /**
+     * JWT Subject
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.2|RFC7519#section-4.1.2}
+     */
+    sub?: string;
+    /**
+     * JWT Audience
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.3|RFC7519#section-4.1.3}
+     */
+    aud?: string | string[];
+    /**
+     * JWT ID
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.7|RFC7519#section-4.1.7}
+     */
+    jti?: string;
+    /**
+     * JWT Not Before
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.5|RFC7519#section-4.1.5}
+     */
+    nbf?: number;
+    /**
+     * JWT Expiration Time
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.4|RFC7519#section-4.1.4}
+     */
+    exp?: number;
+    /**
+     * JWT Issued At
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.6|RFC7519#section-4.1.6}
+     */
+    iat?: number;
+    /** Any other JWT Claim Set member. */
+    [propName: string]: unknown;
+}
+
 /**
  * Memoizes the result of a parameterless function
  * @param fn - The function to be wrapped
@@ -2806,16 +2822,6 @@ export declare interface Marker {
 
 export declare function matchDiscriminant(value: TypedValue | TypedValue[] | undefined, discriminator: SliceDiscriminator, slice: SliceDefinition, elements?: Record<string, InternalSchemaElement>): boolean;
 
-/**
- * Returns true if the resource satisfies the current access policy.
- * @param accessPolicy - The access policy.
- * @param resource - The resource.
- * @param readonlyMode - True if the resource is being read.
- * @returns True if the resource matches the access policy.
- * @deprecated Use satisfiedAccessPolicy() instead.
- */
-export declare function matchesAccessPolicy(accessPolicy: AccessPolicy, resource: Resource, readonlyMode: boolean): boolean;
-
 /**
  * Returns true if the value is in the range accounting for precision.
  * @param value - The numeric value.
@@ -2918,6 +2924,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     private medplumServer?;
     private clientId?;
     private clientSecret?;
+    private credentialsInHeader;
     private autoBatchTimerId?;
     private accessToken?;
     private accessTokenExpires?;
@@ -3014,7 +3021,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @category Caching
      * @param resourceType - The resource type to invalidate.
      */
-    invalidateSearches<K extends ResourceType>(resourceType: K): void;
+    invalidateSearches(resourceType: ResourceType): void;
     /**
      * Makes an HTTP GET request to the specified URL.
      *
@@ -3255,7 +3262,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns Promise to the search result bundle.
      */
-    search<K extends ResourceType>(resourceType: K, query?: QueryTypes, options?: MedplumRequestOptions): ReadablePromise<Bundle<ExtractResource<K>>>;
+    search<RT extends ResourceType>(resourceType: RT, query?: QueryTypes, options?: MedplumRequestOptions): ReadablePromise<Bundle<WithId<ExtractResource<RT>>>>;
     /**
      * Sends a FHIR search request for a single resource.
      *
@@ -3278,7 +3285,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns Promise to the first search result.
      */
-    searchOne<K extends ResourceType>(resourceType: K, query?: QueryTypes, options?: MedplumRequestOptions): ReadablePromise<ExtractResource<K> | undefined>;
+    searchOne<RT extends ResourceType>(resourceType: RT, query?: QueryTypes, options?: MedplumRequestOptions): ReadablePromise<WithId<ExtractResource<RT>> | undefined>;
     /**
      * Sends a FHIR search request for an array of resources.
      *
@@ -3301,7 +3308,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns Promise to the array of search results.
      */
-    searchResources<K extends ResourceType>(resourceType: K, query?: QueryTypes, options?: MedplumRequestOptions): ReadablePromise<ResourceArray<ExtractResource<K>>>;
+    searchResources<RT extends ResourceType>(resourceType: RT, query?: QueryTypes, options?: MedplumRequestOptions): ReadablePromise<ResourceArray<WithId<ExtractResource<RT>>>>;
     /**
      * Creates an
      * [async generator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator)
@@ -3326,18 +3333,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @yields An async generator, where each result is an array of resources for each page.
      */
-    searchResourcePages<K extends ResourceType>(resourceType: K, query?: QueryTypes, options?: MedplumRequestOptions): AsyncGenerator<ResourceArray<ExtractResource<K>>>;
-    /**
-     * Searches a ValueSet resource using the "expand" operation.
-     * See: https://www.hl7.org/fhir/operation-valueset-expand.html
-     * @category Search
-     * @param system - The ValueSet system url.
-     * @param filter - The search string.
-     * @param options - Optional fetch options.
-     * @returns Promise to expanded ValueSet.
-     * @deprecated Use `valueSetExpand()` instead.
-     */
-    searchValueSet(system: string, filter: string, options?: MedplumRequestOptions): ReadablePromise<ValueSet>;
+    searchResourcePages<RT extends ResourceType>(resourceType: RT, query?: QueryTypes, options?: MedplumRequestOptions): AsyncGenerator<ResourceArray<WithId<ExtractResource<RT>>>>;
     /**
      * Searches a ValueSet resource using the "expand" operation.
      * See: https://www.hl7.org/fhir/operation-valueset-expand.html
@@ -3354,7 +3350,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param id - The FHIR resource ID.
      * @returns The resource if it is available in the cache; undefined otherwise.
      */
-    getCached<K extends ResourceType>(resourceType: K, id: string): ExtractResource<K> | undefined;
+    getCached<RT extends ResourceType>(resourceType: RT, id: string): WithId<ExtractResource<RT>> | undefined;
     /**
      * Returns a cached resource if it is available.
      * @category Caching
@@ -3380,7 +3376,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns The resource if available.
      */
-    readResource<K extends ResourceType>(resourceType: K, id: string, options?: MedplumRequestOptions): ReadablePromise<ExtractResource<K>>;
+    readResource<RT extends ResourceType>(resourceType: RT, id: string, options?: MedplumRequestOptions): ReadablePromise<WithId<ExtractResource<RT>>>;
     /**
      * Reads a resource by `Reference`.
      *
@@ -3401,7 +3397,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns The resource if available.
      */
-    readReference<T extends Resource>(reference: Reference<T>, options?: MedplumRequestOptions): ReadablePromise<T>;
+    readReference<T extends Resource>(reference: Reference<T>, options?: MedplumRequestOptions): ReadablePromise<WithId<T>>;
     /**
      * Requests the schema for a resource type.
      * If the schema is already cached, the promise is resolved immediately.
@@ -3439,7 +3435,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns Promise to the resource history.
      */
-    readHistory<K extends ResourceType>(resourceType: K, id: string, options?: MedplumRequestOptions): ReadablePromise<Bundle<ExtractResource<K>>>;
+    readHistory<RT extends ResourceType>(resourceType: RT, id: string, options?: MedplumRequestOptions): ReadablePromise<Bundle<WithId<ExtractResource<RT>>>>;
     /**
      * Reads a specific version of a resource by resource type, ID, and version ID.
      *
@@ -3459,7 +3455,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns The resource if available.
      */
-    readVersion<K extends ResourceType>(resourceType: K, id: string, vid: string, options?: MedplumRequestOptions): ReadablePromise<ExtractResource<K>>;
+    readVersion<RT extends ResourceType>(resourceType: RT, id: string, vid: string, options?: MedplumRequestOptions): ReadablePromise<WithId<ExtractResource<RT>>>;
     /**
      * Executes the Patient "everything" operation for a patient.
      *
@@ -3523,7 +3519,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns The result of the create operation.
      */
-    createResource<T extends Resource>(resource: T, options?: MedplumRequestOptions): Promise<T>;
+    createResource<T extends Resource>(resource: T, options?: MedplumRequestOptions): Promise<WithId<T>>;
     /**
      * Conditionally create a new FHIR resource only if some equivalent resource does not already exist on the server.
      *
@@ -3565,7 +3561,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns The result of the create operation.
      */
-    createResourceIfNoneExist<T extends Resource>(resource: T, query: string, options?: MedplumRequestOptions): Promise<T>;
+    createResourceIfNoneExist<T extends Resource>(resource: T, query: string, options?: MedplumRequestOptions): Promise<WithId<T>>;
     /**
      * Upsert a resource: update it in place if it exists, otherwise create it.  This is done in a single, transactional
      * request to guarantee data consistency.
@@ -3574,7 +3570,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options  - Optional fetch options.
      * @returns The updated/created resource.
      */
-    upsertResource<T extends Resource>(resource: T, query: QueryTypes, options?: MedplumRequestOptions): Promise<T>;
+    upsertResource<T extends Resource>(resource: T, query: QueryTypes, options?: MedplumRequestOptions): Promise<WithId<T>>;
     /**
      * Creates a FHIR `Attachment` with the provided data content.
      *
@@ -3607,7 +3603,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param onProgress - Optional callback for progress events. **NOTE:** only `options.signal` is respected when `onProgress` is also provided.
      * @param options - Optional fetch options. **NOTE:** only `options.signal` is respected when `onProgress` is also provided.
      * @returns The result of the create operation.
-     * @deprecated Use `createAttachment` with `CreateBinaryOptions` instead. To be removed in Medplum 4.0.
+     * @deprecated Use `createAttachment` with `CreateBinaryOptions` instead. To be removed in a future version.
      */
     createAttachment(data: BinarySource, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void, options?: MedplumRequestOptions): Promise<Attachment>;
     /**
@@ -3634,7 +3630,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param requestOptions - Optional fetch options. **NOTE:** only `options.signal` is respected when `onProgress` is also provided.
      * @returns The result of the create operation.
      */
-    createBinary(createBinaryOptions: CreateBinaryOptions, requestOptions?: MedplumRequestOptions): Promise<Binary>;
+    createBinary(createBinaryOptions: CreateBinaryOptions, requestOptions?: MedplumRequestOptions): Promise<WithId<Binary>>;
     /**
      * @category Create
      * @param data - The binary data to upload.
@@ -3643,9 +3639,9 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param onProgress - Optional callback for progress events. **NOTE:** only `options.signal` is respected when `onProgress` is also provided.
      * @param options - Optional fetch options. **NOTE:** only `options.signal` is respected when `onProgress` is also provided.
      * @returns The result of the create operation.
-     * @deprecated Use `createBinary` with `CreateBinaryOptions` instead. To be removed in Medplum 4.0.
+     * @deprecated Use `createBinary` with `CreateBinaryOptions` instead. To be removed in a future version.
      */
-    createBinary(data: BinarySource, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void, options?: MedplumRequestOptions): Promise<Binary>;
+    createBinary(data: BinarySource, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void, options?: MedplumRequestOptions): Promise<WithId<Binary>>;
     uploadwithProgress(url: URL, data: BinarySource, contentType: string, onProgress: (e: ProgressEvent) => void, options?: MedplumRequestOptions): Promise<any>;
     /**
      * Creates a PDF as a FHIR `Binary` resource based on pdfmake document definition.
@@ -3670,7 +3666,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param requestOptions - Optional fetch options.
      * @returns The result of the create operation.
      */
-    createPdf(createPdfOptions: CreatePdfOptions, requestOptions?: MedplumRequestOptions): Promise<Binary>;
+    createPdf(createPdfOptions: CreatePdfOptions, requestOptions?: MedplumRequestOptions): Promise<WithId<Binary>>;
     /**
      * @category Media
      * @param docDefinition - The PDF document definition.
@@ -3678,9 +3674,9 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param tableLayouts - Optional pdfmake custom table layout.
      * @param fonts - Optional pdfmake custom font dictionary.
      * @returns The result of the create operation.
-     * @deprecated Use `createPdf` with `CreatePdfOptions` instead. To be removed in Medplum 4.0.
+     * @deprecated Use `createPdf` with `CreatePdfOptions` instead. To be removed in a future version.
      */
-    createPdf(docDefinition: TDocumentDefinitions, filename: string | undefined, tableLayouts?: Record<string, CustomTableLayout>, fonts?: TFontDictionary): Promise<Binary>;
+    createPdf(docDefinition: TDocumentDefinitions, filename: string | undefined, tableLayouts?: Record<string, CustomTableLayout>, fonts?: TFontDictionary): Promise<WithId<Binary>>;
     /**
      * Creates a FHIR `Communication` resource with the provided data content.
      *
@@ -3691,7 +3687,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns The result of the create operation.
      */
-    createComment(resource: Resource, text: string, options?: MedplumRequestOptions): Promise<Communication>;
+    createComment(resource: Resource, text: string, options?: MedplumRequestOptions): Promise<WithId<Communication>>;
     /**
      * Updates a FHIR resource.
      *
@@ -3718,7 +3714,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns The result of the update operation.
      */
-    updateResource<T extends Resource>(resource: T, options?: MedplumRequestOptions): Promise<T>;
+    updateResource<T extends Resource>(resource: T, options?: MedplumRequestOptions): Promise<WithId<T>>;
     /**
      * Updates a FHIR resource using JSONPatch operations.
      *
@@ -3744,7 +3740,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns The result of the patch operations.
      */
-    patchResource<K extends ResourceType>(resourceType: K, id: string, operations: PatchOperation[], options?: MedplumRequestOptions): Promise<ExtractResource<K>>;
+    patchResource<RT extends ResourceType>(resourceType: RT, id: string, operations: PatchOperation[], options?: MedplumRequestOptions): Promise<WithId<ExtractResource<RT>>>;
     /**
      * Deletes a FHIR resource by resource type and ID.
      *
@@ -3942,7 +3938,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns A Bundle
      */
-    readResourceGraph<K extends ResourceType>(resourceType: K, id: string, graphName: string, options?: MedplumRequestOptions): ReadablePromise<Bundle>;
+    readResourceGraph(resourceType: ResourceType, id: string, graphName: string, options?: MedplumRequestOptions): ReadablePromise<Bundle>;
     /**
      * Pushes a message to an agent.
      *
@@ -4038,13 +4034,13 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @returns The current user profile resource.
      * @category User Profile
      */
-    getProfileAsync(): Promise<ProfileResource | undefined>;
+    getProfileAsync(): Promise<WithId<ProfileResource> | undefined>;
     /**
      * Returns the current user configuration if available.
      * @returns The current user configuration if available.
      * @category User Profile
      */
-    getUserConfiguration(): UserConfiguration | undefined;
+    getUserConfiguration(): WithId<UserConfiguration> | undefined;
     /**
      * Returns the current user access policy if available.
      * @returns The current user access policy if available.
@@ -4076,7 +4072,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param additionalFields - Additional fields for Media.
      * @param options - Optional fetch options.
      * @returns Promise that resolves to the created Media
-     * @deprecated Use `createMedia` with `CreateMediaOptions` instead. To be removed in Medplum 4.0.
+     * @deprecated Use `createMedia` with `CreateMediaOptions` instead. To be removed in a future version.
      */
     uploadMedia(contents: string | Uint8Array | File | Blob, contentType: string, filename: string | undefined, additionalFields?: Partial<Media>, options?: MedplumRequestOptions): Promise<Media>;
     /**
@@ -4345,7 +4341,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     /**
      * Makes a POST request to the tokens endpoint.
      * See: https://openid.net/specs/openid-connect-core-1_0.html#TokenEndpoint
-     * @param formBody - Token parameters in URL encoded format.
+     * @param params - Token parameters.
      * @returns The user profile resource.
      */
     private fetchTokens;
@@ -4540,6 +4536,12 @@ export declare interface MedplumClientOptions {
      * Access Token used to connect to make request to FHIR servers
      */
     accessToken?: string;
+    /**
+     * Specifies through which part of the HTTP request the client credentials should be sent.
+     *
+     * Body is the default for backwards compatibility, but header may be more desirable for applications.
+     */
+    authCredentialsMethod?: 'body' | 'header';
     /**
      * Number of resources to store in the cache.
      *
@@ -4880,7 +4882,7 @@ export declare interface MedplumSourceInfraConfig {
  * The MemoryStorage class is a minimal in-memory implementation of the Storage interface.
  */
 export declare class MemoryStorage implements Storage {
-    private data;
+    private readonly data;
     constructor();
     /**
      * Returns the number of key/value pairs.
@@ -4924,7 +4926,7 @@ export declare type Message = string | ArrayBuffer | Blob | ArrayBufferView;
  */
 export declare class MockAsyncClientStorage extends ClientStorage implements IClientStorage {
     private initialized;
-    private initPromise;
+    private readonly initPromise;
     private initResolve;
     constructor();
     setInitialized(): void;
@@ -5172,15 +5174,6 @@ export declare class OrAtom extends BooleanInfixOperatorAtom {
  */
 export declare type OutputRow = Record<string, any>;
 
-/**
- * Parses a FHIR criteria string into a SearchRequest.
- * FHIR criteria strings are found on resources such as Subscription.
- * @param criteria - The FHIR criteria string.
- * @returns Parsed search definition.
- * @deprecated Use parseSearchRequest instead.
- */
-export declare function parseCriteriaAsSearchRequest<T extends Resource = Resource>(criteria: string): SearchRequest<T>;
-
 /**
  * Parses a FHIRPath expression into an AST.
  * The result can be used to evaluate the expression against a resource or other object.
@@ -5217,7 +5210,7 @@ export declare function parseHl7DateTime(hl7DateTime: string | undefined, option
  * @param token - JWT token.
  * @returns Collection of key value claims in the JWT payload.
  */
-export declare function parseJWTPayload(token: string): Record<string, number | string>;
+export declare function parseJWTPayload(token: string): JWTPayload;
 
 export declare function parseLogLevel(level: string): LogLevel;
 
@@ -5232,8 +5225,8 @@ export declare function parseParameter(searchParam: SearchParameter, modifier: s
 
 export declare class Parser {
     private tokens;
-    private prefixParselets;
-    private infixParselets;
+    private readonly prefixParselets;
+    private readonly infixParselets;
     constructor(tokens: Token[], prefixParselets: Record<string, PrefixParselet>, infixParselets: Record<string, InfixParselet>);
     hasMore(): boolean;
     match(expected: string): boolean;
@@ -5262,14 +5255,6 @@ export declare class ParserBuilder {
  */
 export declare function parseReference<T extends Resource>(reference: Reference<T> | undefined): [T['resourceType'], string];
 
-/**
- * Parses a URL string into a SearchRequest.
- * @param url - The URL to parse.
- * @returns Parsed search definition.
- * @deprecated Use parseSearchRequest instead.
- */
-export declare function parseSearchDefinition<T extends Resource = Resource>(url: string): SearchRequest<T>;
-
 /**
  * Parses a search URL into a search request.
  * @param url - The original search URL or the FHIR resource type.
@@ -5278,14 +5263,6 @@ export declare function parseSearchDefinition<T extends Resource = Resource>(url
  */
 export declare function parseSearchRequest<T extends Resource = Resource>(url: T['resourceType'] | URL | string, query?: Record<string, string[] | string | undefined>): SearchRequest<T>;
 
-/**
- * Parses a search URL into a search request.
- * @param url - The search URL.
- * @returns A parsed SearchRequest.
- * @deprecated Use parseSearchRequest instead.
- */
-export declare function parseSearchUrl<T extends Resource = Resource>(url: URL): SearchRequest<T>;
-
 /**
  * Parses a StructureDefinition resource into an internal schema better suited for
  * programmatic validation and usage in internal systems
@@ -5495,7 +5472,7 @@ export declare type QueryTypes = URLSearchParams | string[][] | Record<string, s
  */
 export declare class ReadablePromise<T> implements Promise<T> {
     readonly [Symbol.toStringTag]: string;
-    private suspender;
+    private readonly suspender;
     private status;
     private response;
     private error;
@@ -5550,7 +5527,7 @@ export declare class ReconnectingWebSocket<WS extends IWebSocket = WebSocket> ex
     private _binaryType;
     private _closeCalled;
     private _messageQueue;
-    private _debugLogger;
+    private readonly _debugLogger;
     protected _url: string;
     protected _protocols?: ProtocolsProvider;
     protected _options: Options<WS>;
@@ -5643,10 +5620,10 @@ export declare class ReconnectingWebSocket<WS extends IWebSocket = WebSocket> ex
     private _handleTimeout;
     private _disconnect;
     private _acceptOpen;
-    private _handleOpen;
-    private _handleMessage;
-    private _handleError;
-    private _handleClose;
+    private readonly _handleOpen;
+    private readonly _handleMessage;
+    private readonly _handleError;
+    private readonly _handleClose;
     private _removeListeners;
     private _addListeners;
     private _clearTimeouts;
@@ -5710,9 +5687,6 @@ export declare type ResourceArray<T extends Resource = Resource> = T[] & {
     bundle: Bundle<T>;
 };
 
-/** @deprecated - Use CrawlerOptions instead */
-export declare type ResourceCrawlerOptions = CrawlerOptions;
-
 export declare type ResourceMatchesSubscriptionCriteria = {
     resource: Resource;
     subscription: Subscription;
@@ -5723,9 +5697,6 @@ export declare type ResourceMatchesSubscriptionCriteria = {
 
 export declare function resourceMatchesSubscriptionCriteria({ resource, subscription, context, getPreviousResource, logger, }: ResourceMatchesSubscriptionCriteria): Promise<boolean>;
 
-/** @deprecated - Use CrawlerVisitor instead */
-export declare type ResourceVisitor = CrawlerVisitor;
-
 export declare type ResourceWithCode = Resource & Code;
 
 export declare const RXNORM = "http://www.nlm.nih.gov/research/umls/rxnorm";
@@ -5974,7 +5945,7 @@ export declare interface SubManagerOptions {
  * - `heartbeat` - A `heartbeat` message has been received.
  */
 export declare class SubscriptionEmitter extends TypedEventTarget<SubscriptionEventMap> {
-    private criteria;
+    private readonly criteria;
     constructor(...criteria: string[]);
     getCriteria(): Set<string>;
     /**
@@ -6024,13 +5995,13 @@ export declare type SubscriptionEventMap = {
 
 export declare class SubscriptionManager {
     private readonly medplum;
-    private ws;
+    private readonly ws;
     private masterSubEmitter?;
-    private criteriaEntries;
-    private criteriaEntriesBySubscriptionId;
+    private readonly criteriaEntries;
+    private readonly criteriaEntriesBySubscriptionId;
     private wsClosed;
     private pingTimer;
-    private pingIntervalMs;
+    private readonly pingIntervalMs;
     private waitingForPong;
     private currentProfile;
     constructor(medplum: MedplumClient, wsUrl: URL | string, options?: SubManagerOptions);
@@ -6186,7 +6157,7 @@ export declare function tryGetJwtExpiration(token: string): number | undefined;
 export declare function tryGetProfile(profileUrl: string): InternalTypeSchema | undefined;
 
 export declare class TypedEventTarget<TEvents extends Record<string, Event_2>> {
-    private emitter;
+    private readonly emitter;
     dispatchEvent<TEventType extends keyof TEvents & string>(event: TEvents[TEventType]): void;
     addEventListener<TEventType extends keyof TEvents & string>(type: TEventType, handler: (event: TEvents[TEventType]) => void): void;
     removeEventListener<TEventType extends keyof TEvents & string>(type: TEventType, handler: (event: TEvents[TEventType]) => void): void;
@@ -6335,6 +6306,10 @@ declare type WebSocketEventMap_2 = {
 };
 export { WebSocketEventMap_2 as WebSocketEventMap }
 
+export declare type WithId<T> = T & {
+    id: string;
+};
+
 /**
  * Returns a word-wrapped string.
  * Based on: https://stackoverflow.com/a/38709683