@talkpilot/core-db 1.3.84 → 1.3.86

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 (229) 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 +847 -847
  5. package/dist/talkpilot/flows/flows.schema.d.ts +9 -0
  6. package/dist/talkpilot/flows/flows.schema.d.ts.map +1 -1
  7. package/dist/talkpilot/flows/flows.schema.js +7 -0
  8. package/dist/talkpilot/flows/flows.schema.js.map +1 -1
  9. package/dist/talkpilot/flows/flows.types.d.ts +3 -0
  10. package/dist/talkpilot/flows/flows.types.d.ts.map +1 -1
  11. package/dist/talkpilot/subscriptions/subscriptions.utils.d.ts +4 -0
  12. package/dist/talkpilot/subscriptions/subscriptions.utils.d.ts.map +1 -0
  13. package/dist/talkpilot/subscriptions/subscriptions.utils.js +20 -0
  14. package/dist/talkpilot/subscriptions/subscriptions.utils.js.map +1 -0
  15. package/jest.config.js +20 -20
  16. package/package.json +46 -46
  17. package/src/__tests__/setup.ts +20 -20
  18. package/src/bulkWrite/__tests__/bulkWrite.spec.ts +65 -65
  19. package/src/bulkWrite/bulkWrite.ops.ts +45 -45
  20. package/src/bulkWrite/bulkWrite.types.ts +4 -4
  21. package/src/bulkWrite/index.ts +2 -2
  22. package/src/config.ts +9 -9
  23. package/src/configuration/index.ts +17 -17
  24. package/src/configuration/internalModels/index.ts +3 -3
  25. package/src/configuration/internalModels/internalModels.constants.ts +1 -1
  26. package/src/configuration/internalModels/internalModels.getters.ts +33 -33
  27. package/src/configuration/internalModels/internalModels.types.ts +12 -12
  28. package/src/configuration/models/__tests__/models.getters.spec.ts +67 -67
  29. package/src/configuration/models/index.ts +27 -27
  30. package/src/configuration/models/models.constants.ts +20 -20
  31. package/src/configuration/models/models.getters.ts +71 -71
  32. package/src/configuration/models/models.types.ts +80 -80
  33. package/src/configuration/mongodb-client.ts +62 -62
  34. package/src/configuration/prompts/index.ts +2 -2
  35. package/src/configuration/prompts/prompts.getters.ts +49 -49
  36. package/src/configuration/prompts/prompts.types.ts +11 -11
  37. package/src/connection.ts +81 -81
  38. package/src/index.ts +48 -48
  39. package/src/municipal/__tests__/validation.spec.ts +62 -62
  40. package/src/municipal/cities/cities.getters.ts +50 -50
  41. package/src/municipal/cities/cities.types.ts +11 -11
  42. package/src/municipal/cities/index.ts +2 -2
  43. package/src/municipal/departmentsSubjects/__tests__/departmentsSubjects.spec.ts +272 -272
  44. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +317 -317
  45. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +73 -73
  46. package/src/municipal/departmentsSubjects/index.ts +9 -9
  47. package/src/municipal/index.ts +23 -23
  48. package/src/municipal/mongodb-client.ts +61 -61
  49. package/src/municipal/muniIssues/__tests__/muniIssues.getters.spec.ts +87 -87
  50. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +219 -219
  51. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +93 -93
  52. package/src/municipal/muniIssues/index.ts +24 -24
  53. package/src/municipal/muniIssues/muniIssues.constants.ts +27 -27
  54. package/src/municipal/muniIssues/muniIssues.getters.ts +73 -73
  55. package/src/municipal/muniIssues/muniIssues.schema.ts +85 -85
  56. package/src/municipal/muniIssues/muniIssues.setters.ts +87 -87
  57. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  58. package/src/municipal/muniIssues/muniIssues.types.ts +67 -67
  59. package/src/municipal/residents/__tests__/residents.spec.ts +92 -92
  60. package/src/municipal/residents/index.ts +4 -4
  61. package/src/municipal/residents/residents.constants.ts +2 -2
  62. package/src/municipal/residents/residents.getters.ts +42 -42
  63. package/src/municipal/residents/residents.schema.ts +28 -28
  64. package/src/municipal/residents/residents.types.ts +17 -17
  65. package/src/municipal/streets/__tests__/streets.spec.ts +253 -253
  66. package/src/municipal/streets/index.ts +2 -2
  67. package/src/municipal/streets/streets.getters.ts +140 -140
  68. package/src/municipal/streets/streets.types.ts +19 -19
  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 +99 -99
  77. package/src/municipal/tickets/index.ts +9 -9
  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 +110 -110
  81. package/src/municipal/tickets/tickets.statistics.getters.ts +145 -145
  82. package/src/municipal/tickets/tickets.types.ts +54 -54
  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/callTokenUsage/__tests__/callTokenUsage.getters.spec.ts +57 -57
  96. package/src/talkpilot/callTokenUsage/callTokenUsage.getters.ts +42 -42
  97. package/src/talkpilot/callTokenUsage/callTokenUsage.types.ts +28 -28
  98. package/src/talkpilot/callTokenUsage/index.ts +2 -2
  99. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  100. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +229 -229
  101. package/src/talkpilot/calls/__tests__/calls.spec.ts +519 -519
  102. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +483 -483
  103. package/src/talkpilot/calls/calls.constants.ts +57 -57
  104. package/src/talkpilot/calls/calls.getters.ts +295 -295
  105. package/src/talkpilot/calls/calls.statistics.getters.ts +668 -668
  106. package/src/talkpilot/calls/calls.statistics.types.ts +48 -48
  107. package/src/talkpilot/calls/calls.types.ts +168 -168
  108. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +295 -295
  109. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  110. package/src/talkpilot/calls/index.ts +6 -6
  111. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  112. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  113. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  114. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  115. package/src/talkpilot/clients/__tests__/clients.quota.spec.ts +123 -123
  116. package/src/talkpilot/clients/clients.getters.ts +19 -19
  117. package/src/talkpilot/clients/clients.quota.getters.ts +119 -119
  118. package/src/talkpilot/clients/clients.quota.types.ts +27 -27
  119. package/src/talkpilot/clients/clients.types.ts +18 -18
  120. package/src/talkpilot/clients/index.ts +4 -4
  121. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.getters.spec.ts +423 -423
  122. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +212 -212
  123. package/src/talkpilot/clientsConfig/clientsConfig.constants.ts +2 -2
  124. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +247 -247
  125. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +137 -137
  126. package/src/talkpilot/clientsConfig/index.ts +3 -3
  127. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +217 -217
  128. package/src/talkpilot/contextNotes/contextNotes.getters.ts +85 -85
  129. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  130. package/src/talkpilot/contextNotes/index.ts +2 -2
  131. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +163 -152
  132. package/src/talkpilot/flows/flows.getter.ts +34 -34
  133. package/src/talkpilot/flows/flows.schema.ts +203 -196
  134. package/src/talkpilot/flows/flows.types.ts +221 -220
  135. package/src/talkpilot/flows/index.ts +7 -7
  136. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  137. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  138. package/src/talkpilot/groups/groups.getters.ts +30 -30
  139. package/src/talkpilot/groups/groups.types.ts +29 -29
  140. package/src/talkpilot/groups/index.ts +3 -3
  141. package/src/talkpilot/groups/phone.utils.ts +46 -46
  142. package/src/talkpilot/index.ts +32 -32
  143. package/src/talkpilot/leads/index.ts +2 -2
  144. package/src/talkpilot/leads/leads.getter.ts +6 -6
  145. package/src/talkpilot/leads/leads.schema.ts +33 -33
  146. package/src/talkpilot/leads/leads.types.ts +20 -20
  147. package/src/talkpilot/mongodb-client.ts +78 -78
  148. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +530 -530
  149. package/src/talkpilot/phone_numbers/index.ts +2 -2
  150. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +240 -240
  151. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  152. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  153. package/src/talkpilot/phone_numbers/phone_numbers.utils.ts +9 -9
  154. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  155. package/src/talkpilot/plans/index.ts +2 -2
  156. package/src/talkpilot/plans/plans.getters.ts +132 -132
  157. package/src/talkpilot/plans/plans.types.ts +89 -89
  158. package/src/talkpilot/products/__tests__/products.getters.spec.ts +44 -44
  159. package/src/talkpilot/products/index.ts +2 -2
  160. package/src/talkpilot/products/products.getters.ts +12 -12
  161. package/src/talkpilot/products/products.types.ts +9 -9
  162. package/src/talkpilot/results/index.ts +7 -7
  163. package/src/talkpilot/results/results.getter.ts +39 -39
  164. package/src/talkpilot/results/results.schema.ts +25 -25
  165. package/src/talkpilot/results/results.types.ts +34 -34
  166. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  167. package/src/talkpilot/retry_analyze/index.ts +2 -2
  168. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +84 -84
  169. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  170. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  171. package/src/talkpilot/sessions/index.ts +2 -2
  172. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  173. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  174. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  175. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  176. package/src/talkpilot/subscriptions/index.ts +3 -3
  177. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  178. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  179. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  180. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  181. package/src/talkpilot/utils/query.utils.ts +21 -21
  182. package/src/test-utils/db-utils.ts +33 -33
  183. package/src/test-utils/factories/index.ts +19 -19
  184. package/src/test-utils/factories/municipal/cities.ts +16 -16
  185. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  186. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  187. package/src/test-utils/factories/municipal/residents.ts +20 -20
  188. package/src/test-utils/factories/municipal/streets.ts +22 -22
  189. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  190. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  191. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  192. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  193. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  194. package/src/test-utils/factories/talkpilot/contextNotes.ts +40 -40
  195. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  196. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  197. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  198. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  199. package/src/test-utils/factories/websitalk/knowledgeDocuments.ts +29 -29
  200. package/src/test-utils/factories/websitalk/scanResources.ts +26 -26
  201. package/src/test-utils/factories/websitalk/scans.ts +30 -30
  202. package/src/test-utils/factories/websitalk/websiteUrls.ts +17 -17
  203. package/src/utils/date.utils.ts +126 -126
  204. package/src/utils/shared.types.ts +4 -4
  205. package/src/utils/validation.ts +23 -23
  206. package/src/websitalk/index.ts +18 -18
  207. package/src/websitalk/knowledgeDocuments/__tests__/knowledgeDocuments.spec.ts +238 -238
  208. package/src/websitalk/knowledgeDocuments/index.ts +3 -3
  209. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.constants.ts +26 -26
  210. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.getters.ts +95 -95
  211. package/src/websitalk/knowledgeDocuments/knowledgeDocuments.types.ts +75 -75
  212. package/src/websitalk/mongodb-client.ts +61 -61
  213. package/src/websitalk/scanResources/__tests__/scanResources.spec.ts +267 -267
  214. package/src/websitalk/scanResources/index.ts +4 -4
  215. package/src/websitalk/scanResources/scanResources.constants.ts +60 -60
  216. package/src/websitalk/scanResources/scanResources.getters.ts +128 -128
  217. package/src/websitalk/scanResources/scanResources.types.ts +105 -105
  218. package/src/websitalk/scanResources/scanResources.utils.ts +31 -31
  219. package/src/websitalk/scans/__tests__/scans.spec.ts +362 -362
  220. package/src/websitalk/scans/index.ts +4 -4
  221. package/src/websitalk/scans/scans.constants.ts +18 -18
  222. package/src/websitalk/scans/scans.getters.ts +172 -172
  223. package/src/websitalk/scans/scans.types.ts +58 -58
  224. package/src/websitalk/scans/scans.utils.ts +5 -5
  225. package/src/websitalk/websiteUrls/__tests__/websiteUrls.spec.ts +77 -77
  226. package/src/websitalk/websiteUrls/index.ts +2 -2
  227. package/src/websitalk/websiteUrls/websiteUrls.getters.ts +65 -65
  228. package/src/websitalk/websiteUrls/websiteUrls.types.ts +13 -13
  229. package/tsconfig.json +23 -23
