Struct RemoteSession 

pub struct RemoteSession { /* private fields */ }

Per-client remote session managing an engine, state, and the wire protocol.

Framework-agnostic: feed it JSON strings, get JSON strings back. Wire it into any WebSocket library (Axum, Actix, Tungstenite, etc.).

Usage

let config = SessionConfig { /* ... */ };
let session = RemoteSession::new(config);
session.set_action_handler(|action, payload, state| { /* ... */ });

// On client connect:
let msgs = session.handle_hello(None);
for m in msgs { ws.send(m); }

// On each incoming message:
let responses = session.handle_message(&incoming_json);
for r in responses { ws.send(r); }

Implementations

impl RemoteSession

pub fn new(config: SessionConfig) -> Self

Create a new remote session.

Sets up the engine with the component resolver and module, but does NOT render yet. The initial render happens in [handle_hello].

pub fn set_action_handler<F>(&self, handler: F)

where F: Fn(&str, Option<&Value>, &Value) -> Value + Send + Sync + 'static,

Set the action handler for this session.

Called when a dispatchAction message arrives. Receives the action name, optional payload, and current state. Must return the new state.

pub fn session_id(&self) -> &str

The session ID assigned to this client.

pub fn handle_hello(&self, _client_session_id: Option<&str>) -> Vec<String>

Handle the hello handshake. Returns [sessionAck, initialTree] as JSON.

Call this either:

• When you receive a hello message from the client, or
• Immediately after connection (for clients that don’t send hello)

pub fn handle_message(&self, json: &str) -> Vec<String>

Handle an incoming JSON message. Returns response messages as JSON strings.

pub fn get_state(&self) -> Value

Get a snapshot of the current state.

pub fn revision(&self) -> u64

Get the current revision number.