feat(queue): add QueueManager fake helpers

Author: RomainLanz

.changelog/queue-fake.md

@@ -0,0 +1,30 @@
+# Queue testing improvements
+
+## New feature
+
+### QueueManager.fake / QueueManager.restore
+
+You can replace all adapters with the fake adapter for test assertions, then restore the original configuration.
+
+```typescript
+import { QueueManager } from '@boringnode/queue'
+import { redis } from '@boringnode/queue/drivers/redis_adapter'
+
+await QueueManager.init({
+  default: 'redis',
+  adapters: {
+    redis: redis({ host: 'localhost' }),
+  },
+})
+
+const fake = QueueManager.fake()
+
+await SendEmailJob.dispatch({ to: '[email protected]' })
+
+fake.assertPushed('SendEmailJob', {
+  queue: 'default',
+  payload: { to: '[email protected]' },
+})
+
+QueueManager.restore()
+```

README.md

@@ -215,6 +215,34 @@ The adapter automatically creates tables on first use.
 
 </details>
 
+### Fake (testing + assertions)
+
+```typescript
+import { QueueManager } from '@boringnode/queue'
+import { redis } from '@boringnode/queue/drivers/redis_adapter'
+
+await QueueManager.init({
+  default: 'redis',
+  adapters: {
+    redis: redis({ host: 'localhost' }),
+  },
+  locations: ['./app/jobs/**/*.ts'],
+})
+
+const adapter = QueueManager.fake()
+
+await SendEmailJob.dispatch({ to: '[email protected]' })
+
+adapter.assertPushed('SendEmailJob')
+adapter.assertPushed('SendEmailJob', {
+  queue: 'default',
+  payload: (payload) => payload.to === '[email protected]',
+})
+adapter.assertPushedCount(1)
+
+QueueManager.restore()
+```
+
 ### Sync (for testing)
 
 ```typescript