Struct DeviceEdgeSession 

pub struct DeviceEdgeSession { /* private fields */ }

A device edge session whose identity survives transport route changes.

The session owns a stable id, a stable ledger reference, a mutable current link, an optional device profile binding, an event ledger, a route order, a command queue, and optional visible consent data. Rebinding changes only the route; the id, ledger reference, event history, queued commands, profile, and bound consent remain attached to the same session.

Implementations

impl DeviceEdgeSession

pub fn new(id: Symbol, link: LinkKind) -> Result<Self>

Creates a device edge session using the id as the ledger reference.

pub fn with_ledger( id: Symbol, link: LinkKind, ledger: LedgerRef, ) -> Result<Self>

Creates a device edge session with an explicit ledger reference.

pub fn id(&self) -> &Symbol

Returns the stable session id.

pub fn link(&self) -> &LinkKind

Returns the current route carrying this session.

pub fn ledger_ref(&self) -> &LedgerRef

Returns the stable ledger reference.

pub fn device_profile(&self) -> Option<&DeviceEdgeProfile>

Returns the profile bound to this session, if one was registered.

pub fn bind_profile(&mut self, profile: DeviceEdgeProfile) -> Result<()>

Binds provider/profile metadata to the session.

pub fn route_order(&self) -> &[LinkKind]

Returns the preferred route order for this session.

pub fn set_route_order(&mut self, route_order: Vec<LinkKind>) -> Result<()>

Replaces the preferred route order.

pub fn queue_command(&mut self, command: Expr) -> Result<()>

Queues an actuator command while the current route is unavailable.

pub fn queued_command_count(&self) -> usize

Returns the number of queued commands waiting for a route.

pub fn flushed_commands(&self) -> &[Expr]

Returns the commands flushed after route reconnects.

pub fn flush_queued_commands(&mut self) -> Result<Vec<Expr>>

Flushes queued actuator commands after a route reconnects.

pub fn event_ledger(&self) -> &EventLedger

Returns the session event ledger.

pub fn bound_consent(&self) -> Option<&Expr>

Returns the visible consent data bound to the session, if present.

pub fn bound_consent_session(&self) -> Option<Symbol>

Returns the session symbol embedded in the bound consent data, if any.

pub fn bind_consent(&mut self, consent: Expr) -> Result<()>

Binds visible consent data to the session and records the ledger event.

pub fn rebind(&mut self, link: LinkKind) -> Result<()>

Swaps the transport route without changing the session identity.

pub fn rebind_and_flush(&mut self, link: LinkKind) -> Result<Vec<Expr>>

Swaps the route and flushes queued commands after the reconnect.

Trait Implementations

impl Clone for DeviceEdgeSession

fn clone(&self) -> DeviceEdgeSession

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeviceEdgeSession

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.