dt-common-device 1.3.0 → 2.0.0

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 (132) hide show
  1. package/TROUBLESHOOTING.md +184 -0
  2. package/dist/config/config.d.ts +9 -2
  3. package/dist/config/config.js +97 -14
  4. package/dist/constants/Event.d.ts +75 -0
  5. package/dist/constants/Event.js +78 -0
  6. package/dist/db/db.d.ts +1 -0
  7. package/dist/db/db.js +18 -2
  8. package/dist/device/local/entities/AlertBuilder.d.ts +87 -0
  9. package/dist/device/local/entities/AlertBuilder.example.d.ts +11 -0
  10. package/dist/device/local/entities/AlertBuilder.example.js +117 -0
  11. package/dist/device/local/entities/AlertBuilder.js +179 -0
  12. package/dist/device/local/entities/IssueBuilder.d.ts +109 -0
  13. package/dist/device/local/entities/IssueBuilder.example.d.ts +16 -0
  14. package/dist/device/local/entities/IssueBuilder.example.js +196 -0
  15. package/dist/device/local/entities/IssueBuilder.js +237 -0
  16. package/dist/device/local/entities/index.d.ts +2 -0
  17. package/dist/device/local/entities/index.js +7 -0
  18. package/dist/device/local/interfaces/IDevice.d.ts +10 -9
  19. package/dist/device/local/interfaces/IDevice.js +7 -0
  20. package/dist/device/local/models/Alert.model.d.ts +28 -0
  21. package/dist/device/local/models/Alert.model.js +222 -0
  22. package/dist/device/local/models/Issue.model.d.ts +28 -0
  23. package/dist/device/local/models/Issue.model.js +260 -0
  24. package/dist/device/local/repository/Alert.repository.d.ts +106 -0
  25. package/dist/device/local/repository/Alert.repository.js +374 -0
  26. package/dist/device/local/repository/Device.repository.d.ts +10 -2
  27. package/dist/device/local/repository/Device.repository.js +153 -30
  28. package/dist/device/local/repository/Hub.repository.d.ts +1 -1
  29. package/dist/device/local/repository/Hub.repository.js +60 -18
  30. package/dist/device/local/repository/Issue.repository.d.ts +113 -0
  31. package/dist/device/local/repository/Issue.repository.js +401 -0
  32. package/dist/device/local/repository/Schedule.repository.d.ts +1 -1
  33. package/dist/device/local/repository/Schedule.repository.js +14 -18
  34. package/dist/device/local/services/Alert.service.d.ts +135 -5
  35. package/dist/device/local/services/Alert.service.js +471 -7
  36. package/dist/device/local/services/AlertService.example.d.ts +55 -0
  37. package/dist/device/local/services/AlertService.example.js +148 -0
  38. package/dist/device/local/services/Device.service.d.ts +8 -5
  39. package/dist/device/local/services/Device.service.js +58 -40
  40. package/dist/device/local/services/Issue.service.d.ts +168 -0
  41. package/dist/device/local/services/Issue.service.js +642 -0
  42. package/dist/device/local/services/IssueService.example.d.ts +68 -0
  43. package/dist/device/local/services/IssueService.example.js +177 -0
  44. package/dist/device/local/services/index.d.ts +7 -5
  45. package/dist/device/local/services/index.js +21 -11
  46. package/dist/events/BaseEventHandler.d.ts +43 -0
  47. package/dist/events/BaseEventHandler.js +111 -0
  48. package/dist/events/BaseEventTransformer.d.ts +26 -0
  49. package/dist/events/BaseEventTransformer.js +72 -0
  50. package/dist/events/DeviceEventHandler.d.ts +15 -0
  51. package/dist/events/DeviceEventHandler.js +152 -0
  52. package/dist/events/DeviceEventTransformerFactory.d.ts +27 -0
  53. package/dist/events/DeviceEventTransformerFactory.js +116 -0
  54. package/dist/events/EventHandler.d.ts +11 -0
  55. package/dist/events/EventHandler.js +106 -0
  56. package/dist/events/EventHandlerOrchestrator.d.ts +35 -0
  57. package/dist/events/EventHandlerOrchestrator.js +141 -0
  58. package/dist/events/EventProcessingService.d.ts +43 -0
  59. package/dist/events/EventProcessingService.js +243 -0
  60. package/dist/events/InternalEventSubscription.d.ts +44 -0
  61. package/dist/events/InternalEventSubscription.js +152 -0
  62. package/dist/events/index.d.ts +9 -0
  63. package/dist/events/index.js +21 -0
  64. package/dist/events/interfaces/DeviceEvent.d.ts +48 -0
  65. package/dist/events/interfaces/DeviceEvent.js +2 -0
  66. package/dist/events/interfaces/IEventHandler.d.ts +23 -0
  67. package/dist/events/interfaces/IEventHandler.js +2 -0
  68. package/dist/events/interfaces/IEventTransformer.d.ts +7 -0
  69. package/dist/events/interfaces/IEventTransformer.js +2 -0
  70. package/dist/events/interfaces/IInternalEvent.d.ts +42 -0
  71. package/dist/events/interfaces/IInternalEvent.js +2 -0
  72. package/dist/events/interfaces/index.d.ts +4 -0
  73. package/dist/events/interfaces/index.js +20 -0
  74. package/dist/index.d.ts +6 -2
  75. package/dist/index.js +9 -2
  76. package/dist/types/alert.types.d.ts +57 -0
  77. package/dist/types/alert.types.js +22 -0
  78. package/dist/types/config.types.d.ts +15 -4
  79. package/dist/types/index.d.ts +2 -0
  80. package/dist/types/index.js +2 -0
  81. package/dist/types/issue.types.d.ts +90 -0
  82. package/dist/types/issue.types.js +40 -0
  83. package/dist/utils/http-utils.d.ts +13 -0
  84. package/dist/utils/http-utils.js +117 -0
  85. package/package.json +2 -1
  86. package/src/config/config.ts +117 -14
  87. package/src/{device/local/events/Events.ts → constants/Event.ts} +34 -13
  88. package/src/db/db.ts +14 -5
  89. package/src/device/local/entities/AlertBuilder.example.ts +126 -0
  90. package/src/device/local/entities/AlertBuilder.ts +202 -0
  91. package/src/device/local/entities/IssueBuilder.example.ts +210 -0
  92. package/src/device/local/entities/IssueBuilder.ts +263 -0
  93. package/src/device/local/entities/README.md +173 -0
  94. package/src/device/local/entities/index.ts +2 -0
  95. package/src/device/local/interfaces/IDevice.ts +11 -9
  96. package/src/device/local/models/Alert.model.md +319 -0
  97. package/src/device/local/models/Alert.model.ts +283 -0
  98. package/src/device/local/models/Issue.model.md +386 -0
  99. package/src/device/local/models/Issue.model.ts +350 -0
  100. package/src/device/local/models/README.md +312 -0
  101. package/src/device/local/repository/Alert.repository.ts +465 -0
  102. package/src/device/local/repository/Device.repository.ts +241 -32
  103. package/src/device/local/repository/Hub.repository.ts +74 -18
  104. package/src/device/local/repository/Issue.repository.ts +517 -0
  105. package/src/device/local/repository/Schedule.repository.ts +28 -22
  106. package/src/device/local/services/Alert.service.ts +617 -5
  107. package/src/device/local/services/AlertService.example.ts +229 -0
  108. package/src/device/local/services/Device.service.ts +70 -50
  109. package/src/device/local/services/Issue.service.ts +872 -0
  110. package/src/device/local/services/IssueService.example.ts +307 -0
  111. package/src/device/local/services/index.ts +7 -5
  112. package/src/events/BaseEventHandler.ts +145 -0
  113. package/src/events/BaseEventTransformer.ts +97 -0
  114. package/src/events/DeviceEventHandler.ts +211 -0
  115. package/src/events/DeviceEventTransformerFactory.ts +77 -0
  116. package/src/{device/local/events → events}/EventHandler.ts +19 -15
  117. package/src/events/EventHandlerOrchestrator.ts +119 -0
  118. package/src/events/EventProcessingService.ts +248 -0
  119. package/src/events/InternalEventSubscription.ts +219 -0
  120. package/src/events/index.ts +9 -0
  121. package/src/events/interfaces/DeviceEvent.ts +56 -0
  122. package/src/events/interfaces/IEventHandler.ts +28 -0
  123. package/src/events/interfaces/IEventTransformer.ts +8 -0
  124. package/src/events/interfaces/IInternalEvent.ts +47 -0
  125. package/src/events/interfaces/index.ts +4 -0
  126. package/src/index.ts +9 -2
  127. package/src/types/alert.types.ts +64 -0
  128. package/src/types/config.types.ts +17 -4
  129. package/src/types/index.ts +2 -0
  130. package/src/types/issue.types.ts +98 -0
  131. package/src/utils/http-utils.ts +143 -0
  132. package/src/device/local/events/index.ts +0 -2
