Module

`pages.reactive.events`

Change events, block references, and SSE swap element extraction.

Classes

ConnectionInfo 3 ▼

Identity of a reactive subscriber connection. Attached at subscribe time so the bus can filter eve…

Identity of a reactive subscriber connection.

Attached at subscribe time so the bus can filter events per-user, track presence, and invoke disconnect callbacks.

Name	Type	Description
`session_id`	`str`	Unique session identifier (always required).
`user_id`	`str \| None`	Authenticated user ID, or`None`for anonymous.
`connected_at`	`float`	Monotonic timestamp (`time.monotonic()`) captured at construction time.

ChangeEvent 4 ▼

Emitted by a store after a data mutation.

Name	Type	Description
`scope`	`str`	Scope identifier (e.g., a document ID) so subscribers only receive events for their scope.
`changed_paths`	`frozenset[str]`	The set of context paths that changed (e.g.,`{"doc.content", "doc.version"}`).
`origin`	`str \| None`	Opaque identifier for who caused this change (e.g., user ID, session ID). Used by`reactive_stream` to skip events originating from the same connection. `None`means system-initiated — always delivered.
`audience`	`frozenset[str] \| None`	If set, only deliver to subscribers whose`ConnectionInfo.user_id` is in this set. `None`broadcasts to all subscribers (default).

BlockRef 4 ▼

Reference to a renderable block within a template.

Name	Type	Description
`template_name`	`str`	Kida template name.
`block_name`	`str`	Block name within the template.
`dom_id`	`str \| None`	DOM element ID to target for OOB swap. Defaults to the block name.

target_id 0 str ▼

DOM element ID for OOB targeting.

property

def target_id(self) -> str

str

_SSESwapElement 3 ▼

Parsed info about an HTML element with ``sse-swap``.

Parsed info about an HTML element withsse-swap.

_extract_sse_swap_elements 1 list[_SSESwapElement] ▼

Extract elements with ``sse-swap`` and find their associated blocks. For each …

def _extract_sse_swap_elements(source: str) -> list[_SSESwapElement]

Extract elements withsse-swapand find their associated blocks.

For each<tag ... sse-swap="event" ...>found, captures the swap event name, elementid, and the associated {% block NAME %}.

Handles two common patterns:

Block inside element (block is a child)::

<span id="status" sse-swap="status">
    {% block toolbar_status %}v{{ doc.version }}{% endblock %}
</span>

Block wraps element (block is the parent)::

{% block toolbar_status %}
<span id="status" sse-swap="status">v{{ doc.version }}</span>
{% endblock %}

Name	Type	Description
`source`	`str`

list[_SSESwapElement]