@talkpilot/core-db 1.3.38 → 1.3.39

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 (233) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/DEVELOPMENT.md +141 -141
  3. package/README.md +721 -721
  4. package/dist/talkpilot/clientsConfig/clientsConfig.constants.d.ts +3 -0
  5. package/dist/talkpilot/clientsConfig/clientsConfig.constants.d.ts.map +1 -0
  6. package/dist/talkpilot/clientsConfig/clientsConfig.constants.js +6 -0
  7. package/dist/talkpilot/clientsConfig/clientsConfig.constants.js.map +1 -0
  8. package/dist/talkpilot/clientsConfig/clientsConfig.getters.d.ts +39 -0
  9. package/dist/talkpilot/clientsConfig/clientsConfig.getters.d.ts.map +1 -1
  10. package/dist/talkpilot/clientsConfig/clientsConfig.getters.js +92 -1
  11. package/dist/talkpilot/clientsConfig/clientsConfig.getters.js.map +1 -1
  12. package/dist/talkpilot/clientsConfig/clientsConfig.types.d.ts +4 -0
  13. package/dist/talkpilot/clientsConfig/clientsConfig.types.d.ts.map +1 -1
  14. package/dist/talkpilot/clientsConfig/index.d.ts +1 -0
  15. package/dist/talkpilot/clientsConfig/index.d.ts.map +1 -1
  16. package/dist/talkpilot/clientsConfig/index.js +1 -0
  17. package/dist/talkpilot/clientsConfig/index.js.map +1 -1
  18. package/jest.config.js +20 -20
  19. package/package.json +46 -46
  20. package/src/__tests__/setup.ts +20 -20
  21. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  22. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  23. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  24. package/src/bulkWrite/index.ts +2 -2
  25. package/src/config.ts +9 -9
  26. package/src/configuration/index.ts +17 -17
  27. package/src/configuration/internalModels/index.ts +3 -3
  28. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  29. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  30. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  31. package/src/configuration/models/index.ts +25 -25
  32. package/src/configuration/models/models.constants.ts +13 -13
  33. package/src/configuration/models/models.getters.ts +53 -53
  34. package/src/configuration/models/models.types.ts +79 -79
  35. package/src/configuration/mongodb-client.ts +62 -62
  36. package/src/configuration/prompts/index.ts +2 -2
  37. package/src/configuration/prompts/prompts.getters.ts +49 -49
  38. package/src/configuration/prompts/prompts.types.ts +11 -11
  39. package/src/connection.ts +81 -81
  40. package/src/index.ts +42 -42
  41. package/src/municipal/__tests__/validation.spec.ts +62 -62
  42. package/src/municipal/cities/cities.getters.ts +50 -50
  43. package/src/municipal/cities/cities.types.ts +11 -11
  44. package/src/municipal/cities/index.ts +2 -2
  45. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  46. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  47. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  48. package/src/municipal/departmentsSubjects/index.ts +9 -9
  49. package/src/municipal/index.ts +22 -22
  50. package/src/municipal/mongodb-client.ts +61 -61
  51. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  52. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  53. package/src/municipal/muniIssues/index.ts +17 -17
  54. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  55. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  56. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  57. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  58. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  59. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  60. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  61. package/src/municipal/streets/index.ts +2 -2
  62. package/src/municipal/streets/streets.getters.ts +140 -140
  63. package/src/municipal/streets/streets.types.ts +19 -19
  64. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  65. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  66. package/src/municipal/systemInstructions/index.ts +7 -7
  67. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  68. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  69. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  70. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  71. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  72. package/src/municipal/tickets/index.ts +9 -9
  73. package/src/municipal/tickets/tickets.constants.ts +8 -8
  74. package/src/municipal/tickets/tickets.getters.ts +121 -121
  75. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  76. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  77. package/src/municipal/tickets/tickets.types.ts +54 -54
  78. package/src/municipal/utils/types.ts +11 -11
  79. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  80. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  81. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  82. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  83. package/src/talkpilot/agents/agents.getters.ts +34 -34
  84. package/src/talkpilot/agents/agents.types.ts +14 -14
  85. package/src/talkpilot/agents/index.ts +2 -2
  86. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  87. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  88. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  89. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  90. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  91. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  92. package/src/talkpilot/calls/__tests__/calls.spec.ts +471 -471
  93. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  94. package/src/talkpilot/calls/calls.constants.ts +49 -49
  95. package/src/talkpilot/calls/calls.getters.ts +277 -277
  96. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  97. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  98. package/src/talkpilot/calls/calls.types.ts +134 -134
  99. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  100. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  101. package/src/talkpilot/calls/index.ts +6 -6
  102. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  103. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  104. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  105. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  106. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  107. package/src/talkpilot/clients/clients.getters.ts +16 -16
  108. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  109. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  110. package/src/talkpilot/clients/clients.types.ts +18 -18
  111. package/src/talkpilot/clients/index.ts +4 -4
  112. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +318 -0
  113. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  114. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -0
  115. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +116 -2
  116. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +4 -0
  117. package/src/talkpilot/clientsConfig/index.ts +3 -2
  118. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  119. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  120. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  121. package/src/talkpilot/contextNotes/index.ts +2 -2
  122. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +99 -99
  123. package/src/talkpilot/flows/flows.getter.ts +14 -14
  124. package/src/talkpilot/flows/flows.schema.ts +155 -155
  125. package/src/talkpilot/flows/flows.types.ts +189 -189
  126. package/src/talkpilot/flows/index.ts +2 -2
  127. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  128. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  129. package/src/talkpilot/groups/groups.getters.ts +30 -30
  130. package/src/talkpilot/groups/groups.types.ts +29 -29
  131. package/src/talkpilot/groups/index.ts +3 -3
  132. package/src/talkpilot/groups/phone.utils.ts +46 -46
  133. package/src/talkpilot/index.ts +31 -31
  134. package/src/talkpilot/leads/index.ts +2 -2
  135. package/src/talkpilot/leads/leads.getter.ts +6 -6
  136. package/src/talkpilot/leads/leads.schema.ts +33 -33
  137. package/src/talkpilot/leads/leads.types.ts +20 -20
  138. package/src/talkpilot/mongodb-client.ts +78 -78
  139. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +282 -282
  140. package/src/talkpilot/phone_numbers/index.ts +2 -2
  141. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +176 -176
  142. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  143. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  144. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  145. package/src/talkpilot/plans/index.ts +2 -2
  146. package/src/talkpilot/plans/plans.getters.ts +132 -132
  147. package/src/talkpilot/plans/plans.types.ts +89 -89
  148. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  149. package/src/talkpilot/products/index.ts +2 -2
  150. package/src/talkpilot/products/products.getters.ts +12 -12
  151. package/src/talkpilot/products/products.types.ts +9 -9
  152. package/src/talkpilot/results/index.ts +7 -7
  153. package/src/talkpilot/results/results.getter.ts +39 -39
  154. package/src/talkpilot/results/results.schema.ts +25 -25
  155. package/src/talkpilot/results/results.types.ts +34 -34
  156. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  157. package/src/talkpilot/retry_analyze/index.ts +2 -2
  158. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  159. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  160. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  161. package/src/talkpilot/sessions/index.ts +2 -2
  162. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  163. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  164. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  165. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  166. package/src/talkpilot/subscriptions/index.ts +3 -3
  167. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  168. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  169. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  170. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  171. package/src/talkpilot/utils/query.utils.ts +21 -21
  172. package/src/test-utils/db-utils.ts +33 -33
  173. package/src/test-utils/factories/index.ts +16 -16
  174. package/src/test-utils/factories/municipal/cities.ts +16 -16
  175. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  176. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  177. package/src/test-utils/factories/municipal/streets.ts +22 -22
  178. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  179. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  180. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  181. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  182. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  183. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  184. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  185. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  186. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  187. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  188. package/src/test-utils/factories/websitalk/scans.ts +24 -24
  189. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  190. package/src/utils/date.utils.ts +126 -126
  191. package/src/utils/shared.types.ts +4 -4
  192. package/src/utils/validation.ts +23 -23
  193. package/src/websitalk/index.ts +16 -16
  194. package/src/websitalk/mongodb-client.ts +61 -61
  195. package/src/websitalk/scans/__tests__/scans.spec.ts +313 -313
  196. package/src/websitalk/scans/index.ts +4 -4
  197. package/src/websitalk/scans/scans.constants.ts +15 -15
  198. package/src/websitalk/scans/scans.getters.ts +160 -160
  199. package/src/websitalk/scans/scans.types.ts +45 -45
  200. package/src/websitalk/scans/scans.utils.ts +5 -5
  201. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  202. package/src/websitalk/websiteUrls/index.ts +2 -2
  203. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  204. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  205. package/tsconfig.json +23 -23
  206. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.d.ts +0 -10
  207. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.d.ts.map +0 -1
  208. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.js +0 -15
  209. package/dist/municipal/departmentsSubjects/departmentsSubjects.setters.js.map +0 -1
  210. package/dist/municipal/streets/streets.setters.d.ts +0 -10
  211. package/dist/municipal/streets/streets.setters.d.ts.map +0 -1
  212. package/dist/municipal/streets/streets.setters.js +0 -15
  213. package/dist/municipal/streets/streets.setters.js.map +0 -1
  214. package/dist/reconcile/index.d.ts +0 -5
  215. package/dist/reconcile/index.d.ts.map +0 -1
  216. package/dist/reconcile/index.js +0 -21
  217. package/dist/reconcile/index.js.map +0 -1
  218. package/dist/reconcile/reconcile.diff.d.ts +0 -4
  219. package/dist/reconcile/reconcile.diff.d.ts.map +0 -1
  220. package/dist/reconcile/reconcile.diff.js +0 -36
  221. package/dist/reconcile/reconcile.diff.js.map +0 -1
  222. package/dist/reconcile/reconcile.execute.d.ts +0 -7
  223. package/dist/reconcile/reconcile.execute.d.ts.map +0 -1
  224. package/dist/reconcile/reconcile.execute.js +0 -20
  225. package/dist/reconcile/reconcile.execute.js.map +0 -1
  226. package/dist/reconcile/reconcile.ops.d.ts +0 -12
  227. package/dist/reconcile/reconcile.ops.d.ts.map +0 -1
  228. package/dist/reconcile/reconcile.ops.js +0 -24
  229. package/dist/reconcile/reconcile.ops.js.map +0 -1
  230. package/dist/reconcile/reconcile.types.d.ts +0 -32
  231. package/dist/reconcile/reconcile.types.d.ts.map +0 -1
  232. package/dist/reconcile/reconcile.types.js +0 -3
  233. 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";