homey-lib 2.49.2 → 2.50.0

package/assets/app/schema.d.ts

@@ -248,7 +248,7 @@ export interface App {
       [k: string]: unknown;
     }[];
     settings?: DriverSettings;
-    firmwareUpdates?: ZigbeeFirmwareUpdates;
+    firmwareUpdates?: ZigbeeFirmwareUpdates | ZwaveFirmwareUpdates;
     gtin?: string | string[];
     matter?: MatterDevice;
     zwave?: ZwaveDevice;
@@ -413,6 +413,41 @@ export interface ZigbeeFirmwareUpdateFile {
   name: string;
   integrity: Integrity;
 }
+export interface ZwaveFirmwareUpdates {
+  wakeInstruction?: I18NObject;
+  reportTimeout?: number;
+  minWaitTime?: number;
+  verifyPostUpdateWithNop?: false;
+  nopRetryInterval?: number;
+  nopMaxRetries?: number;
+  /**
+   * @minItems 1
+   */
+  updates: [ZwaveFirmwareUpdate, ...ZwaveFirmwareUpdate[]];
+}
+export interface ZwaveFirmwareUpdate {
+  version: string;
+  changelog: I18NObject;
+  applicableTo?: string;
+  device: ZwaveFirmwareUpdateDevice;
+  /**
+   * @minItems 1
+   */
+  files: [ZwaveFirmwareUpdateFile, ...ZwaveFirmwareUpdateFile[]];
+}
+export interface ZwaveFirmwareUpdateDevice {
+  manufacturerId: number | number[];
+  productId: number | number[];
+  productTypeId: number | number[];
+  hardwareVersion?: number | number[];
+}
+export interface ZwaveFirmwareUpdateFile {
+  region?: string;
+  targetId: number;
+  name: string;
+  size: number;
+  integrity: Integrity;
+}
 export interface MatterDevice {
   vendorId: number | number[];
   productId: number | number[];

package/assets/app/schema.json

@@ -164,6 +164,146 @@
         }
       }
     },
