@medplum/core 2.0.28 → 2.0.30

package/dist/types/bundle.d.ts

@@ -9,3 +9,14 @@ import { Bundle } from '@medplum/fhirtypes';
  * @returns transaction type bundle
  */
 export declare function convertToTransactionBundle(bundle: Bundle): Bundle;
+/**
+ * Topologically sorts a `batch` or `transaction` bundle to improve reference resolution.
+ * The bundle is sorted such that a resource is created _before_ references to that resource appear in the bundle.
+ *
+ * In the event of cycles, this function will first create a POST request for each resource in the cycle, and then will
+ * append a PUT request to the bundle. This ensures that each resources in the cycle is visited twice, and all
+ * references can be resolved
+ * @param bundle Input bundle with type `batch` or `transaction`
+ * @returns Bundle of the same type, with Bundle.entry reordered
+ */
+export declare function reorderBundle(bundle: Bundle): Bundle;

package/dist/types/client.d.ts

@@ -1,6 +1,7 @@
 import { AccessPolicy, Attachment, Binary, BulkDataExport, Bundle, Communication, ExtractResource, Identifier, Media, OperationOutcome, Project, ProjectMembership, ProjectMembershipAccess, ProjectSecret, Reference, Resource, ResourceType, UserConfiguration, ValueSet } from '@medplum/fhirtypes';
 /** @ts-ignore */
 import type { CustomTableLayout, TDocumentDefinitions, TFontDictionary } from 'pdfmake/interfaces';
+import { EventTarget } from './eventtarget';
 import { Hl7Message } from './hl7';
 import { ReadablePromise } from './readablepromise';
 import { ClientStorage } from './storage';
