@justair/justair-library 7.12.0 → 7.13.0-alpha.84dbc93

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5,4 +5,5 @@ export * from "./deviceTypes.js";
5
5
  export * from "./timezones.js";
6
6
  export * from "./dataDownloads.js";
7
7
  export * from "./terms.js";
8
+ export * from "./jobCategories.js";
8
9
  //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,10 @@
1
+ export const JOB_CATEGORIES: Readonly<{
2
+ TRUCK_DETECTION: "Truck Detection";
3
+ BACKFILL_MONITOR_DATA: "Backfill Monitor Data";
4
+ AQI_NETWORK_SUMMARY: "AQI Network Summary";
5
+ MULTI_MONITOR_DATA_PULL: "Multi Monitor Data Pull";
6
+ MULTI_MONITOR_AVERAGE_AQI_DATA_PULL: "Multi Monitor Average AQI Data Pull";
7
+ DRIVE_INTAKE: "Drive Intake";
8
+ }>;
9
+ export const JOB_CATEGORY_VALUES: readonly ("Truck Detection" | "Backfill Monitor Data" | "AQI Network Summary" | "Multi Monitor Data Pull" | "Multi Monitor Average AQI Data Pull" | "Drive Intake")[];
10
+ //# sourceMappingURL=jobCategories.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jobCategories.d.ts","sourceRoot":"","sources":["../../src/constants/jobCategories.js"],"names":[],"mappings":"AAYA;;;;;;;GASG;AAEH,wMAAgF"}
package/dist/index.d.ts CHANGED
@@ -108,6 +108,8 @@ import { DEVICE_TYPES } from "./constants/deviceTypes.js";
108
108
  import { DEVICE_TYPE_VALUES } from "./constants/deviceTypes.js";
109
109
  import { isAqiCapableDeviceType } from "./constants/deviceTypes.js";
110
110
  import { AQI_CAPABLE_DEVICE_TYPES } from "./constants/deviceTypes.js";
111
+ import { JOB_CATEGORIES } from "./constants/jobCategories.js";
112
+ import { JOB_CATEGORY_VALUES } from "./constants/jobCategories.js";
111
113
  import { projectSubscribedMonitors } from "./utils/subscribedDevices.js";
112
114
  import { resolveSubscribedMonitorIdsByUser } from "./utils/subscribedDevices.js";
113
115
  import { VISIBLE_SITE_MONITOR_FILTER } from "./utils/subscribedDevices.js";
@@ -122,5 +124,5 @@ import { validateQuietHours } from "./utils/quietHours.js";
122
124
  import { getZoneMinutes } from "./utils/quietHours.js";
123
125
  import { isInQuietWindow } from "./utils/quietHours.js";
124
126
  import { resolveQuietHours } from "./utils/quietHours.js";
