@talkpilot/core-db 1.3.45 → 1.3.47

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 (215) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/AGENTS.md +49 -0
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +747 -747
  5. package/dist/talkpilot/clientsConfig/clientsConfig.types.d.ts +1 -0
  6. package/dist/talkpilot/clientsConfig/clientsConfig.types.d.ts.map +1 -1
  7. package/jest.config.js +20 -20
  8. package/package.json +46 -46
  9. package/src/__tests__/setup.ts +20 -20
  10. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  11. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  12. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  13. package/src/bulkWrite/index.ts +2 -2
  14. package/src/config.ts +9 -9
  15. package/src/configuration/index.ts +17 -17
  16. package/src/configuration/internalModels/index.ts +3 -3
  17. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  18. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  19. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  20. package/src/configuration/models/index.ts +25 -25
  21. package/src/configuration/models/models.constants.ts +13 -13
  22. package/src/configuration/models/models.getters.ts +53 -53
  23. package/src/configuration/models/models.types.ts +79 -79
  24. package/src/configuration/mongodb-client.ts +62 -62
  25. package/src/configuration/prompts/index.ts +2 -2
  26. package/src/configuration/prompts/prompts.getters.ts +49 -49
  27. package/src/configuration/prompts/prompts.types.ts +11 -11
  28. package/src/connection.ts +81 -81
  29. package/src/index.ts +46 -46
  30. package/src/municipal/__tests__/validation.spec.ts +62 -62
  31. package/src/municipal/cities/cities.getters.ts +50 -50
  32. package/src/municipal/cities/cities.types.ts +11 -11
  33. package/src/municipal/cities/index.ts +2 -2
  34. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  35. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  36. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  37. package/src/municipal/departmentsSubjects/index.ts +9 -9
  38. package/src/municipal/index.ts +22 -22
  39. package/src/municipal/mongodb-client.ts +61 -61
  40. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  41. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  42. package/src/municipal/muniIssues/index.ts +17 -17
  43. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  44. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  45. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  46. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  47. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  48. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  49. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  50. package/src/municipal/streets/index.ts +2 -2
  51. package/src/municipal/streets/streets.getters.ts +140 -140
  52. package/src/municipal/streets/streets.types.ts +19 -19
  53. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  54. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  55. package/src/municipal/systemInstructions/index.ts +7 -7
  56. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  57. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  58. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  59. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  60. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  61. package/src/municipal/tickets/index.ts +9 -9
  62. package/src/municipal/tickets/tickets.constants.ts +8 -8
  63. package/src/municipal/tickets/tickets.getters.ts +121 -121
  64. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  65. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  66. package/src/municipal/tickets/tickets.types.ts +54 -54
  67. package/src/municipal/utils/types.ts +11 -11
  68. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  69. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  70. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  71. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  72. package/src/talkpilot/agents/agents.getters.ts +34 -34
  73. package/src/talkpilot/agents/agents.types.ts +14 -14
  74. package/src/talkpilot/agents/index.ts +2 -2
  75. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  76. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  77. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  78. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  79. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  80. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  81. package/src/talkpilot/calls/__tests__/calls.spec.ts +471 -471
  82. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  83. package/src/talkpilot/calls/calls.constants.ts +49 -49
  84. package/src/talkpilot/calls/calls.getters.ts +277 -277
  85. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  86. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  87. package/src/talkpilot/calls/calls.types.ts +134 -134
  88. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  89. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  90. package/src/talkpilot/calls/index.ts +6 -6
  91. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  92. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  93. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  94. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  95. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  96. package/src/talkpilot/clients/clients.getters.ts +16 -16
  97. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  98. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  99. package/src/talkpilot/clients/clients.types.ts +18 -18
  100. package/src/talkpilot/clients/index.ts +4 -4
  101. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  102. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  103. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  104. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  105. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +136 -135
  106. package/src/talkpilot/clientsConfig/index.ts +3 -3
  107. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  108. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  109. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  110. package/src/talkpilot/contextNotes/index.ts +2 -2
  111. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +99 -99
  112. package/src/talkpilot/flows/flows.getter.ts +14 -14
  113. package/src/talkpilot/flows/flows.schema.ts +155 -155
  114. package/src/talkpilot/flows/flows.types.ts +189 -189
  115. package/src/talkpilot/flows/index.ts +2 -2
  116. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  117. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  118. package/src/talkpilot/groups/groups.getters.ts +30 -30
  119. package/src/talkpilot/groups/groups.types.ts +29 -29
  120. package/src/talkpilot/groups/index.ts +3 -3
  121. package/src/talkpilot/groups/phone.utils.ts +46 -46
  122. package/src/talkpilot/index.ts +31 -31
  123. package/src/talkpilot/leads/index.ts +2 -2
  124. package/src/talkpilot/leads/leads.getter.ts +6 -6
  125. package/src/talkpilot/leads/leads.schema.ts +33 -33
  126. package/src/talkpilot/leads/leads.types.ts +20 -20
  127. package/src/talkpilot/mongodb-client.ts +78 -78
  128. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +282 -282
  129. package/src/talkpilot/phone_numbers/index.ts +2 -2
  130. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +176 -176
  131. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  132. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  133. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  134. package/src/talkpilot/plans/index.ts +2 -2
  135. package/src/talkpilot/plans/plans.getters.ts +132 -132
  136. package/src/talkpilot/plans/plans.types.ts +89 -89
  137. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  138. package/src/talkpilot/products/index.ts +2 -2
  139. package/src/talkpilot/products/products.getters.ts +12 -12
  140. package/src/talkpilot/products/products.types.ts +9 -9
  141. package/src/talkpilot/results/index.ts +7 -7
  142. package/src/talkpilot/results/results.getter.ts +39 -39
  143. package/src/talkpilot/results/results.schema.ts +25 -25
  144. package/src/talkpilot/results/results.types.ts +34 -34
  145. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  146. package/src/talkpilot/retry_analyze/index.ts +2 -2
  147. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  148. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  149. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  150. package/src/talkpilot/sessions/index.ts +2 -2
  151. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  152. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  153. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  154. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  155. package/src/talkpilot/subscriptions/index.ts +3 -3
  156. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  157. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  158. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  159. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  160. package/src/talkpilot/utils/query.utils.ts +21 -21
  161. package/src/test-utils/db-utils.ts +33 -33
  162. package/src/test-utils/factories/index.ts +18 -18
  163. package/src/test-utils/factories/municipal/cities.ts +16 -16
  164. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  165. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  166. package/src/test-utils/factories/municipal/streets.ts +22 -22
  167. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  168. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  169. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  170. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  171. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  172. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  173. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  174. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  175. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  176. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  177. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  178. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  179. package/src/test-utils/factories/websitalk/scans.ts +29 -29
  180. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  181. package/src/utils/date.utils.ts +126 -126
  182. package/src/utils/shared.types.ts +4 -4
  183. package/src/utils/validation.ts +23 -23
  184. package/src/websitalk/index.ts +18 -18
  185. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +186 -186
  186. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  187. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +17 -17
  188. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +78 -78
  189. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +62 -62
  190. package/src/websitalk/mongodb-client.ts +61 -61
  191. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +136 -136
  192. package/src/websitalk/scanResources/index.ts +4 -4
  193. package/src/websitalk/scanResources/scanResources.constants.ts +47 -47
  194. package/src/websitalk/scanResources/scanResources.getters.ts +94 -94
  195. package/src/websitalk/scanResources/scanResources.types.ts +90 -90
  196. package/src/websitalk/scanResources/scanResources.utils.ts +28 -28
  197. package/src/websitalk/scans/__tests__/scans.spec.ts +313 -313
  198. package/src/websitalk/scans/index.ts +4 -4
  199. package/src/websitalk/scans/scans.constants.ts +15 -15
  200. package/src/websitalk/scans/scans.getters.ts +166 -166
  201. package/src/websitalk/scans/scans.types.ts +54 -54
  202. package/src/websitalk/scans/scans.utils.ts +5 -5
  203. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  204. package/src/websitalk/websiteUrls/index.ts +2 -2
  205. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  206. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  207. package/tsconfig.json +23 -23
  208. package/dist/talkpilot/clients/clients.quota.constants.d.ts +0 -2
  209. package/dist/talkpilot/clients/clients.quota.constants.d.ts.map +0 -1
  210. package/dist/talkpilot/clients/clients.quota.constants.js +0 -5
  211. package/dist/talkpilot/clients/clients.quota.constants.js.map +0 -1
  212. package/dist/talkpilot/clients/clients.quota.utils.d.ts +0 -8
  213. package/dist/talkpilot/clients/clients.quota.utils.d.ts.map +0 -1
  214. package/dist/talkpilot/clients/clients.quota.utils.js +0 -45
  215. package/dist/talkpilot/clients/clients.quota.utils.js.map +0 -1
