@talkpilot/core-db 1.3.50 → 1.3.51

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 (229) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/AGENTS.md +49 -49
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +778 -778
  5. package/dist/configuration/models/models.constants.d.ts +1 -1
  6. package/dist/configuration/models/models.constants.d.ts.map +1 -1
  7. package/dist/configuration/models/models.constants.js +1 -6
  8. package/dist/configuration/models/models.constants.js.map +1 -1
  9. package/dist/websitalk/scanResources/scanResources.getters.d.ts +1 -0
  10. package/dist/websitalk/scanResources/scanResources.getters.d.ts.map +1 -1
  11. package/dist/websitalk/scanResources/scanResources.getters.js +6 -1
  12. package/dist/websitalk/scanResources/scanResources.getters.js.map +1 -1
  13. package/dist/websitalk/scans/scans.constants.d.ts +1 -0
  14. package/dist/websitalk/scans/scans.constants.d.ts.map +1 -1
  15. package/dist/websitalk/scans/scans.constants.js +1 -0
  16. package/dist/websitalk/scans/scans.constants.js.map +1 -1
  17. package/dist/websitalk/scans/scans.getters.d.ts +1 -0
  18. package/dist/websitalk/scans/scans.getters.d.ts.map +1 -1
  19. package/dist/websitalk/scans/scans.getters.js +6 -1
  20. package/dist/websitalk/scans/scans.getters.js.map +1 -1
  21. package/jest.config.js +20 -20
  22. package/package.json +46 -46
  23. package/src/__tests__/setup.ts +20 -20
  24. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  25. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  26. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  27. package/src/bulkWrite/index.ts +2 -2
  28. package/src/config.ts +9 -9
  29. package/src/configuration/index.ts +17 -17
  30. package/src/configuration/internalModels/index.ts +3 -3
  31. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  32. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  33. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  34. package/src/configuration/models/index.ts +25 -25
  35. package/src/configuration/models/models.constants.ts +13 -18
  36. package/src/configuration/models/models.getters.ts +53 -53
  37. package/src/configuration/models/models.types.ts +79 -79
  38. package/src/configuration/mongodb-client.ts +62 -62
  39. package/src/configuration/prompts/index.ts +2 -2
  40. package/src/configuration/prompts/prompts.getters.ts +49 -49
  41. package/src/configuration/prompts/prompts.types.ts +11 -11
  42. package/src/connection.ts +81 -81
  43. package/src/index.ts +46 -46
  44. package/src/municipal/__tests__/validation.spec.ts +62 -62
  45. package/src/municipal/cities/cities.getters.ts +50 -50
  46. package/src/municipal/cities/cities.types.ts +11 -11
  47. package/src/municipal/cities/index.ts +2 -2
  48. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  49. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  50. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  51. package/src/municipal/departmentsSubjects/index.ts +9 -9
  52. package/src/municipal/index.ts +22 -22
  53. package/src/municipal/mongodb-client.ts +61 -61
  54. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  55. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  56. package/src/municipal/muniIssues/index.ts +17 -17
  57. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  58. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  59. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  60. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  61. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  62. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  63. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  64. package/src/municipal/streets/index.ts +2 -2
  65. package/src/municipal/streets/streets.getters.ts +140 -140
  66. package/src/municipal/streets/streets.types.ts +19 -19
  67. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  68. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  69. package/src/municipal/systemInstructions/index.ts +7 -7
  70. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  71. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  72. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  73. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  74. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  75. package/src/municipal/tickets/index.ts +9 -9
  76. package/src/municipal/tickets/tickets.constants.ts +8 -8
  77. package/src/municipal/tickets/tickets.getters.ts +121 -121
  78. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  79. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  80. package/src/municipal/tickets/tickets.types.ts +54 -54
  81. package/src/municipal/utils/types.ts +11 -11
  82. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  83. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  84. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  85. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  86. package/src/talkpilot/agents/agents.getters.ts +34 -34
  87. package/src/talkpilot/agents/agents.types.ts +14 -14
  88. package/src/talkpilot/agents/index.ts +2 -2
  89. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  90. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  91. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  92. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  93. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  94. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  95. package/src/talkpilot/calls/__tests__/calls.spec.ts +471 -471
  96. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  97. package/src/talkpilot/calls/calls.constants.ts +49 -49
  98. package/src/talkpilot/calls/calls.getters.ts +277 -277
  99. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  100. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  101. package/src/talkpilot/calls/calls.types.ts +149 -149
  102. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  103. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  104. package/src/talkpilot/calls/index.ts +6 -6
  105. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  106. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  107. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  108. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  109. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  110. package/src/talkpilot/clients/clients.getters.ts +16 -16
  111. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  112. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  113. package/src/talkpilot/clients/clients.types.ts +18 -18
  114. package/src/talkpilot/clients/index.ts +4 -4
  115. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  116. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  117. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  118. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  119. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +136 -136
  120. package/src/talkpilot/clientsConfig/index.ts +3 -3
  121. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  122. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  123. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  124. package/src/talkpilot/contextNotes/index.ts +2 -2
  125. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +124 -124
  126. package/src/talkpilot/flows/flows.getter.ts +34 -34
  127. package/src/talkpilot/flows/flows.schema.ts +180 -180
  128. package/src/talkpilot/flows/flows.types.ts +211 -211
  129. package/src/talkpilot/flows/index.ts +7 -7
  130. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  131. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  132. package/src/talkpilot/groups/groups.getters.ts +30 -30
  133. package/src/talkpilot/groups/groups.types.ts +29 -29
  134. package/src/talkpilot/groups/index.ts +3 -3
  135. package/src/talkpilot/groups/phone.utils.ts +46 -46
  136. package/src/talkpilot/index.ts +31 -31
  137. package/src/talkpilot/leads/index.ts +2 -2
  138. package/src/talkpilot/leads/leads.getter.ts +6 -6
  139. package/src/talkpilot/leads/leads.schema.ts +33 -33
  140. package/src/talkpilot/leads/leads.types.ts +20 -20
  141. package/src/talkpilot/mongodb-client.ts +78 -78
  142. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +282 -282
  143. package/src/talkpilot/phone_numbers/index.ts +2 -2
  144. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +176 -176
  145. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  146. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  147. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  148. package/src/talkpilot/plans/index.ts +2 -2
  149. package/src/talkpilot/plans/plans.getters.ts +132 -132
  150. package/src/talkpilot/plans/plans.types.ts +89 -89
  151. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  152. package/src/talkpilot/products/index.ts +2 -2
  153. package/src/talkpilot/products/products.getters.ts +12 -12
  154. package/src/talkpilot/products/products.types.ts +9 -9
  155. package/src/talkpilot/results/index.ts +7 -7
  156. package/src/talkpilot/results/results.getter.ts +39 -39
  157. package/src/talkpilot/results/results.schema.ts +25 -25
  158. package/src/talkpilot/results/results.types.ts +34 -34
  159. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  160. package/src/talkpilot/retry_analyze/index.ts +2 -2
  161. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  162. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  163. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  164. package/src/talkpilot/sessions/index.ts +2 -2
  165. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  166. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  167. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  168. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  169. package/src/talkpilot/subscriptions/index.ts +3 -3
  170. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  171. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  172. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  173. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  174. package/src/talkpilot/utils/query.utils.ts +21 -21
  175. package/src/test-utils/db-utils.ts +33 -33
  176. package/src/test-utils/factories/index.ts +18 -18
  177. package/src/test-utils/factories/municipal/cities.ts +16 -16
  178. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  179. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  180. package/src/test-utils/factories/municipal/streets.ts +22 -22
  181. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  182. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  183. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  184. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  185. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  186. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  187. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  188. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  189. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  190. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  191. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  192. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  193. package/src/test-utils/factories/websitalk/scans.ts +29 -29
  194. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  195. package/src/utils/date.utils.ts +126 -126
  196. package/src/utils/shared.types.ts +4 -4
  197. package/src/utils/validation.ts +23 -23
  198. package/src/websitalk/index.ts +18 -18
  199. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +186 -186
  200. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  201. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +17 -17
  202. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +78 -78
  203. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +62 -62
  204. package/src/websitalk/mongodb-client.ts +61 -61
  205. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +212 -193
  206. package/src/websitalk/scanResources/index.ts +4 -4
  207. package/src/websitalk/scanResources/scanResources.constants.ts +47 -47
  208. package/src/websitalk/scanResources/scanResources.getters.ts +109 -102
  209. package/src/websitalk/scanResources/scanResources.types.ts +90 -90
  210. package/src/websitalk/scanResources/scanResources.utils.ts +31 -31
  211. package/src/websitalk/scans/__tests__/scans.spec.ts +330 -313
  212. package/src/websitalk/scans/index.ts +4 -4
  213. package/src/websitalk/scans/scans.constants.ts +16 -15
  214. package/src/websitalk/scans/scans.getters.ts +171 -166
  215. package/src/websitalk/scans/scans.types.ts +54 -54
  216. package/src/websitalk/scans/scans.utils.ts +5 -5
  217. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  218. package/src/websitalk/websiteUrls/index.ts +2 -2
  219. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  220. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  221. package/tsconfig.json +23 -23
  222. package/dist/talkpilot/clients/clients.quota.constants.d.ts +0 -2
  223. package/dist/talkpilot/clients/clients.quota.constants.d.ts.map +0 -1
  224. package/dist/talkpilot/clients/clients.quota.constants.js +0 -5
  225. package/dist/talkpilot/clients/clients.quota.constants.js.map +0 -1
  226. package/dist/talkpilot/clients/clients.quota.utils.d.ts +0 -8
  227. package/dist/talkpilot/clients/clients.quota.utils.d.ts.map +0 -1
  228. package/dist/talkpilot/clients/clients.quota.utils.js +0 -45
  229. package/dist/talkpilot/clients/clients.quota.utils.js.map +0 -1
