@medplum/fhir-router 3.2.10 → 3.2.12

package/dist/cjs/index.d.ts

@@ -1,4 +1,6 @@
 import { Bundle } from '@medplum/fhirtypes';
+import { CapabilityStatementRestInteraction } from '@medplum/fhirtypes';
+import { CapabilityStatementRestResourceInteraction } from '@medplum/fhirtypes';
 import { Event as Event_2 } from '@medplum/core';
 import { EventTarget as EventTarget_2 } from '@medplum/core';
 import type { IncomingHttpHeaders } from 'node:http';
@@ -9,41 +11,6 @@ import { Reference } from '@medplum/fhirtypes';
 import { Resource } from '@medplum/fhirtypes';
 import { SearchRequest } from '@medplum/core';
 
-export declare abstract class BaseRepository {
-    /**
-     * Searches for FHIR resources.
-     *
-     * See: https://www.hl7.org/fhir/http.html#search
-     * @param searchRequest - The FHIR search request.
-     * @returns The search results.
-     */
-    abstract search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<T>>;
-    /**
-     * Searches for a single FHIR resource.
-     *
-     * This is a convenience method for `search()` that returns the first resource rather than a `Bundle`.
-     *
-     * The return value is the resource, if available; otherwise, undefined.
-     *
-     * See FHIR search for full details: https://www.hl7.org/fhir/search.html
-     * @param searchRequest - The FHIR search request.
-     * @returns Promise to the first search result or undefined.
-     */
-    searchOne<T extends Resource>(searchRequest: SearchRequest<T>): Promise<T | undefined>;
-    /**
-     * Sends a FHIR search request for an array of resources.
-     *
-     * This is a convenience method for `search()` that returns the resources as an array rather than a `Bundle`.
-     *
-     * The return value is an array of resources.
-     *
-     * See FHIR search for full details: https://www.hl7.org/fhir/search.html
-     * @param searchRequest - The FHIR search request.
-     * @returns Promise to the array of search results.
-     */
-    searchResources<T extends Resource>(searchRequest: SearchRequest<T>): Promise<T[]>;
-}
-
 export declare interface BatchEvent extends Event_2 {
     bundleType: Bundle['type'];
     count?: number;
@@ -51,19 +18,27 @@ export declare interface BatchEvent extends Event_2 {
     size?: number;
 }
 
+export declare function createResourceImpl<T extends Resource>(resourceType: T['resourceType'], resource: T, repo: FhirRepository, options?: CreateResourceOptions): Promise<FhirResponse>;
+
+export declare type CreateResourceOptions = {
+    assignedId?: boolean;
+};
+
 export declare interface FhirOptions {
     introspectionEnabled?: boolean;
 }
 
 /**
- * The FhirRepository interface defines the methods that are required to implement a FHIR repository.
+ * The FhirRepository abstract class defines the methods that are required to implement a FHIR repository.
  * A FHIR repository is responsible for storing and retrieving FHIR resources.
  * It is used by the FHIR router to implement the FHIR REST API.
  * The primary implementations at this time are:
  *  1. MemoryRepository - A repository that stores resources in memory.
  *  2. Server Repository - A repository that stores resources in a relational database.
+ * Additionally, several convenience method implementations are provided to offer advanced functionality on top of the
+ * abstract basic operations.
  */
-export declare interface FhirRepository<TClient = unknown> {
+export declare abstract class FhirRepository<TClient = unknown> {
     /**
      * Sets the repository mode.
      * In general, it is assumed that repositories will start in "reader" mode,
@@ -72,7 +47,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * but after using "writer" once it should use "writer" exclusively.
      * @param mode - The repository mode.
      */
-    setMode(mode: RepositoryMode): void;
+    abstract setMode(mode: RepositoryMode): void;
     /**
      * Creates a FHIR resource.
      *
@@ -80,7 +55,14 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param resource - The FHIR resource to create.
      * @returns The created resource.
      */
-    createResource<T extends Resource>(resource: T): Promise<T>;
+    abstract createResource<T extends Resource>(resource: T, options?: CreateResourceOptions): Promise<T>;
+    /**
+     * Generates a new unique ID for a resource.
+     *
+     * See: https://www.hl7.org/fhir/R4/resource.html#id
+     * @returns The ID string.
+     */
+    abstract generateId(): string;
     /**
      * Reads a FHIR resource by ID.
      *
@@ -89,7 +71,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param id - The FHIR resource ID.
      * @returns The FHIR resource.
      */
-    readResource<T extends Resource>(resourceType: string, id: string): Promise<T>;
+    abstract readResource<T extends Resource>(resourceType: string, id: string): Promise<T>;
     /**
      * Reads a FHIR resource by reference.
      *
@@ -97,7 +79,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param reference - The FHIR reference.
      * @returns The FHIR resource.
      */
-    readReference<T extends Resource>(reference: Reference<T>): Promise<T>;
+    abstract readReference<T extends Resource>(reference: Reference<T>): Promise<T>;
     /**
      * Reads a collection of FHIR resources by reference.
      *
@@ -105,7 +87,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param references - The FHIR references.
      * @returns The FHIR resources.
      */
-    readReferences(references: readonly Reference[]): Promise<(Resource | Error)[]>;
+    abstract readReferences(references: readonly Reference[]): Promise<(Resource | Error)[]>;
     /**
      * Returns resource history.
      *
@@ -116,7 +98,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param id - The FHIR resource ID.
      * @returns Operation outcome and a history bundle.
      */
-    readHistory<T extends Resource>(resourceType: string, id: string): Promise<Bundle<T>>;
+    abstract readHistory<T extends Resource>(resourceType: string, id: string): Promise<Bundle<T>>;
     /**
      * Reads a FHIR resource version.
      *
@@ -125,7 +107,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param id - The FHIR resource ID.
      * @param vid - The FHIR resource version ID.
      */
-    readVersion<T extends Resource>(resourceType: string, id: string, vid: string): Promise<T>;
+    abstract readVersion<T extends Resource>(resourceType: string, id: string, vid: string): Promise<T>;
     /**
      * Updates a FHIR resource.
      *
@@ -133,19 +115,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param resource - The FHIR resource to update.
      * @returns The updated resource.
      */
-    updateResource<T extends Resource>(resource: T, versionId?: string): Promise<T>;
-    /**
-     * Creates or updates a resource based on a search criteria.
-     *
-     * See: https://www.hl7.org/fhir/http.html#cond-update
-     * @param resource - The FHIR resource to create or update.
-     * @param search - The search criteria to find an existing resource to update.
-     * @returns The updated resource.
-     */
-    conditionalUpdate<T extends Resource>(resource: T, search: SearchRequest): Promise<{
-        resource: T;
-        outcome: OperationOutcome;
-    }>;
+    abstract updateResource<T extends Resource>(resource: T, options?: UpdateResourceOptions): Promise<T>;
     /**
      * Deletes a FHIR resource.
      *
@@ -153,7 +123,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param resourceType - The FHIR resource type.
      * @param id - The FHIR resource ID.
      */
-    deleteResource(resourceType: string, id: string): Promise<void>;
+    abstract deleteResource(resourceType: string, id: string): Promise<void>;
     /**
      * Patches a FHIR resource.
      *
@@ -163,7 +133,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param patch - The JSONPatch operations.
      * @returns The patched resource.
      */
-    patchResource(resourceType: string, id: string, patch: Operation[]): Promise<Resource>;
+    abstract patchResource(resourceType: string, id: string, patch: Operation[]): Promise<Resource>;
     /**
      * Searches for FHIR resources.
      *
@@ -171,8 +141,16 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param searchRequest - The FHIR search request.
      * @returns The search results.
      */
-    search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<T>>;
-    searchByReference<T extends Resource>(searchRequest: SearchRequest<T>, referenceField: string, references: string[]): Promise<Record<string, T[]>>;
+    abstract search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<T>>;
+    abstract searchByReference<T extends Resource>(searchRequest: SearchRequest<T>, referenceField: string, references: string[]): Promise<Record<string, T[]>>;
+    /**
+     * Runs a callback function within a transaction.
+     *
+     * @param callback - The callback function to be run within a transaction.
+     */
+    abstract withTransaction<TResult>(callback: (client: TClient) => Promise<TResult>, options?: {
+        serializable?: boolean;
+    }): Promise<TResult>;
     /**
      * Searches for a single FHIR resource.
      *
@@ -197,12 +175,15 @@ export declare interface FhirRepository<TClient = unknown> {
      * @returns Promise to the array of search results.
      */
     searchResources<T extends Resource>(searchRequest: SearchRequest<T>): Promise<T[]>;
-    /**
-     * Runs a callback function within a transaction.
-     *
-     * @param callback - The callback function to be run within a transaction.
-     */
-    withTransaction<TResult>(callback: (client: TClient) => Promise<TResult>): Promise<TResult>;
+    conditionalCreate<T extends Resource>(resource: T, search: SearchRequest<T>, options?: CreateResourceOptions): Promise<{
+        resource: T;
+        outcome: OperationOutcome;
+    }>;
+    conditionalUpdate<T extends Resource>(resource: T, search: SearchRequest, options?: CreateResourceOptions & UpdateResourceOptions): Promise<{
+        resource: T;
+        outcome: OperationOutcome;
+    }>;
+    conditionalDelete(search: SearchRequest): Promise<void>;
 }
 
 export declare type FhirRequest = {
@@ -220,17 +201,27 @@ export declare type FhirRequestConfig = {
     graphqlMaxDepth?: number;
     graphqlMaxPageSize?: number;
     graphqlMaxSearches?: number;
+    transactions?: boolean;
 };
 
 export declare type FhirResponse = [OperationOutcome] | [OperationOutcome, Resource];
 
-export declare type FhirRouteHandler = (req: FhirRequest, repo: FhirRepository, router: FhirRouter) => Promise<FhirResponse>;
+export declare type FhirRouteHandler = (req: FhirRequest, repo: FhirRepository, router: FhirRouter, options?: FhirRouteOptions) => Promise<FhirResponse>;
+
+export declare type FhirRouteMetadata = {
+    interaction: RestInteraction;
+};
+
+export declare type FhirRouteOptions = {
+    batch?: boolean;
+};
 
 export declare class FhirRouter extends EventTarget_2 {
-    readonly router: Router<FhirRouteHandler>;
+    readonly router: Router<FhirRouteHandler, FhirRouteMetadata>;
     readonly options: FhirOptions;
     constructor(options?: {});
-    add(method: HttpMethod, path: string, handler: FhirRouteHandler): void;
+    add(method: HttpMethod, path: string, handler: FhirRouteHandler, interaction?: RestInteraction): void;
+    find(method: HttpMethod, path: string): RouteResult<FhirRouteHandler, FhirRouteMetadata> | undefined;
     handleRequest(req: FhirRequest, repo: FhirRepository): Promise<FhirResponse>;
     log(level: string, message: string, data?: Record<string, any>): void;
 }
@@ -242,18 +233,15 @@ export declare interface LogEvent extends Event_2 {
     data?: Record<string, any>;
 }
 
-export declare class MemoryRepository extends BaseRepository implements FhirRepository {
+export declare class MemoryRepository extends FhirRepository<undefined> {
     private readonly resources;
     private readonly history;
     constructor();
     clear(): void;
     setMode(_mode: RepositoryMode): void;
     createResource<T extends Resource>(resource: T): Promise<T>;
-    updateResource<T extends Resource>(resource: T, versionId?: string): Promise<T>;
-    conditionalUpdate<T extends Resource>(resource: T, search: SearchRequest): Promise<{
-        resource: T;
-        outcome: OperationOutcome;
-    }>;
+    generateId(): string;
+    updateResource<T extends Resource>(resource: T, options?: UpdateResourceOptions): Promise<T>;
     patchResource(resourceType: string, id: string, patch: Operation[]): Promise<Resource>;
     readResource<T extends Resource>(resourceType: string, id: string): Promise<T>;
     readReference<T extends Resource>(reference: Reference<T>): Promise<T>;
@@ -263,7 +251,7 @@ export declare class MemoryRepository extends BaseRepository implements FhirRepo
     search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<T>>;
     searchByReference<T extends Resource>(searchRequest: SearchRequest<T>, referenceField: string, references: string[]): Promise<Record<string, T[]>>;
     deleteResource(resourceType: string, id: string): Promise<void>;
-    withTransaction<TResult>(callback: (client: unknown) => Promise<TResult>): Promise<TResult>;
+    withTransaction<TResult>(callback: (client: undefined) => Promise<TResult>): Promise<TResult>;
 }
 
 export declare type PathSegment = {
@@ -276,21 +264,32 @@ export declare enum RepositoryMode {
     WRITER = "writer"
 }
 
-export declare type Route<T> = {
+/** @see http://hl7.org/fhir/R4/codesystem-restful-interaction.html */
+export declare type RestInteraction = CapabilityStatementRestInteraction['code'] | CapabilityStatementRestResourceInteraction['code'] | 'operation';
+
+export declare type Route<Handler, Metadata> = {
     method: HttpMethod;
     path: PathSegment[];
-    handler: T;
+    handler: Handler;
+    data?: Metadata;
 };
 
-export declare class Router<T> {
-    readonly routes: Route<T>[];
-    add(method: HttpMethod, pathStr: string, handler: T): void;
-    find(method: HttpMethod, pathStr: string): RouteResult<T> | undefined;
+export declare class Router<Handler, Metadata> {
+    readonly routes: Route<Handler, Metadata>[];
+    add(method: HttpMethod, pathStr: string, handler: Handler, data?: Metadata): void;
+    find(method: HttpMethod, pathStr: string): RouteResult<Handler, Metadata> | undefined;
 }
 
-export declare type RouteResult<T> = {
-    handler: T;
+export declare type RouteResult<Handler, Metadata> = {
+    handler: Handler;
     params: Record<string, string>;
+    data?: Metadata;
+};
+
+export declare function updateResourceImpl<T extends Resource>(resourceType: T['resourceType'], id: string, resource: T, repo: FhirRepository, options?: UpdateResourceOptions): Promise<FhirResponse>;
+
+export declare type UpdateResourceOptions = {
+    ifMatch?: string;
 };
 
 export { }

package/dist/esm/index.d.ts

@@ -1,4 +1,6 @@
 import { Bundle } from '@medplum/fhirtypes';
+import { CapabilityStatementRestInteraction } from '@medplum/fhirtypes';
+import { CapabilityStatementRestResourceInteraction } from '@medplum/fhirtypes';
 import { Event as Event_2 } from '@medplum/core';
 import { EventTarget as EventTarget_2 } from '@medplum/core';
 import type { IncomingHttpHeaders } from 'node:http';
@@ -9,41 +11,6 @@ import { Reference } from '@medplum/fhirtypes';
 import { Resource } from '@medplum/fhirtypes';
 import { SearchRequest } from '@medplum/core';
 
-export declare abstract class BaseRepository {
-    /**
-     * Searches for FHIR resources.
-     *
-     * See: https://www.hl7.org/fhir/http.html#search
-     * @param searchRequest - The FHIR search request.
-     * @returns The search results.
-     */
-    abstract search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<T>>;
-    /**
-     * Searches for a single FHIR resource.
-     *
-     * This is a convenience method for `search()` that returns the first resource rather than a `Bundle`.
-     *
-     * The return value is the resource, if available; otherwise, undefined.
-     *
-     * See FHIR search for full details: https://www.hl7.org/fhir/search.html
-     * @param searchRequest - The FHIR search request.
-     * @returns Promise to the first search result or undefined.
-     */
-    searchOne<T extends Resource>(searchRequest: SearchRequest<T>): Promise<T | undefined>;
-    /**
-     * Sends a FHIR search request for an array of resources.
-     *
-     * This is a convenience method for `search()` that returns the resources as an array rather than a `Bundle`.
-     *
-     * The return value is an array of resources.
-     *
-     * See FHIR search for full details: https://www.hl7.org/fhir/search.html
-     * @param searchRequest - The FHIR search request.
-     * @returns Promise to the array of search results.
-     */
-    searchResources<T extends Resource>(searchRequest: SearchRequest<T>): Promise<T[]>;
-}
-
 export declare interface BatchEvent extends Event_2 {
     bundleType: Bundle['type'];
     count?: number;
@@ -51,19 +18,27 @@ export declare interface BatchEvent extends Event_2 {
     size?: number;
 }
 
+export declare function createResourceImpl<T extends Resource>(resourceType: T['resourceType'], resource: T, repo: FhirRepository, options?: CreateResourceOptions): Promise<FhirResponse>;
+
+export declare type CreateResourceOptions = {
+    assignedId?: boolean;
+};
+
 export declare interface FhirOptions {
     introspectionEnabled?: boolean;
 }
 
 /**
- * The FhirRepository interface defines the methods that are required to implement a FHIR repository.
+ * The FhirRepository abstract class defines the methods that are required to implement a FHIR repository.
  * A FHIR repository is responsible for storing and retrieving FHIR resources.
  * It is used by the FHIR router to implement the FHIR REST API.
  * The primary implementations at this time are:
  *  1. MemoryRepository - A repository that stores resources in memory.
  *  2. Server Repository - A repository that stores resources in a relational database.
+ * Additionally, several convenience method implementations are provided to offer advanced functionality on top of the
+ * abstract basic operations.
  */
-export declare interface FhirRepository<TClient = unknown> {
+export declare abstract class FhirRepository<TClient = unknown> {
     /**
      * Sets the repository mode.
      * In general, it is assumed that repositories will start in "reader" mode,
@@ -72,7 +47,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * but after using "writer" once it should use "writer" exclusively.
      * @param mode - The repository mode.
      */
-    setMode(mode: RepositoryMode): void;
+    abstract setMode(mode: RepositoryMode): void;
     /**
      * Creates a FHIR resource.
      *
@@ -80,7 +55,14 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param resource - The FHIR resource to create.
      * @returns The created resource.
      */
-    createResource<T extends Resource>(resource: T): Promise<T>;
+    abstract createResource<T extends Resource>(resource: T, options?: CreateResourceOptions): Promise<T>;
+    /**
+     * Generates a new unique ID for a resource.
+     *
+     * See: https://www.hl7.org/fhir/R4/resource.html#id
+     * @returns The ID string.
+     */
+    abstract generateId(): string;
     /**
      * Reads a FHIR resource by ID.
      *
@@ -89,7 +71,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param id - The FHIR resource ID.
      * @returns The FHIR resource.
      */
-    readResource<T extends Resource>(resourceType: string, id: string): Promise<T>;
+    abstract readResource<T extends Resource>(resourceType: string, id: string): Promise<T>;
     /**
      * Reads a FHIR resource by reference.
      *
@@ -97,7 +79,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param reference - The FHIR reference.
      * @returns The FHIR resource.
      */
-    readReference<T extends Resource>(reference: Reference<T>): Promise<T>;
+    abstract readReference<T extends Resource>(reference: Reference<T>): Promise<T>;
     /**
      * Reads a collection of FHIR resources by reference.
      *
@@ -105,7 +87,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param references - The FHIR references.
      * @returns The FHIR resources.
      */
-    readReferences(references: readonly Reference[]): Promise<(Resource | Error)[]>;
+    abstract readReferences(references: readonly Reference[]): Promise<(Resource | Error)[]>;
     /**
      * Returns resource history.
      *
@@ -116,7 +98,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param id - The FHIR resource ID.
      * @returns Operation outcome and a history bundle.
      */
-    readHistory<T extends Resource>(resourceType: string, id: string): Promise<Bundle<T>>;
+    abstract readHistory<T extends Resource>(resourceType: string, id: string): Promise<Bundle<T>>;
     /**
      * Reads a FHIR resource version.
      *
@@ -125,7 +107,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param id - The FHIR resource ID.
      * @param vid - The FHIR resource version ID.
      */
-    readVersion<T extends Resource>(resourceType: string, id: string, vid: string): Promise<T>;
+    abstract readVersion<T extends Resource>(resourceType: string, id: string, vid: string): Promise<T>;
     /**
      * Updates a FHIR resource.
      *
@@ -133,19 +115,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param resource - The FHIR resource to update.
      * @returns The updated resource.
      */
-    updateResource<T extends Resource>(resource: T, versionId?: string): Promise<T>;
-    /**
-     * Creates or updates a resource based on a search criteria.
-     *
-     * See: https://www.hl7.org/fhir/http.html#cond-update
-     * @param resource - The FHIR resource to create or update.
-     * @param search - The search criteria to find an existing resource to update.
-     * @returns The updated resource.
-     */
-    conditionalUpdate<T extends Resource>(resource: T, search: SearchRequest): Promise<{
-        resource: T;
-        outcome: OperationOutcome;
-    }>;
+    abstract updateResource<T extends Resource>(resource: T, options?: UpdateResourceOptions): Promise<T>;
     /**
      * Deletes a FHIR resource.
      *
@@ -153,7 +123,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param resourceType - The FHIR resource type.
      * @param id - The FHIR resource ID.
      */
-    deleteResource(resourceType: string, id: string): Promise<void>;
+    abstract deleteResource(resourceType: string, id: string): Promise<void>;
     /**
      * Patches a FHIR resource.
      *
@@ -163,7 +133,7 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param patch - The JSONPatch operations.
      * @returns The patched resource.
      */
-    patchResource(resourceType: string, id: string, patch: Operation[]): Promise<Resource>;
+    abstract patchResource(resourceType: string, id: string, patch: Operation[]): Promise<Resource>;
     /**
      * Searches for FHIR resources.
      *
@@ -171,8 +141,16 @@ export declare interface FhirRepository<TClient = unknown> {
      * @param searchRequest - The FHIR search request.
      * @returns The search results.
      */
-    search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<T>>;
-    searchByReference<T extends Resource>(searchRequest: SearchRequest<T>, referenceField: string, references: string[]): Promise<Record<string, T[]>>;
+    abstract search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<T>>;
+    abstract searchByReference<T extends Resource>(searchRequest: SearchRequest<T>, referenceField: string, references: string[]): Promise<Record<string, T[]>>;
+    /**
+     * Runs a callback function within a transaction.
+     *
+     * @param callback - The callback function to be run within a transaction.
+     */
+    abstract withTransaction<TResult>(callback: (client: TClient) => Promise<TResult>, options?: {
+        serializable?: boolean;
+    }): Promise<TResult>;
     /**
      * Searches for a single FHIR resource.
      *
@@ -197,12 +175,15 @@ export declare interface FhirRepository<TClient = unknown> {
      * @returns Promise to the array of search results.
      */
     searchResources<T extends Resource>(searchRequest: SearchRequest<T>): Promise<T[]>;
-    /**
-     * Runs a callback function within a transaction.
-     *
-     * @param callback - The callback function to be run within a transaction.
-     */
-    withTransaction<TResult>(callback: (client: TClient) => Promise<TResult>): Promise<TResult>;
+    conditionalCreate<T extends Resource>(resource: T, search: SearchRequest<T>, options?: CreateResourceOptions): Promise<{
+        resource: T;
+        outcome: OperationOutcome;
+    }>;
+    conditionalUpdate<T extends Resource>(resource: T, search: SearchRequest, options?: CreateResourceOptions & UpdateResourceOptions): Promise<{
+        resource: T;
+        outcome: OperationOutcome;
+    }>;
+    conditionalDelete(search: SearchRequest): Promise<void>;
 }
 
 export declare type FhirRequest = {
@@ -220,17 +201,27 @@ export declare type FhirRequestConfig = {
     graphqlMaxDepth?: number;
     graphqlMaxPageSize?: number;
     graphqlMaxSearches?: number;
+    transactions?: boolean;
 };
 
 export declare type FhirResponse = [OperationOutcome] | [OperationOutcome, Resource];
 
-export declare type FhirRouteHandler = (req: FhirRequest, repo: FhirRepository, router: FhirRouter) => Promise<FhirResponse>;
+export declare type FhirRouteHandler = (req: FhirRequest, repo: FhirRepository, router: FhirRouter, options?: FhirRouteOptions) => Promise<FhirResponse>;
+
+export declare type FhirRouteMetadata = {
+    interaction: RestInteraction;
+};
+
+export declare type FhirRouteOptions = {
+    batch?: boolean;
+};
 
 export declare class FhirRouter extends EventTarget_2 {
-    readonly router: Router<FhirRouteHandler>;
+    readonly router: Router<FhirRouteHandler, FhirRouteMetadata>;
     readonly options: FhirOptions;
     constructor(options?: {});
-    add(method: HttpMethod, path: string, handler: FhirRouteHandler): void;
+    add(method: HttpMethod, path: string, handler: FhirRouteHandler, interaction?: RestInteraction): void;
+    find(method: HttpMethod, path: string): RouteResult<FhirRouteHandler, FhirRouteMetadata> | undefined;
     handleRequest(req: FhirRequest, repo: FhirRepository): Promise<FhirResponse>;
     log(level: string, message: string, data?: Record<string, any>): void;
 }
@@ -242,18 +233,15 @@ export declare interface LogEvent extends Event_2 {
     data?: Record<string, any>;
 }
 
-export declare class MemoryRepository extends BaseRepository implements FhirRepository {
+export declare class MemoryRepository extends FhirRepository<undefined> {
     private readonly resources;
     private readonly history;
     constructor();
     clear(): void;
     setMode(_mode: RepositoryMode): void;
     createResource<T extends Resource>(resource: T): Promise<T>;
-    updateResource<T extends Resource>(resource: T, versionId?: string): Promise<T>;
-    conditionalUpdate<T extends Resource>(resource: T, search: SearchRequest): Promise<{
-        resource: T;
-        outcome: OperationOutcome;
-    }>;
+    generateId(): string;
+    updateResource<T extends Resource>(resource: T, options?: UpdateResourceOptions): Promise<T>;
     patchResource(resourceType: string, id: string, patch: Operation[]): Promise<Resource>;
     readResource<T extends Resource>(resourceType: string, id: string): Promise<T>;
     readReference<T extends Resource>(reference: Reference<T>): Promise<T>;
@@ -263,7 +251,7 @@ export declare class MemoryRepository extends BaseRepository implements FhirRepo
     search<T extends Resource>(searchRequest: SearchRequest<T>): Promise<Bundle<T>>;
     searchByReference<T extends Resource>(searchRequest: SearchRequest<T>, referenceField: string, references: string[]): Promise<Record<string, T[]>>;
     deleteResource(resourceType: string, id: string): Promise<void>;
-    withTransaction<TResult>(callback: (client: unknown) => Promise<TResult>): Promise<TResult>;
+    withTransaction<TResult>(callback: (client: undefined) => Promise<TResult>): Promise<TResult>;
 }
 
 export declare type PathSegment = {
@@ -276,21 +264,32 @@ export declare enum RepositoryMode {
     WRITER = "writer"
 }
 
-export declare type Route<T> = {
+/** @see http://hl7.org/fhir/R4/codesystem-restful-interaction.html */
+export declare type RestInteraction = CapabilityStatementRestInteraction['code'] | CapabilityStatementRestResourceInteraction['code'] | 'operation';
+
+export declare type Route<Handler, Metadata> = {
     method: HttpMethod;
     path: PathSegment[];
-    handler: T;
+    handler: Handler;
+    data?: Metadata;
 };
 
-export declare class Router<T> {
-    readonly routes: Route<T>[];
-    add(method: HttpMethod, pathStr: string, handler: T): void;
-    find(method: HttpMethod, pathStr: string): RouteResult<T> | undefined;
+export declare class Router<Handler, Metadata> {
+    readonly routes: Route<Handler, Metadata>[];
+    add(method: HttpMethod, pathStr: string, handler: Handler, data?: Metadata): void;
+    find(method: HttpMethod, pathStr: string): RouteResult<Handler, Metadata> | undefined;
 }
 
-export declare type RouteResult<T> = {
-    handler: T;
+export declare type RouteResult<Handler, Metadata> = {
+    handler: Handler;
     params: Record<string, string>;
+    data?: Metadata;
+};
+
+export declare function updateResourceImpl<T extends Resource>(resourceType: T['resourceType'], id: string, resource: T, repo: FhirRepository, options?: UpdateResourceOptions): Promise<FhirResponse>;
+
+export declare type UpdateResourceOptions = {
+    ifMatch?: string;
 };
 
 export { }