@talkpilot/core-db 1.2.1 → 1.3.0

package/src/talkpilot/phone_numbers/phone_numbers.getter.ts

@@ -6,12 +6,12 @@ import {
   getFlowsCollection,
   ObjectId,
   findSubscriptions,
-} from '../index';
+} from "../index";
 import {
   ClientPhoneNumberForFlow,
   PhoneNumber,
   PhoneNumberWithFlow,
-  PurchasedPhoneProviderPayload
+  PurchasedPhoneProviderPayload,
 } from "./phone_numbers.types";
 
 export const getPhoneNumbersCollection = (): Collection<PhoneNumber> =>
@@ -140,13 +140,17 @@ export const createPurchasedPhoneNumber = async (
   await getPhoneNumbersCollection().insertOne(doc);
 
   const created = await getClientPhoneData(clientId, isPrimary);
-  if (!created) throw new Error('Failed to create phoneNumber');
+  if (!created) throw new Error("Failed to create phoneNumber");
   return created;
 };
 
-export const findClientByPhoneNumber = async (phoneNumber: string): Promise<Client> => {
-  const phoneData = await getPhoneNumbersCollection().findOne({ phone_number: phoneNumber });
-  if (!phoneData) throw new Error('Failed to get phone data');
+export const findClientByPhoneNumber = async (
+  phoneNumber: string,
+): Promise<Client> => {
+  const phoneData = await getPhoneNumbersCollection().findOne({
+    phone_number: phoneNumber,
+  });
+  if (!phoneData) throw new Error("Failed to get phone data");
   const clientId = phoneData.client_id;
   const client = await getClientsCollection().findOne({ clientId });
   if (!client) throw new Error("Failed to get client");

package/src/talkpilot/phone_numbers/phone_numbers.schema.ts

@@ -1,17 +1,17 @@
 export const phoneNumbersMongoSchema = {
-  bsonType: 'object',
-  required: ['client_id', 'phone_number'],
+  bsonType: "object",
+  required: ["client_id", "phone_number"],
   properties: {
-    _id: { bsonType: 'objectId' },
-    client_id: { bsonType: 'string' },
-    flow_id: { bsonType: ['objectId', 'string'] },
-    phone_number: { bsonType: 'string' },
-    is_primary: { bsonType: 'bool' },
-    provider: { bsonType: 'string' },
-    provider_sid: { bsonType: 'string' },
-    friendly_name: { bsonType: 'string' },
-    createdAt: { bsonType: 'date' },
-    updatedAt: { bsonType: 'date' },
+    _id: { bsonType: "objectId" },
+    client_id: { bsonType: "string" },
+    flow_id: { bsonType: ["objectId", "string"] },
+    phone_number: { bsonType: "string" },
+    is_primary: { bsonType: "bool" },
+    provider: { bsonType: "string" },
+    provider_sid: { bsonType: "string" },
+    friendly_name: { bsonType: "string" },
+    createdAt: { bsonType: "date" },
+    updatedAt: { bsonType: "date" },
   },
   additionalProperties: false,
 } as const;

package/src/talkpilot/phone_numbers/phone_numbers.types.ts

@@ -1,8 +1,8 @@
-import { ObjectId, WithId } from 'mongodb';
-import { Flow } from '../flows/flows.types';
+import { ObjectId, WithId } from "mongodb";
+import { Flow } from "../flows/flows.types";
 
 export type PurchasedPhoneProviderPayload = {
-  provider: 'twilio' | 'telnyx';
+  provider: "twilio" | "telnyx";
   provider_sid: string;
   friendly_name?: string;
 };
@@ -14,7 +14,7 @@ export type PhoneNumber = {
   phone_number: string;
   subscriptionId?: string;
   is_primary: boolean;
-  provider?: 'twilio' | 'telnyx';
+  provider?: "twilio" | "telnyx";
   provider_sid?: string;
   friendly_name?: string;
   createdAt: Date;

package/src/talkpilot/results/results.getter.ts

@@ -26,10 +26,14 @@ export const initializeResultDocument = async (
   return result;
 };
 
-export const findResultById = async (resultId: string | ObjectId): Promise<Result | null> => {
+export const findResultById = async (
+  resultId: string | ObjectId,
+): Promise<Result | null> => {
   return getResultsCollection().findOne({ _id: new ObjectId(resultId) });
 };
 
-export const findResultByCallSid = async (callSid: string): Promise<Result | null> => {
+export const findResultByCallSid = async (
+  callSid: string,
+): Promise<Result | null> => {
   return getResultsCollection().findOne({ "calls.callSid": callSid });
 };

package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts

@@ -8,7 +8,9 @@ export const getRetryAnalyzeCollection = (): Collection<RetryAnalyzeDoc> => {
   return getDb().collection<RetryAnalyzeDoc>(COLLECTION_NAME);
 };
 
-export const getAllRetryAnalyzeDocs = async (): Promise<RetryAnalyzeWithId[]> => {
+export const getAllRetryAnalyzeDocs = async (): Promise<
+  RetryAnalyzeWithId[]
+> => {
   return getRetryAnalyzeCollection()
     .find({
       $or: [{ retry: { $lt: 5 } }, { retry: { $exists: false } }],
@@ -44,18 +46,25 @@ export const upsertRetryAnalyzeDoc = async (
   );
 
   if (result.matchedCount > 0) {
-    await getRetryAnalyzeCollection().updateOne({ callSid: doc.callSid }, { $inc: { retry: 1 } });
+    await getRetryAnalyzeCollection().updateOne(
+      { callSid: doc.callSid },
+      { $inc: { retry: 1 } },
+    );
   }
 
   return result.upsertedId || null;
 };
 
-export const deleteRetryAnalyzeDocById = async (id: ObjectId): Promise<boolean> => {
+export const deleteRetryAnalyzeDocById = async (
+  id: ObjectId,
+): Promise<boolean> => {
   const result = await getRetryAnalyzeCollection().deleteOne({ _id: id });
   return result.deletedCount === 1;
 };
 
-export const deleteRetryAnalyzeDocByCallSid = async (callSid: string): Promise<boolean> => {
+export const deleteRetryAnalyzeDocByCallSid = async (
+  callSid: string,
+): Promise<boolean> => {
   const result = await getRetryAnalyzeCollection().deleteOne({ callSid });
   return result.deletedCount === 1;
 };

package/src/utils/date.utils.ts

@@ -0,0 +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);
+};

package/src/utils/shared.types.ts

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