@boringnode/queue 0.3.4 → 0.4.1

package/README.md

@@ -123,12 +123,10 @@ Organize related jobs together for monitoring and filtering:
 
 ```typescript
 // Group newsletter jobs
-await SendEmailJob.dispatch({ to: 'user@example.com' })
-  .group('newsletter-jan-2025')
+await SendEmailJob.dispatch({ to: 'user@example.com' }).group('newsletter-jan-2025')
 
 // Group with bulk dispatch
-await SendEmailJob.dispatchMany(recipients)
-  .group('newsletter-jan-2025')
+await SendEmailJob.dispatchMany(recipients).group('newsletter-jan-2025')
 ```
 
 The `groupId` is stored with job data and accessible via `job.data.groupId`.
@@ -153,7 +151,7 @@ export default class ImportantJob extends Job<Payload> {
 <summary><strong>Retention options</strong></summary>
 
 | Value                       | Behavior           |
-|-----------------------------|--------------------|
+| --------------------------- | ------------------ |
 | `true` (default)            | Remove immediately |
 | `false`                     | Keep forever       |
 | `{ count: n }`              | Keep last n jobs   |
@@ -164,9 +162,9 @@ Query job history:
 
 ```typescript
 const job = await adapter.getJob('job-id', 'queue-name')
-console.log(job.status)      // 'completed' | 'failed'
-console.log(job.finishedAt)  // timestamp
-console.log(job.error)       // error message (if failed)
+console.log(job.status) // 'completed' | 'failed'
+console.log(job.finishedAt) // timestamp
+console.log(job.error) // error message (if failed)
 ```
 
 </details>
@@ -211,7 +209,50 @@ const adapter = knex(connection)
 const adapter = knex(config, 'custom_jobs_table')
 ```
 
-The adapter automatically creates tables on first use.
+</details>
+
+<details>
+<summary><strong>Database setup with QueueSchemaService</strong></summary>
+
+The Knex adapter requires tables to be created before use. Use `QueueSchemaService` to create them:
+
+```typescript
+import { QueueSchemaService } from '@boringnode/queue'
+import Knex from 'knex'
+
+const connection = Knex({ client: 'pg', connection: '...' })
+const schemaService = new QueueSchemaService(connection)
+
+// Create tables with default names
+await schemaService.createJobsTable()
+await schemaService.createSchedulesTable()
+
+// Or extend with custom columns
+await schemaService.createJobsTable('queue_jobs', (table) => {
+  table.string('tenant_id', 255).nullable()
+})
+```
+
+**AdonisJS migration example:**
+
+```typescript
+import { BaseSchema } from '@adonisjs/lucid/schema'
+import { QueueSchemaService } from '@boringnode/queue'
+
+export default class extends BaseSchema {
+  async up() {
+    const schemaService = new QueueSchemaService(this.db.connection().getWriteClient())
+    await schemaService.createJobsTable()
+    await schemaService.createSchedulesTable()
+  }
+
+  async down() {
+    const schemaService = new QueueSchemaService(this.db.connection().getWriteClient())
+    await schemaService.dropSchedulesTable()
+    await schemaService.dropJobsTable()
+  }
+}
+```
 
 </details>
 
@@ -256,13 +297,13 @@ const adapter = sync() // Jobs execute immediately
 ```typescript
 export default class MyJob extends Job<Payload> {
   static options: JobOptions = {
-    queue: 'email',       // Queue name (default: 'default')
-    priority: 1,          // Lower = higher priority (default: 5)
-    maxRetries: 3,        // Retry attempts before failing
-    timeout: '30s',       // Max execution time
-    failOnTimeout: true,  // Fail permanently on timeout (default: retry)
-    removeOnComplete: { count: 100 },  // Keep last 100 completed
-    removeOnFail: { age: '7d' },       // Keep failed for 7 days
+    queue: 'email', // Queue name (default: 'default')
+    priority: 1, // Lower = higher priority (default: 5)
+    maxRetries: 3, // Retry attempts before failing
+    timeout: '30s', // Max execution time
+    failOnTimeout: true, // Fail permanently on timeout (default: retry)
+    removeOnComplete: { count: 100 }, // Keep last 100 completed
+    removeOnFail: { age: '7d' }, // Keep failed for 7 days
   }
 }
 ```
@@ -270,10 +311,10 @@ export default class MyJob extends Job<Payload> {
 ## Delayed Jobs
 
 ```typescript
-await SendEmailJob.dispatch(payload).in('30s')  // 30 seconds
-await SendEmailJob.dispatch(payload).in('5m')   // 5 minutes
-await SendEmailJob.dispatch(payload).in('2h')   // 2 hours
-await SendEmailJob.dispatch(payload).in('1d')   // 1 day
+await SendEmailJob.dispatch(payload).in('30s') // 30 seconds
+await SendEmailJob.dispatch(payload).in('5m') // 5 minutes
+await SendEmailJob.dispatch(payload).in('2h') // 2 hours
+await SendEmailJob.dispatch(payload).in('1d') // 1 day
 ```
 
 ## Retry & Backoff
@@ -285,12 +326,13 @@ export default class ReliableJob extends Job<Payload> {
   static options: JobOptions = {
     maxRetries: 5,
     retry: {
-      backoff: () => exponentialBackoff({
-        baseDelay: '1s',
-        maxDelay: '1m',
-        multiplier: 2,
-        jitter: true,
-      }),
+      backoff: () =>
+        exponentialBackoff({
+          baseDelay: '1s',
+          maxDelay: '1m',
+          multiplier: 2,
+          jitter: true,
+        }),
     },
   }
 }
@@ -356,13 +398,12 @@ Run jobs on a recurring basis:
 
 ```typescript
 // Every 10 seconds
-await MetricsJob.schedule({ endpoint: '/health' })
-  .every('10s')
+await MetricsJob.schedule({ endpoint: '/health' }).every('10s')
 
 // Cron schedule
 await CleanupJob.schedule({ days: 30 })
   .id('daily-cleanup')
-  .cron('0 0 * * *')  // Midnight daily
+  .cron('0 0 * * *') // Midnight daily
   .timezone('Europe/Paris')
 ```
 
@@ -376,7 +417,7 @@ import { Schedule } from '@boringnode/queue'
 const schedule = await Schedule.find('daily-cleanup')
 await schedule.pause()
 await schedule.resume()
-await schedule.trigger()  // Run now
+await schedule.trigger() // Run now
 await schedule.delete()
 
 // List schedules
@@ -387,7 +428,7 @@ const active = await Schedule.list({ status: 'active' })
 **Schedule options:**
 
 | Method              | Description                       |
-|---------------------|-----------------------------------|
+| ------------------- | --------------------------------- |
 | `.id(string)`       | Unique identifier                 |
 | `.every(duration)`  | Fixed interval ('5s', '1m', '1h') |
 | `.cron(expression)` | Cron schedule                     |
@@ -437,13 +478,13 @@ export default class SendEmailJob extends Job<SendEmailPayload> {
 ```typescript
 const config = {
   worker: {
-    concurrency: 5,        // Parallel jobs
-    idleDelay: '2s',       // Poll interval when idle
-    timeout: '1m',         // Default job timeout
+    concurrency: 5, // Parallel jobs
+    idleDelay: '2s', // Poll interval when idle
+    timeout: '1m', // Default job timeout
     stalledThreshold: '30s', // When to consider job stalled
-    stalledInterval: '30s',  // How often to check
-    maxStalledCount: 1,      // Max recoveries before failing
-    gracefulShutdown: true,  // Wait for jobs on SIGTERM
+    stalledInterval: '30s', // How often to check
+    maxStalledCount: 1, // Max recoveries before failing
+    gracefulShutdown: true, // Wait for jobs on SIGTERM
   },
 }
 ```
@@ -464,7 +505,7 @@ await QueueManager.init({
 Performance comparison with BullMQ (5ms simulated work per job):
 
 | Jobs | Concurrency | @boringnode/queue | BullMQ | Diff        |
-|------|-------------|-------------------|--------|-------------|
+| ---- | ----------- | ----------------- | ------ | ----------- |
 | 1000 | 5           | 1096ms            | 1116ms | 1.8% faster |
 | 1000 | 10          | 565ms             | 579ms  | 2.4% faster |
 | 100K | 10          | 56.2s             | 57.5s  | 2.1% faster |

package/build/{chunk-H6WOFLPJ.js → chunk-6EBS7CW4.js}

@@ -7,7 +7,7 @@ import {
   E_JOB_NOT_FOUND,
   E_QUEUE_NOT_INITIALIZED,
   parse
-} from "./chunk-3BIR4IQD.js";
+} from "./chunk-ZZFSQY36.js";
 
 // src/drivers/fake_adapter.ts
 import assert from "assert/strict";
@@ -884,7 +884,7 @@ var ScheduleBuilder = class {
       limit: this.#limit
     };
     const adapter = QueueManager.use();
-    const scheduleId = await adapter.createSchedule(config);
+    const scheduleId = await adapter.upsertSchedule(config);
     const nextRunAt = this.#calculateNextRunAt();
     await adapter.updateSchedule(scheduleId, { nextRunAt });
     return { scheduleId };
@@ -1045,7 +1045,8 @@ var Job = class {
    * ```
    */
   static dispatch(payload) {
-    const options = this.options || {};
+    const jobClass = this;
+    const options = jobClass.options || {};
     const jobName = options.name || this.name;
     const dispatcher = new JobDispatcher(jobName, payload);
     if (options.queue) {
@@ -1087,7 +1088,8 @@ var Job = class {
    * ```
    */
   static dispatchMany(payloads) {
-    const options = this.options || {};
+    const jobClass = this;
+    const options = jobClass.options || {};
     const jobName = options.name || this.name;
     const dispatcher = new JobBatchDispatcher(jobName, payloads);
     if (options.queue) {
@@ -1127,7 +1129,8 @@ var Job = class {
    * ```
    */
   static schedule(payload) {
-    const options = this.options || {};
+    const jobClass = this;
+    const options = jobClass.options || {};
     const jobName = options.name || this.name;
     return new ScheduleBuilder(jobName, payload);
   }
@@ -1340,8 +1343,9 @@ var FakeAdapter = class {
     this.#pendingTimeouts.clear();
     return Promise.resolve();
   }
-  async createSchedule(config) {
+  async upsertSchedule(config) {
     const id = config.id ?? randomUUID3();
+    const existing = this.#schedules.get(id);
     const now = /* @__PURE__ */ new Date();
     const schedule = {
       id,
@@ -1353,16 +1357,22 @@ var FakeAdapter = class {
       from: config.from ?? null,
       to: config.to ?? null,
       limit: config.limit ?? null,
-      runCount: 0,
-      nextRunAt: null,
-      // Will be calculated by the caller
-      lastRunAt: null,
+      runCount: existing?.runCount ?? 0,
+      nextRunAt: existing?.nextRunAt ?? null,
+      // Will be (re)calculated by the caller
+      lastRunAt: existing?.lastRunAt ?? null,
       status: "active",
-      createdAt: now
+      createdAt: existing?.createdAt ?? now
     };
     this.#schedules.set(id, schedule);
     return id;
   }
+  /**
+   * @deprecated Use `upsertSchedule` instead.
+   */
+  createSchedule(config) {
+    return this.upsertSchedule(config);
+  }
   async getSchedule(id) {
     return this.#schedules.get(id) ?? null;
   }
@@ -1552,4 +1562,4 @@ export {
   ScheduleBuilder,
   Job
 };
-//# sourceMappingURL=chunk-H6WOFLPJ.js.map
+//# sourceMappingURL=chunk-6EBS7CW4.js.map

package/build/chunk-6EBS7CW4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/drivers/fake_adapter.ts","../src/debug.ts","../src/job_dispatcher.ts","../src/locator.ts","../src/logger.ts","../src/queue_manager.ts","../src/job_batch_dispatcher.ts","../src/schedule_builder.ts","../src/job.ts"],"sourcesContent":["import assert from 'node:assert/strict'\nimport { randomUUID } from 'node:crypto'\nimport { isDeepStrictEqual } from 'node:util'\nimport { CronExpressionParser } from 'cron-parser'\nimport type { Adapter, AcquiredJob } from '../contracts/adapter.js'\nimport type {\n  JobData,\n  JobClass,\n  JobRecord,\n  JobRetention,\n  ScheduleConfig,\n  ScheduleData,\n  ScheduleListOptions,\n} from '../types/main.js'\nimport { DEFAULT_PRIORITY } from '../constants.js'\nimport { parse } from '../utils.js'\nimport { Job } from '../job.js'\n\ninterface ActiveJob {\n  job: JobData\n  acquiredAt: number\n  queue: string\n}\n\ninterface DelayedJob {\n  job: JobData\n  executeAt: number\n  delay: number\n}\n\nexport interface FakeJobRecord {\n  queue: string\n  job: JobData\n  delay?: number\n  pushedAt: number\n}\n\nexport type FakeJobMatcher = string | JobClass | ((job: JobData) => boolean)\nexport type FakePayloadMatcher =\n  | ((payload: unknown) => boolean)\n  | object\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\nexport type FakeDelayMatcher = number | ((delay: number | undefined) => boolean)\n\nexport interface FakeJobQuery {\n  queue?: string\n  payload?: FakePayloadMatcher\n  delay?: FakeDelayMatcher\n}\n\n/**\n * Create a fake adapter factory.\n */\nexport function fake() {\n  return () => new FakeAdapter()\n}\n\n/**\n * In-memory adapter designed for tests with assertion helpers.\n */\nexport class FakeAdapter implements Adapter {\n  #queues = new Map<string, JobData[]>()\n  #activeJobs = new Map<string, ActiveJob>()\n  #delayedJobs = new Map<string, Map<string, DelayedJob>>()\n  #completedJobs = new Map<string, JobRecord[]>()\n  #failedJobs = new Map<string, JobRecord[]>()\n  #pendingTimeouts = new Set<NodeJS.Timeout>()\n  #schedules = new Map<string, ScheduleData>()\n  #pushedJobs: FakeJobRecord[] = []\n\n  setWorkerId(_workerId: string): void {}\n\n  getPushedJobs(): FakeJobRecord[] {\n    return [...this.#pushedJobs]\n  }\n\n  getPushedJobsOn(queue: string): FakeJobRecord[] {\n    return this.#pushedJobs.filter((record) => record.queue === queue)\n  }\n\n  findPushed(matcher: FakeJobMatcher, query?: FakeJobQuery): FakeJobRecord | undefined {\n    return this.#pushedJobs.find((record) => this.#matchesRecord(record, matcher, query))\n  }\n\n  clearPushedJobs(): void {\n    this.#pushedJobs = []\n  }\n\n  clear(): void {\n    for (const timeout of this.#pendingTimeouts) {\n      clearTimeout(timeout)\n    }\n\n    this.#pendingTimeouts.clear()\n    this.#queues.clear()\n    this.#activeJobs.clear()\n    this.#delayedJobs.clear()\n    this.#completedJobs.clear()\n    this.#failedJobs.clear()\n    this.#schedules.clear()\n    this.#pushedJobs = []\n  }\n\n  assertPushed(matcher: FakeJobMatcher, query?: FakeJobQuery): void {\n    const record = this.findPushed(matcher, query)\n    assert.ok(record, this.#formatFailure('Expected job to be pushed', matcher, query))\n  }\n\n  assertNotPushed(matcher: FakeJobMatcher, query?: FakeJobQuery): void {\n    const record = this.findPushed(matcher, query)\n    assert.ok(!record, this.#formatFailure('Expected job to not be pushed', matcher, query))\n  }\n\n  assertPushedCount(count: number, options?: { queue?: string }): void {\n    const actual = options?.queue\n      ? this.#pushedJobs.filter((record) => record.queue === options.queue).length\n      : this.#pushedJobs.length\n\n    const suffix = options?.queue ? ` on \"${options.queue}\"` : ''\n    assert.equal(actual, count, `Expected ${count} pushed job(s)${suffix}, got ${actual}`)\n  }\n\n  assertNothingPushed(): void {\n    assert.equal(\n      this.#pushedJobs.length,\n      0,\n      `Expected no jobs to be pushed, got ${this.#pushedJobs.length}`\n    )\n  }\n\n  async size(): Promise<number> {\n    return this.sizeOf('default')\n  }\n\n  async sizeOf(queue: string): Promise<number> {\n    const jobs = this.#queues.get(queue) || []\n\n    return jobs.length\n  }\n\n  async push(jobData: JobData): Promise<void> {\n    return this.pushOn('default', jobData)\n  }\n\n  async pushOn(queue: string, jobData: JobData): Promise<void> {\n    this.#recordPush(queue, jobData)\n    this.#enqueue(queue, jobData)\n  }\n\n  async pushLater(jobData: JobData, delay: number): Promise<void> {\n    return this.pushLaterOn('default', jobData, delay)\n  }\n\n  pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void> {\n    this.#recordPush(queue, jobData, delay)\n    this.#schedulePush(queue, jobData, delay)\n\n    return Promise.resolve()\n  }\n\n  async pushMany(jobs: JobData[]): Promise<void> {\n    return this.pushManyOn('default', jobs)\n  }\n\n  async pushManyOn(queue: string, jobs: JobData[]): Promise<void> {\n    for (const job of jobs) {\n      await this.pushOn(queue, job)\n    }\n  }\n\n  async pop(): Promise<AcquiredJob | null> {\n    return this.popFrom('default')\n  }\n\n  async popFrom(queue: string): Promise<AcquiredJob | null> {\n    const jobs = this.#queues.get(queue)\n\n    if (!jobs || jobs.length === 0) {\n      return null\n    }\n\n    // Find job with highest priority (lowest priority number)\n    let bestIndex = 0\n    let bestPriority = jobs[0].priority ?? DEFAULT_PRIORITY\n\n    for (let i = 1; i < jobs.length; i++) {\n      const priority = jobs[i].priority ?? DEFAULT_PRIORITY\n      if (priority < bestPriority) {\n        bestPriority = priority\n        bestIndex = i\n      }\n    }\n\n    const [job] = jobs.splice(bestIndex, 1)\n    if (!job) {\n      return null\n    }\n\n    const acquiredAt = Date.now()\n    this.#activeJobs.set(job.id, { job, acquiredAt, queue })\n\n    return { ...job, acquiredAt }\n  }\n\n  async completeJob(jobId: string, queue: string, removeOnComplete?: JobRetention): Promise<void> {\n    const active = this.#activeJobs.get(jobId)\n    if (!active) return\n\n    this.#activeJobs.delete(jobId)\n\n    if (removeOnComplete === undefined || removeOnComplete === true) {\n      return\n    }\n\n    this.#storeHistory(queue, 'completed', active.job, removeOnComplete)\n  }\n\n  async failJob(\n    jobId: string,\n    queue: string,\n    error?: Error,\n    removeOnFail?: JobRetention\n  ): Promise<void> {\n    const active = this.#activeJobs.get(jobId)\n    if (!active) return\n\n    this.#activeJobs.delete(jobId)\n\n    if (removeOnFail === undefined || removeOnFail === true) {\n      return\n    }\n\n    this.#storeHistory(queue, 'failed', active.job, removeOnFail, error)\n  }\n\n  async retryJob(jobId: string, queue: string, retryAt?: Date): Promise<void> {\n    const active = this.#activeJobs.get(jobId)\n    if (!active) return\n\n    this.#activeJobs.delete(jobId)\n\n    const updatedJob = {\n      ...active.job,\n      attempts: (active.job.attempts || 0) + 1,\n    }\n\n    if (retryAt) {\n      const delay = retryAt.getTime() - Date.now()\n\n      if (delay > 0) {\n        this.#schedulePush(queue, updatedJob, delay)\n        return\n      }\n    }\n\n    this.#enqueue(queue, updatedJob)\n  }\n\n  async recoverStalledJobs(\n    queue: string,\n    stalledThreshold: number,\n    maxStalledCount: number\n  ): Promise<number> {\n    const now = Date.now()\n    let recovered = 0\n\n    for (const [jobId, active] of this.#activeJobs.entries()) {\n      if (active.queue !== queue) {\n        continue\n      }\n\n      const isStalled = now - active.acquiredAt > stalledThreshold\n\n      if (!isStalled) {\n        continue\n      }\n\n      const currentStalledCount = active.job.stalledCount ?? 0\n\n      // Check if job has exceeded max stalled count\n      if (currentStalledCount >= maxStalledCount) {\n        // Fail permanently - just remove from active\n        this.#activeJobs.delete(jobId)\n        continue\n      }\n\n      // Recover the job - put back in queue with incremented stalledCount\n      this.#activeJobs.delete(jobId)\n\n      const updatedJob = {\n        ...active.job,\n        stalledCount: currentStalledCount + 1,\n      }\n\n      this.#enqueue(active.queue, updatedJob)\n      recovered++\n    }\n\n    return recovered\n  }\n\n  async getJob(jobId: string, queue: string): Promise<JobRecord | null> {\n    const active = this.#activeJobs.get(jobId)\n    if (active && active.queue === queue) {\n      return { status: 'active', data: active.job }\n    }\n\n    const pendingJobs = this.#queues.get(queue)\n    const pending = pendingJobs?.find((job) => job.id === jobId)\n    if (pending) {\n      return { status: 'pending', data: pending }\n    }\n\n    const delayed = this.#delayedJobs.get(queue)?.get(jobId)\n    if (delayed) {\n      return { status: 'delayed', data: delayed.job }\n    }\n\n    const completed = this.#findHistory(this.#completedJobs, queue, jobId)\n    if (completed) {\n      return completed\n    }\n\n    const failed = this.#findHistory(this.#failedJobs, queue, jobId)\n    if (failed) {\n      return failed\n    }\n\n    return null\n  }\n\n  destroy(): Promise<void> {\n    for (const timeout of this.#pendingTimeouts) {\n      clearTimeout(timeout)\n    }\n\n    this.#pendingTimeouts.clear()\n\n    return Promise.resolve()\n  }\n\n  async upsertSchedule(config: ScheduleConfig): Promise<string> {\n    const id = config.id ?? randomUUID()\n    const existing = this.#schedules.get(id)\n    const now = new Date()\n\n    const schedule: ScheduleData = {\n      id,\n      name: config.name,\n      payload: config.payload,\n      cronExpression: config.cronExpression ?? null,\n      everyMs: config.everyMs ?? null,\n      timezone: config.timezone,\n      from: config.from ?? null,\n      to: config.to ?? null,\n      limit: config.limit ?? null,\n      runCount: existing?.runCount ?? 0,\n      nextRunAt: existing?.nextRunAt ?? null, // Will be (re)calculated by the caller\n      lastRunAt: existing?.lastRunAt ?? null,\n      status: 'active',\n      createdAt: existing?.createdAt ?? now,\n    }\n\n    this.#schedules.set(id, schedule)\n    return id\n  }\n\n  /**\n   * @deprecated Use `upsertSchedule` instead.\n   */\n  createSchedule(config: ScheduleConfig): Promise<string> {\n    return this.upsertSchedule(config)\n  }\n\n  async getSchedule(id: string): Promise<ScheduleData | null> {\n    return this.#schedules.get(id) ?? null\n  }\n\n  async listSchedules(options?: ScheduleListOptions): Promise<ScheduleData[]> {\n    const schedules = Array.from(this.#schedules.values())\n\n    if (options?.status) {\n      return schedules.filter((s) => s.status === options.status)\n    }\n\n    return schedules\n  }\n\n  async updateSchedule(\n    id: string,\n    updates: Partial<Pick<ScheduleData, 'status' | 'nextRunAt' | 'lastRunAt' | 'runCount'>>\n  ): Promise<void> {\n    const schedule = this.#schedules.get(id)\n    if (!schedule) return\n\n    if (updates.status !== undefined) schedule.status = updates.status\n    if (updates.nextRunAt !== undefined) schedule.nextRunAt = updates.nextRunAt\n    if (updates.lastRunAt !== undefined) schedule.lastRunAt = updates.lastRunAt\n    if (updates.runCount !== undefined) schedule.runCount = updates.runCount\n  }\n\n  async deleteSchedule(id: string): Promise<void> {\n    this.#schedules.delete(id)\n  }\n\n  async claimDueSchedule(): Promise<ScheduleData | null> {\n    const now = new Date()\n\n    // Find first due schedule\n    const schedule = Array.from(this.#schedules.values()).find((s) => {\n      if (s.status !== 'active') return false\n      if (s.nextRunAt === null || s.nextRunAt > now) return false\n      if (s.limit !== null && s.runCount >= s.limit) return false\n      if (s.to !== null && now > s.to) return false\n      return true\n    })\n\n    if (!schedule) return null\n\n    // Calculate next run\n    let nextRunAt: Date | null = null\n    if (schedule.everyMs) {\n      nextRunAt = new Date(now.getTime() + schedule.everyMs)\n    } else if (schedule.cronExpression) {\n      const cron = CronExpressionParser.parse(schedule.cronExpression, {\n        currentDate: now,\n        tz: schedule.timezone || 'UTC',\n      })\n      nextRunAt = cron.next().toDate()\n    }\n\n    // Check if limit will be reached after this run\n    const newRunCount = schedule.runCount + 1\n    if (schedule.limit !== null && newRunCount >= schedule.limit) {\n      nextRunAt = null // No more runs\n    }\n\n    // Check if end date will be passed\n    if (nextRunAt && schedule.to !== null && nextRunAt > schedule.to) {\n      nextRunAt = null // Past end date\n    }\n\n    // Clone schedule data before updating (return old state)\n    const claimedSchedule: ScheduleData = { ...schedule }\n\n    // Update schedule atomically\n    schedule.nextRunAt = nextRunAt\n    schedule.lastRunAt = now\n    schedule.runCount = newRunCount\n\n    return claimedSchedule\n  }\n\n  #recordPush(queue: string, jobData: JobData, delay?: number) {\n    this.#pushedJobs.push({\n      queue,\n      job: jobData,\n      delay,\n      pushedAt: Date.now(),\n    })\n  }\n\n  #enqueue(queue: string, jobData: JobData) {\n    if (!this.#queues.has(queue)) {\n      this.#queues.set(queue, [])\n    }\n\n    this.#queues.get(queue)!.push(jobData)\n  }\n\n  #schedulePush(queue: string, jobData: JobData, delay: number) {\n    if (!this.#delayedJobs.has(queue)) {\n      this.#delayedJobs.set(queue, new Map())\n    }\n\n    const executeAt = Date.now() + delay\n    this.#delayedJobs.get(queue)!.set(jobData.id, { job: jobData, executeAt, delay })\n\n    const timeout = setTimeout(() => {\n      this.#pendingTimeouts.delete(timeout)\n      this.#delayedJobs.get(queue)?.delete(jobData.id)\n      this.#enqueue(queue, jobData)\n    }, delay)\n\n    this.#pendingTimeouts.add(timeout)\n  }\n\n  #storeHistory(\n    queue: string,\n    status: 'completed' | 'failed',\n    job: JobData,\n    retention: JobRetention,\n    error?: Error\n  ) {\n    const record: JobRecord = {\n      status,\n      data: job,\n      finishedAt: Date.now(),\n      error: error?.message,\n    }\n\n    const store = status === 'completed' ? this.#completedJobs : this.#failedJobs\n\n    if (!store.has(queue)) {\n      store.set(queue, [])\n    }\n\n    const records = store.get(queue)!\n    records.push(record)\n\n    if (retention && retention !== true) {\n      this.#applyRetention(records, retention)\n    }\n  }\n\n  #applyRetention(records: JobRecord[], retention: JobRetention) {\n    if (retention === false || retention === true) {\n      return\n    }\n\n    if (retention.age !== undefined) {\n      const maxAgeMs = parse(retention.age)\n      if (maxAgeMs > 0) {\n        const cutoff = Date.now() - maxAgeMs\n        const filtered = records.filter((record) => (record.finishedAt ?? 0) >= cutoff)\n        records.splice(0, records.length, ...filtered)\n      }\n    }\n\n    if (retention.count !== undefined && retention.count > 0 && records.length > retention.count) {\n      records.splice(0, records.length - retention.count)\n    }\n  }\n\n  #findHistory(store: Map<string, JobRecord[]>, queue: string, jobId: string): JobRecord | null {\n    const records = store.get(queue)\n    if (!records) return null\n\n    return records.find((record) => record.data.id === jobId) ?? null\n  }\n\n  #matchesRecord(record: FakeJobRecord, matcher: FakeJobMatcher, query?: FakeJobQuery): boolean {\n    if (query?.queue && record.queue !== query.queue) {\n      return false\n    }\n\n    const matchesJob =\n      typeof matcher === 'string'\n        ? record.job.name === matcher\n        : this.#isJobClass(matcher)\n          ? record.job.name === this.#getJobClassName(matcher)\n          : matcher(record.job)\n\n    if (!matchesJob) {\n      return false\n    }\n\n    if (query?.payload !== undefined) {\n      const payloadMatcher = query.payload\n      const matchesPayload =\n        typeof payloadMatcher === 'function'\n          ? payloadMatcher(record.job.payload)\n          : isDeepStrictEqual(record.job.payload, payloadMatcher)\n\n      if (!matchesPayload) {\n        return false\n      }\n    }\n\n    if (query?.delay !== undefined) {\n      const delayMatcher = query.delay\n      const matchesDelay =\n        typeof delayMatcher === 'function'\n          ? delayMatcher(record.delay)\n          : record.delay === delayMatcher\n\n      if (!matchesDelay) {\n        return false\n      }\n    }\n\n    return true\n  }\n\n  #formatFailure(prefix: string, matcher: FakeJobMatcher, query?: FakeJobQuery): string {\n    const parts = [prefix]\n\n    const matcherName = this.#getMatcherName(matcher)\n    if (matcherName) {\n      parts.push(`for \"${matcherName}\"`)\n    }\n\n    if (query?.queue) {\n      parts.push(`on \"${query.queue}\"`)\n    }\n\n    if (query?.payload !== undefined) {\n      parts.push('with matching payload')\n    }\n\n    if (query?.delay !== undefined) {\n      parts.push('with matching delay')\n    }\n\n    const suffix = this.#pushedJobs.length\n      ? `Pushed jobs: ${this.#pushedJobs.map((record) => record.job.name).join(', ')}`\n      : 'Pushed jobs: none'\n\n    return `${parts.join(' ')}. ${suffix}.`\n  }\n\n  #getMatcherName(matcher: FakeJobMatcher): string | undefined {\n    if (typeof matcher === 'string') {\n      return matcher\n    }\n\n    if (this.#isJobClass(matcher)) {\n      return this.#getJobClassName(matcher)\n    }\n\n    return undefined\n  }\n\n  #isJobClass(matcher: FakeJobMatcher): matcher is JobClass {\n    return typeof matcher === 'function' && matcher.prototype instanceof Job\n  }\n\n  #getJobClassName(JobClass: JobClass): string {\n    return JobClass.options?.name || JobClass.name\n  }\n}\n","import { debuglog } from 'node:util'\n\nexport default debuglog('boringnode:queue')\n","import debug from './debug.js'\nimport { randomUUID } from 'node:crypto'\nimport { QueueManager } from './queue_manager.js'\nimport type { Adapter } from './contracts/adapter.js'\nimport type { DispatchResult, Duration } from './types/main.js'\nimport { parse } from './utils.js'\n\n/**\n * Fluent builder for dispatching jobs to the queue.\n *\n * Provides a chainable API for configuring job options before dispatch.\n * Usually created via `Job.dispatch()` rather than directly.\n *\n * ```\n * Job.dispatch(payload)\n *     .toQueue('emails')     // optional: target queue\n *     .priority(1)           // optional: 1-10, lower = higher priority\n *     .in('5m')              // optional: delay before processing\n *     .with('redis')         // optional: specific adapter\n *     .run()                 // dispatch the job\n * ```\n *\n * @typeParam T - The payload type for this job\n *\n * @example\n * ```typescript\n * // Simple dispatch (auto-runs via thenable)\n * await SendEmailJob.dispatch({ to: 'user@example.com', subject: 'Hello' })\n *\n * // With options\n * const jobId = await SendEmailJob.dispatch({ to: 'user@example.com' })\n *   .toQueue('high-priority')\n *   .priority(1)\n *   .run()\n *\n * // Delayed job\n * await ReminderJob.dispatch({ userId: 123 }).in('24h')\n * ```\n */\nexport class JobDispatcher<T> {\n  readonly #name: string\n  readonly #payload: T\n  #queue: string = 'default'\n  #adapter?: string | (() => Adapter)\n  #delay?: Duration\n  #priority?: number\n  #groupId?: string\n\n  /**\n   * Create a new job dispatcher.\n   *\n   * @param name - The job class name (used to locate the class at runtime)\n   * @param payload - The data to pass to the job\n   */\n  constructor(name: string, payload: T) {\n    this.#name = name\n    this.#payload = payload\n  }\n\n  /**\n   * Set the target queue for this job.\n   *\n   * @param queue - Queue name (default: 'default')\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * await SendEmailJob.dispatch(payload).toQueue('emails')\n   * ```\n   */\n  toQueue(queue: string): this {\n    this.#queue = queue\n\n    return this\n  }\n\n  /**\n   * Delay the job execution.\n   *\n   * The job will be stored in a delayed state and moved to pending\n   * after the delay expires.\n   *\n   * @param delay - Delay as milliseconds or duration string ('5s', '1h', '7d')\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * // Send reminder in 24 hours\n   * await ReminderJob.dispatch(payload).in('24h')\n   *\n   * // Process in 5 minutes\n   * await CleanupJob.dispatch(payload).in('5m')\n   * ```\n   */\n  in(delay: Duration): this {\n    this.#delay = delay\n\n    return this\n  }\n\n  /**\n   * Set the job priority.\n   *\n   * Lower numbers = higher priority. Jobs with lower priority values\n   * are processed before jobs with higher values.\n   *\n   * @param priority - Priority level (1-10, default: 5)\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * // High priority job\n   * await UrgentJob.dispatch(payload).priority(1)\n   *\n   * // Low priority job\n   * await BackgroundJob.dispatch(payload).priority(10)\n   * ```\n   */\n  priority(priority: number): this {\n    this.#priority = priority\n\n    return this\n  }\n\n  /**\n   * Assign this job to a group.\n   *\n   * Jobs with the same groupId can be filtered and displayed together\n   * in monitoring UIs. Useful for batch operations like newsletters\n   * or bulk exports.\n   *\n   * @param groupId - Group identifier\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * // Group newsletter jobs together\n   * await SendEmailJob.dispatch({ to: 'user@example.com' })\n   *   .group('newsletter-jan-2025')\n   *   .run()\n   * ```\n   */\n  group(groupId: string): this {\n    this.#groupId = groupId\n\n    return this\n  }\n\n  /**\n   * Use a specific adapter for this job.\n   *\n   * @param adapter - Adapter name or factory function\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * // Use named adapter\n   * await Job.dispatch(payload).with('redis')\n   *\n   * // Use custom adapter instance\n   * await Job.dispatch(payload).with(() => new CustomAdapter())\n   * ```\n   */\n  with(adapter: string | (() => Adapter)) {\n    this.#adapter = adapter\n\n    return this\n  }\n\n  /**\n   * Dispatch the job to the queue.\n   *\n   * @returns A DispatchResult containing the jobId\n   *\n   * @example\n   * ```typescript\n   * const { jobId } = await SendEmailJob.dispatch(payload).run()\n   * console.log(`Dispatched job: ${jobId}`)\n   * ```\n   */\n  async run(): Promise<DispatchResult> {\n    const id = randomUUID()\n\n    debug('dispatching job %s with id %s using payload %s', this.#name, id, this.#payload)\n\n    const adapter = this.#getAdapterInstance()\n\n    const payload = {\n      id,\n      name: this.#name,\n      payload: this.#payload,\n      attempts: 0,\n      priority: this.#priority,\n      groupId: this.#groupId,\n    }\n\n    if (this.#delay) {\n      const parsedDelay = parse(this.#delay)\n\n      await adapter.pushLaterOn(this.#queue, payload, parsedDelay)\n    } else {\n      await adapter.pushOn(this.#queue, payload)\n    }\n\n    return {\n      jobId: id,\n    }\n  }\n\n  /**\n   * Thenable implementation for auto-dispatch when awaited.\n   *\n   * Allows `await Job.dispatch(payload)` without explicit `.run()`.\n   *\n   * @param onFulfilled - Success callback\n   * @param onRejected - Error callback\n   * @returns Promise resolving to the DispatchResult\n   */\n  then<TResult1 = DispatchResult, TResult2 = never>(\n    onFulfilled?: ((value: DispatchResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onRejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return this.run().then(onFulfilled, onRejected)\n  }\n\n  #getAdapterInstance(): Adapter {\n    if (!this.#adapter) {\n      return QueueManager.use()\n    }\n\n    if (typeof this.#adapter === 'string') {\n      return QueueManager.use(this.#adapter)\n    }\n\n    return this.#adapter()\n  }\n}\n","import { Job } from './job.js'\nimport * as errors from './exceptions.js'\nimport type { JobClass } from './types/main.js'\nimport debug from './debug.js'\nimport { glob } from 'node:fs/promises'\nimport { resolve } from 'node:path'\n\n/**\n * Job class registry.\n *\n * The Locator maintains a mapping of job names to their classes,\n * allowing the Worker to instantiate jobs by name when processing.\n *\n * Jobs are typically registered automatically via `QueueManager.init()`\n * using the `locations` config option, but can also be registered manually.\n *\n * @example\n * ```typescript\n * import { Locator } from '@boringnode/queue'\n * import SendEmailJob from './jobs/send_email_job.js'\n *\n * // Manual registration\n * Locator.register('SendEmailJob', SendEmailJob)\n *\n * // Auto-registration via glob (used by QueueManager.init)\n * await Locator.registerFromGlob(['./jobs/**\\/*.js'])\n *\n * // Retrieve a job class\n * const JobClass = Locator.getOrThrow('SendEmailJob')\n * ```\n */\nclass LocatorSingleton {\n  #registry = new Map<string, JobClass>()\n\n  /**\n   * Register a job class with a given name.\n   *\n   * @param name - The job name (usually the class name)\n   * @param JobClass - The job class constructor\n   *\n   * @example\n   * ```typescript\n   * Locator.register('SendEmailJob', SendEmailJob)\n   * ```\n   */\n  register<T extends Job>(name: string, JobClass: JobClass<T>) {\n    debug('registering job: %s', name)\n\n    this.#registry.set(name, JobClass)\n  }\n\n  /**\n   * Auto-register job classes from files matching glob patterns.\n   *\n   * Each file should have a default export that is a Job class.\n   * The class name is used as the registration name.\n   *\n   * @param patterns - Glob patterns to match job files\n   * @returns Number of jobs successfully registered\n   *\n   * @example\n   * ```typescript\n   * const count = await Locator.registerFromGlob([\n   *   './jobs/**\\/*.js',\n   *   './app/jobs/**\\/*.ts'\n   * ])\n   * console.log(`Registered ${count} jobs`)\n   * ```\n   */\n  async registerFromGlob(patterns: string[]): Promise<number> {\n    let registered = 0\n\n    for (const pattern of patterns) {\n      debug('registering jobs from glob pattern: %s', pattern)\n      for await (const file of glob(pattern)) {\n        debug('found job file: %s', file)\n\n        try {\n          const absolutePath = resolve(file)\n          const module = await import(`file://${absolutePath}`)\n          const JobClass = module.default as JobClass\n\n          if (JobClass && typeof JobClass === 'function') {\n            const jobName = JobClass.options?.name || JobClass.name\n            this.register(jobName, JobClass)\n            registered++\n          }\n        } catch (error) {\n          console.warn(`Failed to load job from ${file}:`, error)\n        }\n      }\n    }\n\n    return registered\n  }\n\n  /**\n   * Get a job class by name.\n   *\n   * @param name - The job name to look up\n   * @returns The job class, or undefined if not found\n   *\n   * @example\n   * ```typescript\n   * const JobClass = Locator.get('SendEmailJob')\n   * if (JobClass) {\n   *   const instance = new JobClass(payload)\n   * }\n   * ```\n   */\n  get<T extends Job = Job>(name: string): JobClass<T> | undefined {\n    return this.#registry.get(name) as JobClass<T> | undefined\n  }\n\n  /**\n   * Get a job class by name, throwing if not found.\n   *\n   * @param name - The job name to look up\n   * @returns The job class\n   * @throws {E_JOB_NOT_FOUND} If the job is not registered\n   *\n   * @example\n   * ```typescript\n   * const JobClass = Locator.getOrThrow('SendEmailJob')\n   * const instance = new JobClass(payload)\n   * ```\n   */\n  getOrThrow<T extends Job = Job>(name: string): JobClass<T> {\n    const JobClass = this.get<T>(name)\n\n    if (!JobClass) {\n      throw new errors.E_JOB_NOT_FOUND([name])\n    }\n\n    return JobClass\n  }\n\n  /**\n   * Remove all registered jobs.\n   *\n   * Primarily useful for testing.\n   */\n  clear(): void {\n    this.#registry.clear()\n  }\n}\n\n/** Global job class registry singleton */\nexport const Locator = new LocatorSingleton()\n","export interface LogObject {\n  [key: string]: unknown\n}\n\nexport interface ErrorObject extends LogObject {\n  err?: Error\n}\n\nexport interface Logger {\n  trace(msg: string): void\n  trace(obj: LogObject, msg: string): void\n\n  debug(msg: string): void\n  debug(obj: LogObject, msg: string): void\n\n  info(msg: string): void\n  info(obj: LogObject, msg: string): void\n\n  warn(msg: string): void\n  warn(obj: LogObject, msg: string): void\n\n  error(msg: string): void\n  error(obj: ErrorObject, msg: string): void\n\n  child(obj: LogObject): Logger\n}\n\n/**\n * A simple logger that writes to console.\n */\nclass ConsoleLogger implements Logger {\n  #prefix: string\n\n  constructor(prefix: string = 'queue') {\n    this.#prefix = prefix\n  }\n\n  #format(level: string, msgOrObj: string | LogObject, msg?: string): [string, LogObject?] {\n    const prefix = `[${this.#prefix}] ${level}:`\n\n    if (typeof msgOrObj === 'object') {\n      return [`${prefix} ${msg}`, msgOrObj]\n    }\n\n    return [`${prefix} ${msgOrObj}`]\n  }\n\n  trace(msg: string): void\n  trace(obj: LogObject, msg: string): void\n  trace(msgOrObj: string | LogObject, msg?: string): void {\n    const [message, obj] = this.#format('TRACE', msgOrObj, msg)\n\n    if (obj) {\n      return console.log(message, obj)\n    }\n\n    console.log(message)\n  }\n\n  debug(msg: string): void\n  debug(obj: LogObject, msg: string): void\n  debug(msgOrObj: string | LogObject, msg?: string): void {\n    const [message, obj] = this.#format('DEBUG', msgOrObj, msg)\n\n    if (obj) {\n      return console.log(message, obj)\n    }\n\n    console.log(message)\n  }\n\n  info(msg: string): void\n  info(obj: LogObject, msg: string): void\n  info(msgOrObj: string | LogObject, msg?: string): void {\n    const [message, obj] = this.#format('INFO', msgOrObj, msg)\n\n    if (obj) {\n      return console.log(message, obj)\n    }\n\n    console.log(message)\n  }\n\n  warn(msg: string): void\n  warn(obj: LogObject, msg: string): void\n  warn(msgOrObj: string | LogObject, msg?: string): void {\n    const [message, obj] = this.#format('WARN', msgOrObj, msg)\n\n    if (obj) {\n      return console.warn(message, obj)\n    }\n\n    console.warn(message)\n  }\n\n  error(msg: string): void\n  error(obj: ErrorObject, msg: string): void\n  error(msgOrObj: string | ErrorObject, msg?: string): void {\n    const [message, obj] = this.#format('ERROR', msgOrObj, msg)\n\n    if (obj) {\n      return console.error(message, obj)\n    }\n\n    console.error(message)\n  }\n\n  child(obj: LogObject): Logger {\n    const childPrefix = obj.pkg ? String(obj.pkg) : this.#prefix\n    return new ConsoleLogger(childPrefix)\n  }\n}\n\nexport const consoleLogger = new ConsoleLogger()\n","import * as errors from './exceptions.js'\nimport debug from './debug.js'\nimport { Locator } from './locator.js'\nimport { consoleLogger, type Logger } from './logger.js'\nimport { FakeAdapter } from './drivers/fake_adapter.js'\nimport type { Adapter } from './contracts/adapter.js'\nimport type {\n  AdapterFactory,\n  JobFactory,\n  JobOptions,\n  QueueConfig,\n  QueueManagerConfig,\n  RetryConfig,\n} from './types/main.js'\n\ntype QueueManagerFakeState = {\n  defaultAdapter: string\n  adapters: Record<string, AdapterFactory>\n  adapterInstances: Map<string, Adapter>\n  globalRetryConfig?: RetryConfig\n  globalJobOptions?: JobOptions\n  queueConfigs: Map<string, QueueConfig>\n  logger: Logger\n  jobFactory?: JobFactory\n  fakeAdapter: FakeAdapter\n}\n\n/**\n * Central configuration and adapter management for the queue system.\n *\n * The QueueManager is responsible for:\n * - Initializing adapters and job registration\n * - Providing adapter instances to workers and dispatchers\n * - Managing retry configuration across global, queue, and job levels\n *\n * @example\n * ```typescript\n * import { QueueManager, redis } from '@boringnode/queue'\n *\n * await QueueManager.init({\n *   default: 'redis',\n *   adapters: {\n *     redis: redis({ host: 'localhost' }),\n *   },\n *   locations: ['./jobs/**\\/*.js'],\n *   retry: {\n *     maxRetries: 3,\n *     backoff: exponentialBackoff(),\n *   },\n * })\n *\n * // Get the default adapter\n * const adapter = QueueManager.use()\n *\n * // Clean up when done\n * await QueueManager.destroy()\n * ```\n */\nclass QueueManagerSingleton {\n  #initialized = false\n  #defaultAdapter!: string\n  #adapters: Record<string, AdapterFactory> = {}\n  #adapterInstances: Map<string, Adapter> = new Map()\n  #globalRetryConfig?: RetryConfig\n  #globalJobOptions?: JobOptions\n  #queueConfigs: Map<string, QueueConfig> = new Map()\n  #logger: Logger = consoleLogger\n  #jobFactory?: JobFactory\n  #fakeState?: QueueManagerFakeState\n\n  /**\n   * Initialize the queue system with the given configuration.\n   *\n   * This must be called before using the queue system. It:\n   * - Validates the configuration\n   * - Registers adapters\n   * - Auto-discovers and registers job classes from `locations`\n   *\n   * @param config - The queue configuration\n   * @returns This instance for chaining\n   * @throws {E_CONFIGURATION_ERROR} If the configuration is invalid\n   *\n   * @example\n   * ```typescript\n   * await QueueManager.init({\n   *   default: 'redis',\n   *   adapters: {\n   *     redis: redis(),\n   *     postgres: knex(pgConfig),\n   *   },\n   *   locations: ['./jobs/**\\/*.js'],\n   * })\n   * ```\n   */\n  async init(config: QueueManagerConfig) {\n    debug('initializing queue manager with config: %O', config)\n\n    this.#validateConfig(config)\n\n    this.#adapterInstances.clear()\n\n    this.#defaultAdapter = config.default\n    this.#adapters = config.adapters\n    this.#globalRetryConfig = config.retry\n    this.#globalJobOptions = config.defaultJobOptions\n    this.#logger = config.logger ?? consoleLogger\n    this.#jobFactory = config.jobFactory\n\n    if (config.queues) {\n      for (const [queue, queueConfig] of Object.entries(config.queues)) {\n        this.#queueConfigs.set(queue, queueConfig as QueueConfig)\n      }\n    }\n\n    if (config.locations && config.locations.length > 0) {\n      const registered = await Locator.registerFromGlob(config.locations)\n\n      if (registered === 0) {\n        this.#logger.warn(\n          `No jobs found for locations: ${config.locations.join(', ')}. ` +\n            'Verify your glob patterns match your job files.'\n        )\n      }\n    }\n\n    this.#initialized = true\n\n    return this\n  }\n\n  /**\n   * Get an adapter instance by name.\n   *\n   * Adapter instances are cached and reused. If no name is provided,\n   * the default adapter is returned.\n   *\n   * @param adapter - Adapter name (optional, defaults to the default adapter)\n   * @returns The adapter instance\n   * @throws {E_QUEUE_NOT_INITIALIZED} If `init()` hasn't been called\n   * @throws {E_CONFIGURATION_ERROR} If the adapter is not registered\n   * @throws {E_ADAPTER_INIT_ERROR} If the adapter factory throws\n   *\n   * @example\n   * ```typescript\n   * // Get default adapter\n   * const adapter = QueueManager.use()\n   *\n   * // Get specific adapter\n   * const redisAdapter = QueueManager.use('redis')\n   * ```\n   */\n  use(adapter?: string): Adapter {\n    if (!this.#initialized) {\n      throw new errors.E_QUEUE_NOT_INITIALIZED()\n    }\n\n    if (!adapter) {\n      adapter = this.#defaultAdapter\n    }\n\n    // Return cached instance if exists\n    const cached = this.#adapterInstances.get(adapter)\n    if (cached) {\n      return cached\n    }\n\n    const adapterFactory = this.#adapters[adapter]\n\n    if (!adapterFactory) {\n      throw new errors.E_CONFIGURATION_ERROR([`Adapter \"${adapter}\" is not registered`])\n    }\n\n    debug('using adapter \"%s\"', adapter)\n\n    try {\n      const instance = adapterFactory()\n      this.#adapterInstances.set(adapter, instance)\n      return instance\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      throw new errors.E_ADAPTER_INIT_ERROR([adapter, message], { cause: error })\n    }\n  }\n\n  /**\n   * Replace all adapters with a fake adapter for testing.\n   *\n   * The fake adapter records pushed jobs and exposes assertion helpers.\n   * Call `restore()` to return to the previous configuration.\n   *\n   * @returns The fake adapter instance for assertions\n   * @throws {E_QUEUE_NOT_INITIALIZED} If `init()` hasn't been called\n   *\n   * @example\n   * ```typescript\n   * const fake = QueueManager.fake()\n   *\n   * await SendEmailJob.dispatch({ to: 'user@example.com' })\n   *\n   * fake.assertPushed(SendEmailJob)\n   * QueueManager.restore()\n   * ```\n   */\n  fake(): FakeAdapter {\n    if (!this.#initialized) {\n      throw new errors.E_QUEUE_NOT_INITIALIZED()\n    }\n\n    if (this.#fakeState) {\n      return this.#fakeState.fakeAdapter\n    }\n\n    const fakeAdapter = new FakeAdapter()\n\n    this.#fakeState = {\n      defaultAdapter: this.#defaultAdapter,\n      adapters: this.#adapters,\n      adapterInstances: this.#adapterInstances,\n      globalRetryConfig: this.#globalRetryConfig,\n      globalJobOptions: this.#globalJobOptions,\n      queueConfigs: this.#queueConfigs,\n      logger: this.#logger,\n      jobFactory: this.#jobFactory,\n      fakeAdapter,\n    }\n\n    const fakeFactory = () => fakeAdapter\n    const nextAdapters: Record<string, AdapterFactory> = {}\n\n    for (const name of Object.keys(this.#fakeState.adapters)) {\n      nextAdapters[name] = fakeFactory\n    }\n\n    this.#adapters = nextAdapters\n    this.#adapterInstances = new Map()\n\n    return fakeAdapter\n  }\n\n  /**\n   * Restore adapters after calling `fake()`.\n   */\n  restore(): void {\n    if (!this.#fakeState) {\n      return\n    }\n\n    void this.#fakeState.fakeAdapter.destroy()\n\n    for (const adapter of this.#adapterInstances.values()) {\n      void adapter.destroy()\n    }\n\n    const state = this.#fakeState\n    this.#fakeState = undefined\n\n    this.#defaultAdapter = state.defaultAdapter\n    this.#adapters = state.adapters\n    this.#adapterInstances = state.adapterInstances\n    this.#globalRetryConfig = state.globalRetryConfig\n    this.#globalJobOptions = state.globalJobOptions\n    this.#queueConfigs = state.queueConfigs\n    this.#logger = state.logger\n    this.#jobFactory = state.jobFactory\n  }\n\n  /**\n   * Get the merged retry configuration for a job.\n   *\n   * Configuration is merged with priority: job > queue > global.\n   * This allows specific jobs or queues to override global defaults.\n   *\n   * @param queue - The queue name\n   * @param jobRetryConfig - Optional job-level retry config\n   * @returns The merged retry configuration\n   *\n   * @example\n   * ```typescript\n   * // Global: maxRetries=3, Queue: maxRetries=5, Job: maxRetries=1\n   * // Result: maxRetries=1 (job wins)\n   * const config = QueueManager.getMergedRetryConfig('emails', { maxRetries: 1 })\n   * ```\n   */\n  getMergedRetryConfig(queue: string, jobRetryConfig?: RetryConfig): RetryConfig {\n    const queueConfig = this.#queueConfigs.get(queue)\n    const queueRetryConfig = queueConfig?.retry || {}\n\n    let maxRetries =\n      jobRetryConfig?.maxRetries ??\n      queueRetryConfig.maxRetries ??\n      this.#globalRetryConfig?.maxRetries ??\n      0\n\n    let backoff =\n      jobRetryConfig?.backoff || queueRetryConfig.backoff || this.#globalRetryConfig?.backoff\n\n    return { maxRetries, backoff }\n  }\n\n  /**\n   * Get the configured job factory for custom instantiation.\n   *\n   * @returns The job factory function, or undefined if not configured\n   */\n  getJobFactory(): JobFactory | undefined {\n    return this.#jobFactory\n  }\n\n  /**\n   * Get the merged job options for a job (priority: job > queue > global).\n   */\n  getMergedJobOptions(queue: string, jobOptions?: JobOptions): JobOptions {\n    const queueConfig = this.#queueConfigs.get(queue)\n    const queueJobOptions = queueConfig?.defaultJobOptions\n\n    return {\n      removeOnComplete:\n        jobOptions?.removeOnComplete ??\n        queueJobOptions?.removeOnComplete ??\n        this.#globalJobOptions?.removeOnComplete,\n      removeOnFail:\n        jobOptions?.removeOnFail ??\n        queueJobOptions?.removeOnFail ??\n        this.#globalJobOptions?.removeOnFail,\n    }\n  }\n\n  #validateConfig(config: QueueManagerConfig): void {\n    if (!config.adapters || Object.keys(config.adapters).length === 0) {\n      throw new errors.E_CONFIGURATION_ERROR(['At least one adapter must be configured'])\n    }\n\n    if (!config.default) {\n      throw new errors.E_CONFIGURATION_ERROR(['Default adapter must be specified'])\n    }\n\n    if (!config.adapters[config.default]) {\n      throw new errors.E_CONFIGURATION_ERROR([\n        `Default adapter \"${config.default}\" not found in adapters configuration`,\n      ])\n    }\n\n    for (const [name, factory] of Object.entries(config.adapters)) {\n      if (typeof factory !== 'function') {\n        throw new errors.E_CONFIGURATION_ERROR([`Adapter \"${name}\" must be a factory function`])\n      }\n    }\n  }\n\n  /**\n   * Clean up all adapter instances and reset state.\n   *\n   * Call this when shutting down the application or when\n   * you need to reinitialize with a new configuration.\n   *\n   * @example\n   * ```typescript\n   * // On application shutdown\n   * await QueueManager.destroy()\n   * ```\n   */\n  async destroy() {\n    for (const [name, adapter] of this.#adapterInstances) {\n      debug('destroying adapter \"%s\"', name)\n      await adapter.destroy()\n    }\n\n    if (this.#fakeState) {\n      await this.#fakeState.fakeAdapter.destroy()\n\n      for (const [name, adapter] of this.#fakeState.adapterInstances) {\n        debug('destroying adapter \"%s\"', name)\n        await adapter.destroy()\n      }\n    }\n\n    this.#adapterInstances.clear()\n    this.#initialized = false\n    this.#fakeState = undefined\n  }\n}\n\n/** Global queue manager singleton */\nexport const QueueManager = new QueueManagerSingleton()\n","import debug from './debug.js'\nimport { randomUUID } from 'node:crypto'\nimport { QueueManager } from './queue_manager.js'\nimport type { Adapter } from './contracts/adapter.js'\nimport type { DispatchManyResult } from './types/main.js'\n\n/**\n * Fluent builder for dispatching multiple jobs to the queue in a single batch.\n *\n * Provides a chainable API for configuring job options before dispatch.\n * Usually created via `Job.dispatchMany()` rather than directly.\n *\n * ```\n * Job.dispatchMany(payloads)\n *     .toQueue('emails')     // optional: target queue\n *     .priority(1)           // optional: 1-10, lower = higher priority\n *     .group('batch-123')    // optional: group all jobs together\n *     .with('redis')         // optional: specific adapter\n *     .run()                 // dispatch all jobs\n * ```\n *\n * @typeParam T - The payload type for these jobs\n *\n * @example\n * ```typescript\n * // Batch dispatch for newsletter\n * const { jobIds } = await SendEmailJob.dispatchMany([\n *   { to: 'user1@example.com', subject: 'Newsletter' },\n *   { to: 'user2@example.com', subject: 'Newsletter' },\n * ])\n *   .group('newsletter-jan-2025')\n *   .toQueue('emails')\n *   .run()\n *\n * console.log(`Dispatched ${jobIds.length} jobs`)\n * ```\n */\nexport class JobBatchDispatcher<T> {\n  readonly #name: string\n  readonly #payloads: T[]\n  #queue: string = 'default'\n  #adapter?: string | (() => Adapter)\n  #priority?: number\n  #groupId?: string\n\n  /**\n   * Create a new batch job dispatcher.\n   *\n   * @param name - The job class name (used to locate the class at runtime)\n   * @param payloads - Array of data to pass to each job\n   */\n  constructor(name: string, payloads: T[]) {\n    this.#name = name\n    this.#payloads = payloads\n  }\n\n  /**\n   * Set the target queue for all jobs.\n   *\n   * @param queue - Queue name (default: 'default')\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * await SendEmailJob.dispatchMany(payloads).toQueue('emails')\n   * ```\n   */\n  toQueue(queue: string): this {\n    this.#queue = queue\n\n    return this\n  }\n\n  /**\n   * Set the priority for all jobs.\n   *\n   * Lower numbers = higher priority. Jobs with lower priority values\n   * are processed before jobs with higher values.\n   *\n   * @param priority - Priority level (1-10, default: 5)\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * await UrgentJob.dispatchMany(payloads).priority(1)\n   * ```\n   */\n  priority(priority: number): this {\n    this.#priority = priority\n\n    return this\n  }\n\n  /**\n   * Assign all jobs to a group.\n   *\n   * Jobs with the same groupId can be filtered and displayed together\n   * in monitoring UIs. Useful for batch operations like newsletters\n   * or bulk exports.\n   *\n   * @param groupId - Group identifier\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * await SendEmailJob.dispatchMany(recipients)\n   *   .group('newsletter-jan-2025')\n   *   .run()\n   * ```\n   */\n  group(groupId: string): this {\n    this.#groupId = groupId\n\n    return this\n  }\n\n  /**\n   * Use a specific adapter for these jobs.\n   *\n   * @param adapter - Adapter name or factory function\n   * @returns This dispatcher for chaining\n   *\n   * @example\n   * ```typescript\n   * await Job.dispatchMany(payloads).with('redis')\n   * ```\n   */\n  with(adapter: string | (() => Adapter)) {\n    this.#adapter = adapter\n\n    return this\n  }\n\n  /**\n   * Dispatch all jobs to the queue.\n   *\n   * @returns A DispatchManyResult containing all jobIds\n   *\n   * @example\n   * ```typescript\n   * const { jobIds } = await SendEmailJob.dispatchMany(payloads).run()\n   * console.log(`Dispatched ${jobIds.length} jobs`)\n   * ```\n   */\n  async run(): Promise<DispatchManyResult> {\n    debug('dispatching %d jobs of type %s', this.#payloads.length, this.#name)\n\n    const adapter = this.#getAdapterInstance()\n\n    const jobs = this.#payloads.map((payload) => ({\n      id: randomUUID(),\n      name: this.#name,\n      payload,\n      attempts: 0,\n      priority: this.#priority,\n      groupId: this.#groupId,\n    }))\n\n    await adapter.pushManyOn(this.#queue, jobs)\n\n    return {\n      jobIds: jobs.map((job) => job.id),\n    }\n  }\n\n  /**\n   * Thenable implementation for auto-dispatch when awaited.\n   *\n   * Allows `await Job.dispatchMany(payloads)` without explicit `.run()`.\n   *\n   * @param onFulfilled - Success callback\n   * @param onRejected - Error callback\n   * @returns Promise resolving to the DispatchManyResult\n   */\n  then<TResult1 = DispatchManyResult, TResult2 = never>(\n    onFulfilled?: ((value: DispatchManyResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onRejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return this.run().then(onFulfilled, onRejected)\n  }\n\n  #getAdapterInstance(): Adapter {\n    if (!this.#adapter) {\n      return QueueManager.use()\n    }\n\n    if (typeof this.#adapter === 'string') {\n      return QueueManager.use(this.#adapter)\n    }\n\n    return this.#adapter()\n  }\n}\n","import type { Duration, ScheduleConfig, ScheduleResult } from './types/main.js'\nimport { QueueManager } from './queue_manager.js'\nimport { parse } from './utils.js'\nimport { CronExpressionParser } from 'cron-parser'\nimport * as errors from './exceptions.js'\n\n/**\n * Fluent builder for creating job schedules.\n *\n * @example\n * ```typescript\n * // Create with cron\n * const { scheduleId } = await new ScheduleBuilder('CleanupJob', { days: 30 })\n *   .id('cleanup-daily')\n *   .cron('0 0 * * *')\n *   .timezone('Europe/Paris')\n *   .run()\n *\n * // Create with interval\n * const { scheduleId } = await new ScheduleBuilder('SyncJob', {})\n *   .every('5m')\n *   .run()\n * ```\n */\nexport class ScheduleBuilder<TPayload = unknown> implements PromiseLike<ScheduleResult> {\n  #name: string\n  #payload: TPayload\n  #id?: string\n  #cronExpression?: string\n  #everyMs?: number\n  #timezone: string = 'UTC'\n  #from?: Date\n  #to?: Date\n  #limit?: number\n\n  constructor(name: string, payload: TPayload) {\n    this.#name = name\n    this.#payload = payload\n  }\n\n  /**\n   * Set a custom schedule ID.\n   * If not specified, defaults to the job name.\n   * If a schedule with this ID exists, it will be updated (upsert).\n   */\n  id(scheduleId: string): this {\n    this.#id = scheduleId\n    return this\n  }\n\n  /**\n   * Set a cron expression for the schedule.\n   * Mutually exclusive with `every()`.\n   */\n  cron(expression: string): this {\n    this.#cronExpression = expression\n    return this\n  }\n\n  /**\n   * Set a repeating interval for the schedule.\n   * Mutually exclusive with `cron()`.\n   */\n  every(interval: Duration): this {\n    this.#everyMs = parse(interval)\n    return this\n  }\n\n  /**\n   * Set the timezone for cron evaluation.\n   * @default 'UTC'\n   */\n  timezone(tz: string): this {\n    this.#timezone = tz\n    return this\n  }\n\n  /**\n   * Set the start boundary for the schedule.\n   * No jobs will be dispatched before this date.\n   */\n  from(date: Date): this {\n    this.#from = date\n    return this\n  }\n\n  /**\n   * Set the end boundary for the schedule.\n   * No jobs will be dispatched after this date.\n   */\n  to(date: Date): this {\n    this.#to = date\n    return this\n  }\n\n  /**\n   * Set both start and end boundaries for the schedule.\n   * Shorthand for `.from(start).to(end)`.\n   */\n  between(from: Date, to: Date): this {\n    return this.from(from).to(to)\n  }\n\n  /**\n   * Set the maximum number of runs for this schedule.\n   */\n  limit(maxRuns: number): this {\n    this.#limit = maxRuns\n    return this\n  }\n\n  /**\n   * Create the schedule and return the schedule ID.\n   */\n  async run(): Promise<ScheduleResult> {\n    // Validation\n    if (!this.#cronExpression && !this.#everyMs) {\n      throw new errors.E_INVALID_SCHEDULE_CONFIG([\n        'Schedule must have either a cron expression or an interval',\n      ])\n    }\n\n    if (this.#cronExpression && this.#everyMs) {\n      throw new errors.E_INVALID_SCHEDULE_CONFIG([\n        'Schedule cannot have both a cron expression and an interval',\n      ])\n    }\n\n    // Validate cron expression\n    if (this.#cronExpression) {\n      try {\n        CronExpressionParser.parse(this.#cronExpression, { tz: this.#timezone })\n      } catch (error) {\n        throw new errors.E_INVALID_CRON_EXPRESSION(\n          [this.#cronExpression, (error as Error).message],\n          {\n            cause: error,\n          }\n        )\n      }\n    }\n\n    const config: ScheduleConfig = {\n      id: this.#id ?? this.#name,\n      name: this.#name,\n      payload: this.#payload,\n      cronExpression: this.#cronExpression,\n      everyMs: this.#everyMs,\n      timezone: this.#timezone,\n      from: this.#from,\n      to: this.#to,\n      limit: this.#limit,\n    }\n\n    const adapter = QueueManager.use()\n    const scheduleId = await adapter.upsertSchedule(config)\n\n    // Calculate and set nextRunAt\n    const nextRunAt = this.#calculateNextRunAt()\n    await adapter.updateSchedule(scheduleId, { nextRunAt })\n\n    return { scheduleId }\n  }\n\n  /**\n   * Calculate the next run time based on cron or interval.\n   */\n  #calculateNextRunAt(): Date {\n    const now = new Date()\n    let nextRun: Date\n\n    if (this.#cronExpression) {\n      const cron = CronExpressionParser.parse(this.#cronExpression, {\n        currentDate: now,\n        tz: this.#timezone,\n      })\n      nextRun = cron.next().toDate()\n    } else {\n      // Interval-based: next run is now + interval\n      nextRun = new Date(now.getTime() + this.#everyMs!)\n    }\n\n    // Respect from boundary\n    if (this.#from && nextRun < this.#from) {\n      if (this.#cronExpression) {\n        // Recalculate from the start boundary\n        const cron = CronExpressionParser.parse(this.#cronExpression, {\n          currentDate: this.#from,\n          tz: this.#timezone,\n        })\n        nextRun = cron.next().toDate()\n      } else {\n        nextRun = this.#from\n      }\n    }\n\n    return nextRun\n  }\n\n  /**\n   * Implement PromiseLike to allow `await builder.every('5m')` syntax.\n   */\n  then<TResult1 = ScheduleResult, TResult2 = never>(\n    onfulfilled?: ((value: ScheduleResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return this.run().then(onfulfilled, onrejected)\n  }\n}\n","import { JobDispatcher } from './job_dispatcher.js'\nimport { JobBatchDispatcher } from './job_batch_dispatcher.js'\nimport { ScheduleBuilder } from './schedule_builder.js'\nimport type { JobContext, JobOptions } from './types/main.js'\n\n/**\n * Abstract base class for all queue jobs.\n *\n * Extend this class to create your own jobs. Each job must implement\n * the `execute()` method which contains the job's business logic.\n *\n * The constructor is reserved for dependency injection. Payload and context\n * are provided separately via the `$hydrate()` method (called by the worker).\n *\n * @typeParam Payload - The type of data this job receives\n *\n * @example\n * ```typescript\n * import { Job } from '@boringnode/queue'\n *\n * interface SendEmailPayload {\n *   to: string\n *   subject: string\n *   body: string\n * }\n *\n * export default class SendEmailJob extends Job<SendEmailPayload> {\n *   static options = {\n *     queue: 'emails',\n *     maxRetries: 3,\n *   }\n *\n *   // Constructor is for dependency injection only\n *   constructor(private mailer: MailerService) {\n *     super()\n *   }\n *\n *   async execute() {\n *     console.log(`Attempt ${this.context.attempt} for job ${this.context.jobId}`)\n *     await this.mailer.send(this.payload.to, this.payload.subject, this.payload.body)\n *   }\n *\n *   async failed(error: Error) {\n *     console.error(`Failed to send email to ${this.payload.to}:`, error)\n *   }\n * }\n * ```\n */\nexport abstract class Job<Payload = any> {\n  #payload!: Payload\n  #context!: JobContext\n  #signal?: AbortSignal\n\n  /**\n   * Static options for this job class.\n   *\n   * Override this property in subclasses to configure job behavior\n   * such as queue name, retry policy, timeout, and more.\n   *\n   * @example\n   * ```typescript\n   * class SendEmailJob extends Job<SendEmailPayload> {\n   *   static options = {\n   *     queue: 'emails',\n   *     maxRetries: 3,\n   *     timeout: '30s',\n   *   }\n   * }\n   * ```\n   */\n  static options: JobOptions = {}\n\n  /**\n   * The payload data passed to this job instance.\n   *\n   * Contains the data provided when the job was dispatched.\n   * Available after the job has been hydrated by the worker.\n   *\n   * @example\n   * ```typescript\n   * async execute() {\n   *   const { to, subject, body } = this.payload\n   *   await sendEmail(to, subject, body)\n   * }\n   * ```\n   */\n  get payload(): Payload {\n    return this.#payload\n  }\n\n  /**\n   * Context information for the current job execution.\n   *\n   * Provides metadata such as job ID, current attempt number,\n   * queue name, priority, and timing information.\n   *\n   * @example\n   * ```typescript\n   * async execute() {\n   *   if (this.context.attempt > 1) {\n   *     console.log(`Retry attempt ${this.context.attempt}`)\n   *   }\n   *   console.log(`Processing job ${this.context.jobId} on queue ${this.context.queue}`)\n   * }\n   * ```\n   */\n  get context(): JobContext {\n    return this.#context\n  }\n\n  /**\n   * The abort signal for timeout handling.\n   *\n   * Check `signal.aborted` in long-running operations to handle timeouts gracefully.\n   *\n   * @example\n   * ```typescript\n   * async execute() {\n   *   for (const item of this.payload.items) {\n   *     if (this.signal?.aborted) {\n   *       throw new Error('Job timed out')\n   *     }\n   *     await processItem(item)\n   *   }\n   * }\n   * ```\n   */\n  get signal(): AbortSignal | undefined {\n    return this.#signal\n  }\n\n  /**\n   * Hydrate the job with payload, context, and optional abort signal.\n   *\n   * This method is called by the worker after instantiation to provide\n   * the job's runtime data. It should not be called directly by user code.\n   *\n   * @param payload - The data to be processed by this job\n   * @param context - The job execution context\n   * @param signal - Optional abort signal for timeout handling\n   *\n   * @internal\n   */\n  $hydrate(payload: Payload, context: JobContext, signal?: AbortSignal): void {\n    this.#payload = payload\n    this.#context = Object.freeze(context)\n    this.#signal = signal\n  }\n\n  /**\n   * Dispatch this job to the queue.\n   *\n   * Returns a JobDispatcher for fluent configuration before dispatching.\n   * The job is not actually dispatched until `.run()` is called or the\n   * dispatcher is awaited.\n   *\n   * @param payload - The data to pass to the job\n   * @returns A JobDispatcher for fluent configuration\n   *\n   * @example\n   * ```typescript\n   * // Simple dispatch\n   * await SendEmailJob.dispatch({ to: 'user@example.com', subject: 'Hello' })\n   *\n   * // With options\n   * await SendEmailJob.dispatch({ to: 'user@example.com' })\n   *   .toQueue('high-priority')\n   *   .priority(1)\n   *   .in('5m')\n   *   .run()\n   * ```\n   */\n  static dispatch<T extends Job>(\n    this: new (...args: unknown[]) => T,\n    payload: T extends Job<infer P> ? P : never\n  ): JobDispatcher<T extends Job<infer P> ? P : never> {\n    const jobClass = this as unknown as { options?: JobOptions; name: string }\n    const options = jobClass.options || {}\n    const jobName = options.name || this.name\n\n    const dispatcher = new JobDispatcher<T extends Job<infer P> ? P : never>(jobName, payload)\n\n    if (options.queue) {\n      dispatcher.toQueue(options.queue)\n    }\n\n    if (options.adapter) {\n      dispatcher.with(options.adapter)\n    }\n\n    if (options.priority !== undefined) {\n      dispatcher.priority(options.priority)\n    }\n\n    return dispatcher\n  }\n\n  /**\n   * Dispatch multiple jobs to the queue in a single batch.\n   *\n   * Returns a JobBatchDispatcher for fluent configuration before dispatching.\n   * The jobs are not actually dispatched until `.run()` is called or the\n   * dispatcher is awaited.\n   *\n   * This is more efficient than calling `dispatch()` multiple times as it\n   * uses batched operations (e.g., Redis pipeline, SQL batch insert).\n   *\n   * @param payloads - Array of data to pass to each job\n   * @returns A JobBatchDispatcher for fluent configuration\n   *\n   * @example\n   * ```typescript\n   * // Batch dispatch for newsletter\n   * const { jobIds } = await SendEmailJob.dispatchMany([\n   *   { to: 'user1@example.com', subject: 'Newsletter' },\n   *   { to: 'user2@example.com', subject: 'Newsletter' },\n   * ])\n   *   .group('newsletter-jan-2025')\n   *   .toQueue('emails')\n   *   .run()\n   *\n   * console.log(`Dispatched ${jobIds.length} jobs`)\n   * ```\n   */\n  static dispatchMany<T extends Job>(\n    this: new (...args: unknown[]) => T,\n    payloads: (T extends Job<infer P> ? P : never)[]\n  ): JobBatchDispatcher<T extends Job<infer P> ? P : never> {\n    const jobClass = this as unknown as { options?: JobOptions; name: string }\n    const options = jobClass.options || {}\n    const jobName = options.name || this.name\n\n    const dispatcher = new JobBatchDispatcher<T extends Job<infer P> ? P : never>(jobName, payloads)\n\n    if (options.queue) {\n      dispatcher.toQueue(options.queue)\n    }\n\n    if (options.adapter) {\n      dispatcher.with(options.adapter)\n    }\n\n    if (options.priority !== undefined) {\n      dispatcher.priority(options.priority)\n    }\n\n    return dispatcher\n  }\n\n  /**\n   * Create a schedule for this job.\n   *\n   * Returns a ScheduleBuilder for fluent configuration before creating the schedule.\n   * The schedule is not actually created until `.run()` is called or the\n   * builder is awaited.\n   *\n   * @param payload - The data to pass to the job on each run\n   * @returns A ScheduleBuilder for fluent configuration\n   *\n   * @example\n   * ```typescript\n   * // Cron schedule\n   * await CleanupJob.schedule({ days: 30 })\n   *   .id('cleanup-daily')\n   *   .cron('0 0 * * *')\n   *   .timezone('Europe/Paris')\n   *   .run()\n   *\n   * // Interval schedule\n   * await SyncJob.schedule({ source: 'api' })\n   *   .every('5m')\n   *   .run()\n   * ```\n   */\n  static schedule<T extends Job>(\n    this: new (...args: unknown[]) => T,\n    payload: T extends Job<infer P> ? P : never\n  ): ScheduleBuilder<T extends Job<infer P> ? P : never> {\n    const jobClass = this as unknown as { options?: JobOptions; name: string }\n    const options = jobClass.options || {}\n    const jobName = options.name || this.name\n\n    return new ScheduleBuilder<T extends Job<infer P> ? P : never>(jobName, payload)\n  }\n\n  /**\n   * Execute the job's business logic.\n   *\n   * This method is called by the worker when processing the job.\n   * Implement your job's logic here.\n   *\n   * For timeout handling, use `this.signal` which is available after hydration.\n   *\n   * @throws Any error thrown will trigger retry logic (if configured)\n   *\n   * @example\n   * ```typescript\n   * async execute() {\n   *   for (const item of this.payload.items) {\n   *     if (this.signal?.aborted) {\n   *       throw new Error('Job timed out')\n   *     }\n   *     await processItem(item)\n   *   }\n   * }\n   * ```\n   */\n  abstract execute(): Promise<void>\n\n  /**\n   * Called when the job has permanently failed (after all retries exhausted).\n   *\n   * Use this hook for cleanup, logging, or notifications.\n   * This is optional - implement only if you need failure handling.\n   *\n   * @param error - The error that caused the final failure\n   *\n   * @example\n   * ```typescript\n   * async failed(error: Error) {\n   *   await notifyAdmin(`Job failed: ${error.message}`)\n   *   await cleanup(this.payload)\n   * }\n   * ```\n   */\n  failed?(error: Error): Promise<void>\n}\n"],"mappings":"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","names":["randomUUID","CronExpressionParser","randomUUID","randomUUID","randomUUID","CronExpressionParser"]}

package/build/{chunk-3BIR4IQD.js → chunk-ZZFSQY36.js}

@@ -21,7 +21,7 @@ __export(exceptions_exports, {
   E_NO_JOBS_FOUND: () => E_NO_JOBS_FOUND,
   E_QUEUE_NOT_INITIALIZED: () => E_QUEUE_NOT_INITIALIZED
 });
-import { createError } from "@poppinss/utils";
+import { createError } from "@poppinss/utils/exception";
 var E_INVALID_DURATION_EXPRESSION = createError(
   'Invalid duration expression: "%s"',
   "E_INVALID_DURATION_EXPRESSION",
@@ -144,4 +144,4 @@ export {
   parse,
   calculateScore
 };
-//# sourceMappingURL=chunk-3BIR4IQD.js.map
+//# sourceMappingURL=chunk-ZZFSQY36.js.map

package/build/chunk-ZZFSQY36.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/exceptions.ts","../src/constants.ts","../src/utils.ts"],"sourcesContent":["import { createError } from '@poppinss/utils/exception'\n\nexport const E_INVALID_DURATION_EXPRESSION = createError(\n  'Invalid duration expression: \"%s\"',\n  'E_INVALID_DURATION_EXPRESSION',\n  500\n)\n\nexport const E_INVALID_BASE_DELAY = createError<[reason: string]>(\n  'Invalid base delay. Reason: %s',\n  'E_INVALID_BASE_DELAY',\n  500\n)\n\nexport const E_INVALID_MAX_DELAY = createError<[reason: string]>(\n  'Invalid max delay. Reason: %s',\n  'E_INVALID_MAX_DELAY',\n  500\n)\n\nexport const E_INVALID_MULTIPLIER = createError<[reason: string]>(\n  'Invalid multiplier. Reason: %s',\n  'E_INVALID_MULTIPLIER',\n  500\n)\n\nexport const E_CONFIGURATION_ERROR = createError<[reason: string]>(\n  'Configuration error. Reason: %s',\n  'E_CONFIGURATION_ERROR',\n  500\n)\n\nexport const E_JOB_NOT_FOUND = createError<[jobName: string]>(\n  'Requested job \"%s\" is not registered',\n  'E_JOB_NOT_FOUND'\n)\n\nexport const E_JOB_MAX_ATTEMPTS_REACHED = createError<[jobName: string]>(\n  'The job \"%s\" has reached the maximum number of retry attempts',\n  'E_JOB_MAX_ATTEMPTS_REACHED'\n)\n\nexport const E_JOB_TIMEOUT = createError<[jobName: string, timeout: number]>(\n  'The job \"%s\" has exceeded the timeout of %dms',\n  'E_JOB_TIMEOUT'\n)\n\nexport const E_QUEUE_NOT_INITIALIZED = createError(\n  'QueueManager is not initialized. Call QueueManager.init() before using it.',\n  'E_QUEUE_NOT_INITIALIZED',\n  500\n)\n\nexport const E_ADAPTER_INIT_ERROR = createError<[adapterName: string, originalMessage: string]>(\n  'Failed to initialize adapter \"%s\". Reason: %s',\n  'E_ADAPTER_INIT_ERROR',\n  500\n)\n\nexport const E_NO_JOBS_FOUND = createError<[patterns: string]>(\n  'No jobs found for the specified locations: %s. Verify your glob patterns match your job files.',\n  'E_NO_JOBS_FOUND',\n  500\n)\n\nexport const E_INVALID_CRON_EXPRESSION = createError<[expression: string, reason: string]>(\n  'Invalid cron expression \"%s\": %s',\n  'E_INVALID_CRON_EXPRESSION',\n  500\n)\n\nexport const E_INVALID_SCHEDULE_CONFIG = createError<[reason: string]>(\n  'Invalid schedule configuration: %s',\n  'E_INVALID_SCHEDULE_CONFIG',\n  500\n)\n","/**\n * Default job priority (1-10 scale, lower = higher priority)\n */\nexport const DEFAULT_PRIORITY = 5\n\n/**\n * Multiplier used in score calculation: priority * multiplier + timestamp\n *\n * This ensures higher priority jobs are processed first,\n * while preserving FIFO order within the same priority.\n * The value (1e13) leaves room for ~300 years of millisecond timestamps.\n */\nexport const PRIORITY_SCORE_MULTIPLIER = 1e13\n\n/**\n * Default delay when the worker is idle (no jobs in queue)\n */\nexport const DEFAULT_IDLE_DELAY = '2s'\n\n/**\n * Default interval between stalled job checks\n */\nexport const DEFAULT_STALLED_INTERVAL = '30s'\n\n/**\n * Default threshold after which a job is considered stalled\n */\nexport const DEFAULT_STALLED_THRESHOLD = '30s'\n\n/**\n * Default delay before retrying after an error\n */\nexport const DEFAULT_ERROR_RETRY_DELAY = '5s'\n","import { parse as parseDuration } from '@lukeed/ms'\nimport type { Duration, JobRetention } from './types/main.js'\nimport * as errors from './exceptions.js'\nimport { PRIORITY_SCORE_MULTIPLIER } from './constants.js'\n\nexport interface ResolvedRetention {\n  keep: boolean\n  maxAge: number\n  maxCount: number\n}\n\nexport function resolveRetention(retention?: JobRetention): ResolvedRetention {\n  if (retention === undefined || retention === true) {\n    return { keep: false, maxAge: 0, maxCount: 0 }\n  }\n\n  if (retention === false) {\n    return { keep: true, maxAge: 0, maxCount: 0 }\n  }\n\n  return {\n    keep: true,\n    maxAge: retention.age ? parse(retention.age) : 0,\n    maxCount: retention.count ?? 0,\n  }\n}\n\nexport function parse(duration: Duration): number {\n  if (typeof duration === 'number') {\n    return duration\n  }\n\n  const milliseconds = parseDuration(duration)\n\n  if (typeof milliseconds === 'undefined') {\n    throw new errors.E_INVALID_DURATION_EXPRESSION([duration])\n  }\n\n  return milliseconds\n}\n\n/**\n * Calculate the score for job ordering in the queue.\n * Lower scores are processed first.\n *\n * @param priority - Job priority (1-10, lower = higher priority)\n * @param timestamp - Timestamp in milliseconds\n * @returns Score for queue ordering\n */\nexport function calculateScore(priority: number, timestamp: number): number {\n  return priority * PRIORITY_SCORE_MULTIPLIER + timestamp\n}\n"],"mappings":";;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAS,mBAAmB;AAErB,IAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AACF;AAEO,IAAM,6BAA6B;AAAA,EACxC;AAAA,EACA;AACF;AAEO,IAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AACF;AAEO,IAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF;;;ACxEO,IAAM,mBAAmB;AASzB,IAAM,4BAA4B;AAKlC,IAAM,qBAAqB;AAK3B,IAAM,2BAA2B;AAKjC,IAAM,4BAA4B;AAKlC,IAAM,4BAA4B;;;AChCzC,SAAS,SAAS,qBAAqB;AAWhC,SAAS,iBAAiB,WAA6C;AAC5E,MAAI,cAAc,UAAa,cAAc,MAAM;AACjD,WAAO,EAAE,MAAM,OAAO,QAAQ,GAAG,UAAU,EAAE;AAAA,EAC/C;AAEA,MAAI,cAAc,OAAO;AACvB,WAAO,EAAE,MAAM,MAAM,QAAQ,GAAG,UAAU,EAAE;AAAA,EAC9C;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,UAAU,MAAM,MAAM,UAAU,GAAG,IAAI;AAAA,IAC/C,UAAU,UAAU,SAAS;AAAA,EAC/B;AACF;AAEO,SAAS,MAAM,UAA4B;AAChD,MAAI,OAAO,aAAa,UAAU;AAChC,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,cAAc,QAAQ;AAE3C,MAAI,OAAO,iBAAiB,aAAa;AACvC,UAAM,IAAW,8BAA8B,CAAC,QAAQ,CAAC;AAAA,EAC3D;AAEA,SAAO;AACT;AAUO,SAAS,eAAe,UAAkB,WAA2B;AAC1E,SAAO,WAAW,4BAA4B;AAChD;","names":[]}