@mp-consulting/homebridge-unifi-access 1.0.0

package/dist/access-controller.js

@@ -0,0 +1,342 @@
+/* Copyright(C) 2026, Mickael Palma. All rights reserved.
+ *
+ * access-controller.ts: Access controller device class for UniFi Access.
+ */
+import { ACCESS_CONTROLLER_REFRESH_INTERVAL, ACCESS_CONTROLLER_RETRY_INTERVAL, PLATFORM_NAME, PLUGIN_NAME, createPrefixedLogger, isValidAddress, normalizeMac } from "./settings.js";
+import { AccessApi } from "unifi-access";
+import { MqttClient, retry, sanitizeName, sleep } from "homebridge-plugin-utils";
+import { AccessEventType } from "./access-types.js";
+import { AccessEvents } from "./access-events.js";
+import { AccessHub } from "./hub/index.js";
+import { getDeviceCatalog } from "./access-device-catalog.js";
+import util from "node:util";
+// Check if a device has supported hub or reader capabilities.
+function isSupportedDevice(device) {
+    return ["is_hub", "is_reader"].some(capability => device.capabilities.includes(capability));
+}
+export class AccessController {
+    api;
+    config;
+    deviceRemovalQueue;
+    configuredDevices;
+    events;
+    hap;
+    logApiErrors;
+    log;
+    mqtt;
+    name;
+    platform;
+    uda;
+    udaApi;
+    bootstrapRefreshTimer;
+    unsupportedDevices;
+    constructor(platform, accessOptions) {
+        this.api = platform.api;
+        this.config = accessOptions;
+        this.configuredDevices = {};
+        this.deviceRemovalQueue = {};
+        this.hap = this.api.hap;
+        this.logApiErrors = true;
+        this.mqtt = null;
+        this.name = accessOptions.name ?? accessOptions.address;
+        this.platform = platform;
+        this.uda = {};
+        this.unsupportedDevices = {};
+        // Configure our logging.
+        this.log = createPrefixedLogger(this.platform.log, this.platform.debug.bind(this.platform), () => this.name);
+        // Validate our controller address and login information.
+        if (!accessOptions.address || !accessOptions.username || !accessOptions.password) {
+            return;
+        }
+        // Validate that the controller address is not a loopback, link-local, or otherwise invalid address.
+        if (!isValidAddress(accessOptions.address)) {
+            this.log.error("Invalid controller address: %s. Please provide a valid network address.", accessOptions.address);
+            return;
+        }
+    }
+    // Retrieve the bootstrap configuration from the Access controller.
+    async bootstrapController() {
+        // Attempt to bootstrap the controller until we're successful.
+        await retry(async () => this.udaApi.getBootstrap(), ACCESS_CONTROLLER_RETRY_INTERVAL * 1000);
+    }
+    // Initialize our connection to the UniFi Access controller.
+    async login() {
+        // The plugin has been disabled globally. Let the user know that we're done here.
+        if (!this.hasFeature("Device")) {
+            this.log.info("Disabling this UniFi Access controller.");
+            return;
+        }
+        // Initialize our connection to the UniFi Access API.
+        const udaLog = {
+            debug: (message, ...parameters) => this.platform.debug(util.format(message, ...parameters)),
+            error: (message, ...parameters) => {
+                if (this.logApiErrors) {
+                    this.platform.log.error(util.format(message, ...parameters));
+                }
+            },
+            info: (message, ...parameters) => this.platform.log.info(util.format(message, ...parameters)),
+            warn: (message, ...parameters) => this.platform.log.warn(util.format(message, ...parameters))
+        };
+        // Create our connection to the Access API.
+        this.udaApi = new AccessApi(udaLog);
+        // Attempt to login to the Access controller, retrying at reasonable intervals. This accounts for cases where the Access controller or the network connection
+        // may not be fully available when we startup.
+        await retry(async () => this.udaApi.login(this.config.address, this.config.username, this.config.password), ACCESS_CONTROLLER_RETRY_INTERVAL * 1000);
+        // Now, let's get the bootstrap configuration from the Access controller.
+        await this.bootstrapController();
+        // Set our Access configuration from the controller.
+        this.uda = this.udaApi.controller;
+        // Assign our name if the user hasn't explicitly specified a preference.
+        this.name = this.config.name ?? this.udaApi.name;
+        // We successfully logged in.
+        this.log.info("Connected to %s (UniFi Access %s running on UniFi OS %s).", this.config.address, this.uda.version, this.uda.host.firmware_version);
+        // Now that we know the Access controller configuration, check to see if we've disabled it.
+        if (!this.hasFeature("Device")) {
+            this.udaApi.logout();
+            this.log.info("Disabling this UniFi Access controller in HomeKit.");
+            // Let's sleep for thirty seconds to give all the accessories a chance to load before disabling everything. Homebridge doesn't have a good mechanism to notify us
+            // when all the cached accessories are loaded at startup.
+            await sleep(30);
+            // Unregister all the accessories for this controller from Homebridge that may have been restored already. Any additional ones will be automatically caught when
+            // they are restored.
+            this.platform.accessories.filter(accessory => accessory.context.controller === this.uda.host.mac).map(accessory => this.removeHomeKitDevice(accessory, true));
+            return;
+        }
+        // Initialize our UniFi Access events handler.
+        this.events = new AccessEvents(this);
+        // Initialize MQTT, if needed.
+        if (!this.mqtt && this.config.mqttUrl) {
+            this.mqtt = new MqttClient(this.config.mqttUrl, this.config.mqttTopic, this.log);
+        }
+        // Inform the user about the devices we see.
+        if (this.udaApi.devices) {
+            for (const device of this.udaApi.devices) {
+                // Filter out any devices that aren't managed by this Access controller.
+                if (!device.is_managed) {
+                    continue;
+                }
+                this.log.info("Discovered %s: %s.", this.resolveDeviceModel(device), this.udaApi.getDeviceName(device, this.resolveDeviceName(device), true));
+            }
+        }
+        // Bootstrap refresh loop. Clear any existing timer to prevent accumulation.
+        const bootstrapRefresh = () => {
+            clearTimeout(this.bootstrapRefreshTimer);
+            this.bootstrapRefreshTimer = setTimeout(() => void this.bootstrapController(), ACCESS_CONTROLLER_REFRESH_INTERVAL * 1000);
+        };
+        // Sync the Access controller's devices with HomeKit.
+        const syncUdaHomeKit = () => {
+            // Sync status and check for any new or removed accessories.
+            this.discoverAndSyncAccessories();
+            // Refresh the accessory cache.
+            this.api.updatePlatformAccessories(this.platform.accessories);
+        };
+        // Initialize our Access controller device sync.
+        syncUdaHomeKit();
+        // Let's set a listener to wait for bootstrap events to occur so we can keep ourselves in sync with the Access controller.
+        this.udaApi.on("bootstrap", () => {
+            // Sync our device view.
+            syncUdaHomeKit();
+            // Refresh our bootstrap.
+            bootstrapRefresh();
+        });
+        // Kickoff our first round of bootstrap refreshes to ensure we stay in sync.
+        bootstrapRefresh();
+    }
+    // Create instances of Access device types in our plugin.
+    addAccessDevice(accessory, device) {
+        // Access hubs.
+        if (isSupportedDevice(device)) {
+            // We have a UniFi Access hub or reader.
+            this.configuredDevices[accessory.UUID] = new AccessHub(this, device, accessory);
+            return true;
+        }
+        // Default to an unknown device type.
+        this.log.error("Unknown device class %s detected for %s.", device.device_type, this.resolveDeviceName(device));
+        return false;
+    }
+    // Discover UniFi Access devices that may have been added to the controller since we last checked.
+    discoverDevices(devices) {
+        // Iterate through the list of devices that Access has returned and sync them with what we show HomeKit.
+        for (const device of devices) {
+            this.addHomeKitDevice(device);
+        }
+        return true;
+    }
+    // Add a newly detected Access device to HomeKit.
+    addHomeKitDevice(device) {
+        // If we have no MAC address, name, or this device isn't being managed by this Access controller, we're done.
+        if (!this.uda.host.mac || !device.mac || !device.is_managed) {
+            return false;
+        }
+        // We only support certain device capabilities.
+        if (!isSupportedDevice(device)) {
+            // If we've already informed the user about this one, we're done.
+            if (this.unsupportedDevices[device.mac]) {
+                return false;
+            }
+            // Notify the user we see this device, but we aren't adding it to HomeKit.
+            this.unsupportedDevices[device.mac] = true;
+            this.log.info("UniFi Access device type '%s' is not currently supported, ignoring: %s.", device.device_type, this.udaApi.getDeviceName(device));
+            return false;
+        }
+        // Generate this device's unique identifier. For multi-door devices, we append source_id to the MAC address to distinguish them.
+        const catalog = getDeviceCatalog(device.device_type);
+        const uuid = this.hap.uuid.generate(device.mac + (catalog?.appendsSourceId ? "-" + device.source_id.toUpperCase() : ""));
+        // See if we already know about this accessory.
+        let accessory = this.platform.accessories.find(x => x.UUID === uuid);
+        // Enable or disable certain devices based on configuration parameters.
+        if (!this.hasFeature("Device", device)) {
+            if (accessory) {
+                this.removeHomeKitDevice(accessory, true);
+            }
+            return false;
+        }
+        // We've got a new device, let's add it to HomeKit.
+        if (!accessory) {
+            accessory = new this.api.platformAccessory(sanitizeName(this.resolveDeviceName(device)), uuid);
+            this.log.info("%s: Adding %s to HomeKit.", this.udaApi.getFullName(device), device.display_model);
+            // Register this accessory with homebridge and add it to the accessory array so we can track it.
+            this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
+            this.platform.accessories.push(accessory);
+            this.api.updatePlatformAccessories(this.platform.accessories);
+        }
+        // Setup the accessory as a new Access device in HBUA if we haven't configured it yet.
+        if (!this.configuredDevices[accessory.UUID]) {
+            this.addAccessDevice(accessory, device);
+            return true;
+        }
+        // Update the configuration on an existing Access device.
+        // eslint-disable-next-line camelcase
+        this.events.emit(AccessEventType.DEVICE_UPDATE, { data: device, event: AccessEventType.DEVICE_UPDATE, event_object_id: device.unique_id });
+        return true;
+    }
+    // Discover and sync UniFi Access devices between HomeKit and the Access controller.
+    discoverAndSyncAccessories() {
+        if (!this.udaApi.bootstrap) {
+            return false;
+        }
+        if (this.udaApi.devices && !this.discoverDevices(this.udaApi.devices)) {
+            this.log.error("Error discovering devices.");
+        }
+        // Remove Access devices that are no longer found on this Access controller, but we still have in HomeKit.
+        this.cleanupDevices();
+        // Update our device information.
+        Object.keys(this.configuredDevices).map(x => this.configuredDevices[x]?.configureInfo());
+        return true;
+    }
+    // Cleanup removed Access devices from HomeKit.
+    cleanupDevices() {
+        // Process the device removal queue before we do anything else.
+        this.platform.accessories.filter(accessory => accessory.UUID in this.deviceRemovalQueue).map(accessory => 
+        // eslint-disable-next-line @stylistic/implicit-arrow-linebreak
+        this.removeHomeKitDevice(accessory, !this.platform.featureOptions.test("Device", (accessory.getService(this.hap.Service.AccessoryInformation)?.getCharacteristic(this.hap.Characteristic.SerialNumber).value ?? ""), this.id)));
+        for (const accessory of this.platform.accessories) {
+            const accessDevice = this.configuredDevices[accessory.UUID];
+            // Check to see if we have an orphan - where we haven't configured this in the plugin, but the accessory still exists in HomeKit. One example of when this might
+            // happen is when Homebridge might be shutdown and a device is then removed. When we start back up, the device still exists in HomeKit but not in Access. We
+            // catch those orphan devices here.
+            if (!accessDevice) {
+                this.removeHomeKitDevice(accessory, !this.platform.featureOptions.test("Device", (accessory.getService(this.hap.Service.AccessoryInformation)?.getCharacteristic(this.hap.Characteristic.SerialNumber).value ?? "")));
+                continue;
+            }
+            // If we don't have the Access bootstrap JSON available, we're done. We need to know what's on the Access controller in order to determine what to do with
+            // the accessories we know about.
+            if (!this.udaApi.bootstrap) {
+                continue;
+            }
+            // Check to see if the device still exists on the Access controller and the user has not chosen to hide it.
+            if (isSupportedDevice(accessDevice.uda) &&
+                this.udaApi.devices?.some((x) => x.mac.toLowerCase() === accessDevice.uda.mac.toLowerCase())) {
+                // In case we have previously queued a device for deletion, let's remove it from the queue since it's reappeared.
+                delete this.deviceRemovalQueue[accessDevice.accessory.UUID];
+                continue;
+            }
+            // Process the device removal.
+            this.removeHomeKitDevice(accessory, !this.hasFeature("Device", accessDevice.uda));
+        }
+    }
+    // Utility to retrieve a reasonable device name for an Access device.
+    resolveDeviceName(device) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        return (device.alias?.length ? device.alias : device.name) ?? device.display_model ?? device.model ?? device.device_type ?? "Access Device";
+    }
+    // Utility to retrieve a reasonable device model for an Access device.
+    resolveDeviceModel(device) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        return device.display_model ?? device.model ?? device.device_type ?? "Unknown Model";
+    }
+    // Remove an individual Access device from HomeKit.
+    removeHomeKitDevice(accessory, noRemovalDelay = false) {
+        // Ensure that this accessory hasn't already been removed.
+        if (!this.platform.accessories.some(x => x.UUID === accessory.UUID)) {
+            return;
+        }
+        // We only remove devices if they're on the Access controller we're interested in.
+        if (accessory.context.controller !== this.uda.host.mac) {
+            return;
+        }
+        const delayInterval = this.getFeatureNumber("Controller.DelayDeviceRemoval") ?? 0;
+        // For certain use cases, we may want to defer removal of an Access device where Access may lose track of devices for a brief period of time. This prevents a
+        // potential back-and-forth where devices are removed momentarily only to be readded later.
+        if (!noRemovalDelay && delayInterval) {
+            // Have we seen this device queued for removal previously? If not, let's add it to the queue and come back after our specified delay.
+            if (!this.deviceRemovalQueue[accessory.UUID]) {
+                this.deviceRemovalQueue[accessory.UUID] = Date.now();
+                this.log.info("%s: Delaying device removal for at least %s second%s.", accessory.displayName, delayInterval, delayInterval > 1 ? "s" : "");
+                return;
+            }
+            // Is it time to process this device removal?
+            if ((delayInterval * 1000) > (Date.now() - this.deviceRemovalQueue[accessory.UUID])) {
+                return;
+            }
+        }
+        // Cleanup after ourselves.
+        delete this.deviceRemovalQueue[accessory.UUID];
+        // Grab our instance of the Access device, if it exists.
+        const accessDevice = this.configuredDevices[accessory.UUID];
+        // See if we can pull the device's configuration details from our Access device instance or the controller.
+        const device = accessDevice?.uda ?? this.udaApi.devices?.find(dev => dev.unique_id === accessory.context.mac.toLowerCase()) ?? null;
+        this.log.info("%s: Removing %s from HomeKit.", device ? this.udaApi.getDeviceName(device) : accessDevice?.accessoryName ?? accessory.displayName, device?.display_model ?? "device");
+        // Cleanup our device instance.
+        accessDevice?.cleanup();
+        // Finally, remove it from our list of configured devices and HomeKit.
+        delete this.configuredDevices[accessory.UUID];
+        // Unregister the accessory and delete it's remnants from HomeKit and the plugin.
+        this.api.unregisterPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
+        this.platform.accessories.splice(this.platform.accessories.indexOf(accessory), 1);
+        // Tell Homebridge to save the updated list of accessories.
+        this.api.updatePlatformAccessories(this.platform.accessories);
+    }
+    // Reauthenticate with the controller.
+    async resetControllerConnection() {
+        // Clear our login credentials and statistics.
+        this.udaApi.reset();
+        // Bootstrap the Access controller.
+        await this.bootstrapController();
+    }
+    // Lookup a device by it's identifier and return it if it exists.
+    deviceLookup(deviceId) {
+        // Find the device.
+        const foundDevice = Object.keys(this.configuredDevices).find(x => this.configuredDevices[x]?.uda.unique_id === deviceId);
+        return foundDevice ? this.configuredDevices[foundDevice] : null;
+    }
+    // Utility function to return a floating point configuration parameter on a device.
+    getFeatureFloat(option) {
+        return this.platform.featureOptions.getFloat(option, this.id);
+    }
+    // Utility function to return an integer configuration parameter on a device.
+    getFeatureNumber(option) {
+        return this.platform.featureOptions.getInteger(option, this.id);
+    }
+    // Utility for checking feature options on the controller.
+    hasFeature(option, device) {
+        const deviceMac = device?.mac;
+        return this.platform.featureOptions.test(option, deviceMac ? normalizeMac(deviceMac) : this.id, this.id);
+    }
+    // Return a unique identifier for an Access controller.
+    get id() {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        return this.uda.host?.mac ? normalizeMac(this.uda.host.mac) : undefined;
+    }
+}
+//# sourceMappingURL=access-controller.js.map

