Kikobeats / superlock / 39329861166

100%

push

github

fix: keep round-robin moving after a key leaves the ring (#26)

* fix: keep round-robin moving after a key leaves the ring

Recording a key that just left the ring made the next grant restart at the head and skip whoever was waiting behind it. Aborting the rest of that key had the same skip.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: describe the per-key fair lock

createFairLock shipped without a usage or API section, so the README only showed the FIFO withLock path.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor: call the per-key scheduler createFairQueue

Fair queuing is the established name for one FIFO queue per key served in round-robin. createFairLock stays as an alias because 1.4.0 already exported it.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: say fair queue where the README still said fair lock

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: cite fair queuing in the API section

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor: export the fair queue as withFairQueue

The usage section lists it beside mutex and semaphore, and the name matches withLock. createFairLock remains the 1.4.0 alias.

Co-authored-by: Cursor <cursoragent@cursor.com>

* feat: add createFairQueue beside withFairQueue

createFairQueue is the acquire/release primitive, the same role createLock has under withLock. withFairQueue runs a function and releases it.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: show a semaphore example next to the mutex one

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: reject a partial signal and keep the cursor for NaN

A value with only addEventListener was queued, then threw on removeEventListener after it had already left the queue. NaN never matched the cursor with ===, so aborting it restarted the ring at the head.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

85 of 85 branches covered (100.0%)

Branch coverage included in aggregate %.

54 of 54 new or added lines in 2 files covered. (100.0%)

243 of 243 relevant lines covered (100.0%)

3298.84 hits per line