125
- 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 };
127
+ 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, JOB_CATEGORIES, JOB_CATEGORY_VALUES, projectSubscribedMonitors, resolveSubscribedMonitorIdsByUser, VISIBLE_SITE_MONITOR_FILTER, SUBSCRIBED_DEVICES_ERRORS, splitName, DEFAULT_QUIET_HOURS, DEFAULT_TIMEZONE, QUIET_HOURS_ERRORS, isValidTimeString, isValidIANATimezone, validateQuietHours, getZoneMinutes, isInQuietWindow, resolveQuietHours };
126
128
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AA2KA;;;iBAEC;yBAxGwB,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;4BAoDT,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;oCAvBF,8BAA8B;mCAuE3D,2BAA2B;8BAA3B,2BAA2B;gCAA3B,2BAA2B;mCAA3B,2BAA2B;+DAsB3B,mCAAmC;qCAAnC,mCAAmC;mEAAnC,mCAAmC;yEAAnC,mCAAmC;mEAAnC,mCAAmC;qEAAnC,mCAAmC;yEAAnC,mCAAmC;2EAAnC,mCAAmC;2BAnGD,2BAA2B;6BAA3B,2BAA2B;oCAI7D,4BAA4B;+BAA5B,4BAA4B;yCAGM,sBAAsB;6BAMxD,4BAA4B;mCAA5B,4BAA4B;uCAA5B,4BAA4B;yCAA5B,4BAA4B;+BACiB,8BAA8B;oCAA9B,8BAA8B;0CAgC3E,8BAA8B;kDAA9B,8BAA8B;4CAA9B,8BAA8B;0CAA9B,8BAA8B;0BAhBX,sBAAsB;oCASzC,uBAAuB;iCAlCG,0BAA0B;mCAkCpD,uBAAuB;kCAAvB,uBAAuB;oCACM,qBAAqB;mCADlD,uBAAuB;+BAAvB,uBAAuB;gCAAvB,uBAAuB;kCAAvB,uBAAuB"}
@@ -1 +1 @@
1
- {"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/models/jobs.js"],"names":[],"mappings":"AAEA,6BA4BE;AAEF,uBAAgD"}
1
+ {"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/models/jobs.js"],"names":[],"mappings":"AAGA,6BAsBE;AAEF,uBAAgD"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=jobs.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jobs.test.d.ts","sourceRoot":"","sources":["../../../src/models/tests/jobs.test.js"],"names":[],"mappings":""}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@justair/justair-library",
3
- "version": "7.12.0",
3
+ "version": "7.13.0-alpha.84dbc93",
4
4
  "description": "JustAir Internal Library",
5
5
  "main": "src/index.js",
6
6
  "type": "module",
@@ -14,3 +14,4 @@ export * from "./deviceTypes.js";
14
14
  export * from "./timezones.js";
15
15
  export * from "./dataDownloads.js";
16
16
  export * from "./terms.js";
17
+ export * from "./jobCategories.js";
@@ -0,0 +1,24 @@
1
+ // Jobs.category vocabulary — single source of truth for the persisted values.
2
+ //
3
+ // Kept here (Mongoose-free) so the services that write or branch on a
4
+ // category import the string instead of retyping it: gcloud-functions
5
+ // jobsHandler switches on JOB_CATEGORY, toos-backend creates Truck Detection
6
+ // jobs, JustAirService excludes Truck Detection from the admin list.
7
+ //
8
+ // These are persisted values, NOT display labels. DO NOT rename or remove a
9
+ // value: it is stored on every Jobs document that used it (see CLAUDE.md,
10
+ // "Never remove an enum value").
11
+ //
12
+ // Frozen: every importer in a process shares this instance. Matches DEVICE_TYPES.
13
+ export const JOB_CATEGORIES = Object.freeze({
14
+ TRUCK_DETECTION: "Truck Detection",
15
+ BACKFILL_MONITOR_DATA: "Backfill Monitor Data",
16
+ AQI_NETWORK_SUMMARY: "AQI Network Summary",
17
+ MULTI_MONITOR_DATA_PULL: "Multi Monitor Data Pull",
18
+ MULTI_MONITOR_AVERAGE_AQI_DATA_PULL: "Multi Monitor Average AQI Data Pull",
19
+ // Generic Drive file intake (JA-3738): one value for every supplier that
20
+ // drops files in Drive, Ecosense radon first. Not supplier-specific by design.
21
+ DRIVE_INTAKE: "Drive Intake",
22
+ });
23
+
24
+ export const JOB_CATEGORY_VALUES = Object.freeze(Object.values(JOB_CATEGORIES));
@@ -9,6 +9,7 @@ import { ALERT_LEVEL_WEIGHTS, getAlertWeight } from '../alertLevels.js';
9
9
  import { DEFAULT_TIMEZONE } from '../timezones.js';
10
10
  import { DATA_DOWNLOAD_TYPES } from '../dataDownloads.js';
11
11
  import { TERMS_VERSION_MAX_LENGTH } from '../terms.js';
