@talkpilot/core-db 1.3.19 → 1.3.21

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

@@ -1,33 +1,33 @@
-import { Factory } from "fishery";
-import { ObjectId } from "mongodb";
-import { faker } from "@faker-js/faker";
-import type { Flow } from "../../../talkpilot";
-
-export const flowFactory = Factory.define<Flow & { _id: ObjectId }>(() => {
-  const now = new Date();
-  return {
-    _id: new ObjectId(),
-    flowName: faker.lorem.words(2),
-    clientId: faker.string.uuid(),
-    systemInstructions: faker.lorem.sentences(2),
-    initialSentence: faker.lorem.sentence(),
-    insights: [],
-    interactions: [],
-    createdAt: now,
-    updatedAt: now,
-  };
-});
-
-export function createFlow(
-  overrides?: Partial<Flow>,
-): Flow & { _id: ObjectId } {
-  const now = new Date();
-  const base = flowFactory.build();
-  return {
-    ...base,
-    ...overrides,
-    _id: (overrides?._id as ObjectId) ?? base._id,
-    updatedAt: now,
-    createdAt: overrides?.createdAt ?? now,
-  };
-}
+import { Factory } from "fishery";
+import { ObjectId } from "mongodb";
+import { faker } from "@faker-js/faker";
+import type { Flow } from "../../../talkpilot";
+
+export const flowFactory = Factory.define<Flow & { _id: ObjectId }>(() => {
+  const now = new Date();
+  return {
+    _id: new ObjectId(),
+    flowName: faker.lorem.words(2),
+    clientId: faker.string.uuid(),
+    systemInstructions: faker.lorem.sentences(2),
+    initialSentence: faker.lorem.sentence(),
+    insights: [],
+    interactions: [],
+    createdAt: now,
+    updatedAt: now,
+  };
+});
+
+export function createFlow(
+  overrides?: Partial<Flow>,
+): Flow & { _id: ObjectId } {
+  const now = new Date();
+  const base = flowFactory.build();
+  return {
+    ...base,
+    ...overrides,
+    _id: (overrides?._id as ObjectId) ?? base._id,
+    updatedAt: now,
+    createdAt: overrides?.createdAt ?? now,
+  };
+}

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

@@ -1,33 +1,33 @@
-import { Factory } from "fishery";
-import { ObjectId } from "mongodb";
-import { faker } from "@faker-js/faker";
-import type { Group, GroupContact, GroupDoc } from "../../../talkpilot";
-
-export const groupContactFactory = Factory.define<GroupContact>(() => ({
-  name: faker.person.firstName(),
-  phone: {
-    national: "500000000",
-    національний: "500000000",
-    nacionales: "500000000",
-    национальные: "500000000",
-    e164: "+972500000000" as const,
-    region: "IL",
-    countryCallingCode: "972",
-    formatted: "+972 50-000-0000",
-  },
-  gender: faker.helpers.arrayElement(["male", "female"]),
-}));
-
-export const groupFactory = Factory.define<GroupDoc>(() => ({
-  _id: new ObjectId(),
-  clientId: faker.string.uuid(),
-  createdAt: new Date(),
-  updatedAt: new Date(),
-  name: faker.company.name(),
-  description: faker.lorem.sentence(),
-  contacts: groupContactFactory.buildList(2),
-}));
-
-export function createGroup(overrides?: Partial<Group>): GroupDoc {
-  return groupFactory.build(overrides);
-}
+import { Factory } from "fishery";
+import { ObjectId } from "mongodb";
+import { faker } from "@faker-js/faker";
+import type { Group, GroupContact, GroupDoc } from "../../../talkpilot";
+
+export const groupContactFactory = Factory.define<GroupContact>(() => ({
+  name: faker.person.firstName(),
+  phone: {
+    national: "500000000",
+    національний: "500000000",
+    nacionales: "500000000",
+    национальные: "500000000",
+    e164: "+972500000000" as const,
+    region: "IL",
+    countryCallingCode: "972",
+    formatted: "+972 50-000-0000",
+  },
+  gender: faker.helpers.arrayElement(["male", "female"]),
+}));
+
+export const groupFactory = Factory.define<GroupDoc>(() => ({
+  _id: new ObjectId(),
+  clientId: faker.string.uuid(),
+  createdAt: new Date(),
+  updatedAt: new Date(),
+  name: faker.company.name(),
+  description: faker.lorem.sentence(),
+  contacts: groupContactFactory.buildList(2),
+}));
+
+export function createGroup(overrides?: Partial<Group>): GroupDoc {
+  return groupFactory.build(overrides);
+}

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

