edilkamin 1.14.1 → 1.15.0

package/.github/dependabot.yml

@@ -5,7 +5,7 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
-      day: "monday"
+      day: "friday"
       time: "09:00"
       timezone: "UTC"
     open-pull-requests-limit: 5
@@ -21,7 +21,7 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
-      day: "monday"
+      day: "friday"
       time: "09:00"
       timezone: "UTC"
     open-pull-requests-limit: 5

package/.github/workflows/cli-tests.yml

@@ -20,6 +20,7 @@ jobs:
       - run: yarn cli --help
       - run: yarn build
       - run: node dist/cjs/src/cli.js --help
+      - run: yarn test:cjs-consumer
       - name: Verify CLI binary
         run: |
           test -f dist/cjs/src/cli.js

package/.github/workflows/tests.yml

@@ -20,7 +20,7 @@ jobs:
       - run: yarn lint
       - run: yarn build
       - run: yarn test
-      - uses: codecov/codecov-action@v5
+      - uses: codecov/codecov-action@v6
         with:
           files: ./coverage/lcov.info
           token: ${{ secrets.CODECOV_TOKEN }}

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
     "name": "edilkamin",
-    "version": "1.14.1",
+    "version": "1.15.0",
     "description": "",
     "main": "dist/cjs/src/index.js",
     "module": "dist/esm/src/index.js",
@@ -32,6 +32,7 @@
         "cli:debug": "node --inspect --require ts-node/register/transpile-only src/cli.ts",
         "test": "nyc mocha --require ts-node/register src/*.test.ts",
         "test:debug": "nyc mocha --require ts-node/register/transpile-only --inspect src/*.test.ts",
+        "test:cjs-consumer": "node -e \"const pkg = require('./dist/cjs/src/index.js'); if (typeof pkg.configure !== 'function') throw new Error('configure export missing');\"",
         "lint:prettier": "prettier --check src docs .github *.json *.md *.mjs",
         "format:prettier": "prettier --write src docs .github *.json *.md *.mjs",
         "lint:eslint": "eslint src",
