@mp-consulting/homebridge-unifi-access 1.0.0

package/dist/access-device.js

@@ -0,0 +1,330 @@
+/* Copyright(C) 2026, Mickael Palma. All rights reserved.
+ *
+ * access-device.ts: Base class for all UniFi Access devices.
+ */
+import { ACCESS_MOTION_DURATION, ACCESS_OCCUPANCY_DURATION, HK_CHARACTERISTIC_REVERT_DELAY_MS, createPrefixedLogger, normalizeMac } from "./settings.js";
+import { sanitizeName } from "homebridge-plugin-utils";
+import { AccessReservedNames } from "./access-types.js";
+import { getDeviceCatalog } from "./access-device-catalog.js";
+// Pre-computed set for fast reserved name lookups.
+const reservedNameSet = new Set(Object.values(AccessReservedNames).map(x => x.toUpperCase()));
+export class AccessBase {
+    api;
+    hap;
+    log;
+    controller;
+    udaApi;
+    platform;
+    // The constructor initializes key variables and calls configureDevice().
+    constructor(controller) {
+        this.api = controller.platform.api;
+        this.hap = this.api.hap;
+        this.controller = controller;
+        this.udaApi = controller.udaApi;
+        this.platform = controller.platform;
+        this.log = createPrefixedLogger(controller.platform.log, controller.platform.debug.bind(controller.platform), () => this.name);
+    }
+    // Configure the device information for HomeKit.
+    setInfo(accessory, device) {
+        // 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.
+        const deviceModel = device.display_model ?? device.model;
+        if (deviceModel) {
+            accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.Model, deviceModel);
+        }
+        // Update the serial number for this device.
+        if (device.mac) {
+            accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.SerialNumber, normalizeMac(device.mac));
+        }
+        // Update the firmware revision for this device.
+        if (device.firmware) {
+            // Capture the version of the device firmware, ensuring we get major, minor, and patch levels if they exist.
+            const versionRegex = /^v(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:\.(.+))?$/;
+            const match = versionRegex.exec(device.firmware);
+            // Update our firmware revision.
+            accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.FirmwareRevision, match ? match[1] + "." + (match[2] ?? "0") + "." + (match[3] ?? "0") : 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.
+        this.accessory = accessory;
+    }
+    // Configure device-specific settings.
+    configureHints() {
+        this.hints.enabled = this.hasFeature("Device");
+        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.uda.alias) {
+            this.accessoryName = this.uda.alias;
+        }
+        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)) {
+            try {
+                this.controller.events.removeListener(eventName, this.listeners[eventName]);
+            }
+            catch (error) {
+                this.log.debug("Failed to remove event listener for %s: %s", eventName, error);
+            }
+            delete this.listeners[eventName];
+        }
+    }
+    // Configure the Access motion sensor for HomeKit.
+    configureMotionSensor(isEnabled = true) {
+        // 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);
+            this.accessory.addService(motionService);
+            this.log.info("Enabling motion sensor.");
+        }
+        // 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);
+            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);
+            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), HK_CHARACTERISTIC_REVERT_DELAY_MS);
+                }
+                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), HK_CHARACTERISTIC_REVERT_DELAY_MS);
+            }
+        });
+        // 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) {
+        // 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);
+            this.accessory.addService(occupancyService);
+        }
+        // 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 this.platform.featureOptions.getFloat(option, this.id, this.controller.id);
+    }
+    // Utility function to return an integer configuration parameter on a device.
+    getFeatureNumber(option) {
+        return this.platform.featureOptions.getInteger(option, this.id, this.controller.id);
+    }
+    // Utility function to return a configuration parameter on a device.
+    getFeatureValue(option) {
+        return this.platform.featureOptions.value(option, this.id, this.controller.id);
+    }
+    // Utility for checking feature options on a device.
+    hasFeature(option) {
+        return this.controller.hasFeature(option, this.uda);
+    }
+    // Utility function for reserved identifiers for switches.
+    isReservedName(name) {
+        return name === undefined ? false : reservedNameSet.has(name.toUpperCase());
+    }
+    // Utility function to determine whether or not a device is currently online.
+    get isOnline() {
+        return ["is_adopted", "is_connected", "is_managed", "is_online"].every(key => this.uda[key]);
+    }
+    // Return a unique identifier for an Access device.
+    get id() {
+        return this.uda.mac.replace(/:/g, "") + ((getDeviceCatalog(this.uda.device_type)?.appendsSourceId) ? "-" + this.uda.source_id.toUpperCase() : "");
+    }
+    // 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.alias ?? "Unknown");
+    }
+    // Utility function to set the current accessory name of this device.
+    set accessoryName(name) {
+        const cleanedName = sanitizeName(name);
+        // Set all the internally managed names within Homebridge to the new accessory name.
+        this.accessory.displayName = cleanedName;
+        this.accessory._associatedHAPAccessory.displayName = cleanedName;
+        // Set all the HomeKit-visible names.
+        this.accessory.getService(this.hap.Service.AccessoryInformation)?.updateCharacteristic(this.hap.Characteristic.Name, cleanedName);
+    }
+}
+//# 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,27 @@
+import type { AccessEventPacket } from "unifi-access";
+import type { AccessController } from "./access-controller.js";
+import type { AccessDevice } from "./access-device.js";
+import { EventEmitter } from "node:events";
+type AccessEventMap = Record<string, [AccessEventPacket]>;
+export declare class AccessEvents extends EventEmitter<AccessEventMap> {
+    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;
+    private sanitizeTelemetry;
+    motionEventHandler(accessDevice: AccessDevice): void;
+    private motionEventDelivery;
+}
+export {};

