Struct Journal 

pub struct Journal<'a> { /* private fields */ }

Implementations

impl<'a> Journal<'a>

pub fn client(&self) -> &'a Client

The client this service sends through.

pub async fn get_entry( &self, day: &str, ) -> Result<GetJournalEntryResponseContent, Error>

Get journal entry for a day

pub async fn list_entries( &self, params: &ListJournalEntriesParams, ) -> Result<Page<ListJournalEntriesResponseContent>, Error>

List journal entries newest first. The next page, if any, is a Link header. Pass q to search journal entry content.

pub async fn update_entry( &self, day: &str, body: &UpdateJournalEntryRequestContent, ) -> Result<UpdateJournalEntryResponseContent, Error>

Update the journal entry for a day: writes it, creating it if the day has none, and answers the entry as a recording. Empty content removes the entry instead, and HEY then answers 204 with no body — which is not this shape, so send that through the SDK’s own journal wrapper rather than here.

impl Journal<'_>

pub async fn get_content(&self, day: &str) -> Result<Option<String>, Error>

The rich-text HTML of the day’s journal entry, falling back to its plain text, or None when the day has no entry. day is YYYY-MM-DD.

The fallback covers an empty content_html as well as a missing one: HEY serves the key blank on an entry it has no rendered body for, and blank is not the entry.

pub async fn entry(&self, day: &str) -> Result<Option<Recording>, Error>

The day’s journal entry, or None when it has none. The generated Journal::get_entry reads the same route but takes the empty answer for a day without an entry as a body it could not decode.

pub async fn update_content( &self, day: &str, content: &str, ) -> Result<Option<Recording>, Error>

Writes the day’s journal entry, creating it if needed, and answers it as a recording. Empty content removes the entry, which HEY answers with nothing, so the result is None.