@mp-consulting/homebridge-unifi-access 1.0.0

package/dist/hub/access-hub-types.js

@@ -0,0 +1,35 @@
+import { AccessReservedNames } from "../access-types.js";
+// Access methods available to us for readers.
+export const accessMethods = [
+    { capability: "identity_face_unlock", key: "face", name: "Face Unlock", option: "AccessMethod.Face", subtype: AccessReservedNames.SWITCH_ACCESSMETHOD_FACE },
+    { capability: "hand_wave", key: "wave", name: "Hand Wave", option: "AccessMethod.Hand", subtype: AccessReservedNames.SWITCH_ACCESSMETHOD_HAND },
+    { capability: ["mobile_unlock_ver2", "support_mobile_unlock"], configsApiKeys: ["bt", "bt_button", "bt_tap"], key: "bt_button",
+        name: "Mobile", option: "AccessMethod.Mobile", subtype: AccessReservedNames.SWITCH_ACCESSMETHOD_MOBILE },
+    { capability: "nfc_card_easy_provision", key: "nfc", name: "NFC", option: "AccessMethod.NFC", subtype: AccessReservedNames.SWITCH_ACCESSMETHOD_NFC },
+    { capability: "pin_code", key: "pin_code", name: "PIN", option: "AccessMethod.PIN", subtype: AccessReservedNames.SWITCH_ACCESSMETHOD_PIN },
+    { capability: "qr_code", key: "qr_code", name: "QR Code", option: "AccessMethod.QR", subtype: AccessReservedNames.SWITCH_ACCESSMETHOD_QR },
+    { capability: "support_apple_pass", key: "apple_pass", name: "TouchPass", option: "AccessMethod.TouchPass", subtype: AccessReservedNames.SWITCH_ACCESSMETHOD_TOUCHPASS }
+];
+// Define the dry contact inputs we're interested in for Access hubs.
+export const sensorInputs = ["Dps", "Rel", "Ren", "Rex"];
+// Constants for timing.
+export const AUTO_LOCK_DELAY_MS = 5000;
+export const GATE_TRANSITION_COOLDOWN_MS = 5000;
+// Retrieve a config value by key from the Access device configs array.
+export function getConfigValue(configs, key) {
+    return configs?.find(entry => entry.key === key)?.value;
+}
+// Check if all wiring keys are active ("on") in the Access device configs.
+export function areWiringKeysActive(configs, wiringKeys) {
+    return wiringKeys.every(wire => configs?.some(e => (e.key === wire) && (e.value === "on")));
+}
+// Proxy mode configuration key for UA Ultra devices.
+export const REX_BUTTON_MODE_CONFIG_KEY = "rex_button_mode";
+// Terminal input definitions shared by configureTerminalInputs and handleDeviceUpdate.
+export const terminalInputs = [
+    { input: "Dps", label: "Door Position Sensor", topic: "dps" },
+    { input: "Rel", label: "Remote Release", topic: "rel" },
+    { input: "Ren", label: "Request to Enter Sensor", topic: "ren" },
+    { input: "Rex", label: "Request to Exit Sensor", topic: "rex" }
+];
+//# sourceMappingURL=access-hub-types.js.map

package/dist/hub/access-hub-types.js.map

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

package/dist/hub/access-hub-utils.d.ts

