@the-cascade-protocol/cli 0.2.5 → 0.3.1

package/dist/lib/fhir-converter/converters-clinical.d.ts

@@ -7,6 +7,13 @@
  *   - AllergyIntolerance -> health:AllergyRecord
  *   - Observation (lab) -> health:LabResultRecord
  *   - Observation (vital) -> clinical:VitalSign
+ *   - Procedure -> clinical:Procedure
+ *   - DocumentReference -> clinical:ClinicalDocument
+ *   - Encounter -> clinical:Encounter
+ *   - DiagnosticReport -> clinical:LaboratoryReport
+ *   - MedicationAdministration -> clinical:MedicationAdministration
+ *   - Device -> clinical:ImplantedDevice
+ *   - ImagingStudy -> clinical:ImagingStudy
  */
 import type { Quad } from 'n3';
 import { type ConversionResult } from './types.js';
@@ -26,4 +33,25 @@ export declare function convertObservationLab(resource: any): ConversionResult &
 export declare function convertObservationVital(resource: any): ConversionResult & {
     _quads: Quad[];
 };
+export declare function convertProcedure(resource: any): ConversionResult & {
+    _quads: Quad[];
+};
+export declare function convertClinicalDocument(resource: any): ConversionResult & {
+    _quads: Quad[];
+};
+export declare function convertEncounter(resource: any): ConversionResult & {
+    _quads: Quad[];
+};
+export declare function convertLaboratoryReport(resource: any): ConversionResult & {
+    _quads: Quad[];
+};
+export declare function convertMedicationAdministration(resource: any): ConversionResult & {
+    _quads: Quad[];
+};
+export declare function convertDevice(resource: any): ConversionResult & {
+    _quads: Quad[];
+};
+export declare function convertImagingStudy(resource: any): ConversionResult & {
+    _quads: Quad[];
+};
 //# sourceMappingURL=converters-clinical.d.ts.map

