@talkpilot/core-db 1.3.6 → 1.3.8

package/src/test-utils/factories/municipal/muniIssues.ts

@@ -1,32 +1,32 @@
-import { Factory } from "fishery";
-import { faker } from "@faker-js/faker";
-import type { CreateMuniIssueInput } from "../../../municipal";
-
-/**
- * Test factory for `createMuniIssue` input.
- * `jira.key` uses `sequence` so each build gets a unique key (the real key
- * comes from Jira in production).
- */
-export const muniIssueInputFactory = Factory.define<CreateMuniIssueInput>(
-  ({ sequence }) => ({
-    callSid: `CA${faker.string.alphanumeric(10)}`,
-    clientId: faker.string.uuid(),
-    cityName: faker.location.city(),
-    issueContent: {
-      issuerName: faker.person.fullName(),
-      issuerRole: faker.person.jobTitle(),
-      issueDescription: faker.lorem.sentence(),
-      desiredBehavior: faker.lorem.sentence(),
-    },
-    jira: {
-      key: `CP-${sequence}`,
-      syncStatus: "created",
-    },
-  }),
-);
-
-export function createMuniIssueInput(
-  overrides?: Partial<CreateMuniIssueInput>,
-): CreateMuniIssueInput {
-  return muniIssueInputFactory.build(overrides);
-}
+import { Factory } from "fishery";
+import { faker } from "@faker-js/faker";
+import type { CreateMuniIssueInput } from "../../../municipal";
+
+/**
+ * Test factory for `createMuniIssue` input.
+ * `jira.key` uses `sequence` so each build gets a unique key (the real key
+ * comes from Jira in production).
+ */
+export const muniIssueInputFactory = Factory.define<CreateMuniIssueInput>(
+  ({ sequence }) => ({
+    callSid: `CA${faker.string.alphanumeric(10)}`,
+    clientId: faker.string.uuid(),
+    cityName: faker.location.city(),
+    issueContent: {
+      issuerName: faker.person.fullName(),
+      issuerRole: faker.person.jobTitle(),
+      issueDescription: faker.lorem.sentence(),
+      desiredBehavior: faker.lorem.sentence(),
+    },
+    jira: {
+      key: `CP-${sequence}`,
+      syncStatus: "created",
+    },
+  }),
+);
+
+export function createMuniIssueInput(
+  overrides?: Partial<CreateMuniIssueInput>,
+): CreateMuniIssueInput {
+  return muniIssueInputFactory.build(overrides);
+}

package/src/test-utils/factories/talkpilot/contextNotes.ts

@@ -1,33 +1,33 @@
-import { Factory } from "fishery";
-import { ObjectId } from "mongodb";
-import { faker } from "@faker-js/faker";
-import type { ContextNote, ContextNoteEntry } from "../../../talkpilot";
-
-export const contextNoteEntryFactory = Factory.define<ContextNoteEntry>(() => ({
-  _id: new ObjectId(),
-  title: faker.lorem.words(3),
-  content: faker.lorem.sentences(2),
-  activeFrom: new Date(),
-  expiresAt: null,
-  createdAt: new Date(),
-  updatedAt: new Date(),
-}));
-
-export const contextNoteFactory = Factory.define<ContextNote & { _id: ObjectId }>(() => ({
-  _id: new ObjectId(),
-  clientId: faker.string.uuid(),
-  product: "Municipal",
-  notes: [],
-}));
-
-export function createContextNoteEntry(
-  overrides?: Partial<ContextNoteEntry>,
-): ContextNoteEntry {
-  return { ...contextNoteEntryFactory.build(), ...overrides } as ContextNoteEntry;
-}
-
-export function createContextNote(
-  overrides?: Partial<ContextNote>,
-): ContextNote & { _id: ObjectId } {
-  return { ...contextNoteFactory.build(), ...overrides } as ContextNote & { _id: ObjectId };
-}
+import { Factory } from "fishery";
+import { ObjectId } from "mongodb";
+import { faker } from "@faker-js/faker";
+import type { ContextNote, ContextNoteEntry } from "../../../talkpilot";
+
+export const contextNoteEntryFactory = Factory.define<ContextNoteEntry>(() => ({
+  _id: new ObjectId(),
+  title: faker.lorem.words(3),
+  content: faker.lorem.sentences(2),
+  activeFrom: new Date(),
+  expiresAt: null,
+  createdAt: new Date(),
+  updatedAt: new Date(),
+}));
+
+export const contextNoteFactory = Factory.define<ContextNote & { _id: ObjectId }>(() => ({
+  _id: new ObjectId(),
+  clientId: faker.string.uuid(),
+  product: "Municipal",
+  notes: [],
+}));
+
+export function createContextNoteEntry(
+  overrides?: Partial<ContextNoteEntry>,
+): ContextNoteEntry {
+  return { ...contextNoteEntryFactory.build(), ...overrides } as ContextNoteEntry;
+}
+
+export function createContextNote(
+  overrides?: Partial<ContextNote>,
+): ContextNote & { _id: ObjectId } {
+  return { ...contextNoteFactory.build(), ...overrides } as ContextNote & { _id: ObjectId };
+}