package/dist/access-controller.js.map

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

package/dist/access-device-catalog.d.ts

@@ -0,0 +1,43 @@
+export type SensorInput = "Dps" | "Rel" | "Ren" | "Rex";
+type ProxyMode = "dps" | "rex";
+export interface SensorConfig {
+    configKey?: string;
+    proxyMode?: ProxyMode;
+    wiringKeys?: string[];
+}
+interface SideDoorConfig {
+    dpsConfigKey: string;
+    dpsWiringKeys: string[];
+    lockRelayConfigKey: string;
+}
+export interface DeviceCatalogEntry {
+    appendsSourceId: boolean;
+    defaultDoorService: "Lock" | "GarageDoorOpener";
+    displayModel: string;
+    hasDps: boolean;
+    hasRel: boolean;
+    hasRen: boolean;
+    hasRex: boolean;
+    lockRelayConfigKey: string;
+    sensors: Partial<Record<SensorInput, SensorConfig>>;
+    sideDoor?: SideDoorConfig;
+    skipsV1LockEvents: boolean;
+    supportsSideDoor: boolean;
+    usesConfigsApi: boolean;
+    usesLocationApi: boolean;
+    usesProxyMode: boolean;
+}
+export declare const UGT_MAIN_PORT_SOURCE_ID = "port1";
+export declare const UGT_SIDE_PORT_SOURCE_ID = "port2";
+export declare const UGT_SIDE_DOOR_TARGET_NAME = "oper2";
+export declare const deviceCatalog: Readonly<Record<string, DeviceCatalogEntry>>;
+export declare function getDeviceCatalog(deviceType: string): DeviceCatalogEntry | undefined;
+export declare function getSensorConfig(deviceType: string, sensor: SensorInput): SensorConfig | undefined;
+export declare const modelsDps: string[];
+export declare const modelsRel: string[];
+export declare const modelsRen: string[];
+export declare const modelsRex: string[];
+export declare const modelsSideDoor: string[];
+export declare const modelsDefaultGarageDoor: string[];
+export declare const modelsDefaultLock: string[];
+export {};