@@ -0,0 +1,20 @@
+import type { CharacteristicValue } from "homebridge";
+import type { SensorInput } from "../access-device-catalog.js";
+import { AccessReservedNames } from "../access-types.js";
+import { type DoorServiceType } from "./access-hub-types.js";
+import type { AccessHub } from "./access-hub.js";
+export declare function toLockState(hub: AccessHub, lockValue: "locked" | "unlocked" | "lock" | "unlock"): CharacteristicValue;
+export declare function toDpsState(hub: AccessHub, dpsValue: "open" | "close"): CharacteristicValue;
+export declare function isLocked(hub: AccessHub, state: CharacteristicValue): boolean;
+export declare function isClosed(hub: AccessHub, state: CharacteristicValue): boolean;
+export declare function doorServiceType(hub: AccessHub): DoorServiceType;
+export declare function hasCapability(hub: AccessHub, capability: string | readonly string[]): boolean;
+export declare function isWired(hub: AccessHub, input: SensorInput): boolean;
+export declare function isSideDoorDpsWired(hub: AccessHub): boolean;
+export declare function checkUltraInputs(hub: AccessHub): void;
+export declare function hubInputState(hub: AccessHub, input: SensorInput): CharacteristicValue;
+export declare function hubDpsState(hub: AccessHub, isSideDoor?: boolean): CharacteristicValue;
+export declare function hubLockState(hub: AccessHub, isSideDoor?: boolean): CharacteristicValue;
+export declare function getContactSensorState(hub: AccessHub, name: AccessReservedNames): CharacteristicValue;
+export declare function setContactSensorState(hub: AccessHub, name: AccessReservedNames, value: CharacteristicValue): void;
+export declare function logLockDelayInterval(hub: AccessHub, doorLabel: string): void;

package/dist/hub/access-hub-utils.js

