homebridge 2.0.0-alpha.4 → 2.0.0-alpha.5

package/dist/platformAccessory.js

@@ -0,0 +1,98 @@
+import { EventEmitter } from 'node:events';
+import { Accessory, } from 'hap-nodejs';
+// eslint-disable-next-line no-restricted-syntax
+export var PlatformAccessoryEvent;
+(function (PlatformAccessoryEvent) {
+    PlatformAccessoryEvent["IDENTIFY"] = "identify";
+})(PlatformAccessoryEvent || (PlatformAccessoryEvent = {}));
+// eslint-disable-next-line ts/no-unsafe-declaration-merging
+export class PlatformAccessory extends EventEmitter {
+    // somewhat ugly way to inject custom Accessory object, while not changing the publicly exposed constructor signature
+    static injectedAccessory;
+    _associatedPlugin; // present as soon as it is registered
+    _associatedPlatform; // not present for external accessories
+    _associatedHAPAccessory;
+    // ---------------- HAP Accessory mirror ----------------
+    displayName;
+    UUID;
+    category;
+    services = [];
+    // ------------------------------------------------------
+    /**
+     * This is a way for Plugin developers to store custom data with their accessory
+     */
+    context = {}; // providing something to store
+    constructor(displayName, uuid, category) {
+        super();
+        this._associatedHAPAccessory = PlatformAccessory.injectedAccessory
+            ? PlatformAccessory.injectedAccessory
+            : new Accessory(displayName, uuid);
+        if (category) {
+            this._associatedHAPAccessory.category = category;
+        }
+        this.displayName = this._associatedHAPAccessory.displayName;
+        this.UUID = this._associatedHAPAccessory.UUID;
+        this.category = category || 1 /* Categories.OTHER */;
+        this.services = this._associatedHAPAccessory.services;
+        // forward identify event
+        this._associatedHAPAccessory.on("identify" /* AccessoryEventTypes.IDENTIFY */, (paired, callback) => {
+            // @ts-expect-error: empty callback for backwards compatibility
+            this.emit("identify" /* PlatformAccessoryEvent.IDENTIFY */, paired, () => { });
+            callback();
+        });
+    }
+    addService(service, ...constructorArgs) {
+        // @ts-expect-error: while the HAP-NodeJS interface was refined, the underlying implementation
+        //  still only operates on an any[] array. Therefore, do not require any additional checks here
+        //  we force the parameter unpack with expecting a ts-error.
+        return this._associatedHAPAccessory.addService(service, ...constructorArgs);
+    }
+    removeService(service) {
+        this._associatedHAPAccessory.removeService(service);
+    }
+    getService(name) {
+        return this._associatedHAPAccessory.getService(name);
+    }
+    getServiceById(uuid, subType) {
+        return this._associatedHAPAccessory.getServiceById(uuid, subType);
+    }
+    /**
+     * Configures a new controller for the given accessory.
+     * See {@link https://developers.homebridge.io/HAP-NodeJS/classes/accessory.html#configurecontroller | Accessory.configureController}.
+     *
+     * @param controller
+     */
+    configureController(controller) {
+        this._associatedHAPAccessory.configureController(controller);
+    }
+    /**
+     * Removes a configured controller from the given accessory.
+     * See {@link https://developers.homebridge.io/HAP-NodeJS/classes/accessory.html#removecontroller | Accessory.removeController}.
+     *
+     * @param controller
+     */
+    removeController(controller) {
+        this._associatedHAPAccessory.removeController(controller);
+    }
+    // private
+    static serialize(accessory) {
+        return {
+            plugin: accessory._associatedPlugin,
+            platform: accessory._associatedPlatform,
+            context: accessory.context,
+            ...Accessory.serialize(accessory._associatedHAPAccessory),
+        };
+    }
+    static deserialize(json) {
+        const accessory = Accessory.deserialize(json);
+        PlatformAccessory.injectedAccessory = accessory;
+        const platformAccessory = new PlatformAccessory(accessory.displayName, accessory.UUID);
+        PlatformAccessory.injectedAccessory = undefined;
+        platformAccessory._associatedPlugin = json.plugin;
+        platformAccessory._associatedPlatform = json.platform;
+        platformAccessory.context = json.context;
+        platformAccessory.category = json.category;
+        return platformAccessory;
+    }
+}
+//# sourceMappingURL=platformAccessory.js.map

