CHANGELOG - Whatsapp Bridge Integration

Release 0.2.4 - 2026-06-15

Fix: Resolved a TypeError in async_get_or_create() caused by stricter Home Assistant Core requirements demanding a config_entry_id for all device registry entries.
Architecture Refinement: The global "WhatsApp Bridge Hub" now utilizes a shared multi-entry architecture. It dynamically links to active configurations under a static identifier, ensuring the hub remains a single, non-duplicated entity that survives individual account deletions.

New (Orphaned Devices Cleaner): Added an automatic database cleanup utility. On startup, the integration now automatically identifies and removes orphaned or "ghost" devices left behind by previous configuration changes or older versions.
Fix: Decoupled the central "WhatsApp Bridge Hub" device from specific config entry bindings. The Hub is now persistent and indestructible, preventing global entities (Broadcast and Live Status) from disappearing when individual user profiles are deleted or re-added.

Architecture Change: Introduced a dedicated "WhatsApp Bridge Hub" device. This central device acts as a single point of reference for global components, preventing UI clutter.
Fix: Moved the global live status sensor and the virtual broadcast entity to the new WhatsApp Bridge Hub device. This ensures they remain fully visible and accessible across the Home Assistant UI, automations, and service calls without being duplicated across individual user accounts.
Improvement: Maintained isolated, clean individual devices for each configured account profile.

Fix: Resolved device assignment duplication where a single global gateway card duplicated across all account tabs.
Fix: Globalized the live status sensor and the broadcast entity to instantiate exactly once for the entire integration rather than incorrectly duplicating per account.
Optimization: Code refactoring within sensor.py to prevent entity duplication when utilizing multiple profiles.

New: Setup of a main device (WhatsApp Bridge Gateway) in the Home Assistant device registry.
New: Integrated global service whatsapp_bridge.send_broadcast, which operates independently of individual profile entities and can send messages to any number or group ID.
New: Added status sensor (sensor.whatsapp_bridge_status). This queries the add-on's new API and provides the current connection status (CONNECTED, WAITING_FOR_SCAN, INITIALIZING, OFFLINE) directly within Home Assistant.
Improved: The sensor is assigned to the new main device, which significantly simplifies automations (e.g., alert on connection loss).