@talkpilot/core-db 1.3.7 → 1.3.9

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 (199) hide show
  1. package/.claude/settings.local.json +11 -0
  2. package/.cursor/rules/development.mdc +65 -65
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +257 -190
  5. package/README_OLD.md +160 -160
  6. package/dist/municipal/tickets/tickets.deprecated.getters.d.ts +12 -0
  7. package/dist/municipal/tickets/tickets.deprecated.getters.d.ts.map +1 -0
  8. package/dist/municipal/tickets/tickets.deprecated.getters.js +131 -0
  9. package/dist/municipal/tickets/tickets.deprecated.getters.js.map +1 -0
  10. package/dist/municipal/tickets/tickets.statistics.dates.d.ts +7 -0
  11. package/dist/municipal/tickets/tickets.statistics.dates.d.ts.map +1 -0
  12. package/dist/municipal/tickets/tickets.statistics.dates.js +40 -0
  13. package/dist/municipal/tickets/tickets.statistics.dates.js.map +1 -0
  14. package/dist/municipal/tickets/tickets.statistics.getters.d.ts +4 -0
  15. package/dist/municipal/tickets/tickets.statistics.getters.d.ts.map +1 -1
  16. package/dist/municipal/tickets/tickets.statistics.getters.js +30 -3
  17. package/dist/municipal/tickets/tickets.statistics.getters.js.map +1 -1
  18. package/dist/municipal/tickets/tickets.statistics.pipeline.d.ts +53 -0
  19. package/dist/municipal/tickets/tickets.statistics.pipeline.d.ts.map +1 -0
  20. package/dist/municipal/tickets/tickets.statistics.pipeline.js +112 -0
  21. package/dist/municipal/tickets/tickets.statistics.pipeline.js.map +1 -0
  22. package/dist/municipal/tickets/tickets.statistics.utils.d.ts +7 -0
  23. package/dist/municipal/tickets/tickets.statistics.utils.d.ts.map +1 -0
  24. package/dist/municipal/tickets/tickets.statistics.utils.js +40 -0
  25. package/dist/municipal/tickets/tickets.statistics.utils.js.map +1 -0
  26. package/dist/talkpilot/calls/calls.statistics.getters.d.ts.map +1 -1
  27. package/dist/talkpilot/calls/calls.statistics.getters.js +18 -18
  28. package/dist/talkpilot/calls/calls.statistics.getters.js.map +1 -1
  29. package/dist/talkpilot/calls/calls.statistics.ticketScope.d.ts +12 -0
  30. package/dist/talkpilot/calls/calls.statistics.ticketScope.d.ts.map +1 -0
  31. package/dist/talkpilot/calls/calls.statistics.ticketScope.js +37 -0
  32. package/dist/talkpilot/calls/calls.statistics.ticketScope.js.map +1 -0
  33. package/dist/talkpilot/calls/calls.statistics.tickets.d.ts +17 -0
  34. package/dist/talkpilot/calls/calls.statistics.tickets.d.ts.map +1 -0
  35. package/dist/talkpilot/calls/calls.statistics.tickets.js +33 -0
  36. package/dist/talkpilot/calls/calls.statistics.tickets.js.map +1 -0
  37. package/dist/talkpilot/calls/calls.statistics.types.d.ts +4 -1
  38. package/dist/talkpilot/calls/calls.statistics.types.d.ts.map +1 -1
  39. package/dist/utils/statistics.aggregation.d.ts +20 -0
  40. package/dist/utils/statistics.aggregation.d.ts.map +1 -0
  41. package/dist/utils/statistics.aggregation.js +43 -0
  42. package/dist/utils/statistics.aggregation.js.map +1 -0
  43. package/jest.config.js +20 -20
  44. package/package.json +46 -46
  45. package/src/__tests__/setup.ts +20 -20
  46. package/src/connection.ts +54 -54
  47. package/src/index.ts +26 -26
  48. package/src/municipal/__tests__/validation.spec.ts +62 -62
  49. package/src/municipal/cities/cities.getters.ts +50 -50
  50. package/src/municipal/cities/cities.types.ts +11 -11
  51. package/src/municipal/cities/index.ts +2 -2
  52. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +282 -282
  53. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +72 -72
  54. package/src/municipal/departmentsSubjects/index.ts +9 -9
  55. package/src/municipal/index.ts +22 -22
  56. package/src/municipal/mongodb-client.ts +61 -61
  57. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +92 -92
  58. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  59. package/src/municipal/muniIssues/index.ts +17 -17
  60. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  61. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  62. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  63. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  64. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  65. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  66. package/src/municipal/streets/index.ts +2 -2
  67. package/src/municipal/streets/streets.getters.ts +125 -125
  68. package/src/municipal/streets/streets.types.ts +18 -18
  69. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  70. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  71. package/src/municipal/systemInstructions/index.ts +7 -7
  72. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  73. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  74. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  75. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  76. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +68 -51
  77. package/src/municipal/tickets/index.ts +3 -3
  78. package/src/municipal/tickets/tickets.constants.ts +8 -8
  79. package/src/municipal/tickets/tickets.getters.ts +121 -121
  80. package/src/municipal/tickets/tickets.statistics.aggregation.ts +96 -96
  81. package/src/municipal/tickets/tickets.statistics.getters.ts +109 -71
  82. package/src/municipal/tickets/tickets.types.ts +53 -53
  83. package/src/municipal/utils/types.ts +11 -11
  84. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  85. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  86. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  87. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  88. package/src/talkpilot/agents/agents.getters.ts +34 -34
  89. package/src/talkpilot/agents/agents.types.ts +14 -14
  90. package/src/talkpilot/agents/index.ts +2 -2
  91. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  92. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  93. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  94. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  95. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  96. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +149 -149
  97. package/src/talkpilot/calls/__tests__/calls.spec.ts +270 -270
  98. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +375 -344
  99. package/src/talkpilot/calls/calls.constants.ts +20 -20
  100. package/src/talkpilot/calls/calls.getters.ts +248 -248
  101. package/src/talkpilot/calls/calls.statistics.getters.ts +590 -587
  102. package/src/talkpilot/calls/calls.statistics.types.ts +47 -44
  103. package/src/talkpilot/calls/calls.types.ts +119 -119
  104. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +292 -292
  105. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  106. package/src/talkpilot/calls/index.ts +6 -6
  107. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  108. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  109. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  110. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  111. package/src/talkpilot/clients/clients.getters.ts +16 -16
  112. package/src/talkpilot/clients/clients.types.ts +14 -14
  113. package/src/talkpilot/clients/index.ts +2 -2
  114. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +53 -53
  115. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +190 -190
  116. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +55 -55
  117. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +127 -127
  118. package/src/talkpilot/clientsConfig/index.ts +2 -2
  119. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +176 -176
  120. package/src/talkpilot/contextNotes/contextNotes.getters.ts +86 -86
  121. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  122. package/src/talkpilot/contextNotes/index.ts +2 -2
  123. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +96 -96
  124. package/src/talkpilot/flows/flows.getter.ts +14 -14
  125. package/src/talkpilot/flows/flows.schema.ts +154 -154
  126. package/src/talkpilot/flows/flows.types.ts +187 -187
  127. package/src/talkpilot/flows/index.ts +2 -2
  128. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  129. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  130. package/src/talkpilot/groups/groups.getters.ts +30 -30
  131. package/src/talkpilot/groups/groups.types.ts +29 -29
  132. package/src/talkpilot/groups/index.ts +3 -3
  133. package/src/talkpilot/groups/phone.utils.ts +46 -46
  134. package/src/talkpilot/index.ts +31 -31
  135. package/src/talkpilot/leads/index.ts +2 -2
  136. package/src/talkpilot/leads/leads.getter.ts +6 -6
  137. package/src/talkpilot/leads/leads.schema.ts +33 -33
  138. package/src/talkpilot/leads/leads.types.ts +20 -20
  139. package/src/talkpilot/mongodb-client.ts +78 -78
  140. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +252 -252
  141. package/src/talkpilot/phone_numbers/index.ts +2 -2
  142. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +158 -158
  143. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  144. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  145. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  146. package/src/talkpilot/plans/index.ts +2 -2
  147. package/src/talkpilot/plans/plans.getters.ts +132 -132
  148. package/src/talkpilot/plans/plans.types.ts +89 -89
  149. package/src/talkpilot/products/__tests__/products.getters.spec.ts +45 -45
  150. package/src/talkpilot/products/index.ts +2 -2
  151. package/src/talkpilot/products/products.getters.ts +12 -12
  152. package/src/talkpilot/products/products.types.ts +9 -9
  153. package/src/talkpilot/results/index.ts +7 -7
  154. package/src/talkpilot/results/results.getter.ts +39 -39
  155. package/src/talkpilot/results/results.schema.ts +25 -25
  156. package/src/talkpilot/results/results.types.ts +34 -34
  157. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  158. package/src/talkpilot/retry_analyze/index.ts +2 -2
  159. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  160. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  161. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  162. package/src/talkpilot/sessions/index.ts +2 -2
  163. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  164. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  165. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  166. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  167. package/src/talkpilot/subscriptions/index.ts +3 -3
  168. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  169. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  170. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  171. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  172. package/src/talkpilot/utils/query.utils.ts +21 -21
  173. package/src/test-utils/db-utils.ts +26 -26
  174. package/src/test-utils/factories/index.ts +15 -15
  175. package/src/test-utils/factories/municipal/cities.ts +16 -16
  176. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  177. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  178. package/src/test-utils/factories/municipal/streets.ts +22 -22
  179. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  180. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  181. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  182. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  183. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  184. package/src/test-utils/factories/talkpilot/contextNotes.ts +33 -33
  185. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  186. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  187. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  188. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  189. package/src/test-utils/factories/websitalk/scans.ts +23 -23
  190. package/src/utils/date.utils.ts +116 -116
  191. package/src/utils/shared.types.ts +4 -4
  192. package/src/utils/validation.ts +23 -23
  193. package/src/websitalk/index.ts +15 -15
  194. package/src/websitalk/mongodb-client.ts +61 -61
  195. package/src/websitalk/scans/__tests__/scans.spec.ts +218 -218
  196. package/src/websitalk/scans/index.ts +2 -2
  197. package/src/websitalk/scans/scans.getters.ts +113 -113
  198. package/src/websitalk/scans/scans.types.ts +53 -53
  199. package/tsconfig.json +23 -23