package/dist/access-device-catalog.js

@@ -0,0 +1,151 @@
+/* Copyright(C) 2026, Mickael Palma. All rights reserved.
+ *
+ * access-device-catalog.ts: Device catalog for UniFi Access - single source of truth for all device-specific knowledge.
+ */
+// UGT port and extension identifiers used when mapping physical doors to location IDs.
+export const UGT_MAIN_PORT_SOURCE_ID = "port1";
+export const UGT_SIDE_PORT_SOURCE_ID = "port2";
+export const UGT_SIDE_DOOR_TARGET_NAME = "oper2";
+// The device catalog, keyed by device_type. This is the single source of truth for all device-specific knowledge in the plugin.
+export const deviceCatalog = {
+    "UA-Hub-Door-Mini": {
+        appendsSourceId: false,
+        defaultDoorService: "Lock",
+        displayModel: "UA Hub Door Mini",
+        hasDps: true,
+        hasRel: false,
+        hasRen: false,
+        hasRex: true,
+        lockRelayConfigKey: "output_d1_lock_relay",
+        sensors: {
+            Dps: { configKey: "input_d1_dps", wiringKeys: ["wiring_state_d1-dps-neg", "wiring_state_d1-dps-pos"] },
+            Rex: { configKey: "input_d1_button", wiringKeys: ["wiring_state_d1-button-neg", "wiring_state_d1-button-pos"] }
+        },
+        skipsV1LockEvents: false,
+        supportsSideDoor: false,
+        usesConfigsApi: false,
+        usesLocationApi: false,
+        usesProxyMode: false
+    },
+    "UA-ULTRA": {
+        appendsSourceId: false,
+        defaultDoorService: "Lock",
+        displayModel: "UA Ultra",
+        hasDps: true,
+        hasRel: false,
+        hasRen: false,
+        hasRex: true,
+        lockRelayConfigKey: "output_d1_lock_relay",
+        sensors: {
+            Dps: { configKey: "input_d1_dps", proxyMode: "dps" },
+            Rex: { configKey: "input_d1_button", proxyMode: "rex" }
+        },
+        skipsV1LockEvents: false,
+        supportsSideDoor: false,
+        usesConfigsApi: false,
+        usesLocationApi: false,
+        usesProxyMode: true
+    },
+    "UAH": {
+        appendsSourceId: false,
+        defaultDoorService: "Lock",
+        displayModel: "UA Hub",
+        hasDps: true,
+        hasRel: true,
+        hasRen: true,
+        hasRex: true,
+        lockRelayConfigKey: "input_state_rly-lock_dry",
+        sensors: {
+            Dps: { configKey: "input_state_dps", wiringKeys: ["wiring_state_dps-neg", "wiring_state_dps-pos"] },
+            Rel: { configKey: "input_state_rel", wiringKeys: ["wiring_state_rel-neg", "wiring_state_rel-pos"] },
+            Ren: { configKey: "input_state_ren", wiringKeys: ["wiring_state_ren-neg", "wiring_state_ren-pos"] },
+            Rex: { configKey: "input_state_rex", wiringKeys: ["wiring_state_rex-neg", "wiring_state_rex-pos"] }
+        },
+        skipsV1LockEvents: false,
+        supportsSideDoor: false,
+        usesConfigsApi: false,
+        usesLocationApi: false,
+        usesProxyMode: false
+    },
+    "UAH-Ent": {
+        appendsSourceId: true,
+        defaultDoorService: "Lock",
+        displayModel: "UA Hub Enterprise",
+        hasDps: true,
+        hasRel: true,
+        hasRen: true,
+        hasRex: true,
+        lockRelayConfigKey: "input_state_rly-lock_dry",
+        sensors: {
+            Dps: { configKey: "input_state_dps", wiringKeys: ["wiring_state_dps-neg", "wiring_state_dps-pos"] },
+            Rel: { configKey: "input_state_rel", wiringKeys: ["wiring_state_rel-neg", "wiring_state_rel-pos"] },
+            Ren: { configKey: "input_state_ren", wiringKeys: ["wiring_state_ren-neg", "wiring_state_ren-pos"] },
+            Rex: { configKey: "input_state_rex", wiringKeys: ["wiring_state_rex-neg", "wiring_state_rex-pos"] }
+        },
+        skipsV1LockEvents: false,
+        supportsSideDoor: false,
+        usesConfigsApi: false,
+        usesLocationApi: false,
+        usesProxyMode: false
+    },
+    "UGT": {
+        appendsSourceId: false,
+        defaultDoorService: "GarageDoorOpener",
+        displayModel: "UA Gate",
+        hasDps: true,
+        hasRel: false,
+        hasRen: false,
+        hasRex: false,
+        lockRelayConfigKey: "output_oper1_relay",
+        sensors: {
+            Dps: { configKey: "input_gate_dps", wiringKeys: ["wiring_state_gate-dps-neg", "wiring_state_gate-dps-pos"] }
+        },
+        sideDoor: {
+            dpsConfigKey: "input_door_dps",
+            dpsWiringKeys: ["wiring_state_door-dps-neg", "wiring_state_door-dps-pos"],
+            lockRelayConfigKey: "output_oper2_relay"
+        },
+        skipsV1LockEvents: true,
+        supportsSideDoor: true,
+        usesConfigsApi: false,
+        usesLocationApi: true,
+        usesProxyMode: false
+    },
+    "UVC G6 Entry": {
+        appendsSourceId: false,
+        defaultDoorService: "Lock",
+        displayModel: "UVC G6 Entry",
+        hasDps: false,
+        hasRel: false,
+        hasRen: false,
+        hasRex: false,
+        lockRelayConfigKey: "input_state_rly-lock_dry",
+        sensors: {},
+        skipsV1LockEvents: false,
+        supportsSideDoor: false,
+        usesConfigsApi: true,
+        usesLocationApi: false,
+        usesProxyMode: false
+    }
+};
+// Look up a device catalog entry by device_type. Returns undefined for unknown devices.
+export function getDeviceCatalog(deviceType) {
+    return deviceCatalog[deviceType];
+}
+// Look up sensor configuration for a specific device and sensor input.
+export function getSensorConfig(deviceType, sensor) {
+    return getDeviceCatalog(deviceType)?.sensors[sensor];
+}
+// Returns an array of display_model strings for devices that match a given predicate.
+function modelsWithCapability(predicate) {
+    return Object.values(deviceCatalog).filter(predicate).map(entry => entry.displayModel);
+}
+// Pre-computed model arrays, replacing the hardcoded arrays in access-options.ts.
+export const modelsDps = modelsWithCapability(e => e.hasDps);
+export const modelsRel = modelsWithCapability(e => e.hasRel);
+export const modelsRen = modelsWithCapability(e => e.hasRen);
+export const modelsRex = modelsWithCapability(e => e.hasRex);
+export const modelsSideDoor = modelsWithCapability(e => e.supportsSideDoor);
+export const modelsDefaultGarageDoor = modelsWithCapability(e => e.defaultDoorService === "GarageDoorOpener");
+export const modelsDefaultLock = modelsWithCapability(e => (e.defaultDoorService === "Lock") && !e.appendsSourceId && !e.usesConfigsApi);
+//# sourceMappingURL=access-device-catalog.js.map