package/src/test-utils/factories/websitalk/scans.ts

@@ -1,23 +1,23 @@
-import { Factory } from "fishery";
-import { faker } from "@faker-js/faker";
-import type { Scan } from "../../../websitalk";
-
-export const scanFactory = Factory.define<Scan>(() => ({
-  clientId: faker.string.uuid(),
-  baseUrl: faker.internet.url(),
-  status: "CHECKING",
-  activeTasksCount: 0,
-  pagesScanned: 0,
-  pagesSkipped: 0,
-  skipped: [],
-  siteChrome: {
-    url: faker.internet.url(),
-    sourceType: "site_chrome",
-  },
-  createdAt: new Date(),
-  updatedAt: new Date(),
-}));
-
-export function createScanFixture(overrides?: Partial<Scan>): Scan {
-  return scanFactory.build(overrides);
-}
+import { Factory } from "fishery";
+import { faker } from "@faker-js/faker";
+import type { Scan } from "../../../websitalk";
+
+export const scanFactory = Factory.define<Scan>(() => ({
+  clientId: faker.string.uuid(),
+  baseUrl: faker.internet.url(),
+  status: "CHECKING",
+  activeTasksCount: 0,
+  pagesScanned: 0,
+  pagesSkipped: 0,
+  skipped: [],
+  siteChrome: {
+    url: faker.internet.url(),
+    sourceType: "site_chrome",
+  },
+  createdAt: new Date(),
+  updatedAt: new Date(),
+}));
+
+export function createScanFixture(overrides?: Partial<Scan>): Scan {
+  return scanFactory.build(overrides);
+}

package/src/utils/date.utils.ts

