@talkpilot/core-db 1.3.66 → 1.3.68

package/src/talkpilot/calls/calls.constants.ts

@@ -1,61 +1,49 @@
-/** Customer role within a conference call. */
-export const CONFERENCE_ROLE_CUSTOMER = "customer" as const;
-
-/** Supervisor role within a conference call. */
-export const CONFERENCE_ROLE_SUPERVISOR = "supervisor" as const;
-
-/** Live call — «בשיחה». Excludes Twilio `busy` (line busy / «תפוס»). */
-export const IN_CALL_STATUSES = ["in-progress", "answered"] as const;
-
-/** Terminal Twilio call statuses — no further status callbacks expected. */
-export const FINAL_STATUSES = [
-  "no-answer",
-  "completed",
-  "busy",
-  "failed",
-  "canceled",
-] as const;
-
-/** sessionId used for calls that arrived without an existing session (incoming calls). */
-export const INCOMING_SESSION_ID = "incomingCall";
-
-/** Twilio call statuses considered "currently active" for the live calls summary. */
-export const ACTIVE_STATUSES = ["in-progress"];
-
-/** Lookback window for the "active calls right now" summary. */
-export const ACTIVE_CALLS_WINDOW_MS = 2 * 60 * 60 * 1000;
-
-/** Hours in a single day. */
-export const HOURS_PER_DAY = 24;
-
-/** Max execution time (ms) for calls statistics aggregations. */
-export const STATS_MAX_TIME_MS = 30_000;
-
-/**
- * When the client calls bar chart should group by week or month instead of day:
- *   > MONTH threshold  -> one bar per month
- *   > WEEK threshold   -> one bar per week
- *   otherwise          -> one bar per day
- */
-export const TREND_MONTH_BUCKET_MIN_MONTHS = 6;
-export const TREND_WEEK_BUCKET_MIN_MONTHS = 3;
-
-export const TOOL_EXECUTIONS_DEFAULT_SKIP = 0;
-export const TOOL_EXECUTIONS_DEFAULT_LIMIT = 50;
-
-export const CallStatusValues = {
-  Initiated: "initiated",
-  Ringing: "ringing",
-  InProgress: "in-progress",
-  Answered: "answered",
-  Completed: "completed",
-  Busy: "busy",
-  NoAnswer: "no-answer",
-  Failed: "failed",
-  Canceled: "canceled",
-} as const;
-
-export const ALL_CALL_STATUSES = Object.values(CallStatusValues);
-
-/** All statuses shown in the breakdown tables — kept separate so CallStatusValues stays untouched. */
-export const ALL_STATUSES_FOR_BREAKDOWN = [...ALL_CALL_STATUSES, "queued"] as const;
+/** Customer role within a conference call. */
+export const CONFERENCE_ROLE_CUSTOMER = "customer" as const;
+
+/** Supervisor role within a conference call. */
+export const CONFERENCE_ROLE_SUPERVISOR = "supervisor" as const;
+
+/** Live call — «בשיחה». Excludes Twilio `busy` (line busy / «תפוס»). */
+export const IN_CALL_STATUSES = ["in-progress", "answered"] as const;
+
+/** Terminal Twilio call statuses — no further status callbacks expected. */
+export const FINAL_STATUSES = [
+  "no-answer",
+  "completed",
+  "busy",
+  "failed",
+  "canceled",
+] as const;
+
+/** Hours in a single day. */
+export const HOURS_PER_DAY = 24;
+
+/** Max execution time (ms) for calls statistics aggregations. */
+export const STATS_MAX_TIME_MS = 30_000;
+
+/**
+ * When the client calls bar chart should group by week or month instead of day:
+ *   > MONTH threshold  -> one bar per month
+ *   > WEEK threshold   -> one bar per week
+ *   otherwise          -> one bar per day
+ */
+export const TREND_MONTH_BUCKET_MIN_MONTHS = 6;
+export const TREND_WEEK_BUCKET_MIN_MONTHS = 3;
+
+export const TOOL_EXECUTIONS_DEFAULT_SKIP = 0;
+export const TOOL_EXECUTIONS_DEFAULT_LIMIT = 50;
+
+export const CallStatusValues = {
+  Initiated: "initiated",
+  Ringing: "ringing",
+  InProgress: "in-progress",
+  Answered: "answered",
+  Completed: "completed",
+  Busy: "busy",
+  NoAnswer: "no-answer",
+  Failed: "failed",
+  Canceled: "canceled",
+} as const;
+
+export const ALL_CALL_STATUSES = Object.values(CallStatusValues);

package/src/talkpilot/calls/calls.getters.ts

@@ -5,34 +5,15 @@ import {
   CallUpdateParams,
   getDb,
 } from "../index";
