Skip to main content

Module notifier

Module notifier 

Source
Expand description

Connection-keyed notifier hook for worker registration lifecycle.

This is the application seam for self-describing worker registration. When a worker sends a Frame::WorkerRegister over its established connection, the server associates the registration with the connection’s beamr process id and invokes the configured ConnectionNotifier; on connection close it invokes the matching deregistration. The notifier is connection-keyed (by pid), which is distinct from the subject-keyed responder registry in super::services.

Keeping the hook a liminal-server trait — rather than a liminal-core concern — preserves liminal’s generality: liminal still runs standalone with no notifier configured, and the application (aion, in Stage 2) plugs its registry in without liminal depending on it.

The same trait carries the presence seam for pass-stamped connections: a connection whose Connect verified a registry pass (a browser or agent seat, which sends no WorkerRegister) announces itself once on attach and once on detach through ConnectionNotifier::on_pass_attached and ConnectionNotifier::on_pass_detached, so an application derives presence from those two events and never polls for it.

Traits§

ConnectionNotifier
Application hook invoked when a worker registers or unregisters on a connection.