@talkpilot/core-db 1.3.49 → 1.3.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (225) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/AGENTS.md +49 -49
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +778 -778
  5. package/dist/websitalk/scanResources/scanResources.getters.d.ts +1 -0
  6. package/dist/websitalk/scanResources/scanResources.getters.d.ts.map +1 -1
  7. package/dist/websitalk/scanResources/scanResources.getters.js +6 -1
  8. package/dist/websitalk/scanResources/scanResources.getters.js.map +1 -1
  9. package/dist/websitalk/scans/scans.constants.d.ts +1 -0
  10. package/dist/websitalk/scans/scans.constants.d.ts.map +1 -1
  11. package/dist/websitalk/scans/scans.constants.js +1 -0
  12. package/dist/websitalk/scans/scans.constants.js.map +1 -1
  13. package/dist/websitalk/scans/scans.getters.d.ts +1 -0
  14. package/dist/websitalk/scans/scans.getters.d.ts.map +1 -1
  15. package/dist/websitalk/scans/scans.getters.js +6 -1
  16. package/dist/websitalk/scans/scans.getters.js.map +1 -1
  17. package/jest.config.js +20 -20
  18. package/package.json +46 -46
  19. package/src/__tests__/setup.ts +20 -20
  20. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  21. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  22. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  23. package/src/bulkWrite/index.ts +2 -2
  24. package/src/config.ts +9 -9
  25. package/src/configuration/index.ts +17 -17
  26. package/src/configuration/internalModels/index.ts +3 -3
  27. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  28. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  29. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  30. package/src/configuration/models/index.ts +25 -25
  31. package/src/configuration/models/models.constants.ts +13 -13
  32. package/src/configuration/models/models.getters.ts +53 -53
  33. package/src/configuration/models/models.types.ts +79 -79
  34. package/src/configuration/mongodb-client.ts +62 -62
  35. package/src/configuration/prompts/index.ts +2 -2
  36. package/src/configuration/prompts/prompts.getters.ts +49 -49
  37. package/src/configuration/prompts/prompts.types.ts +11 -11
  38. package/src/connection.ts +81 -81
  39. package/src/index.ts +46 -46
  40. package/src/municipal/__tests__/validation.spec.ts +62 -62
  41. package/src/municipal/cities/cities.getters.ts +50 -50
  42. package/src/municipal/cities/cities.types.ts +11 -11
  43. package/src/municipal/cities/index.ts +2 -2
  44. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  45. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  46. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  47. package/src/municipal/departmentsSubjects/index.ts +9 -9
  48. package/src/municipal/index.ts +22 -22
  49. package/src/municipal/mongodb-client.ts +61 -61
  50. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +94 -94
  51. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  52. package/src/municipal/muniIssues/index.ts +17 -17
  53. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  54. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  55. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  56. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  57. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  58. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  59. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  60. package/src/municipal/streets/index.ts +2 -2
  61. package/src/municipal/streets/streets.getters.ts +140 -140
  62. package/src/municipal/streets/streets.types.ts +19 -19
  63. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  64. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  65. package/src/municipal/systemInstructions/index.ts +7 -7
  66. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  67. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  68. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  69. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  70. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +99 -99
  71. package/src/municipal/tickets/index.ts +9 -9
  72. package/src/municipal/tickets/tickets.constants.ts +8 -8
  73. package/src/municipal/tickets/tickets.getters.ts +121 -121
  74. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -110
  75. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  76. package/src/municipal/tickets/tickets.types.ts +54 -54
  77. package/src/municipal/utils/types.ts +11 -11
  78. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  79. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  80. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  81. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  82. package/src/talkpilot/agents/agents.getters.ts +34 -34
  83. package/src/talkpilot/agents/agents.types.ts +14 -14
  84. package/src/talkpilot/agents/index.ts +2 -2
  85. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  86. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  87. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  88. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  89. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  90. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  91. package/src/talkpilot/calls/__tests__/calls.spec.ts +471 -471
  92. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  93. package/src/talkpilot/calls/calls.constants.ts +49 -49
  94. package/src/talkpilot/calls/calls.getters.ts +277 -277
  95. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  96. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  97. package/src/talkpilot/calls/calls.types.ts +149 -149
  98. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  99. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  100. package/src/talkpilot/calls/index.ts +6 -6
  101. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  102. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  103. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  104. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  105. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  106. package/src/talkpilot/clients/clients.getters.ts +16 -16
  107. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  108. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  109. package/src/talkpilot/clients/clients.types.ts +18 -18
  110. package/src/talkpilot/clients/index.ts +4 -4
  111. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  112. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  113. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  114. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  115. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +136 -136
  116. package/src/talkpilot/clientsConfig/index.ts +3 -3
  117. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  118. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  119. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  120. package/src/talkpilot/contextNotes/index.ts +2 -2
  121. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +124 -124
  122. package/src/talkpilot/flows/flows.getter.ts +34 -34
  123. package/src/talkpilot/flows/flows.schema.ts +180 -180
  124. package/src/talkpilot/flows/flows.types.ts +211 -211
  125. package/src/talkpilot/flows/index.ts +7 -7
  126. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  127. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  128. package/src/talkpilot/groups/groups.getters.ts +30 -30
  129. package/src/talkpilot/groups/groups.types.ts +29 -29
  130. package/src/talkpilot/groups/index.ts +3 -3
  131. package/src/talkpilot/groups/phone.utils.ts +46 -46
  132. package/src/talkpilot/index.ts +31 -31
  133. package/src/talkpilot/leads/index.ts +2 -2
  134. package/src/talkpilot/leads/leads.getter.ts +6 -6
  135. package/src/talkpilot/leads/leads.schema.ts +33 -33
  136. package/src/talkpilot/leads/leads.types.ts +20 -20
  137. package/src/talkpilot/mongodb-client.ts +78 -78
  138. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +282 -282
  139. package/src/talkpilot/phone_numbers/index.ts +2 -2
  140. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +176 -176
  141. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  142. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  143. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  144. package/src/talkpilot/plans/index.ts +2 -2
  145. package/src/talkpilot/plans/plans.getters.ts +132 -132
  146. package/src/talkpilot/plans/plans.types.ts +89 -89
  147. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  148. package/src/talkpilot/products/index.ts +2 -2
  149. package/src/talkpilot/products/products.getters.ts +12 -12
  150. package/src/talkpilot/products/products.types.ts +9 -9
  151. package/src/talkpilot/results/index.ts +7 -7
  152. package/src/talkpilot/results/results.getter.ts +39 -39
  153. package/src/talkpilot/results/results.schema.ts +25 -25
  154. package/src/talkpilot/results/results.types.ts +34 -34
  155. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  156. package/src/talkpilot/retry_analyze/index.ts +2 -2
  157. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  158. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  159. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  160. package/src/talkpilot/sessions/index.ts +2 -2
  161. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  162. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  163. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  164. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  165. package/src/talkpilot/subscriptions/index.ts +3 -3
  166. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  167. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  168. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  169. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  170. package/src/talkpilot/utils/query.utils.ts +21 -21
  171. package/src/test-utils/db-utils.ts +33 -33
  172. package/src/test-utils/factories/index.ts +18 -18
  173. package/src/test-utils/factories/municipal/cities.ts +16 -16
  174. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  175. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  176. package/src/test-utils/factories/municipal/streets.ts +22 -22
  177. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  178. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  179. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  180. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  181. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  182. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  183. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  184. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  185. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  186. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  187. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  188. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  189. package/src/test-utils/factories/websitalk/scans.ts +29 -29
  190. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  191. package/src/utils/date.utils.ts +126 -126
  192. package/src/utils/shared.types.ts +4 -4
  193. package/src/utils/validation.ts +23 -23
  194. package/src/websitalk/index.ts +18 -18
  195. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +186 -186
  196. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  197. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +17 -17
  198. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +78 -78
  199. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +62 -62
  200. package/src/websitalk/mongodb-client.ts +61 -61
  201. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +212 -193
  202. package/src/websitalk/scanResources/index.ts +4 -4
  203. package/src/websitalk/scanResources/scanResources.constants.ts +47 -47
  204. package/src/websitalk/scanResources/scanResources.getters.ts +109 -102
  205. package/src/websitalk/scanResources/scanResources.types.ts +90 -90
  206. package/src/websitalk/scanResources/scanResources.utils.ts +31 -31
  207. package/src/websitalk/scans/__tests__/scans.spec.ts +330 -313
  208. package/src/websitalk/scans/index.ts +4 -4
  209. package/src/websitalk/scans/scans.constants.ts +16 -15
  210. package/src/websitalk/scans/scans.getters.ts +171 -166
  211. package/src/websitalk/scans/scans.types.ts +54 -54
  212. package/src/websitalk/scans/scans.utils.ts +5 -5
  213. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  214. package/src/websitalk/websiteUrls/index.ts +2 -2
  215. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  216. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  217. package/tsconfig.json +23 -23
  218. package/dist/talkpilot/clients/clients.quota.constants.d.ts +0 -2
  219. package/dist/talkpilot/clients/clients.quota.constants.d.ts.map +0 -1
  220. package/dist/talkpilot/clients/clients.quota.constants.js +0 -5
  221. package/dist/talkpilot/clients/clients.quota.constants.js.map +0 -1
  222. package/dist/talkpilot/clients/clients.quota.utils.d.ts +0 -8
  223. package/dist/talkpilot/clients/clients.quota.utils.d.ts.map +0 -1
  224. package/dist/talkpilot/clients/clients.quota.utils.js +0 -45
  225. package/dist/talkpilot/clients/clients.quota.utils.js.map +0 -1
