edilkamin 1.8.0 → 1.10.0

package/.github/dependabot.yml

@@ -11,7 +11,11 @@ updates:
     open-pull-requests-limit: 5
     commit-message:
       prefix: ":arrow_up:"
-
+    # Ignore non-LTS Node.js versions for @types/node
+    # Update this when bumping to the next LTS (e.g., 26.x -> ignore 27.x)
+    ignore:
+      - dependency-name: "@types/node"
+        versions: ["25.x"]
   # GitHub Actions dependencies
   - package-ecosystem: "github-actions"
     directory: "/"

package/README.md

@@ -154,6 +154,57 @@ const wifiMac = bleToWifiMac(bleMac); // "a8032afed508"
   to the [proprietary mobile app](https://play.google.com/store/apps/details?id=com.edilkamin.stufe)
 - improving the interoperability (Nest, HomeAssistant...)
 
+## Device Control Methods
+
+The library provides comprehensive control over Edilkamin stoves:
+
+### Power Control
+
+```js
+setPowerOn(token, mac); // Turn on
+setPowerOff(token, mac); // Turn off
+setPower(token, mac, 1); // 1=on, 0=off
+getPower(token, mac); // Returns boolean
+setPowerLevel(token, mac, 3); // Set power level (1-5)
+getPowerLevel(token, mac); // Returns 1-5
+```
+
+### Fan Speed
+
+```js
+setFan1Speed(token, mac, 3); // Set fan 1 speed (0-5)
+setFan2Speed(token, mac, 3); // Set fan 2 speed (0-5)
+setFan3Speed(token, mac, 3); // Set fan 3 speed (0-5)
+getFan1Speed(token, mac); // Get fan 1 speed
+getFan2Speed(token, mac); // Get fan 2 speed
+getFan3Speed(token, mac); // Get fan 3 speed
+```
+
+### Operating Modes
+
+```js
+setAirkare(token, mac, true); // Enable/disable air quality mode
+setRelax(token, mac, true); // Enable/disable comfort mode
+setStandby(token, mac, true); // Enable/disable standby mode
+getStandby(token, mac); // Get standby status
+setStandbyTime(token, mac, 30); // Set standby timer (minutes)
+getStandbyTime(token, mac); // Get standby timer
+setAuto(token, mac, true); // Enable/disable auto mode
+getAuto(token, mac); // Get auto mode status
+```
+
+### Temperature Control
+
+```js
+setTargetTemperature(token, mac, 22); // Set zone 1 temperature
+getTargetTemperature(token, mac); // Get zone 1 target
+getEnvironmentTemperature(token, mac); // Get ambient temperature
+setEnvironment2Temperature(token, mac, 20); // Set zone 2 temperature
+getEnvironment2Temperature(token, mac); // Get zone 2 target
+setEnvironment3Temperature(token, mac, 18); // Set zone 3 temperature
+getEnvironment3Temperature(token, mac); // Get zone 3 target
+```
+
 ## Roadmap
 
 - [x] AWS Amplify/ Cognito authentication
@@ -161,7 +212,11 @@ const wifiMac = bleToWifiMac(bleMac); // "a8032afed508"
 - [x] authenticated endpoint call
 - [ ] ~list stoves~
 - [x] turn stove on/off
-- [ ] set temperature
+- [x] set temperature
+- [x] power level control
+- [x] fan speed control
+- [x] operating modes (Airkare, Relax, Standby, Auto)
+- [x] multi-zone temperature control
 
 ## Limitations
 

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
     "name": "edilkamin",
-    "version": "1.8.0",
+    "version": "1.10.0",
     "description": "",
     "main": "dist/cjs/src/index.js",
     "module": "dist/esm/src/index.js",
@@ -70,9 +70,9 @@
         "@eslint/eslintrc": "^3.2.0",
         "@eslint/js": "^9.16.0",
         "@types/mocha": "^10.0.10",
-        "@types/node": "^25.0.2",
+        "@types/node": "^24",
         "@types/pako": "^2.0.4",
-        "@types/sinon": "^17.0.3",
+        "@types/sinon": "^21.0.0",
         "@types/web-bluetooth": "^0.0.21",
         "@typescript-eslint/eslint-plugin": "^8.17.0",
         "@typescript-eslint/parser": "^8.17.0",
@@ -84,7 +84,7 @@
         "mocha": "^11.7.5",
         "nyc": "^17.1.0",
         "prettier": "^3.7.4",
-        "sinon": "^19.0.2",
+        "sinon": "^21.0.1",
         "ts-node": "^10.9.1",
         "typedoc": "^0.28.15",
         "typescript": "^5.7.2"

package/dist/cjs/src/cli.js

@@ -153,15 +153,80 @@ const createProgram = () => {
             description: "Retrieve device power status",
             getter: (api, jwtToken, mac) => api.getPower(jwtToken, mac),
         },
+        {
+            commandName: "getPowerLevel",
+            description: "Retrieve manual power level (1-5)",
+            getter: (api, jwtToken, mac) => api.getPowerLevel(jwtToken, mac),
+        },
         {
             commandName: "getEnvironmentTemperature",
             description: "Retrieve environment temperature",
             getter: (api, jwtToken, mac) => api.getEnvironmentTemperature(jwtToken, mac),
         },
         {
-            commandName: "getTargetTemperature",
-            description: "Retrieve target temperature",
-            getter: (api, jwtToken, mac) => api.getTargetTemperature(jwtToken, mac),
+            commandName: "getEnvironment1Temperature",
+            description: "Retrieve Environment 1 target temperature",
+            getter: (api, jwtToken, mac) => api.getEnvironment1Temperature(jwtToken, mac),
+        },
+        {
+            commandName: "getFan1Speed",
+            description: "Retrieve fan 1 speed",
+            getter: (api, jwtToken, mac) => api.getFan1Speed(jwtToken, mac),
+        },
+        {
+            commandName: "getFan2Speed",
+            description: "Retrieve fan 2 speed",
+            getter: (api, jwtToken, mac) => api.getFan2Speed(jwtToken, mac),
+        },
+        {
+            commandName: "getFan3Speed",
+            description: "Retrieve fan 3 speed",
+            getter: (api, jwtToken, mac) => api.getFan3Speed(jwtToken, mac),
+        },
+        {
+            commandName: "getStandby",
+            description: "Retrieve Standby mode status",
+            getter: (api, jwtToken, mac) => api.getStandby(jwtToken, mac),
+        },
+        {
+            commandName: "getStandbyTime",
+            description: "Retrieve standby waiting time in minutes",
+            getter: (api, jwtToken, mac) => api.getStandbyTime(jwtToken, mac),
+        },
+        {
+            commandName: "getAuto",
+            description: "Retrieve Auto mode status",
+            getter: (api, jwtToken, mac) => api.getAuto(jwtToken, mac),
+        },
+        {
+            commandName: "getEnvironment2Temperature",
+            description: "Retrieve Environment 2 target temperature",
+            getter: (api, jwtToken, mac) => api.getEnvironment2Temperature(jwtToken, mac),
+        },
+        {
+            commandName: "getEnvironment3Temperature",
+            description: "Retrieve Environment 3 target temperature",
+            getter: (api, jwtToken, mac) => api.getEnvironment3Temperature(jwtToken, mac),
+        },
+        {
+            commandName: "getMeasureUnit",
+            description: "Retrieve temperature unit (true=Fahrenheit, false=Celsius)",
+            getter: (api, jwtToken, mac) => api.getMeasureUnit(jwtToken, mac),
+        },
+        {
+            commandName: "getLanguage",
+            description: "Retrieve display language code (0-9)",
+            getter: (api, jwtToken, mac) => api.getLanguage(jwtToken, mac),
+        },
+        {
+            commandName: "getPelletInReserve",
+            description: "Retrieve pellet reserve status (true=low/reserve, false=ok)",
+            getter: (api, jwtToken, mac) => api.getPelletInReserve(jwtToken, mac),
+        },
+        {
+            commandName: "getPelletAutonomyTime",
+            description: "Retrieve estimated pellet autonomy time",
+            getter: (api, jwtToken, mac) => api.getPelletAutonomyTime(jwtToken, mac),
         },
     ].forEach(({ commandName, description, getter }) => {
         addLegacyOption(addMacOption(addAuthOptions(program.command(commandName).description(description)))).action((options) => executeGetter(options, getter));
@@ -174,13 +239,176 @@ const createProgram = () => {
             setter: (api, jwtToken, mac, value) => api.setPower(jwtToken, mac, value),
         },
         {
-            commandName: "setTargetTemperature",
-            description: "Set the target temperature (degree celsius) for a device",
-            setter: (api, jwtToken, mac, value) => api.setTargetTemperature(jwtToken, mac, value),
+            commandName: "setPowerLevel",
+            description: "Set manual power level (1-5)",
+            setter: (api, jwtToken, mac, value) => api.setPowerLevel(jwtToken, mac, value),
+        },
+        {
+            commandName: "setEnvironment1Temperature",
+            description: "Set Environment 1 target temperature (degrees Celsius)",
+            setter: (api, jwtToken, mac, value) => api.setEnvironment1Temperature(jwtToken, mac, value),
+        },
+        {
+            commandName: "setFan1Speed",
+            description: "Set fan 1 speed (0-5)",
+            setter: (api, jwtToken, mac, value) => api.setFan1Speed(jwtToken, mac, value),
+        },
+        {
+            commandName: "setFan2Speed",
+            description: "Set fan 2 speed (0-5)",
+            setter: (api, jwtToken, mac, value) => api.setFan2Speed(jwtToken, mac, value),
+        },
+        {
+            commandName: "setFan3Speed",
+            description: "Set fan 3 speed (0-5)",
+            setter: (api, jwtToken, mac, value) => api.setFan3Speed(jwtToken, mac, value),
+        },
+        {
+            commandName: "setAirkare",
+            description: "Enable/disable Airkare mode (1=on, 0=off)",
+            setter: (api, jwtToken, mac, value) => api.setAirkare(jwtToken, mac, value === 1),
+        },
+        {
+            commandName: "setRelax",
+            description: "Enable/disable Relax mode (1=on, 0=off)",
+            setter: (api, jwtToken, mac, value) => api.setRelax(jwtToken, mac, value === 1),
+        },
+        {
+            commandName: "setStandby",
+            description: "Enable/disable Standby mode (1=on, 0=off)",
+            setter: (api, jwtToken, mac, value) => api.setStandby(jwtToken, mac, value === 1),
+        },
+        {
+            commandName: "setStandbyTime",
+            description: "Set standby waiting time in minutes",
+            setter: (api, jwtToken, mac, value) => api.setStandbyTime(jwtToken, mac, value),
+        },
+        {
+            commandName: "setAuto",
+            description: "Enable/disable Auto mode (1=on, 0=off)",
+            setter: (api, jwtToken, mac, value) => api.setAuto(jwtToken, mac, value === 1),
+        },
+        {
+            commandName: "setEnvironment2Temperature",
+            description: "Set Environment 2 target temperature (degrees Celsius)",
+            setter: (api, jwtToken, mac, value) => api.setEnvironment2Temperature(jwtToken, mac, value),
+        },
+        {
+            commandName: "setEnvironment3Temperature",
+            description: "Set Environment 3 target temperature (degrees Celsius)",
+            setter: (api, jwtToken, mac, value) => api.setEnvironment3Temperature(jwtToken, mac, value),
+        },
+        {
+            commandName: "setMeasureUnit",
+            description: "Set temperature unit (1=Fahrenheit, 0=Celsius)",
+            setter: (api, jwtToken, mac, value) => api.setMeasureUnit(jwtToken, mac, value === 1),
+        },
+        {
+            commandName: "setLanguage",
+            description: "Set display language (0=IT,1=FR,2=EN,3=ES,4=PT,5=DA,6=NL,7=DE,8=HU,9=PL)",
+            setter: (api, jwtToken, mac, value) => api.setLanguage(jwtToken, mac, value),
         },
     ].forEach(({ commandName, description, setter }) => {
         addLegacyOption(addMacOption(addAuthOptions(program.command(commandName).description(description)).requiredOption("-v, --value <number>", "Value to set", parseFloat))).action((options) => executeSetter(options, setter));
     });
+    // Indexed getter commands (require --index parameter)
+    addLegacyOption(addMacOption(addAuthOptions(program
+        .command("getFanSpeed")
+        .description("Retrieve fan speed by index (1-3)")).requiredOption("-i, --index <number>", "Fan index (1, 2, or 3)", parseInt))).action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const { username, password, mac, index, legacy = false } = options;
+        const normalizedMac = mac.replace(/:/g, "");
+        const storage = (0, token_storage_1.createFileStorage)();
+        (0, library_1.configureAmplify)(storage);
+        let jwtToken;
+        try {
+            jwtToken = yield (0, library_1.getSession)(false, legacy);
+        }
+        catch (_a) {
+            if (!username) {
+                throw new Error("No session found. Please provide --username to sign in.");
+            }
+            const pwd = password || (yield promptPassword());
+            jwtToken = yield (0, library_1.signIn)(username, pwd, legacy);
+        }
+        const apiUrl = legacy ? constants_1.OLD_API_URL : constants_1.NEW_API_URL;
+        const api = (0, library_1.configure)(apiUrl);
+        const result = yield api.getFanSpeed(jwtToken, normalizedMac, index);
+        console.log(JSON.stringify(result, null, 2));
+    }));
+    addLegacyOption(addMacOption(addAuthOptions(program
+        .command("getTargetTemperature")
+        .description("Retrieve target temperature by environment index (1-3)")).requiredOption("-i, --index <number>", "Environment index (1, 2, or 3)", parseInt))).action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const { username, password, mac, index, legacy = false } = options;
+        const normalizedMac = mac.replace(/:/g, "");
+        const storage = (0, token_storage_1.createFileStorage)();
+        (0, library_1.configureAmplify)(storage);
+        let jwtToken;
+        try {
+            jwtToken = yield (0, library_1.getSession)(false, legacy);
+        }
+        catch (_a) {
+            if (!username) {
+                throw new Error("No session found. Please provide --username to sign in.");
+            }
+            const pwd = password || (yield promptPassword());
+            jwtToken = yield (0, library_1.signIn)(username, pwd, legacy);
+        }
+        const apiUrl = legacy ? constants_1.OLD_API_URL : constants_1.NEW_API_URL;
+        const api = (0, library_1.configure)(apiUrl);
+        const result = yield api.getTargetTemperature(jwtToken, normalizedMac, index);
+        console.log(JSON.stringify(result, null, 2));
+    }));
+    // Indexed setter commands (require --index and --value parameters)
+    addLegacyOption(addMacOption(addAuthOptions(program
+        .command("setFanSpeed")
+        .description("Set fan speed by index (1-3)"))
+        .requiredOption("-i, --index <number>", "Fan index (1, 2, or 3)", parseInt)
+        .requiredOption("-v, --value <number>", "Fan speed (0-5)", parseFloat))).action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const { username, password, mac, index, value, legacy = false } = options;
+        const normalizedMac = mac.replace(/:/g, "");
+        const storage = (0, token_storage_1.createFileStorage)();
+        (0, library_1.configureAmplify)(storage);
+        let jwtToken;
+        try {
+            jwtToken = yield (0, library_1.getSession)(false, legacy);
+        }
+        catch (_a) {
+            if (!username) {
+                throw new Error("No session found. Please provide --username to sign in.");
+            }
+            const pwd = password || (yield promptPassword());
+            jwtToken = yield (0, library_1.signIn)(username, pwd, legacy);
+        }
+        const apiUrl = legacy ? constants_1.OLD_API_URL : constants_1.NEW_API_URL;
+        const api = (0, library_1.configure)(apiUrl);
+        const result = yield api.setFanSpeed(jwtToken, normalizedMac, index, value);
+        console.log(JSON.stringify(result, null, 2));
+    }));
+    addLegacyOption(addMacOption(addAuthOptions(program
+        .command("setTargetTemperature")
+        .description("Set target temperature by environment index (1-3)"))
+        .requiredOption("-i, --index <number>", "Environment index (1, 2, or 3)", parseInt)
+        .requiredOption("-v, --value <number>", "Temperature in degrees Celsius", parseFloat))).action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const { username, password, mac, index, value, legacy = false } = options;
+        const normalizedMac = mac.replace(/:/g, "");
+        const storage = (0, token_storage_1.createFileStorage)();
+        (0, library_1.configureAmplify)(storage);
+        let jwtToken;
+        try {
+            jwtToken = yield (0, library_1.getSession)(false, legacy);
+        }
+        catch (_a) {
+            if (!username) {
+                throw new Error("No session found. Please provide --username to sign in.");
+            }
+            const pwd = password || (yield promptPassword());
+            jwtToken = yield (0, library_1.signIn)(username, pwd, legacy);
+        }
+        const apiUrl = legacy ? constants_1.OLD_API_URL : constants_1.NEW_API_URL;
+        const api = (0, library_1.configure)(apiUrl);
+        const result = yield api.setTargetTemperature(jwtToken, normalizedMac, index, value);
+        console.log(JSON.stringify(result, null, 2));
+    }));
     // Command: register
     addLegacyOption(addAuthOptions(program
         .command("register")

package/dist/cjs/src/index.d.ts

@@ -4,4 +4,4 @@ export { API_URL, NEW_API_URL, OLD_API_URL } from "./constants";
 export { configure, getSession, signIn } from "./library";
 export { serialNumberDisplay, serialNumberFromHex, serialNumberToHex, } from "./serial-utils";
 export { BufferEncodedType, CommandsType, DeviceAssociationBody, DeviceAssociationResponse, DeviceInfoRawType, DeviceInfoType, DiscoveredDevice, EditDeviceAssociationBody, StatusType, TemperaturesType, UserParametersType, } from "./types";
-export declare const deviceInfo: (jwtToken: string, macAddress: string) => Promise<import("./types").DeviceInfoType>, registerDevice: (jwtToken: string, macAddress: string, serialNumber: string, deviceName?: string, deviceRoom?: string) => Promise<import("./types").DeviceAssociationResponse>, editDevice: (jwtToken: string, macAddress: string, deviceName?: string, deviceRoom?: string) => Promise<import("./types").DeviceAssociationResponse>, setPower: (jwtToken: string, macAddress: string, value: number) => Promise<unknown>, setPowerOff: (jwtToken: string, macAddress: string) => Promise<unknown>, setPowerOn: (jwtToken: string, macAddress: string) => Promise<unknown>, getPower: (jwtToken: string, macAddress: string) => Promise<boolean>, getEnvironmentTemperature: (jwtToken: string, macAddress: string) => Promise<number>, getTargetTemperature: (jwtToken: string, macAddress: string) => Promise<number>, setTargetTemperature: (jwtToken: string, macAddress: string, temperature: number) => Promise<unknown>;
+export declare const deviceInfo: (jwtToken: string, macAddress: string) => Promise<import("./types").DeviceInfoType>, registerDevice: (jwtToken: string, macAddress: string, serialNumber: string, deviceName?: string, deviceRoom?: string) => Promise<import("./types").DeviceAssociationResponse>, editDevice: (jwtToken: string, macAddress: string, deviceName?: string, deviceRoom?: string) => Promise<import("./types").DeviceAssociationResponse>, setPower: (jwtToken: string, macAddress: string, value: number) => Promise<unknown>, setPowerOff: (jwtToken: string, macAddress: string) => Promise<unknown>, setPowerOn: (jwtToken: string, macAddress: string) => Promise<unknown>, getPower: (jwtToken: string, macAddress: string) => Promise<boolean>, getEnvironmentTemperature: (jwtToken: string, macAddress: string) => Promise<number>, getTargetTemperature: (jwtToken: string, macAddress: string, envIndex: 1 | 2 | 3) => Promise<number>, setTargetTemperature: (jwtToken: string, macAddress: string, envIndex: 1 | 2 | 3, temperature: number) => Promise<unknown>;

package/dist/cjs/src/library.d.ts

@@ -48,8 +48,38 @@ declare const configure: (baseURL?: string) => {
     setPowerOff: (jwtToken: string, macAddress: string) => Promise<unknown>;
     setPowerOn: (jwtToken: string, macAddress: string) => Promise<unknown>;
     getPower: (jwtToken: string, macAddress: string) => Promise<boolean>;
+    setPowerLevel: (jwtToken: string, macAddress: string, level: number) => Promise<unknown>;
+    getPowerLevel: (jwtToken: string, macAddress: string) => Promise<number>;
+    setFanSpeed: (jwtToken: string, macAddress: string, fanIndex: 1 | 2 | 3, speed: number) => Promise<unknown>;
+    getFanSpeed: (jwtToken: string, macAddress: string, fanIndex: 1 | 2 | 3) => Promise<number>;
+    setFan1Speed: (jwtToken: string, macAddress: string, speed: number) => Promise<unknown>;
+    setFan2Speed: (jwtToken: string, macAddress: string, speed: number) => Promise<unknown>;
+    setFan3Speed: (jwtToken: string, macAddress: string, speed: number) => Promise<unknown>;
+    getFan1Speed: (jwtToken: string, macAddress: string) => Promise<number>;
+    getFan2Speed: (jwtToken: string, macAddress: string) => Promise<number>;
+    getFan3Speed: (jwtToken: string, macAddress: string) => Promise<number>;
+    setAirkare: (jwtToken: string, macAddress: string, enabled: boolean) => Promise<unknown>;
+    setRelax: (jwtToken: string, macAddress: string, enabled: boolean) => Promise<unknown>;
+    setStandby: (jwtToken: string, macAddress: string, enabled: boolean) => Promise<unknown>;
+    getStandby: (jwtToken: string, macAddress: string) => Promise<boolean>;
+    setStandbyTime: (jwtToken: string, macAddress: string, minutes: number) => Promise<unknown>;
+    getStandbyTime: (jwtToken: string, macAddress: string) => Promise<number>;
+    setAuto: (jwtToken: string, macAddress: string, enabled: boolean) => Promise<unknown>;
+    getAuto: (jwtToken: string, macAddress: string) => Promise<boolean>;
     getEnvironmentTemperature: (jwtToken: string, macAddress: string) => Promise<number>;
-    getTargetTemperature: (jwtToken: string, macAddress: string) => Promise<number>;
-    setTargetTemperature: (jwtToken: string, macAddress: string, temperature: number) => Promise<unknown>;
+    getTargetTemperature: (jwtToken: string, macAddress: string, envIndex: 1 | 2 | 3) => Promise<number>;
+    setTargetTemperature: (jwtToken: string, macAddress: string, envIndex: 1 | 2 | 3, temperature: number) => Promise<unknown>;
+    setEnvironment1Temperature: (jwtToken: string, macAddress: string, temperature: number) => Promise<unknown>;
+    getEnvironment1Temperature: (jwtToken: string, macAddress: string) => Promise<number>;
+    setEnvironment2Temperature: (jwtToken: string, macAddress: string, temperature: number) => Promise<unknown>;
+    getEnvironment2Temperature: (jwtToken: string, macAddress: string) => Promise<number>;
+    setEnvironment3Temperature: (jwtToken: string, macAddress: string, temperature: number) => Promise<unknown>;
+    getEnvironment3Temperature: (jwtToken: string, macAddress: string) => Promise<number>;
+    setMeasureUnit: (jwtToken: string, macAddress: string, isFahrenheit: boolean) => Promise<unknown>;
+    getMeasureUnit: (jwtToken: string, macAddress: string) => Promise<boolean>;
+    setLanguage: (jwtToken: string, macAddress: string, languageCode: number) => Promise<unknown>;
+    getLanguage: (jwtToken: string, macAddress: string) => Promise<number>;
+    getPelletInReserve: (jwtToken: string, macAddress: string) => Promise<boolean>;
+    getPelletAutonomyTime: (jwtToken: string, macAddress: string) => Promise<number>;
 };
 export { configure, configureAmplify, createAuthService, getSession, headers, signIn, };