Struct FileActivityJournal 

pub struct FileActivityJournal { /* private fields */ }

File-backed activity journal using NDJSON format.

All entries are appended to a single file. A write mutex ensures line-level atomicity. The entry count is tracked in-memory and incremented on every successful append.

Implementations

impl FileActivityJournal

pub async fn new(path: PathBuf) -> Result<Self, StoreError>

Open (or create) an activity journal at the given file path.

Parent directories are created automatically. The initial entry count is determined by scanning the existing file.

Errors

Returns a backend error if the directory cannot be created or the file cannot be opened for the first scan.

pub fn path(&self) -> &PathBuf

Return the file path backing this journal.

Trait Implementations

impl ActivityJournalPort for FileActivityJournal

fn append<'life0, 'async_trait>( &'life0 self, entry: ActivityEntry, ) -> Pin<Box<dyn Future<Output = Result<(), StoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Append an entry to the journal.

fn query<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 ActivityQuery, ) -> Pin<Box<dyn Future<Output = Result<Vec<ActivityEntry>, StoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Query entries within a time window.

fn count<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64, StoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Count total entries.

impl Debug for FileActivityJournal

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

Formats the value using the given formatter.