package/dist/lib/fhir-converter/converters-clinical.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"converters-clinical.d.ts","sourceRoot":"","sources":["../../../src/lib/fhir-converter/converters-clinical.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,OAAO,EACL,KAAK,gBAAgB,EAetB,MAAM,YAAY,CAAC;AAMpB,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CA2F/F;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAqDrF;AAMD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAwD9F;AAMD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAe7D;AAMD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CA4F1F;AAMD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAwE5F"}
+{"version":3,"file":"converters-clinical.d.ts","sourceRoot":"","sources":["../../../src/lib/fhir-converter/converters-clinical.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,OAAO,EACL,KAAK,gBAAgB,EAkBtB,MAAM,YAAY,CAAC;AAMpB,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CA2F/F;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAqDrF;AAMD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAwD9F;AAMD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAoB7D;AAMD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAiH1F;AAMD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAiG5F;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAgDrF;AAMD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAgD5F;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAsErF;AAMD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CA0E5F;AAMD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAmDpG;AAMD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CA+ClF;AAMD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAuDxF"}

package/dist/lib/fhir-converter/converters-clinical.js

@@ -7,15 +7,21 @@
  *   - AllergyIntolerance -> health:AllergyRecord
  *   - Observation (lab) -> health:LabResultRecord
  *   - Observation (vital) -> clinical:VitalSign
+ *   - Procedure -> clinical:Procedure
+ *   - DocumentReference -> clinical:ClinicalDocument
+ *   - Encounter -> clinical:Encounter
+ *   - DiagnosticReport -> clinical:LaboratoryReport
+ *   - MedicationAdministration -> clinical:MedicationAdministration
+ *   - Device -> clinical:ImplantedDevice
+ *   - ImagingStudy -> clinical:ImagingStudy
  */
-import { randomUUID } from 'node:crypto';
-import { NS, CODING_SYSTEM_MAP, VITAL_LOINC_CODES, VITAL_CATEGORIES, extractCodings, codeableConceptText, tripleStr, tripleBool, tripleDouble, tripleRef, tripleType, tripleDateTime, commonTriples, quadsToJsonLd, } from './types.js';
+import { NS, CODING_SYSTEM_MAP, VITAL_LOINC_CODES, VITAL_CATEGORIES, isLoincSystem, extractCodings, codeableConceptText, tripleStr, tripleBool, tripleDouble, tripleRef, tripleType, tripleDateTime, tripleTyped, commonTriples, quadsToJsonLd, mintSubjectUri, } from './types.js';
 // ---------------------------------------------------------------------------
 // Medication converter
 // ---------------------------------------------------------------------------
 export function convertMedicationStatement(resource) {
     const warnings = [];
-    const subjectUri = `urn:uuid:${randomUUID()}`;
+    const subjectUri = mintSubjectUri(resource);
     const quads = [];
     quads.push(tripleType(subjectUri, NS.health + 'MedicationRecord'));
     quads.push(...commonTriples(subjectUri));
@@ -105,7 +111,7 @@ export function convertMedicationStatement(resource) {
 // ---------------------------------------------------------------------------
 export function convertCondition(resource) {
     const warnings = [];
-    const subjectUri = `urn:uuid:${randomUUID()}`;
+    const subjectUri = mintSubjectUri(resource);
     const quads = [];
     quads.push(tripleType(subjectUri, NS.health + 'ConditionRecord'));
     quads.push(...commonTriples(subjectUri));
@@ -157,7 +163,7 @@ export function convertCondition(resource) {
 // ---------------------------------------------------------------------------
 export function convertAllergyIntolerance(resource) {
     const warnings = [];
-    const subjectUri = `urn:uuid:${randomUUID()}`;
+    const subjectUri = mintSubjectUri(resource);
     const quads = [];
     quads.push(tripleType(subjectUri, NS.health + 'AllergyRecord'));
     quads.push(...commonTriples(subjectUri));
@@ -210,17 +216,23 @@ export function convertAllergyIntolerance(resource) {
 export function isVitalSignObservation(resource) {
     if (Array.isArray(resource.category)) {
         for (const cat of resource.category) {
+            // Structured coding check
             if (Array.isArray(cat.coding)) {
                 for (const c of cat.coding) {
                     if (VITAL_CATEGORIES.includes(c.code))
                         return true;
                 }
             }
+            // Text fallback — some systems only populate category.text
+            if (typeof cat.text === 'string' && /vital/i.test(cat.text))
+                return true;
         }
     }
+    // LOINC code fallback — catches observations with no/wrong category
+    // Accepts all known LOINC system URL variants (http, https, OID, trailing slash)
     const codings = extractCodings(resource.code);
     for (const c of codings) {
-        if (c.system === 'http://loinc.org' && VITAL_LOINC_CODES[c.code])
+        if (isLoincSystem(c.system) && VITAL_LOINC_CODES[c.code])
             return true;
     }
     return false;
@@ -230,7 +242,7 @@ export function isVitalSignObservation(resource) {
 // ---------------------------------------------------------------------------
 export function convertObservationLab(resource) {
     const warnings = [];
-    const subjectUri = `urn:uuid:${randomUUID()}`;
+    const subjectUri = mintSubjectUri(resource);
     const quads = [];
     quads.push(tripleType(subjectUri, NS.health + 'LabResultRecord'));
     quads.push(...commonTriples(subjectUri));
@@ -249,6 +261,29 @@ export function convertObservationLab(resource) {
         const valText = codeableConceptText(resource.valueCodeableConcept) ?? '';
         quads.push(tripleStr(subjectUri, NS.health + 'resultValue', valText));
     }
+    else if (Array.isArray(resource.component) && resource.component.length > 0) {
+        // Panel-style observation (e.g., PRAPARE survey, multi-question assessments):
+        // serialize component question/answer pairs into a single resultValue string.
+        const parts = [];
+        for (const comp of resource.component) {
+            const question = codeableConceptText(comp.code);
+            if (!question)
+                continue;
+            const answer = (comp.valueCodeableConcept ? codeableConceptText(comp.valueCodeableConcept) : undefined) ??
+                comp.valueString ??
+                (comp.valueQuantity !== undefined ? `${comp.valueQuantity.value} ${comp.valueQuantity.unit ?? ''}`.trim() : undefined);
+            if (answer !== undefined) {
+                parts.push(`${question}: ${answer}`);
+            }
+        }
+        if (parts.length > 0) {
+            quads.push(tripleStr(subjectUri, NS.health + 'resultValue', parts.join('; ')));
+        }
+        else {
+            quads.push(tripleStr(subjectUri, NS.health + 'resultValue', ''));
+            warnings.push('No result value found in Observation resource');
+        }
+    }
     else {
         quads.push(tripleStr(subjectUri, NS.health + 'resultValue', ''));
         warnings.push('No result value found in Observation resource');
@@ -324,14 +359,14 @@ export function convertObservationLab(resource) {
 // ---------------------------------------------------------------------------
 export function convertObservationVital(resource) {
     const warnings = [];
-    const subjectUri = `urn:uuid:${randomUUID()}`;
+    const subjectUri = mintSubjectUri(resource);
     const quads = [];
     quads.push(tripleType(subjectUri, NS.clinical + 'VitalSign'));
     quads.push(...commonTriples(subjectUri));
     const codings = extractCodings(resource.code);
     let vitalInfo;
     for (const c of codings) {
-        if (c.system === 'http://loinc.org' && VITAL_LOINC_CODES[c.code]) {
+        if (isLoincSystem(c.system) && VITAL_LOINC_CODES[c.code]) {
             vitalInfo = VITAL_LOINC_CODES[c.code];
             quads.push(tripleRef(subjectUri, NS.clinical + 'loincCode', NS.loinc + c.code));
             break;
@@ -343,15 +378,42 @@ export function convertObservationVital(resource) {
         quads.push(tripleRef(subjectUri, NS.clinical + 'snomedCode', NS.sct + vitalInfo.snomedCode));
     }
     else {
+        // No LOINC match in the map — fall back to a slug derived from the display name.
+        // Data is fully preserved (value + unit + name); we just lack a canonical vitalType enum.
         const name = codeableConceptText(resource.code) ?? 'Unknown Vital';
-        quads.push(tripleStr(subjectUri, NS.clinical + 'vitalType', name.toLowerCase().replace(/\s+/g, '_')));
+        quads.push(tripleStr(subjectUri, NS.clinical + 'vitalType', name.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '')));
         quads.push(tripleStr(subjectUri, NS.clinical + 'vitalTypeName', name));
-        warnings.push(`Unknown vital sign LOINC code -- using display name: ${name}`);
     }
     if (resource.valueQuantity) {
         quads.push(tripleDouble(subjectUri, NS.clinical + 'value', resource.valueQuantity.value));
         quads.push(tripleStr(subjectUri, NS.clinical + 'unit', resource.valueQuantity.unit ?? vitalInfo?.unit ?? ''));
     }
+    else if (Array.isArray(resource.component) && resource.component.length > 0) {
+        // Panel-style vital (e.g., blood pressure panel LOINC 55284-4): component children
+        // hold the individual readings. Emit each known component as a typed value predicate,
+        // e.g., clinical:bloodPressureSystolicValue / clinical:bloodPressureDiastolicValue.
+        let emittedCount = 0;
+        for (const comp of resource.component) {
+            if (!comp.valueQuantity)
+                continue;
+            const compCodings = extractCodings(comp.code);
+            let compInfo;
+            for (const c of compCodings) {
+                if (isLoincSystem(c.system) && VITAL_LOINC_CODES[c.code]) {
+                    compInfo = VITAL_LOINC_CODES[c.code];
+                    break;
+                }
+            }
+            if (compInfo) {
+                quads.push(tripleDouble(subjectUri, NS.clinical + compInfo.type + 'Value', comp.valueQuantity.value));
+                quads.push(tripleStr(subjectUri, NS.clinical + compInfo.type + 'Unit', comp.valueQuantity.unit ?? compInfo.unit ?? ''));
+                emittedCount++;
+            }
+        }
+        if (emittedCount === 0) {
+            warnings.push('No valueQuantity found in vital sign Observation');
+        }
+    }
     else {
         warnings.push('No valueQuantity found in vital sign Observation');
     }
@@ -388,4 +450,367 @@ export function convertObservationVital(resource) {
         _quads: quads,
     };
 }
+// ---------------------------------------------------------------------------
+// Procedure converter (B1)
+// ---------------------------------------------------------------------------
+export function convertProcedure(resource) {
+    const warnings = [];
+    const subjectUri = mintSubjectUri(resource);
+    const quads = [];
+    quads.push(tripleType(subjectUri, NS.clinical + 'Procedure'));
+    quads.push(...commonTriples(subjectUri));
+    // Procedure name
+    const name = codeableConceptText(resource.code) ?? 'Unknown Procedure';
+    quads.push(tripleStr(subjectUri, NS.clinical + 'procedureName', name));
+    // Procedure codes
+    const codings = extractCodings(resource.code);
+    for (const c of codings) {
+        if (c.system === 'http://snomed.info/sct') {
+            quads.push(tripleRef(subjectUri, NS.clinical + 'procedureSnomedCode', NS.sct + c.code));
+        }
+        else if (c.system === 'http://www.ama-assn.org/go/cpt' || c.system.includes('cpt')) {
+            quads.push(tripleStr(subjectUri, NS.clinical + 'cptCode', c.code));
+        }
+    }
+    // performedDate -- use performedDateTime first, fall back to performedPeriod.start
+    const performedDate = resource.performedDateTime ?? resource.performedPeriod?.start;
+    if (performedDate) {
+        quads.push(tripleDateTime(subjectUri, NS.clinical + 'performedDate', performedDate));
+    }
+    // Status
+    if (resource.status) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'procedureStatus', resource.status));
+    }
+    // Source record ID
+    if (resource.id) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'sourceRecordId', resource.id));
+    }
+    quads.push(tripleRef(subjectUri, NS.cascade + 'layerPromotionStatus', NS.cascade + 'FullyMapped'));
+    return {
+        turtle: '',
+        jsonld: quadsToJsonLd(quads, 'clinical:Procedure'),
+        warnings,
+        resourceType: 'Procedure',
+        cascadeType: 'clinical:Procedure',
+        _quads: quads,
+    };
+}
+// ---------------------------------------------------------------------------
+// ClinicalDocument converter (B1)
+// ---------------------------------------------------------------------------
+export function convertClinicalDocument(resource) {
+    const warnings = [];
+    const subjectUri = mintSubjectUri(resource);
+    const quads = [];
+    quads.push(tripleType(subjectUri, NS.clinical + 'ClinicalDocument'));
+    quads.push(...commonTriples(subjectUri));
+    // Document type
+    const docType = codeableConceptText(resource.type) ?? 'Unknown Document';
+    quads.push(tripleStr(subjectUri, NS.clinical + 'documentType', docType));
+    // Date
+    const docDate = resource.date ?? resource.indexed;
+    if (docDate) {
+        quads.push(tripleDateTime(subjectUri, NS.clinical + 'documentDate', docDate));
+    }
+    // Content type and URL from first attachment
+    if (Array.isArray(resource.content) && resource.content.length > 0) {
+        const attachment = resource.content[0]?.attachment;
+        if (attachment) {
+            if (attachment.contentType) {
+                quads.push(tripleStr(subjectUri, NS.clinical + 'contentType', attachment.contentType));
+            }
+            if (attachment.url) {
+                quads.push(tripleStr(subjectUri, NS.clinical + 'documentUrl', attachment.url));
+            }
+            if (attachment.title) {
+                quads.push(tripleStr(subjectUri, NS.clinical + 'documentTitle', attachment.title));
+            }
+        }
+    }
+    if (resource.id) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'sourceRecordId', resource.id));
+    }
+    quads.push(tripleRef(subjectUri, NS.cascade + 'layerPromotionStatus', NS.cascade + 'FullyMapped'));
+    return {
+        turtle: '',
+        jsonld: quadsToJsonLd(quads, 'clinical:ClinicalDocument'),
+        warnings,
+        resourceType: 'DocumentReference',
+        cascadeType: 'clinical:ClinicalDocument',
+        _quads: quads,
+    };
+}
+// ---------------------------------------------------------------------------
+// Encounter converter (B2)
+// ---------------------------------------------------------------------------
+export function convertEncounter(resource) {
+    const warnings = [];
+    const subjectUri = mintSubjectUri(resource);
+    const quads = [];
+    quads.push(tripleType(subjectUri, NS.clinical + 'Encounter'));
+    quads.push(...commonTriples(subjectUri));
+    // Encounter class (ambulatory, emergency, inpatient, etc.)
+    const encounterClass = resource.class?.code ?? resource.class?.coding?.[0]?.code;
+    if (encounterClass) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'encounterClass', encounterClass));
+    }
+    // Status
+    if (resource.status) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'encounterStatus', resource.status));
+    }
+    // Encounter type (from type[0])
+    if (Array.isArray(resource.type) && resource.type.length > 0) {
+        const typeText = codeableConceptText(resource.type[0]);
+        if (typeText) {
+            quads.push(tripleStr(subjectUri, NS.clinical + 'encounterType', typeText));
+        }
+        // SNOMED code from type
+        const codings = extractCodings(resource.type[0]);
+        for (const c of codings) {
+            if (c.system === 'http://snomed.info/sct') {
+                quads.push(tripleRef(subjectUri, NS.clinical + 'snomedCode', NS.sct + c.code));
+                break;
+            }
+        }
+    }
+    // Period
+    if (resource.period?.start) {
+        quads.push(tripleDateTime(subjectUri, NS.clinical + 'encounterStart', resource.period.start));
+    }
+    if (resource.period?.end) {
+        quads.push(tripleDateTime(subjectUri, NS.clinical + 'encounterEnd', resource.period.end));
+    }
+    // Provider from first participant
+    if (Array.isArray(resource.participant) && resource.participant.length > 0) {
+        const providerName = resource.participant[0]?.individual?.display;
+        if (providerName) {
+            quads.push(tripleStr(subjectUri, NS.clinical + 'providerName', providerName));
+        }
+    }
+    // Facility from serviceProvider
+    if (resource.serviceProvider?.display) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'facilityName', resource.serviceProvider.display));
+    }
+    if (resource.id) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'sourceRecordId', resource.id));
+    }
+    quads.push(tripleRef(subjectUri, NS.cascade + 'layerPromotionStatus', NS.cascade + 'FullyMapped'));
+    return {
+        turtle: '',
+        jsonld: quadsToJsonLd(quads, 'clinical:Encounter'),
+        warnings,
+        resourceType: 'Encounter',
+        cascadeType: 'clinical:Encounter',
+        _quads: quads,
+    };
+}
+// ---------------------------------------------------------------------------
+// LaboratoryReport (DiagnosticReport) converter (B5)
+// ---------------------------------------------------------------------------
+export function convertLaboratoryReport(resource) {
+    const warnings = [];
+    const subjectUri = mintSubjectUri(resource);
+    const quads = [];
+    quads.push(tripleType(subjectUri, NS.clinical + 'LaboratoryReport'));
+    quads.push(...commonTriples(subjectUri));
+    // Panel name from code.text or first coding display
+    const panelName = codeableConceptText(resource.code) ?? 'Unknown Panel';
+    quads.push(tripleStr(subjectUri, NS.clinical + 'panelName', panelName));
+    // LOINC code
+    const codings = extractCodings(resource.code);
+    for (const c of codings) {
+        if (c.system === 'http://loinc.org') {
+            quads.push(tripleRef(subjectUri, NS.clinical + 'loincCode', NS.loinc + c.code));
+            break;
+        }
+    }
+    // Report category
+    if (Array.isArray(resource.category) && resource.category.length > 0) {
+        const catCode = resource.category[0]?.coding?.[0]?.code ?? codeableConceptText(resource.category[0]);
+        if (catCode) {
+            quads.push(tripleStr(subjectUri, NS.clinical + 'reportCategory', catCode));
+        }
+    }
+    // Effective date
+    const effectiveDate = resource.effectiveDateTime ?? resource.effectivePeriod?.start;
+    if (effectiveDate) {
+        quads.push(tripleDateTime(subjectUri, NS.clinical + 'performedDate', effectiveDate));
+    }
+    // Provider from first performer
+    if (Array.isArray(resource.performer) && resource.performer.length > 0) {
+        const provName = resource.performer[0]?.display;
+        if (provName) {
+            quads.push(tripleStr(subjectUri, NS.clinical + 'providerName', provName));
+        }
+    }
+    // Link to constituent LabResult Observations via hasLabResult
+    if (Array.isArray(resource.result)) {
+        for (const ref of resource.result) {
+            // Extract ID from reference like "Observation/uuid-here"
+            const refStr = ref.reference;
+            if (refStr) {
+                const parts = refStr.split('/');
+                const obsId = parts[parts.length - 1];
+                if (obsId) {
+                    // Mint deterministic URI for the referenced Observation
+                    const obsUri = `urn:uuid:${obsId}`;
+                    quads.push(tripleRef(subjectUri, NS.clinical + 'hasLabResult', obsUri));
+                }
+            }
+        }
+    }
+    if (resource.id) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'sourceRecordId', resource.id));
+    }
+    quads.push(tripleRef(subjectUri, NS.cascade + 'layerPromotionStatus', NS.cascade + 'FullyMapped'));
+    return {
+        turtle: '',
+        jsonld: quadsToJsonLd(quads, 'clinical:LaboratoryReport'),
+        warnings,
+        resourceType: 'DiagnosticReport',
+        cascadeType: 'clinical:LaboratoryReport',
+        _quads: quads,
+    };
+}
+// ---------------------------------------------------------------------------
+// MedicationAdministration converter (B5)
+// ---------------------------------------------------------------------------
+export function convertMedicationAdministration(resource) {
+    const warnings = [];
+    const subjectUri = mintSubjectUri(resource);
+    const quads = [];
+    quads.push(tripleType(subjectUri, NS.clinical + 'MedicationAdministration'));
+    quads.push(...commonTriples(subjectUri));
+    // Medication name
+    const medName = codeableConceptText(resource.medicationCodeableConcept)
+        ?? resource.medicationReference?.display
+        ?? 'Unknown Medication';
+    quads.push(tripleStr(subjectUri, NS.health + 'medicationName', medName));
+    // Status
+    if (resource.status) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'administrationStatus', resource.status));
+    }
+    // Administered date
+    const adminDate = resource.effectiveDateTime ?? resource.effectivePeriod?.start;
+    if (adminDate) {
+        quads.push(tripleDateTime(subjectUri, NS.clinical + 'administeredDate', adminDate));
+    }
+    // Dose and route from dosage
+    if (resource.dosage) {
+        if (resource.dosage.dose) {
+            const dose = `${resource.dosage.dose.value ?? ''} ${resource.dosage.dose.unit ?? ''}`.trim();
+            if (dose)
+                quads.push(tripleStr(subjectUri, NS.clinical + 'administeredDose', dose));
+        }
+        const route = codeableConceptText(resource.dosage.route);
+        if (route) {
+            quads.push(tripleStr(subjectUri, NS.clinical + 'administeredRoute', route));
+        }
+    }
+    if (resource.id) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'sourceRecordId', resource.id));
+    }
+    quads.push(tripleRef(subjectUri, NS.cascade + 'layerPromotionStatus', NS.cascade + 'FullyMapped'));
+    return {
+        turtle: '',
+        jsonld: quadsToJsonLd(quads, 'clinical:MedicationAdministration'),
+        warnings,
+        resourceType: 'MedicationAdministration',
+        cascadeType: 'clinical:MedicationAdministration',
+        _quads: quads,
+    };
+}
+// ---------------------------------------------------------------------------
+// Device (ImplantedDevice) converter (B5)
+// ---------------------------------------------------------------------------
+export function convertDevice(resource) {
+    const warnings = [];
+    const subjectUri = mintSubjectUri(resource);
+    const quads = [];
+    quads.push(tripleType(subjectUri, NS.clinical + 'ImplantedDevice'));
+    quads.push(...commonTriples(subjectUri));
+    // Device type
+    const deviceType = codeableConceptText(resource.type) ?? 'Unknown Device';
+    quads.push(tripleStr(subjectUri, NS.clinical + 'deviceType', deviceType));
+    // Status
+    if (resource.status) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'deviceStatus', resource.status));
+    }
+    // Manufacturer
+    if (resource.manufacturer) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'deviceManufacturer', resource.manufacturer));
+    }
+    // UDI carrier
+    if (Array.isArray(resource.udiCarrier) && resource.udiCarrier.length > 0) {
+        const udi = resource.udiCarrier[0]?.deviceIdentifier ?? resource.udiCarrier[0]?.carrierHRF;
+        if (udi)
+            quads.push(tripleStr(subjectUri, NS.clinical + 'udiCarrier', udi));
+    }
+    // Implant date (from manufactureDate or extension)
+    if (resource.manufactureDate) {
+        quads.push(tripleDateTime(subjectUri, NS.clinical + 'implantDate', resource.manufactureDate));
+    }
+    if (resource.id) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'sourceRecordId', resource.id));
+    }
+    quads.push(tripleRef(subjectUri, NS.cascade + 'layerPromotionStatus', NS.cascade + 'FullyMapped'));
+    return {
+        turtle: '',
+        jsonld: quadsToJsonLd(quads, 'clinical:ImplantedDevice'),
+        warnings,
+        resourceType: 'Device',
+        cascadeType: 'clinical:ImplantedDevice',
+        _quads: quads,
+    };
+}
+// ---------------------------------------------------------------------------
+// ImagingStudy converter (B5)
+// ---------------------------------------------------------------------------
+export function convertImagingStudy(resource) {
+    const warnings = [];
+    const subjectUri = mintSubjectUri(resource);
+    const quads = [];
+    quads.push(tripleType(subjectUri, NS.clinical + 'ImagingStudy'));
+    quads.push(...commonTriples(subjectUri));
+    // Modality from first series
+    const modality = resource.series?.[0]?.modality?.code;
+    if (modality) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'imagingModality', modality));
+    }
+    // Description
+    if (resource.description) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'studyDescription', resource.description));
+    }
+    // Number of series
+    if (resource.numberOfSeries !== undefined) {
+        quads.push(tripleTyped(subjectUri, NS.clinical + 'numberOfSeries', String(resource.numberOfSeries), NS.xsd + 'integer'));
+    }
+    // Study date
+    if (resource.started) {
+        quads.push(tripleDateTime(subjectUri, NS.clinical + 'studyDate', resource.started));
+    }
+    // DICOM Study UID from identifier[0]
+    if (Array.isArray(resource.identifier) && resource.identifier.length > 0) {
+        const uid = resource.identifier[0]?.value;
+        if (uid)
+            quads.push(tripleStr(subjectUri, NS.clinical + 'dicomStudyUid', uid));
+    }
+    // Retrieve URL from first series endpoint
+    const retrieveUrl = resource.series?.[0]?.endpoint?.[0]?.reference;
+    if (retrieveUrl) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'retrieveUrl', retrieveUrl));
+    }
+    if (resource.id) {
+        quads.push(tripleStr(subjectUri, NS.clinical + 'sourceRecordId', resource.id));
+    }
+    quads.push(tripleRef(subjectUri, NS.cascade + 'layerPromotionStatus', NS.cascade + 'FullyMapped'));
+    return {
+        turtle: '',
+        jsonld: quadsToJsonLd(quads, 'clinical:ImagingStudy'),
+        warnings,
+        resourceType: 'ImagingStudy',
+        cascadeType: 'clinical:ImagingStudy',
+        _quads: quads,
+    };
+}
 //# sourceMappingURL=converters-clinical.js.map