edilkamin 1.10.1 → 1.10.2

package/dist/cjs/package.json

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

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

@@ -1,7 +1,7 @@
 export { bleToWifiMac } from "./bluetooth-utils";
 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 { configure, deriveUsageAnalytics, getSession, signIn } from "./library";
 export { serialNumberDisplay, serialNumberFromHex, serialNumberToHex, } from "./serial-utils";
 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";

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.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;
+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.deriveUsageAnalytics = 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; } });
@@ -15,6 +15,7 @@ Object.defineProperty(exports, "NEW_API_URL", { enumerable: true, get: function
 Object.defineProperty(exports, "OLD_API_URL", { enumerable: true, get: function () { return constants_1.OLD_API_URL; } });
 var library_2 = require("./library");
 Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return library_2.configure; } });
+Object.defineProperty(exports, "deriveUsageAnalytics", { enumerable: true, get: function () { return library_2.deriveUsageAnalytics; } });
 Object.defineProperty(exports, "getSession", { enumerable: true, get: function () { return library_2.getSession; } });
 Object.defineProperty(exports, "signIn", { enumerable: true, get: function () { return library_2.signIn; } });
 var serial_utils_1 = require("./serial-utils");

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

@@ -29,6 +29,22 @@ declare const createAuthService: (auth: typeof amplifyAuth) => {
     getSession: (forceRefresh?: boolean, legacy?: boolean) => Promise<string>;
 };
 declare const signIn: (username: string, password: string, legacy?: boolean) => Promise<string>, getSession: (forceRefresh?: boolean, legacy?: boolean) => Promise<string>;
+/**
+ * Derives usage analytics from an existing DeviceInfo response.
+ * This is a pure function that performs client-side calculations without API calls.
+ *
+ * Use this when you already have a DeviceInfo object (e.g., from a previous deviceInfo() call)
+ * to avoid making an additional API request.
+ *
+ * @param {DeviceInfoType} deviceInfo - The device info response object.
+ * @param {number} [serviceThreshold=2000] - Service threshold in hours.
+ * @returns {UsageAnalyticsType} - Comprehensive usage analytics.
+ *
+ * @example
+ * const info = await api.deviceInfo(token, mac);
+ * const analytics = deriveUsageAnalytics(info);
+ */
+export declare const deriveUsageAnalytics: (deviceInfo: DeviceInfoType, serviceThreshold?: number) => UsageAnalyticsType;
 /**
  * Configures the library for API interactions.
  * Initializes API methods with a specified base URL.

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 = void 0;
+exports.signIn = exports.headers = exports.getSession = exports.createAuthService = exports.configureAmplify = exports.configure = exports.deriveUsageAnalytics = void 0;
 const assert_1 = require("assert");
 const aws_amplify_1 = require("aws-amplify");
 const amplifyAuth = __importStar(require("aws-amplify/auth"));
@@ -584,6 +584,63 @@ const getServiceTime = (baseURL) =>
  * Most devices use 2000 hours.
  */
 const DEFAULT_SERVICE_THRESHOLD = 2000;