@@ -1,22 +1,22 @@
-import { Factory } from "fishery";
-import { ObjectId } from "mongodb";
-import { faker } from "@faker-js/faker";
-import type { PhoneNumber } from "../../../talkpilot";
-
-export const phoneNumberFactory = Factory.define<
-  PhoneNumber & { _id?: ObjectId }
->(() => ({
-  _id: new ObjectId(),
-  client_id: faker.string.uuid(),
-  flow_id: new ObjectId(),
-  phone_number: faker.phone.number(),
-  createdAt: new Date(),
-  updatedAt: new Date(),
-  is_primary: true,
-}));
-
-export function createPhoneNumber(
-  overrides?: Partial<PhoneNumber> & { flow_id?: ObjectId },
-): PhoneNumber & { _id?: ObjectId } {
-  return phoneNumberFactory.build(overrides);
-}
+import { Factory } from "fishery";
+import { ObjectId } from "mongodb";
+import { faker } from "@faker-js/faker";
+import type { PhoneNumber } from "../../../talkpilot";
+
+export const phoneNumberFactory = Factory.define<
+  PhoneNumber & { _id?: ObjectId }
+>(() => ({
+  _id: new ObjectId(),
+  client_id: faker.string.uuid(),
+  flow_id: new ObjectId(),
+  phone_number: faker.phone.number(),
+  createdAt: new Date(),
+  updatedAt: new Date(),
+  is_primary: true,
+}));
+
+export function createPhoneNumber(
+  overrides?: Partial<PhoneNumber> & { flow_id?: ObjectId },
+): PhoneNumber & { _id?: ObjectId } {
+  return phoneNumberFactory.build(overrides);
+}

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

@@ -1,35 +1,35 @@
-import { Factory } from "fishery";
-import { ObjectId } from "mongodb";
-import { faker } from "@faker-js/faker";
-import type { Session } from "../../../talkpilot";
-
-export const sessionFactory = Factory.define<Session>(() => ({
-  _id: new ObjectId(),
-  session_name: faker.lorem.word(),
-  clientId: faker.string.uuid(),
-  flow_id: new ObjectId(),
-  phone_numbers: [
-    {
-      name: faker.person.firstName(),
-      phoneNumber: faker.phone.number(),
-      gender: "male" as const,
-    },
-  ],
-  json: null,
-  metaKeys: null,
-  voice: null,
-  company_name: null,
-  createdAt: new Date(),
-  updatedAt: new Date(),
-}));
-
-export function createSession(overrides?: Partial<Session>): Session {
-  const now = new Date();
-  const base = sessionFactory.build();
-  return {
-    ...base,
-    ...overrides,
-    createdAt: overrides?.createdAt ?? now,
-    updatedAt: now,
-  };
-}
+import { Factory } from "fishery";
+import { ObjectId } from "mongodb";
+import { faker } from "@faker-js/faker";
+import type { Session } from "../../../talkpilot";
+
+export const sessionFactory = Factory.define<Session>(() => ({
+  _id: new ObjectId(),
+  session_name: faker.lorem.word(),
+  clientId: faker.string.uuid(),
+  flow_id: new ObjectId(),
+  phone_numbers: [
+    {
+      name: faker.person.firstName(),
+      phoneNumber: faker.phone.number(),
+      gender: "male" as const,
+    },
+  ],
+  json: null,
+  metaKeys: null,
+  voice: null,
+  company_name: null,
+  createdAt: new Date(),
+  updatedAt: new Date(),
+}));
+
+export function createSession(overrides?: Partial<Session>): Session {
+  const now = new Date();
+  const base = sessionFactory.build();
+  return {
+    ...base,
+    ...overrides,
+    createdAt: overrides?.createdAt ?? now,
+    updatedAt: now,
+  };
+}

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

