Skip to main content

AccountService

Struct AccountService 

Source
pub struct AccountService { /* private fields */ }
Expand description

Connecting, listing and disconnecting accounts.

Keeps the two halves of an account consistent: the record in storage and the credentials in the credential store.

Implementations§

Source§

impl AccountService

Source

pub fn new( accounts: AccountStore, tokens: TokenStore, events: EventBus, storage: Arc<dyn Storage>, clock: Arc<dyn Clock>, ) -> Self

Source

pub async fn connect( &self, connector: &ConnectorId, display_name: impl Into<String>, tokens: &TokenSet, ) -> Result<Account>

Register a freshly authorized account.

Credentials are written first so no visible account can exist without them. If persisting the account fails, the credential write is rolled back.

Source

pub async fn connect_with_token( &self, connector: &ConnectorId, display_name: impl Into<String>, token: impl Into<String>, scopes: Vec<String>, ) -> Result<Account>

Register an account from a pasted token instead of an OAuth flow (B7/C1).

The caller is expected to have verified the token against the service first — this method only records it. Same credential-first ordering and rollback as AccountService::connect.

Source

pub async fn list(&self) -> Result<Vec<Account>>

Source

pub async fn list_for(&self, connector: &ConnectorId) -> Result<Vec<Account>>

Source

pub async fn get(&self, account: &AccountId) -> Result<Account>

Source

pub async fn disconnect(&self, account: &AccountId) -> Result<()>

Remove an account, its credentials and everything stored under it.

The namespace convention (ADR-0019) is what makes the last part mechanical: all account data lives under acct.<connector>.<account>., so no module has to register which namespaces it wrote.

Source

pub async fn mark_expired(&self, account: &AccountId) -> Result<()>

Mark an account as needing re-authentication.

Called when a connector reports that credentials are no longer valid. The credentials are kept: a provider outage can look like an expired token, and deleting them would force an unnecessary reconnect.

Source

pub async fn mark_active(&self, account: &AccountId) -> Result<()>

Mark an account usable again after a successful verification.

Trait Implementations§

Source§

impl Clone for AccountService

Source§

fn clone(&self) -> AccountService

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for AccountService

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more