dsc-itv2-client 1.0.19 → 1.0.21

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsc-itv2-client",
   "author": "fajitacat",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "Reverse engineered DSC ITV2 Protocol Client Library for TL280R Communicator - Monitor and control DSC alarm panels",
   "main": "src/index.js",
   "type": "module",

package/src/ITV2Client.js

@@ -207,6 +207,49 @@ export class ITV2Client extends EventEmitter {
         this._sendPacket(packet);
     }
 
+    // ==================== Authentication Methods ====================
+
+    /**
+     * Authenticate with access code - simple format (0x0400)
+     * Uses 6-digit ASCII format matching interactive CLI
+     * @param {string} code - User/master code (e.g., "5555")
+     */
+    authenticate(code) {
+        if (!this._checkEstablished()) return;
+        const codeStr = (code || this.masterCode).toString().padStart(6, '0').slice(0, 6);
+        const payload = Buffer.from(codeStr, 'ascii');
+        const packet = this.session.buildCommand(0x0400, payload);
+        this._sendPacket(packet);
+    }
+
+    /**
+     * Authenticate with access code - extended format (0x0400)
+     * Includes partition and access level metadata
+     * @param {number} partition - Partition number (1-8, or 0 for all)
+     * @param {string} code - User/master code (e.g., "5555")
+     * @param {number} accessLevel - 0=User, 1=Installer, 2=Master
+     */
+    authenticateExtended(partition = 1, code, accessLevel = 0) {
+        if (!this._checkEstablished()) return;
+        const packet = this.session.buildAccessLevelEnter(
+            code || this.masterCode,
+            partition,
+            accessLevel,
+            'bcd'
+        );
+        this._sendPacket(packet);
+    }
+
+    /**
+     * Exit authenticated access level (0x0401)
+     * @param {number} partition - Partition number
+     */
+    deauthenticate(partition = 1) {
+        if (!this._checkEstablished()) return;
+        const packet = this.session.buildAccessLevelExit(partition);
+        this._sendPacket(packet);
+    }
+
     // ==================== State Accessors ====================
 
     /**