Status & lifecycle

Observe the MusterBox SDK status machine and diagnostics.

The SDK exposes an explicit, observable status machine.

Status values

Status	Meaning
Uninitialized	No config accepted yet
Stopped	Initialized; no workers running
Running	Workers running; not authenticated
Authenticated	Valid session active

Read the current status programmatically:

use musterbox_sdk::status::SdkStatus;
let status = sdk.get_status();
match status {
  SdkStatus::Authenticated { .. } => { /* session active */ }
  _ => { /* not ready */ }
}

Browser:

const status = box.getStatus(); // { state: "authenticated", ... }

What each transition means

Transition	Trigger
Uninitialized → Stopped	initialize(config)
Stopped → Running	start()
Running → Authenticated	authenticate(...)
Authenticated → Running	logout (session revoked)
Running → Stopped	shutdown()
Authenticated → Stopped	shutdown()

Diagnostics

Diagnostics give you the data you need to report a support issue:

Capability	Native	Browser
Health checks	musterbox diagnostics health	box.getDiagnostics()
Diagnostic bundle	musterbox diagnostics generate	–
Corrupted storage	musterbox storage verify / recover	–

Include the diagnostic bundle when filing a support ticket. See Support.

Session status

get_session_status() distinguishes the SDKSide session state from the backend one (pending validation, active, expired). Use it to drive UI states instead of guessing from player context alone.

Next: Secure purchases.