@justair/justair-library 4.15.0-alpha.d287cce → 5.0.0-alpha.56f07df

package/dist/index.d.ts

@@ -43,6 +43,7 @@ import { eventsAuditSchema } from "./models/events.js";
 import { MonitorAudit } from "./models/monitors.js";
 import { monitorAuditSchema } from "./models/monitors.js";
 import { parametersEnum } from "./models/monitors.js";
+import { legacyParametersEnum } from "./models/monitors.js";
 import { deploymentTypesEnum } from "./models/monitors.js";
 import { AlertsAudit } from "./models/alerts.js";
 import { Alerts } from "./models/alerts.js";
@@ -66,5 +67,7 @@ import { Samples } from "./models/samples.js";
 import { samplesAuditSchema } from "./models/samples.js";
 import { SamplesAudit } from "./models/samples.js";
 import { sampleParameterReferenceConcentrations } from "./models/samples.js";
-export { Database, adminSchema, Admin, configurationsSchema, Configurations, measurementsSchema, Measurements, monitorRequestsSchema, MonitorRequests, monitorsSchema, Monitors, organizationsSchema, Organizations, usersSchema, Users, eventsSchema, Events, lightMonitorSchema, LightMonitors, monitorSuppliersSchema, MonitorSuppliers, contextsSchema, Contexts, parametersSchema, Parameters, announcementSchema, Announcements, jobsSchema, Jobs, apiKeySchema, ApiKey, UsageMetrics, usageMetricsSchema, Audit, auditSchema, EventsAudit, eventsAuditSchema, MonitorAudit, monitorAuditSchema, parametersEnum, deploymentTypesEnum, AlertsAudit, Alerts, alertsSchema, alertsAuditSchema, Features, featuresSchema, dataCompletenessSchema, DataCompleteness, networkMetricsSchema, NetworkMetrics, rateOfChangeSchema, RateOfChange, sampleSitesSchema, SampleSites, sampleSiteAuditSchema, SampleSiteAudit, sampleParametersEnum, samplesSchema, Samples, samplesAuditSchema, SamplesAudit, sampleParameterReferenceConcentrations };
+import { PARAMETERS } from "./constants/pollutants.js";
+import { HEAVY_METALS } from "./constants/pollutants.js";
+export { Database, adminSchema, Admin, configurationsSchema, Configurations, measurementsSchema, Measurements, monitorRequestsSchema, MonitorRequests, monitorsSchema, Monitors, organizationsSchema, Organizations, usersSchema, Users, eventsSchema, Events, lightMonitorSchema, LightMonitors, monitorSuppliersSchema, MonitorSuppliers, contextsSchema, Contexts, parametersSchema, Parameters, announcementSchema, Announcements, jobsSchema, Jobs, apiKeySchema, ApiKey, UsageMetrics, usageMetricsSchema, Audit, auditSchema, EventsAudit, eventsAuditSchema, MonitorAudit, monitorAuditSchema, parametersEnum, legacyParametersEnum, deploymentTypesEnum, AlertsAudit, Alerts, alertsSchema, alertsAuditSchema, Features, featuresSchema, dataCompletenessSchema, DataCompleteness, networkMetricsSchema, NetworkMetrics, rateOfChangeSchema, RateOfChange, sampleSitesSchema, SampleSites, sampleSiteAuditSchema, SampleSiteAudit, sampleParametersEnum, samplesSchema, Samples, samplesAuditSchema, SamplesAudit, sampleParameterReferenceConcentrations, PARAMETERS, HEAVY_METALS };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AA4EA;;;iBAEC;yBAtBwB,oBAAoB;qBADxB,gBAAgB;4BAvDF,mBAAmB;sBAAnB,mBAAmB;qCAI/C,4BAA4B;+BAA5B,4BAA4B;mCAM5B,0BAA0B;6BAA1B,0BAA0B;sCAI1B,6BAA6B;gCAA7B,6BAA6B;+BAQ7B,sBAAsB;yBAAtB,sBAAsB;oCACsB,2BAA2B;8BAA3B,2BAA2B;4BAQ3C,mBAAmB;sBAAnB,mBAAmB;6BAM/C,oBAAoB;uBAApB,oBAAoB;mCAbuB,2BAA2B;8BAA3B,2BAA2B;uCAItE,8BAA8B;iCAA9B,8BAA8B;+BACI,sBAAsB;yBAAtB,sBAAsB;iCAClB,wBAAwB;2BAAxB,wBAAwB;mCAQnB,2BAA2B;8BAA3B,2BAA2B;2BAC5C,kBAAkB;qBAAlB,kBAAkB;6BACd,oBAAoB;uBAApB,oBAAoB;6BACR,0BAA0B;mCAA1B,0BAA0B;sBA/BpE,0BAA0B;4BAA1B,0BAA0B;4BA2B1B,oBAAoB;kCAApB,oBAAoB;6BAfpB,sBAAsB;mCAAtB,sBAAsB;+BAAtB,sBAAsB;oCAAtB,sBAAsB;4BAyBtB,oBAAoB;uBAApB,oBAAoB;6BAApB,oBAAoB;kCAApB,oBAAoB;yBACc,sBAAsB;+BAAtB,sBAAsB;uCAIxD,8BAA8B;iCAA9B,8BAA8B;qCACgB,4BAA4B;+BAA5B,4BAA4B;mCAChC,0BAA0B;6BAA1B,0BAA0B;kCAWpE,yBAAyB;4BAAzB,yBAAyB;sCAAzB,yBAAyB;gCAAzB,yBAAyB;qCAAzB,yBAAyB;8BASzB,qBAAqB;wBAArB,qBAAqB;mCAArB,qBAAqB;6BAArB,qBAAqB;uDAArB,qBAAqB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AA8EA;;;iBAEC;yBAvBwB,oBAAoB;qBADxB,gBAAgB;4BAxDF,mBAAmB;sBAAnB,mBAAmB;qCAI/C,4BAA4B;+BAA5B,4BAA4B;mCAM5B,0BAA0B;6BAA1B,0BAA0B;sCAI1B,6BAA6B;gCAA7B,6BAA6B;+BAS7B,sBAAsB;yBAAtB,sBAAsB;oCACsB,2BAA2B;8BAA3B,2BAA2B;4BAQ3C,mBAAmB;sBAAnB,mBAAmB;6BAM/C,oBAAoB;uBAApB,oBAAoB;mCAbuB,2BAA2B;8BAA3B,2BAA2B;uCAItE,8BAA8B;iCAA9B,8BAA8B;+BACI,sBAAsB;yBAAtB,sBAAsB;iCAClB,wBAAwB;2BAAxB,wBAAwB;mCAQnB,2BAA2B;8BAA3B,2BAA2B;2BAC5C,kBAAkB;qBAAlB,kBAAkB;6BACd,oBAAoB;uBAApB,oBAAoB;6BACR,0BAA0B;mCAA1B,0BAA0B;sBAhCpE,0BAA0B;4BAA1B,0BAA0B;4BA4B1B,oBAAoB;kCAApB,oBAAoB;6BAfpB,sBAAsB;mCAAtB,sBAAsB;+BAAtB,sBAAsB;qCAAtB,sBAAsB;oCAAtB,sBAAsB;4BAyBtB,oBAAoB;uBAApB,oBAAoB;6BAApB,oBAAoB;kCAApB,oBAAoB;yBACc,sBAAsB;+BAAtB,sBAAsB;uCAIxD,8BAA8B;iCAA9B,8BAA8B;qCACgB,4BAA4B;+BAA5B,4BAA4B;mCAChC,0BAA0B;6BAA1B,0BAA0B;kCAYpE,yBAAyB;4BAAzB,yBAAyB;sCAAzB,yBAAyB;gCAAzB,yBAAyB;qCAAzB,yBAAyB;8BASzB,qBAAqB;wBAArB,qBAAqB;mCAArB,qBAAqB;6BAArB,qBAAqB;uDAArB,qBAAqB;2BAlBa,2BAA2B;6BAA3B,2BAA2B"}

