@imranq2/fhirpatientsummary 0.0.1

package/lib/src/generators/narrative_generator.js

@@ -0,0 +1,80 @@
+"use strict";
+// TypeScriptNarrativeGenerator.ts - TypeScript replacement for narrative_generator.ts using TypeScript templates
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NarrativeGenerator = void 0;
+const TypeScriptTemplateMapper_1 = require("../narratives/templates/typescript/TypeScriptTemplateMapper");
+/**
+ * Generates narrative content for FHIR resources using TypeScript templates
+ * Replaces the Nunjucks-based narrative generator
+ */
+class NarrativeGenerator {
+    /**
+     * Generates narrative HTML content for a section
+     * @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')
+     * @returns Generated HTML content or undefined if no resources
+     */
+    static generateNarrativeContent(section, resources, timezone) {
+        if (!resources || resources.length === 0) {
+            return undefined; // No resources to generate narrative
+        }
+        try {
+            // Create a bundle-like structure for the template
+            const bundle = {
+                resourceType: 'Bundle',
+                type: 'collection',
+                entry: resources.map(resource => ({
+                    resource
+                }))
+            };
+            // Use the TypeScript template mapper to generate HTML
+            return TypeScriptTemplateMapper_1.TypeScriptTemplateMapper.generateNarrative(section, bundle, timezone);
+        }
+        catch (error) {
+            console.error(`Error generating narrative for section ${section}:`, error);
+            return `<div class="error">Error generating narrative: ${error instanceof Error ? error.message : String(error)}</div>`;
+        }
+    }
+    /**
+     * Creates a complete FHIR Narrative object
+     * @param content - HTML content
+     * @returns FHIR Narrative object
+     */
+    static createNarrative(content) {
+        // remove extra whitespace and newlines
+        content = content.replace(/\s+/g, ' ').trim();
+        // Strip outer <div> wrappers if present
+        const divMatch = content.match(/^<div[^>]*>(.*?)<\/div>$/);
+        if (divMatch) {
+            content = divMatch[1]; // Extract inner content
+        }
+        return {
+            status: 'generated',
+            div: `<div xmlns="http://www.w3.org/1999/xhtml">${content}</div>`
+        };
+    }
+    /**
+     * Generates a complete FHIR Narrative object for a section
+     * @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')
+     * @returns FHIR Narrative object or undefined if no resources
+     */
+    static generateNarrative(section, resources, timezone) {
+        const content = this.generateNarrativeContent(section, resources, timezone);
+        if (!content) {
+            return undefined;
+        }
+        return this.createNarrative(content);
+    }
+    /**
+     * Wrap content in XHTML div with FHIR namespace
+     * @param content - HTML content to wrap
+     * @returns XHTML div string
+     */
+    static wrapInXhtml(content) {
+        return `<div xmlns="http://www.w3.org/1999/xhtml">${content}</div>`;
+    }
+}
+exports.NarrativeGenerator = NarrativeGenerator;

package/lib/src/narratives/templates/typescript/AdvanceDirectivesTemplate.d.ts

