@imranq2/fhirpatientsummary 1.0.17 → 1.0.19

package/README.md

@@ -18,7 +18,7 @@ npm install
 
 You can use the `ComprehensiveIPSCompositionBuilder` in your TypeScript or JavaScript project to generate an IPS-compliant FHIR Bundle. The builder supports both fluent section addition and a convenient `read_bundle()` method to extract all supported sections from a FHIR Bundle.
 
-### Example: Using setPatient and addSection
+### Example: Using setPatient and makeSectionAsync
 
 ```typescript
 import { ComprehensiveIPSCompositionBuilder } from './src/generators/fhir_summary_generator';
@@ -26,10 +26,10 @@ import { IPSSections } from './src/structures/ips_sections';
 
 const builder = new ComprehensiveIPSCompositionBuilder()
   .setPatient(patientResource)
-  .addSection(IPSSections.ALLERGIES, allergiesArray, 'America/New_York')
-  .addSection(IPSSections.MEDICATIONS, medicationsArray, 'America/New_York')
-  .addSection(IPSSections.PROBLEMS, problemsArray, 'America/New_York')
-  .addSection(IPSSections.IMMUNIZATIONS, immunizationsArray, 'America/New_York');
+  .makeSectionAsync(IPSSections.ALLERGIES, allergiesArray, 'America/New_York')
+  .makeSectionAsync(IPSSections.MEDICATIONS, medicationsArray, 'America/New_York')
+  .makeSectionAsync(IPSSections.PROBLEMS, problemsArray, 'America/New_York')
+  .makeSectionAsync(IPSSections.IMMUNIZATIONS, immunizationsArray, 'America/New_York');
 
 const bundle = builder.build_bundle(
   'example-organization',
@@ -61,7 +61,7 @@ console.log(JSON.stringify(bundle, null, 2));
 ```
 
 - Use `setPatient(patientResource)` to set the patient.
-- Use `addSection(sectionType, resources, timezone)` to add each IPS section, or use `read_bundle(fhirBundle, timezone)` to extract all supported sections from a FHIR Bundle.
+- Use `makeSectionAsync(sectionType, resources, timezone)` to add each IPS section, or use `read_bundle(fhirBundle, timezone)` to extract all supported sections from a FHIR Bundle.
 - Use `build_bundle` to generate the final FHIR Bundle.
 
 ## Running Tests

package/dist/index.cjs

@@ -142,10 +142,17 @@ var IPSSectionResourceFilters = {
   // Only include active advance directives (Consent resources)
   ["AdvanceDirectivesSection" /* ADVANCE_DIRECTIVES */]: (resource) => resource.resourceType === "Consent" && resource.status === "active"
 };
+var IPSSectionSummaryCompositionFilter = {
+  ["AllergyIntoleranceSection" /* ALLERGIES */]: (resource) => resource.resourceType === "Composition" && resource.type?.coding?.some((c) => c.system === "https://fhir.icanbwell.com/4_0_0/CodeSystem/composition/" && c.code === "allergy_summary_document"),
+  ["VitalSignsSection" /* VITAL_SIGNS */]: (resource) => resource.resourceType === "Composition" && resource.type?.coding?.some((c) => c.system === "https://fhir.icanbwell.com/4_0_0/CodeSystem/composition/" && c.code === "vital_summary_document")
+};
 var IPSSectionResourceHelper = class {
   static getResourceFilterForSection(section) {
     return IPSSectionResourceFilters[section];
   }
+  static getSummaryCompositionFilterForSection(section) {
+    return IPSSectionSummaryCompositionFilter[section];
+  }
 };
 
 // src/narratives/templates/typescript/TemplateUtilities.ts
@@ -595,6 +602,137 @@ var TemplateUtilities = class {
     }
     return status;
   }