@@ -0,0 +1,128 @@
+import { REX_BUTTON_MODE_CONFIG_KEY, areWiringKeysActive, getConfigValue } from "./access-hub-types.js";
+// Convert lock string value to HomeKit LockCurrentState.
+export function toLockState(hub, lockValue) {
+    return ["unlock", "unlocked"].includes(lockValue) ? hub.hap.Characteristic.LockCurrentState.UNSECURED : hub.hap.Characteristic.LockCurrentState.SECURED;
+}
+// Convert DPS string value to HomeKit ContactSensorState.
+export function toDpsState(hub, dpsValue) {
+    return dpsValue === "open" ? hub.hap.Characteristic.ContactSensorState.CONTACT_NOT_DETECTED : hub.hap.Characteristic.ContactSensorState.CONTACT_DETECTED;
+}
+// Check if a lock state represents "locked".
+export function isLocked(hub, state) {
+    return state === hub.hap.Characteristic.LockCurrentState.SECURED;
+}
+// Check if a DPS state represents "closed" (contact detected).
+export function isClosed(hub, state) {
+    return state === hub.hap.Characteristic.ContactSensorState.CONTACT_DETECTED;
+}
+// Return the door service type from configuration. UA Gate devices default to GarageDoorOpener and can be overridden to Lock. Other hubs default to Lock and can be
+// overridden to GarageDoorOpener.
+export function doorServiceType(hub) {
+    if (hub.catalog.defaultDoorService === "GarageDoorOpener") {
+        return hub.hasFeature("Hub.Door.UseLock") ? "Lock" : "GarageDoorOpener";
+    }
+    return hub.hasFeature("Hub.Door.UseGarageOpener") ? "GarageDoorOpener" : "Lock";
+}
+// Utility to validate hub capabilities.
+export function hasCapability(hub, capability) {
+    return Array.isArray(capability) ? capability.some(c => hub.uda.capabilities.includes(c)) : hub.uda.capabilities.includes(capability);
+}
+// Utility to check the wiring state of a given terminal input.
+export function isWired(hub, input) {
+    const sensorConfig = hub.catalog.sensors[input];
+    if (!sensorConfig) {
+        return false;
+    }
+    // Proxy mode devices use extension config instead of wiring keys.
+    if (sensorConfig.proxyMode) {
+        return hub.uda.extensions?.[0]?.target_config?.some(e => (e.config_key === REX_BUTTON_MODE_CONFIG_KEY) && (e.config_value === sensorConfig.proxyMode)) ?? false;
+    }
+    if (!sensorConfig.wiringKeys) {
+        return false;
+    }
+    return areWiringKeysActive(hub.uda.configs, sensorConfig.wiringKeys);
+}
+// Return the wiring state of the side door DPS.
+export function isSideDoorDpsWired(hub) {
+    const wiringKeys = hub.catalog.sideDoor?.dpsWiringKeys;
+    if (!wiringKeys) {
+        return false;
+    }
+    return areWiringKeysActive(hub.uda.configs, wiringKeys);
+}
+// Check and validate proxy mode inputs with what the user has configured in HomeKit.
+export function checkUltraInputs(hub) {
+    for (const input of ["Dps", "Rex"]) {
+        const hint = ("hasWiring" + input);
+        const sensorConfig = hub.catalog.sensors[input];
+        if (!sensorConfig?.proxyMode) {
+            continue;
+        }
+        // Is the mode enabled on the hub?
+        const isEnabled = hub.uda.extensions?.[0]?.target_config
+            ?.some(entry => (entry.config_key === REX_BUTTON_MODE_CONFIG_KEY) && (entry.config_value === sensorConfig.proxyMode));
+        if (hub.hints[hint] && !isEnabled) {
+            // The hub has disabled this input.
+            hub.hints[hint] = false;
+        }
+        else if (!hub.hints[hint] && isEnabled && hub.hasFeature("Hub." + input.toUpperCase())) {
+            // The hub has the input enabled, and we want it enabled in HomeKit.
+            hub.hints[hint] = true;
+        }
+    }
+}
+// Return the current state of a terminal input sensor on the hub. Checks wiring first and returns CONTACT_DETECTED if not wired.
+export function hubInputState(hub, input) {
+    if (!isWired(hub, input)) {
+        return hub.hap.Characteristic.ContactSensorState.CONTACT_DETECTED;
+    }
+    const configKey = hub.catalog.sensors[input]?.configKey;
+    if (!configKey) {
+        return hub.hap.Characteristic.ContactSensorState.CONTACT_DETECTED;
+    }
+    return (getConfigValue(hub.uda.configs, configKey) === "on") ? hub.hap.Characteristic.ContactSensorState.CONTACT_DETECTED :
+        hub.hap.Characteristic.ContactSensorState.CONTACT_NOT_DETECTED;
+}
+// Return the current state of the DPS on the hub.
+export function hubDpsState(hub, isSideDoor = false) {
+    if (isSideDoor) {
+        if (!isSideDoorDpsWired(hub)) {
+            return hub.hap.Characteristic.ContactSensorState.CONTACT_DETECTED;
+        }
+        const configKey = hub.catalog.sideDoor?.dpsConfigKey;
+        if (!configKey) {
+            return hub.hap.Characteristic.ContactSensorState.CONTACT_DETECTED;
+        }
+        return (getConfigValue(hub.uda.configs, configKey) === "on") ? hub.hap.Characteristic.ContactSensorState.CONTACT_DETECTED :
+            hub.hap.Characteristic.ContactSensorState.CONTACT_NOT_DETECTED;
+    }
+    return hubInputState(hub, "Dps");
+}
+// Return the current state of the relay lock on the hub.
+export function hubLockState(hub, isSideDoor = false) {
+    const configKey = isSideDoor ? hub.catalog.sideDoor?.lockRelayConfigKey : hub.catalog.lockRelayConfigKey;
+    if (!configKey) {
+        return hub.hap.Characteristic.LockCurrentState.SECURED;
+    }
+    const lockRelayValue = getConfigValue(hub.uda.configs, configKey);
+    return (lockRelayValue === "off") ? hub.hap.Characteristic.LockCurrentState.SECURED : hub.hap.Characteristic.LockCurrentState.UNSECURED;
+}
+// Utility to retrieve a contact sensor state.
+export function getContactSensorState(hub, name) {
+    return hub.accessory.getServiceById(hub.hap.Service.ContactSensor, name)?.getCharacteristic(hub.hap.Characteristic.ContactSensorState).value ??
+        hub.hap.Characteristic.ContactSensorState.CONTACT_NOT_DETECTED;
+}
+// Utility to set a contact sensor state.
+export function setContactSensorState(hub, name, value) {
+    hub.accessory.getServiceById(hub.hap.Service.ContactSensor, name)?.updateCharacteristic(hub.hap.Characteristic.ContactSensorState, value);
+}
+// Log the lock delay interval configuration for a door.
+export function logLockDelayInterval(hub, doorLabel) {
+    if (hub.lockDelayInterval === undefined) {
+        hub.log.info("The %s lock relay will lock five seconds after unlocking in HomeKit.", doorLabel);
+    }
+    else {
+        hub.log.info("The %s lock relay will remain unlocked %s after unlocking in HomeKit.", doorLabel, hub.lockDelayInterval === 0 ? "indefinitely" : "for " + hub.lockDelayInterval.toString() + " minutes");
+    }
+}
+//# sourceMappingURL=access-hub-utils.js.map

