feat: add schema 47 driver commands (2/4)

Add new driver commands: softResetAndRestart, enterBootloader,
leaveBootloader, getSupportedCCVersion, getSafeCCVersion,
updateUserAgent, enableFrequentRSSIMonitoring, and
disableFrequentRSSIMonitoring.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: raman325

API_SCHEMA.md

@@ -122,3 +122,5 @@ Base schema.
 - Added controller state properties: `isSIS`, `maxPayloadSize`, `maxPayloadSizeLR`, `zwaveApiVersion`, `zwaveChipType`
 - Added driver events: `all nodes ready`, `error`, `bootloader ready`
 - Added controller events: `network found`, `network joined`, `network left`, `joining network failed`, `leaving network failed`
+- Added driver commands: `soft_reset_and_restart`, `enter_bootloader`, `leave_bootloader`, `get_supported_cc_version`, `get_safe_cc_version`, `update_user_agent`, `enable_frequent_rssi_monitoring`, `disable_frequent_rssi_monitoring`
+- Automatic ZIP extraction for firmware update commands

README.md

@@ -443,7 +443,7 @@ interface {
 }
 ```
 
-If `fileFormat` is not provided in Option 1, the format will be guessed based on the filename and file payload.
+If `fileFormat` is not provided in Option 1, the format will be guessed based on the filename and file payload. If guessing fails, the server will automatically attempt to extract firmware from a ZIP archive.
 
 Returns:
 
@@ -472,6 +472,102 @@ interface {
 }
 ```
 