package/dist/access-events.js

@@ -0,0 +1,152 @@
+import { AccessEventType, AccessReservedNames } from "./access-types.js";
+import { sanitizeName } from "homebridge-plugin-utils";
+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) {
+        // Lookup the device.
+        const accessDevice = this.controller.deviceLookup(packet.event_object_id);
+        // We have the device, let's check for device updates.
+        if (accessDevice) {
+            // 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.isOnline));
+            // Sync names, if configured to do so.
+            if (accessDevice.hints.syncName && accessDevice.uda.alias && (accessDevice.accessoryName !== sanitizeName(accessDevice.uda.alias))) {
+                accessDevice.log.info("Name change detected. A restart of Homebridge may be needed in order to complete name synchronization with HomeKit.");
+                accessDevice.configureInfo();
+            }
+        }
+        // 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 === AccessEventType.DEVICE_DELETE) {
+            // If it's already gone, we're done.
+            if (!accessDevice) {
+                return;
+            }
+            // Remove the device.
+            this.controller.removeHomeKitDevice(accessDevice.accessory);
+            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(AccessEventType.DEVICE_UPDATE, this.udaUpdatesHandler = this.udaUpdates.bind(this));
+        // Process remove events.
+        this.prependListener(AccessEventType.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);
+            // For v2 device update events, we need to unpack the metadata to determine which device we're targeting.
+            if ((packet.event === AccessEventType.DEVICE_UPDATE_V2) && (packet.meta?.object_type === "device")) {
+                this.emit(packet.meta.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.id ?? "", "telemetry", this.sanitizeTelemetry(packet));
+            }
+        });
+        return true;
+    }
+    // Sanitize an event packet for MQTT telemetry, stripping raw data that may contain sensitive information.
+    sanitizeTelemetry(packet) {
+        return JSON.stringify({
+            event: packet.event,
+            event_object_id: packet.event_object_id, // eslint-disable-line camelcase
+            ...(packet.meta ? { meta: { id: packet.meta.id, object_type: packet.meta.object_type } } : {}) // eslint-disable-line camelcase
+        });
+    }
+    // Motion event processing from UniFi Access.
+    motionEventHandler(accessDevice) {
+        // 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 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]) {
+            accessDevice.log.debug("Motion event rate-limited: event already in progress.");
+            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.id, "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.id, "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":"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"}

package/dist/access-options.d.ts

@@ -0,0 +1,32 @@
+import type { FeatureOptionEntry } from "homebridge-plugin-utils";
+export interface AccessOptions {
+    controllers: AccessControllerOptions[];
+    debugAll: boolean;
+    options: string[];
+    ringDelay: number;
+}
+export interface AccessControllerOptions {
+    address: string;
+    mqttTopic: string;
+    mqttUrl?: string;
+    name?: string;
+    username: string;
+    password: string;
+}
+interface AccessFeatureOption extends FeatureOptionEntry {
+    hasCapability?: string[];
+    modelKey?: string[];
+}
+export declare const featureOptionCategories: ({
+    description: string;
+    modelKey: string[];
+    name: string;
+    hasCapability?: undefined;
+} | {
+    description: string;
+    hasCapability: string[];
+    modelKey: string[];
+    name: string;
+})[];
+export declare const featureOptions: Record<string, AccessFeatureOption[]>;
+export {};