@medplum/core 2.1.0 → 2.1.2

package/dist/types/bundle.d.ts

@@ -1,4 +1,4 @@
-import { Bundle } from '@medplum/fhirtypes';
+import { Bundle, Resource } from '@medplum/fhirtypes';
 /**
  * More on Bundles can be found here
  * http://hl7.org/fhir/R4/bundle.html
@@ -20,3 +20,13 @@ export declare function convertToTransactionBundle(bundle: Bundle): Bundle;
  * @returns Bundle of the same type, with Bundle.entry reordered
  */
 export declare function reorderBundle(bundle: Bundle): Bundle;
+/**
+ * Converts a resource with contained resources to a transaction bundle.
+ * This function is useful when creating a resource that contains other resources.
+ * Handles local references and topological sorting.
+ * @param resource The input resource which may or may not include contained resources.
+ * @returns A bundle with the input resource and all contained resources.
+ */
+export declare function convertContainedResourcesToBundle(resource: Resource & {
+    contained?: Resource[];
+}): Bundle;

package/dist/types/client.d.ts

@@ -1,4 +1,4 @@
-import { AccessPolicy, Attachment, Binary, BulkDataExport, Bundle, Communication, ExtractResource, Identifier, Media, OperationOutcome, Project, ProjectMembership, ProjectMembershipAccess, ProjectSecret, Reference, Resource, ResourceType, UserConfiguration, ValueSet } from '@medplum/fhirtypes';
+import { AccessPolicy, Agent, 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';
@@ -27,6 +27,8 @@ export interface MedplumClientOptions {
      *
      * Default value is baseUrl + "/oauth2/authorize".
      *
+     * Can be specified as absolute URL or relative to baseUrl.
+     *
      * Use this if you want to use a separate OAuth server.
      */
     authorizeUrl?: string;
@@ -35,6 +37,8 @@ export interface MedplumClientOptions {
      *
      * Default value is "fhir/R4/".
      *
+     * Can be specified as absolute URL or relative to baseUrl.
+     *
      * Use this if you want to use a different path when connecting to a FHIR server.
      */
     fhirUrlPath?: string;
@@ -43,6 +47,8 @@ export interface MedplumClientOptions {
      *
      * Default value is baseUrl + "/oauth2/token".
      *
+     * Can be specified as absolute URL or relative to baseUrl.
+     *
      * Use this if you want to use a separate OAuth server.
      */
     tokenUrl?: string;
@@ -51,6 +57,8 @@ export interface MedplumClientOptions {
      *
      * Default value is baseUrl + "/oauth2/logout".
      *
+     * Can be specified as absolute URL or relative to baseUrl.
+     *
      * Use this if you want to use a separate OAuth server.
      */
     logoutUrl?: string;
@@ -108,14 +116,6 @@ export interface MedplumClientOptions {
      * For Node.js applications, consider the 'node-fetch' package.
      */
     fetch?: FetchLike;
-    /**
-     * The profile name.
-     *
-     * This is for handling multiple profiles to access different FHIR Servers
-     *
-     * If undefined, the default profile is "default".
-     */
-    profile?: string;
     /**
      * Storage implementation.
      *
@@ -170,6 +170,18 @@ export interface MedplumClientOptions {
      * For client side applications, consider redirecting to a sign in page.
      */
     onUnauthenticated?: () => void;
+    /**
+     * The default redirect behavior.
+     *
+     * The default behavior is to not follow redirects.
+     *
+     * Use "follow" to automatically follow redirects.
+     */
+    redirect?: RequestRedirect;
+    /**
+     * When the verbose flag is set, the client will log all requests and responses to the console.
+     */
+    verbose?: boolean;
 }
 export interface FetchLike {
     (url: string, options?: any): Promise<any>;
@@ -386,6 +398,14 @@ export declare enum OAuthTokenType {
     /** Indicates that the token is a base64url-encoded SAML 2.0 [OASIS.saml-core-2.0-os] assertion. */
     Saml2Token = "urn:ietf:params:oauth:token-type:saml2"
 }
+/**
+ * OAuth 2.0 Client Authentication Methods
+ * See: https://datatracker.ietf.org/doc/html/rfc7523#section-2.2
+ */
+export declare enum OAuthClientAssertionType {
+    /** Using JWTs for Client Authentication */
+    JwtBearer = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer"
+}
 /**
  * The MedplumClient class provides a client for the Medplum FHIR server.
  *
@@ -438,6 +458,7 @@ export declare enum OAuthTokenType {
  *  </head>
  */
 export declare class MedplumClient extends EventTarget {
+    private readonly options;
     private readonly fetch;
     private readonly createPdfImpl?;
     private readonly storage;
@@ -478,6 +499,22 @@ export declare class MedplumClient extends EventTarget {
      * @returns The current authorize URL.
      */
     getAuthorizeUrl(): string;
+    /**
+     * Returns the current token URL.
+     * By default, this is set to `https://api.medplum.com/oauth2/token`.
+     * This can be overridden by setting the `tokenUrl` option when creating the client.
+     * @category HTTP
+     * @returns The current token URL.
+     */
+    getTokenUrl(): string;
+    /**
+     * Returns the current logout URL.
+     * By default, this is set to `https://api.medplum.com/oauth2/logout`.
+     * This can be overridden by setting the `logoutUrl` option when creating the client.
+     * @category HTTP
+     * @returns The current logout URL.
+     */
+    getLogoutUrl(): string;
     /**
      * Clears all auth state including local storage and session storage.
      * @category Authentication
@@ -1328,7 +1365,6 @@ export declare class MedplumClient extends EventTarget {
      */
     graphql(query: string, operationName?: string | null, variables?: any, options?: RequestInit): Promise<any>;
     /**
-     *
      * Executes the $graph operation on this resource to fetch a Bundle of resources linked to the target resource
      * according to a graph definition
      * @category Read
@@ -1339,6 +1375,16 @@ export declare class MedplumClient extends EventTarget {
      * @returns A Bundle
      */
     readResourceGraph<K extends ResourceType>(resourceType: K, id: string, graphName: string, options?: RequestInit): ReadablePromise<Bundle>;
+    /**
+     * Pushes a message to an agent.
+     *
+     * @param agent The agent to push to.
+     * @param body The message body.
+     * @param contentType Optional message content type.
+     * @param options Optional fetch options.
+     * @returns Promise to the operation outcome.
+     */
+    pushToAgent(agent: Agent, body: any, contentType?: string, options?: RequestInit): Promise<OperationOutcome>;
     /**
      * @category Authentication
      * @returns The Login State
@@ -1427,13 +1473,6 @@ export declare class MedplumClient extends EventTarget {
      * @category User Profile
      */
     getAccessPolicy(): AccessPolicy | undefined;
-    /**
-     * Translates/normalizes a URL so that it can be directly used with `MedplumClient.fetch`.
-     * Especially useful for translating `Binary/{id}` URLs to FHIR paths.
-     * @param url A valid URL within the `MedplumClient` context.
-     * @returns URL as a string that can be used with `MedplumClient.fetch`
-     */
-    normalizeFetchUrl(url: URL | string): string;
     /**
      * Downloads the URL as a blob. Can accept binary URLs in the form of `Binary/{id}` as well.
      * @category Read
@@ -1504,6 +1543,8 @@ export declare class MedplumClient extends EventTarget {
     private request;
     private parseResponse;
     private fetchWithRetry;
+    private logRequest;
+    private logResponse;
     private pollStatus;
     /**
      * Executes a batch of requests that were automatically batched together.
@@ -1578,6 +1619,7 @@ export declare class MedplumClient extends EventTarget {
      * ```
      *
      * See: https://datatracker.ietf.org/doc/html/rfc6749#section-4.4
+     *
      * @category Authentication
      * @param clientId The client ID.
      * @param clientSecret The client secret.
@@ -1594,12 +1636,24 @@ export declare class MedplumClient extends EventTarget {
      * ```
      *
      * See: https://datatracker.ietf.org/doc/html/rfc7523#section-2.1
+     *
+     * @category Authentication
      * @param clientId The client ID.
      * @param assertion The JWT assertion.
      * @param scope The OAuth scope.
      * @returns Promise that resolves to the client profile.
      */
     startJwtBearerLogin(clientId: string, assertion: string, scope: string): Promise<ProfileResource>;
+    /**
+     * Starts a new OAuth2 JWT assertion flow.
+     *
+     * See: https://datatracker.ietf.org/doc/html/rfc7523#section-2.2
+     *
+     * @category Authentication
+     * @param jwt The JWT assertion.
+     * @returns Promise that resolves to the client profile.
+     */
+    startJwtAssertionLogin(jwt: string): Promise<ProfileResource>;
     /**
      * Sets the client ID and secret for basic auth.
      *

package/dist/types/config.d.ts

@@ -48,4 +48,10 @@ export interface MedplumInfraConfig {
             [key: string]: string;
         };
     }[];
+    cloudTrailAlarms?: {
+        logGroupName: string;
+        logGroupCreate?: boolean;
+        snsTopicArn?: string;
+        snsTopicName?: string;
+    };
 }

package/dist/types/index.d.ts

@@ -23,6 +23,7 @@ export * from './search/search';
 export * from './sftp';
 export * from './storage';
 export * from './types';
+export * from './typeschema/crawler';
 export * from './typeschema/types';
 export * from './typeschema/validation';
 export * from './utils';

package/dist/types/typeschema/crawler.d.ts

@@ -0,0 +1,12 @@
+import { Resource } from '@medplum/fhirtypes';
+import { TypedValue } from '../types';
+import { InternalTypeSchema } from './types';
+export interface ResourceVisitor {
+    onEnterObject?: (path: string, value: TypedValue, schema: InternalTypeSchema) => void;
+    onExitObject?: (path: string, value: TypedValue, schema: InternalTypeSchema) => void;
+    onEnterResource?: (path: string, value: TypedValue, schema: InternalTypeSchema) => void;
+    onExitResource?: (path: string, value: TypedValue, schema: InternalTypeSchema) => void;
+    visitProperty?: (parent: TypedValue, key: string, path: string, propertyValues: (TypedValue | TypedValue[] | undefined)[], schema: InternalTypeSchema) => void;
+}
+export declare function crawlResource(resource: Resource, visitor: ResourceVisitor, schema?: InternalTypeSchema, initialPath?: string): void;
+export declare function getNestedProperty(value: TypedValue, key: string): (TypedValue | TypedValue[] | undefined)[];

package/dist/types/typeschema/types.d.ts

@@ -1,4 +1,4 @@
-import { Bundle, StructureDefinition, Resource } from '@medplum/fhirtypes';
+import { Bundle, Resource, StructureDefinition } from '@medplum/fhirtypes';
 import { TypedValue } from '../types';
 /**
  * Internal representation of a non-primitive FHIR type, suitable for use in resource validation

package/dist/types/utils.d.ts

@@ -176,7 +176,7 @@ export declare function deepClone<T>(input: T): T;
  * @param input The input string.
  * @returns True if the input string matches the UUID format.
  */
-export declare function isUUID(input: string): boolean;
+export declare function isUUID(input: string): input is `${string}-${string}-${string}-${string}-${string}`;
 /**
  * Returns true if the input is an object.
  * @param obj The candidate object.

package/package.json

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