+    "zwave-firmware-update-device": {
+      "type": "object",
+      "required": ["manufacturerId", "productTypeId", "productId"],
+      "additionalProperties": false,
+      "properties": {
+        "manufacturerId": {
+          "oneOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "number"
+              }
+            }
+          ]
+        },
+        "productId": {
+          "oneOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "number"
+              }
+            }
+          ]
+        },
+        "productTypeId": {
+          "oneOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "number"
+              }
+            }
+          ]
+        },
+        "hardwareVersion": {
+          "oneOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "number"
+              }
+            }
+          ]
+        }
+      }
+    },
+    "zwave-firmware-update-file": {
+      "type": "object",
+      "required": ["targetId", "name", "size", "integrity"],
+      "additionalProperties": false,
+      "properties": {
+        "region": {
+          "type": "string"
+        },
+        "targetId": {
+          "type": "number"
+        },
+        "name": {
+          "type": "string"
+        },
+        "size": {
+          "type": "number"
+        },
+        "integrity": {
+          "$ref": "#/definitions/integrity"
+        }
+      }
+    },
+    "zwave-firmware-update": {
+      "type": "object",
+      "required": ["version", "changelog", "device", "files"],
+      "additionalProperties": false,
+      "properties": {
+        "version": {
+          "type": "string"
+        },
+        "changelog": {
+          "$ref": "#/definitions/i18nObject"
+        },
+        "applicableTo": {
+          "type": "string"
+        },
+        "device": {
+          "$ref": "#/definitions/zwave-firmware-update-device"
+        },
+        "files": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/definitions/zwave-firmware-update-file"
+          }
+        }
+      }
+    },
+    "zwave-firmware-updates": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["updates"],
+      "properties": {
+        "wakeInstruction": {
+          "$ref": "#/definitions/i18nObject"
+        },
+        "reportTimeout": {
+          "type": "number"
+        },
+        "minWaitTime": {
+          "type": "number"
+        },
+        "verifyPostUpdateWithNop": {
+          "type": "boolean",
+          "enum": [false]
+        },
+        "nopRetryInterval": {
+          "type": "number"
+        },
+        "nopMaxRetries": {
+          "type": "number"
+        },
+        "updates": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/definitions/zwave-firmware-update"
+          }
+        }
+      }
+    },
     "author": {
       "required": ["name"],
       "properties": {
@@ -1460,6 +1600,9 @@
             "oneOf": [
               {
                 "$ref": "#/definitions/zigbee-firmware-updates"
+              },
+              {
+                "$ref": "#/definitions/zwave-firmware-updates"
               }
             ]
           },

package/helpers/index.js

@@ -40,11 +40,11 @@ try {
 }
 
 function toArray(value) {
-  if (value) {
+  if (value !== undefined && value !== null) {
     return Array.isArray(value) ? value : [value];
   }
 
   return [];
 }
 
-module.exports.toArray = toArray;
+module.exports.toArray = toArray;

package/index.js

@@ -48,3 +48,4 @@ module.exports.getBatteries = Energy.getBatteries.bind(Energy);
 /** @typedef {import('./assets/app/schema').App} AppManifest */
 /** @typedef {import('./assets/capability/schema').Capability} CapabilityDefinition */
 /** @typedef {import('./assets/app/schema').ZigbeeFirmwareUpdates} ZigbeeFirmwareUpdates */
+/** @typedef {import('./assets/app/schema').ZwaveFirmwareUpdates} ZwaveFirmwareUpdates */

package/lib/App/index.js

@@ -642,15 +642,11 @@ class App {
 
         // Validate driver.firmwareUpdates
         if (driver.firmwareUpdates && Array.isArray(driver.firmwareUpdates.updates)) {
-          // TODO: Remove when we want to roll out firmware updates.
-          if (level !== 'debug') {
-            throw new Error(`drivers.${driver.id} firmwareUpdates can only be included in debug mode validation.`);
-          }
-
           const isZigbeeDriver = typeof driver.zigbee === 'object' && driver.zigbee !== null;
+          const isZwaveDriver = typeof driver.zwave === 'object' && driver.zwave !== null;
 
-          if (!isZigbeeDriver) {
-            throw new Error(`drivers.${driver.id} firmwareUpdates are only supported for Zigbee drivers (missing driver.zigbee)`);
+          if (!isZigbeeDriver && !isZwaveDriver) {
+            throw new Error(`drivers.${driver.id} firmwareUpdates are only supported for Zigbee and Zwave drivers (missing driver.zigbee or driver.zwave)`);
           }
 
           for (const [updateIndex, update] of Object.entries(driver.firmwareUpdates.updates)) {
@@ -688,6 +684,44 @@ class App {
               }
             }
 
+            if (isZwaveDriver) {
+              if (!semver.valid(update.version)) {
+                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}].version is not a valid semver version`);
+              }
+
+              if (update.applicableTo !== undefined && !semver.validRange(update.applicableTo)) {
+                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}].applicableTo is not a valid semver range`);
+              }
+
+              const driverManufacturerIds = toArray(driver.zwave.manufacturerId);
+              const driverProductTypeIds = toArray(driver.zwave.productTypeId);
+              const driverProductIds = toArray(driver.zwave.productId);
+
+              const updateManufacturerIds = toArray(update.device.manufacturerId);
+              const updateProductTypeIds = toArray(update.device.productTypeId);
+              const updateProductIds = toArray(update.device.productId);
+
+              if (updateManufacturerIds.length === 0 || updateProductTypeIds.length === 0 || updateProductIds.length === 0) {
+                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}] must include at least one manufacturerId, productTypeId and productId`);
+              }
+
+              const hasMismatchedManufacturerId = updateManufacturerIds.some(id => !driverManufacturerIds.includes(id));
+              const hasMismatchedProductTypeId = updateProductTypeIds.some(id => !driverProductTypeIds.includes(id));
+              const hasMismatchedProductId = updateProductIds.some(id => !driverProductIds.includes(id));
+
+              if (hasMismatchedManufacturerId) {
+                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}] has a manufacturerId that does not match the driver zwave.manufacturerId`);
+              }
+
+              if (hasMismatchedProductTypeId) {
+                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}] has a productTypeId that does not match the driver zwave.productTypeId`);
+              }
+
+              if (hasMismatchedProductId) {
+                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}] has a productId that does not match the driver zwave.productId`);
+              }
+            }
+
             const seenFiles = new Set();
 
             for (const [fileIndex, file] of Object.entries(update.files)) {
@@ -717,9 +751,31 @@ class App {
                 }
               }
 
