npm - @medplum/core - Versions diffs - 0.10.2 → 1.0.1 - Mend

@medplum/core 0.10.2 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (31) hide show

package/dist/cjs/search.d.ts CHANGED Viewed

@@ -8,6 +8,7 @@ export interface SearchRequest {
     fields?: string[];
     name?: string;
     total?: 'none' | 'estimate' | 'accurate';
+    revInclude?: string;
 }
 export interface Filter {
     code: string;

package/dist/cjs/utils.d.ts CHANGED Viewed

@@ -26,7 +26,7 @@ export declare function resolveId(reference: Reference | undefined): string | un
  * @param resource The FHIR resource.
  * @returns True if the resource is a "ProfileResource".
  */
-export declare function isProfileResource(resource: Resource): boolean;
+export declare function isProfileResource(resource: Resource): resource is ProfileResource;
 /**
  * Returns a display string for the resource.
  * @param resource The input resource.
@@ -203,6 +203,13 @@ export declare function findObservationReferenceRange(definition: ObservationDef
  * @returns True if the value is within the range.
  */
 export declare function matchesRange(value: number, range: Range, precision?: number): boolean;
+/**
+ * Returns the input number rounded to the specified number of digits.
+ * @param a The input number.
+ * @param precision The precision in number of digits.
+ * @returns The number rounded to the specified number of digits.
+ */
+export declare function preciseRound(a: number, precision: number): number;
 /**
  * Returns true if the two numbers are equal to the given precision.
  * @param a The first number.

package/dist/esm/client.d.ts CHANGED Viewed

@@ -136,16 +136,21 @@ export interface CreatePdfFunction {
         [name: string]: CustomTableLayout;
     } | undefined, fonts?: TFontDictionary | undefined): Promise<any>;
 }
-export interface LoginRequest {
-    readonly email: string;
-    readonly password: string;
-    readonly remember?: boolean;
+export interface BaseLoginRequest {
     readonly projectId?: string;
     readonly clientId?: string;
+    readonly resourceType?: string;
     readonly scope?: string;
     readonly nonce?: string;
     readonly codeChallenge?: string;
     readonly codeChallengeMethod?: string;
+    readonly googleClientId?: string;
+    readonly launch?: string;
+}
+export interface EmailPasswordLoginRequest extends BaseLoginRequest {
+    readonly email: string;
+    readonly password: string;
+    readonly remember?: boolean;
 }
 export interface NewUserRequest {
     readonly firstName: string;
@@ -169,15 +174,9 @@ export interface GoogleCredentialResponse {
     readonly clientId: string;
     readonly credential: string;
 }
-export interface GoogleLoginRequest {
+export interface GoogleLoginRequest extends BaseLoginRequest {
     readonly googleClientId: string;
     readonly googleCredential: string;
-    readonly projectId?: string;
-    readonly clientId?: string;
-    readonly scope?: string;
-    readonly nonce?: string;
-    readonly codeChallenge?: string;
-    readonly codeChallengeMethod?: string;
     readonly createUser?: boolean;
 }
 export interface LoginAuthenticationResponse {
@@ -316,6 +315,11 @@ export interface MailOptions {
  * const bundle = await medplum.search('Patient', 'name=Alice');
  * console.log(bundle.total);
  * ```
+ *
+ *  <head>
+ *    <meta name="algolia:pageRank" content="100" />
+ *  </head>
  */
 export declare class MedplumClient extends EventTarget {
     #private;
@@ -452,7 +456,7 @@ export declare class MedplumClient extends EventTarget {
      * @param loginRequest Login request including email and password.
      * @returns Promise to the authentication response.
      */
-    startLogin(loginRequest: LoginRequest): Promise<LoginAuthenticationResponse>;
+    startLogin(loginRequest: EmailPasswordLoginRequest): Promise<LoginAuthenticationResponse>;
     /**
      * Tries to sign in with Google authentication.
      * The response parameter is the result of a Google authentication.
@@ -462,7 +466,7 @@ export declare class MedplumClient extends EventTarget {
      * @returns Promise to the authentication response.
      */
     startGoogleLogin(loginRequest: GoogleLoginRequest): Promise<LoginAuthenticationResponse>;
-    getCodeChallenge(loginRequest: LoginRequest | GoogleLoginRequest): {
+    getCodeChallenge(loginRequest: BaseLoginRequest): {
         codeChallenge?: string;
         codeChallengeMethod?: string;
     };
@@ -544,7 +548,9 @@ export declare class MedplumClient extends EventTarget {
      * See FHIR search for full details: https://www.hl7.org/fhir/search.html
      *
      * @category Search
+     * @param resourceType The FHIR resource type.
      * @param query The search query as either a string or a structured search object.
+     * @param options Optional fetch options.
      * @returns Promise to the search result bundle.
      */
     search<K extends ResourceType>(resourceType: K, query?: URLSearchParams | string, options?: RequestInit): ReadablePromise<Bundle<ExtractResource<K>>>;
@@ -565,7 +571,9 @@ export declare class MedplumClient extends EventTarget {
      * See FHIR search for full details: https://www.hl7.org/fhir/search.html
      *
      * @category Search
+     * @param resourceType The FHIR resource type.
      * @param query The search query as either a string or a structured search object.
+     * @param options Optional fetch options.
      * @returns Promise to the search result bundle.
      */
     searchOne<K extends ResourceType>(resourceType: K, query?: URLSearchParams | string, options?: RequestInit): ReadablePromise<ExtractResource<K> | undefined>;
@@ -586,7 +594,9 @@ export declare class MedplumClient extends EventTarget {
      * See FHIR search for full details: https://www.hl7.org/fhir/search.html
      *
      * @category Search
+     * @param resourceType The FHIR resource type.
      * @param query The search query as either a string or a structured search object.
+     * @param options Optional fetch options.
      * @returns Promise to the search result bundle.
      */
     searchResources<K extends ResourceType>(resourceType: K, query?: URLSearchParams | string, options?: RequestInit): ReadablePromise<ExtractResource<K>[]>;
@@ -597,6 +607,7 @@ export declare class MedplumClient extends EventTarget {
      * @category Search
      * @param system The ValueSet system url.
      * @param filter The search string.
+     * @param options Optional fetch options.
      * @returns Promise to expanded ValueSet.
      */
     searchValueSet(system: string, filter: string, options?: RequestInit): ReadablePromise<ValueSet>;
@@ -631,6 +642,7 @@ export declare class MedplumClient extends EventTarget {
      * @category Read
      * @param resourceType The FHIR resource type.
      * @param id The resource ID.
+     * @param options Optional fetch options.
      * @returns The resource if available; undefined otherwise.
      */
     readResource<K extends ResourceType>(resourceType: K, id: string, options?: RequestInit): ReadablePromise<ExtractResource<K>>;
@@ -651,6 +663,7 @@ export declare class MedplumClient extends EventTarget {
      *
      * @category Read
      * @param reference The FHIR reference object.
+     * @param options Optional fetch options.
      * @returns The resource if available; undefined otherwise.
      */
     readReference<T extends Resource>(reference: Reference<T>, options?: RequestInit): ReadablePromise<T>;
@@ -659,7 +672,6 @@ export declare class MedplumClient extends EventTarget {
      * If the schema is not cached, returns undefined.
      * It is assumed that a client will call requestSchema before using this method.
      * @category Schema
-     * @param resourceType The FHIR resource type.
      * @returns The schema if immediately available, undefined otherwise.
      * @deprecated Use globalSchema instead.
      */
@@ -689,6 +701,7 @@ export declare class MedplumClient extends EventTarget {
      * @category Read
      * @param resourceType The FHIR resource type.
      * @param id The resource ID.
+     * @param options Optional fetch options.
      * @returns Promise to the resource history.
      */
     readHistory<K extends ResourceType>(resourceType: K, id: string, options?: RequestInit): ReadablePromise<Bundle<ExtractResource<K>>>;
@@ -707,13 +720,26 @@ export declare class MedplumClient extends EventTarget {
      * @category Read
      * @param resourceType The FHIR resource type.
      * @param id The resource ID.
+     * @param vid The version ID.
+     * @param options Optional fetch options.
      * @returns The resource if available; undefined otherwise.
      */
     readVersion<K extends ResourceType>(resourceType: K, id: string, vid: string, options?: RequestInit): ReadablePromise<ExtractResource<K>>;
     /**
+     * Executes the Patient "everything" operation for a patient.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const bundle = await medplum.readPatientEverything('123');
+     * console.log(bundle);
+     * ```
+     *
+     * See the FHIR "patient-everything" operation for full details: https://hl7.org/fhir/operation-patient-everything.html
      *
      * @category Read
      * @param id The Patient Id
+     * @param options Optional fetch options.
      * @returns A Bundle of all Resources related to the Patient
      */
     readPatientEverything(id: string, options?: RequestInit): ReadablePromise<Bundle>;
@@ -807,7 +833,8 @@ export declare class MedplumClient extends EventTarget {
      * @param contentType Content type for the binary.
      * @returns The result of the create operation.
      */
-    createBinary(data: string | File | Blob | Uint8Array, filename: string | undefined, contentType: string): Promise<Binary>;
+    createBinary(data: string | File | Blob | Uint8Array, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void): Promise<Binary>;
+    uploadwithProgress(url: URL, data: string | File | Blob | Uint8Array, contentType: string, onProgress: (e: ProgressEvent) => void): Promise<any>;
     /**
      * Creates a PDF as a FHIR `Binary` resource based on pdfmake document definition.
      *
@@ -912,6 +939,24 @@ export declare class MedplumClient extends EventTarget {
      * @returns The result of the delete operation.
      */
     deleteResource(resourceType: ResourceType, id: string): Promise<any>;
+    /**
+     * Executes the validate operation with the provided resource.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const result = await medplum.validateResource({
+     *   resourceType: 'Patient',
+     *   name: [{ given: ['Alice'], family: 'Smith' }],
+     * });
+     * ```
+     *
+     * See the FHIR "$validate" operation for full details: https://www.hl7.org/fhir/resource-operation-validate.html
+     *
+     * @param resource The FHIR resource.
+     * @returns The validate operation outcome.
+     */
+    validateResource<T extends Resource>(resource: T): Promise<OperationOutcome>;
     /**
      * Executes a batch or transaction of FHIR operations.
      *

package/dist/esm/client.js CHANGED Viewed

@@ -11,9 +11,8 @@ import { createReference, arrayBufferToBase64 } from './utils.js';
 // PKCE auth based on:
 // https://aws.amazon.com/blogs/security/how-to-add-authentication-single-page-web-application-with-amazon-cognito-oauth2-implementation/
 var _MedplumClient_instances, _MedplumClient_fetch, _MedplumClient_createPdf, _MedplumClient_storage, _MedplumClient_requestCache, _MedplumClient_cacheTime, _MedplumClient_baseUrl, _MedplumClient_clientId, _MedplumClient_authorizeUrl, _MedplumClient_tokenUrl, _MedplumClient_logoutUrl, _MedplumClient_onUnauthenticated, _MedplumClient_accessToken, _MedplumClient_refreshToken, _MedplumClient_refreshPromise, _MedplumClient_profilePromise, _MedplumClient_profile, _MedplumClient_config, _MedplumClient_addLogin, _MedplumClient_refreshProfile, _MedplumClient_getCacheEntry, _MedplumClient_setCacheEntry, _MedplumClient_request, _MedplumClient_addFetchOptionsDefaults, _MedplumClient_setRequestContentType, _MedplumClient_setRequestBody, _MedplumClient_handleUnauthenticated, _MedplumClient_requestAuthorization, _MedplumClient_refresh, _MedplumClient_fetchTokens, _MedplumClient_verifyTokens, _MedplumClient_setupStorageListener;
-const MEDPLUM_VERSION = "0.10.2-f713edf5";
+const MEDPLUM_VERSION = "1.0.1-69d972ca";
 const DEFAULT_BASE_URL = 'https://api.medplum.com/';
-const DEFAULT_SCOPE = 'launch/patient openid fhirUser offline_access user/*.*';
 const DEFAULT_RESOURCE_CACHE_SIZE = 1000;
 const DEFAULT_CACHE_TIME = 60000; // 60 seconds
 const JSON_CONTENT_TYPE = 'application/json';
@@ -65,6 +64,11 @@ const PATCH_CONTENT_TYPE = 'application/json-patch+json';
  * const bundle = await medplum.search('Patient', 'name=Alice');
  * console.log(bundle.total);
  * ```
+ *
+ *  <head>
+ *    <meta name="algolia:pageRank" content="100" />
+ *  </head>
  */
 class MedplumClient extends EventTarget {
     constructor(options) {
@@ -317,10 +321,10 @@ class MedplumClient extends EventTarget {
      * @returns Promise to the authentication response.
      */
     startLogin(loginRequest) {
-        var _a, _b;
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             const { codeChallenge, codeChallengeMethod } = this.getCodeChallenge(loginRequest);
-            return this.post('auth/login', Object.assign(Object.assign({}, loginRequest), { clientId: (_a = loginRequest.clientId) !== null && _a !== void 0 ? _a : __classPrivateFieldGet(this, _MedplumClient_clientId, "f"), scope: (_b = loginRequest.scope) !== null && _b !== void 0 ? _b : DEFAULT_SCOPE, codeChallengeMethod,
+            return this.post('auth/login', Object.assign(Object.assign({}, loginRequest), { clientId: (_a = loginRequest.clientId) !== null && _a !== void 0 ? _a : __classPrivateFieldGet(this, _MedplumClient_clientId, "f"), scope: loginRequest.scope, codeChallengeMethod,
                 codeChallenge }));
         });
     }
@@ -333,10 +337,10 @@ class MedplumClient extends EventTarget {
      * @returns Promise to the authentication response.
      */
     startGoogleLogin(loginRequest) {
-        var _a, _b;
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             const { codeChallenge, codeChallengeMethod } = this.getCodeChallenge(loginRequest);
-            return this.post('auth/google', Object.assign(Object.assign({}, loginRequest), { clientId: (_a = loginRequest.clientId) !== null && _a !== void 0 ? _a : __classPrivateFieldGet(this, _MedplumClient_clientId, "f"), scope: (_b = loginRequest.scope) !== null && _b !== void 0 ? _b : DEFAULT_SCOPE, codeChallengeMethod,
+            return this.post('auth/google', Object.assign(Object.assign({}, loginRequest), { clientId: (_a = loginRequest.clientId) !== null && _a !== void 0 ? _a : __classPrivateFieldGet(this, _MedplumClient_clientId, "f"), scope: loginRequest.scope, codeChallengeMethod,
                 codeChallenge }));
         });
     }
@@ -458,7 +462,9 @@ class MedplumClient extends EventTarget {
      * See FHIR search for full details: https://www.hl7.org/fhir/search.html
      *
      * @category Search
+     * @param resourceType The FHIR resource type.
      * @param query The search query as either a string or a structured search object.
+     * @param options Optional fetch options.
      * @returns Promise to the search result bundle.
      */
     search(resourceType, query, options = {}) {
@@ -481,7 +487,9 @@ class MedplumClient extends EventTarget {
      * See FHIR search for full details: https://www.hl7.org/fhir/search.html
      *
      * @category Search
+     * @param resourceType The FHIR resource type.
      * @param query The search query as either a string or a structured search object.
+     * @param options Optional fetch options.
      * @returns Promise to the search result bundle.
      */
     searchOne(resourceType, query, options = {}) {
@@ -514,7 +522,9 @@ class MedplumClient extends EventTarget {
      * See FHIR search for full details: https://www.hl7.org/fhir/search.html
      *
      * @category Search
+     * @param resourceType The FHIR resource type.
      * @param query The search query as either a string or a structured search object.
+     * @param options Optional fetch options.
      * @returns Promise to the search result bundle.
      */
     searchResources(resourceType, query, options = {}) {
@@ -535,6 +545,7 @@ class MedplumClient extends EventTarget {
      * @category Search
      * @param system The ValueSet system url.
      * @param filter The search string.
+     * @param options Optional fetch options.
      * @returns Promise to expanded ValueSet.
      */
     searchValueSet(system, filter, options = {}) {
@@ -588,6 +599,7 @@ class MedplumClient extends EventTarget {
      * @category Read
      * @param resourceType The FHIR resource type.
      * @param id The resource ID.
+     * @param options Optional fetch options.
      * @returns The resource if available; undefined otherwise.
      */
     readResource(resourceType, id, options = {}) {
@@ -610,6 +622,7 @@ class MedplumClient extends EventTarget {
      *
      * @category Read
      * @param reference The FHIR reference object.
+     * @param options Optional fetch options.
      * @returns The resource if available; undefined otherwise.
      */
     readReference(reference, options = {}) {
@@ -628,7 +641,6 @@ class MedplumClient extends EventTarget {
      * If the schema is not cached, returns undefined.
      * It is assumed that a client will call requestSchema before using this method.
      * @category Schema
-     * @param resourceType The FHIR resource type.
      * @returns The schema if immediately available, undefined otherwise.
      * @deprecated Use globalSchema instead.
      */
@@ -703,6 +715,7 @@ class MedplumClient extends EventTarget {
      * @category Read
      * @param resourceType The FHIR resource type.
      * @param id The resource ID.
+     * @param options Optional fetch options.
      * @returns Promise to the resource history.
      */
     readHistory(resourceType, id, options = {}) {
@@ -723,15 +736,28 @@ class MedplumClient extends EventTarget {
      * @category Read
      * @param resourceType The FHIR resource type.
      * @param id The resource ID.
+     * @param vid The version ID.
+     * @param options Optional fetch options.
      * @returns The resource if available; undefined otherwise.
      */
     readVersion(resourceType, id, vid, options = {}) {
         return this.get(this.fhirUrl(resourceType, id, '_history', vid), options);
     }
     /**
+     * Executes the Patient "everything" operation for a patient.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const bundle = await medplum.readPatientEverything('123');
+     * console.log(bundle);
+     * ```
+     *
+     * See the FHIR "patient-everything" operation for full details: https://hl7.org/fhir/operation-patient-everything.html
      *
      * @category Read
      * @param id The Patient Id
+     * @param options Optional fetch options.
      * @returns A Bundle of all Resources related to the Patient
      */
     readPatientEverything(id, options = {}) {
@@ -838,12 +864,44 @@ class MedplumClient extends EventTarget {
      * @param contentType Content type for the binary.
      * @returns The result of the create operation.
      */
-    createBinary(data, filename, contentType) {
+    createBinary(data, filename, contentType, onProgress) {
         const url = this.fhirUrl('Binary');
         if (filename) {
             url.searchParams.set('_filename', filename);
         }
-        return this.post(url, data, contentType);
+        if (onProgress) {
+            return this.uploadwithProgress(url, data, contentType, onProgress);
+        }
+        else {
+            return this.post(url, data, contentType);
+        }
+    }
+    uploadwithProgress(url, data, contentType, onProgress) {
+        return new Promise((resolve, reject) => {
+            const xhr = new XMLHttpRequest();
+            xhr.responseType = 'json';
+            xhr.onabort = () => reject(new Error('Request aborted'));
+            xhr.onerror = () => reject(new Error('Request error'));
+            if (onProgress) {
+                xhr.upload.onprogress = (e) => onProgress(e);
+                xhr.upload.onload = (e) => onProgress(e);
+            }
+            xhr.onload = () => {
+                if (xhr.status >= 200 && xhr.status < 300) {
+                    resolve(xhr.response);
+                }
+                else {
+                    reject(new Error(xhr.statusText));
+                }
+            };
+            xhr.open('POST', url);
+            xhr.withCredentials = true;
+            xhr.setRequestHeader('Authorization', 'Bearer ' + __classPrivateFieldGet(this, _MedplumClient_accessToken, "f"));
+            xhr.setRequestHeader('Cache-Control', 'no-cache, no-store, max-age=0');
+            xhr.setRequestHeader('Content-Type', contentType);
+            xhr.setRequestHeader('X-Medplum', 'extended');
+            xhr.send(data);
+        });
     }
     /**
      * Creates a PDF as a FHIR `Binary` resource based on pdfmake document definition.
@@ -999,6 +1057,26 @@ class MedplumClient extends EventTarget {
         this.invalidateSearches(resourceType);
         return this.delete(this.fhirUrl(resourceType, id));
     }
+    /**
+     * Executes the validate operation with the provided resource.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const result = await medplum.validateResource({
+     *   resourceType: 'Patient',
+     *   name: [{ given: ['Alice'], family: 'Smith' }],
+     * });
+     * ```
+     *
+     * See the FHIR "$validate" operation for full details: https://www.hl7.org/fhir/resource-operation-validate.html
+     *
+     * @param resource The FHIR resource.
+     * @returns The validate operation outcome.
+     */
+    validateResource(resource) {
+        return this.post(this.fhirUrl(resource.resourceType, '$validate'), resource);
+    }
     /**
      * Executes a batch or transaction of FHIR operations.
      *
@@ -1406,7 +1484,6 @@ _MedplumClient_fetch = new WeakMap(), _MedplumClient_createPdf = new WeakMap(),
         url.searchParams.set('state', sessionStorage.getItem('pkceState'));
         url.searchParams.set('client_id', __classPrivateFieldGet(this, _MedplumClient_clientId, "f"));
         url.searchParams.set('redirect_uri', getBaseUrl());
-        url.searchParams.set('scope', DEFAULT_SCOPE);
         url.searchParams.set('code_challenge_method', 'S256');
         url.searchParams.set('code_challenge', sessionStorage.getItem('codeChallenge'));
         window.location.assign(url.toString());