/**
 * Represents a Node.js Buffer object serialized to JSON.
 * This format is used by the Edilkamin API for gzip-compressed fields.
 */
interface BufferEncodedType {
  type: "Buffer";
  data: number[];
}

interface CommandsType {
  power: boolean;
}

interface TemperaturesType {
  board: number;
  enviroment: number;
}

interface GeneralFlagsType {
  is_pellet_in_reserve: boolean;
  is_relax_active: boolean;
  is_airkare_active: boolean;
  is_crono_active: boolean;
  is_easytimer_active: boolean;
  is_cochlea_in_continuous_mode: boolean;
}

interface PelletAutonomyType {
  autonomy_time: number;
}

/**
 * Days of the week for schedule indexing.
 * Monday = 0, Sunday = 6 (matching Edilkamin's internal format).
 */
enum Day {
  MONDAY = 0,
  TUESDAY = 1,
  WEDNESDAY = 2,
  THURSDAY = 3,
  FRIDAY = 4,
  SATURDAY = 5,
  SUNDAY = 6,
}

/**
 * Schedule slot values for Chrono Mode temperature scheduling.
 */
enum ChronoTemperatureSlot {
  /** Stove off during this slot */
  OFF = 0,
  /** Target the economy temperature */
  ECONOMY = 1,
  /** Target the comfort temperature */
  COMFORT = 2,
}

/**
 * Schedule slot values for Chrono Mode power scheduling.
 */
enum ChronoPowerSlot {
  /** Stove off during this slot */
  OFF = 0,
  /** Run at power level 1 */
  POWER1 = 1,
  /** Run at power level 5 */
  POWER5 = 2,
}

/**
 * Represents a time slot in the weekly schedule.
 */
interface TimeSlot {
  /** Day of week (0-6, Monday=0) */
  day: Day;
  /** Starting hour (0-23) */
  hour: number;
  /** Starting minutes (0 or 30) */
  minute: 0 | 30;
}

/**
 * Easy timer settings from status.easytimer.
 */
interface EasyTimerType {
  /** Timer time in minutes */
  time: number;
}

/**
 * Status counters including service time.
 */
interface StatusCountersType {
  service_time: number;
}

/**
 * Device operational state information.
 * Retrieved from status.state in the API response.
 */
interface StateType {
  /**
   * Main operational phase (0=Off, 1=Ignition, 2=On, 3=Shutting down, 4=Cooling, 5=Final cleaning)
   * See OperationalPhase enum for all values.
   */
  operational_phase: number;
  /**
   * Sub-phase within current operation (0-7 during ignition)
   * See IgnitionSubPhase enum for all values. Only meaningful when operational_phase = 1 (IGNITION).
   */
  sub_operational_phase: number;
  /** Combined stove state code */
  stove_state: number;
  /** Current alarm code (0 = no alarm) */
  alarm_type: number;
  /** Current actual power level (1-5) */
  actual_power: number;
}

/**
 * Fan speed information for all three fans.
 * Retrieved from status.fans in the API response.
 */
interface FansType {
  /** Fan 1 speed (0-5) */
  fan_1_speed: number;
  /** Fan 2 speed (0-5) */
  fan_2_speed: number;
  /** Fan 3 speed (0-5) */
  fan_3_speed: number;
}

interface StatusType {
  commands: CommandsType;
  temperatures: TemperaturesType;
  flags: GeneralFlagsType;
  pellet: PelletAutonomyType;
  counters: StatusCountersType;
  state: StateType;
  fans: FansType;
  easytimer: EasyTimerType;
}

interface UserParametersType {
  enviroment_1_temperature: number;
  enviroment_2_temperature: number;
  enviroment_3_temperature: number;
  is_auto: boolean;
  is_sound_active: boolean;
  manual_power: number;
  fan_1_ventilation: number;
  fan_2_ventilation: number;
  fan_3_ventilation: number;
  is_standby_active: boolean;
  standby_waiting_time: number;
  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).
 */
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.
 */
