home-assistant-addons/hamh-alpha/CHANGELOG.md

2.0.0-alpha.215 (2026-02-04)

Bug Fixes

• align ColorControl with Matter.js requirements for ExtendedColorLight (1d7806c)

2.0.0-alpha.214 (2026-02-04)

Bug Fixes

• prevent null/undefined from overwriting defaults in update() methods (d9dba0b)

2.0.0-alpha.213 (2026-02-04)

Bug Fixes

• set colorMode default for ColorTemperature-only lights to prevent validation errors (a19f281)

2.0.0-alpha.212 (2026-02-03)

Bug Fixes

• ExtendedColorLightType now only adds features the light actually supports (25e204b)

2.0.0-alpha.211 (2026-02-03)

Bug Fixes

• use ExtendedColorLight for ColorTemperature-only lights to fix initialization errors (435e798)

2.0.0-alpha.210 (2026-02-03)

Bug Fixes

• #49: remove room-specific modes from RvcRunMode - use ServiceArea only for room selection (8afdaf3), closes #49

2.0.0-alpha.209 (2026-02-03)

Bug Fixes

• restore exact alpha.194 behavior server code to diagnose ColorTemperatureLight issue (49f1327)

2.0.0-alpha.208 (2026-02-03)

Bug Fixes

• ensure colorTemperatureMireds is never undefined in update() (7f01a3a)

2.0.0-alpha.207 (2026-02-03)

Bug Fixes

• revert to alpha.194 defaults - remove onLevel, colorMode, enhancedColorMode, onOff defaults (e797541)

2.0.0-alpha.206 (2026-02-03)

Bug Fixes

• add debug logging to behavior servers to diagnose initialization errors (602f121)

2.0.0-alpha.205 (2026-02-03)

Bug Fixes

• #49: improve room selection logging and use consistent mode matching (a1067b5), closes #49

2.0.0-alpha.204 (2026-02-03)

Bug Fixes

• add onOff and enhancedColorMode defaults before super.initialize() (c25cbc6)

2.0.0-alpha.203 (2026-02-03)

Bug Fixes

• add missing defaults for AirQuality and ColorControl before super.initialize() (8cfbd81)

2.0.0-alpha.202 (2026-02-03)

Bug Fixes

• #49: dynamic cleaning mode option matching for Dreame vacuums (179ee92), closes #49
• restore required defaults before super.initialize() in behavior servers (3f9a5b2)

2.0.0-alpha.201 (2026-02-03)

Bug Fixes

• #49: preserve original error in retry utility to fix [object Object] logging (57a6d7f)

2.0.0-alpha.200 (2026-02-03)

Bug Fixes

• #49: use room ID instead of array index for mode values to match ServiceArea (33a3816), closes #49

2.0.0-alpha.199 (2026-02-03)

Bug Fixes

• #49: improve error logging for HA action failures - show actual error instead of [object Object] (9068fb8), closes #49

2.0.0-alpha.198 (2026-02-03)

Bug Fixes

• preserve all fields in backup/export restore (priority, icon, filterLifeEntity, cleaningModeEntity) (b5976e2)

2.0.0-alpha.197 (2026-02-03)

Bug Fixes

• #76: two-phase debounce for WindowCovering quick swipe handling (0896af3), closes #76

2.0.0-alpha.196 (2026-02-03)

Bug Fixes

• #49: add cleaningModeEntity field to entity mapping UI and API (eb83809), closes #49

2.0.0-alpha.195 (2026-02-03)

Bug Fixes

• sensors: add LevelIndication feature and proper min/max values to all concentration sensors (35d1d6f)

2.0.0-alpha.194 (2026-02-03)

Bug Fixes

