@measurequick/measurequick-report-generator 1.5.222 → 1.5.224

package/package.json

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

package/report-gen-scripts/vitals-heating-report-no-combustion.js

@@ -254,18 +254,69 @@ export async function getReport(payload, _test) {
       return isFinite(n) ? n : NaN;
     }
     var coAmbRaw = toNum(data && data.co_ambient);
-    if (isFinite(coAmbRaw) && coAmbRaw > 9) {
-      safeSetText(
-        form,
-        "COWarning",
-        "WARNING: Elevated CO Above 9 ppm Detected!\nVentilate the area and investigate the source."
-      );
-      safeSetText(
-        form,
-        "COWarning2",
-        "WARNING: Elevated CO Above 9 ppm Detected! Ventilate the area and investigate the source."
-      );
+    var coRetRaw = toNum(data && data.co_return);
+    var coSupRaw = toNum(data && data.co_supply);
+
+    // CO level helper function
+    // Normal: 0-8 ppm, Elevated: 9-35 ppm, Dangerous: 36-69 ppm, Emergency: 70+ ppm
+    function getCOLevel(ppm) {
+      if (!isFinite(ppm) || ppm <= 8) return "Normal";
+      if (ppm >= 9 && ppm <= 35) return "Elevated";
+      if (ppm >= 36 && ppm <= 69) return "Dangerous";
+      return "Emergency";
+    }
+
+    var reasons = [];
+    if (isFinite(coAmbRaw) && coAmbRaw > 8) reasons.push({ type: "Ambient", value: coAmbRaw, level: getCOLevel(coAmbRaw) });
+    if (isFinite(coRetRaw) && coRetRaw > 8) reasons.push({ type: "Return", value: coRetRaw, level: getCOLevel(coRetRaw) });
+    if (isFinite(coSupRaw) && coSupRaw > 8) reasons.push({ type: "Supply", value: coSupRaw, level: getCOLevel(coSupRaw) });
+    var coHigh = reasons.length > 0;
+
+    if (coHigh) {
+      // Find the highest severity level and the ambient CO reading
+      var highestLevel = "Elevated";
+      var ambientReading = null;
+      for (var r = 0; r < reasons.length; r++) {
+        if (reasons[r].type === "Ambient") ambientReading = reasons[r];
+        if (reasons[r].level === "Emergency") highestLevel = "Emergency";
+        else if (reasons[r].level === "Dangerous" && highestLevel !== "Emergency") highestLevel = "Dangerous";
+      }
+
+      // Build warning message focused on ambient CO
+      var warningMsg, warningMsg2;
+      if (ambientReading) {
+        warningMsg = "WARNING: " + ambientReading.level + " Ambient CO " + Math.round(ambientReading.value) + " ppm\nVentilate the area and investigate source.";
+        warningMsg2 = "WARNING: " + ambientReading.level + " Ambient CO " + Math.round(ambientReading.value) + " ppm. Ventilate the area and investigate source.";
+      } else {
+        // Fallback if no ambient reading (use first reading)
+        var firstReading = reasons[0];
+        warningMsg = "WARNING: " + firstReading.level + " " + firstReading.type + " CO " + Math.round(firstReading.value) + " ppm\nVentilate the area and investigate source.";
+        warningMsg2 = "WARNING: " + firstReading.level + " " + firstReading.type + " CO " + Math.round(firstReading.value) + " ppm. Ventilate the area and investigate source.";
+      }
+
+      // Set text with color based on severity level
+      // Orange for Elevated, Red for Dangerous, Dark Red for Emergency
+      var warningColor;
+      if (highestLevel === "Emergency") {
+        warningColor = rgb(0.72, 0.11, 0.11); // Dark red (#b71c1c)
+      } else if (highestLevel === "Dangerous") {
+        warningColor = rgb(0.96, 0.26, 0.21); // Red (#f44336)
+      } else {
+        warningColor = rgb(1, 0.6, 0); // Orange (#ff9800)
+      }
+
+      try {
+        var tf1 = form.getTextField("COWarning");
+        tf1.setText(warningMsg);
+        tf1.setTextColor(warningColor);
+      } catch (e) {}
+      try {
+        var tf2 = form.getTextField("COWarning2");
+        tf2.setText(warningMsg2);
+        tf2.setTextColor(warningColor);
+      } catch (e) {}
     } else {
+      // clear warnings if not applicable
       safeSetText(form, "COWarning", "");
       safeSetText(form, "COWarning2", "");
     }
@@ -511,16 +562,57 @@ export async function getReport(payload, _test) {
         passFails.splice(3, 1);
         pfLabels.splice(3, 1);
       }
+
+      // CO threshold color helpers
+      function getCOIcon(coValue) {
+        if (coValue === null || coValue === undefined || isNaN(coValue)) {
+          return iconRangeGreen;
+        }
+        if (coValue <= 9) {
+          return iconRangeGreen;
+        } else if (coValue > 9 && coValue <= 35) {
+          return iconRangeYellow;
+        } else {
+          return iconRangeRed;
+        }
+      }
+
+      function getCOTextColor(coValue) {
+        if (coValue === null || coValue === undefined || isNaN(coValue)) {
+          return rgb(0, 0, 0);
+        }
+        if (coValue <= 9) {
+          return rgb(0, 0, 0); // black - OK
+        } else if (coValue > 9 && coValue <= 35) {
+          return rgb(1, 0.6, 0); // orange - Elevated
+        } else {
+          return rgb(0.96, 0.26, 0.21); // red - Dangerous
+        }
+      }
+
+      function getCOStatus(coValue) {
+        if (coValue === null || coValue === undefined || isNaN(coValue)) {
+          return "";
+        }
+        if (coValue <= 9) {
+          return "OK";
+        } else {
+          return "Elevated";
+        }
+      }
+
+      // Collect valid items first (no gaps)
+      let validItems = [];
+
       for (let i = 0; i < passFails.length; i++) {
         const meas = test.testInfo[passFails[i]];
 
-        // If no value provided, hide the label (set empty) and skip icon
+        // Skip items with no value
         if (meas === undefined || meas === null || meas === "") {
-          safeSetText(form, `SSR${i + 1}`, "");
           continue;
         }
 
-        // Choose icon based on value
+        // Determine icon based on value
         let icon;
         if (meas === "Caution") {
           icon = iconRangeYellow;
@@ -529,53 +621,85 @@ export async function getReport(payload, _test) {
         } else {
           icon = iconRangeRed;
         }
-        if (passFails[i] === "heating_efficiency_pass_fail")
+        if (passFails[i] === "heating_efficiency_pass_fail") {
           icon = iconRangeGreen;
-
-        // Set the icon as before
-        safeSetImage(form, `ImageSubsystem${i + 1}_af_image`, icon);
+        }
 
         const suffix = test.testInfo[passFails[i] + "_override"] ? " *" : "";
-        const fieldName = `SSR${i + 1}`;
-
-        // Default label for non-special cases
         let label = pfLabels[i] + suffix;
+        let textColor = rgb(0, 0, 0); // default black
 
-        // Special handling: Ambient CO failure should be red and show a stronger warning
+        // Special handling for Ambient CO - show actual values
         if (passFails[i] === "ambient_pass_fail") {
-          const isFail = !(
-            meas === "Pass" ||
-            meas === "High" ||
-            meas === "Mid" ||
-            meas === "Caution"
-          );
-
-          if (isFail) {
-            label = "CO Ambient High, Investigate Source!";
-            try {
-              const tf = form.getTextField(fieldName);
-              tf.setText(label);
-              tf.setTextColor(rgb(1, 0, 0)); // red
-            } catch (e) {}
-            continue; // move to next item; we've already set text & color
-          } else {
-            // Non-fail states: ensure text is black
-            try {
-              const tf = form.getTextField(fieldName);
-              tf.setText(label);
-              tf.setTextColor(rgb(0, 0, 0)); // black
-            } catch (e) {}
-            continue;
+          // Calculate CO delta
+          const coDelta = (isFinite(coSupRaw) && isFinite(coRetRaw)) ? (coSupRaw - coRetRaw) : null;
+          const hasCODeltaWarning = test.testInfo.ambient_pass_fail_co_delta_warning || (coDelta !== null && coDelta >= 1);
+
+          // Add CO Ambient with value
+          if (isFinite(coAmbRaw)) {
+            const coAmbIcon = getCOIcon(coAmbRaw);
+            const coAmbColor = getCOTextColor(coAmbRaw);
+            const coAmbStatus = getCOStatus(coAmbRaw);
+            const coAmbLabel = "CO Ambient: " + Math.round(coAmbRaw) + " ppm (" + coAmbStatus + ")" + suffix;
+            validItems.push({ label: coAmbLabel, icon: coAmbIcon, textColor: coAmbColor });
+          } else if (meas) {
+            // No CO value but has pass/fail - show generic
+            const isFail = !(meas === "Pass" || meas === "High" || meas === "Mid" || meas === "Caution");
+            if (isFail) {
+              validItems.push({ label: "CO Ambient: Elevated" + suffix, icon: iconRangeYellow, textColor: rgb(1, 0.6, 0) });
+            } else {
+              validItems.push({ label: "CO Ambient: OK" + suffix, icon: iconRangeGreen, textColor: rgb(0, 0, 0) });
+            }
           }
+
+          // Add CO Return with value (if available and not boiler)
+          if (isFinite(coRetRaw) && !payload.meta.boiler_type) {
+            const coRetIcon = getCOIcon(coRetRaw);
+            const coRetColor = getCOTextColor(coRetRaw);
+            const coRetStatus = getCOStatus(coRetRaw);
+            const coRetLabel = "CO Return: " + Math.round(coRetRaw) + " ppm (" + coRetStatus + ")";
+            validItems.push({ label: coRetLabel, icon: coRetIcon, textColor: coRetColor });
+          }
+
+          // Add CO Supply with value (if available and not boiler)
+          if (isFinite(coSupRaw) && !payload.meta.boiler_type) {
+            const coSupIcon = getCOIcon(coSupRaw);
+            const coSupColor = getCOTextColor(coSupRaw);
+            const coSupStatus = getCOStatus(coSupRaw);
+            const coSupLabel = "CO Supply: " + Math.round(coSupRaw) + " ppm (" + coSupStatus + ")";
+            validItems.push({ label: coSupLabel, icon: coSupIcon, textColor: coSupColor });
+          }
+
+          // Add CO Delta (if both return and supply available and not boiler)
+          if (coDelta !== null && !payload.meta.boiler_type) {
+            const deltaIcon = hasCODeltaWarning ? iconRangeRed : iconRangeGreen;
+            const deltaColor = hasCODeltaWarning ? rgb(0.96, 0.26, 0.21) : rgb(0, 0, 0);
+            const deltaStatus = hasCODeltaWarning ? "Investigate Heat Exchanger" : "OK";
+            const deltaLabel = "CO Delta: " + Math.round(coDelta) + " ppm (" + deltaStatus + ")";
+            validItems.push({ label: deltaLabel, icon: deltaIcon, textColor: deltaColor });
+          }
+
+          continue; // Skip adding the default ambient_pass_fail item
         }
 
-        // All other pass/fail items: keep existing label, ensure black text
+        validItems.push({ label, icon, textColor });
+      }
+
+      // Fill fields sequentially with valid items (no gaps)
+      for (let i = 0; i < validItems.length; i++) {
+        const item = validItems[i];
+        safeSetImage(form, `ImageSubsystem${i + 1}_af_image`, item.icon);
         try {
-          const tf = form.getTextField(fieldName);
-          tf.setText(label);
-          tf.setTextColor(rgb(0, 0, 0));
+          const tf = form.getTextField(`SSR${i + 1}`);
+          tf.setText(item.label);
+          tf.setTextColor(item.textColor);
         } catch (e) {}
       }
+
+      // Clear any remaining unused fields
+      for (let i = validItems.length; i < passFails.length + 3; i++) {
+        safeSetText(form, `SSR${i + 1}`, "");
+      }
     } else safeSetText(form, `SSR1`, "Not yet reviewed");
 
     if (payload.meta.report_type != "FullReport") {

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

@@ -672,13 +672,23 @@ export async function getReport(payload, _test) {
           // Use coAmbRaw which is already defined and validated earlier in the function
           const coValue = isFinite(coAmbRaw) ? coAmbRaw : null;
 
+          // Check for CO delta warning (Supply - Return >= 1 ppm)
+          const coDelta = (isFinite(coSupRaw) && isFinite(coRetRaw)) ? (coSupRaw - coRetRaw) : null;
+          const hasCODeltaWarning = test.testInfo.ambient_pass_fail_co_delta_warning || (coDelta !== null && coDelta >= 1);
+
           // Use CO-specific icon based on actual value
           if (coValue !== null) {
             icon = getCOIcon(coValue);
             const stateText = getCOStateText(coValue);
 
-            // Format label based on CO level
-            if (coValue <= 8) {
+            // Format label based on CO level and delta warning
+            if (hasCODeltaWarning) {
+              // CO delta detected - recommend heat exchanger investigation
+              icon = iconRangeRed;
+              textColor = rgb(0.96, 0.26, 0.21); // Red
+              const deltaValue = coDelta !== null ? Math.round(coDelta) : "";
+              label = "CO Delta " + deltaValue + " ppm: Investigate heat exchanger" + suffix;
+            } else if (coValue <= 8) {
               // Normal - just show value
               label = "Ambient CO: " + Math.round(coValue) + " ppm" + suffix;
             } else {
@@ -686,15 +696,23 @@ export async function getReport(payload, _test) {
               label = "CO Ambient " + stateText + " " + Math.round(coValue) + " ppm, Investigate!" + suffix;
             }
 
-            // Set text color based on CO level
-            // Orange for Elevated, Red for Dangerous, Dark Red for Emergency
-            if (coValue >= 70) {
-              textColor = rgb(0.72, 0.11, 0.11); // Dark red for Emergency
-            } else if (coValue >= 36) {
-              textColor = rgb(0.96, 0.26, 0.21); // Red for Dangerous
-            } else if (coValue >= 9) {
-              textColor = rgb(1, 0.6, 0); // Orange for Elevated
+            // Set text color based on CO level (if not already set by delta warning)
+            if (!hasCODeltaWarning) {
+              // Orange for Elevated, Red for Dangerous, Dark Red for Emergency
+              if (coValue >= 70) {
+                textColor = rgb(0.72, 0.11, 0.11); // Dark red for Emergency
+              } else if (coValue >= 36) {
+                textColor = rgb(0.96, 0.26, 0.21); // Red for Dangerous
+              } else if (coValue >= 9) {
+                textColor = rgb(1, 0.6, 0); // Orange for Elevated
+              }
             }
+          } else if (hasCODeltaWarning) {
+            // No ambient CO value but delta warning detected
+            icon = iconRangeRed;
+            textColor = rgb(0.96, 0.26, 0.21); // Red
+            const deltaValue = coDelta !== null ? Math.round(coDelta) : "";
+            label = "CO Delta " + deltaValue + " ppm: Investigate heat exchanger" + suffix;
           } else {
             // No CO value, use pass/fail status
             const isFail = !(meas === "Pass" || meas === "High" || meas === "Mid" || meas === "Caution");