# `Continuum.Runtime.TimerWheel`
[🔗](https://github.com/Yyeger/Continuum/blob/main/lib/continuum/runtime/timer_wheel.ex#L1)

Caches near-term durable timers and wakes runs when timers fire.

Postgres remains the source of truth. The wheel hydrates an ETS cache with
timers due inside a short window, listens for `continuum_timer_armed`
notifications, and schedules its next tick from the earliest cached timer.
A periodic refresh rebuilds the cache, so a dropped Postgres notification can
delay a timer by at most the refresh interval.

# `child_spec`

Returns a specification to start this module under a supervisor.

See `Supervisor`.

# `fire_due_once`

```elixir
@spec fire_due_once(keyword()) :: {:ok, non_neg_integer()} | {:error, term()}
```

Fire due timers once.

---

*Consult [api-reference.md](api-reference.md) for complete listing*