@talkpilot/core-db 1.3.76 → 1.3.77

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 (263) 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 +817 -816
  5. package/dist/municipal/muniIssues/index.d.ts +2 -2
  6. package/dist/municipal/muniIssues/index.d.ts.map +1 -1
  7. package/dist/municipal/muniIssues/index.js +2 -1
  8. package/dist/municipal/muniIssues/index.js.map +1 -1
  9. package/dist/municipal/muniIssues/muniIssues.constants.d.ts +2 -0
  10. package/dist/municipal/muniIssues/muniIssues.constants.d.ts.map +1 -1
  11. package/dist/municipal/muniIssues/muniIssues.constants.js +8 -1
  12. package/dist/municipal/muniIssues/muniIssues.constants.js.map +1 -1
  13. package/dist/municipal/muniIssues/muniIssues.getters.d.ts +6 -1
  14. package/dist/municipal/muniIssues/muniIssues.getters.d.ts.map +1 -1
  15. package/dist/municipal/muniIssues/muniIssues.getters.js +31 -1
  16. package/dist/municipal/muniIssues/muniIssues.getters.js.map +1 -1
  17. package/dist/municipal/muniIssues/muniIssues.schema.d.ts.map +1 -1
  18. package/dist/municipal/muniIssues/muniIssues.schema.js +13 -0
  19. package/dist/municipal/muniIssues/muniIssues.schema.js.map +1 -1
  20. package/dist/municipal/muniIssues/muniIssues.setters.d.ts +5 -1
  21. package/dist/municipal/muniIssues/muniIssues.setters.d.ts.map +1 -1
  22. package/dist/municipal/muniIssues/muniIssues.setters.js +39 -2
  23. package/dist/municipal/muniIssues/muniIssues.setters.js.map +1 -1
  24. package/dist/municipal/muniIssues/muniIssues.types.d.ts +23 -2
  25. package/dist/municipal/muniIssues/muniIssues.types.d.ts.map +1 -1
  26. package/dist/talkpilot/calls/calls.types.d.ts +0 -12
  27. package/dist/talkpilot/calls/calls.types.d.ts.map +1 -1
  28. package/jest.config.js +20 -20
  29. package/package.json +46 -46
  30. package/src/__tests__/setup.ts +20 -20
  31. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  32. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  33. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  34. package/src/bulkWrite/index.ts +2 -2
  35. package/src/config.ts +9 -9
  36. package/src/configuration/index.ts +17 -17
  37. package/src/configuration/internalModels/index.ts +3 -3
  38. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  39. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  40. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  41. package/src/configuration/models/__tests__/models.getters.spec.ts +67 -67
  42. package/src/configuration/models/index.ts +27 -27
  43. package/src/configuration/models/models.constants.ts +20 -20
  44. package/src/configuration/models/models.getters.ts +71 -71
  45. package/src/configuration/models/models.types.ts +80 -80
  46. package/src/configuration/mongodb-client.ts +62 -62
  47. package/src/configuration/prompts/index.ts +2 -2
  48. package/src/configuration/prompts/prompts.getters.ts +49 -49
  49. package/src/configuration/prompts/prompts.types.ts +11 -11
  50. package/src/connection.ts +81 -81
  51. package/src/index.ts +47 -47
  52. package/src/municipal/__tests__/validation.spec.ts +62 -62
  53. package/src/municipal/cities/cities.getters.ts +50 -50
  54. package/src/municipal/cities/cities.types.ts +11 -11
  55. package/src/municipal/cities/index.ts +2 -2
  56. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  57. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  58. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  59. package/src/municipal/departmentsSubjects/index.ts +9 -9
  60. package/src/municipal/index.ts +22 -22
  61. package/src/municipal/mongodb-client.ts +61 -61
  62. package/src/municipal/muniIssues/__tests__/muniIssues.getters.spec.ts +66 -0
  63. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +167 -94
  64. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +93 -92
  65. package/src/municipal/muniIssues/index.ts +22 -17
  66. package/src/municipal/muniIssues/muniIssues.constants.ts +26 -18
  67. package/src/municipal/muniIssues/muniIssues.getters.ts +68 -24
  68. package/src/municipal/muniIssues/muniIssues.schema.ts +80 -66
  69. package/src/municipal/muniIssues/muniIssues.setters.ts +80 -24
  70. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  71. package/src/municipal/muniIssues/muniIssues.types.ts +68 -37
  72. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  73. package/src/municipal/streets/index.ts +2 -2
  74. package/src/municipal/streets/streets.getters.ts +140 -140
  75. package/src/municipal/streets/streets.types.ts +19 -19
  76. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  77. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  78. package/src/municipal/systemInstructions/index.ts +7 -7
  79. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  80. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  81. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  82. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  83. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  84. package/src/municipal/tickets/index.ts +9 -9
  85. package/src/municipal/tickets/tickets.constants.ts +8 -8
  86. package/src/municipal/tickets/tickets.getters.ts +121 -121
  87. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  88. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  89. package/src/municipal/tickets/tickets.types.ts +54 -54
  90. package/src/municipal/utils/types.ts +11 -11
  91. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  92. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  93. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  94. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  95. package/src/talkpilot/agents/agents.getters.ts +34 -34
  96. package/src/talkpilot/agents/agents.types.ts +14 -14
  97. package/src/talkpilot/agents/index.ts +2 -2
  98. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  99. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  100. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  101. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  102. package/src/talkpilot/callTokenUsage/__tests__/callTokenUsage.getters.spec.ts +57 -57
  103. package/src/talkpilot/callTokenUsage/callTokenUsage.getters.ts +42 -42
  104. package/src/talkpilot/callTokenUsage/callTokenUsage.types.ts +28 -28
  105. package/src/talkpilot/callTokenUsage/index.ts +2 -2
  106. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  107. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  108. package/src/talkpilot/calls/__tests__/calls.spec.ts +471 -471
  109. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  110. package/src/talkpilot/calls/calls.constants.ts +49 -49
  111. package/src/talkpilot/calls/calls.getters.ts +277 -277
  112. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  113. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  114. package/src/talkpilot/calls/calls.types.ts +151 -164
  115. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  116. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  117. package/src/talkpilot/calls/index.ts +6 -6
  118. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  119. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  120. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  121. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  122. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  123. package/src/talkpilot/clients/clients.getters.ts +19 -19
  124. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  125. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  126. package/src/talkpilot/clients/clients.types.ts +18 -18
  127. package/src/talkpilot/clients/index.ts +4 -4
  128. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  129. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  130. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  131. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  132. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +137 -137
  133. package/src/talkpilot/clientsConfig/index.ts +3 -3
  134. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  135. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  136. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  137. package/src/talkpilot/contextNotes/index.ts +2 -2
  138. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +124 -124
  139. package/src/talkpilot/flows/flows.getter.ts +34 -34
  140. package/src/talkpilot/flows/flows.schema.ts +180 -180
  141. package/src/talkpilot/flows/flows.types.ts +211 -211
  142. package/src/talkpilot/flows/index.ts +7 -7
  143. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  144. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  145. package/src/talkpilot/groups/groups.getters.ts +30 -30
  146. package/src/talkpilot/groups/groups.types.ts +29 -29
  147. package/src/talkpilot/groups/index.ts +3 -3
  148. package/src/talkpilot/groups/phone.utils.ts +46 -46
  149. package/src/talkpilot/index.ts +32 -32
  150. package/src/talkpilot/leads/index.ts +2 -2
  151. package/src/talkpilot/leads/leads.getter.ts +6 -6
  152. package/src/talkpilot/leads/leads.schema.ts +33 -33
  153. package/src/talkpilot/leads/leads.types.ts +20 -20
  154. package/src/talkpilot/mongodb-client.ts +78 -78
  155. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +530 -530
  156. package/src/talkpilot/phone_numbers/index.ts +2 -2
  157. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +240 -240
  158. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  159. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  160. package/src/talkpilot/phone_numbers/phone_numbers.utils.ts +9 -9
  161. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  162. package/src/talkpilot/plans/index.ts +2 -2
  163. package/src/talkpilot/plans/plans.getters.ts +132 -132
  164. package/src/talkpilot/plans/plans.types.ts +89 -89
  165. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  166. package/src/talkpilot/products/index.ts +2 -2
  167. package/src/talkpilot/products/products.getters.ts +12 -12
  168. package/src/talkpilot/products/products.types.ts +9 -9
  169. package/src/talkpilot/results/index.ts +7 -7
  170. package/src/talkpilot/results/results.getter.ts +39 -39
  171. package/src/talkpilot/results/results.schema.ts +25 -25
  172. package/src/talkpilot/results/results.types.ts +34 -34
  173. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  174. package/src/talkpilot/retry_analyze/index.ts +2 -2
  175. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  176. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  177. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  178. package/src/talkpilot/sessions/index.ts +2 -2
  179. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  180. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  181. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  182. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  183. package/src/talkpilot/subscriptions/index.ts +3 -3
  184. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  185. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  186. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  187. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  188. package/src/talkpilot/utils/query.utils.ts +21 -21
  189. package/src/test-utils/db-utils.ts +33 -33
  190. package/src/test-utils/factories/index.ts +18 -18
  191. package/src/test-utils/factories/municipal/cities.ts +16 -16
  192. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  193. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  194. package/src/test-utils/factories/municipal/streets.ts +22 -22
  195. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  196. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  197. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  198. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  199. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  200. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  201. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  202. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  203. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  204. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  205. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  206. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  207. package/src/test-utils/factories/websitalk/scans.ts +30 -30
  208. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  209. package/src/utils/date.utils.ts +126 -126
  210. package/src/utils/shared.types.ts +4 -4
  211. package/src/utils/validation.ts +23 -23
  212. package/src/websitalk/index.ts +18 -18
  213. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +238 -238
  214. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  215. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +26 -26
  216. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +95 -95
  217. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +75 -75
  218. package/src/websitalk/mongodb-client.ts +61 -61
  219. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +267 -267
  220. package/src/websitalk/scanResources/index.ts +4 -4
  221. package/src/websitalk/scanResources/scanResources.constants.ts +60 -60
  222. package/src/websitalk/scanResources/scanResources.getters.ts +128 -128
  223. package/src/websitalk/scanResources/scanResources.types.ts +105 -105
  224. package/src/websitalk/scanResources/scanResources.utils.ts +31 -31
  225. package/src/websitalk/scans/__tests__/scans.spec.ts +362 -362
  226. package/src/websitalk/scans/index.ts +4 -4
  227. package/src/websitalk/scans/scans.constants.ts +18 -18
  228. package/src/websitalk/scans/scans.getters.ts +172 -172
  229. package/src/websitalk/scans/scans.types.ts +58 -58
  230. package/src/websitalk/scans/scans.utils.ts +5 -5
  231. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  232. package/src/websitalk/websiteUrls/index.ts +2 -2
  233. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  234. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  235. package/tsconfig.json +23 -23
  236. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.d.ts +0 -10
  237. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.d.ts.map +0 -1
  238. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.js +0 -15
  239. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.js.map +0 -1
  240. package/dist/municipal/streets/streets.setters.d.ts +0 -10
  241. package/dist/municipal/streets/streets.setters.d.ts.map +0 -1
  242. package/dist/municipal/streets/streets.setters.js +0 -15
  243. package/dist/municipal/streets/streets.setters.js.map +0 -1
  244. package/dist/reconcile/index.d.ts +0 -5
  245. package/dist/reconcile/index.d.ts.map +0 -1
  246. package/dist/reconcile/index.js +0 -21
  247. package/dist/reconcile/index.js.map +0 -1
  248. package/dist/reconcile/reconcile.diff.d.ts +0 -4
  249. package/dist/reconcile/reconcile.diff.d.ts.map +0 -1
  250. package/dist/reconcile/reconcile.diff.js +0 -36
  251. package/dist/reconcile/reconcile.diff.js.map +0 -1
  252. package/dist/reconcile/reconcile.execute.d.ts +0 -7
  253. package/dist/reconcile/reconcile.execute.d.ts.map +0 -1
  254. package/dist/reconcile/reconcile.execute.js +0 -20
  255. package/dist/reconcile/reconcile.execute.js.map +0 -1
  256. package/dist/reconcile/reconcile.ops.d.ts +0 -12
  257. package/dist/reconcile/reconcile.ops.d.ts.map +0 -1
  258. package/dist/reconcile/reconcile.ops.js +0 -24
  259. package/dist/reconcile/reconcile.ops.js.map +0 -1
  260. package/dist/reconcile/reconcile.types.d.ts +0 -32
  261. package/dist/reconcile/reconcile.types.d.ts.map +0 -1
  262. package/dist/reconcile/reconcile.types.js +0 -3
  263. package/dist/reconcile/reconcile.types.js.map +0 -1