+  extractObservationSummaryValue(data, timezone) {
+    if (data["valueQuantity.value"] !== void 0) {
+      const value = data["valueQuantity.value"];
+      const unit = data["valueQuantity.unit"];
+      return unit ? `${value} ${unit}` : `${value}`;
+    }
+    if (data["valueCodeableConcept.text"] !== void 0) {
+      return data["valueCodeableConcept.text"];
+    }
+    if (data["valueCodeableConcept.coding.display"] !== void 0) {
+      return data["valueCodeableConcept.coding.display"];
+    }
+    if (data["valueString"] !== void 0) {
+      return data["valueString"];
+    }
+    if (data["valueBoolean"] !== void 0) {
+      return String(data["valueBoolean"]);
+    }
+    if (data["valueInteger"] !== void 0) {
+      return String(data["valueInteger"]);
+    }
+    if (data["valueDateTime"] !== void 0) {
+      return this.renderTime(data["valueDateTime"], timezone);
+    }
+    if (data["valuePeriod.start"] !== void 0 || data["valuePeriod.end"] !== void 0) {
+      const start = this.renderTime(data["valuePeriod.start"], timezone);
+      const end = this.renderTime(data["valuePeriod.end"], timezone);
+      if (start && end) {
+        return `${start} - ${end}`;
+      } else if (start) {
+        return `${start}`;
+      } else if (end) {
+        return `${end}`;
+      }
+    }
+    if (data["valueTime"] !== void 0) {
+      return this.renderTime(data["valueTime"], timezone);
+    }
+    if (data["valueSampledData.origin.value"] !== void 0 || data["valueSampledData.origin.unit"] !== void 0) {
+      const originValue = data["valueSampledData.origin.value"];
+      const originUnit = data["valueSampledData.origin.unit"];
+      let result = "";
+      if (originValue !== void 0 && originUnit !== void 0) {
+        result = `${originValue} ${originUnit}`;
+      } else if (originValue !== void 0) {
+        result = `${originValue}`;
+      } else if (originUnit !== void 0) {
+        result = `${originUnit}`;
+      }
+      const period = data["valueSampledData.period"];
+      const factor = data["valueSampledData.factor"];
+      const lowerLimit = data["valueSampledData.lowerLimit"];
+      const upperLimit = data["valueSampledData.upperLimit"];
+      const sampledData = data["valueSampledData.data"];
+      const extras = [];
+      if (period !== void 0) extras.push(`period: ${period}`);
+      if (factor !== void 0) extras.push(`factor: ${factor}`);
+      if (lowerLimit !== void 0) extras.push(`lowerLimit: ${lowerLimit}`);
+      if (upperLimit !== void 0) extras.push(`upperLimit: ${upperLimit}`);
+      if (sampledData !== void 0) extras.push(`data: ${sampledData}`);
+      if (extras.length > 0) {
+        result += ` (${extras.join(", ")})`;
+      }
+      return result;
+    }
+    if (data["valueRange.low.value"] !== void 0 || data["valueRange.high.value"] !== void 0) {
+      let referenceRange = "";
+      if (data["valueRange.low.value"] !== void 0) {
+        referenceRange += `${data["valueRange.low.value"]}`;
+        if (data["valueRange.low.unit"] !== void 0) {
+          referenceRange += ` ${data["valueRange.low.unit"]}`;
+        }
+        referenceRange = referenceRange.trim();
+        if (data["valueRange.high.value"] !== void 0) {
+          referenceRange += " - ";
+        }
+      }
+      if (data["valueRange.high.value"] !== void 0) {
+        referenceRange += `${data["valueRange.high.value"]}`;
+        if (data["valueRange.high.unit"] !== void 0) {
+          referenceRange += ` ${data["valueRange.high.unit"]}`;
+        }
+      }
+      return referenceRange.trim();
+    }
+    if (data["valueRatio.numerator.value"] !== void 0 || data["valueRatio.denominator.value"] !== void 0) {
+      let ratio = "";
+      if (data["valueRatio.numerator.value"] !== void 0) {
+        ratio += `${data["valueRatio.numerator.value"]}`;
+        if (data["valueRatio.numerator.unit"] !== void 0) {
+          ratio += ` ${data["valueRatio.numerator.unit"]}`;
+        }
+      }
+      if (data["valueRatio.denominator.value"] !== void 0) {
+        ratio += " / ";
+        ratio += `${data["valueRatio.denominator.value"]}`;
+        if (data["valueRatio.denominator.unit"] !== void 0) {
+          ratio += ` ${data["valueRatio.denominator.unit"]}`;
+        }
+      }
+      return ratio.trim();
+    }
+    return "";
+  }
+  extractObservationSummaryReferenceRange(data) {
+    let referenceRange = "";
+    if (data["referenceRange.low.value"]) {
+      referenceRange += `${data["referenceRange.low.value"]} ${data["referenceRange.low.unit"]}`;
+      referenceRange.trim();
+      if (data["referenceRange.high.value"]) {
+        referenceRange += " - ";
+      }
+    }
+    if (data["referenceRange.high.value"]) {
+      referenceRange += `${data["referenceRange.high.value"]} ${data["referenceRange.high.unit"]}`;
+    }
+    return referenceRange.trim();
+  }
+  extractObservationSummaryEffectiveTime(data, timezone) {
+    if (data["effectiveDateTime"]) {
+      return this.renderTime(data["effectiveDateTime"], timezone);
+    }
+    let effectiveTimePeriod = "";
+    if (data["effectivePeriod.start"]) {
+      effectiveTimePeriod += this.renderTime(data["effectivePeriod.start"], timezone);
+    }
+    if (data["effectivePeriod.end"]) {
+      effectiveTimePeriod += ` - ${this.renderTime(data["effectivePeriod.end"], timezone)}`;
+    }
+    return effectiveTimePeriod.trim();
+  }
   formatQuantityValue(quantity) {
     if (!quantity) return "";
     const parts = [];
@@ -1094,6 +1232,57 @@ var AllergyIntoleranceTemplate = class _AllergyIntoleranceTemplate {
   generateNarrative(resources, timezone) {
     return _AllergyIntoleranceTemplate.generateStaticNarrative(resources, timezone);
   }
+  /**
+   * Generate HTML narrative for AllergyIntolerance resources using summary
+   * @param resources - FHIR Composition resources
+   * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+   * @returns HTML string for rendering
+   */
+  generateSummaryNarrative(resources, timezone) {
+    const templateUtilities = new TemplateUtilities(resources);
+    let html = `
+      <div>
+        <table>
+          <thead>
+            <tr>
+              <th>Allergen</th>
+              <th>Criticality</th>
+              <th>Recorded Date</th>
+            </tr>
+          </thead>
+          <tbody>`;
+    for (const resourceItem of resources) {
+      for (const rowData of resourceItem.section ?? []) {
+        const data = {};
+        for (const columnData of rowData.section ?? []) {
+          switch (columnData.title) {
+            case "Allergen Name":
+              data["allergen"] = columnData.text?.div ?? "";
+              break;
+            case "Criticality":
+              data["criticality"] = columnData.text?.div ?? "";
+              break;
+            case "Recorded Date":
+              data["recordedDate"] = columnData.text?.div ?? "";
+              break;
+            default:
+              break;
+          }
+        }
+        html += `
+            <tr>
+              <td>${data["allergen"] ?? "-"}</td>
+              <td>${data["criticality"] ?? "-"}</td>
+              <td>${templateUtilities.renderTime(data["recordedDate"], timezone) ?? "-"}</td>
+            </tr>`;
+      }
+    }
+    html += `
+          </tbody>
+        </table>
+      </div>`;
+    return html;
+  }
   /**
    * Internal static implementation that actually generates the narrative
    * @param resources - FHIR resources array containing AllergyIntolerance resources
@@ -1586,6 +1775,13 @@ var ProblemListTemplate = class _ProblemListTemplate {
   }
 };
 
+// src/structures/ips_section_constants.ts
+var VITAL_SIGNS_SUMMARY_COMPONENT_MAP = {
+  "Systolic Blood Pressure": "valueRatio.numerator.value",
+  "Diastolic Blood Pressure": "valueRatio.denominator.value",
+  "Default": "valueString"
+};
+
 // src/narratives/templates/typescript/VitalSignsTemplate.ts
 var VitalSignsTemplate = class _VitalSignsTemplate {
   /**
@@ -1597,6 +1793,68 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
   generateNarrative(resources, timezone) {
     return _VitalSignsTemplate.generateStaticNarrative(resources, timezone);
   }
+  /**
+   * Generate HTML narrative for vital signs using summary
+   * @param resources - FHIR Composition resources
+   * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+   * @returns HTML string for rendering
+   */
+  generateSummaryNarrative(resources, timezone) {
+    const templateUtilities = new TemplateUtilities(resources);
+    let html = `
+      <div>
+        <table>
+          <thead>
+            <tr>
+              <th>Vital Name</th>
+              <th>Result</th>
+              <th>Reference Range</th>
+              <th>Date</th>
+            </tr>
+          </thead>
+          <tbody>`;
+    for (const resourceItem of resources) {
+      for (const rowData of resourceItem.section ?? []) {
+        const data = {};
+        for (const columnData of rowData.section ?? []) {
+          const columnTitle = columnData.title;
+          if (columnTitle) {
+            if (Object.keys(VITAL_SIGNS_SUMMARY_COMPONENT_MAP).includes(
+              columnTitle
+            )) {
+              const vitalData = {};
+              for (const component of columnData.section?.[0]?.section ?? []) {
+                if (component.title) {
+                  vitalData[component.title] = component.text?.div ?? "";
+                }
+              }
+              const vitalValue = templateUtilities.extractObservationSummaryValue(
+                vitalData,
+                timezone
+              );
+              if (vitalValue) {
+                const dataKey = VITAL_SIGNS_SUMMARY_COMPONENT_MAP[columnTitle] ?? VITAL_SIGNS_SUMMARY_COMPONENT_MAP["Default"];
+                data[dataKey] = vitalValue;
+              }
+            }
+            data[columnTitle] = columnData.text?.div ?? "";
+          }
+        }
+        html += `
+          <tr>
+            <td>${data["Vital Name"] ?? "-"}</td>
+            <td>${templateUtilities.extractObservationSummaryValue(data, timezone) ?? "-"}</td>
+            <td>${templateUtilities.extractObservationSummaryReferenceRange(data) ?? "-"}</td>
+            <td>${templateUtilities.extractObservationSummaryEffectiveTime(data, timezone) ?? "-"}</td>
+          </tr>`;
+      }
+    }
+    html += `
+          </tbody>
+        </table>
+      </div>`;
+    return html;
+  }
   /**
    * Internal static implementation that actually generates the narrative
    * @param resources - FHIR Observation resources
@@ -1615,7 +1873,7 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
       <table>
         <thead>
           <tr>
-            <th>Code</th>
+            <th>Vital Name</th>
             <th>Result</th>
             <th>Unit</th>
             <th>Interpretation</th>
@@ -2260,14 +2518,18 @@ var TypeScriptTemplateMapper = class {
    * @param section - The IPS section
    * @param resources - FHIR resources
    * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+   * @param useSectionSummary - Whether to use the section summary for narrative generation
    * @returns HTML string for rendering
    */
-  static generateNarrative(section, resources, timezone) {
+  static generateNarrative(section, resources, timezone, useSectionSummary = false) {
     const templateClass = this.sectionToTemplate[section];
     if (!templateClass) {
       throw new Error(`No template found for section: ${section}`);
     }
-    return templateClass.generateNarrative(resources, timezone);
+    return useSectionSummary ? templateClass.generateSummaryNarrative(
+      resources,
+      timezone
+    ) : templateClass.generateNarrative(resources, timezone);
   }
 };
 // Map of section types to their template classes
@@ -2323,14 +2585,15 @@ var NarrativeGenerator = class {
    * @param section - IPS section type
    * @param resources - Array of domain resources
    * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+   * @param useSectionSummary - Whether to use section summary for narrative generation (default: false)
    * @returns Generated HTML content or undefined if no resources
    */
-  static async generateNarrativeContentAsync(section, resources, timezone) {
+  static async generateNarrativeContentAsync(section, resources, timezone, useSectionSummary = false) {
     if (!resources || resources.length === 0) {
       return void 0;
     }
     try {
-      const content = TypeScriptTemplateMapper.generateNarrative(section, resources, timezone);
+      const content = TypeScriptTemplateMapper.generateNarrative(section, resources, timezone, useSectionSummary);
       if (!content) {
         return void 0;
       }
@@ -2381,10 +2644,11 @@ var NarrativeGenerator = class {
    * @param resources - Array of domain resources
    * @param timezone - Optional timezone to use for date formatting
    * @param minify - Whether to minify the HTML content (default: true)
+   * @param useSectionSummary - Whether to use section summary for narrative generation (default: false)
    * @returns Promise that resolves to a FHIR Narrative object or undefined if no resources
    */
-  static async generateNarrativeAsync(section, resources, timezone, minify = true) {
-    const content = await this.generateNarrativeContentAsync(section, resources, timezone);
+  static async generateNarrativeAsync(section, resources, timezone, minify = true, useSectionSummary = false) {
+    const content = await this.generateNarrativeContentAsync(section, resources, timezone, useSectionSummary);
     if (!content) {
       return void 0;
     }
@@ -2429,11 +2693,37 @@ var ComprehensiveIPSCompositionBuilder = class {
   }
   /**
    * Adds a section to the composition with async HTML minification
+   * @param narrative - Narrative content for the section
+   * @param sectionType - IPS section type
+   * @param validResources - Array of domain resources
+   */
+  addSectionAsync(narrative, sectionType, validResources) {
+    const sectionEntry = {
+      title: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType,
+      code: {
+        coding: [{
+          system: "http://loinc.org",
+          code: IPS_SECTION_LOINC_CODES[sectionType],
+          display: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType
+        }],
+        text: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType
+      },
+      text: narrative,
+      entry: validResources.map((resource) => ({
+        reference: `${resource.resourceType}/${resource.id}`,
+        display: resource.resourceType
+      }))
+    };
+    this.sections.push(sectionEntry);
+    return this;
+  }
+  /**
+   * Make and adds a section to the composition with async HTML minification
    * @param sectionType - IPS section type
    * @param validResources - Array of domain resources
    * @param timezone - Optional timezone to use for date formatting
    */
-  async addSectionAsync(sectionType, validResources, timezone) {
+  async makeSectionAsync(sectionType, validResources, timezone) {
     for (const resource of validResources) {
       this.resources.add(resource);
     }
@@ -2453,32 +2743,38 @@ var ComprehensiveIPSCompositionBuilder = class {
       } else {
         return this;
       }
-      const sectionEntry = {
-        title: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType,
-        code: {
-          coding: [{
-            system: "http://loinc.org",
-            code: IPS_SECTION_LOINC_CODES[sectionType],
-            display: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType
-          }],
-          text: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType
-        },
-        text: narrative,
-        entry: validResources.map((resource) => ({
-          reference: `${resource.resourceType}/${resource.id}`,
-          display: resource.resourceType
-        }))
-      };
-      this.sections.push(sectionEntry);
+      this.addSectionAsync(narrative, sectionType, validResources);
     }
     return this;
   }
+  async makeSectionFromSummaryAsync(sectionType, summaryCompositions, resources, timezone) {
+    const sectionResources = [];
+    for (const summaryComposition of summaryCompositions) {
+      const resourceEntries = summaryComposition?.section?.flatMap((sec) => sec.entry || []) ?? [];
+      resources.forEach((resource) => {
+        if (resourceEntries?.some((entry) => entry.reference === `${resource.resourceType}/${resource.id}`)) {
+          this.resources.add(resource);
+          sectionResources.push(resource);
+        }
+      });
+    }
+    const narrative = await NarrativeGenerator.generateNarrativeAsync(
+      sectionType,
+      summaryCompositions,
+      timezone,
+      true,
+      true
+    );
+    this.addSectionAsync(narrative, sectionType, sectionResources);
+    return this;
+  }
   /**
    * Reads a FHIR Bundle and extracts resources for each section defined in IPSSections.
    * @param bundle - FHIR Bundle containing resources
    * @param timezone - Optional timezone to use for date formatting
+   * @param useSummaryCompositions - Whether to use summary compositions (default: false)
    */
-  async readBundleAsync(bundle, timezone) {
+  async readBundleAsync(bundle, timezone, useSummaryCompositions = false) {
     if (!bundle.entry) {
       return this;
     }
@@ -2500,9 +2796,15 @@ var ComprehensiveIPSCompositionBuilder = class {
       if (sectionType === "Patient" /* PATIENT */) {
         continue;
       }
-      const sectionFilter = IPSSectionResourceHelper.getResourceFilterForSection(sectionType);
-      const sectionResources = resources.filter((resource) => sectionFilter(resource));
-      await this.addSectionAsync(sectionType, sectionResources, timezone);
+      const summaryCompositionFilter = useSummaryCompositions ? IPSSectionResourceHelper.getSummaryCompositionFilterForSection(sectionType) : void 0;
+      const sectionSummary = summaryCompositionFilter ? resources.filter((resource) => summaryCompositionFilter(resource)) : [];
+      if (sectionSummary.length > 0) {
+        await this.makeSectionFromSummaryAsync(sectionType, sectionSummary, resources, timezone);
+      } else {
+        const sectionFilter = IPSSectionResourceHelper.getResourceFilterForSection(sectionType);
+        const sectionResources = resources.filter((resource) => sectionFilter(resource));
+        await this.makeSectionAsync(sectionType, sectionResources, timezone);
+      }
     }
     return this;
   }

package/dist/index.d.cts

@@ -630,6 +630,60 @@ type TBundle = {
     signature?: TSignature;
 };
 
+type TCompositionAttester = {
+    id?: string;
+    extension?: TExtension[];
+    modifierExtension?: TExtension[];
+    mode: string;
+    time?: TDateTime;
+    party?: TReference;
+};
+
+type TCompositionRelatesTo = {
+    id?: string;
+    extension?: TExtension[];
+    modifierExtension?: TExtension[];
+    code: string;
+    targetIdentifier?: TIdentifier;
+    targetReference?: TReference;
+};
+
+type TCompositionEvent = {
+    id?: string;
+    extension?: TExtension[];
+    modifierExtension?: TExtension[];
+    code?: TCodeableConcept[];
+    period?: TPeriod;
+    detail?: TReference[];
+};
+
+type TComposition = {
+    resourceType?: string;
+    id?: string;
+    meta?: TMeta;
+    implicitRules?: TUri;
+    language?: string;
+    text?: TNarrative;
+    contained?: TResourceContainer[];
+    extension?: TExtension[];
+    modifierExtension?: TExtension[];
+    identifier?: TIdentifier;
+    status: string;
+    type: TCodeableConcept;
+    category?: TCodeableConcept[];
+    subject?: TReference;
+    encounter?: TReference;
+    date: TDateTime;
+    author: TReference[];
+    title: string;
+    confidentiality?: string;
+    attester?: TCompositionAttester[];
+    custodian?: TReference;
+    relatesTo?: TCompositionRelatesTo[];
+    event?: TCompositionEvent[];
+    section?: TCompositionSection[];
+};
+
 declare class ComprehensiveIPSCompositionBuilder {
     private patients;
     private sections;
@@ -642,17 +696,26 @@ declare class ComprehensiveIPSCompositionBuilder {
     setPatient(patients: TPatient | TPatient[]): this;
     /**
      * Adds a section to the composition with async HTML minification
+     * @param narrative - Narrative content for the section
+     * @param sectionType - IPS section type
+     * @param validResources - Array of domain resources
+     */
+    addSectionAsync<T extends TDomainResource>(narrative: TNarrative, sectionType: IPSSections, validResources: T[]): this;
+    /**
+     * Make and adds a section to the composition with async HTML minification
      * @param sectionType - IPS section type
      * @param validResources - Array of domain resources
      * @param timezone - Optional timezone to use for date formatting
      */
-    addSectionAsync<T extends TDomainResource>(sectionType: IPSSections, validResources: T[], timezone: string | undefined): Promise<this>;
+    makeSectionAsync<T extends TDomainResource>(sectionType: IPSSections, validResources: T[], timezone: string | undefined): Promise<this>;
+    makeSectionFromSummaryAsync(sectionType: IPSSections, summaryCompositions: TComposition[], resources: TDomainResource[], timezone: string | undefined): Promise<this>;
     /**
      * Reads a FHIR Bundle and extracts resources for each section defined in IPSSections.
      * @param bundle - FHIR Bundle containing resources
      * @param timezone - Optional timezone to use for date formatting
+     * @param useSummaryCompositions - Whether to use summary compositions (default: false)
      */
-    readBundleAsync(bundle: TBundle, timezone: string | undefined): Promise<this>;
+    readBundleAsync(bundle: TBundle, timezone: string | undefined, useSummaryCompositions?: boolean): Promise<this>;
     /**
      * Builds a complete FHIR Bundle containing the Composition and all resources.
      * @param authorOrganizationId - ID of the authoring organization (e.g., hospital or clinic)
@@ -683,9 +746,10 @@ declare class NarrativeGenerator {
      * @param section - IPS section type
      * @param resources - Array of domain resources
      * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @param useSectionSummary - Whether to use section summary for narrative generation (default: false)
      * @returns Generated HTML content or undefined if no resources
      */
-    static generateNarrativeContentAsync<T extends TDomainResource>(section: IPSSections, resources: T[], timezone: string | undefined): Promise<string | undefined>;
+    static generateNarrativeContentAsync<T extends TDomainResource>(section: IPSSections, resources: T[], timezone: string | undefined, useSectionSummary?: boolean): Promise<string | undefined>;
     /**
      * Minifies HTML content asynchronously using html-minifier-terser
      * @param html - HTML content to minify
@@ -706,9 +770,10 @@ declare class NarrativeGenerator {
      * @param resources - Array of domain resources
      * @param timezone - Optional timezone to use for date formatting
      * @param minify - Whether to minify the HTML content (default: true)
+     * @param useSectionSummary - Whether to use section summary for narrative generation (default: false)
      * @returns Promise that resolves to a FHIR Narrative object or undefined if no resources
      */
-    static generateNarrativeAsync<T extends TDomainResource>(section: IPSSections, resources: T[], timezone: string | undefined, minify?: boolean): Promise<Narrative | undefined>;
+    static generateNarrativeAsync<T extends TDomainResource>(section: IPSSections, resources: T[], timezone: string | undefined, minify?: boolean, useSectionSummary?: boolean): Promise<Narrative | undefined>;
 }
 
 declare const myPackage: (taco?: string) => string;

package/dist/index.d.ts

@@ -630,6 +630,60 @@ type TBundle = {
     signature?: TSignature;
 };
 
+type TCompositionAttester = {
+    id?: string;
+    extension?: TExtension[];
+    modifierExtension?: TExtension[];
+    mode: string;
+    time?: TDateTime;
+    party?: TReference;
+};
+
+type TCompositionRelatesTo = {
+    id?: string;
+    extension?: TExtension[];
+    modifierExtension?: TExtension[];
+    code: string;
+    targetIdentifier?: TIdentifier;
+    targetReference?: TReference;
+};
+
+type TCompositionEvent = {
+    id?: string;
+    extension?: TExtension[];
+    modifierExtension?: TExtension[];
+    code?: TCodeableConcept[];
+    period?: TPeriod;
+    detail?: TReference[];
+};
+
+type TComposition = {
+    resourceType?: string;
+    id?: string;
+    meta?: TMeta;
+    implicitRules?: TUri;
+    language?: string;
+    text?: TNarrative;
+    contained?: TResourceContainer[];
+    extension?: TExtension[];
+    modifierExtension?: TExtension[];
+    identifier?: TIdentifier;
+    status: string;
+    type: TCodeableConcept;
+    category?: TCodeableConcept[];
+    subject?: TReference;
+    encounter?: TReference;
+    date: TDateTime;
+    author: TReference[];
+    title: string;
+    confidentiality?: string;
+    attester?: TCompositionAttester[];
+    custodian?: TReference;
+    relatesTo?: TCompositionRelatesTo[];
+    event?: TCompositionEvent[];
+    section?: TCompositionSection[];
+};
+
 declare class ComprehensiveIPSCompositionBuilder {
     private patients;
     private sections;
@@ -642,17 +696,26 @@ declare class ComprehensiveIPSCompositionBuilder {
     setPatient(patients: TPatient | TPatient[]): this;
     /**
      * Adds a section to the composition with async HTML minification
+     * @param narrative - Narrative content for the section
+     * @param sectionType - IPS section type
+     * @param validResources - Array of domain resources
+     */
+    addSectionAsync<T extends TDomainResource>(narrative: TNarrative, sectionType: IPSSections, validResources: T[]): this;
+    /**
+     * Make and adds a section to the composition with async HTML minification
      * @param sectionType - IPS section type
      * @param validResources - Array of domain resources
      * @param timezone - Optional timezone to use for date formatting
      */
-    addSectionAsync<T extends TDomainResource>(sectionType: IPSSections, validResources: T[], timezone: string | undefined): Promise<this>;
+    makeSectionAsync<T extends TDomainResource>(sectionType: IPSSections, validResources: T[], timezone: string | undefined): Promise<this>;
+    makeSectionFromSummaryAsync(sectionType: IPSSections, summaryCompositions: TComposition[], resources: TDomainResource[], timezone: string | undefined): Promise<this>;
     /**
      * Reads a FHIR Bundle and extracts resources for each section defined in IPSSections.
      * @param bundle - FHIR Bundle containing resources
      * @param timezone - Optional timezone to use for date formatting
+     * @param useSummaryCompositions - Whether to use summary compositions (default: false)
      */
-    readBundleAsync(bundle: TBundle, timezone: string | undefined): Promise<this>;
+    readBundleAsync(bundle: TBundle, timezone: string | undefined, useSummaryCompositions?: boolean): Promise<this>;
     /**
      * Builds a complete FHIR Bundle containing the Composition and all resources.
      * @param authorOrganizationId - ID of the authoring organization (e.g., hospital or clinic)
@@ -683,9 +746,10 @@ declare class NarrativeGenerator {
      * @param section - IPS section type
      * @param resources - Array of domain resources
      * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @param useSectionSummary - Whether to use section summary for narrative generation (default: false)
      * @returns Generated HTML content or undefined if no resources
      */
-    static generateNarrativeContentAsync<T extends TDomainResource>(section: IPSSections, resources: T[], timezone: string | undefined): Promise<string | undefined>;
+    static generateNarrativeContentAsync<T extends TDomainResource>(section: IPSSections, resources: T[], timezone: string | undefined, useSectionSummary?: boolean): Promise<string | undefined>;
     /**
      * Minifies HTML content asynchronously using html-minifier-terser
      * @param html - HTML content to minify
@@ -706,9 +770,10 @@ declare class NarrativeGenerator {
      * @param resources - Array of domain resources
      * @param timezone - Optional timezone to use for date formatting
      * @param minify - Whether to minify the HTML content (default: true)
+     * @param useSectionSummary - Whether to use section summary for narrative generation (default: false)
      * @returns Promise that resolves to a FHIR Narrative object or undefined if no resources
      */
-    static generateNarrativeAsync<T extends TDomainResource>(section: IPSSections, resources: T[], timezone: string | undefined, minify?: boolean): Promise<Narrative | undefined>;
+    static generateNarrativeAsync<T extends TDomainResource>(section: IPSSections, resources: T[], timezone: string | undefined, minify?: boolean, useSectionSummary?: boolean): Promise<Narrative | undefined>;
 }
 
 declare const myPackage: (taco?: string) => string;

package/dist/index.js

@@ -114,10 +114,17 @@ var IPSSectionResourceFilters = {
   // Only include active advance directives (Consent resources)
   ["AdvanceDirectivesSection" /* ADVANCE_DIRECTIVES */]: (resource) => resource.resourceType === "Consent" && resource.status === "active"
 };
+var IPSSectionSummaryCompositionFilter = {
+  ["AllergyIntoleranceSection" /* ALLERGIES */]: (resource) => resource.resourceType === "Composition" && resource.type?.coding?.some((c) => c.system === "https://fhir.icanbwell.com/4_0_0/CodeSystem/composition/" && c.code === "allergy_summary_document"),
+  ["VitalSignsSection" /* VITAL_SIGNS */]: (resource) => resource.resourceType === "Composition" && resource.type?.coding?.some((c) => c.system === "https://fhir.icanbwell.com/4_0_0/CodeSystem/composition/" && c.code === "vital_summary_document")
+};
 var IPSSectionResourceHelper = class {
   static getResourceFilterForSection(section) {
     return IPSSectionResourceFilters[section];
   }
+  static getSummaryCompositionFilterForSection(section) {
+    return IPSSectionSummaryCompositionFilter[section];
+  }
 };
 
 // src/narratives/templates/typescript/TemplateUtilities.ts
@@ -567,6 +574,137 @@ var TemplateUtilities = class {
     }
     return status;
   }
+  extractObservationSummaryValue(data, timezone) {
+    if (data["valueQuantity.value"] !== void 0) {
+      const value = data["valueQuantity.value"];
+      const unit = data["valueQuantity.unit"];
+      return unit ? `${value} ${unit}` : `${value}`;
+    }
+    if (data["valueCodeableConcept.text"] !== void 0) {
+      return data["valueCodeableConcept.text"];
+    }
+    if (data["valueCodeableConcept.coding.display"] !== void 0) {
+      return data["valueCodeableConcept.coding.display"];
+    }
+    if (data["valueString"] !== void 0) {
+      return data["valueString"];
+    }
+    if (data["valueBoolean"] !== void 0) {
+      return String(data["valueBoolean"]);
+    }
+    if (data["valueInteger"] !== void 0) {
+      return String(data["valueInteger"]);
+    }
+    if (data["valueDateTime"] !== void 0) {
+      return this.renderTime(data["valueDateTime"], timezone);
+    }
+    if (data["valuePeriod.start"] !== void 0 || data["valuePeriod.end"] !== void 0) {
+      const start = this.renderTime(data["valuePeriod.start"], timezone);
+      const end = this.renderTime(data["valuePeriod.end"], timezone);
+      if (start && end) {
+        return `${start} - ${end}`;
+      } else if (start) {
+        return `${start}`;
+      } else if (end) {
+        return `${end}`;
+      }
+    }
+    if (data["valueTime"] !== void 0) {
+      return this.renderTime(data["valueTime"], timezone);
+    }
+    if (data["valueSampledData.origin.value"] !== void 0 || data["valueSampledData.origin.unit"] !== void 0) {
+      const originValue = data["valueSampledData.origin.value"];
+      const originUnit = data["valueSampledData.origin.unit"];
+      let result = "";
+      if (originValue !== void 0 && originUnit !== void 0) {
+        result = `${originValue} ${originUnit}`;
+      } else if (originValue !== void 0) {
+        result = `${originValue}`;
+      } else if (originUnit !== void 0) {
+        result = `${originUnit}`;
+      }
+      const period = data["valueSampledData.period"];
+      const factor = data["valueSampledData.factor"];
+      const lowerLimit = data["valueSampledData.lowerLimit"];
+      const upperLimit = data["valueSampledData.upperLimit"];
+      const sampledData = data["valueSampledData.data"];
+      const extras = [];
+      if (period !== void 0) extras.push(`period: ${period}`);
+      if (factor !== void 0) extras.push(`factor: ${factor}`);
+      if (lowerLimit !== void 0) extras.push(`lowerLimit: ${lowerLimit}`);
+      if (upperLimit !== void 0) extras.push(`upperLimit: ${upperLimit}`);
+      if (sampledData !== void 0) extras.push(`data: ${sampledData}`);
+      if (extras.length > 0) {
+        result += ` (${extras.join(", ")})`;
+      }
+      return result;
+    }
+    if (data["valueRange.low.value"] !== void 0 || data["valueRange.high.value"] !== void 0) {
+      let referenceRange = "";
+      if (data["valueRange.low.value"] !== void 0) {
+        referenceRange += `${data["valueRange.low.value"]}`;
+        if (data["valueRange.low.unit"] !== void 0) {
+          referenceRange += ` ${data["valueRange.low.unit"]}`;
+        }
+        referenceRange = referenceRange.trim();
+        if (data["valueRange.high.value"] !== void 0) {
+          referenceRange += " - ";
+        }
+      }
+      if (data["valueRange.high.value"] !== void 0) {
+        referenceRange += `${data["valueRange.high.value"]}`;
+        if (data["valueRange.high.unit"] !== void 0) {
+          referenceRange += ` ${data["valueRange.high.unit"]}`;
+        }
+      }
+      return referenceRange.trim();
+    }
+    if (data["valueRatio.numerator.value"] !== void 0 || data["valueRatio.denominator.value"] !== void 0) {
+      let ratio = "";
+      if (data["valueRatio.numerator.value"] !== void 0) {
+        ratio += `${data["valueRatio.numerator.value"]}`;
+        if (data["valueRatio.numerator.unit"] !== void 0) {
+          ratio += ` ${data["valueRatio.numerator.unit"]}`;
+        }
+      }
+      if (data["valueRatio.denominator.value"] !== void 0) {
+        ratio += " / ";
+        ratio += `${data["valueRatio.denominator.value"]}`;
+        if (data["valueRatio.denominator.unit"] !== void 0) {
+          ratio += ` ${data["valueRatio.denominator.unit"]}`;
+        }
+      }
+      return ratio.trim();
+    }
+    return "";
+  }
+  extractObservationSummaryReferenceRange(data) {
+    let referenceRange = "";
+    if (data["referenceRange.low.value"]) {
+      referenceRange += `${data["referenceRange.low.value"]} ${data["referenceRange.low.unit"]}`;
+      referenceRange.trim();
+      if (data["referenceRange.high.value"]) {
+        referenceRange += " - ";
+      }
+    }
+    if (data["referenceRange.high.value"]) {
+      referenceRange += `${data["referenceRange.high.value"]} ${data["referenceRange.high.unit"]}`;
+    }
+    return referenceRange.trim();
+  }
+  extractObservationSummaryEffectiveTime(data, timezone) {
+    if (data["effectiveDateTime"]) {
+      return this.renderTime(data["effectiveDateTime"], timezone);
+    }
+    let effectiveTimePeriod = "";
+    if (data["effectivePeriod.start"]) {
+      effectiveTimePeriod += this.renderTime(data["effectivePeriod.start"], timezone);
+    }
+    if (data["effectivePeriod.end"]) {
+      effectiveTimePeriod += ` - ${this.renderTime(data["effectivePeriod.end"], timezone)}`;
+    }
+    return effectiveTimePeriod.trim();
+  }
   formatQuantityValue(quantity) {
     if (!quantity) return "";
     const parts = [];
@@ -1066,6 +1204,57 @@ var AllergyIntoleranceTemplate = class _AllergyIntoleranceTemplate {
   generateNarrative(resources, timezone) {
     return _AllergyIntoleranceTemplate.generateStaticNarrative(resources, timezone);
   }
+  /**
+   * Generate HTML narrative for AllergyIntolerance resources using summary
+   * @param resources - FHIR Composition resources
+   * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+   * @returns HTML string for rendering
+   */
+  generateSummaryNarrative(resources, timezone) {
+    const templateUtilities = new TemplateUtilities(resources);
+    let html = `
+      <div>
+        <table>
+          <thead>
+            <tr>
+              <th>Allergen</th>
+              <th>Criticality</th>
+              <th>Recorded Date</th>
+            </tr>
+          </thead>
+          <tbody>`;
+    for (const resourceItem of resources) {
+      for (const rowData of resourceItem.section ?? []) {
+        const data = {};
+        for (const columnData of rowData.section ?? []) {
+          switch (columnData.title) {
+            case "Allergen Name":
+              data["allergen"] = columnData.text?.div ?? "";
+              break;
+            case "Criticality":
+              data["criticality"] = columnData.text?.div ?? "";
+              break;
+            case "Recorded Date":
+              data["recordedDate"] = columnData.text?.div ?? "";
+              break;
+            default:
+              break;
+          }
+        }
+        html += `
+            <tr>
+              <td>${data["allergen"] ?? "-"}</td>
+              <td>${data["criticality"] ?? "-"}</td>
+              <td>${templateUtilities.renderTime(data["recordedDate"], timezone) ?? "-"}</td>
+            </tr>`;
+      }
+    }
+    html += `
+          </tbody>
+        </table>
+      </div>`;
+    return html;
+  }
   /**
    * Internal static implementation that actually generates the narrative
    * @param resources - FHIR resources array containing AllergyIntolerance resources
@@ -1558,6 +1747,13 @@ var ProblemListTemplate = class _ProblemListTemplate {
   }
 };
 
+// src/structures/ips_section_constants.ts
+var VITAL_SIGNS_SUMMARY_COMPONENT_MAP = {
+  "Systolic Blood Pressure": "valueRatio.numerator.value",
+  "Diastolic Blood Pressure": "valueRatio.denominator.value",
+  "Default": "valueString"
+};
+
 // src/narratives/templates/typescript/VitalSignsTemplate.ts
 var VitalSignsTemplate = class _VitalSignsTemplate {
   /**
@@ -1569,6 +1765,68 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
   generateNarrative(resources, timezone) {
     return _VitalSignsTemplate.generateStaticNarrative(resources, timezone);
   }
+  /**
+   * Generate HTML narrative for vital signs using summary
+   * @param resources - FHIR Composition resources
+   * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+   * @returns HTML string for rendering
+   */
+  generateSummaryNarrative(resources, timezone) {
+    const templateUtilities = new TemplateUtilities(resources);
+    let html = `
+      <div>
+        <table>
+          <thead>
+            <tr>
+              <th>Vital Name</th>
+              <th>Result</th>
+              <th>Reference Range</th>
+              <th>Date</th>
+            </tr>
+          </thead>
+          <tbody>`;
+    for (const resourceItem of resources) {
+      for (const rowData of resourceItem.section ?? []) {
+        const data = {};
+        for (const columnData of rowData.section ?? []) {
+          const columnTitle = columnData.title;
+          if (columnTitle) {
+            if (Object.keys(VITAL_SIGNS_SUMMARY_COMPONENT_MAP).includes(
+              columnTitle
+            )) {
+              const vitalData = {};
+              for (const component of columnData.section?.[0]?.section ?? []) {
+                if (component.title) {
+                  vitalData[component.title] = component.text?.div ?? "";
+                }
+              }
+              const vitalValue = templateUtilities.extractObservationSummaryValue(
+                vitalData,
+                timezone
+              );
+              if (vitalValue) {
+                const dataKey = VITAL_SIGNS_SUMMARY_COMPONENT_MAP[columnTitle] ?? VITAL_SIGNS_SUMMARY_COMPONENT_MAP["Default"];
+                data[dataKey] = vitalValue;
+              }
+            }
+            data[columnTitle] = columnData.text?.div ?? "";
+          }
+        }
+        html += `
+          <tr>
+            <td>${data["Vital Name"] ?? "-"}</td>
+            <td>${templateUtilities.extractObservationSummaryValue(data, timezone) ?? "-"}</td>
+            <td>${templateUtilities.extractObservationSummaryReferenceRange(data) ?? "-"}</td>
+            <td>${templateUtilities.extractObservationSummaryEffectiveTime(data, timezone) ?? "-"}</td>
+          </tr>`;
+      }
+    }
+    html += `
+          </tbody>
+        </table>
+      </div>`;
+    return html;
+  }
   /**
    * Internal static implementation that actually generates the narrative
    * @param resources - FHIR Observation resources
@@ -1587,7 +1845,7 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
       <table>
         <thead>
           <tr>
-            <th>Code</th>
+            <th>Vital Name</th>
             <th>Result</th>
             <th>Unit</th>
             <th>Interpretation</th>
@@ -2232,14 +2490,18 @@ var TypeScriptTemplateMapper = class {
    * @param section - The IPS section
    * @param resources - FHIR resources
    * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+   * @param useSectionSummary - Whether to use the section summary for narrative generation
    * @returns HTML string for rendering
    */
-  static generateNarrative(section, resources, timezone) {
+  static generateNarrative(section, resources, timezone, useSectionSummary = false) {
     const templateClass = this.sectionToTemplate[section];
     if (!templateClass) {
       throw new Error(`No template found for section: ${section}`);
     }
-    return templateClass.generateNarrative(resources, timezone);
+    return useSectionSummary ? templateClass.generateSummaryNarrative(
+      resources,
+      timezone
+    ) : templateClass.generateNarrative(resources, timezone);
   }
 };
 // Map of section types to their template classes
@@ -2295,14 +2557,15 @@ var NarrativeGenerator = class {
    * @param section - IPS section type
    * @param resources - Array of domain resources
    * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+   * @param useSectionSummary - Whether to use section summary for narrative generation (default: false)
    * @returns Generated HTML content or undefined if no resources
    */
-  static async generateNarrativeContentAsync(section, resources, timezone) {
+  static async generateNarrativeContentAsync(section, resources, timezone, useSectionSummary = false) {
     if (!resources || resources.length === 0) {
       return void 0;
     }
     try {
-      const content = TypeScriptTemplateMapper.generateNarrative(section, resources, timezone);
+      const content = TypeScriptTemplateMapper.generateNarrative(section, resources, timezone, useSectionSummary);
       if (!content) {
         return void 0;
       }
@@ -2353,10 +2616,11 @@ var NarrativeGenerator = class {
    * @param resources - Array of domain resources
    * @param timezone - Optional timezone to use for date formatting
    * @param minify - Whether to minify the HTML content (default: true)
+   * @param useSectionSummary - Whether to use section summary for narrative generation (default: false)
    * @returns Promise that resolves to a FHIR Narrative object or undefined if no resources
    */
-  static async generateNarrativeAsync(section, resources, timezone, minify = true) {
-    const content = await this.generateNarrativeContentAsync(section, resources, timezone);
+  static async generateNarrativeAsync(section, resources, timezone, minify = true, useSectionSummary = false) {
+    const content = await this.generateNarrativeContentAsync(section, resources, timezone, useSectionSummary);
     if (!content) {
       return void 0;
     }
@@ -2401,11 +2665,37 @@ var ComprehensiveIPSCompositionBuilder = class {
   }
   /**
    * Adds a section to the composition with async HTML minification
+   * @param narrative - Narrative content for the section
+   * @param sectionType - IPS section type
+   * @param validResources - Array of domain resources
+   */
+  addSectionAsync(narrative, sectionType, validResources) {
+    const sectionEntry = {
+      title: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType,
+      code: {
+        coding: [{
+          system: "http://loinc.org",
+          code: IPS_SECTION_LOINC_CODES[sectionType],
+          display: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType
+        }],
+        text: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType
+      },
+      text: narrative,
+      entry: validResources.map((resource) => ({
+        reference: `${resource.resourceType}/${resource.id}`,
+        display: resource.resourceType
+      }))
+    };
+    this.sections.push(sectionEntry);
+    return this;
+  }
+  /**
+   * Make and adds a section to the composition with async HTML minification
    * @param sectionType - IPS section type
    * @param validResources - Array of domain resources
    * @param timezone - Optional timezone to use for date formatting
    */
-  async addSectionAsync(sectionType, validResources, timezone) {
+  async makeSectionAsync(sectionType, validResources, timezone) {
     for (const resource of validResources) {
       this.resources.add(resource);
     }
@@ -2425,32 +2715,38 @@ var ComprehensiveIPSCompositionBuilder = class {
       } else {
         return this;
       }
-      const sectionEntry = {
-        title: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType,
-        code: {
-          coding: [{
-            system: "http://loinc.org",
-            code: IPS_SECTION_LOINC_CODES[sectionType],
-            display: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType
-          }],
-          text: IPS_SECTION_DISPLAY_NAMES[sectionType] || sectionType
-        },
-        text: narrative,
-        entry: validResources.map((resource) => ({
-          reference: `${resource.resourceType}/${resource.id}`,
-          display: resource.resourceType
-        }))
-      };
-      this.sections.push(sectionEntry);
+      this.addSectionAsync(narrative, sectionType, validResources);
     }
     return this;
   }
+  async makeSectionFromSummaryAsync(sectionType, summaryCompositions, resources, timezone) {
+    const sectionResources = [];
+    for (const summaryComposition of summaryCompositions) {
+      const resourceEntries = summaryComposition?.section?.flatMap((sec) => sec.entry || []) ?? [];
+      resources.forEach((resource) => {
+        if (resourceEntries?.some((entry) => entry.reference === `${resource.resourceType}/${resource.id}`)) {
+          this.resources.add(resource);
+          sectionResources.push(resource);
+        }
+      });
+    }
+    const narrative = await NarrativeGenerator.generateNarrativeAsync(
+      sectionType,
+      summaryCompositions,
+      timezone,
+      true,
+      true
+    );
+    this.addSectionAsync(narrative, sectionType, sectionResources);
+    return this;
+  }
   /**
    * Reads a FHIR Bundle and extracts resources for each section defined in IPSSections.
    * @param bundle - FHIR Bundle containing resources
    * @param timezone - Optional timezone to use for date formatting
+   * @param useSummaryCompositions - Whether to use summary compositions (default: false)
    */
-  async readBundleAsync(bundle, timezone) {
+  async readBundleAsync(bundle, timezone, useSummaryCompositions = false) {
     if (!bundle.entry) {
       return this;
     }
@@ -2472,9 +2768,15 @@ var ComprehensiveIPSCompositionBuilder = class {
       if (sectionType === "Patient" /* PATIENT */) {
         continue;
       }
-      const sectionFilter = IPSSectionResourceHelper.getResourceFilterForSection(sectionType);
-      const sectionResources = resources.filter((resource) => sectionFilter(resource));
-      await this.addSectionAsync(sectionType, sectionResources, timezone);
+      const summaryCompositionFilter = useSummaryCompositions ? IPSSectionResourceHelper.getSummaryCompositionFilterForSection(sectionType) : void 0;
+      const sectionSummary = summaryCompositionFilter ? resources.filter((resource) => summaryCompositionFilter(resource)) : [];
+      if (sectionSummary.length > 0) {
+        await this.makeSectionFromSummaryAsync(sectionType, sectionSummary, resources, timezone);
+      } else {
+        const sectionFilter = IPSSectionResourceHelper.getResourceFilterForSection(sectionType);
+        const sectionResources = resources.filter((resource) => sectionFilter(resource));
+        await this.makeSectionAsync(sectionType, sectionResources, timezone);
+      }
     }
     return this;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imranq2/fhirpatientsummary",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "description": "A template for creating npm packages using TypeScript and VSCode",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",