edilkamin 1.9.0 → 1.10.1

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
     "name": "edilkamin",
-    "version": "1.9.0",
+    "version": "1.10.1",
     "description": "",
     "main": "dist/cjs/src/index.js",
     "module": "dist/esm/src/index.js",

package/dist/cjs/src/cli.js

@@ -20,6 +20,7 @@ const package_json_1 = require("../package.json");
 const constants_1 = require("./constants");
 const library_1 = require("./library");
 const token_storage_1 = require("./token-storage");
+const types_1 = require("./types");
 const promptPassword = () => {
     const rl = readline_1.default.createInterface({
         input: process.stdin,
@@ -164,9 +165,9 @@ const createProgram = () => {
             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",
@@ -228,6 +229,84 @@ const createProgram = () => {
             description: "Retrieve estimated pellet autonomy time",
             getter: (api, jwtToken, mac) => api.getPelletAutonomyTime(jwtToken, mac),
         },
+        // Statistics getters
+        {
+            commandName: "getTotalCounters",
+            description: "Get lifetime operating counters (power-ons, runtime by power level)",
+            getter: (api, jwtToken, mac) => api.getTotalCounters(jwtToken, mac),
+        },
+        {
+            commandName: "getServiceCounters",
+            description: "Get service counters (runtime since last maintenance)",
+            getter: (api, jwtToken, mac) => api.getServiceCounters(jwtToken, mac),
+        },
+        {
+            commandName: "getRegenerationData",
+            description: "Get regeneration and maintenance data",
+            getter: (api, jwtToken, mac) => api.getRegenerationData(jwtToken, mac),
+        },
+        {
+            commandName: "getServiceTime",
+            description: "Get total service time in hours",
+            getter: (api, jwtToken, mac) => api.getServiceTime(jwtToken, mac),
+        },
+        // Analytics getters
+        {
+            commandName: "getTotalOperatingHours",
+            description: "Get total operating hours across all power levels",
+            getter: (api, jwtToken, mac) => api.getTotalOperatingHours(jwtToken, mac),
+        },
+        {
+            commandName: "getPowerDistribution",
+            description: "Get power level usage distribution as percentages",
+            getter: (api, jwtToken, mac) => __awaiter(void 0, void 0, void 0, function* () {
+                const result = yield api.getPowerDistribution(jwtToken, mac);
+                return {
+                    p1: `${result.p1.toFixed(1)}%`,
+                    p2: `${result.p2.toFixed(1)}%`,
+                    p3: `${result.p3.toFixed(1)}%`,
+                    p4: `${result.p4.toFixed(1)}%`,
+                    p5: `${result.p5.toFixed(1)}%`,
+                };
+            }),
+        },
+        {
+            commandName: "getServiceStatus",
+            description: "Get service status including whether maintenance is due",
+            getter: (api, jwtToken, mac) => api.getServiceStatus(jwtToken, mac),
+        },
+        {
+            commandName: "getUsageAnalytics",
+            description: "Get comprehensive usage analytics in single response",
+            getter: (api, jwtToken, mac) => __awaiter(void 0, void 0, void 0, function* () {
+                var _a;
+                const analytics = yield api.getUsageAnalytics(jwtToken, mac);
+                return {
+                    lifetime: {
+                        powerOnCount: analytics.totalPowerOns,
+                        totalOperatingHours: analytics.totalOperatingHours,
+                        blackoutCount: analytics.blackoutCount,
+                    },
+                    powerDistribution: {
+                        p1: `${analytics.powerDistribution.p1.toFixed(1)}%`,
+                        p2: `${analytics.powerDistribution.p2.toFixed(1)}%`,
+                        p3: `${analytics.powerDistribution.p3.toFixed(1)}%`,
+                        p4: `${analytics.powerDistribution.p4.toFixed(1)}%`,
+                        p5: `${analytics.powerDistribution.p5.toFixed(1)}%`,
+                    },
+                    service: {
+                        totalServiceHours: analytics.serviceStatus.totalServiceHours,
+                        hoursSinceLastService: analytics.serviceStatus.hoursSinceService,
+                        thresholdHours: analytics.serviceStatus.serviceThresholdHours,
+                        isServiceDue: analytics.serviceStatus.isServiceDue,
+                        lastMaintenanceDate: ((_a = analytics.lastMaintenanceDate) === null || _a === void 0 ? void 0 : _a.toISOString()) || "Never",
+                    },
+                    alarms: {
+                        totalCount: analytics.alarmCount,
+                    },
+                };
+            }),
+        },
     ].forEach(({ commandName, description, getter }) => {
         addLegacyOption(addMacOption(addAuthOptions(program.command(commandName).description(description)))).action((options) => executeGetter(options, getter));
     });
@@ -244,9 +323,9 @@ const createProgram = () => {
             setter: (api, jwtToken, mac, value) => api.setPowerLevel(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: "setEnvironment1Temperature",
+            description: "Set Environment 1 target temperature (degrees Celsius)",
+            setter: (api, jwtToken, mac, value) => api.setEnvironment1Temperature(jwtToken, mac, value),
         },
         {
             commandName: "setFan1Speed",
@@ -311,6 +390,130 @@ const createProgram = () => {
     ].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));
+    }));
+    // Alarm history command with human-readable descriptions
+    addLegacyOption(addMacOption(addAuthOptions(program
+        .command("getAlarmHistory")
+        .description("Get alarm history log with human-readable descriptions")))).action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const { username, password, mac, 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.getAlarmHistory(jwtToken, normalizedMac);
+        // Format alarms with human-readable descriptions
+        const formattedAlarms = result.alarms.map((alarm) => (Object.assign(Object.assign({}, alarm), { typeName: types_1.AlarmCode[alarm.type] || "UNKNOWN", description: types_1.AlarmDescriptions[alarm.type] || "Unknown alarm", date: new Date(alarm.timestamp * 1000).toISOString() })));
+        console.log(JSON.stringify(Object.assign(Object.assign({}, result), { alarms: formattedAlarms }), null, 2));
+    }));
     // Command: register
     addLegacyOption(addAuthOptions(program
         .command("register")

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

@@ -3,5 +3,6 @@ export { decompressBuffer, isBuffer, processResponse } from "./buffer-utils";
 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 { AlarmEntryType, AlarmsLogType, BufferEncodedType, CommandsType, DeviceAssociationBody, DeviceAssociationResponse, DeviceInfoRawType, DeviceInfoType, DiscoveredDevice, EditDeviceAssociationBody, PowerDistributionType, RegenerationDataType, ServiceCountersType, ServiceStatusType, StatusCountersType, StatusType, TemperaturesType, TotalCountersType, UsageAnalyticsType, UserParametersType, } from "./types";
+export { AlarmCode, AlarmDescriptions } 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, envIndex: 1 | 2 | 3) => Promise<number>, setTargetTemperature: (jwtToken: string, macAddress: string, envIndex: 1 | 2 | 3, temperature: number) => Promise<unknown>;

package/dist/cjs/src/index.js

@@ -1,7 +1,7 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setTargetTemperature = exports.getTargetTemperature = exports.getEnvironmentTemperature = exports.getPower = exports.setPowerOn = exports.setPowerOff = exports.setPower = exports.editDevice = exports.registerDevice = exports.deviceInfo = exports.serialNumberToHex = exports.serialNumberFromHex = exports.serialNumberDisplay = exports.signIn = exports.getSession = exports.configure = exports.OLD_API_URL = exports.NEW_API_URL = exports.API_URL = exports.processResponse = exports.isBuffer = exports.decompressBuffer = exports.bleToWifiMac = void 0;
+exports.setTargetTemperature = exports.getTargetTemperature = exports.getEnvironmentTemperature = exports.getPower = exports.setPowerOn = exports.setPowerOff = exports.setPower = exports.editDevice = exports.registerDevice = exports.deviceInfo = exports.AlarmDescriptions = exports.AlarmCode = exports.serialNumberToHex = exports.serialNumberFromHex = exports.serialNumberDisplay = exports.signIn = exports.getSession = exports.configure = exports.OLD_API_URL = exports.NEW_API_URL = exports.API_URL = exports.processResponse = exports.isBuffer = exports.decompressBuffer = exports.bleToWifiMac = void 0;
 const library_1 = require("./library");
 var bluetooth_utils_1 = require("./bluetooth-utils");
 Object.defineProperty(exports, "bleToWifiMac", { enumerable: true, get: function () { return bluetooth_utils_1.bleToWifiMac; } });
@@ -21,4 +21,7 @@ var serial_utils_1 = require("./serial-utils");
 Object.defineProperty(exports, "serialNumberDisplay", { enumerable: true, get: function () { return serial_utils_1.serialNumberDisplay; } });
 Object.defineProperty(exports, "serialNumberFromHex", { enumerable: true, get: function () { return serial_utils_1.serialNumberFromHex; } });
 Object.defineProperty(exports, "serialNumberToHex", { enumerable: true, get: function () { return serial_utils_1.serialNumberToHex; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "AlarmCode", { enumerable: true, get: function () { return types_1.AlarmCode; } });
+Object.defineProperty(exports, "AlarmDescriptions", { enumerable: true, get: function () { return types_1.AlarmDescriptions; } });
 _a = (0, library_1.configure)(), exports.deviceInfo = _a.deviceInfo, exports.registerDevice = _a.registerDevice, exports.editDevice = _a.editDevice, exports.setPower = _a.setPower, exports.setPowerOff = _a.setPowerOff, exports.setPowerOn = _a.setPowerOn, exports.getPower = _a.getPower, exports.getEnvironmentTemperature = _a.getEnvironmentTemperature, exports.getTargetTemperature = _a.getTargetTemperature, exports.setTargetTemperature = _a.setTargetTemperature;

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

@@ -1,5 +1,5 @@
 import * as amplifyAuth from "aws-amplify/auth";
-import { DeviceAssociationResponse, DeviceInfoType } from "./types";
+import { AlarmsLogType, DeviceAssociationResponse, DeviceInfoType, PowerDistributionType, RegenerationDataType, ServiceCountersType, ServiceStatusType, TotalCountersType, UsageAnalyticsType } from "./types";
 /**
  * Generates headers with a JWT token for authenticated requests.
  * @param {string} jwtToken - The JWT token for authorization.
@@ -50,6 +50,8 @@ declare const configure: (baseURL?: string) => {
     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>;
@@ -65,8 +67,10 @@ declare const configure: (baseURL?: string) => {
     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>;
@@ -77,5 +81,14 @@ declare const configure: (baseURL?: string) => {
     getLanguage: (jwtToken: string, macAddress: string) => Promise<number>;
     getPelletInReserve: (jwtToken: string, macAddress: string) => Promise<boolean>;
     getPelletAutonomyTime: (jwtToken: string, macAddress: string) => Promise<number>;
+    getTotalCounters: (jwtToken: string, macAddress: string) => Promise<TotalCountersType>;
+    getServiceCounters: (jwtToken: string, macAddress: string) => Promise<ServiceCountersType>;
+    getAlarmHistory: (jwtToken: string, macAddress: string) => Promise<AlarmsLogType>;
+    getRegenerationData: (jwtToken: string, macAddress: string) => Promise<RegenerationDataType>;
+    getServiceTime: (jwtToken: string, macAddress: string) => Promise<number>;
+    getTotalOperatingHours: (jwtToken: string, macAddress: string) => Promise<number>;
+    getPowerDistribution: (jwtToken: string, macAddress: string) => Promise<PowerDistributionType>;
+    getServiceStatus: (jwtToken: string, macAddress: string, thresholdHours?: number) => Promise<ServiceStatusType>;
+    getUsageAnalytics: (jwtToken: string, macAddress: string, serviceThreshold?: number) => Promise<UsageAnalyticsType>;
 };
 export { configure, configureAmplify, createAuthService, getSession, headers, signIn, };