Struct PersonRecords 

pub struct PersonRecords { /* private fields */ }

Where one app keeps the person’s records on this device. Cloning shares the open records.

Implementations

impl PersonRecords

pub fn open( owners: &mut RecordOwners, package_id: &str, author: UserId, ) -> Result<PersonRecords, RecordOpenError>

package_id’s records of the person author, kept in owners.

Errors

Rejects an invalid package.

pub fn replica( package_id: &str, author: UserId, ) -> Result<PersonRecords, RecordOpenError>

Records that store nothing on this device, for a window whose app already holds the stored ones elsewhere (the same app open in another room): they converge with that window over the record’s route.

Errors

Rejects an invalid package.

pub fn of_package( &self, package_id: &str, ) -> Result<PersonRecords, RecordOpenError>

The person’s records package_id keeps, held in this app’s store beside its own. In one host, these use the original profile-scoped owner registry; another mounted app never opens a second writer or empty fallback replica for the same record. Separate hosts/devices still converge over the record’s route. Sharing an owner adds no editor permission; the framework enforces the resource’s editor list.

Errors

Rejects an invalid package.

pub fn flush(&self) -> Result<(), String>

Write out what is not stored yet, as closing the window does.

Errors

The records’ writer reports a storage failure.

pub fn author(&self) -> &UserId

The person these records belong to.

pub fn room(&self) -> Option<Uuid>

The person’s room, when they have one: the records sync to their other devices only then.

pub fn open_record( &self, kind: RecordKind, initialize: &dyn Fn(&mut AutoCommit) -> Result<(), String>, ) -> Result<PersonRecord, RecordOpenError>

Open the person’s record of kind, created with initialize — its genesis, the same change on every device — when nothing holds it yet. When another window of the app keeps it, this window opens a replica that stores nothing and follows that window’s.

Errors

The record could not be read, created or replicated.

pub fn open_existing_record( &self, kind: RecordKind, ) -> Result<Option<PersonRecord>, RecordOpenError>

The person’s record of kind when it exists, without creating it: what a reader opens, leaving creation to the first write (Self::open_record).

Errors

The record could not be read or replicated.

pub fn open_original_record( &self, kind: RecordKind, initialize: impl Fn(&mut AutoCommit) -> Result<(), String>, ) -> Result<PersonRecord, RecordOpenError>

Open the original writer for a host-owned canonical edit. Unlike the readable replica path, this must observe and edit the actual owner: a busy/missing writer is never replaced by an empty local replica.

Errors

Refuses a replica owner and propagates the original writer’s errors.

Trait Implementations

impl Clone for PersonRecords

fn clone(&self) -> PersonRecords

Returns a duplicate of the value.

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

Performs copy-assignment from source.