homebridge-unifi-access 0.0.1 → 1.0.0

package/dist/access-device.js

@@ -0,0 +1,362 @@
+/* Copyright(C) 2017-2024, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * access-device.ts: Base class for all UniFi Access devices.
+ */
+import { ACCESS_MOTION_DURATION, ACCESS_OCCUPANCY_DURATION } from "./settings.js";
+import { AccessReservedNames } from "./access-types.js";
+import { getOptionFloat, getOptionNumber, getOptionValue, isOptionEnabled } from "./access-options.js";
+import util from "node:util";
+export class AccessBase {
+    api;
+    debug;
+    hap;
+    log;
+    controller;
+    udaApi;
+    platform;
+    // The constructor initializes key variables and calls configureDevice().
+    constructor(controller) {
+        this.api = controller.platform.api;
+        this.debug = controller.platform.debug.bind(this);
+        this.hap = this.api.hap;
+        this.controller = controller;
+        this.udaApi = controller.udaApi;
+        this.platform = controller.platform;
+        this.log = {
+            debug: (message, ...parameters) => controller.platform.debug(util.format(this.name + ": " + message, ...parameters)),
+            error: (message, ...parameters) => controller.platform.log.error(util.format(this.name + ": " + message, ...parameters)),
+            info: (message, ...parameters) => controller.platform.log.info(util.format(this.name + ": " + message, ...parameters)),
+            warn: (message, ...parameters) => controller.platform.log.warn(util.format(this.name + ": " + message, ...parameters))
+        };
+    }
+    // Configure the device information for HomeKit.
+    setInfo(accessory, device) {
+        // If we don't have a device, we're done.
+        if (!device) {
+            return false;
+        }
+        // Update the manufacturer information for this device.
+        accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.Manufacturer, "Ubiquiti Inc.");
+        // Update the model information for this device.
+        let deviceModel = device.display_model;
+        if ("model" in device) {
+            deviceModel = device.model;
+        }
+        if (deviceModel.length) {
+            accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.Model, deviceModel);
+        }
+        // Update the serial number for this device.
+        if (device.mac?.length) {
+            accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.SerialNumber, device.mac.replace(/:/g, "").toUpperCase());
+        }
+        // Update the firmware revision for this device.
+        if (device.firmware?.length) {
+            accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.FirmwareRevision, device.firmware);
+        }
+        return true;
+    }
+    // Utility function to return the fully enumerated name of this device.
+    get name() {
+        return this.controller.udaApi.name;
+    }
+}
+export class AccessDevice extends AccessBase {
+    accessory;
+    hints;
+    listeners;
+    // The constructor initializes key variables and calls configureDevice().
+    constructor(controller, accessory) {
+        // Call the constructor of our base class.
+        super(controller);
+        this.hints = {};
+        this.listeners = {};
+        // Set the accessory, if we have it. Otherwise, we expect configureDevice to assign it.
+        if (accessory) {
+            this.accessory = accessory;
+        }
+    }
+    // Configure device-specific settings.
+    configureHints() {
+        this.hints.logMotion = this.hasFeature("Log.Motion");
+        this.hints.motionDuration = this.getFeatureNumber("Motion.Duration") ?? ACCESS_MOTION_DURATION;
+        this.hints.occupancyDuration = this.getFeatureNumber("Motion.OccupancySensor.Duration") ?? ACCESS_OCCUPANCY_DURATION;
+        this.hints.syncName = this.hasFeature("Device.SyncName");
+        // Sanity check motion detection duration. Make sure it's never less than 2 seconds so we can actually alert the user.
+        if (this.hints.motionDuration < 2) {
+            this.hints.motionDuration = 2;
+        }
+        // Sanity check occupancy detection duration. Make sure it's never less than 60 seconds so we can actually alert the user.
+        if (this.hints.occupancyDuration < 60) {
+            this.hints.occupancyDuration = 60;
+        }
+        // Inform the user if we've opted for something other than the defaults.
+        if (this.hints.syncName) {
+            this.log.info("Syncing Access device name to HomeKit.");
+        }
+        if (this.hints.motionDuration !== ACCESS_MOTION_DURATION) {
+            this.log.info("Motion event duration set to %s seconds.", this.hints.motionDuration);
+        }
+        if (this.hints.occupancyDuration !== ACCESS_OCCUPANCY_DURATION) {
+            this.log.info("Occupancy event duration set to %s seconds.", this.hints.occupancyDuration);
+        }
+        return true;
+    }
+    // Configure the device information details for HomeKit.
+    configureInfo() {
+        // Sync the Access name with HomeKit, if configured.
+        if (this.hints.syncName) {
+            this.accessoryName = this.uda.name;
+        }
+        return this.setInfo(this.accessory, this.uda);
+    }
+    // Cleanup our event handlers and any other activities as needed.
+    cleanup() {
+        for (const eventName of Object.keys(this.listeners)) {
+            this.controller.events.removeListener(eventName, this.listeners[eventName]);
+            delete this.listeners[eventName];
+        }
+    }
+    // Configure the Access motion sensor for HomeKit.
+    configureMotionSensor(isEnabled = true, isInitialized = false) {
+        // Find the motion sensor service, if it exists.
+        let motionService = this.accessory.getService(this.hap.Service.MotionSensor);
+        // Have we disabled the motion sensor?
+        if (!isEnabled) {
+            if (motionService) {
+                this.accessory.removeService(motionService);
+                this.controller.mqtt?.unsubscribe(this.id, "motion/trigger");
+                this.log.info("Disabling motion sensor.");
+            }
+            this.configureMotionSwitch(isEnabled);
+            this.configureMotionTrigger(isEnabled);
+            return false;
+        }
+        // We don't have a motion sensor, let's add it to the device.
+        if (!motionService) {
+            // We don't have it, add the motion sensor to the device.
+            motionService = new this.hap.Service.MotionSensor(this.accessoryName);
+            if (!motionService) {
+                this.log.error("Unable to add motion sensor.");
+                return false;
+            }
+            this.accessory.addService(motionService);
+            isInitialized = false;
+            this.log.info("Enabling motion sensor.");
+        }
+        // Have we previously initialized this sensor? We assume not by default, but this allows for scenarios where you may be dynamically reconfiguring a sensor at
+        // runtime (e.g. UniFi sensors can be reconfigured for various sensor modes in realtime).
+        if (!isInitialized) {
+            // Initialize the state of the motion sensor.
+            motionService.displayName = this.accessoryName;
+            motionService.updateCharacteristic(this.hap.Characteristic.Name, this.accessoryName);
+            motionService.updateCharacteristic(this.hap.Characteristic.MotionDetected, false);
+            motionService.updateCharacteristic(this.hap.Characteristic.StatusActive, this.isOnline);
+            motionService.getCharacteristic(this.hap.Characteristic.StatusActive).onGet(() => {
+                return this.isOnline;
+            });
+            // Configure our MQTT support.
+            this.configureMqttMotionTrigger();
+            // Configure any motion switches or triggers the user may have enabled or disabled.
+            this.configureMotionSwitch(isEnabled);
+            this.configureMotionTrigger(isEnabled);
+        }
+        return true;
+    }
+    // Configure a switch to easily activate or deactivate motion sensor detection for HomeKit.
+    configureMotionSwitch(isEnabled = true) {
+        // Find the switch service, if it exists.
+        let switchService = this.accessory.getServiceById(this.hap.Service.Switch, AccessReservedNames.SWITCH_MOTION_SENSOR);
+        // Motion switches are disabled by default unless the user enables them.
+        if (!isEnabled || !this.hasFeature("Motion.Switch")) {
+            if (switchService) {
+                this.accessory.removeService(switchService);
+            }
+            // If we disable the switch, make sure we fully reset it's state. Otherwise, we can end up in a situation (e.g. liveview switches) where we have
+            // disabled motion detection with no meaningful way to enable it again.
+            this.accessory.context.detectMotion = true;
+            return false;
+        }
+        this.log.info("Enabling motion sensor switch.");
+        const switchName = this.accessoryName + " Motion Events";
+        // Add the switch to the device, if needed.
+        if (!switchService) {
+            switchService = new this.hap.Service.Switch(switchName, AccessReservedNames.SWITCH_MOTION_SENSOR);
+            if (!switchService) {
+                this.log.error("Unable to add motion sensor switch.");
+                return false;
+            }
+            switchService.addOptionalCharacteristic(this.hap.Characteristic.ConfiguredName);
+            this.accessory.addService(switchService);
+        }
+        // Activate or deactivate motion detection.
+        switchService.getCharacteristic(this.hap.Characteristic.On)?.onGet(() => {
+            return this.accessory.context.detectMotion === true;
+        });
+        switchService.getCharacteristic(this.hap.Characteristic.On)?.onSet((value) => {
+            if (this.accessory.context.detectMotion !== value) {
+                this.log.info("Motion detection %s.", (value === true) ? "enabled" : "disabled");
+            }
+            this.accessory.context.detectMotion = value === true;
+        });
+        // Initialize the switch state.
+        if (!("detectMotion" in this.accessory.context)) {
+            this.accessory.context.detectMotion = true;
+        }
+        switchService.updateCharacteristic(this.hap.Characteristic.ConfiguredName, switchName);
+        switchService.updateCharacteristic(this.hap.Characteristic.On, this.accessory.context.detectMotion);
+        return true;
+    }
+    // Configure a switch to manually trigger a motion sensor event for HomeKit.
+    configureMotionTrigger(isEnabled = true) {
+        // Find the switch service, if it exists.
+        let triggerService = this.accessory.getServiceById(this.hap.Service.Switch, AccessReservedNames.SWITCH_MOTION_TRIGGER);
+        // Motion triggers are disabled by default and primarily exist for automation purposes.
+        if (!isEnabled || !this.hasFeature("Motion.Trigger")) {
+            if (triggerService) {
+                this.accessory.removeService(triggerService);
+            }
+            return false;
+        }
+        const triggerName = this.accessoryName + " Motion Trigger";
+        // Add the switch to the device, if needed.
+        if (!triggerService) {
+            triggerService = new this.hap.Service.Switch(triggerName, AccessReservedNames.SWITCH_MOTION_TRIGGER);
+            if (!triggerService) {
+                this.log.error("Unable to add motion sensor trigger.");
+                return false;
+            }
+            triggerService.addOptionalCharacteristic(this.hap.Characteristic.ConfiguredName);
+            this.accessory.addService(triggerService);
+        }
+        const motionService = this.accessory.getService(this.hap.Service.MotionSensor);
+        const switchService = this.accessory.getServiceById(this.hap.Service.Switch, AccessReservedNames.SWITCH_MOTION_SENSOR);
+        // Activate or deactivate motion detection.
+        triggerService.getCharacteristic(this.hap.Characteristic.On)?.onGet(() => {
+            return motionService?.getCharacteristic(this.hap.Characteristic.MotionDetected).value === true;
+        });
+        triggerService.getCharacteristic(this.hap.Characteristic.On)?.onSet((isOn) => {
+            if (isOn) {
+                // Check to see if motion events are disabled.
+                if (switchService && !switchService.getCharacteristic(this.hap.Characteristic.On).value) {
+                    setTimeout(() => {
+                        triggerService?.updateCharacteristic(this.hap.Characteristic.On, false);
+                    }, 50);
+                }
+                else {
+                    // Trigger the motion event.
+                    this.controller.events.motionEventHandler(this);
+                    // Inform the user.
+                    this.log.info("Motion event triggered.");
+                }
+                return;
+            }
+            // If the motion sensor is still on, we should be as well.
+            if (motionService?.getCharacteristic(this.hap.Characteristic.MotionDetected).value) {
+                setTimeout(() => {
+                    triggerService?.updateCharacteristic(this.hap.Characteristic.On, true);
+                }, 50);
+            }
+        });
+        // Initialize the switch.
+        triggerService.updateCharacteristic(this.hap.Characteristic.ConfiguredName, triggerName);
+        triggerService.updateCharacteristic(this.hap.Characteristic.On, false);
+        this.log.info("Enabling motion sensor automation trigger.");
+        return true;
+    }
+    // Configure MQTT motion triggers.
+    configureMqttMotionTrigger() {
+        // Trigger a motion event in MQTT, if requested to do so.
+        this.controller.mqtt?.subscribe(this.id, "motion/trigger", (message) => {
+            const value = message.toString();
+            // When we get the right message, we trigger the motion event.
+            if (value?.toLowerCase() !== "true") {
+                return;
+            }
+            // Trigger the motion event.
+            this.controller.events.motionEventHandler(this);
+            this.log.info("Motion event triggered via MQTT.");
+        });
+        return true;
+    }
+    // Configure the Access occupancy sensor for HomeKit.
+    configureOccupancySensor(isEnabled = true, isInitialized = false) {
+        // Find the occupancy sensor service, if it exists.
+        let occupancyService = this.accessory.getService(this.hap.Service.OccupancySensor);
+        // Occupancy sensors are disabled by default and primarily exist for automation purposes.
+        if (!isEnabled || !this.hasFeature("Motion.OccupancySensor")) {
+            if (occupancyService) {
+                this.accessory.removeService(occupancyService);
+                this.log.info("Disabling occupancy sensor.");
+            }
+            return false;
+        }
+        // We don't have an occupancy sensor, let's add it to the device.
+        if (!occupancyService) {
+            // We don't have it, add the occupancy sensor to the device.
+            occupancyService = new this.hap.Service.OccupancySensor(this.accessoryName);
+            if (!occupancyService) {
+                this.log.error("Unable to add occupancy sensor.");
+                return false;
+            }
+            this.accessory.addService(occupancyService);
+        }
+        // Have we previously initialized this sensor? We assume not by default, but this allows for scenarios where you may be dynamically reconfiguring a sensor at
+        // runtime (e.g. UniFi sensors can be reconfigured for various sensor modes in realtime).
+        if (!isInitialized) {
+            // Initialize the state of the occupancy sensor.
+            occupancyService.updateCharacteristic(this.hap.Characteristic.OccupancyDetected, false);
+            occupancyService.updateCharacteristic(this.hap.Characteristic.StatusActive, this.isOnline);
+            occupancyService.getCharacteristic(this.hap.Characteristic.StatusActive).onGet(() => {
+                return this.isOnline;
+            });
+            this.log.info("Enabling occupancy sensor.");
+        }
+        return true;
+    }
+    // Utility function to return a floating point configuration parameter on a device.
+    getFeatureFloat(option) {
+        return getOptionFloat(this.getFeatureValue(option));
+    }
+    // Utility function to return an integer configuration parameter on a device.
+    getFeatureNumber(option) {
+        return getOptionNumber(this.getFeatureValue(option));
+    }
+    // Utility function to return a configuration parameter on a device.
+    getFeatureValue(option) {
+        return getOptionValue(this.platform.featureOptions, this.controller.uda, this.uda, option);
+    }
+    // Utility for checking feature options on a device.
+    hasFeature(option, defaultReturnValue) {
+        return isOptionEnabled(this.platform.featureOptions, this.controller.uda, this.uda, option, defaultReturnValue ?? this.platform.featureOptionDefault(option));
+    }
+    // Utility function for reserved identifiers for switches.
+    isReservedName(name) {
+        return name === undefined ? false : Object.values(AccessReservedNames).map(x => x.toUpperCase()).includes(name.toUpperCase());
+    }
+    // Utility function to determine whether or not a device is currently online.
+    get isOnline() {
+        return this.uda.is_online;
+    }
+    // Return a unique identifier for an Access device.
+    get id() {
+        return this.uda.mac.replace(/:/g, "");
+    }
+    // Utility function to return the fully enumerated name of this device.
+    get name() {
+        return this.controller.udaApi.getFullName(this.uda);
+    }
+    // Utility function to return the current accessory name of this device.
+    get accessoryName() {
+        return this.accessory.getService(this.hap.Service.AccessoryInformation)?.getCharacteristic(this.hap.Characteristic.Name).value ??
+            (this.uda?.name ?? "Unknown");
+    }
+    // Utility function to set the current accessory name of this device.
+    set accessoryName(name) {
+        // Set all the internally managed names within Homebridge to the new accessory name.
+        this.accessory.displayName = name;
+        this.accessory._associatedHAPAccessory.displayName = name;
+        // Set all the HomeKit-visible names.
+        this.accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.Name, name);
+    }
+}
+//# sourceMappingURL=access-device.js.map