@@ -68,7 +69,7 @@
     },
     "devDependencies": {
         "@eslint/eslintrc": "^3.2.0",
-        "@eslint/js": "^9.16.0",
+        "@eslint/js": "^10.0.1",
         "@types/mocha": "^10.0.10",
         "@types/node": "^24",
         "@types/pako": "^2.0.4",
@@ -76,18 +77,18 @@
         "@types/web-bluetooth": "^0.0.21",
         "@typescript-eslint/eslint-plugin": "^8.17.0",
         "@typescript-eslint/parser": "^8.17.0",
-        "esbuild": "^0.27.1",
-        "eslint": "^9.16.0",
+        "esbuild": "^0.28.0",
+        "eslint": "^10.0.3",
         "eslint-config-prettier": "^10.1.8",
         "eslint-plugin-prettier": "^5.2.1",
-        "eslint-plugin-simple-import-sort": "^12.1.1",
+        "eslint-plugin-simple-import-sort": "^13.0.0",
         "mocha": "^11.7.5",
-        "nyc": "^17.1.0",
+        "nyc": "^18.0.0",
         "prettier": "^3.7.4",
         "sinon": "^21.0.1",
         "ts-node": "^10.9.1",
         "typedoc": "^0.28.15",
-        "typescript": "^5.7.2"
+        "typescript": "^6.0.3"
     },
     "optionalDependencies": {
         "commander": "^14.0.2"

package/dist/cjs/src/bluetooth-protocol.d.ts

@@ -32,6 +32,33 @@ export interface ModbusResponse {
     /** Whether the response indicates an error */
     isError: boolean;
 }
+/**
+ * Operation-tagged BLE response payload emitted by consuming apps.
+ */
+export interface OperationTaggedPayload {
+    /** Operation name associated with this response payload */
+    operation: string;
+    /** Encrypted BLE response payload bytes */
+    payload: Uint8Array;
+}
+/**
+ * Parsed response bound to its originating operation.
+ */
+export interface OperationTaggedResponse<TResponse> {
+    /** Operation name associated with this response payload */
+    operation: string;
+    /** Parsed response data */
+    response: TResponse;
+}
+/**
+ * readWifiStatus operation parse result.
+ */
+export interface ReadWifiStatusResponse {
+    /** Operation name for this specialization */
+    operation: "readWifiStatus";
+    /** Whether Wi-Fi status is connected */
+    isConnected: boolean;
+}
 /**
  * Calculate CRC16-Modbus checksum.
  *
@@ -84,6 +111,48 @@ export declare const createPacket: (modbusCommand: Uint8Array) => Promise<Uint8A
  * @returns Parsed Modbus response
  */
 export declare const parseResponse: (encrypted: Uint8Array) => Promise<ModbusResponse>;
+/**
+ * Normalize and validate an operation-tagged BLE payload.
+ *
+ * @param taggedPayload - Operation name and encrypted payload bytes
+ * @returns Normalized operation-tagged payload
+ */
+export declare const normalizeOperationTaggedPayload: (taggedPayload: OperationTaggedPayload) => OperationTaggedPayload;
+/**
+ * Parse an operation-tagged BLE payload with a caller-provided parser.
+ *
+ * @param taggedPayload - Operation name and encrypted payload bytes
+ * @param parser - Parser to apply on payload bytes
+ * @returns Operation-tagged parsed response
+ */
+export declare const parseOperationTaggedResponse: <TResponse>(taggedPayload: OperationTaggedPayload, parser: (payload: Uint8Array) => TResponse | Promise<TResponse>) => Promise<OperationTaggedResponse<TResponse>>;
+/**
+ * Parse an operation-tagged BLE payload as a Modbus response.
+ *
+ * @param taggedPayload - Operation name and encrypted payload bytes
+ * @returns Operation-tagged parsed Modbus response
+ */
+export declare const parseModbusOperationResponse: (taggedPayload: OperationTaggedPayload) => Promise<OperationTaggedResponse<ModbusResponse>>;
+/**
+ * Parse decrypted payload bytes for readWifiStatus connectivity.
+ *
+ * Decrypted packets keep protocol metadata in bytes 0-19, so this parser checks
+ * string payload from byte 20 onward.
+ *
+ * @param decryptedPayload - Decrypted response payload bytes
+ * @returns true when payload contains STATUS=CONNECTED
+ */
+export declare const parseReadWifiStatusPayload: (decryptedPayload: Uint8Array) => boolean;
+/**
+ * Parse operation-tagged readWifiStatus payloads.
+ *
+ * For protocol packets, 32-byte payloads are decrypted first, then parsed with
+ * readWifiStatus payload conventions.
+ *
+ * @param taggedPayload - Operation name and payload bytes
+ * @returns readWifiStatus operation parse result
+ */
+export declare const parseReadWifiStatusResponse: (taggedPayload: OperationTaggedPayload) => Promise<ReadWifiStatusResponse>;
 /**
  * Pre-built Modbus read commands for querying device state.
  * Each command is 6 bytes: [SlaveAddr, FuncCode, RegHi, RegLo, CountHi, CountLo]

package/dist/cjs/src/bluetooth-protocol.js

@@ -22,7 +22,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parsers = exports.writeCommands = exports.readCommands = exports.parseResponse = exports.createPacket = exports.aesDecrypt = exports.aesEncrypt = exports.crc16Modbus = exports.NOTIFY_CHARACTERISTIC_UUID = exports.WRITE_CHARACTERISTIC_UUID = exports.SERVICE_UUID = void 0;
+exports.parsers = exports.writeCommands = exports.readCommands = exports.parseReadWifiStatusResponse = exports.parseReadWifiStatusPayload = exports.parseModbusOperationResponse = exports.parseOperationTaggedResponse = exports.normalizeOperationTaggedPayload = exports.parseResponse = exports.createPacket = exports.aesDecrypt = exports.aesEncrypt = exports.crc16Modbus = exports.NOTIFY_CHARACTERISTIC_UUID = exports.WRITE_CHARACTERISTIC_UUID = exports.SERVICE_UUID = void 0;
 // =============================================================================
 // BLE Characteristic UUIDs (for consuming apps)
 // =============================================================================
@@ -285,6 +285,90 @@ const parseResponse = (encrypted) => __awaiter(void 0, void 0, void 0, function*
     };
 });
 exports.parseResponse = parseResponse;
+/**
+ * Normalize and validate an operation-tagged BLE payload.
+ *
+ * @param taggedPayload - Operation name and encrypted payload bytes
+ * @returns Normalized operation-tagged payload
+ */
+const normalizeOperationTaggedPayload = (taggedPayload) => {
+    const normalizedOperation = taggedPayload.operation.trim();
+    if (normalizedOperation.length === 0) {
+        throw new Error("Operation must be a non-empty string");
+    }
+    if (taggedPayload.payload.length === 0) {
+        throw new Error("Payload must not be empty");
+    }
+    return {
+        operation: normalizedOperation,
+        payload: taggedPayload.payload,
+    };
+};
+exports.normalizeOperationTaggedPayload = normalizeOperationTaggedPayload;
+/**
+ * Parse an operation-tagged BLE payload with a caller-provided parser.
+ *
+ * @param taggedPayload - Operation name and encrypted payload bytes
+ * @param parser - Parser to apply on payload bytes
+ * @returns Operation-tagged parsed response
+ */
+const parseOperationTaggedResponse = (taggedPayload, parser) => __awaiter(void 0, void 0, void 0, function* () {
+    const normalizedPayload = (0, exports.normalizeOperationTaggedPayload)(taggedPayload);
+    const response = yield parser(normalizedPayload.payload);
+    return {
+        operation: normalizedPayload.operation,
+        response,
+    };
+});
+exports.parseOperationTaggedResponse = parseOperationTaggedResponse;
+/**
+ * Parse an operation-tagged BLE payload as a Modbus response.
+ *
+ * @param taggedPayload - Operation name and encrypted payload bytes
+ * @returns Operation-tagged parsed Modbus response
+ */
+const parseModbusOperationResponse = (taggedPayload) => __awaiter(void 0, void 0, void 0, function* () {
+    return (0, exports.parseOperationTaggedResponse)(taggedPayload, exports.parseResponse);
+});
+exports.parseModbusOperationResponse = parseModbusOperationResponse;
+/**
+ * Parse decrypted payload bytes for readWifiStatus connectivity.
+ *
+ * Decrypted packets keep protocol metadata in bytes 0-19, so this parser checks
+ * string payload from byte 20 onward.
+ *
+ * @param decryptedPayload - Decrypted response payload bytes
+ * @returns true when payload contains STATUS=CONNECTED
+ */
+const parseReadWifiStatusPayload = (decryptedPayload) => {
+    const payloadBytes = decryptedPayload.slice(20);
+    const payloadText = String.fromCharCode(...payloadBytes);
+    return payloadText.includes("STATUS=CONNECTED");
+};
+exports.parseReadWifiStatusPayload = parseReadWifiStatusPayload;
+/**
+ * Parse operation-tagged readWifiStatus payloads.
+ *
+ * For protocol packets, 32-byte payloads are decrypted first, then parsed with
+ * readWifiStatus payload conventions.
+ *
+ * @param taggedPayload - Operation name and payload bytes
+ * @returns readWifiStatus operation parse result
+ */
+const parseReadWifiStatusResponse = (taggedPayload) => __awaiter(void 0, void 0, void 0, function* () {
+    const normalizedPayload = (0, exports.normalizeOperationTaggedPayload)(taggedPayload);
+    if (normalizedPayload.operation !== "readWifiStatus") {
+        throw new Error("Operation must be readWifiStatus");
+    }
+    const decryptedPayload = normalizedPayload.payload.length === 32
+        ? yield (0, exports.aesDecrypt)(normalizedPayload.payload)
+        : normalizedPayload.payload;
+    return {
+        operation: "readWifiStatus",
+        isConnected: (0, exports.parseReadWifiStatusPayload)(decryptedPayload),
+    };
+});
+exports.parseReadWifiStatusResponse = parseReadWifiStatusResponse;
 // =============================================================================
 // Modbus Read Commands (Function Code 0x03)
 // =============================================================================

package/dist/cjs/src/bluetooth-protocol.test.js

@@ -138,6 +138,107 @@ describe("bluetooth-protocol", () => {
             assert_1.strict.ok(typeof parsed.isError === "boolean");
         }));
     });
