@medplum/fhir-router 5.1.26 → 5.1.27

package/dist/cjs/index.d.ts

@@ -11,6 +11,7 @@ import { OperationOutcomeError } from '@medplum/core';
 import type { Parameters as Parameters_2 } from '@medplum/fhirtypes';
 import type { Reference } from '@medplum/fhirtypes';
 import type { Resource } from '@medplum/fhirtypes';
+import type { ResourceType } from '@medplum/fhirtypes';
 import type { SearchRequest } from '@medplum/core';
 import type { WithId } from '@medplum/core';
 
@@ -73,13 +74,8 @@ export declare class BatchProcessor {
     private readonly req;
     private resolvedIdentities;
     private bundleInfo;
-    private resultEntries;
-    /** Index into `bundleInfo.ordering` of the next entry to process. */
-    private position;
-    /** Indices (into the original bundle) of results produced since the last {@link BatchProcessor.takePendingResults} call. */
-    private pendingIndices;
-    /** Error messages accumulated across processed entries, for the post-batch telemetry event. */
-    private readonly errors;
+    /** The state mutated through processing (and preprocessing) */
+    private state;
     /**
      * Creates a batch processor.
      * @param router - The FHIR router.
@@ -157,7 +153,6 @@ export declare class BatchProcessor {
      * Scans the Bundle in order to ensure entries are processed in the correct sequence,
      * as well as to identify any operations that might require specific handling.
      *
-     * @param results - The array of result entries, to track partial results.
      * @returns The information gathered from scanning the Bundle.
      */
     private preprocessBundle;
@@ -232,11 +227,12 @@ export declare class BatchProcessor {
  */
 export declare function buildBatchResponseBundle(bundleType: Bundle['type'], entryCount: number, results: Record<number, BundleEntry>): Bundle;
 
-export declare type BundlePreprocessInfo = {
+export declare interface BundlePreprocessInfo {
     ordering: number[];
     requiresStrongTransaction: boolean;
     updates: number;
-};
+    resourceTypes: Set<ResourceType>;
+}
 
 export declare function createResourceImpl<T extends Resource>(resourceType: T['resourceType'], resource: T, repo: FhirRepository, options?: CreateResourceOptions): Promise<FhirResponse>;
 
@@ -377,10 +373,10 @@ export declare abstract class FhirRepository {
      * Runs a callback function within a transaction.
      *
      * @param callback - The callback function to be run within a transaction.
+     * @param options - The transaction options.
+     * @returns The result of the callback function.
      */
-    abstract withTransaction<TResult>(callback: (txRepo: this) => Promise<TResult>, options?: {
-        serializable?: boolean;
-    }): Promise<TResult>;
+    abstract withTransaction<TResult>(callback: (txRepo: this) => Promise<TResult>, options: TransactionOptions): Promise<TResult>;
     /**
      * Searches for a single FHIR resource.
      *
@@ -483,7 +479,9 @@ export declare type FhirRequestConfig = {
     transactions?: boolean;
 };
 
-export declare type FhirResponse = [OperationOutcome] | [OperationOutcome, Resource] | [OperationOutcome, Resource, FhirResponseOptions];
+export declare type FhirResponse = [
+OperationOutcome
+] | [OperationOutcome, Resource] | [OperationOutcome, Resource, FhirResponseOptions];
 
 export declare type FhirResponseOptions = {
     contentType?: string;
@@ -527,6 +525,7 @@ export declare class MemoryRepository extends FhirRepository {
     withSeeding<T>(fn: () => T | Promise<T>): Promise<T>;
     clear(): void;
     setMode(_mode: RepositoryMode): void;
+    private createResourceSync;
     createResource<T extends Resource>(resource: T, options?: CreateResourceOptions, update?: boolean): Promise<WithId<T>>;
     generateId(): string;
     updateResource<T extends Resource>(resource: T, options?: UpdateResourceOptions): Promise<WithId<T>>;
@@ -536,7 +535,12 @@ export declare class MemoryRepository extends FhirRepository {
     readReferences<T extends Resource>(references: readonly Reference<T>[]): Promise<(T | OperationOutcomeError)[]>;
     readHistory<T extends Resource>(resourceType: string, id: string): Promise<Bundle<T>>;
     readVersion<T extends Resource>(resourceType: string, id: string, versionId: string): Promise<T>;
+    private searchSync;
     search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<WithId<T>>>;
+    conditionalCreate<T extends Resource>(resource: T, search: SearchRequest<T>, options?: CreateResourceOptions): Promise<{
+        resource: WithId<T>;
+        outcome: OperationOutcome;
+    }>;
     searchByReference<T extends Resource>(searchRequest: SearchRequest<T>, referenceField: string, references: string[]): Promise<Record<string, WithId<T>[]>>;
     deleteResource(resourceType: string, id: string): Promise<void>;
     withTransaction<TResult>(callback: (repo: this) => Promise<TResult>): Promise<TResult>;
@@ -571,6 +575,8 @@ export declare const RepositoryMode: {
 
 export declare type RepositoryMode = (typeof RepositoryMode)[keyof typeof RepositoryMode];
 
+declare type ResourceTypeInput = ResourceType | readonly ResourceType[] | ReadonlySet<ResourceType>;
+
 /** @see http://hl7.org/fhir/R4/codesystem-restful-interaction.html */
 export declare type RestInteraction = CapabilityStatementRestInteraction['code'] | CapabilityStatementRestResourceInteraction['code'] | 'operation';
 
@@ -595,6 +601,11 @@ export declare type RouteResult<Handler, Metadata> = {
     data?: Metadata;
 };
 
+export declare interface TransactionOptions {
+    readonly resourceTypes: ResourceTypeInput;
+    readonly serializable?: boolean;
+}
+
 export declare function updateResourceImpl<T extends Resource>(resourceType: T['resourceType'], id: string, resource: T, repo: FhirRepository, options?: UpdateResourceOptions): Promise<FhirResponse>;
 
 export declare type UpdateResourceOptions = {

package/dist/esm/index.d.ts

@@ -11,6 +11,7 @@ import { OperationOutcomeError } from '@medplum/core';
 import type { Parameters as Parameters_2 } from '@medplum/fhirtypes';
 import type { Reference } from '@medplum/fhirtypes';
 import type { Resource } from '@medplum/fhirtypes';
+import type { ResourceType } from '@medplum/fhirtypes';
 import type { SearchRequest } from '@medplum/core';
 import type { WithId } from '@medplum/core';
 
@@ -73,13 +74,8 @@ export declare class BatchProcessor {
     private readonly req;
     private resolvedIdentities;
     private bundleInfo;
-    private resultEntries;
-    /** Index into `bundleInfo.ordering` of the next entry to process. */
-    private position;
-    /** Indices (into the original bundle) of results produced since the last {@link BatchProcessor.takePendingResults} call. */
-    private pendingIndices;
-    /** Error messages accumulated across processed entries, for the post-batch telemetry event. */
-    private readonly errors;
+    /** The state mutated through processing (and preprocessing) */
+    private state;
     /**
      * Creates a batch processor.
      * @param router - The FHIR router.
@@ -157,7 +153,6 @@ export declare class BatchProcessor {
      * Scans the Bundle in order to ensure entries are processed in the correct sequence,
      * as well as to identify any operations that might require specific handling.
      *
-     * @param results - The array of result entries, to track partial results.
      * @returns The information gathered from scanning the Bundle.
      */
     private preprocessBundle;
@@ -232,11 +227,12 @@ export declare class BatchProcessor {
  */
 export declare function buildBatchResponseBundle(bundleType: Bundle['type'], entryCount: number, results: Record<number, BundleEntry>): Bundle;
 
-export declare type BundlePreprocessInfo = {
+export declare interface BundlePreprocessInfo {
     ordering: number[];
     requiresStrongTransaction: boolean;
     updates: number;
-};
+    resourceTypes: Set<ResourceType>;
+}
 
 export declare function createResourceImpl<T extends Resource>(resourceType: T['resourceType'], resource: T, repo: FhirRepository, options?: CreateResourceOptions): Promise<FhirResponse>;
 
@@ -377,10 +373,10 @@ export declare abstract class FhirRepository {
      * Runs a callback function within a transaction.
      *
      * @param callback - The callback function to be run within a transaction.
+     * @param options - The transaction options.
+     * @returns The result of the callback function.
      */
-    abstract withTransaction<TResult>(callback: (txRepo: this) => Promise<TResult>, options?: {
-        serializable?: boolean;
-    }): Promise<TResult>;
+    abstract withTransaction<TResult>(callback: (txRepo: this) => Promise<TResult>, options: TransactionOptions): Promise<TResult>;
     /**
      * Searches for a single FHIR resource.
      *
@@ -483,7 +479,9 @@ export declare type FhirRequestConfig = {
     transactions?: boolean;
 };
 
-export declare type FhirResponse = [OperationOutcome] | [OperationOutcome, Resource] | [OperationOutcome, Resource, FhirResponseOptions];
+export declare type FhirResponse = [
+OperationOutcome
+] | [OperationOutcome, Resource] | [OperationOutcome, Resource, FhirResponseOptions];
 
 export declare type FhirResponseOptions = {
     contentType?: string;
@@ -527,6 +525,7 @@ export declare class MemoryRepository extends FhirRepository {
     withSeeding<T>(fn: () => T | Promise<T>): Promise<T>;
     clear(): void;
     setMode(_mode: RepositoryMode): void;
+    private createResourceSync;
     createResource<T extends Resource>(resource: T, options?: CreateResourceOptions, update?: boolean): Promise<WithId<T>>;
     generateId(): string;
     updateResource<T extends Resource>(resource: T, options?: UpdateResourceOptions): Promise<WithId<T>>;
@@ -536,7 +535,12 @@ export declare class MemoryRepository extends FhirRepository {
     readReferences<T extends Resource>(references: readonly Reference<T>[]): Promise<(T | OperationOutcomeError)[]>;
     readHistory<T extends Resource>(resourceType: string, id: string): Promise<Bundle<T>>;
     readVersion<T extends Resource>(resourceType: string, id: string, versionId: string): Promise<T>;
+    private searchSync;
     search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<WithId<T>>>;
+    conditionalCreate<T extends Resource>(resource: T, search: SearchRequest<T>, options?: CreateResourceOptions): Promise<{
+        resource: WithId<T>;
+        outcome: OperationOutcome;
+    }>;
     searchByReference<T extends Resource>(searchRequest: SearchRequest<T>, referenceField: string, references: string[]): Promise<Record<string, WithId<T>[]>>;
     deleteResource(resourceType: string, id: string): Promise<void>;
     withTransaction<TResult>(callback: (repo: this) => Promise<TResult>): Promise<TResult>;
@@ -571,6 +575,8 @@ export declare const RepositoryMode: {
 
 export declare type RepositoryMode = (typeof RepositoryMode)[keyof typeof RepositoryMode];
 
+declare type ResourceTypeInput = ResourceType | readonly ResourceType[] | ReadonlySet<ResourceType>;
+
 /** @see http://hl7.org/fhir/R4/codesystem-restful-interaction.html */
 export declare type RestInteraction = CapabilityStatementRestInteraction['code'] | CapabilityStatementRestResourceInteraction['code'] | 'operation';
 
@@ -595,6 +601,11 @@ export declare type RouteResult<Handler, Metadata> = {
     data?: Metadata;
 };
 
+export declare interface TransactionOptions {
+    readonly resourceTypes: ResourceTypeInput;
+    readonly serializable?: boolean;
+}
+
 export declare function updateResourceImpl<T extends Resource>(resourceType: T['resourceType'], id: string, resource: T, repo: FhirRepository, options?: UpdateResourceOptions): Promise<FhirResponse>;
 
 export declare type UpdateResourceOptions = {