@talkpilot/core-db 1.3.68 → 1.3.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (245) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/AGENTS.md +49 -49
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +816 -816
  5. package/dist/talkpilot/calls/calls.getters.d.ts +2 -1
  6. package/dist/talkpilot/calls/calls.getters.d.ts.map +1 -1
  7. package/dist/talkpilot/calls/calls.getters.js +6 -1
  8. package/dist/talkpilot/calls/calls.getters.js.map +1 -1
  9. package/dist/talkpilot/calls/calls.types.d.ts +3 -1
  10. package/dist/talkpilot/calls/calls.types.d.ts.map +1 -1
  11. package/jest.config.js +20 -20
  12. package/package.json +46 -46
  13. package/src/__tests__/setup.ts +20 -20
  14. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  15. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  16. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  17. package/src/bulkWrite/index.ts +2 -2
  18. package/src/config.ts +9 -9
  19. package/src/configuration/index.ts +17 -17
  20. package/src/configuration/internalModels/index.ts +3 -3
  21. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  22. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  23. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  24. package/src/configuration/models/__tests__/models.getters.spec.ts +67 -67
  25. package/src/configuration/models/index.ts +27 -27
  26. package/src/configuration/models/models.constants.ts +20 -20
  27. package/src/configuration/models/models.getters.ts +71 -71
  28. package/src/configuration/models/models.types.ts +80 -80
  29. package/src/configuration/mongodb-client.ts +62 -62
  30. package/src/configuration/prompts/index.ts +2 -2
  31. package/src/configuration/prompts/prompts.getters.ts +49 -49
  32. package/src/configuration/prompts/prompts.types.ts +11 -11
  33. package/src/connection.ts +81 -81
  34. package/src/index.ts +47 -47
  35. package/src/municipal/__tests__/validation.spec.ts +62 -62
  36. package/src/municipal/cities/cities.getters.ts +50 -50
  37. package/src/municipal/cities/cities.types.ts +11 -11
  38. package/src/municipal/cities/index.ts +2 -2
  39. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  40. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  41. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  42. package/src/municipal/departmentsSubjects/index.ts +9 -9
  43. package/src/municipal/index.ts +22 -22
  44. package/src/municipal/mongodb-client.ts +61 -61
  45. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  46. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  47. package/src/municipal/muniIssues/index.ts +17 -17
  48. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  49. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  50. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  51. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  52. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  53. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  54. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  55. package/src/municipal/streets/index.ts +2 -2
  56. package/src/municipal/streets/streets.getters.ts +140 -140
  57. package/src/municipal/streets/streets.types.ts +19 -19
  58. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  59. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  60. package/src/municipal/systemInstructions/index.ts +7 -7
  61. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  62. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  63. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  64. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  65. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  66. package/src/municipal/tickets/index.ts +9 -9
  67. package/src/municipal/tickets/tickets.constants.ts +8 -8
  68. package/src/municipal/tickets/tickets.getters.ts +121 -121
  69. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  70. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  71. package/src/municipal/tickets/tickets.types.ts +54 -54
  72. package/src/municipal/utils/types.ts +11 -11
  73. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  74. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  75. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  76. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  77. package/src/talkpilot/agents/agents.getters.ts +34 -34
  78. package/src/talkpilot/agents/agents.types.ts +14 -14
  79. package/src/talkpilot/agents/index.ts +2 -2
  80. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  81. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  82. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  83. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  84. package/src/talkpilot/callTokenUsage/__tests__/callTokenUsage.getters.spec.ts +57 -57
  85. package/src/talkpilot/callTokenUsage/callTokenUsage.getters.ts +42 -42
  86. package/src/talkpilot/callTokenUsage/callTokenUsage.types.ts +28 -28
  87. package/src/talkpilot/callTokenUsage/index.ts +2 -2
  88. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  89. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  90. package/src/talkpilot/calls/__tests__/calls.spec.ts +519 -471
  91. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  92. package/src/talkpilot/calls/calls.constants.ts +49 -49
  93. package/src/talkpilot/calls/calls.getters.ts +295 -277
  94. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  95. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  96. package/src/talkpilot/calls/calls.types.ts +154 -151
  97. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  98. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  99. package/src/talkpilot/calls/index.ts +6 -6
  100. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  101. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  102. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  103. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  104. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  105. package/src/talkpilot/clients/clients.getters.ts +19 -19
  106. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  107. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  108. package/src/talkpilot/clients/clients.types.ts +18 -18
  109. package/src/talkpilot/clients/index.ts +4 -4
  110. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  111. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  112. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  113. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  114. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +137 -137
  115. package/src/talkpilot/clientsConfig/index.ts +3 -3
  116. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  117. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  118. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  119. package/src/talkpilot/contextNotes/index.ts +2 -2
  120. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +124 -124
  121. package/src/talkpilot/flows/flows.getter.ts +34 -34
  122. package/src/talkpilot/flows/flows.schema.ts +180 -180
  123. package/src/talkpilot/flows/flows.types.ts +211 -211
  124. package/src/talkpilot/flows/index.ts +7 -7
  125. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  126. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  127. package/src/talkpilot/groups/groups.getters.ts +30 -30
  128. package/src/talkpilot/groups/groups.types.ts +29 -29
  129. package/src/talkpilot/groups/index.ts +3 -3
  130. package/src/talkpilot/groups/phone.utils.ts +46 -46
  131. package/src/talkpilot/index.ts +32 -32
  132. package/src/talkpilot/leads/index.ts +2 -2
  133. package/src/talkpilot/leads/leads.getter.ts +6 -6
  134. package/src/talkpilot/leads/leads.schema.ts +33 -33
  135. package/src/talkpilot/leads/leads.types.ts +20 -20
  136. package/src/talkpilot/mongodb-client.ts +78 -78
  137. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +530 -530
  138. package/src/talkpilot/phone_numbers/index.ts +2 -2
  139. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +240 -240
  140. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  141. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  142. package/src/talkpilot/phone_numbers/phone_numbers.utils.ts +9 -9
  143. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  144. package/src/talkpilot/plans/index.ts +2 -2
  145. package/src/talkpilot/plans/plans.getters.ts +132 -132
  146. package/src/talkpilot/plans/plans.types.ts +89 -89
  147. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  148. package/src/talkpilot/products/index.ts +2 -2
  149. package/src/talkpilot/products/products.getters.ts +12 -12
  150. package/src/talkpilot/products/products.types.ts +9 -9
  151. package/src/talkpilot/results/index.ts +7 -7
  152. package/src/talkpilot/results/results.getter.ts +39 -39
  153. package/src/talkpilot/results/results.schema.ts +25 -25
  154. package/src/talkpilot/results/results.types.ts +34 -34
  155. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  156. package/src/talkpilot/retry_analyze/index.ts +2 -2
  157. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  158. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  159. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  160. package/src/talkpilot/sessions/index.ts +2 -2
  161. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  162. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  163. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  164. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  165. package/src/talkpilot/subscriptions/index.ts +3 -3
  166. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  167. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  168. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  169. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  170. package/src/talkpilot/utils/query.utils.ts +21 -21
  171. package/src/test-utils/db-utils.ts +33 -33
  172. package/src/test-utils/factories/index.ts +18 -18
  173. package/src/test-utils/factories/municipal/cities.ts +16 -16
  174. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  175. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  176. package/src/test-utils/factories/municipal/streets.ts +22 -22
  177. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  178. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  179. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  180. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  181. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  182. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  183. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  184. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  185. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  186. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  187. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  188. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  189. package/src/test-utils/factories/websitalk/scans.ts +30 -30
  190. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  191. package/src/utils/date.utils.ts +126 -126
  192. package/src/utils/shared.types.ts +4 -4
  193. package/src/utils/validation.ts +23 -23
  194. package/src/websitalk/index.ts +18 -18
  195. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +238 -238
  196. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  197. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +26 -26
  198. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +95 -95
  199. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +75 -75
  200. package/src/websitalk/mongodb-client.ts +61 -61
  201. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +267 -267
  202. package/src/websitalk/scanResources/index.ts +4 -4
  203. package/src/websitalk/scanResources/scanResources.constants.ts +60 -60
  204. package/src/websitalk/scanResources/scanResources.getters.ts +128 -128
  205. package/src/websitalk/scanResources/scanResources.types.ts +105 -105
  206. package/src/websitalk/scanResources/scanResources.utils.ts +31 -31
  207. package/src/websitalk/scans/__tests__/scans.spec.ts +362 -362
  208. package/src/websitalk/scans/index.ts +4 -4
  209. package/src/websitalk/scans/scans.constants.ts +18 -18
  210. package/src/websitalk/scans/scans.getters.ts +172 -172
  211. package/src/websitalk/scans/scans.types.ts +58 -58
  212. package/src/websitalk/scans/scans.utils.ts +5 -5
  213. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  214. package/src/websitalk/websiteUrls/index.ts +2 -2
  215. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  216. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  217. package/tsconfig.json +23 -23
  218. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.d.ts +0 -10
  219. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.d.ts.map +0 -1
  220. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.js +0 -15
  221. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.js.map +0 -1
  222. package/dist/municipal/streets/streets.setters.d.ts +0 -10
  223. package/dist/municipal/streets/streets.setters.d.ts.map +0 -1
  224. package/dist/municipal/streets/streets.setters.js +0 -15
  225. package/dist/municipal/streets/streets.setters.js.map +0 -1
  226. package/dist/reconcile/index.d.ts +0 -5
  227. package/dist/reconcile/index.d.ts.map +0 -1
  228. package/dist/reconcile/index.js +0 -21
  229. package/dist/reconcile/index.js.map +0 -1
  230. package/dist/reconcile/reconcile.diff.d.ts +0 -4
  231. package/dist/reconcile/reconcile.diff.d.ts.map +0 -1
  232. package/dist/reconcile/reconcile.diff.js +0 -36
  233. package/dist/reconcile/reconcile.diff.js.map +0 -1
  234. package/dist/reconcile/reconcile.execute.d.ts +0 -7
  235. package/dist/reconcile/reconcile.execute.d.ts.map +0 -1
  236. package/dist/reconcile/reconcile.execute.js +0 -20
  237. package/dist/reconcile/reconcile.execute.js.map +0 -1
  238. package/dist/reconcile/reconcile.ops.d.ts +0 -12
  239. package/dist/reconcile/reconcile.ops.d.ts.map +0 -1
  240. package/dist/reconcile/reconcile.ops.js +0 -24
  241. package/dist/reconcile/reconcile.ops.js.map +0 -1
  242. package/dist/reconcile/reconcile.types.d.ts +0 -32
  243. package/dist/reconcile/reconcile.types.d.ts.map +0 -1
  244. package/dist/reconcile/reconcile.types.js +0 -3
  245. package/dist/reconcile/reconcile.types.js.map +0 -1
