Struct Lock 

pub struct Lock<S: LockState> {
    data: LockRecord,
    _state: PhantomData<S>,
}

A lock with compile-time state tracking.

The type parameter S indicates the current state of the lock. Methods are only available in appropriate states:

• Lock<Acquired>: Can be extended or released
• Lock<Released>: Cannot be used (transitions consume the lock)

Example

let lock: Lock<Acquired> = acquire_lock(...);
let extended_lock = lock.extend(Duration::from_secs(30)); // OK
let data = extended_lock.release(); // OK, consumes the lock
// Can't use extended_lock anymore - it was consumed!

Fields

data: LockRecord

_state: PhantomData<S>

Implementations

impl<S: LockState> Lock<S>

pub fn data(&self) -> &LockRecord

Access the underlying lock data (read-only).

pub fn lock_id(&self) -> LockId

Get the lock ID.

pub fn tenant_id(&self) -> TenantId

Get the tenant ID.

pub fn resource_type(&self) -> &ResourceType

Get the resource type being locked.

pub fn resource_id(&self) -> Uuid

Get the resource ID being locked.

pub fn holder_agent_id(&self) -> AgentId

Get the agent holding the lock.

pub fn mode(&self) -> LockMode

Get the lock mode.

pub fn acquired_at(&self) -> Timestamp

Get when the lock was acquired.

pub fn expires_at(&self) -> Timestamp

Get when the lock expires.

impl Lock<Acquired>

pub fn new(data: LockRecord) -> Self

Create a new acquired lock from data.

This should only be called when a lock is successfully acquired.

pub fn extend(self, additional: Duration) -> Self

Extend the lock duration.

Returns a new Lock<Acquired> with the updated expiry time. The original lock is consumed.

pub fn extend_ms(self, additional_ms: i64) -> Self

Extend the lock by milliseconds.

Convenience method for extending by a millisecond count.

pub fn release(self) -> LockRecord

Release the lock and return the underlying data.

Consumes the lock, preventing further operations. The returned data can be used to update the database.

pub fn is_expired(&self, now: Timestamp) -> bool

Check if the lock has expired.

pub fn remaining_duration(&self, now: Timestamp) -> Option<Duration>

Get remaining duration until expiry.

pub fn into_data(self) -> LockRecord

Consume the lock and return just the data (for serialization).

Trait Implementations

impl<S: Clone + LockState> Clone for Lock<S>

fn clone(&self) -> Lock<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + LockState> Debug for Lock<S>

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

Formats the value using the given formatter.