package/dist/hub/access-hub-utils.js.map

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

package/dist/hub/access-hub.d.ts

@@ -0,0 +1,39 @@
+import type { AccessDeviceConfig } from "unifi-access";
+import type { CharacteristicValue, PlatformAccessory } from "homebridge";
+import { type DeviceCatalogEntry } from "../access-device-catalog.js";
+import type { AccessController } from "../access-controller.js";
+import { AccessDevice } from "../access-device.js";
+import { type AccessHubHKProps, type AccessHubWiredProps, type HubEventKey, type HubEventMap, type KeyOf } from "./access-hub-types.js";
+export interface AccessHub extends AccessHubHKProps, AccessHubWiredProps {
+}
+export type HkStateKey = KeyOf<AccessHub, "hk", "State">;
+declare class HubEventBus {
+    private readonly emitter;
+    emit<K extends HubEventKey>(event: K, data: HubEventMap[K]): void;
+    on<K extends HubEventKey>(event: K, handler: (data: HubEventMap[K]) => void): void;
+}
+export declare class AccessHub extends AccessDevice {
+    _hkDpsState: CharacteristicValue;
+    _hkLockState: CharacteristicValue;
+    _hkSideDoorDpsState: CharacteristicValue;
+    _hkSideDoorLockState: CharacteristicValue;
+    readonly catalog: DeviceCatalogEntry;
+    doorbellRingRequestId: string | null;
+    gateTransitionUntil: number;
+    lockDelayInterval: number | undefined;
+    mainDoorLocationId: string | undefined;
+    sideDoorLocationId: string | undefined;
+    sideDoorGateTransitionUntil: number;
+    uda: AccessDeviceConfig;
+    readonly hubEvents: HubEventBus;
+    constructor(controller: AccessController, device: AccessDeviceConfig, accessory: PlatformAccessory);
+    protected configureHints(): boolean;
+    private configureDevice;
+    get hkDpsState(): CharacteristicValue;
+    set hkDpsState(value: CharacteristicValue);
+    get hkLockState(): CharacteristicValue;
+    set hkLockState(value: CharacteristicValue);
+    get hkSideDoorLockState(): CharacteristicValue;
+    set hkSideDoorLockState(value: CharacteristicValue);
+}
+export {};

package/dist/hub/access-hub.js

