@justair/justair-library 6.0.0 → 6.1.0

package/dist/index.d.ts

@@ -70,5 +70,6 @@ import { SamplesAudit } from "./models/samples.js";
 import { sampleParameterReferenceConcentrations } from "./models/samples.js";
 import { PARAMETERS } from "./constants/pollutants.js";
 import { HEAVY_METALS } from "./constants/pollutants.js";
-export { Database, adminSchema, Admin, configurationsSchema, Configurations, measurementsSchema, Measurements, monitorRequestsSchema, MonitorRequests, monitorsSchema, Monitors, organizationsSchema, Organizations, usersSchema, Users, eventsSchema, Events, lightMonitorSchema, LightMonitors, monitorSuppliersSchema, MonitorSuppliers, contextsSchema, Contexts, parametersSchema, Parameters, announcementSchema, Announcements, jobsSchema, Jobs, apiKeySchema, ApiKey, UsageMetrics, usageMetricsSchema, Audit, auditSchema, EventsAudit, eventsAuditSchema, MonitorAudit, monitorAuditSchema, parametersEnum, deploymentTypesEnum, AlertsAudit, Alerts, alertsSchema, alertsAuditSchema, Features, featuresSchema, dataCompletenessSchema, DataCompleteness, networkMetricsSchema, NetworkMetrics, rateOfChangeSchema, RateOfChange, sitesSchema, Sites, sampleSitesSchema, SampleSites, sampleSiteAuditSchema, SampleSiteAudit, sampleParametersEnum, samplesSchema, Samples, samplesAuditSchema, SamplesAudit, sampleParameterReferenceConcentrations, PARAMETERS, HEAVY_METALS };
+import { splitName } from "./utils/splitName.js";
+export { Database, adminSchema, Admin, configurationsSchema, Configurations, measurementsSchema, Measurements, monitorRequestsSchema, MonitorRequests, monitorsSchema, Monitors, organizationsSchema, Organizations, usersSchema, Users, eventsSchema, Events, lightMonitorSchema, LightMonitors, monitorSuppliersSchema, MonitorSuppliers, contextsSchema, Contexts, parametersSchema, Parameters, announcementSchema, Announcements, jobsSchema, Jobs, apiKeySchema, ApiKey, UsageMetrics, usageMetricsSchema, Audit, auditSchema, EventsAudit, eventsAuditSchema, MonitorAudit, monitorAuditSchema, parametersEnum, deploymentTypesEnum, AlertsAudit, Alerts, alertsSchema, alertsAuditSchema, Features, featuresSchema, dataCompletenessSchema, DataCompleteness, networkMetricsSchema, NetworkMetrics, rateOfChangeSchema, RateOfChange, sitesSchema, Sites, sampleSitesSchema, SampleSites, sampleSiteAuditSchema, SampleSiteAudit, sampleParametersEnum, samplesSchema, Samples, samplesAuditSchema, SamplesAudit, sampleParameterReferenceConcentrations, PARAMETERS, HEAVY_METALS, splitName };
 //# 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":"AAgFA;;;iBAEC;yBA1BwB,oBAAoB;qBADxB,gBAAgB;4BAvDF,mBAAmB;sBAAnB,mBAAmB;qCAI/C,4BAA4B;+BAA5B,4BAA4B;mCAM5B,0BAA0B;6BAA1B,0BAA0B;sCAI1B,6BAA6B;gCAA7B,6BAA6B;+BAQ7B,sBAAsB;yBAAtB,sBAAsB;oCACsB,2BAA2B;8BAA3B,2BAA2B;4BAQ3C,mBAAmB;sBAAnB,mBAAmB;6BAM/C,oBAAoB;uBAApB,oBAAoB;mCAbuB,2BAA2B;8BAA3B,2BAA2B;uCAItE,8BAA8B;iCAA9B,8BAA8B;+BACI,sBAAsB;yBAAtB,sBAAsB;iCAClB,wBAAwB;2BAAxB,wBAAwB;mCAQnB,2BAA2B;8BAA3B,2BAA2B;2BAC5C,kBAAkB;qBAAlB,kBAAkB;6BACd,oBAAoB;uBAApB,oBAAoB;6BACR,0BAA0B;mCAA1B,0BAA0B;sBA/BpE,0BAA0B;4BAA1B,0BAA0B;4BA2B1B,oBAAoB;kCAApB,oBAAoB;6BAfpB,sBAAsB;mCAAtB,sBAAsB;+BAAtB,sBAAsB;oCAAtB,sBAAsB;4BAyBtB,oBAAoB;uBAApB,oBAAoB;6BAApB,oBAAoB;kCAApB,oBAAoB;yBACc,sBAAsB;+BAAtB,sBAAsB;uCAIxD,8BAA8B;iCAA9B,8BAA8B;qCACgB,4BAA4B;+BAA5B,4BAA4B;mCAChC,0BAA0B;6BAA1B,0BAA0B;4BAMxC,mBAAmB;sBAAnB,mBAAmB;kCAS/C,yBAAyB;4BAAzB,yBAAyB;sCAAzB,yBAAyB;gCAAzB,yBAAyB;qCAAzB,yBAAyB;8BASzB,qBAAqB;wBAArB,qBAAqB;mCAArB,qBAAqB;6BAArB,qBAAqB;uDAArB,qBAAqB;2BArBa,2BAA2B;6BAA3B,2BAA2B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAiFA;;;iBAEC;yBA3BwB,oBAAoB;qBADxB,gBAAgB;4BAvDF,mBAAmB;sBAAnB,mBAAmB;qCAI/C,4BAA4B;+BAA5B,4BAA4B;mCAM5B,0BAA0B;6BAA1B,0BAA0B;sCAI1B,6BAA6B;gCAA7B,6BAA6B;+BAQ7B,sBAAsB;yBAAtB,sBAAsB;oCACsB,2BAA2B;8BAA3B,2BAA2B;4BAQ3C,mBAAmB;sBAAnB,mBAAmB;6BAM/C,oBAAoB;uBAApB,oBAAoB;mCAbuB,2BAA2B;8BAA3B,2BAA2B;uCAItE,8BAA8B;iCAA9B,8BAA8B;+BACI,sBAAsB;yBAAtB,sBAAsB;iCAClB,wBAAwB;2BAAxB,wBAAwB;mCAQnB,2BAA2B;8BAA3B,2BAA2B;2BAC5C,kBAAkB;qBAAlB,kBAAkB;6BACd,oBAAoB;uBAApB,oBAAoB;6BACR,0BAA0B;mCAA1B,0BAA0B;sBA/BpE,0BAA0B;4BAA1B,0BAA0B;4BA2B1B,oBAAoB;kCAApB,oBAAoB;6BAfpB,sBAAsB;mCAAtB,sBAAsB;+BAAtB,sBAAsB;oCAAtB,sBAAsB;4BAyBtB,oBAAoB;uBAApB,oBAAoB;6BAApB,oBAAoB;kCAApB,oBAAoB;yBACc,sBAAsB;+BAAtB,sBAAsB;uCAIxD,8BAA8B;iCAA9B,8BAA8B;qCACgB,4BAA4B;+BAA5B,4BAA4B;mCAChC,0BAA0B;6BAA1B,0BAA0B;4BAOxC,mBAAmB;sBAAnB,mBAAmB;kCAS/C,yBAAyB;4BAAzB,yBAAyB;sCAAzB,yBAAyB;gCAAzB,yBAAyB;qCAAzB,yBAAyB;8BASzB,qBAAqB;wBAArB,qBAAqB;mCAArB,qBAAqB;6BAArB,qBAAqB;uDAArB,qBAAqB;2BAtBa,2BAA2B;6BAA3B,2BAA2B;0BAC1C,sBAAsB"}