@@ -1,72 +1,72 @@
1
- import { ObjectId, WithId } from "mongodb";
2
- import { Request } from "express";
3
- import { ClientConfigDoc, Products } from "../../talkpilot";
4
- import { CityName } from "../utils/types";
5
-
6
- export type DepartmentSubject = {
7
- _id: ObjectId;
8
- createdAt: Date;
9
- updatedAt: Date;
10
- subjectName: string; // e.g. "אחזקה- איטום"
11
- subject_id: string; // e.g. "6121"
12
- sub_subject_name: string; // e.g. "איטום"
13
- sub_subject_id: string; // e.g. "6123"
14
- sub_subject_name2?: string; // e.g. "ניקיון באגם" (level 3 - grandchild)
15
- sub_subject_id2?: string; // e.g. "2898" (level 3 - grandchild)
16
- descriptions: string[]; // array of guideline / example descriptions
17
- embedding_text?: string; // the text used to create the embedding
18
- embedding?: number[]; // length should match embedding_dims (e.g. 1536)
19
- embedding_model?: string; // e.g. "text-embedding-3-small"
20
- embedding_dims?: number; // e.g. 1536
21
- cityName: CityName;
22
- guidelines?: string | null;
23
- instructions?: Instruction[];
24
- communications?: Communication[];
25
- sla?: number;
26
- };
27
-
28
- export interface Instruction {
29
- id: number;
30
- instruction: string;
31
- }
32
-
33
- export interface Communication {
34
- id: number;
35
- type: CommunicationType;
36
- message_text?: string;
37
- template_id?: string;
38
- to?: string;
39
- is_deleted?: boolean;
40
- }
41
-
42
- export type DepartmentSubjectDoc = WithId<DepartmentSubject>;
43
-
44
- /**
45
- * Vector search result from MongoDB
46
- */
47
- export type VectorSearchResult = {
48
- subjectName: string;
49
- subject_id: number;
50
- sub_subject_id: string;
51
- sub_subject_id2?: string | null;
52
- sub_subject_name: string;
53
- sub_subject_name2?: string | null;
54
- descriptions?: string[];
55
- guidelines?: string | null;
56
- instructions?: string | null;
57
- score?: number;
58
- };
59
-
60
- export type CommunicationType = "free_text_sms" | "upload_url_sms";
61
-
62
- /**
63
- * Extended Express Request type with client configuration
64
- */
65
- export type RequestWithClientConfig = Request & {
66
- uid: string;
67
- clientConfig: ClientConfigDoc<Products>;
68
- isGuest: boolean;
69
- claims: Record<string, unknown>;
70
- crmName?: string;
71
- callSid?: string;
72
- };
1
+ import { ObjectId, WithId } from "mongodb";
2
+ import { Request } from "express";
3
+ import { ClientConfigDoc, Products } from "../../talkpilot";
4
+ import { CityName } from "../utils/types";
5
+
6
+ export type DepartmentSubject = {
7
+ _id: ObjectId;
8
+ createdAt: Date;
9
+ updatedAt: Date;
10
+ subjectName: string; // e.g. "אחזקה- איטום"
11
+ subject_id: string; // e.g. "6121"
12
+ sub_subject_name: string; // e.g. "איטום"
13
+ sub_subject_id: string; // e.g. "6123"
14
+ sub_subject_name2?: string; // e.g. "ניקיון באגם" (level 3 - grandchild)
15
+ sub_subject_id2?: string; // e.g. "2898" (level 3 - grandchild)
16
+ descriptions: string[]; // array of guideline / example descriptions
17
+ embedding_text?: string; // the text used to create the embedding
18
+ embedding?: number[]; // length should match embedding_dims (e.g. 1536)
19
+ embedding_model?: string; // e.g. "text-embedding-3-small"
20
+ embedding_dims?: number; // e.g. 1536
21
+ cityName: CityName;
22
+ guidelines?: string | null;
23
+ instructions?: Instruction[];
24
+ communications?: Communication[];
25
+ sla?: number;
26
+ };
27
+
28
+ export interface Instruction {
29
+ id: number;
30
+ instruction: string;
31
+ }
32
+
33
+ export interface Communication {
34
+ id: number;
35
+ type: CommunicationType;
36
+ message_text?: string;
37
+ template_id?: string;
38
+ to?: string;
39
+ is_deleted?: boolean;
40
+ }
41
+
42
+ export type DepartmentSubjectDoc = WithId<DepartmentSubject>;
43
+
44
+ /**
45
+ * Vector search result from MongoDB
46
+ */
47
+ export type VectorSearchResult = {
48
+ subjectName: string;
49
+ subject_id: number;
50
+ sub_subject_id: string;
51
+ sub_subject_id2?: string | null;
52
+ sub_subject_name: string;
53
+ sub_subject_name2?: string | null;
54
+ descriptions?: string[];
55
+ guidelines?: string | null;
56
+ instructions?: string | null;
57
+ score?: number;
58
+ };
59
+
60
+ export type CommunicationType = "free_text_sms" | "upload_url_sms";
61
+
62
+ /**
63
+ * Extended Express Request type with client configuration
64
+ */
65
+ export type RequestWithClientConfig = Request & {
66
+ uid: string;
67
+ clientConfig: ClientConfigDoc<Products>;
68
+ isGuest: boolean;
69
+ claims: Record<string, unknown>;
70
+ crmName?: string;
71
+ callSid?: string;
72
+ };
@@ -1,9 +1,9 @@
1
- export * from "./departmentsSubjects.getters";
2
- export type {
3
- DepartmentSubject,
4
- DepartmentSubjectDoc,
5
- VectorSearchResult,
6
- RequestWithClientConfig,
7
- Communication,
8
- Instruction,
9
- } from "./departmentsSubjects.types";
1
+ export * from "./departmentsSubjects.getters";
2
+ export type {
3
+ DepartmentSubject,
4
+ DepartmentSubjectDoc,
5
+ VectorSearchResult,
6
+ RequestWithClientConfig,
7
+ Communication,
8
+ Instruction,
9
+ } from "./departmentsSubjects.types";
@@ -1,22 +1,22 @@
1
- import { Db, ObjectId as MongoObjectId } from "mongodb";
2
-
3
- export * from "./cities";
4
- export * from "./streets";
5
- export * from "./departmentsSubjects";
6
- export * from "./tickets";
7
- export * from "./systemInstructions";
8
- export * from "./muniIssues";
9
- export * from "./utils/types";
10
- export { CityName } from "./utils/types";
11
- export { municipalDataMongodbClient } from "./mongodb-client";
12
-
13
- let db: Db;
14
- export const setDb = (d: Db) => {
15
- db = d;
16
- };
17
-
18
- export const getDb = (): Db => {
19
- if (!db) throw new Error("Municipal Data DB not initialised");
20
- return db;
21
- };
22
- export const ObjectId = MongoObjectId;
1
+ import { Db, ObjectId as MongoObjectId } from "mongodb";
2
+
3
+ export * from "./cities";
4
+ export * from "./streets";
5
+ export * from "./departmentsSubjects";
6
+ export * from "./tickets";
7
+ export * from "./systemInstructions";
8
+ export * from "./muniIssues";
9
+ export * from "./utils/types";
10
+ export { CityName } from "./utils/types";
11
+ export { municipalDataMongodbClient } from "./mongodb-client";
12
+
13
+ let db: Db;
14
+ export const setDb = (d: Db) => {
15
+ db = d;
16
+ };
17
+
18
+ export const getDb = (): Db => {
19
+ if (!db) throw new Error("Municipal Data DB not initialised");
20
+ return db;
21
+ };
22
+ export const ObjectId = MongoObjectId;
@@ -1,61 +1,61 @@
1
- import { MongoClient, Db } from "mongodb";
2
- import { setDb } from "./index";
3
- import { validateConfig, validateMongoUri } from "../utils/validation";
4
-
5
- class MunicipalDataMongoDBClient {
6
- private client: MongoClient | null = null;
7
- private db: Db | null = null;
8
- private readonly defaultDbName = "municipal-data";
9
-
10
- async connect(uri?: string, dbName?: string): Promise<void> {
11
- if (this.client) {
12
- return;
13
- }
14
-
15
- const mongodbUri = uri || process.env.MONGO_URI || process.env.MONGODB_URI;
16
- validateConfig("MONGO_URI", mongodbUri);
17
- validateMongoUri(mongodbUri!);
18
-
19
- try {
20
- this.client = new MongoClient(mongodbUri!);
21
- await this.client.connect();
22
- const targetDbName =
23
- dbName || process.env.MUNICIPAL_DB_NAME || this.defaultDbName;
24
- this.db = this.client.db(targetDbName);
25
- setDb(this.db);
26
- console.info(`[core-db] Municipal MongoDB connected: ${targetDbName}`);
27
- } catch (error) {
28
- console.error("[core-db] Municipal connection failed", error);
29
- throw error;
30
- }
31
- }
32
-
33
- async disconnect(): Promise<void> {
34
- if (this.client) {
35
- try {
36
- await this.client.close();
37
- this.client = null;
38
- this.db = null;
39
- console.info("Municipal Data MongoDB disconnected successfully");
40
- } catch (error) {
41
- console.error("[core-db] Municipal disconnection failed", error);
42
- throw error;
43
- }
44
- }
45
- }
46
-
47
- getDb(): Db {
48
- if (!this.db) {
49
- throw new Error(
50
- "Municipal Data database not initialized. Call connect() first.",
51
- );
52
- }
53
- return this.db;
54
- }
55
-
56
- isConnected(): boolean {
57
- return this.client !== null && this.client !== undefined;
58
- }
59
- }
60
-
61
- export const municipalDataMongodbClient = new MunicipalDataMongoDBClient();
1
+ import { MongoClient, Db } from "mongodb";
2
+ import { setDb } from "./index";
3
+ import { validateConfig, validateMongoUri } from "../utils/validation";
4
+
5
+ class MunicipalDataMongoDBClient {
6
+ private client: MongoClient | null = null;
7
+ private db: Db | null = null;
8
+ private readonly defaultDbName = "municipal-data";
9
+
10
+ async connect(uri?: string, dbName?: string): Promise<void> {
11
+ if (this.client) {
12
+ return;
13
+ }
14
+
15
+ const mongodbUri = uri || process.env.MONGO_URI || process.env.MONGODB_URI;
16
+ validateConfig("MONGO_URI", mongodbUri);
17
+ validateMongoUri(mongodbUri!);
18
+
19
+ try {
20
+ this.client = new MongoClient(mongodbUri!);
21
+ await this.client.connect();
22
+ const targetDbName =
23
+ dbName || process.env.MUNICIPAL_DB_NAME || this.defaultDbName;
24
+ this.db = this.client.db(targetDbName);
25
+ setDb(this.db);
26
+ console.info(`[core-db] Municipal MongoDB connected: ${targetDbName}`);
27
+ } catch (error) {
28
+ console.error("[core-db] Municipal connection failed", error);
29
+ throw error;
30
+ }
31
+ }
32
+
33
+ async disconnect(): Promise<void> {
34
+ if (this.client) {
35
+ try {
36
+ await this.client.close();
37
+ this.client = null;
38
+ this.db = null;
39
+ console.info("Municipal Data MongoDB disconnected successfully");
40
+ } catch (error) {
41
+ console.error("[core-db] Municipal disconnection failed", error);
42
+ throw error;
43
+ }
44
+ }
45
+ }
46
+
47
+ getDb(): Db {
48
+ if (!this.db) {
49
+ throw new Error(
50
+ "Municipal Data database not initialized. Call connect() first.",
51
+ );
52
+ }
53
+ return this.db;
54
+ }
55
+
56
+ isConnected(): boolean {
57
+ return this.client !== null && this.client !== undefined;
58
+ }
59
+ }
60
+
61
+ export const municipalDataMongodbClient = new MunicipalDataMongoDBClient();
@@ -1,92 +1,92 @@
1
- import { createMuniIssue } from "../muniIssues.setters";
2
- import {
3
- generateMuniIssueId,
4
- getMuniIssueById,
5
- getMuniIssueByJiraKey,
6
- } from "../muniIssues.getters";
7
- import { createMuniIssueInput } from "../../../test-utils/factories";
8
-
9
- describe("muniIssues setters", () => {
10
- describe("createMuniIssue", () => {
11
- it("should insert a well-formed document with createdAt and nested content/jira", async () => {
12
- const input = createMuniIssueInput();
13
- const id = generateMuniIssueId();
14
-
15
- const insertedId = await createMuniIssue(input, id);
16
-
17
- const saved = await getMuniIssueById(insertedId.toString());
18
- expect(saved).toMatchObject({
19
- callSid: input.callSid,
20
- clientId: input.clientId,
21
- cityName: input.cityName,
22
- issueContent: input.issueContent,
23
- jira: input.jira,
24
- });
25
- expect(saved?.createdAt).toBeInstanceOf(Date);
26
- });
27
-
28
- it("should default jira.syncStatus to created when not provided", async () => {
29
- const id = generateMuniIssueId();
30
-
31
- const insertedId = await createMuniIssue(
32
- createMuniIssueInput({ jira: { key: "CP-9" } }),
33
- id,
34
- );
35
-
36
- const saved = await getMuniIssueById(insertedId.toString());
37
- expect(saved?.jira.syncStatus).toBe("created");
38
- });
39
-
40
- it("should store long issueDescription and desiredBehavior in full", async () => {
41
- const issueDescription = "a".repeat(2000);
42
- const desiredBehavior = "b".repeat(2000);
43
- const id = generateMuniIssueId();
44
-
45
- const insertedId = await createMuniIssue(
46
- createMuniIssueInput({
47
- issueContent: {
48
- issuerName: "Dana",
49
- issuerRole: "Agent",
50
- issueDescription,
51
- desiredBehavior,
52
- },
53
- }),
54
- id,
55
- );
56
-
57
- const saved = await getMuniIssueById(insertedId.toString());
58
- expect(saved?.issueContent.issueDescription).toHaveLength(2000);
59
- expect(saved?.issueContent.desiredBehavior).toBe(desiredBehavior);
60
- });
61
-
62
- it("should persist the caller-supplied _id so the Jira ticket can link back", async () => {
63
- const id = generateMuniIssueId();
64
-
65
- const insertedId = await createMuniIssue(createMuniIssueInput(), id);
66
-
67
- expect(insertedId.toString()).toBe(id.toString());
68
- expect(await getMuniIssueById(id.toString())).not.toBeNull();
69
- });
70
- });
71
-
72
- describe("getMuniIssueById", () => {
73
- it("should return null for an unknown or malformed id instead of throwing", async () => {
74
- expect(await getMuniIssueById(generateMuniIssueId().toString())).toBeNull();
75
- expect(await getMuniIssueById("not-a-valid-id")).toBeNull();
76
- });
77
- });
78
-
79
- describe("getMuniIssueByJiraKey", () => {
80
- it("should find the issue with the given Jira key", async () => {
81
- await createMuniIssue(
82
- createMuniIssueInput({ jira: { key: "CP-555" } }),
83
- generateMuniIssueId(),
84
- );
85
-
86
- const found = await getMuniIssueByJiraKey("CP-555");
87
-
88
- expect(found?.jira.key).toBe("CP-555");
89
- expect(await getMuniIssueByJiraKey("CP-nope")).toBeNull();
90
- });
91
- });
92
- });
1
+ import { createMuniIssue } from "../muniIssues.setters";
2
+ import {
3
+ generateMuniIssueId,
4
+ getMuniIssueById,
5
+ getMuniIssueByJiraKey,
6
+ } from "../muniIssues.getters";
7
+ import { createMuniIssueInput } from "../../../test-utils/factories";
8
+
9
+ describe("muniIssues setters", () => {
10
+ describe("createMuniIssue", () => {
11
+ it("should insert a well-formed document with createdAt and nested content/jira", async () => {
12
+ const input = createMuniIssueInput();
13
+ const id = generateMuniIssueId();
14
+
15
+ const insertedId = await createMuniIssue(input, id);
16
+
17
+ const saved = await getMuniIssueById(insertedId.toString());
18
+ expect(saved).toMatchObject({
19
+ callSid: input.callSid,
20
+ clientId: input.clientId,
21
+ cityName: input.cityName,
22
+ issueContent: input.issueContent,
23
+ jira: input.jira,
24
+ });
25
+ expect(saved?.createdAt).toBeInstanceOf(Date);
26
+ });
27
+
28
+ it("should default jira.syncStatus to created when not provided", async () => {
29
+ const id = generateMuniIssueId();
30
+
31
+ const insertedId = await createMuniIssue(
32
+ createMuniIssueInput({ jira: { key: "CP-9" } }),
33
+ id,
34
+ );
35
+
36
+ const saved = await getMuniIssueById(insertedId.toString());
37
+ expect(saved?.jira.syncStatus).toBe("created");
38
+ });
39
+
40
+ it("should store long issueDescription and desiredBehavior in full", async () => {
41
+ const issueDescription = "a".repeat(2000);
42
+ const desiredBehavior = "b".repeat(2000);
43
+ const id = generateMuniIssueId();
44
+
45
+ const insertedId = await createMuniIssue(
46
+ createMuniIssueInput({
47
+ issueContent: {
48
+ issuerName: "Dana",
49
+ issuerRole: "Agent",
50
+ issueDescription,
51
+ desiredBehavior,
52
+ },
53
+ }),
54
+ id,
55
+ );
56
+
57
+ const saved = await getMuniIssueById(insertedId.toString());
58
+ expect(saved?.issueContent.issueDescription).toHaveLength(2000);
59
+ expect(saved?.issueContent.desiredBehavior).toBe(desiredBehavior);
60
+ });
61
+
62
+ it("should persist the caller-supplied _id so the Jira ticket can link back", async () => {
63
+ const id = generateMuniIssueId();
64
+
65
+ const insertedId = await createMuniIssue(createMuniIssueInput(), id);
66
+
67
+ expect(insertedId.toString()).toBe(id.toString());
68
+ expect(await getMuniIssueById(id.toString())).not.toBeNull();
69
+ });
70
+ });
71
+
72
+ describe("getMuniIssueById", () => {
73
+ it("should return null for an unknown or malformed id instead of throwing", async () => {
74
+ expect(await getMuniIssueById(generateMuniIssueId().toString())).toBeNull();
75
+ expect(await getMuniIssueById("not-a-valid-id")).toBeNull();
76
+ });
77
+ });
78
+
79
+ describe("getMuniIssueByJiraKey", () => {
80
+ it("should find the issue with the given Jira key", async () => {
81
+ await createMuniIssue(
82
+ createMuniIssueInput({ jira: { key: "CP-555" } }),
83
+ generateMuniIssueId(),
84
+ );
85
+
86
+ const found = await getMuniIssueByJiraKey("CP-555");
87
+
88
+ expect(found?.jira.key).toBe("CP-555");
89
+ expect(await getMuniIssueByJiraKey("CP-nope")).toBeNull();
90
+ });
91
+ });
92
+ });