@fhirfly-io/shl 0.3.1 → 0.4.0

package/dist/{chunk-YBDRWUQU.js → chunk-UU434UFQ.js}

@@ -174,7 +174,11 @@ var CODE_SYSTEMS = {
   CVX: "http://hl7.org/fhir/sid/cvx",
   ICD10CM: "http://hl7.org/fhir/sid/icd-10-cm",
   CONDITION_CLINICAL: "http://terminology.hl7.org/CodeSystem/condition-clinical",
-  ALLERGY_CLINICAL: "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical"
+  ALLERGY_CLINICAL: "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
+  /** CMS Patient-Shared Health Document category code system */
+  CMS_PATIENT_SHARED_CATEGORY: "https://cms.gov/fhir/CodeSystem/patient-shared-category",
+  /** V3 ActCode security label for patient-asserted data */
+  SECURITY_PATAST: "PATAST"
 };
 
 // src/ips/medication.ts
@@ -1100,8 +1104,9 @@ function resolveDocuments(documents, patientRef, profile, generateUuid2) {
       contentType,
       data: base64Content
     };
-    const typeCode = doc.typeCode ?? "34133-9";
-    const typeDisplay = doc.typeDisplay ?? "Summarization of episode note";
+    const isPshd = profile === "pshd";
+    const typeCode = isPshd ? "60591-5" : doc.typeCode ?? "34133-9";
+    const typeDisplay = isPshd ? "Patient summary Document" : doc.typeDisplay ?? "Summarization of episode note";
     const docRefResource = {
       resourceType: "DocumentReference",
       id: docRefId,
@@ -1127,7 +1132,29 @@ function resolveDocuments(documents, patientRef, profile, generateUuid2) {
         }
       ]
     };
