Struct PersistentIpcClientHandle 

pub struct PersistentIpcClientHandle { /* private fields */ }

Handle to a persistent IPC client that maintains a long-lived connection to the headless sidecar.

The background task automatically:

• Relays IpcEvent frames to app.emit("background-service://event", ...)
• Reconnects on connection failure with exponential backoff (1s–30s, up to 10 retries)
• Forwards commands (start/stop/is_running) over the same connection

Implementations

impl PersistentIpcClientHandle

pub fn spawn<R: Runtime>(socket_path: PathBuf, app: AppHandle<R>) -> Self

Spawn the persistent IPC client background task.

The task immediately begins trying to connect to the socket at socket_path. Events are relayed to the Tauri event system via app.emit().

pub async fn start(&self, config: StartConfig) -> Result<(), ServiceError>

Send a Start command through the persistent connection.

pub async fn stop(&self) -> Result<(), ServiceError>

Send a Stop command through the persistent connection.

pub async fn is_running(&self) -> Result<bool, ServiceError>

Query whether the service is running through the persistent connection.

pub async fn get_state(&self) -> Result<ServiceStatus, ServiceError>

Query the current service lifecycle state through the persistent connection.

pub fn is_connected(&self) -> bool

Returns true if the persistent client is currently connected to the headless sidecar, false otherwise.

pub fn socket_path(&self) -> &PathBuf

Returns the socket path this client is configured to connect to.

pub async fn wait_for_connected( &self, timeout: Duration, ) -> Result<bool, ServiceError>

Wait until the persistent client is connected, polling is_connected() at 500ms intervals.

Returns Ok(true) if connected within the timeout, Ok(false) if the timeout elapsed without connecting.

pub async fn enable_auto_restart( &self, config: Option<StartConfig>, ) -> Result<(), ServiceError>

Enable auto-restart through the persistent connection.

pub async fn disable_auto_restart(&self) -> Result<(), ServiceError>

Disable auto-restart through the persistent connection.

pub async fn get_desired_state( &self, ) -> Result<Option<DesiredState>, ServiceError>

Get the persisted desired-state through the persistent connection.

pub async fn validate_setup( &self, ) -> Result<SetupValidationReport, ServiceError>

Validate background service setup prerequisites through the persistent connection.

pub async fn get_lifecycle_status( &self, ) -> Result<LifecycleStatus, ServiceError>

Get the complete lifecycle status snapshot.

Trait Implementations

impl Drop for PersistentIpcClientHandle

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.