package/dist/access-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-device.js","sourceRoot":"","sources":["../src/access-device.ts"],"names":[],"mappings":"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"}

package/dist/access-events.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+import { AccessController } from "./access-controller.js";
+import { AccessDevice } from "./access-device.js";
+import { EventEmitter } from "node:events";
+export declare class AccessEvents extends EventEmitter {
+    private api;
+    private controller;
+    private eventsHandler;
+    private readonly eventTimers;
+    private hap;
+    private log;
+    private mqttPublishTelemetry;
+    private platform;
+    private udaApi;
+    private udaDeviceState;
+    private udaUpdatesHandler;
+    private unsupportedDevices;
+    constructor(controller: AccessController);
+    private udaUpdates;
+    private manageDevices;
+    private configureEvents;
+    motionEventHandler(accessDevice: AccessDevice): void;
+    private motionEventDelivery;
+}

package/dist/access-events.js

@@ -0,0 +1,151 @@
+import { AccessReservedNames } from "./access-types.js";
+import { EventEmitter } from "node:events";
+export class AccessEvents extends EventEmitter {
+    api;
+    controller;
+    eventsHandler;
+    eventTimers;
+    hap;
+    log;
+    mqttPublishTelemetry;
+    platform;
+    udaApi;
+    udaDeviceState;
+    udaUpdatesHandler;
+    unsupportedDevices;
+    // Initialize an instance of our Access events handler.
+    constructor(controller) {
+        super();
+        this.api = controller.platform.api;
+        this.eventTimers = {};
+        this.hap = controller.platform.api.hap;
+        this.log = controller.log;
+        this.mqttPublishTelemetry = controller.hasFeature("Controller.Publish.Telemetry");
+        this.controller = controller;
+        this.udaApi = controller.udaApi;
+        this.udaDeviceState = {};
+        this.platform = controller.platform;
+        this.unsupportedDevices = {};
+        this.eventsHandler = null;
+        this.udaUpdatesHandler = null;
+        // If we've enabled telemetry from the controller inform the user.
+        if (this.mqttPublishTelemetry) {
+            this.log.info("Access controller telemetry enabled.");
+        }
+        this.configureEvents();
+    }
+    // Process Access API update events.
+    udaUpdates(packet) {
+        let accessDevice;
+        switch (packet.data.device_type) {
+            case "UAH":
+            default:
+                // Lookup the device.
+                accessDevice = this.controller.deviceLookup(packet.event_object_id);
+                // No device found, we're done.
+                if (!accessDevice) {
+                    break;
+                }
+                // Update our device configuration state.
+                accessDevice.uda = packet.data;
+                // If we have services on the accessory associated with the Access device that have a StatusActive characteristic set, update our availability state.
+                accessDevice.accessory.services.filter(x => x.testCharacteristic(this.hap.Characteristic.StatusActive))
+                    ?.map(x => x.updateCharacteristic(this.hap.Characteristic.StatusActive, accessDevice?.uda.is_online === true));
+                // Sync names, if configured to do so.
+                if (accessDevice.hints.syncName && accessDevice.name !== accessDevice.uda.name) {
+                    accessDevice.log.info("Name change detected. A restart of Homebridge may be needed in order to complete name synchronization with HomeKit.");
+                    accessDevice.configureInfo();
+                }
+                break;
+        }
+        // Update the internal list we maintain.
+        this.udaDeviceState[packet.event_object_id] = packet.data;
+    }
+    // Process device additions and removals from the Access events API.
+    manageDevices(packet) {
+        // Lookup the device.
+        const accessDevice = this.controller.deviceLookup(packet.event_object_id);
+        // We're unadopting.
+        if (packet.event === "access.data.device.delete") {
+            // If it's already gone, we're done.
+            if (!accessDevice) {
+                return;
+            }
+            // Remove the device.
+            this.controller.removeHomeKitDevice(accessDevice);
+            return;
+        }
+    }
+    // Listen to the UniFi Access events API for updates we are interested in (e.g. unlock).
+    configureEvents() {
+        // Only configure the event listener if it exists and it's not already configured.
+        if (this.eventsHandler && this.udaUpdatesHandler) {
+            return true;
+        }
+        // Ensure we update our UDA state before we process any other events.
+        this.prependListener("access.data.device.update", this.udaUpdatesHandler = this.udaUpdates.bind(this));
+        // Process remove events.
+        this.prependListener("access.data.device.delete", this.manageDevices.bind(this));
+        // Listen for any messages coming in from our listener. We route events to the appropriate handlers based on the type of event that comes across.
+        this.udaApi.on("message", this.eventsHandler = (packet) => {
+            // Emit messages based on the event type.
+            this.emit(packet.event, packet);
+            // Emit messages based on the specific device.
+            this.emit(packet.event_object_id, packet);
+            // Finally, emit messages based on the specific event and device combination.
+            this.emit(packet.event + "." + packet.event_object_id, packet);
+            // If enabled, publish all the event traffic coming from the Access controller to MQTT.
+            if (this.mqttPublishTelemetry) {
+                this.controller.mqtt?.publish(this.controller.uda.host.mac, "telemetry", JSON.stringify(packet));
+            }
+        });
+        return true;
+    }
+    // Motion event processing from UniFi Access.
+    motionEventHandler(accessDevice) {
+        if (!accessDevice) {
+            return;
+        }
+        // Only notify the user if we have a motion sensor and it's active.
+        const motionService = accessDevice.accessory.getService(this.hap.Service.MotionSensor);
+        if (motionService) {
+            this.motionEventDelivery(accessDevice, motionService);
+        }
+    }
+    // Motion event delivery to HomeKit.
+    motionEventDelivery(accessDevice, motionService) {
+        if (!accessDevice) {
+            return;
+        }
+        // If we have disabled motion events, we're done here.
+        if (("detectMotion" in accessDevice.accessory.context) && !accessDevice.accessory.context.detectMotion) {
+            return;
+        }
+        // If we have an active motion event inflight, we're done.
+        if (this.eventTimers[accessDevice.id]) {
+            return;
+        }
+        // Trigger the motion event in HomeKit.
+        motionService.updateCharacteristic(this.hap.Characteristic.MotionDetected, true);
+        // If we have a motion trigger switch configured, update it.
+        accessDevice.accessory.getServiceById(this.hap.Service.Switch, AccessReservedNames.SWITCH_MOTION_TRIGGER)?.updateCharacteristic(this.hap.Characteristic.On, true);
+        // Publish the motion event to MQTT, if the user has configured it.
+        this.controller.mqtt?.publish(accessDevice.accessory, "motion", "true");
+        // Log the event, if configured to do so.
+        if (accessDevice.hints.logMotion) {
+            accessDevice.log.info("Motion detected.");
+        }
+        // Reset our motion event after motionDuration.
+        this.eventTimers[accessDevice.id] = setTimeout(() => {
+            motionService.updateCharacteristic(this.hap.Characteristic.MotionDetected, false);
+            // If we have a motion trigger switch configured, update it.
+            accessDevice.accessory.getServiceById(this.hap.Service.Switch, AccessReservedNames.SWITCH_MOTION_TRIGGER)?.updateCharacteristic(this.hap.Characteristic.On, false);
+            accessDevice.log.debug("Resetting motion event.");
+            // Publish to MQTT, if the user has configured it.
+            this.controller.mqtt?.publish(accessDevice.accessory, "motion", "false");
+            // Delete the timer from our motion event tracker.
+            delete this.eventTimers[accessDevice.id];
+        }, accessDevice.hints.motionDuration * 1000);
+    }
+}
+//# sourceMappingURL=access-events.js.map

