homebridge-lib 6.7.4 → 7.0.0-0

package/cli/hap.js

@@ -7,8 +7,6 @@
 //
 // Logger for HomeKit accessory announcements.
 
-'use strict'
+import { HapTool } from 'hb-lib-tools'
 
-const { HapTool } = require('hb-lib-tools')
-
-new HapTool(require('../package.json')).main()
+new HapTool(import.meta.dirname).main()

package/cli/json.js

@@ -7,8 +7,6 @@
 //
 // JSON formatter.
 
-'use strict'
+import { JsonTool } from 'hb-lib-tools'
 
-const { JsonTool } = require('hb-lib-tools')
-
-new JsonTool(require('../package.json')).main()
+new JsonTool(import.meta.dirname).main()

package/cli/sysinfo.js

@@ -7,8 +7,6 @@
 //
 // Show system info.
 
-'use strict'
+import { SysinfoTool } from 'hb-lib-tools'
 
-const { SysinfoTool } = require('hb-lib-tools')
-
-new SysinfoTool(require('../package.json')).main()
+new SysinfoTool(import.meta.dirname).main()

package/cli/upnp.js

@@ -7,8 +7,6 @@
 //
 // Logger for UPnP device announcements.
 
-'use strict'
+import { UpnpTool } from 'hb-lib-tools'
 
-const { UpnpTool } = require('hb-lib-tools')
-
-new UpnpTool(require('../package.json')).main()
+new UpnpTool(import.meta.dirname).main()

package/index.js

@@ -3,10 +3,6 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const hbLibTools = require('hb-lib-tools')
-
 /** Library for Homebridge plugins.
   * see the {@tutorial homebridgeLib} tutorial.
   *
@@ -38,7 +34,7 @@ const hbLibTools = require('hb-lib-tools')
   * To access the classes provided by Homebridge Lib from your module,
   * simply load it by:
   * ```javascript
-  * const homebridgeLib = require('homebridge-lib')
+  * import homebridgeLib from 'homebridge-lib'
   * ```
   *
   * Note that each class provided by Homebridge Lib is implemented as a
@@ -48,205 +44,228 @@ const hbLibTools = require('hb-lib-tools')
   *
   * @module homebridgeLib
   */
