@talkpilot/core-db 1.3.48 → 1.3.50

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 (231) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/AGENTS.md +49 -49
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +778 -777
  5. package/dist/configuration/models/models.constants.d.ts +1 -1
  6. package/dist/configuration/models/models.constants.d.ts.map +1 -1
  7. package/dist/configuration/models/models.constants.js +6 -1
  8. package/dist/configuration/models/models.constants.js.map +1 -1
  9. package/dist/talkpilot/clients/clients.quota.constants.d.ts +2 -0
  10. package/dist/talkpilot/clients/clients.quota.constants.d.ts.map +1 -0
  11. package/dist/talkpilot/clients/clients.quota.constants.js +5 -0
  12. package/dist/talkpilot/clients/clients.quota.constants.js.map +1 -0
  13. package/dist/talkpilot/clients/clients.quota.utils.d.ts +8 -0
  14. package/dist/talkpilot/clients/clients.quota.utils.d.ts.map +1 -0
  15. package/dist/talkpilot/clients/clients.quota.utils.js +45 -0
  16. package/dist/talkpilot/clients/clients.quota.utils.js.map +1 -0
  17. package/dist/talkpilot/flows/flows.getter.d.ts +4 -1
  18. package/dist/talkpilot/flows/flows.getter.d.ts.map +1 -1
  19. package/dist/talkpilot/flows/flows.getter.js +12 -1
  20. package/dist/talkpilot/flows/flows.getter.js.map +1 -1
  21. package/dist/talkpilot/flows/flows.schema.d.ts +31 -0
  22. package/dist/talkpilot/flows/flows.schema.d.ts.map +1 -1
  23. package/dist/talkpilot/flows/flows.schema.js +25 -0
  24. package/dist/talkpilot/flows/flows.schema.js.map +1 -1
  25. package/dist/talkpilot/flows/flows.types.d.ts +14 -0
  26. package/dist/talkpilot/flows/flows.types.d.ts.map +1 -1
  27. package/dist/talkpilot/flows/index.d.ts +1 -1
  28. package/dist/talkpilot/flows/index.d.ts.map +1 -1
  29. package/dist/talkpilot/flows/index.js +3 -1
  30. package/dist/talkpilot/flows/index.js.map +1 -1
  31. package/jest.config.js +20 -20
  32. package/package.json +46 -46
  33. package/src/__tests__/setup.ts +20 -20
  34. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  35. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  36. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  37. package/src/bulkWrite/index.ts +2 -2
  38. package/src/config.ts +9 -9
  39. package/src/configuration/index.ts +17 -17
  40. package/src/configuration/internalModels/index.ts +3 -3
  41. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  42. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  43. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  44. package/src/configuration/models/index.ts +25 -25
  45. package/src/configuration/models/models.constants.ts +18 -13
  46. package/src/configuration/models/models.getters.ts +53 -53
  47. package/src/configuration/models/models.types.ts +79 -79
  48. package/src/configuration/mongodb-client.ts +62 -62
  49. package/src/configuration/prompts/index.ts +2 -2
  50. package/src/configuration/prompts/prompts.getters.ts +49 -49
  51. package/src/configuration/prompts/prompts.types.ts +11 -11
  52. package/src/connection.ts +81 -81
  53. package/src/index.ts +46 -46
  54. package/src/municipal/__tests__/validation.spec.ts +62 -62
  55. package/src/municipal/cities/cities.getters.ts +50 -50
  56. package/src/municipal/cities/cities.types.ts +11 -11
  57. package/src/municipal/cities/index.ts +2 -2
  58. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  59. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  60. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  61. package/src/municipal/departmentsSubjects/index.ts +9 -9
  62. package/src/municipal/index.ts +22 -22
  63. package/src/municipal/mongodb-client.ts +61 -61
  64. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  65. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  66. package/src/municipal/muniIssues/index.ts +17 -17
  67. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  68. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  69. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  70. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  71. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  72. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  73. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  74. package/src/municipal/streets/index.ts +2 -2
  75. package/src/municipal/streets/streets.getters.ts +140 -140
  76. package/src/municipal/streets/streets.types.ts +19 -19
  77. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  78. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  79. package/src/municipal/systemInstructions/index.ts +7 -7
  80. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  81. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  82. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  83. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  84. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  85. package/src/municipal/tickets/index.ts +9 -9
  86. package/src/municipal/tickets/tickets.constants.ts +8 -8
  87. package/src/municipal/tickets/tickets.getters.ts +121 -121
  88. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  89. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  90. package/src/municipal/tickets/tickets.types.ts +54 -54
  91. package/src/municipal/utils/types.ts +11 -11
  92. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  93. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  94. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  95. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  96. package/src/talkpilot/agents/agents.getters.ts +34 -34
  97. package/src/talkpilot/agents/agents.types.ts +14 -14
  98. package/src/talkpilot/agents/index.ts +2 -2
  99. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  100. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  101. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  102. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  103. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  104. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  105. package/src/talkpilot/calls/__tests__/calls.spec.ts +471 -471
  106. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  107. package/src/talkpilot/calls/calls.constants.ts +49 -49
  108. package/src/talkpilot/calls/calls.getters.ts +277 -277
  109. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  110. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  111. package/src/talkpilot/calls/calls.types.ts +149 -149
  112. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  113. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  114. package/src/talkpilot/calls/index.ts +6 -6
  115. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  116. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  117. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  118. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  119. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  120. package/src/talkpilot/clients/clients.getters.ts +16 -16
  121. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  122. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  123. package/src/talkpilot/clients/clients.types.ts +18 -18
  124. package/src/talkpilot/clients/index.ts +4 -4
  125. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  126. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  127. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  128. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  129. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +136 -136
  130. package/src/talkpilot/clientsConfig/index.ts +3 -3
  131. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  132. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  133. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  134. package/src/talkpilot/contextNotes/index.ts +2 -2
  135. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +124 -99
  136. package/src/talkpilot/flows/flows.getter.ts +34 -14
  137. package/src/talkpilot/flows/flows.schema.ts +180 -155
  138. package/src/talkpilot/flows/flows.types.ts +211 -189
  139. package/src/talkpilot/flows/index.ts +7 -2
  140. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  141. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  142. package/src/talkpilot/groups/groups.getters.ts +30 -30
  143. package/src/talkpilot/groups/groups.types.ts +29 -29
  144. package/src/talkpilot/groups/index.ts +3 -3
  145. package/src/talkpilot/groups/phone.utils.ts +46 -46
  146. package/src/talkpilot/index.ts +31 -31
  147. package/src/talkpilot/leads/index.ts +2 -2
  148. package/src/talkpilot/leads/leads.getter.ts +6 -6
  149. package/src/talkpilot/leads/leads.schema.ts +33 -33
  150. package/src/talkpilot/leads/leads.types.ts +20 -20
  151. package/src/talkpilot/mongodb-client.ts +78 -78
  152. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +282 -282
  153. package/src/talkpilot/phone_numbers/index.ts +2 -2
  154. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +176 -176
  155. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  156. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  157. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  158. package/src/talkpilot/plans/index.ts +2 -2
  159. package/src/talkpilot/plans/plans.getters.ts +132 -132
  160. package/src/talkpilot/plans/plans.types.ts +89 -89
  161. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  162. package/src/talkpilot/products/index.ts +2 -2
  163. package/src/talkpilot/products/products.getters.ts +12 -12
  164. package/src/talkpilot/products/products.types.ts +9 -9
  165. package/src/talkpilot/results/index.ts +7 -7
  166. package/src/talkpilot/results/results.getter.ts +39 -39
  167. package/src/talkpilot/results/results.schema.ts +25 -25
  168. package/src/talkpilot/results/results.types.ts +34 -34
  169. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  170. package/src/talkpilot/retry_analyze/index.ts +2 -2
  171. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  172. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  173. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  174. package/src/talkpilot/sessions/index.ts +2 -2
  175. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  176. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  177. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  178. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  179. package/src/talkpilot/subscriptions/index.ts +3 -3
  180. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  181. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  182. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  183. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  184. package/src/talkpilot/utils/query.utils.ts +21 -21
  185. package/src/test-utils/db-utils.ts +33 -33
  186. package/src/test-utils/factories/index.ts +18 -18
  187. package/src/test-utils/factories/municipal/cities.ts +16 -16
  188. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  189. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  190. package/src/test-utils/factories/municipal/streets.ts +22 -22
  191. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  192. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  193. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  194. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  195. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  196. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  197. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  198. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  199. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  200. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  201. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  202. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  203. package/src/test-utils/factories/websitalk/scans.ts +29 -29
  204. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  205. package/src/utils/date.utils.ts +126 -126
  206. package/src/utils/shared.types.ts +4 -4
  207. package/src/utils/validation.ts +23 -23
  208. package/src/websitalk/index.ts +18 -18
  209. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +186 -186
  210. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  211. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +17 -17
  212. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +78 -78
  213. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +62 -62
  214. package/src/websitalk/mongodb-client.ts +61 -61
  215. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +193 -193
  216. package/src/websitalk/scanResources/index.ts +4 -4
  217. package/src/websitalk/scanResources/scanResources.constants.ts +47 -47
  218. package/src/websitalk/scanResources/scanResources.getters.ts +102 -102
  219. package/src/websitalk/scanResources/scanResources.types.ts +90 -90
  220. package/src/websitalk/scanResources/scanResources.utils.ts +31 -31
  221. package/src/websitalk/scans/__tests__/scans.spec.ts +313 -313
  222. package/src/websitalk/scans/index.ts +4 -4
  223. package/src/websitalk/scans/scans.constants.ts +15 -15
  224. package/src/websitalk/scans/scans.getters.ts +166 -166
  225. package/src/websitalk/scans/scans.types.ts +54 -54
  226. package/src/websitalk/scans/scans.utils.ts +5 -5
  227. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  228. package/src/websitalk/websiteUrls/index.ts +2 -2
  229. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  230. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  231. package/tsconfig.json +23 -23
