homebridge-plugin-utils 1.0.0

package/dist/featureoptions.js

@@ -0,0 +1,366 @@
+export class FeatureOptions {
+    _categories;
+    _configuredOptions;
+    _groups;
+    _options;
+    defaultReturnValue;
+    defaults;
+    valueOptions;
+    // Create a feature option instance.
+    constructor(categories, options, configuredOptions) {
+        // Initialize our defaults.
+        this._categories = [];
+        this._configuredOptions = [];
+        this._groups = {};
+        this._options = {};
+        this.defaultReturnValue = false;
+        this.defaults = {};
+        this.valueOptions = {};
+        this.categories = categories ?? [];
+        this.configuredOptions = configuredOptions;
+        this.options = options ?? {};
+    }
+    color(option, device) {
+        switch (this.scope(option, device)) {
+            case "device":
+                return "text-info";
+            case "controller":
+                return "text-success";
+            case "global":
+                return device ? "text-warning" : "text-info";
+            default:
+                return "";
+        }
+    }
+    /**
+     * Return the default value for an option.
+     *
+     * @param option        - Feature option to check.
+     *
+     * @returns Returns true or false, depending on the option default.
+     */
+    defaultValue(option) {
+        // Value-centric feature options don't have default values.
+        if (this.isValue(option)) {
+            return this.defaultReturnValue;
+        }
+        const value = this.defaults[option.toLowerCase()];
+        // If it's unknown to us, assume it's true.
+        if (value === undefined) {
+            return this.defaultReturnValue;
+        }
+        return value;
+    }
+    /**
+     * Return whether the option explicitly exists in the list of configured options.
+     *
+     * @param option        - Feature option to check.
+     * @param id            - Optional device or controller scope identifier to check.
+     *
+     * @returns Returns true if the option has been explicitly configured, false otherwise.
+     */
+    exists(option, id) {
+        const regex = this.isValue(option) ? this.valueRegex(option, id) : this.optionRegex(option, id);
+        return this.configuredOptions.some(x => regex.test(x));
+    }
+    /**
+     * Return a fully formed feature option string.
+     *
+     * @param category      - Feature option category entry or category name string.
+     * @param option        - Feature option entry of option name string.
+     *
+     * @returns Returns a fully formed feature option in the form of `category.option`.
+     */
+    expandOption(category, option) {
+        const categoryName = (typeof category === "string") ? category : category.name;
+        const optionName = (typeof option === "string") ? option : option.name;
+        if (!categoryName || !categoryName.length) {
+            return "";
+        }
+        return (!optionName || !optionName.length) ? categoryName : categoryName + "." + optionName;
+    }
+    /**
+     * Parse a floating point feature option value.
+     *
+     * @param value        - Value to parse.
+     *
+     * @returns Returns a floating point number from a string, or `undefined` if it couldn't be parsed.
+     */
+    getFloat(value) {
+        // We don't have the value configured -- we're done.
+        if (value === undefined) {
+            return undefined;
+        }
+        // Parse the number and return the value.
+        return this.parseOptionNumeric(value, parseFloat);
+    }
+    /**
+     * Parse an integer feature option value.
+     *
+     * @param value        - Value to parse.
+     *
+     * @returns Returns an integer from a string, or `undefined` if it couldn't be parsed.
+     */
+    getInteger(value) {
+        // We don't have the value configured -- we're done.
+        if (value === undefined) {
+            return undefined;
+        }
+        // Parse the number and return the value.
+        return this.parseOptionNumeric(value, parseInt);
+    }
+    /**
+     * Return whether an option has been set in either the device or controller scope context.
+     *
+     * @param option        - Feature option to check.
+     *
+     * @returns Returns true if the option is set at the device or controller level and false otherwise.
+     */
+    isScopeDevice(option, device) {
+        const value = this.exists(option, device);
+        // Return the value if it's set, or the default value for this option.
+        return (value !== undefined) ? value : this.defaultValue(option);
+    }
+    /**
+     * Return whether an option has been set in the global scope context.
+     *
+     * @param option        - Feature option to check.
+     *
+     * @returns Returns true if the option is set globally and false otherwise.
+     */
+    isScopeGlobal(option) {
+        const value = this.exists(option);
+        // Return the value if it's set, or the default value for this option.
+        return (value !== undefined) ? value : this.defaultValue(option);
+    }
+    /**
+     * Return whether an option is value-centric or not.
+     *
+     * @param option        - Feature option entry or string to check.
+     *
+     * @returns Returns true if it is a value-centric option and false otherwise.
+     */
+    isValue(option) {
+        return this.valueOptions[option?.toLowerCase()] === true;
+    }
+    /**
+     * Return the scope hierarchy location of an option.
+     *
+     * @param option        - Feature option to check.
+     * @param device        - Optional device scope identifier.
+     * @param controller    - Optional controller scope identifier.
+     *
+     * @returns Returns an object containing the location in the scope hierarchy of an `option` as well as the current value associated with the option.
+     */
+    scope(option, device, controller) {
+        return this.getOptionInfo(option, device, controller).scope;
+    }
+    /**
+     * Return the current state of a feature option, traversing the scope hierarchy.
+     *
+     * @param option        - Feature option to check.
+     * @param device        - Optional device scope identifier.
+     * @param controller    - Optional controller scope identifier.
+     *
+     * @returns Returns true if the option is enabled, and false otherwise.
+     */
+    test(option, device, controller) {
+        return this.getOptionInfo(option, device, controller).value;
+    }
+    /**
+     * Return the value associated with a value-centric feature option, traversing the scope hierarchy.
+     *
+     * @param option        - Feature option to check.
+     * @param device        - Optional device scope identifier.
+     * @param controller    - Optional controller scope identifier.
+     *
+     * @returns Returns the current value associated with `option` or `undefined` if none.
+     */
+    value(option, device, controller) {
+        const getValue = (checkOption, checkId) => {
+            const regex = this.valueRegex(checkOption, checkId);
+            // Get the option value, if we have one.
+            for (const entry of this.configuredOptions) {
+                const regexMatch = regex.exec(entry);
+                if (regexMatch) {
+                    return regexMatch[1];
+                }
+            }
+            return undefined;
+        };
+        // Check to see if we have a device-level value first.
+        if (device) {
+            const value = getValue(option, device);
+            if (value) {
+                return value;
+            }
+        }
+        // Now check to see if we have an controller-level value.
+        if (controller) {
+            const value = getValue(option, controller);
+            if (value) {
+                return value;
+            }
+        }
+        // Finally, we check for a global-level value.
+        return getValue(option);
+    }
+    /**
+     * Return the list of available feature option categories.
+     *
+     * @returns Returns the current list of available feature option categories.
+     */
+    get categories() {
+        return this._categories;
+    }
+    /**
+     * Set the list of available feature option categories.
+     *
+     * @param options       - Array of available feature options.
+     */
+    set categories(category) {
+        this._categories = category;
+    }
+    /**
+     * Return the list of currently configured feature options.
+     *
+     * @returns Returns the currently configured list of feature options.
+     */
+    get configuredOptions() {
+        return this._configuredOptions;
+    }
+    /**
+     * Set the list of currently configured feature options.
+     *
+     * @param options       - Array of configured feature options.
+     */
+    set configuredOptions(options) {
+        this._configuredOptions = options ?? [];
+    }
+    /**
+     * Return the list of available feature option groups.
+     *
+     * @returns Returns the current list of available feature option groups.
+     */
+    get groups() {
+        return this._groups;
+    }
+    /**
+     * Return the list of available feature options.
+     *
+     * @returns Returns the current list of available feature options.
+     */
+    get options() {
+        return this._options;
+    }
+    /**
+     * Set the list of available feature options.
+     *
+     * @param options       - Array of available feature options.
+     */
+    set options(options) {
+        this._options = options ?? {};
+        // Regenerate our defaults.
+        this.generateDefaults();
+    }
+    // Build our list of default values for our feature options.
+    generateDefaults() {
+        this.defaults = {};
+        this._groups = {};
+        this.valueOptions = {};
+        for (const category of this.categories) {
+            // Now enumerate all the feature options for a given device and add then to the full list.
+            for (const option of this.options[category.name]) {
+                // Expand the entry.
+                const entry = this.expandOption(category, option);
+                // Index the default value.
+                this.defaults[entry.toLowerCase()] = option.default;
+                // Track value-centric options.
+                this.valueOptions[entry.toLowerCase()] = "defaultValue" in option;
+                // Cross reference the feature option group it belongs to, if any.
+                if (option.group !== undefined) {
+                    const expandedGroup = category.name + (option.group.length ? ("." + option.group) : "");
+                    // Initialize the group entry if needed and add the entry.
+                    (this._groups[expandedGroup] ??= []).push(entry);
+                }
+            }
+        }
+    }
+    // Utility function to return the setting of a particular option and it's position in the scoping hierarchy.
+    getOptionInfo(option, device, controller) {
+        // There are a couple of ways to enable and disable options. The rules of the road are:
+        //
+        // 1. Explicitly disabling, or enabling an option on the controller propogates to all the devices that are managed by that controller. Why might you want to do this?
+        //    Because...
+        //
+        // 2. Explicitly disabling, or enabling an option on a device always override the above. This means that it's possible to disable an option for a controller, and all
+        //    the devices that are managed by it, and then override that behavior on a single device that it's managing.
+        // Check to see if we have a device-level option first.
+        if (device && this.exists(option, device)) {
+            const value = this.isOptionEnabled(option, device);
+            if (value !== undefined) {
+                return { scope: "device", value: value };
+            }
+        }
+        // Now check to see if we have an controller-level option.
+        if (controller && this.exists(option, controller)) {
+            const value = this.isOptionEnabled(option, controller);
+            if (value !== undefined) {
+                return { scope: "controller", value: value };
+            }
+        }
+        // Finally, we check for a global-level value.
+        if (this.exists(option)) {
+            const value = this.isOptionEnabled(option);
+            if (value !== undefined) {
+                return { scope: "global", value: value };
+            }
+        }
+        // The option hasn't been set at any scope, return our default value.
+        return { scope: "none", value: this.defaultValue(option) };
+    }
+    // Utility to test whether an option is set in a given scope.
+    // We return true if an option is enabled, false for disabled, undefined otherwise. For value-centric options, we return true if a value exists.
+    isOptionEnabled(option, id) {
+        // Deal with value-centric options uniquely.
+        if (this.isValue(option)) {
+            return this.exists(option, id);
+        }
+        const regex = this.optionRegex(option, id);
+        // Get the option value, if we have one.
+        for (const entry of this.configuredOptions) {
+            const regexMatch = regex.exec(entry);
+            if (regexMatch) {
+                return regexMatch[1].toLowerCase() === "enable";
+            }
+        }
+        return undefined;
+    }
+    // Regular expression test for feature options.
+    optionRegex(option, id) {
+        // This regular expression is a bit more intricate than you might think it should be due to the need to ensure we capture values at the very end of the option. We
+        // also need to escape out our option to ensure we have no inadvertent issues in matching the regular expression.
+        return new RegExp("^(Enable|Disable)\\." + option.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + (!id ? "" : "\\." + id) + "$", "gi");
+    }
+    // Utility function to parse and return a numeric configuration parameter.
+    parseOptionNumeric(option, convert) {
+        // We don't have the option configured -- we're done.
+        if (option === undefined) {
+            return undefined;
+        }
+        // Convert it to a number, if needed.
+        const convertedValue = convert(option);
+        // Let's validate to make sure it's really a number.
+        if (isNaN(convertedValue) || (convertedValue < 0)) {
+            return undefined;
+        }
+        // Return the value.
+        return convertedValue;
+    }
+    // Regular expression test for value-centric feature options.
+    valueRegex(option, id) {
+        // This regular expression is a bit more intricate than you might think it should be due to the need to ensure we capture values at the very end of the option.
+        return new RegExp("^Enable\\." + option.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + (!id ? "" : "\\." + id) + "\\.([^\\.]+)$", "gi");
+    }
+}
+//# sourceMappingURL=featureoptions.js.map

