@justair/justair-library 7.6.0 → 7.7.0-alpha.1cf63be

package/SECURITY.md

@@ -0,0 +1,21 @@
+# Security Policy
+
+## Supported versions
+
+Security fixes are prioritized for the current default branch and actively supported releases of `JustAir-Solutions/justair-library`. Older or retired versions may not receive fixes.
+
+## Reporting a vulnerability
+
+Do not open a public GitHub issue for a suspected vulnerability.
+
+Send the initial report to `info@justair.co` with the subject `Security vulnerability: justair-library`. Include the affected repository or component, the potential impact, minimal reproduction steps, and a way to contact you.
+
+Do not include passwords, tokens, private keys, personal data, regulated data, or other sensitive payloads in the initial message. Ask for an approved secure transfer method when sensitive evidence is necessary.
+
+## Testing boundaries
+
+This policy does not grant authorization to access data that is not yours, disrupt service, perform denial-of-service testing, use social engineering, destroy data, or establish persistence. Stop testing and report the issue if sensitive data or credentials are encountered.
+
+## Coordinated disclosure
+
+Please allow JustAir reasonable time to investigate and remediate before public disclosure. Receipt of a report does not create a promise of a specific response or remediation timeline.

package/dist/constants/index.d.ts

@@ -4,4 +4,5 @@ export * from "./userNotifications.js";
 export * from "./deviceTypes.js";
 export * from "./timezones.js";
 export * from "./dataDownloads.js";
+export * from "./terms.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/constants/pollutants.d.ts