-class homebridgeLib {
-  /** Delegate of a HomeKit accessory.
-    * <br>See {@link AccessoryDelegate}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get AccessoryDelegate () { return require('./lib/AccessoryDelegate') }
-
-  /** Adaptive Lighting.
-    * <br>See {@link AdaptiveLighting}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get AdaptiveLighting () { return require('./lib/AdaptiveLighting') }
-
-  /** Return the `Bonjour` class from [`bonjour-hap`](https://github.com/homebridge/bonjour),
-    * so plugins don't have to list this as a separate dependency.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get Bonjour () { return hbLibTools.Bonjour }
-
-  /** Delegate of a HomeKit characteristic.
-    * <br>See {@link CharacteristicDelegate}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get CharacteristicDelegate () { return require('./lib/CharacteristicDelegate') }
-
-  /** Colour conversions.
-    * <br>See {@link Colour}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get Colour () { return hbLibTools.Colour }
-
-  /** Parser and validator for command-line arguments.
-    * <br>See {@link CommandLineParser}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get CommandLineParser () { return hbLibTools.CommandLineParser }
-
-  /** Command-line tool.
-    * <br>See {@link CommandLineTool}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get CommandLineTool () { return hbLibTools.CommandLineTool }
-
-  /** Abstract superclass for {@link EveHomeKitTypes}
-    * and {@link MyHomeKitTypes}.
-    * <br>See {@link CustomHomeKitTypes}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get CustomHomeKitTypes () { return require('./lib/CustomHomeKitTypes') }
-
-  /** Abstract superclass for {@link Platform}, {@link AccessoryDelegate},
-    * {@link ServiceDelegate}, and {@link CharacteristicDelegate}.
-    * <br>See {@link Delegate}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get Delegate () { return require('./lib/Delegate') }
-
-  /** Custom HomeKit services and characteristics used by
-    * [Eve](https://www.evehome.com/en) accessories and by the
-    * [Eve app](https://www.evehome.com/en/eve-app).
-    * <br>See {@link EveHomeKitTypes}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get EveHomeKitTypes () { return require('./lib/EveHomeKitTypes') }
-
-  /** HTTP client.
-    * <br>See {@link HttpClient}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get HttpClient () { return hbLibTools.HttpClient }
-
-  /** JSON formatter.
-    * <br>See {@link JsonFormatter}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get JsonFormatter () { return hbLibTools.JsonFormatter }
-
-  /** My own collection of custom HomeKit services and characteristics.
-    * <br>See {@link MyHomeKitTypes}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get MyHomeKitTypes () { return require('./lib/MyHomeKitTypes') }
-
-  /** Parser and validator for options and other parameters.
-    * <br>See {@link OptionParser}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get OptionParser () { return hbLibTools.OptionParser }
-
-  /** Homebridge dynamic platform plugin.
-    * <br>See {@link Platform}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get Platform () { return require('./lib/Platform') }
-
-  /** Delegate of a property of a HomeKit accessory or service.
-    * <br>See {@link PropertyDelegate}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get PropertyDelegate () { return require('./lib/PropertyDelegate') }
-
-  /** Delegate of a HomeKit service.
-    * <br>See {@link ServiceDelegate}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get ServiceDelegate () { return require('./lib/ServiceDelegate') }
-
-  /** System information.
-    * <br>See {@link SystemInfo}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get SystemInfo () { return hbLibTools.SystemInfo }
-
-  /** Universal Plug and Play client.
-    * <br>See {@link UpnpClient}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get UpnpClient () { return hbLibTools.UpnpClient }
-
-  /** Server for dynamic configuration settings through Homebridge UI.
-    * <br>See {@link UiServer}.
-    * @type {Class}
-    * @memberof module:homebridgeLib
-    */
-  static get UiServer () { return require('./lib/UiServer') }
-
-  /** Resolve after given period, delaying execution.
-    *
-    * E.g. to delay execution for 1.5 seconds, issue:
-    * ```javascript
-    *   await homebridgeLib.timeout(1500)
-    * ```
-    *
-    * @param {integer} msec - Period (in msec) to wait.
-    * @throws {TypeError} On invalid parameter type.
-    * @throws {RangeError} On invalid parameter value.
-    * @memberof module:homebridgeLib
-    */
-  static get timeout () { return hbLibTools.timeout }
-
-  /** Convert Error to string.
-    *
-    * Include the stack trace only for programming errors (JavaScript and NodeJS
-    * runtime errors).
-    * Translate system errors into more readable messages.
-    * @param {Error} e - The error.
-    * @param {boolean} [useChalk=false] - Use chalk to grey out the stack trace.
-    * @returns {string} - The error as string.
-    * @memberof module:homebridgeLib
-    */
-  static get formatError () { return hbLibTools.formatError }
-
-  /** Convert integer to hex string.
-    * @param {integer} i - The integer.
-    * @param {integer} [length=4] - The number of digits in the hex string.
-    * @returns {string} - The hex string.
-    * @memberof module:homebridgeLib
-    */
-  static get toHexString () { return hbLibTools.toHexString }
-
-  /** Return the [`chalk`](https://github.com/chalk/chalk) module,
-    * so plugins don't have to list this as a separate dependency.
-    * @memberof module:homebridgeLib
-    */
-  static get chalk () { return hbLibTools.chalk }
-
-  /** Return the [`semver`](https://github.com/npm/node-semver) module,
-    * so plugins don't have to list this as a separate dependency.
-    * @memberof module:homebridgeLib
-    */
-  static get semver () { return hbLibTools.semver }
-
-  /** Return the recommended version of NodeJS from package.json.
-    * This is the version used to develop and test the software,
-    * typically the latest LTS version.
-    * @param {string} packageJson - The contents of package.json
-    * #return {string} - The recommended version.
-    * @memberof module:hbLibTools
-    */
-  static get recommendedNodeVersion () { return hbLibTools.recommendedNodeVersion }
-}
-
-module.exports = homebridgeLib
+
+/** Abstract superclass for {@link Platform}, {@link AccessoryDelegate},
+  * {@link ServiceDelegate}, and {@link CharacteristicDelegate}.
+  * <br>See {@link Delegate}.
+  * @name Delegate
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { Delegate } from './lib/Delegate.js'
+
+/** Delegate of a HomeKit accessory.
+  * <br>See {@link AccessoryDelegate}.
+  * @name AccessoryDelegate
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { AccessoryDelegate } from './lib/AccessoryDelegate.js'
+
+/** Adaptive Lighting.
+  * <br>See {@link AdaptiveLighting}.
+  * @name AdaptiveLighting
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { AdaptiveLighting } from './lib/AdaptiveLighting.js'
+
+/** Return the `Bonjour` class from [`bonjour-hap`](https://github.com/homebridge/bonjour),
+  * so plugins don't have to list this as a separate dependency.
+  * @name Bonjour
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { Bonjour } from 'hb-lib-tools'
+
+/** Delegate of a HomeKit characteristic.
+  * <br>See {@link CharacteristicDelegate}.
+  * @name CharacteristicDelegate
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { CharacteristicDelegate } from './lib/CharacteristicDelegate.js'
+
+/** Colour conversions.
+  * <br>See {@link Colour}.
+  * @name Colour
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { Colour } from 'hb-lib-tools'
+
+/** Parser and validator for command-line arguments.
+  * <br>See {@link CommandLineParser}.
+  * @name CommandLineParser
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { CommandLineParser } from 'hb-lib-tools'
+
+/** Command-line tool.
+  * <br>See {@link CommandLineTool}.
+  * @name CommandLineTool
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { CommandLineTool } from 'hb-lib-tools'
+
+/** Abstract superclass for {@link EveHomeKitTypes}
+  * and {@link MyHomeKitTypes}.
+  * <br>See {@link CustomHomeKitTypes}.
+  * @name CustomHomeKitTypes
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { CustomHomeKitTypes } from './lib/CustomHomeKitTypes.js'
+
+/** Custom HomeKit services and characteristics used by
+  * [Eve](https://www.evehome.com/en) accessories and by the
+  * [Eve app](https://www.evehome.com/en/eve-app).
+  * <br>See {@link EveHomeKitTypes}.
+  * @name EveHomeKitTypes
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { EveHomeKitTypes } from './lib/EveHomeKitTypes.js'
+
+/** HTTP client.
+  * <br>See {@link HttpClient}.
+  * @name HttpClient
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { HttpClient } from 'hb-lib-tools'
+
+/** JSON formatter.
+  * <br>See {@link JsonFormatter}.
+  * @name JsonFormatter
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { JsonFormatter } from 'hb-lib-tools'
+
+/** My own collection of custom HomeKit services and characteristics.
+  * <br>See {@link MyHomeKitTypes}.
+  * @name MyHomeKitTypes
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { MyHomeKitTypes } from './lib/MyHomeKitTypes.js'
+
+/** Parser and validator for options and other parameters.
+  * <br>See {@link OptionParser}.
+  * @name OptionParser
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { OptionParser } from 'hb-lib-tools'
+
+/** Homebridge dynamic platform plugin.
+  * <br>See {@link Platform}.
+  * @name Platform
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { Platform } from './lib/Platform.js'
+
+/** Delegate of a property of a HomeKit accessory or service.
+  * <br>See {@link PropertyDelegate}.
+  * @name PropertyDelegate
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { PropertyDelegate } from './lib/PropertyDelegate.js'
+
+/** Delegate of a HomeKit service.
+  * <br>See {@link ServiceDelegate}.
+  * @name ServiceDelegate
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { ServiceDelegate } from './lib/ServiceDelegate/index.js'
+
+/** System information.
+  * <br>See {@link SystemInfo}.
+  * @name SystemInfo
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { SystemInfo } from 'hb-lib-tools'
+
+/** Universal Plug and Play client.
+  * <br>See {@link UpnpClient}.
+  * @name UpnpClient
+  * @type {Class}
+  * @memberof module:homebridgeLib
+  */
+export { UpnpClient } from 'hb-lib-tools'
+
+// /** Server for dynamic configuration settings through Homebridge UI.
+//   * <br>See {@link UiServer}.
+//   * @name UiServer
+//   * @type {Class}
+//   * @memberof module:homebridgeLib
+//   */
+// export { UiServer } from './lib/UiServer.js'
+
+/** Convert Error to string.
+  *
+  * Include the stack trace only for programming errors (JavaScript and NodeJS
+  * runtime errors).
+  * Translate system errors into more readable messages.
+  * @param {Error} e - The error.
+  * @param {boolean} [useChalk=false] - Use chalk to grey out the stack trace.
+  * @returns {string} - The error as string.
+  * @memberof module:homebridgeLib
+  */
+export { formatError } from 'hb-lib-tools'
+
+/** Return the recommended version of NodeJS from package.json.
+  * This is the version used to develop and test the software,
+  * typically the latest LTS version.
+  * @param {string} packageJson - The contents of package.json
+  * #return {string} - The recommended version.
+  * @memberof module:hbLibTools
+  */
+export { recommendedNodeVersion } from 'hb-lib-tools'
+
+/** Resolve after given period, delaying execution.
+  *
+  * E.g. to delay execution for 1.5 seconds, issue:
+  * ```javascript
+  *   await homebridgeLib.timeout(1500)
+  * ```
+  *
+  * @param {integer} msec - Period (in msec) to wait.
+  * @throws {TypeError} On invalid parameter type.
+  * @throws {RangeError} On invalid parameter value.
+  * @memberof module:homebridgeLib
+  */
+export { timeout } from 'hb-lib-tools'
+
+/** Convert integer to hex string.
+  * @param {integer} i - The integer.
+  * @param {integer} [length=4] - The number of digits in the hex string.
+  * @returns {string} - The hex string.
+  * @memberof module:homebridgeLib
+  */
+export { toHexString } from 'hb-lib-tools'
+
+/** Return the [`chalk`](https://github.com/chalk/chalk) module,
+  * so plugins don't have to list this as a separate dependency.
+  * @memberof module:homebridgeLib
+  */
+export { chalk } from 'hb-lib-tools'
+
+/** Return the [`semver`](https://github.com/npm/node-semver) module,
+  * so plugins don't have to list this as a separate dependency.
+  * @memberof module:homebridgeLib
+  */
+export { semver } from 'hb-lib-tools'
+
+export { AccessoryInformation } from './lib/ServiceDelegate/AccessoryInformation.js'
+export { Battery } from './lib/ServiceDelegate/Battery.js'
+export { Dummy } from './lib/ServiceDelegate/Dummy.js'
+export { History } from './lib/ServiceDelegate/History.js'
+export { ServiceLabel } from './lib/ServiceDelegate/ServiceLabel.js'

