@medplum/core 2.2.5 → 2.2.7

package/dist/cjs/index.d.ts

@@ -11,6 +11,7 @@ import { Bundle } from '@medplum/fhirtypes';
 import { CodeableConcept } from '@medplum/fhirtypes';
 import { Coding } from '@medplum/fhirtypes';
 import { Communication } from '@medplum/fhirtypes';
+import { ConceptMap } from '@medplum/fhirtypes';
 import type { CustomTableLayout } from 'pdfmake/interfaces';
 import { Device } from '@medplum/fhirtypes';
 import { ElementDefinition } from '@medplum/fhirtypes';
@@ -261,7 +262,7 @@ export declare function calculateAge(birthDateStr: string, endDateStr?: string):
  */
 export declare function calculateAgeString(birthDateStr: string, endDateStr?: string): string | undefined;
 
-declare type CanBePopulated = {
+export declare type CanBePopulated = {
     length: number;
 } | object;
 
@@ -337,6 +338,29 @@ export declare class ConcatAtom extends InfixOperatorAtom {
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
 }
 
+export declare function conceptMapTranslate(map: ConceptMap, params: ConceptMapTranslateParameters): ConceptMapTranslateOutput;
+
+export declare interface ConceptMapTranslateMatch {
+    equivalence?: string;
+    concept?: Coding;
+}
+
+export declare interface ConceptMapTranslateOutput {
+    result: boolean;
+    message?: string;
+    match?: ConceptMapTranslateMatch[];
+}
+
+export declare interface ConceptMapTranslateParameters {
+    url?: string;
+    source?: string;
+    code?: string;
+    system?: string;
+    coding?: Coding;
+    codeableConcept?: CodeableConcept;
+    targetsystem?: string;
+}
+
 export declare interface Constraint {
     key: string;
     severity: 'error' | 'warning';
@@ -1564,6 +1588,8 @@ export declare class Hl7Segment {
     static parse(text: string, context?: Hl7Context): Hl7Segment;
 }
 
+export declare const HTTP_HL7_ORG = "http://hl7.org";
+
 export declare interface HumanNameFormatOptions {
     all?: boolean;
     prefix?: boolean;
@@ -1889,6 +1915,13 @@ export declare function isUUID(input: string): input is string;
  */
 export declare function isValidDate(date: Date): boolean;
 
+/**
+ * Memoizes the result of a parameterless function
+ * @param fn - The function to be wrapped
+ * @returns The result of the first invocation of the wrapped function
+ */
+export declare function lazy<T>(fn: () => T): () => T;
+
 export declare class LiteralAtom implements Atom {
     readonly value: TypedValue;
     constructor(value: TypedValue);
@@ -2129,6 +2162,7 @@ export declare class MedplumClient extends EventTarget_2 {
     private clientSecret?;
     private autoBatchTimerId?;
     private accessToken?;
+    private accessTokenExpires?;
     private refreshToken?;
     private refreshPromise?;
     private profilePromise?;
@@ -2525,8 +2559,18 @@ export declare class MedplumClient extends EventTarget_2 {
      * @param filter - The search string.
      * @param options - Optional fetch options.
      * @returns Promise to expanded ValueSet.
+     * @deprecated Use `valueSetExpand()` instead.
      */
     searchValueSet(system: string, filter: string, options?: RequestInit): ReadablePromise<ValueSet>;
+    /**
+     * Searches a ValueSet resource using the "expand" operation.
+     * See: https://www.hl7.org/fhir/operation-valueset-expand.html
+     * @category Search
+     * @param params - The ValueSet expand parameters.
+     * @param options - Optional fetch options.
+     * @returns Promise to expanded ValueSet.
+     */
+    valueSetExpand(params: ValueSetExpandParams, options?: RequestInit): ReadablePromise<ValueSet>;
     /**
      * Returns a cached resource if it is available.
      * @category Caching
@@ -3298,6 +3342,11 @@ export declare class MedplumClient extends EventTarget_2 {
      * @category Authentication
      */
     processCode(code: string, loginParams?: Partial<BaseLoginRequest>): Promise<ProfileResource>;
+    /**
+     * Refreshes the access token using the refresh token if available.
+     * @returns Promise to refresh the access token.
+     */
+    refreshIfExpired(): Promise<void>;
     /**
      * Tries to refresh the auth tokens.
      * @returns The refresh promise if available; otherwise undefined.
@@ -4079,9 +4128,7 @@ export declare class ParserBuilder {
  * @param reference - A reference to a FHIR resource.
  * @returns A tuple containing the `ResourceType` and the ID of the resource or `undefined` when `undefined` or an invalid reference is passed.
  */
-export declare function parseReference(reference: Reference): [ResourceType, string] | undefined;
-
-export declare function parseReference(reference: undefined): undefined;
+export declare function parseReference(reference: Reference | undefined): [ResourceType, string];
 
 /**
  * Parses a URL string into a SearchRequest.
@@ -4547,6 +4594,16 @@ export declare function stringify(value: any, pretty?: boolean): string;
  */
 export declare function stringifyTypedValue(v: TypedValue): string;
 
+/**
+ * Transforms input values using a FHIR StructureMap.
+ *
+ * See: https://www.hl7.org/fhir/mapping-language.html
+ *
+ * @param structureMap - The StructureMap to transform.
+ * @param input - The input values.
+ * @param loader - Optional loader function for loading imported StructureMaps.
+ * @returns The transformed values.
+ */
 export declare function structureMapTransform(structureMap: StructureMap, input: TypedValue[], loader?: (url: string) => StructureMap[]): TypedValue[];
 
 /**
@@ -4653,6 +4710,13 @@ export declare function toTypedValue(value: unknown): TypedValue;
 
 export declare function tryGetDataType(type: string, profileUrl?: string): InternalTypeSchema | undefined;
 
+/**
+ * Returns the JWT expiration time in number of milliseconds elapsed since the epoch.
+ * @param token - The JWT token.
+ * @returns The JWT expiration time in number of milliseconds elapsed since the epoch if available, undefined if unknown.
+ */
+export declare function tryGetJwtExpiration(token: string): number | undefined;
+
 export declare function tryGetProfile(profileUrl: string): InternalTypeSchema | undefined;
 
 export declare class TypedEventTarget<TEvents extends Record<string, Event_2>> {
@@ -4752,6 +4816,18 @@ export declare function validationError(details: string): OperationOutcome;
 
 export declare type ValueOrExternalSecret<T extends ExternalSecretPrimitive> = T | ExternalSecret<T>;
 
+/**
+ * ValueSet $expand operation parameters.
+ * See: https://hl7.org/fhir/r4/valueset-operation-expand.html
+ */
+export declare interface ValueSetExpandParams {
+    url?: string;
+    filter?: string;
+    date?: string;
+    offset?: number;
+    count?: number;
+}
+
 /**
  * 6.5.4. xor
  * Returns true if exactly one of the operands evaluates to true,

package/dist/esm/index.d.ts

@@ -11,6 +11,7 @@ import { Bundle } from '@medplum/fhirtypes';
 import { CodeableConcept } from '@medplum/fhirtypes';
 import { Coding } from '@medplum/fhirtypes';
 import { Communication } from '@medplum/fhirtypes';
+import { ConceptMap } from '@medplum/fhirtypes';
 import type { CustomTableLayout } from 'pdfmake/interfaces';
 import { Device } from '@medplum/fhirtypes';
 import { ElementDefinition } from '@medplum/fhirtypes';
@@ -261,7 +262,7 @@ export declare function calculateAge(birthDateStr: string, endDateStr?: string):
  */
 export declare function calculateAgeString(birthDateStr: string, endDateStr?: string): string | undefined;
 
-declare type CanBePopulated = {
+export declare type CanBePopulated = {
     length: number;
 } | object;
 
@@ -337,6 +338,29 @@ export declare class ConcatAtom extends InfixOperatorAtom {
     eval(context: AtomContext, input: TypedValue[]): TypedValue[];
 }
 
+export declare function conceptMapTranslate(map: ConceptMap, params: ConceptMapTranslateParameters): ConceptMapTranslateOutput;
+
+export declare interface ConceptMapTranslateMatch {
+    equivalence?: string;
+    concept?: Coding;
+}
+
+export declare interface ConceptMapTranslateOutput {
+    result: boolean;
+    message?: string;
+    match?: ConceptMapTranslateMatch[];
+}
+
+export declare interface ConceptMapTranslateParameters {
+    url?: string;
+    source?: string;
+    code?: string;
+    system?: string;
+    coding?: Coding;
+    codeableConcept?: CodeableConcept;
+    targetsystem?: string;
+}
+
 export declare interface Constraint {
     key: string;
     severity: 'error' | 'warning';
@@ -1564,6 +1588,8 @@ export declare class Hl7Segment {
     static parse(text: string, context?: Hl7Context): Hl7Segment;
 }
 
+export declare const HTTP_HL7_ORG = "http://hl7.org";
+
 export declare interface HumanNameFormatOptions {
     all?: boolean;
     prefix?: boolean;
@@ -1889,6 +1915,13 @@ export declare function isUUID(input: string): input is string;
  */
 export declare function isValidDate(date: Date): boolean;
 
+/**
+ * Memoizes the result of a parameterless function
+ * @param fn - The function to be wrapped
+ * @returns The result of the first invocation of the wrapped function
+ */
+export declare function lazy<T>(fn: () => T): () => T;
+
 export declare class LiteralAtom implements Atom {
     readonly value: TypedValue;
     constructor(value: TypedValue);
@@ -2129,6 +2162,7 @@ export declare class MedplumClient extends EventTarget_2 {
     private clientSecret?;
     private autoBatchTimerId?;
     private accessToken?;
+    private accessTokenExpires?;
     private refreshToken?;
     private refreshPromise?;
     private profilePromise?;
@@ -2525,8 +2559,18 @@ export declare class MedplumClient extends EventTarget_2 {
      * @param filter - The search string.
      * @param options - Optional fetch options.
      * @returns Promise to expanded ValueSet.
+     * @deprecated Use `valueSetExpand()` instead.
      */
     searchValueSet(system: string, filter: string, options?: RequestInit): ReadablePromise<ValueSet>;
+    /**
+     * Searches a ValueSet resource using the "expand" operation.
+     * See: https://www.hl7.org/fhir/operation-valueset-expand.html
+     * @category Search
+     * @param params - The ValueSet expand parameters.
+     * @param options - Optional fetch options.
+     * @returns Promise to expanded ValueSet.
+     */
+    valueSetExpand(params: ValueSetExpandParams, options?: RequestInit): ReadablePromise<ValueSet>;
     /**
      * Returns a cached resource if it is available.
      * @category Caching
@@ -3298,6 +3342,11 @@ export declare class MedplumClient extends EventTarget_2 {
      * @category Authentication
      */
     processCode(code: string, loginParams?: Partial<BaseLoginRequest>): Promise<ProfileResource>;
+    /**
+     * Refreshes the access token using the refresh token if available.
+     * @returns Promise to refresh the access token.
+     */
+    refreshIfExpired(): Promise<void>;
     /**
      * Tries to refresh the auth tokens.
      * @returns The refresh promise if available; otherwise undefined.
@@ -4079,9 +4128,7 @@ export declare class ParserBuilder {
  * @param reference - A reference to a FHIR resource.
  * @returns A tuple containing the `ResourceType` and the ID of the resource or `undefined` when `undefined` or an invalid reference is passed.
  */
-export declare function parseReference(reference: Reference): [ResourceType, string] | undefined;
-
-export declare function parseReference(reference: undefined): undefined;
+export declare function parseReference(reference: Reference | undefined): [ResourceType, string];
 
 /**
  * Parses a URL string into a SearchRequest.
@@ -4547,6 +4594,16 @@ export declare function stringify(value: any, pretty?: boolean): string;
  */
 export declare function stringifyTypedValue(v: TypedValue): string;
 
+/**
+ * Transforms input values using a FHIR StructureMap.
+ *
+ * See: https://www.hl7.org/fhir/mapping-language.html
+ *
+ * @param structureMap - The StructureMap to transform.
+ * @param input - The input values.
+ * @param loader - Optional loader function for loading imported StructureMaps.
+ * @returns The transformed values.
+ */
 export declare function structureMapTransform(structureMap: StructureMap, input: TypedValue[], loader?: (url: string) => StructureMap[]): TypedValue[];
 
 /**
@@ -4653,6 +4710,13 @@ export declare function toTypedValue(value: unknown): TypedValue;
 
 export declare function tryGetDataType(type: string, profileUrl?: string): InternalTypeSchema | undefined;
 
+/**
+ * Returns the JWT expiration time in number of milliseconds elapsed since the epoch.
+ * @param token - The JWT token.
+ * @returns The JWT expiration time in number of milliseconds elapsed since the epoch if available, undefined if unknown.
+ */
+export declare function tryGetJwtExpiration(token: string): number | undefined;
+
 export declare function tryGetProfile(profileUrl: string): InternalTypeSchema | undefined;
 
 export declare class TypedEventTarget<TEvents extends Record<string, Event_2>> {
@@ -4752,6 +4816,18 @@ export declare function validationError(details: string): OperationOutcome;
 
 export declare type ValueOrExternalSecret<T extends ExternalSecretPrimitive> = T | ExternalSecret<T>;
 
+/**
+ * ValueSet $expand operation parameters.
+ * See: https://hl7.org/fhir/r4/valueset-operation-expand.html
+ */
+export declare interface ValueSetExpandParams {
+    url?: string;
+    filter?: string;
+    date?: string;
+    offset?: number;
+    count?: number;
+}
+
 /**
  * 6.5.4. xor
  * Returns true if exactly one of the operands evaluates to true,