@@ -1,116 +1,116 @@
-/**
- * Shared timezone-aware date helpers for statistics aggregations.
- */
-
-/** Milliseconds in a single day. */
-export const DAY_MS = 24 * 60 * 60 * 1000;
-
-/** Maps a short weekday name (as produced by Intl) to its index (Sun = 0). */
-export const WEEKDAY: Record<string, number> = {
-  Sun: 0,
-  Mon: 1,
-  Tue: 2,
-  Wed: 3,
-  Thu: 4,
-  Fri: 5,
-  Sat: 6,
-};
-
-/** Parses a `YYYY-MM-DD` string into `[year, month, day]` numbers. */
-export const parseYmd = (dateStr: string): [number, number, number] => {
-  const [y, m, d] = dateStr.split("-").map(Number);
-  return [y, m, d];
-};
-
-/** Builds a zero-padded `YYYY-MM-DD` string from numeric parts. */
-export const ymdToStr = (y: number, m: number, d: number): string =>
-  `${y}-${String(m).padStart(2, "0")}-${String(d).padStart(2, "0")}`;
-
-/** Parses a `YYYY-MM-DD` string as midnight UTC. */
-export const toUtcDate = (dateStr: string): Date =>
-  new Date(`${dateStr}T00:00:00.000Z`);
-
-/** Formats a date as a `YYYY-MM-DD` string in UTC. */
-export const formatDate = (date: Date): string => date.toISOString().slice(0, 10);
-
-/** Adds `days` to a `YYYY-MM-DD` string, returning the resulting `YYYY-MM-DD`. */
-export const addDaysToDateStr = (dateStr: string, days: number): string =>
-  formatDate(new Date(toUtcDate(dateStr).getTime() + days * DAY_MS));
-
-/** Next civil calendar day (proleptic Gregorian). Avoids DST 24h steps that can stall iteration. */
-export const incrementYmd = (
-  y: number,
-  m: number,
-  d: number,
-): [number, number, number] => {
-  const next = new Date(Date.UTC(y, m - 1, d + 1));
-  return [next.getUTCFullYear(), next.getUTCMonth() + 1, next.getUTCDate()];
-};
-
-/**
- * Formats a date as the calendar day in the given timezone.
- * `en-CA` yields ISO-8601 `YYYY-MM-DD`, which is lexicographically sortable
- * (string compare == chronological compare) and matches MongoDB's `%Y-%m-%d`.
- */
-export const formatYmdInTz = (date: Date, timezone: string): string =>
-  new Intl.DateTimeFormat("en-CA", { timeZone: timezone }).format(date);
-
-/**
- * Returns the calendar day in the given timezone as numeric parts.
- * Reads parts by `type` (not string order), so `en-US` is fine here.
- */
-export const getYmdInTz = (date: Date, timezone: string) => {
-  const parts = Object.fromEntries(
-    new Intl.DateTimeFormat("en-US", {
-      timeZone: timezone,
-      year: "numeric",
-      month: "numeric",
-      day: "numeric",
-    })
-      .formatToParts(date)
-      .map((p) => [p.type, Number(p.value)]),
-  );
-  return { y: parts.year, m: parts.month, d: parts.day };
-};
-
-/** Weekday index (Sun = 0) of a date in the given timezone. */
-export const getWeekdayInTz = (date: Date, timezone: string): number =>
-  WEEKDAY[
-    new Intl.DateTimeFormat("en-US", { timeZone: timezone, weekday: "short" }).format(
-      date,
-    )
-  ] ?? 0;
-
-/**
- * Returns the given `YYYY-MM-DD` day at noon UTC — a stable anchor inside the
- * calendar day, far from midnight so timezone/DST shifts can't cross a date boundary.
- */
-export const dateAtNoonUtc = (dateStr: string): Date => {
-  const [y, m, d] = parseYmd(dateStr);
-  return new Date(Date.UTC(y, m - 1, d, 12, 0, 0));
-};
-
-/**
- * UTC instant at the start of the given `YYYY-MM-DD` calendar day in `timezone`.
- * Binary-searches the boundary so it stays correct across DST transitions.
- */
-export const startOfCalendarDayInTz = (dateStr: string, timezone: string): Date => {
-  const anchor = dateAtNoonUtc(dateStr).getTime();
-  let low = anchor - 2 * DAY_MS;
-  let high = anchor + DAY_MS;
-
-  while (high - low > 1 /* ms */) {
-    const mid = Math.floor((low + high) / 2);
-    if (formatYmdInTz(new Date(mid), timezone) >= dateStr) high = mid;
-    else low = mid;
-  }
-
-  return new Date(high);
-};
-
-/** UTC instant at the last millisecond of the given calendar day in `timezone`. */
-export const endOfCalendarDayInTz = (dateStr: string, timezone: string): Date => {
-  const [y, m, d] = parseYmd(dateStr);
-  const nextDay = new Date(Date.UTC(y, m - 1, d + 1)).toISOString().slice(0, 10);
-  return new Date(startOfCalendarDayInTz(nextDay, timezone).getTime() - 1);
-};
+/**
+ * Shared timezone-aware date helpers for statistics aggregations.
+ */
+
+/** Milliseconds in a single day. */
+export const DAY_MS = 24 * 60 * 60 * 1000;
+
+/** Maps a short weekday name (as produced by Intl) to its index (Sun = 0). */
+export const WEEKDAY: Record<string, number> = {
+  Sun: 0,
+  Mon: 1,
+  Tue: 2,
+  Wed: 3,
+  Thu: 4,
+  Fri: 5,
+  Sat: 6,
+};
+
+/** Parses a `YYYY-MM-DD` string into `[year, month, day]` numbers. */
+export const parseYmd = (dateStr: string): [number, number, number] => {
+  const [y, m, d] = dateStr.split("-").map(Number);
+  return [y, m, d];
+};
+
+/** Builds a zero-padded `YYYY-MM-DD` string from numeric parts. */
+export const ymdToStr = (y: number, m: number, d: number): string =>
+  `${y}-${String(m).padStart(2, "0")}-${String(d).padStart(2, "0")}`;
+
+/** Parses a `YYYY-MM-DD` string as midnight UTC. */
+export const toUtcDate = (dateStr: string): Date =>
+  new Date(`${dateStr}T00:00:00.000Z`);
+
+/** Formats a date as a `YYYY-MM-DD` string in UTC. */
+export const formatDate = (date: Date): string => date.toISOString().slice(0, 10);
+
+/** Adds `days` to a `YYYY-MM-DD` string, returning the resulting `YYYY-MM-DD`. */
+export const addDaysToDateStr = (dateStr: string, days: number): string =>
+  formatDate(new Date(toUtcDate(dateStr).getTime() + days * DAY_MS));
+
+/** Next civil calendar day (proleptic Gregorian). Avoids DST 24h steps that can stall iteration. */
+export const incrementYmd = (
+  y: number,
+  m: number,
+  d: number,
+): [number, number, number] => {
+  const next = new Date(Date.UTC(y, m - 1, d + 1));
+  return [next.getUTCFullYear(), next.getUTCMonth() + 1, next.getUTCDate()];
+};
+
+/**
+ * Formats a date as the calendar day in the given timezone.
+ * `en-CA` yields ISO-8601 `YYYY-MM-DD`, which is lexicographically sortable
+ * (string compare == chronological compare) and matches MongoDB's `%Y-%m-%d`.
+ */
+export const formatYmdInTz = (date: Date, timezone: string): string =>
+  new Intl.DateTimeFormat("en-CA", { timeZone: timezone }).format(date);
+
+/**
+ * Returns the calendar day in the given timezone as numeric parts.
+ * Reads parts by `type` (not string order), so `en-US` is fine here.
+ */
+export const getYmdInTz = (date: Date, timezone: string) => {
+  const parts = Object.fromEntries(
+    new Intl.DateTimeFormat("en-US", {
+      timeZone: timezone,
+      year: "numeric",
+      month: "numeric",
+      day: "numeric",
+    })
+      .formatToParts(date)
+      .map((p) => [p.type, Number(p.value)]),
+  );
+  return { y: parts.year, m: parts.month, d: parts.day };
+};
+
+/** Weekday index (Sun = 0) of a date in the given timezone. */
+export const getWeekdayInTz = (date: Date, timezone: string): number =>
+  WEEKDAY[
+    new Intl.DateTimeFormat("en-US", { timeZone: timezone, weekday: "short" }).format(
+      date,
+    )
+  ] ?? 0;
+
+/**
+ * Returns the given `YYYY-MM-DD` day at noon UTC — a stable anchor inside the
+ * calendar day, far from midnight so timezone/DST shifts can't cross a date boundary.
+ */
+export const dateAtNoonUtc = (dateStr: string): Date => {
+  const [y, m, d] = parseYmd(dateStr);
+  return new Date(Date.UTC(y, m - 1, d, 12, 0, 0));
+};
+
+/**
+ * UTC instant at the start of the given `YYYY-MM-DD` calendar day in `timezone`.
+ * Binary-searches the boundary so it stays correct across DST transitions.
+ */
+export const startOfCalendarDayInTz = (dateStr: string, timezone: string): Date => {
+  const anchor = dateAtNoonUtc(dateStr).getTime();
+  let low = anchor - 2 * DAY_MS;
+  let high = anchor + DAY_MS;
+
+  while (high - low > 1 /* ms */) {
+    const mid = Math.floor((low + high) / 2);
+    if (formatYmdInTz(new Date(mid), timezone) >= dateStr) high = mid;
+    else low = mid;
+  }
+
+  return new Date(high);
+};
+
+/** UTC instant at the last millisecond of the given calendar day in `timezone`. */
+export const endOfCalendarDayInTz = (dateStr: string, timezone: string): Date => {
+  const [y, m, d] = parseYmd(dateStr);
+  const nextDay = new Date(Date.UTC(y, m - 1, d + 1)).toISOString().slice(0, 10);
+  return new Date(startOfCalendarDayInTz(nextDay, timezone).getTime() - 1);
+};

