@medplum/core 5.0.11 → 5.0.13

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 {
@@ -370,6 +371,22 @@ export declare interface BotEvent<T = unknown> {
     readonly requester?: Reference<Bot | ClientApplication | Patient | Practitioner | RelatedPerson>;
     /** Headers from the original request, when invoked by HTTP request */
     readonly headers?: Record<string, string | string[] | undefined>;
+    /** Optional response stream when invoked with SSE (Server Side Events) */
+    readonly responseStream?: BotResponseStream;
+}
+
+/**
+ * Response stream interface for bot streaming responses.
+ * Compatible with both VMContext and AWS Lambda runtimes.
+ */
+export declare interface BotResponseStream extends NodeJS.WritableStream {
+    /**
+     * Starts streaming with the given status code and headers.
+     * Must be called before write() to commit the HTTP response.
+     * @param statusCode - HTTP status code (e.g., 200)
+     * @param headers - HTTP headers to send
+     */
+    startStreaming(statusCode: number, headers: Record<string, string>): void;
 }
 
 /**
@@ -2770,6 +2787,17 @@ 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 usage:
+ *   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.
@@ -3855,7 +3883,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param reference - The FHIR reference.
      * @returns The resource if it is available in the cache; undefined otherwise.
      */
-    getCachedReference<T extends Resource>(reference: Reference<T>): T | undefined;
+    getCachedReference<T extends Resource>(reference: Reference<T>): WithId<T> | undefined;
     /**
      * Reads a resource by resource type and ID.
      *
@@ -5978,9 +6006,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.
@@ -6162,6 +6191,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'>;
@@ -6459,6 +6494,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'>;
@@ -7104,6 +7148,7 @@ export declare class ParserBuilder {
      collect?: {
          tokens?: Record<string, TypedValueWithPath[]>;
      };
+     base64BinaryMaxBytes?: number;
  }
 
  export declare type ValueOrExternalSecret<T extends ExternalSecretPrimitive> = T | ExternalSecret<T>;

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 {
@@ -370,6 +371,22 @@ export declare interface BotEvent<T = unknown> {
     readonly requester?: Reference<Bot | ClientApplication | Patient | Practitioner | RelatedPerson>;
     /** Headers from the original request, when invoked by HTTP request */
     readonly headers?: Record<string, string | string[] | undefined>;
+    /** Optional response stream when invoked with SSE (Server Side Events) */
+    readonly responseStream?: BotResponseStream;
+}
+
+/**
+ * Response stream interface for bot streaming responses.
+ * Compatible with both VMContext and AWS Lambda runtimes.
+ */
+export declare interface BotResponseStream extends NodeJS.WritableStream {
+    /**
+     * Starts streaming with the given status code and headers.
+     * Must be called before write() to commit the HTTP response.
+     * @param statusCode - HTTP status code (e.g., 200)
+     * @param headers - HTTP headers to send
+     */
+    startStreaming(statusCode: number, headers: Record<string, string>): void;
 }
 
 /**
@@ -2770,6 +2787,17 @@ 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 usage:
+ *   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.
@@ -3855,7 +3883,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param reference - The FHIR reference.
      * @returns The resource if it is available in the cache; undefined otherwise.
      */
-    getCachedReference<T extends Resource>(reference: Reference<T>): T | undefined;
+    getCachedReference<T extends Resource>(reference: Reference<T>): WithId<T> | undefined;
     /**
      * Reads a resource by resource type and ID.
      *
@@ -5978,9 +6006,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.
@@ -6162,6 +6191,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'>;
@@ -6459,6 +6494,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'>;
@@ -7104,6 +7148,7 @@ export declare class ParserBuilder {
      collect?: {
          tokens?: Record<string, TypedValueWithPath[]>;
      };
+     base64BinaryMaxBytes?: number;
  }
 
  export declare type ValueOrExternalSecret<T extends ExternalSecretPrimitive> = T | ExternalSecret<T>;