Option to reset tries in ping()

.eslintignore

@@ -0,0 +1,8 @@
+*.json
+*.sh
+*.yml
+*.md
+*.d.ts
+*.js.map
+*.js
+!test/*.js

.eslintrc.yml

@@ -0,0 +1,16 @@
+extends:
+  - 'plugin:@reedsy/recommended'
+parserOptions:
+  project: './tsconfig.json'
+env:
+  node: true
+rules:
+  # default exports have bad CJS/ESM interoperability
+  no-restricted-exports:
+    - error
+    - restrictDefaultExports:
+        direct: true
+        named: true
+        defaultFrom: true
+        namedFrom: true
+        namespaceFrom: true

.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches:
+    - main
+  pull_request:
+    branches:
+    - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        mongodb:
+        - '6.0'
+        mongo_driver:
+        - mongodb6
+    services:
+      mongodb:
+        image: mongo:${{ matrix.mongodb }}
+        ports:
+        - 27017:27017
+    timeout-minutes: 10
+    steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
+      with:
+        node-version: '20.x'
+        registry-url: 'https://npm.pkg.github.com'
+    - name: Install
+      # Skip post-install to avoid malicious scripts stealing PAT
+      run: npm install --ignore-script
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    - name: Post-install
+      run: npm rebuild && npm run prepare --if-present
+    - name: Lint
+      run: npm run lint
+    - name: Test
+      run: npm test
+      env:
+        MONGO_DRIVER: ${{ matrix.mongo_driver }}
+    - name: Release
+      if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
+      run: ./release.sh
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  # A silly job just so we can mark this as the required check for PRs
+  # instead of maintaining the full list of matrix jobs
+  success:
+    needs:
+    - build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+    - name: Success
+      run: echo "Success"

.gitignore

@@ -1,3 +1,8 @@
 node_modules/*
 *.log
 *~
+package-lock.json
+*.d.ts
+*.js.map
+*.js
+!test/*.js

.npmignore

@@ -0,0 +1,3 @@
+**/*
+!*.d.ts
+!*.js.map

.npmrc

@@ -0,0 +1 @@
+@reedsy:registry=https://npm.pkg.github.com

README.md

@@ -26,7 +26,7 @@ const client = new mongodb.MongoClient(url, { useNewUrlParser: true })
 
 client.connect(err => {
   const db = client.db('test')
-  const queue = mongoDbQueue(db, 'my-queue')
+  const queue = new MongoDbQueue(db, 'my-queue')
 
   // ...
 
@@ -102,9 +102,9 @@ passed in:
 var mongoDbQueue = require('mongodb-queue')
 
 // an instance of a queue
-var queue1 = mongoDbQueue(db, 'a-queue')
+var queue1 = new MongoDbQueue(db, 'a-queue')
 // another queue which uses the same collection as above
-var queue2 = mongoDbQueue(db, 'a-queue')
+var queue2 = new MongoDbQueue(db, 'a-queue')
 ```
 
 Using `queue1` and `queue2` here won't interfere with each other and will play along nicely, but that's not
@@ -116,7 +116,7 @@ it's not something you should do.
 To pass in options for the queue:
 
 ```
-var resizeQueue = mongoDbQueue(db, 'resize-queue', { visibility : 30, delay : 15 })
+var resizeQueue = new MongoDbQueue(db, 'resize-queue', { visibility : 30, delay : 15 })
 ```
 
 This example shows a queue with a message visibility of 30s and a delay to each message of 15s.
@@ -131,8 +131,8 @@ Each queue you create will be it's own collection.
 e.g.
 
 ```
-var resizeImageQueue = mongoDbQueue(db, 'resize-image-queue')
-var notifyOwnerQueue = mongoDbQueue(db, 'notify-owner-queue')
+var resizeImageQueue = new MongoDbQueue(db, 'resize-image-queue')
+var notifyOwnerQueue = new MongoDbQueue(db, 'notify-owner-queue')
 ```
 
 This will create two collections in MongoDB called `resize-image-queue` and `notify-owner-queue`.
@@ -149,7 +149,7 @@ You may set this visibility window on a per queue basis. For example, to set the
 visibility to 15 seconds:
 
 ```
-var queue = mongoDbQueue(db, 'queue', { visibility : 15 })
+var queue = new MongoDbQueue(db, 'queue', { visibility : 15 })
 ```
 
 All messages in this queue now have a visibility window of 15s, instead of the
@@ -167,7 +167,7 @@ retrieval 10s after being added.
 To delay all messages by 10 seconds, try this:
 
 ```
-var queue = mongoDbQueue(db, 'queue', { delay : 10 })
+var queue = new MongoDbQueue(db, 'queue', { delay : 10 })
 ```
 
 This is now the default for every message added to the queue.
@@ -182,8 +182,8 @@ automatically see problem messages.
 Pass in a queue (that you created) onto which these messages will be pushed:
 
 ```js
-var deadQueue = mongoDbQueue(db, 'dead-queue')
-var queue = mongoDbQueue(db, 'queue', { deadQueue : deadQueue })
+var deadQueue = new MongoDbQueue(db, 'dead-queue')
+var queue = new MongoDbQueue(db, 'queue', { deadQueue : deadQueue })
 ```
 
 If you pop a message off the `queue` over `maxRetries` times and still have not acked it,
@@ -237,6 +237,18 @@ msg = {
 Notice that the payload from the `deadQueue` is exactly the same as the original message
 when it was on the original queue (except with the number of tries set to 5).
 
+### returnDocument ###
+
+The `mongodb` Node.js driver [deprecated](https://github.com/mongodb/node-mongodb-native/pull/2808)
+use of `returnOriginal` in favor of `returnDocument` when using `findOneAndUpdate()`.
+
+If you want to opt in to using the newer `returnDocument`, set the `returnDocument` option
+to `true`:
+
+```
+var queue = new MongoDbQueue(db, 'queue', { returnDocument : true })
+```
+
 ## Operations ##
 
 ### .add() ###
@@ -345,6 +357,17 @@ queue.get((err, msg) => {
 })
 ```
 
+You can also reset the job tries, effectively creating an atomic ack + add for the
+same job using `resetTries`:
+
+```js
+queue.get((err, msg) => {
+    queue.ping(msg.ack, { resetTries: true }, (err, id) => {
+        // This message now has 0 tries
+    })
+})
+```
+
 ### .total() ###
 
 Returns the total number of messages that has ever been in the queue, including