gdc-common-utils-ts 1.14.9 → 1.14.13

package/dist/utils/clinical-impression-claim-helpers.js

@@ -0,0 +1,26 @@
+import { ClinicalImpressionClaim } from '../models/interoperable-claims/clinical-impression-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getClinicalImpressionClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setClinicalImpressionClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addClinicalImpressionClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeClinicalImpressionClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getClinicalImpressionIdentifier(claims) {
+    return normalizeClaimScalar(claims[ClinicalImpressionClaim.Identifier]);
+}
+export function setClinicalImpressionIdentifier(claims, value) {
+    return { ...claims, [ClinicalImpressionClaim.Identifier]: normalizeClaimScalar(value) };
+}
+export function getClinicalImpressionProblemList(claims) {
+    return getClinicalImpressionClaimList(claims, ClinicalImpressionClaim.Problem);
+}
+export function setClinicalImpressionProblemList(claims, values) {
+    return setClinicalImpressionClaimList(claims, ClinicalImpressionClaim.Problem, values);
+}

package/dist/utils/clinical-resource-converters.d.ts

@@ -1,64 +1,93 @@
-export type FlatClaims = Record<string, string | undefined>;
-export type FhirResource = Record<string, unknown> & {
-    resourceType: string;
-};
+export type { FlatClaims, FhirResource } from '../convert/convert-shared';
+export { flatClaimsToFhirResource, fhirResourceToFlatClaims, } from '../convert/convert-shared';
+export { medicationStatementFlatToFhirR4, medicationStatementFhirR4ToFlat, } from '../convert/convert-medication-statement';
+export { allergyIntoleranceFlatToFhirR4, allergyIntoleranceFhirR4ToFlat, } from '../convert/convert-allergy-intolerance';
+export { conditionFlatToFhirR4, conditionFhirR4ToFlat, } from '../convert/convert-condition';
+export { deviceUseStatementFlatToFhirR4, deviceUseStatementFhirR4ToFlat, } from '../convert/convert-device-use-statement';
+export { documentReferenceFlatToFhirR4, documentReferenceFhirR4ToFlat, } from '../convert/convert-document-reference';
+export { immunizationFlatToFhirR4, immunizationFhirR4ToFlat, } from '../convert/convert-immunization';
+export { locationFlatToFhirR4, locationFhirR4ToFlat, } from '../convert/convert-location';
+export { observationFlatToFhirR4, observationFhirR4ToFlat, } from '../convert/convert-observation';
+export { organizationFlatToFhirR4, organizationFhirR4ToFlat, } from '../convert/convert-organization';
+export { procedureFlatToFhirR4, procedureFhirR4ToFlat, } from '../convert/convert-procedure';
+export { deviceFlatToFhirR4, deviceFhirR4ToFlat, } from '../convert/convert-device';
+export { flagFlatToFhirR4, flagFhirR4ToFlat, } from '../convert/convert-flag';
+export { carePlanFlatToFhirR4, carePlanFhirR4ToFlat, } from '../convert/convert-care-plan';
+export { diagnosticReportFlatToFhirR4, diagnosticReportFhirR4ToFlat, } from '../convert/convert-diagnostic-report';
+export { compositionFlatToFhirR4, compositionFhirR4ToFlat, } from '../convert/convert-composition';
+export { appointmentFlatToFhirR4, appointmentFhirR4ToFlat, } from '../convert/convert-appointment';
+export { appointmentResponseFlatToFhirR4, appointmentResponseFhirR4ToFlat, } from '../convert/convert-appointment-response';
+export { encounterFlatToFhirR4, encounterFhirR4ToFlat, } from '../convert/convert-encounter';
+export { relatedPersonFlatToFhirR4, relatedPersonFhirR4ToFlat, } from '../convert/convert-related-person';
+export { coverageFlatToFhirR4, coverageFhirR4ToFlat, } from '../convert/convert-coverage';
+export { clinicalImpressionFlatToFhirR4, clinicalImpressionFhirR4ToFlat, } from '../convert/convert-clinical-impression';
+import type { FhirResource, FlatClaims } from '../convert/convert-shared';
+import { medicationStatementFhirR4ToFlat, medicationStatementFlatToFhirR4 } from '../convert/convert-medication-statement';
+import { allergyIntoleranceFhirR4ToFlat, allergyIntoleranceFlatToFhirR4 } from '../convert/convert-allergy-intolerance';
+import { conditionFhirR4ToFlat, conditionFlatToFhirR4 } from '../convert/convert-condition';
+import { deviceUseStatementFhirR4ToFlat, deviceUseStatementFlatToFhirR4 } from '../convert/convert-device-use-statement';
+import { documentReferenceFhirR4ToFlat, documentReferenceFlatToFhirR4 } from '../convert/convert-document-reference';
+import { immunizationFhirR4ToFlat, immunizationFlatToFhirR4 } from '../convert/convert-immunization';
+import { locationFhirR4ToFlat, locationFlatToFhirR4 } from '../convert/convert-location';
+import { observationFhirR4ToFlat, observationFlatToFhirR4 } from '../convert/convert-observation';
+import { organizationFhirR4ToFlat, organizationFlatToFhirR4 } from '../convert/convert-organization';
+import { procedureFhirR4ToFlat, procedureFlatToFhirR4 } from '../convert/convert-procedure';
+import { deviceFhirR4ToFlat, deviceFlatToFhirR4 } from '../convert/convert-device';
+import { flagFhirR4ToFlat, flagFlatToFhirR4 } from '../convert/convert-flag';
+import { carePlanFhirR4ToFlat, carePlanFlatToFhirR4 } from '../convert/convert-care-plan';
+import { diagnosticReportFhirR4ToFlat, diagnosticReportFlatToFhirR4 } from '../convert/convert-diagnostic-report';
+import { compositionFhirR4ToFlat, compositionFlatToFhirR4 } from '../convert/convert-composition';
+import { appointmentFhirR4ToFlat, appointmentFlatToFhirR4 } from '../convert/convert-appointment';
+import { appointmentResponseFhirR4ToFlat, appointmentResponseFlatToFhirR4 } from '../convert/convert-appointment-response';
+import { encounterFhirR4ToFlat, encounterFlatToFhirR4 } from '../convert/convert-encounter';
+import { relatedPersonFhirR4ToFlat, relatedPersonFlatToFhirR4 } from '../convert/convert-related-person';
+import { coverageFhirR4ToFlat, coverageFlatToFhirR4 } from '../convert/convert-coverage';
+import { clinicalImpressionFhirR4ToFlat, clinicalImpressionFlatToFhirR4 } from '../convert/convert-clinical-impression';
+export declare const medicationStatementFlatToFhir: typeof medicationStatementFlatToFhirR4;
+export declare const medicationStatementFhirToFlat: typeof medicationStatementFhirR4ToFlat;
+export declare const allergyIntoleranceFlatToFhir: typeof allergyIntoleranceFlatToFhirR4;
+export declare const allergyIntoleranceFhirToFlat: typeof allergyIntoleranceFhirR4ToFlat;
+export declare const conditionFlatToFhir: typeof conditionFlatToFhirR4;
+export declare const conditionFhirToFlat: typeof conditionFhirR4ToFlat;
+export declare const deviceUseStatementFlatToFhir: typeof deviceUseStatementFlatToFhirR4;
+export declare const deviceUseStatementFhirToFlat: typeof deviceUseStatementFhirR4ToFlat;
+export declare const documentReferenceFlatToFhir: typeof documentReferenceFlatToFhirR4;
+export declare const documentReferenceFhirToFlat: typeof documentReferenceFhirR4ToFlat;
+export declare const immunizationFlatToFhir: typeof immunizationFlatToFhirR4;
+export declare const immunizationFhirToFlat: typeof immunizationFhirR4ToFlat;
+export declare const locationFlatToFhir: typeof locationFlatToFhirR4;
+export declare const locationFhirToFlat: typeof locationFhirR4ToFlat;
+export declare const observationFlatToFhir: typeof observationFlatToFhirR4;
+export declare const observationFhirToFlat: typeof observationFhirR4ToFlat;
+export declare const organizationFlatToFhir: typeof organizationFlatToFhirR4;
+export declare const organizationFhirToFlat: typeof organizationFhirR4ToFlat;
+export declare const procedureFlatToFhir: typeof procedureFlatToFhirR4;
+export declare const procedureFhirToFlat: typeof procedureFhirR4ToFlat;
+export declare const deviceFlatToFhir: typeof deviceFlatToFhirR4;
+export declare const deviceFhirToFlat: typeof deviceFhirR4ToFlat;
+export declare const flagFlatToFhir: typeof flagFlatToFhirR4;
+export declare const flagFhirToFlat: typeof flagFhirR4ToFlat;
+export declare const carePlanFlatToFhir: typeof carePlanFlatToFhirR4;
+export declare const carePlanFhirToFlat: typeof carePlanFhirR4ToFlat;
+export declare const diagnosticReportFlatToFhir: typeof diagnosticReportFlatToFhirR4;
+export declare const diagnosticReportFhirToFlat: typeof diagnosticReportFhirR4ToFlat;
+export declare const compositionFlatToFhir: typeof compositionFlatToFhirR4;
+export declare const compositionFhirToFlat: typeof compositionFhirR4ToFlat;
+export declare const appointmentFlatToFhir: typeof appointmentFlatToFhirR4;
+export declare const appointmentFhirToFlat: typeof appointmentFhirR4ToFlat;
+export declare const appointmentResponseFlatToFhir: typeof appointmentResponseFlatToFhirR4;
+export declare const appointmentResponseFhirToFlat: typeof appointmentResponseFhirR4ToFlat;
+export declare const encounterFlatToFhir: typeof encounterFlatToFhirR4;
+export declare const encounterFhirToFlat: typeof encounterFhirR4ToFlat;
+export declare const relatedPersonFlatToFhir: typeof relatedPersonFlatToFhirR4;
+export declare const relatedPersonFhirToFlat: typeof relatedPersonFhirR4ToFlat;
+export declare const coverageFlatToFhir: typeof coverageFlatToFhirR4;
+export declare const coverageFhirToFlat: typeof coverageFhirR4ToFlat;
+export declare const clinicalImpressionFlatToFhir: typeof clinicalImpressionFlatToFhirR4;
+export declare const clinicalImpressionFhirToFlat: typeof clinicalImpressionFhirR4ToFlat;
 /**
- * Converts flat claims into a minimal MedicationStatement resource.
- *
- * @param claims Flat medication claims map.
+ * Converts a FHIR resource to the semantic flat-claims contract when a
+ * resource-specific converter exists. Unsupported resources fall back to the
+ * generic structural flattening.
  */
