@medplum/core 5.0.12 → 5.0.14

package/dist/cjs/index.d.ts

@@ -181,6 +181,7 @@ export declare interface AgentTransmitRequest extends BaseAgentRequestMessage {
     remote: string;
     contentType: string;
     body: string;
+    returnAck?: ReturnAckCategory;
 }
 
 export declare interface AgentTransmitResponse extends BaseAgentMessage {
@@ -2786,6 +2787,19 @@ export declare function isDateString(input: unknown): input is string;
  */
 export declare function isDateTimeString(input: unknown): input is string;
 
+/**
+ * Helper function to narrow a type by excluding undefined/null values.
+ * @param value - The value to refine
+ * @returns boolean
+ *
+ * @example
+ * ```typescript
+ * const arr: Array<number | undefined> = [1,undefined];
+ * const refined: Array<number> = arr.filter(isDefined);
+ * ```
+ */
+export declare function isDefined<T>(value: T | undefined | null): value is T;
+
 /**
  * Returns true if the value is empty (null, undefined, empty string, or empty object).
  * @param v - Any value.
@@ -3560,7 +3574,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns Promise to the response content.
      */
-    post(url: URL | string, body?: any, contentType?: string, options?: MedplumRequestOptions): Promise<any>;
+    post<T = any>(url: URL | string, body?: any, contentType?: string, options?: MedplumRequestOptions): Promise<T>;
     /**
      * Makes an HTTP PUT request to the specified URL.
      *
@@ -3693,10 +3707,11 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * Exchange an external access token for a Medplum access token.
      * @param token - The access token that was generated by the external identity provider.
      * @param clientId - The ID of the `ClientApplication` in your Medplum project that will be making the exchange request.
+     * @param membershipId - Optional membership ID to restrict the exchange to a specific ProjectMembership.
      * @returns The user profile resource.
      * @category Authentication
      */
-    exchangeExternalAccessToken(token: string, clientId?: string): Promise<ProfileResource>;
+    exchangeExternalAccessToken(token: string, clientId?: string, membershipId?: string): Promise<ProfileResource>;
     /**
      * Builds the external identity provider redirect URI.
      * @param authorizeUrl - The external authorization URL.
@@ -5994,9 +6009,10 @@ export declare class ParserBuilder {
   * @see https://hl7.org/fhir/fhir-xquery.html
   * @param query - The X-Fhir-Query string to parse
   * @param variables - Values to pass into embedded FHIRPath expressions
+  * @param context - The context collection to evaluate over
   * @returns The parsed search request
   */
- export declare function parseXFhirQuery(query: string, variables: Record<string, TypedValue>): SearchRequest;
+ export declare function parseXFhirQuery(query: string, variables: Record<string, TypedValue>, context?: TypedValue[]): SearchRequest;
 
  /**
   * JSONPatch patch operation.
@@ -6178,6 +6194,12 @@ export declare class ParserBuilder {
       * Time to wait before request timeout in milliseconds; defaults to `10000` (10 s)
       */
      waitTimeout?: number;
+     /**
+      * The ACK-level that the agent should wait for when sending HL7 messages.
+      * - `'first'`: Return on the first ACK message received (default)
+      * - `'application'`: Wait for application-level ACK (AA), skipping commit ACKs (CA)
+      */
+     returnAck?: ReturnAckCategory;
  }
 
  export declare type QuantityUnit = Pick<Quantity, 'unit' | 'code' | 'system'>;
@@ -6475,6 +6497,15 @@ export declare class ParserBuilder {
 
  export declare type ResourceWithCode = Resource & Code;
 
+ export declare const ReturnAckCategory: {
+     /** The first ACK message received is the one returned */
+     readonly FIRST: "first";
+     /** Only return upon receiving a positive application-level ACK (AA, AE, or AR), or if a commit-level error occurred */
+     readonly APPLICATION: "application";
+ };
+
+ export declare type ReturnAckCategory = (typeof ReturnAckCategory)[keyof typeof ReturnAckCategory];
+
  export declare const RXNORM = "http://www.nlm.nih.gov/research/umls/rxnorm";
 
  export declare type SamplingInfo = Omit<SampledData, 'data'>;
@@ -6591,10 +6622,16 @@ export declare class ParserBuilder {
   * @param resource - The resource to add the identifier to.
   * @param system - The identifier system.
   * @param value - The identifier value.
+  * @param options - Optional attributes to set
   */
  export declare function setIdentifier(resource: Resource & {
      identifier?: Identifier[];
- }, system: string, value: string): void;
+ }, system: string, value: string, options?: SetIdentifierOptions): void;
+
+ export declare interface SetIdentifierOptions {
+     /** IdentifierUse code. See {@link https://build.fhir.org/valueset-identifier-use.html} */
+     use?: Identifier['use'];
+ }
 
  export declare function singleton(collection: TypedValue[], type?: string): TypedValue | undefined;
 
