@talkpilot/core-db 1.3.21 → 1.3.22

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 (190) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/DEVELOPMENT.md +141 -141
  3. package/README.md +494 -500
  4. package/dist/talkpilot/calls/calls.constants.d.ts +0 -2
  5. package/dist/talkpilot/calls/calls.constants.d.ts.map +1 -1
  6. package/dist/talkpilot/calls/calls.constants.js +1 -3
  7. package/dist/talkpilot/calls/calls.constants.js.map +1 -1
  8. package/dist/talkpilot/calls/calls.getters.d.ts +0 -3
  9. package/dist/talkpilot/calls/calls.getters.d.ts.map +1 -1
  10. package/dist/talkpilot/calls/calls.getters.js +1 -12
  11. package/dist/talkpilot/calls/calls.getters.js.map +1 -1
  12. package/dist/talkpilot/calls/calls.types.d.ts +1 -10
  13. package/dist/talkpilot/calls/calls.types.d.ts.map +1 -1
  14. package/dist/websitalk/websiteUrls/websiteUrls.context.d.ts +11 -0
  15. package/dist/websitalk/websiteUrls/websiteUrls.context.d.ts.map +1 -0
  16. package/dist/websitalk/websiteUrls/websiteUrls.context.js +35 -0
  17. package/dist/websitalk/websiteUrls/websiteUrls.context.js.map +1 -0
  18. package/dist/websitalk/websiteUrls/websiteUrls.setters.d.ts +7 -0
  19. package/dist/websitalk/websiteUrls/websiteUrls.setters.d.ts.map +1 -0
  20. package/dist/websitalk/websiteUrls/websiteUrls.setters.js +29 -0
  21. package/dist/websitalk/websiteUrls/websiteUrls.setters.js.map +1 -0
  22. package/jest.config.js +20 -20
  23. package/package.json +46 -46
  24. package/src/__tests__/setup.ts +20 -20
  25. package/src/connection.ts +54 -54
  26. package/src/index.ts +27 -27
  27. package/src/municipal/__tests__/validation.spec.ts +62 -62
  28. package/src/municipal/cities/cities.getters.ts +50 -50
  29. package/src/municipal/cities/cities.types.ts +11 -11
  30. package/src/municipal/cities/index.ts +2 -2
  31. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +282 -282
  32. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +72 -72
  33. package/src/municipal/departmentsSubjects/index.ts +9 -9
  34. package/src/municipal/index.ts +22 -22
  35. package/src/municipal/mongodb-client.ts +61 -61
  36. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  37. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  38. package/src/municipal/muniIssues/index.ts +17 -17
  39. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  40. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  41. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  42. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  43. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  44. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  45. package/src/municipal/streets/index.ts +2 -2
  46. package/src/municipal/streets/streets.getters.ts +125 -125
  47. package/src/municipal/streets/streets.types.ts +18 -18
  48. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  49. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  50. package/src/municipal/systemInstructions/index.ts +7 -7
  51. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  52. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  53. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  54. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  55. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  56. package/src/municipal/tickets/index.ts +9 -9
  57. package/src/municipal/tickets/tickets.constants.ts +8 -8
  58. package/src/municipal/tickets/tickets.getters.ts +121 -121
  59. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  60. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  61. package/src/municipal/tickets/tickets.types.ts +54 -54
  62. package/src/municipal/utils/types.ts +11 -11
  63. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  64. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  65. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  66. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  67. package/src/talkpilot/agents/agents.getters.ts +34 -34
  68. package/src/talkpilot/agents/agents.types.ts +14 -14
  69. package/src/talkpilot/agents/index.ts +2 -2
  70. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  71. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  72. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  73. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  74. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  75. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  76. package/src/talkpilot/calls/__tests__/calls.spec.ts +283 -471
  77. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  78. package/src/talkpilot/calls/calls.constants.ts +32 -35
  79. package/src/talkpilot/calls/calls.getters.ts +258 -277
  80. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  81. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  82. package/src/talkpilot/calls/calls.types.ts +130 -141
  83. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  84. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  85. package/src/talkpilot/calls/index.ts +6 -6
  86. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  87. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  88. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  89. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  90. package/src/talkpilot/clients/clients.getters.ts +16 -16
  91. package/src/talkpilot/clients/clients.types.ts +14 -14
  92. package/src/talkpilot/clients/index.ts +2 -2
  93. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +105 -105
  94. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +186 -186
  95. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +79 -79
  96. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +127 -127
  97. package/src/talkpilot/clientsConfig/index.ts +2 -2
  98. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  99. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  100. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  101. package/src/talkpilot/contextNotes/index.ts +2 -2
  102. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +99 -99
  103. package/src/talkpilot/flows/flows.getter.ts +14 -14
  104. package/src/talkpilot/flows/flows.schema.ts +155 -155
  105. package/src/talkpilot/flows/flows.types.ts +189 -189
  106. package/src/talkpilot/flows/index.ts +2 -2
  107. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  108. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  109. package/src/talkpilot/groups/groups.getters.ts +30 -30
  110. package/src/talkpilot/groups/groups.types.ts +29 -29
  111. package/src/talkpilot/groups/index.ts +3 -3
  112. package/src/talkpilot/groups/phone.utils.ts +46 -46
  113. package/src/talkpilot/index.ts +31 -31
  114. package/src/talkpilot/leads/index.ts +2 -2
  115. package/src/talkpilot/leads/leads.getter.ts +6 -6
  116. package/src/talkpilot/leads/leads.schema.ts +33 -33
  117. package/src/talkpilot/leads/leads.types.ts +20 -20
  118. package/src/talkpilot/mongodb-client.ts +78 -78
  119. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +252 -252
  120. package/src/talkpilot/phone_numbers/index.ts +2 -2
  121. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +171 -171
  122. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  123. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  124. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  125. package/src/talkpilot/plans/index.ts +2 -2
  126. package/src/talkpilot/plans/plans.getters.ts +132 -132
  127. package/src/talkpilot/plans/plans.types.ts +89 -89
  128. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  129. package/src/talkpilot/products/index.ts +2 -2
  130. package/src/talkpilot/products/products.getters.ts +12 -12
  131. package/src/talkpilot/products/products.types.ts +9 -9
  132. package/src/talkpilot/results/index.ts +7 -7
  133. package/src/talkpilot/results/results.getter.ts +39 -39
  134. package/src/talkpilot/results/results.schema.ts +25 -25
  135. package/src/talkpilot/results/results.types.ts +34 -34
  136. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  137. package/src/talkpilot/retry_analyze/index.ts +2 -2
  138. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  139. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  140. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  141. package/src/talkpilot/sessions/index.ts +2 -2
  142. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  143. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  144. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  145. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  146. package/src/talkpilot/subscriptions/index.ts +3 -3
  147. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  148. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  149. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  150. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  151. package/src/talkpilot/utils/query.utils.ts +21 -21
  152. package/src/test-utils/db-utils.ts +26 -26
  153. package/src/test-utils/factories/index.ts +16 -16
  154. package/src/test-utils/factories/municipal/cities.ts +16 -16
  155. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  156. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  157. package/src/test-utils/factories/municipal/streets.ts +22 -22
  158. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  159. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  160. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  161. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  162. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  163. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  164. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  165. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  166. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  167. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  168. package/src/test-utils/factories/websitalk/scans.ts +24 -24
  169. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  170. package/src/utils/date.utils.ts +126 -126
  171. package/src/utils/shared.types.ts +4 -4
  172. package/src/utils/validation.ts +23 -23
  173. package/src/websitalk/index.ts +16 -16
  174. package/src/websitalk/mongodb-client.ts +61 -61
  175. package/src/websitalk/scans/__tests__/scans.spec.ts +313 -313
  176. package/src/websitalk/scans/index.ts +4 -4
  177. package/src/websitalk/scans/scans.constants.ts +15 -15
  178. package/src/websitalk/scans/scans.getters.ts +160 -160
  179. package/src/websitalk/scans/scans.types.ts +45 -45
  180. package/src/websitalk/scans/scans.utils.ts +5 -5
  181. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  182. package/src/websitalk/websiteUrls/index.ts +2 -2
  183. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  184. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  185. package/tsconfig.json +23 -23
  186. package/.claude/settings.local.json +0 -13
  187. package/dist/talkpilot/leads/leads.setter.d.ts +0 -4
  188. package/dist/talkpilot/leads/leads.setter.d.ts.map +0 -1
  189. package/dist/talkpilot/leads/leads.setter.js +0 -16
  190. package/dist/talkpilot/leads/leads.setter.js.map +0 -1
