✨ Add reEnqueue() functionality to exposed API

[dodoarg]

Summary

Adds MongoDBQueue#reEnqueue(ack), which atomically resets a message's tries and ack and makes it immediately visible in a single findOneAndUpdate, without inserting a new document.

Note

Technically, ping(ack, { resetTries: true, resetAck: true, visibility: 0 }) should be functionally equivalent, however ping actually coalesces visibility: 0 to the original config value by || operator (unclear whether this was intentional or not); either way, the intent of ping isn't that of re-enqueuing a message, so I decided to expose a new option-free API whose purpose is explicit to consumers. The implementation details that are shared with ping have been refactored into a small helper.

Test notes

Because this is needed for step 3 of #1915 I installed these changes locally and verified the new exposed API works as intended against its first consumer.

[Copilot]

Pull request overview

Adds an explicit MongoDBQueue#reEnqueue(ack) API to atomically “put back” an in-flight message (resetting ack and tries and making it immediately visible) via a single findOneAndUpdate, primarily to support graceful-shutdown workflows without creating a new document.

Changes:

• Added MongoDBQueue#reEnqueue() and refactored shared ack/ping update logic into a new private updateByAck() helper.
• Added a dedicated re-enqueue test suite and updated test setup to clear the new collection.
• Documented .reEnqueue() in the README and bumped the package version to 8.3.0.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
test/setup.js	Adds the re-enqueue collection to the test cleanup list.
test/re-enqueue.js	Introduces tests validating reEnqueue() behavior and error cases.
README.md	Documents the new .reEnqueue() API and contrasts it with .ping().
package.json	Bumps version to 8.3.0.
mongodb-queue.ts	Implements reEnqueue() and refactors ack/ping through updateByAck().

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.