package/dist/featureoptions.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./featureoptions.js";
+export * from "./mqttclient.js";
+export * from "./utils.js";

package/dist/index.js

@@ -0,0 +1,8 @@
+/* Copyright(C) 2017-2024, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * index.ts: Homebridge plugin utilities.
+ */
+export * from "./featureoptions.js";
+export * from "./mqttclient.js";
+export * from "./utils.js";
+//# 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,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/mqttclient.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="node" />
+import { HomebridgePluginLogging } from "./utils.js";
+export declare class MqttClient {
+    private brokerUrl;
+    private isConnected;
+    private reconnectInterval;
+    private log;
+    private mqtt;
+    private subscriptions;
+    private topicPrefix;
+    constructor(brokerUrl: string, topicPrefix: string, log: HomebridgePluginLogging, reconnectInterval?: number);
+    private configure;
+    publish(id: string, topic: string, message: string): void;
+    subscribe(id: string, topic: string, callback: (cbBuffer: Buffer) => void): void;
+    subscribeGet(id: string, topic: string, type: string, getValue: () => string, log?: HomebridgePluginLogging): void;
+    subscribeSet(id: string, topic: string, type: string, setValue: (value: string, rawValue: string) => Promise<void> | void, log?: HomebridgePluginLogging): void;
+    unsubscribe(id: string, topic: string): void;
+    private expandTopic;
+}

