Changelog

All notable changes to this project will be documented in this file.

[2.0.0] - 2026-11-13

This release has two breaking changes: the queue is now backed by gb_trees, and timeout/1,2,3 is capped at the largest timeout the BEAM accepts.

New backend. A queue is now an opaque %TimeQueue{} struct holding a gb_trees tree, where it used to be a plain map holding a sorted list. Inserts, pops and deletes by time reference are O(log n).

Timeout cap. TimeQueue.timeout/1,2,3 returns at most 4_294_967_295 milliseconds (about 49.7 days), the limit for receive and GenServer timeouts. An event scheduled further away used to crash the process with :timeout_value.

When the next event is beyond that limit, the process wakes up before the event is due. pop/1 then returns {:delay, tref, ms} with the full remaining delay, and timeout/1 gives the next wait. Code that passes the timeout to Process.send_after/3 or :timer.send_after/2, which accept larger values, must handle that {:delay, tref, ms} return.

๐Ÿš€ Features

๐Ÿ› Bug Fixes

๐Ÿ“š Documentation

๐Ÿงช Testing

โš™๏ธ Miscellaneous Tasks

[1.2.3] - 2026-05-29

โš™๏ธ Miscellaneous Tasks

[1.2.2] - 2025-11-23

โš™๏ธ Miscellaneous Tasks

[1.2.1] - 2025-05-13

โš™๏ธ Miscellaneous Tasks

[1.2.0] - 2024-09-26

๐Ÿš€ Features

โš™๏ธ Miscellaneous Tasks

[1.1.1] - 2023-11-22

๐Ÿš€ Features

[1.1.0] - 2023-11-22

โš™๏ธ Miscellaneous Tasks

[0.6.0] - 2020-08-02