@@ -0,0 +1,185 @@
+/* Copyright(C) 2026, Mickael Palma. All rights reserved.
+ *
+ * access-hub.ts: Core hub class for UniFi Access. State management, construction, orchestration, and static property definitions.
+ */
+import { EventEmitter } from "events";
+import { getDeviceCatalog } from "../access-device-catalog.js";
+import { AccessDevice } from "../access-device.js";
+import { AccessReservedNames } from "../access-types.js";
+import { sensorInputs } from "./access-hub-types.js";
+import { discoverDoorIds } from "./access-hub-api.js";
+import { registerEventHandlers } from "./access-hub-events.js";
+import { configureMqtt } from "./access-hub-mqtt.js";
+import { configureServices, registerServiceReactions } from "./access-hub-services.js";
+import { checkUltraInputs, getContactSensorState, hubDpsState, hubLockState, isWired, logLockDelayInterval, setContactSensorState } from "./access-hub-utils.js";
+// Typed event emitter wrapper for the hub event bus.
+class HubEventBus {
+    emitter = new EventEmitter();
+    emit(event, data) {
+        this.emitter.emit(event, data);
+    }
+    on(event, handler) {
+        this.emitter.on(event, handler);
+    }
+}
+export class AccessHub extends AccessDevice {
+    // State backing fields - public for module access.
+    _hkDpsState;
+    _hkLockState;
+    _hkSideDoorDpsState;
+    _hkSideDoorLockState;
+    // Device configuration - public for module access.
+    catalog;
+    doorbellRingRequestId;
+    gateTransitionUntil;
+    lockDelayInterval;
+    mainDoorLocationId;
+    sideDoorLocationId;
+    sideDoorGateTransitionUntil;
+    uda;
+    // Internal event bus for state-change reactions.
+    hubEvents = new HubEventBus();
+    // Create an instance.
+    constructor(controller, device, accessory) {
+        super(controller, accessory);
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        this.catalog = getDeviceCatalog(device.device_type) ?? getDeviceCatalog("UAH");
+        this.uda = device;
+        this._hkDpsState = hubDpsState(this);
+        this._hkLockState = hubLockState(this);
+        this._hkSideDoorDpsState = hubDpsState(this, true);
+        this._hkSideDoorLockState = hubLockState(this, true);
+        this.gateTransitionUntil = 0;
+        this.lockDelayInterval = this.getFeatureNumber("Hub.LockDelayInterval") ?? undefined;
+        this.mainDoorLocationId = undefined;
+        this.sideDoorLocationId = undefined;
+        this.sideDoorGateTransitionUntil = 0;
+        this.doorbellRingRequestId = null;
+        // If we attempt to set the delay interval to something invalid, then assume we are using the default unlock behavior.
+        if ((this.lockDelayInterval !== undefined) && (this.lockDelayInterval < 0)) {
+            this.lockDelayInterval = undefined;
+        }
+        this.configureHints();
+        this.configureDevice();
+    }
+    // Configure device-specific settings for this device.
+    configureHints() {
+        // Configure our parent's hints.
+        super.configureHints();
+        this.hints.hasSideDoor = this.catalog.supportsSideDoor && this.hasFeature("Hub.SideDoor");
+        this.hints.hasWiringDps = this.catalog.hasDps && this.hasFeature("Hub.DPS");
+        this.hints.hasWiringRel = this.catalog.hasRel && this.hasFeature("Hub.REL");
+        this.hints.hasWiringRen = this.catalog.hasRen && this.hasFeature("Hub.REN");
+        this.hints.hasWiringRex = this.catalog.hasRex && this.hasFeature("Hub.REX");
+        this.hints.hasWiringSideDoorDps = this.hints.hasSideDoor && this.hasFeature("Hub.SideDoor.DPS");
+        this.hints.logDoorbell = this.hasFeature("Log.Doorbell");
+        this.hints.logDps = this.hasFeature("Log.DPS");
+        this.hints.logLock = this.hasFeature("Log.Lock");
+        this.hints.logRel = this.hasFeature("Log.REL");
+        this.hints.logRen = this.hasFeature("Log.REN");
+        this.hints.logRex = this.hasFeature("Log.REX");
+        // Proxy mode devices have a single terminal input that's selectable between DPS and REX modes.
+        if (this.catalog.usesProxyMode) {
+            checkUltraInputs(this);
+        }
+        return true;
+    }
+    // Initialize and configure the hub accessory for HomeKit. Orchestrates all module setup.
+    configureDevice() {
+        this._hkLockState = hubLockState(this);
+        this._hkSideDoorDpsState = hubDpsState(this, true);
+        this._hkSideDoorLockState = hubLockState(this, true);
+        // Clean out the context object in case it's been polluted somehow.
+        this.accessory.context = {};
+        this.accessory.context.mac = this.uda.mac;
+        this.accessory.context.controller = this.controller.uda.host.mac;
+        logLockDelayInterval(this, "door");
+        if (this.hints.hasSideDoor) {
+            logLockDelayInterval(this, "side door");
+        }
+        // Configure accessory information.
+        this.configureInfo();
+        // Register state-change reaction handlers on the event bus (must be done before services so reactions are ready).
+        registerServiceReactions(this);
+        // Configure all HomeKit services.
+        configureServices(this);
+        // Configure MQTT services (includes its own event bus subscriptions).
+        configureMqtt(this);
+        // Discover door IDs for UA Gate hubs (must be done before registering event handlers so door IDs are available).
+        if (this.catalog.usesLocationApi) {
+            discoverDoorIds(this);
+        }
+        // Register external event handlers (subscribes to controller events).
+        registerEventHandlers(this);
+        return true;
+    }
+    // HomeKit DPS state property accessor. Reads from the contact sensor service if available, otherwise falls back to the backing variable.
+    get hkDpsState() {
+        const service = this.accessory.getServiceById(this.hap.Service.ContactSensor, AccessReservedNames.CONTACT_DPS);
+        if (service) {
+            return service.getCharacteristic(this.hap.Characteristic.ContactSensorState).value ?? this._hkDpsState;
+        }
+        return this._hkDpsState;
+    }
+    // HomeKit DPS state setter. Updates the backing variable, contact sensor, and emits events.
+    set hkDpsState(value) {
+        this._hkDpsState = value;
+        setContactSensorState(this, AccessReservedNames.CONTACT_DPS, value);
+        // Emit events for DPS and sensor changes.
+        this.hubEvents.emit("dps:changed", { isSideDoor: false, value });
+        this.hubEvents.emit("sensor:changed", { input: "Dps", value });
+    }
+    // HomeKit lock state property accessor.
+    get hkLockState() {
+        return this._hkLockState;
+    }
+    // HomeKit lock state setter. Updates the backing variable and emits the lock:changed event.
+    set hkLockState(value) {
+        // Update the lock state.
+        this._hkLockState = value;
+        // Emit the lock:changed event - service reactions and MQTT will handle the rest.
+        this.hubEvents.emit("lock:changed", { isSideDoor: false, value });
+    }
+    // HomeKit side door lock state property accessor.
+    get hkSideDoorLockState() {
+        return this._hkSideDoorLockState;
+    }
+    // HomeKit side door lock state setter. Updates the backing variable and emits the lock:changed event.
+    set hkSideDoorLockState(value) {
+        // Update the lock state.
+        this._hkSideDoorLockState = value;
+        // Emit the lock:changed event - service reactions and MQTT will handle the rest.
+        this.hubEvents.emit("lock:changed", { isSideDoor: true, value });
+    }
+    // We dynamically define our getters and setters for terminal inputs so we can streamline redundancies.
+    static {
+        // Define wiring getters for all sensor inputs.
+        for (const input of sensorInputs) {
+            Object.defineProperty(AccessHub.prototype, "is" + input + "Wired", {
+                configurable: true,
+                enumerable: true,
+                get() {
+                    return isWired(this, input);
+                }
+            });
+        }
+        // Define hk*State getters and setters. We skip DPS since we implement it with a manual getter/setter that provides fallback behavior when the DPS contact sensor
+        // is disabled.
+        for (const input of sensorInputs.filter(i => i !== "Dps")) {
+            const enumKey = "CONTACT_" + input.toUpperCase();
+            Object.defineProperty(AccessHub.prototype, "hk" + input + "State", {
+                configurable: true,
+                enumerable: true,
+                get() {
+                    return getContactSensorState(this, AccessReservedNames[enumKey]);
+                },
+                set(value) {
+                    setContactSensorState(this, AccessReservedNames[enumKey], value);
+                    // Emit sensor:changed event for MQTT and logging.
+                    this.hubEvents.emit("sensor:changed", { input: input, value });
+                }
+            });
+        }
+    }
+}
+//# sourceMappingURL=access-hub.js.map

