@medplum/core 5.1.26 → 5.1.28

package/dist/esm/index.d.ts

@@ -22,6 +22,7 @@ import type { Encounter } from '@medplum/fhirtypes';
 import type { Extension } from '@medplum/fhirtypes';
 import type { ExtensionValue } from '@medplum/fhirtypes';
 import type { ExtractResource } from '@medplum/fhirtypes';
+import type { HealthcareService } from '@medplum/fhirtypes';
 import type { HumanName } from '@medplum/fhirtypes';
 import type { Identifier } from '@medplum/fhirtypes';
 import type { ImagingStudy } from '@medplum/fhirtypes';
@@ -56,6 +57,7 @@ import type { RelatedPerson } from '@medplum/fhirtypes';
 import type { Resource } from '@medplum/fhirtypes';
 import type { ResourceType } from '@medplum/fhirtypes';
 import type { SampledData } from '@medplum/fhirtypes';
+import type { Schedule } from '@medplum/fhirtypes';
 import type { SearchParameter } from '@medplum/fhirtypes';
 import type { StructureDefinition } from '@medplum/fhirtypes';
 import type { StructureMap } from '@medplum/fhirtypes';
@@ -137,6 +139,8 @@ export declare interface AddFavoriteParams {
     patientId: string;
     pharmacy: Organization;
     setAsPrimary: boolean;
+    /** Selected practice location for multi-practice deployments. */
+    organization?: Reference<Organization>;
 }
 
 export declare interface AddOperation {
@@ -429,6 +433,24 @@ export { assert_2 as assert }
 
 export declare function assertContextVersionOptional(event: string): asserts event is FhircastEventVersionOptional;
 
+/**
+ * Checks that a value has type `never`. Useful for ensuring exhaustive
+ * matches.
+ *
+ * @example
+ * ```typescript
+ *   type MyUnion = 'a' | 'b' | 'c'
+ *   function f(arg: MyUnion) {
+ *     if (arg === 'a') { return 1; }
+ *     if (arg === 'b') { return 2; }
+ *     assertNever(arg); // Type error: 'c' is unhandled
+ *   }
+ * ```
+ *
+ * @param value - The value that should never be present
+ */
+export declare function assertNever(value: never): never;
+
 /**
  * Asserts that the operation completed successfully and that the resource is defined.
  * @param outcome - The operation outcome.
@@ -442,6 +464,8 @@ export declare function assertOk<T>(outcome: OperationOutcome, resource: T | und
  */
 export declare function assertReleaseManifest(candidate: unknown): asserts candidate is ReleaseManifest;
 
+export declare function assertValidMedplumSemver(version: string): asserts version is MedplumSemver;
+
 export declare interface AsyncCrawlerVisitor {
     onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
     onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
@@ -870,6 +894,14 @@ export declare type CodeChallengeMethod = 'plain' | 'S256';
  */
 export declare function codingMatchesToken(coding: Coding, token: string): boolean;
 
+/**
+ * Compares two Medplum semver version strings, ignoring any trailing commit-hash suffix.
+ * @param a - The first version to compare.
+ * @param b - The second version to compare.
+ * @returns A negative number if `a` is older than `b`, a positive number if `a` is newer than `b`, or `0` if they resolve to the same release.
+ */
+export declare function compareVersions(a: MedplumSemver, b: MedplumSemver): number;
+
 export declare function compressElement(element: InternalSchemaElement): Partial<InternalSchemaElement>;
 
 export declare class ConcatAtom extends InfixOperatorAtom {
@@ -942,6 +974,8 @@ export declare function contentTooLarge(text: string): OperationOutcome;
 export declare const ContentType: {
     readonly CSS: "text/css";
     readonly DICOM: "application/dicom";
+    readonly DICOM_JSON: "application/dicom+json";
+    readonly EVENT_STREAM: "text/event-stream";
     readonly FAVICON: "image/vnd.microsoft.icon";
     readonly FHIR_JSON: "application/fhir+json";
     readonly FORM_URL_ENCODED: "application/x-www-form-urlencoded";
@@ -1241,6 +1275,10 @@ export declare type DataTypesMap = {
     [type: string]: InternalTypeSchema;
 };
 
+export declare type DayOfWeek = (typeof DAYS_OF_WEEK)[number];
+
+export declare const DAYS_OF_WEEK: readonly ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+
 /**
  * Decodes a base64 string.
  * Handles both browser and Node environments.
@@ -1617,12 +1655,27 @@ export declare const ExternalSecretSystems: {
  */
 export declare function extractAccountReferences(meta: Meta | undefined): Reference[] | undefined;
 
+/**
+ * Extracts HealthcareService references from serviceType concepts.
+ * @param serviceType - CodeableConcept values to inspect
+ * @returns HealthcareService references embedded in the concepts
+ */
+export declare function extractServiceTypeReferences(serviceType: CodeableConcept[] | undefined): Reference<HealthcareService>[];
+
+/**
+ * Fetches the version strings for all published Medplum releases.
+ * @param appName - The name of the app to fetch the release list for.
+ * @param params - An optional list of key-value pairs to be appended to the URL query string.
+ * @returns An array of version strings (without the leading `v`), sorted from newest to oldest.
+ */
+export declare function fetchAllVersionStrings(appName: string, params?: Record<string, string>): Promise<MedplumSemver[]>;
+
 /**
  * Fetches the latest Medplum release version string.
  * @param appName - The name of the app to fetch the latest version for.
  * @returns A version string corresponding to the latest Medplum release version.
  */
-export declare function fetchLatestVersionString(appName: string): Promise<string>;
+export declare function fetchLatestVersionString(appName: string): Promise<MedplumSemver>;
 
 export declare type FetchLike = (url: string, options?: any) => Promise<any>;
 
@@ -2585,6 +2638,8 @@ export declare function getSearchParameterDetails(resourceType: string, searchPa
  */
 export declare function getSearchParameters(resourceType: string): Record<string, SearchParameter> | undefined;
 
+export declare function getSearchResourceTypes(searchRequest: SearchRequest): ResourceType[];
+
 export declare function getSmartHealthLinkId(manifestUrl: string): string | undefined;
 
 export declare function getStatus(outcome: OperationOutcome): number;
@@ -2663,6 +2718,13 @@ export declare interface GoogleLoginRequest extends BaseLoginRequest {
     readonly createUser?: boolean;
 }
 
+/**
+ * Returns whether a Schedule or HealthcareService has a SchedulingParameters extension.
+ * @param resource - Schedule or HealthcareService to inspect
+ * @returns True if the resource has a SchedulingParameters extension
+ */
+export declare function hasSchedulingParameters(resource: Schedule | HealthcareService): boolean;
+
 export declare interface Hl7AckOptions {
     ackCode: AckCode;
     errSegment?: Hl7Segment;
@@ -3224,6 +3286,18 @@ export declare function intersection(objects: ArrayLike<{
     [index: string]: any;
 }>): string[];
 
+/**
+ * Stable error when a cart-management bot response does not match
+ * {@link MedicationCartManageResponse}.
+ */
+export declare const INVALID_MEDICATION_CART_RESPONSE = "Invalid response from cart-management bot";
+
+/**
+ * Stable error when a checkout-medications bot response does not match
+ * {@link MedicationCheckoutResponse}.
+ */
+export declare const INVALID_MEDICATION_CHECKOUT_RESPONSE = "Invalid response from checkout-medications bot";
+
 /**
  * Stable error when a bot response does not match {@link MedicationOrderResponse}.
  */
@@ -3362,6 +3436,8 @@ export declare function isDateString(input: unknown): input is string;
  */
 export declare function isDateTimeString(input: unknown): input is string;
 
+export declare function isDayOfWeek(value: string | undefined): value is DayOfWeek;
+
 /**
  * Helper function to narrow a type by excluding undefined/null values.
  * @param value - The value to refine
@@ -3427,6 +3503,20 @@ export declare function isLowerCase(c: string): boolean;
  */
 export declare function isMedicationArray(value: unknown): value is Medication[];
 
+/**
+ * Type guard: validates a cart-management bot response.
+ * @param value - Unknown bot JSON payload.
+ * @returns True when the value matches {@link MedicationCartManageResponse}.
+ */
+export declare function isMedicationCartManageResponse(value: unknown): value is MedicationCartManageResponse;
+
+/**
+ * Type guard: validates a checkout-medications bot response.
+ * @param value - Unknown bot JSON payload.
+ * @returns True when the value matches {@link MedicationCheckoutResponse}.
+ */
+export declare function isMedicationCheckoutResponse(value: unknown): value is MedicationCheckoutResponse;
+
 /**
  * Type guard: validates an order-medication bot response.
  * @param value - Unknown bot JSON payload.
@@ -3648,7 +3738,7 @@ export declare function isValidHostname(input: string): boolean;
  * @param version - A version string that should be tested for valid semver semantics.
  * @returns `true` if `version` is a valid semver version that conforms to the Medplum versioning system, otherwise `false`.
  */
-export declare function isValidMedplumSemver(version: string): boolean;
+export declare function isValidMedplumSemver(version: string): version is MedplumSemver;
 
 /**
  * Generic interface that an implementation of `WebSocket` must satisfy to be used with `ReconnectingWebSocket`.
@@ -4006,6 +4096,126 @@ export declare const MEDICATION_REQUEST_STATUS_REASON_RESPONSE_NOT_RECEIVED = "r
  */
 export declare const MEDICATION_REQUEST_STATUS_REASON_SYSTEM = "https://medplum.com/fhir/CodeSystem/medication-request-status-reason";
 
+/**
+ * Vendor-neutral input to clear the patient's whole vendor cart (`$clear-cart`).
+ */
+export declare interface MedicationCartClearRequest {
+    readonly patientId: string;
+}
+
+/**
+ * Encodes a {@link MedicationCartClearRequest} as a FHIR `Parameters` body for
+ * the `$clear-cart` custom operation. Emits the `action: 'clear'` discriminator.
+ *
+ * @param req - Clear request (vendor-neutral).
+ * @returns A `Parameters` resource ready to POST.
+ */
+export declare function medicationCartClearRequestToParameters(req: MedicationCartClearRequest): Parameters_2;
+
+/**
+ * Per-item outcome from a cart remove/clear. `removed` = the vendor cart item
+ * was deleted; `not-in-cart` = the draft was not staged (nothing to remove);
+ * `failed` = the vendor delete failed (see `error`).
+ */
+export declare interface MedicationCartItemResult {
+    readonly medicationRequestId?: string;
+    /** Vendor cart-item reference that was removed (ScriptSure MedCart `rxId`), when known. */
+    readonly vendorLineId?: string;
+    readonly status: 'removed' | 'not-in-cart' | 'failed';
+    readonly error?: string;
+}
+
+/**
+ * Vendor-neutral output from a cart remove/clear: the vendor patient id, the
+ * number of cart items actually removed, and the per-line outcomes (one for a
+ * remove, N for a clear).
+ */
+export declare interface MedicationCartManageResponse {
+    /** Vendor-side patient id (numeric in ScriptSure today). */
+    readonly vendorPatientId: number;
+    readonly removedCount: number;
+    readonly items: MedicationCartItemResult[];
+}
+
+/**
+ * Vendor-neutral input to remove a single draft `MedicationRequest` from the
+ * patient's vendor cart (`$remove-cart-medication`).
+ */
+export declare interface MedicationCartRemoveRequest {
+    readonly patientId: string;
+    readonly medicationRequestId: string;
+}
+
+/**
+ * Encodes a {@link MedicationCartRemoveRequest} as a FHIR `Parameters` body for
+ * the `$remove-cart-medication` custom operation. Emits the `action: 'remove'`
+ * discriminator the shared cart-management bot dispatches on.
+ *
+ * @param req - Remove request (vendor-neutral).
+ * @returns A `Parameters` resource ready to POST.
+ */
+export declare function medicationCartRemoveRequestToParameters(req: MedicationCartRemoveRequest): Parameters_2;
+
+/**
+ * Per-line outcome from a cart checkout. A single bad line is reported here as
+ * `failed` rather than rolling back the lines that already queued.
+ */
+export declare interface MedicationCheckoutItemResult {
+    readonly medicationRequestId: string;
+    /**
+     * Vendor per-line reference returned at checkout, for diagnostics/audit. The
+     * concrete meaning is vendor-specific: a cart-item id for cart-based vendors
+     * (ScriptSure MedCart `rxId`) or a per-prescription id for queue-based ones.
+     * Optional because the vendor may not mint one at add time.
+     */
+    readonly vendorLineId?: string;
+    readonly status: 'queued' | 'failed';
+    /**
+     * True when the line was **not** added because the same drug was already in
+     * the vendor's cart (the vendor-recommended duplicate check matched). Reported
+     * as `status: 'queued'` with this flag set so the caller can surface it.
+     */
+    readonly duplicate?: boolean;
+    readonly error?: string;
+}
+
+/**
+ * Vendor-neutral input for a cart-checkout bot: submit a set of draft
+ * `MedicationRequest`s (the cart) to the vendor's electronic approval queue.
+ */
+export declare interface MedicationCheckoutRequest {
+    readonly patientId: string;
+    readonly medicationRequestIds: string[];
+    readonly appId?: string;
+    /** Selected practice location; omit for single-practice prescribers. */
+    readonly organization?: Reference<Organization>;
+}
+
+/**
+ * Encodes a {@link MedicationCheckoutRequest} as a FHIR `Parameters` body for
+ * the vendor-neutral `$checkout-medications` custom operation
+ * (`POST /fhir/R4/MedicationRequest/$checkout-medications`).
+ *
+ * `medicationRequestIds` is emitted as one `parameter` entry per id so the
+ * OperationDefinition's `max: '*'` cardinality round-trips. Optional fields are
+ * omitted entirely.
+ *
+ * @param req - Cart checkout request (vendor-neutral).
+ * @returns A `Parameters` resource ready to POST.
+ */
+export declare function medicationCheckoutRequestToParameters(req: MedicationCheckoutRequest): Parameters_2;
+
+/**
+ * Vendor-neutral output from a cart-checkout bot: a single embeddable approval
+ * widget URL (the vendor's batch sign-off surface) plus per-line results.
+ */
+export declare interface MedicationCheckoutResponse {
+    readonly approvalUrl: string;
+    /** Vendor-side patient id (numeric in ScriptSure today). */
+    readonly vendorPatientId: number;
+    readonly items: MedicationCheckoutItemResult[];
+}
+
 /**
  * Vendor-neutral drug line for {@link MedicationOrderRequest}.
  */
@@ -4029,6 +4239,14 @@ export declare interface MedicationOrderExtensions {
     readonly pendingOrderIdSystem: string;
     readonly pendingOrderStatusUrl: string;
     readonly iframeUrlExtension: string;
+    /**
+     * Identifier system for the vendor's per-prescription message id (SureScripts
+     * `messageId` in ScriptSure). Stamped on a draft `MedicationRequest` by the
+     * cart-checkout flow and used to reconcile the approval webhook back to the
+     * draft. Optional so existing single-order consumers don't have to populate it.
+     * Consumed by the paired `medplum-ee` cart-checkout / prescription-webhook bots.
+     */
+    readonly messageIdSystem?: string;
 }
 
 /**
@@ -4066,6 +4284,8 @@ export declare interface MedicationOrderRequest {
     /** Free-text patient instructions (additional sig); maps to dosageInstruction[0].patientInstruction when using MR path. */
     readonly patientInstruction?: string;
     readonly appId?: string;
+    /** Selected practice location for multi-practice deployments. */
+    readonly organization?: Reference<Organization>;
 }
 
 /**
@@ -4115,6 +4335,8 @@ export declare interface MedicationOrderSetRequest {
      */
     readonly vendorOrderSetId?: number | string;
     readonly appId?: string;
+    /** Selected practice location for multi-practice deployments. */
+    readonly organization?: Reference<Organization>;
 }
 
 /**
@@ -4181,6 +4403,8 @@ export declare const MEDPLUM_CLI_CLIENT_ID = "medplum-cli";
 
 export declare const MEDPLUM_RELEASES_URL = "https://meta.medplum.com/releases";
 
+export declare const MEDPLUM_SEMVER_REGEX: RegExp;
+
 export declare const MEDPLUM_VERSION: string;
 
 /**
@@ -4379,6 +4603,28 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param resourceType - The resource type to invalidate.
      */
     invalidateSearches(resourceType: ResourceType): void;
+    /**
+     * Notifies listeners that a resource was modified outside of the standard CRUD methods,
+     * and invalidates the relevant cached values.
+     *
+     * The client emits the `resourceModified` event automatically for `createResource`,
+     * `updateResource`, `patchResource`, `deleteResource`, and related methods. Use this method
+     * to announce modifications the client cannot classify itself, such as custom operations,
+     * GraphQL mutations, or out-of-band changes:
+     *
+     * ```typescript
+     * await medplum.post(medplum.fhirUrl('Appointment', '$book'), parameters);
+     * medplum.notifyResourceModified({ resourceType: 'Appointment', operation: 'create' });
+     * medplum.notifyResourceModified({ resourceType: 'Slot', operation: 'update' });
+     * ```
+     *
+     * Cached searches for the resource type are invalidated. If `event.resource` is provided
+     * for a non-delete operation, it becomes the cached read value; otherwise, if `event.id`
+     * is provided, the cached read is invalidated.
+     * @category Caching
+     * @param event - The resource modification to announce.
+     */
+    notifyResourceModified(event: ResourceModifiedEvent): void;
     /**
      * Makes an HTTP GET request to the specified URL.
      *
@@ -5552,6 +5798,11 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      * @param key - The cache key to delete.
      */
     private deleteCacheEntry;
+    /**
+     * Dispatches a `resourceModified` event if there are any listeners.
+     * @param payload - The event payload.
+     */
+    private dispatchResourceModified;
     /**
      * Makes an HTTP request.
      * @param url - The target URL.
@@ -5611,8 +5862,8 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     /**
      * Handles an unauthenticated (HTTP 401) response from the server.
      *
-     * Bounded and terminal: at most {@link MAX_AUTH_ATTEMPTS} attempts per request (1 initial
-     * + 1 recovery, tracked via {@link RequestState.authAttempt}). The recovery re-mints via a
+     * Bounded and terminal: at most `MAX_AUTH_ATTEMPTS` attempts per request (1 initial
+     * + 1 recovery, tracked via `RequestState.authAttempt`). The recovery re-mints via a
      * forced {@link MedplumClient.refresh} (bypassing the {@link MedplumClient.isAuthenticated}
      * short-circuit on the rejected token), single-flight so concurrent 401s share one re-mint.
      * A second 401 is terminal: clear auth, `onUnauthenticated`, reject — never recurse.
@@ -5962,6 +6213,10 @@ export declare type MedplumClientEventMap = {
             error: Error;
         };
     };
+    resourceModified: {
+        type: 'resourceModified';
+        payload: ResourceModifiedEvent;
+    };
 };
 
 /**
@@ -6454,6 +6709,8 @@ export declare interface MedplumRequestOptions extends RequestInit {
     duplex?: 'half';
 }
 
+export declare type MedplumSemver = `${number}.${number}.${number}` | `${number}.${number}.${number}-${string}`;
+
 export declare interface MedplumSourceInfraConfig {
     name: ValueOrExternalSecret<string>;
     stackName: ValueOrExternalSecret<string>;
@@ -6998,11 +7255,66 @@ export declare class OrAtom extends InfixOperatorAtom {
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
 }
 
+/**
+ * Vendor-neutral decoded response from the `$sync-orderset` custom operation
+ * (`POST /fhir/R4/PlanDefinition/$sync-orderset`). `failedCount > 0` means the
+ * synced vendor order set carries fewer meds than the `PlanDefinition`.
+ */
+export declare interface OrderSetSyncResponse {
+    readonly mode: 'created' | 'noop-already-synced';
+    readonly planDefinitionId?: string;
+    readonly scriptSureOrdersetId?: number;
+    readonly syncedCount: number;
+    readonly failedCount: number;
+    readonly results: OrderSetSyncSequenceResult[];
+}
+
+/**
+ * Per-action outcome from the vendor-neutral `$sync-orderset` operation. A
+ * `'failed'` row carries `error` and was NOT added to the vendor order set, so
+ * a later apply/signing session would open with fewer meds than the
+ * `PlanDefinition` requested — callers must surface these.
+ */
+export declare interface OrderSetSyncSequenceResult {
+    readonly actionTitle?: string;
+    readonly activityDefinitionUrl?: string;
+    readonly scriptSureSequenceId?: number;
+    readonly scriptSureOrderId?: number;
+    readonly status: 'synced' | 'failed';
+    readonly error?: string;
+}
+
 /**
  * SQL on FHIR output row.
  */
 export declare type OutputRow = Record<string, any>;
 
+/**
+ * Decodes the `Parameters` response from the `$remove-cart-medication` /
+ * `$clear-cart` custom operations into a typed {@link MedicationCartManageResponse}.
+ * Throws {@link INVALID_MEDICATION_CART_RESPONSE} when required top-level fields
+ * are missing.
+ *
+ * @param params - The `Parameters` resource returned by the operation.
+ * @returns A vendor-neutral {@link MedicationCartManageResponse}.
+ */
+export declare function parametersToMedicationCartManageResponse(params: Parameters_2): MedicationCartManageResponse;
+
+/**
+ * Decodes the `Parameters` response from the `$checkout-medications` custom
+ * operation into a typed {@link MedicationCheckoutResponse}. Throws
+ * `INVALID_MEDICATION_CHECKOUT_RESPONSE` when required top-level fields are
+ * missing.
+ *
+ * The repeating `items` parameter is collected across every occurrence (each is
+ * one queued/failed line); the scalar `approvalUrl` / `vendorPatientId` are read
+ * once.
+ *
+ * @param params - The `Parameters` resource returned by the operation.
+ * @returns A vendor-neutral {@link MedicationCheckoutResponse}.
+ */
+export declare function parametersToMedicationCheckoutResponse(params: Parameters_2): MedicationCheckoutResponse;
+
 /**
  * Decodes the `Parameters` response from the `$order-medication` custom
  * operation into a typed {@link MedicationOrderResponse}. Throws
@@ -7027,6 +7339,16 @@ export declare function parametersToMedicationOrderResponse(params: Parameters_2
  */
 export declare function parametersToMedicationOrderSetResponse(params: Parameters_2): MedicationOrderSetResponse;
 
+/**
+ * Decodes the `Parameters` response from the `$sync-orderset` custom operation
+ * into a typed {@link OrderSetSyncResponse}, including the repeating per-action
+ * `results` rows the server previously dropped.
+ *
+ * @param params - The `Parameters` resource returned by the operation.
+ * @returns A vendor-neutral {@link OrderSetSyncResponse}.
+ */
+export declare function parametersToOrderSetSyncResponse(params: Parameters_2): OrderSetSyncResponse;
+
 /**
  * Parses a FHIRPath expression into an AST.
  * The result can be used to evaluate the expression against a resource or other object.
@@ -7037,6 +7359,16 @@ export declare function parametersToMedicationOrderSetResponse(params: Parameter
  */
 export declare function parseFhirPath(input: string): FhirPathAtom;
 
+/**
+ * Parses a FHIRPath Patch `Parameters` resource into the array of operations consumed by
+ * {@link fhirpathPatchTypedValue}. Each repeating `operation` parameter is decoded from its
+ * `part` entries (`type`, `path`, `name`, `value`, `index`, `source`, `destination`), where
+ * the polymorphic `value[x]` part becomes a {@link TypedValue}.
+ * @param parameters - The FHIRPath Patch Parameters resource.
+ * @returns The parsed FHIRPath Patch operations.
+ */
+export declare function parseFhirPathPatchParameters(parameters: Parameters_2): FhirPathPatch[];
+
 /**
  * Parses a FHIR _filter parameter expression into an AST.
  * @param input - The FHIR _filter parameter expression.
@@ -7212,6 +7544,8 @@ export declare class ParserBuilder {
      address?: string;
      phoneOrFax?: string;
      ncpdpID?: string;
+     /** Selected practice location for multi-practice deployments. */
+     organization?: Reference<Organization>;
  }
 
  /**
@@ -7784,6 +8118,29 @@ export declare class ParserBuilder {
 
  export declare function resourceMatchesSubscriptionCriteria({ resource, subscription, context, getPreviousResource, logger, }: ResourceMatchesSubscriptionCriteria): Promise<boolean>;
 
+ /**
+  * Payload of the `resourceModified` event, emitted after this client instance successfully
+  * creates, updates, patches, or deletes a FHIR resource.
+  *
+  * Emitted by `createResource`, `createResourceIfNoneExist`, `updateResource`, `upsertResource`,
+  * `patchResource`, `deleteResource`, and by `notifyResourceModified`.
+  * Conditional methods (`createResourceIfNoneExist`, `upsertResource`) emit
+  * even when the server made no change, except on HTTP 304 "Not Modified".
+  *
+  * @template T - The type of the modified resource. Defaults to `Resource`; narrow it (e.g. via
+  * `useResourceModified('Slot', ...)`) to get a typed `resource` payload without extra guards.
+  */
+ export declare interface ResourceModifiedEvent<T extends Resource = Resource> {
+     /** The type of the modified resource. */
+     resourceType: T['resourceType'];
+     /** How the resource was modified. */
+     operation: 'create' | 'update' | 'patch' | 'delete';
+     /** The resource id, when known. */
+     id?: string;
+     /** The server-returned resource, when available. Undefined for deletes. */
+     resource?: WithId<T>;
+ }
+
  export declare type ResourceWithCode = Resource & Code;
 
  export declare const ReturnAckCategory: {
@@ -7808,6 +8165,12 @@ export declare class ParserBuilder {
   */
  export declare function satisfiedAccessPolicy(resource: Resource, interaction: AccessPolicyInteraction, accessPolicy: AccessPolicy | undefined): AccessPolicyResource | undefined;
 
+ export declare const SchedulingEncounterCodingURI = "https://medplum.com/fhir/StructureDefinition/SchedulingEncounterCoding";
+
+ export declare const SchedulingParametersURI = "https://medplum.com/fhir/StructureDefinition/SchedulingParameters";
+
+ export declare const SchedulingPlanDefinitionURI = "https://medplum.com/fhir/StructureDefinition/SchedulingPlanDefinition";
+
  export declare interface SearchableToken {
      readonly system: string | undefined;
      readonly value: string | undefined;
@@ -7890,6 +8253,42 @@ export declare class ParserBuilder {
 
  export declare function serverTimeout(msg?: string): OperationOutcome;
 
+ /**
+  * Returns whether any serviceType concept refers to the given HealthcareService.
+  * @param serviceType - CodeableConcept values to inspect
+  * @param service - HealthcareService or reference to match
+  * @returns True if any concept references the service
+  */
+ export declare function serviceTypeIncludesService(serviceType: CodeableConcept[] | undefined, service: WithId<HealthcareService> | (Reference<HealthcareService> & {
+     reference: string;
+ })): boolean;
+
+ /**
+  * Extension URI holding a `Reference<HealthcareService>` on a `serviceType` CodeableConcept.
+  *
+  * In R5/R6, `serviceType` attributes change from `CodeableConcept[]` to
+  * `CodeableReference<HealthcareService>`. We approximate that in R4 with this extension.
+  *
+  * Example: a Schedule whose serviceType refers to a HealthcareService:
+  * ```json
+  * {
+  *   "resourceType": "Schedule",
+  *   "actor": [{ "reference": "Practitioner/abc" }],
+  *   "serviceType": [
+  *     {
+  *       "extension": [
+  *         {
+  *           "url": "https://medplum.com/fhir/service-type-reference",
+  *           "valueReference": { "reference": "HealthcareService/123" }
+  *         }
+  *       ]
+  *     }
+  *   ]
+  * }
+  * ```
+  */
+ export declare const ServiceTypeReferenceURI = "https://medplum.com/fhir/service-type-reference";
+
  /**
   * Sets a code for a given system within a given codeable concept.
   * @param concept - The codeable concept.
@@ -8279,6 +8678,8 @@ export declare class ParserBuilder {
      value: any;
  }
 
+ export declare const TimezoneExtensionURI = "http://hl7.org/fhir/StructureDefinition/timezone";
+
  /**
   * Converts unknown object into a JavaScript boolean.
   * Note that this is different than the FHIRPath "toBoolean",
@@ -8315,6 +8716,19 @@ export declare class ParserBuilder {
      private consumeQuotedSymbol;
      private consumeDateTime;
      private consumeNumber;
+     /**
+      * Consumes an unquoted string value that begins with digits, such as a UUID in a `_filter`
+      * expression, starting over from the beginning of the value.
+      *
+      * The value ends at the first character that cannot be part of a token, per `symbolRegex`. For the
+      * `_filter` tokenizer that is whitespace, ")", and "]", so a value at the end of a nested
+      * expression such as "(_id eq 12345678-1234-4123-8123-123456789abc)" does not swallow the closing
+      * parenthesis.
+      *
+      * @param start - The index of the first character of the value.
+      * @returns The string token.
+      */
+     private consumeUnquotedString;
      private consumeSymbol;
      private consumeOperator;
      private consumeWhile;
@@ -8355,6 +8769,15 @@ export declare class ParserBuilder {
   */
  export declare function toPeriod(input: unknown): Period | undefined;
 
+ /**
+  * Converts a HealthcareService into the CodeableConcept values used by
+  * `Schedule.serviceType` and `Appointment.serviceType`, which encode an R4
+  * approximation of `CodeableReference<HealthcareService>`.
+  * @param service - HealthcareService to represent
+  * @returns CodeableConcept values containing a reference to the service
+  */
+ export declare function toServiceTypeCodeableConcepts(service: WithId<HealthcareService>): CodeableConcept[];
+
  /**
   * Returns a "best guess" TypedValue for a given value.
   * @param value - The unknown value to check.