Struct SendCooldown 

pub struct SendCooldown { /* private fields */ }

A cooldown ledger over the Database port. Construct it with the table the owning module declares (e.g. "<module>_send_cooldown"); the owning module ships create_table_sql as a migration.

Timestamps are RFC 3339 strings from the Clock port, the same shape the house stores in TEXT columns everywhere: lexicographic order on that format is chronological order, which is what the window compare relies on.

Implementations

impl SendCooldown

pub fn new(table: impl Into<String>) -> Self

pub fn create_table_sql(&self) -> String

The portable DDL for the cooldown table (renders identically on SQLite/D1 and Postgres, ADR 0004).

pub async fn try_acquire( &self, db: &dyn Database, subject: &str, now: &str, cutoff: &str, ) -> Result<bool, DbError>

Claims the send window for subject: true for the one caller whose claim lands, false for anyone inside the window.

now is the RFC 3339 timestamp to record, cutoff the instant (now - window) after which an expired claim may be renewed. The update-then-insert pair is race-free: the guarded UPDATE can be won by exactly one writer, and the conflict-insert covers the row not existing (yet).

Errors

Returns DbError if either write fails.

pub async fn release( &self, db: &dyn Database, subject: &str, ) -> Result<(), DbError>

Releases a claim so the window is not consumed by a send that never started (e.g. the mailer port answered NotConfigured).

Errors

Returns DbError if the delete fails.

pub async fn prune( &self, db: &dyn Database, before: &str, ) -> Result<u64, DbError>

Deletes claims older than before (rows whose window has closed anyway). Returns the number removed; a module calls this from its scheduled handler.

Errors

Returns DbError if the delete fails.

Trait Implementations

impl Clone for SendCooldown

fn clone(&self) -> SendCooldown

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SendCooldown

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

Formats the value using the given formatter.