@justair/justair-library 7.10.0-alpha.f42db94 → 7.10.0

package/README.md

@@ -121,6 +121,31 @@ Same install-time visibility caveat as the 7.4.0 section above.
 
 `HI` is **derived, not measured**. Processing-Engine computes it from that reading's own `T_AMB` / `RH_AMB` pair using the NOAA formula (JA-3120); no supplier reports it. It takes no `_AMB` suffix because there is no internal counterpart — an enclosure Heat Index would describe the inside of the housing. Never compute it from the bare `T` / `RH`.
 
+### New parameter and type changes in 7.10.0
+
+| id | Name | Unit |
+|---|---|---|
+| `RN` | Radon | `pCi/L` |
+
+Same install-time visibility caveat as the 7.4.0 section above. Nothing normalizes radon today, so no
+monitor carries it yet, but the first one that does will surface publicly. JA-3427 records that radon
+should start admin only; that gating lives only in JustAir-Client's `parameterFiltering.js` and V2 has
+no equivalent.
+
+`RN.rfc` is `4`, the EPA indoor action level in pCi/L. It is **not** an IRIS chronic inhalation RfC in
+µg/m³, which is what every `HEAVY_METALS` `rfc` is. Nothing reads `rfc` off `PARAMETERS` today.
+
+Two `type` values also changed, so a service that groups by `type` will show these in a new group
+after install:
+
+| id | Was | Now |
+|---|---|---|
+| `H2S` | `Volatile Organic Compound` | `Gas` |
+| `CH4` | `Volatile Organic Compound` | `Gas` |
+
+`origin` and `impacts` were also filled in for the non-AQI pollutants that had them blank. Display
+only, no shape change.
+
 ### Object shape
 
 Each constant is an object with the following fields:
@@ -132,7 +157,7 @@ Each constant is an object with the following fields:
 | `name` | `string` | Full descriptive name (e.g. `"Particulate Matter 2.5 (PM₂.₅)"`) |
 | `unit` | `string` | Measurement unit (e.g. `"µg/m³"`) |
 | `type` | `string` | Category: `"Particulate Matter"`, `"Gas"`, `"Volatile Organic Compound"`, `"Weather"`, `"Heavy Metal"`, `"Heavy Metal - Essential Nutrient"` |
-| `rfc` | `number \| null` | EPA IRIS chronic inhalation reference concentration (µg/m³) |
+| `rfc` | `number \| null` | EPA IRIS chronic inhalation reference concentration (µg/m³). Exception: `RN.rfc` is the EPA indoor action level in pCi/L |
 | `origin` | `string \| null` | Description of pollution source |
 | `impacts` | `string \| null` | Human health impact description |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justair/justair-library",
-  "version": "7.10.0-alpha.f42db94",
+  "version": "7.10.0",
   "description": "JustAir Internal Library",
   "main": "src/index.js",
   "type": "module",

package/src/constants/pollutants.js

@@ -130,7 +130,7 @@ export const PARAMETERS = {
     name: "Radon (Rn)",
     unit: "pCi/L",
     type: "Gas",
-    rfc: 4, // doc states ">= 4pCi/L"; rfc is numeric, so the threshold value only
+    rfc: 4, // EPA indoor action level (pCi/L), not an IRIS inhalation RfC like the HEAVY_METALS values
     origin: "A radioactive gas that comes naturally from uranium breaking down in rock, soil, and water. It can leak into buildings through cracks in the foundation. Has no color or smell.",
     impacts: "The second leading cause of lung cancer in the US, after smoking. Linked to about 21,000 lung cancer deaths a year.",
   },

package/src/constants/tests/pollutants.test.js

@@ -1,11 +1,17 @@
 import { PARAMETERS, HEAVY_METALS } from "../pollutants.js";
 
 const REQUIRED_FIELDS = ["id", "label", "name", "unit", "type"];
+
+// The one type that is not a pollutant. Stated, not derived: deriving the exemption from the
+// entries would make the origin/impacts test assert nothing, since a new entry shipped blank
+// would exempt itself.
+const WEATHER_TYPE = "Weather";
+
 const VALID_TYPES = [
   "Particulate Matter",
   "Gas",
   "Volatile Organic Compound",
-  "Weather",
+  WEATHER_TYPE,
   "Heavy Metal",
   "Heavy Metal - Essential Nutrient",
 ];
@@ -70,7 +76,7 @@ function sharedAssertions(constants) {
 // JA-3460: every pollutant needs Origin and Impacts copy. Weather parameters are exempt: they
 // are not pollutants, and the Centralized Constants doc leaves both columns blank for them.
 function hasOriginAndImpacts(constants) {
-  const pollutants = Object.entries(constants).filter(([, p]) => p.type !== "Weather");
+  const pollutants = Object.entries(constants).filter(([, p]) => p.type !== WEATHER_TYPE);
 
   test.each(pollutants)("%s: origin is populated", (key, pollutant) => {
     expect(typeof pollutant.origin).toBe("string");
@@ -107,7 +113,7 @@ describe("PARAMETERS", () => {
     test("is declared as a Weather parameter in °F", () => {
       expect(PARAMETERS.HI).toBeDefined();
       expect(PARAMETERS.HI.unit).toBe("°F");
-      expect(PARAMETERS.HI.type).toBe("Weather");
+      expect(PARAMETERS.HI.type).toBe(WEATHER_TYPE);
     });
 
     test("shares T_AMB's unit, since it is an apparent temperature", () => {