-              const fileId = `${file.manufacturerCode}-${file.imageType}-${file.fileVersion}`;
+              // Note: Util.validateZigbeeOTAHeader already checks the file size for zigbee firmware files.
+              // Note: Z-Wave doesn't have a standard header or file type, so nothing we validate about the file itself.
+              if (isZwaveDriver) {
+                const { size: actualSize } = await statAsync(filePath);
+                if (actualSize !== file.size) {
+                  throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}].files[${fileIndex}] size mismatch: expected ${file.size}, got ${actualSize}`);
+                }
+              }
+
+              let fileId = null;
+              
+              if (Util.isZigbeeFirmwareUpdateFile(file)) {
+                fileId = `${file.manufacturerCode}-${file.imageType}-${file.fileVersion}`;
+              } else if (Util.isZwaveFirmwareUpdateFile(file)) {
+                fileId = `${file.targetId}-${file.region ? file.region : 'global'}`;
+              } else {
+                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}].files[${fileIndex}] invalid file schema`);
+              }
+
               if (seenFiles.has(fileId)) {
-                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}] has multiple files with the same manufacturerCode, imageType and fileVersion`);
+                if (isZigbeeDriver) {
+                  throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}] has multiple files with the same manufacturerCode, imageType and fileVersion`);
+                } else {
+                  throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}] has multiple files with the same targetId and region`);
+                }
               }
               seenFiles.add(fileId);
             }

package/lib/Util/index.js

@@ -3,6 +3,11 @@
 const fileUtils = require('./file');
 const zigbeeUtils = require('./zigbee');
 
+/** @typedef {import('../../assets/app/schema').ZigbeeFirmwareUpdates} ZigbeeFirmwareUpdates */
+/** @typedef {import('../../assets/app/schema').ZwaveFirmwareUpdates} ZwaveFirmwareUpdates */
+/** @typedef {import('../../assets/app/schema').ZigbeeFirmwareUpdateFile} ZigbeeFirmwareUpdateFile */
+/** @typedef {import('../../assets/app/schema').ZwaveFirmwareUpdateFile} ZwaveFirmwareUpdateFile */
+
 class Util {
 
   /**
@@ -82,6 +87,60 @@ class Util {
     return fileUtils.getOTAFilePath({ appPath, driverId, fileName });
   }
 
+  /**
+   * @param {ZigbeeFirmwareUpdateFile | ZwaveFirmwareUpdateFile} firmwareFile
+   * @return {firmwareFile is ZigbeeFirmwareUpdateFile}
+   */
+  static isZigbeeFirmwareUpdateFile(firmwareFile) {
+    return 'manufacturerCode' in firmwareFile;
+  }
+
+  /**
+   * @param {ZigbeeFirmwareUpdateFile | ZwaveFirmwareUpdateFile} firmwareFile
+   * @return {firmwareFile is ZwaveFirmwareUpdateFile}
+   */
+  static isZwaveFirmwareUpdateFile(firmwareFile) {
+    return 'targetId' in firmwareFile;
+  }
+
+  /**
+   * @param {ZigbeeFirmwareUpdates['updates'][number] | ZwaveFirmwareUpdates['updates'][number]} driverFirmwareUpdatesUpdate
+   * @return {driverFirmwareUpdatesUpdate is ZigbeeFirmwareUpdates['updates'][number]}
+   */
+  static isZigbeeFirmwareUpdate(driverFirmwareUpdatesUpdate) {
+    if (!Array.isArray(driverFirmwareUpdatesUpdate.files) || driverFirmwareUpdatesUpdate.files.length === 0) return false;
+    return Util.isZigbeeFirmwareUpdateFile(driverFirmwareUpdatesUpdate.files[0]);
+  }
+
+  /**
+   * @param {ZigbeeFirmwareUpdates['updates'][number] | ZwaveFirmwareUpdates['updates'][number]} driverFirmwareUpdatesUpdate
+   * @return {driverFirmwareUpdatesUpdate is ZwaveFirmwareUpdates['updates'][number]}
+   */
+  static isZwaveFirmwareUpdate(driverFirmwareUpdatesUpdate) {
+    if (!Array.isArray(driverFirmwareUpdatesUpdate.files) || driverFirmwareUpdatesUpdate.files.length === 0) return false;
+    return Util.isZwaveFirmwareUpdateFile(driverFirmwareUpdatesUpdate.files[0]);
+  }
+
+  /**
+   * @param {ZigbeeFirmwareUpdates | ZwaveFirmwareUpdates} driverFirmwareUpdates
+   * @returns {driverFirmwareUpdates is ZigbeeFirmwareUpdates}
+   */
+  static isZigbeeFirmwareUpdates(driverFirmwareUpdates) {
+    if (!driverFirmwareUpdates) return false;
+    if (!Array.isArray(driverFirmwareUpdates.updates) || driverFirmwareUpdates.updates.length === 0) return false;
+    return Util.isZigbeeFirmwareUpdate(driverFirmwareUpdates.updates[0]);
+  }
+
+  /**
+   * @param {ZigbeeFirmwareUpdates | ZwaveFirmwareUpdates} driverFirmwareUpdates
+   * @returns {driverFirmwareUpdates is ZwaveFirmwareUpdates}
+   */
+  static isZwaveFirmwareUpdates(driverFirmwareUpdates) {
+    if (!driverFirmwareUpdates) return false;
+    if (!Array.isArray(driverFirmwareUpdates.updates) || driverFirmwareUpdates.updates.length === 0) return false;
+    return Util.isZwaveFirmwareUpdate(driverFirmwareUpdates.updates[0]);
+  }
+
 }
 
 Util.FEATURE_SPEAKER = 'speaker';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homey-lib",
-  "version": "2.49.2",
+  "version": "2.50.0",
   "description": "Shared Library for Homey",
   "types": "types/index.d.ts",
   "main": "index.js",

package/types/assets/app/schema.d.ts

@@ -248,7 +248,7 @@ export interface App {
       [k: string]: unknown;
     }[];
     settings?: DriverSettings;
-    firmwareUpdates?: ZigbeeFirmwareUpdates;
+    firmwareUpdates?: ZigbeeFirmwareUpdates | ZwaveFirmwareUpdates;
     gtin?: string | string[];
     matter?: MatterDevice;
     zwave?: ZwaveDevice;
@@ -413,6 +413,41 @@ export interface ZigbeeFirmwareUpdateFile {
   name: string;
   integrity: Integrity;
 }
+export interface ZwaveFirmwareUpdates {
+  wakeInstruction?: I18NObject;
+  reportTimeout?: number;
+  minWaitTime?: number;
+  verifyPostUpdateWithNop?: false;
+  nopRetryInterval?: number;
+  nopMaxRetries?: number;
+  /**
+   * @minItems 1
+   */
+  updates: [ZwaveFirmwareUpdate, ...ZwaveFirmwareUpdate[]];
+}
+export interface ZwaveFirmwareUpdate {
+  version: string;
+  changelog: I18NObject;
+  applicableTo?: string;
+  device: ZwaveFirmwareUpdateDevice;
+  /**
+   * @minItems 1
+   */
+  files: [ZwaveFirmwareUpdateFile, ...ZwaveFirmwareUpdateFile[]];
+}
+export interface ZwaveFirmwareUpdateDevice {
+  manufacturerId: number | number[];
+  productId: number | number[];
+  productTypeId: number | number[];
+  hardwareVersion?: number | number[];
+}
+export interface ZwaveFirmwareUpdateFile {
+  region?: string;
+  targetId: number;
+  name: string;
+  size: number;
+  integrity: Integrity;
+}
 export interface MatterDevice {
   vendorId: number | number[];
   productId: number | number[];

package/types/index.d.ts

@@ -13,6 +13,7 @@ export const getBatteries: typeof Energy.getBatteries;
 export type AppManifest = import("./assets/app/schema").App;
 export type CapabilityDefinition = import("./assets/capability/schema").Capability;
 export type ZigbeeFirmwareUpdates = import("./assets/app/schema").ZigbeeFirmwareUpdates;
+export type ZwaveFirmwareUpdates = import("./assets/app/schema").ZwaveFirmwareUpdates;
 import App = require("./lib/App");
 import Capability = require("./lib/Capability");
 import Device = require("./lib/Device");

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":"+BAkBW,OAAO,MAAM,CAAC,UAAU;6BAExB,OAAO,MAAM,CAAC,QAAQ;8BAGtB,OAAO,UAAU,CAAC,eAAe;4BAEjC,OAAO,UAAU,CAAC,aAAa;4BAE/B,OAAO,UAAU,CAAC,aAAa;4BAG/B,OAAO,GAAG,CAAC,UAAU;+BAErB,OAAO,GAAG,CAAC,aAAa;gCAExB,OAAO,GAAG,CAAC,cAAc;+BAEzB,OAAO,GAAG,CAAC,aAAa;6BAGxB,OAAO,KAAK,CAAC,SAAS;4BAGtB,OAAO,MAAM,CAAC,aAAa;2BAE3B,OAAO,MAAM,CAAC,YAAY;0BAGvB,OAAO,qBAAqB,EAAE,GAAG;mCACjC,OAAO,4BAA4B,EAAE,UAAU;oCAC/C,OAAO,qBAAqB,EAAE,qBAAqB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":"+BAkBW,OAAO,MAAM,CAAC,UAAU;6BAExB,OAAO,MAAM,CAAC,QAAQ;8BAGtB,OAAO,UAAU,CAAC,eAAe;4BAEjC,OAAO,UAAU,CAAC,aAAa;4BAE/B,OAAO,UAAU,CAAC,aAAa;4BAG/B,OAAO,GAAG,CAAC,UAAU;+BAErB,OAAO,GAAG,CAAC,aAAa;gCAExB,OAAO,GAAG,CAAC,cAAc;+BAEzB,OAAO,GAAG,CAAC,aAAa;6BAGxB,OAAO,KAAK,CAAC,SAAS;4BAGtB,OAAO,MAAM,CAAC,aAAa;2BAE3B,OAAO,MAAM,CAAC,YAAY;0BAGvB,OAAO,qBAAqB,EAAE,GAAG;mCACjC,OAAO,4BAA4B,EAAE,UAAU;oCAC/C,OAAO,qBAAqB,EAAE,qBAAqB;mCACnD,OAAO,qBAAqB,EAAE,oBAAoB"}

package/types/lib/App/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/App/index.js"],"names":[],"mappings":";AA8EA;IACE,2CAAqD;IACrD,2CAAmD;IAmyBnD;;;OAGG;IACH,sCAHW,WAAW,GACT,IAAI,CAOhB;IA4PD;;;;;OAKG;IACH,4CALW,MAAM,QACN;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,aAClB,MAAM,GACJ,IAAI,CAkChB;IAiBD;;;OAGG;IACH,wBAHW,MAAM,GACJ,OAAO,CAQnB;IAED;;;OAGG;IACH,gCAHW,MAAM,GACJ,OAAO,CAInB;IAED;;OAEG;IACH,wBAFa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMnC;IAED;;OAEG;IACH,yBAFa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAcnD;IAED;;OAEG;IACH,wBAFa,MAAM,EAAE,CAIpB;IAED;;OAEG;IACH,qBAFa,MAAM,EAAE,CAKpB;IAED;;;OAGG;IACH,4BAHW,MAAM,GACJ,MAAM,CAuBlB;IAED;;;;OAIG;IACH,0BAJW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,WAC1C,WAAW,GACT,MAAM,GAAG,IAAI,CAyDzB;IAjvCD;;OAEG;IACH,kBAFW,MAAM,EAQhB;IALC,cAAiB;IAOnB;;;OAGG;IACH,eAHc,OAAO,EAAA,GACR,IAAI,CAKhB;IAED;;;OAGG;IACH,6BAHW;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CAywBzB;IAnwBC,gBAAmB;IAgxBrB;;;;OAIG;IACH,uCAJW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACvB;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACZ,IAAI,CAwBhB;IAED;;;;OAIG;IACH,8BAJW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,WAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACxC,IAAI,CAuBhB;IAED;;;OAGG;IACH,gCAHW,MAAM,GACJ,OAAO,CAAC,MAAM,EAAE,CAAC,CAY7B;IAED;;;OAGG;IACH,yCAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAOzB;IAED;;;OAGG;IACH,mCAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAe5B;IAED;;;;;OAKG;IACH,2BALW;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,QAChC,KAAK,GAAG,QAAQ,cAChB,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CA6BzB;IAED;;OAEG;IACH,oBAFa,OAAO,CAAC,IAAI,CAAC,CAuBzB;IAED;;;;;;OAMG;IACH,wBANW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aACvB,MAAM,WACN,WAAW,mCACX;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,GAC/C,IAAI,CA+EhB;IA0CD;;;;OAIG;IACH,qBAJW,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAU3B;CAwJF;;;;mBAnyCa,OAAO,yBAAyB,EAAE,GAAG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/App/index.js"],"names":[],"mappings":";AA8EA;IACE,2CAAqD;IACrD,2CAAmD;IA21BnD;;;OAGG;IACH,sCAHW,WAAW,GACT,IAAI,CAOhB;IA4PD;;;;;OAKG;IACH,4CALW,MAAM,QACN;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,aAClB,MAAM,GACJ,IAAI,CAkChB;IAiBD;;;OAGG;IACH,wBAHW,MAAM,GACJ,OAAO,CAQnB;IAED;;;OAGG;IACH,gCAHW,MAAM,GACJ,OAAO,CAInB;IAED;;OAEG;IACH,wBAFa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMnC;IAED;;OAEG;IACH,yBAFa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAcnD;IAED;;OAEG;IACH,wBAFa,MAAM,EAAE,CAIpB;IAED;;OAEG;IACH,qBAFa,MAAM,EAAE,CAKpB;IAED;;;OAGG;IACH,4BAHW,MAAM,GACJ,MAAM,CAuBlB;IAED;;;;OAIG;IACH,0BAJW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,WAC1C,WAAW,GACT,MAAM,GAAG,IAAI,CAyDzB;IAzyCD;;OAEG;IACH,kBAFW,MAAM,EAQhB;IALC,cAAiB;IAOnB;;;OAGG;IACH,eAHc,OAAO,EAAA,GACR,IAAI,CAKhB;IAED;;;OAGG;IACH,6BAHW;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CAi0BzB;IA3zBC,gBAAmB;IAw0BrB;;;;OAIG;IACH,uCAJW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACvB;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACZ,IAAI,CAwBhB;IAED;;;;OAIG;IACH,8BAJW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,WAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACxC,IAAI,CAuBhB;IAED;;;OAGG;IACH,gCAHW,MAAM,GACJ,OAAO,CAAC,MAAM,EAAE,CAAC,CAY7B;IAED;;;OAGG;IACH,yCAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAOzB;IAED;;;OAGG;IACH,mCAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAe5B;IAED;;;;;OAKG;IACH,2BALW;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,QAChC,KAAK,GAAG,QAAQ,cAChB,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CA6BzB;IAED;;OAEG;IACH,oBAFa,OAAO,CAAC,IAAI,CAAC,CAuBzB;IAED;;;;;;OAMG;IACH,wBANW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aACvB,MAAM,WACN,WAAW,mCACX;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,GAC/C,IAAI,CA+EhB;IA0CD;;;;OAIG;IACH,qBAJW,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAU3B;CAwJF;;;;mBA31Ca,OAAO,yBAAyB,EAAE,GAAG"}

package/types/lib/Util/index.d.ts

@@ -1,4 +1,8 @@
 export = Util;
+/** @typedef {import('../../assets/app/schema').ZigbeeFirmwareUpdates} ZigbeeFirmwareUpdates */
+/** @typedef {import('../../assets/app/schema').ZwaveFirmwareUpdates} ZwaveFirmwareUpdates */
+/** @typedef {import('../../assets/app/schema').ZigbeeFirmwareUpdateFile} ZigbeeFirmwareUpdateFile */
+/** @typedef {import('../../assets/app/schema').ZwaveFirmwareUpdateFile} ZwaveFirmwareUpdateFile */
 declare class Util {
     /**
      * @param {string} modelId
@@ -64,13 +68,48 @@ declare class Util {
         driverId: string;
         fileName: string;
     }): string;
+    /**
+     * @param {ZigbeeFirmwareUpdateFile | ZwaveFirmwareUpdateFile} firmwareFile
+     * @return {firmwareFile is ZigbeeFirmwareUpdateFile}
+     */
+    static isZigbeeFirmwareUpdateFile(firmwareFile: ZigbeeFirmwareUpdateFile | ZwaveFirmwareUpdateFile): firmwareFile is ZigbeeFirmwareUpdateFile;
+    /**
+     * @param {ZigbeeFirmwareUpdateFile | ZwaveFirmwareUpdateFile} firmwareFile
+     * @return {firmwareFile is ZwaveFirmwareUpdateFile}
+     */
+    static isZwaveFirmwareUpdateFile(firmwareFile: ZigbeeFirmwareUpdateFile | ZwaveFirmwareUpdateFile): firmwareFile is ZwaveFirmwareUpdateFile;
+    /**
+     * @param {ZigbeeFirmwareUpdates['updates'][number] | ZwaveFirmwareUpdates['updates'][number]} driverFirmwareUpdatesUpdate
+     * @return {driverFirmwareUpdatesUpdate is ZigbeeFirmwareUpdates['updates'][number]}
+     */
+    static isZigbeeFirmwareUpdate(driverFirmwareUpdatesUpdate: ZigbeeFirmwareUpdates["updates"][number] | ZwaveFirmwareUpdates["updates"][number]): driverFirmwareUpdatesUpdate is ZigbeeFirmwareUpdates["updates"][number];
+    /**
+     * @param {ZigbeeFirmwareUpdates['updates'][number] | ZwaveFirmwareUpdates['updates'][number]} driverFirmwareUpdatesUpdate
+     * @return {driverFirmwareUpdatesUpdate is ZwaveFirmwareUpdates['updates'][number]}
+     */
+    static isZwaveFirmwareUpdate(driverFirmwareUpdatesUpdate: ZigbeeFirmwareUpdates["updates"][number] | ZwaveFirmwareUpdates["updates"][number]): driverFirmwareUpdatesUpdate is ZwaveFirmwareUpdates["updates"][number];
+    /**
+     * @param {ZigbeeFirmwareUpdates | ZwaveFirmwareUpdates} driverFirmwareUpdates
+     * @returns {driverFirmwareUpdates is ZigbeeFirmwareUpdates}
+     */
+    static isZigbeeFirmwareUpdates(driverFirmwareUpdates: ZigbeeFirmwareUpdates | ZwaveFirmwareUpdates): driverFirmwareUpdates is ZigbeeFirmwareUpdates;
+    /**
+     * @param {ZigbeeFirmwareUpdates | ZwaveFirmwareUpdates} driverFirmwareUpdates
+     * @returns {driverFirmwareUpdates is ZwaveFirmwareUpdates}
+     */
+    static isZwaveFirmwareUpdates(driverFirmwareUpdates: ZigbeeFirmwareUpdates | ZwaveFirmwareUpdates): driverFirmwareUpdates is ZwaveFirmwareUpdates;
 }
 declare namespace Util {
-    let FEATURE_SPEAKER: string;
-    let FEATURE_LED_RING: string;
-    let FEATURE_NFC: string;
-    let FEATURE_MATTER: string;
-    let FEATURE_CAMERA_STREAMING: string;
-    let _platformLocalFeatures: Record<string, string[]>;
+    export { FEATURE_SPEAKER, FEATURE_LED_RING, FEATURE_NFC, FEATURE_MATTER, FEATURE_CAMERA_STREAMING, _platformLocalFeatures, ZigbeeFirmwareUpdates, ZwaveFirmwareUpdates, ZigbeeFirmwareUpdateFile, ZwaveFirmwareUpdateFile };
 }
+declare var FEATURE_SPEAKER: string;
+declare var FEATURE_LED_RING: string;
+declare var FEATURE_NFC: string;
+declare var FEATURE_MATTER: string;
+declare var FEATURE_CAMERA_STREAMING: string;
+declare var _platformLocalFeatures: Record<string, string[]>;
+type ZigbeeFirmwareUpdates = import("../../assets/app/schema").ZigbeeFirmwareUpdates;
+type ZwaveFirmwareUpdates = import("../../assets/app/schema").ZwaveFirmwareUpdates;
+type ZigbeeFirmwareUpdateFile = import("../../assets/app/schema").ZigbeeFirmwareUpdateFile;
+type ZwaveFirmwareUpdateFile = import("../../assets/app/schema").ZwaveFirmwareUpdateFile;
 //# sourceMappingURL=index.d.ts.map

package/types/lib/Util/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/Util/index.js"],"names":[],"mappings":";AAKA;IAEE;;;OAGG;IACH,yCAHW,MAAM,GACJ,MAAM,EAAE,CAIpB;IAED;;;;OAIG;IACH,gDAJW,MAAM,kBACN,MAAM,EAAE,GACN,MAAM,EAAE,CAKpB;IAED;;;;;;OAMG;IACH,8BAJW,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAI3B;IAED;;;;;;OAMG;IACH,mCAJW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;;OAKG;IACH,sCAHW,MAAM,GACJ,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC,CAIvD;IAED;;;;;;;;;OASG;IACH,wCANG;QAAwB,QAAQ,EAAxB,MAAM;QACW,gBAAgB,GAAjC,MAAM;QACW,WAAW,GAA5B,MAAM;QACW,SAAS,GAA1B,MAAM;KACd,GAAU,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC,CAIvD;IAED;;;;;;;;OAQG;IACH,uDALG;QAAyB,OAAO,GAAxB,MAAM;QACU,QAAQ,EAAxB,MAAM;QACU,QAAQ,EAAxB,MAAM;KACd,GAAU,MAAM,CAIlB;CAEF;;;;;;;gCAOU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/Util/index.js"],"names":[],"mappings":";AAKA,+FAA+F;AAC/F,6FAA6F;AAC7F,qGAAqG;AACrG,mGAAmG;AAEnG;IAEE;;;OAGG;IACH,yCAHW,MAAM,GACJ,MAAM,EAAE,CAIpB;IAED;;;;OAIG;IACH,gDAJW,MAAM,kBACN,MAAM,EAAE,GACN,MAAM,EAAE,CAKpB;IAED;;;;;;OAMG;IACH,8BAJW,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAI3B;IAED;;;;;;OAMG;IACH,mCAJW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;;OAKG;IACH,sCAHW,MAAM,GACJ,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC,CAIvD;IAED;;;;;;;;;OASG;IACH,wCANG;QAAwB,QAAQ,EAAxB,MAAM;QACW,gBAAgB,GAAjC,MAAM;QACW,WAAW,GAA5B,MAAM;QACW,SAAS,GAA1B,MAAM;KACd,GAAU,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC,CAIvD;IAED;;;;;;;;OAQG;IACH,uDALG;QAAyB,OAAO,GAAxB,MAAM;QACU,QAAQ,EAAxB,MAAM;QACU,QAAQ,EAAxB,MAAM;KACd,GAAU,MAAM,CAIlB;IAED;;;OAGG;IACH,gDAHW,wBAAwB,GAAG,uBAAuB,GACjD,YAAY,IAAI,wBAAwB,CAInD;IAED;;;OAGG;IACH,+CAHW,wBAAwB,GAAG,uBAAuB,GACjD,YAAY,IAAI,uBAAuB,CAIlD;IAED;;;OAGG;IACH,2DAHW,qBAAqB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GACjF,2BAA2B,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAKlF;IAED;;;OAGG;IACH,0DAHW,qBAAqB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GACjF,2BAA2B,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAKjF;IAED;;;OAGG;IACH,sDAHW,qBAAqB,GAAG,oBAAoB,GAC1C,qBAAqB,IAAI,qBAAqB,CAM1D;IAED;;;OAGG;IACH,qDAHW,qBAAqB,GAAG,oBAAoB,GAC1C,qBAAqB,IAAI,oBAAoB,CAMzD;CAEF;;;;;;;;;oCAOU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;6BAjJrB,OAAO,yBAAyB,EAAE,qBAAqB;4BACvD,OAAO,yBAAyB,EAAE,oBAAoB;gCACtD,OAAO,yBAAyB,EAAE,wBAAwB;+BAC1D,OAAO,yBAAyB,EAAE,uBAAuB"}