12
+ import { JOB_CATEGORIES, JOB_CATEGORY_VALUES } from '../jobCategories.js';
12
13
 
13
14
  test('barrel re-exports the pollutants constants unchanged (identity, not copies)', () => {
14
15
  expect(barrel.PARAMETERS).toBe(PARAMETERS);
@@ -68,3 +69,20 @@ test('barrel exports TERMS_VERSION_MAX_LENGTH (browser-safe, no Mongoose)', () =
68
69
  test('DATA_DOWNLOAD_TYPES pins the persisted dataType values in order', () => {
69
70
  expect(DATA_DOWNLOAD_TYPES).toEqual(['AQI', 'Sample']);
70
71
  });
72
+
73
+ // Persisted Jobs.category values. Pin the exact strings: a casing drift here
74
+ // would fail validation on every consumer that writes a job.
75
+ test('barrel exports the frozen job-category constants (browser-safe, no Mongoose)', () => {
76
+ expect(barrel.JOB_CATEGORIES).toBe(JOB_CATEGORIES);
77
+ expect(barrel.JOB_CATEGORY_VALUES).toBe(JOB_CATEGORY_VALUES);
78
+ expect(Object.isFrozen(JOB_CATEGORIES)).toBe(true);
79
+ expect(Object.isFrozen(JOB_CATEGORY_VALUES)).toBe(true);
80
+ expect(JOB_CATEGORY_VALUES).toEqual([
81
+ 'Truck Detection',
82
+ 'Backfill Monitor Data',
83
+ 'AQI Network Summary',
84
+ 'Multi Monitor Data Pull',
85
+ 'Multi Monitor Average AQI Data Pull',
86
+ 'Drive Intake',
87
+ ]);
88
+ });
package/src/index.js CHANGED
@@ -82,6 +82,7 @@ import {
82
82
  isAqiCapableDeviceType,
83
83
  AQI_CAPABLE_DEVICE_TYPES,
84
84
  } from "./constants/deviceTypes.js";
85
+ import { JOB_CATEGORIES, JOB_CATEGORY_VALUES } from "./constants/jobCategories.js";
85
86
  import {
86
87
  monitorEpisodesSchema,
87
88
  MonitorEpisode,
@@ -292,6 +293,10 @@ export {
292
293
  // rows that could actually alert:
293
294
  // { "subscribedDevices.deviceType": { $in: AQI_CAPABLE_DEVICE_TYPES } }
294
295
  AQI_CAPABLE_DEVICE_TYPES,
296
+ // Jobs.category persisted vocabulary (JA-3738) — jobsHandler, toos-backend
297
+ // and JustAirService import the strings instead of retyping them
298
+ JOB_CATEGORIES,
299
+ JOB_CATEGORY_VALUES,
295
300
  // subscribedDevices → monitor ids, resolved at READ time (JA-3110 / JA-3335).
296
301
  // Users.subscribedDevices is the source of truth; Users.subscribedMonitors is
297
302
  // being retired rather than kept in step with it. Nothing should store this
@@ -1,4 +1,5 @@
1
1
  import mongoose from "mongoose";
2
+ import { JOB_CATEGORY_VALUES } from "../constants/jobCategories.js";
2
3
 
3
4
  const jobsSchema = mongoose.Schema(
4
5
  {
@@ -6,13 +7,7 @@ const jobsSchema = mongoose.Schema(
6
7
  requestorEmail: String,
7
8
  category: {
8
9
  type: String,
9
- enum: [
10
- "Truck Detection",
11
- "Backfill Monitor Data",
12
- "AQI Network Summary",
13
- "Multi Monitor Data Pull",
14
- "Multi Monitor Average AQI Data Pull",
15
- ],
10
+ enum: JOB_CATEGORY_VALUES,
16
11
  },
17
12
  resourceURL: String,
18
13
  publicResourceURL: String,