-import type {
-  CountOpts,
-  DateRange,
-  ToolExecution,
-  CallStatus,
-  ActiveCallsSummary,
-  TodayCallsSummary,
-  ClientCallStats,
-  SessionCallStats,
-  StatsDateRangeParams,
-} from "./calls.types";
+import type { CountOpts, DateRange, ToolExecution, CallStatus } from "./calls.types";
 import {
   TOOL_EXECUTIONS_DEFAULT_LIMIT,
   TOOL_EXECUTIONS_DEFAULT_SKIP,
-  ACTIVE_STATUSES,
-  ACTIVE_CALLS_WINDOW_MS,
-  INCOMING_SESSION_ID,
-  ALL_STATUSES_FOR_BREAKDOWN,
 } from "./calls.constants";
 import { Filter, ObjectId } from "mongodb";
 import * as process from "node:process";
 import { applyQueryOptions } from "../utils/query.utils";
 import { DashboardHeatmapMetric } from "./dashboard/calls.dashboard.types";
-import {
-  formatYmdInTz,
-  startOfCalendarDayInTz,
-  endOfCalendarDayInTz,
-} from "../../utils/date.utils";
 
 export const getCallsCollection = () => {
   return getDb().collection<Call>("calls");
@@ -294,253 +275,3 @@ export async function getCallsHourlyAggregation(
     calls: r.calls,
   }));
 }