package/dist/models/monitors.d.ts

@@ -3,6 +3,7 @@ export const Monitors: any;
 export const monitorAuditSchema: any;
 export const MonitorAudit: any;
 export const parametersEnum: string[];
+export const legacyParametersEnum: string[];
 export namespace deploymentTypesEnum {
     let STATIONARY: string;
     let MOBILE: string;

package/dist/models/monitors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"monitors.d.ts","sourceRoot":"","sources":["../../src/models/monitors.js"],"names":[],"mappings":"AAiLA,iCA0HE;AA6IF,2BAA4D;AAzS5D,qCA4BE;AAGF,+BAAwE;AA7KxE,sCAsBE"}
+{"version":3,"file":"monitors.d.ts","sourceRoot":"","sources":["../../src/models/monitors.js"],"names":[],"mappings":"AAgKA,iCA0HE;AA6IF,2BAA4D;AAzS5D,qCA4BE;AAGF,+BAAwE;AAvJxE,sCAA6E;AAF7E,4CAA+F"}

package/dist/models/organizations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organizations.d.ts","sourceRoot":"","sources":["../../src/models/organizations.js"],"names":[],"mappings":"AAyFA,sCAsBE;AAyDF,gCAA2E"}
+{"version":3,"file":"organizations.d.ts","sourceRoot":"","sources":["../../src/models/organizations.js"],"names":[],"mappings":"AAoGA,sCAsBE;AAyDF,gCAA2E"}

