| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🚀 Features

• Added exception protection for device data processing. The library should not crash fully on faulty data received from a single endpoint.

🐞 Bug Fixes

• Fixed complex JS variables parsing

🐣 GitHub & Development

• Extended unit tests for the JS parser

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🐞 Bug Fixes

• Fixed issue with onboarding endpoint parsing (client data) for the new firmware versions

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🚀 Features

• Added traffic monitoring for the AiMesh network via asusrouter.modules.traffic
  • Data rates can be independently monitored for any of the nodes (routers) connected to the AiMesh
  • Wired traffic (fronthaul or backhaul) via ARTrafficSourceEthernet
  • Wireless fronthaul (per band via its MAC address) via ARTrafficSourceWiFi
  • Wireless backhaul via ARTrafficSourceBackhaul
• Added units (and corresponding converters) for data and data rate in asusrouter.tools.units

🐞 Bug Fixes

• Improved error handling on data fetch

🧑‍🚀 v2 preparation

• Added new data fetch flow
  • Already in use for traffic monitoring (directly accessible through v1 calls)
• Added universal source module in asusrouter.modules.source for handling data sources

🐣 GitHub & Development

• Added new exception type AsusRouterRequestFormatError
• Other code improvements
• Bumped ruff to 0.12.11

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🐞 Bug Fixes

• Fixed bug in sensors list generation on raw data failure

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🚀 Features

• Added instance configuration management to AsusRouter class via ARInstanceConfig class in asusrouter.config module
• Added enum tools with FromIntMixin and FromStrMixin mixins to standardise value-to-enum conversion
• Added DeviceOperationMode definition in asusrouter.modules.device
• Added dict_to_request writer

🧑‍🚀 v2 preparation

This release starts implementing non-breaking changes to the library in preparation for the v2 upgrade. Such changes will be gradually introduced and will not be directly available without an explicit call.

• Added ARCallableRegistry via asusrouter.registry
• Added MacAddress class in asusrouter.tools.identifiers
• Added masking tools for MacAddress instances in asusrouter.tools.masking

🐣 GitHub & Development

• Bumped codecov-action to 5.5.0

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🚀 Features

• Added asusrouter.tools.security module and ARSecurityLevel level definition
• Added universal configuration manager base ARConfigBase and key base ARConfigKeyBase
• Added ARConfigKey.DEBUG_PAYLOAD configuration key to define which data can be exposed in the debug logging. Defaults to ARSecurityLevel.DEFAULT, which will automatically block any sensitive data (from the known sensitive endpoints + login endpoint)
• Added configuration management for connection settings in asusrouter.connection_config module
  • ARConnectionConfig connection configuration class
  • ARConnectionConfigKey connection configuration parameters
  • Configurations are set per instance of the Connection class and can be passed during AsusRouter, direct Connection initialisation, or dynamically set during runtime.
• Added fallback features for the connection:
  • To be enabled manually via ARConnectionConfigKey.ALLOW_FALLBACK
  • Fallback matrix follows:
    • HTTPS @ Custom port -> HTTPS @ Default port
    • HTTPS @ Default port -> HTTP @ Default port (if ARConnectionConfigKey.STRICT_SSL is false, default)
    • HTTP @ Custom port -> HTTP @ Default port
    • HTTP @ Default port -> HTTPS @ Default port (if ARConnectionConfigKey.ALLOW_UPGRADE_HTTP_TO_HTTPS is true, default)
  • Loop protection via tracking which fallback was already used
• Added new exceptions to the asusrouter.error module (SSL certificate errors, fallback errors)

🐞 Bug Fixes

• Fixed issue when SSL certificate verification relied on the provided session configs rather than AR settings

🐣 GitHub & Development

• Improved and extended unit tests for the asusrouter.connection module
• Bumped uv.lock dependencies:
  • aiohttp to 3.12.15
  • pytest-cov to 6.2.1
  • ruff to 0.12.9

📖 Documentation

• Updated documentation for the latest features

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🚀 Features

• Added ARConfigKey.NOTIFIED_OPTIMISTIC_TEMPERATURE value for custom control of the optimistic temperature notification warning

🐣 GitHub & Development

• Bumped uv.lock dependencies:
  • pytest to 8.4.1
  • pytest-asyncio to 1.1.0
  • pydantic to 2.11.7
  • mypy to 1.17.1
  • urllib3 to 2.5.0

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🐣 GitHub & Development

• Added py.typed and marked project as typed
• Bumped and fixed setuptools to 80.9.0
• Updated deprecated fields in package description
• Updated dependabot configuration
• Bumped CI dependencies

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🚀 Features

• Added DDNS support via AsusData.DDNS
  • Full compatibility with Asus DDNS servers (.com and .cn)
• Added ARConfigKey enum to help with configuration management. This is now the only supported way to get and set ARConfig keys
• Added robust boot time measurement to fix 1-second jitter. Optional, can be set via ARConfigKey.ROBUST_BOOTTIME (default: False)

🐣 GitHub & Development

• Added ruff configurations
• Added pre-commit hooks
• Added CI check on ruff
• Improved the CONTRIBUTING.md documentation

📦 Dependencies

• Bumped ruff to 0.12.8
• Set pre-commit to 4.3.0

| 📑 Release notes | 📖 Documentation | ⭐️ Star AsusRouter | ⭐️ Home Assistant Integration

🚀 Features

• Added global ARConfig configuration to store settings during the library usage
• Added optimistic temperature conversion for automatic data fix when it is obviously wrong (controlled via the corresponding config)
• Added single AiMesh node reboot via AsusSystem.NODE_REBOOT state (requires MAC of the target node)
• Added config control for target node via AsusSystem.NODE_CONFIG_CHANGE state (requires MAC of the target node and config data)