# `NodeWire.Connection`
[🔗](https://github.com/c2bw/nodewire/blob/v0.1.0/lib/node_wire/connection.ex#L1)

Instance-scoped notifications and bounded transport calls.

# `notify`

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

Queues a message for `c: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.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
