@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,252 +1,252 @@
1
- import {
2
- getPhoneDataByPhoneNumber,
3
- getPhoneNumbersCollection,
4
- getPhoneNumbersForFlows,
5
- getClientPhoneNumber,
6
- getClientPhoneData,
7
- createPhoneNumberEntity,
8
- createPurchasedPhoneNumber,
9
- } from "../phone_numbers.getter";
10
- import { getFlowsCollection } from "../../flows/flows.getter";
11
- import { createFlow, createPhoneNumber } from "../../../test-utils/factories";
12
- import { ObjectId } from "mongodb";
13
-
14
- describe("db.phoneNumbers", () => {
15
- describe("getPhoneDataByPhoneNumber", () => {
16
- it("return phone number data with flow", async () => {
17
- const flow = createFlow({
18
- clientId: "test-client-id",
19
- conversationSettings: {
20
- interruptions: {
21
- enableInterruptionDetection: true,
22
- interruptionWindowSeconds: 60,
23
- interruptionThresholdSeconds: 10,
24
- interruptionInstruction:
25
- "I am hearing background noise that makes it hard for me to focus on what you are saying. Please try to move to a quieter place or reduce the noise so I can better assist you.",
26
- },
27
- silence: {
28
- enableSilenceDetection: true,
29
- firstWarningSilenceSeconds: 5,
30
- firstWarningInstruction:
31
- "I have not heard you for a few seconds. If you are still on the line, please say something so we can continue.",
32
- secondWarningSilenceSeconds: 10,
33
- secondWarningInstruction:
34
- "I still have not heard anything from you. If you do not respond in the next few seconds, I will have to end this call.",
35
- disconnectSilenceSeconds: 30,
36
- },
37
- },
38
- });
39
- const phoneData = createPhoneNumber({
40
- flow_id: flow._id,
41
- client_id: "test-client-id",
42
- });
43
-
44
- await getFlowsCollection().insertOne(flow);
45
- await getPhoneNumbersCollection().insertOne(phoneData);
46
-
47
- const result = await getPhoneDataByPhoneNumber(phoneData.phone_number);
48
-
49
- expect(result).toBeDefined();
50
- expect(result).toMatchObject({
51
- client_id: phoneData.client_id,
52
- phone_number: phoneData.phone_number,
53
- flow_id: flow._id,
54
- });
55
- // Specifically check if the flow was joined correctly
56
- expect(result?.flow.flowName).toBe(flow.flowName);
57
- expect(
58
- result?.flow.conversationSettings?.silence?.firstWarningSilenceSeconds,
59
- ).toBe(5);
60
- });
61
- });
62
-
63
- describe("getClientPhoneNumber", () => {
64
- it("return phone number by client id", async () => {
65
- const flow = createFlow();
66
- const phoneData = createPhoneNumber({
67
- flow_id: flow._id,
68
- is_primary: true,
69
- });
70
-
71
- await getFlowsCollection().insertOne(flow);
72
- await getPhoneNumbersCollection().insertOne(phoneData);
73
-
74
- const result = await getClientPhoneNumber(phoneData.client_id);
75
- expect(result).toBe(phoneData.phone_number);
76
- });
77
- });
78
-
79
- describe("getClientPhoneData", () => {
80
- it("returns primary phone data by default", async () => {
81
- const clientId = "multiPhoneClient";
82
- const phone1 = createPhoneNumber({
83
- client_id: clientId,
84
- is_primary: false,
85
- phone_number: "1",
86
- createdAt: new Date("2023-01-01"),
87
- });
88
- const phone2 = createPhoneNumber({
89
- client_id: clientId,
90
- is_primary: true,
91
- phone_number: "2",
92
- createdAt: new Date("2023-01-02"),
93
- });
94
-
95
- await getPhoneNumbersCollection().insertOne(phone1);
96
- await getPhoneNumbersCollection().insertOne(phone2);
97
-
98
- const result = await getClientPhoneData(clientId);
99
- expect(result?.phone_number).toBe("2");
100
- });
101
-
102
- it("returns most recent non-primary phone data if isPrimary is false", async () => {
103
- const clientId = "multiPhoneClient2";
104
- const phone1 = createPhoneNumber({
105
- client_id: clientId,
106
- is_primary: false,
107
- phone_number: "1",
108
- createdAt: new Date("2023-01-01"),
109
- });
110
- const phone2 = createPhoneNumber({
111
- client_id: clientId,
112
- is_primary: false,
113
- phone_number: "2",
114
- createdAt: new Date("2023-01-02"),
115
- });
116
- const phone3 = createPhoneNumber({
117
- client_id: clientId,
118
- is_primary: true,
119
- phone_number: "3",
120
- createdAt: new Date("2023-01-03"),
121
- });
122
-
123
- await getPhoneNumbersCollection().insertOne(phone1);
124
- await getPhoneNumbersCollection().insertOne(phone2);
125
- await getPhoneNumbersCollection().insertOne(phone3);
126
-
127
- const result = await getClientPhoneData(clientId, false);
128
- expect(result?.phone_number).toBe("2");
129
- });
130
- });
131
-
132
- describe("getPhoneNumbersForFlows", () => {
133
- it("returns all phone numbers for the client with flow ObjectIds, newest first", async () => {
134
- const clientId = "flowsClient";
135
- const flow1 = createFlow({ clientId });
136
- const flow2 = createFlow({ clientId });
137
- await getFlowsCollection().insertMany([flow1, flow2]);
138
-
139
- const older = createPhoneNumber({
140
- client_id: clientId,
141
- flow_id: flow1._id,
142
- phone_number: "+100",
143
- is_primary: true,
144
- createdAt: new Date("2023-01-01"),
145
- });
146
- const newer = createPhoneNumber({
147
- client_id: clientId,
148
- flow_id: flow2._id,
149
- phone_number: "+200",
150
- is_primary: false,
151
- createdAt: new Date("2023-06-01"),
152
- });
153
-
154
- await getPhoneNumbersCollection().insertMany([older, newer]);
155
-
156
- const result = await getPhoneNumbersForFlows(clientId);
157
-
158
- expect(result).toHaveLength(2);
159
- expect(result[0]).toEqual({
160
- flowId: String(flow2._id),
161
- phoneNumber: "+200",
162
- isPrimary: false,
163
- });
164
- expect(result[1]).toEqual({
165
- flowId: String(flow1._id),
166
- phoneNumber: "+100",
167
- isPrimary: true,
168
- });
169
- });
170
-
171
- it("returns an empty array when the client has no phone numbers", async () => {
172
- const result = await getPhoneNumbersForFlows("noSuchClient");
173
- expect(result).toEqual([]);
174
- });
175
-
176
- it("does not include phone numbers for other clients", async () => {
177
- const clientA = "clientA";
178
- const clientB = "clientB";
179
- const flow = createFlow();
180
- await getFlowsCollection().insertOne(flow);
181
- const phone = createPhoneNumber({
182
- client_id: clientA,
183
- flow_id: flow._id,
184
- });
185
- await getPhoneNumbersCollection().insertOne(phone);
186
-
187
- const result = await getPhoneNumbersForFlows(clientB);
188
- expect(result).toEqual([]);
189
- });
190
- });
191
-
192
- describe("createPhoneNumberEntity", () => {
193
- it("creates first phone number as primary", async () => {
194
- const clientId = "newClient";
195
- const flowId = new ObjectId().toHexString();
196
- const phoneNumber = "+123456789";
197
-
198
- const result = await createPhoneNumberEntity(
199
- phoneNumber,
200
- flowId,
201
- clientId,
202
- );
203
- expect(result.phone_number).toBe(phoneNumber);
204
- expect(result.is_primary).toBe(true);
205
- });
206
-
207
- it("creates subsequent phone number as non-primary", async () => {
208
- const clientId = "existingClient";
209
- const flowId = new ObjectId().toHexString();
210
-
211
- // Create first one
212
- await createPhoneNumberEntity("+111", flowId, clientId);
213
-
214
- // Create second one
215
- const result = await createPhoneNumberEntity("+222", flowId, clientId);
216
- expect(result.phone_number).toBe("+222");
217
- expect(result.is_primary).toBe(false);
218
- });
219
- });
220
-
221
- describe("createPurchasedPhoneNumber", () => {
222
- it("persists a phone_numbers document with provider payload and flow", async () => {
223
- const clientId = "purchasedClientDb";
224
- const flowId = new ObjectId().toHexString();
225
- const phoneNumber = "+15551234567";
226
- const providerPayload = {
227
- provider: "twilio" as const,
228
- provider_sid: "PNxxxxxxxx",
229
- };
230
-
231
- await createPurchasedPhoneNumber(
232
- phoneNumber,
233
- providerPayload,
234
- clientId,
235
- flowId,
236
- );
237
-
238
- // Re-read from Mongo to confirm insert succeeded (not only the function return value).
239
- const stored = await getPhoneNumbersCollection().findOne({
240
- phone_number: phoneNumber,
241
- });
242
- expect(stored).not.toBeNull();
243
- expect(stored).toMatchObject({
244
- phone_number: phoneNumber,
245
- client_id: clientId,
246
- provider: "twilio",
247
- provider_sid: "PNxxxxxxxx",
248
- flow_id: new ObjectId(flowId),
249
- });
250
- });
251
- });
252
- });
1
+ import {
2
+ getPhoneDataByPhoneNumber,
3
+ getPhoneNumbersCollection,
4
+ getPhoneNumbersForFlows,
5
+ getClientPhoneNumber,
6
+ getClientPhoneData,
7
+ createPhoneNumberEntity,
8
+ createPurchasedPhoneNumber,
9
+ } from "../phone_numbers.getter";
10
+ import { getFlowsCollection } from "../../flows/flows.getter";
11
+ import { createFlow, createPhoneNumber } from "../../../test-utils/factories";
12
+ import { ObjectId } from "mongodb";
13
+
14
+ describe("db.phoneNumbers", () => {
15
+ describe("getPhoneDataByPhoneNumber", () => {
16
+ it("return phone number data with flow", async () => {
17
+ const flow = createFlow({
18
+ clientId: "test-client-id",
19
+ conversationSettings: {
20
+ interruptions: {
21
+ enableInterruptionDetection: true,
22
+ interruptionWindowSeconds: 60,
23
+ interruptionThresholdSeconds: 10,
24
+ interruptionInstruction:
25
+ "I am hearing background noise that makes it hard for me to focus on what you are saying. Please try to move to a quieter place or reduce the noise so I can better assist you.",
26
+ },
27
+ silence: {
28
+ enableSilenceDetection: true,
29
+ firstWarningSilenceSeconds: 5,
30
+ firstWarningInstruction:
31
+ "I have not heard you for a few seconds. If you are still on the line, please say something so we can continue.",
32
+ secondWarningSilenceSeconds: 10,
33
+ secondWarningInstruction:
34
+ "I still have not heard anything from you. If you do not respond in the next few seconds, I will have to end this call.",
35
+ disconnectSilenceSeconds: 30,
36
+ },
37
+ },
38
+ });
39
+ const phoneData = createPhoneNumber({
40
+ flow_id: flow._id,
41
+ client_id: "test-client-id",
42
+ });
43
+
44
+ await getFlowsCollection().insertOne(flow);
45
+ await getPhoneNumbersCollection().insertOne(phoneData);
46
+
47
+ const result = await getPhoneDataByPhoneNumber(phoneData.phone_number);
48
+
49
+ expect(result).toBeDefined();
50
+ expect(result).toMatchObject({
51
+ client_id: phoneData.client_id,
52
+ phone_number: phoneData.phone_number,
53
+ flow_id: flow._id,
54
+ });
55
+ // Specifically check if the flow was joined correctly
56
+ expect(result?.flow.flowName).toBe(flow.flowName);
57
+ expect(
58
+ result?.flow.conversationSettings?.silence?.firstWarningSilenceSeconds,
59
+ ).toBe(5);
60
+ });
61
+ });
62
+
63
+ describe("getClientPhoneNumber", () => {
64
+ it("return phone number by client id", async () => {
65
+ const flow = createFlow();
66
+ const phoneData = createPhoneNumber({
67
+ flow_id: flow._id,
68
+ is_primary: true,
69
+ });
70
+
71
+ await getFlowsCollection().insertOne(flow);
72
+ await getPhoneNumbersCollection().insertOne(phoneData);
73
+
74
+ const result = await getClientPhoneNumber(phoneData.client_id);
75
+ expect(result).toBe(phoneData.phone_number);
76
+ });
77
+ });
78
+
79
+ describe("getClientPhoneData", () => {
80
+ it("returns primary phone data by default", async () => {
81
+ const clientId = "multiPhoneClient";
82
+ const phone1 = createPhoneNumber({
83
+ client_id: clientId,
84
+ is_primary: false,
85
+ phone_number: "1",
86
+ createdAt: new Date("2023-01-01"),
87
+ });
88
+ const phone2 = createPhoneNumber({
89
+ client_id: clientId,
90
+ is_primary: true,
91
+ phone_number: "2",
92
+ createdAt: new Date("2023-01-02"),
93
+ });
94
+
95
+ await getPhoneNumbersCollection().insertOne(phone1);
96
+ await getPhoneNumbersCollection().insertOne(phone2);
97
+
98
+ const result = await getClientPhoneData(clientId);
99
+ expect(result?.phone_number).toBe("2");
100
+ });
101
+
102
+ it("returns most recent non-primary phone data if isPrimary is false", async () => {
103
+ const clientId = "multiPhoneClient2";
104
+ const phone1 = createPhoneNumber({
105
+ client_id: clientId,
106
+ is_primary: false,
107
+ phone_number: "1",
108
+ createdAt: new Date("2023-01-01"),
109
+ });
110
+ const phone2 = createPhoneNumber({
111
+ client_id: clientId,
112
+ is_primary: false,
113
+ phone_number: "2",
114
+ createdAt: new Date("2023-01-02"),
115
+ });
116
+ const phone3 = createPhoneNumber({
117
+ client_id: clientId,
118
+ is_primary: true,
119
+ phone_number: "3",
120
+ createdAt: new Date("2023-01-03"),
121
+ });
122
+
123
+ await getPhoneNumbersCollection().insertOne(phone1);
124
+ await getPhoneNumbersCollection().insertOne(phone2);
125
+ await getPhoneNumbersCollection().insertOne(phone3);
126
+
127
+ const result = await getClientPhoneData(clientId, false);
128
+ expect(result?.phone_number).toBe("2");
129
+ });
130
+ });
131
+
132
+ describe("getPhoneNumbersForFlows", () => {
133
+ it("returns all phone numbers for the client with flow ObjectIds, newest first", async () => {
134
+ const clientId = "flowsClient";
135
+ const flow1 = createFlow({ clientId });
136
+ const flow2 = createFlow({ clientId });
137
+ await getFlowsCollection().insertMany([flow1, flow2]);
138
+
139
+ const older = createPhoneNumber({
140
+ client_id: clientId,
141
+ flow_id: flow1._id,
142
+ phone_number: "+100",
143
+ is_primary: true,
144
+ createdAt: new Date("2023-01-01"),
145
+ });
146
+ const newer = createPhoneNumber({
147
+ client_id: clientId,
148
+ flow_id: flow2._id,
149
+ phone_number: "+200",
150
+ is_primary: false,
151
+ createdAt: new Date("2023-06-01"),
152
+ });
153
+
154
+ await getPhoneNumbersCollection().insertMany([older, newer]);
155
+
156
+ const result = await getPhoneNumbersForFlows(clientId);
157
+
158
+ expect(result).toHaveLength(2);
159
+ expect(result[0]).toEqual({
160
+ flowId: String(flow2._id),
161
+ phoneNumber: "+200",
162
+ isPrimary: false,
163
+ });
164
+ expect(result[1]).toEqual({
165
+ flowId: String(flow1._id),
166
+ phoneNumber: "+100",
167
+ isPrimary: true,
168
+ });
169
+ });
170
+
171
+ it("returns an empty array when the client has no phone numbers", async () => {
172
+ const result = await getPhoneNumbersForFlows("noSuchClient");
173
+ expect(result).toEqual([]);
174
+ });
175
+
176
+ it("does not include phone numbers for other clients", async () => {
177
+ const clientA = "clientA";
178
+ const clientB = "clientB";
179
+ const flow = createFlow();
180
+ await getFlowsCollection().insertOne(flow);
181
+ const phone = createPhoneNumber({
182
+ client_id: clientA,
183
+ flow_id: flow._id,
184
+ });
185
+ await getPhoneNumbersCollection().insertOne(phone);
186
+
187
+ const result = await getPhoneNumbersForFlows(clientB);
188
+ expect(result).toEqual([]);
189
+ });
190
+ });
191
+
192
+ describe("createPhoneNumberEntity", () => {
193
+ it("creates first phone number as primary", async () => {
194
+ const clientId = "newClient";
195
+ const flowId = new ObjectId().toHexString();
196
+ const phoneNumber = "+123456789";
197
+
198
+ const result = await createPhoneNumberEntity(
199
+ phoneNumber,
200
+ flowId,
201
+ clientId,
202
+ );
203
+ expect(result.phone_number).toBe(phoneNumber);
204
+ expect(result.is_primary).toBe(true);
205
+ });
206
+
207
+ it("creates subsequent phone number as non-primary", async () => {
208
+ const clientId = "existingClient";
209
+ const flowId = new ObjectId().toHexString();
210
+
211
+ // Create first one
212
+ await createPhoneNumberEntity("+111", flowId, clientId);
213
+
214
+ // Create second one
215
+ const result = await createPhoneNumberEntity("+222", flowId, clientId);
216
+ expect(result.phone_number).toBe("+222");
217
+ expect(result.is_primary).toBe(false);
218
+ });
219
+ });
220
+
221
+ describe("createPurchasedPhoneNumber", () => {
222
+ it("persists a phone_numbers document with provider payload and flow", async () => {
223
+ const clientId = "purchasedClientDb";
224
+ const flowId = new ObjectId().toHexString();
225
+ const phoneNumber = "+15551234567";
226
+ const providerPayload = {
227
+ provider: "twilio" as const,
228
+ provider_sid: "PNxxxxxxxx",
229
+ };
230
+
231
+ await createPurchasedPhoneNumber(
232
+ phoneNumber,
233
+ providerPayload,
234
+ clientId,
235
+ flowId,
236
+ );
237
+
238
+ // Re-read from Mongo to confirm insert succeeded (not only the function return value).
239
+ const stored = await getPhoneNumbersCollection().findOne({
240
+ phone_number: phoneNumber,
241
+ });
242
+ expect(stored).not.toBeNull();
243
+ expect(stored).toMatchObject({
244
+ phone_number: phoneNumber,
245
+ client_id: clientId,
246
+ provider: "twilio",
247
+ provider_sid: "PNxxxxxxxx",
248
+ flow_id: new ObjectId(flowId),
249
+ });
250
+ });
251
+ });
252
+ });
@@ -1,2 +1,2 @@
1
- export * from "./phone_numbers.getter";
2
- export type * from "./phone_numbers.types";
1
+ export * from "./phone_numbers.getter";
2
+ export type * from "./phone_numbers.types";