package/dist/platformAccessory.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,31 @@
+import type { AccessoryIdentifier, AccessoryName, AccessoryPluginConstructor, API, DynamicPlatformPlugin, PlatformIdentifier, PlatformName, PlatformPluginConstructor, PluginIdentifier, PluginName } from './api.js';
+import type { PackageJSON } from './pluginManager.js';
+/**
+ * Represents a loaded Homebridge plugin.
+ */
+export declare class Plugin {
+    private readonly pluginName;
+    private readonly scope?;
+    private readonly pluginPath;
+    private readonly isESM;
+    disabled: boolean;
+    readonly version: string;
+    private readonly main;
+    private loadContext?;
+    private pluginInitializer?;
+    private readonly registeredAccessories;
+    private readonly registeredPlatforms;
+    private readonly activeDynamicPlatforms;
+    constructor(name: PluginName, path: string, packageJSON: PackageJSON, scope?: string);
+    getPluginIdentifier(): PluginIdentifier;
+    getPluginPath(): string;
+    registerAccessory(name: AccessoryName, constructor: AccessoryPluginConstructor): void;
+    registerPlatform(name: PlatformName, constructor: PlatformPluginConstructor): void;
+    getAccessoryConstructor(accessoryIdentifier: AccessoryIdentifier | AccessoryName): AccessoryPluginConstructor;
+    getPlatformConstructor(platformIdentifier: PlatformIdentifier | PlatformName): PlatformPluginConstructor;
+    assignDynamicPlatform(platformIdentifier: PlatformIdentifier | PlatformName, platformPlugin: DynamicPlatformPlugin): void;
+    getActiveDynamicPlatform(platformName: PlatformName): DynamicPlatformPlugin | undefined;
+    load(): Promise<void>;
+    initialize(api: API): void | Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,0BAA0B,EAC1B,GAAG,EACH,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAEhB,UAAU,EACX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAerD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAExB,QAAQ,UAAQ;IAGvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,WAAW,CAAC,CAGnB;IAGD,OAAO,CAAC,iBAAiB,CAAC,CAAmB;IAE7C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA4D;IAClG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA0D;IAE9F,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAwD;gBAEnF,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM;IAmD7E,mBAAmB,IAAI,gBAAgB;IAIvC,aAAa,IAAI,MAAM;IAIvB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,0BAA0B,GAAG,IAAI;IAYrF,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,yBAAyB,GAAG,IAAI;IAYlF,uBAAuB,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,aAAa,GAAG,0BAA0B;IAW7G,sBAAsB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,YAAY,GAAG,yBAAyB;IAiBxG,qBAAqB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,YAAY,EAAE,cAAc,EAAE,qBAAqB,GAAG,IAAI;IAczH,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB,GAAG,SAAS;IAMjF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmD3B,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAOlD"}

package/dist/plugin.js

@@ -0,0 +1,185 @@
+import assert from 'node:assert';
+import path from 'node:path';
+import process from 'node:process';
+import { pathToFileURL } from 'node:url';
+import { satisfies } from 'semver';
+import { Logger } from './logger.js';
+import { PluginManager } from './pluginManager.js';
+import getVersion from './version.js';
+const log = Logger.internal;
+/**
+ * Represents a loaded Homebridge plugin.
+ */
+export class Plugin {
+    pluginName;
+    scope; // npm package scope
+    pluginPath; // like "/usr/local/lib/node_modules/homebridge-lockitron"
+    isESM;
+    disabled = false; // mark the plugin as disabled
+    // ------------------ package.json content ------------------
+    version;
+    main;
+    loadContext;
+    // ----------------------------------------------------------
+    pluginInitializer; // default exported function from the plugin that initializes it
+    registeredAccessories = new Map();
+    registeredPlatforms = new Map();
+    activeDynamicPlatforms = new Map();
+    constructor(name, path, packageJSON, scope) {
+        this.pluginName = name;
+        this.scope = scope;
+        this.pluginPath = path;
+        this.version = packageJSON.version || '0.0.0';
+        this.main = '';
+        // figure out the main module
+        // exports is available - https://nodejs.org/dist/latest-v14.x/docs/api/packages.html#packages_package_entry_points
+        if (packageJSON.exports) {
+            // main entrypoint - https://nodejs.org/dist/latest-v14.x/docs/api/packages.html#packages_main_entry_point_export
+            if (typeof packageJSON.exports === 'string') {
+                this.main = packageJSON.exports;
+            }
+            else { // subpath export - https://nodejs.org/dist/latest-v14.x/docs/api/packages.html#packages_subpath_exports
+                // conditional exports - https://nodejs.org/dist/latest-v14.x/docs/api/packages.html#packages_conditional_exports
+                const exports = packageJSON.exports.import || packageJSON.exports.require || packageJSON.exports.node || packageJSON.exports.default || packageJSON.exports['.'];
+                // check if conditional export is nested
+                if (typeof exports !== 'string') {
+                    if (exports.import) {
+                        this.main = exports.import;
+                    }
+                    else {
+                        this.main = exports.require || exports.node || exports.default;
+                    }
+                }
+                else {
+                    this.main = exports;
+                }
+            }
+        }
+        // exports search was not successful, fallback to package.main, using index.js as fallback
+        if (!this.main) {
+            this.main = packageJSON.main || './index.js';
+        }
+        // check if it is an ESM module
+        this.isESM = this.main.endsWith('.mjs') || (this.main.endsWith('.js') && packageJSON.type === 'module');
+        // very temporary fix for first wave of plugins
+        if (packageJSON.peerDependencies && (!packageJSON.engines || !packageJSON.engines.homebridge)) {
+            packageJSON.engines = packageJSON.engines || {};
+            packageJSON.engines.homebridge = packageJSON.peerDependencies.homebridge;
+        }
+        this.loadContext = {
+            engines: packageJSON.engines,
+            dependencies: packageJSON.dependencies,
+        };
+    }
+    getPluginIdentifier() {
+        return (this.scope ? `${this.scope}/` : '') + this.pluginName;
+    }
+    getPluginPath() {
+        return this.pluginPath;
+    }
+    registerAccessory(name, constructor) {
+        if (this.registeredAccessories.has(name)) {
+            throw new Error(`Plugin '${this.getPluginIdentifier()}' tried to register an accessory '${name}' which has already been registered!`);
+        }
+        if (!this.disabled) {
+            log.info('Registering accessory \'%s\'', `${this.getPluginIdentifier()}.${name}`);
+        }
+        this.registeredAccessories.set(name, constructor);
+    }
+    registerPlatform(name, constructor) {
+        if (this.registeredPlatforms.has(name)) {
+            throw new Error(`Plugin '${this.getPluginIdentifier()}' tried to register a platform '${name}' which has already been registered!`);
+        }
+        if (!this.disabled) {
+            log.info('Registering platform \'%s\'', `${this.getPluginIdentifier()}.${name}`);
+        }
+        this.registeredPlatforms.set(name, constructor);
+    }
+    getAccessoryConstructor(accessoryIdentifier) {
+        const name = PluginManager.getAccessoryName(accessoryIdentifier);
+        const constructor = this.registeredAccessories.get(name);
+        if (!constructor) {
+            throw new Error(`The requested accessory '${name}' was not registered by the plugin '${this.getPluginIdentifier()}'.`);
+        }
+        return constructor;
+    }
+    getPlatformConstructor(platformIdentifier) {
+        const name = PluginManager.getPlatformName(platformIdentifier);
+        const constructor = this.registeredPlatforms.get(name);
+        if (!constructor) {
+            throw new Error(`The requested platform '${name}' was not registered by the plugin '${this.getPluginIdentifier()}'.`);
+        }
+        // If it's a dynamic platform plugin, ensure it's not enabled multiple times.
+        if (this.activeDynamicPlatforms.has(name)) {
+            throw new Error(`The dynamic platform ${name} from the plugin ${this.getPluginIdentifier()} is configured `
+                + `times in your config.json.`);
+        }
+        return constructor;
+    }
+    assignDynamicPlatform(platformIdentifier, platformPlugin) {
+        const name = PluginManager.getPlatformName(platformIdentifier);
+        let platforms = this.activeDynamicPlatforms.get(name);
+        if (!platforms) {
+            platforms = [];
+            this.activeDynamicPlatforms.set(name, platforms);
+        }
+        // the last platform published should be at the first position for easy access
+        // we just try to mimic pre 1.0.0 behavior
+        platforms.unshift(platformPlugin);
+    }
+    getActiveDynamicPlatform(platformName) {
+        const platforms = this.activeDynamicPlatforms.get(platformName);
+        // we always use the last registered
+        return platforms && platforms[0];
+    }
+    async load() {
+        const context = this.loadContext;
+        assert(context, 'Reached illegal state. Plugin state is undefined!');
+        this.loadContext = undefined; // free up memory
+        // pluck out the HomeBridge version requirement
+        if (!context.engines || !context.engines.homebridge) {
+            throw new Error(`Plugin ${this.pluginPath} does not contain the 'homebridge' package in 'engines'.`);
+        }
+        const versionRequired = context.engines.homebridge;
+        const nodeVersionRequired = context.engines.node;
+        // make sure the version is satisfied by the currently running version of HomeBridge
+        if (!satisfies(getVersion(), versionRequired, { includePrerelease: true })) {
+            // TODO - change this back to an error
+            log.error(`The plugin "${this.pluginName}" requires a Homebridge version of ${versionRequired} which does \
+not satisfy the current Homebridge version of ${getVersion()}. You may need to update this plugin (or Homebridge) to a newer version. \
+You may face unexpected issues or stability problems running this plugin.`);
+        }
+        // make sure the version is satisfied by the currently running version of Node
+        if (nodeVersionRequired && !satisfies(process.version, nodeVersionRequired)) {
+            log.warn(`The plugin "${this.pluginName}" requires Node.js version of ${nodeVersionRequired} which does \
+not satisfy the current Node.js version of ${process.version}. You may need to upgrade your installation of Node.js - see https://homebridge.io/w/JTKEF`);
+        }
+        const dependencies = context.dependencies || {};
+        if (dependencies.homebridge || dependencies['hap-nodejs']) {
+            log.error(`The plugin "${this.pluginName}" defines 'homebridge' and/or 'hap-nodejs' in their 'dependencies' section, \
+meaning they carry an additional copy of homebridge and hap-nodejs. This not only wastes disk space, but also can cause \
+major incompatibility issues and thus is considered bad practice. Please inform the developer to update their plugin!`);
+        }
+        const mainPath = path.join(this.pluginPath, this.main);
+        // try to import it and grab the exported initialization hook
+        // pathToFileURL(specifier).href to turn a path into a "file url"
+        // see https://github.com/nodejs/node/issues/31710
+        const pluginModules = await import(pathToFileURL(mainPath).href);
+        if (typeof pluginModules === 'function') {
+            this.pluginInitializer = pluginModules;
+        }
+        else if (pluginModules && typeof pluginModules.default === 'function') {
+            this.pluginInitializer = pluginModules.default;
+        }
+        else {
+            throw new Error(`Plugin ${this.pluginPath} does not export a initializer function from main.`);
+        }
+    }
+    initialize(api) {
+        if (!this.pluginInitializer) {
+            throw new Error('Tried to initialize a plugin which hasn\'t been loaded yet!');
+        }
+        return this.pluginInitializer(api);
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/pluginManager.d.ts

@@ -0,0 +1,77 @@
+import type { AccessoryIdentifier, AccessoryName, HomebridgeAPI, PlatformIdentifier, PlatformName, PluginIdentifier, PluginName } from './api.js';
+import { Plugin } from './plugin.js';
+export interface PackageJSON {
+    name: string;
+    version: string;
+    keywords?: string[];
+    exports?: string | Record<string, string | Record<string, string>>;
+    main?: string;
+    /**
+     * When set as module, it marks .js file to be treated as ESM.
+     * See https://nodejs.org/dist/latest-v14.x/docs/api/esm.html#esm_enabling
+     */
+    type?: 'module' | 'commonjs';
+    engines?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+}
+export interface PluginManagerOptions {
+    /**
+     * Additional path to search for plugins in. Specified relative to the current working directory.
+     */
+    customPluginPath?: string;
+    /**
+     * If set, only load plugins from the customPluginPath, if set, otherwise only from the primary global node_modules.
+     */
+    strictPluginResolution?: boolean;
+    /**
+     * When defined, only plugins specified here will be initialized.
+     */
+    activePlugins?: PluginIdentifier[];
+    /**
+     * Plugins that are marked as disabled and whose corresponding config blocks should be ignored
+     */
+    disabledPlugins?: PluginIdentifier[];
+}
+/**
+ * Utility which exposes methods to search for installed Homebridge plugins
+ */
+export declare class PluginManager {
+    private static readonly PLUGIN_IDENTIFIER_PATTERN;
+    private readonly api;
+    private readonly searchPaths;
+    private readonly strictPluginResolution;
+    private readonly activePlugins?;
+    private readonly disabledPlugins?;
+    private readonly plugins;
+    private readonly pluginIdentifierTranslation;
+    private readonly accessoryToPluginMap;
+    private readonly platformToPluginMap;
+    private currentInitializingPlugin?;
+    constructor(api: HomebridgeAPI, options?: PluginManagerOptions);
+    static isQualifiedPluginIdentifier(identifier: string): boolean;
+    static extractPluginName(name: string): PluginName;
+    static extractPluginScope(name: string): string;
+    static getAccessoryName(identifier: AccessoryIdentifier): AccessoryName;
+    static getPlatformName(identifier: PlatformIdentifier): PlatformIdentifier;
+    static getPluginIdentifier(identifier: AccessoryIdentifier | PlatformIdentifier): PluginIdentifier;
+    initializeInstalledPlugins(): Promise<void>;
+    initializePlugin(plugin: Plugin, identifier: string): Promise<void>;
+    private handleRegisterAccessory;
+    private handleRegisterPlatform;
+    getPluginForAccessory(accessoryIdentifier: AccessoryIdentifier | AccessoryName): Plugin;
+    getPluginForPlatform(platformIdentifier: PlatformIdentifier | PlatformName): Plugin;
+    hasPluginRegistered(pluginIdentifier: PluginIdentifier): boolean;
+    getPlugin(pluginIdentifier: PluginIdentifier): Plugin | undefined;
+    getPluginByActiveDynamicPlatform(platformName: PlatformName): Plugin | undefined;
+    /**
+     * Gets all plugins installed on the local system
+     */
+    private loadInstalledPlugins;
+    loadPlugin(absolutePath: string): Plugin;
+    private static loadPackageJSON;
+    private loadDefaultPaths;
+    private addNpmPrefixToSearchPaths;
+}
+//# sourceMappingURL=pluginManager.d.ts.map

package/dist/pluginManager.d.ts.map

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