@talkpilot/core-db 1.3.7 → 1.3.9

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 (199) hide show
  1. package/.claude/settings.local.json +11 -0
  2. package/.cursor/rules/development.mdc +65 -65
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +257 -190
  5. package/README_OLD.md +160 -160
  6. package/dist/municipal/tickets/tickets.deprecated.getters.d.ts +12 -0
  7. package/dist/municipal/tickets/tickets.deprecated.getters.d.ts.map +1 -0
  8. package/dist/municipal/tickets/tickets.deprecated.getters.js +131 -0
  9. package/dist/municipal/tickets/tickets.deprecated.getters.js.map +1 -0
  10. package/dist/municipal/tickets/tickets.statistics.dates.d.ts +7 -0
  11. package/dist/municipal/tickets/tickets.statistics.dates.d.ts.map +1 -0
  12. package/dist/municipal/tickets/tickets.statistics.dates.js +40 -0
  13. package/dist/municipal/tickets/tickets.statistics.dates.js.map +1 -0
  14. package/dist/municipal/tickets/tickets.statistics.getters.d.ts +4 -0
  15. package/dist/municipal/tickets/tickets.statistics.getters.d.ts.map +1 -1
  16. package/dist/municipal/tickets/tickets.statistics.getters.js +30 -3
  17. package/dist/municipal/tickets/tickets.statistics.getters.js.map +1 -1
  18. package/dist/municipal/tickets/tickets.statistics.pipeline.d.ts +53 -0
  19. package/dist/municipal/tickets/tickets.statistics.pipeline.d.ts.map +1 -0
  20. package/dist/municipal/tickets/tickets.statistics.pipeline.js +112 -0
  21. package/dist/municipal/tickets/tickets.statistics.pipeline.js.map +1 -0
  22. package/dist/municipal/tickets/tickets.statistics.utils.d.ts +7 -0
  23. package/dist/municipal/tickets/tickets.statistics.utils.d.ts.map +1 -0
  24. package/dist/municipal/tickets/tickets.statistics.utils.js +40 -0
  25. package/dist/municipal/tickets/tickets.statistics.utils.js.map +1 -0
  26. package/dist/talkpilot/calls/calls.statistics.getters.d.ts.map +1 -1
  27. package/dist/talkpilot/calls/calls.statistics.getters.js +18 -18
  28. package/dist/talkpilot/calls/calls.statistics.getters.js.map +1 -1
  29. package/dist/talkpilot/calls/calls.statistics.ticketScope.d.ts +12 -0
  30. package/dist/talkpilot/calls/calls.statistics.ticketScope.d.ts.map +1 -0
  31. package/dist/talkpilot/calls/calls.statistics.ticketScope.js +37 -0
  32. package/dist/talkpilot/calls/calls.statistics.ticketScope.js.map +1 -0
  33. package/dist/talkpilot/calls/calls.statistics.tickets.d.ts +17 -0
  34. package/dist/talkpilot/calls/calls.statistics.tickets.d.ts.map +1 -0
  35. package/dist/talkpilot/calls/calls.statistics.tickets.js +33 -0
  36. package/dist/talkpilot/calls/calls.statistics.tickets.js.map +1 -0
  37. package/dist/talkpilot/calls/calls.statistics.types.d.ts +4 -1
  38. package/dist/talkpilot/calls/calls.statistics.types.d.ts.map +1 -1
  39. package/dist/utils/statistics.aggregation.d.ts +20 -0
  40. package/dist/utils/statistics.aggregation.d.ts.map +1 -0
  41. package/dist/utils/statistics.aggregation.js +43 -0
  42. package/dist/utils/statistics.aggregation.js.map +1 -0
  43. package/jest.config.js +20 -20
  44. package/package.json +46 -46
  45. package/src/__tests__/setup.ts +20 -20
  46. package/src/connection.ts +54 -54
  47. package/src/index.ts +26 -26
  48. package/src/municipal/__tests__/validation.spec.ts +62 -62
  49. package/src/municipal/cities/cities.getters.ts +50 -50
  50. package/src/municipal/cities/cities.types.ts +11 -11
  51. package/src/municipal/cities/index.ts +2 -2
  52. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +282 -282
  53. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +72 -72
  54. package/src/municipal/departmentsSubjects/index.ts +9 -9
  55. package/src/municipal/index.ts +22 -22
  56. package/src/municipal/mongodb-client.ts +61 -61
  57. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +92 -92
  58. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  59. package/src/municipal/muniIssues/index.ts +17 -17
  60. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  61. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  62. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  63. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  64. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  65. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  66. package/src/municipal/streets/index.ts +2 -2
  67. package/src/municipal/streets/streets.getters.ts +125 -125
  68. package/src/municipal/streets/streets.types.ts +18 -18
  69. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  70. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  71. package/src/municipal/systemInstructions/index.ts +7 -7
  72. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  73. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  74. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  75. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  76. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +68 -51
  77. package/src/municipal/tickets/index.ts +3 -3
  78. package/src/municipal/tickets/tickets.constants.ts +8 -8
  79. package/src/municipal/tickets/tickets.getters.ts +121 -121
  80. package/src/municipal/tickets/tickets.statistics.aggregation.ts +96 -96
  81. package/src/municipal/tickets/tickets.statistics.getters.ts +109 -71
  82. package/src/municipal/tickets/tickets.types.ts +53 -53
  83. package/src/municipal/utils/types.ts +11 -11
  84. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  85. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  86. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  87. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  88. package/src/talkpilot/agents/agents.getters.ts +34 -34
  89. package/src/talkpilot/agents/agents.types.ts +14 -14
  90. package/src/talkpilot/agents/index.ts +2 -2
  91. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  92. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  93. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  94. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  95. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  96. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +149 -149
  97. package/src/talkpilot/calls/__tests__/calls.spec.ts +270 -270
  98. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +375 -344
  99. package/src/talkpilot/calls/calls.constants.ts +20 -20
  100. package/src/talkpilot/calls/calls.getters.ts +248 -248
  101. package/src/talkpilot/calls/calls.statistics.getters.ts +590 -587
  102. package/src/talkpilot/calls/calls.statistics.types.ts +47 -44
  103. package/src/talkpilot/calls/calls.types.ts +119 -119
  104. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +292 -292
  105. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  106. package/src/talkpilot/calls/index.ts +6 -6
  107. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  108. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  109. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  110. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  111. package/src/talkpilot/clients/clients.getters.ts +16 -16
  112. package/src/talkpilot/clients/clients.types.ts +14 -14
  113. package/src/talkpilot/clients/index.ts +2 -2
  114. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +53 -53
  115. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +190 -190
  116. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +55 -55
  117. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +127 -127
  118. package/src/talkpilot/clientsConfig/index.ts +2 -2
  119. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +176 -176
  120. package/src/talkpilot/contextNotes/contextNotes.getters.ts +86 -86
  121. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  122. package/src/talkpilot/contextNotes/index.ts +2 -2
  123. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +96 -96
  124. package/src/talkpilot/flows/flows.getter.ts +14 -14
  125. package/src/talkpilot/flows/flows.schema.ts +154 -154
  126. package/src/talkpilot/flows/flows.types.ts +187 -187
  127. package/src/talkpilot/flows/index.ts +2 -2
  128. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  129. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  130. package/src/talkpilot/groups/groups.getters.ts +30 -30
  131. package/src/talkpilot/groups/groups.types.ts +29 -29
  132. package/src/talkpilot/groups/index.ts +3 -3
  133. package/src/talkpilot/groups/phone.utils.ts +46 -46
  134. package/src/talkpilot/index.ts +31 -31
  135. package/src/talkpilot/leads/index.ts +2 -2
  136. package/src/talkpilot/leads/leads.getter.ts +6 -6
  137. package/src/talkpilot/leads/leads.schema.ts +33 -33
  138. package/src/talkpilot/leads/leads.types.ts +20 -20
  139. package/src/talkpilot/mongodb-client.ts +78 -78
  140. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +252 -252
  141. package/src/talkpilot/phone_numbers/index.ts +2 -2
  142. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +158 -158
  143. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  144. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  145. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  146. package/src/talkpilot/plans/index.ts +2 -2
  147. package/src/talkpilot/plans/plans.getters.ts +132 -132
  148. package/src/talkpilot/plans/plans.types.ts +89 -89
  149. package/src/talkpilot/products/__tests__/products.getters.spec.ts +45 -45
  150. package/src/talkpilot/products/index.ts +2 -2
  151. package/src/talkpilot/products/products.getters.ts +12 -12
  152. package/src/talkpilot/products/products.types.ts +9 -9
  153. package/src/talkpilot/results/index.ts +7 -7
  154. package/src/talkpilot/results/results.getter.ts +39 -39
  155. package/src/talkpilot/results/results.schema.ts +25 -25
  156. package/src/talkpilot/results/results.types.ts +34 -34
  157. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  158. package/src/talkpilot/retry_analyze/index.ts +2 -2
  159. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  160. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  161. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  162. package/src/talkpilot/sessions/index.ts +2 -2
  163. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  164. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  165. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  166. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  167. package/src/talkpilot/subscriptions/index.ts +3 -3
  168. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  169. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  170. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  171. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  172. package/src/talkpilot/utils/query.utils.ts +21 -21
  173. package/src/test-utils/db-utils.ts +26 -26
  174. package/src/test-utils/factories/index.ts +15 -15
  175. package/src/test-utils/factories/municipal/cities.ts +16 -16
  176. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  177. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  178. package/src/test-utils/factories/municipal/streets.ts +22 -22
  179. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  180. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  181. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  182. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  183. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  184. package/src/test-utils/factories/talkpilot/contextNotes.ts +33 -33
  185. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  186. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  187. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  188. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  189. package/src/test-utils/factories/websitalk/scans.ts +23 -23
  190. package/src/utils/date.utils.ts +116 -116
  191. package/src/utils/shared.types.ts +4 -4
  192. package/src/utils/validation.ts +23 -23
  193. package/src/websitalk/index.ts +15 -15
  194. package/src/websitalk/mongodb-client.ts +61 -61
  195. package/src/websitalk/scans/__tests__/scans.spec.ts +218 -218
  196. package/src/websitalk/scans/index.ts +2 -2
  197. package/src/websitalk/scans/scans.getters.ts +113 -113
  198. package/src/websitalk/scans/scans.types.ts +53 -53
  199. package/tsconfig.json +23 -23