+/**
+ * Derives usage analytics from an existing DeviceInfo response.
+ * This is a pure function that performs client-side calculations without API calls.
+ *
+ * Use this when you already have a DeviceInfo object (e.g., from a previous deviceInfo() call)
+ * to avoid making an additional API request.
+ *
+ * @param {DeviceInfoType} deviceInfo - The device info response object.
+ * @param {number} [serviceThreshold=2000] - Service threshold in hours.
+ * @returns {UsageAnalyticsType} - Comprehensive usage analytics.
+ *
+ * @example
+ * const info = await api.deviceInfo(token, mac);
+ * const analytics = deriveUsageAnalytics(info);
+ */
+const deriveUsageAnalytics = (deviceInfo, serviceThreshold = DEFAULT_SERVICE_THRESHOLD) => {
+    const totalCounters = deviceInfo.nvm.total_counters;
+    const serviceCounters = deviceInfo.nvm.service_counters;
+    const regeneration = deviceInfo.nvm.regeneration;
+    const alarmsLog = deviceInfo.nvm.alarms_log;
+    const totalOperatingHours = totalCounters.p1_working_time +
+        totalCounters.p2_working_time +
+        totalCounters.p3_working_time +
+        totalCounters.p4_working_time +
+        totalCounters.p5_working_time;
+    const hoursSinceService = serviceCounters.p1_working_time +
+        serviceCounters.p2_working_time +
+        serviceCounters.p3_working_time +
+        serviceCounters.p4_working_time +
+        serviceCounters.p5_working_time;
+    const powerDistribution = totalOperatingHours === 0
+        ? { p1: 0, p2: 0, p3: 0, p4: 0, p5: 0 }
+        : {
+            p1: (totalCounters.p1_working_time / totalOperatingHours) * 100,
+            p2: (totalCounters.p2_working_time / totalOperatingHours) * 100,
+            p3: (totalCounters.p3_working_time / totalOperatingHours) * 100,
+            p4: (totalCounters.p4_working_time / totalOperatingHours) * 100,
+            p5: (totalCounters.p5_working_time / totalOperatingHours) * 100,
+        };
+    return {
+        totalPowerOns: totalCounters.power_ons,
+        totalOperatingHours,
+        powerDistribution,
+        serviceStatus: {
+            totalServiceHours: deviceInfo.status.counters.service_time,
+            hoursSinceService,
+            serviceThresholdHours: serviceThreshold,
+            isServiceDue: hoursSinceService >= serviceThreshold,
+        },
+        blackoutCount: regeneration.blackout_counter,
+        lastMaintenanceDate: regeneration.last_intervention > 0
+            ? new Date(regeneration.last_intervention * 1000)
+            : null,
+        alarmCount: alarmsLog.number,
+    };
+};
+exports.deriveUsageAnalytics = deriveUsageAnalytics;
 const getTotalOperatingHours = (baseURL) => 
 /**
  * Calculates total operating hours across all power levels.
@@ -662,45 +719,7 @@ const getUsageAnalytics = (baseURL) =>
  */
 (jwtToken_1, macAddress_1, ...args_1) => __awaiter(void 0, [jwtToken_1, macAddress_1, ...args_1], void 0, function* (jwtToken, macAddress, serviceThreshold = DEFAULT_SERVICE_THRESHOLD) {
     const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
-    const totalCounters = info.nvm.total_counters;
-    const serviceCounters = info.nvm.service_counters;
-    const regeneration = info.nvm.regeneration;
-    const alarmsLog = info.nvm.alarms_log;
-    const totalOperatingHours = totalCounters.p1_working_time +
-        totalCounters.p2_working_time +
-        totalCounters.p3_working_time +
-        totalCounters.p4_working_time +
-        totalCounters.p5_working_time;
-    const hoursSinceService = serviceCounters.p1_working_time +
-        serviceCounters.p2_working_time +
-        serviceCounters.p3_working_time +
-        serviceCounters.p4_working_time +
-        serviceCounters.p5_working_time;
-    const powerDistribution = totalOperatingHours === 0
-        ? { p1: 0, p2: 0, p3: 0, p4: 0, p5: 0 }
-        : {
-            p1: (totalCounters.p1_working_time / totalOperatingHours) * 100,
-            p2: (totalCounters.p2_working_time / totalOperatingHours) * 100,
-            p3: (totalCounters.p3_working_time / totalOperatingHours) * 100,
-            p4: (totalCounters.p4_working_time / totalOperatingHours) * 100,
-            p5: (totalCounters.p5_working_time / totalOperatingHours) * 100,
-        };
-    return {
-        totalPowerOns: totalCounters.power_ons,
-        totalOperatingHours,
-        powerDistribution,
-        serviceStatus: {
-            totalServiceHours: info.status.counters.service_time,
-            hoursSinceService,
-            serviceThresholdHours: serviceThreshold,
-            isServiceDue: hoursSinceService >= serviceThreshold,
-        },
-        blackoutCount: regeneration.blackout_counter,
-        lastMaintenanceDate: regeneration.last_intervention > 0
-            ? new Date(regeneration.last_intervention * 1000)
-            : null,
-        alarmCount: alarmsLog.number,
-    };
+    return (0, exports.deriveUsageAnalytics)(info, serviceThreshold);
 });
 const registerDevice = (baseURL) => 
 /**

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

@@ -1014,6 +1014,139 @@ describe("library", () => {
             assert_1.strict.equal(result.lastMaintenanceDate, null);
         }));
     });
+    describe("deriveUsageAnalytics", () => {
+        const mockDeviceInfoForDerive = {
+            status: {
+                commands: {
+                    power: false,
+                },
+                temperatures: {
+                    enviroment: 20,
+                    set_air: 21,
+                    get_air: 20,
+                    set_water: 40,
+                    get_water: 35,
+                },
+                counters: {
+                    service_time: 1108,
+                },
+                flags: {
+                    is_pellet_in_reserve: false,
+                },
+                pellet: {
+                    autonomy_time: 180,
+                },
+            },
+            nvm: {
+                user_parameters: {
+                    language: 1,
+                    is_auto: false,
+                    is_fahrenheit: false,
+                    is_sound_active: false,
+                    enviroment_1_temperature: 19,
+                    enviroment_2_temperature: 20,
+                    enviroment_3_temperature: 20,
+                    manual_power: 1,
+                    fan_1_ventilation: 3,
+                    fan_2_ventilation: 0,
+                    fan_3_ventilation: 0,
+                    is_standby_active: false,
+                    standby_waiting_time: 60,
+                },
+                total_counters: {
+                    power_ons: 278,
+                    p1_working_time: 833,
+                    p2_working_time: 15,
+                    p3_working_time: 19,
+                    p4_working_time: 8,
+                    p5_working_time: 17,
+                },
+                service_counters: {
+                    p1_working_time: 100,
+                    p2_working_time: 10,
+                    p3_working_time: 5,
+                    p4_working_time: 2,
+                    p5_working_time: 1,
+                },
+                regeneration: {
+                    time: 0,
+                    last_intervention: 1577836800,
+                    daylight_time_flag: 0,
+                    blackout_counter: 43,
+                    airkare_working_hours_counter: 0,
+                },
+                alarms_log: {
+                    number: 6,
+                    index: 6,
+                    alarms: [],
+                },
+            },
+        };
+        it("should derive analytics from device info without API call", () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = (0, library_1.deriveUsageAnalytics)(mockDeviceInfoForDerive);
+            assert_1.strict.equal(analytics.totalPowerOns, 278);
+            assert_1.strict.equal(analytics.totalOperatingHours, 892); // 833+15+19+8+17
+            assert_1.strict.equal(analytics.blackoutCount, 43);
+            assert_1.strict.equal(analytics.alarmCount, 6);
+        });
+        it("should calculate power distribution correctly", () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = (0, library_1.deriveUsageAnalytics)(mockDeviceInfoForDerive);
+            // P1: 833/892 ≈ 93.4%
+            assert_1.strict.ok(analytics.powerDistribution.p1 > 93);
+            assert_1.strict.ok(analytics.powerDistribution.p1 < 94);
+            // Sum should be 100%
+            const sum = Object.values(analytics.powerDistribution).reduce((a, b) => a + b, 0);
+            assert_1.strict.ok(Math.abs(sum - 100) < 0.001);
+        });
+        it("should handle zero operating hours", () => {
+            const zeroHoursInfo = Object.assign(Object.assign({}, mockDeviceInfoForDerive), { nvm: Object.assign(Object.assign({}, mockDeviceInfoForDerive.nvm), { total_counters: {
+                        power_ons: 0,
+                        p1_working_time: 0,
+                        p2_working_time: 0,
+                        p3_working_time: 0,
+                        p4_working_time: 0,
+                        p5_working_time: 0,
+                    } }) });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = (0, library_1.deriveUsageAnalytics)(zeroHoursInfo);
+            assert_1.strict.deepEqual(analytics.powerDistribution, {
+                p1: 0,
+                p2: 0,
+                p3: 0,
+                p4: 0,
+                p5: 0,
+            });
+        });
+        it("should respect custom service threshold", () => {
+            const analytics = (0, library_1.deriveUsageAnalytics)(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            mockDeviceInfoForDerive, 100);
+            // 118 hours since service >= 100 threshold
+            assert_1.strict.equal(analytics.serviceStatus.isServiceDue, true);
+            assert_1.strict.equal(analytics.serviceStatus.serviceThresholdHours, 100);
+        });
+        it("should use default threshold of 2000 hours", () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = (0, library_1.deriveUsageAnalytics)(mockDeviceInfoForDerive);
+            assert_1.strict.equal(analytics.serviceStatus.serviceThresholdHours, 2000);
+            assert_1.strict.equal(analytics.serviceStatus.isServiceDue, false); // 118 < 2000
+        });
+        it("should convert last_intervention timestamp to Date", () => {
+            var _a;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = (0, library_1.deriveUsageAnalytics)(mockDeviceInfoForDerive);
+            assert_1.strict.ok(analytics.lastMaintenanceDate instanceof Date);
+            assert_1.strict.equal((_a = analytics.lastMaintenanceDate) === null || _a === void 0 ? void 0 : _a.getTime(), 1577836800 * 1000);
+        });
+        it("should return null for lastMaintenanceDate when timestamp is 0", () => {
+            const noMaintenanceInfo = Object.assign(Object.assign({}, mockDeviceInfoForDerive), { nvm: Object.assign(Object.assign({}, mockDeviceInfoForDerive.nvm), { regeneration: Object.assign(Object.assign({}, mockDeviceInfoForDerive.nvm.regeneration), { last_intervention: 0 }) }) });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = (0, library_1.deriveUsageAnalytics)(noMaintenanceInfo);
+            assert_1.strict.equal(analytics.lastMaintenanceDate, null);
+        });
+    });
     describe("Error Handling", () => {
         const errorTests = [
             { status: 400, statusText: "Bad Request" },

package/dist/esm/package.json

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

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

@@ -1,7 +1,7 @@
 export { bleToWifiMac } from "./bluetooth-utils";
 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 { configure, deriveUsageAnalytics, getSession, signIn } from "./library";
 export { serialNumberDisplay, serialNumberFromHex, serialNumberToHex, } from "./serial-utils";
 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";

package/dist/esm/src/index.js

@@ -2,7 +2,7 @@ import { configure } from "./library";
 export { bleToWifiMac } from "./bluetooth-utils";
 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 { configure, deriveUsageAnalytics, getSession, signIn } from "./library";
 export { serialNumberDisplay, serialNumberFromHex, serialNumberToHex, } from "./serial-utils";
 export { AlarmCode, AlarmDescriptions } from "./types";
 export const { deviceInfo, registerDevice, editDevice, setPower, setPowerOff, setPowerOn, getPower, getEnvironmentTemperature, getTargetTemperature, setTargetTemperature, } = configure();

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

@@ -29,6 +29,22 @@ declare const createAuthService: (auth: typeof amplifyAuth) => {
     getSession: (forceRefresh?: boolean, legacy?: boolean) => Promise<string>;
 };
 declare const signIn: (username: string, password: string, legacy?: boolean) => Promise<string>, getSession: (forceRefresh?: boolean, legacy?: boolean) => Promise<string>;
+/**
+ * Derives usage analytics from an existing DeviceInfo response.
+ * This is a pure function that performs client-side calculations without API calls.
+ *
+ * Use this when you already have a DeviceInfo object (e.g., from a previous deviceInfo() call)
+ * to avoid making an additional API request.
+ *
+ * @param {DeviceInfoType} deviceInfo - The device info response object.
+ * @param {number} [serviceThreshold=2000] - Service threshold in hours.
+ * @returns {UsageAnalyticsType} - Comprehensive usage analytics.
+ *
+ * @example
+ * const info = await api.deviceInfo(token, mac);
+ * const analytics = deriveUsageAnalytics(info);
+ */
+export declare const deriveUsageAnalytics: (deviceInfo: DeviceInfoType, serviceThreshold?: number) => UsageAnalyticsType;
 /**
  * Configures the library for API interactions.
  * Initializes API methods with a specified base URL.

package/dist/esm/src/library.js

@@ -543,6 +543,62 @@ const getServiceTime = (baseURL) =>
  * Most devices use 2000 hours.
  */
 const DEFAULT_SERVICE_THRESHOLD = 2000;