-export declare function medicationStatementFlatToFhir(claims: FlatClaims): FhirResource;
-/**
- * Converts a minimal MedicationStatement resource to flat claims.
- *
- * @param resource FHIR `MedicationStatement` resource.
- */
-export declare function medicationStatementFhirToFlat(resource: FhirResource): FlatClaims;
-/**
- * Converts flat claims into a minimal AllergyIntolerance resource.
- *
- * @param claims Flat allergy/intolerance claims map.
- */
-export declare function allergyIntoleranceFlatToFhir(claims: FlatClaims): FhirResource;
-/**
- * Converts a minimal AllergyIntolerance resource to flat claims.
- *
- * @param resource FHIR `AllergyIntolerance` resource.
- */
-export declare function allergyIntoleranceFhirToFlat(resource: FhirResource): FlatClaims;
-/**
- * Converts flat claims into a minimal Condition resource.
- *
- * @param claims Flat condition claims map.
- */
-export declare function conditionFlatToFhir(claims: FlatClaims): FhirResource;
-/**
- * Converts a minimal Condition resource to flat claims.
- *
- * @param resource FHIR `Condition` resource.
- */
-export declare function conditionFhirToFlat(resource: FhirResource): FlatClaims;
-/**
- * Converts flat claims into a minimal DeviceUseStatement resource.
- *
- * @param claims Flat device-use claims map.
- */
-export declare function deviceUseStatementFlatToFhir(claims: FlatClaims): FhirResource;
-/**
- * Converts a minimal DeviceUseStatement resource to flat claims.
- *
- * @param resource FHIR `DeviceUseStatement` resource.
- */
-export declare function deviceUseStatementFhirToFlat(resource: FhirResource): FlatClaims;
-/**
- * Converts flat claims into a minimal DocumentReference resource.
- *
- * @param claims Flat document reference claims map.
- */
-export declare function documentReferenceFlatToFhir(claims: FlatClaims): FhirResource;
-/**
- * Converts a minimal DocumentReference resource to flat claims.
- *
- * @param resource FHIR `DocumentReference` resource.
- */
-export declare function documentReferenceFhirToFlat(resource: FhirResource): FlatClaims;
+export declare function convertFhirResourceToClaims(resource: FhirResource, context?: string): FlatClaims;