package/dist/access-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-events.js","sourceRoot":"","sources":["../src/access-events.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,OAAO,YAAa,SAAQ,YAAY;IAEpC,GAAG,CAAM;IACT,UAAU,CAAmB;IAC7B,aAAa,CAA+C;IACnD,WAAW,CAAsC;IAC1D,GAAG,CAAM;IACT,GAAG,CAAgB;IACnB,oBAAoB,CAAU;IAC9B,QAAQ,CAAiB;IACzB,MAAM,CAAY;IAClB,cAAc,CAA0C;IACxD,iBAAiB,CAAgD;IACjE,kBAAkB,CAA+B;IAEzD,uDAAuD;IACvD,YAAY,UAA4B;QAEtC,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;QAC1B,IAAI,CAAC,oBAAoB,GAAG,UAAU,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;QAClF,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAE9B,kEAAkE;QAClE,IAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAE7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,oCAAoC;IAC5B,UAAU,CAAC,MAAyB;QAE1C,IAAI,YAAiC,CAAC;QAEtC,QAAQ,MAAM,CAAC,IAA2B,CAAC,WAAW,EAAE,CAAC;YAEvD,KAAK,KAAK,CAAC;YACX;gBAEE,qBAAqB;gBACrB,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;gBAEpE,+BAA+B;gBAC/B,IAAG,CAAC,YAAY,EAAE,CAAC;oBAEjB,MAAM;gBACR,CAAC;gBAED,yCAAyC;gBACzC,YAAY,CAAC,GAAG,GAAG,MAAM,CAAC,IAA0B,CAAC;gBAErD,qJAAqJ;gBACrJ,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;oBACrG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC;gBAEjH,sCAAsC;gBACtC,IAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC,IAAI,KAAK,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;oBAE9E,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,qHAAqH,CAAC,CAAC;oBAC7I,YAAY,CAAC,aAAa,EAAE,CAAC;gBAC/B,CAAC;gBAED,MAAM;QACV,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,IAA0B,CAAC;IAClF,CAAC;IAED,oEAAoE;IAC5D,aAAa,CAAC,MAAyB;QAE7C,qBAAqB;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAE1E,oBAAoB;QACpB,IAAG,MAAM,CAAC,KAAK,KAAK,2BAA2B,EAAE,CAAC;YAEhD,oCAAoC;YACpC,IAAG,CAAC,YAAY,EAAE,CAAC;gBAEjB,OAAO;YACT,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;IACH,CAAC;IAED,wFAAwF;IAChF,eAAe;QAErB,kFAAkF;QAClF,IAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAEhD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,qEAAqE;QACrE,IAAI,CAAC,eAAe,CAAC,2BAA2B,EAAE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvG,yBAAyB;QACzB,IAAI,CAAC,eAAe,CAAC,2BAA2B,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjF,iJAAiJ;QACjJ,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,GAAG,CAAC,MAAyB,EAAQ,EAAE;YAEjF,yCAAyC;YACzC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAEhC,8CAA8C;YAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YAE1C,6EAA6E;YAC7E,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YAE/D,uFAAuF;YACvF,IAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAE7B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YACnG,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IACtC,kBAAkB,CAAC,YAA0B;QAElD,IAAG,CAAC,YAAY,EAAE,CAAC;YAEjB,OAAO;QACT,CAAC;QAED,mEAAmE;QACnE,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAEvF,IAAG,aAAa,EAAE,CAAC;YAEjB,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,oCAAoC;IAC5B,mBAAmB,CAAC,YAA0B,EAAE,aAAsB;QAE5E,IAAG,CAAC,YAAY,EAAE,CAAC;YAEjB,OAAO;QACT,CAAC;QAED,sDAAsD;QACtD,IAAG,CAAC,cAAc,IAAI,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAEtG,OAAO;QACT,CAAC;QAED,0DAA0D;QAC1D,IAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;YAErC,OAAO;QACT,CAAC;QAED,uCAAuC;QACvC,aAAa,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAEjF,4DAA4D;QAC5D,YAAY,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,qBAAqB,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAElK,mEAAmE;QACnE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAExE,yCAAyC;QACzC,IAAG,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAEhC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC5C,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YAElD,aAAa,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YAElF,4DAA4D;YAC5D,YAAY,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,qBAAqB,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAEnK,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAElD,kDAAkD;YAClD,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEzE,kDAAkD;YAClD,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;CAkGF"}

package/dist/access-hub.d.ts

@@ -0,0 +1,21 @@
+import { AccessDeviceConfig } from "unifi-access";
+import { PlatformAccessory } from "homebridge";
+import { AccessController } from "./access-controller.js";
+import { AccessDevice } from "./access-device.js";
+export declare class AccessHub extends AccessDevice {
+    private _hkLockState;
+    private doorbellRingRequestId;
+    private lockDelayInterval;
+    uda: AccessDeviceConfig;
+    constructor(controller: AccessController, device: AccessDeviceConfig, accessory: PlatformAccessory);
+    protected configureHints(): boolean;
+    private configureDevice;
+    private configureLock;
+    private configureDoorbell;
+    private configureDoorbellTrigger;
+    private configureMqtt;
+    private get hkLockState();
+    private set hkLockState(value);
+    private get hubLockState();
+    private eventHandler;
+}