@@ -1,57 +1,57 @@
1
- import { CityName, getDb, ObjectId } from "../index";
2
- import { Collection, Filter } from "mongodb";
3
- import { MIS_SystemInstruction, MIS_Tool } from "./instructions.types";
4
-
5
- export const getSystemInstructionsCollection =
6
- (): Collection<MIS_SystemInstruction> => {
7
- return getDb().collection<MIS_SystemInstruction>("system_instructions");
8
- };
9
- /**
10
- * Find system instructions by filter
11
- * @param filter filter to apply
12
- * @returns array of system instructions
13
- */
14
- export const findSystemInstructions = async (
15
- filter: Filter<MIS_SystemInstruction> = {},
16
- ): Promise<MIS_SystemInstruction[]> => {
17
- return await getSystemInstructionsCollection().find(filter).toArray();
18
- };
19
-
20
- /**
21
- * Get system instruction by id
22
- * @param id system instruction id
23
- * @returns system instruction or null if not found
24
- */
25
- export const getSystemInstructionById = async (
26
- id: string,
27
- ): Promise<MIS_SystemInstruction | null> => {
28
- return await getSystemInstructionsCollection().findOne({
29
- _id: new ObjectId(id),
30
- });
31
- };
32
- /**
33
- * Get all active system instructions for a city
34
- * @param cityName city name
35
- * @returns array of active system instructions
36
- */
37
- export const getActiveSystemInstructionsByCity = async (
38
- cityName: CityName,
39
- ): Promise<MIS_SystemInstruction[]> => {
40
- return await getSystemInstructionsCollection()
41
- .find({ cityName, isActive: true })
42
- .toArray();
43
- };
44
- /**
45
- * Get system instructions by tool and city
46
- * @param cityName city name
47
- * @param toolName tool name
48
- * @returns array of system instructions
49
- */
50
- export const getSystemInstructionsByToolAndCity = async (
51
- cityName: CityName,
52
- toolName: MIS_Tool,
53
- ): Promise<MIS_SystemInstruction[]> => {
54
- return await getSystemInstructionsCollection()
55
- .find({ cityName: cityName, tool: toolName })
56
- .toArray();
57
- };
1
+ import { CityName, getDb, ObjectId } from "../index";
2
+ import { Collection, Filter } from "mongodb";
3
+ import { MIS_SystemInstruction, MIS_Tool } from "./instructions.types";
4
+
5
+ export const getSystemInstructionsCollection =
6
+ (): Collection<MIS_SystemInstruction> => {
7
+ return getDb().collection<MIS_SystemInstruction>("system_instructions");
8
+ };
9
+ /**
10
+ * Find system instructions by filter
11
+ * @param filter filter to apply
12
+ * @returns array of system instructions
13
+ */
14
+ export const findSystemInstructions = async (
15
+ filter: Filter<MIS_SystemInstruction> = {},
16
+ ): Promise<MIS_SystemInstruction[]> => {
17
+ return await getSystemInstructionsCollection().find(filter).toArray();
18
+ };
19
+
20
+ /**
21
+ * Get system instruction by id
22
+ * @param id system instruction id
23
+ * @returns system instruction or null if not found
24
+ */
25
+ export const getSystemInstructionById = async (
26
+ id: string,
27
+ ): Promise<MIS_SystemInstruction | null> => {
28
+ return await getSystemInstructionsCollection().findOne({
29
+ _id: new ObjectId(id),
30
+ });
31
+ };
32
+ /**
33
+ * Get all active system instructions for a city
34
+ * @param cityName city name
35
+ * @returns array of active system instructions
36
+ */
37
+ export const getActiveSystemInstructionsByCity = async (
38
+ cityName: CityName,
39
+ ): Promise<MIS_SystemInstruction[]> => {
40
+ return await getSystemInstructionsCollection()
41
+ .find({ cityName, isActive: true })
42
+ .toArray();
43
+ };
44
+ /**
45
+ * Get system instructions by tool and city
46
+ * @param cityName city name
47
+ * @param toolName tool name
48
+ * @returns array of system instructions
49
+ */
50
+ export const getSystemInstructionsByToolAndCity = async (
51
+ cityName: CityName,
52
+ toolName: MIS_Tool,
53
+ ): Promise<MIS_SystemInstruction[]> => {
54
+ return await getSystemInstructionsCollection()
55
+ .find({ cityName: cityName, tool: toolName })
56
+ .toArray();
57
+ };
@@ -1,119 +1,119 @@
1
- import { ObjectId } from "../index";
2
- import { ObjectId as MongoObjectId } from "mongodb";
3
- import {
4
- MIS_SystemInstruction,
5
- MIS_TOOLS,
6
- QUERY_TYPES,
7
- } from "./instructions.types";
8
- import { getSystemInstructionsCollection } from "./instructions.getters";
9
-
10
- /**
11
- * Validate system instruction data
12
- * @param data partial system instruction data
13
- * @throws Error if tool or queryType is invalid
14
- */
15
- const validateInstructionData = (data: Partial<MIS_SystemInstruction>) => {
16
- if (
17
- data.tool &&
18
- !(Object.values(MIS_TOOLS) as string[]).includes(data.tool)
19
- ) {
20
- throw new Error(
21
- `Invalid tool value: ${data.tool}. Allowed values are: ${Object.values(MIS_TOOLS).join(", ")}`,
22
- );
23
- }
24
- if (
25
- data.queryType &&
26
- !(Object.values(QUERY_TYPES) as string[]).includes(data.queryType)
27
- ) {
28
- throw new Error(
29
- `Invalid queryType value: ${data.queryType}. Allowed values are: ${Object.values(QUERY_TYPES).join(", ")}`,
30
- );
31
- }
32
- };
33
-
34
- /**
35
- * Create a new system instruction
36
- * @param instructionData system instruction data
37
- * @returns inserted system instruction id
38
- */
39
- export const createSystemInstruction = async (
40
- instructionData: Omit<
41
- MIS_SystemInstruction,
42
- "_id" | "createdAt" | "updatedAt"
43
- >,
44
- ): Promise<MongoObjectId> => {
45
- validateInstructionData(instructionData as Partial<MIS_SystemInstruction>);
46
- const instruction: Omit<MIS_SystemInstruction, "_id"> = {
47
- //append doc metadata to user provided data
48
- ...instructionData,
49
- createdAt: new Date(),
50
- updatedAt: new Date(),
51
- };
52
- const { insertedId } = await getSystemInstructionsCollection().insertOne(
53
- instruction as MIS_SystemInstruction,
54
- );
55
- return insertedId;
56
- };
57
-
58
- /**
59
- * Update a system instruction by id
60
- * @param id system instruction id
61
- * @param data partial system instruction data
62
- * @returns updated system instruction or null if not found
63
- */
64
- export const updateSystemInstruction = async (
65
- id: string,
66
- data: Partial<Omit<MIS_SystemInstruction, "_id" | "createdAt" | "updatedAt">>,
67
- ): Promise<MIS_SystemInstruction | null> => {
68
- validateInstructionData(data as Partial<MIS_SystemInstruction>);
69
- const result = await getSystemInstructionsCollection().findOneAndUpdate(
70
- { _id: new ObjectId(id) },
71
- { $set: { ...data, updatedAt: new Date() } },
72
- { returnDocument: "after" },
73
- );
74
- return result || null;
75
- };
76
-
77
- /**
78
- * Delete a system instruction by id
79
- * @param id system instruction id
80
- * @returns true if deleted, false otherwise
81
- */
82
- export const deleteSystemInstruction = async (id: string): Promise<boolean> => {
83
- const result = await getSystemInstructionsCollection().deleteOne({
84
- _id: new ObjectId(id),
85
- });
86
- return result.deletedCount > 0;
87
- };
88
- /**
89
- * Activate a system instruction by id, sets isActive to true.
90
- * Does not check the current instruction state, calling this on an active instruction will do nothing.
91
- * @param id system instruction id
92
- * @returns true on success, false otherwise
93
- */
94
- export const activateSystemInstruction = async (
95
- id: string,
96
- ): Promise<boolean> => {
97
- const result = await getSystemInstructionsCollection().findOneAndUpdate(
98
- { _id: new ObjectId(id) },
99
- { $set: { isActive: true } },
100
- { returnDocument: "after" },
101
- );
102
- return Boolean(result);
103
- };
104
- /**
105
- * Deactivate a system instruction by id, sets isActive to false.
106
- * Does not check the current instruction state, calling this on a deactivated instruction will do nothing.
107
- * @param id system instruction id
108
- * @returns true on success, false otherwise
109
- */
110
- export const deactivateSystemInstruction = async (
111
- id: string,
112
- ): Promise<boolean> => {
113
- const result = await getSystemInstructionsCollection().findOneAndUpdate(
114
- { _id: new ObjectId(id) },
115
- { $set: { isActive: false } },
116
- { returnDocument: "after" },
117
- );
118
- return Boolean(result);
119
- };
1
+ import { ObjectId } from "../index";
2
+ import { ObjectId as MongoObjectId } from "mongodb";
3
+ import {
4
+ MIS_SystemInstruction,
5
+ MIS_TOOLS,
6
+ QUERY_TYPES,
7
+ } from "./instructions.types";
8
+ import { getSystemInstructionsCollection } from "./instructions.getters";
9
+
10
+ /**
11
+ * Validate system instruction data
12
+ * @param data partial system instruction data
13
+ * @throws Error if tool or queryType is invalid
14
+ */
15
+ const validateInstructionData = (data: Partial<MIS_SystemInstruction>) => {
16
+ if (
17
+ data.tool &&
18
+ !(Object.values(MIS_TOOLS) as string[]).includes(data.tool)
19
+ ) {
20
+ throw new Error(
21
+ `Invalid tool value: ${data.tool}. Allowed values are: ${Object.values(MIS_TOOLS).join(", ")}`,
22
+ );
23
+ }
24
+ if (
25
+ data.queryType &&
26
+ !(Object.values(QUERY_TYPES) as string[]).includes(data.queryType)
27
+ ) {
28
+ throw new Error(
29
+ `Invalid queryType value: ${data.queryType}. Allowed values are: ${Object.values(QUERY_TYPES).join(", ")}`,
30
+ );
31
+ }
32
+ };
33
+
34
+ /**
35
+ * Create a new system instruction
36
+ * @param instructionData system instruction data
37
+ * @returns inserted system instruction id
38
+ */
39
+ export const createSystemInstruction = async (
40
+ instructionData: Omit<
41
+ MIS_SystemInstruction,
42
+ "_id" | "createdAt" | "updatedAt"
43
+ >,
44
+ ): Promise<MongoObjectId> => {
45
+ validateInstructionData(instructionData as Partial<MIS_SystemInstruction>);
46
+ const instruction: Omit<MIS_SystemInstruction, "_id"> = {
47
+ //append doc metadata to user provided data
48
+ ...instructionData,
49
+ createdAt: new Date(),
50
+ updatedAt: new Date(),
51
+ };
52
+ const { insertedId } = await getSystemInstructionsCollection().insertOne(
53
+ instruction as MIS_SystemInstruction,
54
+ );
55
+ return insertedId;
56
+ };
57
+
58
+ /**
59
+ * Update a system instruction by id
60
+ * @param id system instruction id
61
+ * @param data partial system instruction data
62
+ * @returns updated system instruction or null if not found
63
+ */
64
+ export const updateSystemInstruction = async (
65
+ id: string,
66
+ data: Partial<Omit<MIS_SystemInstruction, "_id" | "createdAt" | "updatedAt">>,
67
+ ): Promise<MIS_SystemInstruction | null> => {
68
+ validateInstructionData(data as Partial<MIS_SystemInstruction>);
69
+ const result = await getSystemInstructionsCollection().findOneAndUpdate(
70
+ { _id: new ObjectId(id) },
71
+ { $set: { ...data, updatedAt: new Date() } },
72
+ { returnDocument: "after" },
73
+ );
74
+ return result || null;
75
+ };
76
+
77
+ /**
78
+ * Delete a system instruction by id
79
+ * @param id system instruction id
80
+ * @returns true if deleted, false otherwise
81
+ */
82
+ export const deleteSystemInstruction = async (id: string): Promise<boolean> => {
83
+ const result = await getSystemInstructionsCollection().deleteOne({
84
+ _id: new ObjectId(id),
85
+ });
86
+ return result.deletedCount > 0;
87
+ };
88
+ /**
89
+ * Activate a system instruction by id, sets isActive to true.
90
+ * Does not check the current instruction state, calling this on an active instruction will do nothing.
91
+ * @param id system instruction id
92
+ * @returns true on success, false otherwise
93
+ */
94
+ export const activateSystemInstruction = async (
95
+ id: string,
96
+ ): Promise<boolean> => {
97
+ const result = await getSystemInstructionsCollection().findOneAndUpdate(
98
+ { _id: new ObjectId(id) },
99
+ { $set: { isActive: true } },
100
+ { returnDocument: "after" },
101
+ );
102
+ return Boolean(result);
103
+ };
104
+ /**
105
+ * Deactivate a system instruction by id, sets isActive to false.
106
+ * Does not check the current instruction state, calling this on a deactivated instruction will do nothing.
107
+ * @param id system instruction id
108
+ * @returns true on success, false otherwise
109
+ */
110
+ export const deactivateSystemInstruction = async (
111
+ id: string,
112
+ ): Promise<boolean> => {
113
+ const result = await getSystemInstructionsCollection().findOneAndUpdate(
114
+ { _id: new ObjectId(id) },
115
+ { $set: { isActive: false } },
116
+ { returnDocument: "after" },
117
+ );
118
+ return Boolean(result);
119
+ };
@@ -1,30 +1,30 @@
1
- import { ObjectId } from "mongodb";
2
-
3
- import { CityName } from "../utils/types";
4
-
5
- export const MIS_TOOLS = {
6
- findStreet: "findStreet",
7
- findSubject: "findSubject",
8
- } as const;
9
-
10
- export const QUERY_TYPES = {
11
- exactlyOne: "exactlyOne",
12
- any: "any",
13
- all: "all",
14
- none: "none",
15
- } as const;
16
-
17
- export type MIS_Tool = (typeof MIS_TOOLS)[keyof typeof MIS_TOOLS];
18
- export type QueryType = (typeof QUERY_TYPES)[keyof typeof QUERY_TYPES];
19
-
20
- export type MIS_SystemInstruction = {
21
- _id: ObjectId;
22
- createdAt: Date;
23
- updatedAt: Date;
24
- cityName: CityName;
25
- instruction: string;
26
- isActive: boolean;
27
- tool: MIS_Tool;
28
- queryType: QueryType;
29
- tags?: string[]; //no tags implies all wildcard (?)
30
- };
1
+ import { ObjectId } from "mongodb";
2
+
3
+ import { CityName } from "../utils/types";
4
+
5
+ export const MIS_TOOLS = {
6
+ findStreet: "findStreet",
7
+ findSubject: "findSubject",
8
+ } as const;
9
+
10
+ export const QUERY_TYPES = {
11
+ exactlyOne: "exactlyOne",
12
+ any: "any",
13
+ all: "all",
14
+ none: "none",
15
+ } as const;
16
+
17
+ export type MIS_Tool = (typeof MIS_TOOLS)[keyof typeof MIS_TOOLS];
18
+ export type QueryType = (typeof QUERY_TYPES)[keyof typeof QUERY_TYPES];
19
+
20
+ export type MIS_SystemInstruction = {
21
+ _id: ObjectId;
22
+ createdAt: Date;
23
+ updatedAt: Date;
24
+ cityName: CityName;
25
+ instruction: string;
26
+ isActive: boolean;
27
+ tool: MIS_Tool;
28
+ queryType: QueryType;
29
+ tags?: string[]; //no tags implies all wildcard (?)
30
+ };
@@ -1,30 +1,30 @@
1
- import { findTicketsByCallSid } from "../tickets.getters";
2
- import { setDb } from "../../index";
3
- import { Db, Collection } from "mongodb";
4
- import { createTicket } from "../../../test-utils/factories";
5
-
6
- describe("tickets getters", () => {
7
- let mockDb: Partial<Db>;
8
- let mockCollection: Partial<Collection>;
9
-
10
- beforeEach(() => {
11
- const mockTicket = createTicket({ callSid: "123" });
12
- mockCollection = {
13
- find: jest.fn().mockReturnValue({
14
- toArray: jest.fn().mockResolvedValue([mockTicket]),
15
- }),
16
- };
17
- mockDb = {
18
- collection: jest.fn().mockReturnValue(mockCollection),
19
- };
20
- setDb(mockDb as Db);
21
- });
22
-
23
- it("findTicketsByCallSid should return tickets for the given callSid", async () => {
24
- const result = await findTicketsByCallSid("123");
25
-
26
- expect(mockDb.collection).toHaveBeenCalledWith("tickets");
27
- expect(mockCollection.find).toHaveBeenCalledWith({ callSid: "123" });
28
- expect(result[0].callSid).toBe("123");
29
- });
30
- });
1
+ import { findTicketsByCallSid } from "../tickets.getters";
2
+ import { setDb } from "../../index";
3
+ import { Db, Collection } from "mongodb";
4
+ import { createTicket } from "../../../test-utils/factories";
5
+
6
+ describe("tickets getters", () => {
7
+ let mockDb: Partial<Db>;
8
+ let mockCollection: Partial<Collection>;
9
+
10
+ beforeEach(() => {
11
+ const mockTicket = createTicket({ callSid: "123" });
12
+ mockCollection = {
13
+ find: jest.fn().mockReturnValue({
14
+ toArray: jest.fn().mockResolvedValue([mockTicket]),
15
+ }),
16
+ };
17
+ mockDb = {
18
+ collection: jest.fn().mockReturnValue(mockCollection),
19
+ };
20
+ setDb(mockDb as Db);
21
+ });
22
+
23
+ it("findTicketsByCallSid should return tickets for the given callSid", async () => {
24
+ const result = await findTicketsByCallSid("123");
25
+
26
+ expect(mockDb.collection).toHaveBeenCalledWith("tickets");
27
+ expect(mockCollection.find).toHaveBeenCalledWith({ callSid: "123" });
28
+ expect(result[0].callSid).toBe("123");
29
+ });
30
+ });