package/dist/hub/access-hub.js.map

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

package/dist/hub/index.d.ts

@@ -0,0 +1,4 @@
+export { AccessHub } from "./access-hub.js";
+export type { HkStateKey } from "./access-hub.js";
+export { AUTO_LOCK_DELAY_MS, GATE_TRANSITION_COOLDOWN_MS, REX_BUTTON_MODE_CONFIG_KEY, areWiringKeysActive, getConfigValue, accessMethods, sensorInputs, terminalInputs } from "./access-hub-types.js";
+export type { AccessEventDeviceUpdateV2, AccessEventLocationUpdate, AccessHubHKProps, AccessHubWiredProps, AccessMethodKey, DoorServiceType, HasWiringHintKey, HubEventKey, HubEventMap, KeyOf, LogHintKey } from "./access-hub-types.js";

package/dist/hub/index.js

@@ -0,0 +1,7 @@
+/* Copyright(C) 2026, Mickael Palma. All rights reserved.
+ *
+ * hub/index.ts: Barrel export for the UniFi Access hub module.
+ */
+export { AccessHub } from "./access-hub.js";
+export { AUTO_LOCK_DELAY_MS, GATE_TRANSITION_COOLDOWN_MS, REX_BUTTON_MODE_CONFIG_KEY, areWiringKeysActive, getConfigValue, accessMethods, sensorInputs, terminalInputs } from "./access-hub-types.js";
+//# sourceMappingURL=index.js.map