@@ -1,24 +1,24 @@
-import { Factory } from "fishery";
-import { faker } from "@faker-js/faker";
-import { ObjectId } from "mongodb";
-import type { Scan } from "../../../websitalk";
-
-export const scanFactory = Factory.define<Scan>(() => ({
-  clientId: faker.string.uuid(),
-  websiteUrlId: new ObjectId().toString(),
-  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 { ObjectId } from "mongodb";
+import type { Scan } from "../../../websitalk";
+
+export const scanFactory = Factory.define<Scan>(() => ({
+  clientId: faker.string.uuid(),
+  websiteUrlId: new ObjectId().toString(),
+  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/test-utils/factories/websitalk/websiteUrls.ts

@@ -1,17 +1,17 @@
-import { Factory } from "fishery";
-import { faker } from "@faker-js/faker";
-import type { WebsiteUrl } from "../../../websitalk/websiteUrls";
-
-export const websiteUrlFactory = Factory.define<WebsiteUrl>(() => ({
-  clientId: faker.string.uuid(),
-  name: faker.company.name(),
-  baseUrl: faker.internet.url(),
-  createdAt: new Date(),
-  updatedAt: new Date(),
-}));
-
-export function createWebsiteUrlFixture(
-  overrides?: Partial<WebsiteUrl>,
-): WebsiteUrl {
-  return websiteUrlFactory.build(overrides);
-}
+import { Factory } from "fishery";
+import { faker } from "@faker-js/faker";
+import type { WebsiteUrl } from "../../../websitalk/websiteUrls";
+
+export const websiteUrlFactory = Factory.define<WebsiteUrl>(() => ({
+  clientId: faker.string.uuid(),
+  name: faker.company.name(),
+  baseUrl: faker.internet.url(),
+  createdAt: new Date(),
+  updatedAt: new Date(),
+}));
+
+export function createWebsiteUrlFixture(
+  overrides?: Partial<WebsiteUrl>,
+): WebsiteUrl {
+  return websiteUrlFactory.build(overrides);
+}

package/src/utils/date.utils.ts

@@ -1,126 +1,126 @@
-/**
- * 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/utils/shared.types.ts

@@ -1,4 +1,4 @@
-export interface CallLengthThresholds {
-  shortThreshold: number;
-  mediumThreshold: number;
-}
+export interface CallLengthThresholds {
+  shortThreshold: number;
+  mediumThreshold: number;
+}

package/src/utils/validation.ts

@@ -1,23 +1,23 @@
-/**
- * Simple validation utilities for the core-db package.
- * Designed to be lightweight and only run when needed.
- */
-
-export const validateConfig = (configName: string, value?: string): string => {
-  if (!value || value.trim() === "") {
-    throw new Error(
-      `[core-db] Configuration Error: '${configName}' is missing. ` +
-        `Please provide it via parameters or set the corresponding environment variable.`,
-    );
-  }
-  return value;
-};
-
-export const validateMongoUri = (uri: string): void => {
-  if (!uri.startsWith("mongodb://") && !uri.startsWith("mongodb+srv://")) {
-    throw new Error(
-      `[core-db] Connection Error: The provided MongoDB URI is invalid. ` +
-        `It must start with 'mongodb://' or 'mongodb+srv://'. Received: '${uri}'`,
-    );
-  }
-};
+/**
+ * Simple validation utilities for the core-db package.
+ * Designed to be lightweight and only run when needed.
+ */
+
+export const validateConfig = (configName: string, value?: string): string => {
+  if (!value || value.trim() === "") {
+    throw new Error(
+      `[core-db] Configuration Error: '${configName}' is missing. ` +
+        `Please provide it via parameters or set the corresponding environment variable.`,
+    );
+  }
+  return value;
+};
+
+export const validateMongoUri = (uri: string): void => {
+  if (!uri.startsWith("mongodb://") && !uri.startsWith("mongodb+srv://")) {
+    throw new Error(
+      `[core-db] Connection Error: The provided MongoDB URI is invalid. ` +
+        `It must start with 'mongodb://' or 'mongodb+srv://'. Received: '${uri}'`,
+    );
+  }
+};