NodeWire.Connection (NodeWire v0.1.0)

Copy Markdown View Source

Instance-scoped notifications and bounded transport calls.

Summary

Functions

Queues a message for NodeWire.Handler.handle_info/3 on this exact connection.

Functions

notify(conn, message, opts \\ [])

@spec notify(NodeWire.Conn.t(), term(), NodeWire.call_options()) ::
  :ok | {:error, :busy | :stale_connection | {:outcome_unknown, term()}}

Queues a message for NodeWire.Handler.handle_info/3 on this exact connection.

Use a snapshot from a callback or registry lookup for asynchronous work. :ok acknowledges queuing, not callback completion. Old instances return {:error, :stale_connection}; overload returns {:error, :busy} before dispatch. Notifications and public sends share the same admission budget.

Accepts :timeout_ms (default 5,000, or :infinity) for the dispatch wait. {:error, {:outcome_unknown, :timeout}} does not cancel queued work; do not automatically replay it. Reserved transport/timer tuples are ignored. Never call synchronously from the same connection's handler.