package/dist/hub/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hub/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,kBAAkB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAC9J,MAAM,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { API } from "homebridge";
+declare const _default: (api: API) => void;
+export default _default;

package/dist/index.js

@@ -0,0 +1,11 @@
+/* Copyright(C) 2026, Mickael Palma. All rights reserved.
+ *
+ * index.ts: homebridge-unifi-access plugin registration.
+ */
+import { PLATFORM_NAME, PLUGIN_NAME } from "./settings.js";
+import { AccessPlatform } from "./access-platform.js";
+// Register our platform with homebridge.
+export default (api) => {
+    api.registerPlatform(PLUGIN_NAME, PLATFORM_NAME, AccessPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,yCAAyC;AACzC,eAAe,CAAC,GAAQ,EAAQ,EAAE;IAEhC,GAAG,CAAC,gBAAgB,CAAC,WAAW,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;AACnE,CAAC,CAAC"}

package/dist/settings.d.ts

@@ -0,0 +1,16 @@
+import type { HomebridgePluginLogging } from "homebridge-plugin-utils";
+import type { Logging } from "homebridge";
+export declare const PLUGIN_NAME = "@mp-consulting/homebridge-unifi-access";
+export declare const PLATFORM_NAME = "UniFi Access";
+export declare const ACCESS_CONTROLLER_REFRESH_INTERVAL = 120;
+export declare const ACCESS_CONTROLLER_RETRY_INTERVAL = 10;
+export declare const ACCESS_DEVICE_REMOVAL_DELAY_INTERVAL = 60;
+export declare const ACCESS_DEVICE_UNLOCK_INTERVAL = 0;
+export declare const ACCESS_MOTION_DURATION = 10;
+export declare const ACCESS_MQTT_RECONNECT_INTERVAL = 60;
+export declare const ACCESS_MQTT_TOPIC = "unifi/access";
+export declare const ACCESS_OCCUPANCY_DURATION = 300;
+export declare const HK_CHARACTERISTIC_REVERT_DELAY_MS = 50;
+export declare function normalizeMac(mac: string): string;
+export declare function isValidAddress(address: string): boolean;
+export declare function createPrefixedLogger(platformLog: Logging, debugFn: (message: string, ...parameters: unknown[]) => void, nameGetter: () => string): HomebridgePluginLogging;

package/dist/settings.js

@@ -0,0 +1,49 @@
+import util from "node:util";
+// The name of our plugin.
+export const PLUGIN_NAME = "@mp-consulting/homebridge-unifi-access";
+// The platform the plugin creates.
+export const PLATFORM_NAME = "UniFi Access";
+// How often, in seconds, should we check Access controllers for new or removed devices.
+export const ACCESS_CONTROLLER_REFRESH_INTERVAL = 120;
+// How often, in seconds, should we retry getting our bootstrap configuration from the Access controller.
+export const ACCESS_CONTROLLER_RETRY_INTERVAL = 10;
+// Default delay, in seconds, before removing Access devices that no longer exist.
+export const ACCESS_DEVICE_REMOVAL_DELAY_INTERVAL = 60;
+// Default delay, in minutes, before locking an unlocked door relay.
+export const ACCESS_DEVICE_UNLOCK_INTERVAL = 0;
+// Default duration, in seconds, of motion events. Setting this too low will potentially cause a lot of notification spam.
+export const ACCESS_MOTION_DURATION = 10;
+// How often, in seconds, should we try to reconnect with an MQTT broker, if we have one configured.
+export const ACCESS_MQTT_RECONNECT_INTERVAL = 60;
+// Default MQTT topic to use when publishing events. This is in the form of: unifi/access/MAC/event
+export const ACCESS_MQTT_TOPIC = "unifi/access";
+// Default duration, in seconds, of occupancy events.
+export const ACCESS_OCCUPANCY_DURATION = 300;
+// Delay, in milliseconds, before reverting a HomeKit characteristic value after a failed or no-op set.
+export const HK_CHARACTERISTIC_REVERT_DELAY_MS = 50;
+// Normalize a MAC address by stripping colons and uppercasing.
+export function normalizeMac(mac) {
+    return mac.replace(/:/g, "").toUpperCase();
+}
+// Validate a controller address, rejecting loopback, link-local, and unspecified addresses.
+export function isValidAddress(address) {
+    if (!address || (typeof address !== "string")) {
+        return false;
+    }
+    const trimmed = address.trim().toLowerCase();
+    if (!trimmed || (trimmed === "localhost") || trimmed.startsWith("127.") || trimmed.startsWith("169.254.") || (trimmed === "0.0.0.0") ||
+        trimmed.startsWith("[") || trimmed.includes("::")) {
+        return false;
+    }
+    return true;
+}
+// Factory for the prefixed logging adapter pattern used across devices and controllers.
+export function createPrefixedLogger(platformLog, debugFn, nameGetter) {
+    return {
+        debug: (message, ...parameters) => debugFn(util.format(nameGetter() + ": " + message, ...parameters)),
+        error: (message, ...parameters) => platformLog.error(util.format(nameGetter() + ": " + message, ...parameters)),
+        info: (message, ...parameters) => platformLog.info(util.format(nameGetter() + ": " + message, ...parameters)),
+        warn: (message, ...parameters) => platformLog.warn(util.format(nameGetter() + ": " + message, ...parameters))
+    };
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAMA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,0BAA0B;AAC1B,MAAM,CAAC,MAAM,WAAW,GAAG,wCAAwC,CAAC;AAEpE,mCAAmC;AACnC,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,wFAAwF;AACxF,MAAM,CAAC,MAAM,kCAAkC,GAAG,GAAG,CAAC;AAEtD,yGAAyG;AACzG,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,CAAC;AAEnD,kFAAkF;AAClF,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAE,CAAC;AAEvD,oEAAoE;AACpE,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAE/C,0HAA0H;AAC1H,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,oGAAoG;AACpG,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAEjD,mGAAmG;AACnG,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,qDAAqD;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,uGAAuG;AACvG,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAEpD,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,GAAW;IAEtC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,OAAe;IAE5C,IAAG,CAAC,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAE7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,IAAG,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,WAAW,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;QACjI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAEpD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAAC,WAAoB,EAAE,OAA4D,EACrH,UAAwB;IAExB,OAAO;QAEL,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,UAAqB,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC;QAC9H,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,UAAqB,EAAQ,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC;QACxI,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,UAAqB,EAAQ,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC;QACtI,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,UAAqB,EAAQ,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC;KACvI,CAAC;AACJ,CAAC"}