zigbee-clusters 2.10.1 → 3.0.1

package/README.md

@@ -15,6 +15,16 @@ Make sure to take a look at the API documentation: [https://athombv.github.io/no
 
 ## Breaking changes
 
+v3.0.0
+
+- **iasZone**: Unified `zoneType` enum keys between attribute and `zoneEnrollRequest` command to match ZCL spec (Table 8-5). See [#176](https://github.com/athombv/node-zigbee-clusters/pull/176) for full impact analysis.
+  - `cabonMonoxideSensor` -> `carbonMonoxideSensor` (typo fix)
+  - `keyfob` -> `keyFob` (spec says "Key fob" - two words)
+  - `standard` -> `standardCIE` (in `zoneEnrollRequest`)
+  - `invalid` -> `invalidZoneType` (in `zoneEnrollRequest`)
+  - `keyPad` -> `keypad` (in `zoneEnrollRequest`, spec says "Keypad" - one word)
+  - Added missing `doorWindowHandle` (0x0016) zone type from spec
+
 v2.0.0
 
 - Changed `Cluster.readAttributes` signature, attributes must now be specified as an array of strings.

package/index.d.ts

@@ -34,6 +34,9 @@ type ZCLNodeConstructorInput = {
 type ZCLEnum8Status = 'SUCCESS' | 'FAILURE' | 'NOT_AUTHORIZED' | 'RESERVED_FIELD_NOT_ZERO' | 'MALFORMED_COMMAND' | 'UNSUP_CLUSTER_COMMAND' | 'UNSUP_GENERAL_COMMAND' | 'UNSUP_MANUF_CLUSTER_COMMAND' | 'UNSUP_MANUF_GENERAL_COMMAND' | 'INVALID_FIELD' | 'UNSUPPORTED_ATTRIBUTE' | 'INVALID_VALUE' | 'READ_ONLY' | 'INSUFFICIENT_SPACE' | 'DUPLICATE_EXISTS' | 'NOT_FOUND' | 'UNREPORTABLE_ATTRIBUTE' | 'INVALID_DATA_TYPE' | 'INVALID_SELECTOR' | 'WRITE_ONLY' | 'INCONSISTENT_STARTUP_STATE' | 'DEFINED_OUT_OF_BAND' | 'INCONSISTENT' | 'ACTION_DENIED' | 'TIMEOUT' | 'ABORT' | 'INVALID_IMAGE' | 'WAIT_FOR_DATA' | 'NO_IMAGE_AVAILABLE' | 'REQUIRE_MORE_IMAGE' | 'NOTIFICATION_PENDING' | 'HARDWARE_FAILURE' | 'SOFTWARE_FAILURE' | 'CALIBRATION_ERROR' | 'UNSUPPORTED_CLUSTER';
 
 export interface ZCLNodeCluster extends EventEmitter {
+  /** Dynamic command handler methods (e.g. `onZoneStatusChangeNotification`). */
+  [key: string]: unknown;
+
   discoverCommandsGenerated(params?: {
     startValue?: number;
     maxResults?: number;
@@ -467,7 +470,7 @@ export interface IASWDCluster extends ZCLNodeCluster {
 
 export interface IASZoneClusterAttributes {
   zoneState?: 'notEnrolled' | 'enrolled';
-  zoneType?: 'standardCIE' | 'motionSensor' | 'contactSwitch' | 'fireSensor' | 'waterSensor' | 'cabonMonoxideSensor' | 'personalEmergencyDevice' | 'vibrationMovementSensor' | 'remoteControl' | 'keyfob' | 'keypad' | 'standardWarningDevice' | 'glassBreakSensor' | 'securityRepeater' | 'invalidZoneType';
+  zoneType?: 'standardCIE' | 'motionSensor' | 'contactSwitch' | 'doorWindowHandle' | 'fireSensor' | 'waterSensor' | 'carbonMonoxideSensor' | 'personalEmergencyDevice' | 'vibrationMovementSensor' | 'remoteControl' | 'keyFob' | 'keypad' | 'standardWarningDevice' | 'glassBreakSensor' | 'securityRepeater' | 'invalidZoneType';
   zoneStatus?: Partial<{ alarm1: boolean; alarm2: boolean; tamper: boolean; battery: boolean; supervisionReports: boolean; restoreReports: boolean; trouble: boolean; acMains: boolean; test: boolean; batteryDefect: boolean }>;
   iasCIEAddress?: string;
   zoneId?: number;
@@ -481,7 +484,7 @@ export interface IASZoneCluster extends ZCLNodeCluster {
   once<K extends keyof IASZoneClusterAttributes & string>(eventName: `attr.${K}`, listener: (value: IASZoneClusterAttributes[K]) => void): this;
   zoneStatusChangeNotification(args: { zoneStatus: Partial<{ alarm1: boolean; alarm2: boolean; tamper: boolean; battery: boolean; supervisionReports: boolean; restoreReports: boolean; trouble: boolean; acMains: boolean; test: boolean; batteryDefect: boolean }>; extendedStatus: number; zoneId: number; delay: number }, opts?: ClusterCommandOptions): Promise<void>;
   zoneEnrollResponse(args: { enrollResponseCode: 'success' | 'notSupported' | 'noEnrollPermit' | 'tooManyZones'; zoneId: number }, opts?: ClusterCommandOptions): Promise<void>;
-  zoneEnrollRequest(args: { zoneType: 'standard' | 'motionSensor' | 'contactSwitch' | 'fireSensor' | 'waterSensor' | 'carbonMonoxideSensor' | 'personalEmergencyDevice' | 'vibrationMovementSensor' | 'remoteControl' | 'keyFob' | 'keyPad' | 'standardWarningDevice' | 'glassBreakSensor' | 'securityRepeater' | 'invalid'; manufacturerCode: number }, opts?: ClusterCommandOptions): Promise<void>;
+  zoneEnrollRequest(args: { zoneType: 'standardCIE' | 'motionSensor' | 'contactSwitch' | 'doorWindowHandle' | 'fireSensor' | 'waterSensor' | 'carbonMonoxideSensor' | 'personalEmergencyDevice' | 'vibrationMovementSensor' | 'remoteControl' | 'keyFob' | 'keypad' | 'standardWarningDevice' | 'glassBreakSensor' | 'securityRepeater' | 'invalidZoneType'; manufacturerCode: number }, opts?: ClusterCommandOptions): Promise<void>;
   initiateNormalOperationMode(opts?: ClusterCommandOptions): Promise<void>;
 }
 

package/lib/clusters/iasZone.js

@@ -5,6 +5,25 @@ const { ZCLDataTypes } = require('../zclTypes');
 
 const ZONE_STATUS_DATA_TYPE = ZCLDataTypes.map16('alarm1', 'alarm2', 'tamper', 'battery', 'supervisionReports', 'restoreReports', 'trouble', 'acMains', 'test', 'batteryDefect');
 
+const ZONE_TYPE_VALUES = {
+  standardCIE: 0x0000,
+  motionSensor: 0x000d,
+  contactSwitch: 0x0015,
+  doorWindowHandle: 0x0016,
+  fireSensor: 0x0028,
+  waterSensor: 0x002a,
+  carbonMonoxideSensor: 0x002b,
+  personalEmergencyDevice: 0x002c,
+  vibrationMovementSensor: 0x002d,
+  remoteControl: 0x010f,
+  keyFob: 0x0115,
+  keypad: 0x021d,
+  standardWarningDevice: 0x0225,
+  glassBreakSensor: 0x0226,
+  securityRepeater: 0x0229,
+  invalidZoneType: 0xffff,
+};
+
 const ATTRIBUTES = {
   zoneState: {
     id: 0,
@@ -15,23 +34,7 @@ const ATTRIBUTES = {
   },
   zoneType: {
     id: 1,
-    type: ZCLDataTypes.enum16({
-      standardCIE: 0,
-      motionSensor: 13,
-      contactSwitch: 21,
-      fireSensor: 40,
-      waterSensor: 42,
-      cabonMonoxideSensor: 43,
-      personalEmergencyDevice: 44,
-      vibrationMovementSensor: 45,
-      remoteControl: 271,
-      keyfob: 277,
-      keypad: 541,
-      standardWarningDevice: 549,
-      glassBreakSensor: 550,
-      securityRepeater: 553,
-      invalidZoneType: 65535,
-    }),
+    type: ZCLDataTypes.enum16(ZONE_TYPE_VALUES),
   },
   zoneStatus: {
     id: 2,
@@ -78,23 +81,7 @@ const COMMANDS = {
     // Add direction property as "initiateNormalOperationMode" has same command id.
     direction: Cluster.DIRECTION_SERVER_TO_CLIENT,
     args: {
-      zoneType: ZCLDataTypes.enum16({
-        standard: 0x0000,
-        motionSensor: 0x000d,
-        contactSwitch: 0x0015,
-        fireSensor: 0x0028,
-        waterSensor: 0x002a,
-        carbonMonoxideSensor: 0x002b,
-        personalEmergencyDevice: 0x002c,
-        vibrationMovementSensor: 0x002d,
-        remoteControl: 0x010f,
-        keyFob: 0x0115,
-        keyPad: 0x021d,
-        standardWarningDevice: 0x0225,
-        glassBreakSensor: 0x0226,
-        securityRepeater: 0x0229,
-        invalid: 0xffff,
-      }),
+      zoneType: ZCLDataTypes.enum16(ZONE_TYPE_VALUES),
       manufacturerCode: ZCLDataTypes.uint16,
     },
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zigbee-clusters",
-  "version": "2.10.1",
+  "version": "3.0.1",
   "description": "Zigbee Cluster Library for Node.js",
   "main": "index.js",
   "types": "index.d.ts",

package/scripts/generate-types.js

@@ -286,6 +286,9 @@ type ZCLEnum8Status = ${zclTypeToTS(ZCLDataTypes.enum8Status, false)};
 
   // Base ZCLNodeCluster interface
   lines.push(`export interface ZCLNodeCluster extends EventEmitter {
+  /** Dynamic command handler methods (e.g. \`onZoneStatusChangeNotification\`). */
+  [key: string]: unknown;
+
   discoverCommandsGenerated(params?: {
     startValue?: number;
     maxResults?: number;