package/dist/models/sampleSites.d.ts

@@ -3,16 +3,7 @@ export const SampleSites: any;
 export const sampleSiteAuditSchema: any;
 export const SampleSiteAudit: any;
 export const sampleParametersEnum: string[];
-export namespace sampleParameterReferenceConcentrations {
-    let C6H6: number;
-    let PB: number;
-    let AS: number;
-    let CD: number;
-    let CR: number;
-    let NI: any;
-    let BA: any;
-    let FE: any;
-    let CU: any;
-    let ZN: any;
-}
+export const sampleParameterReferenceConcentrations: {
+    [k: string]: any;
+};
 //# sourceMappingURL=sampleSites.d.ts.map

package/dist/models/sampleSites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sampleSites.d.ts","sourceRoot":"","sources":["../../src/models/sampleSites.js"],"names":[],"mappings":"AA8EA,oCAmDE;AA2JF,8BAAqE;AApOrE,wCAgBE;AAGF,kCAAiF;AAvEjF,4CAWE"}
+{"version":3,"file":"sampleSites.d.ts","sourceRoot":"","sources":["../../src/models/sampleSites.js"],"names":[],"mappings":"AA4DA,oCAmDE;AA2JF,8BAAqE;AApOrE,wCAgBE;AAGF,kCAAiF;AAnDjF,4CAAuD;AAIvD;;EAEE"}

package/dist/models/samples.d.ts

@@ -2,16 +2,7 @@ export const samplesSchema: any;
 export const Samples: any;
 export const SamplesAudit: any;
 export const samplesAuditSchema: any;
-export namespace sampleParameterReferenceConcentrations {
-    let C6H6: number;
-    let PB: number;
-    let AS: number;
-    let CD: number;
-    let CR: number;
-    let NI: any;
-    let BA: any;
-    let FE: any;
-    let CU: any;
-    let ZN: any;
-}
+export const sampleParameterReferenceConcentrations: {
+    [k: string]: any;
+};
 //# sourceMappingURL=samples.d.ts.map

package/dist/models/samples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../../src/models/samples.js"],"names":[],"mappings":"AA6CA,gCAkBE;AAoIF,0BAAyD;AAzJzD,+BAAwE;AAvBxE,qCAoBE"}
+{"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../../src/models/samples.js"],"names":[],"mappings":"AAoCA,gCAkBE;AAoIF,0BAAyD;AAzJzD,+BAAwE;AAvBxE,qCAoBE;AAzBF;;EAEE"}

package/dist/models/tests/enums.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=enums.test.d.ts.map

package/dist/models/tests/enums.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.test.d.ts","sourceRoot":"","sources":["../../../src/models/tests/enums.test.js"],"names":[],"mappings":""}

package/package.json

@@ -1,12 +1,22 @@
 {
   "name": "@justair/justair-library",
-  "version": "4.15.0-alpha.d287cce",
+  "version": "5.0.0-alpha.56f07df",
   "description": "JustAir Internal Library",
   "main": "src/index.js",
   "type": "module",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./constants": {
+      "types": "./dist/constants/pollutants.d.ts",
+      "default": "./src/constants/pollutants.js"
+    }
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
     "build": "tsc",
     "prepublish": "npm run build"
   },