-
-type StatusCountFields = { [K in (typeof ALL_STATUSES_FOR_BREAKDOWN)[number]]: number };
-
-// One $sum/$cond accumulator per status in ALL_STATUSES_FOR_BREAKDOWN.
-const buildStatusCountFields = (field: string) =>
-  Object.fromEntries(
-    ALL_STATUSES_FOR_BREAKDOWN.map((status) => [
-      status,
-      { $sum: { $cond: [{ $eq: [field, status] }, 1, 0] } },
-    ]),
-  );
-
-const extractStatusCounts = (row: StatusCountFields): Record<string, number> =>
-  Object.fromEntries(ALL_STATUSES_FOR_BREAKDOWN.map((status) => [status, row[status] ?? 0]));
-
-const dateRangeFilter = (
-  dateFrom: string | undefined,
-  dateTo: string | undefined,
-  timezone: string,
-): { start: Date; end: Date } => {
-  const today = formatYmdInTz(new Date(), timezone);
-  return {
-    start: startOfCalendarDayInTz(dateFrom ?? today, timezone),
-    end: endOfCalendarDayInTz(dateTo ?? today, timezone),
-  };
-};
-
-const buildCallsStatsMatch = ({ dateFrom, dateTo, clientId, timezone = "UTC" }: StatsDateRangeParams) => {
-  const range = dateFrom || dateTo ? dateRangeFilter(dateFrom, dateTo, timezone) : null;
-  return {
-    ...(range ? { createdAt: { $gte: range.start, $lte: range.end } } : {}),
-    ...(clientId ? { clientId } : {}),
-  };
-};
-
-export const aggregateActiveCallsSummary = async (
-  clientId?: string,
-): Promise<ActiveCallsSummary> => {
-  const coll = getCallsCollection();
-  const twoHoursAgo = new Date(Date.now() - ACTIVE_CALLS_WINDOW_MS);
-
-  const match = {
-    status: { $in: ACTIVE_STATUSES },
-    updatedAt: { $gte: twoHoursAgo },
-    ...(clientId ? { clientId } : {}),
-  };
-
-  const facetResult = await coll
-    .aggregate<{
-      counts: { total: number; incoming: number; outgoing: number }[];
-      activeClients: { _id: string }[];
-    }>([
-      { $match: match },
-      {
-        $facet: {
-          counts: [
-            {
-              $group: {
-                _id: null,
-                total: { $sum: 1 },
-                incoming: { $sum: { $cond: ["$isIncomingCall", 1, 0] } },
-                outgoing: { $sum: { $cond: ["$isOutgoingCall", 1, 0] } },
-              },
-            },
-          ],
-          activeClients: [{ $group: { _id: "$clientId" } }],
-        },
-      },
-    ])
-    .next();
-
-  const counts = facetResult?.counts?.[0];
-
-  return {
-    total: counts?.total ?? 0,
-    incoming: counts?.incoming ?? 0,
-    outgoing: counts?.outgoing ?? 0,
-    activeClientIds: (facetResult?.activeClients ?? []).map((d) => d._id || "Unknown"),
-  };
-};
-
-export const aggregateTodayCallsSummary = async ({
-  dateFrom,
-  dateTo,
-  clientId,
-  timezone = "UTC",
-}: StatsDateRangeParams): Promise<TodayCallsSummary> => {
-  const coll = getCallsCollection();
-  const match = buildCallsStatsMatch({ dateFrom, dateTo, clientId, timezone });
-
-  const facetResult = await coll
-    .aggregate<{
-      byStatus: { _id: string; count: number }[];
-      byType: { _id: string; count: number }[];
-      total: { count: number }[];
-      totalSeconds: { seconds: number }[];
-    }>([
-      { $match: match },
-      {
-        $facet: {
-          byStatus: [{ $group: { _id: "$status", count: { $sum: 1 } } }],
-          byType: [
-            {
-              $group: {
-                _id: { $cond: ["$isIncomingCall", "incoming", "outgoing"] },
-                count: { $sum: 1 },
-              },
-            },
-          ],
-          total: [{ $group: { _id: null, count: { $sum: 1 } } }],
-          totalSeconds: [{ $group: { _id: null, seconds: { $sum: "$callLength" } } }],
-        },
-      },
-    ])
-    .next();
-
-  const byStatus: Record<string, number> = {};
-  (facetResult?.byStatus ?? []).forEach((s) => {
-    byStatus[s._id] = s.count;
-  });
-  const byType: Record<string, number> = {};
-  (facetResult?.byType ?? []).forEach((t) => {
-    byType[t._id] = t.count;
-  });
-
-  const totalSeconds = facetResult?.totalSeconds?.[0]?.seconds ?? 0;
-
-  return {
-    total: facetResult?.total?.[0]?.count ?? 0,
-    incoming: byType.incoming ?? 0,
-    outgoing: byType.outgoing ?? 0,
-    completed: byStatus.completed ?? 0,
-    failed: byStatus.failed ?? 0,
-    busy: byStatus.busy ?? 0,
-    noAnswer: byStatus["no-answer"] ?? 0,
-    totalMinutes: Math.ceil(totalSeconds / 60),
-  };
-};
-
-export const aggregateClientCallStats = async ({
-  dateFrom,
-  dateTo,
-  clientId,
-  timezone = "UTC",
-}: StatsDateRangeParams): Promise<ClientCallStats[]> => {
-  const coll = getCallsCollection();
-  const match = buildCallsStatsMatch({ dateFrom, dateTo, clientId, timezone });
-
-  const rows = await coll
-    .aggregate<
-      {
-        _id: string;
-        totalCalls: number;
-        totalSeconds: number;
-        lastCallDate: Date;
-      } & StatusCountFields
-    >([
-      { $match: match },
-      {
-        $group: {
-          _id: "$clientId",
-          totalCalls: { $sum: 1 },
-          ...buildStatusCountFields("$status"),
-          totalSeconds: { $sum: "$callLength" },
-          lastCallDate: { $max: "$createdAt" },
-        },
-      },
-      { $sort: { totalCalls: -1 } },
-    ])
-    .toArray();
-
-  return rows.map((r) => ({
-    clientId: r._id || "Unknown",
-    totalCalls: r.totalCalls,
-    statusCounts: extractStatusCounts(r),
-    totalMinutes: Math.ceil((r.totalSeconds || 0) / 60),
-    lastCallDate: r.lastCallDate,
-  }));
-};
-
-export const aggregateSessionCallStats = async ({
-  dateFrom,
-  dateTo,
-  clientId,
-  timezone = "UTC",
-}: StatsDateRangeParams): Promise<SessionCallStats[]> => {
-  const coll = getCallsCollection();
-  const match = buildCallsStatsMatch({ dateFrom, dateTo, clientId, timezone });
-
-  const rows = await coll
-    .aggregate<
-      {
-        _id: ObjectId | null;
-        sessionDoc: { session_name: string }[];
-        totalCalls: number;
-      } & StatusCountFields
-    >([
-      { $match: match },
-      {
-        $group: {
-          _id: "$sessionId",
-          totalCalls: { $sum: 1 },
-          ...buildStatusCountFields("$status"),
-        },
-      },
-      {
-        $lookup: {
-          from: "sessions",
-          localField: "_id",
-          foreignField: "_id",
-          as: "sessionDoc",
-        },
-      },
-      { $sort: { totalCalls: -1 } },
-    ])
-    .toArray();
-
-  return rows.map((r) => ({
-    // A null sessionId is an incoming call (expected), not a broken/orphaned one.
-    sessionId: r._id ? r._id.toString() : INCOMING_SESSION_ID,
-    sessionName: r._id ? r.sessionDoc[0]?.session_name || "Unknown" : "Incoming Call",
-    totalCalls: r.totalCalls,
-    statusCounts: extractStatusCounts(r),
-  }));
-};
-
-export const getAllClientsLastCallDate = async (): Promise<Map<string, Date>> => {
-  const rows = await getCallsCollection()
-    .aggregate<{ _id: string; lastCallDate: Date }>([
-      { $group: { _id: "$clientId", lastCallDate: { $max: "$createdAt" } } },
-    ])
-    .toArray();
-
-  return new Map(rows.map((r) => [r._id, r.lastCallDate]));
-};
-
-export const findClientIdsByCallSids = async (
-  callSids: string[],
-): Promise<Map<string, string>> => {
-  if (callSids.length === 0) return new Map();
-
-  const docs = await getCallsCollection()
-    .find(
-      { callSid: { $in: callSids } },
-      { projection: { _id: 0, clientId: 1, callSid: 1 } },
-    )
-    .toArray();
-
-  return new Map(docs.map((d) => [d.callSid, d.clientId]));
-};