Enum fxa_client::AccountEvent

pub enum AccountEvent {
    CommandReceived {
        command: IncomingDeviceCommand,
    },
    ProfileUpdated,
    AccountAuthStateChanged,
    AccountDestroyed,
    DeviceConnected {
        device_name: String,
    },
    DeviceDisconnected {
        device_id: String,
        is_local_device: bool,
    },
    Unknown,
}

An event that happened on the user’s account.

If the application has registered a DevicePushSubscription as part of its device record, then the Firefox Accounts server can send push notifications about important events that happen on the user’s account. This enum represents the different kinds of event that can occur.

Variants

CommandReceived

Fields

command: IncomingDeviceCommand

Sent when another device has invoked a command for this device to execute.

When receiving this event, the application should inspect the contained command and react appropriately.

ProfileUpdated

Sent when the user has modified their account profile information.

When receiving this event, the application should request fresh profile information by calling get_profile with ignore_cache set to true, and update any profile information displayed in its UI.

AccountAuthStateChanged

Sent when when there has been a change in authorization status.

When receiving this event, the application should check whether it is still connected to the user’s account by calling check_authorization_status, and updating its UI as appropriate.

AccountDestroyed

Sent when the user deletes their Firefox Account.

When receiving this event, the application should act as though the user had signed out, discarding any persisted account state.

DeviceConnected

Fields

device_name: String

Sent when a new device connects to the user’s account.

When receiving this event, the application may use it to trigger an update of any UI that shows the list of connected devices. It may also show the user an informational notice about the new device, as a security measure.

DeviceDisconnected

Fields

device_id: String

is_local_device: bool

Sent when a device disconnects from the user’s account.

When receiving this event, the application may use it to trigger an update of any UI that shows the list of connected devices.

Unknown

An unknown event, most likely an event the client doesn’t support yet.

When receiving this event, the application should gracefully ignore it.

Trait Implementations

impl Debug for AccountEvent

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

Formats the value using the given formatter.