@@ -1,270 +1,270 @@
1
- import {
2
- createCallDoc,
3
- getCallsByFlow,
4
- getCallsByClient,
5
- getCallsByPhoneNumber,
6
- getCallByCallSid,
7
- findCallsByQuery,
8
- countCalls,
9
- getCallsByClientAndDateRange,
10
- getCallsCollection,
11
- pushToolExecution,
12
- } from "../calls.getters";
13
- import type { ToolExecution } from "../calls.types";
14
- import { ObjectId } from "mongodb";
15
- import { createOutGoingCallDoc } from "../../../test-utils/factories";
16
-
17
- describe("db.calls", () => {
18
- it("should return calls by flow", async () => {
19
- const flowId = new ObjectId();
20
- const call1 = createOutGoingCallDoc({ flowId });
21
- const call2 = createOutGoingCallDoc({ flowId });
22
-
23
- await createCallDoc(call1);
24
- await createCallDoc(call2);
25
-
26
- const result = await getCallsByFlow(flowId);
27
-
28
- expect(result.length).toBe(2);
29
- expect(result).toMatchObject([
30
- { callSid: call1.callSid },
31
- { callSid: call2.callSid },
32
- ]);
33
- });
34
-
35
- it("should get call by callSid", async () => {
36
- const call = createOutGoingCallDoc();
37
- await createCallDoc(call);
38
-
39
- const result = await getCallByCallSid(call.callSid);
40
-
41
- expect(result).toBeDefined();
42
- expect(result?.callSid).toBe(call.callSid);
43
- });
44
-
45
- it("should get calls by client", async () => {
46
- const call = createOutGoingCallDoc();
47
- await createCallDoc(call);
48
-
49
- const result = await getCallsByClient(call.clientId);
50
-
51
- expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
52
- });
53
-
54
- it("should get calls by phone number", async () => {
55
- const call = createOutGoingCallDoc();
56
- await createCallDoc(call);
57
-
58
- const result = await getCallsByPhoneNumber(call.customerPhoneNumber);
59
-
60
- expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
61
- });
62
-
63
- describe("findCallsByQuery()", () => {
64
- it("should find calls by status with limit and sort", async () => {
65
- const clientId = "client123";
66
- const call1 = createOutGoingCallDoc({ clientId, status: "completed" });
67
- const call2 = createOutGoingCallDoc({ clientId, status: "completed" });
68
- const call3 = createOutGoingCallDoc({ clientId, status: "busy" });
69
-
70
- // We need to control createdAt to test sort. We'll insert directly.
71
- await getCallsCollection().insertOne({
72
- ...call1,
73
- createdAt: new Date("2023-01-01"),
74
- updatedAt: new Date(),
75
- env: "test",
76
- });
77
- await getCallsCollection().insertOne({
78
- ...call2,
79
- createdAt: new Date("2023-01-02"),
80
- updatedAt: new Date(),
81
- env: "test",
82
- });
83
- await getCallsCollection().insertOne({
84
- ...call3,
85
- createdAt: new Date(),
86
- updatedAt: new Date(),
87
- env: "test",
88
- });
89
-
90
- const result = await findCallsByQuery(
91
- { clientId, status: "completed" },
92
- { sort: { createdAt: -1 }, limit: 1 },
93
- );
94
-
95
- expect(result.length).toBe(1);
96
- expect(result[0].callSid).toBe(call2.callSid);
97
- });
98
- });
99
-
100
- describe("countCalls()", () => {
101
- it("should count calls matching query", async () => {
102
- const clientId = "countClient";
103
- await createCallDoc(
104
- createOutGoingCallDoc({ clientId, status: "completed" }),
105
- );
106
- await createCallDoc(
107
- createOutGoingCallDoc({ clientId, status: "completed" }),
108
- );
109
- await createCallDoc(
110
- createOutGoingCallDoc({ clientId, status: "failed" }),
111
- );
112
-
113
- const count = await countCalls({ clientId, status: "completed" });
114
- expect(count).toBe(2);
115
- });
116
- });
117
-
118
- describe("pushToolExecution()", () => {
119
- let callSid: string;
120
-
121
- beforeEach(async () => {
122
- const call = createOutGoingCallDoc();
123
- await createCallDoc(call);
124
- callSid = call.callSid;
125
- });
126
-
127
- const makeHttpExecution = (
128
- overrides?: Partial<ToolExecution>,
129
- ): ToolExecution => ({
130
- toolName: "sendSms",
131
- executedAt: new Date(),
132
- durationMs: 120,
133
- args: { to: "+1234567890", message: "hello" },
134
- meta: {
135
- kind: "http",
136
- url: "https://api.example.com/sms",
137
- method: "POST",
138
- },
139
- status: "success",
140
- httpStatus: 200,
141
- ...overrides,
142
- });
143
-
144
- it("should append an execution to a call with none", async () => {
145
- const execution = makeHttpExecution();
146
- await pushToolExecution(callSid, execution);
147
-
148
- const result = await getCallByCallSid(callSid);
149
- expect(result?.toolExecutions).toHaveLength(1);
150
- expect(result?.toolExecutions?.[0]).toMatchObject({
151
- toolName: "sendSms",
152
- status: "success",
153
- httpStatus: 200,
154
- });
155
- });
156
-
157
- it("should maintain insertion order across multiple pushes", async () => {
158
- const first = makeHttpExecution({ toolName: "first" });
159
- const second = makeHttpExecution({ toolName: "second" });
160
- const third = makeHttpExecution({ toolName: "third" });
161
-
162
- await pushToolExecution(callSid, first);
163
- await pushToolExecution(callSid, second);
164
- await pushToolExecution(callSid, third);
165
-
166
- const result = await getCallByCallSid(callSid);
167
- expect(result?.toolExecutions?.map((e) => e.toolName)).toEqual([
168
- "first",
169
- "second",
170
- "third",
171
- ]);
172
- });
173
-
174
- it("should store an internal tool execution", async () => {
175
- const execution: ToolExecution = {
176
- toolName: "endFlow",
177
- executedAt: new Date(),
178
- durationMs: 5,
179
- args: {},
180
- meta: { kind: "internal" },
181
- status: "success",
182
- };
183
-
184
- await pushToolExecution(callSid, execution);
185
-
186
- const result = await getCallByCallSid(callSid);
187
- expect(result?.toolExecutions?.[0]).toMatchObject({
188
- toolName: "endFlow",
189
- meta: { kind: "internal" },
190
- });
191
- });
192
-
193
- it("should store redacted args for sensitive tools", async () => {
194
- const execution = makeHttpExecution({ args: { _redacted: true } });
195
- await pushToolExecution(callSid, execution);
196
-
197
- const result = await getCallByCallSid(callSid);
198
- expect(result?.toolExecutions?.[0].args).toEqual({ _redacted: true });
199
- });
200
-
201
- it("should store an error execution", async () => {
202
- const execution = makeHttpExecution({ status: "error", httpStatus: 500 });
203
- await pushToolExecution(callSid, execution);
204
-
205
- const result = await getCallByCallSid(callSid);
206
- expect(result?.toolExecutions?.[0]).toMatchObject({
207
- status: "error",
208
- httpStatus: 500,
209
- });
210
- });
211
-
212
- it("should be a no-op for an unknown callSid", async () => {
213
- await expect(
214
- pushToolExecution("nonexistent-sid", makeHttpExecution()),
215
- ).resolves.not.toThrow();
216
- });
217
-
218
- it("should store the response body", async () => {
219
- const execution = makeHttpExecution({
220
- response: { userId: "123", status: "sent" },
221
- });
222
- await pushToolExecution(callSid, execution);
223
-
224
- const result = await getCallByCallSid(callSid);
225
- expect(result?.toolExecutions?.[0].response).toEqual({
226
- userId: "123",
227
- status: "sent",
228
- });
229
- });
230
- });
231
-
232
- describe("getCallsByClientAndDateRange()", () => {
233
- it("should return calls within date range", async () => {
234
- const clientId = "dateRangeClient";
235
- const startDate = new Date("2023-05-01");
236
- const endDate = new Date("2023-05-31");
237
-
238
- const callInside = createOutGoingCallDoc({ clientId });
239
- const callBefore = createOutGoingCallDoc({ clientId });
240
- const callAfter = createOutGoingCallDoc({ clientId });
241
-
242
- await getCallsCollection().insertOne({
243
- ...callInside,
244
- createdAt: new Date("2023-05-15"),
245
- updatedAt: new Date(),
246
- env: "test",
247
- });
248
- await getCallsCollection().insertOne({
249
- ...callBefore,
250
- createdAt: new Date("2023-04-30"),
251
- updatedAt: new Date(),
252
- env: "test",
253
- });
254
- await getCallsCollection().insertOne({
255
- ...callAfter,
256
- createdAt: new Date("2023-06-01"),
257
- updatedAt: new Date(),
258
- env: "test",
259
- });
260
-
261
- const result = await getCallsByClientAndDateRange(
262
- clientId,
263
- startDate,
264
- endDate,
265
- );
266
- expect(result.length).toBe(1);
267
- expect(result[0].callSid).toBe(callInside.callSid);
268
- });
269
- });
270
- });
1
+ import {
2
+ createCallDoc,
3
+ getCallsByFlow,
4
+ getCallsByClient,
5
+ getCallsByPhoneNumber,
6
+ getCallByCallSid,
7
+ findCallsByQuery,
8
+ countCalls,
9
+ getCallsByClientAndDateRange,
10
+ getCallsCollection,
11
+ pushToolExecution,
12
+ } from "../calls.getters";
13
+ import type { ToolExecution } from "../calls.types";
14
+ import { ObjectId } from "mongodb";
15
+ import { createOutGoingCallDoc } from "../../../test-utils/factories";
16
+
17
+ describe("db.calls", () => {
18
+ it("should return calls by flow", async () => {
19
+ const flowId = new ObjectId();
20
+ const call1 = createOutGoingCallDoc({ flowId });
21
+ const call2 = createOutGoingCallDoc({ flowId });
22
+
23
+ await createCallDoc(call1);
24
+ await createCallDoc(call2);
25
+
26
+ const result = await getCallsByFlow(flowId);
27
+
28
+ expect(result.length).toBe(2);
29
+ expect(result).toMatchObject([
30
+ { callSid: call1.callSid },
31
+ { callSid: call2.callSid },
32
+ ]);
33
+ });
34
+
35
+ it("should get call by callSid", async () => {
36
+ const call = createOutGoingCallDoc();
37
+ await createCallDoc(call);
38
+
39
+ const result = await getCallByCallSid(call.callSid);
40
+
41
+ expect(result).toBeDefined();
42
+ expect(result?.callSid).toBe(call.callSid);
43
+ });
44
+
45
+ it("should get calls by client", async () => {
46
+ const call = createOutGoingCallDoc();
47
+ await createCallDoc(call);
48
+
49
+ const result = await getCallsByClient(call.clientId);
50
+
51
+ expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
52
+ });
53
+
54
+ it("should get calls by phone number", async () => {
55
+ const call = createOutGoingCallDoc();
56
+ await createCallDoc(call);
57
+
58
+ const result = await getCallsByPhoneNumber(call.customerPhoneNumber);
59
+
60
+ expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
61
+ });
62
+
63
+ describe("findCallsByQuery()", () => {
64
+ it("should find calls by status with limit and sort", async () => {
65
+ const clientId = "client123";
66
+ const call1 = createOutGoingCallDoc({ clientId, status: "completed" });
67
+ const call2 = createOutGoingCallDoc({ clientId, status: "completed" });
68
+ const call3 = createOutGoingCallDoc({ clientId, status: "busy" });
69
+
70
+ // We need to control createdAt to test sort. We'll insert directly.
71
+ await getCallsCollection().insertOne({
72
+ ...call1,
73
+ createdAt: new Date("2023-01-01"),
74
+ updatedAt: new Date(),
75
+ env: "test",
76
+ });
77
+ await getCallsCollection().insertOne({
78
+ ...call2,
79
+ createdAt: new Date("2023-01-02"),
80
+ updatedAt: new Date(),
81
+ env: "test",
82
+ });
83
+ await getCallsCollection().insertOne({
84
+ ...call3,
85
+ createdAt: new Date(),
86
+ updatedAt: new Date(),
87
+ env: "test",
88
+ });
89
+
90
+ const result = await findCallsByQuery(
91
+ { clientId, status: "completed" },
92
+ { sort: { createdAt: -1 }, limit: 1 },
93
+ );
94
+
95
+ expect(result.length).toBe(1);
96
+ expect(result[0].callSid).toBe(call2.callSid);
97
+ });
98
+ });
99
+
100
+ describe("countCalls()", () => {
101
+ it("should count calls matching query", async () => {
102
+ const clientId = "countClient";
103
+ await createCallDoc(
104
+ createOutGoingCallDoc({ clientId, status: "completed" }),
105
+ );
106
+ await createCallDoc(
107
+ createOutGoingCallDoc({ clientId, status: "completed" }),
108
+ );
109
+ await createCallDoc(
110
+ createOutGoingCallDoc({ clientId, status: "failed" }),
111
+ );
112
+
113
+ const count = await countCalls({ clientId, status: "completed" });
114
+ expect(count).toBe(2);
115
+ });
116
+ });
117
+
118
+ describe("pushToolExecution()", () => {
119
+ let callSid: string;
120
+
121
+ beforeEach(async () => {
122
+ const call = createOutGoingCallDoc();
123
+ await createCallDoc(call);
124
+ callSid = call.callSid;
125
+ });
126
+
127
+ const makeHttpExecution = (
128
+ overrides?: Partial<ToolExecution>,
129
+ ): ToolExecution => ({
130
+ toolName: "sendSms",
131
+ executedAt: new Date(),
132
+ durationMs: 120,
133
+ args: { to: "+1234567890", message: "hello" },
134
+ meta: {
135
+ kind: "http",
136
+ url: "https://api.example.com/sms",
137
+ method: "POST",
138
+ },
139
+ status: "success",
140
+ httpStatus: 200,
141
+ ...overrides,
142
+ });
143
+
144
+ it("should append an execution to a call with none", async () => {
145
+ const execution = makeHttpExecution();
146
+ await pushToolExecution(callSid, execution);
147
+
148
+ const result = await getCallByCallSid(callSid);
149
+ expect(result?.toolExecutions).toHaveLength(1);
150
+ expect(result?.toolExecutions?.[0]).toMatchObject({
151
+ toolName: "sendSms",
152
+ status: "success",
153
+ httpStatus: 200,
154
+ });
155
+ });
156
+
157
+ it("should maintain insertion order across multiple pushes", async () => {
158
+ const first = makeHttpExecution({ toolName: "first" });
159
+ const second = makeHttpExecution({ toolName: "second" });
160
+ const third = makeHttpExecution({ toolName: "third" });
161
+
162
+ await pushToolExecution(callSid, first);
163
+ await pushToolExecution(callSid, second);
164
+ await pushToolExecution(callSid, third);
165
+
166
+ const result = await getCallByCallSid(callSid);
167
+ expect(result?.toolExecutions?.map((e) => e.toolName)).toEqual([
168
+ "first",
169
+ "second",
170
+ "third",
171
+ ]);
172
+ });
173
+
174
+ it("should store an internal tool execution", async () => {
175
+ const execution: ToolExecution = {
176
+ toolName: "endFlow",
177
+ executedAt: new Date(),
178
+ durationMs: 5,
179
+ args: {},
180
+ meta: { kind: "internal" },
181
+ status: "success",
182
+ };
183
+
184
+ await pushToolExecution(callSid, execution);
185
+
186
+ const result = await getCallByCallSid(callSid);
187
+ expect(result?.toolExecutions?.[0]).toMatchObject({
188
+ toolName: "endFlow",
189
+ meta: { kind: "internal" },
190
+ });
191
+ });
192
+
193
+ it("should store redacted args for sensitive tools", async () => {
194
+ const execution = makeHttpExecution({ args: { _redacted: true } });
195
+ await pushToolExecution(callSid, execution);
196
+
197
+ const result = await getCallByCallSid(callSid);
198
+ expect(result?.toolExecutions?.[0].args).toEqual({ _redacted: true });
199
+ });
200
+
201
+ it("should store an error execution", async () => {
202
+ const execution = makeHttpExecution({ status: "error", httpStatus: 500 });
203
+ await pushToolExecution(callSid, execution);
204
+
205
+ const result = await getCallByCallSid(callSid);
206
+ expect(result?.toolExecutions?.[0]).toMatchObject({
207
+ status: "error",
208
+ httpStatus: 500,
209
+ });
210
+ });
211
+
212
+ it("should be a no-op for an unknown callSid", async () => {
213
+ await expect(
214
+ pushToolExecution("nonexistent-sid", makeHttpExecution()),
215
+ ).resolves.not.toThrow();
216
+ });
217
+
218
+ it("should store the response body", async () => {
219
+ const execution = makeHttpExecution({
220
+ response: { userId: "123", status: "sent" },
221
+ });
222
+ await pushToolExecution(callSid, execution);
223
+
224
+ const result = await getCallByCallSid(callSid);
225
+ expect(result?.toolExecutions?.[0].response).toEqual({
226
+ userId: "123",
227
+ status: "sent",
228
+ });
229
+ });
230
+ });
231
+
232
+ describe("getCallsByClientAndDateRange()", () => {
233
+ it("should return calls within date range", async () => {
234
+ const clientId = "dateRangeClient";
235
+ const startDate = new Date("2023-05-01");
236
+ const endDate = new Date("2023-05-31");
237
+
238
+ const callInside = createOutGoingCallDoc({ clientId });
239
+ const callBefore = createOutGoingCallDoc({ clientId });
240
+ const callAfter = createOutGoingCallDoc({ clientId });
241
+
242
+ await getCallsCollection().insertOne({
243
+ ...callInside,
244
+ createdAt: new Date("2023-05-15"),
245
+ updatedAt: new Date(),
246
+ env: "test",
247
+ });
248
+ await getCallsCollection().insertOne({
249
+ ...callBefore,
250
+ createdAt: new Date("2023-04-30"),
251
+ updatedAt: new Date(),
252
+ env: "test",
253
+ });
254
+ await getCallsCollection().insertOne({
255
+ ...callAfter,
256
+ createdAt: new Date("2023-06-01"),
257
+ updatedAt: new Date(),
258
+ env: "test",
259
+ });
260
+
261
+ const result = await getCallsByClientAndDateRange(
262
+ clientId,
263
+ startDate,
264
+ endDate,
265
+ );
266
+ expect(result.length).toBe(1);
267
+ expect(result[0].callSid).toBe(callInside.callSid);
268
+ });
269
+ });
270
+ });