homebridge-unifi-access/dist/access-platform.js

Homebridge UniFi Access plugin providing complete HomeKit integration for the UniFi Access ecosystem with full support for most features including autoconfiguration, motion detection, multiple controllers, and realtime updates.

import { featureOptionCategories, featureOptions } from "./access-options.js";
import { ACCESS_MQTT_TOPIC } from "./settings.js";
import { AccessController } from "./access-controller.js";
import { FeatureOptions } from "homebridge-plugin-utils";
import util from "node:util";
export class AccessPlatform {
    accessories;
    api;
    config;
    controllers;
    featureOptions;
    log;
    constructor(log, config, api) {
        this.accessories = [];
        this.api = api;
        this.controllers = [];
        this.featureOptions = new FeatureOptions(featureOptionCategories, featureOptions, config?.options ?? []);
        this.log = log;
        // We can't start without being configured.
        if (!config) {
            return;
        }
        // Plugin options into our config variables.
        this.config = {
            controllers: config.controllers,
            debugAll: false,
            options: config.options,
            ringDelay: config.ringDelay ?? 0
        };
        // We need a UniFi Access controller configured to do anything.
        if (!this.config.controllers) {
            this.log.info("No UniFi Access controllers have been configured.");
            return;
        }
        // Debugging - most people shouldn't enable this.
        this.debug("Debug logging on. Expect a lot of data.");
        // Loop through each configured NVR and instantiate it.
        for (const controllerConfig of this.config.controllers) {
            // We need an address, or there's nothing to do.
            if (!controllerConfig.address) {
                this.log.info("No host or IP address has been configured.");
                continue;
            }
            // We need login credentials or we're skipping this one.
            if (!controllerConfig.username || !controllerConfig.password) {
                this.log.info("No UniFi Access login credentials have been configured.");
                continue;
            }
            // MQTT topic to use.
            controllerConfig.mqttTopic ??= ACCESS_MQTT_TOPIC;
            this.controllers.push(new AccessController(this, controllerConfig));
        }
        // Avoid a prospective race condition by waiting to configure our controllers until Homebridge is done loading all the cached accessories it knows about, and calling
        // configureAccessory() on each.
        api.on("didFinishLaunching" /* APIEvent.DID_FINISH_LAUNCHING */, this.launchControllers.bind(this));
    }
    // This gets called when homebridge restores cached accessories at startup. We intentionally avoid doing anything significant here, and save all that logic
    // for device discovery.
    configureAccessory(accessory) {
        // Add this to the accessory array so we can track it.
        this.accessories.push(accessory);
    }
    // Launch our configured controllers once all accessories have been loaded. Once we do, they will sustain themselves.
    launchControllers() {
        // Iterate through all our controllers and startup.
        for (const controller of this.controllers) {
            // Login to the Access controller.
            void controller.login();
        }
    }
    // Utility for debug logging.
    debug(message, ...parameters) {
        if (this.config.debugAll) {
            this.log.info(util.format(message, ...parameters));
        }
    }
}
//# sourceMappingURL=access-platform.js.map