Struct Application 

pub struct Application { /* private fields */ }

One application environment on a FeltDB server. Cheap to clone.

Implementations

impl Application

pub fn environment(self, environment: impl Into<String>) -> Self

The same application in another environment.

pub fn id(&self) -> &str

pub fn environment_name(&self) -> &str

pub async fn discover(&self) -> Result<ApplicationInfo>

Discover the environment’s active contract, and remember its revision for later requests.

pub async fn revision_id(&self) -> Result<String>

The revision canonical requests are evaluated against: cached after the first discovery. Call Application::discover again after a promotion to move to the new revision.

pub async fn state_version(&self) -> Result<StateVersion>

The committed state version of the environment’s state, at its active revision.

pub async fn query(&self, query: &CanonicalQuery) -> Result<QueryResult>

Run a canonical query, authorized by the contract’s read policy for the collection.

pub async fn commit(&self, transaction: &AppTransaction) -> Result<AppCommit>

Commit a canonical transaction.

pub async fn read_basis(&self, reads: &ReadSet) -> Result<ReadBasis>

Capture a read basis over the application’s state, under the caller’s read authorization.

pub async fn events(&self, cursor: Option<&str>) -> Result<EventStream>

Committed changes to this application as they happen, from cursor or from now.

pub async fn replay( &self, cursor: Option<&str>, limit: Option<usize>, ) -> Result<ReplayPage>

A bounded page of committed history from cursor (the start when None), at most limit events (the server caps it at 256). Replay, not the live stream, is the authority on history.

pub async fn provenance(&self, collection: &str, id: &str) -> Result<Value>

The complete mutation chain of one record.

pub async fn sign_in(&self, email: &str, password: &str) -> Result<Value>

Sign an end user in to this application; the session’s access token becomes this client’s bearer token.

pub async fn sign_up( &self, email: &str, password: &str, display_name: Option<&str>, ) -> Result<Value>

Register an end user of this application and sign them in.

pub async fn session(&self) -> Result<Value>

The current session’s principal.

pub async fn sign_out(&self) -> Result<()>

End the current session and clear this client’s token.

Trait Implementations

impl Clone for Application

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Application

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

Formats the value using the given formatter.