@medplum/core 0.9.18 → 0.9.19

package/dist/types/client.d.ts

@@ -844,7 +844,54 @@ export declare class MedplumClient extends EventTarget {
      * @returns Promise to the operation outcome.
      */
     sendEmail(email: MailOptions): Promise<OperationOutcome>;
-    graphql(query: string, options?: RequestInit): Promise<any>;
+    /**
+     * Executes a GraphQL query.
+     *
+     * Example:
+     *
+     * ```typescript
+     * const result = await medplum.graphql(`{
+     *   Patient(id: "123") {
+     *     resourceType
+     *     id
+     *     name {
+     *       given
+     *       family
+     *     }
+     *   }
+     * }`);
+     * ```
+     *
+     * Advanced queries such as named operations and variable substitution are supported:
+     *
+     * ```typescript
+     * const result = await medplum.graphql(
+     *   `query GetPatientById($patientId: ID!) {
+     *     Patient(id: $patientId) {
+     *       resourceType
+     *       id
+     *       name {
+     *         given
+     *         family
+     *       }
+     *     }
+     *   }`,
+     *   'GetPatientById',
+     *   { patientId: '123' }
+     * );
+     * ```
+     *
+     * See the GraphQL documentation for more details: https://graphql.org/learn/
+     *
+     * See the FHIR GraphQL documentation for FHIR specific details: https://www.hl7.org/fhir/graphql.html
+     *
+     * @param query The GraphQL query.
+     * @param operationName Optional GraphQL operation name.
+     * @param variables Optional GraphQL variables.
+     * @param options Optional fetch options.
+     * @returns The GraphQL result.
+     */
+    graphql(query: string, operationName?: string | null, variables?: any, options?: RequestInit): Promise<any>;
     getActiveLogin(): LoginState | undefined;
     setActiveLogin(login: LoginState): Promise<void>;
     getAccessToken(): string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medplum/core",
-  "version": "0.9.18",
+  "version": "0.9.19",
   "description": "Medplum TS/JS Library",
   "author": "Medplum <hello@medplum.com>",
   "license": "Apache-2.0",
@@ -17,8 +17,8 @@
     "test": "jest"
   },
   "devDependencies": {
-    "@medplum/definitions": "0.9.18",
-    "@medplum/fhirtypes": "0.9.18"
+    "@medplum/definitions": "0.9.19",
+    "@medplum/fhirtypes": "0.9.19"
   },
   "peerDependencies": {
     "pdfmake": "0.2.5"