+    describe("operation-tagged helpers", () => {
+        it("normalizes operation by trimming whitespace", () => {
+            const payload = new Uint8Array([0x01]);
+            const normalized = (0, bluetooth_protocol_1.normalizeOperationTaggedPayload)({
+                operation: "  readState  ",
+                payload,
+            });
+            assert_1.strict.equal(normalized.operation, "readState");
+            assert_1.strict.deepEqual(normalized.payload, payload);
+        });
+        it("rejects empty operation", () => {
+            assert_1.strict.throws(() => (0, bluetooth_protocol_1.normalizeOperationTaggedPayload)({
+                operation: "   ",
+                payload: new Uint8Array([0x01]),
+            }), /Operation must be a non-empty string/);
+        });
+        it("rejects empty payload", () => {
+            assert_1.strict.throws(() => (0, bluetooth_protocol_1.normalizeOperationTaggedPayload)({
+                operation: "readState",
+                payload: new Uint8Array([]),
+            }), /Payload must not be empty/);
+        });
+        it("parses operation-tagged payload with sync parser", () => __awaiter(void 0, void 0, void 0, function* () {
+            const payload = new Uint8Array([0xaa, 0xbb]);
+            const parsed = yield (0, bluetooth_protocol_1.parseOperationTaggedResponse)({
+                operation: "readState",
+                payload,
+            }, (value) => value[0] + value[1]);
+            assert_1.strict.equal(parsed.operation, "readState");
+            assert_1.strict.equal(parsed.response, 0x165);
+        }));
+        it("parses operation-tagged payload with async parser", () => __awaiter(void 0, void 0, void 0, function* () {
+            const payload = new Uint8Array([0xaa, 0xbb]);
+            const parsed = yield (0, bluetooth_protocol_1.parseOperationTaggedResponse)({
+                operation: "readState",
+                payload,
+            }, (value) => __awaiter(void 0, void 0, void 0, function* () { return value.length; }));
+            assert_1.strict.equal(parsed.operation, "readState");
+            assert_1.strict.equal(parsed.response, 2);
+        }));
+        it("parseModbusOperationResponse preserves operation and parses payload", () => __awaiter(void 0, void 0, void 0, function* () {
+            const payload = yield (0, bluetooth_protocol_1.createPacket)(bluetooth_protocol_1.readCommands.power);
+            const taggedPayload = {
+                operation: "readPower",
+                payload,
+            };
+            const parsed = yield (0, bluetooth_protocol_1.parseModbusOperationResponse)(taggedPayload);
+            const expected = yield (0, bluetooth_protocol_1.parseResponse)(payload);
+            assert_1.strict.equal(parsed.operation, "readPower");
+            assert_1.strict.deepEqual(parsed.response, expected);
+        }));
+        describe("parseReadWifiStatusPayload", () => {
+            it("returns true when decrypted payload contains STATUS=CONNECTED", () => {
+                const payloadText = "STATUS=CONNECTED";
+                const payload = new Uint8Array(20 + payloadText.length);
+                payload.set(Buffer.from(payloadText, "latin1"), 20);
+                assert_1.strict.equal((0, bluetooth_protocol_1.parseReadWifiStatusPayload)(payload), true);
+            });
+            it("returns false for non-connected status", () => {
+                const payloadText = "STATUS=DISCONNECTED";
+                const payload = new Uint8Array(20 + payloadText.length);
+                payload.set(Buffer.from(payloadText, "latin1"), 20);
+                assert_1.strict.equal((0, bluetooth_protocol_1.parseReadWifiStatusPayload)(payload), false);
+            });
+            it("returns false when status is missing or invalid", () => {
+                const payloadText = "NO_STATUS_PRESENT";
+                const payload = new Uint8Array(20 + payloadText.length);
+                payload.set(Buffer.from(payloadText, "latin1"), 20);
+                assert_1.strict.equal((0, bluetooth_protocol_1.parseReadWifiStatusPayload)(payload), false);
+            });
+        });
+        describe("parseReadWifiStatusResponse", () => {
+            it("parses readWifiStatus operation payloads", () => __awaiter(void 0, void 0, void 0, function* () {
+                const payloadText = "STATUS=CONNECTED";
+                const payload = new Uint8Array(20 + payloadText.length);
+                payload.set(Buffer.from(payloadText, "latin1"), 20);
+                const parsed = yield (0, bluetooth_protocol_1.parseReadWifiStatusResponse)({
+                    operation: "readWifiStatus",
+                    payload,
+                });
+                assert_1.strict.equal(parsed.operation, "readWifiStatus");
+                assert_1.strict.equal(parsed.isConnected, true);
+            }));
+            it("returns false when readWifiStatus payload is not connected", () => __awaiter(void 0, void 0, void 0, function* () {
+                const payloadText = "STATUS=DISCONNECTED";
+                const payload = new Uint8Array(20 + payloadText.length);
+                payload.set(Buffer.from(payloadText, "latin1"), 20);
+                const parsed = yield (0, bluetooth_protocol_1.parseReadWifiStatusResponse)({
+                    operation: "readWifiStatus",
+                    payload,
+                });
+                assert_1.strict.equal(parsed.isConnected, false);
+            }));
+            it("rejects non-readWifiStatus operations", () => __awaiter(void 0, void 0, void 0, function* () {
+                yield assert_1.strict.rejects(() => (0, bluetooth_protocol_1.parseReadWifiStatusResponse)({
+                    operation: "readState",
+                    payload: new Uint8Array([0x01]),
+                }), /Operation must be readWifiStatus/);
+            }));
+        });
+    });
     describe("readCommands", () => {
         it("all commands are 6 bytes", () => {
             Object.entries(bluetooth_protocol_1.readCommands).forEach(([name, cmd]) => {

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

@@ -38,5 +38,5 @@ declare const scanForDevices: () => Promise<DiscoveredDevice[]>;
 declare const scanWithOptions: (options: RequestDeviceOptions) => Promise<BluetoothDevice>;
 export { EDILKAMIN_DEVICE_NAME, EDILKAMIN_SERVICE_UUID, isWebBluetoothSupported, scanForDevices, scanWithOptions, };
 export type { DiscoveredDevice } from "./types";
-export { aesDecrypt, aesEncrypt, crc16Modbus, createPacket, NOTIFY_CHARACTERISTIC_UUID, parseResponse, parsers, readCommands, SERVICE_UUID, WRITE_CHARACTERISTIC_UUID, writeCommands, } from "./bluetooth-protocol";
-export type { ModbusResponse } from "./bluetooth-protocol";
+export { aesDecrypt, aesEncrypt, crc16Modbus, createPacket, normalizeOperationTaggedPayload, NOTIFY_CHARACTERISTIC_UUID, parseModbusOperationResponse, parseOperationTaggedResponse, parseReadWifiStatusPayload, parseReadWifiStatusResponse, parseResponse, parsers, readCommands, SERVICE_UUID, WRITE_CHARACTERISTIC_UUID, writeCommands, } from "./bluetooth-protocol";
+export type { ModbusResponse, OperationTaggedPayload, OperationTaggedResponse, ReadWifiStatusResponse, } from "./bluetooth-protocol";

package/dist/cjs/src/bluetooth.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeCommands = exports.WRITE_CHARACTERISTIC_UUID = exports.SERVICE_UUID = exports.readCommands = exports.parsers = exports.parseResponse = exports.NOTIFY_CHARACTERISTIC_UUID = exports.createPacket = exports.crc16Modbus = exports.aesEncrypt = exports.aesDecrypt = exports.scanWithOptions = exports.scanForDevices = exports.isWebBluetoothSupported = exports.EDILKAMIN_SERVICE_UUID = exports.EDILKAMIN_DEVICE_NAME = void 0;
+exports.writeCommands = exports.WRITE_CHARACTERISTIC_UUID = exports.SERVICE_UUID = exports.readCommands = exports.parsers = exports.parseResponse = exports.parseReadWifiStatusResponse = exports.parseReadWifiStatusPayload = exports.parseOperationTaggedResponse = exports.parseModbusOperationResponse = exports.NOTIFY_CHARACTERISTIC_UUID = exports.normalizeOperationTaggedPayload = exports.createPacket = exports.crc16Modbus = exports.aesEncrypt = exports.aesDecrypt = exports.scanWithOptions = exports.scanForDevices = exports.isWebBluetoothSupported = exports.EDILKAMIN_SERVICE_UUID = exports.EDILKAMIN_DEVICE_NAME = void 0;
 const bluetooth_utils_1 = require("./bluetooth-utils");
 /** Device name broadcast by Edilkamin stoves */
 const EDILKAMIN_DEVICE_NAME = "EDILKAMIN_EP";
@@ -87,7 +87,7 @@ const scanForDevices = () => __awaiter(void 0, void 0, void 0, function* () {
             }
             throw error;
         }
-        throw new Error("Unknown error during Bluetooth scan");
+        throw new Error("Unknown error during Bluetooth scan", { cause: error });
     }
 });
 exports.scanForDevices = scanForDevices;
@@ -111,8 +111,13 @@ Object.defineProperty(exports, "aesDecrypt", { enumerable: true, get: function (
 Object.defineProperty(exports, "aesEncrypt", { enumerable: true, get: function () { return bluetooth_protocol_1.aesEncrypt; } });
 Object.defineProperty(exports, "crc16Modbus", { enumerable: true, get: function () { return bluetooth_protocol_1.crc16Modbus; } });
 Object.defineProperty(exports, "createPacket", { enumerable: true, get: function () { return bluetooth_protocol_1.createPacket; } });
+Object.defineProperty(exports, "normalizeOperationTaggedPayload", { enumerable: true, get: function () { return bluetooth_protocol_1.normalizeOperationTaggedPayload; } });
 // Constants
 Object.defineProperty(exports, "NOTIFY_CHARACTERISTIC_UUID", { enumerable: true, get: function () { return bluetooth_protocol_1.NOTIFY_CHARACTERISTIC_UUID; } });
+Object.defineProperty(exports, "parseModbusOperationResponse", { enumerable: true, get: function () { return bluetooth_protocol_1.parseModbusOperationResponse; } });
+Object.defineProperty(exports, "parseOperationTaggedResponse", { enumerable: true, get: function () { return bluetooth_protocol_1.parseOperationTaggedResponse; } });
+Object.defineProperty(exports, "parseReadWifiStatusPayload", { enumerable: true, get: function () { return bluetooth_protocol_1.parseReadWifiStatusPayload; } });
+Object.defineProperty(exports, "parseReadWifiStatusResponse", { enumerable: true, get: function () { return bluetooth_protocol_1.parseReadWifiStatusResponse; } });
 Object.defineProperty(exports, "parseResponse", { enumerable: true, get: function () { return bluetooth_protocol_1.parseResponse; } });
 // Commands
 Object.defineProperty(exports, "parsers", { enumerable: true, get: function () { return bluetooth_protocol_1.parsers; } });

package/dist/cjs/src/cli.js

@@ -241,6 +241,11 @@ const createProgram = () => {
             description: "Retrieve Relax (comfort) mode status",
             getter: (api, jwtToken, mac) => api.getRelax(jwtToken, mac),
         },
+        {
+            commandName: "getSound",
+            description: "Retrieve control beep sound setting",
+            getter: (api, jwtToken, mac) => api.getSound(jwtToken, mac),
+        },
         {
             commandName: "getChronoMode",
             description: "Retrieve Chrono (scheduled programming) mode status",
@@ -379,6 +384,11 @@ const createProgram = () => {
             description: "Enable/disable Relax mode (1=on, 0=off)",
             setter: (api, jwtToken, mac, value) => api.setRelax(jwtToken, mac, value === 1),
         },
+        {
+            commandName: "setSound",
+            description: "Enable/disable control beep sounds (1=on, 0=off)",
+            setter: (api, jwtToken, mac, value) => api.setSound(jwtToken, mac, value === 1),
+        },
         {
             commandName: "setStandby",
             description: "Enable/disable Standby mode (1=on, 0=off)",

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

@@ -53,6 +53,18 @@ export declare const deriveAirkare: (deviceInfo: DeviceInfoType) => boolean;
  * const isRelaxActive = deriveRelax(info);
  */
 export declare const deriveRelax: (deviceInfo: DeviceInfoType) => boolean;
+/**
+ * Derives the sound (control beep) status from an existing DeviceInfo response.
+ * This is a pure function that extracts data without API calls.
+ *
+ * @param {DeviceInfoType} deviceInfo - The device info response object.
+ * @returns {boolean} - Whether control beep sounds are enabled.
+ *
+ * @example
+ * const info = await api.deviceInfo(token, mac);
+ * const isSoundActive = deriveSound(info);
+ */
+export declare const deriveSound: (deviceInfo: DeviceInfoType) => boolean;
 /**
  * Derives the Chrono mode status from an existing DeviceInfo response.
  * This is a pure function that extracts data without API calls.
@@ -311,6 +323,8 @@ declare const configure: (baseURL?: string) => {
     getAirkare: (jwtToken: string, macAddress: string) => Promise<boolean>;
     setRelax: (jwtToken: string, macAddress: string, enabled: boolean) => Promise<unknown>;
     getRelax: (jwtToken: string, macAddress: string) => Promise<boolean>;
+    setSound: (jwtToken: string, macAddress: string, enabled: boolean) => Promise<unknown>;
+    getSound: (jwtToken: string, macAddress: string) => Promise<boolean>;
     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>;

package/dist/cjs/src/library.js

@@ -42,7 +42,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.signIn = exports.headers = exports.getSession = exports.createAuthService = exports.configureAmplify = exports.configure = exports.derivePhaseDescription = exports.getPhaseDescription = exports.deriveUsageAnalytics = exports.deriveAlarmHistory = exports.deriveContinueCochleaLoading = exports.createWorkWeekSchedule = exports.setWeekendRange = exports.setWeekdayRange = exports.setScheduleRange = exports.createEmptySchedule = exports.indexToTime = exports.timeToIndex = exports.deriveEasyTimer = exports.deriveChronoMode = exports.deriveRelax = exports.deriveAirkare = void 0;
+exports.signIn = exports.headers = exports.getSession = exports.createAuthService = exports.configureAmplify = exports.configure = exports.derivePhaseDescription = exports.getPhaseDescription = exports.deriveUsageAnalytics = exports.deriveAlarmHistory = exports.deriveContinueCochleaLoading = exports.createWorkWeekSchedule = exports.setWeekendRange = exports.setWeekdayRange = exports.setScheduleRange = exports.createEmptySchedule = exports.indexToTime = exports.timeToIndex = exports.deriveEasyTimer = exports.deriveChronoMode = exports.deriveSound = exports.deriveRelax = exports.deriveAirkare = void 0;
 const assert_1 = require("assert");
 const aws_amplify_1 = require("aws-amplify");
 const amplifyAuth = __importStar(require("aws-amplify/auth"));
@@ -348,6 +348,46 @@ const getRelax = (baseURL) =>
     const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
     return (0, exports.deriveRelax)(info);
 });
+const setSound = (baseURL) => 
+/**
+ * Enables or disables control beep sounds.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @param {boolean} enabled - Whether to enable sound.
+ * @returns {Promise<unknown>} - A promise that resolves to the command response.
+ */
+(jwtToken, macAddress, enabled) => mqttCommand(baseURL)(jwtToken, macAddress, {
+    name: "radio_control_sound",
+    value: enabled,
+});
+/**
+ * Derives the sound (control beep) status from an existing DeviceInfo response.
+ * This is a pure function that extracts data without API calls.
+ *
+ * @param {DeviceInfoType} deviceInfo - The device info response object.
+ * @returns {boolean} - Whether control beep sounds are enabled.
+ *
+ * @example
+ * const info = await api.deviceInfo(token, mac);
+ * const isSoundActive = deriveSound(info);
+ */
+const deriveSound = (deviceInfo) => {
+    return deviceInfo.nvm.user_parameters.is_sound_active;
+};
+exports.deriveSound = deriveSound;
+const getSound = (baseURL) => 
+/**
+ * Retrieves the current sound (control beep) setting.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<boolean>} - A promise that resolves to the sound status.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
+    return (0, exports.deriveSound)(info);
+});
 const setStandby = (baseURL) => 
 /**
  * Enables or disables Standby mode.
@@ -1413,6 +1453,8 @@ const configure = (baseURL = constants_1.API_URL) => ({
     getAirkare: getAirkare(baseURL),
     setRelax: setRelax(baseURL),
     getRelax: getRelax(baseURL),
+    setSound: setSound(baseURL),
+    getSound: getSound(baseURL),
     setStandby: setStandby(baseURL),
     getStandby: getStandby(baseURL),
     setStandbyTime: setStandbyTime(baseURL),

package/dist/cjs/src/library.test.js

@@ -202,6 +202,8 @@ describe("library", () => {
             "getAirkare",
             "setRelax",
             "getRelax",
+            "setSound",
+            "getSound",
             "setStandby",
             "getStandby",
             "setStandbyTime",
@@ -308,6 +310,7 @@ describe("library", () => {
                     standby_waiting_time: 30,
                     is_auto: true,
                     is_fahrenheit: false,
+                    is_sound_active: true,
                     language: 2,
                 },
             },
@@ -449,6 +452,11 @@ describe("library", () => {
                 call: (api, token, mac) => api.getRelax(token, mac),
                 expectedResult: false,
             },
+            {
+                method: "getSound",
+                call: (api, token, mac) => api.getSound(token, mac),
+                expectedResult: true,
+            },
             {
                 method: "getChronoMode",
                 call: (api, token, mac) => api.getChronoMode(token, mac),
@@ -596,6 +604,12 @@ describe("library", () => {
                 truePayload: { name: "relax_mode", value: true },
                 falsePayload: { name: "relax_mode", value: false },
             },
+            {
+                method: "setSound",
+                call: (api, token, mac, enabled) => api.setSound(token, mac, enabled),
+                truePayload: { name: "radio_control_sound", value: true },
+                falsePayload: { name: "radio_control_sound", value: false },
+            },
             {
                 method: "setStandby",
                 call: (api, token, mac, enabled) => api.setStandby(token, mac, enabled),
@@ -1417,7 +1431,7 @@ describe("library", () => {
                 easytimer: { time: 30 },
             },
             nvm: {
-                user_parameters: {},
+                user_parameters: { is_sound_active: true },
                 total_counters: {},
                 service_counters: {},
                 alarms_log: { number: 0, index: 0, alarms: [] },
@@ -1434,6 +1448,11 @@ describe("library", () => {
             const result = (0, library_1.deriveRelax)(mockDeviceInfoForModes);
             assert_1.strict.equal(result, false);
         });
+        it("should derive Sound status from device info", () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const result = (0, library_1.deriveSound)(mockDeviceInfoForModes);
+            assert_1.strict.equal(result, true);
+        });
         it("should derive Chrono mode status from device info", () => {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const result = (0, library_1.deriveChronoMode)(mockDeviceInfoForModes);

package/dist/esm/package.json

@@ -1,6 +1,6 @@
 {
     "name": "edilkamin",
-    "version": "1.14.1",
+    "version": "1.15.0",
     "description": "",
     "main": "dist/cjs/src/index.js",
     "module": "dist/esm/src/index.js",
@@ -32,6 +32,7 @@
         "cli:debug": "node --inspect --require ts-node/register/transpile-only src/cli.ts",
         "test": "nyc mocha --require ts-node/register src/*.test.ts",
         "test:debug": "nyc mocha --require ts-node/register/transpile-only --inspect src/*.test.ts",
+        "test:cjs-consumer": "node -e \"const pkg = require('./dist/cjs/src/index.js'); if (typeof pkg.configure !== 'function') throw new Error('configure export missing');\"",
         "lint:prettier": "prettier --check src docs .github *.json *.md *.mjs",
         "format:prettier": "prettier --write src docs .github *.json *.md *.mjs",
         "lint:eslint": "eslint src",
@@ -68,7 +69,7 @@
     },
     "devDependencies": {
         "@eslint/eslintrc": "^3.2.0",
-        "@eslint/js": "^9.16.0",
+        "@eslint/js": "^10.0.1",
         "@types/mocha": "^10.0.10",
         "@types/node": "^24",
         "@types/pako": "^2.0.4",
@@ -76,18 +77,18 @@
         "@types/web-bluetooth": "^0.0.21",
         "@typescript-eslint/eslint-plugin": "^8.17.0",
         "@typescript-eslint/parser": "^8.17.0",
-        "esbuild": "^0.27.1",
-        "eslint": "^9.16.0",
+        "esbuild": "^0.28.0",
+        "eslint": "^10.0.3",
         "eslint-config-prettier": "^10.1.8",
         "eslint-plugin-prettier": "^5.2.1",
-        "eslint-plugin-simple-import-sort": "^12.1.1",
+        "eslint-plugin-simple-import-sort": "^13.0.0",
         "mocha": "^11.7.5",
-        "nyc": "^17.1.0",
+        "nyc": "^18.0.0",
         "prettier": "^3.7.4",
         "sinon": "^21.0.1",
         "ts-node": "^10.9.1",
         "typedoc": "^0.28.15",
-        "typescript": "^5.7.2"
+        "typescript": "^6.0.3"
     },
     "optionalDependencies": {
         "commander": "^14.0.2"