+/**
+ * Derives usage analytics from an existing DeviceInfo response.
+ * This is a pure function that performs client-side calculations without API calls.
+ *
+ * Use this when you already have a DeviceInfo object (e.g., from a previous deviceInfo() call)
+ * to avoid making an additional API request.
+ *
+ * @param {DeviceInfoType} deviceInfo - The device info response object.
+ * @param {number} [serviceThreshold=2000] - Service threshold in hours.
+ * @returns {UsageAnalyticsType} - Comprehensive usage analytics.
+ *
+ * @example
+ * const info = await api.deviceInfo(token, mac);
+ * const analytics = deriveUsageAnalytics(info);
+ */
+export const deriveUsageAnalytics = (deviceInfo, serviceThreshold = DEFAULT_SERVICE_THRESHOLD) => {
+    const totalCounters = deviceInfo.nvm.total_counters;
+    const serviceCounters = deviceInfo.nvm.service_counters;
+    const regeneration = deviceInfo.nvm.regeneration;
+    const alarmsLog = deviceInfo.nvm.alarms_log;
+    const totalOperatingHours = totalCounters.p1_working_time +
+        totalCounters.p2_working_time +
+        totalCounters.p3_working_time +
+        totalCounters.p4_working_time +
+        totalCounters.p5_working_time;
+    const hoursSinceService = serviceCounters.p1_working_time +
+        serviceCounters.p2_working_time +
+        serviceCounters.p3_working_time +
+        serviceCounters.p4_working_time +
+        serviceCounters.p5_working_time;
+    const powerDistribution = totalOperatingHours === 0
+        ? { p1: 0, p2: 0, p3: 0, p4: 0, p5: 0 }
+        : {
+            p1: (totalCounters.p1_working_time / totalOperatingHours) * 100,
+            p2: (totalCounters.p2_working_time / totalOperatingHours) * 100,
+            p3: (totalCounters.p3_working_time / totalOperatingHours) * 100,
+            p4: (totalCounters.p4_working_time / totalOperatingHours) * 100,
+            p5: (totalCounters.p5_working_time / totalOperatingHours) * 100,
+        };
+    return {
+        totalPowerOns: totalCounters.power_ons,
+        totalOperatingHours,
+        powerDistribution,
+        serviceStatus: {
+            totalServiceHours: deviceInfo.status.counters.service_time,
+            hoursSinceService,
+            serviceThresholdHours: serviceThreshold,
+            isServiceDue: hoursSinceService >= serviceThreshold,
+        },
+        blackoutCount: regeneration.blackout_counter,
+        lastMaintenanceDate: regeneration.last_intervention > 0
+            ? new Date(regeneration.last_intervention * 1000)
+            : null,
+        alarmCount: alarmsLog.number,
+    };
+};
 const getTotalOperatingHours = (baseURL) => 
 /**
  * Calculates total operating hours across all power levels.
@@ -621,45 +677,7 @@ const getUsageAnalytics = (baseURL) =>
  */
 (jwtToken_1, macAddress_1, ...args_1) => __awaiter(void 0, [jwtToken_1, macAddress_1, ...args_1], void 0, function* (jwtToken, macAddress, serviceThreshold = DEFAULT_SERVICE_THRESHOLD) {
     const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
-    const totalCounters = info.nvm.total_counters;
-    const serviceCounters = info.nvm.service_counters;
-    const regeneration = info.nvm.regeneration;
-    const alarmsLog = info.nvm.alarms_log;
-    const totalOperatingHours = totalCounters.p1_working_time +
-        totalCounters.p2_working_time +
-        totalCounters.p3_working_time +
-        totalCounters.p4_working_time +
-        totalCounters.p5_working_time;
-    const hoursSinceService = serviceCounters.p1_working_time +
-        serviceCounters.p2_working_time +
-        serviceCounters.p3_working_time +
-        serviceCounters.p4_working_time +
-        serviceCounters.p5_working_time;
-    const powerDistribution = totalOperatingHours === 0
-        ? { p1: 0, p2: 0, p3: 0, p4: 0, p5: 0 }
-        : {
-            p1: (totalCounters.p1_working_time / totalOperatingHours) * 100,
-            p2: (totalCounters.p2_working_time / totalOperatingHours) * 100,
-            p3: (totalCounters.p3_working_time / totalOperatingHours) * 100,
-            p4: (totalCounters.p4_working_time / totalOperatingHours) * 100,
-            p5: (totalCounters.p5_working_time / totalOperatingHours) * 100,
-        };
-    return {
-        totalPowerOns: totalCounters.power_ons,
-        totalOperatingHours,
-        powerDistribution,
-        serviceStatus: {
-            totalServiceHours: info.status.counters.service_time,
-            hoursSinceService,
-            serviceThresholdHours: serviceThreshold,
-            isServiceDue: hoursSinceService >= serviceThreshold,
-        },
-        blackoutCount: regeneration.blackout_counter,
-        lastMaintenanceDate: regeneration.last_intervention > 0
-            ? new Date(regeneration.last_intervention * 1000)
-            : null,
-        alarmCount: alarmsLog.number,
-    };
+    return deriveUsageAnalytics(info, serviceThreshold);
 });
 const registerDevice = (baseURL) => 
 /**

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

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { strict as assert } from "assert";
 import pako from "pako";
 import sinon from "sinon";
-import { configure, createAuthService } from "../src/library";
+import { configure, createAuthService, deriveUsageAnalytics, } from "../src/library";
 import { API_URL } from "./constants";
 /**
  * Helper to create a gzip-compressed Buffer object for testing.
@@ -1009,6 +1009,139 @@ describe("library", () => {
             assert.equal(result.lastMaintenanceDate, null);
         }));
     });
+    describe("deriveUsageAnalytics", () => {
+        const mockDeviceInfoForDerive = {
+            status: {
+                commands: {
+                    power: false,
+                },
+                temperatures: {
+                    enviroment: 20,
+                    set_air: 21,
+                    get_air: 20,
+                    set_water: 40,
+                    get_water: 35,
+                },
+                counters: {
+                    service_time: 1108,
+                },
+                flags: {
+                    is_pellet_in_reserve: false,
+                },
+                pellet: {
+                    autonomy_time: 180,
+                },
+            },
+            nvm: {
+                user_parameters: {
+                    language: 1,
+                    is_auto: false,
+                    is_fahrenheit: false,
+                    is_sound_active: false,
+                    enviroment_1_temperature: 19,
+                    enviroment_2_temperature: 20,
+                    enviroment_3_temperature: 20,
+                    manual_power: 1,
+                    fan_1_ventilation: 3,
+                    fan_2_ventilation: 0,
+                    fan_3_ventilation: 0,
+                    is_standby_active: false,
+                    standby_waiting_time: 60,
+                },
+                total_counters: {
+                    power_ons: 278,
+                    p1_working_time: 833,
+                    p2_working_time: 15,
+                    p3_working_time: 19,
+                    p4_working_time: 8,
+                    p5_working_time: 17,
+                },
+                service_counters: {
+                    p1_working_time: 100,
+                    p2_working_time: 10,
+                    p3_working_time: 5,
+                    p4_working_time: 2,
+                    p5_working_time: 1,
+                },
+                regeneration: {
+                    time: 0,
+                    last_intervention: 1577836800,
+                    daylight_time_flag: 0,
+                    blackout_counter: 43,
+                    airkare_working_hours_counter: 0,
+                },
+                alarms_log: {
+                    number: 6,
+                    index: 6,
+                    alarms: [],
+                },
+            },
+        };
+        it("should derive analytics from device info without API call", () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = deriveUsageAnalytics(mockDeviceInfoForDerive);
+            assert.equal(analytics.totalPowerOns, 278);
+            assert.equal(analytics.totalOperatingHours, 892); // 833+15+19+8+17
+            assert.equal(analytics.blackoutCount, 43);
+            assert.equal(analytics.alarmCount, 6);
+        });
+        it("should calculate power distribution correctly", () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = deriveUsageAnalytics(mockDeviceInfoForDerive);
+            // P1: 833/892 ≈ 93.4%
+            assert.ok(analytics.powerDistribution.p1 > 93);
+            assert.ok(analytics.powerDistribution.p1 < 94);
+            // Sum should be 100%
+            const sum = Object.values(analytics.powerDistribution).reduce((a, b) => a + b, 0);
+            assert.ok(Math.abs(sum - 100) < 0.001);
+        });
+        it("should handle zero operating hours", () => {
+            const zeroHoursInfo = Object.assign(Object.assign({}, mockDeviceInfoForDerive), { nvm: Object.assign(Object.assign({}, mockDeviceInfoForDerive.nvm), { total_counters: {
+                        power_ons: 0,
+                        p1_working_time: 0,
+                        p2_working_time: 0,
+                        p3_working_time: 0,
+                        p4_working_time: 0,
+                        p5_working_time: 0,
+                    } }) });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = deriveUsageAnalytics(zeroHoursInfo);
+            assert.deepEqual(analytics.powerDistribution, {
+                p1: 0,
+                p2: 0,
+                p3: 0,
+                p4: 0,
+                p5: 0,
+            });
+        });
+        it("should respect custom service threshold", () => {
+            const analytics = deriveUsageAnalytics(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            mockDeviceInfoForDerive, 100);
+            // 118 hours since service >= 100 threshold
+            assert.equal(analytics.serviceStatus.isServiceDue, true);
+            assert.equal(analytics.serviceStatus.serviceThresholdHours, 100);
+        });
+        it("should use default threshold of 2000 hours", () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = deriveUsageAnalytics(mockDeviceInfoForDerive);
+            assert.equal(analytics.serviceStatus.serviceThresholdHours, 2000);
+            assert.equal(analytics.serviceStatus.isServiceDue, false); // 118 < 2000
+        });
+        it("should convert last_intervention timestamp to Date", () => {
+            var _a;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = deriveUsageAnalytics(mockDeviceInfoForDerive);
+            assert.ok(analytics.lastMaintenanceDate instanceof Date);
+            assert.equal((_a = analytics.lastMaintenanceDate) === null || _a === void 0 ? void 0 : _a.getTime(), 1577836800 * 1000);
+        });
+        it("should return null for lastMaintenanceDate when timestamp is 0", () => {
+            const noMaintenanceInfo = Object.assign(Object.assign({}, mockDeviceInfoForDerive), { nvm: Object.assign(Object.assign({}, mockDeviceInfoForDerive.nvm), { regeneration: Object.assign(Object.assign({}, mockDeviceInfoForDerive.nvm.regeneration), { last_intervention: 0 }) }) });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const analytics = deriveUsageAnalytics(noMaintenanceInfo);
+            assert.equal(analytics.lastMaintenanceDate, null);
+        });
+    });
     describe("Error Handling", () => {
         const errorTests = [
             { status: 400, statusText: "Bad Request" },

package/package.json

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

package/src/index.ts

@@ -3,7 +3,7 @@ import { configure } from "./library";
 export { bleToWifiMac } from "./bluetooth-utils";
 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 { configure, deriveUsageAnalytics, getSession, signIn } from "./library";
 export {
   serialNumberDisplay,
   serialNumberFromHex,

package/src/library.test.ts

@@ -3,7 +3,11 @@ import * as amplifyAuth from "aws-amplify/auth";
 import pako from "pako";
 import sinon from "sinon";
 
-import { configure, createAuthService } from "../src/library";
+import {
+  configure,
+  createAuthService,
+  deriveUsageAnalytics,
+} from "../src/library";
 import { API_URL } from "./constants";
 
 /**
@@ -1307,6 +1311,174 @@ describe("library", () => {
     });
   });
 
+  describe("deriveUsageAnalytics", () => {
+    const mockDeviceInfoForDerive = {
+      status: {
+        commands: {
+          power: false,
+        },
+        temperatures: {
+          enviroment: 20,
+          set_air: 21,
+          get_air: 20,
+          set_water: 40,
+          get_water: 35,
+        },
+        counters: {
+          service_time: 1108,
+        },
+        flags: {
+          is_pellet_in_reserve: false,
+        },
+        pellet: {
+          autonomy_time: 180,
+        },
+      },
+      nvm: {
+        user_parameters: {
+          language: 1,
+          is_auto: false,
+          is_fahrenheit: false,
+          is_sound_active: false,
+          enviroment_1_temperature: 19,
+          enviroment_2_temperature: 20,
+          enviroment_3_temperature: 20,
+          manual_power: 1,
+          fan_1_ventilation: 3,
+          fan_2_ventilation: 0,
+          fan_3_ventilation: 0,
+          is_standby_active: false,
+          standby_waiting_time: 60,
+        },
+        total_counters: {
+          power_ons: 278,
+          p1_working_time: 833,
+          p2_working_time: 15,
+          p3_working_time: 19,
+          p4_working_time: 8,
+          p5_working_time: 17,
+        },
+        service_counters: {
+          p1_working_time: 100,
+          p2_working_time: 10,
+          p3_working_time: 5,
+          p4_working_time: 2,
+          p5_working_time: 1,
+        },
+        regeneration: {
+          time: 0,
+          last_intervention: 1577836800,
+          daylight_time_flag: 0,
+          blackout_counter: 43,
+          airkare_working_hours_counter: 0,
+        },
+        alarms_log: {
+          number: 6,
+          index: 6,
+          alarms: [],
+        },
+      },
+    };
+
+    it("should derive analytics from device info without API call", () => {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const analytics = deriveUsageAnalytics(mockDeviceInfoForDerive as any);
+
+      assert.equal(analytics.totalPowerOns, 278);
+      assert.equal(analytics.totalOperatingHours, 892); // 833+15+19+8+17
+      assert.equal(analytics.blackoutCount, 43);
+      assert.equal(analytics.alarmCount, 6);
+    });
+
+    it("should calculate power distribution correctly", () => {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const analytics = deriveUsageAnalytics(mockDeviceInfoForDerive as any);
+
+      // P1: 833/892 ≈ 93.4%
+      assert.ok(analytics.powerDistribution.p1 > 93);
+      assert.ok(analytics.powerDistribution.p1 < 94);
+
+      // Sum should be 100%
+      const sum = Object.values(analytics.powerDistribution).reduce(
+        (a, b) => a + b,
+        0,
+      );
+      assert.ok(Math.abs(sum - 100) < 0.001);
+    });
+
+    it("should handle zero operating hours", () => {
+      const zeroHoursInfo = {
+        ...mockDeviceInfoForDerive,
+        nvm: {
+          ...mockDeviceInfoForDerive.nvm,
+          total_counters: {
+            power_ons: 0,
+            p1_working_time: 0,
+            p2_working_time: 0,
+            p3_working_time: 0,
+            p4_working_time: 0,
+            p5_working_time: 0,
+          },
+        },
+      };
+
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const analytics = deriveUsageAnalytics(zeroHoursInfo as any);
+      assert.deepEqual(analytics.powerDistribution, {
+        p1: 0,
+        p2: 0,
+        p3: 0,
+        p4: 0,
+        p5: 0,
+      });
+    });
+
+    it("should respect custom service threshold", () => {
+      const analytics = deriveUsageAnalytics(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        mockDeviceInfoForDerive as any,
+        100,
+      );
+
+      // 118 hours since service >= 100 threshold
+      assert.equal(analytics.serviceStatus.isServiceDue, true);
+      assert.equal(analytics.serviceStatus.serviceThresholdHours, 100);
+    });
+
+    it("should use default threshold of 2000 hours", () => {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const analytics = deriveUsageAnalytics(mockDeviceInfoForDerive as any);
+
+      assert.equal(analytics.serviceStatus.serviceThresholdHours, 2000);
+      assert.equal(analytics.serviceStatus.isServiceDue, false); // 118 < 2000
+    });
+
+    it("should convert last_intervention timestamp to Date", () => {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const analytics = deriveUsageAnalytics(mockDeviceInfoForDerive as any);
+
+      assert.ok(analytics.lastMaintenanceDate instanceof Date);
+      assert.equal(analytics.lastMaintenanceDate?.getTime(), 1577836800 * 1000);
+    });
+
+    it("should return null for lastMaintenanceDate when timestamp is 0", () => {
+      const noMaintenanceInfo = {
+        ...mockDeviceInfoForDerive,
+        nvm: {
+          ...mockDeviceInfoForDerive.nvm,
+          regeneration: {
+            ...mockDeviceInfoForDerive.nvm.regeneration,
+            last_intervention: 0,
+          },
+        },
+      };
+
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const analytics = deriveUsageAnalytics(noMaintenanceInfo as any);
+      assert.equal(analytics.lastMaintenanceDate, null);
+    });
+  });
+
   describe("Error Handling", () => {
     const errorTests = [
       { status: 400, statusText: "Bad Request" },

package/src/library.ts

@@ -718,6 +718,74 @@ const getServiceTime =
  */
 const DEFAULT_SERVICE_THRESHOLD = 2000;
 