package/lib/AccessoryDelegate.js

@@ -3,9 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const homebridgeLib = require('../index')
+import { CharacteristicDelegate, Delegate, PropertyDelegate, ServiceDelegate } from '../index.js'
 
 const startsWithUuid = /^[0-9A-F]{8}-[0-9A-F]{4}-[1-5][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}/
 
@@ -14,7 +12,7 @@ const startsWithUuid = /^[0-9A-F]{8}-[0-9A-F]{4}-[1-5][0-9A-F]{3}-[89AB][0-9A-F]
   * @abstract
   * @extends Delegate
   */
-class AccessoryDelegate extends homebridgeLib.Delegate {
+class AccessoryDelegate extends Delegate {
   /** Create a new instance of a HomeKit accessory delegate.
     *
     * When the corresponding HomeKit accessory was restored from persistent
@@ -76,7 +74,7 @@ class AccessoryDelegate extends homebridgeLib.Delegate {
     // Create delegate for AccessoryInformation service.
     this._serviceDelegates = {}
     this._accessoryInformationDelegate =
-      new homebridgeLib.ServiceDelegate.AccessoryInformation(this, params)
+      new ServiceDelegate.AccessoryInformation(this, params)
 
     // Configure PlatformAccessory.
     this._accessory.on('identify', this._identify.bind(this))
@@ -189,7 +187,7 @@ class AccessoryDelegate extends homebridgeLib.Delegate {
       throw new SyntaxError(`${key}: duplicate key`)
     }
 
-    const delegate = new homebridgeLib.PropertyDelegate(this, params)
+    const delegate = new PropertyDelegate(this, params)
     this._propertyDelegates[key] = delegate
 
     // Create shortcut for characteristic value.
@@ -303,8 +301,8 @@ class AccessoryDelegate extends homebridgeLib.Delegate {
     */
   manageLogLevel (delegate, forPlatform = false) {
     if (
-      !(delegate instanceof homebridgeLib.CharacteristicDelegate) &&
-      !(delegate instanceof homebridgeLib.PropertyDelegate)
+      !(delegate instanceof CharacteristicDelegate) &&
+      !(delegate instanceof PropertyDelegate)
     ) {
       throw new TypeError('delegate: not a CharacteristicDelegate or PropertyDelegate')
     }
@@ -329,4 +327,4 @@ class AccessoryDelegate extends homebridgeLib.Delegate {
   }
 }
 
-module.exports = AccessoryDelegate
+export { AccessoryDelegate }

package/lib/AdaptiveLighting.js

@@ -3,9 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2020-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const { CharacteristicDelegate } = require('../index')
+import { CharacteristicDelegate } from '../index.js'
 
 /* global BigInt */
 
@@ -342,4 +340,4 @@ class AdaptiveLighting {
   }
 }
 
-module.exports = AdaptiveLighting
+export { AdaptiveLighting }

package/lib/CharacteristicDelegate.js

@@ -3,9 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const homebridgeLib = require('../index')
+import { Delegate, OptionParser, ServiceDelegate } from '../index.js'
 
 /** Delegate of a HomeKit characteristic.
   *
@@ -50,7 +48,7 @@ const homebridgeLib = require('../index')
   *
   * @extends Delegate
   */
-class CharacteristicDelegate extends homebridgeLib.Delegate {
+class CharacteristicDelegate extends Delegate {
   /** Create a new instance of a HomeKit characteristic delegate.
     *
     * Note that instances of `CharacteristicDelegate` are normally created by
@@ -95,7 +93,7 @@ class CharacteristicDelegate extends homebridgeLib.Delegate {
     * optional parameter is not applicable.
     */
   constructor (serviceDelegate, params = {}) {
-    if (!(serviceDelegate instanceof homebridgeLib.ServiceDelegate)) {
+    if (!(serviceDelegate instanceof ServiceDelegate)) {
       throw new TypeError('serviceDelegate: not a ServiceDelegate')
     }
     super(serviceDelegate.platform, serviceDelegate.name)
@@ -145,7 +143,7 @@ class CharacteristicDelegate extends homebridgeLib.Delegate {
         }
         this._characteristic.on('set', this._onSet.bind(this))
       }
-      this._timeout = homebridgeLib.OptionParser.toInt(
+      this._timeout = OptionParser.toInt(
         'params.timeout', params.timeout == null ? 1000 : params.timeout, 500, 5000
       )
       // Check that we are the only listener
@@ -451,4 +449,4 @@ class CharacteristicDelegate extends homebridgeLib.Delegate {
   }
 }
 
-module.exports = CharacteristicDelegate
+export { CharacteristicDelegate }

package/lib/CustomHomeKitTypes.js

@@ -233,4 +233,4 @@ class CustomHomeKitTypes {
   }
 }
 
-module.exports = CustomHomeKitTypes
+export { CustomHomeKitTypes }

package/lib/Delegate.js

@@ -3,12 +3,9 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
+import { EventEmitter } from 'node:events'
 
-const homebridgeLib = require('../index')
-const { HttpClient } = homebridgeLib
-
-const events = require('events')
+import { HttpClient, Platform } from '../index.js'
 
 /** Abstract superclass for {@link Platform}, {@link AccessoryDelegate},
   * {@link ServiceDelegate}, and {@link CharacteristicDelegate}.
@@ -19,7 +16,7 @@ const events = require('events')
   * @abstract
   * @extends EventEmitter
   */
-class Delegate extends events.EventEmitter {
+class Delegate extends EventEmitter {
   /** Create a new `Delegate` instance.
     * @abstract
     * @param {?Platform} platform - Reference to the corresponding platform
@@ -32,7 +29,7 @@ class Delegate extends events.EventEmitter {
     if (platform == null) {
       platform = this
     }
-    if (!(platform instanceof homebridgeLib.Platform)) {
+    if (!(platform instanceof Platform)) {
       throw new TypeError('platform: not a Platform')
     }
     this._platform = platform
@@ -256,4 +253,4 @@ class Delegate extends events.EventEmitter {
   }
 }
 
-module.exports = Delegate
+export { Delegate }

package/lib/EveHomeKitTypes.js

@@ -3,7 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-const { CustomHomeKitTypes } = require('../index')
+import { CustomHomeKitTypes } from '../index.js'
 
 // Return long Eve UUID.
 function uuid (id) {
@@ -691,4 +691,4 @@ class EveHomeKitTypes extends CustomHomeKitTypes {
   }
 }
 
-module.exports = EveHomeKitTypes
+export { EveHomeKitTypes }

package/lib/MyHomeKitTypes.js

@@ -5,7 +5,7 @@
 //
 // My own collection of custom HomeKit Services and Characteristics.
 
-const { CustomHomeKitTypes } = require('../index')
+import { CustomHomeKitTypes } from '../index.js'
 
 function uuid (id) {
   return MyHomeKitTypes.uuid(id, '-0000-1000-8000-656261617577')
@@ -1034,4 +1034,4 @@ class MyHomeKitTypes extends CustomHomeKitTypes {
   }
 }
 
-module.exports = MyHomeKitTypes
+export { MyHomeKitTypes }

package/lib/Platform.js

@@ -3,31 +3,33 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const homebridgeLib = require('../index')
-const {
-  HttpClient, SystemInfo, UpnpClient, formatError, recommendedNodeVersion, semver
-} = homebridgeLib
-
-const events = require('events')
-const fs = require('fs')
-const http = require('http')
-const util = require('util')
-const zlib = require('zlib')
-
-const libPackageJson = require('../package.json')
+import { once } from 'node:events'
+import { readFileSync } from 'node:fs'
+import { writeFile, unlink } from 'node:fs/promises'
+import { Server, STATUS_CODES } from 'node:http'
+import { join } from 'node:path'
+import { format, promisify } from 'node:util'
+import zlib from 'node:zlib'
+
+import {
+  Delegate, EveHomeKitTypes, HttpClient, MyHomeKitTypes, SystemInfo,
+  UpnpClient, formatError, recommendedNodeVersion, semver
+} from '../index.js'
+
+const libPackageJson = JSON.parse(
+  readFileSync(join(import.meta.dirname, '../package.json'), 'utf8')
+)
 
 const uuid = /^[0-9A-F]{8}-[0-9A-F]{4}-[1-5][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/
-const gzip = util.promisify(zlib.gzip)
+const gzip = promisify(zlib.gzip)
 
 const context = {
   libName: libPackageJson.name,
   libVersion: libPackageJson.version,
   nodeVersion: process.version.slice(1),
   recommendedNodeVersion: recommendedNodeVersion(libPackageJson),
-  recommendedHomebridgeVersion:
-    semver.minVersion(libPackageJson.engines.homebridge).toString(),
+  // recommendedHomebridgeVersion:
+  //   semver.minVersion(libPackageJson.engines.homebridge).toString(),
   saveInterval: 3600,
   checkInterval: 7 * 24 * 3600,
   driftDebugThreshold: 250,
@@ -49,7 +51,7 @@ const context = {
   * @abstract
   * @extends Delegate
   */
-class Platform extends homebridgeLib.Delegate {
+class Platform extends Delegate {
   /** Load the platform plugin.
     *
     * Called by Homebridge, through the plugin's `index.js`, when loading the
@@ -57,16 +59,19 @@ class Platform extends homebridgeLib.Delegate {
     * @static
     * @param {!API} homebridge - Homebridge
     * [API](https://github.com/nfarina/homebridge/blob/master/lib/api.js).
-    * @param {!object} packageJson - The contents of the plugin's `package.json`.
+    * @param {!string} dirName - The name of the plugin's directory.
     * @param {!string} platformName - The name of the platform plugin, as used
     * in Homebridge's `config.json`.
     * @param {!Platform} Platform - The constructor of the platform plugin.
     */
-  static loadPlatform (homebridge, packageJson, platformName, Platform) {
+  static loadPlatform (homebridge, dirName, platformName, Platform) {
     if (context.homebridge == null) {
       context.homebridge = homebridge
       context.homebridgeVersion = homebridge.serverVersion
       context.PlatformAccessory = homebridge.platformAccessory
+      context.recommendedHomebridgeVersion =
+        semver.minVersion(libPackageJson.engines.homebridge).toString()
+
       const hap = {
         Services: {},
         Characteristics: {}
@@ -81,8 +86,8 @@ class Platform extends homebridgeLib.Delegate {
       }).forEach((key) => {
         hap.Characteristics[key] = homebridge.hap.Characteristic[key]
       })
-      const eve = new homebridgeLib.EveHomeKitTypes(homebridge)
-      const my = new homebridgeLib.MyHomeKitTypes(homebridge)
+      const eve = new EveHomeKitTypes(homebridge)
+      const my = new MyHomeKitTypes(homebridge)
 
       context.Accessory = Object.freeze({
         Categories: Object.freeze(Object.assign({}, homebridge.hap.Categories))
@@ -104,7 +109,15 @@ class Platform extends homebridgeLib.Delegate {
         my: Object.freeze(my.Characteristics)
       })
     }
+    const packageJson = JSON.parse(
+      readFileSync(join(dirName, 'package.json'), 'utf8')
+    )
     context[Platform.name] = { packageJson, platformName }
+    // console.log(
+    //   '%s v%s, node v%s, homebridge v%s, %s v%s',
+    //   packageJson.name, packageJson.version, context.nodeVersion,
+    //   context.homebridgeVersion, context.libName, context.libVersion
+    // )
     homebridge.registerPlatform(
       packageJson.name, platformName, Platform, true
     )
@@ -170,9 +183,6 @@ class Platform extends homebridgeLib.Delegate {
   // Main platform function.
   // Called by homebridge after restoring accessories from cache.
   async _main () {
-    // process.on('unhandledRejection', (error) => {
-    //   this.error('unhandled rejection: %s', error.stack)
-    // })
     /** System information.
       * @type {SystemInfo}
       * @readonly
@@ -204,7 +214,7 @@ class Platform extends homebridgeLib.Delegate {
         await this._createUiServer()
       } catch (error) { this.error(error) }
     }
-    await events.once(this, 'initialised')
+    await once(this, 'initialised')
     this._flushCachedAccessories()
     for (const id in this._accessories) {
       if (this._accessoryDelegates[id] == null) {
@@ -248,7 +258,7 @@ class Platform extends homebridgeLib.Delegate {
       this._pluginName + '.json.gz'
     try {
       const data = await gzip(JSON.stringify(Object.assign(result, dumpInfo)))
-      await fs.promises.writeFile(filename, data)
+      await writeFile(filename, data)
       this.log('created debug dump file %s', filename)
     } catch (error) {
       this.error('%s: %s', filename, error)
@@ -526,7 +536,7 @@ class Platform extends homebridgeLib.Delegate {
     const historyFile = accessory.context.historyFile
     if (historyFile) {
       this.debug('remove history file %s', historyFile)
-      fs.unlink(historyFile, (error) => {
+      unlink(historyFile, (error) => {
         if (error) {
           this.warn(error)
         }
@@ -611,7 +621,7 @@ class Platform extends homebridgeLib.Delegate {
   // Create HTTP server for Homebridge Plugin UI Settings.
   async _createUiServer () {
     this._ui = {}
-    this._ui.server = new http.Server()
+    this._ui.server = new Server()
     this._ui.server
       .on('listening', () => {
         this._ui.port = this._ui.server.address().port
@@ -660,7 +670,7 @@ class Platform extends homebridgeLib.Delegate {
                 )
             this.debug(
               'ui request %d: %d %s', this._ui.requestId,
-              status, http.STATUS_CODES[status]
+              status, STATUS_CODES[status]
             )
             if (status === 200) {
               this.vdebug('ui request %d: response: %j', this._ui.requestId, body)
@@ -684,7 +694,7 @@ class Platform extends homebridgeLib.Delegate {
       host: '127.0.0.1',
       signal: this._ui.abortController.signal
     })
-    await events.once(this._ui.server, 'listening')
+    await once(this._ui.server, 'listening')
   }
 
   // ===== Logging =============================================================
@@ -707,7 +717,7 @@ class Platform extends homebridgeLib.Delegate {
     if (args[0] == null) {
       message = ''
     } else if (typeof (args[0]) === 'string') {
-      message = util.format(...args)
+      message = format(...args)
     } else {
       throw new TypeError('format: not a string or instance of Error')
     }
@@ -740,4 +750,4 @@ class Platform extends homebridgeLib.Delegate {
   }
 }
 
-module.exports = Platform
+export { Platform }

package/lib/PropertyDelegate.js

@@ -3,9 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const homebridgeLib = require('../index')
+import { AccessoryDelegate, Delegate } from '../index.js'
 
 /** Delegate of a property of a delegate of a HomeKit accessory or HomeKit
   * service.
@@ -18,7 +16,7 @@ const homebridgeLib = require('../index')
   *
   * @extends Delegate
   */
-class PropertyDelegate extends homebridgeLib.Delegate {
+class PropertyDelegate extends Delegate {
   /** Instantiate a property delegate.
     *
     * Note that instances are normally created by invoking
@@ -40,7 +38,7 @@ class PropertyDelegate extends homebridgeLib.Delegate {
     * optional parameter is not applicable.
     */
   constructor (parent, params = {}) {
-    if (!(parent instanceof homebridgeLib.AccessoryDelegate)) {
+    if (!(parent instanceof AccessoryDelegate)) {
       throw new TypeError('parent: not an AccessoryDelegate')
     }
     super(parent.platform, parent.name + ': ' + params.key)
@@ -134,4 +132,4 @@ class PropertyDelegate extends homebridgeLib.Delegate {
   }
 }
 
-module.exports = PropertyDelegate
+export { PropertyDelegate }

package/lib/ServiceDelegate/AccessoryInformation.js

@@ -3,9 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const { ServiceDelegate } = require('../../index')
+import { ServiceDelegate } from './index.js'
 
 /** Class for an _AccessoryInformation_ service delegate.
   *
@@ -111,4 +109,4 @@ class AccessoryInformation extends ServiceDelegate {
   }
 }
 
-module.exports = AccessoryInformation
+export { AccessoryInformation }

package/lib/ServiceDelegate/Battery.js

@@ -3,9 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const { ServiceDelegate } = require('../../index')
+import { ServiceDelegate } from '../../index.js'
 
 /** Class for a _Battery_ service delegate.
   *
@@ -105,4 +103,4 @@ class Battery extends ServiceDelegate {
   }
 }
 
-module.exports = Battery
+export { Battery }

package/lib/ServiceDelegate/Dummy.js

@@ -3,9 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const { ServiceDelegate } = require('../../index')
+import { ServiceDelegate } from '../../index.js'
 
 /** Class for a delegate for a dummy _StatelessProgrammableSwitch_ service.
   *
@@ -44,4 +42,4 @@ class Dummy extends ServiceDelegate {
   }
 }
 
-module.exports = Dummy
+export { Dummy }

package/lib/ServiceDelegate/History.js

@@ -7,9 +7,7 @@
 // fakagato-history repository, copyright © 2017 simont77.
 // See https://github.com/simont77/fakegato-history.
 
-'use strict'
-
-const { CharacteristicDelegate, ServiceDelegate } = require('../../index')
+import { CharacteristicDelegate, ServiceDelegate } from '../../index.js'
 
 // Eve history keeps time as # seconds since epoch of 2001/01/01.
 // @type {integer}
@@ -749,4 +747,4 @@ class History extends ServiceDelegate {
   }
 }
 
-module.exports = History
+export { History }

package/lib/ServiceDelegate/ServiceLabel.js

@@ -3,9 +3,7 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const { ServiceDelegate } = require('../../index')
+import { ServiceDelegate } from '../../index.js'
 
 /** Class for a _ServiceLabel_ service delegate.
   *
@@ -47,4 +45,4 @@ class ServiceLabel extends ServiceDelegate {
   }
 }
 
-module.exports = ServiceLabel
+export { ServiceLabel }

package/lib/ServiceDelegate/index.js

@@ -3,9 +3,10 @@
 // Library for Homebridge plugins.
 // Copyright © 2017-2024 Erik Baauw. All rights reserved.
 
-'use strict'
-
-const homebridgeLib = require('../../index')
+import {
+  AccessoryDelegate, CharacteristicDelegate, Delegate,
+  AccessoryInformation, Battery, Dummy, History, ServiceLabel
+} from '../../index.js'
 
 /** Delegate of a HomeKit service.
   *
@@ -19,12 +20,12 @@ const homebridgeLib = require('../../index')
   * @abstract
   * @extends Delegate
   */
-class ServiceDelegate extends homebridgeLib.Delegate {
-  static get AccessoryInformation () { return require('./AccessoryInformation') }
-  static get Battery () { return require('./Battery') }
-  static get Dummy () { return require('./Dummy') }
-  static get History () { return require('./History') }
-  static get ServiceLabel () { return require('./ServiceLabel') }
+class ServiceDelegate extends Delegate {
+  static get AccessoryInformation () { return AccessoryInformation }
+  static get Battery () { return Battery }
+  static get Dummy () { return Dummy }
+  static get History () { return History }
+  static get ServiceLabel () { return ServiceLabel }
 
   /** Create a new instance of a HomeKit service delegate.
     *
@@ -49,7 +50,7 @@ class ServiceDelegate extends homebridgeLib.Delegate {
     * @params {?boolean} params.hidden - Hidden service.
     */
   constructor (accessoryDelegate, params = {}) {
-    if (!(accessoryDelegate instanceof homebridgeLib.AccessoryDelegate)) {
+    if (!(accessoryDelegate instanceof AccessoryDelegate)) {
       throw new TypeError('parent: not a AccessoryDelegate')
     }
     if (params.name == null) {
@@ -229,7 +230,7 @@ class ServiceDelegate extends homebridgeLib.Delegate {
       throw new SyntaxError(`${key}: duplicate key`)
     }
 
-    const characteristicDelegate = new homebridgeLib.CharacteristicDelegate(
+    const characteristicDelegate = new CharacteristicDelegate(
       this, params
     )
     this._characteristicDelegates[key] = characteristicDelegate
@@ -318,4 +319,4 @@ class ServiceDelegate extends homebridgeLib.Delegate {
   }
 }
 
-module.exports = ServiceDelegate
+export { ServiceDelegate }

package/lib/UiServer.js

@@ -3,15 +3,14 @@
 // Library for Homebridge plugins.
 // Copyright © 2022-2024 Erik Baauw. All rights reserved.
 
-'use strict'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { format } from 'node:util'
 
-const {
-  HomebridgePluginUiServer // , RequestError
-} = require('@homebridge/plugin-ui-utils')
-const { HttpClient, chalk, formatError } = require('../index')
-const fs = require('fs').promises
-const path = require('path')
-const util = require('util')
+// Somehow this causes Homebridge to crash with SIGTERM after ~9 seconds.
+import { HomebridgePluginUiServer } from '@homebridge/plugin-ui-utils'
+
+import { HttpClient, chalk, formatError } from '../index.js'
 
 /** Server for handling Homebridge Plugin UI requests.
   *
@@ -93,12 +92,12 @@ class UiServer extends HomebridgePluginUiServer {
         if (username != null) {
           fileName += '.' + username.replace(/:/g, '').toUpperCase()
         }
-        const fullFileName = path.join(
+        const fullFileName = join(
           this.homebridgeStoragePath,
           'accessories',
           fileName
         )
-        const json = await fs.readFile(fullFileName)
+        const json = await readFile(fullFileName)
         const cachedAccessories = JSON.parse(json)
         return cachedAccessories
       } catch (error) {
@@ -219,9 +218,9 @@ class UiServer extends HomebridgePluginUiServer {
     if (args[0] == null) {
       message = ''
     } else if (typeof args[0] === 'string') {
-      message = util.format(...args)
+      message = format(...args)
     } else {
-      message = util.format('%o', ...args)
+      message = format('%o', ...args)
     }
 
     // Handle colours.
@@ -233,4 +232,4 @@ class UiServer extends HomebridgePluginUiServer {
   }
 }
 
-module.exports = UiServer
+export { UiServer }

package/package.json

@@ -3,11 +3,12 @@
   "description": "Library for homebridge plugins",
   "author": "Erik Baauw",
   "license": "Apache-2.0",
-  "version": "6.7.4",
+  "version": "7.0.0-0",
   "keywords": [
     "homekit",
     "homebridge"
   ],
+  "type": "module",
   "main": "index.js",
   "files": [
     "index.js",
@@ -22,11 +23,11 @@
   },
   "engines": {
     "homebridge": "^1.7.0",
-    "node": "20.11.1||^20||^18"
+    "node": "20.12.2||^20||^18"
   },
   "dependencies": {
-    "@homebridge/plugin-ui-utils": "~1.0.1",
-    "hb-lib-tools": "~1.2.3"
+    "@homebridge/plugin-ui-utils": "~1.0.3",
+    "hb-lib-tools": "~2.0.0-0"
   },
   "scripts": {
     "prepare": "standard && rm -rf out && jsdoc -c jsdoc.json",