homey-lib 2.45.3 → 2.46.0

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

@@ -0,0 +1,140 @@
+export = App;
+declare class App {
+    static REQUIRED_PYTHON_PLATFORMS: string[];
+    static SUPPORTED_PYTHON_VERSIONS: string[];
+    /**
+     * @param {AppManifest} appJson
+     * @returns {void}
+     */
+    static validatePythonVersion(appJson: AppManifest): void;
+    /**
+     * @param {string} titleFormatted
+     * @param {{ name: string }[]} args
+     * @param {string} errorPath
+     * @returns {void}
+     */
+    static _checkTitleFormatted(titleFormatted: string, args: {
+        name: string;
+    }[], errorPath: string): void;
+    /**
+     * @param {string} appId
+     * @returns {boolean}
+     */
+    static isValidId(appId: string): boolean;
+    /**
+     * @param {string} color
+     * @returns {boolean}
+     */
+    static isValidBrandColor(color: string): boolean;
+    /**
+     * @returns {Record<string, unknown>}
+     */
+    static getJSONSchema(): Record<string, unknown>;
+    /**
+     * @returns {Record<string, Record<string, unknown>>}
+     */
+    static getPermissions(): Record<string, Record<string, unknown>>;
+    /**
+     * @returns {string[]}
+     */
+    static getCategories(): string[];
+    /**
+     * @returns {string[]}
+     */
+    static getLocales(): string[];
+    /**
+     * @param {string} appId
+     * @returns {string}
+     */
+    static getBrandColor(appId: string): string;
+    /**
+     * @param {Array<Record<string, unknown>> | undefined} errors
+     * @param {AppManifest} appJson
+     * @returns {string | null}
+     */
+    static errorsText(errors: Array<Record<string, unknown>> | undefined, appJson: AppManifest): string | null;
+    /**
+     * @param {string} path
+     */
+    constructor(path: string);
+    _path: string;
+    /**
+     * @param {...unknown} args
+     * @returns {void}
+     */
+    debug(...args: unknown[]): void;
+    /**
+     * @param {{ level?: 'debug' | 'publish' | 'verified', debug?: boolean }} [options]
+     * @returns {Promise<void>}
+     */
+    validate({ level, debug, }?: {
+        level?: "debug" | "publish" | "verified";
+        debug?: boolean;
+    }): Promise<void>;
+    _debug: boolean;
+    /**
+     * @param {Record<string, unknown>} setting
+     * @param {{ id: string }} driver
+     * @returns {void}
+     */
+    _checkPrivateSettingPrefixUse(setting: Record<string, unknown>, driver: {
+        id: string;
+    }): void;
+    /**
+     * @param {Record<string, unknown> | null | undefined} driver
+     * @param {Record<string, unknown> | null | undefined} setting
+     * @returns {void}
+     */
+    _checkZwaveForSetting(driver: Record<string, unknown> | null | undefined, setting: Record<string, unknown> | null | undefined): void;
+    /**
+     * @param {string} filepath
+     * @returns {Promise<string[]>}
+     */
+    _getDirectoryContents(filepath: string): Promise<string[]>;
+    /**
+     * @param {string} filepath
+     * @returns {Promise<void>}
+     */
+    _ensureFileExistsCaseSensitive(filepath: string): Promise<void>;
+    /**
+     * @param {string} filepath
+     * @returns {Promise<boolean>}
+     */
+    _fileExistsCaseSensitive(filepath: string): Promise<boolean>;
+    /**
+     * @param {{ small: string, large: string }} imagesObj
+     * @param {'app' | 'driver'} type
+     * @param {string} [errorPath]
+     * @returns {Promise<void>}
+     */
+    _validateImages(imagesObj: {
+        small: string;
+        large: string;
+    }, type: "app" | "driver", errorPath?: string): Promise<void>;
+    /**
+     * @returns {Promise<void>}
+     */
+    _validateModules(): Promise<void>;
+    /**
+     * @param {Record<string, unknown>} card
+     * @param {string} errorPath
+     * @param {AppManifest} appJson
+     * @param {{ levelPublish: boolean, levelVerified: boolean }} options
+     * @returns {void}
+     */
+    _validateFlowCard(card: Record<string, unknown>, errorPath: string, appJson: AppManifest, { levelPublish, levelVerified }: {
+        levelPublish: boolean;
+        levelVerified: boolean;
+    }): void;
+    /**
+     * @param {string} filepath
+     * @param {number} numBytes
+     * @returns {Promise<Buffer>}
+     */
+    _readBytes(filepath: string, numBytes: number): Promise<Buffer>;
+}
+declare namespace App {
+    export { AppManifest };
+}
+type AppManifest = import("../../assets/app/schema").App;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/App/index.js"],"names":[],"mappings":";AA8EA;IACE,2CAAqD;IACrD,2CAAmD;IAsyBnD;;;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;IApvCD;;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,CA4wBzB;IAtwBC,gBAAmB;IAmxBrB;;;;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;;;;mBAtyCa,OAAO,yBAAyB,EAAE,GAAG"}

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

