@medplum/core 2.0.2 → 2.0.4

package/README.md

@@ -58,7 +58,7 @@ Before you begin
 After that, you can use the `startLogin()` method:
 
 ```ts
-const loginResult = await medplum.startLogin(email, password, remember);
+const loginResult = await medplum.startLogin({ email, password, remember });
 const profile = await medplum.processCode(loginResult.code);
 console.log(profile);
 ```
@@ -76,13 +76,17 @@ medplum.signInWithRedirect().then((user) => console.log(user));
 Search for any resource using a [FHIR search](https://www.hl7.org/fhir/search.html) string:
 
 ```ts
-search<T extends Resource>(query: string | SearchRequest, options: RequestInit = {}): ReadablePromise<Bundle<T>>
+search<K extends ResourceType>(
+  resourceType: K,
+  query?: URLSearchParams | string,
+  options: RequestInit = {}
+): ReadablePromise<Bundle<ExtractResource<K>>>
 ```
 
 Example:
 
 ```ts
-const bundle = await medplum.search('Patient?given=eve');
+const bundle = await medplum.search('Patient', 'given=eve');
 bundle.entry.forEach((entry) => console.log(entry.resource));
 ```
 

package/dist/cjs/client.d.ts

@@ -84,7 +84,7 @@ export interface MedplumClientOptions {
      *
      * Default is window.fetch (if available).
      *
-     * For nodejs applications, consider the 'node-fetch' package.
+     * For Node.js applications, consider the 'node-fetch' package.
      */
     fetch?: FetchLike;
     /**
@@ -105,7 +105,7 @@ export interface MedplumClientOptions {
      * </script>
      * ```
      *
-     * In nodejs applications:
+     * In Node.js applications:
      *
      * ```ts
      * import type { CustomTableLayout, TDocumentDefinitions, TFontDictionary } from 'pdfmake/interfaces';
@@ -282,7 +282,7 @@ export interface MailOptions {
 /**
  * The MedplumClient class provides a client for the Medplum FHIR server.
  *
- * The client can be used in the browser, in a NodeJS application, or in a Medplum Bot.
+ * The client can be used in the browser, in a Node.js application, or in a Medplum Bot.
  *
  * The client provides helpful methods for common operations such as:
  *   1) Authenticating
@@ -517,8 +517,19 @@ export declare class MedplumClient extends EventTarget {
      * @param clientId The external client ID.
      * @param redirectUri The external identity provider redirect URI.
      * @param baseLogin The Medplum login request.
+     * @category Authentication
      */
     signInWithExternalAuth(authorizeUrl: string, clientId: string, redirectUri: string, baseLogin: BaseLoginRequest): Promise<void>;
+    /**
+     * Builds the external identity provider redirect URI.
+     * @param authorizeUrl The external authorization URL.
+     * @param clientId The external client ID.
+     * @param redirectUri The external identity provider redirect URI.
+     * @param loginRequest  The Medplum login request.
+     * @returns The external identity provider redirect URI.
+     * @category Authentication
+     */
+    getExternalAuthRedirectUri(authorizeUrl: string, clientId: string, redirectUri: string, loginRequest: BaseLoginRequest): string;
     /**
      * Builds a FHIR URL from a collection of URL path components.
      * For example, `buildUrl('/Patient', '123')` returns `fhir/R4/Patient/123`.
@@ -1182,6 +1193,7 @@ export declare class MedplumClient extends EventTarget {
     /**
      * Starts a new PKCE flow.
      * These PKCE values are stateful, and must survive redirects and page refreshes.
+     * @category Authentication
      */
     startPkce(): Promise<{
         codeChallengeMethod: string;
@@ -1191,6 +1203,7 @@ export declare class MedplumClient extends EventTarget {
      * Processes an OAuth authorization code.
      * See: https://openid.net/specs/openid-connect-core-1_0.html#TokenRequest
      * @param code The authorization code received by URL parameter.
+     * @category Authentication
      */
     processCode(code: string): Promise<ProfileResource>;
     /**