@@ -1,471 +1,283 @@
1
- import {
2
- createCallDoc,
3
- getCallsByFlow,
4
- getCallsByClient,
5
- getCallsByPhoneNumber,
6
- getCallByCallSid,
7
- findCallsByQuery,
8
- countCalls,
9
- getCallsByClientAndDateRange,
10
- getCallsCollection,
11
- pushToolExecution,
12
- getToolExecutionsByCallSid,
13
- updateCallStatusByCallSid,
14
- } from "../calls.getters";
15
- import type { ToolExecution, ToolExecutionStep } from "../calls.types";
16
- import { ObjectId } from "mongodb";
17
- import { createOutGoingCallDoc } from "../../../test-utils/factories";
18
-
19
- describe("db.calls", () => {
20
- it("should return calls by flow", async () => {
21
- const flowId = new ObjectId();
22
- const call1 = createOutGoingCallDoc({ flowId });
23
- const call2 = createOutGoingCallDoc({ flowId });
24
-
25
- await createCallDoc(call1);
26
- await createCallDoc(call2);
27
-
28
- const result = await getCallsByFlow(flowId);
29
-
30
- expect(result.length).toBe(2);
31
- expect(result).toMatchObject([
32
- { callSid: call1.callSid },
33
- { callSid: call2.callSid },
34
- ]);
35
- });
36
-
37
- it("should get call by callSid", async () => {
38
- const call = createOutGoingCallDoc();
39
- await createCallDoc(call);
40
-
41
- const result = await getCallByCallSid(call.callSid);
42
-
43
- expect(result).toBeDefined();
44
- expect(result?.callSid).toBe(call.callSid);
45
- });
46
-
47
- it("should get calls by client", async () => {
48
- const call = createOutGoingCallDoc();
49
- await createCallDoc(call);
50
-
51
- const result = await getCallsByClient(call.clientId);
52
-
53
- expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
54
- });
55
-
56
- it("should get calls by phone number", async () => {
57
- const call = createOutGoingCallDoc();
58
- await createCallDoc(call);
59
-
60
- const result = await getCallsByPhoneNumber(call.customerPhoneNumber);
61
-
62
- expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
63
- });
64
-
65
- it("should set current status only via updateCallStatusByCallSid", async () => {
66
- const call = createOutGoingCallDoc({ status: "ringing" });
67
- await createCallDoc(call);
68
-
69
- const updated = await updateCallStatusByCallSid(call.callSid, "in-progress");
70
-
71
- expect(updated?.status).toBe("in-progress");
72
- expect(await getCallByCallSid(call.callSid)).toMatchObject({
73
- status: "in-progress",
74
- });
75
- });
76
-
77
- describe("findCallsByQuery()", () => {
78
- it("should find calls by status with limit and sort", async () => {
79
- const clientId = "client123";
80
- const call1 = createOutGoingCallDoc({ clientId, status: "completed" });
81
- const call2 = createOutGoingCallDoc({ clientId, status: "completed" });
82
- const call3 = createOutGoingCallDoc({ clientId, status: "busy" });
83
-
84
- // We need to control createdAt to test sort. We'll insert directly.
85
- await getCallsCollection().insertOne({
86
- ...call1,
87
- createdAt: new Date("2023-01-01"),
88
- updatedAt: new Date(),
89
- env: "test",
90
- });
91
- await getCallsCollection().insertOne({
92
- ...call2,
93
- createdAt: new Date("2023-01-02"),
94
- updatedAt: new Date(),
95
- env: "test",
96
- });
97
- await getCallsCollection().insertOne({
98
- ...call3,
99
- createdAt: new Date(),
100
- updatedAt: new Date(),
101
- env: "test",
102
- });
103
-
104
- const result = await findCallsByQuery(
105
- { clientId, status: "completed" },
106
- { sort: { createdAt: -1 }, limit: 1 },
107
- );
108
-
109
- expect(result.length).toBe(1);
110
- expect(result[0].callSid).toBe(call2.callSid);
111
- });
112
- });
113
-
114
- describe("countCalls()", () => {
115
- it("should count calls matching query", async () => {
116
- const clientId = "countClient";
117
- await createCallDoc(
118
- createOutGoingCallDoc({ clientId, status: "completed" }),
119
- );
120
- await createCallDoc(
121
- createOutGoingCallDoc({ clientId, status: "completed" }),
122
- );
123
- await createCallDoc(
124
- createOutGoingCallDoc({ clientId, status: "failed" }),
125
- );
126
-
127
- const count = await countCalls({ clientId, status: "completed" });
128
- expect(count).toBe(2);
129
- });
130
- });
131
-
132
- describe("pushToolExecution()", () => {
133
- let callSid: string;
134
-
135
- beforeEach(async () => {
136
- const call = createOutGoingCallDoc();
137
- await createCallDoc(call);
138
- callSid = call.callSid;
139
- });
140
-
141
- const makeHttpExecution = (
142
- overrides?: Partial<ToolExecution>,
143
- ): ToolExecution => ({
144
- toolName: "sendSms",
145
- executedAt: new Date(),
146
- durationMs: 120,
147
- args: { to: "+1234567890", message: "hello" },
148
- meta: {
149
- kind: "http",
150
- url: "https://api.example.com/sms",
151
- method: "POST",
152
- },
153
- status: "success",
154
- httpStatus: 200,
155
- ...overrides,
156
- });
157
-
158
- it("should append an execution to a call with none", async () => {
159
- const execution = makeHttpExecution();
160
- await pushToolExecution(callSid, execution);
161
-
162
- const result = await getCallByCallSid(callSid);
163
- expect(result?.toolExecutions).toHaveLength(1);
164
- expect(result?.toolExecutions?.[0]).toMatchObject({
165
- toolName: "sendSms",
166
- status: "success",
167
- httpStatus: 200,
168
- });
169
- });
170
-
171
- it("should maintain insertion order across multiple pushes", async () => {
172
- const first = makeHttpExecution({ toolName: "first" });
173
- const second = makeHttpExecution({ toolName: "second" });
174
- const third = makeHttpExecution({ toolName: "third" });
175
-
176
- await pushToolExecution(callSid, first);
177
- await pushToolExecution(callSid, second);
178
- await pushToolExecution(callSid, third);
179
-
180
- const result = await getCallByCallSid(callSid);
181
- expect(result?.toolExecutions?.map((e) => e.toolName)).toEqual([
182
- "first",
183
- "second",
184
- "third",
185
- ]);
186
- });
187
-
188
- it("should store an internal tool execution", async () => {
189
- const execution: ToolExecution = {
190
- toolName: "endFlow",
191
- executedAt: new Date(),
192
- durationMs: 5,
193
- args: {},
194
- meta: { kind: "internal" },
195
- status: "success",
196
- };
197
-
198
- await pushToolExecution(callSid, execution);
199
-
200
- const result = await getCallByCallSid(callSid);
201
- expect(result?.toolExecutions?.[0]).toMatchObject({
202
- toolName: "endFlow",
203
- meta: { kind: "internal" },
204
- });
205
- });
206
-
207
- it("should store redacted args for sensitive tools", async () => {
208
- const execution = makeHttpExecution({ args: { _redacted: true } });
209
- await pushToolExecution(callSid, execution);
210
-
211
- const result = await getCallByCallSid(callSid);
212
- expect(result?.toolExecutions?.[0].args).toEqual({ _redacted: true });
213
- });
214
-
215
- it("should store an error execution", async () => {
216
- const execution = makeHttpExecution({ status: "error", httpStatus: 500 });
217
- await pushToolExecution(callSid, execution);
218
-
219
- const result = await getCallByCallSid(callSid);
220
- expect(result?.toolExecutions?.[0]).toMatchObject({
221
- status: "error",
222
- httpStatus: 500,
223
- });
224
- });
225
-
226
- it("should be a no-op for an unknown callSid", async () => {
227
- await expect(
228
- pushToolExecution("nonexistent-sid", makeHttpExecution()),
229
- ).resolves.not.toThrow();
230
- });
231
-
232
- it("should store the response body", async () => {
233
- const execution = makeHttpExecution({
234
- response: { userId: "123", status: "sent" },
235
- });
236
- await pushToolExecution(callSid, execution);
237
-
238
- const result = await getCallByCallSid(callSid);
239
- expect(result?.toolExecutions?.[0].response).toEqual({
240
- userId: "123",
241
- status: "sent",
242
- });
243
- });
244
- });
245
-
246
- describe("getToolExecutionsByCallSid()", () => {
247
- const makeExecution = (
248
- overrides?: Partial<ToolExecution>,
249
- ): ToolExecution => ({
250
- toolName: "testTool",
251
- executedAt: new Date(),
252
- durationMs: 100,
253
- args: { query: "test" },
254
- meta: { kind: "http", url: "https://example.com", method: "POST" },
255
- status: "success",
256
- httpStatus: 200,
257
- ...overrides,
258
- });
259
-
260
- it("returns all executions for a call", async () => {
261
- const call = createOutGoingCallDoc();
262
- await createCallDoc(call);
263
- await pushToolExecution(call.callSid, makeExecution({ toolName: "first" }));
264
- await pushToolExecution(call.callSid, makeExecution({ toolName: "second" }));
265
-
266
- const result = await getToolExecutionsByCallSid(call.callSid);
267
-
268
- expect(result).toHaveLength(2);
269
- expect(result.map((e) => e.toolName)).toEqual(["first", "second"]);
270
- });
271
-
272
- it("returns an empty array when the call has no executions", async () => {
273
- const call = createOutGoingCallDoc();
274
- await createCallDoc(call);
275
-
276
- const result = await getToolExecutionsByCallSid(call.callSid);
277
-
278
- expect(result).toEqual([]);
279
- });
280
-
281
- it("returns an empty array for an unknown callSid", async () => {
282
- const result = await getToolExecutionsByCallSid("nonexistent-sid");
283
-
284
- expect(result).toEqual([]);
285
- });
286
-
287
- it("respects skip and limit for pagination", async () => {
288
- const call = createOutGoingCallDoc();
289
- await createCallDoc(call);
290
- for (const name of ["a", "b", "c", "d", "e"]) {
291
- await pushToolExecution(call.callSid, makeExecution({ toolName: name }));
292
- }
293
-
294
- const page1 = await getToolExecutionsByCallSid(call.callSid, { skip: 0, limit: 2 });
295
- const page2 = await getToolExecutionsByCallSid(call.callSid, { skip: 2, limit: 2 });
296
- const page3 = await getToolExecutionsByCallSid(call.callSid, { skip: 4, limit: 2 });
297
-
298
- expect(page1.map((e) => e.toolName)).toEqual(["a", "b"]);
299
- expect(page2.map((e) => e.toolName)).toEqual(["c", "d"]);
300
- expect(page3.map((e) => e.toolName)).toEqual(["e"]);
301
- });
302
-
303
- it("includes steps when present", async () => {
304
- const call = createOutGoingCallDoc();
305
- await createCallDoc(call);
306
- const steps: ToolExecutionStep[] = [
307
- { timestamp: new Date("2024-01-01T10:00:00Z"), label: "audio_enrichment", level: "info", data: { audioUsed: true } },
308
- { timestamp: new Date("2024-01-01T10:00:01Z"), label: "subject_classification", level: "warn" },
309
- ];
310
- await pushToolExecution(call.callSid, makeExecution({ steps }));
311
-
312
- const result = await getToolExecutionsByCallSid(call.callSid);
313
-
314
- expect(result[0].steps).toHaveLength(2);
315
- const s0 = result[0].steps![0];
316
- expect(s0.label).toBe("audio_enrichment");
317
- expect(s0.level).toBe("info");
318
- expect(new Date(s0.timestamp).toISOString()).toBe("2024-01-01T10:00:00.000Z");
319
- expect(s0.data).toEqual({ audioUsed: true });
320
- const s1 = result[0].steps![1];
321
- expect(s1.label).toBe("subject_classification");
322
- expect(s1.level).toBe("warn");
323
- expect(s1.data).toBeUndefined();
324
- });
325
-
326
- it("includes step payload when present", async () => {
327
- const call = createOutGoingCallDoc();
328
- await createCallDoc(call);
329
- const steps: ToolExecutionStep[] = [
330
- {
331
- timestamp: new Date("2024-01-01T10:00:00Z"),
332
- label: "subject_classification",
333
- level: "info",
334
- data: "Classified as: ניקיון / אשפה",
335
- payload: { subject: "ניקיון", subSubject: "אשפה", ids: { subject: "abc", subSubject: "def" } },
336
- },
337
- ];
338
- await pushToolExecution(call.callSid, makeExecution({ steps }));
339
-
340
- const result = await getToolExecutionsByCallSid(call.callSid);
341
-
342
- const s0 = result[0].steps![0];
343
- expect(s0.data).toBe("Classified as: ניקיון / אשפה");
344
- expect(s0.payload).toEqual({ subject: "ניקיון", subSubject: "אשפה", ids: { subject: "abc", subSubject: "def" } });
345
- });
346
-
347
- it("does not require step payload to be present", async () => {
348
- const call = createOutGoingCallDoc();
349
- await createCallDoc(call);
350
- const steps: ToolExecutionStep[] = [
351
- { timestamp: new Date(), label: "user_query", level: "info", data: "Query: הרצל" },
352
- ];
353
- await pushToolExecution(call.callSid, makeExecution({ steps }));
354
-
355
- const result = await getToolExecutionsByCallSid(call.callSid);
356
-
357
- expect(result[0].steps![0].payload).toBeUndefined();
358
- });
359
-
360
- it("does not require steps to be present", async () => {
361
- const call = createOutGoingCallDoc();
362
- await createCallDoc(call);
363
- await pushToolExecution(call.callSid, makeExecution());
364
-
365
- const result = await getToolExecutionsByCallSid(call.callSid);
366
-
367
- expect(result[0].steps).toBeUndefined();
368
- });
369
-
370
- it("returns at most 50 executions by default", async () => {
371
- const call = createOutGoingCallDoc();
372
- await getCallsCollection().insertOne({
373
- ...call,
374
- createdAt: new Date(),
375
- updatedAt: new Date(),
376
- env: "test",
377
- toolExecutions: Array.from({ length: 51 }, (_, i) =>
378
- makeExecution({ toolName: `tool${i}` }),
379
- ),
380
- });
381
-
382
- const result = await getToolExecutionsByCallSid(call.callSid);
383
-
384
- expect(result).toHaveLength(50);
385
- expect(result[0].toolName).toBe("tool0");
386
- expect(result[49].toolName).toBe("tool49");
387
- });
388
-
389
- it("clamps negative skip to 0", async () => {
390
- const call = createOutGoingCallDoc();
391
- await createCallDoc(call);
392
- await pushToolExecution(call.callSid, makeExecution({ toolName: "only" }));
393
-
394
- const result = await getToolExecutionsByCallSid(call.callSid, { skip: -5 });
395
-
396
- expect(result).toHaveLength(1);
397
- expect(result[0].toolName).toBe("only");
398
- });
399
-
400
- it("clamps negative limit to 1", async () => {
401
- const call = createOutGoingCallDoc();
402
- await createCallDoc(call);
403
- await pushToolExecution(call.callSid, makeExecution({ toolName: "first" }));
404
- await pushToolExecution(call.callSid, makeExecution({ toolName: "second" }));
405
-
406
- const result = await getToolExecutionsByCallSid(call.callSid, { limit: -1 });
407
-
408
- expect(result).toHaveLength(1);
409
- });
410
-
411
- it("returns executions when clientId matches the call's client", async () => {
412
- const call = createOutGoingCallDoc({ clientId: "clientA" });
413
- await createCallDoc(call);
414
- await pushToolExecution(call.callSid, makeExecution({ toolName: "secret" }));
415
-
416
- const result = await getToolExecutionsByCallSid(call.callSid, { clientId: "clientA" });
417
-
418
- expect(result).toHaveLength(1);
419
- expect(result[0].toolName).toBe("secret");
420
- });
421
-
422
- it("returns empty when clientId does not match the call's client", async () => {
423
- const call = createOutGoingCallDoc({ clientId: "clientA" });
424
- await createCallDoc(call);
425
- await pushToolExecution(call.callSid, makeExecution({ toolName: "secret" }));
426
-
427
- const result = await getToolExecutionsByCallSid(call.callSid, { clientId: "clientB" });
428
-
429
- expect(result).toEqual([]);
430
- });
431
- });
432
-
433
- describe("getCallsByClientAndDateRange()", () => {
434
- it("should return calls within date range", async () => {
435
- const clientId = "dateRangeClient";
436
- const startDate = new Date("2023-05-01");
437
- const endDate = new Date("2023-05-31");
438
-
439
- const callInside = createOutGoingCallDoc({ clientId });
440
- const callBefore = createOutGoingCallDoc({ clientId });
441
- const callAfter = createOutGoingCallDoc({ clientId });
442
-
443
- await getCallsCollection().insertOne({
444
- ...callInside,
445
- createdAt: new Date("2023-05-15"),
446
- updatedAt: new Date(),
447
- env: "test",
448
- });
449
- await getCallsCollection().insertOne({
450
- ...callBefore,
451
- createdAt: new Date("2023-04-30"),
452
- updatedAt: new Date(),
453
- env: "test",
454
- });
455
- await getCallsCollection().insertOne({
456
- ...callAfter,
457
- createdAt: new Date("2023-06-01"),
458
- updatedAt: new Date(),
459
- env: "test",
460
- });
461
-
462
- const result = await getCallsByClientAndDateRange(
463
- clientId,
464
- startDate,
465
- endDate,
466
- );
467
- expect(result.length).toBe(1);
468
- expect(result[0].callSid).toBe(callInside.callSid);
469
- });
470
- });
471
- });
1
+ import {
2
+ createCallDoc,
3
+ getCallsByFlow,
4
+ getCallsByClient,
5
+ getCallsByPhoneNumber,
6
+ getCallByCallSid,
7
+ findCallsByQuery,
8
+ countCalls,
9
+ getCallsByClientAndDateRange,
10
+ getCallsCollection,
11
+ pushToolExecution,
12
+ updateCallStatusByCallSid,
13
+ } from "../calls.getters";
14
+ import type { ToolExecution } from "../calls.types";
15
+ import { ObjectId } from "mongodb";
16
+ import { createOutGoingCallDoc } from "../../../test-utils/factories";
17
+
18
+ describe("db.calls", () => {
19
+ it("should return calls by flow", async () => {
20
+ const flowId = new ObjectId();
21
+ const call1 = createOutGoingCallDoc({ flowId });
22
+ const call2 = createOutGoingCallDoc({ flowId });
23
+
24
+ await createCallDoc(call1);
25
+ await createCallDoc(call2);
26
+
27
+ const result = await getCallsByFlow(flowId);
28
+
29
+ expect(result.length).toBe(2);
30
+ expect(result).toMatchObject([
31
+ { callSid: call1.callSid },
32
+ { callSid: call2.callSid },
33
+ ]);
34
+ });
35
+
36
+ it("should get call by callSid", async () => {
37
+ const call = createOutGoingCallDoc();
38
+ await createCallDoc(call);
39
+
40
+ const result = await getCallByCallSid(call.callSid);
41
+
42
+ expect(result).toBeDefined();
43
+ expect(result?.callSid).toBe(call.callSid);
44
+ });
45
+
46
+ it("should get calls by client", async () => {
47
+ const call = createOutGoingCallDoc();
48
+ await createCallDoc(call);
49
+
50
+ const result = await getCallsByClient(call.clientId);
51
+
52
+ expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
53
+ });
54
+
55
+ it("should get calls by phone number", async () => {
56
+ const call = createOutGoingCallDoc();
57
+ await createCallDoc(call);
58
+
59
+ const result = await getCallsByPhoneNumber(call.customerPhoneNumber);
60
+
61
+ expect(result.some((c) => c.callSid === call.callSid)).toBe(true);
62
+ });
63
+
64
+ it("should set current status only via updateCallStatusByCallSid", async () => {
65
+ const call = createOutGoingCallDoc({ status: "ringing" });
66
+ await createCallDoc(call);
67
+
68
+ const updated = await updateCallStatusByCallSid(call.callSid, "in-progress");
69
+
70
+ expect(updated?.status).toBe("in-progress");
71
+ expect(await getCallByCallSid(call.callSid)).toMatchObject({
72
+ status: "in-progress",
73
+ });
74
+ });
75
+
76
+ describe("findCallsByQuery()", () => {
77
+ it("should find calls by status with limit and sort", async () => {
78
+ const clientId = "client123";
79
+ const call1 = createOutGoingCallDoc({ clientId, status: "completed" });
80
+ const call2 = createOutGoingCallDoc({ clientId, status: "completed" });
81
+ const call3 = createOutGoingCallDoc({ clientId, status: "busy" });
82
+
83
+ // We need to control createdAt to test sort. We'll insert directly.
84
+ await getCallsCollection().insertOne({
85
+ ...call1,
86
+ createdAt: new Date("2023-01-01"),
87
+ updatedAt: new Date(),
88
+ env: "test",
89
+ });
90
+ await getCallsCollection().insertOne({
91
+ ...call2,
92
+ createdAt: new Date("2023-01-02"),
93
+ updatedAt: new Date(),
94
+ env: "test",
95
+ });
96
+ await getCallsCollection().insertOne({
97
+ ...call3,
98
+ createdAt: new Date(),
99
+ updatedAt: new Date(),
100
+ env: "test",
101
+ });
102
+
103
+ const result = await findCallsByQuery(
104
+ { clientId, status: "completed" },
105
+ { sort: { createdAt: -1 }, limit: 1 },
106
+ );
107
+
108
+ expect(result.length).toBe(1);
109
+ expect(result[0].callSid).toBe(call2.callSid);
110
+ });
111
+ });
112
+
113
+ describe("countCalls()", () => {
114
+ it("should count calls matching query", async () => {
115
+ const clientId = "countClient";
116
+ await createCallDoc(
117
+ createOutGoingCallDoc({ clientId, status: "completed" }),
118
+ );
119
+ await createCallDoc(
120
+ createOutGoingCallDoc({ clientId, status: "completed" }),
121
+ );
122
+ await createCallDoc(
123
+ createOutGoingCallDoc({ clientId, status: "failed" }),
124
+ );
125
+
126
+ const count = await countCalls({ clientId, status: "completed" });
127
+ expect(count).toBe(2);
128
+ });
129
+ });
130
+
131
+ describe("pushToolExecution()", () => {
132
+ let callSid: string;
133
+
134
+ beforeEach(async () => {
135
+ const call = createOutGoingCallDoc();
136
+ await createCallDoc(call);
137
+ callSid = call.callSid;
138
+ });
139
+
140
+ const makeHttpExecution = (
141
+ overrides?: Partial<ToolExecution>,
142
+ ): ToolExecution => ({
143
+ toolName: "sendSms",
144
+ executedAt: new Date(),
145
+ durationMs: 120,
146
+ args: { to: "+1234567890", message: "hello" },
147
+ meta: {
148
+ kind: "http",
149
+ url: "https://api.example.com/sms",
150
+ method: "POST",
151
+ },
152
+ status: "success",
153
+ httpStatus: 200,
154
+ ...overrides,
155
+ });
156
+
157
+ it("should append an execution to a call with none", async () => {
158
+ const execution = makeHttpExecution();
159
+ await pushToolExecution(callSid, execution);
160
+
161
+ const result = await getCallByCallSid(callSid);
162
+ expect(result?.toolExecutions).toHaveLength(1);
163
+ expect(result?.toolExecutions?.[0]).toMatchObject({
164
+ toolName: "sendSms",
165
+ status: "success",
166
+ httpStatus: 200,
167
+ });
168
+ });
169
+
170
+ it("should maintain insertion order across multiple pushes", async () => {
171
+ const first = makeHttpExecution({ toolName: "first" });
172
+ const second = makeHttpExecution({ toolName: "second" });
173
+ const third = makeHttpExecution({ toolName: "third" });
174
+
175
+ await pushToolExecution(callSid, first);
176
+ await pushToolExecution(callSid, second);
177
+ await pushToolExecution(callSid, third);
178
+
179
+ const result = await getCallByCallSid(callSid);
180
+ expect(result?.toolExecutions?.map((e) => e.toolName)).toEqual([
181
+ "first",
182
+ "second",
183
+ "third",
184
+ ]);
185
+ });
186
+
187
+ it("should store an internal tool execution", async () => {
188
+ const execution: ToolExecution = {
189
+ toolName: "endFlow",
190
+ executedAt: new Date(),
191
+ durationMs: 5,
192
+ args: {},
193
+ meta: { kind: "internal" },
194
+ status: "success",
195
+ };
196
+
197
+ await pushToolExecution(callSid, execution);
198
+
199
+ const result = await getCallByCallSid(callSid);
200
+ expect(result?.toolExecutions?.[0]).toMatchObject({
201
+ toolName: "endFlow",
202
+ meta: { kind: "internal" },
203
+ });
204
+ });
205
+
206
+ it("should store redacted args for sensitive tools", async () => {
207
+ const execution = makeHttpExecution({ args: { _redacted: true } });
208
+ await pushToolExecution(callSid, execution);
209
+
210
+ const result = await getCallByCallSid(callSid);
211
+ expect(result?.toolExecutions?.[0].args).toEqual({ _redacted: true });
212
+ });
213
+
214
+ it("should store an error execution", async () => {
215
+ const execution = makeHttpExecution({ status: "error", httpStatus: 500 });
216
+ await pushToolExecution(callSid, execution);
217
+
218
+ const result = await getCallByCallSid(callSid);
219
+ expect(result?.toolExecutions?.[0]).toMatchObject({
220
+ status: "error",
221
+ httpStatus: 500,
222
+ });
223
+ });
224
+
225
+ it("should be a no-op for an unknown callSid", async () => {
226
+ await expect(
227
+ pushToolExecution("nonexistent-sid", makeHttpExecution()),
228
+ ).resolves.not.toThrow();
229
+ });
230
+
231
+ it("should store the response body", async () => {
232
+ const execution = makeHttpExecution({
233
+ response: { userId: "123", status: "sent" },
234
+ });
235
+ await pushToolExecution(callSid, execution);
236
+
237
+ const result = await getCallByCallSid(callSid);
238
+ expect(result?.toolExecutions?.[0].response).toEqual({
239
+ userId: "123",
240
+ status: "sent",
241
+ });
242
+ });
243
+ });
244
+
245
+ describe("getCallsByClientAndDateRange()", () => {
246
+ it("should return calls within date range", async () => {
247
+ const clientId = "dateRangeClient";
248
+ const startDate = new Date("2023-05-01");
249
+ const endDate = new Date("2023-05-31");
250
+
251
+ const callInside = createOutGoingCallDoc({ clientId });
252
+ const callBefore = createOutGoingCallDoc({ clientId });
253
+ const callAfter = createOutGoingCallDoc({ clientId });
254
+
255
+ await getCallsCollection().insertOne({
256
+ ...callInside,
257
+ createdAt: new Date("2023-05-15"),
258
+ updatedAt: new Date(),
259
+ env: "test",
260
+ });
261
+ await getCallsCollection().insertOne({
262
+ ...callBefore,
263
+ createdAt: new Date("2023-04-30"),
264
+ updatedAt: new Date(),
265
+ env: "test",
266
+ });
267
+ await getCallsCollection().insertOne({
268
+ ...callAfter,
269
+ createdAt: new Date("2023-06-01"),
270
+ updatedAt: new Date(),
271
+ env: "test",
272
+ });
273
+
274
+ const result = await getCallsByClientAndDateRange(
275
+ clientId,
276
+ startDate,
277
+ endDate,
278
+ );
279
+ expect(result.length).toBe(1);
280
+ expect(result[0].callSid).toBe(callInside.callSid);
281
+ });
282
+ });
283
+ });