@justair/justair-library 7.2.0-alpha.e76a08c → 7.3.0-alpha.002ee84

package/dist/constants/deviceTypes.d.ts

@@ -0,0 +1,8 @@
+export namespace DEVICE_TYPES {
+    let MONITOR: string;
+    let SAMPLE_SITE: string;
+    let LINKED_DEVICE: string;
+}
+export const DEVICE_TYPE_VALUES: string[];
+export function isAqiCapableDeviceType(deviceType: any): boolean;
+//# sourceMappingURL=deviceTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deviceTypes.d.ts","sourceRoot":"","sources":["../../src/constants/deviceTypes.js"],"names":[],"mappings":";;;;;AA2BA,0CAA8D;AASvD,iEAEoC"}

package/dist/constants/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./pollutants.js";
 export * from "./alertLevels.js";
 export * from "./userNotifications.js";
-export * from "./timezones.js";
+export * from "./deviceTypes.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/constants/tests/deviceTypes.test.d.ts

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

package/dist/constants/tests/deviceTypes.test.d.ts.map

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

package/dist/index.d.ts

@@ -86,21 +86,16 @@ import { AccountNotification } from "./models/userNotifications.js";
 import { NOTIFICATION_KINDS } from "./models/userNotifications.js";
 import { NOTIFICATION_CHANNELS } from "./models/userNotifications.js";
 import { DELIVERY_STATUSES } from "./models/userNotifications.js";
-import { dataDownloadSchema } from "./models/dataDownloads.js";
-import { DataDownloads } from "./models/dataDownloads.js";
-import { AqiDataDownload } from "./models/dataDownloads.js";
-import { SampleDataDownload } from "./models/dataDownloads.js";
-import { MAX_RANGE_DAYS } from "./utils/dataDownloadRange.js";
-import { DATA_DOWNLOAD_ERRORS } from "./utils/dataDownloadRange.js";
-import { validateDateOrder } from "./utils/dataDownloadRange.js";
-import { validateMaxDateRange } from "./utils/dataDownloadRange.js";
 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 { DEVICE_TYPES } from "./constants/deviceTypes.js";
+import { DEVICE_TYPE_VALUES } from "./constants/deviceTypes.js";
+import { isAqiCapableDeviceType } from "./constants/deviceTypes.js";
 import { splitName } from "./utils/splitName.js";
 import { DEFAULT_QUIET_HOURS } from "./utils/quietHours.js";
-import { DEFAULT_TIMEZONE } from "./constants/timezones.js";
+import { DEFAULT_TIMEZONE } from "./utils/quietHours.js";
 import { QUIET_HOURS_ERRORS } from "./utils/quietHours.js";
 import { isValidTimeString } from "./utils/quietHours.js";
 import { isValidIANATimezone } from "./utils/quietHours.js";
@@ -108,5 +103,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, dataDownloadSchema, DataDownloads, AqiDataDownload, SampleDataDownload, MAX_RANGE_DAYS, DATA_DOWNLOAD_ERRORS, validateDateOrder, validateMaxDateRange, PARAMETERS, HEAVY_METALS, ALERT_LEVEL_WEIGHTS, getAlertWeight, 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, PARAMETERS, HEAVY_METALS, ALERT_LEVEL_WEIGHTS, getAlertWeight, DEVICE_TYPES, DEVICE_TYPE_VALUES, isAqiCapableDeviceType, 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":"AAmIA;;;iBAEC;yBAnEwB,oBAAoB;qBADxB,gBAAgB;4BAjEF,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;qCACgB,4BAA4B;+BAA5B,4BAA4B;mCAChC,0BAA0B;6BAA1B,0BAA0B;8CAIpE,qCAAqC;wCAArC,qCAAqC;4BAkCT,mBAAmB;sBAAnB,mBAAmB;kCAS/C,yBAAyB;4BAAzB,yBAAyB;sCAAzB,yBAAyB;gCAAzB,yBAAyB;qCAAzB,yBAAyB;8BASzB,qBAAqB;wBAArB,qBAAqB;mCAArB,qBAAqB;6BAArB,qBAAqB;uDAArB,qBAAqB;yCACiC,gCAAgC;mCAAhC,gCAAgC;sCA5CtF,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;mCAuC/B,2BAA2B;8BAA3B,2BAA2B;gCAA3B,2BAA2B;mCAA3B,2BAA2B;+BAM3B,8BAA8B;qCAA9B,8BAA8B;kCAA9B,8BAA8B;qCAA9B,8BAA8B;2BA9DI,2BAA2B;6BAA3B,2BAA2B;oCAChB,4BAA4B;+BAA5B,4BAA4B;0BAiBtD,sBAAsB;oCAUzC,uBAAuB;iCA1BG,0BAA0B;mCA0BpD,uBAAuB;kCAAvB,uBAAuB;oCAAvB,uBAAuB;mCAAvB,uBAAuB;+BAAvB,uBAAuB;gCAAvB,uBAAuB;kCAAvB,uBAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AA4HA;;;iBAEC;yBA5DwB,oBAAoB;qBADxB,gBAAgB;4BAjEF,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;qCACgB,4BAA4B;+BAA5B,4BAA4B;mCAChC,0BAA0B;6BAA1B,0BAA0B;8CAIpE,qCAAqC;wCAArC,qCAAqC;4BAuCT,mBAAmB;sBAAnB,mBAAmB;kCAS/C,yBAAyB;4BAAzB,yBAAyB;sCAAzB,yBAAyB;gCAAzB,yBAAyB;qCAAzB,yBAAyB;8BASzB,qBAAqB;wBAArB,qBAAqB;mCAArB,qBAAqB;6BAArB,qBAAqB;uDAArB,qBAAqB;yCACiC,gCAAgC;mCAAhC,gCAAgC;sCA7CtF,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;2BArBG,2BAA2B;6BAA3B,2BAA2B;oCAChB,4BAA4B;+BAA5B,4BAA4B;6BAKzE,4BAA4B;mCAA5B,4BAA4B;uCAA5B,4BAA4B;0BAgBT,sBAAsB;oCAWzC,uBAAuB;iCAAvB,uBAAuB;mCAAvB,uBAAuB;kCAAvB,uBAAuB;oCAAvB,uBAAuB;mCAAvB,uBAAuB;+BAAvB,uBAAuB;gCAAvB,uBAAuB;kCAAvB,uBAAuB"}