package/dist/utils/splitName.d.ts

@@ -0,0 +1,5 @@
+export function splitName(rawName: any): {
+    firstName: string;
+    lastName: string;
+};
+//# sourceMappingURL=splitName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"splitName.d.ts","sourceRoot":"","sources":["../../src/utils/splitName.js"],"names":[],"mappings":"AAsBA;;;EAqCC"}

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

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

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

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

package/package.json

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

package/src/index.js

@@ -56,6 +56,7 @@ import { RateOfChange, rateOfChangeSchema } from "./models/rateOfChange.js";
 import Database from "./config/db.js"; // Import the new Database class
 import CustomLogger from "./config/logger.js";
 import { PARAMETERS, HEAVY_METALS } from "./constants/pollutants.js";
+import { splitName } from "./utils/splitName.js";
 
 // Sites related imports
 import { sitesSchema, Sites } from "./models/sites.js";
@@ -154,4 +155,6 @@ export {
   // Pollutant constants
   PARAMETERS,
   HEAVY_METALS,
+  // Utilities
+  splitName,
 };

package/src/utils/splitName.js

@@ -0,0 +1,60 @@
+// Splits a single-field legacy `name` into { firstName, lastName }.
+// Mirrors the parsing table from JA-2387. Used by the one-time migration
+// script and by user/admin creation in JustAirUserService and JustAirService
+// until V2 signup collects firstName and lastName directly.
+
+const TITLES = new Set([
+  "dr",
+  "mr",
+  "mrs",
+  "ms",
+  "miss",
+  "prof",
+  "sir",
+  "madam",
+  "rev",
+]);
+
+const isTitle = (word) =>
+  TITLES.has(word.replace(/\.$/, "").toLowerCase());
+
+const isInitial = (word) => /^[A-Za-z]\.?$/.test(word);
+
+export function splitName(rawName) {
+  if (!rawName || typeof rawName !== "string") {
+    return { firstName: "", lastName: "" };
+  }
+  const trimmed = rawName.trim();
+  if (!trimmed) return { firstName: "", lastName: "" };
+
+  const w = trimmed.split(/\s+/);
+
+  if (w.length === 1) return { firstName: w[0], lastName: "" };
+  if (w.length === 2) return { firstName: w[0], lastName: w[1] };
+
+  if (w.length === 3) {
+    if (isTitle(w[0]))
+      return { firstName: `${w[0]} ${w[1]}`, lastName: w[2] };
+    if (isInitial(w[1]))
+      return { firstName: `${w[0]} ${w[1]}`, lastName: w[2] };
+    return { firstName: w[0], lastName: `${w[1]} ${w[2]}` };
+  }
+
+  if (w.length === 4) {
+    if (isTitle(w[0]))
+      return {
+        firstName: `${w[0]} ${w[1]}`,
+        lastName: `${w[2]} ${w[3]}`,
+      };
+    if (isInitial(w[0]))
+      return {
+        firstName: `${w[0]} ${w[1]}`,
+        lastName: `${w[2]} ${w[3]}`,
+      };
+    return { firstName: w[0], lastName: w.slice(1).join(" ") };
+  }
+
+  // 5+ words: not specified in JA-2387 table. Default to first word +
+  // remainder, consistent with the 4-word "other" rule.
+  return { firstName: w[0], lastName: w.slice(1).join(" ") };
+}

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