@@ -107,6 +108,14 @@ export interface MedplumClientOptions {
      * For Node.js applications, consider the 'node-fetch' package.
      */
     fetch?: FetchLike;
+    /**
+     * The profile name.
+     *
+     * This is for handling multiple profiles to access different FHIR Servers
+     *
+     * If undefined, the default profile is "default".
+     */
+    profile?: string;
     /**
      * Storage implementation.
      *
@@ -292,6 +301,10 @@ export interface PatchOperation {
     readonly path: string;
     readonly value?: any;
 }
+/**
+ * Source for a FHIR Binary.
+ */
+export type BinarySource = string | File | Blob | Uint8Array;
 /**
  * Email address definition.
  * Compatible with nodemailer Mail.Address.
@@ -1020,7 +1033,7 @@ export declare class MedplumClient extends EventTarget {
      * @param onProgress Optional callback for progress events.
      * @returns The result of the create operation.
      */
-    createAttachment(data: string | File | Blob | Uint8Array, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void): Promise<Attachment>;
+    createAttachment(data: BinarySource, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void): Promise<Attachment>;
     /**
      * Creates a FHIR `Binary` resource with the provided data content.
      *
@@ -1045,8 +1058,8 @@ export declare class MedplumClient extends EventTarget {
      * @param onProgress Optional callback for progress events.
      * @returns The result of the create operation.
      */
-    createBinary(data: string | File | Blob | Uint8Array, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void): Promise<Binary>;
-    uploadwithProgress(url: URL, data: string | File | Blob | Uint8Array, contentType: string, onProgress: (e: ProgressEvent) => void): Promise<any>;
+    createBinary(data: BinarySource, filename: string | undefined, contentType: string, onProgress?: (e: ProgressEvent) => void): Promise<Binary>;
+    uploadwithProgress(url: URL, data: BinarySource, contentType: string, onProgress: (e: ProgressEvent) => void): Promise<any>;
     /**
      * Creates a PDF as a FHIR `Binary` resource based on pdfmake document definition.
      *
@@ -1415,9 +1428,16 @@ export declare class MedplumClient extends EventTarget {
      */
     getAccessPolicy(): AccessPolicy | undefined;
     /**
-     * Downloads the URL as a blob.
+     * Translates/normalizes a URL so that it can be directly used with `MedplumClient.fetch`.
+     * Especially useful for translating `Binary/{id}` URLs to FHIR paths.
+     * @param url A valid URL within the `MedplumClient` context.
+     * @returns URL as a string that can be used with `MedplumClient.fetch`
+     */
+    normalizeFetchUrl(url: URL | string): string;
+    /**
+     * Downloads the URL as a blob. Can accept binary URLs in the form of `Binary/{id}` as well.
      * @category Read
-     * @param url The URL to request.
+     * @param url The URL to request. Can be a standard URL or one in the form of `Binary/{id}`.
      * @param options Optional fetch request init options.
      * @returns Promise to the response body as a blob.
      */

package/dist/types/contenttype.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Content type constants.
+ */
+export declare const ContentType: {
+    CSS: string;
+    FAVICON: string;
+    FHIR_JSON: string;
+    FORM_URL_ENCODED: string;
+    HL7_V2: string;
+    HTML: string;
+    JAVASCRIPT: string;
+    JSON: string;
+    JSON_PATCH: string;
+    PNG: string;
+    SVG: string;
+    TEXT: string;
+    TYPESCRIPT: string;
+};

package/dist/types/crypto.d.ts

@@ -9,3 +9,11 @@ export declare function getRandomString(): string;
  * @returns The encrypted value in an ArrayBuffer.
  */
 export declare function encryptSHA256(str: string): Promise<ArrayBuffer>;
+/**
+ * Cross platform random UUID generator
+ * Note that this is not intended for production use, but rather for testing
+ * This should be replaced when crypto.randomUUID is fully supported
+ * See: https://stackoverflow.com/revisions/2117523/28
+ * @returns A random UUID.
+ */
+export declare function generateId(): string;

package/dist/types/eventtarget.d.ts

@@ -0,0 +1,12 @@
+export interface Event {
+    readonly type: string;
+    readonly defaultPrevented?: boolean;
+}
+export type EventListener = (e: Event) => void;
+export declare class EventTarget {
+    private readonly listeners;
+    constructor();
+    addEventListener(type: string, callback: EventListener): void;
+    removeEventListener(type: string, callback: EventListener): void;
+    dispatchEvent(event: Event): boolean;
+}

package/dist/types/hl7.d.ts

@@ -18,6 +18,11 @@ export declare class Hl7Context {
     readonly escapeCharacter: string;
     readonly subcomponentSeparator: string;
     constructor(segmentSeparator?: string, fieldSeparator?: string, componentSeparator?: string, repetitionSeparator?: string, escapeCharacter?: string, subcomponentSeparator?: string);
+    /**
+     * Returns the MSH-1 field value based on the configured separators.
+     * @returns The HL7 MSH-1 field value.
+     */
+    getMsh1(): string;
     /**
      * Returns the MSH-2 field value based on the configured separators.
      * @returns The HL7 MSH-2 field value.
@@ -209,15 +214,29 @@ export declare class Hl7Field {
      */
     static parse(text: string, context?: Hl7Context): Hl7Field;
 }
-interface Hl7DateParseOptions {
-    seconds?: boolean;
+export interface Hl7DateParseOptions {
+    /**
+     * Default timezone offset.
+     * Example: "-0500"
+     */
     tzOffset?: string;
 }
 /**
  * Returns a formatted string representing the date in ISO-8601 format.
- * @param hl7Date Date string.
- * @param options Optional configuration Object
+ *
+ * HL7-Definition V2
+ * Specifies a point in time using a 24-hour clock notation.
+ *
+ * Format: YYYY[MM[DD[HH[MM[SS[. S[S[S[S]]]]]]]]][+/-ZZZZ].
+ *
+ * @param hl7DateTime Date/time string.
+ * @param options Optional parsing options.
  * @returns The date in ISO-8601 format.
  */
-export declare function parseHl7Date(hl7Date: string | undefined, options?: Hl7DateParseOptions): string | undefined;
-export {};
+export declare function parseHl7DateTime(hl7DateTime: string | undefined, options?: Hl7DateParseOptions): string | undefined;
+/**
+ * Formats an ISO date/time string into an HL7 date/time string.
+ * @param isoDate The ISO date/time string.
+ * @returns The HL7 date/time string.
+ */
+export declare function formatHl7DateTime(isoDate: Date | string): string;

package/dist/types/index.d.ts

@@ -4,6 +4,9 @@ export * from './bundle';
 export * from './cache';
 export * from './client';
 export * from './config';
+export * from './contenttype';
+export * from './crypto';
+export * from './eventtarget';
 export * from './fhirlexer';
 export * from './fhirmapper';
 export * from './fhirpath';
@@ -20,6 +23,6 @@ export * from './search/search';
 export * from './sftp';
 export * from './storage';
 export * from './types';
+export * from './typeschema/types';
+export * from './typeschema/validation';
 export * from './utils';
-export { loadDataTypes } from './typeschema/types';
-export { validate } from './typeschema/validation';

package/dist/types/outcomes.d.ts

@@ -1,4 +1,5 @@
 import { OperationOutcome, OperationOutcomeIssue } from '@medplum/fhirtypes';
+import { Constraint } from './typeschema/types';
 export declare const allOk: OperationOutcome;
 export declare const created: OperationOutcome;
 export declare const notModified: OperationOutcome;
@@ -51,3 +52,6 @@ export declare function operationOutcomeToString(outcome: OperationOutcome): str
  * @returns The string representation of the operation outcome issue.
  */
 export declare function operationOutcomeIssueToString(issue: OperationOutcomeIssue): string;
+export declare function createStructureIssue(expression: string, details: string): OperationOutcomeIssue;
+export declare function createConstraintIssue(expression: string, constraint: Constraint): OperationOutcomeIssue;
+export declare function createProcessingIssue(expression: string, message: string, err: Error, data?: Record<string, any>): OperationOutcomeIssue;

package/dist/types/schema.d.ts

@@ -144,4 +144,3 @@ export declare class FhirSchemaValidator<T extends Resource> {
  * @param issues Output list of issues.
  */
 export declare function checkForNull(value: unknown, path: string, issues: OperationOutcomeIssue[]): void;
-export declare function createStructureIssue(expression: string, details: string): OperationOutcomeIssue;

package/dist/types/search/search.d.ts

@@ -11,6 +11,7 @@ export interface SearchRequest<T extends Resource = Resource> {
     total?: 'none' | 'estimate' | 'accurate';
     include?: IncludeTarget[];
     revInclude?: IncludeTarget[];
+    summary?: 'true' | 'text' | 'data';
 }
 export interface Filter {
     code: string;

package/dist/types/typeschema/types.d.ts

@@ -1,4 +1,4 @@
-import { Bundle, StructureDefinition } from '@medplum/fhirtypes';
+import { Bundle, StructureDefinition, Resource } from '@medplum/fhirtypes';
 import { TypedValue } from '../types';
 /**
  * Internal representation of a non-primitive FHIR type, suitable for use in resource validation
@@ -8,6 +8,8 @@ export interface InternalTypeSchema {
     fields: Record<string, ElementValidator>;
     constraints: Constraint[];
     innerTypes: InternalTypeSchema[];
+    summaryProperties?: Set<string>;
+    mandatoryProperties?: Set<string>;
 }
 export interface ElementValidator {
     min: number;
@@ -56,3 +58,12 @@ export interface SliceDiscriminator {
 export declare function parseStructureDefinition(sd: StructureDefinition): InternalTypeSchema;
 export declare function loadDataTypes(bundle: Bundle<StructureDefinition>): void;
 export declare function getDataType(type: string): InternalTypeSchema;
+/**
+ * Construct the subset of a resource containing a minimum set of fields.  The returned resource is not guaranteed
+ * to contain only the provided properties, and may contain others (e.g. `resourceType` and `id`)
+ *
+ * @param resource The resource to subset
+ * @param properties The minimum properties to include in the subset
+ * @returns The modified resource, containing the listed properties and possibly other mandatory ones
+ */
+export declare function subsetResource<T extends Resource>(resource: T | undefined, properties: string[]): T | undefined;

package/dist/types/utils.d.ts

@@ -1,4 +1,4 @@
-import { CodeableConcept, Extension, ObservationDefinition, ObservationDefinitionQualifiedInterval, Patient, Practitioner, QuestionnaireResponse, QuestionnaireResponseItemAnswer, Range, Reference, RelatedPerson, Resource } from '@medplum/fhirtypes';
+import { CodeableConcept, Extension, ObservationDefinition, ObservationDefinitionQualifiedInterval, Patient, Practitioner, QuestionnaireResponse, QuestionnaireResponseItemAnswer, Range, Reference, RelatedPerson, Resource, ResourceType } from '@medplum/fhirtypes';
 /**
  * @internal
  */
@@ -28,6 +28,13 @@ export declare function getReferenceString(resource: Resource): string;
  * @returns The ID portion of a reference.
  */
 export declare function resolveId(reference: Reference | undefined): string | undefined;
+/**
+ * Parses a reference and returns a tuple of [ResourceType, ID].
+ * @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;
 /**
  * Returns true if the resource is a "ProfileResource".
  * @param resource The FHIR resource.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medplum/core",
-  "version": "2.0.28",
+  "version": "2.0.30",
   "description": "Medplum TS/JS Library",
   "author": "Medplum <hello@medplum.com>",
   "license": "Apache-2.0",