@@ -1,176 +1,176 @@
1
- import type { Collection } from "mongodb";
2
- import {
3
- Client,
4
- getClientsCollection,
5
- getDb,
6
- getFlowsCollection,
7
- ObjectId,
8
- findSubscriptions,
9
- } from "../index";
10
- import {
11
- ClientPhoneNumberForFlow,
12
- PhoneNumber,
13
- PhoneNumberWithFlow,
14
- PurchasedPhoneProviderPayload,
15
- } from "./phone_numbers.types";
16
-
17
- export const getPhoneNumbersCollection = (): Collection<PhoneNumber> =>
18
- getDb().collection<PhoneNumber>("phone_numbers");
19
-
20
- export const getPhoneDataByPhoneNumber = async (
21
- phoneNumber: string,
22
- ): Promise<PhoneNumberWithFlow | null> => {
23
- const phoneCallData = await getPhoneNumbersCollection().findOne({
24
- phone_number: phoneNumber,
25
- });
26
- if (!phoneCallData) {
27
- throw new Error("PhoneNumber not found");
28
- }
29
- const flow = await getFlowsCollection().findOne({
30
- _id: new ObjectId(phoneCallData.flow_id),
31
- });
32
- if (!flow) {
33
- throw new Error("Flow not found");
34
- }
35
- const [subscription] =
36
- (await findSubscriptions({
37
- clientId: phoneCallData.client_id,
38
- isActive: true,
39
- })) || [];
40
-
41
- return {
42
- ...phoneCallData,
43
- flow,
44
- subscriptionId: subscription?._id?.toString() ?? undefined,
45
- };
46
- };
47
-
48
- export const getClientPrimaryPhoneNumber = async (
49
- clientId: string,
50
- ): Promise<string | null> => {
51
- return (
52
- (
53
- await getPhoneNumbersCollection().findOne({
54
- client_id: clientId,
55
- is_primary: true,
56
- })
57
- )?.phone_number ?? null
58
- );
59
- };
60
-
61
- export const getClientPhoneNumber = getClientPrimaryPhoneNumber;
62
-
63
- export const getClientPhoneData = async (
64
- clientId: string,
65
- isPrimary?: boolean,
66
- ): Promise<PhoneNumber | null> => {
67
- const filter = { client_id: clientId, is_primary: isPrimary !== false };
68
- const options =
69
- isPrimary === false ? { sort: { createdAt: -1 } as const } : {};
70
- return getPhoneNumbersCollection().findOne(filter, options);
71
- };
72
-
73
- export const getPhoneNumbersForFlows = async (
74
- clientId: string,
75
- ): Promise<ClientPhoneNumberForFlow[]> => {
76
- const docs = await getPhoneNumbersCollection()
77
- .find({
78
- client_id: clientId,
79
- flow_id: { $exists: true, $type: "objectId" },
80
- })
81
- .project({ _id: 0, flow_id: 1, phone_number: 1, is_primary: 1 })
82
- .sort({ createdAt: -1 })
83
- .toArray();
84
-
85
- return docs.map((doc) => ({
86
- flowId: String(doc.flow_id),
87
- phoneNumber: doc.phone_number,
88
- isPrimary: doc.is_primary,
89
- }));
90
- };
91
-
92
- export const createPhoneNumberEntity = async (
93
- phoneNumber: string,
94
- flowId: string,
95
- clientId: string,
96
- ): Promise<PhoneNumber> => {
97
- const existing = await getClientPhoneData(clientId);
98
- const isPrimary = !existing;
99
-
100
- await getPhoneNumbersCollection().insertOne({
101
- phone_number: phoneNumber,
102
- flow_id: new ObjectId(flowId),
103
- client_id: clientId,
104
- is_primary: isPrimary,
105
- createdAt: new Date(),
106
- updatedAt: new Date(),
107
- });
108
- const phoneNumberData = await getClientPhoneData(clientId, isPrimary);
109
- if (!phoneNumberData) throw new Error("Failed to create phoneNumber");
110
- return phoneNumberData;
111
- };
112
-
113
- /** API-purchased number; `flowId` may be omitted until the number is bound to a flow. */
114
- export const createPurchasedPhoneNumber = async (
115
- phoneNumber: string,
116
- providerPayload: PurchasedPhoneProviderPayload,
117
- clientId: string,
118
- flowId?: string | null,
119
- ): Promise<PhoneNumber> => {
120
- const existingPhoneForClient = await getClientPhoneData(clientId);
121
- const isPrimary = !existingPhoneForClient;
122
-
123
- const now = new Date();
124
- const trimmedFlowId = flowId?.trim();
125
- const flowObjectId = trimmedFlowId ? new ObjectId(trimmedFlowId) : undefined;
126
-
127
- const doc: PhoneNumber = {
128
- phone_number: phoneNumber,
129
- client_id: clientId,
130
- is_primary: isPrimary,
131
- ...providerPayload,
132
- createdAt: now,
133
- updatedAt: now,
134
- };
135
-
136
- if (flowObjectId) {
137
- doc.flow_id = flowObjectId;
138
- }
139
-
140
- await getPhoneNumbersCollection().insertOne(doc);
141
-
142
- const created = await getClientPhoneData(clientId, isPrimary);
143
- if (!created) throw new Error("Failed to create phoneNumber");
144
- return created;
145
- };
146
-
147
- export const findClientByPhoneNumber = async (
148
- phoneNumber: string,
149
- ): Promise<Client> => {
150
- const phoneData = await getPhoneNumbersCollection().findOne({
151
- phone_number: phoneNumber,
152
- });
153
- if (!phoneData) throw new Error("Failed to get phone data");
154
- const clientId = phoneData.client_id;
155
- const client = await getClientsCollection().findOne({ clientId });
156
- if (!client) throw new Error("Failed to get client");
157
- return client;
158
- };
159
-
160
- export const getPrimaryPhoneFlowId = async (clientId: string): Promise<string | null> => {
161
- const phone = await getClientPhoneData(clientId);
162
- return phone?.flow_id ? String(phone.flow_id) : null;
163
- };
164
-
165
- export const bindClientPhoneToFlow = async (
166
- clientId: string,
167
- flowId: string,
168
- ): Promise<void> => {
169
- const result = await getPhoneNumbersCollection().updateOne(
170
- { client_id: clientId, is_primary: true },
171
- { $set: { flow_id: new ObjectId(flowId), updatedAt: new Date() } },
172
- );
173
- if (result.matchedCount === 0) {
174
- throw new Error(`No primary phone number found for client: ${clientId}`);
175
- }
176
- };
1
+ import type { Collection } from "mongodb";
2
+ import {
3
+ Client,
4
+ getClientsCollection,
5
+ getDb,
6
+ getFlowsCollection,
7
+ ObjectId,
8
+ findSubscriptions,
9
+ } from "../index";
10
+ import {
11
+ ClientPhoneNumberForFlow,
12
+ PhoneNumber,
13
+ PhoneNumberWithFlow,
14
+ PurchasedPhoneProviderPayload,
15
+ } from "./phone_numbers.types";
16
+
17
+ export const getPhoneNumbersCollection = (): Collection<PhoneNumber> =>
18
+ getDb().collection<PhoneNumber>("phone_numbers");
19
+
20
+ export const getPhoneDataByPhoneNumber = async (
21
+ phoneNumber: string,
22
+ ): Promise<PhoneNumberWithFlow | null> => {
23
+ const phoneCallData = await getPhoneNumbersCollection().findOne({
24
+ phone_number: phoneNumber,
25
+ });
26
+ if (!phoneCallData) {
27
+ throw new Error("PhoneNumber not found");
28
+ }
29
+ const flow = await getFlowsCollection().findOne({
30
+ _id: new ObjectId(phoneCallData.flow_id),
31
+ });
32
+ if (!flow) {
33
+ throw new Error("Flow not found");
34
+ }
35
+ const [subscription] =
36
+ (await findSubscriptions({
37
+ clientId: phoneCallData.client_id,
38
+ isActive: true,
39
+ })) || [];
40
+
41
+ return {
42
+ ...phoneCallData,
43
+ flow,
44
+ subscriptionId: subscription?._id?.toString() ?? undefined,
45
+ };
46
+ };
47
+
48
+ export const getClientPrimaryPhoneNumber = async (
49
+ clientId: string,
50
+ ): Promise<string | null> => {
51
+ return (
52
+ (
53
+ await getPhoneNumbersCollection().findOne({
54
+ client_id: clientId,
55
+ is_primary: true,
56
+ })
57
+ )?.phone_number ?? null
58
+ );
59
+ };
60
+
61
+ export const getClientPhoneNumber = getClientPrimaryPhoneNumber;
62
+
63
+ export const getClientPhoneData = async (
64
+ clientId: string,
65
+ isPrimary?: boolean,
66
+ ): Promise<PhoneNumber | null> => {
67
+ const filter = { client_id: clientId, is_primary: isPrimary !== false };
68
+ const options =
69
+ isPrimary === false ? { sort: { createdAt: -1 } as const } : {};
70
+ return getPhoneNumbersCollection().findOne(filter, options);
71
+ };
72
+
73
+ export const getPhoneNumbersForFlows = async (
74
+ clientId: string,
75
+ ): Promise<ClientPhoneNumberForFlow[]> => {
76
+ const docs = await getPhoneNumbersCollection()
77
+ .find({
78
+ client_id: clientId,
79
+ flow_id: { $exists: true, $type: "objectId" },
80
+ })
81
+ .project({ _id: 0, flow_id: 1, phone_number: 1, is_primary: 1 })
82
+ .sort({ createdAt: -1 })
83
+ .toArray();
84
+
85
+ return docs.map((doc) => ({
86
+ flowId: String(doc.flow_id),
87
+ phoneNumber: doc.phone_number,
88
+ isPrimary: doc.is_primary,
89
+ }));
90
+ };
91
+
92
+ export const createPhoneNumberEntity = async (
93
+ phoneNumber: string,
94
+ flowId: string,
95
+ clientId: string,
96
+ ): Promise<PhoneNumber> => {
97
+ const existing = await getClientPhoneData(clientId);
98
+ const isPrimary = !existing;
99
+
100
+ await getPhoneNumbersCollection().insertOne({
101
+ phone_number: phoneNumber,
102
+ flow_id: new ObjectId(flowId),
103
+ client_id: clientId,
104
+ is_primary: isPrimary,
105
+ createdAt: new Date(),
106
+ updatedAt: new Date(),
107
+ });
108
+ const phoneNumberData = await getClientPhoneData(clientId, isPrimary);
109
+ if (!phoneNumberData) throw new Error("Failed to create phoneNumber");
110
+ return phoneNumberData;
111
+ };
112
+
113
+ /** API-purchased number; `flowId` may be omitted until the number is bound to a flow. */
114
+ export const createPurchasedPhoneNumber = async (
115
+ phoneNumber: string,
116
+ providerPayload: PurchasedPhoneProviderPayload,
117
+ clientId: string,
118
+ flowId?: string | null,
119
+ ): Promise<PhoneNumber> => {
120
+ const existingPhoneForClient = await getClientPhoneData(clientId);
121
+ const isPrimary = !existingPhoneForClient;
122
+
123
+ const now = new Date();
124
+ const trimmedFlowId = flowId?.trim();
125
+ const flowObjectId = trimmedFlowId ? new ObjectId(trimmedFlowId) : undefined;
126
+
127
+ const doc: PhoneNumber = {
128
+ phone_number: phoneNumber,
129
+ client_id: clientId,
130
+ is_primary: isPrimary,
131
+ ...providerPayload,
132
+ createdAt: now,
133
+ updatedAt: now,
134
+ };
135
+
136
+ if (flowObjectId) {
137
+ doc.flow_id = flowObjectId;
138
+ }
139
+
140
+ await getPhoneNumbersCollection().insertOne(doc);
141
+
142
+ const created = await getClientPhoneData(clientId, isPrimary);
143
+ if (!created) throw new Error("Failed to create phoneNumber");
144
+ return created;
145
+ };
146
+
147
+ export const findClientByPhoneNumber = async (
148
+ phoneNumber: string,
149
+ ): Promise<Client> => {
150
+ const phoneData = await getPhoneNumbersCollection().findOne({
151
+ phone_number: phoneNumber,
152
+ });
153
+ if (!phoneData) throw new Error("Failed to get phone data");
154
+ const clientId = phoneData.client_id;
155
+ const client = await getClientsCollection().findOne({ clientId });
156
+ if (!client) throw new Error("Failed to get client");
157
+ return client;
158
+ };
159
+
160
+ export const getPrimaryPhoneFlowId = async (clientId: string): Promise<string | null> => {
161
+ const phone = await getClientPhoneData(clientId);
162
+ return phone?.flow_id ? String(phone.flow_id) : null;
163
+ };
164
+
165
+ export const bindClientPhoneToFlow = async (
166
+ clientId: string,
167
+ flowId: string,
168
+ ): Promise<void> => {
169
+ const result = await getPhoneNumbersCollection().updateOne(
170
+ { client_id: clientId, is_primary: true },
171
+ { $set: { flow_id: new ObjectId(flowId), updatedAt: new Date() } },
172
+ );
173
+ if (result.matchedCount === 0) {
174
+ throw new Error(`No primary phone number found for client: ${clientId}`);
175
+ }
176
+ };
@@ -1,17 +1,17 @@
1
- export const phoneNumbersMongoSchema = {
2
- bsonType: "object",
3
- required: ["client_id", "phone_number"],
4
- properties: {
5
- _id: { bsonType: "objectId" },
6
- client_id: { bsonType: "string" },
7
- flow_id: { bsonType: ["objectId", "string"] },
8
- phone_number: { bsonType: "string" },
9
- is_primary: { bsonType: "bool" },
10
- provider: { bsonType: "string" },
11
- provider_sid: { bsonType: "string" },
12
- friendly_name: { bsonType: "string" },
13
- createdAt: { bsonType: "date" },
14
- updatedAt: { bsonType: "date" },
15
- },
16
- additionalProperties: false,
17
- } as const;
1
+ export const phoneNumbersMongoSchema = {
2
+ bsonType: "object",
3
+ required: ["client_id", "phone_number"],
4
+ properties: {
5
+ _id: { bsonType: "objectId" },
6
+ client_id: { bsonType: "string" },
7
+ flow_id: { bsonType: ["objectId", "string"] },
8
+ phone_number: { bsonType: "string" },
9
+ is_primary: { bsonType: "bool" },
10
+ provider: { bsonType: "string" },
11
+ provider_sid: { bsonType: "string" },
12
+ friendly_name: { bsonType: "string" },
13
+ createdAt: { bsonType: "date" },
14
+ updatedAt: { bsonType: "date" },
15
+ },
16
+ additionalProperties: false,
17
+ } as const;
@@ -1,30 +1,30 @@
1
- import { ObjectId, WithId } from "mongodb";
2
- import { Flow } from "../flows/flows.types";
3
-
4
- export type PurchasedPhoneProviderPayload = {
5
- provider: "twilio" | "telnyx";
6
- provider_sid: string;
7
- friendly_name?: string;
8
- };
9
-
10
- export type PhoneNumber = {
11
- _id?: ObjectId;
12
- client_id: string;
13
- flow_id?: ObjectId;
14
- phone_number: string;
15
- subscriptionId?: string;
16
- is_primary: boolean;
17
- provider?: "twilio" | "telnyx";
18
- provider_sid?: string;
19
- friendly_name?: string;
20
- createdAt: Date;
21
- updatedAt: Date;
22
- };
23
-
24
- export type PhoneNumberWithFlow = WithId<PhoneNumber> & { flow: Flow };
25
-
26
- export type ClientPhoneNumberForFlow = {
27
- flowId: string;
28
- phoneNumber: string;
29
- isPrimary: boolean;
30
- };
1
+ import { ObjectId, WithId } from "mongodb";
2
+ import { Flow } from "../flows/flows.types";
3
+
4
+ export type PurchasedPhoneProviderPayload = {
5
+ provider: "twilio" | "telnyx";
6
+ provider_sid: string;
7
+ friendly_name?: string;
8
+ };
9
+
10
+ export type PhoneNumber = {
11
+ _id?: ObjectId;
12
+ client_id: string;
13
+ flow_id?: ObjectId;
14
+ phone_number: string;
15
+ subscriptionId?: string;
16
+ is_primary: boolean;
17
+ provider?: "twilio" | "telnyx";
18
+ provider_sid?: string;
19
+ friendly_name?: string;
20
+ createdAt: Date;
21
+ updatedAt: Date;
22
+ };
23
+
24
+ export type PhoneNumberWithFlow = WithId<PhoneNumber> & { flow: Flow };
25
+
26
+ export type ClientPhoneNumberForFlow = {
27
+ flowId: string;
28
+ phoneNumber: string;
29
+ isPrimary: boolean;
30
+ };
@@ -1,70 +1,70 @@
1
- import {
2
- createPlanDoc,
3
- findPlans,
4
- findPlansByQuery,
5
- countPlans,
6
- updatePlanDoc,
7
- getPlansCollection,
8
- } from "../plans.getters";
9
- import { Plan } from "../plans.types";
10
-
11
- describe("db.plans", () => {
12
- const createTestPlan = (
13
- overrides?: Partial<Plan>,
14
- ): Omit<Plan, "createdAt" | "updatedAt"> => ({
15
- productKey: "basic-500",
16
- name: "Basic 500",
17
- monthlyCallQuota: 500,
18
- currency: "ILS",
19
- priceMonthlyMinor: 10000,
20
- isActive: true,
21
- ...overrides,
22
- });
23
-
24
- it("should create and find a plan", async () => {
25
- const planData = createTestPlan({ name: "CreateTest" });
26
- const created = await createPlanDoc(planData);
27
-
28
- expect(created._id).toBeDefined();
29
- expect(created.name).toBe("CreateTest");
30
-
31
- const found = await findPlans({ _id: created._id });
32
- expect(found.length).toBe(1);
33
- expect(found[0].name).toBe("CreateTest");
34
- });
35
-
36
- it("should find plans by query with limit", async () => {
37
- await getPlansCollection().deleteMany({});
38
- await createPlanDoc(createTestPlan({ productKey: "p1", isActive: true }));
39
- await createPlanDoc(createTestPlan({ productKey: "p2", isActive: true }));
40
- await createPlanDoc(createTestPlan({ productKey: "p3", isActive: false }));
41
-
42
- const activePlans = await findPlansByQuery(
43
- { isActive: true },
44
- { limit: 1 },
45
- );
46
- expect(activePlans.length).toBe(1);
47
- expect(activePlans[0].isActive).toBe(true);
48
- });
49
-
50
- it("should count plans matching query", async () => {
51
- await getPlansCollection().deleteMany({});
52
- await createPlanDoc(createTestPlan({ currency: "USD" }));
53
- await createPlanDoc(createTestPlan({ currency: "USD" }));
54
- await createPlanDoc(createTestPlan({ currency: "ILS" }));
55
-
56
- const count = await countPlans({ currency: "USD" });
57
- expect(count).toBe(2);
58
- });
59
-
60
- it("should update a plan", async () => {
61
- const plan = await createPlanDoc(createTestPlan({ isActive: true }));
62
- const updated = await updatePlanDoc(plan._id, { isActive: false });
63
-
64
- expect(updated).not.toBeNull();
65
- expect(updated?.isActive).toBe(false);
66
-
67
- const found = await findPlans({ _id: plan._id });
68
- expect(found[0].isActive).toBe(false);
69
- });
70
- });
1
+ import {
2
+ createPlanDoc,
3
+ findPlans,
4
+ findPlansByQuery,
5
+ countPlans,
6
+ updatePlanDoc,
7
+ getPlansCollection,
8
+ } from "../plans.getters";
9
+ import { Plan } from "../plans.types";
10
+
11
+ describe("db.plans", () => {
12
+ const createTestPlan = (
13
+ overrides?: Partial<Plan>,
14
+ ): Omit<Plan, "createdAt" | "updatedAt"> => ({
15
+ productKey: "basic-500",
16
+ name: "Basic 500",
17
+ monthlyCallQuota: 500,
18
+ currency: "ILS",
19
+ priceMonthlyMinor: 10000,
20
+ isActive: true,
21
+ ...overrides,
22
+ });
23
+
24
+ it("should create and find a plan", async () => {
25
+ const planData = createTestPlan({ name: "CreateTest" });
26
+ const created = await createPlanDoc(planData);
27
+
28
+ expect(created._id).toBeDefined();
29
+ expect(created.name).toBe("CreateTest");
30
+
31
+ const found = await findPlans({ _id: created._id });
32
+ expect(found.length).toBe(1);
33
+ expect(found[0].name).toBe("CreateTest");
34
+ });
35
+
36
+ it("should find plans by query with limit", async () => {
37
+ await getPlansCollection().deleteMany({});
38
+ await createPlanDoc(createTestPlan({ productKey: "p1", isActive: true }));
39
+ await createPlanDoc(createTestPlan({ productKey: "p2", isActive: true }));
40
+ await createPlanDoc(createTestPlan({ productKey: "p3", isActive: false }));
41
+
42
+ const activePlans = await findPlansByQuery(
43
+ { isActive: true },
44
+ { limit: 1 },
45
+ );
46
+ expect(activePlans.length).toBe(1);
47
+ expect(activePlans[0].isActive).toBe(true);
48
+ });
49
+
50
+ it("should count plans matching query", async () => {
51
+ await getPlansCollection().deleteMany({});
52
+ await createPlanDoc(createTestPlan({ currency: "USD" }));
53
+ await createPlanDoc(createTestPlan({ currency: "USD" }));
54
+ await createPlanDoc(createTestPlan({ currency: "ILS" }));
55
+
56
+ const count = await countPlans({ currency: "USD" });
57
+ expect(count).toBe(2);
58
+ });
59
+
60
+ it("should update a plan", async () => {
61
+ const plan = await createPlanDoc(createTestPlan({ isActive: true }));
62
+ const updated = await updatePlanDoc(plan._id, { isActive: false });
63
+
64
+ expect(updated).not.toBeNull();
65
+ expect(updated?.isActive).toBe(false);
66
+
67
+ const found = await findPlans({ _id: plan._id });
68
+ expect(found[0].isActive).toBe(false);
69
+ });
70
+ });
@@ -1,2 +1,2 @@
1
- export * from "./plans.types";
2
- export * from "./plans.getters";
1
+ export * from "./plans.types";
2
+ export * from "./plans.getters";