package/dist/access-device-catalog.js.map

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

package/dist/access-device.d.ts

@@ -0,0 +1,68 @@
+import type { API, HAP, PlatformAccessory } from "homebridge";
+import type { AccessApi, AccessDeviceConfig, AccessEventPacket } from "unifi-access";
+import { type HomebridgePluginLogging, type Nullable } from "homebridge-plugin-utils";
+import type { AccessController } from "./access-controller.js";
+import type { AccessPlatform } from "./access-platform.js";
+export interface AccessHints {
+    enabled: boolean;
+    hasMethodFace: boolean;
+    hasMethodHand: boolean;
+    hasMethodMobile: boolean;
+    hasMethodNfc: boolean;
+    hasMethodPin: boolean;
+    hasMethodQr: boolean;
+    hasMethodTwoStep: boolean;
+    hasSideDoor: boolean;
+    hasWiringDps: boolean;
+    hasWiringRel: boolean;
+    hasWiringRen: boolean;
+    hasWiringRex: boolean;
+    hasWiringSideDoorDps: boolean;
+    ledStatus: boolean;
+    logDoorbell: boolean;
+    logDps: boolean;
+    logLock: boolean;
+    logMotion: boolean;
+    logRel: boolean;
+    logRen: boolean;
+    logRex: boolean;
+    motionDuration: number;
+    occupancyDuration: number;
+    syncName: boolean;
+}
+export declare abstract class AccessBase {
+    readonly api: API;
+    readonly hap: HAP;
+    readonly log: HomebridgePluginLogging;
+    readonly controller: AccessController;
+    udaApi: AccessApi;
+    readonly platform: AccessPlatform;
+    constructor(controller: AccessController);
+    protected setInfo(accessory: PlatformAccessory, device: AccessDeviceConfig): boolean;
+    get name(): string;
+}
+export declare abstract class AccessDevice extends AccessBase {
+    accessory: PlatformAccessory;
+    hints: AccessHints;
+    listeners: Record<string, (packet: AccessEventPacket) => void>;
+    abstract uda: AccessDeviceConfig;
+    constructor(controller: AccessController, accessory: PlatformAccessory);
+    protected configureHints(): boolean;
+    configureInfo(): boolean;
+    cleanup(): void;
+    protected configureMotionSensor(isEnabled?: boolean): boolean;
+    private configureMotionSwitch;
+    private configureMotionTrigger;
+    private configureMqttMotionTrigger;
+    protected configureOccupancySensor(isEnabled?: boolean): boolean;
+    getFeatureFloat(option: string): Nullable<number | undefined>;
+    getFeatureNumber(option: string): Nullable<number | undefined>;
+    getFeatureValue(option: string): Nullable<string | undefined>;
+    hasFeature(option: string): boolean;
+    isReservedName(name: string | undefined): boolean;
+    get isOnline(): boolean;
+    get id(): string;
+    get name(): string;
+    get accessoryName(): string;
+    set accessoryName(name: string);
+}