package/dist/mqttclient.js

@@ -0,0 +1,163 @@
+import mqtt from "mqtt";
+import util from "node:util";
+const MQTT_DEFAULT_RECONNECT_INTERVAL = 60;
+export class MqttClient {
+    brokerUrl;
+    isConnected;
+    reconnectInterval;
+    log;
+    mqtt;
+    subscriptions;
+    topicPrefix;
+    constructor(brokerUrl, topicPrefix, log, reconnectInterval = MQTT_DEFAULT_RECONNECT_INTERVAL) {
+        this.brokerUrl = brokerUrl;
+        this.isConnected = false;
+        this.log = log;
+        this.mqtt = null;
+        this.reconnectInterval = reconnectInterval;
+        this.subscriptions = {};
+        this.topicPrefix = topicPrefix;
+        this.configure();
+    }
+    // Connect to the MQTT broker.
+    configure() {
+        // Try to connect to the MQTT broker and make sure we catch any URL errors.
+        try {
+            this.mqtt = mqtt.connect(this.brokerUrl, { reconnectPeriod: this.reconnectInterval * 1000, rejectUnauthorized: false });
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                switch (error.message) {
+                    case "Missing protocol":
+                        this.log.error("MQTT Broker: Invalid URL provided: %s.", this.brokerUrl);
+                        break;
+                    default:
+                        this.log.error("MQTT Broker: Error: %s.", error.message);
+                        break;
+                }
+            }
+        }
+        // We've been unable to even attempt to connect. It's likely we have a configuration issue - we're done here.
+        if (!this.mqtt) {
+            return;
+        }
+        // Notify the user when we connect to the broker.
+        this.mqtt.on("connect", () => {
+            this.isConnected = true;
+            // Inform users, while redacting authentication credentials.
+            this.log.info("MQTT Broker: Connected to %s (topic: %s).", this.brokerUrl.replace(/^(.*:\/\/.*:)(.*)(@.*)$/, "$1REDACTED$3"), this.topicPrefix);
+        });
+        // Notify the user when we've disconnected.
+        this.mqtt.on("close", () => {
+            // We only inform users if we're already connected. Otherwise, we're likely in an error state and that's logged elsewhere.
+            if (!this.isConnected) {
+                return;
+            }
+            this.isConnected = false;
+            // Inform users.
+            this.log.info("MQTT Broker: Connection closed.");
+        });
+        // Process inbound messages and pass it to the right message handler.
+        this.mqtt.on("message", (topic, message) => {
+            this.subscriptions[topic]?.(message);
+        });
+        // Notify the user when there's a connectivity error.
+        this.mqtt.on("error", (error) => {
+            const logError = (message) => this.log.error("MQTT Broker: %s. Will retry again in %s minute%s.", message, this.reconnectInterval / 60, this.reconnectInterval / 60 > 1 ? "s" : "");
+            switch (error.code) {
+                case "ECONNREFUSED":
+                    logError("Connection refused");
+                    break;
+                case "ECONNRESET":
+                    logError("Connection reset");
+                    break;
+                case "ENOTFOUND":
+                    this.mqtt?.end(true);
+                    this.log.error("MQTT Broker: Hostname or IP address not found.");
+                    break;
+                default:
+                    logError(util.inspect(error, { sorted: true }));
+                    break;
+            }
+        });
+    }
+    // Publish an MQTT event to a broker.
+    publish(id, topic, message) {
+        const expandedTopic = this.expandTopic(id, topic);
+        // No valid topic returned, we're done.
+        if (!expandedTopic) {
+            return;
+        }
+        this.log.debug("MQTT publish: %s Message: %s.", expandedTopic, message);
+        // By default, we publish as: pluginTopicPrefix/id/topic
+        this.mqtt?.publish(expandedTopic, message);
+    }
+    // Subscribe to an MQTT topic.
+    subscribe(id, topic, callback) {
+        const expandedTopic = this.expandTopic(id, topic);
+        // No valid topic returned, we're done.
+        if (!expandedTopic) {
+            return;
+        }
+        this.log.debug("MQTT subscribe: %s.", expandedTopic);
+        // Add to our callback list.
+        this.subscriptions[expandedTopic] = callback;
+        // Tell MQTT we're subscribing to this event.
+        // By default, we subscribe as: pluginTopicPrefix/id/topic
+        this.mqtt?.subscribe(expandedTopic);
+    }
+    // Subscribe to a specific MQTT topic and publish a value on a get request.
+    subscribeGet(id, topic, type, getValue, log = this.log) {
+        // Return the current status of a given sensor.
+        this.subscribe(id, topic + "/get", (message) => {
+            const value = message.toString().toLowerCase();
+            // When we get the right message, we return the system information JSON.
+            if (value !== "true") {
+                return;
+            }
+            this.publish(id, topic, getValue());
+            log.info("MQTT: %s status published.", type);
+        });
+    }
+    // Subscribe to a specific MQTT topic and set a value on a set request.
+    subscribeSet(id, topic, type, setValue, log = this.log) {
+        // Return the current status of a given sensor.
+        this.subscribe(id, topic + "/set", (message) => {
+            const value = message.toString().toLowerCase();
+            const logResult = () => {
+                log.info("MQTT: set message received for %s: %s.", type, value);
+            };
+            // Set our value and inform the user.
+            const result = setValue(value, message.toString());
+            // For callbacks that are promises, we wait until they complete before logging the result.
+            if (result && typeof result.then === "function") {
+                result.then(() => {
+                    logResult();
+                }).catch(error => {
+                    log.error("MQTT: error seting message received for %s: %s. %s", type, value, error);
+                });
+                return;
+            }
+            // Log the outcome.
+            logResult();
+        });
+    }
+    // Unsubscribe to an MQTT topic.
+    unsubscribe(id, topic) {
+        const expandedTopic = this.expandTopic(id, topic);
+        // No valid topic returned, we're done.
+        if (!expandedTopic) {
+            return;
+        }
+        delete this.subscriptions[expandedTopic];
+    }
+    // Expand a topic to a unique, fully formed one.
+    expandTopic(id, topic) {
+        // No id, we're done.
+        if (!id) {
+            return null;
+        }
+        return this.topicPrefix + "/" + id + "/" + topic;
+    }
+}
+//# sourceMappingURL=mqttclient.js.map

package/dist/mqttclient.js.map

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