update hap characteristics and services

Author: bwp91

CHANGELOG.md

@@ -9,6 +9,7 @@ All notable changes to `hap-nodejs` will be documented in this file. This projec
 - update readme badges (use `shields.io`) (#1104)
 - update publish workflows for npm oidc auth (#1105)
 - dependency updates
+- update hap characteristics and services
 
 ## v2.0.2 (2025-09-17)
 

src/lib/Characteristic.ts

@@ -39,6 +39,7 @@ import type {
   ColorTemperature,
   ConfigurationState,
   ConfiguredName,
+  ConnectionHealthMonitor,
   ContactSensorState,
   CoolingThresholdTemperature,
   CryptoHash,
@@ -105,6 +106,7 @@ import type {
   MatterFirmwareRevisionNumber,
   MatterFirmwareUpdateStatus,
   MaximumTransmitPower,
+  MediaAccessControlLevel,
   MetricsBufferFullState,
   Model,
   MotionDetected,
@@ -812,6 +814,10 @@ export class Characteristic extends EventEmitter {
    * @group Characteristic Definitions
    */
   public static ConfiguredName: typeof ConfiguredName;
+  /**
+   * @group Characteristic Definitions
+   */
+  public static ConnectionHealthMonitor: typeof ConnectionHealthMonitor;
   /**
    * @group Characteristic Definitions
    */
@@ -1076,6 +1082,10 @@ export class Characteristic extends EventEmitter {
    * @group Characteristic Definitions
    */
   public static MaximumTransmitPower: typeof MaximumTransmitPower;
+  /**
+   * @group Characteristic Definitions
+   */
+  public static MediaAccessControlLevel: typeof MediaAccessControlLevel;
   /**
    * @group Characteristic Definitions
    */
@@ -1493,6 +1503,7 @@ export class Characteristic extends EventEmitter {
   public static SwingMode: typeof SwingMode;
   /**
    * @group Characteristic Definitions
+   * @deprecated Removed
    */
   public static TapType: typeof TapType;
   /**
@@ -1585,6 +1596,7 @@ export class Characteristic extends EventEmitter {
   public static ThreadStatus: typeof ThreadStatus;
   /**
    * @group Characteristic Definitions
+   * @deprecated Removed
    */
   public static Token: typeof Token;
   /**

src/lib/Service.ts

@@ -399,6 +399,7 @@ export class Service extends EventEmitter {
   public static Switch: typeof Switch;
   /**
    * @group Service Definitions
+   * @deprecated Removed
    */
   public static TapManagement: typeof TapManagement;
   /**

src/lib/definitions/CharacteristicDefinitions.spec.ts

@@ -214,6 +214,12 @@ describe("CharacteristicDefinitions", () => {
     });
   });
 
+  describe("ConnectionHealthMonitor", () => {
+    it("should be able to construct", () => {
+      new Characteristic.ConnectionHealthMonitor();
+    });
+  });
+
   describe("ContactSensorState", () => {
     it("should be able to construct", () => {
       new Characteristic.ContactSensorState();
@@ -610,6 +616,12 @@ describe("CharacteristicDefinitions", () => {
     });
   });
 
+  describe("MediaAccessControlLevel", () => {
+    it("should be able to construct", () => {
+      new Characteristic.MediaAccessControlLevel();
+    });
+  });
+
   describe("MetricsBufferFullState", () => {
     it("should be able to construct", () => {
       new Characteristic.MetricsBufferFullState();

src/lib/definitions/CharacteristicDefinitions.ts

@@ -1,5 +1,5 @@
 // THIS FILE IS AUTO-GENERATED - DO NOT MODIFY
-// V=886
+// V=887
 
 import { Access, Characteristic, Formats, Perms, Units } from "../Characteristic";
 
@@ -699,6 +699,23 @@ export class ConfiguredName extends Characteristic {
 }
 Characteristic.ConfiguredName = ConfiguredName;
 
+/**
+ * Characteristic "Connection Health Monitor"
+ */
+export class ConnectionHealthMonitor extends Characteristic {
+
+  public static readonly UUID: string = "00000273-0000-1000-8000-0026BB765291";
+
+  constructor() {
+    super("Connection Health Monitor", ConnectionHealthMonitor.UUID, {
+      format: Formats.TLV8,
+      perms: [Perms.NOTIFY, Perms.PAIRED_READ, Perms.PAIRED_WRITE],
+    });
+    this.value = this.getDefaultValue();
+  }
+}
+Characteristic.ConnectionHealthMonitor = ConnectionHealthMonitor;
+
 /**
  * Characteristic "Contact Sensor State"
  */
@@ -746,6 +763,7 @@ Characteristic.CoolingThresholdTemperature = CoolingThresholdTemperature;
 
 /**
  * Characteristic "Crypto Hash"
+ * @since iOS 14.0
  */
 export class CryptoHash extends Characteristic {
 
@@ -2083,6 +2101,26 @@ export class MaximumTransmitPower extends Characteristic {
 }
 Characteristic.MaximumTransmitPower = MaximumTransmitPower;
 
+/**
+ * Characteristic "Media Access Control Level"
+ */
+export class MediaAccessControlLevel extends Characteristic {
+
+  public static readonly UUID: string = "000000EE-0000-1000-8000-0026BB765291";
+
+  constructor() {
+    super("Media Access Control Level", MediaAccessControlLevel.UUID, {
+      format: Formats.UINT8,
+      perms: [Perms.NOTIFY, Perms.PAIRED_READ, Perms.PAIRED_WRITE],
+      minValue: 0,
+      maxValue: 2,
+      minStep: 1,
+    });
+    this.value = this.getDefaultValue();
+  }
+}
+Characteristic.MediaAccessControlLevel = MediaAccessControlLevel;
+
 /**
  * Characteristic "Metrics Buffer Full State"
  */
@@ -4105,6 +4143,7 @@ Characteristic.SwingMode = SwingMode;
 
 /**
  * Characteristic "Tap Type"
+ * @deprecated Removed
  */
 export class TapType extends Characteristic {
 
@@ -4118,6 +4157,7 @@ export class TapType extends Characteristic {
     this.value = this.getDefaultValue();
   }
 }
+// noinspection JSDeprecatedSymbols
 Characteristic.TapType = TapType;
 
 /**
@@ -4599,6 +4639,7 @@ Characteristic.ThreadStatus = ThreadStatus;
 
 /**
  * Characteristic "Token"
+ * @deprecated Removed
  */
 export class Token extends Characteristic {
 
@@ -4612,6 +4653,7 @@ export class Token extends Characteristic {
     this.value = this.getDefaultValue();
   }
 }
+// noinspection JSDeprecatedSymbols
 Characteristic.Token = Token;
 
 /**

src/lib/definitions/ServiceDefinitions.ts

@@ -1,5 +1,5 @@
 // THIS FILE IS AUTO-GENERATED - DO NOT MODIFY
-// V=886
+// V=887
 
 import { Characteristic } from "../Characteristic";
 import { Service } from "../Service";
@@ -37,6 +37,7 @@ export class AccessControl extends Service {
     this.addCharacteristic(Characteristic.AccessControlLevel);
 
     // Optional Characteristics
+    this.addOptionalCharacteristic(Characteristic.MediaAccessControlLevel);
     this.addOptionalCharacteristic(Characteristic.PasswordSetting);
   }
 }
@@ -108,6 +109,7 @@ export class AccessoryRuntimeInformation extends Service {
 
     // Optional Characteristics
     this.addOptionalCharacteristic(Characteristic.ActivityInterval);
+    this.addOptionalCharacteristic(Characteristic.ConnectionHealthMonitor);
     this.addOptionalCharacteristic(Characteristic.HeartBeat);
     this.addOptionalCharacteristic(Characteristic.SleepInterval);
   }
@@ -1267,6 +1269,7 @@ Service.Switch = Switch;
 
 /**
  * Service "Tap Management"
+ * @deprecated Removed
  */
 export class TapManagement extends Service {
 
@@ -1282,6 +1285,7 @@ export class TapManagement extends Service {
     this.addCharacteristic(Characteristic.Token);
   }
 }
+// noinspection JSDeprecatedSymbols
 Service.TapManagement = TapManagement;
 
 /**

src/lib/definitions/generator-configuration.ts

@@ -212,6 +212,15 @@ export const CharacteristicManualAdditions: Map<string, GeneratedCharacteristic>
     properties: 2, // paired read
     maxLength: 64,
   }],
+  ["crypto-hash", {
+    id: "crypto-hash",
+    UUID: "00000250-0000-1000-8000-0026BB765291",
+    name: "Crypto Hash",
+    className: "CryptoHash",
+    since: "14.0",
+    format: "tlv8",
+    properties: 132, // write (4) + write_response (128)
+  }],
   ["relay-control-point", {
     id: "relay-control-point",
     UUID: "0000005E-0000-1000-8000-0026BB765291",
@@ -242,6 +251,24 @@ export const CharacteristicManualAdditions: Map<string, GeneratedCharacteristic>
     minValue: 0,
     maxValue: 5,
   }],
+  ["tap-type", {
+    id: "tap-type",
+    UUID: "0000022F-0000-1000-8000-0026BB765291",
+    name: "Tap Type",
+    className: "TapType",
+    deprecatedNotice: "Removed",
+    format: "uint16",
+    properties: 2, // read
+  }],
+  ["token", {
+    id: "token",
+    UUID: "00000231-0000-1000-8000-0026BB765291",
+    name: "Token",
+    className: "Token",
+    deprecatedNotice: "Removed",
+    format: "data",
+    properties: 4, // write
+  }],
   ["tunnel-connection-timeout", {
     id: "tunnel-connection-timeout",
     UUID: "00000061-0000-1000-8000-0026BB765291",
@@ -326,6 +353,19 @@ export const ServiceManualAdditions: Map<string, GeneratedService> = new Map([
       "relay-enabled",
     ],
   }],
+  ["tap-management", {
+    id: "tap-management",
+    UUID: "0000022E-0000-1000-8000-0026BB765291",
+    name: "Tap Management",
+    className: "TapManagement",
+    deprecatedNotice: "Removed",
+    requiredCharacteristics: [
+      "active",
+      "crypto-hash",
+      "tap-type",
+      "token",
+    ],
+  }],
   ["tunnel", {
     id: "tunnel",
     UUID: "00000056-0000-1000-8000-0026BB765291",