fix(alarms): Declare Get Alarm Response for getAlarm

getAlarm had no response, so with response matching by command its Get
Alarm Response (0x01) no longer resolved the call. Before, it only
resolved by TSN, parsed as resetAllAlarms with no args. Status-dependent
payload per ZCL R8 3.11.2.5.1.

Author: RobinBol

index.d.ts

@@ -490,7 +490,12 @@ declare module "zigbee-clusters" {
         timeout?: number,
         disableDefaultResponse?: boolean,
       },
-    ): Promise<void>;
+    ): Promise<{
+      status?: types.ZCLEnum8Status,
+      alarmCode?: number,
+      clusterId?: number,
+      timeStamp?: number,
+    }>;
     resetAlarmLog(
       args?: {
         manufacturerId?: number,

lib/clusters/alarms.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const Cluster = require('../Cluster');
+const { ZCLDataTypes } = require('../zclTypes');
 
 const ATTRIBUTES = {};
 
@@ -10,6 +11,17 @@ const COMMANDS = {
   },
   getAlarm: {
     id: 2,
+    response: {
+      id: 1,
+      encodeMissingFieldsBehavior: 'skip',
+      args: {
+        status: ZCLDataTypes.enum8Status,
+        // Remaining fields only present when status is SUCCESS
+        alarmCode: ZCLDataTypes.uint8,
+        clusterId: ZCLDataTypes.uint16,
+        timeStamp: ZCLDataTypes.uint32,
+      },
+    },
   },
   resetAlarmLog: {
     id: 3,

test/testClusterResponseTimeout.js

@@ -7,6 +7,7 @@ const sinon = require('sinon');
 const Node = require('../lib/Node');
 const BoundCluster = require('../lib/BoundCluster');
 const OnOffCluster = require('../lib/clusters/onOff');
+const AlarmsCluster = require('../lib/clusters/alarms');
 
 const sandbox = sinon.createSandbox();
 
@@ -127,4 +128,32 @@ describe('Cluster Response Timeout', function() {
     assert.deepStrictEqual(reportedValues, [true]);
     assert.strictEqual(result, undefined);
   });
+
+  it('should resolve getAlarm with a Get Alarm Response alone', async function() {
+    const pair = [AlarmsCluster.ID];
+    const sender = new Node({
+      // eslint-disable-next-line no-use-before-define
+      sendFrame: (...args) => receiver.handleFrame(...args),
+      endpointDescriptors: [{ endpointId: 1, inputClusters: pair }],
+    });
+    const receiver = new Node({
+      sendFrame: (...args) => sender.handleFrame(...args),
+      endpointDescriptors: [{ endpointId: 1, inputClusters: pair }],
+    });
+    receiver.endpoints[1].bind('alarms', new class extends BoundCluster {
+
+      getAlarm() {
+        return {
+          status: 'SUCCESS', alarmCode: 2, clusterId: 6, timeStamp: 1234,
+        };
+      }
+
+    }());
+
+    const { alarms } = sender.endpoints[1].clusters;
+    const response = await alarms.getAlarm(undefined, { timeout: 1000 });
+
+    assert.strictEqual(response.alarmCode, 2);
+    assert.strictEqual(response.timeStamp, 1234);
+  });
 });