@zwave-js/config 14.0.0-beta.1 → 14.0.0-beta.4

package/build/{ConfigManager.d.ts → cjs/ConfigManager.d.ts}

@@ -1,6 +1,6 @@
 import { ZWaveLogContainer } from "@zwave-js/core";
-import { type ManufacturersMap } from "./Manufacturers";
-import { ConditionalDeviceConfig, type DeviceConfig, type DeviceConfigIndex, type FulltextDeviceConfigIndex } from "./devices/DeviceConfig";
+import { type ManufacturersMap } from "./Manufacturers.js";
+import { ConditionalDeviceConfig, type DeviceConfig, type DeviceConfigIndex, type FulltextDeviceConfigIndex } from "./devices/DeviceConfig.js";
 export interface ConfigManagerOptions {
     logContainer?: ZWaveLogContainer;
     deviceConfigPriorityDir?: string;

package/build/cjs/ConfigManager.js

@@ -0,0 +1,208 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ConfigManager_exports = {};
+__export(ConfigManager_exports, {
+  ConfigManager: () => ConfigManager
+});
+module.exports = __toCommonJS(ConfigManager_exports);
+var import_core = require("@zwave-js/core");
+var import_shared = require("@zwave-js/shared");
+var import_node_path = __toESM(require("node:path"), 1);
+var import_Logger = require("./Logger.js");
+var import_Manufacturers = require("./Manufacturers.js");
+var import_version = require("./_version.js");
+var import_DeviceConfig = require("./devices/DeviceConfig.js");
+var import_utils = require("./utils.js");
+class ConfigManager {
+  constructor(options = {}) {
+    this.logger = new import_Logger.ConfigLogger(options.logContainer ?? new import_core.ZWaveLogContainer({ enabled: false }));
+    this.deviceConfigPriorityDir = options.deviceConfigPriorityDir;
+    this._configVersion = import_version.PACKAGE_VERSION;
+  }
+  _configVersion;
+  get configVersion() {
+    return this._configVersion;
+  }
+  logger;
+  _manufacturers;
+  get manufacturers() {
+    if (!this._manufacturers) {
+      throw new import_core.ZWaveError("The config has not been loaded yet!", import_core.ZWaveErrorCodes.Driver_NotReady);
+    }
+    return this._manufacturers;
+  }
+  deviceConfigPriorityDir;
+  index;
+  fulltextIndex;
+  _useExternalConfig = false;
+  get useExternalConfig() {
+    return this._useExternalConfig;
+  }
+  async loadAll() {
+    const syncResult = await (0, import_utils.syncExternalConfigDir)(this.logger);
+    if (syncResult.success) {
+      this._useExternalConfig = true;
+      this.logger.print(`Using external configuration dir ${(0, import_utils.externalConfigDir)()}`);
+      this._configVersion = syncResult.version;
+    } else {
+      this._useExternalConfig = false;
+      this._configVersion = import_version.PACKAGE_VERSION;
+    }
+    this.logger.print(`version ${this._configVersion}`, "info");
+    await this.loadManufacturers();
+    await this.loadDeviceIndex();
+  }
+  async loadManufacturers() {
+    try {
+      this._manufacturers = await (0, import_Manufacturers.loadManufacturersInternal)(this._useExternalConfig);
+    } catch (e) {
+      if ((0, import_core.isZWaveError)(e) && e.code === import_core.ZWaveErrorCodes.Config_Invalid) {
+        if (process.env.NODE_ENV !== "test") {
+          this.logger.print(`Could not load manufacturers config: ${e.message}`, "error");
+        }
+        if (!this._manufacturers)
+          this._manufacturers = /* @__PURE__ */ new Map();
+      } else {
+        throw e;
+      }
+    }
+  }
+  async saveManufacturers() {
+    if (!this._manufacturers) {
+      throw new import_core.ZWaveError("The config has not been loaded yet!", import_core.ZWaveErrorCodes.Driver_NotReady);
+    }
+    await (0, import_Manufacturers.saveManufacturersInternal)(this._manufacturers);
+  }
+  /**
+   * Looks up the name of the manufacturer with the given ID in the configuration DB
+   * @param manufacturerId The manufacturer id to look up
+   */
+  lookupManufacturer(manufacturerId) {
+    if (!this._manufacturers) {
+      throw new import_core.ZWaveError("The config has not been loaded yet!", import_core.ZWaveErrorCodes.Driver_NotReady);
+    }
+    return this._manufacturers.get(manufacturerId);
+  }
+  /**
+   * Add new manufacturers to configuration DB
+   * @param manufacturerId The manufacturer id to look up
+   * @param manufacturerName The manufacturer name
+   */
+  setManufacturer(manufacturerId, manufacturerName) {
+    if (!this._manufacturers) {
+      throw new import_core.ZWaveError("The config has not been loaded yet!", import_core.ZWaveErrorCodes.Driver_NotReady);
+    }
+    this._manufacturers.set(manufacturerId, manufacturerName);
+  }
+  async loadDeviceIndex() {
+    try {
+      const embeddedIndex = await (0, import_DeviceConfig.loadDeviceIndexInternal)(this.logger, this._useExternalConfig);
+      const priorityIndex = [];
+      if (this.deviceConfigPriorityDir) {
+        if (await (0, import_shared.pathExists)(this.deviceConfigPriorityDir)) {
+          priorityIndex.push(...await (0, import_DeviceConfig.generatePriorityDeviceIndex)(this.deviceConfigPriorityDir, this.logger));
+        } else {
+          this.logger.print(`Priority device configuration directory ${this.deviceConfigPriorityDir} not found`, "warn");
+        }
+      }
+      this.index = [...priorityIndex, ...embeddedIndex];
+    } catch (e) {
+      if (!(0, import_core.isZWaveError)(e) && e instanceof Error || (0, import_core.isZWaveError)(e) && e.code === import_core.ZWaveErrorCodes.Config_Invalid) {
+        if (!this.index)
+          this.index = [];
+        if (process.env.NODE_ENV !== "test") {
+          this.logger.print(`Could not load or regenerate device config index: ${e.message}`, "error");
+          return;
+        }
+        throw e;
+      }
+    }
+  }
+  getIndex() {
+    return this.index;
+  }
+  async loadFulltextDeviceIndex() {
+    this.fulltextIndex = await (0, import_DeviceConfig.loadFulltextDeviceIndexInternal)(this.logger);
+  }
+  getFulltextIndex() {
+    return this.fulltextIndex;
+  }
+  /**
+   * Looks up the definition of a given device in the configuration DB, but does not evaluate conditional settings.
+   * @param manufacturerId The manufacturer id of the device
+   * @param productType The product type of the device
+   * @param productId The product id of the device
+   * @param firmwareVersion If known, configuration for a specific firmware version can be loaded.
+   * If this is `undefined` or not given, the first matching file with a defined firmware range will be returned.
+   */
+  async lookupDevicePreserveConditions(manufacturerId, productType, productId, firmwareVersion) {
+    if (!this.index)
+      await this.loadDeviceIndex();
+    const indexEntries = this.index.filter((0, import_utils.getDeviceEntryPredicate)(manufacturerId, productType, productId, firmwareVersion));
+    const indexEntry = indexEntries.find((e) => !!e.preferred) ?? indexEntries[0];
+    if (indexEntry) {
+      const devicesDir = (0, import_DeviceConfig.getDevicesPaths)(this._useExternalConfig ? (0, import_utils.externalConfigDir)() : import_utils.configDir).devicesDir;
+      const filePath = import_node_path.default.isAbsolute(indexEntry.filename) ? indexEntry.filename : import_node_path.default.join(devicesDir, indexEntry.filename);
+      if (!await (0, import_shared.pathExists)(filePath))
+        return;
+      const isEmbedded = !import_node_path.default.relative(devicesDir, filePath).startsWith("..");
+      const rootDir = indexEntry.rootDir ?? devicesDir;
+      const fallbackDirs = rootDir === devicesDir ? void 0 : [devicesDir];
+      try {
+        return await import_DeviceConfig.ConditionalDeviceConfig.from(filePath, isEmbedded, { rootDir, fallbackDirs });
+      } catch (e) {
+        if (process.env.NODE_ENV !== "test") {
+          this.logger.print(`Error loading device config ${filePath}: ${(0, import_shared.getErrorMessage)(e, true)}`, "error");
+        }
+      }
+    }
+  }
+  /**
+   * Looks up the definition of a given device in the configuration DB
+   * @param manufacturerId The manufacturer id of the device
+   * @param productType The product type of the device
+   * @param productId The product id of the device
+   * @param firmwareVersion If known, configuration for a specific firmware version can be loaded.
+   * If this is `undefined` or not given, the first matching file with a defined firmware range will be returned.
+   */
+  async lookupDevice(manufacturerId, productType, productId, firmwareVersion) {
+    const ret = await this.lookupDevicePreserveConditions(manufacturerId, productType, productId, firmwareVersion);
+    return ret?.evaluate({
+      manufacturerId,
+      productType,
+      productId,
+      firmwareVersion
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigManager
+});
+//# sourceMappingURL=ConfigManager.js.map

package/build/cjs/ConfigManager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ConfigManager.ts"],
+  "sourcesContent": ["import {\n\tZWaveError,\n\tZWaveErrorCodes,\n\tZWaveLogContainer,\n\tisZWaveError,\n} from \"@zwave-js/core\";\nimport { getErrorMessage, pathExists } from \"@zwave-js/shared\";\nimport path from \"node:path\";\nimport { ConfigLogger } from \"./Logger.js\";\nimport {\n\ttype ManufacturersMap,\n\tloadManufacturersInternal,\n\tsaveManufacturersInternal,\n} from \"./Manufacturers.js\";\nimport { PACKAGE_VERSION } from \"./_version.js\";\nimport {\n\tConditionalDeviceConfig,\n\ttype DeviceConfig,\n\ttype DeviceConfigIndex,\n\ttype FulltextDeviceConfigIndex,\n\tgeneratePriorityDeviceIndex,\n\tgetDevicesPaths,\n\tloadDeviceIndexInternal,\n\tloadFulltextDeviceIndexInternal,\n} from \"./devices/DeviceConfig.js\";\nimport {\n\tconfigDir,\n\texternalConfigDir,\n\tgetDeviceEntryPredicate,\n\tsyncExternalConfigDir,\n} from \"./utils.js\";\n\nexport interface ConfigManagerOptions {\n\tlogContainer?: ZWaveLogContainer;\n\tdeviceConfigPriorityDir?: string;\n}\n\nexport class ConfigManager {\n\tpublic constructor(options: ConfigManagerOptions = {}) {\n\t\tthis.logger = new ConfigLogger(\n\t\t\toptions.logContainer ?? new ZWaveLogContainer({ enabled: false }),\n\t\t);\n\t\tthis.deviceConfigPriorityDir = options.deviceConfigPriorityDir;\n\t\tthis._configVersion = PACKAGE_VERSION;\n\t}\n\n\tprivate _configVersion: string;\n\tpublic get configVersion(): string {\n\t\treturn this._configVersion;\n\t}\n\n\tprivate logger: ConfigLogger;\n\n\tprivate _manufacturers: ManufacturersMap | undefined;\n\tpublic get manufacturers(): ManufacturersMap {\n\t\tif (!this._manufacturers) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t\"The config has not been loaded yet!\",\n\t\t\t\tZWaveErrorCodes.Driver_NotReady,\n\t\t\t);\n\t\t}\n\t\treturn this._manufacturers;\n\t}\n\n\tprivate deviceConfigPriorityDir: string | undefined;\n\tprivate index: DeviceConfigIndex | undefined;\n\tprivate fulltextIndex: FulltextDeviceConfigIndex | undefined;\n\n\tprivate _useExternalConfig: boolean = false;\n\tpublic get useExternalConfig(): boolean {\n\t\treturn this._useExternalConfig;\n\t}\n\n\tpublic async loadAll(): Promise<void> {\n\t\t// If the environment option for an external config dir is set\n\t\t// try to sync it and then use it\n\t\tconst syncResult = await syncExternalConfigDir(this.logger);\n\t\tif (syncResult.success) {\n\t\t\tthis._useExternalConfig = true;\n\t\t\tthis.logger.print(\n\t\t\t\t`Using external configuration dir ${externalConfigDir()}`,\n\t\t\t);\n\t\t\tthis._configVersion = syncResult.version;\n\t\t} else {\n\t\t\tthis._useExternalConfig = false;\n\t\t\tthis._configVersion = PACKAGE_VERSION;\n\t\t}\n\t\tthis.logger.print(`version ${this._configVersion}`, \"info\");\n\n\t\tawait this.loadManufacturers();\n\t\tawait this.loadDeviceIndex();\n\t}\n\n\tpublic async loadManufacturers(): Promise<void> {\n\t\ttry {\n\t\t\tthis._manufacturers = await loadManufacturersInternal(\n\t\t\t\tthis._useExternalConfig,\n\t\t\t);\n\t\t} catch (e) {\n\t\t\t// If the config file is missing or invalid, don't try to find it again\n\t\t\tif (isZWaveError(e) && e.code === ZWaveErrorCodes.Config_Invalid) {\n\t\t\t\tif (process.env.NODE_ENV !== \"test\") {\n\t\t\t\t\tthis.logger.print(\n\t\t\t\t\t\t`Could not load manufacturers config: ${e.message}`,\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (!this._manufacturers) this._manufacturers = new Map();\n\t\t\t} else {\n\t\t\t\t// This is an unexpected error\n\t\t\t\tthrow e;\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic async saveManufacturers(): Promise<void> {\n\t\tif (!this._manufacturers) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t\"The config has not been loaded yet!\",\n\t\t\t\tZWaveErrorCodes.Driver_NotReady,\n\t\t\t);\n\t\t}\n\n\t\tawait saveManufacturersInternal(this._manufacturers);\n\t}\n\n\t/**\n\t * Looks up the name of the manufacturer with the given ID in the configuration DB\n\t * @param manufacturerId The manufacturer id to look up\n\t */\n\tpublic lookupManufacturer(manufacturerId: number): string | undefined {\n\t\tif (!this._manufacturers) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t\"The config has not been loaded yet!\",\n\t\t\t\tZWaveErrorCodes.Driver_NotReady,\n\t\t\t);\n\t\t}\n\n\t\treturn this._manufacturers.get(manufacturerId);\n\t}\n\n\t/**\n\t * Add new manufacturers to configuration DB\n\t * @param manufacturerId The manufacturer id to look up\n\t * @param manufacturerName The manufacturer name\n\t */\n\tpublic setManufacturer(\n\t\tmanufacturerId: number,\n\t\tmanufacturerName: string,\n\t): void {\n\t\tif (!this._manufacturers) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t\"The config has not been loaded yet!\",\n\t\t\t\tZWaveErrorCodes.Driver_NotReady,\n\t\t\t);\n\t\t}\n\n\t\tthis._manufacturers.set(manufacturerId, manufacturerName);\n\t}\n\n\tpublic async loadDeviceIndex(): Promise<void> {\n\t\ttry {\n\t\t\t// The index of config files included in this package\n\t\t\tconst embeddedIndex = await loadDeviceIndexInternal(\n\t\t\t\tthis.logger,\n\t\t\t\tthis._useExternalConfig,\n\t\t\t);\n\t\t\t// A dynamic index of the user-defined priority device config files\n\t\t\tconst priorityIndex: DeviceConfigIndex = [];\n\t\t\tif (this.deviceConfigPriorityDir) {\n\t\t\t\tif (await pathExists(this.deviceConfigPriorityDir)) {\n\t\t\t\t\tpriorityIndex.push(\n\t\t\t\t\t\t...(await generatePriorityDeviceIndex(\n\t\t\t\t\t\t\tthis.deviceConfigPriorityDir,\n\t\t\t\t\t\t\tthis.logger,\n\t\t\t\t\t\t)),\n\t\t\t\t\t);\n\t\t\t\t} else {\n\t\t\t\t\tthis.logger.print(\n\t\t\t\t\t\t`Priority device configuration directory ${this.deviceConfigPriorityDir} not found`,\n\t\t\t\t\t\t\"warn\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Put the priority index in front, so the files get resolved first\n\t\t\tthis.index = [...priorityIndex, ...embeddedIndex];\n\t\t} catch (e) {\n\t\t\t// If the index file is missing or invalid, don't try to find it again\n\t\t\tif (\n\t\t\t\t(!isZWaveError(e) && e instanceof Error)\n\t\t\t\t|| (isZWaveError(e)\n\t\t\t\t\t&& e.code === ZWaveErrorCodes.Config_Invalid)\n\t\t\t) {\n\t\t\t\t// Fall back to no index on production systems\n\t\t\t\tif (!this.index) this.index = [];\n\t\t\t\tif (process.env.NODE_ENV !== \"test\") {\n\t\t\t\t\tthis.logger.print(\n\t\t\t\t\t\t`Could not load or regenerate device config index: ${e.message}`,\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t);\n\t\t\t\t\t// and don't throw\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\t// But fail hard in tests\n\t\t\t\tthrow e;\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic getIndex(): DeviceConfigIndex | undefined {\n\t\treturn this.index;\n\t}\n\n\tpublic async loadFulltextDeviceIndex(): Promise<void> {\n\t\tthis.fulltextIndex = await loadFulltextDeviceIndexInternal(this.logger);\n\t}\n\n\tpublic getFulltextIndex(): FulltextDeviceConfigIndex | undefined {\n\t\treturn this.fulltextIndex;\n\t}\n\n\t/**\n\t * Looks up the definition of a given device in the configuration DB, but does not evaluate conditional settings.\n\t * @param manufacturerId The manufacturer id of the device\n\t * @param productType The product type of the device\n\t * @param productId The product id of the device\n\t * @param firmwareVersion If known, configuration for a specific firmware version can be loaded.\n\t * If this is `undefined` or not given, the first matching file with a defined firmware range will be returned.\n\t */\n\tpublic async lookupDevicePreserveConditions(\n\t\tmanufacturerId: number,\n\t\tproductType: number,\n\t\tproductId: number,\n\t\tfirmwareVersion?: string,\n\t): Promise<ConditionalDeviceConfig | undefined> {\n\t\t// Load/regenerate the index if necessary\n\t\tif (!this.index) await this.loadDeviceIndex();\n\n\t\t// Look up the device in the index\n\t\tconst indexEntries = this.index!.filter(\n\t\t\tgetDeviceEntryPredicate(\n\t\t\t\tmanufacturerId,\n\t\t\t\tproductType,\n\t\t\t\tproductId,\n\t\t\t\tfirmwareVersion,\n\t\t\t),\n\t\t);\n\t\t// If there are multiple with overlapping firmware ranges, return the preferred one first\n\t\tconst indexEntry = indexEntries.find((e) => !!e.preferred)\n\t\t\t?? indexEntries[0];\n\n\t\tif (indexEntry) {\n\t\t\tconst devicesDir = getDevicesPaths(\n\t\t\t\tthis._useExternalConfig ? externalConfigDir()! : configDir,\n\t\t\t).devicesDir;\n\t\t\tconst filePath = path.isAbsolute(indexEntry.filename)\n\t\t\t\t? indexEntry.filename\n\t\t\t\t: path.join(devicesDir, indexEntry.filename);\n\t\t\tif (!(await pathExists(filePath))) return;\n\n\t\t\t// A config file is treated as am embedded one when it is located under the devices root dir\n\t\t\t// or the external config dir\n\t\t\tconst isEmbedded = !path\n\t\t\t\t.relative(devicesDir, filePath)\n\t\t\t\t.startsWith(\"..\");\n\n\t\t\t// When a device file is located in a different root directory than the embedded config files,\n\t\t\t// we use the embedded dir a fallback\n\t\t\tconst rootDir = indexEntry.rootDir ?? devicesDir;\n\t\t\tconst fallbackDirs = rootDir === devicesDir\n\t\t\t\t? undefined\n\t\t\t\t: [devicesDir];\n\n\t\t\ttry {\n\t\t\t\treturn await ConditionalDeviceConfig.from(\n\t\t\t\t\tfilePath,\n\t\t\t\t\tisEmbedded,\n\t\t\t\t\t{ rootDir, fallbackDirs },\n\t\t\t\t);\n\t\t\t} catch (e) {\n\t\t\t\tif (process.env.NODE_ENV !== \"test\") {\n\t\t\t\t\tthis.logger.print(\n\t\t\t\t\t\t`Error loading device config ${filePath}: ${\n\t\t\t\t\t\t\tgetErrorMessage(\n\t\t\t\t\t\t\t\te,\n\t\t\t\t\t\t\t\ttrue,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t}`,\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Looks up the definition of a given device in the configuration DB\n\t * @param manufacturerId The manufacturer id of the device\n\t * @param productType The product type of the device\n\t * @param productId The product id of the device\n\t * @param firmwareVersion If known, configuration for a specific firmware version can be loaded.\n\t * If this is `undefined` or not given, the first matching file with a defined firmware range will be returned.\n\t */\n\tpublic async lookupDevice(\n\t\tmanufacturerId: number,\n\t\tproductType: number,\n\t\tproductId: number,\n\t\tfirmwareVersion?: string,\n\t): Promise<DeviceConfig | undefined> {\n\t\tconst ret = await this.lookupDevicePreserveConditions(\n\t\t\tmanufacturerId,\n\t\t\tproductType,\n\t\t\tproductId,\n\t\t\tfirmwareVersion,\n\t\t);\n\t\treturn ret?.evaluate({\n\t\t\tmanufacturerId,\n\t\t\tproductType,\n\t\t\tproductId,\n\t\t\tfirmwareVersion,\n\t\t});\n\t}\n}\n"],
+  "mappings": "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",
+  "names": ["path"]
+}

package/build/cjs/JsonTemplate.js

@@ -0,0 +1,198 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var JsonTemplate_exports = {};
+__export(JsonTemplate_exports, {
+  clearTemplateCache: () => clearTemplateCache,
+  readJsonWithTemplate: () => readJsonWithTemplate
+});
+module.exports = __toCommonJS(JsonTemplate_exports);
+var import_safe = require("@zwave-js/core/safe");
+var import_shared = require("@zwave-js/shared");
+var import_safe2 = require("@zwave-js/shared/safe");
+var import_typeguards = require("alcalzone-shared/typeguards/index.js");
+var import_json5 = __toESM(require("json5"), 1);
+var import_promises = __toESM(require("node:fs/promises"), 1);
+var path = __toESM(require("node:path"), 1);
+const IMPORT_KEY = "$import";
+const importSpecifierRegex = /^(?<filename>(?:~\/)?[\w\d\/\\\._-]+\.json)?(?:#(?<selector>[\w\d\/\._-]+(?:\[0x[0-9a-fA-F]+\])?))?$/i;
+const templateCache = /* @__PURE__ */ new Map();
+function clearTemplateCache() {
+  templateCache.clear();
+}
+async function readJsonWithTemplate(filename, rootDirs) {
+  if (!await (0, import_shared.pathExists)(filename)) {
+    throw new import_safe.ZWaveError(`Could not open config file ${filename}: not found!`, import_safe.ZWaveErrorCodes.Config_NotFound);
+  }
+  if (typeof rootDirs === "string")
+    rootDirs = [rootDirs];
+  const fileCache = new Map(templateCache);
+  const ret = await readJsonWithTemplateInternal(filename, void 0, [], fileCache, rootDirs);
+  for (const [filename2, cached] of fileCache) {
+    if (/[\\/]templates[\\/]/.test(filename2)) {
+      templateCache.set(filename2, cached);
+    }
+  }
+  return ret;
+}
+function assertImportSpecifier(val, source) {
+  if (typeof val !== "string") {
+    throw new import_safe.ZWaveError(`Invalid import specifier ${String(val)}!${source != void 0 ? ` Source: ${source}` : ""}`, import_safe.ZWaveErrorCodes.Config_Invalid);
+  }
+  if (!importSpecifierRegex.test(val)) {
+    throw new import_safe.ZWaveError(`Import specifier "${val}" is invalid!${source != void 0 ? ` Source: ${source}` : ""}`, import_safe.ZWaveErrorCodes.Config_Invalid);
+  }
+}
+function getImportSpecifier(filename, selector) {
+  let ret = filename;
+  if (selector)
+    ret += `#${selector}`;
+  return ret;
+}
+function select(obj, selector) {
+  let ret = obj;
+  const selectorParts = selector.split("/").filter((s) => !!s);
+  for (const part of selectorParts) {
+    if ((0, import_typeguards.isArray)(ret)) {
+      const item = ret.find((r) => (0, import_typeguards.isObject)(r) && "#" in r && r["#"] === part);
+      if (item != void 0) {
+        const { ["#"]: _, ...rest } = item;
+        ret = rest;
+        continue;
+      }
+    }
+    ret = ret[part];
+  }
+  if (!(0, import_typeguards.isObject)(ret)) {
+    throw new import_safe.ZWaveError(`The import target "${selector}" is not an object!`, import_safe.ZWaveErrorCodes.Config_Invalid);
+  }
+  return ret;
+}
+function getImportStack(visited, selector) {
+  const source = [...visited, selector ? `#${selector}` : void 0].reverse().filter((s) => !!s);
+  if (source.length > 0) {
+    return `
+Import stack: ${source.map((s) => `
+  in ${s}`).join("")}`;
+  }
+  return "";
+}
+async function readJsonWithTemplateInternal(filename, selector, visited, fileCache, rootDirs) {
+  filename = path.normalize(filename);
+  if (rootDirs) {
+    const outsideAllRootDirs = rootDirs.every((rootDir) => {
+      const relativeToRoot = path.relative(rootDir, filename);
+      return relativeToRoot.startsWith("..");
+    });
+    if (outsideAllRootDirs) {
+      throw new import_safe.ZWaveError(`Tried to import config file "${filename}" from outside all root directories: ${rootDirs.map((d) => `
+\xB7 ${d}`).join("")}
+${getImportStack(visited, selector)}`, import_safe.ZWaveErrorCodes.Config_Invalid);
+    }
+  }
+  const specifier = getImportSpecifier(filename, selector);
+  if (visited.includes(specifier)) {
+    const msg = `Circular $import in config files: ${[
+      ...visited,
+      specifier
+    ].join(" -> ")}
+`;
+    throw new import_safe.ZWaveError(msg, import_safe.ZWaveErrorCodes.Config_CircularImport);
+  }
+  let json;
+  if (fileCache.has(filename)) {
+    json = fileCache.get(filename);
+  } else {
+    try {
+      const fileContent = await import_promises.default.readFile(filename, "utf8");
+      json = import_json5.default.parse(fileContent);
+      fileCache.set(filename, json);
+    } catch (e) {
+      throw new import_safe.ZWaveError(`Could not parse config file ${filename}: ${(0, import_safe2.getErrorMessage)(e)}${getImportStack(visited, selector)}`, import_safe.ZWaveErrorCodes.Config_Invalid);
+    }
+  }
+  return resolveJsonImports(selector ? select(json, selector) : json, filename, [...visited, specifier], fileCache, rootDirs);
+}
+async function resolveJsonImports(json, filename, visited, fileCache, rootDirs) {
+  const ret = {};
+  for (const [prop, val] of Object.entries(json)) {
+    if (prop === IMPORT_KEY) {
+      assertImportSpecifier(val, visited.join(" -> "));
+      const { filename: importFilename, selector } = importSpecifierRegex.exec(val).groups;
+      let newFilename;
+      if (importFilename) {
+        if (importFilename.startsWith("~/")) {
+          if (rootDirs) {
+            for (const rootDir of rootDirs) {
+              newFilename = path.join(rootDir, importFilename.slice(2));
+              if (await (0, import_shared.pathExists)(newFilename)) {
+                break;
+              } else {
+                newFilename = void 0;
+              }
+            }
+            if (!newFilename) {
+              throw new import_safe.ZWaveError(`Could not find the referenced file ${importFilename.slice(2)} in any of the root directories: ${rootDirs.map((d) => `
+\xB7 ${d}`).join("")}
+${getImportStack(visited, selector)}`, import_safe.ZWaveErrorCodes.Config_Invalid);
+            }
+          } else {
+            throw new import_safe.ZWaveError(`An $import specifier cannot start with ~/ when no root directory is defined!${getImportStack(visited, selector)}`, import_safe.ZWaveErrorCodes.Config_Invalid);
+          }
+        } else {
+          newFilename = path.join(path.dirname(filename), importFilename);
+        }
+      } else {
+        newFilename = filename;
+      }
+      const imported = await readJsonWithTemplateInternal(newFilename, selector, visited, fileCache, rootDirs);
+      Object.assign(ret, imported);
+    } else if ((0, import_typeguards.isObject)(val)) {
+      ret[prop] = await resolveJsonImports(val, filename, visited, fileCache, rootDirs);
+    } else if ((0, import_typeguards.isArray)(val)) {
+      const vals = [];
+      for (const v of val) {
+        if ((0, import_typeguards.isObject)(v)) {
+          vals.push(await resolveJsonImports(v, filename, visited, fileCache, rootDirs));
+        } else {
+          vals.push(v);
+        }
+      }
+      ret[prop] = vals;
+    } else {
+      ret[prop] = val;
+    }
+  }
+  return ret;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearTemplateCache,
+  readJsonWithTemplate
+});
+//# sourceMappingURL=JsonTemplate.js.map

package/build/cjs/JsonTemplate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/JsonTemplate.ts"],
+  "sourcesContent": ["import { ZWaveError, ZWaveErrorCodes } from \"@zwave-js/core/safe\";\nimport { pathExists } from \"@zwave-js/shared\";\nimport { getErrorMessage } from \"@zwave-js/shared/safe\";\nimport { isArray, isObject } from \"alcalzone-shared/typeguards/index.js\";\nimport JSON5 from \"json5\";\nimport fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\n\nconst IMPORT_KEY = \"$import\";\nconst importSpecifierRegex =\n\t/^(?<filename>(?:~\\/)?[\\w\\d\\/\\\\\\._-]+\\.json)?(?:#(?<selector>[\\w\\d\\/\\._-]+(?:\\[0x[0-9a-fA-F]+\\])?))?$/i;\n\ntype FileCache = Map<string, Record<string, unknown>>;\n\n// The template cache is used to speed up cases where the same files get parsed multiple times,\n// e.g. during config file linting. It should be cleared whenever the files need to be loaded fresh\n// from disk, like when creating an index\nconst templateCache: FileCache = new Map();\nexport function clearTemplateCache(): void {\n\ttemplateCache.clear();\n}\n\n/** Parses a JSON file with $import keys and replaces them with the selected objects */\nexport async function readJsonWithTemplate(\n\tfilename: string,\n\trootDirs?: string | string[],\n): Promise<Record<string, unknown>> {\n\tif (!(await pathExists(filename))) {\n\t\tthrow new ZWaveError(\n\t\t\t`Could not open config file ${filename}: not found!`,\n\t\t\tZWaveErrorCodes.Config_NotFound,\n\t\t);\n\t}\n\n\tif (typeof rootDirs === \"string\") rootDirs = [rootDirs];\n\n\t// Try to use the cached versions of the template files to speed up the loading\n\tconst fileCache = new Map(templateCache);\n\tconst ret = await readJsonWithTemplateInternal(\n\t\tfilename,\n\t\tundefined,\n\t\t[],\n\t\tfileCache,\n\t\trootDirs,\n\t);\n\n\t// Only remember the cached templates, not the individual files to save RAM\n\tfor (const [filename, cached] of fileCache) {\n\t\tif (/[\\\\/]templates[\\\\/]/.test(filename)) {\n\t\t\ttemplateCache.set(filename, cached);\n\t\t}\n\t}\n\n\treturn ret;\n}\n\nfunction assertImportSpecifier(\n\tval: unknown,\n\tsource?: string,\n): asserts val is string {\n\tif (typeof val !== \"string\") {\n\t\tthrow new ZWaveError(\n\t\t\t`Invalid import specifier ${String(val)}!${\n\t\t\t\tsource != undefined ? ` Source: ${source}` : \"\"\n\t\t\t}`,\n\t\t\tZWaveErrorCodes.Config_Invalid,\n\t\t);\n\t}\n\tif (!importSpecifierRegex.test(val)) {\n\t\tthrow new ZWaveError(\n\t\t\t`Import specifier \"${val}\" is invalid!${\n\t\t\t\tsource != undefined ? ` Source: ${source}` : \"\"\n\t\t\t}`,\n\t\t\tZWaveErrorCodes.Config_Invalid,\n\t\t);\n\t}\n}\n\nfunction getImportSpecifier(filename: string, selector?: string): string {\n\tlet ret = filename;\n\tif (selector) ret += `#${selector}`;\n\treturn ret;\n}\n\nfunction select(\n\tobj: Record<string, unknown>,\n\tselector: string,\n): Record<string, unknown> {\n\tlet ret: Record<string, unknown> = obj;\n\tconst selectorParts = selector.split(\"/\").filter((s) => !!s);\n\tfor (const part of selectorParts) {\n\t\t// Special case for paramInformation selectors to select params by #\n\t\tif (isArray(ret)) {\n\t\t\tconst item = ret.find(\n\t\t\t\t(r) => isObject(r) && \"#\" in r && r[\"#\"] === part,\n\t\t\t);\n\t\t\tif (item != undefined) {\n\t\t\t\t// Don't copy the param number\n\t\t\t\tconst { [\"#\"]: _, ...rest } = item as any;\n\t\t\t\tret = rest;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\t// By default select the object property\n\t\tret = (ret as any)[part];\n\t}\n\tif (!isObject(ret)) {\n\t\tthrow new ZWaveError(\n\t\t\t`The import target \"${selector}\" is not an object!`,\n\t\t\tZWaveErrorCodes.Config_Invalid,\n\t\t);\n\t}\n\treturn ret;\n}\n\nfunction getImportStack(\n\tvisited: string[],\n\tselector: string | undefined,\n): string {\n\tconst source = [...visited, selector ? `#${selector}` : undefined]\n\t\t.reverse()\n\t\t.filter((s) => !!s) as string[];\n\tif (source.length > 0) {\n\t\treturn `\\nImport stack: ${source.map((s) => `\\n  in ${s}`).join(\"\")}`;\n\t}\n\treturn \"\";\n}\n\nasync function readJsonWithTemplateInternal(\n\tfilename: string,\n\tselector: string | undefined,\n\tvisited: string[],\n\tfileCache: FileCache,\n\trootDirs?: string[],\n): Promise<Record<string, unknown>> {\n\tfilename = path.normalize(filename);\n\n\t// If we're limited by one or more root directories, make sure the file is inside one of those\n\tif (rootDirs) {\n\t\tconst outsideAllRootDirs = rootDirs.every((rootDir) => {\n\t\t\tconst relativeToRoot = path.relative(rootDir, filename);\n\t\t\treturn relativeToRoot.startsWith(\"..\");\n\t\t});\n\n\t\tif (outsideAllRootDirs) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t`Tried to import config file \"${filename}\" from outside all root directories: ${\n\t\t\t\t\trootDirs\n\t\t\t\t\t\t.map((d) => `\\n\u00B7 ${d}`)\n\t\t\t\t\t\t.join(\"\")\n\t\t\t\t}\n${getImportStack(visited, selector)}`,\n\t\t\t\tZWaveErrorCodes.Config_Invalid,\n\t\t\t);\n\t\t}\n\t}\n\n\tconst specifier = getImportSpecifier(filename, selector);\n\tif (visited.includes(specifier)) {\n\t\tconst msg = `Circular $import in config files: ${\n\t\t\t[\n\t\t\t\t...visited,\n\t\t\t\tspecifier,\n\t\t\t].join(\" -> \")\n\t\t}\\n`;\n\t\t// process.stderr.write(msg + \"\\n\");\n\t\tthrow new ZWaveError(msg, ZWaveErrorCodes.Config_CircularImport);\n\t}\n\n\tlet json: Record<string, unknown>;\n\tif (fileCache.has(filename)) {\n\t\tjson = fileCache.get(filename)!;\n\t} else {\n\t\ttry {\n\t\t\tconst fileContent = await fs.readFile(filename, \"utf8\");\n\t\t\tjson = JSON5.parse(fileContent);\n\t\t\tfileCache.set(filename, json);\n\t\t} catch (e) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t`Could not parse config file ${filename}: ${\n\t\t\t\t\tgetErrorMessage(\n\t\t\t\t\t\te,\n\t\t\t\t\t)\n\t\t\t\t}${getImportStack(visited, selector)}`,\n\t\t\t\tZWaveErrorCodes.Config_Invalid,\n\t\t\t);\n\t\t}\n\t}\n\t// Resolve the JSON imports for (a subset) of the file and return the compound file\n\treturn resolveJsonImports(\n\t\tselector ? select(json, selector) : json,\n\t\tfilename,\n\t\t[...visited, specifier],\n\t\tfileCache,\n\t\trootDirs,\n\t);\n}\n\n/** Replaces all `$import` properties in a JSON object with object spreads of the referenced file/property */\nasync function resolveJsonImports(\n\tjson: Record<string, unknown>,\n\tfilename: string,\n\tvisited: string[],\n\tfileCache: FileCache,\n\trootDirs?: string[],\n): Promise<Record<string, unknown>> {\n\tconst ret: Record<string, unknown> = {};\n\t// Loop through all properties and copy them to the resulting object\n\tfor (const [prop, val] of Object.entries(json)) {\n\t\tif (prop === IMPORT_KEY) {\n\t\t\t// This is an import statement. Make sure we're working with a string\n\t\t\tassertImportSpecifier(val, visited.join(\" -> \"));\n\t\t\tconst { filename: importFilename, selector } = importSpecifierRegex\n\t\t\t\t.exec(val)!.groups!;\n\n\t\t\t// Resolve the correct import path\n\t\t\tlet newFilename: string | undefined;\n\t\t\tif (importFilename) {\n\t\t\t\tif (importFilename.startsWith(\"~/\")) {\n\t\t\t\t\t// This is a special import specifier that is relative to the root directory\n\t\t\t\t\t// Try to find at least one root directory that contains the referenced file\n\t\t\t\t\tif (rootDirs) {\n\t\t\t\t\t\tfor (const rootDir of rootDirs) {\n\t\t\t\t\t\t\tnewFilename = path.join(\n\t\t\t\t\t\t\t\trootDir,\n\t\t\t\t\t\t\t\timportFilename.slice(2),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tif (await pathExists(newFilename)) {\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t// Try the next\n\t\t\t\t\t\t\t\tnewFilename = undefined!;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif (!newFilename) {\n\t\t\t\t\t\t\tthrow new ZWaveError(\n\t\t\t\t\t\t\t\t`Could not find the referenced file ${\n\t\t\t\t\t\t\t\t\timportFilename.slice(\n\t\t\t\t\t\t\t\t\t\t2,\n\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t} in any of the root directories: ${\n\t\t\t\t\t\t\t\t\trootDirs\n\t\t\t\t\t\t\t\t\t\t.map((d) => `\\n\u00B7 ${d}`)\n\t\t\t\t\t\t\t\t\t\t.join(\"\")\n\t\t\t\t\t\t\t\t}\\n${\n\t\t\t\t\t\t\t\t\tgetImportStack(\n\t\t\t\t\t\t\t\t\t\tvisited,\n\t\t\t\t\t\t\t\t\t\tselector,\n\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t}`,\n\t\t\t\t\t\t\t\tZWaveErrorCodes.Config_Invalid,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tthrow new ZWaveError(\n\t\t\t\t\t\t\t`An $import specifier cannot start with ~/ when no root directory is defined!${\n\t\t\t\t\t\t\t\tgetImportStack(\n\t\t\t\t\t\t\t\t\tvisited,\n\t\t\t\t\t\t\t\t\tselector,\n\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t}`,\n\t\t\t\t\t\t\tZWaveErrorCodes.Config_Invalid,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tnewFilename = path.join(\n\t\t\t\t\t\tpath.dirname(filename),\n\t\t\t\t\t\timportFilename,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tnewFilename = filename;\n\t\t\t}\n\n\t\t\t// const importFilename = path.join(path.dirname(filename), val);\n\t\t\tconst imported = await readJsonWithTemplateInternal(\n\t\t\t\tnewFilename,\n\t\t\t\tselector,\n\t\t\t\tvisited,\n\t\t\t\tfileCache,\n\t\t\t\trootDirs,\n\t\t\t);\n\t\t\tObject.assign(ret, imported);\n\t\t} else if (isObject(val)) {\n\t\t\t// We're looking at an object, recurse into it\n\t\t\tret[prop] = await resolveJsonImports(\n\t\t\t\tval,\n\t\t\t\tfilename,\n\t\t\t\tvisited,\n\t\t\t\tfileCache,\n\t\t\t\trootDirs,\n\t\t\t);\n\t\t} else if (isArray(val)) {\n\t\t\t// We're looking at an array, check if there are objects we need to recurse into\n\t\t\tconst vals: unknown[] = [];\n\t\t\tfor (const v of val) {\n\t\t\t\tif (isObject(v)) {\n\t\t\t\t\tvals.push(\n\t\t\t\t\t\tawait resolveJsonImports(\n\t\t\t\t\t\t\tv,\n\t\t\t\t\t\t\tfilename,\n\t\t\t\t\t\t\tvisited,\n\t\t\t\t\t\t\tfileCache,\n\t\t\t\t\t\t\trootDirs,\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t} else {\n\t\t\t\t\tvals.push(v);\n\t\t\t\t}\n\t\t\t}\n\t\t\tret[prop] = vals;\n\t\t} else {\n\t\t\tret[prop] = val;\n\t\t}\n\t}\n\treturn ret;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;AAAA,kBAA4C;AAC5C,oBAA2B;AAC3B,IAAAA,eAAgC;AAChC,wBAAkC;AAClC,mBAAkB;AAClB,sBAAe;AACf,WAAsB;AAEtB,MAAM,aAAa;AACnB,MAAM,uBACL;AAOD,MAAM,gBAA2B,oBAAI,IAAG;AAClC,SAAU,qBAAkB;AACjC,gBAAc,MAAK;AACpB;AAGA,eAAsB,qBACrB,UACA,UAA4B;AAE5B,MAAI,CAAE,UAAM,0BAAW,QAAQ,GAAI;AAClC,UAAM,IAAI,uBACT,8BAA8B,QAAQ,gBACtC,4BAAgB,eAAe;EAEjC;AAEA,MAAI,OAAO,aAAa;AAAU,eAAW,CAAC,QAAQ;AAGtD,QAAM,YAAY,IAAI,IAAI,aAAa;AACvC,QAAM,MAAM,MAAM,6BACjB,UACA,QACA,CAAA,GACA,WACA,QAAQ;AAIT,aAAW,CAACC,WAAU,MAAM,KAAK,WAAW;AAC3C,QAAI,sBAAsB,KAAKA,SAAQ,GAAG;AACzC,oBAAc,IAAIA,WAAU,MAAM;IACnC;EACD;AAEA,SAAO;AACR;AAEA,SAAS,sBACR,KACA,QAAe;AAEf,MAAI,OAAO,QAAQ,UAAU;AAC5B,UAAM,IAAI,uBACT,4BAA4B,OAAO,GAAG,CAAC,IACtC,UAAU,SAAY,YAAY,MAAM,KAAK,EAC9C,IACA,4BAAgB,cAAc;EAEhC;AACA,MAAI,CAAC,qBAAqB,KAAK,GAAG,GAAG;AACpC,UAAM,IAAI,uBACT,qBAAqB,GAAG,gBACvB,UAAU,SAAY,YAAY,MAAM,KAAK,EAC9C,IACA,4BAAgB,cAAc;EAEhC;AACD;AAEA,SAAS,mBAAmB,UAAkB,UAAiB;AAC9D,MAAI,MAAM;AACV,MAAI;AAAU,WAAO,IAAI,QAAQ;AACjC,SAAO;AACR;AAEA,SAAS,OACR,KACA,UAAgB;AAEhB,MAAI,MAA+B;AACnC,QAAM,gBAAgB,SAAS,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3D,aAAW,QAAQ,eAAe;AAEjC,YAAI,2BAAQ,GAAG,GAAG;AACjB,YAAM,OAAO,IAAI,KAChB,CAAC,UAAM,4BAAS,CAAC,KAAK,OAAO,KAAK,EAAE,GAAG,MAAM,IAAI;AAElD,UAAI,QAAQ,QAAW;AAEtB,cAAM,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,KAAI,IAAK;AAC9B,cAAM;AACN;MACD;IACD;AAEA,UAAO,IAAY,IAAI;EACxB;AACA,MAAI,KAAC,4BAAS,GAAG,GAAG;AACnB,UAAM,IAAI,uBACT,sBAAsB,QAAQ,uBAC9B,4BAAgB,cAAc;EAEhC;AACA,SAAO;AACR;AAEA,SAAS,eACR,SACA,UAA4B;AAE5B,QAAM,SAAS,CAAC,GAAG,SAAS,WAAW,IAAI,QAAQ,KAAK,MAAS,EAC/D,QAAO,EACP,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACnB,MAAI,OAAO,SAAS,GAAG;AACtB,WAAO;gBAAmB,OAAO,IAAI,CAAC,MAAM;OAAU,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;EACpE;AACA,SAAO;AACR;AAEA,eAAe,6BACd,UACA,UACA,SACA,WACA,UAAmB;AAEnB,aAAW,KAAK,UAAU,QAAQ;AAGlC,MAAI,UAAU;AACb,UAAM,qBAAqB,SAAS,MAAM,CAAC,YAAW;AACrD,YAAM,iBAAiB,KAAK,SAAS,SAAS,QAAQ;AACtD,aAAO,eAAe,WAAW,IAAI;IACtC,CAAC;AAED,QAAI,oBAAoB;AACvB,YAAM,IAAI,uBACT,gCAAgC,QAAQ,wCACvC,SACE,IAAI,CAAC,MAAM;OAAO,CAAC,EAAE,EACrB,KAAK,EAAE,CACV;EACF,eAAe,SAAS,QAAQ,CAAC,IAC/B,4BAAgB,cAAc;IAEhC;EACD;AAEA,QAAM,YAAY,mBAAmB,UAAU,QAAQ;AACvD,MAAI,QAAQ,SAAS,SAAS,GAAG;AAChC,UAAM,MAAM,qCACX;MACC,GAAG;MACH;MACC,KAAK,MAAM,CACd;;AAEA,UAAM,IAAI,uBAAW,KAAK,4BAAgB,qBAAqB;EAChE;AAEA,MAAI;AACJ,MAAI,UAAU,IAAI,QAAQ,GAAG;AAC5B,WAAO,UAAU,IAAI,QAAQ;EAC9B,OAAO;AACN,QAAI;AACH,YAAM,cAAc,MAAM,gBAAAC,QAAG,SAAS,UAAU,MAAM;AACtD,aAAO,aAAAC,QAAM,MAAM,WAAW;AAC9B,gBAAU,IAAI,UAAU,IAAI;IAC7B,SAAS,GAAG;AACX,YAAM,IAAI,uBACT,+BAA+B,QAAQ,SACtC,8BACC,CAAC,CAEH,GAAG,eAAe,SAAS,QAAQ,CAAC,IACpC,4BAAgB,cAAc;IAEhC;EACD;AAEA,SAAO,mBACN,WAAW,OAAO,MAAM,QAAQ,IAAI,MACpC,UACA,CAAC,GAAG,SAAS,SAAS,GACtB,WACA,QAAQ;AAEV;AAGA,eAAe,mBACd,MACA,UACA,SACA,WACA,UAAmB;AAEnB,QAAM,MAA+B,CAAA;AAErC,aAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,SAAS,YAAY;AAExB,4BAAsB,KAAK,QAAQ,KAAK,MAAM,CAAC;AAC/C,YAAM,EAAE,UAAU,gBAAgB,SAAQ,IAAK,qBAC7C,KAAK,GAAG,EAAG;AAGb,UAAI;AACJ,UAAI,gBAAgB;AACnB,YAAI,eAAe,WAAW,IAAI,GAAG;AAGpC,cAAI,UAAU;AACb,uBAAW,WAAW,UAAU;AAC/B,4BAAc,KAAK,KAClB,SACA,eAAe,MAAM,CAAC,CAAC;AAExB,kBAAI,UAAM,0BAAW,WAAW,GAAG;AAClC;cACD,OAAO;AAEN,8BAAc;cACf;YACD;AAEA,gBAAI,CAAC,aAAa;AACjB,oBAAM,IAAI,uBACT,sCACC,eAAe,MACd,CAAC,CAEH,oCACC,SACE,IAAI,CAAC,MAAM;OAAO,CAAC,EAAE,EACrB,KAAK,EAAE,CACV;EACC,eACC,SACA,QAAQ,CAEV,IACA,4BAAgB,cAAc;YAEhC;UACD,OAAO;AACN,kBAAM,IAAI,uBACT,+EACC,eACC,SACA,QAAQ,CAEV,IACA,4BAAgB,cAAc;UAEhC;QACD,OAAO;AACN,wBAAc,KAAK,KAClB,KAAK,QAAQ,QAAQ,GACrB,cAAc;QAEhB;MACD,OAAO;AACN,sBAAc;MACf;AAGA,YAAM,WAAW,MAAM,6BACtB,aACA,UACA,SACA,WACA,QAAQ;AAET,aAAO,OAAO,KAAK,QAAQ;IAC5B,eAAW,4BAAS,GAAG,GAAG;AAEzB,UAAI,IAAI,IAAI,MAAM,mBACjB,KACA,UACA,SACA,WACA,QAAQ;IAEV,eAAW,2BAAQ,GAAG,GAAG;AAExB,YAAM,OAAkB,CAAA;AACxB,iBAAW,KAAK,KAAK;AACpB,gBAAI,4BAAS,CAAC,GAAG;AAChB,eAAK,KACJ,MAAM,mBACL,GACA,UACA,SACA,WACA,QAAQ,CACR;QAEH,OAAO;AACN,eAAK,KAAK,CAAC;QACZ;MACD;AACA,UAAI,IAAI,IAAI;IACb,OAAO;AACN,UAAI,IAAI,IAAI;IACb;EACD;AACA,SAAO;AACR;",
+  "names": ["import_safe", "filename", "fs", "JSON5"]
+}

package/build/{Logger.d.ts → cjs/Logger.d.ts}

@@ -1,5 +1,5 @@
 import { type ZWaveLogContainer, ZWaveLoggerBase } from "@zwave-js/core";
-import { type ConfigLogContext } from "./Logger_safe";
+import { type ConfigLogContext } from "./Logger_safe.js";
 export declare class ConfigLogger extends ZWaveLoggerBase<ConfigLogContext> {
     constructor(loggers: ZWaveLogContainer);
     /**

package/build/cjs/Logger.js

@@ -0,0 +1,50 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Logger_exports = {};
+__export(Logger_exports, {
+  ConfigLogger: () => ConfigLogger
+});
+module.exports = __toCommonJS(Logger_exports);
+var import_core = require("@zwave-js/core");
+var import_Logger_safe = require("./Logger_safe.js");
+class ConfigLogger extends import_core.ZWaveLoggerBase {
+  constructor(loggers) {
+    super(loggers, import_Logger_safe.CONFIG_LABEL);
+  }
+  /**
+   * Logs a message
+   * @param msg The message to output
+   */
+  print(message, level) {
+    const actualLevel = level || import_Logger_safe.CONFIG_LOGLEVEL;
+    if (!this.container.isLoglevelVisible(actualLevel))
+      return;
+    this.logger.log({
+      level: actualLevel,
+      message,
+      direction: (0, import_core.getDirectionPrefix)("none"),
+      context: { source: "config" }
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigLogger
+});
+//# sourceMappingURL=Logger.js.map

package/build/cjs/Logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/Logger.ts"],
+  "sourcesContent": ["import {\n\ttype ZWaveLogContainer,\n\tZWaveLoggerBase,\n\tgetDirectionPrefix,\n} from \"@zwave-js/core\";\nimport {\n\tCONFIG_LABEL,\n\tCONFIG_LOGLEVEL,\n\ttype ConfigLogContext,\n} from \"./Logger_safe.js\";\n\nexport class ConfigLogger extends ZWaveLoggerBase<ConfigLogContext> {\n\tconstructor(loggers: ZWaveLogContainer) {\n\t\tsuper(loggers, CONFIG_LABEL);\n\t}\n\n\t/**\n\t * Logs a message\n\t * @param msg The message to output\n\t */\n\tpublic print(\n\t\tmessage: string,\n\t\tlevel?: \"debug\" | \"verbose\" | \"warn\" | \"error\" | \"info\",\n\t): void {\n\t\tconst actualLevel = level || CONFIG_LOGLEVEL;\n\t\tif (!this.container.isLoglevelVisible(actualLevel)) return;\n\n\t\tthis.logger.log({\n\t\t\tlevel: actualLevel,\n\t\t\tmessage,\n\t\t\tdirection: getDirectionPrefix(\"none\"),\n\t\t\tcontext: { source: \"config\" },\n\t\t});\n\t}\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;;;;;AAAA,kBAIO;AACP,yBAIO;AAED,MAAO,qBAAqB,4BAAiC;EAClE,YAAY,SAA0B;AACrC,UAAM,SAAS,+BAAY;EAC5B;;;;;EAMO,MACN,SACA,OAAuD;AAEvD,UAAM,cAAc,SAAS;AAC7B,QAAI,CAAC,KAAK,UAAU,kBAAkB,WAAW;AAAG;AAEpD,SAAK,OAAO,IAAI;MACf,OAAO;MACP;MACA,eAAW,gCAAmB,MAAM;MACpC,SAAS,EAAE,QAAQ,SAAQ;KAC3B;EACF;;",
+  "names": []
+}

package/build/cjs/Logger_safe.js

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Logger_safe_exports = {};
+__export(Logger_safe_exports, {
+  CONFIG_LABEL: () => CONFIG_LABEL,
+  CONFIG_LOGLEVEL: () => CONFIG_LOGLEVEL
+});
+module.exports = __toCommonJS(Logger_safe_exports);
+const CONFIG_LABEL = "CONFIG";
+const CONFIG_LOGLEVEL = "debug";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CONFIG_LABEL,
+  CONFIG_LOGLEVEL
+});
+//# sourceMappingURL=Logger_safe.js.map

package/build/cjs/Logger_safe.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/Logger_safe.ts"],
+  "sourcesContent": ["import type { LogContext } from \"@zwave-js/core/safe\";\n\nexport const CONFIG_LABEL = \"CONFIG\";\nexport const CONFIG_LOGLEVEL = \"debug\";\n\nexport type ConfigLogContext = LogContext<\"config\">;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAEA;;;;;;AAAO,MAAM,eAAe;AACrB,MAAM,kBAAkB;",
+  "names": []
+}