@medplum/core 5.1.28 → 5.1.30

package/dist/cjs/index.d.ts

@@ -16,6 +16,7 @@ import type { CustomTableLayout } from 'pdfmake/interfaces';
 import type { Device } from '@medplum/fhirtypes';
 import type { DiagnosticReport } from '@medplum/fhirtypes';
 import type { DocumentReference } from '@medplum/fhirtypes';
+import type { Duration } from '@medplum/fhirtypes';
 import type { ElementDefinition } from '@medplum/fhirtypes';
 import type { ElementDefinitionBinding } from '@medplum/fhirtypes';
 import type { Encounter } from '@medplum/fhirtypes';
@@ -831,6 +832,17 @@ export declare function checkIfValidMedplumVersion(appName: string, version: str
  */
 export declare function clearReleaseCache(): void;
 
+/**
+ * Immutably clears one scheduling parameter a Schedule sets for a HealthcareService, dropping that
+ * calendar back to the service-level parameter of the same name. Pairs with `setScheduleParameter`
+ * and `getScheduleParameters`.
+ * @param schedule - Schedule to update
+ * @param service - HealthcareService referenced by the parameters
+ * @param url - Url of the SchedulingParameters sub-extension to remove, for example `availability`
+ * @returns A cloned Schedule without the matching parameter
+ */
+export declare function clearScheduleParameter(schedule: Schedule, service: WithId<HealthcareService>, url: string): Schedule;
+
 /**
  * Log level for MedplumClient requests and responses.
  * - 'none': No logging
@@ -925,14 +937,19 @@ export declare function conceptMapTranslate(map: ConceptMap, params: ConceptMapT
 export declare interface ConceptMapTranslateMatch {
     equivalence?: string;
     concept?: Coding;
-    property?: ConceptMapTranslateMatchAttribute[];
+    property?: ConceptMapTranslateMatchProperty[];
     dependsOn?: ConceptMapTranslateMatchAttribute[];
     product?: ConceptMapTranslateMatchAttribute[];
     source?: string;
 }
 
 export declare interface ConceptMapTranslateMatchAttribute {
-    key: string;
+    attribute: string;
+    value: TypedValue;
+}
+
+export declare interface ConceptMapTranslateMatchProperty {
+    uri: string;
     value: TypedValue;
 }
 
@@ -1060,6 +1077,17 @@ export declare interface CopyOperation {
     path: string;
 }
 
+/**
+ * Counts iterable elements by a key function, returning a sparse map of key to count.
+ * Matches Lodash `countBy` semantics (no zero-fill for missing keys).
+ * @param items - The items to count.
+ * @param keyFn - The function to extract the key from each item.
+ * @returns A map of key to count for keys that appear at least once.
+ */
+export declare function countBy<T, K extends keyof any>(items: Iterable<T>, keyFn: (value: T) => K): Partial<Record<K, number>>;
+
+export declare function countWhere<T>(items: Iterable<T>, fn: (value: T) => boolean): number;
+
 export declare const CPT = "http://www.ama-assn.org/go/cpt";
 
 export declare interface CrawlerOptions {
@@ -1632,6 +1660,15 @@ export declare interface ExtendedInternalSchemaElement extends InternalSchemaEle
     readonly?: boolean;
 }
 
+/**
+ * Anything that can carry FHIR extensions: resources such as `Patient`, data types such as
+ * `CodeableConcept`, and extensions themselves. Structural, so any of those is accepted, while a
+ * type that cannot hold extensions, `Binary` being the notable example, is rejected.
+ */
+export declare interface Extensible {
+    extension?: Extension[];
+}
+
 export declare type ExternalSecret<T extends ExternalSecretPrimitive = ExternalSecretPrimitive> = {
     system: ExternalSecretSystem;
     key: string;
@@ -1852,7 +1889,11 @@ export declare type FhircastConnectEvent = {
  * 2. `message` - Contains a `payload` field containing a `FHIRcast` message payload exactly as it comes in over WebSockets.
  * 3. `disconnect` - An event to signal when a WebSocket connection has been closed. Fired as soon as a WebSocket emits `close`.
  *
- * To close the connection, call `connection.disconnect()` and listen to the `disconnect` event to know when the connection has been disconnected.
+ * The underlying socket reconnects on its own, so `disconnect` followed by `connect` is the normal
+ * shape of a dropped connection rather than the end of the session. A subscription endpoint stays
+ * valid for the lease the Hub granted it, so reconnecting resubscribes without a new `hub.subscribe`
+ * request. Two things end a connection for good: calling `connection.disconnect()`, and the Hub
+ * denying the subscription — after either, `connect` will not fire again.
  */
 export declare class FhircastConnection extends TypedEventTarget<FhircastSubscriptionEventMap> {
     readonly subRequest: SubscriptionRequest;
@@ -1860,11 +1901,17 @@ export declare class FhircastConnection extends TypedEventTarget<FhircastSubscri
     /**
      * Creates a new `FhircastConnection`.
      * @param subRequest - The subscription request to initialize the connection from.
+     * @param options - Options for the underlying `ReconnectingWebSocket`.
      */
-    constructor(subRequest: SubscriptionRequest);
+    constructor(subRequest: SubscriptionRequest, options?: FhircastConnectionOptions);
     disconnect(): void;
 }
 
+export declare type FhircastConnectionOptions = Options & {
+    /** An alternate `ReconnectingWebSocket` implementation to open the connection with. */
+    ReconnectingWebSocket?: IReconnectingWebSocketCtor;
+};
+
 export declare type FhircastContextResourceType<EventName extends FhircastEventName, K extends FhircastEventKeys<EventName>> = (typeof FHIRCAST_EVENT_RESOURCES)[EventName][K] extends {
     resourceType: infer R;
 } ? R : never;
@@ -2466,6 +2513,18 @@ export declare function getExpressionsForResourceType(resourceType: string, expr
  */
 export declare function getExtension(resource: any, ...urls: string[]): Extension | undefined;
 
+/**
+ * Returns every extension reachable by the given extension URLs.
+ *
+ * Like `getExtension`, but does not stop at the first match: extensions that repeat under one URL are
+ * all returned, at every level. Use it for extensions defined with a cardinality above one, where
+ * `getExtension` would silently read only the first.
+ * @param extensible - The base resource, data type, or extension. Anything that may hold an `extension` array.
+ * @param urlOrUrls - One extension URL, or an array of them where each entry represents descending a level in a nested extension.
+ * @returns Every matching extension, in document order. Empty if none match or no URL is given.
+ */
+export declare function getExtensions(extensible: Extensible | undefined, urlOrUrls: string | string[]): Extension[];
+
 /**
  * Returns an extension value by extension URLs.
  * @param resource - The base resource.
@@ -2608,6 +2667,30 @@ export declare function getReferenceString(input: Reference | Resource): string
  */
 export declare function getResourceTypes(): ResourceType[];
 
+/**
+ * Reads one scheduling parameter a Schedule sets for a HealthcareService, taking precedence over the
+ * service-level parameter of the same name. Pairs with `setScheduleParameter` and `clearScheduleParameter`.
+ *
+ * The result is a list rather than a single extension because a Schedule may carry more than one
+ * SchedulingParameters extension matching the service, and because a parameter may legitimately repeat.
+ * @param schedule - Schedule to inspect
+ * @param service - HealthcareService referenced by the parameters
+ * @param url - Url of the SchedulingParameters sub-extension to read, for example `availability`
+ * @returns Every matching sub-extension, in document order
+ */
+export declare function getScheduleParameters(schedule: Schedule, service: WithId<HealthcareService>, url: string): Extension[];
+
+/**
+ * Resolves the timezone used by scheduling in server priority order: the Schedule's parameters for the
+ * service, then the service's own parameters, then the actor's standard FHIR timezone extension.
+ * @param service - HealthcareService whose parameters may define a timezone
+ * @param schedule - Schedule whose parameters may define a timezone. Omit to resolve the service's own timezone,
+ * as when the service default hours are being read on their own rather than through a particular calendar.
+ * @param actor - Optional Schedule actor used as a timezone fallback
+ * @returns The resolved IANA timezone identifier, if present
+ */
+export declare function getSchedulingTimezone(service: WithId<HealthcareService>, schedule?: Schedule, actor?: Resource): string | undefined;
+
 /**
  * Returns a search parameter for a resource type by search code.
  * @param resourceType - The FHIR resource type.
@@ -2720,6 +2803,9 @@ export declare interface GoogleLoginRequest extends BaseLoginRequest {
 
 /**
  * Returns whether a Schedule or HealthcareService has a SchedulingParameters extension.
+ *
+ * Unscoped: on a Schedule, where the extension repeats once per service, this reports that some
+ * service is configured rather than any particular one. Ask `getScheduleParameters` about a service.
  * @param resource - Schedule or HealthcareService to inspect
  * @returns True if the resource has a SchedulingParameters extension
  */
@@ -3668,7 +3754,7 @@ export declare function isStringArray(arr: any[]): arr is string[];
 
 export declare type IssueSeverity = 'error' | 'fatal' | 'warning' | 'information';
 
-export declare type IssueType = 'structure' | 'invariant' | 'processing';
+export declare type IssueType = 'structure' | 'invariant' | 'processing' | 'required';
 
 /**
  * Returns true if the input value is an object with a string text property.
@@ -4223,6 +4309,25 @@ export declare interface MedicationOrderDrugInput {
     readonly ndc?: string;
     readonly rxNorm?: string;
     readonly routedMedId?: number;
+    /**
+     * Vendor formulation key, paired with {@link routedMedId} to order a drug that
+     * has no dose-level product to resolve an NDC from — OTC / topical /
+     * wide-multi-strength generics for which the vendor's dose-format lookup
+     * returns nothing. Supply {@link drugName} alongside it, since there is no
+     * catalog row to derive a name from.
+     */
+    readonly gcnSeqno?: number;
+    /** Drug name, required for a {@link gcnSeqno}-keyed line (no catalog row to name it). */
+    readonly drugName?: string;
+    /**
+     * Dose text for a {@link gcnSeqno}-keyed line, e.g. `"solution"`.
+     *
+     * Optional, and only worth sending when the caller holds dose text *separate*
+     * from {@link drugName} — a hand-entered form, say. Passing a full product
+     * label duplicates it in the description the vendor renders. When omitted, the
+     * vendor derives the dose from the formulation key or falls back to the sig.
+     */
+    readonly line1?: string;
     readonly quantity: number;
     readonly quantityQualifier?: string;
     readonly refill?: number;
@@ -4378,6 +4483,13 @@ export declare interface MedicationSearchParams {
     readonly ndc?: string;
     readonly rxNorm?: string;
     readonly routedMedId?: number;
+    /**
+     * Vendor formulation keys under {@link routedMedId}, from the name-search hit.
+     * Only used when the drug has no dose-level products: each key is resolved to
+     * its marketed strength so the caller still gets selectable formulations
+     * instead of an empty result. Ignored otherwise.
+     */
+    readonly gcnSeqnos?: number[];
     readonly searchOtc?: boolean;
     readonly searchSupply?: boolean;
     readonly searchBrand?: boolean;
@@ -6068,9 +6180,10 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      *
      * @category FHIRcast
      * @param subRequest - The `SubscriptionRequest` to use for connecting.
+     * @param options - Options for the underlying `ReconnectingWebSocket`.
      * @returns A `FhircastConnection` which emits lifecycle events for the `FHIRcast` WebSocket connection.
      */
-    fhircastConnect(subRequest: SubscriptionRequest): FhircastConnection;
+    fhircastConnect(subRequest: SubscriptionRequest, options?: FhircastConnectionOptions): FhircastConnection;
     /**
      * Publishes a new context to a given topic for a specified event type.
      *
@@ -8165,6 +8278,15 @@ export declare class ParserBuilder {
   */
  export declare function satisfiedAccessPolicy(resource: Resource, interaction: AccessPolicyInteraction, accessPolicy: AccessPolicy | undefined): AccessPolicyResource | undefined;
 
+ /**
+  * Converts a SchedulingParameters duration to minutes.
+  *
+  * @param duration - The duration to convert.
+  * @returns The length in minutes, or undefined when the duration has no value, a
+  * negative value, or a unit scheduling does not accept.
+  */
+ export declare function schedulingDurationToMinutes(duration: Duration | undefined): number | undefined;
+
  export declare const SchedulingEncounterCodingURI = "https://medplum.com/fhir/StructureDefinition/SchedulingEncounterCoding";
 
  export declare const SchedulingParametersURI = "https://medplum.com/fhir/StructureDefinition/SchedulingParameters";
@@ -8322,6 +8444,23 @@ export declare class ParserBuilder {
      use?: Identifier['use'];
  }
 
+ /**
+  * Immutably sets one scheduling parameter on a Schedule for a HealthcareService, so that calendar keeps
+  * it in place of the service-level parameter of the same name. Whatever the Schedule already holds at the
+  * sub-extension's url is replaced, and the SchedulingParameters extension is created if the Schedule has
+  * none for the service yet.
+  *
+  * Untyped by design, taking any sub-extension of the shape the parameter calls for, for example
+  * `{ url: 'bufferBefore', valueDuration: { value: 10, unit: 'min' } }`. A parameter whose value is a nested
+  * structure rather than a single `value[x]` is worth a typed wrapper over this; `availability` has one in
+  * `@medplum/react-scheduling`. Pairs with `clearScheduleParameter` and `getScheduleParameters`.
+  * @param schedule - Schedule to update
+  * @param service - HealthcareService referenced by the parameters
+  * @param subextension - SchedulingParameters sub-extension to set
+  * @returns A cloned Schedule containing the parameter
+  */
+ export declare function setScheduleParameter(schedule: Schedule, service: WithId<HealthcareService>, subextension: Extension): Schedule;
+
  export declare function singleton(collection: TypedValue[], type?: string): TypedValue | undefined;
 
  export declare function singularize<T>(value: T | T[] | undefined): T | undefined;
@@ -8630,6 +8769,8 @@ export declare class ParserBuilder {
      [index: string]: any;
  }): string[];
 
+ export declare function sumBy<T>(items: Iterable<T>, fn: (value: T) => number): number;
+
  /**
   * Summarizes a group of Observations into a single computed summary value, with the individual values
   * preserved in `Observation.component.valueSampledData`.

package/dist/esm/index.d.ts

@@ -16,6 +16,7 @@ import type { CustomTableLayout } from 'pdfmake/interfaces';
 import type { Device } from '@medplum/fhirtypes';
 import type { DiagnosticReport } from '@medplum/fhirtypes';
 import type { DocumentReference } from '@medplum/fhirtypes';
+import type { Duration } from '@medplum/fhirtypes';
 import type { ElementDefinition } from '@medplum/fhirtypes';
 import type { ElementDefinitionBinding } from '@medplum/fhirtypes';
 import type { Encounter } from '@medplum/fhirtypes';
@@ -831,6 +832,17 @@ export declare function checkIfValidMedplumVersion(appName: string, version: str
  */
 export declare function clearReleaseCache(): void;
 
+/**
+ * Immutably clears one scheduling parameter a Schedule sets for a HealthcareService, dropping that
+ * calendar back to the service-level parameter of the same name. Pairs with `setScheduleParameter`
+ * and `getScheduleParameters`.
+ * @param schedule - Schedule to update
+ * @param service - HealthcareService referenced by the parameters
+ * @param url - Url of the SchedulingParameters sub-extension to remove, for example `availability`
+ * @returns A cloned Schedule without the matching parameter
+ */
+export declare function clearScheduleParameter(schedule: Schedule, service: WithId<HealthcareService>, url: string): Schedule;
+
 /**
  * Log level for MedplumClient requests and responses.
  * - 'none': No logging
@@ -925,14 +937,19 @@ export declare function conceptMapTranslate(map: ConceptMap, params: ConceptMapT
 export declare interface ConceptMapTranslateMatch {
     equivalence?: string;
     concept?: Coding;
-    property?: ConceptMapTranslateMatchAttribute[];
+    property?: ConceptMapTranslateMatchProperty[];
     dependsOn?: ConceptMapTranslateMatchAttribute[];
     product?: ConceptMapTranslateMatchAttribute[];
     source?: string;
 }
 
 export declare interface ConceptMapTranslateMatchAttribute {
-    key: string;
+    attribute: string;
+    value: TypedValue;
+}
+
+export declare interface ConceptMapTranslateMatchProperty {
+    uri: string;
     value: TypedValue;
 }
 
@@ -1060,6 +1077,17 @@ export declare interface CopyOperation {
     path: string;
 }
 
+/**
+ * Counts iterable elements by a key function, returning a sparse map of key to count.
+ * Matches Lodash `countBy` semantics (no zero-fill for missing keys).
+ * @param items - The items to count.
+ * @param keyFn - The function to extract the key from each item.
+ * @returns A map of key to count for keys that appear at least once.
+ */
+export declare function countBy<T, K extends keyof any>(items: Iterable<T>, keyFn: (value: T) => K): Partial<Record<K, number>>;
+
+export declare function countWhere<T>(items: Iterable<T>, fn: (value: T) => boolean): number;
+
 export declare const CPT = "http://www.ama-assn.org/go/cpt";
 
 export declare interface CrawlerOptions {
@@ -1632,6 +1660,15 @@ export declare interface ExtendedInternalSchemaElement extends InternalSchemaEle
     readonly?: boolean;
 }
 
+/**
+ * Anything that can carry FHIR extensions: resources such as `Patient`, data types such as
+ * `CodeableConcept`, and extensions themselves. Structural, so any of those is accepted, while a
+ * type that cannot hold extensions, `Binary` being the notable example, is rejected.
+ */
+export declare interface Extensible {
+    extension?: Extension[];
+}
+
 export declare type ExternalSecret<T extends ExternalSecretPrimitive = ExternalSecretPrimitive> = {
     system: ExternalSecretSystem;
     key: string;
@@ -1852,7 +1889,11 @@ export declare type FhircastConnectEvent = {
  * 2. `message` - Contains a `payload` field containing a `FHIRcast` message payload exactly as it comes in over WebSockets.
  * 3. `disconnect` - An event to signal when a WebSocket connection has been closed. Fired as soon as a WebSocket emits `close`.
  *
- * To close the connection, call `connection.disconnect()` and listen to the `disconnect` event to know when the connection has been disconnected.
+ * The underlying socket reconnects on its own, so `disconnect` followed by `connect` is the normal
+ * shape of a dropped connection rather than the end of the session. A subscription endpoint stays
+ * valid for the lease the Hub granted it, so reconnecting resubscribes without a new `hub.subscribe`
+ * request. Two things end a connection for good: calling `connection.disconnect()`, and the Hub
+ * denying the subscription — after either, `connect` will not fire again.
  */
 export declare class FhircastConnection extends TypedEventTarget<FhircastSubscriptionEventMap> {
     readonly subRequest: SubscriptionRequest;
@@ -1860,11 +1901,17 @@ export declare class FhircastConnection extends TypedEventTarget<FhircastSubscri
     /**
      * Creates a new `FhircastConnection`.
      * @param subRequest - The subscription request to initialize the connection from.
+     * @param options - Options for the underlying `ReconnectingWebSocket`.
      */
-    constructor(subRequest: SubscriptionRequest);
+    constructor(subRequest: SubscriptionRequest, options?: FhircastConnectionOptions);
     disconnect(): void;
 }
 
+export declare type FhircastConnectionOptions = Options & {
+    /** An alternate `ReconnectingWebSocket` implementation to open the connection with. */
+    ReconnectingWebSocket?: IReconnectingWebSocketCtor;
+};
+
 export declare type FhircastContextResourceType<EventName extends FhircastEventName, K extends FhircastEventKeys<EventName>> = (typeof FHIRCAST_EVENT_RESOURCES)[EventName][K] extends {
     resourceType: infer R;
 } ? R : never;
@@ -2466,6 +2513,18 @@ export declare function getExpressionsForResourceType(resourceType: string, expr
  */
 export declare function getExtension(resource: any, ...urls: string[]): Extension | undefined;
 
+/**
+ * Returns every extension reachable by the given extension URLs.
+ *
+ * Like `getExtension`, but does not stop at the first match: extensions that repeat under one URL are
+ * all returned, at every level. Use it for extensions defined with a cardinality above one, where
+ * `getExtension` would silently read only the first.
+ * @param extensible - The base resource, data type, or extension. Anything that may hold an `extension` array.
+ * @param urlOrUrls - One extension URL, or an array of them where each entry represents descending a level in a nested extension.
+ * @returns Every matching extension, in document order. Empty if none match or no URL is given.
+ */
+export declare function getExtensions(extensible: Extensible | undefined, urlOrUrls: string | string[]): Extension[];
+
 /**
  * Returns an extension value by extension URLs.
  * @param resource - The base resource.
@@ -2608,6 +2667,30 @@ export declare function getReferenceString(input: Reference | Resource): string
  */
 export declare function getResourceTypes(): ResourceType[];
 
+/**
+ * Reads one scheduling parameter a Schedule sets for a HealthcareService, taking precedence over the
+ * service-level parameter of the same name. Pairs with `setScheduleParameter` and `clearScheduleParameter`.
+ *
+ * The result is a list rather than a single extension because a Schedule may carry more than one
+ * SchedulingParameters extension matching the service, and because a parameter may legitimately repeat.
+ * @param schedule - Schedule to inspect
+ * @param service - HealthcareService referenced by the parameters
+ * @param url - Url of the SchedulingParameters sub-extension to read, for example `availability`
+ * @returns Every matching sub-extension, in document order
+ */
+export declare function getScheduleParameters(schedule: Schedule, service: WithId<HealthcareService>, url: string): Extension[];
+
+/**
+ * Resolves the timezone used by scheduling in server priority order: the Schedule's parameters for the
+ * service, then the service's own parameters, then the actor's standard FHIR timezone extension.
+ * @param service - HealthcareService whose parameters may define a timezone
+ * @param schedule - Schedule whose parameters may define a timezone. Omit to resolve the service's own timezone,
+ * as when the service default hours are being read on their own rather than through a particular calendar.
+ * @param actor - Optional Schedule actor used as a timezone fallback
+ * @returns The resolved IANA timezone identifier, if present
+ */
+export declare function getSchedulingTimezone(service: WithId<HealthcareService>, schedule?: Schedule, actor?: Resource): string | undefined;
+
 /**
  * Returns a search parameter for a resource type by search code.
  * @param resourceType - The FHIR resource type.
@@ -2720,6 +2803,9 @@ export declare interface GoogleLoginRequest extends BaseLoginRequest {
 
 /**
  * Returns whether a Schedule or HealthcareService has a SchedulingParameters extension.
+ *
+ * Unscoped: on a Schedule, where the extension repeats once per service, this reports that some
+ * service is configured rather than any particular one. Ask `getScheduleParameters` about a service.
  * @param resource - Schedule or HealthcareService to inspect
  * @returns True if the resource has a SchedulingParameters extension
  */
@@ -3668,7 +3754,7 @@ export declare function isStringArray(arr: any[]): arr is string[];
 
 export declare type IssueSeverity = 'error' | 'fatal' | 'warning' | 'information';
 
-export declare type IssueType = 'structure' | 'invariant' | 'processing';
+export declare type IssueType = 'structure' | 'invariant' | 'processing' | 'required';
 
 /**
  * Returns true if the input value is an object with a string text property.
@@ -4223,6 +4309,25 @@ export declare interface MedicationOrderDrugInput {
     readonly ndc?: string;
     readonly rxNorm?: string;
     readonly routedMedId?: number;
+    /**
+     * Vendor formulation key, paired with {@link routedMedId} to order a drug that
+     * has no dose-level product to resolve an NDC from — OTC / topical /
+     * wide-multi-strength generics for which the vendor's dose-format lookup
+     * returns nothing. Supply {@link drugName} alongside it, since there is no
+     * catalog row to derive a name from.
+     */
+    readonly gcnSeqno?: number;
+    /** Drug name, required for a {@link gcnSeqno}-keyed line (no catalog row to name it). */
+    readonly drugName?: string;
+    /**
+     * Dose text for a {@link gcnSeqno}-keyed line, e.g. `"solution"`.
+     *
+     * Optional, and only worth sending when the caller holds dose text *separate*
+     * from {@link drugName} — a hand-entered form, say. Passing a full product
+     * label duplicates it in the description the vendor renders. When omitted, the
+     * vendor derives the dose from the formulation key or falls back to the sig.
+     */
+    readonly line1?: string;
     readonly quantity: number;
     readonly quantityQualifier?: string;
     readonly refill?: number;
@@ -4378,6 +4483,13 @@ export declare interface MedicationSearchParams {
     readonly ndc?: string;
     readonly rxNorm?: string;
     readonly routedMedId?: number;
+    /**
+     * Vendor formulation keys under {@link routedMedId}, from the name-search hit.
+     * Only used when the drug has no dose-level products: each key is resolved to
+     * its marketed strength so the caller still gets selectable formulations
+     * instead of an empty result. Ignored otherwise.
+     */
+    readonly gcnSeqnos?: number[];
     readonly searchOtc?: boolean;
     readonly searchSupply?: boolean;
     readonly searchBrand?: boolean;
@@ -6068,9 +6180,10 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
      *
      * @category FHIRcast
      * @param subRequest - The `SubscriptionRequest` to use for connecting.
+     * @param options - Options for the underlying `ReconnectingWebSocket`.
      * @returns A `FhircastConnection` which emits lifecycle events for the `FHIRcast` WebSocket connection.
      */
-    fhircastConnect(subRequest: SubscriptionRequest): FhircastConnection;
+    fhircastConnect(subRequest: SubscriptionRequest, options?: FhircastConnectionOptions): FhircastConnection;
     /**
      * Publishes a new context to a given topic for a specified event type.
      *
@@ -8165,6 +8278,15 @@ export declare class ParserBuilder {
   */
  export declare function satisfiedAccessPolicy(resource: Resource, interaction: AccessPolicyInteraction, accessPolicy: AccessPolicy | undefined): AccessPolicyResource | undefined;
 
+ /**
+  * Converts a SchedulingParameters duration to minutes.
+  *
+  * @param duration - The duration to convert.
+  * @returns The length in minutes, or undefined when the duration has no value, a
+  * negative value, or a unit scheduling does not accept.
+  */
+ export declare function schedulingDurationToMinutes(duration: Duration | undefined): number | undefined;
+
  export declare const SchedulingEncounterCodingURI = "https://medplum.com/fhir/StructureDefinition/SchedulingEncounterCoding";
 
  export declare const SchedulingParametersURI = "https://medplum.com/fhir/StructureDefinition/SchedulingParameters";
@@ -8322,6 +8444,23 @@ export declare class ParserBuilder {
      use?: Identifier['use'];
  }
 
+ /**
+  * Immutably sets one scheduling parameter on a Schedule for a HealthcareService, so that calendar keeps
+  * it in place of the service-level parameter of the same name. Whatever the Schedule already holds at the
+  * sub-extension's url is replaced, and the SchedulingParameters extension is created if the Schedule has
+  * none for the service yet.
+  *
+  * Untyped by design, taking any sub-extension of the shape the parameter calls for, for example
+  * `{ url: 'bufferBefore', valueDuration: { value: 10, unit: 'min' } }`. A parameter whose value is a nested
+  * structure rather than a single `value[x]` is worth a typed wrapper over this; `availability` has one in
+  * `@medplum/react-scheduling`. Pairs with `clearScheduleParameter` and `getScheduleParameters`.
+  * @param schedule - Schedule to update
+  * @param service - HealthcareService referenced by the parameters
+  * @param subextension - SchedulingParameters sub-extension to set
+  * @returns A cloned Schedule containing the parameter
+  */
+ export declare function setScheduleParameter(schedule: Schedule, service: WithId<HealthcareService>, subextension: Extension): Schedule;
+
  export declare function singleton(collection: TypedValue[], type?: string): TypedValue | undefined;
 
  export declare function singularize<T>(value: T | T[] | undefined): T | undefined;
@@ -8630,6 +8769,8 @@ export declare class ParserBuilder {
      [index: string]: any;
  }): string[];
 
+ export declare function sumBy<T>(items: Iterable<T>, fn: (value: T) => number): number;
+
  /**
   * Summarizes a group of Observations into a single computed summary value, with the individual values
   * preserved in `Observation.component.valueSampledData`.