+/**
+ * Derives usage analytics from an existing DeviceInfo response.
+ * This is a pure function that performs client-side calculations without API calls.
+ *
+ * Use this when you already have a DeviceInfo object (e.g., from a previous deviceInfo() call)
+ * to avoid making an additional API request.
+ *
+ * @param {DeviceInfoType} deviceInfo - The device info response object.
+ * @param {number} [serviceThreshold=2000] - Service threshold in hours.
+ * @returns {UsageAnalyticsType} - Comprehensive usage analytics.
+ *
+ * @example
+ * const info = await api.deviceInfo(token, mac);
+ * const analytics = deriveUsageAnalytics(info);
+ */
+export const deriveUsageAnalytics = (
+  deviceInfo: DeviceInfoType,
+  serviceThreshold: number = DEFAULT_SERVICE_THRESHOLD,
+): UsageAnalyticsType => {
+  const totalCounters = deviceInfo.nvm.total_counters;
+  const serviceCounters = deviceInfo.nvm.service_counters;
+  const regeneration = deviceInfo.nvm.regeneration;
+  const alarmsLog = deviceInfo.nvm.alarms_log;
+
+  const totalOperatingHours =
+    totalCounters.p1_working_time +
+    totalCounters.p2_working_time +
+    totalCounters.p3_working_time +
+    totalCounters.p4_working_time +
+    totalCounters.p5_working_time;
+
+  const hoursSinceService =
+    serviceCounters.p1_working_time +
+    serviceCounters.p2_working_time +
+    serviceCounters.p3_working_time +
+    serviceCounters.p4_working_time +
+    serviceCounters.p5_working_time;
+
+  const powerDistribution: PowerDistributionType =
+    totalOperatingHours === 0
+      ? { p1: 0, p2: 0, p3: 0, p4: 0, p5: 0 }
+      : {
+          p1: (totalCounters.p1_working_time / totalOperatingHours) * 100,
+          p2: (totalCounters.p2_working_time / totalOperatingHours) * 100,
+          p3: (totalCounters.p3_working_time / totalOperatingHours) * 100,
+          p4: (totalCounters.p4_working_time / totalOperatingHours) * 100,
+          p5: (totalCounters.p5_working_time / totalOperatingHours) * 100,
+        };
+
+  return {
+    totalPowerOns: totalCounters.power_ons,
+    totalOperatingHours,
+    powerDistribution,
+    serviceStatus: {
+      totalServiceHours: deviceInfo.status.counters.service_time,
+      hoursSinceService,
+      serviceThresholdHours: serviceThreshold,
+      isServiceDue: hoursSinceService >= serviceThreshold,
+    },
+    blackoutCount: regeneration.blackout_counter,
+    lastMaintenanceDate:
+      regeneration.last_intervention > 0
+        ? new Date(regeneration.last_intervention * 1000)
+        : null,
+    alarmCount: alarmsLog.number,
+  };
+};
+
 const getTotalOperatingHours =
   (baseURL: string) =>
   /**
@@ -821,54 +889,7 @@ const getUsageAnalytics =
     serviceThreshold: number = DEFAULT_SERVICE_THRESHOLD,
   ): Promise<UsageAnalyticsType> => {
     const info = await deviceInfo(baseURL)(jwtToken, macAddress);
-
-    const totalCounters = info.nvm.total_counters;
-    const serviceCounters = info.nvm.service_counters;
-    const regeneration = info.nvm.regeneration;
-    const alarmsLog = info.nvm.alarms_log;
-
-    const totalOperatingHours =
-      totalCounters.p1_working_time +
-      totalCounters.p2_working_time +
-      totalCounters.p3_working_time +
-      totalCounters.p4_working_time +
-      totalCounters.p5_working_time;
-
-    const hoursSinceService =
-      serviceCounters.p1_working_time +
-      serviceCounters.p2_working_time +
-      serviceCounters.p3_working_time +
-      serviceCounters.p4_working_time +
-      serviceCounters.p5_working_time;
-
-    const powerDistribution: PowerDistributionType =
-      totalOperatingHours === 0
-        ? { p1: 0, p2: 0, p3: 0, p4: 0, p5: 0 }
-        : {
-            p1: (totalCounters.p1_working_time / totalOperatingHours) * 100,
-            p2: (totalCounters.p2_working_time / totalOperatingHours) * 100,
-            p3: (totalCounters.p3_working_time / totalOperatingHours) * 100,
-            p4: (totalCounters.p4_working_time / totalOperatingHours) * 100,
-            p5: (totalCounters.p5_working_time / totalOperatingHours) * 100,
-          };
-
-    return {
-      totalPowerOns: totalCounters.power_ons,
-      totalOperatingHours,
-      powerDistribution,
-      serviceStatus: {
-        totalServiceHours: info.status.counters.service_time,
-        hoursSinceService,
-        serviceThresholdHours: serviceThreshold,
-        isServiceDue: hoursSinceService >= serviceThreshold,
-      },
-      blackoutCount: regeneration.blackout_counter,
-      lastMaintenanceDate:
-        regeneration.last_intervention > 0
-          ? new Date(regeneration.last_intervention * 1000)
-          : null,
-      alarmCount: alarmsLog.number,
-    };
+    return deriveUsageAnalytics(info, serviceThreshold);
   };
 
 const registerDevice =