@@ -1,217 +1,217 @@
1
- import {
2
- getContextNotesCollection,
3
- getContextNotes,
4
- getActiveContextNotes,
5
- createContextNote,
6
- setContextNoteEntries,
7
- setContextNoteConfig,
8
- deleteContextNoteEntry,
9
- } from "../contextNotes.getters";
10
- import { ObjectId } from "../../index";
11
- import {
12
- createContextNote as buildContextNote,
13
- createContextNoteEntry,
14
- } from "../../../test-utils/factories/talkpilot/contextNotes";
15
-
16
- describe("contextNotes getters", () => {
17
- it('should return the "contextNotes" collection', () => {
18
- const collection = getContextNotesCollection();
19
- expect(collection.collectionName).toBe("contextNotes");
20
- });
21
-
22
- it("should create a context note document and return its id", async () => {
23
- const doc = buildContextNote({ notes: [createContextNoteEntry()] });
24
- const id = await createContextNote(doc);
25
- expect(id).toBeInstanceOf(ObjectId);
26
-
27
- const saved = await getContextNotesCollection().findOne({ _id: id });
28
- expect(saved).toBeDefined();
29
- expect(saved?.clientId).toBe(doc.clientId);
30
- expect(saved?.notes).toHaveLength(1);
31
- });
32
-
33
- it("should return documents matching clientId and product", async () => {
34
- const clientId = new ObjectId().toString();
35
- await createContextNote(
36
- buildContextNote({ clientId, product: "Municipal" }),
37
- );
38
- await createContextNote(buildContextNote({ clientId, product: "Clinics" }));
39
- await createContextNote(buildContextNote({ product: "Municipal" })); // different client
40
-
41
- const results = await getContextNotes(clientId, "Municipal");
42
- expect(results).toHaveLength(1);
43
- expect(results[0].clientId).toBe(clientId);
44
- expect(results[0].product).toBe("Municipal");
45
- });
46
-
47
- it("should not return documents for a different product", async () => {
48
- const clientId = new ObjectId().toString();
49
- await createContextNote(
50
- buildContextNote({ clientId, product: "Municipal" }),
51
- );
52
- await createContextNote(buildContextNote({ clientId, product: "Clinics" }));
53
-
54
- const results = await getContextNotes(clientId, "Rcure");
55
- expect(results).toHaveLength(0);
56
- });
57
-
58
- it("should return only active notes for a client and product", async () => {
59
- const clientId = new ObjectId().toString();
60
- const now = new Date();
61
- const past = new Date(now.getTime() - 10000);
62
- const future = new Date(now.getTime() + 10000);
63
-
64
- const activeNote = createContextNoteEntry({
65
- activeFrom: past,
66
- expiresAt: future,
67
- });
68
- const expiredNote = createContextNoteEntry({
69
- activeFrom: past,
70
- expiresAt: past,
71
- });
72
- const notYetActiveNote = createContextNoteEntry({
73
- activeFrom: future,
74
- expiresAt: null,
75
- });
76
- const noExpiryNote = createContextNoteEntry({
77
- activeFrom: past,
78
- expiresAt: null,
79
- });
80
-
81
- await createContextNote(
82
- buildContextNote({
83
- clientId,
84
- product: "Municipal",
85
- notes: [activeNote, expiredNote, notYetActiveNote, noExpiryNote],
86
- }),
87
- );
88
-
89
- const results = await getActiveContextNotes(clientId, "Municipal");
90
- expect(results).toHaveLength(2);
91
- expect(results.map((n) => n._id.toString())).toEqual(
92
- expect.arrayContaining([
93
- activeNote._id.toString(),
94
- noExpiryNote._id.toString(),
95
- ]),
96
- );
97
- });
98
-
99
- it("should replace the notes array on a document", async () => {
100
- const doc = buildContextNote({
101
- notes: [createContextNoteEntry(), createContextNoteEntry()],
102
- });
103
- const id = await createContextNote(doc);
104
-
105
- const newNotes = [createContextNoteEntry({ title: "updated" })];
106
- const updated = await setContextNoteEntries(id, doc.clientId, newNotes);
107
- expect(updated).toBe(true);
108
-
109
- const saved = await getContextNotesCollection().findOne({ _id: id });
110
- expect(saved?.notes).toHaveLength(1);
111
- expect(saved?.notes[0].title).toBe("updated");
112
- });
113
-
114
- it("should return false when setContextNoteEntries targets a non-existent document", async () => {
115
- const result = await setContextNoteEntries(new ObjectId(), "nobody", []);
116
- expect(result).toBe(false);
117
- });
118
-
119
- it("should store and retrieve a systemPrompt set at creation", async () => {
120
- const doc = buildContextNote({
121
- systemPrompt: "Treat this information as highly reliable.",
122
- });
123
- const id = await createContextNote(doc);
124
-
125
- const saved = await getContextNotesCollection().findOne({ _id: id });
126
- expect(saved?.systemPrompt).toBe(
127
- "Treat this information as highly reliable.",
128
- );
129
- });
130
-
131
- it("should not touch systemPrompt or product when setContextNoteEntries is called", async () => {
132
- const doc = buildContextNote({
133
- notes: [],
134
- systemPrompt: "Original instructions.",
135
- product: "Municipal",
136
- });
137
- const id = await createContextNote(doc);
138
-
139
- await setContextNoteEntries(id, doc.clientId, [createContextNoteEntry()]);
140
-
141
- const saved = await getContextNotesCollection().findOne({ _id: id });
142
- expect(saved?.systemPrompt).toBe("Original instructions.");
143
- expect(saved?.product).toBe("Municipal");
144
- expect(saved?.notes).toHaveLength(1);
145
- });
146
-
147
- it("should update systemPrompt via setContextNoteConfig", async () => {
148
- const doc = buildContextNote({ notes: [] });
149
- const id = await createContextNote(doc);
150
-
151
- const updated = await setContextNoteConfig(id, doc.clientId, {
152
- systemPrompt: "New instructions.",
153
- });
154
- expect(updated).toBe(true);
155
-
156
- const saved = await getContextNotesCollection().findOne({ _id: id });
157
- expect(saved?.systemPrompt).toBe("New instructions.");
158
- });
159
-
160
- it("should update product via setContextNoteConfig", async () => {
161
- const doc = buildContextNote({ product: "Municipal" });
162
- const id = await createContextNote(doc);
163
-
164
- const updated = await setContextNoteConfig(id, doc.clientId, {
165
- product: "Clinics",
166
- });
167
- expect(updated).toBe(true);
168
-
169
- const saved = await getContextNotesCollection().findOne({ _id: id });
170
- expect(saved?.product).toBe("Clinics");
171
- });
172
-
173
- it("should return false from setContextNoteConfig when no fields are provided", async () => {
174
- const doc = buildContextNote({});
175
- const id = await createContextNote(doc);
176
-
177
- const result = await setContextNoteConfig(id, doc.clientId, {});
178
- expect(result).toBe(false);
179
- });
180
-
181
- it("should return false from setContextNoteConfig for a non-existent document", async () => {
182
- const result = await setContextNoteConfig(new ObjectId(), "nobody", {
183
- systemPrompt: "x",
184
- });
185
- expect(result).toBe(false);
186
- });
187
-
188
- it("should delete a single note entry by id", async () => {
189
- const noteToKeep = createContextNoteEntry();
190
- const noteToDelete = createContextNoteEntry();
191
- const doc = buildContextNote({ notes: [noteToKeep, noteToDelete] });
192
- const id = await createContextNote(doc);
193
-
194
- const deleted = await deleteContextNoteEntry(
195
- id,
196
- doc.clientId,
197
- noteToDelete._id,
198
- );
199
- expect(deleted).toBe(true);
200
-
201
- const saved = await getContextNotesCollection().findOne({ _id: id });
202
- expect(saved?.notes).toHaveLength(1);
203
- expect(saved?.notes[0]._id.toString()).toBe(noteToKeep._id.toString());
204
- });
205
-
206
- it("should return false when deleteContextNoteEntry targets a non-existent note", async () => {
207
- const doc = buildContextNote({ notes: [] });
208
- const id = await createContextNote(doc);
209
-
210
- const result = await deleteContextNoteEntry(
211
- id,
212
- doc.clientId,
213
- new ObjectId(),
214
- );
215
- expect(result).toBe(false);
216
- });
217
- });
1
+ import {
2
+ getContextNotesCollection,
3
+ getContextNotes,
4
+ getActiveContextNotes,
5
+ createContextNote,
6
+ setContextNoteEntries,
7
+ setContextNoteConfig,
8
+ deleteContextNoteEntry,
9
+ } from "../contextNotes.getters";
10
+ import { ObjectId } from "../../index";
11
+ import {
12
+ createContextNote as buildContextNote,
13
+ createContextNoteEntry,
14
+ } from "../../../test-utils/factories/talkpilot/contextNotes";
15
+
16
+ describe("contextNotes getters", () => {
17
+ it('should return the "contextNotes" collection', () => {
18
+ const collection = getContextNotesCollection();
19
+ expect(collection.collectionName).toBe("contextNotes");
20
+ });
21
+
22
+ it("should create a context note document and return its id", async () => {
23
+ const doc = buildContextNote({ notes: [createContextNoteEntry()] });
24
+ const id = await createContextNote(doc);
25
+ expect(id).toBeInstanceOf(ObjectId);
26
+
27
+ const saved = await getContextNotesCollection().findOne({ _id: id });
28
+ expect(saved).toBeDefined();
29
+ expect(saved?.clientId).toBe(doc.clientId);
30
+ expect(saved?.notes).toHaveLength(1);
31
+ });
32
+
33
+ it("should return documents matching clientId and product", async () => {
34
+ const clientId = new ObjectId().toString();
35
+ await createContextNote(
36
+ buildContextNote({ clientId, product: "Municipal" }),
37
+ );
38
+ await createContextNote(buildContextNote({ clientId, product: "Clinics" }));
39
+ await createContextNote(buildContextNote({ product: "Municipal" })); // different client
40
+
41
+ const results = await getContextNotes(clientId, "Municipal");
42
+ expect(results).toHaveLength(1);
43
+ expect(results[0].clientId).toBe(clientId);
44
+ expect(results[0].product).toBe("Municipal");
45
+ });
46
+
47
+ it("should not return documents for a different product", async () => {
48
+ const clientId = new ObjectId().toString();
49
+ await createContextNote(
50
+ buildContextNote({ clientId, product: "Municipal" }),
51
+ );
52
+ await createContextNote(buildContextNote({ clientId, product: "Clinics" }));
53
+
54
+ const results = await getContextNotes(clientId, "Rcure");
55
+ expect(results).toHaveLength(0);
56
+ });
57
+
58
+ it("should return only active notes for a client and product", async () => {
59
+ const clientId = new ObjectId().toString();
60
+ const now = new Date();
61
+ const past = new Date(now.getTime() - 10000);
62
+ const future = new Date(now.getTime() + 10000);
63
+
64
+ const activeNote = createContextNoteEntry({
65
+ activeFrom: past,
66
+ expiresAt: future,
67
+ });
68
+ const expiredNote = createContextNoteEntry({
69
+ activeFrom: past,
70
+ expiresAt: past,
71
+ });
72
+ const notYetActiveNote = createContextNoteEntry({
73
+ activeFrom: future,
74
+ expiresAt: null,
75
+ });
76
+ const noExpiryNote = createContextNoteEntry({
77
+ activeFrom: past,
78
+ expiresAt: null,
79
+ });
80
+
81
+ await createContextNote(
82
+ buildContextNote({
83
+ clientId,
84
+ product: "Municipal",
85
+ notes: [activeNote, expiredNote, notYetActiveNote, noExpiryNote],
86
+ }),
87
+ );
88
+
89
+ const results = await getActiveContextNotes(clientId, "Municipal");
90
+ expect(results).toHaveLength(2);
91
+ expect(results.map((n) => n._id.toString())).toEqual(
92
+ expect.arrayContaining([
93
+ activeNote._id.toString(),
94
+ noExpiryNote._id.toString(),
95
+ ]),
96
+ );
97
+ });
98
+
99
+ it("should replace the notes array on a document", async () => {
100
+ const doc = buildContextNote({
101
+ notes: [createContextNoteEntry(), createContextNoteEntry()],
102
+ });
103
+ const id = await createContextNote(doc);
104
+
105
+ const newNotes = [createContextNoteEntry({ title: "updated" })];
106
+ const updated = await setContextNoteEntries(id, doc.clientId, newNotes);
107
+ expect(updated).toBe(true);
108
+
109
+ const saved = await getContextNotesCollection().findOne({ _id: id });
110
+ expect(saved?.notes).toHaveLength(1);
111
+ expect(saved?.notes[0].title).toBe("updated");
112
+ });
113
+
114
+ it("should return false when setContextNoteEntries targets a non-existent document", async () => {
115
+ const result = await setContextNoteEntries(new ObjectId(), "nobody", []);
116
+ expect(result).toBe(false);
117
+ });
118
+
119
+ it("should store and retrieve a systemPrompt set at creation", async () => {
120
+ const doc = buildContextNote({
121
+ systemPrompt: "Treat this information as highly reliable.",
122
+ });
123
+ const id = await createContextNote(doc);
124
+
125
+ const saved = await getContextNotesCollection().findOne({ _id: id });
126
+ expect(saved?.systemPrompt).toBe(
127
+ "Treat this information as highly reliable.",
128
+ );
129
+ });
130
+
131
+ it("should not touch systemPrompt or product when setContextNoteEntries is called", async () => {
132
+ const doc = buildContextNote({
133
+ notes: [],
134
+ systemPrompt: "Original instructions.",
135
+ product: "Municipal",
136
+ });
137
+ const id = await createContextNote(doc);
138
+
139
+ await setContextNoteEntries(id, doc.clientId, [createContextNoteEntry()]);
140
+
141
+ const saved = await getContextNotesCollection().findOne({ _id: id });
142
+ expect(saved?.systemPrompt).toBe("Original instructions.");
143
+ expect(saved?.product).toBe("Municipal");
144
+ expect(saved?.notes).toHaveLength(1);
145
+ });
146
+
147
+ it("should update systemPrompt via setContextNoteConfig", async () => {
148
+ const doc = buildContextNote({ notes: [] });
149
+ const id = await createContextNote(doc);
150
+
151
+ const updated = await setContextNoteConfig(id, doc.clientId, {
152
+ systemPrompt: "New instructions.",
153
+ });
154
+ expect(updated).toBe(true);
155
+
156
+ const saved = await getContextNotesCollection().findOne({ _id: id });
157
+ expect(saved?.systemPrompt).toBe("New instructions.");
158
+ });
159
+
160
+ it("should update product via setContextNoteConfig", async () => {
161
+ const doc = buildContextNote({ product: "Municipal" });
162
+ const id = await createContextNote(doc);
163
+
164
+ const updated = await setContextNoteConfig(id, doc.clientId, {
165
+ product: "Clinics",
166
+ });
167
+ expect(updated).toBe(true);
168
+
169
+ const saved = await getContextNotesCollection().findOne({ _id: id });
170
+ expect(saved?.product).toBe("Clinics");
171
+ });
172
+
173
+ it("should return false from setContextNoteConfig when no fields are provided", async () => {
174
+ const doc = buildContextNote({});
175
+ const id = await createContextNote(doc);
176
+
177
+ const result = await setContextNoteConfig(id, doc.clientId, {});
178
+ expect(result).toBe(false);
179
+ });
180
+
181
+ it("should return false from setContextNoteConfig for a non-existent document", async () => {
182
+ const result = await setContextNoteConfig(new ObjectId(), "nobody", {
183
+ systemPrompt: "x",
184
+ });
185
+ expect(result).toBe(false);
186
+ });
187
+
188
+ it("should delete a single note entry by id", async () => {
189
+ const noteToKeep = createContextNoteEntry();
190
+ const noteToDelete = createContextNoteEntry();
191
+ const doc = buildContextNote({ notes: [noteToKeep, noteToDelete] });
192
+ const id = await createContextNote(doc);
193
+
194
+ const deleted = await deleteContextNoteEntry(
195
+ id,
196
+ doc.clientId,
197
+ noteToDelete._id,
198
+ );
199
+ expect(deleted).toBe(true);
200
+
201
+ const saved = await getContextNotesCollection().findOne({ _id: id });
202
+ expect(saved?.notes).toHaveLength(1);
203
+ expect(saved?.notes[0]._id.toString()).toBe(noteToKeep._id.toString());
204
+ });
205
+
206
+ it("should return false when deleteContextNoteEntry targets a non-existent note", async () => {
207
+ const doc = buildContextNote({ notes: [] });
208
+ const id = await createContextNote(doc);
209
+
210
+ const result = await deleteContextNoteEntry(
211
+ id,
212
+ doc.clientId,
213
+ new ObjectId(),
214
+ );
215
+ expect(result).toBe(false);
216
+ });
217
+ });
@@ -1,85 +1,85 @@
1
- import { Collection, ObjectId, WithId } from "mongodb";
2
- import { getDb } from "../index";
3
- import type { ContextNote, ContextNoteEntry } from "./contextNotes.types";
4
-
5
- export const getContextNotesCollection = (): Collection<ContextNote> => {
6
- return getDb().collection<ContextNote>("contextNotes");
7
- };
8
-
9
- /** Returns all context note documents matching a clientId and product. */
10
- export const getContextNotes = (
11
- clientId: string,
12
- product: string,
13
- ): Promise<WithId<ContextNote>[]> => {
14
- return getContextNotesCollection().find({ clientId, product }).toArray();
15
- };
16
-
17
- /** Returns all currently active note entries across matching documents */
18
- export const getActiveContextNotes = async (
19
- clientId: string,
20
- product: string,
21
- ): Promise<ContextNoteEntry[]> => {
22
- const docs = await getContextNotes(clientId, product);
23
- const now = new Date();
24
- return docs.flatMap((doc) =>
25
- doc.notes.filter(
26
- (note) =>
27
- note.activeFrom <= now &&
28
- (note.expiresAt === null || note.expiresAt > now),
29
- ),
30
- );
31
- };
32
-
33
- /** Creates a new context note document. */
34
- export const createContextNote = (
35
- data: Omit<ContextNote, "_id">,
36
- ): Promise<ObjectId> => {
37
- return getContextNotesCollection()
38
- .insertOne({ ...data, _id: new ObjectId() } as ContextNote)
39
- .then((r) => r.insertedId);
40
- };
41
-
42
- /** Replaces the full notes array on a context note document. */
43
- export const setContextNoteEntries = async (
44
- id: ObjectId,
45
- clientId: string,
46
- notes: ContextNoteEntry[],
47
- ): Promise<boolean> => {
48
- const result = await getContextNotesCollection().updateOne(
49
- { _id: id, clientId },
50
- { $set: { notes } },
51
- );
52
- return result.matchedCount > 0;
53
- };
54
-
55
- /** Updates the configuration fields (systemPrompt, product) on a context note document. */
56
- export const setContextNoteConfig = async (
57
- id: ObjectId,
58
- clientId: string,
59
- config: { systemPrompt?: string; product?: string },
60
- ): Promise<boolean> => {
61
- const fields: Partial<ContextNote> = {};
62
- if (config.systemPrompt !== undefined)
63
- fields.systemPrompt = config.systemPrompt;
64
- if (config.product !== undefined) fields.product = config.product;
65
- if (!Object.keys(fields).length) return false;
66
-
67
- const result = await getContextNotesCollection().updateOne(
68
- { _id: id, clientId },
69
- { $set: fields },
70
- );
71
- return result.matchedCount > 0;
72
- };
73
-
74
- /** Removes a single note entry from a document by its _id. */
75
- export const deleteContextNoteEntry = async (
76
- id: ObjectId,
77
- clientId: string,
78
- noteId: ObjectId,
79
- ): Promise<boolean> => {
80
- const result = await getContextNotesCollection().updateOne(
81
- { _id: id, clientId },
82
- { $pull: { notes: { _id: noteId } as any } },
83
- );
84
- return result.modifiedCount > 0;
85
- };
1
+ import { Collection, ObjectId, WithId } from "mongodb";
2
+ import { getDb } from "../index";
3
+ import type { ContextNote, ContextNoteEntry } from "./contextNotes.types";
4
+
5
+ export const getContextNotesCollection = (): Collection<ContextNote> => {
6
+ return getDb().collection<ContextNote>("contextNotes");
7
+ };
8
+
9
+ /** Returns all context note documents matching a clientId and product. */
10
+ export const getContextNotes = (
11
+ clientId: string,
12
+ product: string,
13
+ ): Promise<WithId<ContextNote>[]> => {
14
+ return getContextNotesCollection().find({ clientId, product }).toArray();
15
+ };
16
+
17
+ /** Returns all currently active note entries across matching documents */
18
+ export const getActiveContextNotes = async (
19
+ clientId: string,
20
+ product: string,
21
+ ): Promise<ContextNoteEntry[]> => {
22
+ const docs = await getContextNotes(clientId, product);
23
+ const now = new Date();
24
+ return docs.flatMap((doc) =>
25
+ doc.notes.filter(
26
+ (note) =>
27
+ note.activeFrom <= now &&
28
+ (note.expiresAt === null || note.expiresAt > now),
29
+ ),
30
+ );
31
+ };
32
+
33
+ /** Creates a new context note document. */
34
+ export const createContextNote = (
35
+ data: Omit<ContextNote, "_id">,
36
+ ): Promise<ObjectId> => {
37
+ return getContextNotesCollection()
38
+ .insertOne({ ...data, _id: new ObjectId() } as ContextNote)
39
+ .then((r) => r.insertedId);
40
+ };
41
+
42
+ /** Replaces the full notes array on a context note document. */
43
+ export const setContextNoteEntries = async (
44
+ id: ObjectId,
45
+ clientId: string,
46
+ notes: ContextNoteEntry[],
47
+ ): Promise<boolean> => {
48
+ const result = await getContextNotesCollection().updateOne(
49
+ { _id: id, clientId },
50
+ { $set: { notes } },
51
+ );
52
+ return result.matchedCount > 0;
53
+ };
54
+
55
+ /** Updates the configuration fields (systemPrompt, product) on a context note document. */
56
+ export const setContextNoteConfig = async (
57
+ id: ObjectId,
58
+ clientId: string,
59
+ config: { systemPrompt?: string; product?: string },
60
+ ): Promise<boolean> => {
61
+ const fields: Partial<ContextNote> = {};
62
+ if (config.systemPrompt !== undefined)
63
+ fields.systemPrompt = config.systemPrompt;
64
+ if (config.product !== undefined) fields.product = config.product;
65
+ if (!Object.keys(fields).length) return false;
66
+
67
+ const result = await getContextNotesCollection().updateOne(
68
+ { _id: id, clientId },
69
+ { $set: fields },
70
+ );
71
+ return result.matchedCount > 0;
72
+ };
73
+
74
+ /** Removes a single note entry from a document by its _id. */
75
+ export const deleteContextNoteEntry = async (
76
+ id: ObjectId,
77
+ clientId: string,
78
+ noteId: ObjectId,
79
+ ): Promise<boolean> => {
80
+ const result = await getContextNotesCollection().updateOne(
81
+ { _id: id, clientId },
82
+ { $pull: { notes: { _id: noteId } as any } },
83
+ );
84
+ return result.modifiedCount > 0;
85
+ };
@@ -1,20 +1,20 @@
1
- import { ObjectId } from "mongodb";
2
-
3
- export type ContextNoteEntry = {
4
- _id: ObjectId;
5
- title: string;
6
- content: string;
7
- activeFrom: Date;
8
- expiresAt: Date | null;
9
- createdAt: Date;
10
- updatedAt: Date;
11
- };
12
-
13
- export type ContextNote = {
14
- _id: ObjectId;
15
- clientId: string;
16
- product: string;
17
- notes: ContextNoteEntry[];
18
- /** instructions for how the LLM should treat context info */
19
- systemPrompt?: string;
20
- };
1
+ import { ObjectId } from "mongodb";
2
+
3
+ export type ContextNoteEntry = {
4
+ _id: ObjectId;
5
+ title: string;
6
+ content: string;
7
+ activeFrom: Date;
8
+ expiresAt: Date | null;
9
+ createdAt: Date;
10
+ updatedAt: Date;
11
+ };
12
+
13
+ export type ContextNote = {
14
+ _id: ObjectId;
15
+ clientId: string;
16
+ product: string;
17
+ notes: ContextNoteEntry[];
18
+ /** instructions for how the LLM should treat context info */
19
+ systemPrompt?: string;
20
+ };
@@ -1,2 +1,2 @@
1
- export * from "./contextNotes.types";
2
- export * from "./contextNotes.getters";
1
+ export * from "./contextNotes.types";
2
+ export * from "./contextNotes.getters";