@@ -1,253 +1,253 @@
1
- import {
2
- getStreetsCollection,
3
- getStreetsByCityName,
4
- getStreetById,
5
- getStreetByStreetId,
6
- getStreetByStreetIdAndCity,
7
- createStreet,
8
- bulkWriteStreets,
9
- } from '../streets.getters';
10
- import { createStreet as streetFactory } from '../../../test-utils/factories/municipal/streets';
11
-
12
- const CITY = 'tests' as const;
13
-
14
- describe('Street — isActive field', () => {
15
- describe('persistence', () => {
16
- it('a document inserted without isActive is retrievable and the field is absent', async () => {
17
- const street = streetFactory({ cityName: CITY });
18
- delete (street as Partial<typeof street>).isActive;
19
-
20
- await getStreetsCollection().insertOne(street);
21
-
22
- const saved = await getStreetsCollection().findOne({ _id: street._id });
23
- expect(saved).not.toBeNull();
24
- expect(saved).not.toHaveProperty('isActive');
25
- });
26
-
27
- it('isActive: true is persisted and returned', async () => {
28
- const street = streetFactory({ cityName: CITY, isActive: true });
29
- await getStreetsCollection().insertOne(street);
30
-
31
- const saved = await getStreetsCollection().findOne({ _id: street._id });
32
- expect(saved?.isActive).toBe(true);
33
- });
34
-
35
- it('isActive: false is persisted and returned', async () => {
36
- const street = streetFactory({ cityName: CITY, isActive: false });
37
- await getStreetsCollection().insertOne(street);
38
-
39
- const saved = await getStreetsCollection().findOne({ _id: street._id });
40
- expect(saved?.isActive).toBe(false);
41
- });
42
- });
43
-
44
- describe('createStreet', () => {
45
- it('defaults isActive to true when not provided', async () => {
46
- const data = streetFactory({ cityName: CITY });
47
- delete (data as Partial<typeof data>).isActive;
48
-
49
- const insertedId = await createStreet(data);
50
-
51
- const saved = await getStreetsCollection().findOne({ _id: insertedId });
52
- expect(saved?.isActive).toBe(true);
53
- });
54
-
55
- it('persists isActive: false when explicitly passed', async () => {
56
- const data = streetFactory({ cityName: CITY, isActive: false });
57
- const insertedId = await createStreet(data);
58
-
59
- const saved = await getStreetsCollection().findOne({ _id: insertedId });
60
- expect(saved?.isActive).toBe(false);
61
- });
62
- });
63
-
64
- describe('querying', () => {
65
- it('getStreetsByCityName returns all streets regardless of isActive', async () => {
66
- const active = streetFactory({ cityName: CITY, isActive: true });
67
- const inactive = streetFactory({ cityName: CITY, isActive: false });
68
- const noFlag = streetFactory({ cityName: CITY });
69
- delete (noFlag as Partial<typeof noFlag>).isActive;
70
-
71
- await getStreetsCollection().insertMany([active, inactive, noFlag]);
72
-
73
- const all = await getStreetsByCityName(CITY);
74
- expect(all.length).toBeGreaterThanOrEqual(3);
75
-
76
- const returnedActive = all.find((s) => s._id.equals(active._id));
77
- const returnedInactive = all.find((s) => s._id.equals(inactive._id));
78
- const returnedNoFlag = all.find((s) => s._id.equals(noFlag._id));
79
-
80
- expect(returnedActive?.isActive).toBe(true);
81
- expect(returnedInactive?.isActive).toBe(false);
82
- expect(returnedNoFlag?.isActive).toBeUndefined(); // absent in DB → getter is a pass-through, no normalization
83
- });
84
-
85
- it('getStreetById returns isActive undefined when absent in DB', async () => {
86
- const street = streetFactory({ cityName: CITY });
87
- delete (street as Partial<typeof street>).isActive;
88
- await getStreetsCollection().insertOne(street);
89
-
90
- const result = await getStreetById(street._id.toString());
91
- expect(result?.isActive).toBeUndefined();
92
- });
93
-
94
- it('getStreetById returns isActive: false unchanged', async () => {
95
- const street = streetFactory({ cityName: CITY, isActive: false });
96
- await getStreetsCollection().insertOne(street);
97
-
98
- const result = await getStreetById(street._id.toString());
99
- expect(result?.isActive).toBe(false);
100
- });
101
-
102
- it('getStreetByStreetId returns isActive undefined when absent in DB', async () => {
103
- const street = streetFactory({ cityName: CITY });
104
- delete (street as Partial<typeof street>).isActive;
105
- await getStreetsCollection().insertOne(street);
106
-
107
- const result = await getStreetByStreetId(street.id);
108
- expect(result?.isActive).toBeUndefined();
109
- });
110
-
111
- it('getStreetByStreetIdAndCity returns isActive undefined when absent in DB', async () => {
112
- const street = streetFactory({ cityName: CITY });
113
- delete (street as Partial<typeof street>).isActive;
114
- await getStreetsCollection().insertOne(street);
115
-
116
- const result = await getStreetByStreetIdAndCity(street.id, CITY);
117
- expect(result?.isActive).toBeUndefined();
118
- });
119
-
120
- it('filtering with isActive !== false excludes inactive and includes active and unset documents', async () => {
121
- const active = streetFactory({ cityName: CITY, isActive: true });
122
- const inactive = streetFactory({ cityName: CITY, isActive: false });
123
- const noFlag = streetFactory({ cityName: CITY });
124
- delete (noFlag as Partial<typeof noFlag>).isActive;
125
-
126
- await getStreetsCollection().insertMany([active, inactive, noFlag]);
127
-
128
- // This is the exact filter pattern used by the sync script to skip already-inactive records
129
- const notInactive = await getStreetsCollection()
130
- .find({ cityName: CITY, isActive: { $ne: false } })
131
- .toArray();
132
-
133
- expect(notInactive.map((s) => s._id.toString())).toEqual(
134
- expect.arrayContaining([active._id.toString(), noFlag._id.toString()])
135
- );
136
- expect(notInactive.map((s) => s._id.toString())).not.toContain(inactive._id.toString());
137
- });
138
- });
139
-
140
- describe('updating', () => {
141
- it('isActive can be set to false on an existing active document (deactivation)', async () => {
142
- const street = streetFactory({ cityName: CITY, isActive: true });
143
- await getStreetsCollection().insertOne(street);
144
-
145
- await getStreetsCollection().updateOne(
146
- { _id: street._id },
147
- { $set: { isActive: false, updatedAt: new Date() } }
148
- );
149
-
150
- const updated = await getStreetsCollection().findOne({ _id: street._id });
151
- expect(updated?.isActive).toBe(false);
152
- });
153
-
154
- it('isActive can be set to true on a deactivated document (reactivation)', async () => {
155
- const street = streetFactory({ cityName: CITY, isActive: false });
156
- await getStreetsCollection().insertOne(street);
157
-
158
- await getStreetsCollection().updateOne(
159
- { _id: street._id },
160
- { $set: { isActive: true, updatedAt: new Date() } }
161
- );
162
-
163
- const updated = await getStreetsCollection().findOne({ _id: street._id });
164
- expect(updated?.isActive).toBe(true);
165
- });
166
-
167
- it('deactivating a street does not touch other fields', async () => {
168
- const street = streetFactory({
169
- cityName: CITY,
170
- isActive: true,
171
- name: 'Herzl St',
172
- hints: [{ id: '1', text: 'near the park' }],
173
- });
174
- await getStreetsCollection().insertOne(street);
175
-
176
- await getStreetsCollection().updateOne(
177
- { _id: street._id },
178
- { $set: { isActive: false, updatedAt: new Date() } }
179
- );
180
-
181
- const updated = await getStreetsCollection().findOne({ _id: street._id });
182
- expect(updated?.isActive).toBe(false);
183
- expect(updated?.name).toBe('Herzl St');
184
- expect(updated?.hints).toEqual([{ id: '1', text: 'near the park' }]);
185
- });
186
- });
187
-
188
- describe('bulkWriteStreets', () => {
189
- it('applies upsert and update operations from a single batch', async () => {
190
- const existing = streetFactory({ cityName: CITY, name: 'Old Name' });
191
- await getStreetsCollection().insertOne(existing);
192
-
193
- const result = await bulkWriteStreets(
194
- [
195
- {
196
- updateOne: {
197
- filter: { _id: existing._id },
198
- update: { $set: { name: 'New Name' } },
199
- },
200
- },
201
- {
202
- updateOne: {
203
- filter: { id: 'brand-new-street', cityName: CITY },
204
- update: {
205
- $set: { name: 'Brand New St', cityName: CITY },
206
- $setOnInsert: { id: 'brand-new-street', createdAt: new Date(), isActive: true },
207
- },
208
- upsert: true,
209
- },
210
- },
211
- ],
212
- { ordered: false }
213
- );
214
-
215
- expect(result.modifiedCount).toBe(1);
216
- expect(result.upsertedCount).toBe(1);
217
-
218
- const updated = await getStreetsCollection().findOne({ _id: existing._id });
219
- expect(updated?.name).toBe('New Name');
220
-
221
- const inserted = await getStreetsCollection().findOne({ id: 'brand-new-street', cityName: CITY });
222
- expect(inserted?.name).toBe('Brand New St');
223
- });
224
-
225
- it('propagates a MongoBulkWriteError for an invalid operation, preserving partial results', async () => {
226
- const existing = streetFactory({ cityName: CITY });
227
- await getStreetsCollection().insertOne(existing);
228
-
229
- await expect(
230
- bulkWriteStreets(
231
- [
232
- {
233
- updateOne: {
234
- filter: { _id: existing._id },
235
- update: { $set: { name: 'Valid Update' } },
236
- },
237
- },
238
- {
239
- insertOne: {
240
- // Duplicate _id triggers a write error without aborting the ordered:false batch
241
- document: { ...existing },
242
- },
243
- },
244
- ],
245
- { ordered: false }
246
- )
247
- ).rejects.toMatchObject({ name: 'MongoBulkWriteError' });
248
-
249
- const updated = await getStreetsCollection().findOne({ _id: existing._id });
250
- expect(updated?.name).toBe('Valid Update');
251
- });
252
- });
253
- });
1
+ import {
2
+ getStreetsCollection,
3
+ getStreetsByCityName,
4
+ getStreetById,
5
+ getStreetByStreetId,
6
+ getStreetByStreetIdAndCity,
7
+ createStreet,
8
+ bulkWriteStreets,
9
+ } from '../streets.getters';
10
+ import { createStreet as streetFactory } from '../../../test-utils/factories/municipal/streets';
11
+
12
+ const CITY = 'tests' as const;
13
+
14
+ describe('Street — isActive field', () => {
15
+ describe('persistence', () => {
16
+ it('a document inserted without isActive is retrievable and the field is absent', async () => {
17
+ const street = streetFactory({ cityName: CITY });
18
+ delete (street as Partial<typeof street>).isActive;
19
+
20
+ await getStreetsCollection().insertOne(street);
21
+
22
+ const saved = await getStreetsCollection().findOne({ _id: street._id });
23
+ expect(saved).not.toBeNull();
24
+ expect(saved).not.toHaveProperty('isActive');
25
+ });
26
+
27
+ it('isActive: true is persisted and returned', async () => {
28
+ const street = streetFactory({ cityName: CITY, isActive: true });
29
+ await getStreetsCollection().insertOne(street);
30
+
31
+ const saved = await getStreetsCollection().findOne({ _id: street._id });
32
+ expect(saved?.isActive).toBe(true);
33
+ });
34
+
35
+ it('isActive: false is persisted and returned', async () => {
36
+ const street = streetFactory({ cityName: CITY, isActive: false });
37
+ await getStreetsCollection().insertOne(street);
38
+
39
+ const saved = await getStreetsCollection().findOne({ _id: street._id });
40
+ expect(saved?.isActive).toBe(false);
41
+ });
42
+ });
43
+
44
+ describe('createStreet', () => {
45
+ it('defaults isActive to true when not provided', async () => {
46
+ const data = streetFactory({ cityName: CITY });
47
+ delete (data as Partial<typeof data>).isActive;
48
+
49
+ const insertedId = await createStreet(data);
50
+
51
+ const saved = await getStreetsCollection().findOne({ _id: insertedId });
52
+ expect(saved?.isActive).toBe(true);
53
+ });
54
+
55
+ it('persists isActive: false when explicitly passed', async () => {
56
+ const data = streetFactory({ cityName: CITY, isActive: false });
57
+ const insertedId = await createStreet(data);
58
+
59
+ const saved = await getStreetsCollection().findOne({ _id: insertedId });
60
+ expect(saved?.isActive).toBe(false);
61
+ });
62
+ });
63
+
64
+ describe('querying', () => {
65
+ it('getStreetsByCityName returns all streets regardless of isActive', async () => {
66
+ const active = streetFactory({ cityName: CITY, isActive: true });
67
+ const inactive = streetFactory({ cityName: CITY, isActive: false });
68
+ const noFlag = streetFactory({ cityName: CITY });
69
+ delete (noFlag as Partial<typeof noFlag>).isActive;
70
+
71
+ await getStreetsCollection().insertMany([active, inactive, noFlag]);
72
+
73
+ const all = await getStreetsByCityName(CITY);
74
+ expect(all.length).toBeGreaterThanOrEqual(3);
75
+
76
+ const returnedActive = all.find((s) => s._id.equals(active._id));
77
+ const returnedInactive = all.find((s) => s._id.equals(inactive._id));
78
+ const returnedNoFlag = all.find((s) => s._id.equals(noFlag._id));
79
+
80
+ expect(returnedActive?.isActive).toBe(true);
81
+ expect(returnedInactive?.isActive).toBe(false);
82
+ expect(returnedNoFlag?.isActive).toBeUndefined(); // absent in DB → getter is a pass-through, no normalization
83
+ });
84
+
85
+ it('getStreetById returns isActive undefined when absent in DB', async () => {
86
+ const street = streetFactory({ cityName: CITY });
87
+ delete (street as Partial<typeof street>).isActive;
88
+ await getStreetsCollection().insertOne(street);
89
+
90
+ const result = await getStreetById(street._id.toString());
91
+ expect(result?.isActive).toBeUndefined();
92
+ });
93
+
94
+ it('getStreetById returns isActive: false unchanged', async () => {
95
+ const street = streetFactory({ cityName: CITY, isActive: false });
96
+ await getStreetsCollection().insertOne(street);
97
+
98
+ const result = await getStreetById(street._id.toString());
99
+ expect(result?.isActive).toBe(false);
100
+ });
101
+
102
+ it('getStreetByStreetId returns isActive undefined when absent in DB', async () => {
103
+ const street = streetFactory({ cityName: CITY });
104
+ delete (street as Partial<typeof street>).isActive;
105
+ await getStreetsCollection().insertOne(street);
106
+
107
+ const result = await getStreetByStreetId(street.id);
108
+ expect(result?.isActive).toBeUndefined();
109
+ });
110
+
111
+ it('getStreetByStreetIdAndCity returns isActive undefined when absent in DB', async () => {
112
+ const street = streetFactory({ cityName: CITY });
113
+ delete (street as Partial<typeof street>).isActive;
114
+ await getStreetsCollection().insertOne(street);
115
+
116
+ const result = await getStreetByStreetIdAndCity(street.id, CITY);
117
+ expect(result?.isActive).toBeUndefined();
118
+ });
119
+
120
+ it('filtering with isActive !== false excludes inactive and includes active and unset documents', async () => {
121
+ const active = streetFactory({ cityName: CITY, isActive: true });
122
+ const inactive = streetFactory({ cityName: CITY, isActive: false });
123
+ const noFlag = streetFactory({ cityName: CITY });
124
+ delete (noFlag as Partial<typeof noFlag>).isActive;
125
+
126
+ await getStreetsCollection().insertMany([active, inactive, noFlag]);
127
+
128
+ // This is the exact filter pattern used by the sync script to skip already-inactive records
129
+ const notInactive = await getStreetsCollection()
130
+ .find({ cityName: CITY, isActive: { $ne: false } })
131
+ .toArray();
132
+
133
+ expect(notInactive.map((s) => s._id.toString())).toEqual(
134
+ expect.arrayContaining([active._id.toString(), noFlag._id.toString()])
135
+ );
136
+ expect(notInactive.map((s) => s._id.toString())).not.toContain(inactive._id.toString());
137
+ });
138
+ });
139
+
140
+ describe('updating', () => {
141
+ it('isActive can be set to false on an existing active document (deactivation)', async () => {
142
+ const street = streetFactory({ cityName: CITY, isActive: true });
143
+ await getStreetsCollection().insertOne(street);
144
+
145
+ await getStreetsCollection().updateOne(
146
+ { _id: street._id },
147
+ { $set: { isActive: false, updatedAt: new Date() } }
148
+ );
149
+
150
+ const updated = await getStreetsCollection().findOne({ _id: street._id });
151
+ expect(updated?.isActive).toBe(false);
152
+ });
153
+
154
+ it('isActive can be set to true on a deactivated document (reactivation)', async () => {
155
+ const street = streetFactory({ cityName: CITY, isActive: false });
156
+ await getStreetsCollection().insertOne(street);
157
+
158
+ await getStreetsCollection().updateOne(
159
+ { _id: street._id },
160
+ { $set: { isActive: true, updatedAt: new Date() } }
161
+ );
162
+
163
+ const updated = await getStreetsCollection().findOne({ _id: street._id });
164
+ expect(updated?.isActive).toBe(true);
165
+ });
166
+
167
+ it('deactivating a street does not touch other fields', async () => {
168
+ const street = streetFactory({
169
+ cityName: CITY,
170
+ isActive: true,
171
+ name: 'Herzl St',
172
+ hints: [{ id: '1', text: 'near the park' }],
173
+ });
174
+ await getStreetsCollection().insertOne(street);
175
+
176
+ await getStreetsCollection().updateOne(
177
+ { _id: street._id },
178
+ { $set: { isActive: false, updatedAt: new Date() } }
179
+ );
180
+
181
+ const updated = await getStreetsCollection().findOne({ _id: street._id });
182
+ expect(updated?.isActive).toBe(false);
183
+ expect(updated?.name).toBe('Herzl St');
184
+ expect(updated?.hints).toEqual([{ id: '1', text: 'near the park' }]);
185
+ });
186
+ });
187
+
188
+ describe('bulkWriteStreets', () => {
189
+ it('applies upsert and update operations from a single batch', async () => {
190
+ const existing = streetFactory({ cityName: CITY, name: 'Old Name' });
191
+ await getStreetsCollection().insertOne(existing);
192
+
193
+ const result = await bulkWriteStreets(
194
+ [
195
+ {
196
+ updateOne: {
197
+ filter: { _id: existing._id },
198
+ update: { $set: { name: 'New Name' } },
199
+ },
200
+ },
201
+ {
202
+ updateOne: {
203
+ filter: { id: 'brand-new-street', cityName: CITY },
204
+ update: {
205
+ $set: { name: 'Brand New St', cityName: CITY },
206
+ $setOnInsert: { id: 'brand-new-street', createdAt: new Date(), isActive: true },
207
+ },
208
+ upsert: true,
209
+ },
210
+ },
211
+ ],
212
+ { ordered: false }
213
+ );
214
+
215
+ expect(result.modifiedCount).toBe(1);
216
+ expect(result.upsertedCount).toBe(1);
217
+
218
+ const updated = await getStreetsCollection().findOne({ _id: existing._id });
219
+ expect(updated?.name).toBe('New Name');
220
+
221
+ const inserted = await getStreetsCollection().findOne({ id: 'brand-new-street', cityName: CITY });
222
+ expect(inserted?.name).toBe('Brand New St');
223
+ });
224
+
225
+ it('propagates a MongoBulkWriteError for an invalid operation, preserving partial results', async () => {
226
+ const existing = streetFactory({ cityName: CITY });
227
+ await getStreetsCollection().insertOne(existing);
228
+
229
+ await expect(
230
+ bulkWriteStreets(
231
+ [
232
+ {
233
+ updateOne: {
234
+ filter: { _id: existing._id },
235
+ update: { $set: { name: 'Valid Update' } },
236
+ },
237
+ },
238
+ {
239
+ insertOne: {
240
+ // Duplicate _id triggers a write error without aborting the ordered:false batch
241
+ document: { ...existing },
242
+ },
243
+ },
244
+ ],
245
+ { ordered: false }
246
+ )
247
+ ).rejects.toMatchObject({ name: 'MongoBulkWriteError' });
248
+
249
+ const updated = await getStreetsCollection().findOne({ _id: existing._id });
250
+ expect(updated?.name).toBe('Valid Update');
251
+ });
252
+ });
253
+ });
@@ -1,2 +1,2 @@
1
- export * from "./streets.getters";
2
- export type { Street, StreetDoc, StreetHint } from "./streets.types";
1
+ export * from "./streets.getters";
2
+ export type { Street, StreetDoc, StreetHint } from "./streets.types";