@@ -1,33 +1,33 @@
1
- import { getDb } from "../index";
2
- import { Collection, Filter } from "mongodb";
3
- import { InternalModel } from "./internalModels.types";
4
- import { INTERNAL_MODELS_COLLECTION } from "./internalModels.constants";
5
-
6
- export const getInternalModelsCollection = (): Collection<InternalModel> => {
7
- return getDb().collection<InternalModel>(INTERNAL_MODELS_COLLECTION);
8
- };
9
-
10
- /**
11
- * Get an internal model config by its unique name
12
- */
13
- export const getInternalModelByName = async (
14
- name: string
15
- ): Promise<InternalModel | null> => {
16
- return await getInternalModelsCollection().findOne({ name });
17
- };
18
-
19
- /**
20
- * Find internal models by filter.
21
- */
22
- export const findInternalModels = async (
23
- filter: Filter<InternalModel> = {}
24
- ): Promise<InternalModel[]> => {
25
- return await getInternalModelsCollection().find(filter).toArray();
26
- };
27
-
28
- /**
29
- * Get all internal models.
30
- */
31
- export const getAllInternalModels = async (): Promise<InternalModel[]> => {
32
- return await findInternalModels();
33
- };
1
+ import { getDb } from "../index";
2
+ import { Collection, Filter } from "mongodb";
3
+ import { InternalModel } from "./internalModels.types";
4
+ import { INTERNAL_MODELS_COLLECTION } from "./internalModels.constants";
5
+
6
+ export const getInternalModelsCollection = (): Collection<InternalModel> => {
7
+ return getDb().collection<InternalModel>(INTERNAL_MODELS_COLLECTION);
8
+ };
9
+
10
+ /**
11
+ * Get an internal model config by its unique name
12
+ */
13
+ export const getInternalModelByName = async (
14
+ name: string
15
+ ): Promise<InternalModel | null> => {
16
+ return await getInternalModelsCollection().findOne({ name });
17
+ };
18
+
19
+ /**
20
+ * Find internal models by filter.
21
+ */
22
+ export const findInternalModels = async (
23
+ filter: Filter<InternalModel> = {}
24
+ ): Promise<InternalModel[]> => {
25
+ return await getInternalModelsCollection().find(filter).toArray();
26
+ };
27
+
28
+ /**
29
+ * Get all internal models.
30
+ */
31
+ export const getAllInternalModels = async (): Promise<InternalModel[]> => {
32
+ return await findInternalModels();
33
+ };
@@ -1,12 +1,12 @@
1
- import { ObjectId } from "mongodb";
2
-
3
- export type InternalModel = {
4
- _id: ObjectId;
5
- /** Has to be unique between other names in collection */
6
- name: string;
7
- provider: string;
8
- model: string;
9
- config?: Record<string, unknown>;
10
- createdAt: Date;
11
- updatedAt: Date;
12
- };
1
+ import { ObjectId } from "mongodb";
2
+
3
+ export type InternalModel = {
4
+ _id: ObjectId;
5
+ /** Has to be unique between other names in collection */
6
+ name: string;
7
+ provider: string;
8
+ model: string;
9
+ config?: Record<string, unknown>;
10
+ createdAt: Date;
11
+ updatedAt: Date;
12
+ };
@@ -1,25 +1,25 @@
1
- export {
2
- MODELS_COLLECTION,
3
- MODEL_TYPES,
4
- REALTIME_MODEL_PROVIDERS,
5
- STT_MODEL_PROVIDERS,
6
- } from "./models.constants";
7
- export {
8
- getModelsCollection,
9
- findModels,
10
- getModelByModelId,
11
- getModelsByProvider,
12
- getModelsByType,
13
- getAvailableModelsByType,
14
- } from "./models.getters";
15
- export type {
16
- ModelType,
17
- RealtimeModelProvider,
18
- SttModelProvider,
19
- SemanticVad,
20
- ServerVad,
21
- TurnDetection,
22
- RealtimeModelDoc,
23
- SttModelDoc,
24
- ModelDoc,
25
- } from "./models.types";
1
+ export {
2
+ MODELS_COLLECTION,
3
+ MODEL_TYPES,
4
+ REALTIME_MODEL_PROVIDERS,
5
+ STT_MODEL_PROVIDERS,
6
+ } from "./models.constants";
7
+ export {
8
+ getModelsCollection,
9
+ findModels,
10
+ getModelByModelId,
11
+ getModelsByProvider,
12
+ getModelsByType,
13
+ getAvailableModelsByType,
14
+ } from "./models.getters";
15
+ export type {
16
+ ModelType,
17
+ RealtimeModelProvider,
18
+ SttModelProvider,
19
+ SemanticVad,
20
+ ServerVad,
21
+ TurnDetection,
22
+ RealtimeModelDoc,
23
+ SttModelDoc,
24
+ ModelDoc,
25
+ } from "./models.types";
@@ -1,13 +1,13 @@
1
- export const MODELS_COLLECTION = "models";
2
-
3
- export const MODEL_TYPES = ["realtime", "stt"] as const;
4
-
5
- export const REALTIME_MODEL_PROVIDERS = ["openai", "gemini", "xai"] as const;
6
- export const STT_MODEL_PROVIDERS = [
7
- "openai-stt",
8
- "google-stt",
9
- "deepgram-stt",
10
- "deepgram-flux",
11
- "elevenlabs-scribe",
12
- "gladia-stt",
13
- ] as const;
1
+ export const MODELS_COLLECTION = "models";
2
+
3
+ export const MODEL_TYPES = ["realtime", "stt"] as const;
4
+
5
+ export const REALTIME_MODEL_PROVIDERS = ["openai", "gemini", "xai"] as const;
6
+ export const STT_MODEL_PROVIDERS = [
7
+ "openai-stt",
8
+ "google-stt",
9
+ "deepgram-stt",
10
+ "deepgram-flux",
11
+ "elevenlabs-scribe",
12
+ "gladia-stt",
13
+ ] as const;
@@ -1,53 +1,53 @@
1
- import { Collection, Filter } from "mongodb";
2
-
3
- import { getDb } from "../index";
4
- import { MODELS_COLLECTION } from "./models.constants";
5
- import { ModelDoc, ModelType } from "./models.types";
6
-
7
- /** Raw typed handle to the `models` collection. */
8
- export const getModelsCollection = (): Collection<ModelDoc> => {
9
- return getDb().collection<ModelDoc>(MODELS_COLLECTION);
10
- };
11
-
12
- /** Find models by an arbitrary filter. */
13
- export const findModels = async (
14
- filter: Filter<ModelDoc> = {}
15
- ): Promise<ModelDoc[]> => {
16
- return await getModelsCollection().find(filter).toArray();
17
- };
18
-
19
- /**
20
- * Get a single model by its `modelId`, optionally scoped to a `type`.
21
- * @param modelId e.g. "deepgram-stt-phonecall"
22
- * @param type optional narrowing filter, since `modelId` isn't guaranteed unique across types
23
- */
24
- export const getModelByModelId = async (
25
- modelId: string,
26
- type?: ModelType
27
- ): Promise<ModelDoc | null> => {
28
- const filter = (type ? { modelId, type } : { modelId }) as Filter<ModelDoc>;
29
- return await getModelsCollection().findOne(filter);
30
- };
31
-
32
- /**
33
- * Get all models for a given `provider`, optionally scoped to a `type`.
34
- */
35
- export const getModelsByProvider = async (
36
- provider: string,
37
- type?: ModelType
38
- ): Promise<ModelDoc[]> => {
39
- const filter = (type ? { provider, type } : { provider }) as Filter<ModelDoc>;
40
- return await findModels(filter);
41
- };
42
-
43
- /** Get all models of a given `type`. */
44
- export const getModelsByType = async (type: ModelType): Promise<ModelDoc[]> => {
45
- return await findModels({ type } as Filter<ModelDoc>);
46
- };
47
-
48
- /** Get all models of a given `type` where `available` is true. */
49
- export const getAvailableModelsByType = async (
50
- type: ModelType
51
- ): Promise<ModelDoc[]> => {
52
- return await findModels({ type, available: true } as Filter<ModelDoc>);
53
- };
1
+ import { Collection, Filter } from "mongodb";
2
+
3
+ import { getDb } from "../index";
4
+ import { MODELS_COLLECTION } from "./models.constants";
5
+ import { ModelDoc, ModelType } from "./models.types";
6
+
7
+ /** Raw typed handle to the `models` collection. */
8
+ export const getModelsCollection = (): Collection<ModelDoc> => {
9
+ return getDb().collection<ModelDoc>(MODELS_COLLECTION);
10
+ };
11
+
12
+ /** Find models by an arbitrary filter. */
13
+ export const findModels = async (
14
+ filter: Filter<ModelDoc> = {}
15
+ ): Promise<ModelDoc[]> => {
16
+ return await getModelsCollection().find(filter).toArray();
17
+ };
18
+
19
+ /**
20
+ * Get a single model by its `modelId`, optionally scoped to a `type`.
21
+ * @param modelId e.g. "deepgram-stt-phonecall"
22
+ * @param type optional narrowing filter, since `modelId` isn't guaranteed unique across types
23
+ */
24
+ export const getModelByModelId = async (
25
+ modelId: string,
26
+ type?: ModelType
27
+ ): Promise<ModelDoc | null> => {
28
+ const filter = (type ? { modelId, type } : { modelId }) as Filter<ModelDoc>;
29
+ return await getModelsCollection().findOne(filter);
30
+ };
31
+
32
+ /**
33
+ * Get all models for a given `provider`, optionally scoped to a `type`.
34
+ */
35
+ export const getModelsByProvider = async (
36
+ provider: string,
37
+ type?: ModelType
38
+ ): Promise<ModelDoc[]> => {
39
+ const filter = (type ? { provider, type } : { provider }) as Filter<ModelDoc>;
40
+ return await findModels(filter);
41
+ };
42
+
43
+ /** Get all models of a given `type`. */
44
+ export const getModelsByType = async (type: ModelType): Promise<ModelDoc[]> => {
45
+ return await findModels({ type } as Filter<ModelDoc>);
46
+ };
47
+
48
+ /** Get all models of a given `type` where `available` is true. */
49
+ export const getAvailableModelsByType = async (
50
+ type: ModelType
51
+ ): Promise<ModelDoc[]> => {
52
+ return await findModels({ type, available: true } as Filter<ModelDoc>);
53
+ };
@@ -1,79 +1,79 @@
1
- import { ObjectId } from "mongodb";
2
-
3
- import {
4
- MODEL_TYPES,
5
- REALTIME_MODEL_PROVIDERS,
6
- STT_MODEL_PROVIDERS,
7
- } from "./models.constants";
8
-
9
- export type ModelType = (typeof MODEL_TYPES)[number];
10
- export type RealtimeModelProvider = (typeof REALTIME_MODEL_PROVIDERS)[number];
11
- export type SttModelProvider = (typeof STT_MODEL_PROVIDERS)[number];
12
-
13
- export type SemanticVad = {
14
- type: "semantic_vad";
15
- eagerness?: "low" | "medium" | "high" | "auto";
16
- create_response?: boolean;
17
- interrupt_response?: boolean;
18
- };
19
-
20
- export type ServerVad = {
21
- type: "server_vad";
22
- threshold: number;
23
- prefix_padding_ms: number;
24
- silence_duration_ms: number;
25
- create_response?: boolean;
26
- interrupt_response?: boolean;
27
- };
28
-
29
- export type TurnDetection = SemanticVad | ServerVad;
30
-
31
- type BaseModelDoc = {
32
- _id: ObjectId;
33
- /** Public identifier used by the provider, not to be confused with mongo id */
34
- modelId: string;
35
- name: string;
36
- description?: string;
37
- available: boolean;
38
- configDefaults?: Record<string, unknown>;
39
- createdAt: Date;
40
- updatedAt: Date;
41
- };
42
-
43
- /** Realtime speech-to-speech model (OpenAI/Gemini). `features.vad` is turn-detection config. */
44
- export type RealtimeModelDoc = BaseModelDoc & {
45
- type: "realtime";
46
- provider: RealtimeModelProvider;
47
- features?: {
48
- supportsAudio?: boolean;
49
- supportsText?: boolean;
50
- vad?: TurnDetection;
51
- };
52
- };
53
-
54
- /** STT engine/preset (openai-stt, google-stt, deepgram-stt/-flux, elevenlabs-scribe, gladia-stt). */
55
- export type SttModelDoc = BaseModelDoc & {
56
- type: "stt";
57
- provider: SttModelProvider;
58
- features?: {
59
- supportsAudio?: boolean;
60
- supportsText?: boolean;
61
- };
62
- };
63
-
64
- /**
65
- * A document in the `models` collection (configuration db). Discriminated by `type`.
66
- *
67
- * Common fields (all variants):
68
- * - `_id` — Mongo-managed ObjectId
69
- * - `modelId` — model's public identifier
70
- * - `name` — display name
71
- * - `description?` — display description
72
- * - `available` — whether the model should be offered/selectable right now
73
- * - `configDefaults?` — free-form provider-specific config, e.g. the literal vendor
74
- * model string, VAD tuning, language, barge-in timings — shape varies per `provider`
75
- * - `createdAt` / `updatedAt`
76
- *
77
- * Type-specific fields: see {@link RealtimeModelDoc}, {@link SttModelDoc}.
78
- */
79
- export type ModelDoc = RealtimeModelDoc | SttModelDoc;
1
+ import { ObjectId } from "mongodb";
2
+
3
+ import {
4
+ MODEL_TYPES,
5
+ REALTIME_MODEL_PROVIDERS,
6
+ STT_MODEL_PROVIDERS,
7
+ } from "./models.constants";
8
+
9
+ export type ModelType = (typeof MODEL_TYPES)[number];
10
+ export type RealtimeModelProvider = (typeof REALTIME_MODEL_PROVIDERS)[number];
11
+ export type SttModelProvider = (typeof STT_MODEL_PROVIDERS)[number];
12
+
13
+ export type SemanticVad = {
14
+ type: "semantic_vad";
15
+ eagerness?: "low" | "medium" | "high" | "auto";
16
+ create_response?: boolean;
17
+ interrupt_response?: boolean;
18
+ };
19
+
20
+ export type ServerVad = {
21
+ type: "server_vad";
22
+ threshold: number;
23
+ prefix_padding_ms: number;
24
+ silence_duration_ms: number;
25
+ create_response?: boolean;
26
+ interrupt_response?: boolean;
27
+ };
28
+
29
+ export type TurnDetection = SemanticVad | ServerVad;
30
+
31
+ type BaseModelDoc = {
32
+ _id: ObjectId;
33
+ /** Public identifier used by the provider, not to be confused with mongo id */
34
+ modelId: string;
35
+ name: string;
36
+ description?: string;
37
+ available: boolean;
38
+ configDefaults?: Record<string, unknown>;
39
+ createdAt: Date;
40
+ updatedAt: Date;
41
+ };
42
+
43
+ /** Realtime speech-to-speech model (OpenAI/Gemini). `features.vad` is turn-detection config. */
44
+ export type RealtimeModelDoc = BaseModelDoc & {
45
+ type: "realtime";
46
+ provider: RealtimeModelProvider;
47
+ features?: {
48
+ supportsAudio?: boolean;
49
+ supportsText?: boolean;
50
+ vad?: TurnDetection;
51
+ };
52
+ };
53
+
54
+ /** STT engine/preset (openai-stt, google-stt, deepgram-stt/-flux, elevenlabs-scribe, gladia-stt). */
55
+ export type SttModelDoc = BaseModelDoc & {
56
+ type: "stt";
57
+ provider: SttModelProvider;
58
+ features?: {
59
+ supportsAudio?: boolean;
60
+ supportsText?: boolean;
61
+ };
62
+ };
63
+
64
+ /**
65
+ * A document in the `models` collection (configuration db). Discriminated by `type`.
66
+ *
67
+ * Common fields (all variants):
68
+ * - `_id` — Mongo-managed ObjectId
69
+ * - `modelId` — model's public identifier
70
+ * - `name` — display name
71
+ * - `description?` — display description
72
+ * - `available` — whether the model should be offered/selectable right now
73
+ * - `configDefaults?` — free-form provider-specific config, e.g. the literal vendor
74
+ * model string, VAD tuning, language, barge-in timings — shape varies per `provider`
75
+ * - `createdAt` / `updatedAt`
76
+ *
77
+ * Type-specific fields: see {@link RealtimeModelDoc}, {@link SttModelDoc}.
78
+ */
79
+ export type ModelDoc = RealtimeModelDoc | SttModelDoc;
@@ -1,62 +1,62 @@
1
- import { MongoClient, Db } from "mongodb";
2
- import { setDb } from "./index";
3
- import { validateConfig, validateMongoUri } from "../utils/validation";
4
- import { configurationDbConfig } from "../config";
5
-
6
- class ConfigurationMongoDBClient {
7
- private client: MongoClient | null = null;
8
- private db: Db | null = null;
9
- private readonly defaultDbName = "configuration";
10
-
11
- async connect(uri?: string, dbName?: string): Promise<void> {
12
- if (this.client) {
13
- return;
14
- }
15
-
16
- const mongodbUri = uri || configurationDbConfig.mongoUri;
17
- validateConfig("MONGO_URI", mongodbUri);
18
- validateMongoUri(mongodbUri!);
19
-
20
- try {
21
- this.client = new MongoClient(mongodbUri!);
22
- await this.client.connect();
23
- const targetDbName =
24
- dbName || configurationDbConfig.configurationDbName || this.defaultDbName;
25
- this.db = this.client.db(targetDbName);
26
- setDb(this.db);
27
- console.info(`[core-db] Configuration MongoDB connected: ${targetDbName}`);
28
- } catch (error) {
29
- console.error("[core-db] Configuration connection failed", error);
30
- throw error;
31
- }
32
- }
33
-
34
- async disconnect(): Promise<void> {
35
- if (this.client) {
36
- try {
37
- await this.client.close();
38
- this.client = null;
39
- this.db = null;
40
- console.info("Configuration MongoDB disconnected successfully");
41
- } catch (error) {
42
- console.error("[core-db] Configuration disconnection failed", error);
43
- throw error;
44
- }
45
- }
46
- }
47
-
48
- getDb(): Db {
49
- if (!this.db) {
50
- throw new Error(
51
- "Configuration database not initialized. Call connect() first.",
52
- );
53
- }
54
- return this.db;
55
- }
56
-
57
- isConnected(): boolean {
58
- return this.client !== null && this.client !== undefined;
59
- }
60
- }
61
-
62
- export const configurationMongodbClient = new ConfigurationMongoDBClient();
1
+ import { MongoClient, Db } from "mongodb";
2
+ import { setDb } from "./index";
3
+ import { validateConfig, validateMongoUri } from "../utils/validation";
4
+ import { configurationDbConfig } from "../config";
5
+
6
+ class ConfigurationMongoDBClient {
7
+ private client: MongoClient | null = null;
8
+ private db: Db | null = null;
9
+ private readonly defaultDbName = "configuration";
10
+
11
+ async connect(uri?: string, dbName?: string): Promise<void> {
12
+ if (this.client) {
13
+ return;
14
+ }
15
+
16
+ const mongodbUri = uri || configurationDbConfig.mongoUri;
17
+ validateConfig("MONGO_URI", mongodbUri);
18
+ validateMongoUri(mongodbUri!);
19
+
20
+ try {
21
+ this.client = new MongoClient(mongodbUri!);
22
+ await this.client.connect();
23
+ const targetDbName =
24
+ dbName || configurationDbConfig.configurationDbName || this.defaultDbName;
25
+ this.db = this.client.db(targetDbName);
26
+ setDb(this.db);
27
+ console.info(`[core-db] Configuration MongoDB connected: ${targetDbName}`);
28
+ } catch (error) {
29
+ console.error("[core-db] Configuration connection failed", error);
30
+ throw error;
31
+ }
32
+ }
33
+
34
+ async disconnect(): Promise<void> {
35
+ if (this.client) {
36
+ try {
37
+ await this.client.close();
38
+ this.client = null;
39
+ this.db = null;
40
+ console.info("Configuration MongoDB disconnected successfully");
41
+ } catch (error) {
42
+ console.error("[core-db] Configuration disconnection failed", error);
43
+ throw error;
44
+ }
45
+ }
46
+ }
47
+
48
+ getDb(): Db {
49
+ if (!this.db) {
50
+ throw new Error(
51
+ "Configuration database not initialized. Call connect() first.",
52
+ );
53
+ }
54
+ return this.db;
55
+ }
56
+
57
+ isConnected(): boolean {
58
+ return this.client !== null && this.client !== undefined;
59
+ }
60
+ }
61
+
62
+ export const configurationMongodbClient = new ConfigurationMongoDBClient();
@@ -1,2 +1,2 @@
1
- export * from "./prompts.getters";
2
- export type { Prompt } from "./prompts.types";
1
+ export * from "./prompts.getters";
2
+ export type { Prompt } from "./prompts.types";
@@ -1,49 +1,49 @@
1
- import { getDb } from "../index";
2
- import { Collection, Filter } from "mongodb";
3
- import { Prompt } from "./prompts.types";
4
- import { KnownProductKey } from "../../talkpilot";
5
-
6
- export const getPromptsCollection = (): Collection<Prompt> => {
7
- return getDb().collection<Prompt>("prompts");
8
- };
9
-
10
- /**
11
- * Get a prompt by its unique name.
12
- * @param name prompt name
13
- * @returns the prompt or null if not found
14
- */
15
- export const getPromptByName = async (
16
- name: string,
17
- ): Promise<Prompt | null> => {
18
- return await getPromptsCollection().findOne({ name });
19
- };
20
-
21
- /**
22
- * Find prompts by filter.
23
- * @param filter filter to apply
24
- * @returns array of matching prompts
25
- */
26
- export const findPrompts = async (
27
- filter: Filter<Prompt> = {},
28
- ): Promise<Prompt[]> => {
29
- return await getPromptsCollection().find(filter).toArray();
30
- };
31
-
32
- /**
33
- * Get all prompts.
34
- * @returns array of all prompts
35
- */
36
- export const getAllPrompts = async (): Promise<Prompt[]> => {
37
- return await findPrompts();
38
- };
39
-
40
- /**
41
- * Get all prompts for a given product.
42
- * @param productName product key
43
- * @returns array of matching prompts
44
- */
45
- export const getPromptsByProduct = async (
46
- productName: KnownProductKey,
47
- ): Promise<Prompt[]> => {
48
- return await findPrompts({ productName });
49
- };
1
+ import { getDb } from "../index";
2
+ import { Collection, Filter } from "mongodb";
3
+ import { Prompt } from "./prompts.types";
4
+ import { KnownProductKey } from "../../talkpilot";
5
+
6
+ export const getPromptsCollection = (): Collection<Prompt> => {
7
+ return getDb().collection<Prompt>("prompts");
8
+ };
9
+
10
+ /**
11
+ * Get a prompt by its unique name.
12
+ * @param name prompt name
13
+ * @returns the prompt or null if not found
14
+ */
15
+ export const getPromptByName = async (
16
+ name: string,
17
+ ): Promise<Prompt | null> => {
18
+ return await getPromptsCollection().findOne({ name });
19
+ };
20
+
21
+ /**
22
+ * Find prompts by filter.
23
+ * @param filter filter to apply
24
+ * @returns array of matching prompts
25
+ */
26
+ export const findPrompts = async (
27
+ filter: Filter<Prompt> = {},
28
+ ): Promise<Prompt[]> => {
29
+ return await getPromptsCollection().find(filter).toArray();
30
+ };
31
+
32
+ /**
33
+ * Get all prompts.
34
+ * @returns array of all prompts
35
+ */
36
+ export const getAllPrompts = async (): Promise<Prompt[]> => {
37
+ return await findPrompts();
38
+ };
39
+
40
+ /**
41
+ * Get all prompts for a given product.
42
+ * @param productName product key
43
+ * @returns array of matching prompts
44
+ */
45
+ export const getPromptsByProduct = async (
46
+ productName: KnownProductKey,
47
+ ): Promise<Prompt[]> => {
48
+ return await findPrompts({ productName });
49
+ };