@@ -0,0 +1,108 @@
+import { splitName } from "../splitName.js";
+
+describe("splitName", () => {
+  describe("empty / invalid", () => {
+    test.each([null, undefined, "", "   ", 0, {}, []])(
+      "returns empty strings for %p",
+      (input) => {
+        expect(splitName(input)).toEqual({ firstName: "", lastName: "" });
+      },
+    );
+  });
+
+  describe("1 word", () => {
+    test("treats single word as firstName", () => {
+      expect(splitName("Derrick")).toEqual({
+        firstName: "Derrick",
+        lastName: "",
+      });
+    });
+  });
+
+  describe("2 words", () => {
+    test("splits into firstName and lastName", () => {
+      expect(splitName("Darren Riley")).toEqual({
+        firstName: "Darren",
+        lastName: "Riley",
+      });
+    });
+
+    test("preserves hyphenated last name", () => {
+      expect(splitName("Nate Rauh-Bieri")).toEqual({
+        firstName: "Nate",
+        lastName: "Rauh-Bieri",
+      });
+    });
+  });
+
+  describe("3 words", () => {
+    test("title prefix joins into firstName", () => {
+      expect(splitName("Dr. Jane Smith")).toEqual({
+        firstName: "Dr. Jane",
+        lastName: "Smith",
+      });
+    });
+
+    test("middle initial joins into firstName", () => {
+      expect(splitName("John A. Smith")).toEqual({
+        firstName: "John A.",
+        lastName: "Smith",
+      });
+    });
+
+    test("middle initial without period also joins", () => {
+      expect(splitName("John A Smith")).toEqual({
+        firstName: "John A",
+        lastName: "Smith",
+      });
+    });
+
+    test("other 3-word names go first word / last two", () => {
+      expect(splitName("Mary Van Witt")).toEqual({
+        firstName: "Mary",
+        lastName: "Van Witt",
+      });
+    });
+  });
+
+  describe("4 words", () => {
+    test("title prefix splits to two-word first / two-word last", () => {
+      expect(splitName("Dr. Jane Mary Smith")).toEqual({
+        firstName: "Dr. Jane",
+        lastName: "Mary Smith",
+      });
+    });
+
+    test("leading initial splits to two-word first / two-word last", () => {
+      expect(splitName("J. Mary Anne Smith")).toEqual({
+        firstName: "J. Mary",
+        lastName: "Anne Smith",
+      });
+    });
+
+    test("other 4-word names put first word in firstName, rest in lastName", () => {
+      expect(splitName("Mary Anne Van Witt")).toEqual({
+        firstName: "Mary",
+        lastName: "Anne Van Witt",
+      });
+    });
+  });
+
+  describe("5+ words", () => {
+    test("falls back to first word + remainder", () => {
+      expect(splitName("Mary Anne Elizabeth Van Witt")).toEqual({
+        firstName: "Mary",
+        lastName: "Anne Elizabeth Van Witt",
+      });
+    });
+  });
+
+  describe("whitespace handling", () => {
+    test("collapses multiple spaces", () => {
+      expect(splitName("  Darren   Riley  ")).toEqual({
+        firstName: "Darren",
+        lastName: "Riley",
+      });
+    });
+  });
+});