@@ -1,166 +1,166 @@
1
- import { Collection, Filter, ObjectId } from "mongodb";
2
- import { getDb } from "../index";
3
- import {
4
- applyQueryOptions,
5
- QueryOptions,
6
- } from "../../talkpilot/utils/query.utils";
7
- import type { Scan, ScanDoc } from "./scans.types";
8
- import { FINISHED_SCAN_STATUSES, SCAN_STATUSES } from "./scans.constants";
9
- import { isInProgressScan } from "./scans.utils";
10
-
11
- export const getScansCollection = (): Collection<Scan> => {
12
- return getDb().collection<Scan>("scans");
13
- };
14
-
15
- export const getScansByClientAndDateRange = (
16
- clientId: string,
17
- startDate: Date,
18
- endDate: Date,
19
- ): Promise<ScanDoc[]> => {
20
- return getScansCollection()
21
- .find({
22
- clientId,
23
- createdAt: {
24
- $gte: startDate,
25
- $lte: endDate,
26
- },
27
- })
28
- .toArray();
29
- };
30
-
31
- export const getScanFieldsByClientAndDateRange = <K extends keyof Scan>(
32
- clientId: string,
33
- startDate: Date,
34
- endDate: Date,
35
- fields: K[],
36
- ): Promise<Pick<ScanDoc, "_id" | K>[]> => {
37
- const projection = fields.reduce<Record<string, 1>>((acc, field) => {
38
- acc[field as string] = 1;
39
- return acc;
40
- }, {});
41
-
42
- return getScansCollection()
43
- .find(
44
- {
45
- clientId,
46
- createdAt: {
47
- $gte: startDate,
48
- $lte: endDate,
49
- },
50
- },
51
- { projection },
52
- )
53
- .toArray() as Promise<Pick<ScanDoc, "_id" | K>[]>;
54
- };
55
-
56
- export const createScanDoc = (
57
- scan: Pick<Scan, "clientId" | "websiteUrlId"> &
58
- Partial<Pick<Scan, "notifyPhoneNumber">>,
59
- ) => {
60
- const now = new Date();
61
- return getScansCollection().insertOne({
62
- ...scan,
63
- status: SCAN_STATUSES.CHECKING,
64
- activeTasksCount: 0,
65
- pagesScanned: 0,
66
- pagesSkipped: 0,
67
- skipped: [],
68
- siteChrome: {} as Scan["siteChrome"],
69
- createdAt: now,
70
- updatedAt: now,
71
- startedAt: now,
72
- completedAt: null,
73
- pagesCompleted: 0,
74
- pagesFailedPermanent: 0,
75
- pagesDuplicate: 0,
76
- });
77
- };
78
-
79
- export const getScanById = async (id: string): Promise<ScanDoc | null> => {
80
- return getScansCollection().findOne({ _id: new ObjectId(id) });
81
- };
82
-
83
- export const getScansByWebsiteUrl = async (
84
- websiteUrlId: string,
85
- ): Promise<ScanDoc[]> => {
86
- return getScansCollection()
87
- .find({ websiteUrlId })
88
- .sort({ createdAt: -1 })
89
- .toArray();
90
- };
91
-
92
- export const getLatestScanByWebsiteUrl = async (
93
- websiteUrlId: string,
94
- ): Promise<ScanDoc | null> => {
95
- return getScansCollection().findOne(
96
- { websiteUrlId },
97
- { sort: { createdAt: -1 } },
98
- );
99
- };
100
-
101
- export const getInProgressScanByWebsiteUrl = async (
102
- websiteUrlId: string,
103
- ): Promise<ScanDoc | null> => {
104
- const latestScan = await getLatestScanByWebsiteUrl(websiteUrlId);
105
- if (!latestScan || !isInProgressScan(latestScan)) {
106
- return null;
107
- }
108
- return latestScan;
109
- };
110
-
111
- export const findInProgressScansByClient = async (
112
- clientId: string,
113
- ): Promise<ScanDoc[]> => {
114
- return getScansCollection()
115
- .find({
116
- clientId,
117
- status: { $nin: FINISHED_SCAN_STATUSES },
118
- })
119
- .sort({ createdAt: -1 })
120
- .toArray();
121
- };
122
-
123
- export const updateScanDoc = async (
124
- scanId: ObjectId,
125
- updates: Partial<Omit<Scan, "clientId" | "createdAt">>,
126
- ): Promise<ScanDoc | null> => {
127
- return await getScansCollection().findOneAndUpdate(
128
- { _id: scanId },
129
- { $set: { ...updates, updatedAt: new Date() } },
130
- { returnDocument: "after" },
131
- );
132
- };
133
-
134
- export const findScansByQuery = async (
135
- query: Filter<Scan>,
136
- options?: QueryOptions,
137
- ): Promise<ScanDoc[]> => {
138
- const cursor = getScansCollection().find(query);
139
- return await applyQueryOptions(cursor, options).toArray();
140
- };
141
-
142
- export const countScans = async (query: Filter<Scan>): Promise<number> => {
143
- return getScansCollection().countDocuments(query);
144
- };
145
-
146
- export const hasScansForWebsiteUrl = async (
147
- websiteUrlId: string,
148
- ): Promise<boolean> => {
149
- return (await countScans({ websiteUrlId })) > 0;
150
- };
151
-
152
- export const getLatestCompletedScanByWebsiteUrl = async (
153
- websiteUrlId: string,
154
- ): Promise<ScanDoc | null> => {
155
- return getScansCollection().findOne(
156
- { websiteUrlId, status: SCAN_STATUSES.COMPLETED },
157
- { sort: { createdAt: -1 } },
158
- );
159
- };
160
-
161
- export const deleteScansByWebsiteUrl = async (
162
- websiteUrlId: string,
163
- ): Promise<number> => {
164
- const result = await getScansCollection().deleteMany({ websiteUrlId });
165
- return result.deletedCount;
166
- };
1
+ import { Collection, Filter, ObjectId } from "mongodb";
2
+ import { getDb } from "../index";
3
+ import {
4
+ applyQueryOptions,
5
+ QueryOptions,
6
+ } from "../../talkpilot/utils/query.utils";
7
+ import type { Scan, ScanDoc } from "./scans.types";
8
+ import { FINISHED_SCAN_STATUSES, SCAN_STATUSES } from "./scans.constants";
9
+ import { isInProgressScan } from "./scans.utils";
10
+
11
+ export const getScansCollection = (): Collection<Scan> => {
12
+ return getDb().collection<Scan>("scans");
13
+ };
14
+
15
+ export const getScansByClientAndDateRange = (
16
+ clientId: string,
17
+ startDate: Date,
18
+ endDate: Date,
19
+ ): Promise<ScanDoc[]> => {
20
+ return getScansCollection()
21
+ .find({
22
+ clientId,
23
+ createdAt: {
24
+ $gte: startDate,
25
+ $lte: endDate,
26
+ },
27
+ })
28
+ .toArray();
29
+ };
30
+
31
+ export const getScanFieldsByClientAndDateRange = <K extends keyof Scan>(
32
+ clientId: string,
33
+ startDate: Date,
34
+ endDate: Date,
35
+ fields: K[],
36
+ ): Promise<Pick<ScanDoc, "_id" | K>[]> => {
37
+ const projection = fields.reduce<Record<string, 1>>((acc, field) => {
38
+ acc[field as string] = 1;
39
+ return acc;
40
+ }, {});
41
+
42
+ return getScansCollection()
43
+ .find(
44
+ {
45
+ clientId,
46
+ createdAt: {
47
+ $gte: startDate,
48
+ $lte: endDate,
49
+ },
50
+ },
51
+ { projection },
52
+ )
53
+ .toArray() as Promise<Pick<ScanDoc, "_id" | K>[]>;
54
+ };
55
+
56
+ export const createScanDoc = (
57
+ scan: Pick<Scan, "clientId" | "websiteUrlId"> &
58
+ Partial<Pick<Scan, "notifyPhoneNumber">>,
59
+ ) => {
60
+ const now = new Date();
61
+ return getScansCollection().insertOne({
62
+ ...scan,
63
+ status: SCAN_STATUSES.CHECKING,
64
+ activeTasksCount: 0,
65
+ pagesScanned: 0,
66
+ pagesSkipped: 0,
67
+ skipped: [],
68
+ siteChrome: {} as Scan["siteChrome"],
69
+ createdAt: now,
70
+ updatedAt: now,
71
+ startedAt: now,
72
+ completedAt: null,
73
+ pagesCompleted: 0,
74
+ pagesFailedPermanent: 0,
75
+ pagesDuplicate: 0,
76
+ });
77
+ };
78
+
79
+ export const getScanById = async (id: string): Promise<ScanDoc | null> => {
80
+ return getScansCollection().findOne({ _id: new ObjectId(id) });
81
+ };
82
+
83
+ export const getScansByWebsiteUrl = async (
84
+ websiteUrlId: string,
85
+ ): Promise<ScanDoc[]> => {
86
+ return getScansCollection()
87
+ .find({ websiteUrlId })
88
+ .sort({ createdAt: -1 })
89
+ .toArray();
90
+ };
91
+
92
+ export const getLatestScanByWebsiteUrl = async (
93
+ websiteUrlId: string,
94
+ ): Promise<ScanDoc | null> => {
95
+ return getScansCollection().findOne(
96
+ { websiteUrlId },
97
+ { sort: { createdAt: -1 } },
98
+ );
99
+ };
100
+
101
+ export const getInProgressScanByWebsiteUrl = async (
102
+ websiteUrlId: string,
103
+ ): Promise<ScanDoc | null> => {
104
+ const latestScan = await getLatestScanByWebsiteUrl(websiteUrlId);
105
+ if (!latestScan || !isInProgressScan(latestScan)) {
106
+ return null;
107
+ }
108
+ return latestScan;
109
+ };
110
+
111
+ export const findInProgressScansByClient = async (
112
+ clientId: string,
113
+ ): Promise<ScanDoc[]> => {
114
+ return getScansCollection()
115
+ .find({
116
+ clientId,
117
+ status: { $nin: FINISHED_SCAN_STATUSES },
118
+ })
119
+ .sort({ createdAt: -1 })
120
+ .toArray();
121
+ };
122
+
123
+ export const updateScanDoc = async (
124
+ scanId: ObjectId,
125
+ updates: Partial<Omit<Scan, "clientId" | "createdAt">>,
126
+ ): Promise<ScanDoc | null> => {
127
+ return await getScansCollection().findOneAndUpdate(
128
+ { _id: scanId },
129
+ { $set: { ...updates, updatedAt: new Date() } },
130
+ { returnDocument: "after" },
131
+ );
132
+ };
133
+
134
+ export const findScansByQuery = async (
135
+ query: Filter<Scan>,
136
+ options?: QueryOptions,
137
+ ): Promise<ScanDoc[]> => {
138
+ const cursor = getScansCollection().find(query);
139
+ return await applyQueryOptions(cursor, options).toArray();
140
+ };
141
+
142
+ export const countScans = async (query: Filter<Scan>): Promise<number> => {
143
+ return getScansCollection().countDocuments(query);
144
+ };
145
+
146
+ export const hasScansForWebsiteUrl = async (
147
+ websiteUrlId: string,
148
+ ): Promise<boolean> => {
149
+ return (await countScans({ websiteUrlId })) > 0;
150
+ };
151
+
152
+ export const getLatestCompletedScanByWebsiteUrl = async (
153
+ websiteUrlId: string,
154
+ ): Promise<ScanDoc | null> => {
155
+ return getScansCollection().findOne(
156
+ { websiteUrlId, status: SCAN_STATUSES.COMPLETED },
157
+ { sort: { createdAt: -1 } },
158
+ );
159
+ };
160
+
161
+ export const deleteScansByWebsiteUrl = async (
162
+ websiteUrlId: string,
163
+ ): Promise<number> => {
164
+ const result = await getScansCollection().deleteMany({ websiteUrlId });
165
+ return result.deletedCount;
166
+ };
@@ -1,54 +1,54 @@
1
- import { WithId } from "mongodb";
2
-
3
- import type { SCAN_STATUSES } from "./scans.constants";
4
-
5
- export type ScanStatus = (typeof SCAN_STATUSES)[keyof typeof SCAN_STATUSES];
6
-
7
- export type SiteChromeEntry = {
8
- url: string;
9
- urlCanonical?: string | null;
10
- title?: string | null;
11
- h1?: string | null;
12
- language?: string | null;
13
- sourceType?: string | null;
14
- status?: string | null;
15
- context?: string | null;
16
- contentHash?: string | null;
17
- errorMessage?: string | null;
18
- breadcrumbs?: unknown;
19
- description?: string | null;
20
- sourceUrl?: string | null;
21
- fetchedAt?: Date | null;
22
- createdAt?: Date;
23
- updatedAt?: Date;
24
- };
25
-
26
- export type SkippedEntry = {
27
- path: string;
28
- reason: string;
29
- };
30
-
31
- export type Scan = {
32
- clientId: string;
33
- websiteUrlId: string;
34
- notifyPhoneNumber?: string | null;
35
- status: ScanStatus;
36
- activeTasksCount: number;
37
- pagesScanned: number;
38
- pagesSkipped: number;
39
- skipped: SkippedEntry[];
40
- siteChrome: SiteChromeEntry;
41
- createdAt: Date;
42
- updatedAt: Date;
43
-
44
- // Terminal-only snapshot, written once at finalize (Brain, outside core-db).
45
- // Never read for live progress — an active scan's KPIs must come from
46
- // getScanKpiCounts, not these fields, which are not kept in sync mid-scan.
47
- startedAt?: Date;
48
- completedAt?: Date | null;
49
- pagesCompleted?: number;
50
- pagesFailedPermanent?: number;
51
- pagesDuplicate?: number;
52
- };
53
-
54
- export type ScanDoc = WithId<Scan>;
1
+ import { WithId } from "mongodb";
2
+
3
+ import type { SCAN_STATUSES } from "./scans.constants";
4
+
5
+ export type ScanStatus = (typeof SCAN_STATUSES)[keyof typeof SCAN_STATUSES];
6
+
7
+ export type SiteChromeEntry = {
8
+ url: string;
9
+ urlCanonical?: string | null;
10
+ title?: string | null;
11
+ h1?: string | null;
12
+ language?: string | null;
13
+ sourceType?: string | null;
14
+ status?: string | null;
15
+ context?: string | null;
16
+ contentHash?: string | null;
17
+ errorMessage?: string | null;
18
+ breadcrumbs?: unknown;
19
+ description?: string | null;
20
+ sourceUrl?: string | null;
21
+ fetchedAt?: Date | null;
22
+ createdAt?: Date;
23
+ updatedAt?: Date;
24
+ };
25
+
26
+ export type SkippedEntry = {
27
+ path: string;
28
+ reason: string;
29
+ };
30
+
31
+ export type Scan = {
32
+ clientId: string;
33
+ websiteUrlId: string;
34
+ notifyPhoneNumber?: string | null;
35
+ status: ScanStatus;
36
+ activeTasksCount: number;
37
+ pagesScanned: number;
38
+ pagesSkipped: number;
39
+ skipped: SkippedEntry[];
40
+ siteChrome: SiteChromeEntry;
41
+ createdAt: Date;
42
+ updatedAt: Date;
43
+
44
+ // Terminal-only snapshot, written once at finalize (Brain, outside core-db).
45
+ // Never read for live progress — an active scan's KPIs must come from
46
+ // getScanKpiCounts, not these fields, which are not kept in sync mid-scan.
47
+ startedAt?: Date;
48
+ completedAt?: Date | null;
49
+ pagesCompleted?: number;
50
+ pagesFailedPermanent?: number;
51
+ pagesDuplicate?: number;
52
+ };
53
+
54
+ export type ScanDoc = WithId<Scan>;
@@ -1,5 +1,5 @@
1
- import type { Scan, ScanStatus } from "./scans.types";
2
- import { FINISHED_SCAN_STATUSES } from "./scans.constants";
3
-
4
- export const isInProgressScan = (scan: Scan): boolean =>
5
- !(FINISHED_SCAN_STATUSES as readonly ScanStatus[]).includes(scan.status);
1
+ import type { Scan, ScanStatus } from "./scans.types";
2
+ import { FINISHED_SCAN_STATUSES } from "./scans.constants";
3
+
4
+ export const isInProgressScan = (scan: Scan): boolean =>
5
+ !(FINISHED_SCAN_STATUSES as readonly ScanStatus[]).includes(scan.status);
@@ -1,77 +1,77 @@
1
- import {
2
- createWebsiteUrl,
3
- getWebsiteUrlsByClient,
4
- getWebsiteUrlById,
5
- getWebsiteUrlsCollection,
6
- updateWebsiteUrl,
7
- deleteWebsiteUrl,
8
- } from "../websiteUrls.getters";
9
- import { createWebsiteUrlFixture } from "../../../test-utils/factories/websitalk/websiteUrls";
10
-
11
- describe("db.websitalk.websiteUrls", () => {
12
- const clientId = "test-client";
13
-
14
- describe("createWebsiteUrl", () => {
15
- it("should create a website URL configuration", async () => {
16
- const id = await createWebsiteUrl({
17
- clientId,
18
- name: "Primary",
19
- baseUrl: "https://example.com",
20
- });
21
-
22
- const saved = await getWebsiteUrlById(id.toString());
23
- expect(saved).toMatchObject({
24
- clientId,
25
- name: "Primary",
26
- baseUrl: "https://example.com",
27
- });
28
- expect(saved?.createdAt).toBeInstanceOf(Date);
29
- expect(saved?.updatedAt).toBeInstanceOf(Date);
30
- });
31
- });
32
-
33
- describe("getWebsiteUrlsByClient", () => {
34
- it("should return all configurations for a client", async () => {
35
- await getWebsiteUrlsCollection().insertMany([
36
- createWebsiteUrlFixture({ clientId, name: "A" }),
37
- createWebsiteUrlFixture({ clientId, name: "B" }),
38
- createWebsiteUrlFixture({ clientId: "other-client", name: "Other" }),
39
- ]);
40
-
41
- const results = await getWebsiteUrlsByClient(clientId);
42
- expect(results).toHaveLength(2);
43
- expect(results.map((doc) => doc.name)).toEqual(["A", "B"]);
44
- });
45
- });
46
-
47
- describe("updateWebsiteUrl", () => {
48
- it("should update name and baseUrl", async () => {
49
- const id = await createWebsiteUrl({
50
- clientId,
51
- name: "Old",
52
- baseUrl: "https://old.example",
53
- });
54
-
55
- const updated = await updateWebsiteUrl(id.toString(), {
56
- name: "New",
57
- baseUrl: "https://new.example",
58
- });
59
-
60
- expect(updated?.name).toBe("New");
61
- expect(updated?.baseUrl).toBe("https://new.example");
62
- });
63
- });
64
-
65
- describe("deleteWebsiteUrl", () => {
66
- it("should delete the website and return true", async () => {
67
- const id = await createWebsiteUrl({
68
- clientId: "delete-client",
69
- name: "Gone",
70
- baseUrl: "https://gone.example",
71
- });
72
-
73
- expect(await deleteWebsiteUrl(id.toString())).toBe(true);
74
- expect(await getWebsiteUrlById(id.toString())).toBeNull();
75
- });
76
- });
77
- });
1
+ import {
2
+ createWebsiteUrl,
3
+ getWebsiteUrlsByClient,
4
+ getWebsiteUrlById,
5
+ getWebsiteUrlsCollection,
6
+ updateWebsiteUrl,
7
+ deleteWebsiteUrl,
8
+ } from "../websiteUrls.getters";
9
+ import { createWebsiteUrlFixture } from "../../../test-utils/factories/websitalk/websiteUrls";
10
+
11
+ describe("db.websitalk.websiteUrls", () => {
12
+ const clientId = "test-client";
13
+
14
+ describe("createWebsiteUrl", () => {
15
+ it("should create a website URL configuration", async () => {
16
+ const id = await createWebsiteUrl({
17
+ clientId,
18
+ name: "Primary",
19
+ baseUrl: "https://example.com",
20
+ });
21
+
22
+ const saved = await getWebsiteUrlById(id.toString());
23
+ expect(saved).toMatchObject({
24
+ clientId,
25
+ name: "Primary",
26
+ baseUrl: "https://example.com",
27
+ });
28
+ expect(saved?.createdAt).toBeInstanceOf(Date);
29
+ expect(saved?.updatedAt).toBeInstanceOf(Date);
30
+ });
31
+ });
32
+
33
+ describe("getWebsiteUrlsByClient", () => {
34
+ it("should return all configurations for a client", async () => {
35
+ await getWebsiteUrlsCollection().insertMany([
36
+ createWebsiteUrlFixture({ clientId, name: "A" }),
37
+ createWebsiteUrlFixture({ clientId, name: "B" }),
38
+ createWebsiteUrlFixture({ clientId: "other-client", name: "Other" }),
39
+ ]);
40
+
41
+ const results = await getWebsiteUrlsByClient(clientId);
42
+ expect(results).toHaveLength(2);
43
+ expect(results.map((doc) => doc.name)).toEqual(["A", "B"]);
44
+ });
45
+ });
46
+
47
+ describe("updateWebsiteUrl", () => {
48
+ it("should update name and baseUrl", async () => {
49
+ const id = await createWebsiteUrl({
50
+ clientId,
51
+ name: "Old",
52
+ baseUrl: "https://old.example",
53
+ });
54
+
55
+ const updated = await updateWebsiteUrl(id.toString(), {
56
+ name: "New",
57
+ baseUrl: "https://new.example",
58
+ });
59
+
60
+ expect(updated?.name).toBe("New");
61
+ expect(updated?.baseUrl).toBe("https://new.example");
62
+ });
63
+ });
64
+
65
+ describe("deleteWebsiteUrl", () => {
66
+ it("should delete the website and return true", async () => {
67
+ const id = await createWebsiteUrl({
68
+ clientId: "delete-client",
69
+ name: "Gone",
70
+ baseUrl: "https://gone.example",
71
+ });
72
+
73
+ expect(await deleteWebsiteUrl(id.toString())).toBe(true);
74
+ expect(await getWebsiteUrlById(id.toString())).toBeNull();
75
+ });
76
+ });
77
+ });
@@ -1,2 +1,2 @@
1
- export * from "./websiteUrls.types";
2
- export * from "./websiteUrls.getters";
1
+ export * from "./websiteUrls.types";
2
+ export * from "./websiteUrls.getters";