@medplum/core 3.2.6 → 3.2.8

package/dist/cjs/index.d.ts

@@ -245,7 +245,7 @@ export declare function assertContextVersionOptional(event: string): asserts eve
  */
 export declare function assertOk<T>(outcome: OperationOutcome, resource: T | undefined): asserts resource is T;
 
-export declare interface AsyncResourceVisitor {
+export declare interface AsyncCrawlerVisitor {
     onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
     onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
     onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
@@ -253,6 +253,9 @@ export declare interface AsyncResourceVisitor {
     visitPropertyAsync: (parent: TypedValueWithPath, key: string, path: string, value: TypedValueWithPath | TypedValueWithPath[], schema: InternalTypeSchema) => Promise<void>;
 }
 
+/** @deprecated - Use AsyncCrawlerVisitor instead */
+export declare type AsyncResourceVisitor = AsyncCrawlerVisitor;
+
 export declare interface Atom {
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
     toString(): string;
@@ -542,15 +545,29 @@ export declare type ConvertToUnion<T> = T[keyof T];
 
 export declare const CPT = "http://www.ama-assn.org/go/cpt";
 
+export declare interface CrawlerOptions {
+    skipMissingProperties?: boolean;
+    schema?: InternalTypeSchema;
+    initialPath?: string;
+}
+
+export declare interface CrawlerVisitor {
+    onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
+    onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
+    onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
+    onExitResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
+    visitProperty: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
+}
+
 /**
  * Crawls the resource synchronously.
  * @param resource - The resource to crawl.
  * @param visitor - The visitor functions to apply while crawling.
  * @param schema - The schema to use for the resource.
  * @param initialPath - The path within the resource form which to start crawling.
- * @deprecated
+ * @deprecated - Use crawlTypedValue instead
  */
-export declare function crawlResource(resource: Resource, visitor: ResourceVisitor, schema?: InternalTypeSchema, initialPath?: string): void;
+export declare function crawlResource(resource: Resource, visitor: CrawlerVisitor, schema?: InternalTypeSchema, initialPath?: string): void;
 
 /**
  * Crawls the resource asynchronously.
@@ -558,25 +575,45 @@ export declare function crawlResource(resource: Resource, visitor: ResourceVisit
  * @param visitor - The visitor functions to apply while crawling.
  * @param options - Options for how to crawl the resource.
  * @returns void
- * @deprecated
+ * @deprecated - Use crawlTypedValueAsync instead
  */
-export declare function crawlResource(resource: Resource, visitor: AsyncResourceVisitor, options: ResourceCrawlerOptions): Promise<void>;
+export declare function crawlResource(resource: Resource, visitor: AsyncCrawlerVisitor, options: CrawlerOptions): Promise<void>;
 
 /**
  * Crawls the resource synchronously.
  * @param resource - The resource to crawl.
  * @param visitor - The visitor functions to apply while crawling.
  * @param options - Options for how to crawl the resource.
+ * @deprecated - Use crawlTypedValue instead
  */
-export declare function crawlResource(resource: Resource, visitor: ResourceVisitor, options?: ResourceCrawlerOptions): void;
+export declare function crawlResource(resource: Resource, visitor: CrawlerVisitor, options?: CrawlerOptions): void;
 
 /**
  * Crawls the resource asynchronously.
  * @param resource - The resource to crawl.
  * @param visitor - The visitor functions to apply while crawling.
  * @param options - Options for how to crawl the resource.
+ * @returns Promise
+ * @deprecated - Use crawlTypedValueAsync instead
+ */
+export declare function crawlResourceAsync(resource: Resource, visitor: AsyncCrawlerVisitor, options: CrawlerOptions): Promise<void>;
+
+/**
+ * Crawls the typed value synchronously.
+ * @param typedValue - The typed value to crawl.
+ * @param visitor - The visitor functions to apply while crawling.
+ * @param options - Options for how to crawl the typed value.
  */
-export declare function crawlResourceAsync(resource: Resource, visitor: AsyncResourceVisitor, options: ResourceCrawlerOptions): Promise<void>;
+export declare function crawlTypedValue(typedValue: TypedValue, visitor: CrawlerVisitor, options?: CrawlerOptions): void;
+
+/**
+ * Crawls the typed value asynchronously.
+ * @param typedValue - The typed value to crawl.
+ * @param visitor - The visitor functions to apply while crawling.
+ * @param options - Options for how to crawl the typed value.
+ * @returns Promise to crawl the typed value.
+ */
+export declare function crawlTypedValueAsync(typedValue: TypedValue, visitor: AsyncCrawlerVisitor, options?: CrawlerOptions): Promise<void>;
 
 /**
  * Binary upload options.
@@ -2080,6 +2117,7 @@ export declare interface InternalSchemaElement {
 export declare interface InternalTypeSchema {
     name: string;
     type: string;
+    path: string;
     title?: string;
     url?: string;
     kind?: string;
@@ -2237,6 +2275,13 @@ export declare function isPopulated<T extends {
     length: number;
 } | object>(arg: CanBePopulated | undefined | null): arg is T;
 
+/**
+ * Returns true if the type code is a primitive type.
+ * @param code - The type code to check.
+ * @returns True if the type code is a primitive type.
+ */
+export declare function isPrimitiveType(code: string): boolean;
+
 export declare function isProfileLoaded(profileUrl: string): boolean;
 
 /**
@@ -2662,6 +2707,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     private readonly onUnauthenticated?;
     private readonly autoBatchTime;
     private readonly autoBatchQueue;
+    private readonly refreshGracePeriod;
     private subscriptionManager?;
     private medplumServer?;
     private clientId?;
@@ -3910,9 +3956,10 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     processCode(code: string, loginParams?: Partial<BaseLoginRequest>): Promise<ProfileResource>;
     /**
      * Refreshes the access token using the refresh token if available.
+     * @param gracePeriod - Optional grace period in milliseconds. If not specified, uses the client configured grace period (default 5 minutes).
      * @returns Promise to refresh the access token.
      */
-    refreshIfExpired(): Promise<void>;
+    refreshIfExpired(gracePeriod?: number): Promise<void>;
     /**
      * Tries to refresh the auth tokens.
      * @returns The refresh promise if available; otherwise undefined.
@@ -4250,6 +4297,14 @@ export declare interface MedplumClientOptions {
      * Default value is 0, which disables auto batching.
      */
     autoBatchTime?: number;
+    /**
+     * The refresh grace period in milliseconds.
+     *
+     * This is the amount of time before the access token expires that the client will attempt to refresh the token.
+     *
+     * Default value is 300000 (5 minutes).
+     */
+    refreshGracePeriod?: number;
     /**
      * Fetch implementation.
      *
@@ -4359,6 +4414,7 @@ export declare interface MedplumInfraConfig {
     rdsInstances: number;
     rdsInstanceType: string;
     rdsInstanceVersion?: string;
+    rdsInstanceParameters?: StringMap;
     rdsSecretsArn?: string;
     rdsReaderInstanceType?: string;
     rdsProxyEnabled?: boolean;
@@ -4484,6 +4540,7 @@ export declare interface MedplumSourceInfraConfig {
     rdsSecretsArn?: ValueOrExternalSecret<string>;
     rdsReaderInstanceType?: ValueOrExternalSecret<string>;
     rdsProxyEnabled?: ValueOrExternalSecret<boolean>;
+    rdsClusterParameters?: StringMap;
     cacheNodeType?: ValueOrExternalSecret<string>;
     cacheSecurityGroupId?: ValueOrExternalSecret<string>;
     desiredServerCount: ValueOrExternalSecret<number>;
@@ -5335,11 +5392,8 @@ export declare type ResourceArray<T extends Resource = Resource> = T[] & {
     bundle: Bundle<T>;
 };
 
-export declare type ResourceCrawlerOptions = {
-    skipMissingProperties?: boolean;
-    schema?: InternalTypeSchema;
-    initialPath?: string;
-};
+/** @deprecated - Use CrawlerOptions instead */
+export declare type ResourceCrawlerOptions = CrawlerOptions;
 
 export declare type ResourceMatchesSubscriptionCriteria = {
     resource: Resource;
@@ -5351,13 +5405,8 @@ export declare type ResourceMatchesSubscriptionCriteria = {
 
 export declare function resourceMatchesSubscriptionCriteria({ resource, subscription, context, getPreviousResource, logger, }: ResourceMatchesSubscriptionCriteria): Promise<boolean>;
 
-export declare interface ResourceVisitor {
-    onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    onExitResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    visitProperty: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
-}
+/** @deprecated - Use CrawlerVisitor instead */
+export declare type ResourceVisitor = CrawlerVisitor;
 
 export declare type ResourceWithCode = Resource & Code;
 
@@ -5396,6 +5445,7 @@ export declare interface SearchRequest<T extends Resource = Resource> {
     readonly resourceType: T['resourceType'];
     filters?: Filter[];
     sortRules?: SortRule[];
+    cursor?: string;
     offset?: number;
     count?: number;
     fields?: string[];
@@ -5568,10 +5618,10 @@ export declare type StringMap = {
  *
  * @param structureMap - The StructureMap to transform.
  * @param input - The input values.
- * @param loader - Optional loader function for loading imported StructureMaps.
+ * @param transformMaps - Optional collection of imported StructureMaps and ConceptMaps.
  * @returns The transformed values.
  */
-export declare function structureMapTransform(structureMap: StructureMap, input: TypedValue[], loader?: (url: string) => StructureMap[]): TypedValue[];
+export declare function structureMapTransform(structureMap: StructureMap, input: TypedValue[], transformMaps?: TransformMapCollection): TypedValue[];
 
 export declare interface SubManagerOptions {
     ReconnectingWebSocket?: IReconnectingWebSocketCtor;
@@ -5654,8 +5704,9 @@ export declare class SubscriptionManager {
     private pingTimer;
     private pingIntervalMs;
     private waitingForPong;
+    private currentProfile;
     constructor(medplum: MedplumClient, wsUrl: URL | string, options?: SubManagerOptions);
-    private setupWebSocketListeners;
+    private setupListeners;
     private emitError;
     private maybeEmitDisconnect;
     private getTokenForCriteria;
@@ -5784,6 +5835,17 @@ export declare function toPeriod(input: unknown): Period | undefined;
  */
 export declare function toTypedValue(value: unknown): TypedValue;
 
+/**
+ * The TransformMapCollection class is a collection of StructureMap and ConceptMap resources.
+ * It is used to store and retrieve imported StructureMaps and ConceptMaps by URL.
+ */
+export declare class TransformMapCollection {
+    readonly resources: (StructureMap | ConceptMap)[];
+    constructor(resources?: (StructureMap | ConceptMap)[]);
+    get<K extends ResourceType>(resourceType: K, url: string): ExtractResource<K>[];
+    private matchesUrl;
+}
+
 export declare function tryGetDataType(type: string, profileUrl?: string): InternalTypeSchema | undefined;
 
 /**

package/dist/esm/index.d.ts

@@ -245,7 +245,7 @@ export declare function assertContextVersionOptional(event: string): asserts eve
  */
 export declare function assertOk<T>(outcome: OperationOutcome, resource: T | undefined): asserts resource is T;
 
-export declare interface AsyncResourceVisitor {
+export declare interface AsyncCrawlerVisitor {
     onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
     onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
     onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => Promise<void>;
@@ -253,6 +253,9 @@ export declare interface AsyncResourceVisitor {
     visitPropertyAsync: (parent: TypedValueWithPath, key: string, path: string, value: TypedValueWithPath | TypedValueWithPath[], schema: InternalTypeSchema) => Promise<void>;
 }
 
+/** @deprecated - Use AsyncCrawlerVisitor instead */
+export declare type AsyncResourceVisitor = AsyncCrawlerVisitor;
+
 export declare interface Atom {
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
     toString(): string;
@@ -542,15 +545,29 @@ export declare type ConvertToUnion<T> = T[keyof T];
 
 export declare const CPT = "http://www.ama-assn.org/go/cpt";
 
+export declare interface CrawlerOptions {
+    skipMissingProperties?: boolean;
+    schema?: InternalTypeSchema;
+    initialPath?: string;
+}
+
+export declare interface CrawlerVisitor {
+    onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
+    onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
+    onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
+    onExitResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
+    visitProperty: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
+}
+
 /**
  * Crawls the resource synchronously.
  * @param resource - The resource to crawl.
  * @param visitor - The visitor functions to apply while crawling.
  * @param schema - The schema to use for the resource.
  * @param initialPath - The path within the resource form which to start crawling.
- * @deprecated
+ * @deprecated - Use crawlTypedValue instead
  */
-export declare function crawlResource(resource: Resource, visitor: ResourceVisitor, schema?: InternalTypeSchema, initialPath?: string): void;
+export declare function crawlResource(resource: Resource, visitor: CrawlerVisitor, schema?: InternalTypeSchema, initialPath?: string): void;
 
 /**
  * Crawls the resource asynchronously.
@@ -558,25 +575,45 @@ export declare function crawlResource(resource: Resource, visitor: ResourceVisit
  * @param visitor - The visitor functions to apply while crawling.
  * @param options - Options for how to crawl the resource.
  * @returns void
- * @deprecated
+ * @deprecated - Use crawlTypedValueAsync instead
  */
-export declare function crawlResource(resource: Resource, visitor: AsyncResourceVisitor, options: ResourceCrawlerOptions): Promise<void>;
+export declare function crawlResource(resource: Resource, visitor: AsyncCrawlerVisitor, options: CrawlerOptions): Promise<void>;
 
 /**
  * Crawls the resource synchronously.
  * @param resource - The resource to crawl.
  * @param visitor - The visitor functions to apply while crawling.
  * @param options - Options for how to crawl the resource.
+ * @deprecated - Use crawlTypedValue instead
  */
-export declare function crawlResource(resource: Resource, visitor: ResourceVisitor, options?: ResourceCrawlerOptions): void;
+export declare function crawlResource(resource: Resource, visitor: CrawlerVisitor, options?: CrawlerOptions): void;
 
 /**
  * Crawls the resource asynchronously.
  * @param resource - The resource to crawl.
  * @param visitor - The visitor functions to apply while crawling.
  * @param options - Options for how to crawl the resource.
+ * @returns Promise
+ * @deprecated - Use crawlTypedValueAsync instead
+ */
+export declare function crawlResourceAsync(resource: Resource, visitor: AsyncCrawlerVisitor, options: CrawlerOptions): Promise<void>;
+
+/**
+ * Crawls the typed value synchronously.
+ * @param typedValue - The typed value to crawl.
+ * @param visitor - The visitor functions to apply while crawling.
+ * @param options - Options for how to crawl the typed value.
  */
-export declare function crawlResourceAsync(resource: Resource, visitor: AsyncResourceVisitor, options: ResourceCrawlerOptions): Promise<void>;
+export declare function crawlTypedValue(typedValue: TypedValue, visitor: CrawlerVisitor, options?: CrawlerOptions): void;
+
+/**
+ * Crawls the typed value asynchronously.
+ * @param typedValue - The typed value to crawl.
+ * @param visitor - The visitor functions to apply while crawling.
+ * @param options - Options for how to crawl the typed value.
+ * @returns Promise to crawl the typed value.
+ */
+export declare function crawlTypedValueAsync(typedValue: TypedValue, visitor: AsyncCrawlerVisitor, options?: CrawlerOptions): Promise<void>;
 
 /**
  * Binary upload options.
@@ -2080,6 +2117,7 @@ export declare interface InternalSchemaElement {
 export declare interface InternalTypeSchema {
     name: string;
     type: string;
+    path: string;
     title?: string;
     url?: string;
     kind?: string;
@@ -2237,6 +2275,13 @@ export declare function isPopulated<T extends {
     length: number;
 } | object>(arg: CanBePopulated | undefined | null): arg is T;
 
+/**
+ * Returns true if the type code is a primitive type.
+ * @param code - The type code to check.
+ * @returns True if the type code is a primitive type.
+ */
+export declare function isPrimitiveType(code: string): boolean;
+
 export declare function isProfileLoaded(profileUrl: string): boolean;
 
 /**
@@ -2662,6 +2707,7 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     private readonly onUnauthenticated?;
     private readonly autoBatchTime;
     private readonly autoBatchQueue;
+    private readonly refreshGracePeriod;
     private subscriptionManager?;
     private medplumServer?;
     private clientId?;
@@ -3910,9 +3956,10 @@ export declare class MedplumClient extends TypedEventTarget<MedplumClientEventMa
     processCode(code: string, loginParams?: Partial<BaseLoginRequest>): Promise<ProfileResource>;
     /**
      * Refreshes the access token using the refresh token if available.
+     * @param gracePeriod - Optional grace period in milliseconds. If not specified, uses the client configured grace period (default 5 minutes).
      * @returns Promise to refresh the access token.
      */
-    refreshIfExpired(): Promise<void>;
+    refreshIfExpired(gracePeriod?: number): Promise<void>;
     /**
      * Tries to refresh the auth tokens.
      * @returns The refresh promise if available; otherwise undefined.
@@ -4250,6 +4297,14 @@ export declare interface MedplumClientOptions {
      * Default value is 0, which disables auto batching.
      */
     autoBatchTime?: number;
+    /**
+     * The refresh grace period in milliseconds.
+     *
+     * This is the amount of time before the access token expires that the client will attempt to refresh the token.
+     *
+     * Default value is 300000 (5 minutes).
+     */
+    refreshGracePeriod?: number;
     /**
      * Fetch implementation.
      *
@@ -4359,6 +4414,7 @@ export declare interface MedplumInfraConfig {
     rdsInstances: number;
     rdsInstanceType: string;
     rdsInstanceVersion?: string;
+    rdsInstanceParameters?: StringMap;
     rdsSecretsArn?: string;
     rdsReaderInstanceType?: string;
     rdsProxyEnabled?: boolean;
@@ -4484,6 +4540,7 @@ export declare interface MedplumSourceInfraConfig {
     rdsSecretsArn?: ValueOrExternalSecret<string>;
     rdsReaderInstanceType?: ValueOrExternalSecret<string>;
     rdsProxyEnabled?: ValueOrExternalSecret<boolean>;
+    rdsClusterParameters?: StringMap;
     cacheNodeType?: ValueOrExternalSecret<string>;
     cacheSecurityGroupId?: ValueOrExternalSecret<string>;
     desiredServerCount: ValueOrExternalSecret<number>;
@@ -5335,11 +5392,8 @@ export declare type ResourceArray<T extends Resource = Resource> = T[] & {
     bundle: Bundle<T>;
 };
 
-export declare type ResourceCrawlerOptions = {
-    skipMissingProperties?: boolean;
-    schema?: InternalTypeSchema;
-    initialPath?: string;
-};
+/** @deprecated - Use CrawlerOptions instead */
+export declare type ResourceCrawlerOptions = CrawlerOptions;
 
 export declare type ResourceMatchesSubscriptionCriteria = {
     resource: Resource;
@@ -5351,13 +5405,8 @@ export declare type ResourceMatchesSubscriptionCriteria = {
 
 export declare function resourceMatchesSubscriptionCriteria({ resource, subscription, context, getPreviousResource, logger, }: ResourceMatchesSubscriptionCriteria): Promise<boolean>;
 
-export declare interface ResourceVisitor {
-    onEnterObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    onExitObject?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    onEnterResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    onExitResource?: (path: string, value: TypedValueWithPath, schema: InternalTypeSchema) => void;
-    visitProperty: (parent: TypedValueWithPath, key: string, path: string, propertyValues: (TypedValueWithPath | TypedValueWithPath[])[], schema: InternalTypeSchema) => void;
-}
+/** @deprecated - Use CrawlerVisitor instead */
+export declare type ResourceVisitor = CrawlerVisitor;
 
 export declare type ResourceWithCode = Resource & Code;
 
@@ -5396,6 +5445,7 @@ export declare interface SearchRequest<T extends Resource = Resource> {
     readonly resourceType: T['resourceType'];
     filters?: Filter[];
     sortRules?: SortRule[];
+    cursor?: string;
     offset?: number;
     count?: number;
     fields?: string[];
@@ -5568,10 +5618,10 @@ export declare type StringMap = {
  *
  * @param structureMap - The StructureMap to transform.
  * @param input - The input values.
- * @param loader - Optional loader function for loading imported StructureMaps.
+ * @param transformMaps - Optional collection of imported StructureMaps and ConceptMaps.
  * @returns The transformed values.
  */
-export declare function structureMapTransform(structureMap: StructureMap, input: TypedValue[], loader?: (url: string) => StructureMap[]): TypedValue[];
+export declare function structureMapTransform(structureMap: StructureMap, input: TypedValue[], transformMaps?: TransformMapCollection): TypedValue[];
 
 export declare interface SubManagerOptions {
     ReconnectingWebSocket?: IReconnectingWebSocketCtor;
@@ -5654,8 +5704,9 @@ export declare class SubscriptionManager {
     private pingTimer;
     private pingIntervalMs;
     private waitingForPong;
+    private currentProfile;
     constructor(medplum: MedplumClient, wsUrl: URL | string, options?: SubManagerOptions);
-    private setupWebSocketListeners;
+    private setupListeners;
     private emitError;
     private maybeEmitDisconnect;
     private getTokenForCriteria;
@@ -5784,6 +5835,17 @@ export declare function toPeriod(input: unknown): Period | undefined;
  */
 export declare function toTypedValue(value: unknown): TypedValue;
 
+/**
+ * The TransformMapCollection class is a collection of StructureMap and ConceptMap resources.
+ * It is used to store and retrieve imported StructureMaps and ConceptMaps by URL.
+ */
+export declare class TransformMapCollection {
+    readonly resources: (StructureMap | ConceptMap)[];
+    constructor(resources?: (StructureMap | ConceptMap)[]);
+    get<K extends ResourceType>(resourceType: K, url: string): ExtractResource<K>[];
+    private matchesUrl;
+}
+
 export declare function tryGetDataType(type: string, profileUrl?: string): InternalTypeSchema | undefined;
 
 /**