edilkamin 1.10.0 → 1.10.1

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

@@ -19,11 +19,18 @@ interface GeneralFlagsType {
 interface PelletAutonomyType {
     autonomy_time: number;
 }
+/**
+ * Status counters including service time.
+ */
+interface StatusCountersType {
+    service_time: number;
+}
 interface StatusType {
     commands: CommandsType;
     temperatures: TemperaturesType;
     flags: GeneralFlagsType;
     pellet: PelletAutonomyType;
+    counters: StatusCountersType;
 }
 interface UserParametersType {
     enviroment_1_temperature: number;
@@ -40,10 +47,128 @@ interface UserParametersType {
     is_fahrenheit: boolean;
     language: number;
 }
+/**
+ * Lifetime operating counters - never reset.
+ * Tracks total power-on cycles and runtime hours per power level.
+ */
+interface TotalCountersType {
+    power_ons: number;
+    p1_working_time: number;
+    p2_working_time: number;
+    p3_working_time: number;
+    p4_working_time: number;
+    p5_working_time: number;
+}
+/**
+ * Service counters - reset after maintenance.
+ * Tracks runtime hours per power level since last service.
+ */
+interface ServiceCountersType {
+    p1_working_time: number;
+    p2_working_time: number;
+    p3_working_time: number;
+    p4_working_time: number;
+    p5_working_time: number;
+}
+/**
+ * Individual alarm entry from the alarm history log.
+ */
+interface AlarmEntryType {
+    type: number;
+    timestamp: number;
+}
+/**
+ * Alarm history log - circular buffer of recent alarms.
+ */
+interface AlarmsLogType {
+    number: number;
+    index: number;
+    alarms: AlarmEntryType[];
+}
+/**
+ * Regeneration and maintenance tracking data.
+ */
+interface RegenerationDataType {
+    time: number;
+    last_intervention: number;
+    daylight_time_flag: number;
+    blackout_counter: number;
+    airkare_working_hours_counter: number;
+}
+/**
+ * Power level distribution as percentages.
+ */
+interface PowerDistributionType {
+    p1: number;
+    p2: number;
+    p3: number;
+    p4: number;
+    p5: number;
+}
+/**
+ * Service status with computed fields.
+ */
+interface ServiceStatusType {
+    totalServiceHours: number;
+    hoursSinceService: number;
+    serviceThresholdHours: number;
+    isServiceDue: boolean;
+}
+/**
+ * Comprehensive usage analytics.
+ */
+interface UsageAnalyticsType {
+    totalPowerOns: number;
+    totalOperatingHours: number;
+    powerDistribution: PowerDistributionType;
+    serviceStatus: ServiceStatusType;
+    blackoutCount: number;
+    lastMaintenanceDate: Date | null;
+    alarmCount: number;
+}
+/**
+ * Alarm type codes from Edilkamin devices.
+ * Based on AlarmsEnum.java from Android app (version 1.3.1-RC2 released 2025/12/10).
+ */
+declare enum AlarmCode {
+    NONE = 0,
+    FLUE_BLOCK = 1,
+    SMOKE_EXTRACTOR_FAILURE = 2,
+    END_PELLET = 3,
+    MISSING_LIGHTING = 4,
+    NO_NAME_ALARM = 5,
+    SMOKE_PROBE_FAILURE = 6,
+    FUMES_OVERTEMPERATURE = 7,
+    PELLET_TANK_SAFETY_THERMOSTAT = 8,
+    GEAR_MOTOR_FAILURE = 9,
+    BOARD_OVER_TEMPERATURE = 10,
+    SAFETY_PRESSURE_SWITCH_INTERVENTION = 11,
+    ROOM_PROBE_FAILURE = 12,
+    ROOM_PROBE_2_OR_BOILER_PROBE_FAILURE = 13,
+    ROOM_PROBE_3_OR_BOILER_PROBE_FAILURE = 14,
+    WATER_EARTHQUAKE_SAFETY_THERMOSTAT_INTERVENTION = 15,
+    WATER_PRESSURE_TRANSDUCER_FAILURE = 16,
+    OUTSIDE_PROBE_OR_LOW_STORAGE_PROBE_FAILURE = 17,
+    PUFFER_PROBE_FAILURE = 18,
+    CRUCIBLE_CLEANING_FAILURE = 19,
+    TRIAC_FAILURE = 20,
+    BLACKOUT = 21,
+    OPEN_DOOR = 22,
+    OVERTEMPERATURE_PANEL = 23,
+    BOARD_FUSE = 24
+}
+/**
+ * Human-readable descriptions for alarm codes.
+ */
+declare const AlarmDescriptions: Record<AlarmCode, string>;
 interface DeviceInfoType {
     status: StatusType;
     nvm: {
         user_parameters: UserParametersType;
+        total_counters: TotalCountersType;
+        service_counters: ServiceCountersType;
+        alarms_log: AlarmsLogType;
+        regeneration: RegenerationDataType;
     };
 }
 /**
@@ -99,4 +224,5 @@ interface DiscoveredDevice {
     /** Signal strength in dBm (optional, not all platforms provide this) */
     rssi?: number;
 }
-export type { BufferEncodedType, CommandsType, DeviceAssociationBody, DeviceAssociationResponse, DeviceInfoRawType, DeviceInfoType, DiscoveredDevice, EditDeviceAssociationBody, GeneralFlagsType, PelletAutonomyType, StatusType, TemperaturesType, UserParametersType, };
+export type { AlarmEntryType, AlarmsLogType, BufferEncodedType, CommandsType, DeviceAssociationBody, DeviceAssociationResponse, DeviceInfoRawType, DeviceInfoType, DiscoveredDevice, EditDeviceAssociationBody, GeneralFlagsType, PelletAutonomyType, PowerDistributionType, RegenerationDataType, ServiceCountersType, ServiceStatusType, StatusCountersType, StatusType, TemperaturesType, TotalCountersType, UsageAnalyticsType, UserParametersType, };
+export { AlarmCode, AlarmDescriptions };

package/dist/cjs/src/types.js

@@ -1,2 +1,66 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlarmDescriptions = exports.AlarmCode = void 0;
+/**
+ * Alarm type codes from Edilkamin devices.
+ * Based on AlarmsEnum.java from Android app (version 1.3.1-RC2 released 2025/12/10).
+ */
+var AlarmCode;
+(function (AlarmCode) {
+    AlarmCode[AlarmCode["NONE"] = 0] = "NONE";
+    AlarmCode[AlarmCode["FLUE_BLOCK"] = 1] = "FLUE_BLOCK";
+    AlarmCode[AlarmCode["SMOKE_EXTRACTOR_FAILURE"] = 2] = "SMOKE_EXTRACTOR_FAILURE";
+    AlarmCode[AlarmCode["END_PELLET"] = 3] = "END_PELLET";
+    AlarmCode[AlarmCode["MISSING_LIGHTING"] = 4] = "MISSING_LIGHTING";
+    AlarmCode[AlarmCode["NO_NAME_ALARM"] = 5] = "NO_NAME_ALARM";
+    AlarmCode[AlarmCode["SMOKE_PROBE_FAILURE"] = 6] = "SMOKE_PROBE_FAILURE";
+    AlarmCode[AlarmCode["FUMES_OVERTEMPERATURE"] = 7] = "FUMES_OVERTEMPERATURE";
+    AlarmCode[AlarmCode["PELLET_TANK_SAFETY_THERMOSTAT"] = 8] = "PELLET_TANK_SAFETY_THERMOSTAT";
+    AlarmCode[AlarmCode["GEAR_MOTOR_FAILURE"] = 9] = "GEAR_MOTOR_FAILURE";
+    AlarmCode[AlarmCode["BOARD_OVER_TEMPERATURE"] = 10] = "BOARD_OVER_TEMPERATURE";
+    AlarmCode[AlarmCode["SAFETY_PRESSURE_SWITCH_INTERVENTION"] = 11] = "SAFETY_PRESSURE_SWITCH_INTERVENTION";
+    AlarmCode[AlarmCode["ROOM_PROBE_FAILURE"] = 12] = "ROOM_PROBE_FAILURE";
+    AlarmCode[AlarmCode["ROOM_PROBE_2_OR_BOILER_PROBE_FAILURE"] = 13] = "ROOM_PROBE_2_OR_BOILER_PROBE_FAILURE";
+    AlarmCode[AlarmCode["ROOM_PROBE_3_OR_BOILER_PROBE_FAILURE"] = 14] = "ROOM_PROBE_3_OR_BOILER_PROBE_FAILURE";
+    AlarmCode[AlarmCode["WATER_EARTHQUAKE_SAFETY_THERMOSTAT_INTERVENTION"] = 15] = "WATER_EARTHQUAKE_SAFETY_THERMOSTAT_INTERVENTION";
+    AlarmCode[AlarmCode["WATER_PRESSURE_TRANSDUCER_FAILURE"] = 16] = "WATER_PRESSURE_TRANSDUCER_FAILURE";
+    AlarmCode[AlarmCode["OUTSIDE_PROBE_OR_LOW_STORAGE_PROBE_FAILURE"] = 17] = "OUTSIDE_PROBE_OR_LOW_STORAGE_PROBE_FAILURE";
+    AlarmCode[AlarmCode["PUFFER_PROBE_FAILURE"] = 18] = "PUFFER_PROBE_FAILURE";
+    AlarmCode[AlarmCode["CRUCIBLE_CLEANING_FAILURE"] = 19] = "CRUCIBLE_CLEANING_FAILURE";
+    AlarmCode[AlarmCode["TRIAC_FAILURE"] = 20] = "TRIAC_FAILURE";
+    AlarmCode[AlarmCode["BLACKOUT"] = 21] = "BLACKOUT";
+    AlarmCode[AlarmCode["OPEN_DOOR"] = 22] = "OPEN_DOOR";
+    AlarmCode[AlarmCode["OVERTEMPERATURE_PANEL"] = 23] = "OVERTEMPERATURE_PANEL";
+    AlarmCode[AlarmCode["BOARD_FUSE"] = 24] = "BOARD_FUSE";
+})(AlarmCode || (exports.AlarmCode = AlarmCode = {}));
+/**
+ * Human-readable descriptions for alarm codes.
+ */
+const AlarmDescriptions = {
+    [AlarmCode.NONE]: "No alarm",
+    [AlarmCode.FLUE_BLOCK]: "Flue/chimney blockage",
+    [AlarmCode.SMOKE_EXTRACTOR_FAILURE]: "Smoke extractor motor failure",
+    [AlarmCode.END_PELLET]: "Pellet tank empty",
+    [AlarmCode.MISSING_LIGHTING]: "Ignition failure",
+    [AlarmCode.NO_NAME_ALARM]: "Unnamed alarm",
+    [AlarmCode.SMOKE_PROBE_FAILURE]: "Smoke temperature probe failure",
+    [AlarmCode.FUMES_OVERTEMPERATURE]: "Exhaust overtemperature",
+    [AlarmCode.PELLET_TANK_SAFETY_THERMOSTAT]: "Pellet tank safety thermostat triggered",
+    [AlarmCode.GEAR_MOTOR_FAILURE]: "Gear motor/auger failure",
+    [AlarmCode.BOARD_OVER_TEMPERATURE]: "Control board overtemperature",
+    [AlarmCode.SAFETY_PRESSURE_SWITCH_INTERVENTION]: "Safety pressure switch activated",
+    [AlarmCode.ROOM_PROBE_FAILURE]: "Room temperature probe failure",
+    [AlarmCode.ROOM_PROBE_2_OR_BOILER_PROBE_FAILURE]: "Room probe 2 or boiler probe failure",
+    [AlarmCode.ROOM_PROBE_3_OR_BOILER_PROBE_FAILURE]: "Room probe 3 or boiler probe failure",
+    [AlarmCode.WATER_EARTHQUAKE_SAFETY_THERMOSTAT_INTERVENTION]: "Water/earthquake safety thermostat",
+    [AlarmCode.WATER_PRESSURE_TRANSDUCER_FAILURE]: "Water pressure transducer failure",
+    [AlarmCode.OUTSIDE_PROBE_OR_LOW_STORAGE_PROBE_FAILURE]: "Outside probe or low storage probe failure",
+    [AlarmCode.PUFFER_PROBE_FAILURE]: "Buffer tank probe failure",
+    [AlarmCode.CRUCIBLE_CLEANING_FAILURE]: "Crucible cleaning failure",
+    [AlarmCode.TRIAC_FAILURE]: "Power control (TRIAC) failure",
+    [AlarmCode.BLACKOUT]: "Power outage detected",
+    [AlarmCode.OPEN_DOOR]: "Door open alarm",
+    [AlarmCode.OVERTEMPERATURE_PANEL]: "Panel overtemperature",
+    [AlarmCode.BOARD_FUSE]: "Control board fuse issue",
+};
+exports.AlarmDescriptions = AlarmDescriptions;

package/dist/esm/package.json

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

package/dist/esm/src/cli.js

@@ -14,6 +14,7 @@ import { version } from "../package.json";
 import { NEW_API_URL, OLD_API_URL } from "./constants";
 import { configure, configureAmplify, getSession, signIn } from "./library";
 import { clearSession, createFileStorage } from "./token-storage";
+import { AlarmCode, AlarmDescriptions } from "./types";
 const promptPassword = () => {
     const rl = readline.createInterface({
         input: process.stdin,
@@ -222,6 +223,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));
     });
