node-red-contrib-homekit-bridged 2.0.0-dev.5 → 2.0.0-dev.8

package/build/lib/api.js

@@ -1,306 +1,672 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-const hap_nodejs_1 = require("@homebridge/hap-nodejs");
-const logger_1 = require("@nrchkb/logger");
-const EveCharacteristics_1 = __importDefault(require("./hap/eve-app/EveCharacteristics"));
-const Storage_1 = require("./Storage");
-const HapCategories_1 = __importDefault(require("./types/hap-nodejs/HapCategories"));
-const version = require('../../package.json').version.trim();
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var fs = __toESM(require("node:fs"));
+var os = __toESM(require("node:os"));
+var import_hap_nodejs = require("@homebridge/hap-nodejs");
+var import_logger = require("@nrchkb/logger");
+var import_embedded = require("../plugins/embedded");
+var import_registry = require("../plugins/registry");
+var import_EveCharacteristics = __toESM(require("./hap/eve-app/EveCharacteristics"));
+var import_NodeMigration = require("./migration/NodeMigration");
+var import_PairingQRCode = require("./PairingQRCode");
+var import_Storage = require("./Storage");
+var import_HapCategories = __toESM(require("./types/hap-nodejs/HapCategories"));
+var import_ProtectDiscovery = require("./unifi/ProtectDiscovery");
+const version = require("../../package.json").version.trim();
 module.exports = (RED) => {
-    const log = (0, logger_1.logger)('NRCHKB', 'API');
-    const _initServiceAPI = () => {
-        log.debug('Initialize Service API');
-        const serviceData = {
-            BatteryService: {
-                nrchkbDisabledText: 'BatteryService (deprecated, replaced by Battery)'
-            },
-            BridgeConfiguration: {
-                nrchkbDisabledText: 'BridgeConfiguration (deprecated, unused)'
-            },
-            BridgingState: {
-                nrchkbDisabledText: 'BridgingState (deprecated, unused)'
-            },
-            CameraControl: {
-                nrchkbDisabledText: 'CameraControl (deprecated, replaced by)'
-            },
-            CameraEventRecordingManagement: {
-                nrchkbDisabledText: 'CameraEventRecordingManagement (deprecated, replaced by CameraRecordingManagement)'
-            },
-            Relay: {
-                nrchkbDisabledText: 'Relay (deprecated, replaced by CloudRelay)'
-            },
-            Slat: {
-                nrchkbDisabledText: 'Slat (deprecated, replaced by Slats)'
-            },
-            TimeInformation: {
-                nrchkbDisabledText: 'TimeInformation (deprecated, unused)'
-            },
-            TunneledBTLEAccessoryService: {
-                nrchkbDisabledText: 'TunneledBTLEAccessoryService (deprecated, replaced by Tunnel)'
-            }
+  const log = (0, import_logger.logger)("NRCHKB", "API");
+  const registeredCustomCharacteristicKeys = /* @__PURE__ */ new Set();
+  const pathExists = (path) => {
+    try {
+      return fs.existsSync(path);
+    } catch (_error) {
+      return false;
+    }
+  };
+  const detectAdvertiserRecommendation = () => {
+    const platform = os.platform();
+    const container = pathExists("/.dockerenv") || pathExists("/run/.containerenv") || process.env.container !== void 0 || process.env.KUBERNETES_SERVICE_HOST !== void 0;
+    const dbusAvailable = pathExists("/run/dbus/system_bus_socket") || pathExists("/var/run/dbus/system_bus_socket");
+    const avahiAvailable = dbusAvailable && (pathExists("/run/avahi-daemon/socket") || pathExists("/var/run/avahi-daemon/socket"));
+    const resolvedAvailable = dbusAvailable && (pathExists("/run/systemd/resolve") || pathExists("/run/systemd/resolve/io.systemd.Resolve"));
+    const caveats = [];
+    if (platform === "linux") {
+      if (avahiAvailable) {
+        if (container) {
+          caveats.push(
+            "Container detected. HomeKit discovery still depends on host networking and multicast visibility."
+          );
+        }
+        return {
+          caveats,
+          detected: {
+            avahiAvailable,
+            container,
+            dbusAvailable,
+            platform,
+            resolvedAvailable
+          },
+          reason: "Linux host with Avahi and D-Bus available.",
+          recommended: "avahi",
+          title: "AVAHI recommended"
         };
-        Object.values(hap_nodejs_1.Service)
-            .filter((service) => service.prototype instanceof hap_nodejs_1.Service)
-            .map((service) => {
-            const newService = hap_nodejs_1.Service.serialize(new service());
-            newService.displayName = service.name;
-            return newService;
-        })
-            .forEach((serialized) => {
-            serviceData[serialized.displayName] = Object.assign(Object.assign({}, serviceData === null || serviceData === void 0 ? void 0 : serviceData[serialized.displayName]), serialized);
-        });
-        RED.httpAdmin.get('/nrchkb/service/types', RED.auth.needsPermission('nrchkb.read'), (_req, res) => {
-            res.setHeader('Content-Type', 'application/json');
-            res.json(serviceData);
-        });
+      }
+      if (container) {
+        caveats.push(
+          "Container detected without usable host Avahi. Docker bridge networking can prevent mDNS discovery even with the recommended advertiser."
+        );
+      } else if (resolvedAvailable) {
+        caveats.push(
+          "systemd-resolved mDNS appears available, but RESOLVED is an advanced experimental choice. CIAO is safer unless you intentionally manage mDNS through systemd-resolved."
+        );
+      } else {
+        caveats.push(
+          "Install and run avahi-daemon with D-Bus if you prefer the Linux-native advertiser."
+        );
+      }
+      return {
+        caveats,
+        detected: {
+          avahiAvailable,
+          container,
+          dbusAvailable,
+          platform,
+          resolvedAvailable
+        },
+        reason: container ? "Linux container without usable host Avahi detected." : "Linux host without usable Avahi detected.",
+        recommended: "ciao",
+        title: "CIAO recommended"
+      };
+    }
+    if (platform === "darwin" || platform === "win32") {
+      return {
+        caveats,
+        detected: {
+          avahiAvailable,
+          container,
+          dbusAvailable,
+          platform,
+          resolvedAvailable
+        },
+        reason: platform === "darwin" ? "macOS host detected." : "Windows host detected.",
+        recommended: "ciao",
+        title: "CIAO recommended"
+      };
+    }
+    caveats.push(
+      "Host platform is uncommon for HomeKit. Verify multicast and mDNS behavior on this system."
+    );
+    return {
+      caveats,
+      detected: {
+        avahiAvailable,
+        container,
+        dbusAvailable,
+        platform,
+        resolvedAvailable
+      },
+      reason: `Unsupported or uncommon host platform: ${platform}.`,
+      recommended: "ciao",
+      title: "CIAO recommended"
     };
-    const stringifyVersion = (version) => {
-        const releaseVersionRegex = /(\d+)\.(\d+)\.(\d+)/;
-        const devVersionRegex = /(\d+)\.(\d+)\.(\d+)-dev\.(\d+)/;
-        const releaseVersionFound = releaseVersionRegex.test(version);
-        const devVersionFound = devVersionRegex.test(version);
-        let xyzVersion = '0.0.0';
-        if (devVersionFound) {
-            try {
-                const match = devVersionRegex.exec(version);
-                if (match) {
-                    xyzVersion = `0.${match[1]}${match[2]}${match[3]}.${match[4]}`;
-                }
-                else {
-                    log.debug('Could not match dev version');
-                }
-            }
-            catch (e) {
-                log.error(e);
-            }
+  };
+  const _initServiceAPI = () => {
+    log.debug("Initialize Service API");
+    const serviceData = {
+      Camera: {
+        displayName: "Camera",
+        constructorName: "Camera"
+      },
+      BatteryService: {
+        nrchkbDisabledText: "BatteryService (deprecated, replaced by Battery)"
+      },
+      BridgeConfiguration: {
+        nrchkbDisabledText: "BridgeConfiguration (deprecated, unused)"
+      },
+      BridgingState: {
+        nrchkbDisabledText: "BridgingState (deprecated, unused)"
+      },
+      CameraControl: {
+        nrchkbDisabledText: "CameraControl (deprecated, replaced by Camera)",
+        nrchkbHiddenInService2: true
+      },
+      CameraEventRecordingManagement: {
+        nrchkbDisabledText: "CameraEventRecordingManagement (deprecated, replaced by CameraRecordingManagement)"
+      },
+      Relay: {
+        nrchkbDisabledText: "Relay (deprecated, replaced by CloudRelay)"
+      },
+      Slat: {
+        nrchkbDisabledText: "Slat (deprecated, replaced by Slats)"
+      },
+      TimeInformation: {
+        nrchkbDisabledText: "TimeInformation (deprecated, unused)"
+      },
+      TunneledBTLEAccessoryService: {
+        nrchkbDisabledText: "TunneledBTLEAccessoryService (deprecated, replaced by Tunnel)"
+      }
+    };
+    Object.values(import_hap_nodejs.Service).filter((service) => service.prototype instanceof import_hap_nodejs.Service).map((service) => {
+      const newService = import_hap_nodejs.Service.serialize(new service());
+      newService.displayName = service.name;
+      return newService;
+    }).forEach((serialized) => {
+      serviceData[serialized.displayName] = {
+        ...serviceData?.[serialized.displayName],
+        ...serialized
+      };
+    });
+    RED.httpAdmin.get(
+      "/nrchkb/service/types",
+      RED.auth.needsPermission("nrchkb.read"),
+      (_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.json(serviceData);
+      }
+    );
+    RED.httpAdmin.get(
+      "/nrchkb/plugins",
+      RED.auth.needsPermission("nrchkb.read"),
+      (_req, res) => {
+        (0, import_registry.registerNodeRedPlugins)(RED);
+        (0, import_embedded.registerEmbeddedPlugins)();
+        res.setHeader("Content-Type", "application/json");
+        res.json((0, import_registry.listPlugins)().map((plugin) => plugin.metadata));
+      }
+    );
+    RED.httpAdmin.get(
+      "/nrchkb/unifi/controllers/:id/test",
+      RED.auth.needsPermission("nrchkb.read"),
+      async (req, res) => {
+        const controller = RED.nodes.getNode(
+          req.params.id
+        );
+        if (!controller) {
+          res.status(404).json({
+            error: "UniFi controller config node was not found."
+          });
+          return;
         }
-        else if (releaseVersionFound) {
-            try {
-                const match = releaseVersionRegex.exec(version);
-                if (match) {
-                    xyzVersion = match[0];
-                }
-                else {
-                    log.debug('Could not match release version');
-                }
-            }
-            catch (e) {
-                log.error(e);
-            }
+        try {
+          (0, import_ProtectDiscovery.assertProtectControllerConfig)(
+            controller,
+            controller.credentials ?? {}
+          );
+          await (0, import_ProtectDiscovery.discoverProtectCameras)(
+            controller,
+            controller.credentials ?? {}
+          );
+          res.json({ ok: true });
+        } catch (error) {
+          res.status(400).json({
+            error: error instanceof Error ? error.message : "Unable to connect to UniFi Protect."
+          });
         }
-        else {
-            log.debug('Bad version format');
-            xyzVersion = '0.0.0';
+      }
+    );
+    RED.httpAdmin.get(
+      "/nrchkb/unifi/controllers/:id/protect/cameras",
+      RED.auth.needsPermission("nrchkb.read"),
+      async (req, res) => {
+        const controller = RED.nodes.getNode(
+          req.params.id
+        );
+        if (!controller) {
+          res.status(404).json({
+            error: "UniFi controller config node was not found."
+          });
+          return;
         }
-        return xyzVersion;
-    };
-    const _initNRCHKBInfoAPI = () => {
-        log.debug('Initialize NRCHKB Info API');
-        log.debug(`Running version: ${version}`);
-        const xyzVersion = stringifyVersion(version);
-        log.debug(`Evaluated as: ${xyzVersion}`);
-        const experimental = process.env.NRCHKB_EXPERIMENTAL === 'true';
-        log.debug(`Running experimental: ${experimental}`);
-        RED.httpAdmin.get('/nrchkb/info', RED.auth.needsPermission('nrchkb.read'), (_req, res) => {
-            res.setHeader('Content-Type', 'application/json');
-            res.json({
-                version: xyzVersion,
-                experimental
-            });
+        try {
+          const cameras = await (0, import_ProtectDiscovery.discoverProtectCameras)(
+            controller,
+            controller.credentials ?? {}
+          );
+          res.json(
+            cameras.map((camera) => ({
+              value: camera.mac,
+              label: `${camera.name ?? camera.marketName ?? camera.mac} (${camera.mac})`,
+              id: camera.id,
+              mac: camera.mac,
+              state: camera.state
+            }))
+          );
+        } catch (error) {
+          res.status(400).json({
+            error: error instanceof Error ? error.message : "Unable to discover UniFi Protect cameras."
+          });
+        }
+      }
+    );
+    RED.httpAdmin.post(
+      "/nrchkb/migration/node",
+      RED.auth.needsPermission("nrchkb.write"),
+      (req, res) => {
+        if (!req.body || typeof req.body !== "object") {
+          res.status(400).json({
+            error: "Request body must be a Node-RED node object."
+          });
+          return;
+        }
+        res.setHeader("Content-Type", "application/json");
+        res.json((0, import_NodeMigration.migrateNode)(req.body));
+      }
+    );
+    RED.httpAdmin.post(
+      "/nrchkb/migration/flow",
+      RED.auth.needsPermission("nrchkb.write"),
+      (req, res) => {
+        if (!Array.isArray(req.body)) {
+          res.status(400).json({
+            error: "Request body must be an array of Node-RED nodes."
+          });
+          return;
+        }
+        res.setHeader("Content-Type", "application/json");
+        res.json((0, import_NodeMigration.migrateFlow)(req.body));
+      }
+    );
+  };
+  const stringifyVersion = (version2) => {
+    const releaseVersionRegex = /(\d+)\.(\d+)\.(\d+)/;
+    const devVersionRegex = /(\d+)\.(\d+)\.(\d+)-dev\.(\d+)/;
+    const releaseVersionFound = releaseVersionRegex.test(version2);
+    const devVersionFound = devVersionRegex.test(version2);
+    let xyzVersion = "0.0.0";
+    if (devVersionFound) {
+      try {
+        const match = devVersionRegex.exec(version2);
+        if (match) {
+          xyzVersion = `0.${match[1]}${match[2]}${match[3]}.${match[4]}`;
+        } else {
+          log.debug("Could not match dev version");
+        }
+      } catch (e) {
+        log.error(e);
+      }
+    } else if (releaseVersionFound) {
+      try {
+        const match = releaseVersionRegex.exec(version2);
+        if (match) {
+          xyzVersion = match[0];
+        } else {
+          log.debug("Could not match release version");
+        }
+      } catch (e) {
+        log.error(e);
+      }
+    } else {
+      log.debug("Bad version format");
+      xyzVersion = "0.0.0";
+    }
+    return xyzVersion;
+  };
+  const _initNRCHKBInfoAPI = () => {
+    log.debug("Initialize NRCHKB Info API");
+    log.debug(`Running version: ${version}`);
+    const xyzVersion = stringifyVersion(version);
+    log.debug(`Evaluated as: ${xyzVersion}`);
+    const experimental = process.env.NRCHKB_EXPERIMENTAL === "true";
+    log.debug(`Running experimental: ${experimental}`);
+    RED.httpAdmin.get(
+      "/nrchkb/info",
+      RED.auth.needsPermission("nrchkb.read"),
+      (_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.json({
+          version: xyzVersion,
+          experimental
         });
+      }
+    );
+  };
+  const _initAdvertiserRecommendationAPI = () => {
+    log.debug("Initialize Advertiser Recommendation API");
+    RED.httpAdmin.get(
+      "/nrchkb/advertiser/recommendation",
+      RED.auth.needsPermission("nrchkb.read"),
+      (_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.json(detectAdvertiserRecommendation());
+      }
+    );
+  };
+  const getHostPairedState = (hostNode) => {
+    const accessoryInfo = hostNode.host._accessoryInfo;
+    if (accessoryInfo) {
+      hostNode.paired = accessoryInfo.paired();
+    }
+    return !!hostNode.paired;
+  };
+  const _initBridgePairingAPI = () => {
+    log.debug("Initialize Bridge Pairing API");
+    RED.httpAdmin.get(
+      "/nrchkb/bridge/:id/pairing",
+      RED.auth.needsPermission("nrchkb.read"),
+      async (req, res) => {
+        const hostId = req.params.id;
+        const node = RED.nodes.getNode(hostId);
+        res.setHeader("Content-Type", "application/json");
+        if (!node || node.type !== "homekit-bridge" && node.type !== "homekit-standalone") {
+          res.status(404).json({
+            error: "Pairing host not found.",
+            paired: false,
+            published: false
+          });
+          return;
+        }
+        const bridgeName = node.config.bridgeName;
+        const pinCode = node.config.pinCode;
+        const formattedPinCode = (0, import_PairingQRCode.formatPinCodeForPairing)(pinCode);
+        const paired = getHostPairedState(node);
+        if (!node.published) {
+          res.status(409).json({
+            bridgeName,
+            formattedPinCode,
+            paired,
+            pinCode,
+            published: false,
+            status: "unpublished"
+          });
+          return;
+        }
+        if (paired) {
+          res.json({
+            bridgeName,
+            formattedPinCode,
+            paired: true,
+            pinCode,
+            published: true,
+            status: "paired"
+          });
+          return;
+        }
+        try {
+          const setupUri = node.host.setupURI();
+          const qrCodeDataUrl = await (0, import_PairingQRCode.createPairingQRCodeDataURL)(
+            setupUri,
+            pinCode
+          );
+          res.json({
+            bridgeName,
+            formattedPinCode,
+            paired: false,
+            pinCode,
+            published: true,
+            qrCodeDataUrl,
+            setupUri,
+            status: "unpaired"
+          });
+        } catch (error) {
+          log.error(
+            `Failed to generate pairing QR code for host ${hostId}: ${error}`
+          );
+          res.status(500).json({
+            bridgeName,
+            error: "Failed to generate pairing QR code.",
+            formattedPinCode,
+            paired: false,
+            pinCode,
+            published: true
+          });
+        }
+      }
+    );
+  };
+  const _initNRCHKBCustomCharacteristicsAPI = async () => {
+    const getCustomCharacteristics = async () => {
+      try {
+        const value = await import_Storage.Storage.loadCustomCharacteristics();
+        log.trace("loadCustomCharacteristics()");
+        log.trace(value);
+        if (Array.isArray(value)) {
+          return value;
+        } else {
+          log.debug(
+            "customCharacteristics is not Array, returning empty value"
+          );
+          return import_EveCharacteristics.default;
+        }
+      } catch (error) {
+        log.error(
+          `Failed to get customCharacteristics in nrchkbStorage due to ${error}`
+        );
+        return import_EveCharacteristics.default;
+      }
     };
-    const _initNRCHKBCustomCharacteristicsAPI = () => __awaiter(void 0, void 0, void 0, function* () {
-        const getCustomCharacteristics = () => __awaiter(void 0, void 0, void 0, function* () {
-            try {
-                const value = yield Storage_1.Storage.loadCustomCharacteristics();
-                log.trace('loadCustomCharacteristics()');
-                log.trace(value);
-                if (Array.isArray(value)) {
-                    return value;
-                }
-                else {
-                    log.debug('customCharacteristics is not Array, returning empty value');
-                    return EveCharacteristics_1.default;
-                }
+    const characteristicNameToKey = (name) => {
+      return name.replace(/\s+/g, "");
+    };
+    const toNumber = (value, optional = void 0) => {
+      const num = Number(value);
+      if (Number.isNaN(num)) {
+        return optional;
+      } else return num;
+    };
+    const rebindCharacteristicListeners = (characteristic, serviceNode) => {
+      characteristic.removeListener(
+        "get",
+        serviceNode.onCharacteristicGet
+      );
+      characteristic.removeListener(
+        "set",
+        serviceNode.onCharacteristicSet
+      );
+      characteristic.removeListener(
+        "change",
+        serviceNode.onCharacteristicChange
+      );
+      characteristic.on("get", serviceNode.onCharacteristicGet);
+      characteristic.on("set", serviceNode.onCharacteristicSet);
+      characteristic.on("change", serviceNode.onCharacteristicChange);
+    };
+    const refreshCustomCharacteristics = (customCharacteristics) => {
+      log.debug("Refreshing Custom Characteristics");
+      const customCharacteristicKeys = /* @__PURE__ */ new Set();
+      customCharacteristics.forEach(({ name, UUID, ...props }) => {
+        if (UUID && name) {
+          const key = characteristicNameToKey(name);
+          log.debug(
+            `Adding Custom Characteristic ${name} using key ${key}`
+          );
+          if (customCharacteristicKeys.has(key)) {
+            log.error(
+              `Cannot add ${name}. Another Custom Characteristic already defined using key ${key}`
+            );
+            return;
+          }
+          const validatedProps = { ...props };
+          if (validatedProps.validValues?.length === 0) {
+            validatedProps.validValues = void 0;
+          }
+          if (validatedProps.validValueRanges?.length) {
+            const [minRange, maxRange] = validatedProps.validValueRanges;
+            if (minRange === void 0 || maxRange === void 0) {
+              validatedProps.validValueRanges = void 0;
+            } else {
+              const minRangeNumber = Number(minRange);
+              const maxRangeNumber = Number(maxRange);
+              if (Number.isNaN(minRangeNumber) || Number.isNaN(maxRangeNumber)) {
+                validatedProps.validValueRanges = void 0;
+              } else {
+                validatedProps.validValueRanges = [
+                  minRangeNumber,
+                  maxRangeNumber
+                ];
+              }
             }
-            catch (error) {
-                log.error(`Failed to get customCharacteristics in nrchkbStorage due to ${error}`);
-                return EveCharacteristics_1.default;
+          }
+          if (validatedProps.adminOnlyAccess?.length === 0) {
+            validatedProps.adminOnlyAccess = void 0;
+          }
+          if (validatedProps.minValue !== void 0) {
+            validatedProps.minValue = toNumber(
+              validatedProps.minValue
+            );
+          }
+          if (validatedProps.maxValue !== void 0) {
+            validatedProps.maxValue = toNumber(
+              validatedProps.maxValue
+            );
+          }
+          if (validatedProps.minStep !== void 0) {
+            validatedProps.minStep = toNumber(
+              validatedProps.minStep
+            );
+          }
+          class CustomCharacteristic extends import_hap_nodejs.Characteristic {
+            static {
+              this.UUID = UUID;
             }
-        });
-        const characteristicNameToKey = (name) => {
-            return name.replace(' ', '');
-        };
-        const toNumber = (value, optional = undefined) => {
-            const num = Number(value);
-            if (Number.isNaN(num)) {
-                return optional;
+            constructor() {
+              super(name, CustomCharacteristic.UUID, {
+                ...validatedProps,
+                perms: validatedProps.perms ?? [
+                  import_hap_nodejs.Perms.PAIRED_READ,
+                  import_hap_nodejs.Perms.PAIRED_WRITE,
+                  import_hap_nodejs.Perms.NOTIFY
+                ]
+              });
+              this.value = this.getDefaultValue();
             }
-            else
-                return num;
-        };
-        const refreshCustomCharacteristics = (customCharacteristics) => {
-            log.debug('Refreshing Custom Characteristics');
-            const customCharacteristicKeys = [];
-            customCharacteristics.forEach((_a) => {
-                var _b, _c, _d, _e;
-                var { name, UUID } = _a, props = __rest(_a, ["name", "UUID"]);
-                if (!!UUID && !!name) {
-                    const key = characteristicNameToKey(name);
-                    log.debug(`Adding Custom Characteristic ${name} using key ${key}`);
-                    if (customCharacteristicKeys.includes(key)) {
-                        log.error(`Cannot add ${name}. Another Custom Characteristic already defined using key ${key}`);
-                        return;
-                    }
-                    const validatedProps = props;
-                    if (((_b = validatedProps.validValues) === null || _b === void 0 ? void 0 : _b.length) === 0) {
-                        validatedProps.validValues = undefined;
-                    }
-                    if (!((_c = validatedProps.validValueRanges) === null || _c === void 0 ? void 0 : _c[0]) ||
-                        !((_d = validatedProps.validValueRanges) === null || _d === void 0 ? void 0 : _d[1])) {
-                        validatedProps.validValueRanges = undefined;
-                    }
-                    if (((_e = validatedProps.adminOnlyAccess) === null || _e === void 0 ? void 0 : _e.length) === 0) {
-                        validatedProps.adminOnlyAccess = undefined;
-                    }
-                    if (validatedProps.minValue) {
-                        validatedProps.minValue = toNumber(validatedProps.minValue);
-                    }
-                    if (validatedProps.maxValue) {
-                        validatedProps.maxValue = toNumber(validatedProps.maxValue);
-                    }
-                    if (validatedProps.minStep) {
-                        validatedProps.minStep = toNumber(validatedProps.minStep);
-                    }
-                    class CustomCharacteristic extends hap_nodejs_1.Characteristic {
-                        constructor() {
-                            var _a;
-                            super(name, CustomCharacteristic.UUID, Object.assign(Object.assign({}, validatedProps), { perms: (_a = validatedProps.perms) !== null && _a !== void 0 ? _a : [
-                                    "pr",
-                                    "pw",
-                                    "ev"
-                                ] }));
-                            this.value = this.getDefaultValue();
-                        }
-                    }
-                    CustomCharacteristic.UUID = UUID;
-                    Object.defineProperty(CustomCharacteristic, 'name', {
-                        value: key,
-                        configurable: true
-                    });
-                    Object.defineProperty(hap_nodejs_1.Characteristic, key, {
-                        value: CustomCharacteristic,
-                        configurable: true
-                    });
-                    customCharacteristicKeys.push(key);
-                }
-            });
-            new Promise((resolve) => {
-                const isRedInitialized = () => {
-                    try {
-                        RED.nodes.eachNode(() => {
-                            return;
-                        });
-                        resolve(true);
-                    }
-                    catch (_) {
-                        log.debug('Waiting for RED to be initialized');
-                        setTimeout(isRedInitialized, 1000);
-                    }
-                };
-                isRedInitialized();
-            }).then(() => {
-                RED.nodes.eachNode((node) => {
-                    if (node.type === 'homekit-service' ||
-                        node.type === 'homekit-service2') {
-                        const serviceNodeConfig = node;
-                        const serviceNode = RED.nodes.getNode(serviceNodeConfig.id);
-                        if ((serviceNode === null || serviceNode === void 0 ? void 0 : serviceNode.characteristicProperties) && serviceNode.service) {
-                            for (const key in serviceNode.characteristicProperties) {
-                                if (customCharacteristicKeys.includes(key)) {
-                                    const characteristic = serviceNode.service
-                                        .getCharacteristic(hap_nodejs_1.Characteristic[key])
-                                        .setProps(serviceNode.characteristicProperties[key]);
-                                    serviceNode.supported.push(key);
-                                    characteristic.on('get', serviceNode.onCharacteristicGet);
-                                    characteristic.on('set', serviceNode.onCharacteristicSet);
-                                    characteristic.on('change', serviceNode.onCharacteristicChange);
-                                }
-                            }
-                        }
-                    }
-                });
+          }
+          Object.defineProperty(CustomCharacteristic, "name", {
+            value: key,
+            configurable: true
+          });
+          Object.defineProperty(import_hap_nodejs.Characteristic, key, {
+            value: CustomCharacteristic,
+            configurable: true
+          });
+          customCharacteristicKeys.add(key);
+        }
+      });
+      registeredCustomCharacteristicKeys.forEach((key) => {
+        if (customCharacteristicKeys.has(key)) {
+          return;
+        }
+        log.debug(`Removing stale Custom Characteristic ${key}`);
+        delete import_hap_nodejs.Characteristic[key];
+        registeredCustomCharacteristicKeys.delete(key);
+      });
+      customCharacteristicKeys.forEach((key) => {
+        registeredCustomCharacteristicKeys.add(key);
+      });
+      new Promise((resolve) => {
+        const isRedInitialized = () => {
+          try {
+            RED.nodes.eachNode(() => {
+              return;
             });
+            resolve(true);
+          } catch (_) {
+            log.debug("Waiting for RED to be initialized");
+            setTimeout(isRedInitialized, 1e3);
+          }
         };
-        log.debug('Initialize NRCHKBCustomCharacteristicsAPI');
-        getCustomCharacteristics().then((value) => refreshCustomCharacteristics(value));
-        RED.httpAdmin.get('/nrchkb/config', RED.auth.needsPermission('nrchkb.read'), (_req, res) => __awaiter(void 0, void 0, void 0, function* () {
-            res.setHeader('Content-Type', 'application/json');
-            res.json({
-                customCharacteristics: yield getCustomCharacteristics()
-            });
-        }));
-        RED.httpAdmin.post('/nrchkb/config', RED.auth.needsPermission('nrchkb.write'), (req, res) => __awaiter(void 0, void 0, void 0, function* () {
-            const customCharacteristics = req.body.customCharacteristics || EveCharacteristics_1.default;
-            Storage_1.Storage.saveCustomCharacteristics(customCharacteristics)
-                .then(() => {
-                res.sendStatus(200);
-                refreshCustomCharacteristics(customCharacteristics);
-            })
-                .catch((error) => {
-                log.error(error);
-                res.sendStatus(500);
-            });
-        }));
-    });
-    const _initAccessoryAPI = () => {
-        log.debug('Initialize Accessory API');
-        const accessoryCategoriesData = {};
-        Object.keys(HapCategories_1.default)
-            .sort()
-            .filter((x) => parseInt(x, 10) >= 0)
-            .forEach((key) => {
-            const keyNumber = key;
-            accessoryCategoriesData[keyNumber] = HapCategories_1.default[keyNumber];
-        });
-        RED.httpAdmin.get('/nrchkb/accessory/categories', RED.auth.needsPermission('nrchkb.read'), (_req, res) => {
-            res.setHeader('Content-Type', 'application/json');
-            res.json(accessoryCategoriesData);
+        isRedInitialized();
+      }).then(() => {
+        RED.nodes.eachNode((node) => {
+          if (node.type === "homekit-service" || node.type === "homekit-service2") {
+            const serviceNodeConfig = node;
+            const serviceNode = RED.nodes.getNode(
+              serviceNodeConfig.id
+            );
+            if (serviceNode?.characteristicProperties && serviceNode.service) {
+              for (const key in serviceNode.characteristicProperties) {
+                if (customCharacteristicKeys.has(key)) {
+                  const characteristic = serviceNode.service.getCharacteristic(import_hap_nodejs.Characteristic[key]).setProps(
+                    serviceNode.characteristicProperties[key]
+                  );
+                  serviceNode.supported.add(key);
+                  rebindCharacteristicListeners(
+                    characteristic,
+                    serviceNode
+                  );
+                }
+              }
+            }
+          }
         });
+      });
     };
-    const init = () => {
-        _initServiceAPI();
-        _initNRCHKBInfoAPI();
-        _initAccessoryAPI();
-        if (process.env.NRCHKB_EXPERIMENTAL === 'true') {
-            _initNRCHKBCustomCharacteristicsAPI().then();
-        }
-    };
-    return {
-        init,
-        stringifyVersion
-    };
+    log.debug("Initialize NRCHKBCustomCharacteristicsAPI");
+    getCustomCharacteristics().then(
+      (value) => refreshCustomCharacteristics(value)
+    );
+    RED.httpAdmin.get(
+      "/nrchkb/config",
+      RED.auth.needsPermission("nrchkb.read"),
+      async (_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.json({
+          customCharacteristics: await getCustomCharacteristics()
+        });
+      }
+    );
+    RED.httpAdmin.post(
+      "/nrchkb/config",
+      RED.auth.needsPermission("nrchkb.write"),
+      async (req, res) => {
+        const customCharacteristics = req.body.customCharacteristics || import_EveCharacteristics.default;
+        import_Storage.Storage.saveCustomCharacteristics(customCharacteristics).then(() => {
+          res.sendStatus(200);
+          refreshCustomCharacteristics(customCharacteristics);
+        }).catch((error) => {
+          log.error(error);
+          res.sendStatus(500);
+        });
+      }
+    );
+  };
+  const _initAccessoryAPI = () => {
+    log.debug("Initialize Accessory API");
+    const accessoryCategoriesData = {};
+    Object.keys(import_HapCategories.default).sort().filter((x) => parseInt(x, 10) >= 0).forEach((key) => {
+      const keyNumber = key;
+      accessoryCategoriesData[keyNumber] = import_HapCategories.default[keyNumber];
+    });
+    RED.httpAdmin.get(
+      "/nrchkb/accessory/categories",
+      RED.auth.needsPermission("nrchkb.read"),
+      (_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.json(accessoryCategoriesData);
+      }
+    );
+  };
+  const init = () => {
+    _initServiceAPI();
+    _initNRCHKBInfoAPI();
+    _initAdvertiserRecommendationAPI();
+    _initBridgePairingAPI();
+    _initAccessoryAPI();
+    _initNRCHKBCustomCharacteristicsAPI().then();
+  };
+  return {
+    detectAdvertiserRecommendation,
+    init,
+    stringifyVersion
+  };
 };