Core Classes¶

Initialize the service.

Which deliveries a notification would use right now, and who it would reach, without sending it

Send a message via chosen transport, returning the notification, if one could be made

Listen for mobile actions relevant to snooze and silence notifications

Example Action: event_type: mobile_app_notification_action data: foo: a origin: REMOTE time_fired: "2024-04-20T13:14:09.360708+00:00" context: id: 01HVXT93JGWEDW0KE57Z0X6Z1K parent_id: null user_id: a9dbae1a5abf33dbbad52ff82201bb17

Re-publish the current state of every entity SuperNotify provides.

Entities are only refreshed once added to Home Assistant, so this is a safe no-op for any whose platform hasn't loaded (e.g. in tests that build SupernotifyEngine directly without a config entry). Must run in the event loop, as it writes entity state.

Put everything switched on or off at runtime back to its configured enabled state, returning the names reset for each kind.

Walks the scenarios, recipients, deliveries and transports themselves rather than their switches, so one whose switch is disabled in the entity registry is reset too.

Fetch a still image directly from a camera entity, via HA's own camera component API, rather than triggering the camera.snapshot service and polling the filesystem for the resulting file to appear.

Fetch a still image directly from an image entity, via HA's own image component API.

Active, non-system HA user ids mapped to their login username - for discovering recipients that have no Person record (see CONF_USER_ID in const.py), excluding internal accounts like Supervisor/Home Assistant Content that aren't real people.

All enabled mobile apps

Wrap a blocking function call in a HomeAssistant awaitable job

entity_ids in domain (e.g. "notify") registered by a specific integration.

Reads the entity registry directly (not the state machine), so a freshly registered entity counts even before it has reported a first state.

device_model_select optionally filters by the backing device's model (e.g. {"exclude": ["Speaker Group"]}), same include/exclude rule shape used elsewhere.

Return the data of the first enabled, non-ignored config entry for domain, if any.

Fully expanded members of a group.* helper or a platform group (media_player, light... groups created by the group integration expose members in an entity_id state attribute). None if not a group.

Other entities, e.g. scene.* or min/max sensor.*, also expose an entity_id attribute, so anything outside the group domain is only treated as a group if the entity registry says its platform is group.

Guard for HA functionality, largely for tests or docgen

Client aiohttp session for async web requests

True if device_id is this integration's own 'SuperNotify' device (see ha_device_info)

Load integration state previously persisted to Home Assistant's .storage/ area, via HA's own Store helper, or None if nothing has been persisted yet for this key.

The integration that registered this entity (RegistryEntry.platform), if any.

Resolve HA area/floor/label selectors to the entities they reference, through the same core helper as HA entity actions, so groups are expanded and entities inherit the area of their device.

Persist integration state to Home Assistant's .storage/ area, via HA's own Store helper. Fire-and-forget: the write happens in a tracked background task rather than blocking the caller, since this is called from both sync and async contexts.