-    if (profile === "ips") {
+    if (isPshd) {
+      docRefResource.category = [
+        {
+          coding: [
+            {
+              system: CODE_SYSTEMS.CMS_PATIENT_SHARED_CATEGORY,
+              code: "patient-shared",
+              display: "Patient Shared"
+            }
+          ]
+        }
+      ];
+      docRefResource.author = [{ reference: patientRef }];
+      docRefResource.meta = {
+        security: [
+          {
+            system: "http://terminology.hl7.org/CodeSystem/v3-ActCode",
+            code: CODE_SYSTEMS.SECURITY_PATAST,
+            display: "patient asserted"
+          }
+        ]
+      };
+    } else if (profile === "ips") {
       docRefResource.meta = {
         profile: ["http://hl7.org/fhir/uv/ips/StructureDefinition/DocumentReference-uv-ips"]
       };
@@ -1326,11 +1353,9 @@ var Bundle = class {
   async build(options) {
     const profile = options?.profile ?? "ips";
     const bundleId = options?.bundleId ?? generateUuid();
-    const compositionId = generateUuid();
     const patientId = generateUuid();
-    const compositionDate = options?.compositionDate ?? (/* @__PURE__ */ new Date()).toISOString();
+    const timestamp = options?.compositionDate ?? (/* @__PURE__ */ new Date()).toISOString();
     const patientFullUrl = `urn:uuid:${patientId}`;
-    const compositionFullUrl = `urn:uuid:${compositionId}`;
     const patientResource = normalizePatient(this._patient, patientId, profile);
     const [medResult, condResult, allergyResult, immResult, resultResult] = await Promise.all([
       resolveMedications(this._medications, patientFullUrl, profile, generateUuid),
@@ -1347,6 +1372,22 @@ var Bundle = class {
       ...immResult.warnings,
       ...resultResult.warnings
     ];
+    if (profile === "pshd") {
+      return this.buildPshdBundle(
+        bundleId,
+        timestamp,
+        patientFullUrl,
+        patientResource,
+        medResult.entries,
+        condResult.entries,
+        allergyResult.entries,
+        immResult.entries,
+        resultResult.entries,
+        docResult.entries
+      );
+    }
+    const compositionId = generateUuid();
+    const compositionFullUrl = `urn:uuid:${compositionId}`;
     const medRefs = medResult.entries.map((e) => ({ reference: e.fullUrl }));
     const condRefs = condResult.entries.map((e) => ({ reference: e.fullUrl }));
     const allergyRefs = allergyResult.entries.map((e) => ({ reference: e.fullUrl }));
@@ -1355,7 +1396,7 @@ var Bundle = class {
     const composition = this.buildComposition(
       compositionId,
       patientFullUrl,
-      compositionDate,
+      timestamp,
       profile,
       medRefs,
       allergyRefs,
@@ -1381,7 +1422,7 @@ var Bundle = class {
         value: `urn:uuid:${bundleId}`
       },
       type: "document",
-      timestamp: compositionDate,
+      timestamp,
       entry: entries
     };
     return bundle;
@@ -1401,6 +1442,37 @@ var Bundle = class {
         path: "Patient.birthDate"
       });
     }
+    if (profile === "pshd") {
+      if (this._documents.length === 0) {
+        issues.push({
+          severity: "error",
+          message: "PSHD requires at least one DocumentReference (1..1)",
+          path: "Bundle.entry:DocumentReference"
+        });
+      } else {
+        const hasPdf = this._documents.some(
+          (d) => (d.contentType ?? "application/pdf") === "application/pdf"
+        );
+        if (!hasPdf) {
+          issues.push({
+            severity: "error",
+            message: "PSHD requires at least one PDF document (contentType application/pdf)",
+            path: "DocumentReference.content.attachment.contentType"
+          });
+        }
+      }
+      if (!this._patient.gender) {
+        issues.push({
+          severity: "warning",
+          message: "Patient.gender recommended for PSHD demographic matching",
+          path: "Patient.gender"
+        });
+      }
+      return {
+        valid: issues.filter((i) => i.severity === "error").length === 0,
+        issues
+      };
+    }
     if (profile === "ips") {
       if (!this.hasValidName()) {
         issues.push({
@@ -1476,6 +1548,28 @@ var Bundle = class {
     const s = this._patient;
     return !!(s.given || s.family || s.name);
   }
+  buildPshdBundle(bundleId, timestamp, patientFullUrl, patientResource, medEntries, condEntries, allergyEntries, immEntries, resultEntries, docEntries) {
+    const entries = [
+      { fullUrl: patientFullUrl, resource: patientResource },
+      ...medEntries,
+      ...condEntries,
+      ...allergyEntries,
+      ...immEntries,
+      ...resultEntries,
+      ...docEntries
+    ];
+    return {
+      resourceType: "Bundle",
+      id: bundleId,
+      identifier: {
+        system: "urn:ietf:rfc:3986",
+        value: `urn:uuid:${bundleId}`
+      },
+      type: "collection",
+      timestamp,
+      entry: entries
+    };
+  }
   buildComposition(id, patientRef, date, profile, medRefs, allergyRefs, condRefs, immRefs, resultRefs) {
     const composition = {
       resourceType: "Composition",
@@ -1709,6 +1803,25 @@ async function create(options) {
   if (!storage?.baseUrl) {
     throw new ValidationError("storage with baseUrl is required");
   }
+  let mode = options.mode ?? "manifest";
+  if (options.compliance === "pshd") {
+    mode = "direct";
+    if (passcode) {
+      throw new ValidationError(
+        "PSHD compliance forbids passcode (flag U is incompatible with flag P)"
+      );
+    }
+    if (!expiresAt) {
+      throw new ValidationError(
+        "PSHD compliance requires expiresAt (short-lived links for point-of-care)"
+      );
+    }
+  }
+  if (mode === "direct" && passcode) {
+    throw new ValidationError(
+      "Direct mode (flag U) is incompatible with passcode (flag P)"
+    );
+  }
   const key = generateKey();
   const shlId = generateShlId();
   let jwe;
@@ -1768,31 +1881,34 @@ async function create(options) {
       );
     }
   }
-  const manifest = {
-    files: [
-      {
-        contentType: "application/fhir+json;fhirVersion=4.0.1",
-        location: `${baseUrl}/${shlId}/content`
-      },
-      ...attachments.map((att, i) => ({
-        contentType: att.contentType,
-        location: `${baseUrl}/${shlId}/attachment/${i}`
-      }))
-    ],
-    status: "finalized",
-    lastUpdated: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  try {
-    await storage.store(`${shlId}/manifest.json`, JSON.stringify(manifest));
-  } catch (err) {
-    throw new StorageError(
-      `Failed to store manifest: ${err instanceof Error ? err.message : String(err)}`,
-      "store"
-    );
+  if (mode === "manifest") {
+    const manifest = {
+      files: [
+        {
+          contentType: "application/fhir+json;fhirVersion=4.0.1",
+          location: `${baseUrl}/${shlId}/content`
+        },
+        ...attachments.map((att, i) => ({
+          contentType: att.contentType,
+          location: `${baseUrl}/${shlId}/attachment/${i}`
+        }))
+      ],
+      status: "finalized",
+      lastUpdated: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    try {
+      await storage.store(`${shlId}/manifest.json`, JSON.stringify(manifest));
+    } catch (err) {
+      throw new StorageError(
+        `Failed to store manifest: ${err instanceof Error ? err.message : String(err)}`,
+        "store"
+      );
+    }
   }
   const metadata = {
     createdAt: (/* @__PURE__ */ new Date()).toISOString()
   };
+  if (mode === "direct") metadata.mode = "direct";
   if (passcode) {
     metadata.passcode = createHash("sha256").update(passcode).digest("hex");
   }
@@ -1806,7 +1922,7 @@ async function create(options) {
       "store"
     );
   }
-  const flags = buildFlags(passcode);
+  const flags = buildFlags(mode, passcode);
   const shlPayload = {
     url: `${baseUrl}/${shlId}`,
     key: base64url(key),
@@ -1833,8 +1949,8 @@ async function create(options) {
   if (debug) result.debugBundlePath = `${shlId}/bundle.json`;
   return result;
 }
-function buildFlags(passcode) {
-  const flags = ["L"];
+function buildFlags(mode, passcode) {
+  const flags = [mode === "direct" ? "U" : "L"];
   if (passcode) flags.push("P");
   return flags.sort().join("");
 }
@@ -1941,5 +2057,5 @@ async function revoke(shlId, storage) {
 }
 
 export { ips_exports, shl_exports };
-//# sourceMappingURL=chunk-YBDRWUQU.js.map
-//# sourceMappingURL=chunk-YBDRWUQU.js.map
+//# sourceMappingURL=chunk-UU434UFQ.js.map
+//# sourceMappingURL=chunk-UU434UFQ.js.map