+#### [Soft Reset and Restart](https://zwave-js.github.io/node-zwave-js/#/api/driver?id=softresetandrestart)
+
+[compatible with schema version: 47+]
+
+```ts
+interface {
+  messageId: string;
+  command: "driver.soft_reset_and_restart";
+}
+```
+
+#### [Enter Bootloader](https://zwave-js.github.io/node-zwave-js/#/api/driver?id=enterbootloader)
+
+[compatible with schema version: 47+]
+
+```ts
+interface {
+  messageId: string;
+  command: "driver.enter_bootloader";
+}
+```
+
+#### [Leave Bootloader](https://zwave-js.github.io/node-zwave-js/#/api/driver?id=leavebootloader)
+
+[compatible with schema version: 47+]
+
+```ts
+interface {
+  messageId: string;
+  command: "driver.leave_bootloader";
+}
+```
+
+#### [Get Supported CC Version](https://zwave-js.github.io/node-zwave-js/#/api/driver?id=getsupportedccversion)
+
+[compatible with schema version: 47+]
+
+```ts
+interface {
+  messageId: string;
+  command: "driver.get_supported_cc_version";
+  cc: CommandClasses;
+  nodeId: number;
+  endpointIndex?: number;
+}
+```
+
+#### [Get Safe CC Version](https://zwave-js.github.io/node-zwave-js/#/api/driver?id=getsafeccversion)
+
+[compatible with schema version: 47+]
+
+```ts
+interface {
+  messageId: string;
+  command: "driver.get_safe_cc_version";
+  cc: CommandClasses;
+  nodeId: number;
+  endpointIndex?: number;
+}
+```
+
+#### [Update User Agent](https://zwave-js.github.io/node-zwave-js/#/api/driver?id=updateuseragent)
+
+[compatible with schema version: 47+]
+
+```ts
+interface {
+  messageId: string;
+  command: "driver.update_user_agent";
+  components: Record<string, string | null | undefined>;
+}
+```
+
+#### [Enable Frequent RSSI Monitoring](https://zwave-js.github.io/node-zwave-js/#/api/driver?id=enablefrequentrssimonitoring)
+
+[compatible with schema version: 47+]
+
+```ts
+interface {
+  messageId: string;
+  command: "driver.enable_frequent_rssi_monitoring";
+  durationMs: number;
+}
+```
+
+#### [Disable Frequent RSSI Monitoring](https://zwave-js.github.io/node-zwave-js/#/api/driver?id=disablefrequentrssimonitoring)
+
+[compatible with schema version: 47+]
+
+```ts
+interface {
+  messageId: string;
+  command: "driver.disable_frequent_rssi_monitoring";
+}
+```
+
 ### Controller level commands
 
 `zwave-js-server` supports all of the controller methods listed in the [Z-Wave JS documentation](https://zwave-js.github.io/node-zwave-js/#/api/controller?id=controller-methods). `zwave-js-server` uses [snake casing](https://en.wikipedia.org/wiki/Snake_case) for commands and prefixes every controller command with `controller.`, so `beginInclusion` is called using the `controller.begin_inclusion` command.

src/lib/driver/command.ts

@@ -21,4 +21,18 @@ export enum DriverCommand {
   firmwareUpdateOTW = "driver.firmware_update_otw",
   // Schema version >= 41:
   isOTWFirmwareUpdateInProgress = "driver.is_otw_firmware_update_in_progress",
+  // Undocumented
+  softResetAndRestart = "driver.soft_reset_and_restart",
+  // Undocumented
+  enterBootloader = "driver.enter_bootloader",
+  // Undocumented
+  leaveBootloader = "driver.leave_bootloader",
+  // CC version queries
+  getSupportedCCVersion = "driver.get_supported_cc_version",
+  getSafeCCVersion = "driver.get_safe_cc_version",
+  // User agent
+  updateUserAgent = "driver.update_user_agent",
+  // RSSI monitoring
+  enableFrequentRSSIMonitoring = "driver.enable_frequent_rssi_monitoring",
+  disableFrequentRSSIMonitoring = "driver.disable_frequent_rssi_monitoring",
 }

src/lib/driver/incoming_message.ts

@@ -1,4 +1,4 @@
-import { FirmwareFileFormat, LogConfig } from "@zwave-js/core";
+import { CommandClasses, FirmwareFileFormat, LogConfig } from "@zwave-js/core";
 import { DriverCommand } from "./command.js";
 import { IncomingCommandBase } from "../incoming_message_base.js";
 import {
@@ -110,6 +110,52 @@ export interface IncomingCommandIsOTWFirmwareUpdateInProgress
   command: DriverCommand.isOTWFirmwareUpdateInProgress;
 }
 
+// Bootloader operations
+interface IncomingCommandSoftResetAndRestart extends IncomingCommandBase {
+  command: DriverCommand.softResetAndRestart;
+}
+
+interface IncomingCommandEnterBootloader extends IncomingCommandBase {
+  command: DriverCommand.enterBootloader;
+}
+
+interface IncomingCommandLeaveBootloader extends IncomingCommandBase {
+  command: DriverCommand.leaveBootloader;
+}
+
+// CC version queries
+interface IncomingCommandGetSupportedCCVersion extends IncomingCommandBase {
+  command: DriverCommand.getSupportedCCVersion;
+  cc: CommandClasses;
+  nodeId: number;
+  endpointIndex?: number;
+}
+
+interface IncomingCommandGetSafeCCVersion extends IncomingCommandBase {
+  command: DriverCommand.getSafeCCVersion;
+  cc: CommandClasses;
+  nodeId: number;
+  endpointIndex?: number;
+}
+
+// User agent
+interface IncomingCommandUpdateUserAgent extends IncomingCommandBase {
+  command: DriverCommand.updateUserAgent;
+  components: Record<string, string | null | undefined>;
+}
+
+// RSSI monitoring
+interface IncomingCommandEnableFrequentRSSIMonitoring
+  extends IncomingCommandBase {
+  command: DriverCommand.enableFrequentRSSIMonitoring;
+  durationMs: number;
+}
+
+interface IncomingCommandDisableFrequentRSSIMonitoring
+  extends IncomingCommandBase {
+  command: DriverCommand.disableFrequentRSSIMonitoring;
+}
+
 export type IncomingMessageDriver =
   | IncomingCommandGetConfig
   | IncomingCommandUpdateLogConfig
@@ -130,4 +176,12 @@ export type IncomingMessageDriver =
   | IncomingCommandUpdateOptions
   | IncomingCommandSendTestFrame
   | IncomingCommandFirmwareUpdateOTW
-  | IncomingCommandIsOTWFirmwareUpdateInProgress;
+  | IncomingCommandIsOTWFirmwareUpdateInProgress
+  | IncomingCommandSoftResetAndRestart
+  | IncomingCommandEnterBootloader
+  | IncomingCommandLeaveBootloader
+  | IncomingCommandGetSupportedCCVersion
+  | IncomingCommandGetSafeCCVersion
+  | IncomingCommandUpdateUserAgent
+  | IncomingCommandEnableFrequentRSSIMonitoring
+  | IncomingCommandDisableFrequentRSSIMonitoring;

src/lib/driver/message_handler.ts

@@ -1,10 +1,6 @@
-import {
-  Driver,
-  extractFirmware,
-  guessFirmwareFileFormat,
-  OTWFirmwareUpdateResult,
-} from "zwave-js";
+import { Driver, extractFirmware, OTWFirmwareUpdateResult } from "zwave-js";
 import { UnknownCommandError } from "../error.js";
+import { parseFirmwareFile } from "../common.js";
 import {
   Client,
   ClientsController,
@@ -136,11 +132,12 @@ export class DriverMessageHandler implements MessageHandler {
           result = await this.driver.firmwareUpdateOTW(message.updateInfo);
         } else {
           const file = Buffer.from(message.file, "base64");
-          const { data } = await extractFirmware(
+          const parsed = parseFirmwareFile(
+            message.filename,
             file,
-            message.fileFormat ??
-              guessFirmwareFileFormat(message.filename, file),
+            message.fileFormat,
           );
+          const { data } = await extractFirmware(parsed.rawData, parsed.format);
           result = await this.driver.firmwareUpdateOTW(data);
         }
         return { result };
@@ -149,6 +146,50 @@ export class DriverMessageHandler implements MessageHandler {
         const progress = this.driver.isOTWFirmwareUpdateInProgress();
         return { progress };
       }
+      // Bootloader operations
+      case DriverCommand.softResetAndRestart: {
+        await this.driver.softResetAndRestart();
+        return {};
+      }
+      case DriverCommand.enterBootloader: {
+        await this.driver.enterBootloader();
+        return {};
+      }
+      case DriverCommand.leaveBootloader: {
+        await this.driver.leaveBootloader();
+        return {};
+      }
+      // CC version queries
+      case DriverCommand.getSupportedCCVersion: {
+        const version = this.driver.getSupportedCCVersion(
+          message.cc,
+          message.nodeId,
+          message.endpointIndex,
+        );
+        return { version };
+      }
+      case DriverCommand.getSafeCCVersion: {
+        const version = this.driver.getSafeCCVersion(
+          message.cc,
+          message.nodeId,
+          message.endpointIndex,
+        );
+        return { version };
+      }
+      // User agent
+      case DriverCommand.updateUserAgent: {
+        this.driver.updateUserAgent(message.components);
+        return {};
+      }
+      // RSSI monitoring
+      case DriverCommand.enableFrequentRSSIMonitoring: {
+        this.driver.enableFrequentRSSIMonitoring(message.durationMs);
+        return {};
+      }
+      case DriverCommand.disableFrequentRSSIMonitoring: {
+        this.driver.disableFrequentRSSIMonitoring();
+        return {};
+      }
       default: {
         throw new UnknownCommandError(command);
       }

src/lib/driver/outgoing_message.ts

@@ -28,4 +28,16 @@ export interface DriverResultTypes {
   [DriverCommand.sendTestFrame]: { status?: TransmitStatus };
   [DriverCommand.firmwareUpdateOTW]: OTWFirmwareUpdateResultType;
   [DriverCommand.isOTWFirmwareUpdateInProgress]: { progress: boolean };
+  // Bootloader operations
+  [DriverCommand.softResetAndRestart]: Record<string, never>;
+  [DriverCommand.enterBootloader]: Record<string, never>;
+  [DriverCommand.leaveBootloader]: Record<string, never>;
+  // CC version queries
+  [DriverCommand.getSupportedCCVersion]: { version: number };
+  [DriverCommand.getSafeCCVersion]: { version: number | undefined };
+  // User agent
+  [DriverCommand.updateUserAgent]: Record<string, never>;
+  // RSSI monitoring
+  [DriverCommand.enableFrequentRSSIMonitoring]: Record<string, never>;
+  [DriverCommand.disableFrequentRSSIMonitoring]: Record<string, never>;
 }