package/dist/utils/clinical-resource-converters.js

@@ -1,279 +1,141 @@
 // Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
 // File: src/utils/clinical-resource-converters.ts
-// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
-import { AllergyIntoleranceClaim } from '../models/interoperable-claims/allergy-intolerance-claims.js';
-import { ConditionClaim } from '../models/interoperable-claims/condition-claims.js';
-import { DeviceUseStatementClaim } from '../models/interoperable-claims/device-use-statement-claims.js';
-import { DocumentReferenceClaim } from '../models/interoperable-claims/document-reference-claims.js';
-import { MedicationStatementClaim } from '../models/interoperable-claims/medication-statement-claims.js';
-function codingFromValue(value) {
-    if (!value) {
-        return undefined;
-    }
-    const [system, code] = value.split('|');
-    if (!code) {
-        return [{ code: system }];
-    }
-    return [{ system, code }];
-}
-function codingToValue(coding) {
-    if (!coding?.code) {
-        return undefined;
-    }
-    return coding.system ? `${coding.system}|${coding.code}` : coding.code;
-}
-function requireClaim(claims, key) {
-    const value = claims[key];
-    if (!value) {
-        throw new Error(`Missing required claim: ${key}`);
-    }
-    return value;
-}
-function requireSubjectIdentifier(value, key) {
-    if (!value.startsWith('urn:') && !value.startsWith('did:web:')) {
-        throw new Error(`Invalid ${key}: expected urn:* or did:web:*`);
-    }
-}
-function requireDidWeb(value, key) {
-    if (!value.startsWith('did:web:')) {
-        throw new Error(`Invalid ${key}: expected did:web:*`);
-    }
-}
-/**
- * Converts flat claims into a minimal MedicationStatement resource.
- *
- * @param claims Flat medication claims map.
- */
-export function medicationStatementFlatToFhir(claims) {
-    const subject = requireClaim(claims, MedicationStatementClaim.Subject);
-    const status = requireClaim(claims, MedicationStatementClaim.Status);
-    const effectiveDateTime = claims[MedicationStatementClaim.Effective];
-    const medicationText = claims[MedicationStatementClaim.MedicationText];
-    const medicationIdentifier = claims[MedicationStatementClaim.MedicationIdentifier];
-    const medicationSerialNumber = claims[MedicationStatementClaim.MedicationSerialNumber];
-    const medicationExpirationDate = claims[MedicationStatementClaim.MedicationExpirationDate];
-    const hasContainedMedication = Boolean(medicationIdentifier)
-        || Boolean(medicationSerialNumber)
-        || Boolean(medicationExpirationDate)
-        || Boolean(medicationText);
-    const containedMedicationId = 'medication-contained-1';
-    const containedMedication = hasContainedMedication
-        ? {
-            resourceType: 'Medication',
-            id: containedMedicationId,
-            identifier: medicationIdentifier ? [{ value: medicationIdentifier }] : undefined,
-            code: medicationText ? { text: medicationText } : undefined,
-            batch: medicationSerialNumber || medicationExpirationDate
-                ? {
-                    lotNumber: medicationSerialNumber,
-                    expirationDate: medicationExpirationDate,
-                }
-                : undefined,
-        }
-        : undefined;
-    const dosageInstructionText = claims[MedicationStatementClaim.DosageInstruction];
-    const noteText = claims[MedicationStatementClaim.Note];
-    return {
-        resourceType: 'MedicationStatement',
-        identifier: claims[MedicationStatementClaim.Identifier] ? [{ value: claims[MedicationStatementClaim.Identifier] }] : undefined,
-        status,
-        subject: { reference: subject },
-        effectiveDateTime,
-        medicationCodeableConcept: claims[MedicationStatementClaim.Code]
-            ? { coding: codingFromValue(claims[MedicationStatementClaim.Code]) }
-            : (!hasContainedMedication && medicationText ? { text: medicationText } : undefined),
-        medicationReference: hasContainedMedication ? { reference: `#${containedMedicationId}` } : undefined,
-        contained: containedMedication ? [containedMedication] : undefined,
-        dosage: dosageInstructionText ? [{ text: dosageInstructionText }] : undefined,
-        note: noteText ? [{ text: noteText }] : undefined,
-    };
-}
-/**
- * Converts a minimal MedicationStatement resource to flat claims.
- *
- * @param resource FHIR `MedicationStatement` resource.
- */
-export function medicationStatementFhirToFlat(resource) {
-    const medicationReference = resource.medicationReference?.reference;
-    const containedResources = Array.isArray(resource.contained) ? resource.contained : [];
-    const containedMedication = medicationReference?.startsWith('#')
-        ? containedResources.find((item) => item?.resourceType === 'Medication' && String(item?.id || '') === medicationReference.slice(1))
-        : containedResources.find((item) => item?.resourceType === 'Medication');
-    const containedMedicationIdentifier = containedMedication?.identifier?.[0]?.value;
-    const containedMedicationText = containedMedication?.code?.text;
-    const batch = containedMedication?.batch;
-    const dosageInstructionText = resource.dosage?.[0]?.text;
-    const noteText = resource.note?.[0]?.text;
-    const medicationCode = codingToValue(resource.medicationCodeableConcept?.coding?.[0]);
-    const medicationText = containedMedicationText
-        || resource.medicationCodeableConcept?.text
-        || undefined;
-    return {
-        [MedicationStatementClaim.Identifier]: resource.identifier?.[0]?.value,
-        [MedicationStatementClaim.Subject]: resource.subject?.reference,
-        [MedicationStatementClaim.Status]: resource.status,
-        [MedicationStatementClaim.Effective]: resource.effectiveDateTime,
-        [MedicationStatementClaim.Code]: medicationCode,
-        [MedicationStatementClaim.MedicationText]: medicationText,
-        [MedicationStatementClaim.Note]: noteText,
-        [MedicationStatementClaim.DosageInstruction]: dosageInstructionText,
-        [MedicationStatementClaim.MedicationIdentifier]: containedMedicationIdentifier,
-        [MedicationStatementClaim.MedicationSerialNumber]: batch?.lotNumber,
-        [MedicationStatementClaim.MedicationExpirationDate]: batch?.expirationDate,
-    };
-}
+export { flatClaimsToFhirResource, fhirResourceToFlatClaims, } from '../convert/convert-shared.js';
+export { medicationStatementFlatToFhirR4, medicationStatementFhirR4ToFlat, } from '../convert/convert-medication-statement.js';
+export { allergyIntoleranceFlatToFhirR4, allergyIntoleranceFhirR4ToFlat, } from '../convert/convert-allergy-intolerance.js';
+export { conditionFlatToFhirR4, conditionFhirR4ToFlat, } from '../convert/convert-condition.js';
+export { deviceUseStatementFlatToFhirR4, deviceUseStatementFhirR4ToFlat, } from '../convert/convert-device-use-statement.js';
+export { documentReferenceFlatToFhirR4, documentReferenceFhirR4ToFlat, } from '../convert/convert-document-reference.js';
+export { immunizationFlatToFhirR4, immunizationFhirR4ToFlat, } from '../convert/convert-immunization.js';
+export { locationFlatToFhirR4, locationFhirR4ToFlat, } from '../convert/convert-location.js';
+export { observationFlatToFhirR4, observationFhirR4ToFlat, } from '../convert/convert-observation.js';
+export { organizationFlatToFhirR4, organizationFhirR4ToFlat, } from '../convert/convert-organization.js';
+export { procedureFlatToFhirR4, procedureFhirR4ToFlat, } from '../convert/convert-procedure.js';
+export { deviceFlatToFhirR4, deviceFhirR4ToFlat, } from '../convert/convert-device.js';
+export { flagFlatToFhirR4, flagFhirR4ToFlat, } from '../convert/convert-flag.js';
+export { carePlanFlatToFhirR4, carePlanFhirR4ToFlat, } from '../convert/convert-care-plan.js';
+export { diagnosticReportFlatToFhirR4, diagnosticReportFhirR4ToFlat, } from '../convert/convert-diagnostic-report.js';
+export { compositionFlatToFhirR4, compositionFhirR4ToFlat, } from '../convert/convert-composition.js';
+export { appointmentFlatToFhirR4, appointmentFhirR4ToFlat, } from '../convert/convert-appointment.js';
+export { appointmentResponseFlatToFhirR4, appointmentResponseFhirR4ToFlat, } from '../convert/convert-appointment-response.js';
+export { encounterFlatToFhirR4, encounterFhirR4ToFlat, } from '../convert/convert-encounter.js';
+export { relatedPersonFlatToFhirR4, relatedPersonFhirR4ToFlat, } from '../convert/convert-related-person.js';
+export { coverageFlatToFhirR4, coverageFhirR4ToFlat, } from '../convert/convert-coverage.js';
+export { clinicalImpressionFlatToFhirR4, clinicalImpressionFhirR4ToFlat, } from '../convert/convert-clinical-impression.js';
+import { fhirResourceToFlatClaims } from '../convert/convert-shared.js';
+import { medicationStatementFhirR4ToFlat, medicationStatementFlatToFhirR4 } from '../convert/convert-medication-statement.js';
+import { allergyIntoleranceFhirR4ToFlat, allergyIntoleranceFlatToFhirR4 } from '../convert/convert-allergy-intolerance.js';
+import { conditionFhirR4ToFlat, conditionFlatToFhirR4 } from '../convert/convert-condition.js';
+import { deviceUseStatementFhirR4ToFlat, deviceUseStatementFlatToFhirR4 } from '../convert/convert-device-use-statement.js';
+import { documentReferenceFhirR4ToFlat, documentReferenceFlatToFhirR4 } from '../convert/convert-document-reference.js';
+import { immunizationFhirR4ToFlat, immunizationFlatToFhirR4 } from '../convert/convert-immunization.js';
+import { locationFhirR4ToFlat, locationFlatToFhirR4 } from '../convert/convert-location.js';
+import { observationFhirR4ToFlat, observationFlatToFhirR4 } from '../convert/convert-observation.js';
+import { organizationFhirR4ToFlat, organizationFlatToFhirR4 } from '../convert/convert-organization.js';
+import { procedureFhirR4ToFlat, procedureFlatToFhirR4 } from '../convert/convert-procedure.js';
+import { deviceFhirR4ToFlat, deviceFlatToFhirR4 } from '../convert/convert-device.js';
+import { flagFhirR4ToFlat, flagFlatToFhirR4 } from '../convert/convert-flag.js';
+import { carePlanFhirR4ToFlat, carePlanFlatToFhirR4 } from '../convert/convert-care-plan.js';
+import { diagnosticReportFhirR4ToFlat, diagnosticReportFlatToFhirR4 } from '../convert/convert-diagnostic-report.js';
+import { compositionFhirR4ToFlat, compositionFlatToFhirR4 } from '../convert/convert-composition.js';
+import { appointmentFhirR4ToFlat, appointmentFlatToFhirR4 } from '../convert/convert-appointment.js';
+import { appointmentResponseFhirR4ToFlat, appointmentResponseFlatToFhirR4 } from '../convert/convert-appointment-response.js';
+import { encounterFhirR4ToFlat, encounterFlatToFhirR4 } from '../convert/convert-encounter.js';
+import { relatedPersonFhirR4ToFlat, relatedPersonFlatToFhirR4 } from '../convert/convert-related-person.js';
+import { coverageFhirR4ToFlat, coverageFlatToFhirR4 } from '../convert/convert-coverage.js';
+import { clinicalImpressionFhirR4ToFlat, clinicalImpressionFlatToFhirR4 } from '../convert/convert-clinical-impression.js';
+export const medicationStatementFlatToFhir = medicationStatementFlatToFhirR4;
+export const medicationStatementFhirToFlat = medicationStatementFhirR4ToFlat;
+export const allergyIntoleranceFlatToFhir = allergyIntoleranceFlatToFhirR4;
+export const allergyIntoleranceFhirToFlat = allergyIntoleranceFhirR4ToFlat;
+export const conditionFlatToFhir = conditionFlatToFhirR4;
+export const conditionFhirToFlat = conditionFhirR4ToFlat;
+export const deviceUseStatementFlatToFhir = deviceUseStatementFlatToFhirR4;
+export const deviceUseStatementFhirToFlat = deviceUseStatementFhirR4ToFlat;
+export const documentReferenceFlatToFhir = documentReferenceFlatToFhirR4;
+export const documentReferenceFhirToFlat = documentReferenceFhirR4ToFlat;
+export const immunizationFlatToFhir = immunizationFlatToFhirR4;
+export const immunizationFhirToFlat = immunizationFhirR4ToFlat;
+export const locationFlatToFhir = locationFlatToFhirR4;
+export const locationFhirToFlat = locationFhirR4ToFlat;
+export const observationFlatToFhir = observationFlatToFhirR4;
+export const observationFhirToFlat = observationFhirR4ToFlat;
+export const organizationFlatToFhir = organizationFlatToFhirR4;
+export const organizationFhirToFlat = organizationFhirR4ToFlat;
+export const procedureFlatToFhir = procedureFlatToFhirR4;
+export const procedureFhirToFlat = procedureFhirR4ToFlat;
+export const deviceFlatToFhir = deviceFlatToFhirR4;
+export const deviceFhirToFlat = deviceFhirR4ToFlat;
+export const flagFlatToFhir = flagFlatToFhirR4;
+export const flagFhirToFlat = flagFhirR4ToFlat;
+export const carePlanFlatToFhir = carePlanFlatToFhirR4;
+export const carePlanFhirToFlat = carePlanFhirR4ToFlat;
+export const diagnosticReportFlatToFhir = diagnosticReportFlatToFhirR4;
+export const diagnosticReportFhirToFlat = diagnosticReportFhirR4ToFlat;
+export const compositionFlatToFhir = compositionFlatToFhirR4;
+export const compositionFhirToFlat = compositionFhirR4ToFlat;
+export const appointmentFlatToFhir = appointmentFlatToFhirR4;
+export const appointmentFhirToFlat = appointmentFhirR4ToFlat;
+export const appointmentResponseFlatToFhir = appointmentResponseFlatToFhirR4;
+export const appointmentResponseFhirToFlat = appointmentResponseFhirR4ToFlat;
+export const encounterFlatToFhir = encounterFlatToFhirR4;
+export const encounterFhirToFlat = encounterFhirR4ToFlat;
+export const relatedPersonFlatToFhir = relatedPersonFlatToFhirR4;
+export const relatedPersonFhirToFlat = relatedPersonFhirR4ToFlat;
+export const coverageFlatToFhir = coverageFlatToFhirR4;
+export const coverageFhirToFlat = coverageFhirR4ToFlat;
+export const clinicalImpressionFlatToFhir = clinicalImpressionFlatToFhirR4;
+export const clinicalImpressionFhirToFlat = clinicalImpressionFhirR4ToFlat;
 /**
- * Converts flat claims into a minimal AllergyIntolerance resource.
- *
- * @param claims Flat allergy/intolerance claims map.
+ * Converts a FHIR resource to the semantic flat-claims contract when a
+ * resource-specific converter exists. Unsupported resources fall back to the
+ * generic structural flattening.
  */