@@ -6,8 +6,8 @@ export namespace PARAMETERS {
         let unit: string;
         let type: string;
         let rfc: any;
-        let origin: any;
-        let impacts: any;
+        let origin: string;
+        let impacts: string;
     }
     namespace NO2 {
         let id_1: string;
@@ -94,9 +94,9 @@ export namespace PARAMETERS {
         export { type_5 as type };
         let rfc_5: any;
         export { rfc_5 as rfc };
-        let origin_5: any;
+        let origin_5: string;
         export { origin_5 as origin };
-        let impacts_5: any;
+        let impacts_5: string;
         export { impacts_5 as impacts };
     }
     namespace BC {
@@ -112,9 +112,9 @@ export namespace PARAMETERS {
         export { type_6 as type };
         let rfc_6: any;
         export { rfc_6 as rfc };
-        let origin_6: any;
+        let origin_6: string;
         export { origin_6 as origin };
-        let impacts_6: any;
+        let impacts_6: string;
         export { impacts_6 as impacts };
     }
     namespace BRC {
@@ -130,9 +130,9 @@ export namespace PARAMETERS {
         export { type_7 as type };
         let rfc_7: any;
         export { rfc_7 as rfc };
-        let origin_7: any;
+        let origin_7: string;
         export { origin_7 as origin };
-        let impacts_7: any;
+        let impacts_7: string;
         export { impacts_7 as impacts };
     }
     namespace CO2 {
@@ -148,9 +148,9 @@ export namespace PARAMETERS {
         export { type_8 as type };
         let rfc_8: any;
         export { rfc_8 as rfc };
-        let origin_8: any;
+        let origin_8: string;
         export { origin_8 as origin };
-        let impacts_8: any;
+        let impacts_8: string;
         export { impacts_8 as impacts };
     }
     namespace H2S {
@@ -166,9 +166,9 @@ export namespace PARAMETERS {
         export { type_9 as type };
         let rfc_9: any;
         export { rfc_9 as rfc };
-        let origin_9: any;
+        let origin_9: string;
         export { origin_9 as origin };
-        let impacts_9: any;
+        let impacts_9: string;
         export { impacts_9 as impacts };
     }
     namespace CH4 {
@@ -184,9 +184,9 @@ export namespace PARAMETERS {
         export { type_10 as type };
         let rfc_10: any;
         export { rfc_10 as rfc };
-        let origin_10: any;
+        let origin_10: string;
         export { origin_10 as origin };
-        let impacts_10: any;
+        let impacts_10: string;
         export { impacts_10 as impacts };
     }
     namespace NO {
@@ -202,12 +202,12 @@ export namespace PARAMETERS {
         export { type_11 as type };
         let rfc_11: any;
         export { rfc_11 as rfc };
-        let origin_11: any;
+        let origin_11: string;
         export { origin_11 as origin };
-        let impacts_11: any;
+        let impacts_11: string;
         export { impacts_11 as impacts };
     }
-    namespace PM1 {
+    namespace RN {
         let id_12: string;
         export { id_12 as id };
         let label_12: string;
@@ -218,14 +218,14 @@ export namespace PARAMETERS {
         export { unit_12 as unit };
         let type_12: string;
         export { type_12 as type };
-        let rfc_12: any;
+        let rfc_12: number;
         export { rfc_12 as rfc };
-        let origin_12: any;
+        let origin_12: string;
         export { origin_12 as origin };
-        let impacts_12: any;
+        let impacts_12: string;
         export { impacts_12 as impacts };
     }
-    namespace UFP {
+    namespace PM1 {
         let id_13: string;
         export { id_13 as id };
         let label_13: string;
@@ -238,12 +238,12 @@ export namespace PARAMETERS {
         export { type_13 as type };
         let rfc_13: any;
         export { rfc_13 as rfc };
-        let origin_13: any;
+        let origin_13: string;
         export { origin_13 as origin };
-        let impacts_13: any;
+        let impacts_13: string;
         export { impacts_13 as impacts };
     }
-    namespace VOC {
+    namespace UFP {
         let id_14: string;
         export { id_14 as id };
         let label_14: string;
@@ -256,12 +256,12 @@ export namespace PARAMETERS {
         export { type_14 as type };
         let rfc_14: any;
         export { rfc_14 as rfc };
-        let origin_14: any;
+        let origin_14: string;
         export { origin_14 as origin };
-        let impacts_14: any;
+        let impacts_14: string;
         export { impacts_14 as impacts };
     }
-    namespace DP {
+    namespace VOC {
         let id_15: string;
         export { id_15 as id };
         let label_15: string;
@@ -274,12 +274,12 @@ export namespace PARAMETERS {
         export { type_15 as type };
         let rfc_15: any;
         export { rfc_15 as rfc };
-        let origin_15: any;
+        let origin_15: string;
         export { origin_15 as origin };
-        let impacts_15: any;
+        let impacts_15: string;
         export { impacts_15 as impacts };
     }
-    namespace DP_AMB {
+    namespace DP {
         let id_16: string;
         export { id_16 as id };
         let label_16: string;
@@ -297,7 +297,7 @@ export namespace PARAMETERS {
         let impacts_16: any;
         export { impacts_16 as impacts };
     }
-    namespace RH {
+    namespace DP_AMB {
         let id_17: string;
         export { id_17 as id };
         let label_17: string;
@@ -315,7 +315,7 @@ export namespace PARAMETERS {
         let impacts_17: any;
         export { impacts_17 as impacts };
     }
-    namespace RH_AMB {
+    namespace RH {
         let id_18: string;
         export { id_18 as id };
         let label_18: string;
@@ -333,7 +333,7 @@ export namespace PARAMETERS {
         let impacts_18: any;
         export { impacts_18 as impacts };
     }
-    namespace T {
+    namespace RH_AMB {
         let id_19: string;
         export { id_19 as id };
         let label_19: string;
@@ -351,7 +351,7 @@ export namespace PARAMETERS {
         let impacts_19: any;
         export { impacts_19 as impacts };
     }
-    namespace T_AMB {
+    namespace T {
         let id_20: string;
         export { id_20 as id };
         let label_20: string;
@@ -369,7 +369,7 @@ export namespace PARAMETERS {
         let impacts_20: any;
         export { impacts_20 as impacts };
     }
-    namespace WD {
+    namespace T_AMB {
         let id_21: string;
         export { id_21 as id };
         let label_21: string;
@@ -387,7 +387,7 @@ export namespace PARAMETERS {
         let impacts_21: any;
         export { impacts_21 as impacts };
     }
-    namespace WS {
+    namespace WD {
         let id_22: string;
         export { id_22 as id };
         let label_22: string;
@@ -405,7 +405,7 @@ export namespace PARAMETERS {
         let impacts_22: any;
         export { impacts_22 as impacts };
     }
-    namespace GS {
+    namespace WS {
         let id_23: string;
         export { id_23 as id };
         let label_23: string;
@@ -423,7 +423,7 @@ export namespace PARAMETERS {
         let impacts_23: any;
         export { impacts_23 as impacts };
     }
-    namespace R {
+    namespace GS {
         let id_24: string;
         export { id_24 as id };
         let label_24: string;
@@ -441,7 +441,7 @@ export namespace PARAMETERS {
         let impacts_24: any;
         export { impacts_24 as impacts };
     }
-    namespace SR {
+    namespace R {
         let id_25: string;
         export { id_25 as id };
         let label_25: string;
@@ -459,7 +459,7 @@ export namespace PARAMETERS {
         let impacts_25: any;
         export { impacts_25 as impacts };
     }
-    namespace P {
+    namespace SR {
         let id_26: string;
         export { id_26 as id };
         let label_26: string;
@@ -477,7 +477,7 @@ export namespace PARAMETERS {
         let impacts_26: any;
         export { impacts_26 as impacts };
     }
-    namespace PAR {
+    namespace P {
         let id_27: string;
         export { id_27 as id };
         let label_27: string;
@@ -495,7 +495,7 @@ export namespace PARAMETERS {
         let impacts_27: any;
         export { impacts_27 as impacts };
     }
-    namespace ARM {
+    namespace PAR {
         let id_28: string;
         export { id_28 as id };
         let label_28: string;
@@ -513,7 +513,7 @@ export namespace PARAMETERS {
         let impacts_28: any;
         export { impacts_28 as impacts };
     }
-    namespace ARW {
+    namespace ARM {
         let id_29: string;
         export { id_29 as id };
         let label_29: string;
@@ -531,7 +531,7 @@ export namespace PARAMETERS {
         let impacts_29: any;
         export { impacts_29 as impacts };
     }
-    namespace ARD {
+    namespace ARW {
         let id_30: string;
         export { id_30 as id };
         let label_30: string;
@@ -549,7 +549,7 @@ export namespace PARAMETERS {
         let impacts_30: any;
         export { impacts_30 as impacts };
     }
-    namespace ARH {
+    namespace ARD {
         let id_31: string;
         export { id_31 as id };
         let label_31: string;
@@ -567,9 +567,7 @@ export namespace PARAMETERS {
         let impacts_31: any;
         export { impacts_31 as impacts };
     }
-}
-export namespace HEAVY_METALS {
-    export namespace AS {
+    namespace ARH {
         let id_32: string;
         export { id_32 as id };
         let label_32: string;
@@ -580,14 +578,16 @@ export namespace HEAVY_METALS {
         export { unit_32 as unit };
         let type_32: string;
         export { type_32 as type };
-        let rfc_32: number;
+        let rfc_32: any;
         export { rfc_32 as rfc };
-        let origin_32: string;
+        let origin_32: any;
         export { origin_32 as origin };
-        let impacts_32: string;
+        let impacts_32: any;
         export { impacts_32 as impacts };
     }
-    export namespace BA {
+}
+export namespace HEAVY_METALS {
+    export namespace AS {
         let id_33: string;
         export { id_33 as id };
         let label_33: string;
@@ -598,14 +598,14 @@ export namespace HEAVY_METALS {
         export { unit_33 as unit };
         let type_33: string;
         export { type_33 as type };
-        let rfc_33: any;
+        let rfc_33: number;
         export { rfc_33 as rfc };
         let origin_33: string;
         export { origin_33 as origin };
         let impacts_33: string;
         export { impacts_33 as impacts };
     }
-    export namespace C6H6 {
+    export namespace BA {
         let id_34: string;
         export { id_34 as id };
         let label_34: string;
@@ -616,14 +616,14 @@ export namespace HEAVY_METALS {
         export { unit_34 as unit };
         let type_34: string;
         export { type_34 as type };
-        let rfc_34: number;
+        let rfc_34: any;
         export { rfc_34 as rfc };
         let origin_34: string;
         export { origin_34 as origin };
         let impacts_34: string;
         export { impacts_34 as impacts };
     }
-    export namespace BE {
+    export namespace C6H6 {
         let id_35: string;
         export { id_35 as id };
         let label_35: string;
@@ -641,7 +641,7 @@ export namespace HEAVY_METALS {
         let impacts_35: string;
         export { impacts_35 as impacts };
     }
-    export namespace CD {
+    export namespace BE {
         let id_36: string;
         export { id_36 as id };
         let label_36: string;
@@ -659,7 +659,7 @@ export namespace HEAVY_METALS {
         let impacts_36: string;
         export { impacts_36 as impacts };
     }
-    export namespace CR {
+    export namespace CD {
         let id_37: string;
         export { id_37 as id };
         let label_37: string;
@@ -677,7 +677,7 @@ export namespace HEAVY_METALS {
         let impacts_37: string;
         export { impacts_37 as impacts };
     }
-    export namespace CO_1 {
+    export namespace CR {
         let id_38: string;
         export { id_38 as id };
         let label_38: string;
@@ -688,15 +688,14 @@ export namespace HEAVY_METALS {
         export { unit_38 as unit };
         let type_38: string;
         export { type_38 as type };
-        let rfc_38: any;
+        let rfc_38: number;
         export { rfc_38 as rfc };
         let origin_38: string;
         export { origin_38 as origin };
         let impacts_38: string;
         export { impacts_38 as impacts };
     }
-    export { CO_1 as CO };
-    export namespace CU {
+    export namespace CO_1 {
         let id_39: string;
         export { id_39 as id };
         let label_39: string;
@@ -714,7 +713,8 @@ export namespace HEAVY_METALS {
         let impacts_39: string;
         export { impacts_39 as impacts };
     }
-    export namespace FE {
+    export { CO_1 as CO };
+    export namespace CU {
         let id_40: string;
         export { id_40 as id };
         let label_40: string;
@@ -732,7 +732,7 @@ export namespace HEAVY_METALS {
         let impacts_40: string;
         export { impacts_40 as impacts };
     }
-    export namespace PB {
+    export namespace FE {
         let id_41: string;
         export { id_41 as id };
         let label_41: string;
@@ -743,14 +743,14 @@ export namespace HEAVY_METALS {
         export { unit_41 as unit };
         let type_41: string;
         export { type_41 as type };
-        let rfc_41: number;
+        let rfc_41: any;
         export { rfc_41 as rfc };
         let origin_41: string;
         export { origin_41 as origin };
         let impacts_41: string;
         export { impacts_41 as impacts };
     }
-    export namespace MN {
+    export namespace PB {
         let id_42: string;
         export { id_42 as id };
         let label_42: string;
@@ -768,7 +768,7 @@ export namespace HEAVY_METALS {
         let impacts_42: string;
         export { impacts_42 as impacts };
     }
-    export namespace NI {
+    export namespace MN {
         let id_43: string;
         export { id_43 as id };
         let label_43: string;
@@ -779,14 +779,14 @@ export namespace HEAVY_METALS {
         export { unit_43 as unit };
         let type_43: string;
         export { type_43 as type };
-        let rfc_43: any;
+        let rfc_43: number;
         export { rfc_43 as rfc };
         let origin_43: string;
         export { origin_43 as origin };
         let impacts_43: string;
         export { impacts_43 as impacts };
     }
-    export namespace SE {
+    export namespace NI {
         let id_44: string;
         export { id_44 as id };
         let label_44: string;
@@ -804,7 +804,7 @@ export namespace HEAVY_METALS {
         let impacts_44: string;
         export { impacts_44 as impacts };
     }
-    export namespace ZN {
+    export namespace SE {
         let id_45: string;
         export { id_45 as id };
         let label_45: string;
@@ -822,5 +822,23 @@ export namespace HEAVY_METALS {
         let impacts_45: string;
         export { impacts_45 as impacts };
     }
+    export namespace ZN {
+        let id_46: string;
+        export { id_46 as id };
+        let label_46: string;
+        export { label_46 as label };
+        let name_46: string;
+        export { name_46 as name };
+        let unit_46: string;
+        export { unit_46 as unit };
+        let type_46: string;
+        export { type_46 as type };
+        let rfc_46: any;
+        export { rfc_46 as rfc };
+        let origin_46: string;
+        export { origin_46 as origin };
+        let impacts_46: string;
+        export { impacts_46 as impacts };
+    }
 }
 //# sourceMappingURL=pollutants.d.ts.map

package/dist/constants/terms.d.ts

@@ -0,0 +1,2 @@
+export const TERMS_VERSION_MAX_LENGTH: 32;
+//# sourceMappingURL=terms.d.ts.map

package/dist/constants/terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terms.d.ts","sourceRoot":"","sources":["../../src/constants/terms.js"],"names":[],"mappings":"AAaA,0CAA2C"}

package/dist/index.d.ts

@@ -103,6 +103,7 @@ import { PARAMETERS } from "./constants/pollutants.js";
 import { HEAVY_METALS } from "./constants/pollutants.js";
 import { ALERT_LEVEL_WEIGHTS } from "./constants/alertLevels.js";
 import { getAlertWeight } from "./constants/alertLevels.js";
+import { TERMS_VERSION_MAX_LENGTH } from "./constants/terms.js";
 import { DEVICE_TYPES } from "./constants/deviceTypes.js";
 import { DEVICE_TYPE_VALUES } from "./constants/deviceTypes.js";
 import { isAqiCapableDeviceType } from "./constants/deviceTypes.js";
@@ -121,5 +122,5 @@ import { validateQuietHours } from "./utils/quietHours.js";
 import { getZoneMinutes } from "./utils/quietHours.js";
 import { isInQuietWindow } from "./utils/quietHours.js";
 import { resolveQuietHours } from "./utils/quietHours.js";
-export { Database, adminSchema, Admin, configurationsSchema, Configurations, measurementsSchema, Measurements, monitorRequestsSchema, MonitorRequests, monitorsSchema, Monitors, organizationsSchema, Organizations, usersSchema, Users, COOKIE_CONSENT_CATEGORIES, COOKIE_CONSENT_VALUES, validateCookieConsent, 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, changeStreamCheckpointsSchema, ChangeStreamCheckpoints, sitesSchema, Sites, sampleSitesSchema, SampleSites, sampleSiteAuditSchema, SampleSiteAudit, sampleParametersEnum, samplesSchema, Samples, samplesAuditSchema, SamplesAudit, sampleParameterReferenceConcentrations, passwordResetTokenSchema, PasswordResetToken, monitorEpisodesSchema, MonitorEpisode, userNotificationsSchema, UserNotification, AqiAlertNotification, DeviceOfflineNotification, WeeklyDigestNotification, AccountNotification, NOTIFICATION_KINDS, NOTIFICATION_CHANNELS, DELIVERY_STATUSES, DATA_DOWNLOAD_TYPES, dataDownloadSchema, DataDownloads, AqiDataDownload, SampleDataDownload, DATA_DOWNLOAD_MAX_RANGE_DAYS, DATA_DOWNLOAD_ERRORS, validateDataDownloadDateOrder, validateDataDownloadMaxDateRange, validateDataDownloadEmail, normalizeDataDownloadEmail, validateDataDownloadTimezone, normalizeDataDownloadTimezone, PARAMETERS, HEAVY_METALS, ALERT_LEVEL_WEIGHTS, getAlertWeight, DEVICE_TYPES, DEVICE_TYPE_VALUES, isAqiCapableDeviceType, AQI_CAPABLE_DEVICE_TYPES, projectSubscribedMonitors, resolveSubscribedMonitorIdsByUser, VISIBLE_SITE_MONITOR_FILTER, SUBSCRIBED_DEVICES_ERRORS, splitName, DEFAULT_QUIET_HOURS, DEFAULT_TIMEZONE, QUIET_HOURS_ERRORS, isValidTimeString, isValidIANATimezone, validateQuietHours, getZoneMinutes, isInQuietWindow, resolveQuietHours };
+export { Database, adminSchema, Admin, configurationsSchema, Configurations, measurementsSchema, Measurements, monitorRequestsSchema, MonitorRequests, monitorsSchema, Monitors, organizationsSchema, Organizations, usersSchema, Users, COOKIE_CONSENT_CATEGORIES, COOKIE_CONSENT_VALUES, validateCookieConsent, 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, changeStreamCheckpointsSchema, ChangeStreamCheckpoints, sitesSchema, Sites, sampleSitesSchema, SampleSites, sampleSiteAuditSchema, SampleSiteAudit, sampleParametersEnum, samplesSchema, Samples, samplesAuditSchema, SamplesAudit, sampleParameterReferenceConcentrations, passwordResetTokenSchema, PasswordResetToken, monitorEpisodesSchema, MonitorEpisode, userNotificationsSchema, UserNotification, AqiAlertNotification, DeviceOfflineNotification, WeeklyDigestNotification, AccountNotification, NOTIFICATION_KINDS, NOTIFICATION_CHANNELS, DELIVERY_STATUSES, DATA_DOWNLOAD_TYPES, dataDownloadSchema, DataDownloads, AqiDataDownload, SampleDataDownload, DATA_DOWNLOAD_MAX_RANGE_DAYS, DATA_DOWNLOAD_ERRORS, validateDataDownloadDateOrder, validateDataDownloadMaxDateRange, validateDataDownloadEmail, normalizeDataDownloadEmail, validateDataDownloadTimezone, normalizeDataDownloadTimezone, PARAMETERS, HEAVY_METALS, ALERT_LEVEL_WEIGHTS, getAlertWeight, TERMS_VERSION_MAX_LENGTH, DEVICE_TYPES, DEVICE_TYPE_VALUES, isAqiCapableDeviceType, AQI_CAPABLE_DEVICE_TYPES, projectSubscribedMonitors, resolveSubscribedMonitorIdsByUser, VISIBLE_SITE_MONITOR_FILTER, SUBSCRIBED_DEVICES_ERRORS, splitName, DEFAULT_QUIET_HOURS, DEFAULT_TIMEZONE, QUIET_HOURS_ERRORS, isValidTimeString, isValidIANATimezone, validateQuietHours, getZoneMinutes, isInQuietWindow, resolveQuietHours };
 //# 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":"AAyKA;;;iBAEC;yBAtGwB,oBAAoB;qBADxB,gBAAgB;4BApEF,mBAAmB;sBAAnB,mBAAmB;qCAI/C,4BAA4B;+BAA5B,4BAA4B;mCAM5B,0BAA0B;6BAA1B,0BAA0B;sCAI1B,6BAA6B;gCAA7B,6BAA6B;+BAQ7B,sBAAsB;yBAAtB,sBAAsB;oCACsB,2BAA2B;8BAA3B,2BAA2B;4BAcvE,mBAAmB;sBAAnB,mBAAmB;0CAAnB,mBAAmB;sCAAnB,mBAAmB;sCAAnB,mBAAmB;6BAMnB,oBAAoB;uBAApB,oBAAoB;mCAnBuB,2BAA2B;8BAA3B,2BAA2B;uCAItE,8BAA8B;iCAA9B,8BAA8B;+BACI,sBAAsB;yBAAtB,sBAAsB;iCAClB,wBAAwB;2BAAxB,wBAAwB;mCAcnB,2BAA2B;8BAA3B,2BAA2B;2BAC5C,kBAAkB;qBAAlB,kBAAkB;6BACd,oBAAoB;uBAApB,oBAAoB;6BACR,0BAA0B;mCAA1B,0BAA0B;sBArCpE,0BAA0B;4BAA1B,0BAA0B;4BAiC1B,oBAAoB;kCAApB,oBAAoB;6BArBpB,sBAAsB;mCAAtB,sBAAsB;+BAAtB,sBAAsB;oCAAtB,sBAAsB;4BA+BtB,oBAAoB;uBAApB,oBAAoB;6BAApB,oBAAoB;kCAApB,oBAAoB;yBACc,sBAAsB;+BAAtB,sBAAsB;uCAIxD,8BAA8B;iCAA9B,8BAA8B;qCAI9B,4BAA4B;+BAA5B,4BAA4B;mCACc,0BAA0B;6BAA1B,0BAA0B;8CAIpE,qCAAqC;wCAArC,qCAAqC;4BAkDT,mBAAmB;sBAAnB,mBAAmB;kCAS/C,yBAAyB;4BAAzB,yBAAyB;sCAAzB,yBAAyB;gCAAzB,yBAAyB;qCAAzB,yBAAyB;8BASzB,qBAAqB;wBAArB,qBAAqB;mCAArB,qBAAqB;6BAArB,qBAAqB;uDAArB,qBAAqB;yCAIrB,gCAAgC;mCAAhC,gCAAgC;sCArDhC,6BAA6B;+BAA7B,6BAA6B;wCAW7B,+BAA+B;iCAA/B,+BAA+B;qCAA/B,+BAA+B;0CAA/B,+BAA+B;yCAA/B,+BAA+B;oCAA/B,+BAA+B;mCAA/B,+BAA+B;sCAA/B,+BAA+B;kCAA/B,+BAA+B;oCArBF,8BAA8B;mCAqE3D,2BAA2B;8BAA3B,2BAA2B;gCAA3B,2BAA2B;mCAA3B,2BAA2B;+DAsB3B,mCAAmC;qCAAnC,mCAAmC;mEAAnC,mCAAmC;yEAAnC,mCAAmC;mEAAnC,mCAAmC;qEAAnC,mCAAmC;yEAAnC,mCAAmC;2EAAnC,mCAAmC;2BAjGD,2BAA2B;6BAA3B,2BAA2B;oCAI7D,4BAA4B;+BAA5B,4BAA4B;6BAQ5B,4BAA4B;mCAA5B,4BAA4B;uCAA5B,4BAA4B;yCAA5B,4BAA4B;0CAgC5B,8BAA8B;kDAA9B,8BAA8B;4CAA9B,8BAA8B;0CAA9B,8BAA8B;0BAhBX,sBAAsB;oCASzC,uBAAuB;iCAhCG,0BAA0B;mCAgCpD,uBAAuB;kCAAvB,uBAAuB;oCACM,qBAAqB;mCADlD,uBAAuB;+BAAvB,uBAAuB;gCAAvB,uBAAuB;kCAAvB,uBAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AA0KA;;;iBAEC;yBAvGwB,oBAAoB;qBADxB,gBAAgB;4BApEF,mBAAmB;sBAAnB,mBAAmB;qCAI/C,4BAA4B;+BAA5B,4BAA4B;mCAM5B,0BAA0B;6BAA1B,0BAA0B;sCAI1B,6BAA6B;gCAA7B,6BAA6B;+BAQ7B,sBAAsB;yBAAtB,sBAAsB;oCACsB,2BAA2B;8BAA3B,2BAA2B;4BAcvE,mBAAmB;sBAAnB,mBAAmB;0CAAnB,mBAAmB;sCAAnB,mBAAmB;sCAAnB,mBAAmB;6BAMnB,oBAAoB;uBAApB,oBAAoB;mCAnBuB,2BAA2B;8BAA3B,2BAA2B;uCAItE,8BAA8B;iCAA9B,8BAA8B;+BACI,sBAAsB;yBAAtB,sBAAsB;iCAClB,wBAAwB;2BAAxB,wBAAwB;mCAcnB,2BAA2B;8BAA3B,2BAA2B;2BAC5C,kBAAkB;qBAAlB,kBAAkB;6BACd,oBAAoB;uBAApB,oBAAoB;6BACR,0BAA0B;mCAA1B,0BAA0B;sBArCpE,0BAA0B;4BAA1B,0BAA0B;4BAiC1B,oBAAoB;kCAApB,oBAAoB;6BArBpB,sBAAsB;mCAAtB,sBAAsB;+BAAtB,sBAAsB;oCAAtB,sBAAsB;4BA+BtB,oBAAoB;uBAApB,oBAAoB;6BAApB,oBAAoB;kCAApB,oBAAoB;yBACc,sBAAsB;+BAAtB,sBAAsB;uCAIxD,8BAA8B;iCAA9B,8BAA8B;qCAI9B,4BAA4B;+BAA5B,4BAA4B;mCACc,0BAA0B;6BAA1B,0BAA0B;8CAIpE,qCAAqC;wCAArC,qCAAqC;4BAmDT,mBAAmB;sBAAnB,mBAAmB;kCAS/C,yBAAyB;4BAAzB,yBAAyB;sCAAzB,yBAAyB;gCAAzB,yBAAyB;qCAAzB,yBAAyB;8BASzB,qBAAqB;wBAArB,qBAAqB;mCAArB,qBAAqB;6BAArB,qBAAqB;uDAArB,qBAAqB;yCAIrB,gCAAgC;mCAAhC,gCAAgC;sCArDhC,6BAA6B;+BAA7B,6BAA6B;wCAW7B,+BAA+B;iCAA/B,+BAA+B;qCAA/B,+BAA+B;0CAA/B,+BAA+B;yCAA/B,+BAA+B;oCAA/B,+BAA+B;mCAA/B,+BAA+B;sCAA/B,+BAA+B;kCAA/B,+BAA+B;oCAtBF,8BAA8B;mCAsE3D,2BAA2B;8BAA3B,2BAA2B;gCAA3B,2BAA2B;mCAA3B,2BAA2B;+DAsB3B,mCAAmC;qCAAnC,mCAAmC;mEAAnC,mCAAmC;yEAAnC,mCAAmC;mEAAnC,mCAAmC;qEAAnC,mCAAmC;yEAAnC,mCAAmC;2EAAnC,mCAAmC;2BAlGD,2BAA2B;6BAA3B,2BAA2B;oCAI7D,4BAA4B;+BAA5B,4BAA4B;yCAGM,sBAAsB;6BAMxD,4BAA4B;mCAA5B,4BAA4B;uCAA5B,4BAA4B;yCAA5B,4BAA4B;0CAgC5B,8BAA8B;kDAA9B,8BAA8B;4CAA9B,8BAA8B;0CAA9B,8BAA8B;0BAhBX,sBAAsB;oCASzC,uBAAuB;iCAjCG,0BAA0B;mCAiCpD,uBAAuB;kCAAvB,uBAAuB;oCACM,qBAAqB;mCADlD,uBAAuB;+BAAvB,uBAAuB;gCAAvB,uBAAuB;kCAAvB,uBAAuB"}

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

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/models/users.js"],"names":[],"mappings":"AA6FA,8BA0GE;AAiCF,wBAAmD;AA/NnD,iDAA4D;AAC5D,6CAAmD;AAUnD,4DA0BC"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/models/users.js"],"names":[],"mappings":"AA8FA,8BAuIE;AAiCF,wBAAmD;AA5PnD,iDAA4D;AAC5D,6CAAmD;AAUnD,4DA0BC"}

package/package.json

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

package/src/constants/index.js

@@ -13,3 +13,4 @@ export * from "./userNotifications.js";
 export * from "./deviceTypes.js";
 export * from "./timezones.js";
 export * from "./dataDownloads.js";
+export * from "./terms.js";

package/src/constants/pollutants.js

@@ -8,8 +8,8 @@ export const PARAMETERS = {
     unit: "ppm",
     type: "Gas",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Made when fuel burns without enough oxygen. Comes mostly from car exhaust outdoors, and from heaters, furnaces, and gas stoves indoors. Has no color or smell.",
+    impacts: "Makes it harder for blood to carry oxygen to the heart and brain. High indoor levels can cause confusion, passing out, or death.",
   },
   NO2: {
     id: "NO2",
@@ -18,7 +18,7 @@ export const PARAMETERS = {
     unit: "ppb",
     type: "Gas",
     rfc: null,
-    origin: "Harmful gas from cars, power plants, and industrial equipment that contributes to smog and acid rain.",
+    origin: "Harmful gas from cars, power plants, and industrial equipment that contributes to smog and acid rain. Smells sharp and bitter.",
     impacts: "Can cause respiratory problems, worsen asthma and bronchitis, and increase heart-related health risks.",
   },
   O3: {
@@ -28,7 +28,7 @@ export const PARAMETERS = {
     unit: "ppm",
     type: "Gas",
     rfc: null,
-    origin: "Harmful smog component formed when pollution reacts with sunlight, especially problematic on hot, sunny days.",
+    origin: "Harmful smog component formed when pollution reacts with sunlight, especially problematic on hot, sunny days. Smell described as fresh or clean.",
     impacts: "Can irritate lungs, intensify asthma and chronic bronchitis, and increase heart problems and mortality rates.",
   },
   PM2_5: {
@@ -58,8 +58,8 @@ export const PARAMETERS = {
     unit: "ppb",
     type: "Gas",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Comes mostly from burning fossil fuels at power plants and factories. Smaller amounts come from metal processing and volcanoes. Smells sharp or pungent.",
+    impacts: "Can make it hard to breathe and irritate the lungs, especially for people with asthma. Also helps form fine particle pollution and acid rain.",
   },
   BC: {
     id: "BC",
@@ -68,8 +68,8 @@ export const PARAMETERS = {
     unit: "ng/m³",
     type: "Particulate Matter",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Black, sooty particles from burning fuel. Comes mostly from diesel and gas engines, coal power plants, and cookstoves that burn wood or coal. A major part of fine particle matter (PM2.5) in the air.",
+    impacts: "Can cause respiratory and cardiovascular disease, including asthma, heart attacks, and lung cancer.",
   },
   BRC: {
     id: "BRC",
@@ -78,8 +78,8 @@ export const PARAMETERS = {
     unit: "ng/m³",
     type: "Particulate Matter",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Organic particles released by burning wood and plants, especially in wildfire smoke and wood fires at home.",
+    impacts: "Can cause respiratory and cardiovascular illnesses, exacerbate asthma, and increase mortality risk with prolonged exposure.",
   },
   CO2: {
     id: "CO2",
@@ -88,28 +88,28 @@ export const PARAMETERS = {
     unit: "ppm",
     type: "Gas",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Comes mostly from burning fossil fuels, plus burning waste and plant material, and industrial processes like making cement. Has no color or smell.",
+    impacts: "Can cause drowsiness and reduced concentration, worsen headaches and fatigue, and increase breathing and heart-related health risks.",
   },
   H2S: {
     id: "H2S",
     label: "H₂S",
-    name: "Hydrogen Sulfide (H₂S)",
+    name: "Hydrogen sulfide (H₂S)",
     unit: "ppm",
-    type: "Volatile Organic Compound",
+    type: "Gas",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Found naturally in crude oil, natural gas, and volcanic gas. Also released by oil refineries, wastewater plants, farms with livestock, and landfills. Smells of rotten-eggs.",
+    impacts: "Low levels over a long time can irritate eyes and airways and cause headaches or nausea. Very high levels can cause someone to pass out or die.",
   },
   CH4: {
     id: "CH4",
     label: "CH₄",
     name: "Methane (CH₄)",
     unit: "ppm",
-    type: "Volatile Organic Compound",
+    type: "Gas",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Comes from landfills, oil and gas drilling, livestock and farming, coal mines, and wastewater treatment. Has no natural smell, sometimes it is added to detect leaks.",
+    impacts: "Not harmful to breathe at normal outdoor levels. In a closed space, high levels can push out oxygen and cause dizziness or passing out. It also heats the planet, since it traps heat in the air like other gases that cause climate change.",
   },
   NO: {
     id: "NO",
@@ -118,8 +118,18 @@ export const PARAMETERS = {
     unit: "ppb",
     type: "Gas",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Made when fuel burns in car engines, power plants, and factories. Turns into NO2 once it's in the air. Smells sharp and sweet.",
+    impacts: "Can irritate the eyes, nose, throat, and lungs at low levels, and cause serious airway damage, fluid buildup in the lungs, and death at high levels.",
+  },
+  RN: {
+    id: "RN",
+    label: "Radon",
+    name: "Radon (Rn)",
+    unit: "pCi/L",
+    type: "Gas",
+    rfc: 4, // doc states ">= 4pCi/L"; rfc is numeric, so the threshold value only
+    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.",
   },
   PM1: {
     id: "PM1",
@@ -128,8 +138,8 @@ export const PARAMETERS = {
     unit: "µg/m³",
     type: "Particulate Matter",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Very fine 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.",
   },
   UFP: {
     id: "UFP",
@@ -138,18 +148,18 @@ export const PARAMETERS = {
     unit: "pt/cm³",
     type: "Particulate Matter",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Very tiny particles from burning fuel, especially from cars, trucks, factories, power plants, and home heating.",
+    impacts: "Can raise the risk of lung and heart disease.",
   },
   VOC: {
     id: "VOC",
     label: "VOC",
-    name: "Volatile Organic Compounds (VOC)",
+    name: "Volatile organic compounds (VOC)",
     unit: "ppm",
     type: "Volatile Organic Compound",
     rfc: null,
-    origin: null,
-    impacts: null,
+    origin: "Released when making or using everyday products like paint, cleaning supplies, solvents, and fuel.",
+    impacts: "Can harm health when breathed in indoors. Outdoors, reacts with sunlight to form smog. Some VOCs can cause cancer.",
   },
   // ---- T/RH/DP and their _AMB pairs (JA-3058). Does not apply to WD/WS below. ----
   // Bare ids (T/RH/DP) are enclosure-internal, for corrections and fog detection only. The _AMB

package/src/constants/terms.js

@@ -0,0 +1,14 @@
+// Terms-of-service agreement vocabulary.
+//
+// Users.termsVersion stores the policy-document version a public user agreed
+// to at registration (e.g. "2026.1" — the published doc's tab name). The
+// VALUE is owned by the frontend signup flow; nothing in the
+// backend hardcodes a current version, so there is deliberately no
+// TERMS_CURRENT_VERSION constant here.
+//
+// The cap below is the one number shared by the two enforcement points in
+// different repos: the Users schema (`maxlength`) and JustAirUserService's
+// registration route validator. Import it from either barrel rather than
+// inlining the literal — if the two drift, the route accepts what the schema
+// rejects and a signup 500s instead of 400ing.
+export const TERMS_VERSION_MAX_LENGTH = 32;

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

@@ -8,6 +8,7 @@ import { PARAMETERS, HEAVY_METALS } from '../pollutants.js';
 import { ALERT_LEVEL_WEIGHTS, getAlertWeight } from '../alertLevels.js';
 import { DEFAULT_TIMEZONE } from '../timezones.js';
 import { DATA_DOWNLOAD_TYPES } from '../dataDownloads.js';
+import { TERMS_VERSION_MAX_LENGTH } from '../terms.js';
 
 test('barrel re-exports the pollutants constants unchanged (identity, not copies)', () => {
   expect(barrel.PARAMETERS).toBe(PARAMETERS);
@@ -56,6 +57,11 @@ test('barrel exports DATA_DOWNLOAD_TYPES (browser-safe, no Mongoose)', () => {
   expect(barrel.DATA_DOWNLOAD_TYPES).toBe(DATA_DOWNLOAD_TYPES);
 });
 
+test('barrel exports TERMS_VERSION_MAX_LENGTH (browser-safe, no Mongoose)', () => {
+  expect(barrel.TERMS_VERSION_MAX_LENGTH).toBe(TERMS_VERSION_MAX_LENGTH);
+  expect(TERMS_VERSION_MAX_LENGTH).toBe(32);
+});
+
 // models/dataDownloads.js destructures this list positionally to build the two
 // discriminators, so a reorder would silently swap the persisted dataType
 // values on every future download. Pin contents AND order.

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

@@ -67,8 +67,26 @@ function sharedAssertions(constants) {
   });
 }
 
+// JA-3460: the public UI now renders concentration data for non-AQI pollutants, so every
+// pollutant it can show 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");
+
+  test.each(pollutants)("%s: origin is populated", (key, pollutant) => {
+    expect(typeof pollutant.origin).toBe("string");
+    expect(pollutant.origin.trim().length).toBeGreaterThan(0);
+  });
+
+  test.each(pollutants)("%s: impacts is populated", (key, pollutant) => {
+    expect(typeof pollutant.impacts).toBe("string");
+    expect(pollutant.impacts.trim().length).toBeGreaterThan(0);
+  });
+}
+
 describe("PARAMETERS", () => {
   sharedAssertions(PARAMETERS);
+  hasOriginAndImpacts(PARAMETERS);
 
   // JA-3060: Processing-Engine hardcodes these ids, so lock the ambient/internal pairing.
   const ambientKeys = Object.keys(PARAMETERS).filter((key) => key.endsWith("_AMB"));
@@ -87,6 +105,7 @@ describe("PARAMETERS", () => {
 
 describe("HEAVY_METALS", () => {
   sharedAssertions(HEAVY_METALS);
+  hasOriginAndImpacts(HEAVY_METALS);
 
   test("PB.rfc is exactly 0, not null", () => {
     expect(HEAVY_METALS.PB.rfc).toBe(0);

package/src/index.js

@@ -75,6 +75,7 @@ import {
 } from "./constants/alertLevels.js";
 import { DEFAULT_TIMEZONE } from "./constants/timezones.js";
 import { DATA_DOWNLOAD_TYPES } from "./constants/dataDownloads.js";
+import { TERMS_VERSION_MAX_LENGTH } from "./constants/terms.js";
 import {
   DEVICE_TYPES,
   DEVICE_TYPE_VALUES,
@@ -280,6 +281,9 @@ export {
   // AQI alert-level hierarchy (single source of truth)
   ALERT_LEVEL_WEIGHTS,
   getAlertWeight,
+  // Terms agreement (JA-3396) — cap shared by the Users schema and
+  // JustAirUserService's registration route validator
+  TERMS_VERSION_MAX_LENGTH,
   // V2 device-type vocabulary (single source of truth) — JA-3110 / JA-3335
   DEVICE_TYPES,
   DEVICE_TYPE_VALUES,

package/src/models/users.js

@@ -6,6 +6,7 @@ import {
   QUIET_HOURS_ERRORS,
 } from "../utils/quietHours.js";
 import { DEVICE_TYPE_VALUES } from "../constants/deviceTypes.js";
+import { TERMS_VERSION_MAX_LENGTH } from "../constants/terms.js";
 
 const COOKIE_CONSENT_CATEGORIES = ["analytics_performance"];
 const COOKIE_CONSENT_VALUES = ["accept", "reject"];
@@ -193,6 +194,35 @@ const usersSchema = mongoose.Schema(
         message: "timezone must be a valid IANA timezone identifier",
       },
     },
+    // Terms agreement: the policy-document version the user agreed to at
+    // registration (e.g. "2026.1"). The client supplies the value (the signup
+    // FE owns it); the backend never hardcodes a
+    // current version. Written once at account creation — `immutable` means
+    // save() mutations are ignored and strict-mode query updates are
+    // stripped, silently by design; treat any need to change it as a product
+    // decision, not a bug. Absent = registered before terms tracking existed
+    // (or a legacy client that sent only { phone }); absence is legal
+    // forever. Deliberately NO acceptance boolean (an account cannot be
+    // created without pressing "I Agree", so it would be true on every
+    // record) and NO separate acceptance timestamp — createdAt IS the
+    // agreement date (grooming decision, 2026-09-03).
+    //
+    // Blank guard: immutability makes a stored value permanent, so a blank,
+    // padded, or null value ("" / "  2026.1" / null) would be an
+    // uncorrectable third state — looks present, records nothing. The custom
+    // validator (not minlength, which skips null) rejects all three here as
+    // the backstop; the registration route validator (JA-3397) is the
+    // primary 400 path, both sharing TERMS_VERSION_MAX_LENGTH.
+    termsVersion: {
+      type: String,
+      trim: true,
+      immutable: true,
+      maxlength: TERMS_VERSION_MAX_LENGTH,
+      validate: {
+        validator: (v) => typeof v === "string" && v.length > 0,
+        message: "termsVersion must be a non-empty string",
+      },
+    },
   },
   {
     timestamps: true,