Expand description
Partition-local timers, shared by native and Durable Object drivers.
Re-exports§
pub use registry::TimerHandler;pub use registry::TimerKind;pub use registry::TimerRegistry;
Modules§
- lease_
sweep - Expired epoch-lease table cleanup, confined to the coordinator partition.
- outcome_
delivery - Bounded, at-least-once terminal outcome delivery.
- publication_
recheck - Durable dependency rechecks. One retained timer per blocked advance avoids an unbounded reverse-dependency fanout when membership publishes across refs.
- quota_
rollup - Reconcile each ref shard’s cumulative fixed-window quota into its
coordinator. The coordinator apply precedes the local view write; a crash
between them is safe because
qcstores the last applied cumulative count. - registry
- Timer kind allocations and startup handler registration.
- reservation_
reconcile - Reconcile a pending write or read after its safe abandonment deadline.
- ticket_
expiry - Close due upload tickets and queue one terminal
Expiredoutcome.
Structs§
- DueTimer
- The row handed to a kind-specific codec and handler.
- RunReport
- Counts and the next driver wake, never earlier than this tick’s business time.
- Tick
Budget - Work limits shared by every logical partition of one physical tick.
- Tick
State - Physical-tick counters. Fetching a page reserves its rows before processing them, so an exhausted scan allowance does not discard an already read page.
- Timer
Ctx - Reads available to a handler; effects belong in the returned batch.
Enums§
- Fired
- A handler’s decision, committed by the core.
Constants§
- MAX_
RETRY_ BACKOFF_ MS - Largest persisted retry delay, including after an isolate restart.
- RETRY_
BACKOFF_ MS - Delay before retrying failed or unknown timers, avoiding a busy loop.
Functions§
- earliest_
timer_ put - Earliest timer Put in a batch, shared by both driver adapters.
- run_due
- Fire one partition with its own allowance. Physical drivers should use
run_due_with_stateand share a singleTickStateacross their heads. - run_
due_ with_ state - Fire a partition without refreshing physical-alarm limits. Scans reserve their returned rows and one portable SQL lookahead row before processing. Retry moves preserve the handler’s original due time and opaque payload.