package/src/websitalk/index.ts

@@ -1,15 +1,15 @@
-import { Db, ObjectId as MongoObjectId } from "mongodb";
-
-export * from "./scans";
-export { websitalkMongodbClient } from "./mongodb-client";
-
-let db: Db;
-export const setDb = (d: Db) => {
-  db = d;
-};
-
-export const getDb = (): Db => {
-  if (!db) throw new Error("Website Talk DB not initialised");
-  return db;
-};
-export const ObjectId = MongoObjectId;
+import { Db, ObjectId as MongoObjectId } from "mongodb";
+
+export * from "./scans";
+export { websitalkMongodbClient } from "./mongodb-client";
+
+let db: Db;
+export const setDb = (d: Db) => {
+  db = d;
+};
+
+export const getDb = (): Db => {
+  if (!db) throw new Error("Website Talk DB not initialised");
+  return db;
+};
+export const ObjectId = MongoObjectId;

package/src/websitalk/mongodb-client.ts

@@ -1,61 +1,61 @@
-import { MongoClient, Db } from "mongodb";
-import { setDb } from "./index";
-import { validateConfig, validateMongoUri } from "../utils/validation";
-
-class WebsitalkMongoDBClient {
-  private client: MongoClient | null = null;
-  private db: Db | null = null;
-  private readonly defaultDbName = "website-talk";
-
-  async connect(uri?: string, dbName?: string): Promise<void> {
-    if (this.client) {
-      return;
-    }
-
-    const mongodbUri = uri || process.env.MONGO_URI || process.env.MONGODB_URI;
-    validateConfig("MONGO_URI", mongodbUri);
-    validateMongoUri(mongodbUri!);
-
-    try {
-      this.client = new MongoClient(mongodbUri!);
-      await this.client.connect();
-      const targetDbName =
-        dbName || process.env.WEBSITALK_DB_NAME || this.defaultDbName;
-      this.db = this.client.db(targetDbName);
-      setDb(this.db);
-      console.info(`[core-db] Website Talk MongoDB connected: ${targetDbName}`);
-    } catch (error) {
-      console.error("[core-db] Website Talk connection failed", error);
-      throw error;
-    }
-  }
-
-  async disconnect(): Promise<void> {
-    if (this.client) {
-      try {
-        await this.client.close();
-        this.client = null;
-        this.db = null;
-        console.info("Website Talk MongoDB disconnected successfully");
-      } catch (error) {
-        console.error("[core-db] Website Talk disconnection failed", error);
-        throw error;
-      }
-    }
-  }
-
-  getDb(): Db {
-    if (!this.db) {
-      throw new Error(
-        "Website Talk database not initialized. Call connect() first.",
-      );
-    }
-    return this.db;
-  }
-
-  isConnected(): boolean {
-    return this.client !== null && this.client !== undefined;
-  }
-}
-
-export const websitalkMongodbClient = new WebsitalkMongoDBClient();
+import { MongoClient, Db } from "mongodb";
+import { setDb } from "./index";
+import { validateConfig, validateMongoUri } from "../utils/validation";
+
+class WebsitalkMongoDBClient {
+  private client: MongoClient | null = null;
+  private db: Db | null = null;
+  private readonly defaultDbName = "website-talk";
+
+  async connect(uri?: string, dbName?: string): Promise<void> {
+    if (this.client) {
+      return;
+    }
+
+    const mongodbUri = uri || process.env.MONGO_URI || process.env.MONGODB_URI;
+    validateConfig("MONGO_URI", mongodbUri);
+    validateMongoUri(mongodbUri!);
+
+    try {
+      this.client = new MongoClient(mongodbUri!);
+      await this.client.connect();
+      const targetDbName =
+        dbName || process.env.WEBSITALK_DB_NAME || this.defaultDbName;
+      this.db = this.client.db(targetDbName);
+      setDb(this.db);
+      console.info(`[core-db] Website Talk MongoDB connected: ${targetDbName}`);
+    } catch (error) {
+      console.error("[core-db] Website Talk connection failed", error);
+      throw error;
+    }
+  }
+
+  async disconnect(): Promise<void> {
+    if (this.client) {
+      try {
+        await this.client.close();
+        this.client = null;
+        this.db = null;
+        console.info("Website Talk MongoDB disconnected successfully");
+      } catch (error) {
+        console.error("[core-db] Website Talk disconnection failed", error);
+        throw error;
+      }
+    }
+  }
+
+  getDb(): Db {
+    if (!this.db) {
+      throw new Error(
+        "Website Talk database not initialized. Call connect() first.",
+      );
+    }
+    return this.db;
+  }
+
+  isConnected(): boolean {
+    return this.client !== null && this.client !== undefined;
+  }
+}
+
+export const websitalkMongodbClient = new WebsitalkMongoDBClient();