@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,313 +1,330 @@
1
- import {
2
- getScansCollection,
3
- getScansByClientAndDateRange,
4
- getScanFieldsByClientAndDateRange,
5
- findScansByQuery,
6
- countScans,
7
- createScanDoc,
8
- updateScanDoc,
9
- findInProgressScansByClient,
10
- getScansByWebsiteUrl,
11
- getLatestScanByWebsiteUrl,
12
- getInProgressScanByWebsiteUrl,
13
- getLatestCompletedScanByWebsiteUrl,
14
- deleteScansByWebsiteUrl,
15
- } from "../scans.getters";
16
- import { createScanFixture } from "../../../test-utils/factories";
17
- import { ObjectId } from "mongodb";
18
-
19
- describe("db.websitalk.scans", () => {
20
- describe("getScansByClientAndDateRange()", () => {
21
- it("should return full scan documents within the date range", async () => {
22
- const clientId = "dateRangeClient";
23
- const startDate = new Date("2023-05-01");
24
- const endDate = new Date("2023-05-31");
25
-
26
- const scanInside = createScanFixture({ clientId, status: "COMPLETED" });
27
- const scanBefore = createScanFixture({ clientId });
28
- const scanAfter = createScanFixture({ clientId });
29
-
30
- await getScansCollection().insertMany([
31
- { ...scanInside, createdAt: new Date("2023-05-15") },
32
- { ...scanBefore, createdAt: new Date("2023-04-30") },
33
- { ...scanAfter, createdAt: new Date("2023-06-01") },
34
- ]);
35
-
36
- const result = await getScansByClientAndDateRange(
37
- clientId,
38
- startDate,
39
- endDate,
40
- );
41
-
42
- expect(result.length).toBe(1);
43
- expect(result[0]).toMatchObject({
44
- clientId,
45
- websiteUrlId: scanInside.websiteUrlId,
46
- status: "COMPLETED",
47
- });
48
- expect(result[0]).toHaveProperty("siteChrome");
49
- expect(result[0]).toHaveProperty("skipped");
50
- });
51
-
52
- it("should respect the date range boundaries (inclusive)", async () => {
53
- const clientId = "boundaryClient";
54
- const onStart = createScanFixture({ clientId });
55
- const onEnd = createScanFixture({ clientId });
56
-
57
- await getScansCollection().insertMany([
58
- { ...onStart, createdAt: new Date("2023-05-01") },
59
- { ...onEnd, createdAt: new Date("2023-05-31") },
60
- ]);
61
-
62
- const result = await getScansByClientAndDateRange(
63
- clientId,
64
- new Date("2023-05-01"),
65
- new Date("2023-05-31"),
66
- );
67
-
68
- expect(result.length).toBe(2);
69
- });
70
- });
71
-
72
- describe("getScanFieldsByClientAndDateRange()", () => {
73
- it("should return only the requested fields (plus _id)", async () => {
74
- const clientId = "projectionClient";
75
- const scan = createScanFixture({
76
- clientId,
77
- status: "COMPLETED",
78
- siteChrome: { url: "https://example.com", sourceType: "site_chrome" },
79
- skipped: [{ path: "/broken", reason: "HTTP 500" }],
80
- });
81
-
82
- await getScansCollection().insertOne({
83
- ...scan,
84
- createdAt: new Date("2023-05-15"),
85
- });
86
-
87
- const [result] = await getScanFieldsByClientAndDateRange(
88
- clientId,
89
- new Date("2023-05-01"),
90
- new Date("2023-05-31"),
91
- ["clientId", "websiteUrlId", "status"],
92
- );
93
-
94
- expect(result).toMatchObject({
95
- clientId,
96
- websiteUrlId: scan.websiteUrlId,
97
- status: "COMPLETED",
98
- });
99
- expect(result).toHaveProperty("_id");
100
- expect(result).not.toHaveProperty("siteChrome");
101
- expect(result).not.toHaveProperty("skipped");
102
- expect(result).not.toHaveProperty("createdAt");
103
- });
104
- });
105
-
106
- describe("findScansByQuery() / countScans()", () => {
107
- it("should find scans matching a raw filter and count them", async () => {
108
- const clientId = "queryClient";
109
- const completed = createScanFixture({ clientId, status: "COMPLETED" });
110
- const scanning = createScanFixture({ clientId, status: "SCANNING" });
111
-
112
- await getScansCollection().insertMany([completed, scanning]);
113
-
114
- const result = await findScansByQuery({ clientId, status: "COMPLETED" });
115
- const count = await countScans({ clientId });
116
-
117
- expect(result.length).toBe(1);
118
- expect(result[0].websiteUrlId).toBe(completed.websiteUrlId);
119
- expect(count).toBe(2);
120
- });
121
- });
122
-
123
- describe("createScanDoc()", () => {
124
- it("should insert a scan with default values for the rest of the fields", async () => {
125
- const clientId = "createClient";
126
- const websiteUrlId = new ObjectId().toString();
127
-
128
- const { insertedId } = await createScanDoc({ clientId, websiteUrlId });
129
-
130
- const result = await getScansCollection().findOne({ _id: insertedId });
131
-
132
- expect(result).toMatchObject({
133
- clientId,
134
- websiteUrlId,
135
- status: "CHECKING",
136
- activeTasksCount: 0,
137
- pagesScanned: 0,
138
- pagesSkipped: 0,
139
- skipped: [],
140
- siteChrome: {},
141
- });
142
- expect(result?.createdAt).toBeInstanceOf(Date);
143
- expect(result?.updatedAt).toBeInstanceOf(Date);
144
- });
145
- });
146
-
147
- describe("updateScanDoc()", () => {
148
- it("should update the given fields and bump updatedAt", async () => {
149
- const scan = createScanFixture({ status: "SCANNING", pagesScanned: 0 });
150
- const { insertedId } = await getScansCollection().insertOne(scan);
151
-
152
- const result = await updateScanDoc(insertedId, {
153
- status: "COMPLETED",
154
- pagesScanned: 10,
155
- });
156
-
157
- expect(result).toMatchObject({
158
- _id: insertedId,
159
- status: "COMPLETED",
160
- pagesScanned: 10,
161
- });
162
- expect(result?.updatedAt.getTime()).toBeGreaterThan(
163
- scan.updatedAt.getTime(),
164
- );
165
- });
166
-
167
- it("should return null when the scan does not exist", async () => {
168
- const result = await updateScanDoc(new ObjectId(), { status: "FAILED" });
169
-
170
- expect(result).toBeNull();
171
- });
172
- });
173
-
174
- describe("in-progress scan helpers", () => {
175
- const websiteUrlId = "website-123";
176
-
177
- it("should return website scan history newest first", async () => {
178
- await getScansCollection().insertMany([
179
- createScanFixture({
180
- websiteUrlId,
181
- status: "COMPLETED",
182
- createdAt: new Date("2023-05-01"),
183
- }),
184
- createScanFixture({
185
- websiteUrlId,
186
- status: "COMPLETED",
187
- createdAt: new Date("2023-05-15"),
188
- }),
189
- ]);
190
-
191
- const scans = await getScansByWebsiteUrl(websiteUrlId);
192
- expect(scans).toHaveLength(2);
193
- expect(scans[0].createdAt.getTime()).toBeGreaterThan(
194
- scans[1].createdAt.getTime(),
195
- );
196
- });
197
-
198
- it("should return the newest scan for a website", async () => {
199
- await getScansCollection().insertMany([
200
- createScanFixture({
201
- websiteUrlId,
202
- status: "COMPLETED",
203
- createdAt: new Date("2023-05-01"),
204
- }),
205
- createScanFixture({
206
- websiteUrlId,
207
- status: "FAILED",
208
- createdAt: new Date("2023-05-15"),
209
- }),
210
- ]);
211
-
212
- const latest = await getLatestScanByWebsiteUrl(websiteUrlId);
213
- expect(latest?.status).toBe("FAILED");
214
- });
215
-
216
- it("should return in-progress scan and return null when only completed exists", async () => {
217
- await getScansCollection().insertMany([
218
- createScanFixture({
219
- websiteUrlId,
220
- status: "COMPLETED",
221
- createdAt: new Date("2023-05-01"),
222
- }),
223
- createScanFixture({
224
- websiteUrlId,
225
- status: "SCANNING",
226
- createdAt: new Date("2023-05-15"),
227
- }),
228
- ]);
229
-
230
- const inProgressScan = await getInProgressScanByWebsiteUrl(websiteUrlId);
231
- expect(inProgressScan?.status).toBe("SCANNING");
232
-
233
- await getScansCollection().deleteMany({ websiteUrlId });
234
- await getScansCollection().insertOne(
235
- createScanFixture({
236
- websiteUrlId,
237
- status: "COMPLETED",
238
- createdAt: new Date("2023-05-20"),
239
- }),
240
- );
241
-
242
- expect(await getInProgressScanByWebsiteUrl(websiteUrlId)).toBeNull();
243
- });
244
-
245
- it("should return all in-progress scans across websites for a client", async () => {
246
- const clientId = "multiScanClient";
247
- await getScansCollection().insertMany([
248
- createScanFixture({
249
- clientId,
250
- websiteUrlId: "website-a",
251
- status: "SCANNING",
252
- }),
253
- createScanFixture({
254
- clientId,
255
- websiteUrlId: "website-b",
256
- status: "PROCESSING",
257
- }),
258
- createScanFixture({
259
- clientId,
260
- websiteUrlId: "website-c",
261
- status: "COMPLETED",
262
- }),
263
- ]);
264
-
265
- const scans = await findInProgressScansByClient(clientId);
266
- expect(scans).toHaveLength(2);
267
- expect(scans.map((s) => s.websiteUrlId).sort()).toEqual([
268
- "website-a",
269
- "website-b",
270
- ]);
271
- });
272
- });
273
-
274
- describe("website delete helpers", () => {
275
- it("should return the newest completed scan only", async () => {
276
- const websiteUrlId = new ObjectId().toString();
277
- await getScansCollection().insertMany([
278
- createScanFixture({
279
- websiteUrlId,
280
- status: "FAILED",
281
- createdAt: new Date("2023-05-25"),
282
- }),
283
- createScanFixture({
284
- websiteUrlId,
285
- status: "COMPLETED",
286
- createdAt: new Date("2023-05-20"),
287
- }),
288
- createScanFixture({
289
- websiteUrlId,
290
- status: "COMPLETED",
291
- createdAt: new Date("2023-05-22"),
292
- }),
293
- ]);
294
-
295
- const latest = await getLatestCompletedScanByWebsiteUrl(websiteUrlId);
296
- expect(latest?.status).toBe("COMPLETED");
297
- expect(latest?.createdAt).toEqual(new Date("2023-05-22"));
298
- });
299
-
300
- it("should delete all scans for the website and return count", async () => {
301
- const websiteUrlId = new ObjectId().toString();
302
- await getScansCollection().insertMany([
303
- createScanFixture({ websiteUrlId }),
304
- createScanFixture({ websiteUrlId }),
305
- createScanFixture({ websiteUrlId: new ObjectId().toString() }),
306
- ]);
307
-
308
- const deleted = await deleteScansByWebsiteUrl(websiteUrlId);
309
- expect(deleted).toBe(2);
310
- expect(await countScans({ websiteUrlId })).toBe(0);
311
- });
312
- });
313
- });
1
+ import {
2
+ getScansCollection,
3
+ getScansByClientAndDateRange,
4
+ getScanFieldsByClientAndDateRange,
5
+ findScansByQuery,
6
+ countScans,
7
+ createScanDoc,
8
+ updateScanDoc,
9
+ findInProgressScansByClient,
10
+ getScansByWebsiteUrl,
11
+ getLatestScanByWebsiteUrl,
12
+ getInProgressScanByWebsiteUrl,
13
+ getLatestCompletedScanByWebsiteUrl,
14
+ deleteScansByWebsiteUrl,
15
+ deleteScanById,
16
+ } from "../scans.getters";
17
+ import { createScanFixture } from "../../../test-utils/factories";
18
+ import { ObjectId } from "mongodb";
19
+
20
+ describe("db.websitalk.scans", () => {
21
+ describe("getScansByClientAndDateRange()", () => {
22
+ it("should return full scan documents within the date range", async () => {
23
+ const clientId = "dateRangeClient";
24
+ const startDate = new Date("2023-05-01");
25
+ const endDate = new Date("2023-05-31");
26
+
27
+ const scanInside = createScanFixture({ clientId, status: "COMPLETED" });
28
+ const scanBefore = createScanFixture({ clientId });
29
+ const scanAfter = createScanFixture({ clientId });
30
+
31
+ await getScansCollection().insertMany([
32
+ { ...scanInside, createdAt: new Date("2023-05-15") },
33
+ { ...scanBefore, createdAt: new Date("2023-04-30") },
34
+ { ...scanAfter, createdAt: new Date("2023-06-01") },
35
+ ]);
36
+
37
+ const result = await getScansByClientAndDateRange(
38
+ clientId,
39
+ startDate,
40
+ endDate,
41
+ );
42
+
43
+ expect(result.length).toBe(1);
44
+ expect(result[0]).toMatchObject({
45
+ clientId,
46
+ websiteUrlId: scanInside.websiteUrlId,
47
+ status: "COMPLETED",
48
+ });
49
+ expect(result[0]).toHaveProperty("siteChrome");
50
+ expect(result[0]).toHaveProperty("skipped");
51
+ });
52
+
53
+ it("should respect the date range boundaries (inclusive)", async () => {
54
+ const clientId = "boundaryClient";
55
+ const onStart = createScanFixture({ clientId });
56
+ const onEnd = createScanFixture({ clientId });
57
+
58
+ await getScansCollection().insertMany([
59
+ { ...onStart, createdAt: new Date("2023-05-01") },
60
+ { ...onEnd, createdAt: new Date("2023-05-31") },
61
+ ]);
62
+
63
+ const result = await getScansByClientAndDateRange(
64
+ clientId,
65
+ new Date("2023-05-01"),
66
+ new Date("2023-05-31"),
67
+ );
68
+
69
+ expect(result.length).toBe(2);
70
+ });
71
+ });
72
+
73
+ describe("getScanFieldsByClientAndDateRange()", () => {
74
+ it("should return only the requested fields (plus _id)", async () => {
75
+ const clientId = "projectionClient";
76
+ const scan = createScanFixture({
77
+ clientId,
78
+ status: "COMPLETED",
79
+ siteChrome: { url: "https://example.com", sourceType: "site_chrome" },
80
+ skipped: [{ path: "/broken", reason: "HTTP 500" }],
81
+ });
82
+
83
+ await getScansCollection().insertOne({
84
+ ...scan,
85
+ createdAt: new Date("2023-05-15"),
86
+ });
87
+
88
+ const [result] = await getScanFieldsByClientAndDateRange(
89
+ clientId,
90
+ new Date("2023-05-01"),
91
+ new Date("2023-05-31"),
92
+ ["clientId", "websiteUrlId", "status"],
93
+ );
94
+
95
+ expect(result).toMatchObject({
96
+ clientId,
97
+ websiteUrlId: scan.websiteUrlId,
98
+ status: "COMPLETED",
99
+ });
100
+ expect(result).toHaveProperty("_id");
101
+ expect(result).not.toHaveProperty("siteChrome");
102
+ expect(result).not.toHaveProperty("skipped");
103
+ expect(result).not.toHaveProperty("createdAt");
104
+ });
105
+ });
106
+
107
+ describe("findScansByQuery() / countScans()", () => {
108
+ it("should find scans matching a raw filter and count them", async () => {
109
+ const clientId = "queryClient";
110
+ const completed = createScanFixture({ clientId, status: "COMPLETED" });
111
+ const scanning = createScanFixture({ clientId, status: "SCANNING" });
112
+
113
+ await getScansCollection().insertMany([completed, scanning]);
114
+
115
+ const result = await findScansByQuery({ clientId, status: "COMPLETED" });
116
+ const count = await countScans({ clientId });
117
+
118
+ expect(result.length).toBe(1);
119
+ expect(result[0].websiteUrlId).toBe(completed.websiteUrlId);
120
+ expect(count).toBe(2);
121
+ });
122
+ });
123
+
124
+ describe("createScanDoc()", () => {
125
+ it("should insert a scan with default values for the rest of the fields", async () => {
126
+ const clientId = "createClient";
127
+ const websiteUrlId = new ObjectId().toString();
128
+
129
+ const { insertedId } = await createScanDoc({ clientId, websiteUrlId });
130
+
131
+ const result = await getScansCollection().findOne({ _id: insertedId });
132
+
133
+ expect(result).toMatchObject({
134
+ clientId,
135
+ websiteUrlId,
136
+ status: "CHECKING",
137
+ activeTasksCount: 0,
138
+ pagesScanned: 0,
139
+ pagesSkipped: 0,
140
+ skipped: [],
141
+ siteChrome: {},
142
+ });
143
+ expect(result?.createdAt).toBeInstanceOf(Date);
144
+ expect(result?.updatedAt).toBeInstanceOf(Date);
145
+ });
146
+ });
147
+
148
+ describe("updateScanDoc()", () => {
149
+ it("should update the given fields and bump updatedAt", async () => {
150
+ const scan = createScanFixture({ status: "SCANNING", pagesScanned: 0 });
151
+ const { insertedId } = await getScansCollection().insertOne(scan);
152
+
153
+ const result = await updateScanDoc(insertedId, {
154
+ status: "COMPLETED",
155
+ pagesScanned: 10,
156
+ });
157
+
158
+ expect(result).toMatchObject({
159
+ _id: insertedId,
160
+ status: "COMPLETED",
161
+ pagesScanned: 10,
162
+ });
163
+ expect(result?.updatedAt.getTime()).toBeGreaterThan(
164
+ scan.updatedAt.getTime(),
165
+ );
166
+ });
167
+
168
+ it("should return null when the scan does not exist", async () => {
169
+ const result = await updateScanDoc(new ObjectId(), { status: "FAILED" });
170
+
171
+ expect(result).toBeNull();
172
+ });
173
+ });
174
+
175
+ describe("in-progress scan helpers", () => {
176
+ const websiteUrlId = "website-123";
177
+
178
+ it("should return website scan history newest first", async () => {
179
+ await getScansCollection().insertMany([
180
+ createScanFixture({
181
+ websiteUrlId,
182
+ status: "COMPLETED",
183
+ createdAt: new Date("2023-05-01"),
184
+ }),
185
+ createScanFixture({
186
+ websiteUrlId,
187
+ status: "COMPLETED",
188
+ createdAt: new Date("2023-05-15"),
189
+ }),
190
+ ]);
191
+
192
+ const scans = await getScansByWebsiteUrl(websiteUrlId);
193
+ expect(scans).toHaveLength(2);
194
+ expect(scans[0].createdAt.getTime()).toBeGreaterThan(
195
+ scans[1].createdAt.getTime(),
196
+ );
197
+ });
198
+
199
+ it("should return the newest scan for a website", async () => {
200
+ await getScansCollection().insertMany([
201
+ createScanFixture({
202
+ websiteUrlId,
203
+ status: "COMPLETED",
204
+ createdAt: new Date("2023-05-01"),
205
+ }),
206
+ createScanFixture({
207
+ websiteUrlId,
208
+ status: "FAILED",
209
+ createdAt: new Date("2023-05-15"),
210
+ }),
211
+ ]);
212
+
213
+ const latest = await getLatestScanByWebsiteUrl(websiteUrlId);
214
+ expect(latest?.status).toBe("FAILED");
215
+ });
216
+
217
+ it("should return in-progress scan and return null when only completed exists", async () => {
218
+ await getScansCollection().insertMany([
219
+ createScanFixture({
220
+ websiteUrlId,
221
+ status: "COMPLETED",
222
+ createdAt: new Date("2023-05-01"),
223
+ }),
224
+ createScanFixture({
225
+ websiteUrlId,
226
+ status: "SCANNING",
227
+ createdAt: new Date("2023-05-15"),
228
+ }),
229
+ ]);
230
+
231
+ const inProgressScan = await getInProgressScanByWebsiteUrl(websiteUrlId);
232
+ expect(inProgressScan?.status).toBe("SCANNING");
233
+
234
+ await getScansCollection().deleteMany({ websiteUrlId });
235
+ await getScansCollection().insertOne(
236
+ createScanFixture({
237
+ websiteUrlId,
238
+ status: "COMPLETED",
239
+ createdAt: new Date("2023-05-20"),
240
+ }),
241
+ );
242
+
243
+ expect(await getInProgressScanByWebsiteUrl(websiteUrlId)).toBeNull();
244
+ });
245
+
246
+ it("should return all in-progress scans across websites for a client", async () => {
247
+ const clientId = "multiScanClient";
248
+ await getScansCollection().insertMany([
249
+ createScanFixture({
250
+ clientId,
251
+ websiteUrlId: "website-a",
252
+ status: "SCANNING",
253
+ }),
254
+ createScanFixture({
255
+ clientId,
256
+ websiteUrlId: "website-b",
257
+ status: "PROCESSING",
258
+ }),
259
+ createScanFixture({
260
+ clientId,
261
+ websiteUrlId: "website-c",
262
+ status: "COMPLETED",
263
+ }),
264
+ ]);
265
+
266
+ const scans = await findInProgressScansByClient(clientId);
267
+ expect(scans).toHaveLength(2);
268
+ expect(scans.map((s) => s.websiteUrlId).sort()).toEqual([
269
+ "website-a",
270
+ "website-b",
271
+ ]);
272
+ });
273
+ });
274
+
275
+ describe("website delete helpers", () => {
276
+ it("should return the newest completed scan only", async () => {
277
+ const websiteUrlId = new ObjectId().toString();
278
+ await getScansCollection().insertMany([
279
+ createScanFixture({
280
+ websiteUrlId,
281
+ status: "FAILED",
282
+ createdAt: new Date("2023-05-25"),
283
+ }),
284
+ createScanFixture({
285
+ websiteUrlId,
286
+ status: "COMPLETED",
287
+ createdAt: new Date("2023-05-20"),
288
+ }),
289
+ createScanFixture({
290
+ websiteUrlId,
291
+ status: "COMPLETED",
292
+ createdAt: new Date("2023-05-22"),
293
+ }),
294
+ ]);
295
+
296
+ const latest = await getLatestCompletedScanByWebsiteUrl(websiteUrlId);
297
+ expect(latest?.status).toBe("COMPLETED");
298
+ expect(latest?.createdAt).toEqual(new Date("2023-05-22"));
299
+ });
300
+
301
+ it("should delete all scans for the website and return count", async () => {
302
+ const websiteUrlId = new ObjectId().toString();
303
+ await getScansCollection().insertMany([
304
+ createScanFixture({ websiteUrlId }),
305
+ createScanFixture({ websiteUrlId }),
306
+ createScanFixture({ websiteUrlId: new ObjectId().toString() }),
307
+ ]);
308
+
309
+ const deleted = await deleteScansByWebsiteUrl(websiteUrlId);
310
+ expect(deleted).toBe(2);
311
+ expect(await countScans({ websiteUrlId })).toBe(0);
312
+ });
313
+ });
314
+
315
+ describe("deleteScanById()", () => {
316
+ it("should delete the scan and return true", async () => {
317
+ const { insertedId } =
318
+ await getScansCollection().insertOne(createScanFixture());
319
+
320
+ expect(await deleteScanById(insertedId)).toBe(true);
321
+ expect(
322
+ await getScansCollection().findOne({ _id: insertedId }),
323
+ ).toBeNull();
324
+ });
325
+
326
+ it("should return false when the scan does not exist", async () => {
327
+ expect(await deleteScanById(new ObjectId())).toBe(false);
328
+ });
329
+ });
330
+ });