@@ -0,0 +1,61 @@
+export = Capability;
+declare class Capability {
+    /**
+     * @returns {Record<string, unknown>}
+     */
+    static getJSONSchema(): Record<string, unknown>;
+    /**
+     * @returns {Record<string, CapabilityDefinition>}
+     */
+    static getCapabilities(): Record<string, CapabilityDefinition>;
+    /**
+     * @param {string} id
+     * @returns {CapabilityDefinition}
+     */
+    static getCapability(id: string): CapabilityDefinition;
+    /**
+     * @param {string} id
+     * @returns {boolean}
+     */
+    static hasCapability(id: string): boolean;
+    /**
+     * @param {string} capabilityId
+     * @param {CapabilityDefinition} capability
+     * @returns {CapabilityDefinition}
+     */
+    static _composeCapability(capabilityId: string, capability: CapabilityDefinition): CapabilityDefinition;
+    /**
+     * @param {string} capabilityIdToCheck
+     * @param {string} capabilityId
+     * @returns {boolean}
+     */
+    static isInstanceOfId(capabilityIdToCheck: string, capabilityId: string): boolean;
+    /**
+     * @param {string} capabilityId
+     * @returns {string}
+     */
+    static getBaseId(capabilityId: string): string;
+    /**
+    * @param {CapabilityDefinition} capability
+     */
+    constructor(capability: CapabilityDefinition);
+    _capability: import("../../assets/capability/schema").Capability;
+    /**
+     * @param {...unknown} args
+     * @returns {void}
+     */
+    debug(...args: unknown[]): void;
+    /**
+     * @param {{ debug?: boolean }} [options]
+     * @returns {Promise<void>}
+     */
+    validate({ debug, }?: {
+        debug?: boolean;
+    }): Promise<void>;
+    _debug: boolean;
+}
+declare namespace Capability {
+    export { CapabilityDefinition };
+}
+type CapabilityDefinition = import("../../assets/capability/schema").Capability;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/Capability/index.js"],"names":[],"mappings":";AAWA;IAsCE;;OAEG;IACH,wBAFa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKnC;IAED;;OAEG;IACH,0BAFa,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAchD;IAED;;;OAGG;IACH,yBAHW,MAAM,GACJ,oBAAoB,CAShC;IAED;;;OAGG;IACH,yBAHW,MAAM,GACJ,OAAO,CAKnB;IAED;;;;OAIG;IACH,wCAJW,MAAM,cACN,oBAAoB,GAClB,oBAAoB,CA2ChC;IAED;;;;OAIG;IACH,2CAJW,MAAM,gBACN,MAAM,GACJ,OAAO,CAMnB;IAED;;;OAGG;IACH,+BAHW,MAAM,GACJ,MAAM,CAKlB;IArJD;;OAEG;IACH,wBAFU,oBAAoB,EAI7B;IADC,iEAA6B;IAG/B;;;OAGG;IACH,eAHc,OAAO,EAAA,GACR,IAAI,CAKhB;IAED;;;OAGG;IACH,sBAHW;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBzB;IAXC,gBAAmB;CAgItB;;;;4BA9Ja,OAAO,gCAAgC,EAAE,UAAU"}

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