@@ -403,6 +482,32 @@ const createProgram = () => {
         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 = createFileStorage();
+        configureAmplify(storage);
+        let jwtToken;
+        try {
+            jwtToken = yield 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 signIn(username, pwd, legacy);
+        }
+        const apiUrl = legacy ? OLD_API_URL : NEW_API_URL;
+        const api = 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: AlarmCode[alarm.type] || "UNKNOWN", description: 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/esm/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 { 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/esm/src/index.js

@@ -4,4 +4,5 @@ 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 { AlarmCode, AlarmDescriptions } from "./types";
 export const { deviceInfo, registerDevice, editDevice, setPower, setPowerOff, setPowerOn, getPower, getEnvironmentTemperature, getTargetTemperature, setTargetTemperature, } = configure();

package/dist/esm/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.
@@ -81,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, };

package/dist/esm/src/library.js

@@ -473,6 +473,194 @@ const getPelletAutonomyTime = (baseURL) =>
     const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
     return info.status.pellet.autonomy_time;
 });
+const getTotalCounters = (baseURL) => 
+/**
+ * Retrieves lifetime operating counters.
+ * Includes power-on count and runtime hours per power level.
+ * These counters are never reset.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<TotalCountersType>} - Lifetime operating statistics.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
+    return info.nvm.total_counters;
+});
+const getServiceCounters = (baseURL) => 
+/**
+ * Retrieves service counters (runtime since last maintenance).
+ * These counters track hours per power level since last service reset.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<ServiceCountersType>} - Service tracking statistics.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
+    return info.nvm.service_counters;
+});
+const getAlarmHistory = (baseURL) => 
+/**
+ * Retrieves the alarm history log.
+ * Contains a circular buffer of recent alarms with timestamps.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<AlarmsLogType>} - Alarm history log.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
+    return info.nvm.alarms_log;
+});
+const getRegenerationData = (baseURL) => 
+/**
+ * Retrieves regeneration and maintenance data.
+ * Includes blackout counter and last intervention timestamp.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<RegenerationDataType>} - Maintenance tracking data.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
+    return info.nvm.regeneration;
+});
+const getServiceTime = (baseURL) => 
+/**
+ * Retrieves the total service time in hours.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<number>} - Total service hours.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
+    return info.status.counters.service_time;
+});
+/**
+ * Default service threshold in hours (from OEM parameters).
+ * Most devices use 2000 hours.
+ */
+const DEFAULT_SERVICE_THRESHOLD = 2000;
+const getTotalOperatingHours = (baseURL) => 
+/**
+ * Calculates total operating hours across all power levels.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<number>} - Total operating hours.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const counters = yield getTotalCounters(baseURL)(jwtToken, macAddress);
+    return (counters.p1_working_time +
+        counters.p2_working_time +
+        counters.p3_working_time +
+        counters.p4_working_time +
+        counters.p5_working_time);
+});
+const getPowerDistribution = (baseURL) => 
+/**
+ * Calculates power level usage distribution as percentages.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<PowerDistributionType>} - Percentage time at each power level.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const counters = yield getTotalCounters(baseURL)(jwtToken, macAddress);
+    const total = counters.p1_working_time +
+        counters.p2_working_time +
+        counters.p3_working_time +
+        counters.p4_working_time +
+        counters.p5_working_time;
+    if (total === 0) {
+        return { p1: 0, p2: 0, p3: 0, p4: 0, p5: 0 };
+    }
+    return {
+        p1: (counters.p1_working_time / total) * 100,
+        p2: (counters.p2_working_time / total) * 100,
+        p3: (counters.p3_working_time / total) * 100,
+        p4: (counters.p4_working_time / total) * 100,
+        p5: (counters.p5_working_time / total) * 100,
+    };
+});
+const getServiceStatus = (baseURL) => 
+/**
+ * Calculates service status including whether maintenance is due.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @param {number} [thresholdHours=2000] - Service threshold in hours.
+ * @returns {Promise<ServiceStatusType>} - Service status with computed fields.
+ */
+(jwtToken_1, macAddress_1, ...args_1) => __awaiter(void 0, [jwtToken_1, macAddress_1, ...args_1], void 0, function* (jwtToken, macAddress, thresholdHours = DEFAULT_SERVICE_THRESHOLD) {
+    const info = yield deviceInfo(baseURL)(jwtToken, macAddress);
+    const serviceCounters = info.nvm.service_counters;
+    const hoursSinceService = serviceCounters.p1_working_time +
+        serviceCounters.p2_working_time +
+        serviceCounters.p3_working_time +
+        serviceCounters.p4_working_time +
+        serviceCounters.p5_working_time;
+    return {
+        totalServiceHours: info.status.counters.service_time,
+        hoursSinceService,
+        serviceThresholdHours: thresholdHours,
+        isServiceDue: hoursSinceService >= thresholdHours,
+    };
+});
+const getUsageAnalytics = (baseURL) => 
+/**
+ * Retrieves comprehensive usage analytics in a single call.
+ * Combines multiple statistics into a unified analytics object.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @param {number} [serviceThreshold=2000] - Service threshold in hours.
+ * @returns {Promise<UsageAnalyticsType>} - Comprehensive usage analytics.
+ */
+(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,
+    };
+});
 const registerDevice = (baseURL) => 
 /**
  * Registers a device with the user's account.
@@ -572,5 +760,16 @@ const configure = (baseURL = API_URL) => ({
     getLanguage: getLanguage(baseURL),
     getPelletInReserve: getPelletInReserve(baseURL),
     getPelletAutonomyTime: getPelletAutonomyTime(baseURL),
+    // Statistics getters
+    getTotalCounters: getTotalCounters(baseURL),
+    getServiceCounters: getServiceCounters(baseURL),
+    getAlarmHistory: getAlarmHistory(baseURL),
+    getRegenerationData: getRegenerationData(baseURL),
+    getServiceTime: getServiceTime(baseURL),
+    // Analytics functions
+    getTotalOperatingHours: getTotalOperatingHours(baseURL),
+    getPowerDistribution: getPowerDistribution(baseURL),
+    getServiceStatus: getServiceStatus(baseURL),
+    getUsageAnalytics: getUsageAnalytics(baseURL),
 });
 export { configure, configureAmplify, createAuthService, getSession, headers, signIn, };