@talkpilot/core-db 1.3.65 → 1.3.66

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

@@ -1,49 +1,61 @@
-/** 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);
+/** 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;

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

@@ -5,15 +5,34 @@ import {
   CallUpdateParams,
   getDb,
 } from "../index";
-import type { CountOpts, DateRange, ToolExecution, CallStatus } from "./calls.types";
+import type {
+  CountOpts,
+  DateRange,
+  ToolExecution,
+  CallStatus,
+  ActiveCallsSummary,
+  TodayCallsSummary,
+  ClientCallStats,
+  SessionCallStats,
+  StatsDateRangeParams,
+} 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");
@@ -275,3 +294,253 @@ 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]));
+};