@@ -0,0 +1,18 @@
+export = Device;
+declare class Device {
+    /**
+     * @returns {Record<string, Record<string, unknown>>}
+     */
+    static getClasses(): Record<string, Record<string, unknown>>;
+    /**
+     * @param {string} id
+     * @returns {Record<string, unknown>}
+     */
+    static getClass(id: string): Record<string, unknown>;
+    /**
+     * @returns {ReturnType<typeof Capability.getCapabilities>}
+     */
+    static getCapabilities(): ReturnType<typeof Capability.getCapabilities>;
+}
+import Capability = require("../Capability");
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/Device/index.js"],"names":[],"mappings":";AAMA;IAEE;;OAEG;IACH,qBAFa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAanD;IAED;;;OAGG;IACH,oBAHW,MAAM,GACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASnC;IAGD;;OAEG;IACH,0BAFa,UAAU,CAAC,OAAO,UAAU,CAAC,eAAe,CAAC,CAIzD;CAEF"}

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

@@ -0,0 +1,12 @@
+export = Energy;
+declare class Energy {
+    /**
+     * @returns {Record<string, Record<string, unknown>>}
+     */
+    static getCurrencies(): Record<string, Record<string, unknown>>;
+    /**
+     * @returns {string[]}
+     */
+    static getBatteries(): string[];
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/Energy/index.js"],"names":[],"mappings":";AAEA;IAEE;;OAEG;IACH,wBAFa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKnD;IAED;;OAEG;IACH,uBAFa,MAAM,EAAE,CAwBpB;CAEF"}

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

@@ -0,0 +1,8 @@
+export = Media;
+declare class Media {
+    /**
+     * @returns {Record<string, Record<string, unknown>>}
+     */
+    static getCodecs(): Record<string, Record<string, unknown>>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/Media/index.js"],"names":[],"mappings":";AAEA;IAEE;;OAEG;IACH,oBAFa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKnD;CAEF"}

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

@@ -0,0 +1,52 @@
+export = Signal;
+/**
+ * @typedef {'433' | '868' | 'ir'} SignalFrequency
+ */
+declare class Signal {
+    /**
+     * @param {Record<string, unknown>} signal
+     * @param {{ frequency?: SignalFrequency }} [options]
+     */
+    constructor(signal: Record<string, unknown>, { frequency }?: {
+        frequency?: SignalFrequency;
+    });
+    _signal: Record<string, unknown>;
+    _frequency: SignalFrequency;
+    /**
+     * @param {string} message
+     * @param {boolean} result
+     * @returns {void}
+     */
+    _check(message: string, result: boolean): void;
+    /**
+     * @param {...unknown} args
+     * @returns {void}
+     */
+    debug(...args: unknown[]): void;
+    /**
+     * @param {{ debug?: boolean }} [options]
+     * @returns {Promise<void>}
+     */
+    validate({ debug, }?: {
+        debug?: boolean;
+    }): Promise<void>;
+    _debug: boolean;
+    /**
+     * @param {Record<string, (value: unknown, signal: Record<string, unknown>) => { result: boolean, msg: string }>} validatorEngine
+     * @returns {void}
+     */
+    _validateWithEngine(validatorEngine: Record<string, (value: unknown, signal: Record<string, unknown>) => {
+        result: boolean;
+        msg: string;
+    }>): void;
+    _validateProntohex(): void;
+    _validateRegular(): void;
+    _validate433(): void;
+    _validate868(): void;
+    _validateInfrared(): void;
+}
+declare namespace Signal {
+    export { SignalFrequency };
+}
+type SignalFrequency = "433" | "868" | "ir";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/Signal/index.js"],"names":[],"mappings":";AAaA;;GAEG;AAEH;IAEE;;;OAGG;IACH,oBAHW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBACvB;QAAE,SAAS,CAAC,EAAE,eAAe,CAAA;KAAE,EAOzC;IAJC,iCAAqB;IACrB,4BAA2B;IAgB7B;;;;OAIG;IACH,gBAJW,MAAM,UACN,OAAO,GACL,IAAI,CAMhB;IApBD;;;OAGG;IACH,eAHc,OAAO,EAAA,GACR,IAAI,CAOhB;IAaD;;;OAGG;IACH,sBAHW;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAgCzB;IA3BC,gBAAmB;IA6BrB;;;OAGG;IACH,qCAHW,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,GACnG,IAAI,CAIhB;IAED,2BAIC;IAED,yBAKC;IAED,qBAGC;IAED,qBAGC;IAED,0BAEC;CAEF;;;;uBA7GY,KAAK,GAAG,KAAK,GAAG,IAAI"}

package/types/lib/Signal/validators.d.ts

@@ -0,0 +1,37 @@
+export type SignalDefinition = Record<string, unknown>;
+export type ValidationResult = {
+    result: boolean;
+    msg: string;
+};
+export type Validator = (value: unknown, signal: SignalDefinition) => ValidationResult;
+export type ValidatorEngine = Record<string, Validator>;
+export type CheckFn = (message: string, result: boolean) => void;
+/**
+ * @typedef {Record<string, unknown>} SignalDefinition
+ * @typedef {{ result: boolean, msg: string }} ValidationResult
+ * @typedef {(value: unknown, signal: SignalDefinition) => ValidationResult} Validator
+ * @typedef {Record<string, Validator>} ValidatorEngine
+ * @typedef {(message: string, result: boolean) => void} CheckFn
+ */
+/**
+ * @param {ValidatorEngine} validator
+ * @param {CheckFn} check
+ * @param {SignalDefinition} signal
+ * @returns {void}
+ */
+export function validate(validator: ValidatorEngine, check: CheckFn, signal: SignalDefinition): void;
+/** @type {ValidatorEngine} */
+export const genericValidator: ValidatorEngine;
+/** @type {ValidatorEngine} */
+export const irValidator: ValidatorEngine;
+/** @type {ValidatorEngine} */
+export const rfValidator: ValidatorEngine;
+/** @type {ValidatorEngine} */
+export const rf433Validator: ValidatorEngine;
+/** @type {ValidatorEngine} */
+export const rf868Validator: ValidatorEngine;
+/** @type {ValidatorEngine} */
+export const modulationValidator: ValidatorEngine;
+/** @type {ValidatorEngine} */
+export const prontoValidator: ValidatorEngine;
+//# sourceMappingURL=validators.d.ts.map

package/types/lib/Signal/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../lib/Signal/validators.js"],"names":[],"mappings":"+BAKa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;+BACvB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;wBAChC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,KAAK,gBAAgB;8BAC9D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;sBACzB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI;AALvD;;;;;;GAMG;AAGH;;;;;GAKG;AACH,oCALW,eAAe,SACf,OAAO,UACP,gBAAgB,GACd,IAAI,CAWhB;AA0DD,8BAA8B;AAC9B,+BADW,eAAe,CAwFxB;AAsJF,8BAA8B;AAC9B,0BADW,eAAe,CAUxB;AAvJF,8BAA8B;AAC9B,0BADW,eAAe,CAiDxB;AAmEF,8BAA8B;AAC9B,6BADW,eAAe,CAMxB;AAMF,8BAA8B;AAC9B,6BADW,eAAe,CAMxB;AA7EF,8BAA8B;AAC9B,kCADW,eAAe,CAiCxB;AAEF,8BAA8B;AAC9B,8BADW,eAAe,CAkBxB"}

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

@@ -0,0 +1,27 @@
+/**
+ * Calculate a hex hash for the contents of a file.
+ * @param {string} filePath - Absolute or relative path to the file.
+ * @param {string} [hashName='sha256'] - Hash algorithm name (e.g. sha256).
+ * @returns {Promise<string>} Resolves with a hex-encoded digest.
+ */
+export function hashFile(filePath: string, hashName?: string): Promise<string>;
+/**
+ * Create an integrity string for a file using an allowed hash algorithm.
+ * @param {string} filePath - Absolute or relative path to the file.
+ * @param {string} [hashName='sha256'] - Allowed hash algorithm name.
+ * @returns {Promise<string>} Resolves with `hashName:hexDigest`.
+ */
+export function getIntegrity(filePath: string, hashName?: string): Promise<string>;
+/**
+ * Validate file integrity using a `hashName:hexDigest` string.
+ * @param {string} filePath - Absolute or relative path to the file.
+ * @param {string} integrity - Hash name and hex digest separated by `:`.
+ * @returns {Promise<boolean>} Resolves with true when hashes match.
+ */
+export function validateIntegrity(filePath: string, integrity: string): Promise<boolean>;
+export function getOTAFilePath({ appPath, driverId, fileName }: {
+    appPath: any;
+    driverId: any;
+    fileName: any;
+}): string;
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../lib/Util/file.js"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,mCAJW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAW3B;AAwBD;;;;;GAKG;AACH,uCAJW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAW3B;AArCD;;;;;GAKG;AACH,4CAJW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAgB5B;AAmBD;;;;WAEC"}

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

@@ -0,0 +1,76 @@
+export = Util;
+declare class Util {
+    /**
+     * @param {string} modelId
+     * @returns {string[]}
+     */
+    static getPlatformLocalFeatures(modelId: string): string[];
+    /**
+     * @param {string} modelId
+     * @param {string[]} wantedFeatures
+     * @returns {string[]}
+     */
+    static getMissingPlatformLocalFeatures(modelId: string, wantedFeatures: string[]): string[];
+    /**
+     * Create an integrity string for a file using an allowed hash algorithm.
+     * NOTE: This method is only available in Node.js environments.
+     * @param {string} filePath - Absolute or relative path to the file.
+     * @param {string} hashName - Allowed hash algorithm name.
+     * @returns {Promise<string>} Resolves with `hashName:hexDigest`.
+     */
+    static getIntegrity(filePath: string, hashName: string): Promise<string>;
+    /**
+     * Validate file integrity using a `hashName:hexDigest` string.
+     * NOTE: This method is only available in Node.js environments.
+     * @param {string} filePath - Absolute or relative path to the file.
+     * @param {string} integrity - Hash name and hex digest separated by `:`.
+     * @returns {Promise<boolean>} Resolves with true when hashes match.
+     */
+    static validateIntegrity(filePath: string, integrity: string): Promise<boolean>;
+    /**
+     * Parse the Zigbee OTA header from a file.
+     * NOTE: This method is only available in Node.js environments.
+     * @param {string} filePath - Absolute or relative path to the OTA file.
+     * @returns {Promise<import('./zigbee').ZigbeeOTAHeader>} Parsed header values.
+     */
+    static parseZigbeeOTAHeader(filePath: string): Promise<import("./zigbee").ZigbeeOTAHeader>;
+    /**
+     * Validate a Zigbee OTA header against expected values.
+     * NOTE: This method is only available in Node.js environments.
+     * @param {object} options - Validation options.
+     * @param {string} options.filePath - Absolute or relative path to the OTA file.
+     * @param {number} [options.manufacturerCode] - Expected manufacturer code.
+     * @param {number} [options.fileVersion] - Expected file version.
+     * @param {number} [options.imageType] - Expected image type.
+     * @returns {Promise<import('./zigbee').ZigbeeOTAHeader>} Parsed header values.
+     */
+    static validateZigbeeOTAHeader(options: {
+        filePath: string;
+        manufacturerCode?: number;
+        fileVersion?: number;
+        imageType?: number;
+    }): Promise<import("./zigbee").ZigbeeOTAHeader>;
+    /**
+     * Returns the expected file path for an OTA file based on app path, driver ID and file name.
+     * NOTE: This method is only available in Node.js environments.
+     * @param {object} options - File path options.
+     * @param {string} options.appPath - Absolute path to the app.
+     * @param {string} options.driverId - Driver ID.
+     * @param {string} options.fileName - OTA file name.
+     * @returns {string} Resolves with the expected file path.
+     */
+    static getOTAFilePath({ appPath, driverId, fileName }: {
+        appPath: string;
+        driverId: string;
+        fileName: string;
+    }): string;
+}
+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[]>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;QAAwB,OAAO,EAAvB,MAAM;QACU,QAAQ,EAAxB,MAAM;QACU,QAAQ,EAAxB,MAAM;KACd,GAAU,MAAM,CAIlB;CAEF;;;;;;;gCAOU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC"}

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

@@ -0,0 +1,88 @@
+export type ZigbeeOTAHeader = {
+    /**
+     * - File size in bytes.
+     */
+    fileSize: number;
+    /**
+     * - OTA file identifier.
+     */
+    fileIdentifier: number;
+    /**
+     * - OTA header version.
+     */
+    headerVersion: number;
+    /**
+     * - OTA header length in bytes.
+     */
+    headerLength: number;
+    /**
+     * - Field control bitmask.
+     */
+    fieldControl: number;
+    /**
+     * - Manufacturer code.
+     */
+    manufacturerCode: number;
+    /**
+     * - Image type.
+     */
+    imageType: number;
+    /**
+     * - File version.
+     */
+    fileVersion: number;
+    /**
+     * - Zigbee stack version.
+     */
+    zigbeeStackVersion: number;
+    /**
+     * - Header string (ASCII).
+     */
+    headerString: string;
+    /**
+     * - Total image size in bytes.
+     */
+    totalImageSize: number;
+    /**
+     * - Security credential version.
+     */
+    securityCredentialVersion?: number;
+    /**
+     * - Destination EUI64 hex string.
+     */
+    upgradeFileDestination?: string;
+    /**
+     * - Minimum hardware version.
+     */
+    minimumHardwareVersion?: number;
+    /**
+     * - Maximum hardware version.
+     */
+    maximumHardwareVersion?: number;
+    /**
+     * - Unparsed header bytes.
+     */
+    remainingHeaderBytes: number;
+};
+/**
+ * Parse the Zigbee OTA header from a file.
+ * @param {string} filePath - Absolute or relative path to the OTA file.
+ * @returns {Promise<ZigbeeOTAHeader>} Parsed header values.
+ */
+export function parseZigbeeOTAHeader(filePath: string): Promise<ZigbeeOTAHeader>;
+/**
+ * Validate a Zigbee OTA header against expected values.
+ * @param {object} options - Validation options.
+ * @param {string} options.filePath - Absolute or relative path to the OTA file.
+ * @param {number} [options.manufacturerCode] - Expected manufacturer code.
+ * @param {number} [options.fileVersion] - Expected file version.
+ * @param {number} [options.imageType] - Expected image type.
+ * @returns {Promise<ZigbeeOTAHeader>} Parsed header values.
+ */
+export function validateZigbeeOTAHeader({ filePath, manufacturerCode, fileVersion, imageType, }?: {
+    filePath: string;
+    manufacturerCode?: number;
+    fileVersion?: number;
+    imageType?: number;
+}): Promise<ZigbeeOTAHeader>;
+//# sourceMappingURL=zigbee.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zigbee.d.ts","sourceRoot":"","sources":["../../../lib/Util/zigbee.js"],"names":[],"mappings":";;;;cAgBc,MAAM;;;;oBACN,MAAM;;;;mBACN,MAAM;;;;kBACN,MAAM;;;;kBACN,MAAM;;;;sBACN,MAAM;;;;eACN,MAAM;;;;iBACN,MAAM;;;;wBACN,MAAM;;;;kBACN,MAAM;;;;oBACN,MAAM;;;;gCACN,MAAM;;;;6BACN,MAAM;;;;6BACN,MAAM;;;;6BACN,MAAM;;;;0BACN,MAAM;;AAuBpB;;;;GAIG;AACH,+CAHW,MAAM,GACJ,OAAO,CAAC,eAAe,CAAC,CAmGpC;AAED;;;;;;;;GAQG;AACH,kGANG;IAAwB,QAAQ,EAAxB,MAAM;IACW,gBAAgB,GAAjC,MAAM;IACW,WAAW,GAA5B,MAAM;IACW,SAAS,GAA1B,MAAM;CACd,GAAU,OAAO,CAAC,eAAe,CAAC,CAsDpC"}