dsc-itv2-client 2.0.0 → 2.0.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsc-itv2-client",
   "author": "fajitacat",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Reverse engineered DSC ITV2 Protocol Client Library for TL280/TL280E - Monitor and control DSC Neo alarm panels with real-time zone/partition status, arming, and trouble detail",
   "main": "src/index.js",
   "type": "module",

package/src/ITV2Client.js

@@ -566,6 +566,9 @@ export class ITV2Client extends EventEmitter {
             case CMD.TROUBLE_DETAIL:
                 this._handleTroubleDetail(parsed);
                 break;
+            case CMD.NOTIFICATION_EXIT_DELAY:
+                this._handleExitDelayNotification(parsed);
+                break;
             case CMD.NOTIFICATION_ARMING:
                 this._handleArmingNotification(parsed);
                 break;
@@ -1251,6 +1254,45 @@ export class ITV2Client extends EventEmitter {
 
     // ==================== Notification Handlers ====================
 
+    _handleExitDelayNotification(parsed) {
+        // 0x0230 NotificationExitDelay (from neohub):
+        // [CompactInt:Partition][DelayFlags:1B][CompactInt:DurationInSeconds]
+        // Flags: 0x01=Audible, 0x02=Restarted, 0x04=Urgency, 0x80=Active
+        const fullPayload = this._reconstructPayload(parsed);
+        if (!fullPayload || fullPayload.length < 4) {
+            this._ack();
+            return;
+        }
+
+        try {
+            let offset = 0;
+            const partition = ITv2Session.decodeVarBytes(fullPayload, offset);
+            offset += partition.bytesRead;
+            const flags = fullPayload[offset++];
+            const duration = ITv2Session.decodeVarBytes(fullPayload, offset);
+
+            const active = !!(flags & 0x80);
+            const audible = !!(flags & 0x01);
+            const restarted = !!(flags & 0x02);
+            const urgent = !!(flags & 0x04);
+
+            this._logMinimal(`[Partition ${partition.value}] Exit delay: ${duration.value}s${active ? ' ACTIVE' : ' ENDED'}${audible ? ' (audible)' : ''}`);
+
+            this.emit('partition:exitDelay', {
+                partition: partition.value,
+                duration: duration.value,
+                active,
+                audible,
+                restarted,
+                urgent,
+            });
+        } catch (e) {
+            this._log(`[Exit Delay] Parse error: ${e.message}`);
+        }
+
+        this._ack();
+    }
+
     _handleArmingNotification(parsed) {
         // NotificationArmDisarm (neohub format, IMessageData NOT CommandMessageBase):
         // [CompactInt:Partition][ArmMode:1B][Method:1B][CompactInt:UserId]
@@ -1287,6 +1329,13 @@ export class ITV2Client extends EventEmitter {
                 method,
                 userId,
             });
+
+            // Convenience events
+            if (armMode === 0) {
+                this.emit('partition:disarmed', partition.value);
+            } else {
+                this.emit('partition:armed', partition.value, modeName);
+            }
         } catch (e) {
             this._log(`[Arming Notification] Parse error: ${e.message}`);
         }

package/src/examples/arm-disarm-example.js

@@ -56,14 +56,9 @@ client.on('zone:closed', (zone) => {
   if (sessionEstablished) rl.prompt();
 });
 
-// Partition events (these would be emitted when the panel confirms arming/disarming)
-client.on('partition:armed', (partition, mode) => {
-  console.log(`\n🛡️  Partition ${partition} ARMED (mode: ${mode})`);
-  if (sessionEstablished) rl.prompt();
-});
-
-client.on('partition:disarmed', (partition) => {
-  console.log(`\n🔓 Partition ${partition} DISARMED`);
+// Partition events
+client.on('partition:arming', ({ partition, modeName }) => {
+  console.log(`\n🛡️  Partition ${partition}: ${modeName}`);
   if (sessionEstablished) rl.prompt();
 });
 

package/src/itv2-session.js

@@ -107,8 +107,8 @@ export const CMD = {
   NOTIFICATION_PARTITION_READY: 0x0239,
   NOTIFICATION_PARTITION_TROUBLE: 0x023F,
   ZONE_ALARM_STATUS: 0x0840,
-  // General notification event
-  GENERAL_NOTIFICATION: 0x0230,
+  // Notification events
+  NOTIFICATION_EXIT_DELAY: 0x0230,
   DATA_UPDATE_NOTIFICATION: 0x0231,
 };