dt-common-device 7.4.0 → 7.6.0

package/dist/alerts/Alert.model.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AlertSchema = exports.AlertModel = void 0;
 const mongoose_1 = __importStar(require("mongoose"));
 const alert_types_1 = require("./alert.types");
+const issues_1 = require("../issues");
 // Main Alert schema
 const AlertSchema = new mongoose_1.Schema({
     category: {
@@ -50,7 +51,7 @@ const AlertSchema = new mongoose_1.Schema({
     },
     zoneId: {
         type: String,
-        required: true,
+        required: false,
         index: true,
     },
     title: {
@@ -74,6 +75,12 @@ const AlertSchema = new mongoose_1.Schema({
         required: true,
         index: true,
     },
+    entitySubType: {
+        type: String,
+        enum: Object.values(issues_1.EntitySubType),
+        required: true,
+        index: true,
+    },
     severity: {
         type: String,
         enum: Object.values(alert_types_1.AlertSeverity),

package/dist/alerts/Alert.service.d.ts

@@ -1,45 +1,49 @@
 import { IAlertDocument } from "./Alert.model";
 import { CreateAlertData, UpdateAlertData, AlertCategory, AlertSeverity, IAlertQuery } from "./alert.types";
 import { AlertBuilder } from "./AlertBuilder";
+import { IDevice } from "../entities/device/local/interfaces";
+import { Source } from "../constants";
+import { IUser } from "../entities/admin";
 export declare class AlertService {
     private readonly alertRepository;
     constructor();
     /**
      * Create an operations alert using AlertBuilder
      */
-    raiseOperationsAlert(data: CreateAlertData): Promise<IAlertDocument>;
+    raiseOperationsAlert(data: CreateAlertData): Promise<IAlertDocument | null>;
     /**
      * Create a security alert using AlertBuilder
      */
-    raiseSecurityAlert(data: CreateAlertData): Promise<IAlertDocument>;
-    /**
-     * Create an energy alert using AlertBuilder
-     */
-    raiseEnergyAlert(data: CreateAlertData): Promise<IAlertDocument>;
-    /**
-     * Create a device-specific alert using AlertBuilder
-     */
+    raiseSecurityAlert(data: CreateAlertData): Promise<IAlertDocument | null>;
+    raiseDeviceAlert(data: CreateAlertData): Promise<IAlertDocument | null>;
     /**
      * Create a hub-specific alert using AlertBuilder
      */
-    raiseHubAlert(data: CreateAlertData): Promise<IAlertDocument>;
-    /**
-     * Raise alert for device going offline (OPERATIONAL only)
-     */
+    raiseHubAlert(data: CreateAlertData): Promise<IAlertDocument | null>;
+    raiseDoorLeftOpenAlert(device: IDevice, zone: any, openThreshold: number, source: Source): Promise<IAlertDocument | null>;
+    raiseNewDeviceAlert(device: {
+        deviceId: string;
+        deviceType: {
+            type: any;
+        };
+        propertyId: string;
+        name: string;
+    }, source: Source, description?: string): Promise<IAlertDocument | null>;
+    raiseDoorOpenFrequentAlert(device: IDevice, zone: any, accessTimes: number, openThreshold: number, source: Source): Promise<IAlertDocument | null>;
+    raiseDoorOpenOutsideBusinessHoursAlert(device: IDevice, zone: any, source: Source): Promise<IAlertDocument | null>;
     /**
      * Raise alert for device coming online (OPERATIONAL only)
      */
-    /**
-     * Raise alert for device battery level below threshold (READINESS + OPERATIONAL + ENERGY)
-     */
-    /**
-     * Raise alert for device issue (jammed or malfunctioned) (READINESS + OPERATIONAL)
-     */
+    raiseDeviceOnlineAlert(device: IDevice, source: Source): Promise<IAlertDocument | null>;
+    raiseLockAccessEmergencyCodeAlert(device: IDevice, zone: any, source: Source): Promise<IAlertDocument | null>;
+    raiseLockAccessMasterCodeAlert(device: IDevice, zone: any, source: Source): Promise<IAlertDocument | null>;
+    raiseSpecificDoorAccessAlert(user: IUser, device: IDevice, zone: any, source: Source): Promise<IAlertDocument | null>;
+    raiseGuestLockFirstAccessAlert(user: IUser, device: IDevice, zone: any, source: Source): Promise<IAlertDocument | null>;
     /**
      * Create a new alert with business logic validation
      * Accepts either a CreateAlertData object or an AlertBuilder instance
      */
-    createAlert(alertData: CreateAlertData | AlertBuilder): Promise<IAlertDocument>;
+    createAlert(alertData: CreateAlertData | AlertBuilder): Promise<IAlertDocument | null>;
     /**
      * Get alert by ID with business logic
      */

package/dist/alerts/Alert.service.js

@@ -77,6 +77,8 @@ const Alert_repository_1 = require("./Alert.repository");
 const Alert_model_1 = require("./Alert.model");
 const alert_types_1 = require("./alert.types");
 const AlertBuilder_1 = require("./AlertBuilder");
+const constants_1 = require("../constants");
+const audit_1 = require("../audit");
 let AlertService = (() => {
     let _classDecorators = [(0, typedi_1.Service)()];
     let _classDescriptor;
@@ -92,13 +94,15 @@ let AlertService = (() => {
         async raiseOperationsAlert(data) {
             const alertBuilder = AlertBuilder_1.AlertBuilder.createOperationsAlert()
                 .setPropertyId(data.propertyId)
-                .setZoneId(data.zoneId)
+                .setZoneId(data.zoneId || "")
                 .setTitle(data.title)
                 .setDescription(data.description);
             if (data.entityId)
                 alertBuilder.setEntityId(data.entityId);
             if (data.entityType)
                 alertBuilder.setEntityType(data.entityType);
+            if (data.entitySubType)
+                alertBuilder.setEntitySubType(data.entitySubType);
             if (data.createdBy)
                 alertBuilder.setCreatedBy(data.createdBy);
             return await this.createAlert(alertBuilder);
@@ -109,56 +113,40 @@ let AlertService = (() => {
         async raiseSecurityAlert(data) {
             const alertBuilder = AlertBuilder_1.AlertBuilder.createSecurityAlert()
                 .setPropertyId(data.propertyId)
-                .setZoneId(data.zoneId)
+                .setZoneId(data.zoneId || "")
                 .setTitle(data.title)
                 .setDescription(data.description);
             if (data.entityId)
                 alertBuilder.setEntityId(data.entityId);
             if (data.entityType)
                 alertBuilder.setEntityType(data.entityType);
+            if (data.entitySubType)
+                alertBuilder.setEntitySubType(data.entitySubType);
             if (data.createdBy)
                 alertBuilder.setCreatedBy(data.createdBy);
             return await this.createAlert(alertBuilder);
         }
-        /**
-         * Create an energy alert using AlertBuilder
-         */
-        async raiseEnergyAlert(data) {
-            const alertBuilder = AlertBuilder_1.AlertBuilder.createEnergyAlert()
-                .setPropertyId(data.propertyId)
-                .setZoneId(data.zoneId)
+        async raiseDeviceAlert(data) {
+            const alertBuilder = AlertBuilder_1.AlertBuilder.createDeviceAlert(data.entityId || "", data.propertyId, data.zoneId || "")
                 .setTitle(data.title)
                 .setDescription(data.description);
-            if (data.entityId)
-                alertBuilder.setEntityId(data.entityId);
-            if (data.entityType)
-                alertBuilder.setEntityType(data.entityType);
+            if (data.category)
+                alertBuilder.setCategory(data.category);
+            if (data.severity)
+                alertBuilder.setSeverity(data.severity);
+            if (data.type)
+                alertBuilder.setType(data.type);
             if (data.createdBy)
                 alertBuilder.setCreatedBy(data.createdBy);
+            if (data.entitySubType)
+                alertBuilder.setEntitySubType(data.entitySubType);
             return await this.createAlert(alertBuilder);
         }
-        /**
-         * Create a device-specific alert using AlertBuilder
-         */
-        // async raiseDeviceAlert(data: CreateAlertData): Promise<IAlertDocument> {
-        //   const alertBuilder = AlertBuilder.createDeviceAlert(
-        //     data.entityId || "",
-        //     data.propertyId,
-        //     data.zoneId
-        //   )
-        //     .setTitle(data.title)
-        //     .setDescription(data.description);
-        //   if (data.category) alertBuilder.setCategory(data.category);
-        //   if (data.severity) alertBuilder.setSeverity(data.severity);
-        //   if (data.type) alertBuilder.setType(data.type);
-        //   if (data.createdBy) alertBuilder.setCreatedBy(data.createdBy);
-        //   return await this.createAlert(alertBuilder);
-        // }
         /**
          * Create a hub-specific alert using AlertBuilder
          */
         async raiseHubAlert(data) {
-            const alertBuilder = AlertBuilder_1.AlertBuilder.createHubAlert(data.entityId || "", data.propertyId, data.zoneId)
+            const alertBuilder = AlertBuilder_1.AlertBuilder.createHubAlert(data.entityId || "", data.propertyId, data.zoneId || "")
                 .setTitle(data.title)
                 .setDescription(data.description);
             if (data.category)
@@ -169,125 +157,227 @@ let AlertService = (() => {
                 alertBuilder.setType(data.type);
             if (data.createdBy)
                 alertBuilder.setCreatedBy(data.createdBy);
+            if (data.entitySubType)
+                alertBuilder.setEntitySubType(data.entitySubType);
             return await this.createAlert(alertBuilder);
         }
-        /**
-         * Raise alert for device going offline (OPERATIONAL only)
-         */
-        // async raiseDeviceOfflineAlert(
-        //   device: IDevice,
-        //   source: Source,
-        //   reason?: string
-        // ): Promise<IAlertDocument> {
-        //   return await this.raiseDeviceAlert({
-        //     entityId: device.deviceId,
-        //     propertyId: device.propertyId,
-        //     zoneId: device.zoneId,
-        //     title: "Device Offline",
-        //     description: `Device ${device.name} has gone offline. ${
-        //       reason ? `Reason: ${reason}` : ""
-        //     }`,
-        //     category: AlertCategory.OPERATIONS,
-        //     severity: AlertSeverity.HIGH,
-        //     createdBy: source,
-        //     entityType: EntityType.DEVICE,
-        //     type: AlertType.DEVICE_OFFLINE, // Using a relevant type for device offline
-        //   });
-        // }
+        async raiseDoorLeftOpenAlert(device, zone, openThreshold, source) {
+            return await this.createAlert({
+                entityId: device.deviceId,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Door Left Open",
+                description: `${zone?.name} has a door left open, for more than ${openThreshold} minutes.`,
+                createdBy: source,
+                category: alert_types_1.AlertCategory.SECURITY,
+                severity: alert_types_1.AlertSeverity.CRITICAL,
+                type: alert_types_1.AlertType.DOOR_LEFT_OPEN,
+            });
+        }
+        async raiseNewDeviceAlert(device, source, description) {
+            return await this.createAlert({
+                entityId: device.deviceId,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device?.deviceType?.type,
+                propertyId: device?.propertyId,
+                title: "New Device Detected",
+                description: description || `New device ${device?.name} has been detected.`,
+                createdBy: source,
+                category: alert_types_1.AlertCategory.OPERATIONS,
+                severity: alert_types_1.AlertSeverity.INFO,
+                type: alert_types_1.AlertType.ACCOUNT_NEW_DEVICE,
+            });
+        }
+        async raiseDoorOpenFrequentAlert(device, zone, accessTimes, openThreshold, source) {
+            return await this.createAlert({
+                entityId: device.deviceId,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Door Open Frequently",
+                description: `${zone?.name} has been opened ${accessTimes} times in the last ${openThreshold} minutes.`,
+                createdBy: source,
+                category: alert_types_1.AlertCategory.OPERATIONS,
+                severity: alert_types_1.AlertSeverity.HIGH,
+                type: alert_types_1.AlertType.DOOR_OPEN_FREQUENT,
+            });
+        }
+        async raiseDoorOpenOutsideBusinessHoursAlert(device, zone, source) {
+            return await this.createAlert({
+                entityId: device.deviceId,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Door Open Outside Business Hours",
+                description: `${zone?.name} has been opened outside business hours.`,
+                createdBy: source,
+                category: alert_types_1.AlertCategory.SECURITY,
+                severity: alert_types_1.AlertSeverity.HIGH,
+                type: alert_types_1.AlertType.DOOR_OPEN_OUTSIDE_BIZ_HOURS,
+            });
+        }
         /**
          * Raise alert for device coming online (OPERATIONAL only)
          */
-        // async raiseDeviceOnlineAlert(
-        //   device: IDevice,
-        //   source: Source,
-        //   reason?: string
-        // ): Promise<IAlertDocument> {
-        //   return await this.raiseDeviceAlert({
-        //     entityId: device.deviceId,
-        //     propertyId: device.propertyId,
-        //     zoneId: device.zoneId,
-        //     title: "Device Online",
-        //     description: `Device ${device.name} is now online. ${
-        //       reason ? `Reason: ${reason}` : ""
-        //     }`,
-        //     category: AlertCategory.OPERATIONS,
-        //     severity: AlertSeverity.INFO,
-        //     createdBy: source,
-        //     entityType: EntityType.DEVICE,
-        //     type: AlertType.DEVICE_ONLINE,
-        //   });
-        // }
-        /**
-         * Raise alert for device battery level below threshold (READINESS + OPERATIONAL + ENERGY)
-         */
-        // async raiseDeviceBatteryAlert(
-        //   device: IDevice,
-        //   batteryLevel: number,
-        //   threshold: number,
-        //   source: Source
-        // ): Promise<IAlertDocument> {
-        //   return await this.raiseDeviceAlert({
-        //     entityId: device.deviceId,
-        //     propertyId: device.propertyId,
-        //     zoneId: device.zoneId,
-        //     title: "Device Battery Low",
-        //     description: `Device ${device.name} (${device.deviceId}) battery level is ${batteryLevel}%, which is below the property threshold of ${threshold}%.`,
-        //     category: AlertCategory.ENERGY,
-        //     severity: AlertSeverity.HIGH,
-        //     createdBy: source,
-        //     entityType: EntityType.DEVICE,
-        //     type: AlertType.DEVICE_BATTERY_LOW,
-        //   });
-        // }
-        /**
-         * Raise alert for device issue (jammed or malfunctioned) (READINESS + OPERATIONAL)
-         */
-        // async raiseDeviceIssueAlert(
-        //   device: IDevice,
-        //   issueType: string,
-        //   source: Source,
-        //   reason?: string
-        // ): Promise<IAlertDocument> {
-        //   return await this.raiseDeviceAlert({
-        //     entityId: device.deviceId,
-        //     propertyId: device.propertyId,
-        //     zoneId: device.zoneId,
-        //     title: `Device Issue - ${issueType}`,
-        //     description: `Device ${device.name} has an issue: ${issueType}. ${
-        //       reason ? `Reason: ${reason}` : ""
-        //     }`,
-        //     category: AlertCategory.OPERATIONS,
-        //     severity: AlertSeverity.HIGH,
-        //     createdBy: source,
-        //     entityType: EntityType.DEVICE,
-        //     type: AlertType.DEVICE_ISSUE,
-        //   });
-        // }
+        async raiseDeviceOnlineAlert(device, source) {
+            return await this.raiseDeviceAlert({
+                entityId: device.deviceId,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Device Online",
+                description: `Device ${device.name} is now online.`,
+                category: alert_types_1.AlertCategory.OPERATIONS,
+                severity: alert_types_1.AlertSeverity.INFO,
+                createdBy: source,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                type: alert_types_1.AlertType.DEVICE_ONLINE,
+            });
+        }
+        async raiseLockAccessEmergencyCodeAlert(device, zone, source) {
+            return await this.createAlert({
+                entityId: device.deviceId,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Emergency Code Used",
+                description: `${zone?.name} has been accessed using the emergency code.`,
+                createdBy: source,
+                category: alert_types_1.AlertCategory.SECURITY,
+                severity: alert_types_1.AlertSeverity.HIGH,
+                type: alert_types_1.AlertType.LOCK_ACCESS_EMERGENCY_CODE,
+            });
+        }
+        async raiseLockAccessMasterCodeAlert(device, zone, source) {
+            return await this.createAlert({
+                entityId: device.deviceId,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Master Code Used",
+                description: `${zone?.name} has been accessed using the master code.`,
+                createdBy: source,
+                category: alert_types_1.AlertCategory.SECURITY,
+                severity: alert_types_1.AlertSeverity.HIGH,
+                type: alert_types_1.AlertType.LOCK_ACCESS_MASTER_CODE,
+            });
+        }
+        async raiseSpecificDoorAccessAlert(user, device, zone, source) {
+            return await this.createAlert({
+                entityId: device.deviceId,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Specific Door Access",
+                description: `${user?.firstName} ${user?.lastName} has accessed ${zone?.name}.`,
+                createdBy: source,
+                category: alert_types_1.AlertCategory.OTHER,
+                severity: alert_types_1.AlertSeverity.INFO,
+                type: alert_types_1.AlertType.SPECIFIC_DOOR_ACCESS,
+            });
+        }
+        async raiseGuestLockFirstAccessAlert(user, device, zone, source) {
+            return await this.createAlert({
+                entityId: device.deviceId,
+                entityType: alert_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Guest Used Code for First Time",
+                description: `${user?.firstName} ${user?.lastName} has used the code for the first time to access ${zone?.name}.`,
+                createdBy: source,
+                category: alert_types_1.AlertCategory.OTHER,
+                severity: alert_types_1.AlertSeverity.INFO,
+                type: alert_types_1.AlertType.GUEST_LOCK_FIRST_ACCESS,
+            });
+        }
         /**
          * Create a new alert with business logic validation
          * Accepts either a CreateAlertData object or an AlertBuilder instance
          */
         async createAlert(alertData) {
-            let processedAlertData;
-            // Handle AlertBuilder instance
-            if (alertData instanceof AlertBuilder_1.AlertBuilder) {
-                processedAlertData = alertData.build();
-            }
-            else {
-                processedAlertData = alertData;
-            }
-            // Business logic: Validate alert data
-            this.validateAlertData(processedAlertData);
-            // Business logic: Set default severity if not provided
-            if (!processedAlertData.severity) {
-                processedAlertData.severity = this.determineDefaultSeverity(processedAlertData.category, processedAlertData.type);
-            }
-            // Business logic: Validate snooze date is in the future
-            if (processedAlertData.snoozeUntil &&
-                processedAlertData.snoozeUntil <= new Date()) {
-                throw new Error("Snooze date must be in the future");
+            try {
+                let processedAlertData;
+                // Handle AlertBuilder instance
+                if (alertData instanceof AlertBuilder_1.AlertBuilder) {
+                    processedAlertData = alertData.build();
+                }
+                else {
+                    processedAlertData = alertData;
+                }
+                // Business logic: Validate alert data
+                this.validateAlertData(processedAlertData);
+                // Business logic: Set default severity if not provided
+                if (!processedAlertData.severity) {
+                    processedAlertData.severity = this.determineDefaultSeverity(processedAlertData.category, processedAlertData.type);
+                }
+                // Business logic: Validate snooze date is in the future
+                if (processedAlertData.snoozeUntil &&
+                    processedAlertData.snoozeUntil <= new Date()) {
+                    throw new Error("Snooze date must be in the future");
+                }
+                const existingAlert = await this.queryAlerts({
+                    propertyId: processedAlertData.propertyId,
+                    zoneId: processedAlertData.zoneId,
+                    entityId: processedAlertData.entityId,
+                    entityType: processedAlertData.entityType,
+                    entitySubType: processedAlertData.entitySubType,
+                });
+                if (existingAlert.length > 0) {
+                    await (0, audit_1.pushAudit)({
+                        auditType: constants_1.DT_EVENT_TYPES.ALERT.CREATE.SKIPPED,
+                        auditData: {
+                            reason: "Alert already exists",
+                            resource: audit_1.Resource.ALERT,
+                            source: processedAlertData.createdBy,
+                            propertyId: processedAlertData.propertyId,
+                            entityId: processedAlertData.entityId,
+                            entityType: processedAlertData.entityType,
+                            entitySubType: processedAlertData.entitySubType,
+                        },
+                    });
+                    return null;
+                }
+                const alert = await this.alertRepository.create(processedAlertData);
+                await (0, audit_1.pushAudit)({
+                    auditType: constants_1.DT_EVENT_TYPES.ALERT.CREATE.SUCCESS,
+                    auditData: {
+                        resource: audit_1.Resource.ALERT,
+                        source: constants_1.Source.USER,
+                        propertyId: processedAlertData.propertyId,
+                        zoneId: processedAlertData.zoneId,
+                        entityId: processedAlertData.entityId,
+                        entityType: processedAlertData.entityType,
+                        entitySubType: processedAlertData.entitySubType,
+                        type: processedAlertData.type,
+                        createdBy: processedAlertData.createdBy,
+                        createdAt: new Date(),
+                    },
+                });
+                return alert;
+            }
+            catch (error) {
+                await (0, audit_1.pushAudit)({
+                    auditType: constants_1.DT_EVENT_TYPES.ALERT.CREATE.FAILED,
+                    auditData: {
+                        resource: audit_1.Resource.ALERT,
+                        source: constants_1.Source.USER,
+                        propertyId: alertData?.propertyId || "",
+                        zoneId: alertData?.zoneId || "",
+                        errorMessage: error.message,
+                        error: error,
+                        createdBy: alertData?.createdBy || "",
+                    },
+                });
+                throw error;
             }
-            return await this.alertRepository.create(processedAlertData);
         }
         /**
          * Get alert by ID with business logic

package/dist/alerts/AlertBuilder.d.ts

@@ -1,3 +1,4 @@
+import { EntitySubType } from "../issues";
 import { CreateAlertData, AlertCategory, AlertSeverity, EntityType, AlertType } from "./alert.types";
 /**
  * AlertBuilder - A builder pattern implementation for constructing CreateAlertData objects
@@ -48,6 +49,10 @@ export declare class AlertBuilder {
      * Sets the entity type
      */
     setEntityType(entityType: EntityType): this;
+    /**
+     * Sets the entity sub type
+     */
+    setEntitySubType(entitySubType: EntitySubType): this;
     /**
      * Sets the alert severity (optional, defaults to LOW)
      */

package/dist/alerts/AlertBuilder.js

@@ -88,6 +88,13 @@ class AlertBuilder {
         this.data.entityType = entityType;
         return this;
     }
+    /**
+     * Sets the entity sub type
+     */
+    setEntitySubType(entitySubType) {
+        this.data.entitySubType = entitySubType;
+        return this;
+    }
     /**
      * Sets the alert severity (optional, defaults to LOW)
      */

package/dist/alerts/alert.types.d.ts

@@ -1,4 +1,4 @@
-import { EntityType } from "../issues/issue.types";
+import { EntitySubType, EntityType } from "../issues/issue.types";
 export declare enum AlertCategory {
     OPERATIONS = "OPERATIONS",
     SECURITY = "SECURITY",
@@ -20,18 +20,20 @@ export declare enum AlertType {
     LOCK_ACCESS_EMERGENCY_CODE = "LOCK_ACCESS_EMERGENCY_CODE",
     LOCK_ACCESS_MASTER_CODE = "LOCK_ACCESS_MASTER_CODE",
     SPECIFIC_DOOR_ACCESS = "SPECIFIC_DOOR_ACCESS",
-    GUEST_LOCK_FIRST_ACCESS = "GUEST_LOCK_FIRST_ACCESS"
+    GUEST_LOCK_FIRST_ACCESS = "GUEST_LOCK_FIRST_ACCESS",
+    DEVICE_ONLINE = "DEVICE_ONLINE"
 }
 export interface AlertDocument {
     _id: string;
     category: AlertCategory;
     propertyId: string;
-    zoneId: string;
+    zoneId?: string;
     type: AlertType;
     title: string;
     description: string;
     entityId?: string;
     entityType: EntityType;
+    entitySubType: EntitySubType;
     severity: AlertSeverity;
     isRead: boolean;
     isActive: boolean;
@@ -45,11 +47,12 @@ export interface AlertDocument {
 export interface CreateAlertData {
     category: AlertCategory;
     propertyId: string;
-    zoneId: string;
+    zoneId?: string;
     title: string;
     description: string;
     entityId?: string;
     entityType: EntityType;
+    entitySubType: EntitySubType;
     severity?: AlertSeverity;
     type?: AlertType;
     createdBy?: string;
@@ -59,8 +62,10 @@ export interface UpdateAlertData {
     category?: AlertCategory;
     title?: string;
     description?: string;
+    zoneId?: string;
     entityId?: string;
     entityType?: EntityType;
+    entitySubType?: EntitySubType;
     severity?: AlertSeverity;
     type?: AlertType;
     isRead?: boolean;
@@ -74,6 +79,7 @@ export interface IAlertQuery {
     category?: AlertCategory;
     severity?: AlertSeverity;
     entityType?: EntityType;
+    entitySubType?: EntitySubType;
     entityId?: string;
     type?: AlertType | AlertType[];
     isActive?: boolean;

package/dist/alerts/alert.types.js

@@ -26,6 +26,7 @@ var AlertType;
     AlertType["LOCK_ACCESS_MASTER_CODE"] = "LOCK_ACCESS_MASTER_CODE";
     AlertType["SPECIFIC_DOOR_ACCESS"] = "SPECIFIC_DOOR_ACCESS";
     AlertType["GUEST_LOCK_FIRST_ACCESS"] = "GUEST_LOCK_FIRST_ACCESS";
+    AlertType["DEVICE_ONLINE"] = "DEVICE_ONLINE";
 })(AlertType || (exports.AlertType = AlertType = {}));
 // Re-export EntityType from issue.types.ts to avoid duplication
 var issue_types_1 = require("../issues/issue.types");

package/dist/constants/Service.d.ts

@@ -13,5 +13,6 @@ export declare enum Source {
     CLOUD_WEBHOOK = "cloud-webhook",
     HEARTBEAT = "heartbeat",
     CODE_ACTION = "code-action",
-    DEVICE_ACTION = "device-action"
+    DEVICE_ACTION = "device-action",
+    SYSTEM = "system"
 }

package/dist/constants/Service.js

@@ -17,4 +17,5 @@ var Source;
     Source["HEARTBEAT"] = "heartbeat";
     Source["CODE_ACTION"] = "code-action";
     Source["DEVICE_ACTION"] = "device-action";
+    Source["SYSTEM"] = "system";
 })(Source || (exports.Source = Source = {}));

package/dist/entities/device/local/interfaces/IDevice.d.ts

@@ -74,7 +74,7 @@ export interface IQueryDevice {
     deviceIds?: string[];
     propertyId?: string;
     hubId?: string;
-    deviceType?: string;
+    deviceType?: string | string[];
     excludeDeviceType?: string | string[];
     connectionId?: string;
 }

package/dist/entities/device/local/repository/Device.repository.d.ts

@@ -11,7 +11,6 @@ export declare class DeviceRepository {
     deleteDevice(deviceId: string): Promise<void>;
     getDevices(deviceIds: string[], withHubDetails?: boolean): Promise<IDevice[]>;
     getPropertyDevices(propertyId: string, selectDeviceId?: boolean, type?: string, withHubDetails?: boolean): Promise<IDevice[]>;
-    getPropertyDeviceIds(propertyId: string, selectDeviceId: boolean | undefined, manufacturer: string): Promise<any>;
     getState(deviceId: string): Promise<any>;
     setState(deviceId: string, state: any): Promise<any>;
     getStatus(deviceId: string): Promise<Record<string, any>>;

package/dist/entities/device/local/repository/Device.repository.js

@@ -129,18 +129,6 @@ let DeviceRepository = (() => {
                 throw new Error(`Failed to get property devices: ${error.message || "Unknown error"}`);
             }
         }
-        async getPropertyDeviceIds(propertyId, selectDeviceId = false, manufacturer) {
-            try {
-                const response = await this.axiosInstance.get(`/devices`, {
-                    params: { propertyId, selectDeviceId, manufacturer },
-                });
-                return response.data;
-            }
-            catch (error) {
-                (0, config_1.getConfig)().LOGGER.error(`Failed to get property device IDs for ${propertyId}:`, error);
-                throw new Error(`Failed to get property device IDs: ${error.message || "Unknown error"}`);
-            }
-        }
         async getState(deviceId) {
             try {
                 const response = await this.axiosInstance.get(`/devices/${deviceId}/state`);

package/dist/entities/device/local/services/Device.service.d.ts

@@ -12,7 +12,6 @@ export declare class LocalDeviceService {
     getDevice(deviceId: string, withHubDetails?: boolean): Promise<IDevice>;
     getDevices(deviceIds: string[], withHubDetails?: boolean): Promise<IDevice[]>;
     getPropertyDevices(propertyId: string, selectDeviceId?: boolean, type?: string, withHubDetails?: boolean): Promise<IDevice[]>;
-    getPropertyDeviceIds(propertyId: string, selectDeviceId: boolean | undefined, type: string): Promise<any>;
     updateDevice(deviceId: string, body: Partial<IDevice>, auditBody: IAuditProperties): Promise<any>;
     updateDevices(query: any, updateData: any): Promise<any>;
     deleteDevice(deviceId: string, auditBody: IAuditProperties): Promise<any>;
@@ -29,7 +28,6 @@ export declare class LocalDeviceService {
     private shouldUpdateBatteryLevel;
     updateBatteryState(deviceId: string, batteryState: any): Promise<void>;
     private getPropertyBatteryThreshold;
-    private checkForDeviceMalfunctions;
     getMetaData(deviceId: string): Promise<any>;
     setMetaData(deviceId: string, metaData: Record<string, any>, auditBody: IAuditProperties): Promise<any>;
     getDevicesByZone(zoneId: string): Promise<import("../interfaces").IDtDevice[]>;

package/dist/entities/device/local/services/Device.service.js

@@ -121,12 +121,6 @@ let LocalDeviceService = (() => {
             }
             return await this.deviceRepository.getPropertyDevices(propertyId, selectDeviceId, type, withHubDetails);
         }
-        async getPropertyDeviceIds(propertyId, selectDeviceId = false, type) {
-            if (!propertyId) {
-                throw new Error("Property ID is required");
-            }
-            return await this.deviceRepository.getPropertyDeviceIds(propertyId, selectDeviceId, type);
-        }
         async updateDevice(deviceId, body, auditBody) {
             if (!deviceId) {
                 throw new Error("Device ID is required");
@@ -139,6 +133,13 @@ let LocalDeviceService = (() => {
                 const auditType = body?.status?.online
                     ? constants_1.DT_EVENT_TYPES.DEVICE.STATUS.ONLINE
                     : constants_1.DT_EVENT_TYPES.DEVICE.STATUS.OFFLINE;
+                if (body?.status?.online) {
+                    await this.handleOnlineStatus(device, device.status, body.status, auditBody?.source || Service_1.Source.SYSTEM, auditBody);
+                }
+                else {
+                    await this.handleOfflineStatus(device, device.status, body.status, auditBody?.source || Service_1.Source.SYSTEM, auditBody);
+                }
+                await this.setBatteryLevel(deviceId, body.state?.batteryPercentage?.value, auditBody?.source || Service_1.Source.SYSTEM, auditBody);
                 (0, audit_1.pushAudit)({
                     auditType,
                     auditData: {
@@ -165,7 +166,20 @@ let LocalDeviceService = (() => {
                     ? constants_1.DT_EVENT_TYPES.DEVICE.STATUS.ONLINE
                     : constants_1.DT_EVENT_TYPES.DEVICE.STATUS.OFFLINE;
                 const devices = await this.deviceRepository.queryDevices(query);
-                devices.forEach((device) => {
+                for (const device of devices) {
+                    const auditBody = {
+                        source: Service_1.Source.DEVICE_ACTION,
+                        resource: IAuditProperties_1.Resource.DEVICE,
+                        propertyId: device.propertyId,
+                        zoneId: device.zoneId,
+                        deviceId: device.deviceId,
+                    };
+                    if (updateData?.status?.online) {
+                        await this.handleOnlineStatus(device, device.status, updateData.status, Service_1.Source.DEVICE_ACTION, auditBody);
+                    }
+                    else {
+                        await this.handleOfflineStatus(device, device.status, updateData.status, Service_1.Source.DEVICE_ACTION, auditBody);
+                    }
                     (0, audit_1.pushAudit)({
                         auditType,
                         auditData: {
@@ -181,7 +195,7 @@ let LocalDeviceService = (() => {
                             newStatus: updateData.status,
                         },
                     });
-                });
+                }
             }
             return await this.deviceRepository.updateDevices(query, updateData);
         }
@@ -224,8 +238,8 @@ let LocalDeviceService = (() => {
             const oldStatus = device.status;
             const currentTime = new Date().toISOString();
             // Determine if the new status is ONLINE or OFFLINE
-            const isNewStatusOnline = newStatus.liveStatus === "ONLINE";
-            const isNewStatusOffline = newStatus.liveStatus === "OFFLINE";
+            const isNewStatusOnline = newStatus?.liveStatus === "ONLINE";
+            const isNewStatusOffline = newStatus?.liveStatus === "OFFLINE";
             if (isNewStatusOffline) {
                 // New Status = OFFLINE
                 await this.handleOfflineStatus(device, oldStatus, newStatus, source, auditBody, reason, currentTime);
@@ -249,6 +263,15 @@ let LocalDeviceService = (() => {
             const eventType = newStatus.online
                 ? constants_1.DT_EVENT_TYPES.DEVICE.STATUS.ONLINE
                 : constants_1.DT_EVENT_TYPES.DEVICE.STATUS.OFFLINE;
+            const devices = await this.deviceRepository.queryDevices(query);
+            for (const device of devices) {
+                if (newStatus.online) {
+                    await this.handleOnlineStatus(device, device.status, newStatus, source, auditBody);
+                }
+                else {
+                    await this.handleOfflineStatus(device, device.status, newStatus, source, auditBody);
+                }
+            }
             await this.deviceRepository.setStatusMany(query, newStatus);
             await this.eventHandler.onStatusChangeMany(query, newStatus, auditBody, eventType);
         }
@@ -286,8 +309,6 @@ let LocalDeviceService = (() => {
                     };
                     await this.deviceRepository.setStatus(device.deviceId, newStatus);
                     await this.eventHandler.onStatusChange(device.deviceId, newStatus, auditBody, constants_1.DT_EVENT_TYPES.DEVICE.STATUS.OFFLINE);
-                    // Raise alert (OPERATIONAL only)
-                    // await this.alertService.raiseDeviceOfflineAlert(device, source, reason);
                     // Raise issue when the device goes offline if longer than the baseline (OPERATIONAL only)
                     await this.issueService.createDeviceOfflineIssue(device, source, reason);
                 }
@@ -310,9 +331,14 @@ let LocalDeviceService = (() => {
                     newStatus.error = {}; // Clear the error
                     await this.deviceRepository.setStatus(device.deviceId, newStatus);
                     await this.eventHandler.onStatusChange(device.deviceId, newStatus, auditBody, constants_1.DT_EVENT_TYPES.DEVICE.STATUS.ONLINE);
-                    //TODO: ALERT NEEDED?
-                    //  Raise alert
-                    // await this.alertService.raiseDeviceOnlineAlert(device, source, reason);
+                    // Resolve issue if exists
+                    await this.issueService.performIssueAction({
+                        entityId: device.deviceId,
+                        entityType: issue_types_1.EntityType.DEVICE,
+                        type: issue_types_1.IssueType.DEVICE_OFFLINE,
+                        propertyId: device.propertyId,
+                        zoneId: device.zoneId,
+                    }, "resolve", source);
                 }
             }
             else if (isExistingStatusOffline) {
@@ -323,9 +349,14 @@ let LocalDeviceService = (() => {
                 newStatus.error = undefined; // Clear the error
                 await this.deviceRepository.setStatus(device.deviceId, newStatus);
                 await this.eventHandler.onStatusChange(device.deviceId, newStatus, auditBody, constants_1.DT_EVENT_TYPES.DEVICE.STATUS.ONLINE);
-                //TODO: ALERT NEEDED?
-                //  Raise alert
-                // await this.alertService.raiseDeviceOnlineAlert(device, source, reason);
+                //Resolve issue if exists
+                await this.issueService.performIssueAction({
+                    entityId: device.deviceId,
+                    entityType: issue_types_1.EntityType.DEVICE,
+                    type: issue_types_1.IssueType.DEVICE_OFFLINE,
+                    propertyId: device.propertyId,
+                    zoneId: device.zoneId,
+                }, "resolve", source);
             }
         }
         async getDeviceBaseline(deviceId) {
@@ -347,43 +378,40 @@ let LocalDeviceService = (() => {
             // Get device information
             const device = await this.getDevice(deviceId);
             // Fetch the old battery level state
-            const oldBatteryLevel = device.state?.batteryPercentage;
+            const oldBatteryState = device.state?.batteryPercentage;
             // Check if battery level has changed
-            const isDifferent = !(0, lodash_1.isEqual)(oldBatteryLevel?.value, batteryLevel);
+            const isDifferent = !(0, lodash_1.isEqual)(oldBatteryState?.value, batteryLevel);
             if (isDifferent) {
                 // Check if current time is greater than or equal to last updated time (8-hour logic)
-                const shouldUpdate = this.shouldUpdateBatteryLevel(oldBatteryLevel?.lastUpdated);
+                const shouldUpdate = this.shouldUpdateBatteryLevel(oldBatteryState?.lastUpdated);
                 if (shouldUpdate) {
                     // Save the battery level in the device
                     await this.deviceRepository.setBatteryLevel(deviceId, batteryLevel);
                     await this.eventHandler.onBatteryLevelChange(deviceId, batteryLevel, auditBody);
-                    if (oldBatteryLevel?.value < batteryLevel &&
-                        batteryLevel - oldBatteryLevel?.value > 10) {
-                        // Battery level has increased (considering as battery has been replaced)
-                        await this.eventHandler.onBatteryReplaced(deviceId, batteryLevel, auditBody);
-                    }
-                    // Additional condition: if battery level is less than 50, update battery state to "replace"
-                    if (batteryLevel < 50) {
+                    if (oldBatteryState?.value < batteryLevel &&
+                        batteryLevel - oldBatteryState?.value > 50) {
+                        // Battery level has increased more than 50% (considering as battery has been replaced)
                         const batteryState = {
                             batteryState: {
-                                value: "replace",
+                                value: "replaced",
                                 lastUpdated: new Date().toISOString(),
                             },
                         };
                         await this.updateBatteryState(deviceId, batteryState);
-                        await this.eventHandler.onBatteryStateChange(deviceId, batteryState, auditBody);
+                        await this.eventHandler.onBatteryReplaced(deviceId, batteryLevel, auditBody);
+                        // Cancel any existing battery issue
+                        await this.issueService.performIssueAction({
+                            entityId: deviceId,
+                            entityType: issue_types_1.EntityType.DEVICE,
+                            type: issue_types_1.IssueType.BATTERY_LOW,
+                            propertyId: device.propertyId,
+                            zoneId: device.zoneId,
+                        }, "resolve", source);
                     }
                     // Get property threshold
                     const propertyThreshold = await this.getPropertyBatteryThreshold(device.propertyId);
                     // Check if battery level is below threshold
                     if (batteryLevel < propertyThreshold) {
-                        // Raise alert
-                        // await this.alertService.raiseDeviceBatteryAlert(
-                        //   device,
-                        //   batteryLevel,
-                        //   propertyThreshold,
-                        //   source
-                        // );
                         // Raise issue when the level is below threshold
                         await this.issueService.createDeviceBatteryIssue(device, batteryLevel, propertyThreshold, issue_types_1.IssuePriority.CRITICAL, source);
                     }
@@ -415,37 +443,6 @@ let LocalDeviceService = (() => {
             }
             return preferences?.settings?.batteryPreference?.value ?? 20;
         }
-        async checkForDeviceMalfunctions(device, source, reason) {
-            // TODO: Implement device malfunction detection logic
-            // This should check for:
-            // - Lock jammed
-            // - Device not accepting codes
-            // - Other malfunction indicators
-            // For now, we'll check if the reason indicates a malfunction
-            const malfunctionIndicators = [
-                "jammed",
-                "not accepting codes",
-                "malfunction",
-                "error",
-                "failure",
-            ];
-            const hasMalfunction = malfunctionIndicators.some((indicator) => reason?.toLowerCase().includes(indicator));
-            // if (hasMalfunction) {
-            //   // Raise alert for device malfunction (READINESS + OPERATIONAL)
-            //   await this.alertService.raiseDeviceIssueAlert(
-            //     device,
-            //     "Device Malfunction Detected",
-            //     source,
-            //     reason
-            //   );
-            //   // Raise issue for device malfunction (READINESS + OPERATIONAL)
-            //   await this.issueService.createDeviceMalfunctionIssue(
-            //     device,
-            //     source,
-            //     reason
-            //   );
-            // }
-        }
         async getMetaData(deviceId) {
             if (!deviceId) {
                 throw new Error("Device ID is required");

package/dist/events/EventHandler.d.ts

@@ -9,7 +9,6 @@ export declare class EventHandler {
     onStatusChange(deviceId: string, status: any, auditProperties: IAuditProperties, eventType: any): Promise<void>;
     onStatusChangeMany(query: IStatusQuery, status: IStatus, auditProperties: IAuditProperties, eventType: any): Promise<void>;
     onBatteryLevelChange(deviceId: string, batteryLevel: number, auditProperties: IAuditProperties): Promise<void>;
-    onBatteryStateChange(deviceId: string, batteryState: any, auditProperties: IAuditProperties): Promise<void>;
     onBatteryReplaced(deviceId: string, batteryLevel: number, auditProperties: IAuditProperties): Promise<void>;
     onDeviceMetaChange(deviceId: string, metaData: Record<string, any>, auditProperties: IAuditProperties): Promise<void>;
 }

package/dist/events/EventHandler.js

@@ -125,16 +125,6 @@ let EventHandler = (() => {
                 },
             });
         }
-        async onBatteryStateChange(deviceId, batteryState, auditProperties) {
-            await (0, audit_1.pushAudit)({
-                auditType: Event_1.DT_EVENT_TYPES.DEVICE.BATTERY.STATE.REPLACE,
-                auditData: {
-                    deviceId,
-                    batteryState,
-                    ...auditProperties,
-                },
-            });
-        }
         async onBatteryReplaced(deviceId, batteryLevel, auditProperties) {
             await (0, audit_1.pushAudit)({
                 auditType: Event_1.DT_EVENT_TYPES.DEVICE.BATTERY.REPLACED,

package/dist/issues/Issue.service.d.ts

@@ -1,5 +1,5 @@
 import { IIssueDocument } from "./Issue.model";
-import { CreateIssueData, UpdateIssueData, AddCommentData, IssuePriority, IssuesCategory, EntityType, IIssueQuery, IssueType } from "./issue.types";
+import { CreateIssueData, UpdateIssueData, AddCommentData, IssuePriority, IssuesCategory, EntityType, EntitySubType, IIssueQuery, IssueType } from "./issue.types";
 import { IssueBuilder } from "./IssueBuilder";
 import { Source } from "../constants/Service";
 import { IDevice } from "../entities/device/local/interfaces";
@@ -47,10 +47,25 @@ export declare class IssueService {
      * Create issue for device battery level below threshold (READINESS + OPERATIONAL + ENERGY)
      */
     createDeviceBatteryIssue(device: IDevice, batteryLevel: number, threshold: number, priority: IssuePriority, source: Source): Promise<IIssueDocument | null>;
+    createAccountMissingDeviceIssue(device: {
+        deviceId: string;
+        deviceType: {
+            type: any;
+        };
+        propertyId: string;
+        name: string;
+    }, source: Source, reason?: string): Promise<IIssueDocument | null>;
+    createAccountUnauthorizedIssue(account: {
+        accountId: string;
+        accountType: EntitySubType;
+        propertyId: string;
+        name: string;
+    }, source: Source, reason?: string): Promise<IIssueDocument | null>;
     /**
      * Create issue for device malfunction (jammed or not accepting codes) (READINESS + OPERATIONAL)
      */
     createDeviceMalfunctionIssue(device: IDevice, source: Source, reason?: string): Promise<IIssueDocument | null>;
+    createLockJammedIssue(device: IDevice, source: Source): Promise<IIssueDocument | null>;
     /**
      * Create a maintenance issue using IssueBuilder
      */
@@ -113,7 +128,7 @@ export declare class IssueService {
      */
     unassignIssue(id: string, unassignedBy: string): Promise<IIssueDocument | null>;
     /**
-     * Cancel/Close/Resolve an issue based on query
+     * Cancel/Close/Resolve/Ignore/In_Progress/On_Hold an issue based on query
      * This method will find an issue matching the query and update its status
      */
     performIssueAction(query: IIssueQuery, action: "cancel" | "close" | "resolve" | "ignore" | "in_progress" | "on_hold", updatedBy: string): Promise<IIssueDocument | null>;

package/dist/issues/Issue.service.js

@@ -243,38 +243,18 @@ let IssueService = (() => {
                 entitySubType: device.deviceType.type,
                 propertyId: device.propertyId,
                 zoneId: device.zoneId,
-                title: "Device Offline - Requires Attention",
+                title: device.deviceType.type.toLowerCase() === "hub"
+                    ? "Hub Offline"
+                    : "Device Offline",
                 description: `${device.name} has been offline for longer than the threshold time. ${reason ? `Reason: ${reason}.` : ""}`,
                 createdBy: source,
                 category: issue_types_1.IssuesCategory.OPERATIONS,
                 priority: issue_types_1.IssuePriority.CRITICAL,
-                type: issue_types_1.IssueType.DEVICE_OFFLINE,
+                type: device.deviceType.type.toLowerCase() === "hub"
+                    ? issue_types_1.IssueType.HUB_OFFLINE
+                    : issue_types_1.IssueType.DEVICE_OFFLINE,
             });
         }
-        // async createDoorLeftOpenIssue(
-        //   device: IDevice,
-        //   source: Source,
-        //   reason?: string
-        // ): Promise<IIssueDocument | null> {
-        //   const zone = await Container.get(AdminService).getZone(device.zoneId);
-        //   return await this.createDeviceIssue({
-        //     entityId: device.deviceId,
-        //     entityType: EntityType.DEVICE,
-        //     entitySubType: device.deviceType.type as EntitySubType,
-        //     propertyId: device.propertyId,
-        //     zoneId: device.zoneId,
-        //     title: "Door Left Open - Requires Attention",
-        //     description: `${
-        //       zone?.name
-        //     } has a door left open, for more than 10 minutes. ${
-        //       reason ? `Reason: ${reason}.` : ""
-        //     }`,
-        //     createdBy: source,
-        //     category: IssuesCategory.SECURITY,
-        //     priority: IssuePriority.HIGH,
-        //     type: IssueType.DOOR_LEFT_OPEN,
-        //   });
-        // }
         /**
          * Create issue for device battery level below threshold (READINESS + OPERATIONAL + ENERGY)
          */
@@ -285,7 +265,7 @@ let IssueService = (() => {
                 entitySubType: device.deviceType.type,
                 propertyId: device.propertyId,
                 zoneId: device.zoneId,
-                title: "Device Battery Low - Requires Attention",
+                title: "Device Battery Low",
                 description: `${device.name} battery level is ${batteryLevel}%, which is below the property threshold of ${threshold}%.`,
                 createdBy: source,
                 category: issue_types_1.IssuesCategory.ENERGY,
@@ -293,6 +273,34 @@ let IssueService = (() => {
                 type: issue_types_1.IssueType.BATTERY_LOW,
             });
         }
+        async createAccountMissingDeviceIssue(device, source, reason) {
+            return await this.createIssue({
+                entityId: device.deviceId,
+                entityType: issue_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                title: "Device Missing",
+                description: `${device.name} is missing from the account. ${reason ? `Reason: ${reason}.` : ""}`,
+                createdBy: source,
+                category: issue_types_1.IssuesCategory.OPERATIONS,
+                priority: issue_types_1.IssuePriority.CRITICAL,
+                type: issue_types_1.IssueType.ACCOUNT_MISSING_DEVICE,
+            });
+        }
+        async createAccountUnauthorizedIssue(account, source, reason) {
+            return await this.createIssue({
+                entityId: account.accountId,
+                entityType: issue_types_1.EntityType.CLOUD_DEVICE_ACCOUNT,
+                entitySubType: account.accountType,
+                propertyId: account.propertyId,
+                title: "Account re-authorization required",
+                description: `${account.name}'s authorization has expired. Please re-authorize the account. ${reason ? `Reason: ${reason}.` : ""}`,
+                createdBy: source,
+                category: issue_types_1.IssuesCategory.OPERATIONS,
+                priority: issue_types_1.IssuePriority.CRITICAL,
+                type: issue_types_1.IssueType.ACCOUNT_UNAUTHORIZED,
+            });
+        }
         /**
          * Create issue for device malfunction (jammed or not accepting codes) (READINESS + OPERATIONAL)
          */
@@ -303,7 +311,7 @@ let IssueService = (() => {
                 entitySubType: device.deviceType.type,
                 propertyId: device.propertyId,
                 zoneId: device.zoneId,
-                title: `Device Malfunction - Requires Attention`,
+                title: `Device Malfunction`,
                 description: `${device.name} is malfunctioning. ${reason ? `Reason: ${reason}.` : ""}`,
                 createdBy: source,
                 category: issue_types_1.IssuesCategory.OPERATIONS,
@@ -311,6 +319,21 @@ let IssueService = (() => {
                 type: issue_types_1.IssueType.DEVICE_MALFUNCTION,
             });
         }
+        async createLockJammedIssue(device, source) {
+            return await this.createDeviceIssue({
+                entityId: device.deviceId,
+                entityType: issue_types_1.EntityType.DEVICE,
+                entitySubType: device.deviceType.type,
+                propertyId: device.propertyId,
+                zoneId: device.zoneId,
+                title: "Lock Jammed",
+                description: `${device.name} is jammed. Requires Immediate Attention.`,
+                createdBy: source,
+                category: issue_types_1.IssuesCategory.OPERATIONS,
+                priority: issue_types_1.IssuePriority.HIGH,
+                type: issue_types_1.IssueType.LOCK_JAMMED,
+            });
+        }
         /**
          * Create a maintenance issue using IssueBuilder
          */
@@ -647,7 +670,7 @@ let IssueService = (() => {
             return await issueModel.save();
         }
         /**
-         * Cancel/Close/Resolve an issue based on query
+         * Cancel/Close/Resolve/Ignore/In_Progress/On_Hold an issue based on query
          * This method will find an issue matching the query and update its status
          */
         async performIssueAction(query, action, updatedBy) {
@@ -913,10 +936,11 @@ let IssueService = (() => {
         applyBusinessRules(filters) {
             // Business logic: Apply additional filters based on business rules
             const enhancedFilters = { ...filters };
-            // Example: Always exclude cancelled issues unless explicitly requested
-            if (!enhancedFilters.status ||
-                enhancedFilters.status !== issue_types_1.IssueStatus.CANCELLED) {
-                enhancedFilters.status = { $ne: issue_types_1.IssueStatus.CANCELLED };
+            // Always exclude cancelled, resolved, and closed issues unless explicitly requested
+            if (!enhancedFilters.status) {
+                enhancedFilters.status = {
+                    $nin: [issue_types_1.IssueStatus.CANCELLED, issue_types_1.IssueStatus.RESOLVED, issue_types_1.IssueStatus.CLOSED],
+                };
             }
             return enhancedFilters;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dt-common-device",
-  "version": "7.4.0",
+  "version": "7.6.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [