Class ConnectionApi

Detach an Interactive from its current holder. After detach, interactive.holder is null. Used at disconnect / cleanup (Interactive.onDestruct calls this).

No-op when there's no current holder.

Get all active Interactive connections. Safe read-only operation for mudlib.

Get count of active connections. Safe read-only operation for mudlib.

Get an Interactive by socket ID. Safe read-only operation for mudlib.

Get all socket IDs. Safe read-only operation for mudlib.

Check if a socket ID has an active connection. Safe read-only operation for mudlib.

The connecting player's origin, by playerId. Returns country only (a display name, broadly readable) — the raw IP never leaves the connection layer (the developer-gated IP read is deferred). Empty object when the player isn't connected or geo didn't resolve (localhost / private IP / unknown). The social presence relay reads originOf(player).country for the "from " arrival line.

Record an Interactive's connection origin from its handshake IP: the raw IP is stored transiently on the Interactive (in-memory only — the PII posture) and resolved to a country display name via the offline geo dataset. Called once at connect by the connection layer. A missing / unresolvable IP is a safe no-op.

Route an Interactive to a new holder. Idempotent on the same target.

This is connection routing, not character control or "operate on this avatar" — target is intentionally the broad HasInteractive set (Login during entry, Avatar during play, any future Bot/Spirit). Code that needs to act on an avatar specifically should narrow with instanceof Avatar (or MixinApi.isCommandGiver for command dispatch).

Mechanics: removes interactive from its previous holder (if any), adds it to target via the HasInteractiveMixin primitives, and updates interactive.holder.