@@ -0,0 +1,22 @@
+import { TBundle } from '../../../types/resources/Bundle';
+import { ITemplate } from './interfaces/ITemplate';
+/**
+ * Class to generate HTML narrative for Advance Directives (Consent resources)
+ * This replaces the Jinja2 advancedirectives.j2 template
+ */
+export declare class AdvanceDirectivesTemplate implements ITemplate {
+    /**
+     * Generate HTML narrative for Advance Directives
+     * @param resource - FHIR Bundle containing Advance Directive resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    generateNarrative(resource: TBundle, timezone: string | undefined): string;
+    /**
+     * Internal static implementation that actually generates the narrative
+     * @param resource - FHIR Bundle containing Advance Directive resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    private static generateStaticNarrative;
+}

package/lib/src/narratives/templates/typescript/AdvanceDirectivesTemplate.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdvanceDirectivesTemplate = void 0;
+// AdvanceDirectivesTemplate.ts - TypeScript replacement for Jinja2 advancedirectives.j2
+const TemplateUtilities_1 = require("./TemplateUtilities");
+/**
+ * Class to generate HTML narrative for Advance Directives (Consent resources)
+ * This replaces the Jinja2 advancedirectives.j2 template
+ */
+class AdvanceDirectivesTemplate {
+    /**
+     * Generate HTML narrative for Advance Directives
+     * @param resource - FHIR Bundle containing Advance Directive resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    generateNarrative(resource, timezone) {
+        return AdvanceDirectivesTemplate.generateStaticNarrative(resource, timezone);
+    }
+    /**
+     * Internal static implementation that actually generates the narrative
+     * @param resource - FHIR Bundle containing Advance Directive resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static generateStaticNarrative(resource, timezone) {
+        var _a;
+        const templateUtilities = new TemplateUtilities_1.TemplateUtilities(resource);
+        // Start building the HTML table
+        let html = `
+      <h5>Advance Directives</h5>
+      <table class="hapiPropertyTable">
+        <thead>
+          <tr>
+            <th>Scope</th>
+            <th>Status</th>
+            <th>Action Controlled</th>
+            <th>Date</th>
+          </tr>
+        </thead>
+        <tbody>`;
+        // Check if we have entries in the bundle
+        if (resource.entry && Array.isArray(resource.entry)) {
+            // Loop through entries in the bundle
+            for (const entry of resource.entry) {
+                const consent = entry.resource;
+                // Skip Composition resources
+                if (consent.resourceType === 'Composition') {
+                    continue;
+                }
+                // Use the enhanced narrativeLinkId utility function to extract the ID
+                // Add a table row for this consent
+                html += `
+          <tr id="${(templateUtilities.narrativeLinkId(consent))}">
+            <td>${templateUtilities.codeableConcept(consent.scope, 'display')}</td>
+            <td>${consent.status || ''}</td>
+            <td>${((_a = consent.provision) === null || _a === void 0 ? void 0 : _a.action) ? templateUtilities.concatCodeableConcept(consent.provision.action) : ''}</td>
+            <td>${consent.dateTime || ''}</td>
+          </tr>`;
+            }
+        }
+        // Close the HTML table
+        html += `
+        </tbody>
+      </table>`;
+        return html;
+    }
+}
+exports.AdvanceDirectivesTemplate = AdvanceDirectivesTemplate;

package/lib/src/narratives/templates/typescript/AllergyIntoleranceTemplate.d.ts

@@ -0,0 +1,31 @@
+import { TBundle } from '../../../types/resources/Bundle';
+import { ITemplate } from './interfaces/ITemplate';
+/**
+ * Class to generate HTML narrative for AllergyIntolerance resources
+ * This replaces the Jinja2 allergyintolerance.j2 template
+ */
+export declare class AllergyIntoleranceTemplate implements ITemplate {
+    /**
+     * Generate HTML narrative for AllergyIntolerance resources
+     * @param resource - FHIR Bundle containing AllergyIntolerance resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    generateNarrative(resource: TBundle, timezone: string | undefined): string;
+    /**
+     * Internal static implementation that actually generates the narrative
+     * @param resource - FHIR Bundle containing AllergyIntolerance resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    private static generateStaticNarrative;
+    /**
+     * Helper method to generate HTML table rows for allergies
+     * @param allergies - Array of allergy resources to process
+     * @param templateUtilities - Utilities for formatting
+     * @param includeResolved - Whether to include resolved date column
+     * @param timezone - Optional timezone to use for date formatting
+     * @returns HTML string with table rows
+     */
+    private static generateAllergyRows;
+}

package/lib/src/narratives/templates/typescript/AllergyIntoleranceTemplate.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AllergyIntoleranceTemplate = void 0;
+// AllergyIntoleranceTemplate.ts - TypeScript replacement for Jinja2 allergyintolerance.j2
+const TemplateUtilities_1 = require("./TemplateUtilities");
+/**
+ * Class to generate HTML narrative for AllergyIntolerance resources
+ * This replaces the Jinja2 allergyintolerance.j2 template
+ */
+class AllergyIntoleranceTemplate {
+    /**
+     * Generate HTML narrative for AllergyIntolerance resources
+     * @param resource - FHIR Bundle containing AllergyIntolerance resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    generateNarrative(resource, timezone) {
+        return AllergyIntoleranceTemplate.generateStaticNarrative(resource, timezone);
+    }
+    /**
+     * Internal static implementation that actually generates the narrative
+     * @param resource - FHIR Bundle containing AllergyIntolerance resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    static generateStaticNarrative(resource, timezone) {
+        var _a, _b, _c;
+        const templateUtilities = new TemplateUtilities_1.TemplateUtilities(resource);
+        // Group allergies by status (active vs resolved/inactive)
+        const activeAllergies = [];
+        const resolvedAllergies = [];
+        if (resource.entry && Array.isArray(resource.entry)) {
+            for (const entry of resource.entry) {
+                const allergy = entry.resource;
+                // Check clinical status to determine if active or resolved
+                const status = ((_c = (_b = (_a = allergy.clinicalStatus) === null || _a === void 0 ? void 0 : _a.coding) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.code) || '';
+                if (status === 'inactive' || status === 'resolved') {
+                    resolvedAllergies.push(allergy);
+                }
+                else {
+                    activeAllergies.push(allergy);
+                }
+            }
+        }
+        // Start building the HTML with proper XHTML namespace
+        let html = `<div xmlns="http://www.w3.org/1999/xhtml">`;
+        // Active Allergies section
+        html += `
+      <div class="ActiveAllergies">
+        <h3>Active Allergies and Intolerances</h3>
+        <table class="ActiveAllergyTable">
+          <thead>
+            <tr>
+              <th>Allergen</th>
+              <th>Status</th>
+              <th>Category</th>
+              <th>Reaction</th>
+              <th>Severity</th>
+              <th>Onset Date</th>
+              <th>Comments</th>
+            </tr>
+          </thead>
+          <tbody>`;
+        // Process active allergies
+        if (activeAllergies.length > 0) {
+            html += this.generateAllergyRows(activeAllergies, templateUtilities, timezone);
+        }
+        else {
+            html += `
+          <tr>
+            <td colspan="7">No active allergies recorded</td>
+          </tr>`;
+        }
+        // Close the active allergies table
+        html += `
+          </tbody>
+        </table>
+      </div>`;
+        // Resolved Allergies section
+        html += `
+      <div class="ResolvedAllergies">
+        <h3>Resolved Allergies and Intolerances</h3>
+        <table class="ResolvedAllergyTable">
+          <thead>
+            <tr>
+              <th>Allergen</th>
+              <th>Status</th>
+              <th>Category</th>
+              <th>Reaction</th>
+              <th>Severity</th>
+              <th>Onset Date</th>
+              <th>Comments</th>
+              <th>Resolved Date</th>
+            </tr>
+          </thead>
+          <tbody>`;
+        // Process resolved allergies
+        if (resolvedAllergies.length > 0) {
+            html += this.generateAllergyRows(resolvedAllergies, templateUtilities, timezone, true);
+        }
+        else {
+            html += `
+          <tr>
+            <td colspan="8">No resolved allergies recorded</td>
+          </tr>`;
+        }
+        // Close the resolved allergies table
+        html += `
+          </tbody>
+        </table>
+      </div>
+    </div>`;
+        return html;
+    }
+    /**
+     * Helper method to generate HTML table rows for allergies
+     * @param allergies - Array of allergy resources to process
+     * @param templateUtilities - Utilities for formatting
+     * @param includeResolved - Whether to include resolved date column
+     * @param timezone - Optional timezone to use for date formatting
+     * @returns HTML string with table rows
+     */
+    static generateAllergyRows(allergies, templateUtilities, timezone, includeResolved = false) {
+        let html = '';
+        for (const allergy of allergies) {
+            // Find the narrative link extension if it exists
+            // Add a table row for this allergy with appropriate classes
+            html += `
+        <tr id="${(templateUtilities.narrativeLinkId(allergy.extension))}">
+          <td class="Name"><span class="AllergenName">${templateUtilities.codeableConcept(allergy.code)}</span></td>
+          <td class="Status">${templateUtilities.codeableConcept(allergy.clinicalStatus) || '-'}</td>
+          <td class="Category">${templateUtilities.safeConcat(allergy.category, 'value') || '-'}</td>
+          <td class="Reaction">${templateUtilities.concatReactionManifestation(allergy.reaction) || '-'}</td>
+          <td class="Severity">${templateUtilities.safeConcat(allergy.reaction, 'severity') || '-'}</td>
+          <td class="OnsetDate">${templateUtilities.renderTime(allergy.onsetDateTime, timezone) || '-'}</td>
+          <td class="Comments">${templateUtilities.renderNotes(allergy.note, timezone, { styled: true, warning: true })}</td>`;
+            // Add resolved date column for resolved allergies
+            if (includeResolved) {
+                // Try to find end date from extension or use '-' if not found
+                let endDate = '-';
+                if (allergy.extension && Array.isArray(allergy.extension)) {
+                    const endDateExt = allergy.extension.find(ext => ext.url === 'http://hl7.org/fhir/StructureDefinition/allergyintolerance-resolutionDate');
+                    if (endDateExt && endDateExt.valueDateTime) {
+                        endDate = templateUtilities.renderDate(endDateExt.valueDateTime);
+                    }
+                }
+                html += `
+          <td class="ResolvedDate">${endDate}</td>`;
+            }
+            html += `</tr>`;
+        }
+        return html;
+    }
+}
+exports.AllergyIntoleranceTemplate = AllergyIntoleranceTemplate;

package/lib/src/narratives/templates/typescript/ClinicalImpressionTemplate.d.ts

@@ -0,0 +1,15 @@
+import { TBundle } from '../../../types/resources/Bundle';
+import { ITemplate } from './interfaces/ITemplate';
+/**
+ * Class to generate HTML narrative for Clinical Impression resources
+ * This generates narrative for the Clinical Impression section of the IPS
+ */
+export declare class ClinicalImpressionTemplate implements ITemplate {
+    /**
+     * Generate HTML narrative for Clinical Impressions
+     * @param resource - FHIR Bundle containing ClinicalImpression resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    generateNarrative(resource: TBundle, timezone: string | undefined): string;
+}

package/lib/src/narratives/templates/typescript/ClinicalImpressionTemplate.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClinicalImpressionTemplate = void 0;
+// ClinicalImpressionTemplate.ts - TypeScript template for Clinical Impression section
+const TemplateUtilities_1 = require("./TemplateUtilities");
+/**
+ * Class to generate HTML narrative for Clinical Impression resources
+ * This generates narrative for the Clinical Impression section of the IPS
+ */
+class ClinicalImpressionTemplate {
+    /**
+     * Generate HTML narrative for Clinical Impressions
+     * @param resource - FHIR Bundle containing ClinicalImpression resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    generateNarrative(resource, timezone) {
+        const templateUtilities = new TemplateUtilities_1.TemplateUtilities(resource);
+        // Start building the HTML table
+        let html = `
+      <h5>Clinical Impressions</h5>
+      <table class="hapiPropertyTable">
+        <thead>
+          <tr>
+            <th>Date</th>
+            <th>Status</th>
+            <th>Description</th>
+            <th>Summary</th>
+            <th>Findings</th>
+            <th>Notes</th>
+          </tr>
+        </thead>
+        <tbody>`;
+        // Check if we have entries in the bundle
+        if (resource.entry && Array.isArray(resource.entry)) {
+            let hasClinicalImpressions = false;
+            // Loop through entries in the bundle
+            for (const entry of resource.entry) {
+                const res = entry.resource;
+                // Skip non-ClinicalImpression resources
+                if (!res || res.resourceType !== 'ClinicalImpression') {
+                    continue;
+                }
+                hasClinicalImpressions = true;
+                const impression = res;
+                // Format date (could be effectiveDateTime, effectivePeriod, or date)
+                let formattedDate = '';
+                if (impression.effectiveDateTime) {
+                    formattedDate = templateUtilities.renderTime(impression.effectiveDateTime, timezone);
+                }
+                else if (impression.effectivePeriod) {
+                    formattedDate = templateUtilities.renderPeriod(impression.effectivePeriod, timezone);
+                }
+                else if (impression.date) {
+                    formattedDate = templateUtilities.renderDate(impression.date);
+                }
+                // Format status
+                const status = impression.status || '';
+                // Description and summary
+                const description = impression.description || '';
+                const summary = impression.summary || '';
+                // Format findings
+                let findingsHtml = '';
+                if (impression.finding && impression.finding.length > 0) {
+                    findingsHtml = '<ul>';
+                    for (const finding of impression.finding) {
+                        // Each finding has an itemCodeableConcept and/or itemReference
+                        const findingText = finding.itemCodeableConcept
+                            ? templateUtilities.codeableConcept(finding.itemCodeableConcept, 'display')
+                            : (finding.itemReference
+                                ? templateUtilities.renderReference(finding.itemReference)
+                                : '');
+                        // Add cause if present
+                        const cause = finding.basis || '';
+                        findingsHtml += `<li>${findingText}${cause ? ` - ${cause}` : ''}</li>`;
+                    }
+                    findingsHtml += '</ul>';
+                }
+                // Format notes
+                const notes = templateUtilities.renderNotes(impression.note, timezone);
+                html += `
+          <tr id="${templateUtilities.narrativeLinkId(impression)}">
+            <td>${formattedDate}</td>
+            <td>${status}</td>
+            <td>${description}</td>
+            <td>${summary}</td>
+            <td>${findingsHtml}</td>
+            <td>${notes}</td>
+          </tr>`;
+            }
+            // If no clinical impression entries were found
+            if (!hasClinicalImpressions) {
+                html += `
+          <tr>
+            <td colspan="6">No clinical impressions recorded</td>
+          </tr>`;
+            }
+        }
+        else {
+            html += `
+          <tr>
+            <td colspan="6">No clinical impressions recorded</td>
+          </tr>`;
+        }
+        html += `
+        </tbody>
+      </table>`;
+        return html;
+    }
+}
+exports.ClinicalImpressionTemplate = ClinicalImpressionTemplate;

package/lib/src/narratives/templates/typescript/DiagnosticResultsTemplate.d.ts

@@ -0,0 +1,50 @@
+import { TBundle } from '../../../types/resources/Bundle';
+import { ITemplate } from './interfaces/ITemplate';
+/**
+ * Class to generate HTML narrative for Diagnostic Results (Observation resources)
+ * This replaces the Jinja2 diagnosticresults.j2 template
+ */
+export declare class DiagnosticResultsTemplate implements ITemplate {
+    /**
+     * Generate HTML narrative for Diagnostic Results
+     * @param resource - FHIR Bundle containing Observation and DiagnosticReport resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    generateNarrative(resource: TBundle, timezone: string | undefined): string;
+    /**
+     * Internal static implementation that actually generates the narrative
+     * @param resource - FHIR Bundle containing Observation and DiagnosticReport resources
+     * @param timezone - Optional timezone to use for date formatting (e.g., 'America/New_York', 'Europe/London')
+     * @returns HTML string for rendering
+     */
+    private static generateStaticNarrative;
+    /**
+     * Extract Observation resources from the bundle
+     * @param resource - FHIR Bundle
+     * @returns Array of Observation resources
+     */
+    private static getObservations;
+    /**
+     * Extract DiagnosticReport resources from the bundle
+     * @param resource - FHIR Bundle
+     * @returns Array of DiagnosticReport resources
+     */
+    private static getDiagnosticReports;
+    /**
+     * Render HTML table for Observation resources
+     * @param templateUtilities - Instance of TemplateUtilities for utility functions
+     * @param observations - Array of Observation resources
+     * @param timezone - Optional timezone to use for date formatting
+     * @returns HTML string for rendering
+     */
+    private static renderObservations;
+    /**
+     * Render HTML table for DiagnosticReport resources
+     * @param templateUtilities - Instance of TemplateUtilities for utility functions
+     * @param reports - Array of DiagnosticReport resources
+     * @param timezone - Optional timezone to use for date formatting
+     * @returns HTML string for rendering
+     */
+    private static renderDiagnosticReports;
+}