homebridge-blueair-plugin 1.1.0

package/.eslintignore

@@ -0,0 +1,3 @@
+dist
+.vscode
+.github

package/.gitattributes

@@ -0,0 +1,3 @@
+# Handle line endings automatically for files detected as text
+# and leave all files detected as binary untouched.
+* text=auto eol=lf

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+# v1.1.0
+## 2026-01-07
+- fix: correct handling of state/sensor updates, so the states of the accessory in the Home app refreshes correctly
+- fix: correct mutex usage
+- fix: supports Node.js v24 (fixes #26)
+- chore: outdated dependencies
+
+# v1.0.11
+## 2024-07-21
+- fix: added Canada to the custom UI

package/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,99 @@
+<p align="center">
+  <a href="https://github.com/homebridge/verified/blob/master/verified-plugins.json"><img alt="Homebridge Verified" src="./branding/Homebridge_x_Blueair.svg" width="500px"></a>
+</p>
+
+# homebridge-blueair-plugin
+
+## Installation
+
+**Option 1: Install via Homebridge Config UI X:**
+
+Search for "Blueair Purifier" in in [homebridge-config-ui-x](https://github.com/oznu/homebridge-config-ui-x) and install `homebridge-blueair-purifier`.
+
+**Option 2: Manually Install:**
+
+```text
+sudo npm install -g homebridge-blueair-purifier
+```
+
+### Features
+
+This plugin only supports WiFi connected BlueAir purifiers utilizing cloud connectivity (via AWS) for device communication. Below is a list of known tested products.
+
+- **Simple Login Mechanism** - all you need is your username and password to get started.
+- **Semi-automatic detection and configuration of multiple BlueAir devices.**
+- **Fast response times** - the plugin uses the BlueAir API to communicate with the devices.
+- **Intelligent device detection** - automatically detects device type and capabilities from API responses.
+- **Expandable sensor support** - supports PM 1/2.5/10, Temperature, Humidity, VOC, HCHO, CO₂, NO₂, and Ozone sensors (when available on device).
+
+>[!NOTE]
+>**Air quality readings** - the plugin may not always report the correct air quality readings (like PM 2.5) due to the BlueAir API limitations. The solution for this issue is in progress.
+>
+>**Advanced sensors** - CO₂, NO₂, and Ozone sensors are now mapped and will be reported when available from your device, pending Homebridge characteristic support.
+
+## Plugin Configuration
+
+### Feature Toggles
+* Show LED service as a lightbulb
+* Show Air Quality Sensor service
+* Show Temperature Sensor service
+* Show Germ Shield switch service
+* Show Night Mode switch service
+
+### Customizable Options
+* Adjustable Filter Change Level
+* Device Name
+* Verbose Logging
+* BlueAir Server Region Selection
+
+### Sensor Support
+
+The plugin supports the following sensors when available on your device:
+
+| Sensor Type | Code | Description |
+|-------------|------|-------------|
+| PM 1.0 | `pm1` | Particulate Matter 1 micron |
+| PM 2.5 | `pm2_5` | Particulate Matter 2.5 microns |
+| PM 10 | `pm10` | Particulate Matter 10 microns |
+| Temperature | `t` | Ambient temperature |
+| Humidity | `h` | Relative humidity |
+| VOC | `tVOC` | Volatile Organic Compounds |
+| Formaldehyde | `hcho` | HCHO concentration |
+| Carbon Dioxide | `co2` | CO₂ levels |
+| Nitrogen Dioxide | `no2` | NO₂ levels |
+| Ozone | `o3` | Ozone concentration |
+| Nitrogen Oxides | `nox` | NOx density |
+
+### Device Detection
+
+The plugin automatically detects device capabilities based on:
+1. **API Device Type** - When the BlueAir API provides device type information
+2. **Model Name** - Pattern matching against known device models
+3. **Fallback Defaults** - Safe defaults for unknown devices
+
+This allows the plugin to intelligently enable/disable features based on what your specific device supports.
+
+## Extending the Plugin
+
+### Adding Support for New Sensors
+
+New sensor types can be added to the plugin by:
+
+1. Updating the sensor map in `src/api/BlueAirAwsApi.ts`
+2. Adding the sensor to the `BlueAirDeviceSensorData` type
+3. Creating appropriate Homebridge characteristics (if new sensor type)
+
+## Credits
+
+This plugin is based on the original work by [@kovapatrik](https://github.com/kovapatrik). Special thanks to him for creating and maintaining the homebridge-blueair-purifier plugin.
+
+If you'd like to support kovapatrik's work:
+- [GitHub](https://github.com/kovapatrik)
+- [Buy Me a Coffee](https://www.buymeacoffee.com/kovapatrik)
+
+Original inspiration from the work of [@fsj21](https://github.com/fjs21) on the Amazon Web Services (AWS) API and construction of the documentation.
+
+### Trademarks
+
+Apple and HomeKit are registered trademarks of Apple Inc.
+BlueAir is a trademark of Unilever Corporation

package/branding/Homebridge_x_Blueair.svg

@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 27.6.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 1800 630" style="enable-background:new 0 0 1800 630;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#0C2F4F;}
+	.st1{fill:#9596AE;}
+	.st2{fill:url(#SVGID_1_);}
+	.st3{fill:url(#SVGID_00000070101692078192461080000003741069921744300967_);}
+	.st4{fill:#FFFFFF;}
+	.st5{fill:none;stroke:#9596AE;stroke-width:5;stroke-linecap:round;stroke-miterlimit:10;}
+</style>
+<g>
+	<g id="Plugin_Logo_00000143588722170484654090000001453365823179829675_">
+		<path class="st0" d="M1292.5,283.5h15.8l-13.7,63.8h-15.4l13.3-63.1V283.5z M1589.6,298.5h-5.3c-9.1,0-14,2.8-21.4,10.5l2.1-9.5
+			h-15.1l-10.5,47.3h15.8l4.6-20.3c1.8-9.5,8.1-14.7,18.6-14.7c2.8,0,5.6,0.7,8.4,1.4l3.2-14.7H1589.6z M1275.3,299.6
+			c-1.4,6-5.6,10.5-11.2,12.6c7,1.8,9.5,8.8,8.1,15.8c-2.1,8.1-8.1,18.6-27.3,18.6h-45.2l13.7-63.1h47.3c9.5,0,17.2,4.2,14.7,15.8
+			V299.6z M1246.3,319.9h-23.5l-3.5,15.1h25.6c4.6,0,8.1-3.2,8.8-7.4c1.4-4.9-1.4-7.7-7-7.7H1246.3z M1249.8,295.4H1228l-3.2,13.3
+			h24.2c3.9,0,7.4-2.5,7.7-6.7c1.1-3.9,0-7-7-7L1249.8,295.4z M1149.5,276.5c-21.3,0-38.5,17.3-38.5,38.5s17.3,38.5,38.5,38.5
+			s38.5-17.3,38.5-38.5S1170.8,276.5,1149.5,276.5z M1438.3,325.9v1.4h-45.6c-1.4,4.9,1.8,11.9,12.3,11.9c5.6,0,10.9-2.1,14.4-6.3
+			h16.8c-7,11.2-18.9,15.8-32.9,15.8c-19.3,0-29.8-7.4-26.3-25.6c3.9-17.5,18.2-25.2,36.8-25.2
+			C1434.8,297.8,1442.1,308.3,1438.3,325.9z M1424.3,318.5c0-2.8-1.4-10.5-13-10.5c-7.2-0.3-13.9,3.9-16.8,10.5h29.4H1424.3z
+			 M1507,314.3l-4.9,23.5c-0.7,3.5-1.1,6.7,0,9.8h-15.8v-5.3c-6.7,5.3-16.8,7-23.8,7c-12.3,0-20.3-4.2-17.5-15.4
+			c2.8-11.2,13-14,22.4-14.7l16.8-1.1c4.9-0.4,6.7-1.4,7.4-5.3c0.7-3.9-1.8-5.6-10.9-5.6c-7,0-10.5,0.4-14,7h-15.1
+			c4.9-14.7,18.6-16.1,31.5-16.1C1505.6,298.2,1509.1,305.2,1507,314.3z M1489.8,324.5c-3.2,1.1-6.3,1.8-9.5,1.8l-9.5,1.1
+			c-5.6,0-8.4,1.8-9.5,6c-1.1,4.2,2.5,7,8.4,7c8.1,0,17.5-4.2,19.3-11.9C1489.1,328.3,1489.8,324.5,1489.8,324.5z M1352.1,323.4
+			c-1.1,8.1-8.1,14-16.1,13.7c-7,0-9.8-3.5-8.4-9.8l5.6-27.7h-15.4l-7,32.2c-3.2,14,8.8,16.8,16.8,16.8c7.7,0,15.1-2.8,21-8.1
+			l-1.4,6.3h15.1l10.2-47.3h-15.8C1356.6,299.6,1352.1,323.4,1352.1,323.4z M1511.9,347.2h15.8l10.2-47.3H1522l-10.2,46.6V347.2z
+			 M1525.9,283.5l-2.1,9.8h15.4l2.1-9.8C1541.3,283.5,1525.9,283.5,1525.9,283.5z"/>
+	</g>
+	<g id="Homebridge">
+		<g id="Text">
+			<path class="st1" d="M136.2,471.8h29v-31.1H178v75.9h-12.7v-33.8h-29v33.8h-12.8v-75.9h12.8v31.1H136.2z"/>
+			<path class="st1" d="M222.8,517.6c-16.9,0-28.4-10.2-28.4-34.1v-9.7c0-23.9,11.4-34.1,28.4-34.1s28.5,10.2,28.5,34.1v9.7
+				C251.3,507.3,239.9,517.6,222.8,517.6z M207.2,483.5c0,16.4,5.5,23,15.6,23s15.7-6.6,15.7-23v-9.7c0-16.4-5.6-23-15.7-23
+				s-15.6,6.6-15.6,23V483.5z"/>
+			<path class="st1" d="M301.7,484.7l21.9-44h12.2v75.9h-12.3v-50.8L306.1,502h-9L280,466.1v50.5h-12.3v-75.9h12.1L301.7,484.7z"/>
+			<path class="st1" d="M401.8,440.7v11.1H368v20h30.5v11H368v22.8h33.8v11h-46.5v-75.9L401.8,440.7z"/>
+			<path class="st1" d="M441,440.7c17.8,0,27,6.6,27,19.7c0.2,7.3-4.3,13.9-11.1,16.5c8.6,2.4,13.5,8.4,13.5,17.9
+				c0,11.4-7.3,21.8-27,21.8h-26.8v-75.9L441,440.7L441,440.7z M429.3,471.7h12.4c9.5,0,13.4-4.3,13.4-10.6c0-5.9-3-9.5-15.1-9.5
+				h-10.7L429.3,471.7z M429.3,505.5h13.3c10.2,0,15-4.2,15-11.4c0-8-5.3-11.4-16.5-11.4h-11.8V505.5z"/>
+			<path class="st1" d="M527.7,516.6l-14.6-30.8h-14.7v30.8h-12.8v-75.9h25.9c17.5,0,27.9,7.6,27.9,22.7c0,10.5-5,17.2-13.8,20.4
+				l16.2,32.9h-14.1V516.6z M510.6,474.8c10.8,0,16.1-2.9,16.1-11.4s-5.3-11.5-16.1-11.5h-12.2v23L510.6,474.8z"/>
+			<path class="st1" d="M569.4,516.6h-12.8v-75.9h12.8V516.6z"/>
+			<path class="st1" d="M589.9,516.6v-75.9h25.6c17,0,28.5,9.1,28.5,33.4v9c0,24.3-11.4,33.4-28.5,33.4L589.9,516.6z M631.2,483.1
+				v-9c0-15.6-4.8-22.3-15.7-22.3h-12.9v53.8h12.9C626.4,505.6,631.2,498.7,631.2,483.1z"/>
+			<path class="st1" d="M713.6,477.6v5.8c0,23.9-10.9,34.1-27.9,34.1s-28.4-10.2-28.4-34.1v-9.1c0-24.4,11.4-34.6,28.4-34.6
+				c15.4,0,25.2,8.6,27.6,24.5H701c-1.9-8.8-6.7-13.4-15.3-13.4c-10.1,0-15.6,6.6-15.6,23v9.7c0,16.4,5.5,23,15.6,23
+				c9.7,0,14.5-5.7,15.4-17.7H686v-11.1L713.6,477.6L713.6,477.6z"/>
+			<path class="st1" d="M776.5,440.7v11.1h-33.8v20h30.5v11h-30.5v22.8h33.8v11H730v-75.9L776.5,440.7z"/>
+		</g>
+		<g id="Logo">
+			
+				<linearGradient id="SVGID_1_" gradientUnits="userSpaceOnUse" x1="450" y1="532.5001" x2="450" y2="832.5001" gradientTransform="matrix(1 0 0 1 0 -446.0001)">
+				<stop  offset="0" style="stop-color:#57277C"/>
+				<stop  offset="1" style="stop-color:#491F59"/>
+			</linearGradient>
+			<circle class="st2" cx="450" cy="236.5" r="150"/>
+			
+				<radialGradient id="SVGID_00000183220377242521611990000013811618075543456901_" cx="450" cy="682.5001" r="150" gradientTransform="matrix(1 0 0 1 0 -446.0001)" gradientUnits="userSpaceOnUse">
+				<stop  offset="0" style="stop-color:#000000;stop-opacity:0"/>
+				<stop  offset="1" style="stop-color:#000000;stop-opacity:0.1"/>
+			</radialGradient>
+			<circle style="fill:url(#SVGID_00000183220377242521611990000013811618075543456901_);" cx="450" cy="236.5" r="150"/>
+			<path class="st4" d="M551.7,221.2h-0.2l-18.3-18.3c-0.6-0.7-1-1.6-1-2.5v-42.3c0-9-7.3-16.2-16.2-16.2h-11.5
+				c-9,0-16.2,7.3-16.2,16.2v0.2l-27.1-26.2c-6.4-6.1-16.5-6-22.8,0.2L346.8,224c-6.3,6.3-6.3,16.6,0,22.9l0,0l0,0l8.7,8.7
+				c6.3,6.3,16.5,6.3,22.9,0.1l70.5-69.4c1.4-1.4,3.6-1.4,5,0l69,69c1.4,1.4,1.4,3.6,0,5l-8.5,8.5c-1.4,1.4-3.6,1.4-5,0l-48.5-47
+				c-6.4-6.2-16.5-6.1-22.8,0.2l-46.5,46.7c-6.3,6.3-6.3,16.6,0,22.9l8.6,8.6c6.3,6.3,16.5,6.3,22.9,0.1l25.1-24.8
+				c1.4-1.4,3.6-1.4,5,0L478,300c1.4,1.4,1.4,3.6,0,5l0,0l-24.7,24.9c-0.1,0-0.2-0.1-0.3-0.1c-5.1,0-9.3,4.1-9.3,9.3
+				c0,5.1,4.1,9.3,9.3,9.3c5.1,0,9.3-4.1,9.3-9.3v-0.2l24.8-24.8c6.4-6.3,6.4-16.6,0-23l0,0L487,291l-24.9-24.5
+				c-6.3-6.2-16.5-6.2-22.8,0l-25.1,24.8c-1.4,1.4-3.6,1.4-5,0l-8.6-8.6c-1.4-1.4-1.4-3.6,0-5l46.5-46.7c1.4-1.4,3.6-1.4,5-0.1
+				l48.5,47.1c6.4,6.1,16.5,6.1,22.8-0.2l8.5-8.5c6.3-6.3,6.3-16.6,0-22.9l-69.1-69.1c-6.3-6.3-16.5-6.3-22.9-0.1l-70.5,69.4
+				c-1.4,1.4-3.6,1.4-5,0l-8.7-8.7c-1.4-1.4-1.4-3.6,0-5l91.7-91.7c1.4-1.4,3.6-1.4,5,0l48.6,47V158c0-2,1.6-3.5,3.5-3.5H516
+				c2,0,3.5,1.6,3.5,3.5v42.4c0,4.3,1.7,8.5,4.8,11.5l18.2,18.2c0,0.1-0.1,0.2-0.1,0.3c0,5.1,4.2,9.3,9.3,9.2c5.1,0,9.3-4.2,9.2-9.3
+				C561,225.4,556.8,221.3,551.7,221.2L551.7,221.2z"/>
+		</g>
+	</g>
+	<g id="Divider">
+		<line class="st5" x1="998" y1="14.2" x2="902" y2="614.2"/>
+	</g>
+</g>
+</svg>

package/dist/accessory.d.ts

@@ -0,0 +1,111 @@
+import { FullBlueAirDeviceState } from "./api/BlueAirAwsApi";
+import { CharacteristicValue, PlatformAccessory } from "homebridge";
+import { DeviceConfig } from "./utils";
+import { BlueAirDevice } from "./device";
+import type { BlueAirPlatform } from "./platform";
+export { BlueAirDevice } from "./device";
+type DeviceType = "humidifier" | "air-purifier";
+export declare class BlueAirAccessory {
+    protected readonly platform: BlueAirPlatform;
+    protected readonly accessory: PlatformAccessory;
+    protected readonly device: BlueAirDevice;
+    protected readonly configDev: DeviceConfig;
+    private service;
+    private fanService?;
+    private filterMaintenanceService?;
+    private readonly optionalServices;
+    private deviceType;
+    private humidityAutoControlEnabled;
+    private lastManualOverride;
+    private lastAutoAdjust;
+    private loggedNoWritableTargetHumidity;
+    private lastBrightness;
+    private fanSpeedDebouncer;
+    private nlBrightnessDebouncer;
+    private humidityDebouncer;
+    private capabilities;
+    constructor(platform: BlueAirPlatform, accessory: PlatformAccessory, device: BlueAirDevice, configDev: DeviceConfig, deviceType?: DeviceType);
+    private initCapabilities;
+    private setupAccessoryInformation;
+    private setupMainService;
+    /**
+     * Setup characteristics common to both Air Purifier and Humidifier services
+     */
+    private setupCommonServiceCharacteristics;
+    private setupAirPurifierService;
+    private setupHumidifierService;
+    /**
+     * Setup separate Fan service for humidifiers (optional)
+     */
+    private setupFanService;
+    /**
+     * Helper to set up or remove an optional service based on config.
+     * Returns the service if enabled, undefined otherwise.
+     *
+     * Note: By default, optional services are NOT linked to the primary service.
+     * This means they appear as separate tiles in the Home app, which provides
+     * a cleaner UX than stacked controls in the main control popup.
+     * The primary service (purifier/humidifier) handles the main device controls.
+     */
+    private setupOptionalService;
+    private setupOptionalServices;
+    private setupEventListeners;
+    /** Helper to get an optional service by subtype */
+    private getOptionalService;
+    /** Helper to update a characteristic on an optional service if it exists */
+    private updateOptionalCharacteristic;
+    updateCharacteristics(changedStates: Partial<FullBlueAirDeviceState>): void;
+    private handleStandbyChange;
+    private handleAutomodeChange;
+    private handleFanspeedChange;
+    private handleAirQualityChange;
+    getActive(): CharacteristicValue;
+    setActive(value: CharacteristicValue): Promise<void>;
+    getCurrentTemperature(): CharacteristicValue;
+    getDisplayOn(): CharacteristicValue;
+    setDisplayOn(value: CharacteristicValue): Promise<void>;
+    getDisplayBrightness(): CharacteristicValue;
+    setDisplayBrightness(value: CharacteristicValue): Promise<void>;
+    getNightLightOn(): CharacteristicValue;
+    setNightLightOn(value: CharacteristicValue): Promise<void>;
+    getNightLightBrightness(): CharacteristicValue;
+    setNightLightBrightness(value: CharacteristicValue): Promise<void>;
+    /** Debounced execution for night light brightness */
+    private executeNlBrightnessChange;
+    getNightMode(): CharacteristicValue;
+    setNightMode(value: CharacteristicValue): Promise<void>;
+    getCurrentAirPurifierState(): CharacteristicValue;
+    getTargetAirPurifierState(): CharacteristicValue;
+    setTargetAirPurifierState(value: CharacteristicValue): Promise<void>;
+    getLockPhysicalControls(): CharacteristicValue;
+    setLockPhysicalControls(value: CharacteristicValue): Promise<void>;
+    getRotationSpeed(): CharacteristicValue;
+    setRotationSpeed(value: CharacteristicValue): Promise<void>;
+    /** Debounced execution for fan speed changes */
+    private executeFanSpeedChange;
+    getFilterChangeIndication(): CharacteristicValue;
+    getFilterLifeLevel(): CharacteristicValue;
+    getPM2_5Density(): CharacteristicValue;
+    getPM10Density(): CharacteristicValue;
+    getVOCDensity(): CharacteristicValue;
+    getAirQuality(): CharacteristicValue;
+    getGermShield(): CharacteristicValue;
+    setGermShield(value: CharacteristicValue): Promise<void>;
+    private findHumidityTargetAttribute;
+    getCurrentRelativeHumidity(): CharacteristicValue;
+    /**
+     * Sync target humidity to current humidity when switching to manual mode.
+     * This provides a sensible starting point for manual control.
+     */
+    private syncTargetHumidityToCurrent;
+    getTargetRelativeHumidity(): CharacteristicValue;
+    setTargetRelativeHumidity(value: CharacteristicValue): Promise<void>;
+    /** Debounced execution for target humidity changes */
+    private executeHumidityChange;
+    private maybeAutoAdjustFanSpeed;
+    getCurrentHumidifierState(): CharacteristicValue;
+    getTargetHumidifierState(): CharacteristicValue;
+    setTargetHumidifierState(_value: CharacteristicValue): Promise<void>;
+    getWaterLevel(): CharacteristicValue;
+}
+//# sourceMappingURL=accessory.d.ts.map

package/dist/accessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessory.d.ts","sourceRoot":"","sources":["../src/accessory.ts"],"names":[],"mappings":"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"}