Interface LaunchHandle

The control channel back to a launch — the ONLY thing a launcher gets (§2). There is no typed return value (R-SAL-1); status/onDismiss are debounced so they cannot time-distinguish a self-exit from a user dismiss.

interface LaunchHandle {
    launchId: string;
    status: LaunchStatus;
    dismiss(): void;
    onDismiss(cb: () => void): () => void;
}

Properties

Methods

Properties

launchId: string

Host-assigned id for this launch.

status: LaunchStatus

The current lifecycle state (§2).

Methods

  • Ask the host to tear this launch down. Idempotent (double-dismiss is a no-op).

    Returns void

  • Observe the launch ending (self-exit / user dismiss / host revoke — fired identically, R-SAL-1). Returns an unsubscribe fn. Fires at most once; if the launch has already ended it fires on the next tick.

    Parameters

    • cb: () => void

    Returns () => void