• add default values before super.initialize() to all behavior servers (#92) (90d5174)

2.0.0-alpha.193 (2026-02-03)

Bug Fixes

• light: set default ColorControl values before super.initialize() (#92) (fe9966e)

2.0.0-alpha.192 (2026-02-03)

Bug Fixes

• speaker: remove currentLevelPercent from state - was confusing Google Home (#79) (2bef68d)

2.0.0-alpha.191 (2026-02-03)

Bug Fixes

• vacuum: delay room cleaning until RvcRunMode start (#49) (d58863a)

Features

• vacuum: add configurable cleaningModeEntity for Dreame vacuums (#49) (9165031)

2.0.0-alpha.190 (2026-02-03)

Bug Fixes

• vacuum: target correct select entity for Dreame cleaning modes (#49) (77ef1b8)

2.0.0-alpha.189 (2026-02-02)

Features

• vacuum: add RvcCleanModeServer for Dreame cleaning modes (Sweeping, Mopping, etc.) (#49) (70f1b7b)

2.0.0-alpha.188 (2026-02-02)

Bug Fixes

• vacuum: handle segment_cleaning and other cleaning states for proper status display (#49) (95a84e0)

2.0.0-alpha.187 (2026-02-02)

Bug Fixes

• reduce WindowCovering debounce from 500ms to 200ms for quick swipes (#76) (fe2a1ef)
• speaker: use 0-254 range for volume - Google Home calculates percentage as currentLevel/254 (#79) (fe31c66)

2.0.0-alpha.186 (2026-02-02)

Features

• ui: redesign Backup & Restore with separate boxes and descriptions (e3fc1a4)

2.0.0-alpha.185 (2026-02-02)

Bug Fixes

• ui: consolidate Backup & Restore section in Health page (#91) (ac4ddb9)

2.0.0-alpha.184 (2026-02-02)

Bug Fixes

• vacuum: filter out unnamed rooms like 'Room 7' by default (#49) (515c3ac)

2.0.0-alpha.183 (2026-02-02)

Features

• frontend: add Startup Order button to header navigation (#81) (69f2352)

2.0.0-alpha.182 (2026-02-02)

Bug Fixes

• speaker: use 0-100 range for volume in Google Home (#79) (01e6b75)

Features

• frontend: add drag-and-drop startup order dashboard (#81) (6b6c98a)

2.0.0-alpha.181 (2026-02-02)

Bug Fixes

• frontend: load icon and priority when editing bridge (#81) (1e3eb8b)

2.0.0-alpha.180 (2026-02-02)

Bug Fixes

• vacuum: re-enable ServiceArea cluster using Matterbridge pattern (127a580)

2.0.0-alpha.179 (2026-02-02)

Bug Fixes

• use dreame_vacuum.vacuum_clean_segment for Dreame vacuums (#49) (44e78aa)

2.0.0-alpha.178 (2026-02-02)

Bug Fixes

• round currentLevel to integer for correct volume display (#79) (eaff2d1)

2.0.0-alpha.177 (2026-02-02)

Bug Fixes

• temporarily disable ServiceArea cluster to fix vacuum initialization (#49) (703278d)

2.0.0-alpha.176 (2026-02-02)

Bug Fixes

• remove Overkiz/Somfy from Matter semantics platforms - use standard HA inversion (#90) (5bd011c)

2.0.0-alpha.175 (2026-02-02)

Bug Fixes

• add detailed debug logging for ServiceArea cluster initialization (#49) (e9cb371)
• update Matter.js to 0.16.8 in apps package.json (#49) (a69a55d)

Features

• update Matter.js to 0.16.8 for ServiceArea cluster fix (#49) (fe6b0e1)

2.0.0-alpha.174 (2026-02-02)

Features

• add debug logging for ServiceArea cluster initialization (#49) (02580bb)

2.0.0-alpha.173 (2026-02-02)

Features

• re-enable ServiceArea cluster for Apple Home room selection (#49) (654c168)

2.0.0-alpha.172 (2026-02-02)

Features

• add debug logging for vacuum room parsing (#49) (f9e996b)

2.0.0-alpha.171 (2026-02-02)

Features

• add debug logging for cover state updates (#88) (437c017)

2.0.0-alpha.170 (2026-02-02)

Bug Fixes

• refactor RvcRunModeServer to pass supportedModes at creation time (#49) (9ba2819)

2.0.0-alpha.169 (2026-02-02)

Features

• add includeMode (any/all) for AND/OR filter logic (#83) (16940e7)

2.0.0-alpha.168 (2026-02-02)

Bug Fixes

• pass initial supportedAreas to ServiceArea cluster at creation time (#49) (47bc74c)

2.0.0-alpha.167 (2026-02-02)

Bug Fixes

• temporarily disable ServiceArea cluster to debug vacuum issue (#49) (240df88)

2.0.0-alpha.166 (2026-02-02)

Features

• add configurable bridge startup priority (#81) (4c3b6ff)

2.0.0-alpha.165 (2026-02-02)

Bug Fixes

• correct ServiceArea initialize() to call super.initialize() first (5be3d06)

2.0.0-alpha.164 (2026-02-02)

Bug Fixes

• revert getSystemMode to v1.10.6 behavior - map Auto to Heat/Cool without AutoMode feature (06413bb)

2.0.0-alpha.163 (2026-02-02)

Bug Fixes

• add logging to debug thermostat setpoint initialization (f4899a7)

2.0.0-alpha.162 (2026-02-02)

Bug Fixes

• use standard thermostat limits to prevent NaN validation errors (a8d56ac)

2.0.0-alpha.161 (2026-02-02)

Bug Fixes

• pass thermostat attributes in final .set() call to prevent override (37f4edd)

2.0.0-alpha.160 (2026-02-02)

Bug Fixes

• pass thermostat initial state during registration (Matterbridge pattern) (5af23d8)

2.0.0-alpha.159 (2026-02-02)

Bug Fixes

• ensure valid thermostat setpoints before super.initialize() - check for NaN (6d7a735)

2.0.0-alpha.158 (2026-02-02)

Bug Fixes

• use static State class for thermostat defaults (Matter.js pattern) (af0c8c7)

2.0.0-alpha.157 (2026-02-02)

Bug Fixes

• remove .with() calls on ClimateThermostatServer to prevent NaN validation errors (c4cad88)

2.0.0-alpha.156 (2026-02-02)

Bug Fixes

• re-apply thermostat defaults after .with() to prevent NaN validation errors (8d7683c)

2.0.0-alpha.155 (2026-02-02)

Bug Fixes

• capture entityId and actions before setTimeout to prevent expired context (#76) (8bd6f71)

2.0.0-alpha.154 (2026-02-02)

Bug Fixes

• set thermostat defaults on featured base class before extension (#82) (1ac3dd6)

2.0.0-alpha.153 (2026-02-02)

Bug Fixes

• define default setpoints in State class to fix NaN validation (#82) (87e5e2a)

2.0.0-alpha.152 (2026-02-02)

Bug Fixes

• set default setpoints before super.initialize() to prevent NaN errors (#82) (a86deb5)

2.0.0-alpha.151 (2026-02-02)

Features

• add Matter 1.4 Service Area cluster for Apple Home room selection (#49) (709bc8e)

2.0.0-alpha.150 (2026-02-02)

Bug Fixes

• handle undefined thermostat setpoints to prevent NaN errors (#82) (a2bfbc2)

2.0.0-alpha.149 (2026-02-02)

Bug Fixes

• capture action and homeAssistant before setTimeout to fix expired context crash (#76) (0509c7d)

2.0.0-alpha.148 (2026-02-02)

Bug Fixes

• remove AutoMode feature from ClimateDevice to fix Behaviors have errors (#82) (b943898)

2.0.0-alpha.147 (2026-02-02)

Bug Fixes

• set RvcRunMode supportedModes before super.initialize() for HomeKit compatibility (#49) (80260af)

2.0.0-alpha.146 (2026-02-02)

Bug Fixes

• debounce WindowCovering position commands to handle rapid Google Home updates (#76) (e28b763)

2.0.0-alpha.145 (2026-02-02)

Bug Fixes

• save filterLifeEntity in entity mapping API and storage (914e136)

2.0.0-alpha.144 (2026-02-02)

Features

• add filter life sensor mapping for Air Purifiers in Entity Mapping UI (c083411)

2.0.0-alpha.143 (2026-02-02)

Features

• add HEPA filter life monitoring for Air Purifiers (47683f1)

2.0.0-alpha.142 (2026-02-02)

Bug Fixes

• support nested Dreame room format and fallback to segments (#49) (f7ec6b2)

2.0.0-alpha.141 (2026-02-02)

Bug Fixes

• binary covers (garage doors) now show Open/Close buttons instead of only percentage slider (#78) (67e3c2a)

2.0.0-alpha.140 (2026-02-02)

Bug Fixes

• thermostat auto mode now correctly displays on Matter controllers (#71) (68c7cb1)

2.0.0-alpha.139 (2026-02-02)

Features

• add EntityIsolationService to isolate problematic entities at runtime (1f53a24)

2.0.0-alpha.138 (2026-02-02)

Bug Fixes

• suppress Invalid intervalMs errors to prevent FATAL crashes (#74, #76, #79, #80, #82) (e609988)

2.0.0-alpha.137 (2026-01-31)

Bug Fixes

• add water_heater to entity mapping dropdown and backend factories (90fc7e7)

2.0.0-alpha.136 (2026-01-31)

Bug Fixes

• set minMeasuredValue to 1 for IlluminanceMeasurement (Matter spec requirement) (4344b53)

2.0.0-alpha.135 (2026-01-31)

Features

• add water_valve and pump to Entity Mapping dropdown (118e602)

2.0.0-alpha.134 (2026-01-31)

Bug Fixes

• add min/max measured values to sensor behaviors to prevent Invalid intervalMs error (#74) (6953cd7)

2.0.0-alpha.133 (2026-01-31)

Bug Fixes

• map both setpoints to temperature in auto mode for single-temp thermostats (#71) (42601e1)

2.0.0-alpha.132 (2026-01-31)

Bug Fixes

• include bridge icons in full backup export/import (d06b10a)

2.0.0-alpha.131 (2026-01-31)

Bug Fixes

• add sensor type factories to enable entity mapping override (#73) (b6c13da)

2.0.0-alpha.130 (2026-01-31)

Features

• add water_heater domain support as thermostat device (#14) (4ec0fbc)

2.0.0-alpha.129 (2026-01-31)

Bug Fixes

• add .nojekyll file and copy to docs build output for GitHub Pages (18c308e)
• add asLocalActor to FanControlServer reactors for access control (f3fb3fc)
• add asLocalActor to preUpdateRunningMode for thermostat systemMode writes (fixes #24) (27055dd)
• add asLocalActor to thermostat setpoint handlers (fixes #9) (61fb48d)
• add environment config for GitHub Pages deployment (d62d40c)
• add explicit docs build step with BASE_URL env for GitHub Pages (1cd2593)
• add global error handler to suppress async endpoint storage errors during bridge deletion (edb7efe)
• add missing await to super.initialize() in behavior servers (9131f21)
• add missing dependencies (archiver, multer, unzipper) to app package.json (e6057d7)
• add null checks for entity.state in behavior servers and remove Matter.js patch workaround (43942a9)
• add smokeCoAlarm to ClusterId enum (4ddbe59)
• adjust thermostat setpoint limits to satisfy Matter.js 200 deadband constraint (3cc6ec6)
• auto-detect Overkiz covers and suppress transaction conflicts for stable position display (400a329)
• BridgeWizard sends wrong filter format - use HomeAssistantMatcher (fixes #33) (478b1b8)
• bundle Matter.js packages to include access control patch (765284c)
• check HVAC mode for temperature range support (fixes #9) (2ad5ed1)
• clamp maxHeatSetpointLimit for heating-only thermostats to satisfy Matter.js constraints (9e7cbf4)
• clamp maxHeatSetpointLimit when maxCoolSetpointLimit would exceed 35°C (75c2af7)
• clamp thermostat setpoints to valid limits to prevent Matter.js validation errors (0e48566)
• correct alarm_control_panel action format with domain prefix (fixes #35) (28909e4)
• correct thermostat deadband constraint logic with 2.5C margin (b37f03c)
• correct unit mismatch in thermostat deadband (0.1°C vs 0.01°C) (745e913)
• correct vendor ID mapping - 4996 is iCloud Keychain, not Google (fixes #47) (453c763)
• cover position comparison, thermostat offline status (4f4b80b)
• enable PhysicalContact feature for OccupancySensing cluster (required since revision 5) (855aeb9)
• ensure Bun stub fix is included in stable release (a7f55ba)
• FanControl step command not calling Home Assistant (b5527b5)
• graceful handling of /api/system/info 404 and restore missing components (dec4e00)
• handle endpoint storage errors during bridge deletion (c52110e)
• handle Home Assistant action errors to prevent unhandled promise rejections (fixes #17) (d35229b)
• handle missing transitionTime in LevelControl commands for Google Home compatibility (8cf11af)
• handle mutex-closed error gracefully during shutdown (24d489c)
• handle null transitionTime from Google Home (fixes #41) (8545aab)
• hidden entities should only be included via feature flag, not by filter match (fixes #56) (f5cb1b7)
• improve brightness persistence by checking entity on/off state and add debug logging (fe4be30)
• improve humidity sensor limits, light type detection, and media player power control (ee0c803)
• merge alpha fixes into main (humidity detection, cover position, hvac auto mode, etc.) (674b15e)
• minSetpointDeadBand int8 overflow (250 -> 25) (e929dd7)
• move PACKAGE_VERSION ARG after FROM in standalone Dockerfile (5a1fbd1)
• move super.initialize() to beginning in rvc behavior servers (734461c)
• only apply thermostat deadband when currently in Auto mode (#21) (0b0825f)
• pass APP_VERSION environment variable to Docker containers (958910f)
• patch Matter.js FabricAccessControl to grant Operate access when cluster undefined (ff9f554)
• preserve light brightness on turn-on and correct thermostat setpoint handling (fixes #37, #38) (0facacc)
• prevent thermostat init crash by setting default deadband and improve version reporting (b93b4c7)
• remove AutoMode feature to prevent Matter.js permission error on thermostatRunningMode (fixes #24) (7fb48d2)
• remove broken Pump device (missing mandatory PumpConfigurationAndControl cluster) (91e7a06)
• resolve lint formatting errors in SystemInfo and BackupRestore (c9b8303)
• return minimum level instead of null for controller compatibility (lights, humidifier) (682677a)
• round fan percentage to nearest valid step (#8) (d01ef90)
• separate Smoke and CO alarm types (cherry-pick from alpha) (00b1cbb)
• set controlSequenceOfOperation based on features in initialize() (#28) (a1dc67e)
• set initial RVC state before super.initialize() to satisfy Matter.js validation (f51a9b2)
• set thermostat defaults in ThermostatServer function for conformance (7b0b956)
• stub Bun imports to prevent runtime errors in Node.js (28b9f53)
• sync frontend/backend/common packages from alpha to fix missing components (c658289)
• sync pnpm-lock.yaml and backend package.json from alpha to include all dependencies (5430ea8)
• thermostat deadband constraint violation causing boot loop with climate entities (81774f6)
• trigger release for Matter.js access control patch (5c184af)
• trigger v1.4.0 release with bridge export/import feature (bf8a255)
• use asLocalActor in thermostat reactors to fix access control issues (585cc9b)
• use device_id instead of entity_id for device lookup (fixes #56) (4dafb48)
• use pre-commit handlers for thermostat setpoint changes (#9) (0b1c118)
• use pre-commit reactor to set thermostatRunningMode before Matter.js internal handler (#24) (6ccc964)
• use relative API paths for Home Assistant ingress compatibility (7aa2348)
• use setImmediate for thermostat setpoint and mode changes (#9, #24) (baf4475)

Features

• Add Air Purifier as selectable Matter device type (fixes #43) (c170c3b)
• add AirPurifier and Pump Matter device types (71bd320)
• add AirQuality sensor, improve Fan speed control, add Media Player playback (76f9660)
• add BasicVideoPlayer device type for TV/media player support (fixes #45) (b6a5fcb)
• add bridge export/import functionality (b6e774a)
• Add CO2 sensor with numeric ppm value (fixes #42) (fbe4dba)
• add coverUseHomeAssistantPercentage flag for Alexa-friendly cover percentage display (c8f311c)
• add dark mode toggle and device list sorting (98e4aaf)
• add Full Backup with Identity option and fix API paths in BackupRestore (ab6b663)
• add Pressure, Flow sensors and Valve device type (cherry-pick from alpha) (a6499e1)
• add Pump device with proper PumpConfigurationAndControl cluster (579b287)
• add Smoke/CO Alarm device type (cherry-pick from alpha) (ecb148c)
• add Tuya, LG ThinQ, and Aqara vendor IDs to health dashboard (4893056)
• Add TVOC sensor with numeric ppb value (related to #42) (31dad1e)
• add Update device class mapping to binary sensor (2cc0b4f)
• add vacuum room selection support via RvcRunMode (#49) (bea9068)
• auto-refresh Entity Mappings list after saving from EndpointList (4721ddd)
• capture application logs in buffer for Log Viewer API (3d94994)
• comprehensive UI enhancements - logs, system info, device overview, and devices page (5e621aa)
• enhance System Info with version, environment detection, CPU model (14e1b67)
• health monitoring dashboard, auto-recovery, bridge wizard (ac9c595)
• improve system info API with more parameters (CPU, load, process info) (fc291a6)
• sort bridges alphabetically in UI (#30) (e26d7c1)

2.0.0-alpha.128 (2026-01-31)

Bug Fixes

• detect humidity from current_humidity attribute, not just TARGET_HUMIDITY feature (#67) (9133491)

2.0.0-alpha.127 (2026-01-31)

Bug Fixes

• keep heat_cool as default fallback for auto mode mapping (a8b87d4)

2.0.0-alpha.126 (2026-01-31)

Bug Fixes

• improve hvac_mode auto mapping for climate entities (#71) (bfa55e9)

2.0.0-alpha.125 (2026-01-31)

Bug Fixes

• correct inverted cover state-based position fallback (#72) (634a9d0)

2.0.0-alpha.124 (2026-01-31)

Features

• add Update device class mapping to binary sensor (bb411f3)

2.0.0-alpha.123 (2026-01-31)

Features

• add WaterValveDevice for valve domain and RoomAirConditioner for climate with fan_mode (0505cf8)

2.0.0-alpha.122 (2026-01-30)

Features

• add alexaPreserveBrightnessOnTurnOn feature flag to prevent brightness reset (#37) (4f3c4de)

2.0.0-alpha.121 (2026-01-30)

Bug Fixes

• support 'battery' attribute for Dreame and similar vacuums (#59) (dbc6533)

2.0.0-alpha.120 (2026-01-30)

Bug Fixes

• apply customName from entity mapping to Matter nodeLabel (d6a529c)

2.0.0-alpha.119 (2026-01-30)

Bug Fixes

• add PowerSource for vacuum when battery_level attribute exists (fixes #59) (e9aea12)
• add powerSource to ClusterId enum and fix vacuum PowerSource logic (c27e3f7)

2.0.0-alpha.118 (2026-01-30)

Features

• add battery status support for vacuum devices (fixes #59) (c15a038)

2.0.0-alpha.117 (2026-01-30)

Bug Fixes

• make coverUseHomeAssistantPercentage consistent for reading and writing (#34) (30b9f53)

2.0.0-alpha.116 (2026-01-30)

Bug Fixes

• change humidifier from OnOffPlugInUnit to FanDevice for better Matter controller representation (#58) (765e5e9)

Features

• add humidity sensor and auto mode support for humidifier (#58) (ce9871c)

2.0.0-alpha.115 (2026-01-30)

Bug Fixes

• include icon field in bridge API response (2b7718b)

2.0.0-alpha.114 (2026-01-30)

Bug Fixes

• preserve icon selection when saving bridge config (c8788cf)

2.0.0-alpha.113 (2026-01-30)

Bug Fixes

• remove leading slash from bridge-icons API response for Ingress compatibility (79a9ca9)

2.0.0-alpha.112 (2026-01-30)

Bug Fixes

• use HA limits directly for single-mode thermostats, wide limits for dual-mode (#52) (1044a55)

2.0.0-alpha.111 (2026-01-30)

Bug Fixes

• bridge icon selection now applies correctly, remove duplicate status chip, fix button inverted state (#57), add remote device support (#40) (98ff47f)

2.0.0-alpha.110 (2026-01-30)

Bug Fixes

• hidden entities should only be included via feature flag, not by filter match (fixes #56) (3e19be2)

2.0.0-alpha.109 (2026-01-30)

Bug Fixes

• use device_id instead of entity_id for device lookup (fixes #56) (8afe290)

2.0.0-alpha.108 (2026-01-30)

Features

• auto-refresh Entity Mappings list after saving from EndpointList (8c18888)

2.0.0-alpha.107 (2026-01-29)

Bug Fixes

• WebSocket URL includes Ingress path for proper routing (d6c8a6a)

2.0.0-alpha.106 (2026-01-29)

Bug Fixes

• use relative API URL for bridge-icons (Ingress compatibility) (a9d630b)

2.0.0-alpha.105 (2026-01-29)

Bug Fixes

• add error handling for bridge icon existence check (26172d2)

2.0.0-alpha.104 (2026-01-29)

Bug Fixes

• ensure minCoolSetpointLimit >= minHeatSetpointLimit + deadband for Heating+Cooling thermostats (00dbb46)

2.0.0-alpha.103 (2026-01-29)

Features

• add custom image upload for bridge icons (PNG, JPG, GIF, WebP, SVG) (6687fca)

2.0.0-alpha.102 (2026-01-29)

Features

• add configurable icon field to bridge config with dropdown selection (99900a4)

2.0.0-alpha.101 (2026-01-29)

Bug Fixes

• clamp maxHeatSetpointLimit when maxCoolSetpointLimit would exceed 35°C (066b726)

2.0.0-alpha.100 (2026-01-29)

Features

• add domain-based bridge icons, entity mapping in card view, and clean up UI (fixes #44) (48f6933)

2.0.0-alpha.99 (2026-01-29)

Bug Fixes

• clamp maxHeatSetpointLimit for heating-only thermostats to satisfy Matter.js constraints (a57a0f9)

2.0.0-alpha.98 (2026-01-29)

Features

• add BasicVideoPlayer device type for TV/media player support (fixes #45) (5537472)

2.0.0-alpha.97 (2026-01-29)

Bug Fixes

• support auto-only thermostats by treating them as heating devices (fixes #54) (bf0281c)

2.0.0-alpha.96 (2026-01-29)

Bug Fixes

• add uniqueId to BridgedDeviceBasicInformation for Alexa deduplication (fixes #53) (4b7a7e5)

2.0.0-alpha.95 (2026-01-29)

Reverts

• Revert "feat: add GarageDoorDevice for Apple CarPlay support (fixes #50)" (78f4f54)

2.0.0-alpha.94 (2026-01-29)

Features

• add GarageDoorDevice for Apple CarPlay support (fixes #50) (13c5ca8)

2.0.0-alpha.93 (2026-01-29)

Bug Fixes

• handle null transitionTime from Google Home (fixes #41) (f4a0ff3)

2.0.0-alpha.92 (2026-01-29)

Bug Fixes

• check HVAC mode for temperature range support (fixes #9) (c1244b9)

2.0.0-alpha.91 (2026-01-29)

Bug Fixes

• expand thermostat setpoint limits instead of restricting them (6957c46)

2.0.0-alpha.90 (2026-01-29)

Bug Fixes

• show all leaf endpoints in card view, not just aggregator (669557d)

2.0.0-alpha.89 (2026-01-29)

Features

• add All Devices button to EndpointList in bridge details (6c8f1d4)

2.0.0-alpha.88 (2026-01-29)

Bug Fixes

• sync frontend components from testing (AppTopBar, EndpointList, BridgeDetails) (f2dded5)

2.0.0-alpha.87 (2026-01-29)

Features

• add Tuya, LG ThinQ, and Aqara vendor IDs to health dashboard (6a11695)

2.0.0-alpha.86 (2026-01-29)

Bug Fixes

• correct vendor ID mapping - 4996 is iCloud Keychain, not Google (fixes #47) (55cfd51)

2.0.0-alpha.85 (2026-01-29)

Features

• Add All Devices overview with entity mapping support (18b6f62)

2.0.0-alpha.84 (2026-01-29)

Features

• Add Air Purifier as selectable Matter device type (fixes #43) (67fa949)
• Add TVOC sensor with numeric ppb value (related to #42) (c512976)

2.0.0-alpha.83 (2026-01-29)

Features

• Add CO2 sensor with numeric ppm value (fixes #42) (fc73081)

2.0.0-alpha.82 (2026-01-29)

Bug Fixes

• handle missing transitionTime in LevelControl commands for Google Home compatibility (622787a)

2.0.0-alpha.81 (2026-01-29)

Bug Fixes

• improve brightness persistence by checking entity on/off state and add debug logging (9cc3cf0)

2.0.0-alpha.80 (2026-01-29)

Features

• add coverUseHomeAssistantPercentage flag for Alexa-friendly cover percentage display (883ce66)

2.0.0-alpha.79 (2026-01-29)

Bug Fixes

• preserve light brightness on turn-on and correct thermostat setpoint handling (fixes #37, #38) (3723d32)

2.0.0-alpha.78 (2026-01-29)

Bug Fixes

• add global error handler to suppress async endpoint storage errors during bridge deletion (a21c32e)

2.0.0-alpha.77 (2026-01-29)

Bug Fixes

• handle endpoint storage errors during bridge deletion (43c7527)

2.0.0-alpha.76 (2026-01-29)

Bug Fixes

• correct alarm_control_panel action format with domain prefix (fixes #35) (a151091)

2.0.0-alpha.75 (2026-01-29)

Bug Fixes

• auto-detect Overkiz covers and suppress transaction conflicts for stable position display (ecde728)

2.0.0-alpha.74 (2026-01-29)

Bug Fixes

• correct thermostat deadband constraint logic with 2.5C margin (fde0e98)

2.0.0-alpha.73 (2026-01-29)

Bug Fixes

• adjust thermostat setpoint limits to satisfy Matter.js 200 deadband constraint (e92b485)

2.0.0-alpha.72 (2026-01-29)

Bug Fixes

• remove AutoMode feature to prevent Matter.js permission error on thermostatRunningMode (fixes #24) (36d50b2)

2.0.0-alpha.71 (2026-01-29)

Bug Fixes

• add asLocalActor to preUpdateRunningMode for thermostat systemMode writes (fixes #24) (fd4cd11)

2.0.0-alpha.70 (2026-01-29)

Bug Fixes

• BridgeWizard sends wrong filter format - use HomeAssistantMatcher (fixes #33) (5de5221)

2.0.0-alpha.69 (2026-01-29)

Bug Fixes

• add asLocalActor to thermostat setpoint handlers (fixes #9) (a567cf7)

2.0.0-alpha.68 (2026-01-29)

Features

• add exponential backoff retry, circuit breaker, and config validation (1fb6d03)

2.0.0-alpha.67 (2026-01-29)

Bug Fixes

• resolve lint formatting errors in SystemInfo and BackupRestore (b6057c0)

Features

• enhance System Info with version, environment detection, CPU model (20dc7e1)

2.0.0-alpha.66 (2026-01-29)

Features

• capture application logs in buffer for Log Viewer API (d58c7fb)

2.0.0-alpha.65 (2026-01-29)

Bug Fixes

• use relative API paths for Home Assistant ingress compatibility (a791fd9)

2.0.0-alpha.64 (2026-01-29)

Features

• add Full Backup with Identity option and fix API paths in BackupRestore (8822468)

2.0.0-alpha.63 (2026-01-28)

Features

• improve system info API with more parameters (CPU, load, process info) (8c60bc3)

2.0.0-alpha.62 (2026-01-28)

Bug Fixes

• graceful handling of /api/system/info 404 and restore missing components (26e396d)

2.0.0-alpha.61 (2026-01-28)

Features

• comprehensive UI enhancements - logs, system info, device overview, and devices page (9e21ba7)

2.0.0-alpha.60 (2026-01-28)

Bug Fixes

• use pre-commit handlers for thermostat setpoint changes (#9) (8070297)

2.0.0-alpha.59 (2026-01-28)

Bug Fixes

• use pre-commit reactor to set thermostatRunningMode before Matter.js internal handler (#24) (79b2f6c)

2.0.0-alpha.58 (2026-01-28)

Bug Fixes

• include hidden entities when explicitly matched by filter (#26) (8bb96b8)

2.0.0-alpha.57 (2026-01-28)

Features

• add full backup with Matter identity files (#31) (29c934e)

2.0.0-alpha.56 (2026-01-28)

Features

• sort bridges alphabetically in UI (#30) (2b38f06)

2.0.0-alpha.55 (2026-01-28)

Bug Fixes

• use asLocalActor in thermostat reactors to fix access control issues (1fd1023)

2.0.0-alpha.54 (2026-01-28)

Bug Fixes

• set controlSequenceOfOperation based on features in initialize() (#28) (627191c)

2.0.0-alpha.53 (2026-01-28)

Bug Fixes

• use setImmediate for thermostat setpoint changes (#9) (73bef52)

2.0.0-alpha.52 (2026-01-28)

Bug Fixes

• use setImmediate for thermostat mode changes to bypass transaction conflicts (#24) (cfe325a)

2.0.0-alpha.51 (2026-01-28)

Bug Fixes

• handle transaction conflict in fan control state updates (91b967f)

2.0.0-alpha.50 (2026-01-28)

Features

• add fan preset mode support and fix script filtering (#26) (f63b715)

2.0.0-alpha.49 (2026-01-28)

Bug Fixes

• call HA action before thermostatRunningMode update to prevent blocking (#24) (1759fb2)

2.0.0-alpha.48 (2026-01-28)

Bug Fixes

• climate mode change from Apple Home fails with read-only error (#24) (856e1ea)

2.0.0-alpha.47 (2026-01-28)

Bug Fixes

• entity mapping delete using array index instead of entityId (20b4d46)

2.0.0-alpha.46 (2026-01-28)

Bug Fixes

• add minSetpointDeadBand and absolute limits to thermostat defaults (e925164)

2.0.0-alpha.45 (2026-01-28)

Bug Fixes

• set thermostat defaults at behavior creation to prevent conformance errors (a898cb9)

2.0.0-alpha.44 (2026-01-28)

Bug Fixes

• suppress transient endpoint storage errors in applyPatchState during behavior initialization (4ab6f94)

2.0.0-alpha.43 (2026-01-28)

Bug Fixes

• set thermostat controlSequenceOfOperation before first update (7a47ff4)

2.0.0-alpha.42 (2026-01-28)

Bug Fixes

• avoid fatal crash when endpoint storage is temporarily inaccessible (0552e1d)

2.0.0-alpha.41 (2026-01-28)

Bug Fixes

• thermostat init deadband ordering and robust filter preview error parsing (39a7222)

2.0.0-alpha.40 (2026-01-28)

Bug Fixes

• prevent thermostat init crash by setting default deadband and improve version reporting (1fd5260)
• satisfy CI lint (export server bases, organize imports) (1c06a53)

2.0.0-alpha.39 (2026-01-27)

Bug Fixes

• only apply thermostat deadband when currently in Auto mode, not just when feature is supported (#21) (0f0db53)

2.0.0-alpha.38 (2026-01-27)

Bug Fixes

• add null checks for entity.state in all behavior servers to prevent crashes when entities are deleted (477da9c)

2.0.0-alpha.37 (2026-01-27)

Bug Fixes

• remove Matter.js patch workaround - now using asLocalActor per Matter.js team advice (0b6c6c0)

2.0.0-alpha.36 (2026-01-27)

Bug Fixes

• use asLocalActor for attribute change handlers to fix access control issues (per Matter.js team) (f9334e4)

2.0.0-alpha.35 (2026-01-27)

Features

• graceful error handling for failed entities with frontend display (521f7f3)

2.0.0-alpha.34 (2026-01-27)

Bug Fixes

• add AirQualityServer to PM2.5/PM10 sensors to satisfy mandatory airQuality attribute (2d9b3a1)
• resolve lint errors (parseInt radix, useless switch case) (20fe6d8)

2.0.0-alpha.33 (2026-01-27)

Bug Fixes

• prevent crash when entity is enabled from disabled state (missing state) (e7901c9)

2.0.0-alpha.32 (2026-01-27)

Bug Fixes

• enable PhysicalContact feature for OccupancySensing cluster (required since revision 5) (89ff72e)

2.0.0-alpha.31 (2026-01-27)

Features

• add PM2.5 and PM10 concentration measurement sensors with numeric values (b52a4c3)

2.0.0-alpha.30 (2026-01-27)

Features

• add ProductName filter for Include/Exclude entity filtering (dccf818)

2.0.0-alpha.29 (2026-01-27)

Bug Fixes

• handle Matter.js endpoint storage errors gracefully to prevent crashes (2a059bc)

2.0.0-alpha.28 (2026-01-27)

Features

• add restart prompt after backup restore and fix error message display (769edaf)

2.0.0-alpha.27 (2026-01-27)

Bug Fixes

• handle Home Assistant action errors to prevent unhandled promise rejections (fixes #17) (1f35169)

2.0.0-alpha.26 (2026-01-27)

Features

• add Pump device with proper PumpConfigurationAndControl cluster (ebc989e)

2.0.0-alpha.25 (2026-01-27)

Bug Fixes

• remove broken Pump device (missing mandatory PumpConfigurationAndControl cluster) (b1bd5b9)

2.0.0-alpha.24 (2026-01-27)

Features

• add AirPurifier and Pump Matter device types (cherry-pick from main) (1b1346f)

2.0.0-alpha.23 (2026-01-27)

Bug Fixes

• clamp thermostat setpoints to valid limits to prevent Matter.js validation errors (2d190b5)

2.0.0-alpha.22 (2026-01-27)

Features

• add comprehensive REST API with Home Assistant, Logs, and Metrics endpoints (128a070)

2.0.0-alpha.21 (2026-01-27)

Bug Fixes

• set initial RVC state before super.initialize() to satisfy Matter.js validation (23dcd5e)

2.0.0-alpha.20 (2026-01-27)

Bug Fixes

• revert thermostat deadband changes - Matter.js enforces constraint on limits (313e5d6)

2.0.0-alpha.19 (2026-01-27)

Bug Fixes

• remove deadband offset from thermostat setpoint limits (c2a5290)

2.0.0-alpha.18 (2026-01-27)

Bug Fixes

• trigger release for Bun import stub fix (66818ab)

2.0.0-alpha.17 (2026-01-27)

Bug Fixes

• bundle Matter.js packages to include access control patch (2791246)
• patch Matter.js FabricAccessControl to grant Operate access when cluster undefined (ca490e2)
• stub Bun imports to prevent runtime errors in Node.js (53db982)

2.0.0-alpha.16 (2026-01-27)

Bug Fixes

• FanControl step command not calling Home Assistant (91acf08)

2.0.0-alpha.15 (2026-01-26)

Bug Fixes

• move super.initialize() to beginning in rvc behavior servers (1fb48f8)

2.0.0-alpha.14 (2026-01-26)

Bug Fixes

• add missing await to super.initialize() in behavior servers (#8) (803dd35)

2.0.0-alpha.13 (2026-01-26)

Bug Fixes

• round fan percentage to nearest valid step (#8) (292cc91)

2.0.0-alpha.12 (2026-01-26)

Bug Fixes

• separate Smoke and CO alarm types to prevent duplicate sensors (#7) (53e7d03)

2.0.0-alpha.11 (2026-01-26)

Features

• add Add Controller button for multi-fabric re-pairing (a9a6829)

2.0.0-alpha.10 (2026-01-26)

Features

• add Backup/Restore section to Health page (b4ea8d5)

2.0.0-alpha.9 (2026-01-26)

Bug Fixes

• return minimum level instead of null for humidifier controller compatibility (dfb36a7)

2.0.0-alpha.8 (2026-01-26)

Bug Fixes

• return minimum level instead of null for Apple Home compatibility (c3cb384)

2.0.0-alpha.7 (2026-01-26)

Bug Fixes

• move multer to runtime dependencies (01e46a1)

2.0.0-alpha.6 (2026-01-26)

Bug Fixes

• pin archiver and unzipper versions and add to app dependencies (65fd739)

Features

• add backup/restore system, smoke/CO detector, filter preview, dark mode, sorting, and update docs (5bcc9a0)

2.0.0-alpha.5 (2026-01-26)

Features

• add dark mode toggle, device list sorting, and filter preview (b4fe7e0)

2.0.0-alpha.4 (2026-01-26)

Bug Fixes

• pass APP_VERSION environment variable to Docker containers (79bde68)

2.0.0-alpha.3 (2026-01-26)

Bug Fixes

• handle mutex-closed error gracefully during shutdown (e23bcee)

2.0.0-alpha.2 (2026-01-26)

Features

• improve Fan speed control, add Media Player playback (0de6198)

2.0.0-alpha.1 (2026-01-26)

• fix!: AirQuality sensor conformance - enable all feature flags (d037659)

BREAKING CHANGES

• Alpha version bump to 2.0.0 series. This release includes major new features like Health Monitoring Dashboard, Auto-Recovery, and Bridge Wizard.

1.5.0-alpha.22 (2026-01-26)

Features

• health monitoring dashboard, auto-recovery, bridge wizard (3800813)

1.5.0-alpha.21 (2026-01-26)

Bug Fixes

• cover position comparison, thermostat offline status, valve actions (4388383)

1.5.0-alpha.20 (2026-01-26)

Bug Fixes

• improve humidity sensor limits, light type detection, and media player power control (30c94de)

1.5.0-alpha.19 (2026-01-26)

Bug Fixes

• correct unit mismatch in thermostat deadband (0.1°C vs 0.01°C) (7b88ee3)

1.5.0-alpha.18 (2026-01-26)

Bug Fixes

• minSetpointDeadBand int8 overflow (250 -> 25) (3110267)

1.5.0-alpha.17 (2026-01-26)

Bug Fixes

• thermostat deadband constraint violation causing boot loop with climate entities (a680be8)

1.5.0-alpha.16 (2026-01-26)

Bug Fixes

• add .nojekyll file and copy to docs build output for GitHub Pages (cf96b0c)

1.5.0-alpha.15 (2026-01-26)

Bug Fixes

• add environment config for GitHub Pages deployment (87101a8)

1.5.0-alpha.14 (2026-01-26)

Bug Fixes

• add explicit docs build step with BASE_URL env for GitHub Pages (259d57b)

1.5.0-alpha.13 (2026-01-26)

Features

• integrate structured logging with context and retry utilities into backend (44bcb9f)

1.5.0-alpha.12 (2026-01-26)

Features

• add structured logging, retry utilities, and UI improvements (a0b21ec)

1.5.0-alpha.11 (2026-01-26)

Bug Fixes

• StatusIndicator health API structure mismatch (5b43fbb)

1.5.0-alpha.10 (2026-01-26)

Features

• add Alarm Control Panel device type (db96ffb)

1.5.0-alpha.9 (2026-01-26)

Features

• add Pressure, Flow, Air Quality sensors and Water Valve (330d4e3)

1.5.0-alpha.8 (2026-01-26)

Bug Fixes

• add null checks in StatusIndicator to prevent crash (e64b9a6)

1.5.0-alpha.7 (2026-01-26)

Bug Fixes

• add smokeCoAlarm to ClusterId enum (868558c)
• correct API URLs for Home Assistant ingress support (8d6a8b5)

Features

• add Smoke/CO Alarm device type and update entity mappings (5d405e4)

Performance Improvements

• parallelize state updates for faster Alexa/Google Home response (dea2e62)

1.5.0-alpha.6 (2026-01-26)

Features

• add WebSocket live updates and status indicator (227edc8)

1.5.0-alpha.5 (2026-01-26)

Features

• add migration support for importing stable exports into alpha (331f11d)

1.5.0-alpha.4 (2026-01-26)

Bug Fixes

• handle missing entity-mappings storage data (21674ab)

1.5.0-alpha.3 (2026-01-26)

Features

• complete entity mapping UI integration (48d0ace)

1.5.0-alpha.2 (2026-01-26)

Features

• add bridge export/import functionality (fbd42bd)

1.5.0-alpha.1 (2026-01-25)

Features

• add entity mapping customization (0e89fd0)

1.4.1-alpha.1 (2026-01-25)

Bug Fixes

• biome formatting for .releaserc.json (5ca1c4d)

1.4.0 (2026-01-25)

Features

• add health check API and WebSocket live updates (bbbfd18)

1.3.1 (2026-01-25)

Bug Fixes

• rebuild frontend with APP_VERSION during release (34b0bdf)

1.3.0 (2026-01-25)

Bug Fixes

• docs: add base_url for GitHub Pages deployment (d4e589e)
• pin Node.js to 22.13.1 for armv7 Docker support (5be5e97)

Features

• drop armv7 support, upgrade to Node 24 (0b53cc6)

1.2.0 (2026-01-25)

Features

• graceful handling of entities with too long IDs (6580cdd)

1.1.3 (2026-01-25)

Bug Fixes

• docker: add tini for proper signal handling (244800d)

1.1.2 (2026-01-25)

Bug Fixes

• revert to Node 22 - Node 24 has no armv7 Docker support (2206ae4)

1.1.1 (2026-01-25)

Bug Fixes

• disable NPM publish - package owned by original maintainer (9d65932)

1.1.0 (2026-01-25)

Features

• add regex and device_name filters, update to riddix ownership, fix Windows compatibility (2095da4)

1.0.0 (2026-01-25)

Bug Fixes

• add additional null-checks to prevent startup failures (c53c29f), closes #584
• add configuration option to set Country Code in regulatory config (f0145ac), closes #541
• add debug logging when home assistant actions fail (d77826e), closes #264
• add explicit icon for google vendor id (0afbd42), closes #32
• add extra logging when a device cannot be created (fc0a2f0), closes #404
• add fallback mechanism for empty json files (035a0bd), closes #9
• add further null checks to prevent bridge from failing (b8e55c4), closes #404 #412
• add hash to state subscription to prevent reuses when entity filter is changed (1162dce), closes #37
• add missing token to generate github releases (dd3479f)
• add more configuration details (7c95b3c)
• add more details when home assistant connection fails (963d3b2)
• add silly logs for entity exclusion (e635f91), closes #40
• addon: revert docker entrypoint setup for the native home assistant addon (095bd97)
• another try to properly react to state events (04ba690)
• automatically retry home assistant connection on startup (47979d9), closes #347
• automation, scene, input_button, button: add 'lighting' feature to allow onOff to work properly (2f0bf90), closes #638 #636 #630 #596
• avoid transaction locks in applyPatchState by assigning each key (#869) (7c755d2)
• basic-information-server: Use device vendor (#472) (7fd669a)
• basic-information: add vendor id and names to all devices (d3e4703)
• basic-information: consider maxLength of device properties (627aea5), closes #6
• basic-information: ensure variables are actually strings (dc5f700), closes #400
• basic-information: prevent empty values to fail initialization (73185d5), closes #393
• basic-information: use proper device information instead of mocked values (d33c6e8)
• basicInformation: reduce the hash for long names to 4 chars (1212ad3), closes #116
• basicInformation: use the entity_id as name, if name is missing (d4baf5c), closes #117
• binary_sensor: made config of boolean state cluster optional (0710d89), closes #154
• binary_sensor: revert to invert state for ALL contact sensors (572fc85)
• binary_sensor: safe access the config from the state (b703cc7), closes #78
• bridge: enable flex wrapping for filter chips in BridgeDetails (#95) (4dcda7a), closes #94
• bridge: since matter 1.4 bridge names are limited to 32 characters (d6bb614), closes #623
• built clean update mechanism to prevent devices to get re-created (26dc0be), closes #214
• bumb matter.js to 0.12.3 (a1266d9), closes #485 #491
• change fallthrough matcher after migrating to express@5 (620eddd)
• ci: add repository to repository_dispatch (28d34b0)
• ci: allow multiple docker image tags (c737066)
• ci: automatic releases for the addon repository including changelog (4559883), closes #90
• ci: enable releases on the 'latest' channel (1b8d02d)
• ci: properly load changelog for complete release notes (b85f3d1)
• ci: remove typo which prevented the release workflow (7330d8d)
• cleanup boot sequence and state handling, update all dependencies (4afb864)
• climate & fan: correctly react to property changes (08a4d68), closes #624
• climate: add OnOff cluster to climates, so that they can be turned on and off (841a192)
• climate: allow auto-mode only (7bb1f68), closes #47
• climate: do not set the target position when device is off (b828295), closes #169
• climate: ensure correct temperature conversion between home assistant and matter (bb33b7b), closes #411
• climate: ignore unsupported covers and print a warning instead of failing (317ef5c), closes #561
• climate: map all neccessary properties from climate to thermostat (72ab81e), closes #73
• climate: only add humidity sensor if available at all (948a34a), closes #168
• climate: remove optional temperature cluster (#147) (a6d9baa), closes #142
• climate: set controlSequenceOfOperation as a required property (4816273), closes #16
• climate: use 'current_temperature' attribute to get current temperature (b7475a7)
• climate: use cooling and heating together with auto mode (6193a40)
• climate: use entity state instead of hvac_mode attribute (ff20e85), closes #449
• climate: use entity state value as fallback for all status reports (20483e8), closes #73
• color-control: Propagate colorMode (ce5ced4), closes #225
• colorControl: validate min and max mireds to stay in bounds (2e10106), closes #379
• Cover open state incorrectly syncs as "null" instead of 0% in Matter (#910) (9c4b528)
• cover: add AbsolutePosition feature to position aware covers and fake PositionAware feature for non position aware covers (7fb8a01), closes #144
• cover: allow covers to be not position aware (7af0298), closes #144
• cover: do not use configStatus to control lift directions (de7aae8), closes #144
• cover: keep current position in bounds (41f10bf)
• cover: remove absolute position and add operational status (5e37273)
• cover: remove unallowed properties from covers without positions (241206c)
• cover: split feature flag 'mimicHaBehavior' into two features flags for more control (bd24afd)
• cover: use compatible cover types for tilt only or both (a28ee12), closes #393
• cover: use compatible endProductType for tilt and lift (38c9731), closes #444
• debounce HA entity updates to 1 transaction for its attributes (#870) (3608873)
• deps: update all npm dependencies (690abbc)
• deps: update dependency ajv to v8 (e73e5c5)
• deps: update matter.js to v0.11.8 (8fe9509)
• disable automatic releases (54f6e50)
• disable matter environment parsing (effe5a4)
• Do not interpret "unknown" boolean states as "true" matter state (#856) (e3bf044)
• docker: ensure the app handles process signals properly (a8dd37e), closes #516
• docker: migrate all docker images to node22 (0af1d92)
• docker: refactor entrypoint and cmd to allow proper shutdown (57c01b2), closes #516
• docker: remove environment variables from dockerfile (24adece)
• docs: add base-url (7d8e4a0)
• docs: change the addon repository to be added in home assistant (4aedf2e)
• enable update of feature flags without restarting the addon (a5bacab)
• fan-control: always set fan mode sequence (57803ca), closes #274
• finally fix bigint serialization to be compatible with matter.js (51f84e1)
• fix OnOffServer after Matter.js 0.13.0-nightly upgrade (26c3ee7), closes #621 #620
• frontend version number (3ca7218)
• frontend: Add Amazon and Apple vendor IDs (a244855)
• frontend: add base to index.html (75137fe)
• frontend: add copy-to-clipboard action to cluster states (f79ef69)
• frontend: add explicit main page to not prevent history-back (ed13eb8), closes #246 #238
• frontend: add margin to the commissioning qr-code (#198) (9498ae9)
• frontend: Add second Samsung vendor ID (#256) (5ce01aa), closes #253
• frontend: adjust base url to prevent broken urls (370d25b)
• ignore entities by their hidden and disabled state (9e7b641), closes #23
• implement moveToLevelWithOnOff for all levelControls (93ab431), closes #34
• improve logging to debug inclusion and exclusion (f055652)
• input_button: turn the matter device 'on' for a short time (57465a6), closes #388
• input_button: use correct action to trigger the button (936ac64), closes #501
• introduce an initial start-up delay to make sure home assistant is ready (0fdb09a)
• level-control: configure minimal transition time (e754974), closes #4
• light: add fallback-transition time to level- and color-control (b0ed5a8), closes #4
• light: allow adjusting min and max level if value is out of bounds (a95dbda), closes #336
• light: default hue and saturation to 0 when not available (306bf5a), closes #134
• light: do not set out-of-bounds color temperatures (a22ae25), closes #53
• light: ensure color temperature is always within boundaries (dd47e08), closes #676
• light: only round min and max values properly (50394f6), closes #99
• light: Return 0.0 instead of null for light brightness to prevent apple home to fail (7ddbfdd)
• light: round values after converting kelvin and mireds (e4ad137), closes #4
• lights: apply rounding to brightness and color calculations (f72cd9a)
• lights: auto adjust min and max mireds when value is out of bounds (83a6fa0)
• lights: debounce home assistant actions to prevent race conditions (#855) (bd38e20)
• lights: enable features for on/off and level control (e89cb67)
• light: set previous level when light is turned off (f761edd)
• lights: preserve last level control state (6991d9b), closes #217
• lights: proper boundaries for color temperature (784f186), closes #392
• lights: remove old and wrong properties from lights (0c02a6c), closes #138
• light: swap min and max temperature when mixed up in the entity (bcd84cd), closes #410
• light: use correct device type for color temp only devices (4b57edf), closes #52
• log but avoid crash for invalid device errors (df983ed)
• matter: finish transaction before calling home assistant services (f66372c), closes #225
• media_player: set default input when no input could be determined (0830f18), closes #393
• minor frontend fixes (97aa72a), closes #93
• minor patch in state management (cb7607e)
• on-off: allow sending on and off commands, when already on or off (898ba0d), closes #320
• only hash labels larger than max length (3e71fb3)
• prevent bridge edit screen from automatically changing the port (415fada)
• prevent edge cases where storage gets deleted (3bdc6ee)
• prevent race conditions when home assistant responds faster than matter (#211) (5ca0727), closes #208
• properly handle transactions to prevent cyclic event flows (afce77c), closes #763 #745
• properly report brightness value when light is off (#909) (a002204)
• properly trap process signals and shutdown the application (69c1175), closes #516
• properly wait for home assistant to boot before starting any bridge (b8986cc), closes #574 #228 #459
• properly wait for transactions to begin and to commit (#877) (1f96b41), closes #876
• refactor all clusters to use reactTo and pessimistic state changes (cd00915)
• refactor thermostat server to a single behavior with feature flags (a939600)
• remove all entities which don't have a state (cb7b76c), closes #11
• remove feature flags (75b2335)
• remove first-release flag (3b90bfe)
• remove funding (c7eafaa)
• resolve dependabot vulnerability checks (f2aa5ca)
• revert matter.js and cleanup dependencies (89507ce)
• revert matter.js to 0.11.5-alpha.0-20241121-c31bc6998 (a52a66e)
• revert offline transactions for updates (9d548ea), closes #887 #876
• scene: default to off state to be able to turn it on (1af9513), closes #199
• script, automation, scene: explicit call the right commands to activate scripts, automations, and scenes (66f41cd), closes #326
• sensor: fix temperature conversion (59c17d8), closes #64
• smaller fixes after upgrading to Matter 1.4 (7472e7f), closes #615
• storage: do not load device states from disk (1cc51db), closes #532
• storage: fixed storage migration of the last release (8ddb9b5), closes #523
• storage: use multi-file storage to prevent broken storage files due to race conditions (98179e6), closes #435
• support pattern matching (8107a8b), closes #14 #30
• switch: show switches as 'off' if they are unavailable (5b799fb), closes #496
• thermostat: add additional logging when unit of measurement changes (90b625b), closes #411
• thermostat: Check if setting temperature range is supported (#453) (ba3a2f6), closes #377 #449
• thermostat: Compare setpoint with target temperature (#254) (b7259ca)
• thermostat: consider the default unit of measurements from home assistant for temperatures (e9aeb1a), closes #348
• thermostat: refactor how states are synchronized (551da69)
• thermostat: set thermostatRunningState more explicit (8617c88), closes #241
• thermostat: Skip temp commands if state is unavailable (#255) (5e68c47), closes #216
• trigger new release (d00b83f)
• trying to figure out why serialization works locally but not in docker (a2c880b)
• update all dependencies including matter.js (197f01c)
• update dependencies and switch from nx-releases to semantic-release (a587383)
• upgrade to latest matter.js to fix on-off and connectivity issues (91d05eb), closes #627 #613 #594
• use fallback dirname for node:18 (bbe0903)
• use matter internal serialization to be able to serialize additional types (bigint, etc.) (04e6bc5), closes #836
• Use Transaction.act to handle lock acquisition in applyPatchState (#872) (f10c7ed)
• vacuum: consider supported features when pausing a vacuum (70ac3af), closes #645 #659
• vacuum: proper implement pause, resume and mode change commands (c29ed54), closes #616 #637
• vacuum: return to dock when put into idle mode (3a8ac4a)

chore

• major refactoring due to the growing number of supported device types (75a1df3), closes #649 #644

Features

• add a customized app logo (#202) (f01dba6)
• add base url and proxy detection (bbce762)
• add descriptions for docker-compose (7b304fd)
• add IP whitelisting to prevent unauthorized access (916b3ae)
• add support for input_boolean, scene, automation, script (e63a955), closes #21
• adjust proxy request handling and update documentation (f6bdd20)
• allow configuring the mdns-interface (441c99b), closes #42
• allow filtering by entity_category (fc83505)
• allow include and exclude by area (a3ef4a6)
• allow including hidden entities with a feature flag (03be49d), closes #515
• allow specifying basic authentication (4a40caf), closes #434
• basic-information: add serial number to devices (7c37dc1), closes #266
• basicInformation: add change detection and reachable check to all devices (d48c9b6)
• binary_sensor: add support for water leak detector (2f8707a), closes #48
• binary_sensor: allow defaulting unknown device_classes to OnOffSensor (feature flag) (fffef29), closes #525
• cli: added a config-option to provide a configuration file instead of CLI arguments (b5325d6), closes #115
• cli: allow explicit whitelisting of ip addresses for http (dee117e)
• climate: add temperature measurement and humidity sensor (3b44979), closes #68 #96
• climate: add thermostatRunningMode only for autoMode (c928ca5), closes #68
• cover: allow covers to mimic HA behaviors (5e2907a), closes #384 #297 #291
• cover: allow tilt feature (9506263), closes #349
• extracted bridge creation to it's own page, allow editing an existing bridge (38287af), closes #7 #10 #25
• fan-control: Implement fan control cluster (#258) (20cf2bf), closes #43 #173 #250
• frontend: add app logo to header (f9d8021)
• frontend: add details how to connect multiple fabrics (1b717ac)
• frontend: New form-based bridge configuration (#197) (d513357)
• frontend: refactored menu structure (ab40cbf)
• frontend: replace brand icons and add samsung (b3991e2)
• handle button entity the same way as input_button (#480) (573ad24), closes #341
• humidifer: add support for humidifiers mapped to PlugInUnits (dd7fe69), closes #100
• input_button: add support for input_button entities (7b38ad9), closes #195
• light: add support for RGBW and RGBWW lights (e66a180), closes #514
• lights: in general support color control for all lights having hs_color (91a269d), closes #415
• link to new documentation (4419a90)
• media_player: add support for media_players as OnOffPluginUnits (59f081c), closes #57
• media_player: expose media_player as speaker device if feature flag is activated (#156) (b2cd50a)
• media_player: source selection, mute and volume fixes (#363) (8858c30)
• nx-cloud: setup nx cloud workspace (2919527)
• pre-build the addon docker image to increase installation speed and reduce backup size (179f266), closes #323
• prepare configurations per domainm, entity and compatibility mode (cb0b599)
• project setup and complete migration (51301ac)
• sensor: Add illuminance sensor type (#758) (67ec42b)
• show version number in app title (70bdca8), closes #38
• Taking a Holiday Break – See You in the New Year! (86bea0a)
• use custom homeAssistantBehavior for better state management (6e0f862)
• Use device area if available for entities that have no area directly set (#403) (bda867e)
• vacuum: add basic support for vacuums (RVC) (9021b7b)

BREAKING CHANGES

• This could affect some sensors like water leak or occupancy. Make sure to verify your automations in Alexa, Apple Home, Google Home and others.
• MAINTAINER WANTED! This project is currently looking for a new maintainer. Due to limited time, I can no longer actively maintain it. If you are interested in taking over or co-maintaining, please reach out via GitHub Discussions (#825).
• Due to the growing code base and its complexity, I've decided to simplify the application by removing non-compliant workarounds.
• Almost every aspect of the device implementations were touched. I've tried to test as much as possible locally until everything was back working. But since there are so many edge cases in different devices, I probably couldn't verify everything.
• basic-information-server: It can happen, that your controller (Alexa, Google Home, etc.) doesn't match your existing devices and re-pairs all of them. In that case, you'll need to assign the devices to rooms and automations again.
• As the holiday season approaches and my main job keeps me busy, I haven’t been able to dedicate as much time to this project as I’d like. Over the holidays, I’ll be taking a well-deserved break to recharge. That said, if an opportunity arises, I’ll try to answer a few questions or review a pull request via my phone. I’m looking forward to returning refreshed and motivated in the new year. Thank you for your understanding and continued support! Happy holidays!
• thermostat: Auto mode from Home Assistant is no longer supported for climates / thermostats. It just doesn't fit into the Matter specification. Instead, Heat/Cool from Home Assistant is mapped to AutoMode in Matter. I tried to test as much as possible, but since I don't have any physical climate I needed to use GenericThermostat and BetterThermostat to make virtual climates. My testings were therefore limited to simple tests with simple climates. This change could break existing behaviors. Please provide feedback what is working as expected, and what isn't (https://github.com/t0bst4r/home-assistant-matter-hub/discussions/261).
• The native addon (HAOS) will use Home Assistant ingress from now on. Direct access via the port will no longer be possible.