@@ -20,8 +30,15 @@
     "nanoid": "^5.1.6",
     "winston": "^3.10.0"
   },
+  "jest": {
+    "testEnvironment": "node",
+    "transform": {}
+  },
   "devDependencies": {
+    "@jest/globals": "^29",
     "@types/node": "^16.0.0",
+    "jest": "^29",
+    "jest-environment-node": "^29",
     "ts-node": "^10.0.0",
     "typescript": "^5.3.2"
   }

package/src/constants/pollutants.js

@@ -0,0 +1,350 @@
+// Parameters measured by air quality sensors in real time.
+// These correspond to the values stored in Monitors.parameters and used across the platform.
+export const PARAMETERS = {
+  PM1: {
+    id: "PM1",
+    label: "PM₁",
+    name: "Particulate Matter 1 (PM₁)",
+    unit: "µg/m³",
+    type: "Particulate Matter",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  PM2_5: {
+    id: "PM2_5",
+    label: "PM₂.₅",
+    name: "Particulate Matter 2.5 (PM₂.₅)",
+    unit: "µg/m³",
+    type: "Particulate Matter",
+    rfc: null,
+    origin: "Tiny particles that can penetrate deep into lungs and bloodstream, originating from vehicle emissions, industrial processes, and wildfires.",
+    impacts: "Can cause respiratory and cardiovascular illnesses, exacerbate asthma, and increase mortality risk with prolonged exposure.",
+  },
+  PM10: {
+    id: "PM10",
+    label: "PM₁₀",
+    name: "Particulate Matter 10 (PM₁₀)",
+    unit: "µg/m³",
+    type: "Particulate Matter",
+    rfc: null,
+    origin: "Larger particles including dust, dirt, soot, and smoke from various sources like construction and natural activities.",
+    impacts: "Can worsen respiratory diseases including asthma and COPD, particularly with short-term exposure.",
+  },
+  BC: {
+    id: "BC",
+    label: "Black Carbon",
+    name: "Total Black Carbon (BC)",
+    unit: "ng/m³",
+    type: "Particulate Matter",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  BRC: {
+    id: "BRC",
+    label: "Brown Carbon",
+    name: "Total Brown Carbon (BrC)",
+    unit: "ng/m³",
+    type: "Particulate Matter",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  UFP: {
+    id: "UFP",
+    label: "Ultra Fine Particles",
+    name: "Ultra Fine Particles (UFP)",
+    unit: "pt/cm³",
+    type: "Particulate Matter",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  O3: {
+    id: "O3",
+    label: "O₃",
+    name: "Ozone (O₃)",
+    unit: "ppm",
+    type: "Gas",
+    rfc: null,
+    origin: "Harmful smog component formed when pollution reacts with sunlight, especially problematic on hot, sunny days.",
+    impacts: "Can irritate lungs, intensify asthma and chronic bronchitis, and increase heart problems and mortality rates.",
+  },
+  NO: {
+    id: "NO",
+    label: "NO",
+    name: "Nitric Oxide (NO)",
+    unit: "ppb",
+    type: "Gas",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  NO2: {
+    id: "NO2",
+    label: "NO₂",
+    name: "Nitrogen Dioxide (NO₂)",
+    unit: "ppb",
+    type: "Gas",
+    rfc: null,
+    origin: "Harmful gas from cars, power plants, and industrial equipment that contributes to smog and acid rain.",
+    impacts: "Can cause respiratory problems, worsen asthma and bronchitis, and increase heart-related health risks.",
+  },
+  SO2: {
+    id: "SO2",
+    label: "SO₂",
+    name: "Sulfur Dioxide (SO₂)",
+    unit: "ppb",
+    type: "Gas",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  CO: {
+    id: "CO",
+    label: "CO",
+    name: "Carbon Monoxide (CO)",
+    unit: "ppm",
+    type: "Gas",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  CO2: {
+    id: "CO2",
+    label: "CO₂",
+    name: "Carbon Dioxide (CO₂)",
+    unit: "ppm",
+    type: "Gas",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  CH4: {
+    id: "CH4",
+    label: "CH₄",
+    name: "Methane (CH₄)",
+    unit: "ppm",
+    type: "Volatile Organic Compound",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  H2S: {
+    id: "H2S",
+    label: "H₂S",
+    name: "Hydrogen Sulfide (H₂S)",
+    unit: "ppm",
+    type: "Volatile Organic Compound",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  VOC: {
+    id: "VOC",
+    label: "VOC",
+    name: "Volatile Organic Compounds (VOC)",
+    unit: "ppm",
+    type: "Volatile Organic Compound",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  T: {
+    id: "T",
+    label: "Temperature",
+    name: "Temperature (T)",
+    unit: "°F",
+    type: "Weather",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  RH: {
+    id: "RH",
+    label: "Humidity",
+    name: "Relative Humidity (RH)",
+    unit: "%",
+    type: "Weather",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  DP: {
+    id: "DP",
+    label: "Dew Point",
+    name: "Dew Point (DP)",
+    unit: "°F",
+    type: "Weather",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  WS: {
+    id: "WS",
+    label: "Wind Speed",
+    name: "Wind Speed (WS)",
+    unit: "mph",
+    type: "Weather",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+  WD: {
+    id: "WD",
+    label: "Wind Direction",
+    name: "Wind Direction (WD)",
+    unit: "°",
+    type: "Weather",
+    rfc: null,
+    origin: null,
+    impacts: null,
+  },
+};
+
+// Parameters analyzed from physical air samples in a laboratory.
+// These correspond to SampleSites.parameters and are not measured by real-time sensors.
+// Note: Cobalt uses the key COBALT (not CO) to avoid collision with PARAMETERS.CO (Carbon Monoxide).
+export const HEAVY_METALS = {
+  C6H6: {
+    id: "C6H6",
+    label: "Benzene",
+    name: "Benzene (C₆H₆)",
+    unit: "ppb",
+    type: "Volatile Organic Compound",
+    rfc: 30,
+    origin: "Benzene is a gas released when coal, oil, and gasoline are burned. It's found in car exhaust, at gas stations, and anywhere fossil fuels are burned.",
+    impacts: "Breathing in benzene for a short time can cause dizziness, drowsiness, or headaches. It may irritate the eyes, skin, or breathing passages. In extreme cases with very high exposure, it can cause loss of consciousness. Regular exposure over a long period can harm the blood, reducing red blood cell count and potentially causing serious blood disorders.",
+  },
+  AS: {
+    id: "AS",
+    label: "Arsenic",
+    name: "Arsenic (As)",
+    unit: "µg/m³",
+    type: "Heavy Metal",
+    rfc: 0.03,
+    origin: "Arsenic is naturally in rocks and soil. It gets into the air through dust blown by wind, metal factories, pesticides, and can leak into groundwater.",
+    impacts: "Short-term exposure to high amounts can cause nausea, vomiting, problems with blood cells, irregular heartbeat, and tingling in the nerves. Long-term exposure may cause skin discoloration or thickening (especially on the palms and feet), damage blood vessels, and increase the risk of skin, liver, bladder, and lung cancers.",
+  },
+  BA: {
+    id: "BA",
+    label: "Barium",
+    name: "Barium (Ba)",
+    unit: "µg/m³",
+    type: "Heavy Metal",
+    rfc: null,
+    origin: "This metal comes from mining operations, industrial facilities, and burning coal and oil.",
+    impacts: "Breathing barium dust can irritate the nose, throat, and lungs. It may cause coughing, difficulty breathing, and temporary increases in blood pressure. Over many years of high exposure, barium can affect heart and kidney function.",
+  },
+  BE: {
+    id: "BE",
+    label: "Beryllium",
+    name: "Beryllium (Be)",
+    unit: "µg/m³",
+    type: "Heavy Metal",
+    rfc: 0.02,
+    origin: "Beryllium occurs naturally in rocks, soil, coal, and oil. It gets into the air through mining and industrial processing, burning coal or fuel oil, and tobacco smoke.",
+    impacts: "Short-term exposure to high levels can cause lung inflammation, coughing, and difficulty breathing. Long-term exposure can cause permanent lung scarring, reduced lung capacity, shortness of breath, and fatigue. It has also been linked to an increased risk of lung cancer.",
+  },
+  COBALT: {
+    id: "COBALT",
+    label: "Cobalt",
+    name: "Cobalt (Co)",
+    unit: "µg/m³",
+    type: "Heavy Metal",
+    rfc: null,
+    origin: "This metal is a naturally occurring metal found throughout the environment. It gets into the air through industrial processing, manufacturing of metal alloys and pigments, and burning of coal and fuel oil.",
+    impacts: "Short-term exposure to high levels can cause coughing, wheezing, and shortness of breath. Long-term exposure may lead to reduced lung function, asthma, and lung scarring. It can also affect the heart and cause skin or respiratory allergic reactions in some people. Some studies suggest a possible link to lung cancer with prolonged exposure.",
+  },
+  NI: {
+    id: "NI",
+    label: "Nickel",
+    name: "Nickel (Ni)",
+    unit: "µg/m³",
+    type: "Heavy Metal",
+    rfc: null,
+    origin: "Nickel occurs naturally in the earth's crust. It enters the air through oil and coal combustion, metal refining, manufacturing facilities, and sewage sludge incineration.",
+    impacts: "Breathing nickel over long periods can irritate the lungs, cause reduced lung function, and trigger asthma-like symptoms. Skin contact with nickel is the most common source of reactions, causing rash and itching on the hands and forearms. Long-term inhalation exposure to certain forms of nickel — particularly those found in refinery dust — has been linked to an increased risk of lung and nasal cancers.",
+  },
+  CD: {
+    id: "CD",
+    label: "Cadmium",
+    name: "Cadmium (Cd)",
+    unit: "µg/m³",
+    type: "Heavy Metal",
+    rfc: 0.01,
+    origin: "Cadmium is released when coal and oil are burned, waste is incinerated, or metals are processed. It's used in batteries, paints, metal coatings, and some plastics.",
+    impacts: "Breathing cadmium can irritate and damage the lungs immediately. Over time, cadmium builds up in the kidneys and can cause kidney damage and increase the likelihood of developing kidney stones. Some research shows it may increase lung cancer risk with long-term exposure.",
+  },
+  CR: {
+    id: "CR",
+    label: "Chromium",
+    name: "Chromium (Cr)",
+    unit: "µg/m³",
+    type: "Heavy Metal",
+    rfc: 0.1,
+    origin: "Chromium is naturally in rocks, soil, plants, and volcanic dust. Industries like steel making, metal plating, leather tanning, and improper waste disposal release it into the environment.",
+    impacts: "Certain forms of chromium can irritate the nose, throat, and lungs when inhaled. It can also cause skin rashes or irritation upon contact. Long-term exposure to high levels has been linked to respiratory problems and an increased risk of lung cancer.",
+  },
+  PB: {
+    id: "PB",
+    label: "Lead",
+    name: "Lead (Pb)",
+    unit: "µg/m³",
+    type: "Heavy Metal",
+    rfc: 0, // 0 = no safe level of exposure (not the same as null/unmeasured)
+    origin: "Lead comes from old paint containing lead, contaminated soil, water pipes made with lead, factory emissions, and from when leaded gasoline was used.",
+    impacts: "Lead is especially dangerous for children. Even small amounts can harm brain development, affecting learning, behavior, and growth. There is no safe level of lead exposure for children. For adults, long-term exposure can contribute to high blood pressure, kidney problems, and reproductive issues.",
+  },
+  FE: {
+    id: "FE",
+    label: "Iron",
+    name: "Iron (Fe)",
+    unit: "µg/m³",
+    type: "Heavy Metal - Essential Nutrient",
+    rfc: null,
+    origin: "Iron is naturally in soil, water, and dust. Airborne iron often comes from factories, construction sites, and wear on roads from vehicles.",
+    impacts: "The human body needs iron to function properly. However, breathing iron-rich dust over long periods can cause coughing or lung irritation. Consuming too much iron can cause stomach problems, vomiting, and in severe cases, organ damage.",
+  },
+  MN: {
+    id: "MN",
+    label: "Manganese",
+    name: "Manganese (Mn)",
+    unit: "µg/m³",
+    type: "Heavy Metal - Essential Nutrient",
+    rfc: 0.05,
+    origin: "Manganese occurs naturally in rocks, soil, and water. It enters the air through steel and iron production, mining operations, power plants, and coke ovens.",
+    impacts: "Manganese is an essential nutrient at low levels, but breathing elevated concentrations over time can affect the nervous system. Long-term exposure may slow reaction time, reduce hand steadiness, and impair coordination. At higher levels, it can cause tremors, difficulty walking, muscle stiffness, and mood or behavioral changes. Prolonged exposure may also lead to coughing and bronchitis.",
+  },
+  SE: {
+    id: "SE",
+    label: "Selenium",
+    name: "Selenium (Se)",
+    unit: "µg/m³",
+    type: "Heavy Metal - Essential Nutrient",
+    rfc: null,
+    origin: "Selenium occurs naturally in rocks, soil, and water. It enters the air through metal industries, mining, and selenium-recovery processes. Food and drinking water are the most common sources of everyday exposure.",
+    impacts: "Selenium is an essential nutrient at low levels, but exposure to elevated concentrations can be harmful. Breathing selenium dust or compounds can irritate the nose, throat, and lungs, causing coughing, nosebleeds, and difficulty breathing. Long-term exposure to high levels through food or water has been associated with skin discoloration, hair and nail loss, tooth decay, and reduced mental alertness.",
+  },
+  CU: {
+    id: "CU",
+    label: "Copper",
+    name: "Copper (Cu)",
+    unit: "µg/m³",
+    type: "Heavy Metal - Essential Nutrient",
+    rfc: null,
+    origin: "Copper occurs naturally in soil and water. Mining, factories, and burning waste release it into the air.",
+    impacts: "Breathing copper dust or fumes can irritate the nose, throat, and lungs, causing coughing or temporary flu-like symptoms. Long-term exposure to high airborne copper levels may lead to ongoing respiratory irritation and sometimes liver or kidney effects.",
+  },
+  ZN: {
+    id: "ZN",
+    label: "Zinc",
+    name: "Zinc (Zn)",
+    unit: "µg/m³",
+    type: "Heavy Metal - Essential Nutrient",
+    rfc: null,
+    origin: "Zinc is common in soil, water, and air. It's released from metal production, waste burning, and wear from vehicle tires and brakes.",
+    impacts: "The body needs zinc, but breathing high levels of zinc dust or fumes can irritate the throat and lungs. Consuming too much zinc over long periods can cause nausea, interfere with copper absorption in the body, and disrupt immune function.",
+  },
+};

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

@@ -0,0 +1,80 @@
+import { PARAMETERS, HEAVY_METALS } from "../pollutants.js";
+
+const REQUIRED_FIELDS = ["id", "label", "name", "unit", "type"];
+const VALID_TYPES = [
+  "Particulate Matter",
+  "Gas",
+  "Volatile Organic Compound",
+  "Weather",
+  "Heavy Metal",
+  "Heavy Metal - Essential Nutrient",
+];
+
+function sharedAssertions(constants) {
+  const entries = Object.entries(constants);
+
+  test("has no duplicate ids", () => {
+    const ids = Object.values(constants).map((p) => p.id);
+    expect(new Set(ids).size).toBe(ids.length);
+  });
+
+  test.each(entries)("%s: key matches id", (key, pollutant) => {
+    expect(key).toBe(pollutant.id);
+  });
+
+  test.each(entries)("%s: has all required fields", (key, pollutant) => {
+    for (const field of REQUIRED_FIELDS) {
+      expect(pollutant).toHaveProperty(field);
+    }
+  });
+
+  test.each(entries)("%s: id is a non-empty string with no dots or spaces", (key, pollutant) => {
+    expect(typeof pollutant.id).toBe("string");
+    expect(pollutant.id.length).toBeGreaterThan(0);
+    expect(pollutant.id).not.toContain(".");
+    expect(pollutant.id).not.toContain(" ");
+  });
+
+  test.each(entries)("%s: label is a non-empty string", (key, pollutant) => {
+    expect(typeof pollutant.label).toBe("string");
+    expect(pollutant.label.length).toBeGreaterThan(0);
+  });
+
+  test.each(entries)("%s: name is a non-empty string", (key, pollutant) => {
+    expect(typeof pollutant.name).toBe("string");
+    expect(pollutant.name.length).toBeGreaterThan(0);
+  });
+
+  test.each(entries)("%s: unit is a non-empty string", (key, pollutant) => {
+    expect(typeof pollutant.unit).toBe("string");
+    expect(pollutant.unit.length).toBeGreaterThan(0);
+  });
+
+  test.each(entries)("%s: type is a recognized value", (key, pollutant) => {
+    expect(VALID_TYPES).toContain(pollutant.type);
+  });
+
+  test.each(entries)("%s: rfc is a number or null", (key, pollutant) => {
+    expect(pollutant.rfc === null || typeof pollutant.rfc === "number").toBe(true);
+  });
+
+  test.each(entries)("%s: origin is a string or null", (key, pollutant) => {
+    expect(pollutant.origin === null || typeof pollutant.origin === "string").toBe(true);
+  });
+
+  test.each(entries)("%s: impacts is a string or null", (key, pollutant) => {
+    expect(pollutant.impacts === null || typeof pollutant.impacts === "string").toBe(true);
+  });
+}
+
+describe("PARAMETERS", () => {
+  sharedAssertions(PARAMETERS);
+});
+
+describe("HEAVY_METALS", () => {
+  sharedAssertions(HEAVY_METALS);
+
+  test("PB.rfc is exactly 0, not null", () => {
+    expect(HEAVY_METALS.PB.rfc).toBe(0);
+  });
+});

package/src/index.js

@@ -19,6 +19,7 @@ import {
   monitorAuditSchema,
   MonitorAudit,
   parametersEnum,
+  legacyParametersEnum,
   deploymentTypesEnum,
 } from "./models/monitors.js";
 import { organizationsSchema, Organizations } from "./models/organizations.js";
@@ -55,6 +56,7 @@ import { NetworkMetrics, networkMetricsSchema } from "./models/networkMetrics.js
 import { RateOfChange, rateOfChangeSchema } from "./models/rateOfChange.js";
 import Database from "./config/db.js"; // Import the new Database class
 import CustomLogger from "./config/logger.js";
+import { PARAMETERS, HEAVY_METALS } from "./constants/pollutants.js";
 
 // SampleSites related imports
 import {
@@ -119,6 +121,7 @@ export {
   MonitorAudit,
   monitorAuditSchema,
   parametersEnum,
+  legacyParametersEnum,
   deploymentTypesEnum,
   AlertsAudit,
   Alerts,
@@ -144,4 +147,7 @@ export {
   samplesAuditSchema,
   SamplesAudit,
   sampleParameterReferenceConcentrations,
+  // Pollutant constants
+  PARAMETERS,
+  HEAVY_METALS,
 };

package/src/models/monitors.js

@@ -1,27 +1,10 @@
 import mongoose from "mongoose";
-const parametersEnum = [
-  "NO2",
-  "SO2",
-  "PM2.5",
-  "PM2_5",
-  "PM10",
-  "Temperature",
-  "Humidity",
-  "OZONE",
-  "O3",
-  "VOC",
-  "CO",
-  "NO",
-  "PM1",
-  "WS",
-  "WD",
-  "WS And Direction",
-  "DP",
-  "CO2",
-  "CH4",
-  "H2S",
-  "BC",
-];
+import { PARAMETERS } from "../constants/pollutants.js";
+
+// Legacy values kept for backwards compatibility — remove after data migration
+const legacyParametersEnum = ["PM2.5", "Temperature", "Humidity", "OZONE", "WS And Direction"];
+
+const parametersEnum = [...Object.keys(PARAMETERS), ...legacyParametersEnum];
 
 const deploymentTypesEnum = {
   STATIONARY: "stationary",
@@ -440,4 +423,4 @@ monitorsSchema.pre("updateMany", async function () {
 // Create the Monitors model
 const Monitors = mongoose.model("Monitors", monitorsSchema);
 
-export { monitorsSchema, Monitors, monitorAuditSchema, MonitorAudit, parametersEnum, deploymentTypesEnum };
+export { monitorsSchema, Monitors, monitorAuditSchema, MonitorAudit, parametersEnum, legacyParametersEnum, deploymentTypesEnum };