@@ -6830,6 +6867,7 @@ export declare class ParserBuilder {
      reconnectWebSocket(): void;
      getCriteriaCount(): number;
      getMasterEmitter(): SubscriptionEmitter;
+     reconnectIfNeeded(): Promise<void>;
  }
 
  /**

package/dist/esm/index.d.ts

@@ -181,6 +181,7 @@ export declare interface AgentTransmitRequest extends BaseAgentRequestMessage {
     remote: string;
     contentType: string;
     body: string;
+    returnAck?: ReturnAckCategory;
 }
 
 export declare interface AgentTransmitResponse extends BaseAgentMessage {
@@ -2786,6 +2787,19 @@ export declare function isDateString(input: unknown): input is string;
  */
 export declare function isDateTimeString(input: unknown): input is string;
 
+/**
+ * Helper function to narrow a type by excluding undefined/null values.
+ * @param value - The value to refine
+ * @returns boolean
+ *
+ * @example
+ * ```typescript
+ * const arr: Array<number | undefined> = [1,undefined];
+ * const refined: Array<number> = arr.filter(isDefined);
+ * ```
+ */
+export declare function isDefined<T>(value: T | undefined | null): value is T;
+
 /**
  * Returns true if the value is empty (null, undefined, empty string, or empty object).
  * @param v - Any value.
@@ -3560,7 +3574,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param options - Optional fetch options.
      * @returns Promise to the response content.
      */
-    post(url: URL | string, body?: any, contentType?: string, options?: MedplumRequestOptions): Promise<any>;
+    post<T = any>(url: URL | string, body?: any, contentType?: string, options?: MedplumRequestOptions): Promise<T>;
     /**
      * Makes an HTTP PUT request to the specified URL.
      *
@@ -3693,10 +3707,11 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * Exchange an external access token for a Medplum access token.
      * @param token - The access token that was generated by the external identity provider.
      * @param clientId - The ID of the `ClientApplication` in your Medplum project that will be making the exchange request.
+     * @param membershipId - Optional membership ID to restrict the exchange to a specific ProjectMembership.
      * @returns The user profile resource.
      * @category Authentication
      */
-    exchangeExternalAccessToken(token: string, clientId?: string): Promise<ProfileResource>;
+    exchangeExternalAccessToken(token: string, clientId?: string, membershipId?: string): Promise<ProfileResource>;
     /**
      * Builds the external identity provider redirect URI.
      * @param authorizeUrl - The external authorization URL.
@@ -5994,9 +6009,10 @@ export declare class ParserBuilder {
   * @see https://hl7.org/fhir/fhir-xquery.html
   * @param query - The X-Fhir-Query string to parse
   * @param variables - Values to pass into embedded FHIRPath expressions
+  * @param context - The context collection to evaluate over
   * @returns The parsed search request
   */
- export declare function parseXFhirQuery(query: string, variables: Record<string, TypedValue>): SearchRequest;
+ export declare function parseXFhirQuery(query: string, variables: Record<string, TypedValue>, context?: TypedValue[]): SearchRequest;
 
  /**
   * JSONPatch patch operation.
@@ -6178,6 +6194,12 @@ export declare class ParserBuilder {
       * Time to wait before request timeout in milliseconds; defaults to `10000` (10 s)
       */
      waitTimeout?: number;
+     /**
+      * The ACK-level that the agent should wait for when sending HL7 messages.
+      * - `'first'`: Return on the first ACK message received (default)
+      * - `'application'`: Wait for application-level ACK (AA), skipping commit ACKs (CA)
+      */
+     returnAck?: ReturnAckCategory;
  }
 
  export declare type QuantityUnit = Pick<Quantity, 'unit' | 'code' | 'system'>;
@@ -6475,6 +6497,15 @@ export declare class ParserBuilder {
 
  export declare type ResourceWithCode = Resource & Code;
 
+ export declare const ReturnAckCategory: {
+     /** The first ACK message received is the one returned */
+     readonly FIRST: "first";
+     /** Only return upon receiving a positive application-level ACK (AA, AE, or AR), or if a commit-level error occurred */
+     readonly APPLICATION: "application";
+ };
+
+ export declare type ReturnAckCategory = (typeof ReturnAckCategory)[keyof typeof ReturnAckCategory];
+
  export declare const RXNORM = "http://www.nlm.nih.gov/research/umls/rxnorm";
 
  export declare type SamplingInfo = Omit<SampledData, 'data'>;
@@ -6591,10 +6622,16 @@ export declare class ParserBuilder {
   * @param resource - The resource to add the identifier to.
   * @param system - The identifier system.
   * @param value - The identifier value.
+  * @param options - Optional attributes to set
   */
  export declare function setIdentifier(resource: Resource & {
      identifier?: Identifier[];
- }, system: string, value: string): void;
+ }, system: string, value: string, options?: SetIdentifierOptions): void;
+
+ export declare interface SetIdentifierOptions {
+     /** IdentifierUse code. See {@link https://build.fhir.org/valueset-identifier-use.html} */
+     use?: Identifier['use'];
+ }
 
  export declare function singleton(collection: TypedValue[], type?: string): TypedValue | undefined;
 
@@ -6830,6 +6867,7 @@ export declare class ParserBuilder {
      reconnectWebSocket(): void;
      getCriteriaCount(): number;
      getMasterEmitter(): SubscriptionEmitter;
+     reconnectIfNeeded(): Promise<void>;
  }
 
  /**