@@ -1,229 +1,229 @@
1
- import { describe, it, expect, beforeEach, afterEach } from "@jest/globals";
2
- import { getDashboardStats } from "../dashboard/calls.dashboard";
3
- import { getCallsCollection } from "../calls.getters";
4
- import { getClientsConfigCollection } from "../../clientsConfig/clientsConfig.getters";
5
-
6
- describe("getDashboardStats", () => {
7
- beforeEach(async () => {
8
- await getCallsCollection().deleteMany({});
9
- await getClientsConfigCollection().deleteMany({});
10
- });
11
-
12
- afterEach(async () => {
13
- await getCallsCollection().deleteMany({});
14
- await getClientsConfigCollection().deleteMany({});
15
- });
16
-
17
- it("should return correct empty dashboard stats when no calls exist", async () => {
18
- const clientId = "client-dash-123";
19
-
20
- await getClientsConfigCollection().insertOne({
21
- clientId,
22
- timezone: "UTC",
23
- products: {},
24
- } as any);
25
-
26
- const params = {
27
- clientId,
28
- startDate: "2026-05-01T00:00:00.000Z",
29
- endDate: "2026-05-31T23:59:59.999Z",
30
- };
31
-
32
- const result = await getDashboardStats(params);
33
-
34
- expect(result).toBeDefined();
35
- expect(result.kpis.totalCalls).toBe(0);
36
- expect(result.kpis.completedCount).toBe(0);
37
- expect(result.kpis.avgDurationSeconds).toBe(0);
38
- expect(result.kpis.inCallCount).toBe(0);
39
- expect(result.kpis.timeSavedMinutes).toBe(0);
40
- // ~30 day range -> daily buckets, gap-filled with zeros across the whole range
41
- expect(result.charts.volumeGranularity).toBe("day");
42
- expect(result.charts.volumeData.length).toBeGreaterThan(0);
43
- expect(result.charts.volumeData.every((d) => d.completed === 0)).toBe(true);
44
- expect(result.charts.volumeData[0].date).toBe("2026-05-01");
45
- expect(
46
- result.charts.volumeData[result.charts.volumeData.length - 1].date,
47
- ).toBe("2026-05-31");
48
- });
49
-
50
- it("should pick a bucket size that keeps the volume chart readable across range lengths", async () => {
51
- const clientId = "client-dash-456";
52
-
53
- await getClientsConfigCollection().insertOne({
54
- clientId,
55
- timezone: "UTC",
56
- products: {},
57
- } as any);
58
-
59
- const oneDay = await getDashboardStats({
60
- clientId,
61
- startDate: "2026-05-01T00:00:00.000Z",
62
- endDate: "2026-05-01T23:59:59.999Z",
63
- });
64
- expect(oneDay.charts.volumeGranularity).toBe("hour");
65
-
66
- const threeWeeks = await getDashboardStats({
67
- clientId,
68
- startDate: "2026-05-01T00:00:00.000Z",
69
- endDate: "2026-05-21T23:59:59.999Z",
70
- });
71
- expect(threeWeeks.charts.volumeGranularity).toBe("day");
72
-
73
- const fourMonths = await getDashboardStats({
74
- clientId,
75
- startDate: "2026-01-01T00:00:00.000Z",
76
- endDate: "2026-04-30T23:59:59.999Z",
77
- });
78
- expect(fourMonths.charts.volumeGranularity).toBe("week");
79
-
80
- const eighteenMonths = await getDashboardStats({
81
- clientId,
82
- startDate: "2025-01-01T00:00:00.000Z",
83
- endDate: "2026-06-30T23:59:59.999Z",
84
- });
85
- expect(eighteenMonths.charts.volumeGranularity).toBe("month");
86
-
87
- const threeYears = await getDashboardStats({
88
- clientId,
89
- startDate: "2023-01-01T00:00:00.000Z",
90
- endDate: "2026-01-01T23:59:59.999Z",
91
- });
92
- expect(threeYears.charts.volumeGranularity).toBe("quarter");
93
-
94
- const fiveYears = await getDashboardStats({
95
- clientId,
96
- startDate: "2021-01-01T00:00:00.000Z",
97
- endDate: "2026-01-01T23:59:59.999Z",
98
- });
99
- expect(fiveYears.charts.volumeGranularity).toBe("year");
100
- });
101
-
102
- it("should fill gaps with zero-count buckets so the chart has no missing points", async () => {
103
- const clientId = "client-dash-789";
104
-
105
- await getClientsConfigCollection().insertOne({
106
- clientId,
107
- timezone: "UTC",
108
- products: {},
109
- } as any);
110
-
111
- // Sparse data: only two of the day's hours have calls.
112
- await getCallsCollection().insertMany([
113
- {
114
- clientId,
115
- status: "completed",
116
- callLength: 60,
117
- createdAt: new Date("2026-05-01T09:15:00Z"),
118
- },
119
- {
120
- clientId,
121
- status: "completed",
122
- callLength: 90,
123
- createdAt: new Date("2026-05-01T18:45:00Z"),
124
- },
125
- ] as any);
126
-
127
- const result = await getDashboardStats({
128
- clientId,
129
- startDate: "2026-05-01T00:00:00.000Z",
130
- endDate: "2026-05-01T23:59:59.999Z",
131
- });
132
-
133
- expect(result.charts.volumeGranularity).toBe("hour");
134
- // A full day of hourly buckets, with no gaps, sorted chronologically.
135
- expect(result.charts.volumeData).toHaveLength(24);
136
- expect(result.charts.volumeData[0].date).toBe("2026-05-01T00:00");
137
- expect(result.charts.volumeData[23].date).toBe("2026-05-01T23:00");
138
-
139
- const populated = result.charts.volumeData.filter((d) => d.completed > 0);
140
- expect(populated).toHaveLength(2);
141
- expect(populated.map((d) => d.date)).toEqual([
142
- "2026-05-01T09:00",
143
- "2026-05-01T18:00",
144
- ]);
145
-
146
- const empty = result.charts.volumeData.filter((d) => d.completed === 0);
147
- expect(empty).toHaveLength(22);
148
- });
149
-
150
- it("should count in-progress and answered as inCallCount, not completed", async () => {
151
- const clientId = "client-dash-in-call";
152
-
153
- await getClientsConfigCollection().insertOne({
154
- clientId,
155
- timezone: "UTC",
156
- products: {},
157
- } as any);
158
-
159
- await getCallsCollection().insertMany([
160
- {
161
- clientId,
162
- status: "in-progress",
163
- callLength: 30,
164
- createdAt: new Date("2026-05-10T10:00:00Z"),
165
- },
166
- {
167
- clientId,
168
- status: "answered",
169
- callLength: 45,
170
- createdAt: new Date("2026-05-10T11:00:00Z"),
171
- },
172
- {
173
- clientId,
174
- status: "completed",
175
- callLength: 120,
176
- createdAt: new Date("2026-05-10T12:00:00Z"),
177
- },
178
- ] as any);
179
-
180
- const result = await getDashboardStats({
181
- clientId,
182
- startDate: "2026-05-01T00:00:00.000Z",
183
- endDate: "2026-05-31T23:59:59.999Z",
184
- });
185
-
186
- expect(result.kpis.inCallCount).toBe(2);
187
- expect(result.kpis.completedCount).toBe(1);
188
- expect(result.kpis.totalCalls).toBe(3);
189
- expect(result.kpis.avgDurationSeconds).toBe(120);
190
- expect(result.kpis.timeSavedMinutes).toBe(2);
191
- });
192
-
193
- it("should not count physical busy status as inCall or answered duration", async () => {
194
- const clientId = "client-dash-busy";
195
-
196
- await getClientsConfigCollection().insertOne({
197
- clientId,
198
- timezone: "UTC",
199
- products: {},
200
- } as any);
201
-
202
- await getCallsCollection().insertMany([
203
- {
204
- clientId,
205
- status: "busy",
206
- callLength: 60,
207
- createdAt: new Date("2026-05-10T10:00:00Z"),
208
- },
209
- {
210
- clientId,
211
- status: "completed",
212
- callLength: 90,
213
- createdAt: new Date("2026-05-10T11:00:00Z"),
214
- },
215
- ] as any);
216
-
217
- const result = await getDashboardStats({
218
- clientId,
219
- startDate: "2026-05-01T00:00:00.000Z",
220
- endDate: "2026-05-31T23:59:59.999Z",
221
- });
222
-
223
- expect(result.kpis.inCallCount).toBe(0);
224
- expect(result.kpis.completedCount).toBe(1);
225
- expect(result.kpis.totalCalls).toBe(1);
226
- expect(result.kpis.avgDurationSeconds).toBe(90);
227
- expect(result.kpis.timeSavedMinutes).toBe(2);
228
- });
229
- });
1
+ import { describe, it, expect, beforeEach, afterEach } from "@jest/globals";
2
+ import { getDashboardStats } from "../dashboard/calls.dashboard";
3
+ import { getCallsCollection } from "../calls.getters";
4
+ import { getClientsConfigCollection } from "../../clientsConfig/clientsConfig.getters";
5
+
6
+ describe("getDashboardStats", () => {
7
+ beforeEach(async () => {
8
+ await getCallsCollection().deleteMany({});
9
+ await getClientsConfigCollection().deleteMany({});
10
+ });
11
+
12
+ afterEach(async () => {
13
+ await getCallsCollection().deleteMany({});
14
+ await getClientsConfigCollection().deleteMany({});
15
+ });
16
+
17
+ it("should return correct empty dashboard stats when no calls exist", async () => {
18
+ const clientId = "client-dash-123";
19
+
20
+ await getClientsConfigCollection().insertOne({
21
+ clientId,
22
+ timezone: "UTC",
23
+ products: {},
24
+ } as any);
25
+
26
+ const params = {
27
+ clientId,
28
+ startDate: "2026-05-01T00:00:00.000Z",
29
+ endDate: "2026-05-31T23:59:59.999Z",
30
+ };
31
+
32
+ const result = await getDashboardStats(params);
33
+
34
+ expect(result).toBeDefined();
35
+ expect(result.kpis.totalCalls).toBe(0);
36
+ expect(result.kpis.completedCount).toBe(0);
37
+ expect(result.kpis.avgDurationSeconds).toBe(0);
38
+ expect(result.kpis.inCallCount).toBe(0);
39
+ expect(result.kpis.timeSavedMinutes).toBe(0);
40
+ // ~30 day range -> daily buckets, gap-filled with zeros across the whole range
41
+ expect(result.charts.volumeGranularity).toBe("day");
42
+ expect(result.charts.volumeData.length).toBeGreaterThan(0);
43
+ expect(result.charts.volumeData.every((d) => d.completed === 0)).toBe(true);
44
+ expect(result.charts.volumeData[0].date).toBe("2026-05-01");
45
+ expect(
46
+ result.charts.volumeData[result.charts.volumeData.length - 1].date,
47
+ ).toBe("2026-05-31");
48
+ });
49
+
50
+ it("should pick a bucket size that keeps the volume chart readable across range lengths", async () => {
51
+ const clientId = "client-dash-456";
52
+
53
+ await getClientsConfigCollection().insertOne({
54
+ clientId,
55
+ timezone: "UTC",
56
+ products: {},
57
+ } as any);
58
+
59
+ const oneDay = await getDashboardStats({
60
+ clientId,
61
+ startDate: "2026-05-01T00:00:00.000Z",
62
+ endDate: "2026-05-01T23:59:59.999Z",
63
+ });
64
+ expect(oneDay.charts.volumeGranularity).toBe("hour");
65
+
66
+ const threeWeeks = await getDashboardStats({
67
+ clientId,
68
+ startDate: "2026-05-01T00:00:00.000Z",
69
+ endDate: "2026-05-21T23:59:59.999Z",
70
+ });
71
+ expect(threeWeeks.charts.volumeGranularity).toBe("day");
72
+
73
+ const fourMonths = await getDashboardStats({
74
+ clientId,
75
+ startDate: "2026-01-01T00:00:00.000Z",
76
+ endDate: "2026-04-30T23:59:59.999Z",
77
+ });
78
+ expect(fourMonths.charts.volumeGranularity).toBe("week");
79
+
80
+ const eighteenMonths = await getDashboardStats({
81
+ clientId,
82
+ startDate: "2025-01-01T00:00:00.000Z",
83
+ endDate: "2026-06-30T23:59:59.999Z",
84
+ });
85
+ expect(eighteenMonths.charts.volumeGranularity).toBe("month");
86
+
87
+ const threeYears = await getDashboardStats({
88
+ clientId,
89
+ startDate: "2023-01-01T00:00:00.000Z",
90
+ endDate: "2026-01-01T23:59:59.999Z",
91
+ });
92
+ expect(threeYears.charts.volumeGranularity).toBe("quarter");
93
+
94
+ const fiveYears = await getDashboardStats({
95
+ clientId,
96
+ startDate: "2021-01-01T00:00:00.000Z",
97
+ endDate: "2026-01-01T23:59:59.999Z",
98
+ });
99
+ expect(fiveYears.charts.volumeGranularity).toBe("year");
100
+ });
101
+
102
+ it("should fill gaps with zero-count buckets so the chart has no missing points", async () => {
103
+ const clientId = "client-dash-789";
104
+
105
+ await getClientsConfigCollection().insertOne({
106
+ clientId,
107
+ timezone: "UTC",
108
+ products: {},
109
+ } as any);
110
+
111
+ // Sparse data: only two of the day's hours have calls.
112
+ await getCallsCollection().insertMany([
113
+ {
114
+ clientId,
115
+ status: "completed",
116
+ callLength: 60,
117
+ createdAt: new Date("2026-05-01T09:15:00Z"),
118
+ },
119
+ {
120
+ clientId,
121
+ status: "completed",
122
+ callLength: 90,
123
+ createdAt: new Date("2026-05-01T18:45:00Z"),
124
+ },
125
+ ] as any);
126
+
127
+ const result = await getDashboardStats({
128
+ clientId,
129
+ startDate: "2026-05-01T00:00:00.000Z",
130
+ endDate: "2026-05-01T23:59:59.999Z",
131
+ });
132
+
133
+ expect(result.charts.volumeGranularity).toBe("hour");
134
+ // A full day of hourly buckets, with no gaps, sorted chronologically.
135
+ expect(result.charts.volumeData).toHaveLength(24);
136
+ expect(result.charts.volumeData[0].date).toBe("2026-05-01T00:00");
137
+ expect(result.charts.volumeData[23].date).toBe("2026-05-01T23:00");
138
+
139
+ const populated = result.charts.volumeData.filter((d) => d.completed > 0);
140
+ expect(populated).toHaveLength(2);
141
+ expect(populated.map((d) => d.date)).toEqual([
142
+ "2026-05-01T09:00",
143
+ "2026-05-01T18:00",
144
+ ]);
145
+
146
+ const empty = result.charts.volumeData.filter((d) => d.completed === 0);
147
+ expect(empty).toHaveLength(22);
148
+ });
149
+
150
+ it("should count in-progress and answered as inCallCount, not completed", async () => {
151
+ const clientId = "client-dash-in-call";
152
+
153
+ await getClientsConfigCollection().insertOne({
154
+ clientId,
155
+ timezone: "UTC",
156
+ products: {},
157
+ } as any);
158
+
159
+ await getCallsCollection().insertMany([
160
+ {
161
+ clientId,
162
+ status: "in-progress",
163
+ callLength: 30,
164
+ createdAt: new Date("2026-05-10T10:00:00Z"),
165
+ },
166
+ {
167
+ clientId,
168
+ status: "answered",
169
+ callLength: 45,
170
+ createdAt: new Date("2026-05-10T11:00:00Z"),
171
+ },
172
+ {
173
+ clientId,
174
+ status: "completed",
175
+ callLength: 120,
176
+ createdAt: new Date("2026-05-10T12:00:00Z"),
177
+ },
178
+ ] as any);
179
+
180
+ const result = await getDashboardStats({
181
+ clientId,
182
+ startDate: "2026-05-01T00:00:00.000Z",
183
+ endDate: "2026-05-31T23:59:59.999Z",
184
+ });
185
+
186
+ expect(result.kpis.inCallCount).toBe(2);
187
+ expect(result.kpis.completedCount).toBe(1);
188
+ expect(result.kpis.totalCalls).toBe(3);
189
+ expect(result.kpis.avgDurationSeconds).toBe(120);
190
+ expect(result.kpis.timeSavedMinutes).toBe(2);
191
+ });
192
+
193
+ it("should not count physical busy status as inCall or answered duration", async () => {
194
+ const clientId = "client-dash-busy";
195
+
196
+ await getClientsConfigCollection().insertOne({
197
+ clientId,
198
+ timezone: "UTC",
199
+ products: {},
200
+ } as any);
201
+
202
+ await getCallsCollection().insertMany([
203
+ {
204
+ clientId,
205
+ status: "busy",
206
+ callLength: 60,
207
+ createdAt: new Date("2026-05-10T10:00:00Z"),
208
+ },
209
+ {
210
+ clientId,
211
+ status: "completed",
212
+ callLength: 90,
213
+ createdAt: new Date("2026-05-10T11:00:00Z"),
214
+ },
215
+ ] as any);
216
+
217
+ const result = await getDashboardStats({
218
+ clientId,
219
+ startDate: "2026-05-01T00:00:00.000Z",
220
+ endDate: "2026-05-31T23:59:59.999Z",
221
+ });
222
+
223
+ expect(result.kpis.inCallCount).toBe(0);
224
+ expect(result.kpis.completedCount).toBe(1);
225
+ expect(result.kpis.totalCalls).toBe(1);
226
+ expect(result.kpis.avgDurationSeconds).toBe(90);
227
+ expect(result.kpis.timeSavedMinutes).toBe(2);
228
+ });
229
+ });