const AlarmDescriptions: Record<AlarmCode, string> = {
  [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",
};

/**
 * Main operational phases of the stove.
 * Values from StatusFireplaceEnum in official Edilkamin Android app.
 */
enum OperationalPhase {
  OFF = 0, // SPENTO
  IGNITION = 1, // ACCENSIONE
  ON = 2, // ACCESO
  SHUTTING_DOWN = 3, // SPEGNIMENTO
  COOLING = 4, // RAFFREDDAMENTO
  FINAL_CLEANING = 5, // PULIZIA_FINALE
}

/**
 * Human-readable descriptions for operational phases.
 * English translations from strings.xml in official Edilkamin Android app.
 */
const OperationalPhaseDescriptions: Record<OperationalPhase, string> = {
  [OperationalPhase.OFF]: "Off",
  [OperationalPhase.IGNITION]: "Ignition",
  [OperationalPhase.ON]: "On",
  [OperationalPhase.SHUTTING_DOWN]: "Shutting down",
  [OperationalPhase.COOLING]: "Cooling",
  [OperationalPhase.FINAL_CLEANING]: "Final cleaning",
};

/**
 * Get description for an operational phase, with fallback for unknown values.
 *
 * @param phase - The operational phase value from API
 * @returns Human-readable description
 */
const getOperationalPhaseDescription = (phase: number): string =>
  OperationalPhaseDescriptions[phase as OperationalPhase] ??
  `Unknown phase (${phase})`;

/**
 * Sub-phases during ignition sequence.
 * These are only meaningful when operational_phase === IGNITION (1).
 * Values from SubStatusEnum in official Edilkamin Android app.
 */
enum IgnitionSubPhase {
  HOT_STOVE_CLEANING = 0, // PULIZIA_STUFA_CALDA
  CLEANING_WITHOUT_CLEANER = 1, // PULIZIA_SENZA_EKLEANER
  CLEANING_WITH_CLEANER = 2, // PULIZIA_CON_EKLEANER
  PELLET_LOAD = 3, // CARICO_PELLET
  LOADING_BREAK = 4, // PAUSA_CARICAMENTO
  SMOKE_TEMP_CHECK = 5, // CONTROLLO_INCREMENTO_TEMPERATURA
  THRESHOLD_CHECK = 6, // CONTROLLO_SUPERAMENTO_SOGLIA
  WARMUP = 7, // WARMUP
}

/**
 * Human-readable descriptions for ignition sub-phases.
 * English translations from strings.xml in official Edilkamin Android app.
 */
const IgnitionSubPhaseDescriptions: Record<IgnitionSubPhase, string> = {
  [IgnitionSubPhase.HOT_STOVE_CLEANING]: "Hot stove cleaning",
  [IgnitionSubPhase.CLEANING_WITHOUT_CLEANER]: "Cleaning without cleaner",
  [IgnitionSubPhase.CLEANING_WITH_CLEANER]: "Cleaning with cleaner",
  [IgnitionSubPhase.PELLET_LOAD]: "Pellet load",
  [IgnitionSubPhase.LOADING_BREAK]: "Loading break",
  [IgnitionSubPhase.SMOKE_TEMP_CHECK]: "Smoke temperature check",
  [IgnitionSubPhase.THRESHOLD_CHECK]: "Threshold check",
  [IgnitionSubPhase.WARMUP]: "Warmup",
};

/**
 * Get description for an ignition sub-phase, with fallback for unknown values.
 *
 * @param subPhase - The sub-phase value from API
 * @returns Human-readable description
 */
const getIgnitionSubPhaseDescription = (subPhase: number): string =>
  IgnitionSubPhaseDescriptions[subPhase as IgnitionSubPhase] ??
  `Unknown sub-phase (${subPhase})`;

/**
 * Combined stove states.
 * This is a composite value combining operational phase and sub-phase.
 */
enum StoveState {
  OFF = 0,
  STANDBY = 1,
  IGNITION_CLEANING = 2,
  IGNITION_LOADING = 3,
  IGNITION_WAITING = 4,
  IGNITION_WARMUP = 5,
  ON = 6,
  COOLING = 7,
  ALARM = 8,
}

/**
 * Human-readable descriptions for stove states.
 */
const StoveStateDescriptions: Record<number, string> = {
  [StoveState.OFF]: "Off",
  [StoveState.STANDBY]: "Standby",
  [StoveState.IGNITION_CLEANING]: "Ignition - Cleaning",
  [StoveState.IGNITION_LOADING]: "Ignition - Loading pellets",
  [StoveState.IGNITION_WAITING]: "Ignition - Waiting",
  [StoveState.IGNITION_WARMUP]: "Ignition - Warming up",
  [StoveState.ON]: "On",
  [StoveState.COOLING]: "Cooling down",
  [StoveState.ALARM]: "Alarm",
};

/**
 * Get description for a stove state, with fallback for unknown values.
 */
const getStoveStateDescription = (state: number): string =>
  StoveStateDescriptions[state] ?? `Unknown state (${state})`;

/**
 * Hardware/software component information.
 * Used for motherboard, panels, remote control, and other hardware components.
 * Empty serial_number or board_name indicates the component is not installed.
 */
interface ComponentType {
  serial_number: string;
  board_name: string;
  bootloader_name: string;
  bootloader_version: string;
  application_name: string;
  application_version: string;
  compatibility: number;
}

/**
 * Component information for all hardware components.
 * Contains firmware versions, serial numbers, and board information.
 */
interface ComponentInfoType {
  timestamp: number;
  motherboard: ComponentType;
  emergency_panel: ComponentType;
  radio_control: ComponentType;
  expansion_board: ComponentType;
  remote_user_panel_1: ComponentType;
  remote_user_panel_2: ComponentType;
  remote_user_panel_3: ComponentType;
  temp_umidity_voc_probe_1: ComponentType;
  temp_umidity_voc_probe_2: ComponentType;
  temp_umidity_voc_probe_3: ComponentType;
  wifi_ble_module: ComponentType;
  idro_panel: ComponentType;
  general: {
    check: number;
  };
}

interface DeviceInfoType {
  status: StatusType;
  nvm: {
    user_parameters: UserParametersType;
    total_counters: TotalCountersType;
    service_counters: ServiceCountersType;
    alarms_log: AlarmsLogType;
    regeneration: RegenerationDataType;
  };
  component_info?: ComponentInfoType;
}

/**
 * Raw device info response that may contain Buffer-encoded compressed fields.
 * Used internally before processing; external callers receive DeviceInfoType.
 */
interface DeviceInfoRawType {
  status: StatusType | BufferEncodedType;
  nvm:
    | {
        user_parameters: UserParametersType;
      }
    | BufferEncodedType;
  component_info?: BufferEncodedType | Record<string, unknown>;
}

/**
 * Request body for registering a device with a user account.
 * All fields are required by the API.
 */
interface DeviceAssociationBody {
  macAddress: string;
  deviceName: string;
  deviceRoom: string;
  serialNumber: string;
}

/**
 * Request body for editing a device's name and room.
 * MAC address is specified in the URL path, not the body.
 * Serial number cannot be changed after registration.
 */
interface EditDeviceAssociationBody {
  deviceName: string;
  deviceRoom: string;
}

/**
 * Response from device registration endpoint.
 * Structure based on Android app behavior - may need adjustment after testing.
 */
interface DeviceAssociationResponse {
  macAddress: string;
  deviceName: string;
  deviceRoom: string;
  serialNumber: string;
}

/**
 * Represents a discovered Edilkamin device from Bluetooth scanning.
 */
interface DiscoveredDevice {
  /** BLE MAC address as discovered */
  bleMac: string;
  /** WiFi MAC address (BLE MAC - 2), used for API calls */
  wifiMac: string;
  /** Device name (typically "EDILKAMIN_EP") */
  name: string;
  /** Signal strength in dBm (optional, not all platforms provide this) */
  rssi?: number;
}

/**
 * Easy timer state returned by getEasyTimer.
 */
interface EasyTimerStateType {
  /** Whether easy timer is currently active */
  active: boolean;
  /** Timer time in minutes */
  time: number;
}

export type {
  AlarmEntryType,
  AlarmsLogType,
  BufferEncodedType,
  CommandsType,
  ComponentInfoType,
  ComponentType,
  DeviceAssociationBody,
  DeviceAssociationResponse,
  DeviceInfoRawType,
  DeviceInfoType,
  DiscoveredDevice,
  EasyTimerStateType,
  EasyTimerType,
  EditDeviceAssociationBody,
  FansType,
  GeneralFlagsType,
  PelletAutonomyType,
  PowerDistributionType,
  RegenerationDataType,
  ServiceCountersType,
  ServiceStatusType,
  StateType,
  StatusCountersType,
  StatusType,
  TemperaturesType,
  TimeSlot,
  TotalCountersType,
  UsageAnalyticsType,
  UserParametersType,
};

export {
  AlarmCode,
  AlarmDescriptions,
  ChronoPowerSlot,
  ChronoTemperatureSlot,
  Day,
  getIgnitionSubPhaseDescription,
  getOperationalPhaseDescription,
  getStoveStateDescription,
  IgnitionSubPhase,
  IgnitionSubPhaseDescriptions,
  OperationalPhase,
  OperationalPhaseDescriptions,
  StoveState,
  StoveStateDescriptions,
};