Medplum

// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors // SPDX-License-Identifier: Apache-2.0 import type { WithId } from '@medplum/core'; import { evalFhirPath, getReferenceString, getSearchParameter } from '@medplum/core'; import { readJson } from '@medplum/definitions'; import type { CompartmentDefinition, CompartmentDefinitionResource, Patient, Reference, Resource, ResourceType, } from '@medplum/fhirtypes'; /** * Patient compartment definitions. * See: https://www.hl7.org/fhir/compartmentdefinition-patient.html */ let patientCompartment: CompartmentDefinition | undefined = undefined; /** * Lazy load the patient compartment definitions. * @returns The patient compartment definitions. */ export function getPatientCompartments(): CompartmentDefinition { if (!patientCompartment) { patientCompartment = readJson('fhir/r4/compartmentdefinition-patient.json') as CompartmentDefinition; } return patientCompartment; } /** * Returns the list of patient compartment search parameters, if the resource type is in a patient compartment. * Returns undefined otherwise. * See: https://www.hl7.org/fhir/compartmentdefinition-patient.html * @param resourceType - The resource type. * @returns List of property names if in patient compartment; undefined otherwise. */ export function getPatientCompartmentParams(resourceType: string): string[] | undefined { const resourceList = getPatientCompartments().resource as CompartmentDefinitionResource[]; for (const resource of resourceList) { if (resource.code === resourceType) { return resource.param; } } return undefined; } /** * Returns the patient compartment ID for a resource. * If the resource is in a patient compartment (i.e., an Observation about the patient), * then return the patient ID. * If the resource is not in a patient compartment (i.e., a StructureDefinition), * then return undefined. * @param resource - The resource to inspect. * @returns The patient ID if found; undefined otherwise. */ export function getPatients(resource: Resource): (Reference<Patient> & { reference: string })[] { const result = new Set<string>(); if (resource.resourceType === 'Patient' && resource.id) { result.add(getReferenceString(resource as WithId<Patient>)); } const params = getPatientCompartmentParams(resource.resourceType); if (params) { for (const code of params) { const searchParam = getSearchParameter(resource.resourceType, code); if (searchParam) { const values = evalFhirPath(searchParam.expression as string, resource); for (const value of values) { const patient = getPatientFromUnknownValue(value); if (patient) { result.add(patient); } } } } } return Array.from(result).map((reference) => ({ reference })); } /** * Tries to return a patient reference from an unknown value. * @param value - The unknown value. * @returns The patient reference if found; undefined otherwise. */ function getPatientFromUnknownValue(value: unknown): string | undefined { if (value && typeof value === 'object') { return getPatientIdFromReference(value as Reference); } return undefined; } /** * Tries to return a patient reference from a FHIR reference. * @param reference - A FHIR reference. * @returns The patient reference if found; undefined otherwise. */ function getPatientIdFromReference(reference: Reference): string | undefined { if (reference.reference?.startsWith('Patient/')) { return reference.reference; } return undefined; } /** * Returns the list of patient resource types. * @returns List of all patient resource types */ export function getPatientResourceTypes(): ResourceType[] { const resourceList = getPatientCompartments().resource as CompartmentDefinitionResource[]; const resourceTypes: ResourceType[] = []; for (const resource of resourceList) { if (resource.code) { resourceTypes.push(resource.code); } } return resourceTypes; }