@@ -0,0 +1,465 @@
1
+ import { Service } from "typedi";
2
+ import { AlertModel, IAlertDocument } from "../models/Alert.model";
3
+ import {
4
+ CreateAlertData,
5
+ UpdateAlertData,
6
+ AlertCategory,
7
+ AlertSeverity,
8
+ EntityType,
9
+ } from "../../../types/alert.types";
10
+
11
+ @Service()
12
+ export class AlertRepository {
13
+ /**
14
+ * Create a new alert
15
+ */
16
+ async create(alertData: CreateAlertData): Promise<IAlertDocument> {
17
+ try {
18
+ const alert = new AlertModel({
19
+ ...alertData,
20
+ severity: alertData.severity || AlertSeverity.MEDIUM,
21
+ isRead: false,
22
+ isActive: true,
23
+ isDeleted: false,
24
+ });
25
+
26
+ return await alert.save();
27
+ } catch (error) {
28
+ throw new Error(
29
+ `Failed to create alert: ${
30
+ error instanceof Error ? error.message : "Unknown error"
31
+ }`
32
+ );
33
+ }
34
+ }
35
+
36
+ /**
37
+ * Find alert by ID
38
+ */
39
+ async findById(
40
+ id: string,
41
+ includeDeleted = false
42
+ ): Promise<IAlertDocument | null> {
43
+ try {
44
+ const query: any = { _id: id };
45
+ if (!includeDeleted) {
46
+ query.isDeleted = false;
47
+ }
48
+ return await AlertModel.findOne(query);
49
+ } catch (error) {
50
+ throw new Error(
51
+ `Failed to find alert by ID: ${
52
+ error instanceof Error ? error.message : "Unknown error"
53
+ }`
54
+ );
55
+ }
56
+ }
57
+
58
+ /**
59
+ * Find all alerts with filters
60
+ */
61
+ async findAll(
62
+ filters: {
63
+ propertyId?: string;
64
+ category?: AlertCategory;
65
+ severity?: AlertSeverity;
66
+ entityType?: EntityType;
67
+ entityId?: string;
68
+ isActive?: boolean;
69
+ isRead?: boolean;
70
+ includeDeleted?: boolean;
71
+ limit?: number;
72
+ skip?: number;
73
+ sort?: { [key: string]: 1 | -1 };
74
+ } = {}
75
+ ): Promise<IAlertDocument[]> {
76
+ try {
77
+ const query: any = {};
78
+
79
+ if (filters.propertyId) query.propertyId = filters.propertyId;
80
+ if (filters.category) query.category = filters.category;
81
+ if (filters.severity) query.severity = filters.severity;
82
+ if (filters.entityType) query.entityType = filters.entityType;
83
+ if (filters.entityId) query.entityId = filters.entityId;
84
+ if (filters.isActive !== undefined) query.isActive = filters.isActive;
85
+ if (filters.isRead !== undefined) query.isRead = filters.isRead;
86
+ if (!filters.includeDeleted) query.isDeleted = false;
87
+
88
+ const queryBuilder = AlertModel.find(query);
89
+
90
+ if (filters.sort) {
91
+ queryBuilder.sort(filters.sort);
92
+ } else {
93
+ queryBuilder.sort({ severity: -1, createdAt: -1 });
94
+ }
95
+
96
+ if (filters.skip) queryBuilder.skip(filters.skip);
97
+ if (filters.limit) queryBuilder.limit(filters.limit);
98
+
99
+ return await queryBuilder.exec();
100
+ } catch (error) {
101
+ throw new Error(
102
+ `Failed to find alerts: ${
103
+ error instanceof Error ? error.message : "Unknown error"
104
+ }`
105
+ );
106
+ }
107
+ }
108
+
109
+ /**
110
+ * Update an alert
111
+ */
112
+ async update(
113
+ id: string,
114
+ updateData: UpdateAlertData
115
+ ): Promise<IAlertDocument | null> {
116
+ try {
117
+ return await AlertModel.findByIdAndUpdate(
118
+ id,
119
+ { ...updateData, updatedAt: new Date() },
120
+ { new: true, runValidators: true }
121
+ );
122
+ } catch (error) {
123
+ throw new Error(
124
+ `Failed to update alert: ${
125
+ error instanceof Error ? error.message : "Unknown error"
126
+ }`
127
+ );
128
+ }
129
+ }
130
+
131
+ /**
132
+ * Soft delete an alert
133
+ */
134
+ async softDelete(id: string, deletedBy: string): Promise<boolean> {
135
+ try {
136
+ const result = await AlertModel.findByIdAndUpdate(id, {
137
+ isDeleted: true,
138
+ updatedBy: deletedBy,
139
+ updatedAt: new Date(),
140
+ });
141
+ return !!result;
142
+ } catch (error) {
143
+ throw new Error(
144
+ `Failed to soft delete alert: ${
145
+ error instanceof Error ? error.message : "Unknown error"
146
+ }`
147
+ );
148
+ }
149
+ }
150
+
151
+ /**
152
+ * Permanently delete an alert
153
+ */
154
+ async hardDelete(id: string): Promise<boolean> {
155
+ try {
156
+ const result = await AlertModel.findByIdAndDelete(id);
157
+ return !!result;
158
+ } catch (error) {
159
+ throw new Error(
160
+ `Failed to permanently delete alert: ${
161
+ error instanceof Error ? error.message : "Unknown error"
162
+ }`
163
+ );
164
+ }
165
+ }
166
+
167
+ /**
168
+ * Count alerts with filters
169
+ */
170
+ async count(
171
+ filters: {
172
+ propertyId?: string;
173
+ category?: AlertCategory;
174
+ severity?: AlertSeverity;
175
+ entityType?: EntityType;
176
+ entityId?: string;
177
+ isActive?: boolean;
178
+ isRead?: boolean;
179
+ includeDeleted?: boolean;
180
+ } = {}
181
+ ): Promise<number> {
182
+ try {
183
+ const query: any = {};
184
+
185
+ if (filters.propertyId) query.propertyId = filters.propertyId;
186
+ if (filters.category) query.category = filters.category;
187
+ if (filters.severity) query.severity = filters.severity;
188
+ if (filters.entityType) query.entityType = filters.entityType;
189
+ if (filters.entityId) query.entityId = filters.entityId;
190
+ if (filters.isActive !== undefined) query.isActive = filters.isActive;
191
+ if (filters.isRead !== undefined) query.isRead = filters.isRead;
192
+ if (!filters.includeDeleted) query.isDeleted = false;
193
+
194
+ return await AlertModel.countDocuments(query);
195
+ } catch (error) {
196
+ throw new Error(
197
+ `Failed to count alerts: ${
198
+ error instanceof Error ? error.message : "Unknown error"
199
+ }`
200
+ );
201
+ }
202
+ }
203
+
204
+ /**
205
+ * Find alerts by property
206
+ */
207
+ async findByProperty(
208
+ propertyId: string,
209
+ includeDeleted = false
210
+ ): Promise<IAlertDocument[]> {
211
+ try {
212
+ return await AlertModel.findByProperty(propertyId, includeDeleted);
213
+ } catch (error) {
214
+ throw new Error(
215
+ `Failed to find alerts by property: ${
216
+ error instanceof Error ? error.message : "Unknown error"
217
+ }`
218
+ );
219
+ }
220
+ }
221
+
222
+ /**
223
+ * Find alerts by entity
224
+ */
225
+ async findByEntity(
226
+ entityId: string,
227
+ entityType: EntityType,
228
+ includeDeleted = false
229
+ ): Promise<IAlertDocument[]> {
230
+ try {
231
+ return await AlertModel.findByEntity(
232
+ entityId,
233
+ entityType,
234
+ includeDeleted
235
+ );
236
+ } catch (error) {
237
+ throw new Error(
238
+ `Failed to find alerts by entity: ${
239
+ error instanceof Error ? error.message : "Unknown error"
240
+ }`
241
+ );
242
+ }
243
+ }
244
+
245
+ /**
246
+ * Find alerts by category
247
+ */
248
+ async findByCategory(
249
+ category: AlertCategory,
250
+ includeDeleted = false
251
+ ): Promise<IAlertDocument[]> {
252
+ try {
253
+ return await AlertModel.findByCategory(category, includeDeleted);
254
+ } catch (error) {
255
+ throw new Error(
256
+ `Failed to find alerts by category: ${
257
+ error instanceof Error ? error.message : "Unknown error"
258
+ }`
259
+ );
260
+ }
261
+ }
262
+
263
+ /**
264
+ * Find alerts by severity
265
+ */
266
+ async findBySeverity(
267
+ severity: AlertSeverity,
268
+ includeDeleted = false
269
+ ): Promise<IAlertDocument[]> {
270
+ try {
271
+ return await AlertModel.findBySeverity(severity, includeDeleted);
272
+ } catch (error) {
273
+ throw new Error(
274
+ `Failed to find alerts by severity: ${
275
+ error instanceof Error ? error.message : "Unknown error"
276
+ }`
277
+ );
278
+ }
279
+ }
280
+
281
+ /**
282
+ * Find active alerts
283
+ */
284
+ async findActive(includeDeleted = false): Promise<IAlertDocument[]> {
285
+ try {
286
+ return await AlertModel.findActive(includeDeleted);
287
+ } catch (error) {
288
+ throw new Error(
289
+ `Failed to find active alerts: ${
290
+ error instanceof Error ? error.message : "Unknown error"
291
+ }`
292
+ );
293
+ }
294
+ }
295
+
296
+ /**
297
+ * Find unread alerts
298
+ */
299
+ async findUnread(includeDeleted = false): Promise<IAlertDocument[]> {
300
+ try {
301
+ return await AlertModel.findUnread(includeDeleted);
302
+ } catch (error) {
303
+ throw new Error(
304
+ `Failed to find unread alerts: ${
305
+ error instanceof Error ? error.message : "Unknown error"
306
+ }`
307
+ );
308
+ }
309
+ }
310
+
311
+ /**
312
+ * Find snoozed alerts
313
+ */
314
+ async findSnoozed(includeDeleted = false): Promise<IAlertDocument[]> {
315
+ try {
316
+ return await AlertModel.findSnoozed(includeDeleted);
317
+ } catch (error) {
318
+ throw new Error(
319
+ `Failed to find snoozed alerts: ${
320
+ error instanceof Error ? error.message : "Unknown error"
321
+ }`
322
+ );
323
+ }
324
+ }
325
+
326
+ /**
327
+ * Find expired snooze alerts
328
+ */
329
+ async findExpiredSnooze(includeDeleted = false): Promise<IAlertDocument[]> {
330
+ try {
331
+ return await AlertModel.findExpiredSnooze(includeDeleted);
332
+ } catch (error) {
333
+ throw new Error(
334
+ `Failed to find expired snooze alerts: ${
335
+ error instanceof Error ? error.message : "Unknown error"
336
+ }`
337
+ );
338
+ }
339
+ }
340
+
341
+ /**
342
+ * Get alert statistics
343
+ */
344
+ async getStatistics(propertyId?: string): Promise<{
345
+ total: number;
346
+ active: number;
347
+ unread: number;
348
+ snoozed: number;
349
+ bySeverity: Record<AlertSeverity, number>;
350
+ byCategory: Record<AlertCategory, number>;
351
+ }> {
352
+ try {
353
+ const query: any = { isDeleted: false };
354
+ if (propertyId) query.propertyId = propertyId;
355
+
356
+ const [total, active, unread, snoozed, severityStats, categoryStats] =
357
+ await Promise.all([
358
+ AlertModel.countDocuments(query),
359
+ AlertModel.countDocuments({ ...query, isActive: true }),
360
+ AlertModel.countDocuments({ ...query, isRead: false }),
361
+ AlertModel.countDocuments({
362
+ ...query,
363
+ snoozeUntil: { $exists: true, $ne: null },
364
+ }),
365
+ AlertModel.aggregate([
366
+ { $match: query },
367
+ { $group: { _id: "$severity", count: { $sum: 1 } } },
368
+ ]),
369
+ AlertModel.aggregate([
370
+ { $match: query },
371
+ { $group: { _id: "$category", count: { $sum: 1 } } },
372
+ ]),
373
+ ]);
374
+
375
+ const bySeverity = Object.values(AlertSeverity).reduce(
376
+ (acc, severity) => {
377
+ acc[severity] = 0;
378
+ return acc;
379
+ },
380
+ {} as Record<AlertSeverity, number>
381
+ );
382
+
383
+ const byCategory = Object.values(AlertCategory).reduce(
384
+ (acc, category) => {
385
+ acc[category] = 0;
386
+ return acc;
387
+ },
388
+ {} as Record<AlertCategory, number>
389
+ );
390
+
391
+ // Type-safe handling of aggregation results
392
+ severityStats.forEach((stat: { _id: string; count: number }) => {
393
+ if (stat._id in bySeverity) {
394
+ bySeverity[stat._id as AlertSeverity] = stat.count;
395
+ }
396
+ });
397
+
398
+ categoryStats.forEach((stat: { _id: string; count: number }) => {
399
+ if (stat._id in byCategory) {
400
+ byCategory[stat._id as AlertCategory] = stat.count;
401
+ }
402
+ });
403
+
404
+ return {
405
+ total,
406
+ active,
407
+ unread,
408
+ snoozed,
409
+ bySeverity,
410
+ byCategory,
411
+ };
412
+ } catch (error) {
413
+ throw new Error(
414
+ `Failed to get alert statistics: ${
415
+ error instanceof Error ? error.message : "Unknown error"
416
+ }`
417
+ );
418
+ }
419
+ }
420
+
421
+ /**
422
+ * Bulk update alerts
423
+ */
424
+ async bulkUpdate(
425
+ ids: string[],
426
+ updateData: Partial<UpdateAlertData>
427
+ ): Promise<number> {
428
+ try {
429
+ const result = await AlertModel.updateMany(
430
+ { _id: { $in: ids } },
431
+ { ...updateData, updatedAt: new Date() }
432
+ );
433
+ return result.modifiedCount;
434
+ } catch (error) {
435
+ throw new Error(
436
+ `Failed to bulk update alerts: ${
437
+ error instanceof Error ? error.message : "Unknown error"
438
+ }`
439
+ );
440
+ }
441
+ }
442
+
443
+ /**
444
+ * Bulk soft delete alerts
445
+ */
446
+ async bulkSoftDelete(ids: string[], deletedBy: string): Promise<number> {
447
+ try {
448
+ const result = await AlertModel.updateMany(
449
+ { _id: { $in: ids } },
450
+ {
451
+ isDeleted: true,
452
+ updatedBy: deletedBy,
453
+ updatedAt: new Date(),
454
+ }
455
+ );
456
+ return result.modifiedCount;
457
+ } catch (error) {
458
+ throw new Error(
459
+ `Failed to bulk soft delete alerts: ${
460
+ error instanceof Error ? error.message : "Unknown error"
461
+ }`
462
+ );
463
+ }
464
+ }
465
+ }