-export function allergyIntoleranceFlatToFhir(claims) {
-    const patient = claims[AllergyIntoleranceClaim.Subject] ?? claims[AllergyIntoleranceClaim.Patient];
-    const recorder = claims[AllergyIntoleranceClaim.Recorder];
-    if (!patient) {
-        throw new Error(`Missing required claim: ${AllergyIntoleranceClaim.Subject}`);
-    }
-    requireSubjectIdentifier(patient, AllergyIntoleranceClaim.Subject);
-    if (recorder) {
-        requireDidWeb(recorder, AllergyIntoleranceClaim.Recorder);
+export function convertFhirResourceToClaims(resource, context = 'org.hl7.fhir.r4') {
+    switch (resource.resourceType) {
+        case 'MedicationStatement':
+            return medicationStatementFhirR4ToFlat(resource);
+        case 'AllergyIntolerance':
+            return allergyIntoleranceFhirR4ToFlat(resource);
+        case 'Condition':
+            return conditionFhirR4ToFlat(resource);
+        case 'DocumentReference':
+            return documentReferenceFhirR4ToFlat(resource);
+        case 'DeviceUseStatement':
+            return deviceUseStatementFhirR4ToFlat(resource);
+        case 'Immunization':
+            return immunizationFhirR4ToFlat(resource);
+        case 'Location':
+            return locationFhirR4ToFlat(resource);
+        case 'Observation':
+            return observationFhirR4ToFlat(resource);
+        case 'Organization':
+            return organizationFhirR4ToFlat(resource);
+        case 'Procedure':
+            return procedureFhirR4ToFlat(resource);
+        case 'Device':
+            return deviceFhirR4ToFlat(resource);
+        case 'Flag':
+            return flagFhirR4ToFlat(resource);
+        case 'CarePlan':
+            return carePlanFhirR4ToFlat(resource);
+        case 'DiagnosticReport':
+            return diagnosticReportFhirR4ToFlat(resource);
+        case 'Composition':
+            return compositionFhirR4ToFlat(resource);
+        case 'Appointment':
+            return appointmentFhirR4ToFlat(resource);
+        case 'AppointmentResponse':
+            return appointmentResponseFhirR4ToFlat(resource);
+        case 'Encounter':
+            return encounterFhirR4ToFlat(resource);
+        case 'RelatedPerson':
+            return relatedPersonFhirR4ToFlat(resource);
+        case 'Coverage':
+            return coverageFhirR4ToFlat(resource);
+        case 'ClinicalImpression':
+            return clinicalImpressionFhirR4ToFlat(resource);
+        default:
+            return fhirResourceToFlatClaims(resource, context);
     }
-    return {
-        resourceType: 'AllergyIntolerance',
-        identifier: claims[AllergyIntoleranceClaim.Identifier] ? [{ value: claims[AllergyIntoleranceClaim.Identifier] }] : undefined,
-        patient: { reference: patient },
-        code: claims[AllergyIntoleranceClaim.Code] ? { coding: codingFromValue(claims[AllergyIntoleranceClaim.Code]) } : undefined,
-        clinicalStatus: claims[AllergyIntoleranceClaim.ClinicalStatus]
-            ? { coding: [{ code: claims[AllergyIntoleranceClaim.ClinicalStatus] }] }
-            : undefined,
-        verificationStatus: claims[AllergyIntoleranceClaim.VerificationStatus]
-            ? { coding: [{ code: claims[AllergyIntoleranceClaim.VerificationStatus] }] }
-            : undefined,
-        recorder: recorder ? { reference: recorder } : undefined,
-    };
-}
-/**
- * Converts a minimal AllergyIntolerance resource to flat claims.
- *
- * @param resource FHIR `AllergyIntolerance` resource.
- */
-export function allergyIntoleranceFhirToFlat(resource) {
-    const subject = resource.patient?.reference;
-    return {
-        [AllergyIntoleranceClaim.Identifier]: resource.identifier?.[0]?.value,
-        [AllergyIntoleranceClaim.Subject]: subject,
-        [AllergyIntoleranceClaim.Patient]: subject,
-        [AllergyIntoleranceClaim.Code]: codingToValue(resource.code?.coding?.[0]),
-        [AllergyIntoleranceClaim.ClinicalStatus]: resource.clinicalStatus?.coding?.[0]?.code,
-        [AllergyIntoleranceClaim.VerificationStatus]: resource.verificationStatus?.coding?.[0]?.code,
-        [AllergyIntoleranceClaim.Recorder]: resource.recorder?.reference,
-    };
-}
-/**
- * Converts flat claims into a minimal Condition resource.
- *
- * @param claims Flat condition claims map.
- */
-export function conditionFlatToFhir(claims) {
-    const subject = requireClaim(claims, ConditionClaim.Subject);
-    return {
-        resourceType: 'Condition',
-        identifier: claims[ConditionClaim.Identifier] ? [{ value: claims[ConditionClaim.Identifier] }] : undefined,
-        subject: { reference: subject },
-        code: claims[ConditionClaim.Code] ? { coding: codingFromValue(claims[ConditionClaim.Code]) } : undefined,
-        clinicalStatus: claims[ConditionClaim.ClinicalStatus] ? { coding: [{ code: claims[ConditionClaim.ClinicalStatus] }] } : undefined,
-        verificationStatus: claims[ConditionClaim.VerificationStatus] ? { coding: [{ code: claims[ConditionClaim.VerificationStatus] }] } : undefined,
-    };
-}
-/**
- * Converts a minimal Condition resource to flat claims.
- *
- * @param resource FHIR `Condition` resource.
- */
-export function conditionFhirToFlat(resource) {
-    return {
-        [ConditionClaim.Identifier]: resource.identifier?.[0]?.value,
-        [ConditionClaim.Subject]: resource.subject?.reference,
-        [ConditionClaim.Code]: codingToValue(resource.code?.coding?.[0]),
-        [ConditionClaim.ClinicalStatus]: resource.clinicalStatus?.coding?.[0]?.code,
-        [ConditionClaim.VerificationStatus]: resource.verificationStatus?.coding?.[0]?.code,
-    };
-}
-/**
- * Converts flat claims into a minimal DeviceUseStatement resource.
- *
- * @param claims Flat device-use claims map.
- */
-export function deviceUseStatementFlatToFhir(claims) {
-    const subject = requireClaim(claims, DeviceUseStatementClaim.Subject);
-    const device = requireClaim(claims, DeviceUseStatementClaim.Device);
-    const status = requireClaim(claims, DeviceUseStatementClaim.Status);
-    return {
-        resourceType: 'DeviceUseStatement',
-        identifier: claims[DeviceUseStatementClaim.Identifier] ? [{ value: claims[DeviceUseStatementClaim.Identifier] }] : undefined,
-        subject: { reference: subject },
-        device: { reference: device },
-        status,
-        recordedOn: claims[DeviceUseStatementClaim.RecordedOn],
-        timingDateTime: claims[DeviceUseStatementClaim.TimingDateTime],
-    };
-}
-/**
- * Converts a minimal DeviceUseStatement resource to flat claims.
- *
- * @param resource FHIR `DeviceUseStatement` resource.
- */
-export function deviceUseStatementFhirToFlat(resource) {
-    return {
-        [DeviceUseStatementClaim.Identifier]: resource.identifier?.[0]?.value,
-        [DeviceUseStatementClaim.Subject]: resource.subject?.reference,
-        [DeviceUseStatementClaim.Device]: resource.device?.reference,
-        [DeviceUseStatementClaim.Status]: resource.status,
-        [DeviceUseStatementClaim.RecordedOn]: resource.recordedOn,
-        [DeviceUseStatementClaim.TimingDateTime]: resource.timingDateTime,
-    };
-}
-/**
- * Converts flat claims into a minimal DocumentReference resource.
- *
- * @param claims Flat document reference claims map.
- */
-export function documentReferenceFlatToFhir(claims) {
-    const subject = requireClaim(claims, DocumentReferenceClaim.Subject);
-    return {
-        resourceType: 'DocumentReference',
-        identifier: claims[DocumentReferenceClaim.Identifier] ? [{ value: claims[DocumentReferenceClaim.Identifier] }] : undefined,
-        subject: { reference: subject },
-        description: claims[DocumentReferenceClaim.Description],
-        date: claims[DocumentReferenceClaim.Date],
-        content: [
-            {
-                attachment: {
-                    contentType: claims[DocumentReferenceClaim.ContentType],
-                    data: claims[DocumentReferenceClaim.ContentData],
-                    url: claims[DocumentReferenceClaim.Location],
-                    hash: claims[DocumentReferenceClaim.ContentHash],
-                    language: claims[DocumentReferenceClaim.Language],
-                },
-            },
-        ],
-    };
-}
-/**
- * Converts a minimal DocumentReference resource to flat claims.
- *
- * @param resource FHIR `DocumentReference` resource.
- */
-export function documentReferenceFhirToFlat(resource) {
-    const attachment = resource.content?.[0]?.attachment;
-    return {
-        [DocumentReferenceClaim.Identifier]: resource.identifier?.[0]?.value,
-        [DocumentReferenceClaim.Subject]: resource.subject?.reference,
-        [DocumentReferenceClaim.Description]: resource.description,
-        [DocumentReferenceClaim.Date]: resource.date,
-        [DocumentReferenceClaim.ContentType]: attachment?.contentType,
-        [DocumentReferenceClaim.ContentData]: attachment?.data,
-        [DocumentReferenceClaim.Location]: attachment?.url,
-        [DocumentReferenceClaim.ContentHash]: attachment?.hash,
-        [DocumentReferenceClaim.Language]: attachment?.language,
-    };
 }

package/dist/utils/communication-bundle-document-request.d.ts

@@ -136,8 +136,8 @@ export declare function buildBundleSearchReferenceUrl(input: Readonly<{
  */
 export declare function createSummaryOperationRequestParameters(subjectIdOrInput: string | CreateSummaryOperationParametersInput, filterSections?: string[]): ReadonlyArray<ParameterData>;
 /**
- * Flattens semantic summary-operation parameters to the relative search path
- * currently stored in `Communication.content-reference`.
+ * Flattens semantic summary-operation parameters to the relative `Bundle/_search`
+ * path currently stored in `Communication.content-reference`.
  */
 export declare function createSummaryOperationRequestReferencePath(parameters: ReadonlyArray<ParameterData>): string;
 /**
@@ -187,8 +187,10 @@ export declare const communication: Readonly<{
      */
     newIpsSummarySearchCommunication: typeof createIpsSummarySearchCommunicationClaims;
     /**
-     * Frontend-facing IPS helper: creates the DIDComm-ready message to request
-     * an IPS summary/search using an already-generated reference path.
+     * Compatibility helper for current DIDComm transport flows.
+     *
+     * Prefer `newIpsSummarySearchCommunication(...)` in `common-utils` 101 docs.
+     * DIDComm/outbox orchestration belongs to the next SDK layer.
      */
     newIpsSummarySearchDidcommMessage: typeof createIpsSummarySearchDidcommMessage;
     /**