package/dist/models/monitorEpisodes.d.ts

@@ -1,8 +1,8 @@
 export const monitorEpisodesSchema: mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
     timestamps: true;
 }, {
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -10,8 +10,8 @@ export const monitorEpisodesSchema: mongoose.Schema<any, mongoose.Model<any, any
     endedAt?: NativeDate;
     peakStatus?: string;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -23,8 +23,8 @@ export const monitorEpisodesSchema: mongoose.Schema<any, mongoose.Model<any, any
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
     timestamps: true;
 }> & Omit<{
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -38,8 +38,8 @@ export const monitorEpisodesSchema: mongoose.Schema<any, mongoose.Model<any, any
 }, "id"> & mongoose.HydratedDocumentOverrides<{
     id: string;
 }>, unknown, {
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -54,8 +54,8 @@ export const monitorEpisodesSchema: mongoose.Schema<any, mongoose.Model<any, any
     __v: number;
 }>;
 export const MonitorEpisode: mongoose.Model<{
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -65,8 +65,8 @@ export const MonitorEpisode: mongoose.Model<{
 } & mongoose.DefaultTimestampProps, {}, {}, {
     id: string;
 }, mongoose.Document<unknown, {}, {
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -78,8 +78,8 @@ export const MonitorEpisode: mongoose.Model<{
 }, {
     timestamps: true;
 }> & Omit<{
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -95,8 +95,8 @@ export const MonitorEpisode: mongoose.Model<{
 }>, mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
     timestamps: true;
 }, {
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -104,8 +104,8 @@ export const MonitorEpisode: mongoose.Model<{
     endedAt?: NativeDate;
     peakStatus?: string;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -117,8 +117,8 @@ export const MonitorEpisode: mongoose.Model<{
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
     timestamps: true;
 }> & Omit<{
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -132,8 +132,8 @@ export const MonitorEpisode: mongoose.Model<{
 }, "id"> & mongoose.HydratedDocumentOverrides<{
     id: string;
 }>, unknown, {
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;
@@ -147,8 +147,8 @@ export const MonitorEpisode: mongoose.Model<{
 } & {
     __v: number;
 }>, {
-    user: mongoose.Types.ObjectId;
     monitor: mongoose.Types.ObjectId;
+    user: mongoose.Types.ObjectId;
     open: boolean;
     startedAt: NativeDate;
     alertCount: number;

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

@@ -1 +1 @@
-{"version":3,"file":"monitors.d.ts","sourceRoot":"","sources":["../../src/models/monitors.js"],"names":[],"mappings":"AA4KA,iCAoJE;AAuIF,2BAA4D;AAlU5D,qCAiCE;AAGF,+BAAwE;AAtKxE,sCAAoD"}
+{"version":3,"file":"monitors.d.ts","sourceRoot":"","sources":["../../src/models/monitors.js"],"names":[],"mappings":"AA4KA,iCAqJE;AAuIF,2BAA4D;AAnU5D,qCAiCE;AAGF,+BAAwE;AAtKxE,sCAAoD"}

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

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/models/users.js"],"names":[],"mappings":"AA2CA,8BAiFE;AA8BF,wBAAmD;AAlJnD,iDAA4D;AAC5D,6CAAmD;AAUnD,4DAsBC"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/models/users.js"],"names":[],"mappings":"AA6DA,8BAiGE;AAiCF,wBAAmD;AAtLnD,iDAA4D;AAC5D,6CAAmD;AAUnD,4DAsBC"}

package/dist/utils/quietHours.d.ts

@@ -1,8 +1,8 @@
-export { DEFAULT_TIMEZONE };
 export const DEFAULT_QUIET_HOURS: Readonly<{
     start: "22:00";
     end: "07:00";
 }>;
+export const DEFAULT_TIMEZONE: "America/New_York";
 export const QUIET_HOURS_ERRORS: Readonly<{
     HALF_PAIR: "half_pair";
     FORMAT: "format";
@@ -30,5 +30,4 @@ export function resolveQuietHours(user: any): {
     timezone: string;
     warnings: string[];
 };
-import { DEFAULT_TIMEZONE } from "../constants/timezones.js";
 //# sourceMappingURL=quietHours.d.ts.map

package/dist/utils/quietHours.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quietHours.d.ts","sourceRoot":"","sources":["../../src/utils/quietHours.js"],"names":[],"mappings":";AAwBA;;;GAGG;AAKH;;;;GAIG;AAuBI,uDACgD;AAEhD,4DAUN;AAOM;;;;;;;;;KAsCN;AASM,iEASN;AAKM,uEAaN;AAeM;;;;;;;EA6CN;iCAnMgC,2BAA2B"}
+{"version":3,"file":"quietHours.d.ts","sourceRoot":"","sources":["../../src/utils/quietHours.js"],"names":[],"mappings":"AAkBA;;;GAGG;AAEH,kDAAmD;AAKnD;;;;GAIG;AAuBI,uDACgD;AAEhD,4DAUN;AAOM;;;;;;;;;KAsCN;AASM,iEASN;AAKM,uEAaN;AAeM;;;;;;;EA6CN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justair/justair-library",
-  "version": "7.2.0-alpha.e76a08c",
+  "version": "7.3.0-alpha.002ee84",
   "description": "JustAir Internal Library",
   "main": "src/index.js",
   "type": "module",

package/src/constants/deviceTypes.js

@@ -0,0 +1,39 @@
+// V2 device-type vocabulary — single source of truth (JA-3110 / JA-3335).
+//
+// Every device a user can see or subscribe to is exactly one of three things,
+// each backed by a different collection:
+//   monitor       — a standalone Monitors doc (siteId: null). Reports live AQI.
+//   sample-site   — a standalone SampleSites doc (siteId: null). Lab/filter
+//                   sample data only, no live AQI, so it can never trigger an
+//                   AQI alert.
+//   linked-device — a Sites doc joining one or more Monitors and/or one
+//                   SampleSite at a single physical location. Reports live AQI
+//                   when it links at least one monitor.
+//
+// Consumers: JustAirService fetchDevices/getDeviceById stamp these strings onto
+// every device response; JustAirUserService validates the subscribe body
+// against them and persists them in Users.subscribedDevices; JustAir-Client
+// passes back verbatim the value it received. Keep the string values
+// byte-identical to what the devices API emits — the FE does no mapping, and a
+// casing drift here is a silent 404 on subscribe.
+//
+// DO NOT rename these values: they are persisted in Users.subscribedDevices.
+
+export const DEVICE_TYPES = {
+  MONITOR: "monitor",
+  SAMPLE_SITE: "sample-site",
+  LINKED_DEVICE: "linked-device",
+};
+
+export const DEVICE_TYPE_VALUES = Object.values(DEVICE_TYPES);
+
+// Whether a device of this type can ever report AQI, and therefore whether a
+// subscription to it can contribute to AQI alert delivery.
+//
+// Note the asymmetry: `sample-site` is unconditionally false, but a true result
+// for `linked-device` is necessary and NOT sufficient — a Site is only actually
+// AQI-capable when it links at least one monitor, which the type alone cannot
+// tell you. Callers must still check the Site's monitorIds.
+export const isAqiCapableDeviceType = (deviceType) =>
+  deviceType === DEVICE_TYPES.MONITOR ||
+  deviceType === DEVICE_TYPES.LINKED_DEVICE;

package/src/constants/index.js

@@ -10,4 +10,4 @@
 export * from "./pollutants.js";
 export * from "./alertLevels.js";
 export * from "./userNotifications.js";
-export * from "./timezones.js";
+export * from "./deviceTypes.js";

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

@@ -6,7 +6,6 @@
 import * as barrel from '../index.js';
 import { PARAMETERS, HEAVY_METALS } from '../pollutants.js';
 import { ALERT_LEVEL_WEIGHTS, getAlertWeight } from '../alertLevels.js';
-import { DEFAULT_TIMEZONE } from '../timezones.js';
 
 test('barrel re-exports PARAMETERS and HEAVY_METALS unchanged (identity, not copies)', () => {
   expect(barrel.PARAMETERS).toBe(PARAMETERS);
@@ -45,8 +44,3 @@ test('unknown and legacy statuses fall back to the Good weight (never alert, nev
   expect(getAlertWeight(null)).toBe(1);
   expect(getAlertWeight('')).toBe(1);
 });
-
-test('barrel exports DEFAULT_TIMEZONE (browser-safe, no Mongoose)', () => {
-  expect(barrel.DEFAULT_TIMEZONE).toBe(DEFAULT_TIMEZONE);
-  expect(DEFAULT_TIMEZONE).toBe('America/New_York');
-});

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

@@ -0,0 +1,48 @@
+// Pins the device-type vocabulary shared across JustAirService (which stamps
+// deviceType onto every device response), JustAirUserService (which validates
+// the subscribe body and persists it), and JustAir-Client (which passes it
+// back verbatim). A casing drift in any value is a silent subscribe failure,
+// so the exact strings are asserted rather than derived.
+import * as barrel from '../index.js';
+import {
+  DEVICE_TYPES,
+  DEVICE_TYPE_VALUES,
+  isAqiCapableDeviceType,
+} from '../deviceTypes.js';
+
+test('barrel exports the device-type constants', () => {
+  expect(barrel.DEVICE_TYPES).toBe(DEVICE_TYPES);
+  expect(barrel.DEVICE_TYPE_VALUES).toBe(DEVICE_TYPE_VALUES);
+  expect(barrel.isAqiCapableDeviceType).toBe(isAqiCapableDeviceType);
+});
+
+test('DEVICE_TYPES values match the strings the devices API emits', () => {
+  expect(DEVICE_TYPES).toEqual({
+    MONITOR: 'monitor',
+    SAMPLE_SITE: 'sample-site',
+    LINKED_DEVICE: 'linked-device',
+  });
+});
+
+test('DEVICE_TYPE_VALUES covers every type exactly once', () => {
+  expect(DEVICE_TYPE_VALUES).toEqual(['monitor', 'sample-site', 'linked-device']);
+  expect(new Set(DEVICE_TYPE_VALUES).size).toBe(DEVICE_TYPE_VALUES.length);
+});
+
+describe('isAqiCapableDeviceType', () => {
+  test('monitor and linked-device can report AQI', () => {
+    expect(isAqiCapableDeviceType('monitor')).toBe(true);
+    expect(isAqiCapableDeviceType('linked-device')).toBe(true);
+  });
+
+  test('sample-site never reports AQI, so it never alerts', () => {
+    expect(isAqiCapableDeviceType('sample-site')).toBe(false);
+  });
+
+  test('unknown and missing types are not AQI-capable', () => {
+    expect(isAqiCapableDeviceType('sampleSite')).toBe(false);
+    expect(isAqiCapableDeviceType(undefined)).toBe(false);
+    expect(isAqiCapableDeviceType(null)).toBe(false);
+    expect(isAqiCapableDeviceType('')).toBe(false);
+  });
+});

package/src/index.js

@@ -67,7 +67,11 @@ 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";
 import { ALERT_LEVEL_WEIGHTS, getAlertWeight } from "./constants/alertLevels.js";
-import { DEFAULT_TIMEZONE } from "./constants/timezones.js";
+import {
+  DEVICE_TYPES,
+  DEVICE_TYPE_VALUES,
+  isAqiCapableDeviceType,
+} from "./constants/deviceTypes.js";
 import {
   monitorEpisodesSchema,
   MonitorEpisode,
@@ -86,6 +90,7 @@ import {
 import { splitName } from "./utils/splitName.js";
 import {
   DEFAULT_QUIET_HOURS,
+  DEFAULT_TIMEZONE,
   QUIET_HOURS_ERRORS,
   isValidTimeString,
   isValidIANATimezone,
@@ -116,18 +121,6 @@ import {
   sampleParameterReferenceConcentrations,
 } from "./models/samples.js";
 import { passwordResetTokenSchema, PasswordResetToken } from "./models/passwordResetToken.js";
-import {
-  dataDownloadSchema,
-  DataDownloads,
-  AqiDataDownload,
-  SampleDataDownload,
-} from "./models/dataDownloads.js";
-import {
-  MAX_RANGE_DAYS,
-  DATA_DOWNLOAD_ERRORS,
-  validateDateOrder,
-  validateMaxDateRange,
-} from "./utils/dataDownloadRange.js";
 
 export function createLoggerInstance({ DATADOG_API_KEY, APPLICATION_NAME }) {
   return new CustomLogger({ DATADOG_API_KEY, APPLICATION_NAME });
@@ -222,21 +215,16 @@ export {
   NOTIFICATION_KINDS,
   NOTIFICATION_CHANNELS,
   DELIVERY_STATUSES,
-  // Data downloads (JA-3080)
-  dataDownloadSchema,
-  DataDownloads,
-  AqiDataDownload,
-  SampleDataDownload,
-  MAX_RANGE_DAYS,
-  DATA_DOWNLOAD_ERRORS,
-  validateDateOrder,
-  validateMaxDateRange,
   // Pollutant constants
   PARAMETERS,
   HEAVY_METALS,
   // AQI alert-level hierarchy (single source of truth)
   ALERT_LEVEL_WEIGHTS,
   getAlertWeight,
+  // V2 device-type vocabulary (single source of truth) — JA-3110 / JA-3335
+  DEVICE_TYPES,
+  DEVICE_TYPE_VALUES,
+  isAqiCapableDeviceType,
   // Utilities
   splitName,
   // Quiet hours (JA-3054): shared validation + window evaluation

package/src/models/monitors.js

@@ -195,6 +195,7 @@ const monitorsSchema = mongoose.Schema(
         "atmotube",
         "hobolink",
         "dasberry",
+        "airThings",
       ],
     },
     monitorType: String,

package/src/models/users.js

@@ -5,6 +5,7 @@ import {
   validateQuietHours,
   QUIET_HOURS_ERRORS,
 } from "../utils/quietHours.js";
+import { DEVICE_TYPE_VALUES } from "../constants/deviceTypes.js";
 
 const COOKIE_CONSENT_CATEGORIES = ["analytics_performance"];
 const COOKIE_CONSENT_VALUES = ["accept", "reject"];
@@ -41,6 +42,23 @@ const validateCookieConsent = (consent) => {
   return null;
 };
 
+// One entry in Users.subscribedDevices (JA-3110 / JA-3335). deviceId points
+// into a different collection per deviceType (Monitors / SampleSites / Sites),
+// so there is deliberately no `ref` to declare here.
+//
+// `_id: false` is load-bearing, not cosmetic: it makes the pair itself the
+// identity of an element, so `$addToSet` dedupes and re-subscribing is
+// idempotent. With per-subdocument _ids every push would cast to a brand-new
+// object, `$addToSet` would never match, and the array would accumulate a
+// duplicate on every click of the subscribe button.
+const subscribedDeviceSchema = mongoose.Schema(
+  {
+    deviceId: { type: mongoose.Types.ObjectId, required: true },
+    deviceType: { type: String, enum: DEVICE_TYPE_VALUES, required: true },
+  },
+  { _id: false }
+);
+
 const usersSchema = mongoose.Schema(
   {
     name: String,
@@ -54,6 +72,22 @@ const usersSchema = mongoose.Schema(
     alertPhone: String,
     alertCount: { type: Number, default: 0 },
     subscribedMonitors: [{ type: mongoose.Types.ObjectId, ref: "Monitors" }],
+    // Subscribed devices (JA-3110 / JA-3335) — the source of truth for what the
+    // user has added to "My Monitors", across all three device types.
+    //
+    // Relationship to subscribedMonitors above: that array stays monitor ids
+    // ONLY, and is the AQI-alert projection of this one. A subscribed
+    // linked-device contributes the monitorIds of its Site to it; a subscribed
+    // sample-site contributes nothing, having no live AQI. The two must be
+    // written together on every subscribe/unsubscribe path.
+    //
+    // Why the split matters: JustAirNotificationService reads subscribedMonitors
+    // and drops ids that do not resolve to a Monitor (statusAlerts.js
+    // `.filter(monitor => monitor)`). Writing a Site or SampleSite id in there
+    // therefore throws no error — it silently delivers no alerts. Keeping the
+    // polymorphic ids in their own field preserves that invariant for every
+    // library consumer.
+    subscribedDevices: [subscribedDeviceSchema],
     currentAlertMode: {
       type: String,
       enum: [
@@ -151,6 +185,9 @@ usersSchema.pre("validate", function () {
 });
 
 usersSchema.index({ phone: 1 });
+// Supports the "is this user subscribed to device X?" lookup behind the V2
+// device-card subscribed state and the My Monitors map filter.
+usersSchema.index({ "subscribedDevices.deviceId": 1 });
 
 const Users = mongoose.model("Users", usersSchema);
 

package/src/utils/quietHours.js

@@ -16,17 +16,13 @@
 // Boundary rule: start is inclusive, end is exclusive — a 22:00–07:00 user
 // is suppressed at 22:00 sharp and receives alerts again at 07:00 sharp.
 
-import { DEFAULT_TIMEZONE } from "../constants/timezones.js";
-
-// Re-exported for existing backend imports — canonical definition now lives
-// in src/constants/timezones.js (Mongoose-free, browser-safe).
-export { DEFAULT_TIMEZONE };
-
 export const DEFAULT_QUIET_HOURS = Object.freeze({
   start: "22:00",
   end: "07:00",
 });
 
+export const DEFAULT_TIMEZONE = "America/New_York";
+
 // Stable error codes for validateQuietHours. Consumers filter on `code`
 // (e.g. the users schema pre-validate hook re-attaches only cross-field
 // errors) — never on message wording, which is free to change.

package/dist/constants/timezones.d.ts

@@ -1,2 +0,0 @@
-export const DEFAULT_TIMEZONE: "America/New_York";
-//# sourceMappingURL=timezones.d.ts.map

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

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

package/dist/models/dataDownloads.d.ts

@@ -1,5 +0,0 @@
-export const dataDownloadSchema: any;
-export const DataDownloads: any;
-export const AqiDataDownload: any;
-export const SampleDataDownload: any;
-//# sourceMappingURL=dataDownloads.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"dataDownloads.d.ts","sourceRoot":"","sources":["../../src/models/dataDownloads.js"],"names":[],"mappings":"AAkBA,qCAkCE;AA+CF,gCAA0E;AAO1E,kCAEG;AAEH,qCAIE"}

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

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

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

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

package/dist/utils/dataDownloadRange.d.ts

@@ -1,14 +0,0 @@
-export const MAX_RANGE_DAYS: 31;
-export const DATA_DOWNLOAD_ERRORS: Readonly<{
-    END_BEFORE_START: "end_before_start";
-    RANGE_TOO_LONG: "range_too_long";
-}>;
-export function validateDateOrder({ start, end }?: {}): {
-    code: "end_before_start";
-    message: string;
-}[];
-export function validateMaxDateRange({ start, end }?: {}): {
-    code: "range_too_long";
-    message: string;
-}[];
-//# sourceMappingURL=dataDownloadRange.d.ts.map

package/dist/utils/dataDownloadRange.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dataDownloadRange.d.ts","sourceRoot":"","sources":["../../src/utils/dataDownloadRange.js"],"names":[],"mappings":"AAYA,gCAAiC;AASjC;;;GAGG;AA0BI;;;IAcN;AAMM;;;IAcN"}

package/dist/utils/tests/dataDownloadRange.test.d.ts

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

package/dist/utils/tests/dataDownloadRange.test.d.ts.map

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

package/src/constants/timezones.js

@@ -1,7 +0,0 @@
-// Mongoose-free timezone defaults, so a browser-safe consumer (e.g.
-// JustAir-Client) can use the same default other domains store server-side.
-// Originally lived in utils/quietHours.js (JA-3054); moved here once a
-// second, unrelated domain (dataDownloads.js, JA-3080) needed it too — see
-// CLAUDE.md's "Note on constants placement".
-
-export const DEFAULT_TIMEZONE = "America/New_York";

package/src/models/dataDownloads.js

@@ -1,117 +0,0 @@
-import mongoose from "mongoose";
-import { DEFAULT_TIMEZONE } from "../constants/timezones.js";
-import { isValidIANATimezone } from "../utils/quietHours.js";
-import { validateDateOrder, validateMaxDateRange } from "../utils/dataDownloadRange.js";
-
-const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-
-// DataDownloads — one doc per data download request (JA-3080). Written by
-// JustAirService on download (JA-3081); read by the org-level admin
-// communication screen. AQI downloads are monitor-scoped, Sample downloads
-// are site-scoped (samples.js keys samples to SampleSites, not Monitors) —
-// modeled as discriminators per CLAUDE.md's multi-kind pattern rather than
-// a flat schema with a monitorId/siteId pair that's nullable either way.
-//
-// The base model permits a kind-less document (create() without `dataType`)
-// — same property `userNotifications.js`'s base model has. Write through
-// AqiDataDownload/SampleDataDownload, not DataDownloads, so every stored
-// document has the ref field the admin screen needs to render it.
-const dataDownloadSchema = mongoose.Schema(
-  {
-    orgId: {
-      type: mongoose.Types.ObjectId,
-      ref: "Organizations",
-      required: [true, "orgId is required"],
-    },
-    dateRangeStart: { type: Date, required: [true, "dateRangeStart is required"] },
-    dateRangeEnd: { type: Date, required: [true, "dateRangeEnd is required"] },
-    timezone: {
-      type: String,
-      default: DEFAULT_TIMEZONE,
-      validate: {
-        validator: isValidIANATimezone,
-        message: "timezone must be a valid IANA timezone identifier",
-      },
-    },
-    downloadedAt: { type: Date, required: true, default: Date.now },
-    email: {
-      type: String,
-      trim: true,
-      lowercase: true,
-      default: null,
-      set: (value) => (typeof value === "string" && value.trim() === "" ? null : value),
-      validate: {
-        validator: (value) => value === null || EMAIL_PATTERN.test(value),
-        message: "email must be a valid email address",
-      },
-    },
-  },
-  {
-    timestamps: true,
-    discriminatorKey: "dataType",
-  }
-);
-
-// Cross-field rule (quiet-hours shape, CLAUDE.md): delegated to
-// validateDateOrder so this schema and JA-3081's write-path validation can
-// never drift. Applies to every kind — the 31-day cap is AQI-only and lives
-// on AqiDataDownload's own schema below, not here. Lives in pre('validate')
-// so create()/save() can't persist an invalid range even if a caller
-// forgets to check.
-dataDownloadSchema.pre("validate", function () {
-  const errors = validateDateOrder({ start: this.dateRangeStart, end: this.dateRangeEnd });
-  for (const error of errors) {
-    this.invalidate("dateRangeEnd", error.message);
-  }
-});
-
-// Org-level admin screen lists a given org's downloads, most recent first,
-// by the domain-meaningful "date of the download" (JA-3080), not createdAt.
-dataDownloadSchema.index({ orgId: 1, downloadedAt: -1 });
-
-const aqiDataDownloadSchema = new mongoose.Schema({
-  monitorId: {
-    type: mongoose.Types.ObjectId,
-    ref: "Monitors",
-    required: [true, "monitorId is required"],
-  },
-});
-aqiDataDownloadSchema.index({ monitorId: 1, downloadedAt: -1 });
-
-// AQI-only: the 31-day cap does not apply to Sample downloads. Mongoose
-// merges base + discriminator schema hooks by default (mergeHooks), so this
-// runs alongside (not instead of) the base's validateDateOrder check above.
-aqiDataDownloadSchema.pre("validate", function () {
-  const errors = validateMaxDateRange({ start: this.dateRangeStart, end: this.dateRangeEnd });
-  for (const error of errors) {
-    this.invalidate("dateRangeEnd", error.message);
-  }
-});
-
-const sampleDataDownloadSchema = new mongoose.Schema({
-  siteId: {
-    type: mongoose.Types.ObjectId,
-    ref: "SampleSites",
-    required: [true, "siteId is required"],
-  },
-});
-sampleDataDownloadSchema.index({ siteId: 1, downloadedAt: -1 });
-
-const DataDownloads = mongoose.model("DataDownloads", dataDownloadSchema);
-
-// Discriminator model names are namespaced (matches userNotifications.js's
-// aqi_alert/device_offline/weekly_digest) — "AQI"/"Sample" as bare mongoose
-// model-registry keys would collide with any consuming service's own models
-// of those names. { value } keeps the persisted dataType exactly what
-// JA-3245 specifies regardless of the registry name.
-const AqiDataDownload = DataDownloads.discriminator("AqiDataDownload", aqiDataDownloadSchema, {
-  value: "AQI",
-});
-
-const SampleDataDownload = DataDownloads.discriminator(
-  "SampleDataDownload",
-  sampleDataDownloadSchema,
-  { value: "Sample" }
-);
-
-export { dataDownloadSchema, DataDownloads, AqiDataDownload, SampleDataDownload };

package/src/utils/dataDownloadRange.js

@@ -1,85 +0,0 @@
-// Data download date range validation (JA-3080/JA-3245): shared cross-field
-// rules for the requested range on a DataDownloads document. Single source
-// of truth for every consumer — this library's schema enforces these on
-// write, JustAirService's intake endpoint (JA-3081) validates the same
-// request shape before ever constructing a document. Pure functions, no DB,
-// no clock reads. Same shape as quietHours.js's cross-field validator.
-//
-// Two separate rules, deliberately not one function: end-must-not-precede-
-// start applies to every download kind, but the 31-day cap is AQI-only —
-// Sample downloads have no range limit. Compose the one(s) that apply to
-// the kind being validated; don't call validateMaxDateRange for Sample.
-
-export const MAX_RANGE_DAYS = 31;
-
-// DST slack: a calendar-accurate 31-day span crossing a fall-back transition
-// is 745 (not 744) hours long. Allow it rather than rejecting a range the
-// product spec (Figma) explicitly promises as valid.
-const MAX_RANGE_MS = MAX_RANGE_DAYS * 24 * 60 * 60 * 1000 + 60 * 60 * 1000;
-
-// Stable error codes for validateDateOrder/validateMaxDateRange. Consumers
-// filter on `code` — never on message wording, which is free to change.
-export const DATA_DOWNLOAD_ERRORS = Object.freeze({
-  END_BEFORE_START: "end_before_start",
-  RANGE_TOO_LONG: "range_too_long",
-});
-
-// Coerces both ends through `new Date(...)` before comparing/subtracting: a
-// JSON request body (JA-3081's intake endpoint) hands these functions raw
-// strings, not Date instances, and comparing/subtracting un-coerced strings
-// silently produces NaN (`NaN > x` is always false) — the caps would never
-// fire for exactly the caller these functions exist to serve. An unparsable
-// value coerces to an Invalid Date (NaN time); format validation is the
-// schema/type layer's job, not a cross-field rule's, so that's treated the
-// same as "not this validator's concern" and returns null rather than
-// throwing or reporting a spurious range error.
-const toTimes = (start, end) => {
-  if (!start || !end) {
-    return null;
-  }
-  const startTime = new Date(start).getTime();
-  const endTime = new Date(end).getTime();
-  if (Number.isNaN(startTime) || Number.isNaN(endTime)) {
-    return null;
-  }
-  return { startTime, endTime };
-};
-
-// Returns an array of { code, message } errors; empty array = valid. Applies
-// to every download kind (AQI and Sample) — the Figma "31 days" cap is
-// AQI-only and is NOT enforced here, see validateMaxDateRange.
-export const validateDateOrder = ({ start, end } = {}) => {
-  const times = toTimes(start, end);
-  if (!times) {
-    return [];
-  }
-  if (times.endTime < times.startTime) {
-    return [
-      {
-        code: DATA_DOWNLOAD_ERRORS.END_BEFORE_START,
-        message: "dateRangeEnd must not be before dateRangeStart",
-      },
-    ];
-  }
-  return [];
-};
-
-// Returns an array of { code, message } errors; empty array = valid. AQI
-// downloads only — Sample downloads have no range limit. Assumes the caller
-// has already confirmed order via validateDateOrder (a reversed range isn't
-// re-reported here as "too long").
-export const validateMaxDateRange = ({ start, end } = {}) => {
-  const times = toTimes(start, end);
-  if (!times || times.endTime < times.startTime) {
-    return [];
-  }
-  if (times.endTime - times.startTime > MAX_RANGE_MS) {
-    return [
-      {
-        code: DATA_DOWNLOAD_ERRORS.RANGE_TOO_LONG,
-        message: `date range cannot exceed ${MAX_RANGE_DAYS} days`,
-      },
-    ];
-  }
-  return [];
-};

package/src/utils/tests/dataDownloadRange.test.js

@@ -1,89 +0,0 @@
-import {
-  MAX_RANGE_DAYS,
-  DATA_DOWNLOAD_ERRORS,
-  validateDateOrder,
-  validateMaxDateRange,
-} from "../dataDownloadRange.js";
-
-const DAY_MS = 24 * 60 * 60 * 1000;
-const HOUR_MS = 60 * 60 * 1000;
-const start = new Date("2026-01-01T00:00:00.000Z");
-
-describe("validateDateOrder (applies to every download kind)", () => {
-  test("returns no errors when start/end are missing", () => {
-    expect(validateDateOrder({})).toEqual([]);
-    expect(validateDateOrder({ start })).toEqual([]);
-    expect(validateDateOrder({ end: start })).toEqual([]);
-  });
-
-  test("returns no errors for a valid order", () => {
-    const end = new Date(start.getTime() + DAY_MS);
-    expect(validateDateOrder({ start, end })).toEqual([]);
-  });
-
-  test("flags end before start with END_BEFORE_START", () => {
-    const end = new Date(start.getTime() - DAY_MS);
-    expect(validateDateOrder({ start, end })).toEqual([
-      expect.objectContaining({ code: DATA_DOWNLOAD_ERRORS.END_BEFORE_START }),
-    ]);
-  });
-
-  test("does not flag a range far longer than MAX_RANGE_DAYS — that's validateMaxDateRange's job", () => {
-    const end = new Date(start.getTime() + 365 * DAY_MS);
-    expect(validateDateOrder({ start, end })).toEqual([]);
-  });
-
-  // JA-3081's intake endpoint hands this raw JSON request-body strings, not
-  // Date instances — must not silently misjudge order via NaN-producing
-  // string arithmetic (see dataDownloadRange.js's toTimes coercion comment).
-  test("flags end before start given as raw date strings", () => {
-    expect(
-      validateDateOrder({ start: "2026-05-01", end: "2026-01-01" })
-    ).toEqual([expect.objectContaining({ code: DATA_DOWNLOAD_ERRORS.END_BEFORE_START })]);
-  });
-
-  test("returns no errors for an unparsable date value", () => {
-    expect(validateDateOrder({ start: "not-a-date", end: start })).toEqual([]);
-  });
-});
-
-describe("validateMaxDateRange (AQI only — Sample downloads have no cap)", () => {
-  test("returns no errors when start/end are missing", () => {
-    expect(validateMaxDateRange({})).toEqual([]);
-  });
-
-  test("accepts exactly MAX_RANGE_DAYS", () => {
-    const end = new Date(start.getTime() + MAX_RANGE_DAYS * DAY_MS);
-    expect(validateMaxDateRange({ start, end })).toEqual([]);
-  });
-
-  // The +1h grace exists so a calendar-accurate 31-day span crossing a DST
-  // fall-back transition (745 real hours, not 744) still validates — see
-  // dataDownloadRange.js's MAX_RANGE_MS comment.
-  test("accepts MAX_RANGE_DAYS plus the 1-hour DST grace", () => {
-    const end = new Date(start.getTime() + MAX_RANGE_DAYS * DAY_MS + HOUR_MS);
-    expect(validateMaxDateRange({ start, end })).toEqual([]);
-  });
-
-  test("flags a range longer than MAX_RANGE_DAYS plus the DST grace with RANGE_TOO_LONG", () => {
-    const end = new Date(start.getTime() + MAX_RANGE_DAYS * DAY_MS + HOUR_MS + 1);
-    expect(validateMaxDateRange({ start, end })).toEqual([
-      expect.objectContaining({ code: DATA_DOWNLOAD_ERRORS.RANGE_TOO_LONG }),
-    ]);
-  });
-
-  test("flags a too-long range given as raw date strings (JSON request-body shape)", () => {
-    expect(
-      validateMaxDateRange({ start: "2026-01-01", end: "2027-06-01" })
-    ).toEqual([expect.objectContaining({ code: DATA_DOWNLOAD_ERRORS.RANGE_TOO_LONG })]);
-  });
-
-  test("does not re-report a reversed range as RANGE_TOO_LONG — validateDateOrder owns that", () => {
-    const end = new Date(start.getTime() - DAY_MS);
-    expect(validateMaxDateRange({ start, end })).toEqual([]);
-  });
-
-  test("returns no errors for an unparsable date value", () => {
-    expect(validateMaxDateRange({ start: "not-a-date", end: start })).toEqual([]);
-  });
-});