@measurequick/measurequick-report-generator 1.5.207 → 1.5.215

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@measurequick/measurequick-report-generator",
-  "version": "1.5.207",
+  "version": "1.5.215",
   "description": "Generates PDF documents for various measureQuick applications.",
   "main": "index.js",
   "scripts": {

package/report-gen-scripts/full-report.js

@@ -15,6 +15,7 @@ import * as vitalsHeatpumpHeatingReport from "./vitals-heatpump-heating-report.j
 import * as nciReport from "./nci-report.js";
 import * as energyStarCertificate from "./energy-star-certificate.js";
 import * as accaCertificate from "./acca-certificate.js";
+import * as notesSummaryPage from "./notes-summary-page.js";
 import * as util from "../util.js";
 
 let docs = [];
@@ -487,6 +488,13 @@ export async function getReport(payload) {
     errors.push(`System Info: ${error}`);
   }
 
+  /******** AI SUMMARY / NOTES (1+ PAGES) *********/
+  try {
+    await notesSummaryPage.addNotesSummaryPages(coreDoc, payload);
+  } catch (error) {
+    errors.push(`AI Summary: ${error}`);
+  }
+
   return errors.length > 0
     ? { status: 400, data: errors.join("\n") }
     : { status: 200, data: await coreDoc.saveAsBase64({ dataUri: true }) };

package/report-gen-scripts/measurement-details.js

@@ -10,7 +10,7 @@ let embeddedIconsTestOut = {};
 function isNCIProject(payload) {
   if (payload && payload.project && payload.project.specialProjectType) {
     const type = payload.project.specialProjectType;
-    return type === 'CoolMaxx' || type === 'HeatMaxx';
+    return type === "CoolMaxx" || type === "HeatMaxx";
   }
   return false;
 }
@@ -203,8 +203,12 @@ export async function getReport(payload) {
     // For NCI projects (CoolMaxx/HeatMaxx), draw NCI logo in place of profile picture (15% larger)
     let isNCI = isNCIProject(payload) && base64.nciLogo;
     if (isNCI) {
-      const nciLogoImagePg1 = await pdfDocPg1.embedPng(util._base64ToArrayBuffer(base64.nciLogo));
-      const nciLogoImagePg2 = await pdfDocPg2.embedPng(util._base64ToArrayBuffer(base64.nciLogo));
+      const nciLogoImagePg1 = await pdfDocPg1.embedPng(
+        util._base64ToArrayBuffer(base64.nciLogo)
+      );
+      const nciLogoImagePg2 = await pdfDocPg2.embedPng(
+        util._base64ToArrayBuffer(base64.nciLogo)
+      );
       const pagesPg1 = pdfDocPg1.getPages();
       const pagesPg2 = pdfDocPg2.getPages();
       const firstPagePg1 = pagesPg1[0];
@@ -218,11 +222,13 @@ export async function getReport(payload) {
       const rectPg2 = widgetsPg2[0].getRectangle();
       // Draw NCI logo at the profile picture position, 15% larger
       const logoWidth1 = rectPg1.width * 1.15;
-      const logoHeight1 = logoWidth1 * (nciLogoImagePg1.height / nciLogoImagePg1.width);
+      const logoHeight1 =
+        logoWidth1 * (nciLogoImagePg1.height / nciLogoImagePg1.width);
       const x1 = rectPg1.x + (rectPg1.width - logoWidth1) / 2;
       const y1 = rectPg1.y + (rectPg1.height - logoHeight1) / 2;
       const logoWidth2 = rectPg2.width * 1.15;
-      const logoHeight2 = logoWidth2 * (nciLogoImagePg2.height / nciLogoImagePg2.width);
+      const logoHeight2 =
+        logoWidth2 * (nciLogoImagePg2.height / nciLogoImagePg2.width);
       const x2 = rectPg2.x + (rectPg2.width - logoWidth2) / 2;
       const y2 = rectPg2.y + (rectPg2.height - logoHeight2) / 2;
       firstPagePg1.drawImage(nciLogoImagePg1, {
@@ -283,7 +289,8 @@ export async function getReport(payload) {
       let test = payload.tests[t].testInfo;
       // Add source property to test object for tool icon lookup
       // Source is stored in testInfo.source, not at the test root level
-      test.source = payload.tests[t].testInfo.source || payload.tests[t].source || {};
+      test.source =
+        payload.tests[t].testInfo.source || payload.tests[t].source || {};
       form.getTextField("Header").setText(`${sectionLabel}Measurement Details`);
 
       if (payload.meta.cName)
@@ -500,9 +507,12 @@ export async function getReport(payload) {
 
             // Use derated value if available for gas_input_rated
             // Also check for empty string - middleman passes "" when it expects lookup from test.data
-            let val = measurement.value !== null && measurement.value !== undefined && measurement.value !== ""
-              ? measurement.value
-              : +test.data[measurement.ref];
+            let val =
+              measurement.value !== null &&
+              measurement.value !== undefined &&
+              measurement.value !== ""
+                ? measurement.value
+                : +test.data[measurement.ref];
             if (
               measurement.ref == "gas_input_rated" &&
               payload.equipment.gas_input_derated
@@ -518,7 +528,10 @@ export async function getReport(payload) {
 
             // For CO measurements: if value is null/undefined, show "--"; if valid, show as integer (no decimals)
             if (isCOMeasurement) {
-              if (measurement.value === null || measurement.value === undefined) {
+              if (
+                measurement.value === null ||
+                measurement.value === undefined
+              ) {
                 val = "--";
               } else {
                 val = Math.round(Number(val)).toString();

package/report-gen-scripts/vitals-cooling-report.js

@@ -5,6 +5,20 @@ import * as systemInfoPage from "./system-info-page.js";
 import * as util from "../util.js";
 import * as notesSummaryPage from "./notes-summary-page.js";
 
+// Helper to safely set text field (ignores if field doesn't exist)
+function safeSetText(form, name, value) {
+  try {
+    form.getTextField(name).setText(value != null ? String(value) : "");
+  } catch (e) {}
+}
+
+// Helper to safely set image on button (ignores if field doesn't exist)
+function safeSetImage(form, name, image) {
+  try {
+    form.getButton(name).setImage(image);
+  } catch (e) {}
+}
+
 // Check if project is CoolMaxx or HeatMaxx (NCI branded)
 function isNCIProject(payload) {
   if (payload && payload.project && payload.project.specialProjectType) {
@@ -230,6 +244,19 @@ export async function getReport(payload, _test) {
         .setText(date.toLocaleTimeString("en-US"));
     }
 
+    // Build equipment info and set "Information Text" field with shortened description
+    const equipment = payload.equipment || {};
+    let equipmentLines = [];
+    if (equipment.condenser_make) equipmentLines.push("Make: " + equipment.condenser_make);
+    if (equipment.condenser_model) equipmentLines.push("Model: " + equipment.condenser_model);
+    if (equipment.condenser_serial) equipmentLines.push("Serial: " + equipment.condenser_serial);
+
+    let infoText = "What Are Your System Vitals?\nYour system vitals show the overall health of your HVAC system. These vitals account for both the refrigerant and air delivery of the system.";
+    if (equipmentLines.length > 0) {
+      infoText = equipmentLines.join("\n") + "\n\n" + infoText;
+    }
+    safeSetText(form, "Information Text", infoText);
+
     let systemScorePercentage = t.data.vitals_score
       ? +t.data.vitals_score.toFixed(0)
       : 0;
@@ -294,6 +321,42 @@ export async function getReport(payload, _test) {
       .getTextField("YourSystemScorePage2")
       .setText(`${systemScorePercentage} ${systemScoreGrade}`);
 
+    // Display system age (condenser year installed)
+    const currentYear = new Date().getUTCFullYear();
+    const rawYear = payload.equipment && payload.equipment.year_installed;
+    const installYear = rawYear !== undefined && rawYear !== null ? Number(rawYear) : NaN;
+    const hasValidYear = Number.isFinite(installYear) && installYear > 1900 && installYear <= currentYear;
+
+    if (hasValidYear) {
+      const age = currentYear - installYear;
+      let specialCasePlacement = "1";
+      let specialCaseIcon = iconRangeGreen;
+
+      if (age < 2) specialCasePlacement = "1";
+      else if (age < 5) specialCasePlacement = "2";
+      else if (age < 8) specialCasePlacement = "3";
+      else if (age < 15) {
+        specialCasePlacement = "4";
+        specialCaseIcon = iconRangeRed;
+      } else if (age < 20) {
+        specialCasePlacement = "5";
+        specialCaseIcon = iconRangeRed;
+      } else if (age < 25) {
+        specialCasePlacement = "6";
+        specialCaseIcon = iconRangeRed;
+      } else {
+        specialCasePlacement = "7";
+        specialCaseIcon = iconRangeRed;
+      }
+
+      // Set age marker and text if fields exist
+      safeSetImage(form, `ImageAge${specialCasePlacement}`, specialCaseIcon);
+      safeSetText(form, "Age", age.toString());
+    } else {
+      // Age unknown - set to "--" if field exists
+      safeSetText(form, "Age", "--");
+    }
+
     // print targets and range icons
     const measureLabels = [
       "Superheat",

package/report-gen-scripts/vitals-heatpump-heating-report.js

@@ -4,6 +4,20 @@ import * as pdf from "../base-64/mq-vitals-heatpump-heating.js";
 import * as util from "../util.js";
 import * as notesSummaryPage from "./notes-summary-page.js";
 
+// Helper to safely set text field (ignores if field doesn't exist)
+function safeSetText(form, name, value) {
+  try {
+    form.getTextField(name).setText(value != null ? String(value) : "");
+  } catch (e) {}
+}
+
+// Helper to safely set image on button (ignores if field doesn't exist)
+function safeSetImage(form, name, image) {
+  try {
+    form.getButton(name).setImage(image);
+  } catch (e) {}
+}
+
 // Check if project is CoolMaxx or HeatMaxx (NCI branded)
 function isNCIProject(payload) {
   if (payload && payload.project && payload.project.specialProjectType) {
@@ -170,6 +184,19 @@ export async function getReport(payload, _test) {
       form.getTextField("TimeOfServiceUpper").setText(date.toLocaleTimeString("en-US"));
     }
 
+    // Build equipment info and set "Information Text" field with shortened description
+    const equipment = payload.equipment || {};
+    let equipmentLines = [];
+    if (equipment.condenser_make) equipmentLines.push("Make: " + equipment.condenser_make);
+    if (equipment.condenser_model) equipmentLines.push("Model: " + equipment.condenser_model);
+    if (equipment.condenser_serial) equipmentLines.push("Serial: " + equipment.condenser_serial);
+
+    let infoText = "What Are Your System Vitals?\nYour system vitals show the overall health of your HVAC system. These vitals account for both the refrigerant and air delivery of the system.";
+    if (equipmentLines.length > 0) {
+      infoText = equipmentLines.join("\n") + "\n\n" + infoText;
+    }
+    safeSetText(form, "Information Text", infoText);
+
     // System score
     let systemScorePercentage = t.data.vitals_score ? +t.data.vitals_score.toFixed(0) : 0;
     let systemScoreGrade = util.getGradeFromScore(systemScorePercentage);
@@ -223,6 +250,42 @@ export async function getReport(payload, _test) {
 
     form.getTextField("YourSystemScorePage2").setText(`${systemScorePercentage} ${systemScoreGrade}`);
 
+    // Display system age (condenser year installed - heat pump outdoor unit)
+    const currentYear = new Date().getUTCFullYear();
+    const rawYear = payload.equipment && payload.equipment.year_installed;
+    const installYear = rawYear !== undefined && rawYear !== null ? Number(rawYear) : NaN;
+    const hasValidYear = Number.isFinite(installYear) && installYear > 1900 && installYear <= currentYear;
+
+    if (hasValidYear) {
+      const age = currentYear - installYear;
+      let specialCasePlacement = "1";
+      let specialCaseIcon = iconRangeGreen;
+
+      if (age < 2) specialCasePlacement = "1";
+      else if (age < 5) specialCasePlacement = "2";
+      else if (age < 8) specialCasePlacement = "3";
+      else if (age < 15) {
+        specialCasePlacement = "4";
+        specialCaseIcon = iconRangeRed;
+      } else if (age < 20) {
+        specialCasePlacement = "5";
+        specialCaseIcon = iconRangeRed;
+      } else if (age < 25) {
+        specialCasePlacement = "6";
+        specialCaseIcon = iconRangeRed;
+      } else {
+        specialCasePlacement = "7";
+        specialCaseIcon = iconRangeRed;
+      }
+
+      // Set age marker and text if fields exist
+      safeSetImage(form, `ImageAge${specialCasePlacement}`, specialCaseIcon);
+      safeSetText(form, "Age", age.toString());
+    } else {
+      // Age unknown - set to "--" if field exists
+      safeSetText(form, "Age", "--");
+    }
+
     // Print targets and range icons for heat pump heating
     // Heat pump heating target zones - some are in data, some in targets
     const measureLabels = ["Superheat", "Subcooling", "Condenser", "TempSplit", "Tesp", "FilterFace"];

package/util.js

@@ -218,6 +218,7 @@ export function getToolIcon(test, ref, embeddedIcons) {
         toolIcon = embeddedIcons.iconBluflame;
         break;
       case "iDVM510":
+      case "iDVM-510":
         toolIcon = embeddedIcons.iconRedfish510;
         break;
       case "iDVM550":
@@ -250,7 +251,7 @@ export function getToolIcon(test, ref, embeddedIcons) {
         break;
     }
   }
-  if (sourceValue == "iDVM510" && ref.includes("amperage"))
+  if ((sourceValue == "iDVM510" || sourceValue == "iDVM-510") && ref.includes("amperage"))
     toolIcon = embeddedIcons.iconRedfish510333;
   return toolIcon;
 }
@@ -293,99 +294,121 @@ export function getElectricalData(test, suffix, embeddedIcons) {
     if (phase === "Single") {
       if (
         (voltage == "115" || voltage == "120") &&
-        test.data[`voltage_l1`] &&
-        test.data[`amperage_l1`]
+        test.data[`voltage_l1${suffix}`] &&
+        test.data[`amperage_l1${suffix}`]
       ) {
-        vDisplay = (+test.data[`voltage_l1`]).toFixed(1);
-        aDisplay = (+test.data[`amperage_l1`]).toFixed(1);
+        vDisplay = (+test.data[`voltage_l1${suffix}`]).toFixed(1);
+        aDisplay = (+test.data[`amperage_l1${suffix}`]).toFixed(1);
       } else if (
         (voltage == "115" || voltage == "120") &&
-        test.data[`voltage_l1_ph_to_gnd`] &&
-        test.data[`amperage_l1_ph_to_gnd`]
+        test.data[`voltage_l1${suffix}_ph_to_gnd`] &&
+        test.data[`amperage_l1${suffix}_ph_to_gnd`]
       ) {
-        vDisplay = (+test.data[`voltage_l1_ph_to_gnd`]).toFixed(1);
-        aDisplay = (+test.data[`amperage_l1_ph_to_gnd`]).toFixed(1);
-        src = "_l1_ph_to_gnd";
+        vDisplay = (+test.data[`voltage_l1${suffix}_ph_to_gnd`]).toFixed(1);
+        aDisplay = (+test.data[`amperage_l1${suffix}_ph_to_gnd`]).toFixed(1);
+        src = `_l1${suffix}_ph_to_gnd`;
       } else if (
         (voltage == "208" ||
           voltage == "230" ||
           voltage == "240" ||
           voltage == "460" ||
           voltage == "480") &&
-        test.data[`voltage_l1`] &&
-        test.data[`amperage_l1`]
+        test.data[`voltage_l1${suffix}`] &&
+        test.data[`amperage_l1${suffix}`]
       ) {
-        vDisplay = (+test.data[`voltage_l1`]).toFixed(1);
-        aDisplay = (+test.data[`amperage_l1`]).toFixed(1);
+        vDisplay = (+test.data[`voltage_l1${suffix}`]).toFixed(1);
+        aDisplay = (+test.data[`amperage_l1${suffix}`]).toFixed(1);
       } else if (
         (voltage == "208" ||
           voltage == "230" ||
           voltage == "240" ||
           voltage == "460" ||
           voltage == "480") &&
-        test.data[`voltage_l1_ph_to_gnd`] &&
-        test.data[`voltage_l2_ph_to_gnd`] &&
-        test.data[`amperage_l1_ph_to_gnd`] &&
-        test.data[`amperage_l2_ph_to_gnd`]
+        test.data[`voltage_l1${suffix}_ph_to_gnd`] &&
+        test.data[`voltage_l2${suffix}_ph_to_gnd`] &&
+        test.data[`amperage_l1${suffix}_ph_to_gnd`] &&
+        test.data[`amperage_l2${suffix}_ph_to_gnd`]
       ) {
         vDisplay =
-          (+test.data[`voltage_l1_ph_to_gnd`]).toFixed(1) +
+          (+test.data[`voltage_l1${suffix}_ph_to_gnd`]).toFixed(1) +
           " / " +
-          (+test.data[`voltage_l2_ph_to_gnd`]).toFixed(1);
+          (+test.data[`voltage_l2${suffix}_ph_to_gnd`]).toFixed(1);
         aDisplay =
-          (+test.data[`amperage_l1_ph_to_gnd`]).toFixed(1) +
+          (+test.data[`amperage_l1${suffix}_ph_to_gnd`]).toFixed(1) +
           " / " +
-          (+test.data[`amperage_l2_ph_to_gnd`]).toFixed(1);
-        src = "_l1_ph_to_gnd";
+          (+test.data[`amperage_l2${suffix}_ph_to_gnd`]).toFixed(1);
+        src = `_l1${suffix}_ph_to_gnd`;
       }
     } else if (
       phase === "Three" &&
-      test.data[`voltage_l1`] &&
-      test.data.voltage_l2 &&
-      test.data[`voltage_l3`] &&
-      test.data[`amperage_l1`] &&
-      test.data.amperage_l2 &&
-      test.data[`amperage_l3`]
+      test.data[`voltage_l1${suffix}`] &&
+      test.data[`voltage_l2${suffix}`] &&
+      test.data[`voltage_l3${suffix}`] &&
+      test.data[`amperage_l1${suffix}`] &&
+      test.data[`amperage_l2${suffix}`] &&
+      test.data[`amperage_l3${suffix}`]
     ) {
       vDisplay =
-        (+test.data[`voltage_l1`]).toFixed(1) +
+        (+test.data[`voltage_l1${suffix}`]).toFixed(1) +
         " / " +
-        (+test.data[`voltage_l2`]).toFixed(1) +
+        (+test.data[`voltage_l2${suffix}`]).toFixed(1) +
         " / " +
-        (+test.data[`voltage_l3`]).toFixed(1);
+        (+test.data[`voltage_l3${suffix}`]).toFixed(1);
       aDisplay =
-        (+test.data[`amperage_l1`]).toFixed(1) +
+        (+test.data[`amperage_l1${suffix}`]).toFixed(1) +
         " / " +
-        (+test.data[`amperage_l2`]).toFixed(1) +
+        (+test.data[`amperage_l2${suffix}`]).toFixed(1) +
         " / " +
-        (+test.data[`amperage_l3`]).toFixed(1);
+        (+test.data[`amperage_l3${suffix}`]).toFixed(1);
     }
   } else if (test.electrical_capture_type === "Power") {
     vDisplay = (+test.data[`voltage_l1`]).toFixed(1);
     aDisplay = (+test.data[`amperage_l1`]).toFixed(1);
   }
+  // Build the source key with suffix for AHU support
+  // Note: for ph_to_gnd cases, src already includes the suffix, so don't add it again
+  const suffixAlreadyInSrc = src.includes(suffix) && suffix !== "";
+  const vSourceKey = suffixAlreadyInSrc ? "voltage" + src : "voltage" + src + suffix;
+  const aSourceKey = suffixAlreadyInSrc ? "amperage" + src : "amperage" + src + suffix;
+
+  // Build fallback source keys for multimeter sources (used when L1/L2/L3 sources aren't set)
+  // For condenser (suffix=""), check voltage_multimeter_condenser then voltage_multimeter
+  // For AHU (suffix="_ahu"), check voltage_multimeter_ahu then voltage_multimeter
+  const vMultimeterKey = suffix === "_ahu" ? "voltage_multimeter_ahu" : "voltage_multimeter_condenser";
+  const aMultimeterKey = suffix === "_ahu" ? "amperage_multimeter_ahu" : "amperage_multimeter_condenser";
+
+  // Get voltage source with fallback chain
+  let vSource = test.source[vSourceKey];
+  if (!vSource) vSource = test.source[vMultimeterKey];
+  if (!vSource) vSource = test.source["voltage_multimeter"];
+
+  // Get amperage source with fallback chain
+  let aSource = test.source[aSourceKey];
+  if (!aSource) aSource = test.source[aMultimeterKey];
+  if (!aSource) aSource = test.source["amperage_multimeter"];
+
   if (vDisplay) {
-    if (test.source["voltage" + src] == "ComfortGuard")
+    if (vSource == "ComfortGuard")
       vIcon = embeddedIcons.iconSensi;
-    else if (test.source["voltage" + src] == "iDVM550" || test.source["voltage" + src] == "iDVM-550")
+    else if (vSource == "iDVM550" || vSource == "iDVM-550")
       vIcon = embeddedIcons.iconRedfish550;
-    else if (test.source["voltage" + src] == "VOLT-100")
+    else if (vSource == "VOLT-100")
       vIcon = embeddedIcons.iconVolt100;
-    else if (test.source["voltage" + src] == "iDVM510")
+    else if (vSource == "iDVM510" || vSource == "iDVM-510")
       vIcon = embeddedIcons.iconRedfish510;
-    else if (test.source["voltage" + src] == "Fieldpiece")
+    else if (vSource == "Fieldpiece")
       vIcon = embeddedIcons.iconFieldpiece;
   }
   if (aDisplay) {
-    if (test.source["amperage" + src] == "ComfortGuard")
+    if (aSource == "ComfortGuard")
       aIcon = embeddedIcons.iconSensi;
-    else if (test.source["amperage" + src] == "iDVM550" || test.source["amperage" + src] == "iDVM-550")
+    else if (aSource == "iDVM550" || aSource == "iDVM-550")
       aIcon = embeddedIcons.iconRedfish550;
-    else if (test.source["amperage" + src] == "VOLT-100")
+    else if (aSource == "VOLT-100")
       aIcon = embeddedIcons.iconVolt100;
-    else if (test.source["amperage" + src] == "iDVM510")
+    else if (aSource == "iDVM510" || aSource == "iDVM-510")
       aIcon = embeddedIcons.iconRedfish510;
-    else if (test.source["amperage" + src] == "Fieldpiece")
+    else if (aSource == "Fieldpiece")
       aIcon = embeddedIcons.iconFieldpiece;
   }
   return {