homey-lib 2.46.1 → 2.48.0

package/assets/device/classes/waterpurifier.json

@@ -30,4 +30,4 @@
     "ar": "استخدم فئة الجهاز هذه لأجهزة تنقية المياه."
   },
   "minCompatibility": "12.0.0"
-}
+}

package/assets/device/classes/watervalve.json

@@ -30,4 +30,4 @@
     "ar": "استخدم فئة الجهاز هذه لصمامات المياه الميكانيكية."
   },
   "minCompatibility": "12.0.0"
-}
+}

package/assets/device/classes/windowcoverings.json

@@ -6,7 +6,7 @@
     "fr": "Couverture de fenêtre",
     "it": "Rivestimenti per finestre",
     "sv": "Fönsterskydd",
-    "no": "Vindusbeskyttelse",
+    "no": "Vindusskjerming",
     "es": "Cobertores de ventanas",
     "da": "Vinduesdække",
     "ru": "Оконные навесы",
@@ -50,4 +50,4 @@
     "curtain",
     "shutterblinds"
   ]
-}
+}

package/lib/App/index.js

@@ -386,28 +386,24 @@ class App {
         // validate `appJson.drivers[].capabilitiesOptions`
         if (driver.capabilitiesOptions) {
           for (const [capabilityId, capabilityOptions] of Object.entries(driver.capabilitiesOptions)) {
-            // Validate target_power_mode values - check canonical IDs present, no reserved prefixes
+            // Validate target_power_mode values - require homey, at least one non-homey, no reserved prefixes
             if (Capability.isInstanceOfId(capabilityId, 'target_power_mode') && Array.isArray(capabilityOptions.values)) {
-              const canonicalValues = Capability.getCapability('target_power_mode').values;
-
-              for (const canonical of canonicalValues) {
-                const provided = capabilityOptions.values.find(v => v && typeof v === 'object' && v.id === canonical.id);
-                if (!provided) {
-                  throw new Error(`drivers.${driver.id}.capabilitiesOptions.${capabilityId}.values must include canonical value "${canonical.id}"`);
-                }
+              const hasHomey = capabilityOptions.values.some(v => v && typeof v === 'object' && v.id === 'homey');
+              if (!hasHomey) {
+                throw new Error(`drivers.${driver.id}.capabilitiesOptions.${capabilityId}.values must include "homey" value`);
               }
 
-              const canonicalIds = new Set(canonicalValues.map(v => v.id));
-              const extraValues = capabilityOptions.values.filter(v => v && typeof v === 'object' && typeof v.id === 'string' && !canonicalIds.has(v.id));
+              const nonHomeyValues = capabilityOptions.values.filter(v => v && typeof v === 'object' && typeof v.id === 'string' && v.id !== 'homey');
+              if (nonHomeyValues.length === 0) {
+                throw new Error(`drivers.${driver.id}.capabilitiesOptions.${capabilityId}.values must include at least one non-homey value`);
+              }
 
               const RESERVED_PREFIXES = ['homey_'];
-              const reservedValues = extraValues.filter(value =>
-                RESERVED_PREFIXES.some(prefix => value.id.startsWith(prefix))
-              );
-
-              if (reservedValues.length) {
-                const ids = reservedValues.map(value => value.id).join(', ');
-                throw new Error(`drivers.${driver.id}.capabilitiesOptions.${capabilityId}.values custom values cannot use reserved prefix "homey_": ${ids}`);
+              for (const value of capabilityOptions.values) {
+                if (value && typeof value === 'object' && typeof value.id === 'string'
+                  && RESERVED_PREFIXES.some(prefix => value.id.startsWith(prefix))) {
+                  throw new Error(`drivers.${driver.id}.capabilitiesOptions.${capabilityId}.values custom values cannot use reserved prefix "homey_": ${value.id}`);
+                }
               }
             }
 
@@ -695,7 +691,11 @@ class App {
             const seenFiles = new Set();
 
             for (const [fileIndex, file] of Object.entries(update.files)) {
-              const relativeFilePath = Util.getOTAFilePath({ appPath: '', driverId: driver.id, fileName: file.name });
+              if (basename(file.name) !== file.name) {
+                throw new Error(`drivers.${driver.id}.firmwareUpdates.updates[${updateIndex}].files[${fileIndex}] cannot include (sub)directories in the file name`);
+              }
+
+              const relativeFilePath = Util.getOTAFilePath({ driverId: driver.id, fileName: file.name });
               await this._ensureFileExistsCaseSensitive(relativeFilePath);
               const filePath = join(this._path, relativeFilePath);
               const isIntegrityValid = await Util.validateIntegrity(filePath, file.integrity);

package/lib/Util/file.js

@@ -73,7 +73,7 @@ async function getIntegrity(filePath, hashName = 'sha256') {
 }
 
 function getOTAFilePath({ appPath, driverId, fileName }) {
-  return path.join(appPath, 'drivers', driverId, 'assets', 'firmware', fileName);
+  return path.join(appPath || '', 'drivers', driverId, 'assets', 'firmware', fileName);
 }
 
 module.exports = {

package/lib/Util/index.js

@@ -73,7 +73,7 @@ class Util {
    * 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.appPath] - Absolute path to the app. If not provided, the path is relative to the app root.
    * @param {string} options.driverId - Driver ID.
    * @param {string} options.fileName - OTA file name.
    * @returns {string} Resolves with the expected file path.

package/package.json

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

package/scripts/apply-locale-files.js

@@ -34,7 +34,7 @@ fs.readdirSync(INPUT_DIR).forEach(inputFile => {
       // Write updated content back to file
       fs.writeFileSync(
         sourceFilePath,
-        JSON.stringify(originalContent, null, 2),
+        `${JSON.stringify(originalContent, null, 2)}\n`,
       );
     });
   }

package/scripts/generate-locale-files.js

@@ -56,7 +56,7 @@ function writeTranslations(translations, outputDir) {
         existingTranslations = JSON.parse(fs.readFileSync(filePath, 'utf8'));
       }
       translationObj = { ...existingTranslations, ...translationObj };
-      fs.writeFileSync(filePath, JSON.stringify(translationObj, null, 2));
+      fs.writeFileSync(filePath, `${JSON.stringify(translationObj, null, 2)}\n`);
     }
   });
 }

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

@@ -504,6 +504,7 @@ export interface FlowCard {
           | {
               [k: string]: unknown;
             };
+        items?: "variable" | "flow_or_advanced_flow" | "user";
         [k: string]: unknown;
       }
     | {

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

@@ -54,13 +54,13 @@ declare class Util {
      * 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.appPath] - Absolute path to the app. If not provided, the path is relative to the app root.
      * @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;
+        appPath?: string;
         driverId: string;
         fileName: string;
     }): string;

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;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"}
+{"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"}