@boringnode/queue 0.4.1 → 0.5.0

package/README.md

@@ -292,6 +292,17 @@ import { sync } from '@boringnode/queue/drivers/sync_adapter'
 const adapter = sync() // Jobs execute immediately
 ```
 
+Use the `sync` adapter for tests and lightweight local development only.
+
+- `await MyJob.dispatch(payload).run()` waits for the job to fully finish.
+- Retries are executed inline, not by a background worker.
+- If you configure backoff, the adapter will `sleep` between attempts.
+- This means the caller can stay blocked for the full retry duration.
+
+Example: with `maxRetries: 3` and an exponential backoff of `1s`, `2s`, `4s`,
+the request or command that dispatched the job can stay busy for about 7 seconds
+before the job exhausts its retries and runs `failed()`.
+
 ## Job Options
 
 ```typescript
@@ -338,6 +349,14 @@ export default class ReliableJob extends Job<Payload> {
 }
 ```
 
+`maxRetries` can be defined directly on the job options, and `retry.backoff`
+controls the delay between attempts.
+
+> With the `sync` adapter, these delays happen inline in the caller via
+> `sleep`. If a job fails repeatedly, `dispatch().run()` will take as long as
+> the total backoff duration. Use a worker-backed adapter when you do not want
+> retries to slow down the request/command that dispatched the job.
+
 <details>
 <summary><strong>Available strategies</strong></summary>
 

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

@@ -185,17 +185,89 @@ var ConsoleLogger = class _ConsoleLogger {
 };
 var consoleLogger = new ConsoleLogger();
 
+// src/queue_config_resolver.ts
+var QueueConfigResolver = class _QueueConfigResolver {
+  #globalRetryConfig;
+  #globalJobOptions;
+  #queueConfigs;
+  #workerTimeout;
+  /**
+   * Create a resolver from the queue manager config.
+   */
+  static from(config) {
+    return new _QueueConfigResolver({
+      globalRetryConfig: config.retry,
+      globalJobOptions: config.defaultJobOptions,
+      queueConfigs: new Map(Object.entries(config.queues || {})),
+      workerTimeout: config.worker?.timeout
+    });
+  }
+  /**
+   * Create a resolver from already-materialized config fragments.
+   */
+  constructor({
+    globalRetryConfig,
+    globalJobOptions,
+    queueConfigs,
+    workerTimeout
+  }) {
+    this.#globalRetryConfig = globalRetryConfig;
+    this.#globalJobOptions = globalJobOptions;
+    this.#queueConfigs = queueConfigs ?? /* @__PURE__ */ new Map();
+    this.#workerTimeout = workerTimeout;
+  }
+  /**
+   * Resolve the retry policy for a job using priority: job > queue > global.
+   */
+  resolveRetryConfig(queue, jobOptions) {
+    const queueConfig = this.#queueConfigs.get(queue);
+    const queueRetryConfig = queueConfig?.retry || {};
+    const jobRetryConfig = this.#normalizeJobRetryConfig(jobOptions);
+    const maxRetries = jobRetryConfig?.maxRetries ?? queueRetryConfig.maxRetries ?? this.#globalRetryConfig?.maxRetries ?? 0;
+    const backoff = jobRetryConfig?.backoff || queueRetryConfig.backoff || this.#globalRetryConfig?.backoff;
+    return { maxRetries, backoff };
+  }
+  /**
+   * Resolve effective retention options using priority: job > queue > global.
+   */
+  resolveJobOptions(queue, jobOptions) {
+    const queueConfig = this.#queueConfigs.get(queue);
+    const queueJobOptions = queueConfig?.defaultJobOptions;
+    return {
+      removeOnComplete: jobOptions?.removeOnComplete ?? queueJobOptions?.removeOnComplete ?? this.#globalJobOptions?.removeOnComplete,
+      removeOnFail: jobOptions?.removeOnFail ?? queueJobOptions?.removeOnFail ?? this.#globalJobOptions?.removeOnFail
+    };
+  }
+  /**
+   * Return the configured default worker timeout.
+   */
+  getWorkerTimeout() {
+    return this.#workerTimeout;
+  }
+  /**
+   * Normalize job retry settings so top-level `maxRetries` participates in the
+   * merge like `retry.maxRetries`.
+   */
+  #normalizeJobRetryConfig(jobOptions) {
+    if (!jobOptions || jobOptions.retry === void 0 && jobOptions.maxRetries === void 0) {
+      return void 0;
+    }
+    return {
+      ...jobOptions.retry,
+      maxRetries: jobOptions.retry?.maxRetries ?? jobOptions.maxRetries
+    };
+  }
+};
+
 // src/queue_manager.ts
 var QueueManagerSingleton = class {
   #initialized = false;
   #defaultAdapter;
   #adapters = {};
   #adapterInstances = /* @__PURE__ */ new Map();
-  #globalRetryConfig;
-  #globalJobOptions;
-  #queueConfigs = /* @__PURE__ */ new Map();
   #logger = consoleLogger;
   #jobFactory;
+  #configResolver = new QueueConfigResolver({});
   #fakeState;
   /**
    * Initialize the queue system with the given configuration.
@@ -224,18 +296,12 @@ var QueueManagerSingleton = class {
   async init(config) {
     debug_default("initializing queue manager with config: %O", config);
     this.#validateConfig(config);
-    this.#adapterInstances.clear();
+    await this.#cleanupBeforeReinitialization();
     this.#defaultAdapter = config.default;
     this.#adapters = config.adapters;
-    this.#globalRetryConfig = config.retry;
-    this.#globalJobOptions = config.defaultJobOptions;
     this.#logger = config.logger ?? consoleLogger;
     this.#jobFactory = config.jobFactory;
-    if (config.queues) {
-      for (const [queue, queueConfig] of Object.entries(config.queues)) {
-        this.#queueConfigs.set(queue, queueConfig);
-      }
-    }
+    this.#configResolver = QueueConfigResolver.from(config);
     if (config.locations && config.locations.length > 0) {
       const registered = await Locator.registerFromGlob(config.locations);
       if (registered === 0) {
@@ -247,6 +313,40 @@ var QueueManagerSingleton = class {
     this.#initialized = true;
     return this;
   }
+  /**
+   * Destroy any materialized adapters from the current configuration before
+   * replacing it with a new one.
+   */
+  async #cleanupBeforeReinitialization() {
+    const destroyedAdapters = /* @__PURE__ */ new Set();
+    await this.#destroyAdapters(this.#adapterInstances, destroyedAdapters);
+    if (this.#fakeState) {
+      await this.#destroyAdapter("fake", this.#fakeState.fakeAdapter, destroyedAdapters);
+      await this.#destroyAdapters(this.#fakeState.adapterInstances, destroyedAdapters);
+      this.#fakeState = void 0;
+    }
+    this.#adapterInstances.clear();
+  }
+  /**
+   * Destroy a collection of adapters while avoiding double-destroying the same
+   * instance through multiple references.
+   */
+  async #destroyAdapters(adapters, destroyedAdapters) {
+    for (const [name, adapter] of adapters) {
+      await this.#destroyAdapter(name, adapter, destroyedAdapters);
+    }
+  }
+  /**
+   * Destroy a single adapter once for the current cleanup pass.
+   */
+  async #destroyAdapter(name, adapter, destroyedAdapters) {
+    if (destroyedAdapters.has(adapter)) {
+      return;
+    }
+    destroyedAdapters.add(adapter);
+    debug_default('destroying adapter "%s" before reinitialization', name);
+    await adapter.destroy();
+  }
   /**
    * Get an adapter instance by name.
    *
@@ -324,11 +424,9 @@ var QueueManagerSingleton = class {
       defaultAdapter: this.#defaultAdapter,
       adapters: this.#adapters,
       adapterInstances: this.#adapterInstances,
-      globalRetryConfig: this.#globalRetryConfig,
-      globalJobOptions: this.#globalJobOptions,
-      queueConfigs: this.#queueConfigs,
       logger: this.#logger,
       jobFactory: this.#jobFactory,
+      configResolver: this.#configResolver,
       fakeAdapter
     };
     const fakeFactory = () => fakeAdapter;
@@ -356,35 +454,9 @@ var QueueManagerSingleton = class {
     this.#defaultAdapter = state.defaultAdapter;
     this.#adapters = state.adapters;
     this.#adapterInstances = state.adapterInstances;
-    this.#globalRetryConfig = state.globalRetryConfig;
-    this.#globalJobOptions = state.globalJobOptions;
-    this.#queueConfigs = state.queueConfigs;
     this.#logger = state.logger;
     this.#jobFactory = state.jobFactory;
-  }
-  /**
-   * Get the merged retry configuration for a job.
-   *
-   * Configuration is merged with priority: job > queue > global.
-   * This allows specific jobs or queues to override global defaults.
-   *
-   * @param queue - The queue name
-   * @param jobRetryConfig - Optional job-level retry config
-   * @returns The merged retry configuration
-   *
-   * @example
-   * ```typescript
-   * // Global: maxRetries=3, Queue: maxRetries=5, Job: maxRetries=1
-   * // Result: maxRetries=1 (job wins)
-   * const config = QueueManager.getMergedRetryConfig('emails', { maxRetries: 1 })
-   * ```
-   */
-  getMergedRetryConfig(queue, jobRetryConfig) {
-    const queueConfig = this.#queueConfigs.get(queue);
-    const queueRetryConfig = queueConfig?.retry || {};
-    let maxRetries = jobRetryConfig?.maxRetries ?? queueRetryConfig.maxRetries ?? this.#globalRetryConfig?.maxRetries ?? 0;
-    let backoff = jobRetryConfig?.backoff || queueRetryConfig.backoff || this.#globalRetryConfig?.backoff;
-    return { maxRetries, backoff };
+    this.#configResolver = state.configResolver;
   }
   /**
    * Get the configured job factory for custom instantiation.
@@ -395,15 +467,19 @@ var QueueManagerSingleton = class {
     return this.#jobFactory;
   }
   /**
-   * Get the merged job options for a job (priority: job > queue > global).
+   * Get the configured logger used by the queue runtime.
    */
-  getMergedJobOptions(queue, jobOptions) {
-    const queueConfig = this.#queueConfigs.get(queue);
-    const queueJobOptions = queueConfig?.defaultJobOptions;
-    return {
-      removeOnComplete: jobOptions?.removeOnComplete ?? queueJobOptions?.removeOnComplete ?? this.#globalJobOptions?.removeOnComplete,
-      removeOnFail: jobOptions?.removeOnFail ?? queueJobOptions?.removeOnFail ?? this.#globalJobOptions?.removeOnFail
-    };
+  getLogger() {
+    return this.#logger;
+  }
+  /**
+   * Get the resolver responsible for effective queue/job runtime config.
+   */
+  getConfigResolver() {
+    if (!this.#initialized) {
+      throw new E_QUEUE_NOT_INITIALIZED();
+    }
+    return this.#configResolver;
   }
   #validateConfig(config) {
     if (!config.adapters || Object.keys(config.adapters).length === 0) {
@@ -449,6 +525,7 @@ var QueueManagerSingleton = class {
     }
     this.#adapterInstances.clear();
     this.#initialized = false;
+    this.#configResolver = new QueueConfigResolver({});
     this.#fakeState = void 0;
   }
 };
@@ -1562,4 +1639,4 @@ export {
   ScheduleBuilder,
   Job
 };
-//# sourceMappingURL=chunk-6EBS7CW4.js.map
+//# sourceMappingURL=chunk-OVYXMSSU.js.map

package/build/chunk-OVYXMSSU.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_config_resolver.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 type {\n  Duration,\n  JobOptions,\n  QueueConfig,\n  QueueManagerConfig,\n  RetryConfig,\n} from './types/main.js'\n\n/**\n * Resolve effective queue/job runtime configuration from the initialized\n * queue config.\n *\n * This keeps merge rules in one place without coupling execution code to the\n * full `QueueManager` lifecycle and adapter concerns.\n */\nexport class QueueConfigResolver {\n  readonly #globalRetryConfig?: RetryConfig\n  readonly #globalJobOptions?: JobOptions\n  readonly #queueConfigs: Map<string, QueueConfig>\n  readonly #workerTimeout?: Duration\n\n  /**\n   * Create a resolver from the queue manager config.\n   */\n  static from(config: QueueManagerConfig): QueueConfigResolver {\n    return new QueueConfigResolver({\n      globalRetryConfig: config.retry,\n      globalJobOptions: config.defaultJobOptions,\n      queueConfigs: new Map(Object.entries(config.queues || {}) as [string, QueueConfig][]),\n      workerTimeout: config.worker?.timeout,\n    })\n  }\n\n  /**\n   * Create a resolver from already-materialized config fragments.\n   */\n  constructor({\n    globalRetryConfig,\n    globalJobOptions,\n    queueConfigs,\n    workerTimeout,\n  }: {\n    globalRetryConfig?: RetryConfig\n    globalJobOptions?: JobOptions\n    queueConfigs?: Map<string, QueueConfig>\n    workerTimeout?: Duration\n  }) {\n    this.#globalRetryConfig = globalRetryConfig\n    this.#globalJobOptions = globalJobOptions\n    this.#queueConfigs = queueConfigs ?? new Map()\n    this.#workerTimeout = workerTimeout\n  }\n\n  /**\n   * Resolve the retry policy for a job using priority: job > queue > global.\n   */\n  resolveRetryConfig(queue: string, jobOptions?: JobOptions): RetryConfig {\n    const queueConfig = this.#queueConfigs.get(queue)\n    const queueRetryConfig = queueConfig?.retry || {}\n    const jobRetryConfig = this.#normalizeJobRetryConfig(jobOptions)\n\n    const maxRetries =\n      jobRetryConfig?.maxRetries ??\n      queueRetryConfig.maxRetries ??\n      this.#globalRetryConfig?.maxRetries ??\n      0\n\n    const backoff =\n      jobRetryConfig?.backoff || queueRetryConfig.backoff || this.#globalRetryConfig?.backoff\n\n    return { maxRetries, backoff }\n  }\n\n  /**\n   * Resolve effective retention options using priority: job > queue > global.\n   */\n  resolveJobOptions(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  /**\n   * Return the configured default worker timeout.\n   */\n  getWorkerTimeout(): Duration | undefined {\n    return this.#workerTimeout\n  }\n\n  /**\n   * Normalize job retry settings so top-level `maxRetries` participates in the\n   * merge like `retry.maxRetries`.\n   */\n  #normalizeJobRetryConfig(jobOptions?: JobOptions): RetryConfig | undefined {\n    if (\n      !jobOptions ||\n      (jobOptions.retry === undefined && jobOptions.maxRetries === undefined)\n    ) {\n      return undefined\n    }\n\n    return {\n      ...jobOptions.retry,\n      maxRetries: jobOptions.retry?.maxRetries ?? jobOptions.maxRetries,\n    }\n  }\n}\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 { QueueConfigResolver } from './queue_config_resolver.js'\nimport type { Adapter } from './contracts/adapter.js'\nimport type { AdapterFactory, JobFactory, QueueManagerConfig } from './types/main.js'\n\ntype QueueManagerFakeState = {\n  defaultAdapter: string\n  adapters: Record<string, AdapterFactory>\n  adapterInstances: Map<string, Adapter>\n  logger: Logger\n  jobFactory?: JobFactory\n  configResolver: QueueConfigResolver\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  #logger: Logger = consoleLogger\n  #jobFactory?: JobFactory\n  #configResolver: QueueConfigResolver = new QueueConfigResolver({})\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    await this.#cleanupBeforeReinitialization()\n\n    this.#defaultAdapter = config.default\n    this.#adapters = config.adapters\n    this.#logger = config.logger ?? consoleLogger\n    this.#jobFactory = config.jobFactory\n    this.#configResolver = QueueConfigResolver.from(config)\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   * Destroy any materialized adapters from the current configuration before\n   * replacing it with a new one.\n   */\n  async #cleanupBeforeReinitialization() {\n    const destroyedAdapters = new Set<Adapter>()\n\n    await this.#destroyAdapters(this.#adapterInstances, destroyedAdapters)\n\n    if (this.#fakeState) {\n      await this.#destroyAdapter('fake', this.#fakeState.fakeAdapter, destroyedAdapters)\n      await this.#destroyAdapters(this.#fakeState.adapterInstances, destroyedAdapters)\n      this.#fakeState = undefined\n    }\n\n    this.#adapterInstances.clear()\n  }\n\n  /**\n   * Destroy a collection of adapters while avoiding double-destroying the same\n   * instance through multiple references.\n   */\n  async #destroyAdapters(adapters: Iterable<[string, Adapter]>, destroyedAdapters: Set<Adapter>) {\n    for (const [name, adapter] of adapters) {\n      await this.#destroyAdapter(name, adapter, destroyedAdapters)\n    }\n  }\n\n  /**\n   * Destroy a single adapter once for the current cleanup pass.\n   */\n  async #destroyAdapter(name: string, adapter: Adapter, destroyedAdapters: Set<Adapter>) {\n    if (destroyedAdapters.has(adapter)) {\n      return\n    }\n\n    destroyedAdapters.add(adapter)\n    debug('destroying adapter \"%s\" before reinitialization', name)\n    await adapter.destroy()\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      logger: this.#logger,\n      jobFactory: this.#jobFactory,\n      configResolver: this.#configResolver,\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.#logger = state.logger\n    this.#jobFactory = state.jobFactory\n    this.#configResolver = state.configResolver\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 configured logger used by the queue runtime.\n   */\n  getLogger(): Logger {\n    return this.#logger\n  }\n\n  /**\n   * Get the resolver responsible for effective queue/job runtime config.\n   */\n  getConfigResolver(): QueueConfigResolver {\n    if (!this.#initialized) {\n      throw new errors.E_QUEUE_NOT_INITIALIZED()\n    }\n\n    return this.#configResolver\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.#configResolver = new QueueConfigResolver({})\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: abstract new (...args: any[]) => 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: abstract new (...args: any[]) => 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: abstract new (...args: any[]) => 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-WOUYSNK2.js

@@ -0,0 +1,128 @@
+import {
+  E_JOB_MAX_ATTEMPTS_REACHED,
+  E_JOB_TIMEOUT,
+  parse
+} from "./chunk-ZZFSQY36.js";
+
+// src/job_runtime.ts
+var JobExecutionRuntime = class _JobExecutionRuntime {
+  #jobName;
+  #options;
+  #retryConfig;
+  #timeout;
+  /**
+   * Build a runtime from already-resolved queue/job execution config.
+   */
+  static from({
+    jobName,
+    options,
+    retryConfig,
+    defaultTimeout
+  }) {
+    return new _JobExecutionRuntime({
+      jobName,
+      options,
+      retryConfig,
+      defaultTimeout
+    });
+  }
+  get maxRetries() {
+    return this.#retryConfig.maxRetries;
+  }
+  /**
+   * Create a runtime with fully resolved retry and timeout settings.
+   */
+  constructor({ jobName, options, retryConfig, defaultTimeout }) {
+    this.#jobName = jobName;
+    this.#options = options || {};
+    this.#retryConfig = retryConfig;
+    const timeout = this.#options.timeout ?? defaultTimeout;
+    this.#timeout = timeout === void 0 ? void 0 : parse(timeout);
+  }
+  /**
+   * Execute a hydrated job instance and enforce the configured timeout.
+   */
+  async execute(instance, payload, context) {
+    if (this.#timeout === void 0) {
+      instance.$hydrate(payload, context);
+      return instance.execute();
+    }
+    const signal = AbortSignal.timeout(this.#timeout);
+    instance.$hydrate(payload, context, signal);
+    const { abortPromise, cleanupAbortListener } = this.#createTimeoutAbortRace(
+      signal,
+      instance.constructor.name
+    );
+    try {
+      await Promise.race([instance.execute(), abortPromise]);
+    } finally {
+      cleanupAbortListener();
+    }
+  }
+  /**
+   * Convert an execution error into a retry or permanent-failure outcome.
+   */
+  resolveFailure(error, attempts) {
+    if (error instanceof E_JOB_TIMEOUT && this.#options.failOnTimeout) {
+      return {
+        type: "failed",
+        reason: "timeout",
+        storageError: error,
+        hookError: error
+      };
+    }
+    if (typeof this.#retryConfig.maxRetries === "undefined" || this.#retryConfig.maxRetries <= 0) {
+      return {
+        type: "failed",
+        reason: "no-retries",
+        storageError: error,
+        hookError: error
+      };
+    }
+    if (attempts >= this.#retryConfig.maxRetries) {
+      return {
+        type: "failed",
+        reason: "max-attempts",
+        storageError: error,
+        hookError: new E_JOB_MAX_ATTEMPTS_REACHED([this.#jobName], { cause: error })
+      };
+    }
+    if (this.#retryConfig.backoff) {
+      return {
+        type: "retry",
+        retryAt: this.#retryConfig.backoff().getNextRetryAt(attempts + 1)
+      };
+    }
+    return { type: "retry" };
+  }
+  /**
+   * Create the timeout race used to abort a job execution cleanly.
+   */
+  #createTimeoutAbortRace(signal, runtimeJobName) {
+    const timeout = this.#timeout;
+    let abortHandler;
+    const abortPromise = new Promise((_, reject) => {
+      abortHandler = () => {
+        reject(new E_JOB_TIMEOUT([runtimeJobName, timeout]));
+      };
+      if (signal.aborted) {
+        abortHandler();
+        return;
+      }
+      signal.addEventListener("abort", abortHandler, { once: true });
+    });
+    return {
+      abortPromise,
+      cleanupAbortListener: () => {
+        if (abortHandler) {
+          signal.removeEventListener("abort", abortHandler);
+        }
+      }
+    };
+  }
+};
+
+export {
+  JobExecutionRuntime
+};
+//# sourceMappingURL=chunk-WOUYSNK2.js.map

package/build/chunk-WOUYSNK2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/job_runtime.ts"],"sourcesContent":["import * as errors from './exceptions.js'\nimport type { Job } from './job.js'\nimport type { Duration, JobContext, JobOptions, RetryConfig } from './types/main.js'\nimport { parse } from './utils.js'\n\nexport type JobExecutionOutcome =\n  | { type: 'completed' }\n  | { type: 'retry'; retryAt?: Date }\n  | {\n      type: 'failed'\n      reason: 'timeout' | 'no-retries' | 'max-attempts'\n      storageError: Error\n      hookError: Error\n    }\n\ntype JobExecutionRuntimeConfig = {\n  jobName: string\n  options?: JobOptions\n  retryConfig: RetryConfig\n  defaultTimeout?: Duration\n}\n\ntype JobExecutionRuntimeFactoryOptions = {\n  jobName: string\n  options?: JobOptions\n  retryConfig: RetryConfig\n  defaultTimeout?: Duration\n}\n\n/**\n * Shared execution policy for a single job runtime.\n *\n * It encapsulates timeout resolution and retry/failure decisions so the\n * worker and the sync adapter follow the same execution rules.\n */\nexport class JobExecutionRuntime {\n  readonly #jobName: string\n  readonly #options: JobOptions\n  readonly #retryConfig: RetryConfig\n  readonly #timeout?: number\n\n  /**\n   * Build a runtime from already-resolved queue/job execution config.\n   */\n  static from({\n    jobName,\n    options,\n    retryConfig,\n    defaultTimeout,\n  }: JobExecutionRuntimeFactoryOptions): JobExecutionRuntime {\n    return new JobExecutionRuntime({\n      jobName,\n      options,\n      retryConfig,\n      defaultTimeout,\n    })\n  }\n\n  get maxRetries(): number | undefined {\n    return this.#retryConfig.maxRetries\n  }\n\n  /**\n   * Create a runtime with fully resolved retry and timeout settings.\n   */\n  constructor({ jobName, options, retryConfig, defaultTimeout }: JobExecutionRuntimeConfig) {\n    this.#jobName = jobName\n    this.#options = options || {}\n    this.#retryConfig = retryConfig\n\n    const timeout = this.#options.timeout ?? defaultTimeout\n    this.#timeout = timeout === undefined ? undefined : parse(timeout)\n  }\n\n  /**\n   * Execute a hydrated job instance and enforce the configured timeout.\n   */\n  async execute(instance: Job, payload: unknown, context: JobContext): Promise<void> {\n    if (this.#timeout === undefined) {\n      instance.$hydrate(payload, context)\n      return instance.execute()\n    }\n\n    const signal = AbortSignal.timeout(this.#timeout)\n    instance.$hydrate(payload, context, signal)\n\n    const { abortPromise, cleanupAbortListener } = this.#createTimeoutAbortRace(\n      signal,\n      instance.constructor.name\n    )\n\n    try {\n      await Promise.race([instance.execute(), abortPromise])\n    } finally {\n      cleanupAbortListener()\n    }\n  }\n\n  /**\n   * Convert an execution error into a retry or permanent-failure outcome.\n   */\n  resolveFailure(error: Error, attempts: number): JobExecutionOutcome {\n    if (error instanceof errors.E_JOB_TIMEOUT && this.#options.failOnTimeout) {\n      return {\n        type: 'failed',\n        reason: 'timeout',\n        storageError: error,\n        hookError: error,\n      }\n    }\n\n    if (typeof this.#retryConfig.maxRetries === 'undefined' || this.#retryConfig.maxRetries <= 0) {\n      return {\n        type: 'failed',\n        reason: 'no-retries',\n        storageError: error,\n        hookError: error,\n      }\n    }\n\n    if (attempts >= this.#retryConfig.maxRetries) {\n      return {\n        type: 'failed',\n        reason: 'max-attempts',\n        storageError: error,\n        hookError: new errors.E_JOB_MAX_ATTEMPTS_REACHED([this.#jobName], { cause: error }),\n      }\n    }\n\n    if (this.#retryConfig.backoff) {\n      return {\n        type: 'retry',\n        retryAt: this.#retryConfig.backoff().getNextRetryAt(attempts + 1),\n      }\n    }\n\n    return { type: 'retry' }\n  }\n\n  /**\n   * Create the timeout race used to abort a job execution cleanly.\n   */\n  #createTimeoutAbortRace(signal: AbortSignal, runtimeJobName: string) {\n    const timeout = this.#timeout!\n    let abortHandler: (() => void) | undefined\n\n    const abortPromise = new Promise<never>((_, reject) => {\n      abortHandler = () => {\n        reject(new errors.E_JOB_TIMEOUT([runtimeJobName, timeout]))\n      }\n\n      if (signal.aborted) {\n        abortHandler()\n        return\n      }\n\n      signal.addEventListener('abort', abortHandler, { once: true })\n    })\n\n    return {\n      abortPromise,\n      cleanupAbortListener: () => {\n        if (abortHandler) {\n          signal.removeEventListener('abort', abortHandler)\n        }\n      },\n    }\n  }\n}\n"],"mappings":";;;;;;;AAmCO,IAAM,sBAAN,MAAM,qBAAoB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA,EAKT,OAAO,KAAK;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAA2D;AACzD,WAAO,IAAI,qBAAoB;AAAA,MAC7B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,aAAiC;AACnC,WAAO,KAAK,aAAa;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,EAAE,SAAS,SAAS,aAAa,eAAe,GAA8B;AACxF,SAAK,WAAW;AAChB,SAAK,WAAW,WAAW,CAAC;AAC5B,SAAK,eAAe;AAEpB,UAAM,UAAU,KAAK,SAAS,WAAW;AACzC,SAAK,WAAW,YAAY,SAAY,SAAY,MAAM,OAAO;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAQ,UAAe,SAAkB,SAAoC;AACjF,QAAI,KAAK,aAAa,QAAW;AAC/B,eAAS,SAAS,SAAS,OAAO;AAClC,aAAO,SAAS,QAAQ;AAAA,IAC1B;AAEA,UAAM,SAAS,YAAY,QAAQ,KAAK,QAAQ;AAChD,aAAS,SAAS,SAAS,SAAS,MAAM;AAE1C,UAAM,EAAE,cAAc,qBAAqB,IAAI,KAAK;AAAA,MAClD;AAAA,MACA,SAAS,YAAY;AAAA,IACvB;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,CAAC,SAAS,QAAQ,GAAG,YAAY,CAAC;AAAA,IACvD,UAAE;AACA,2BAAqB;AAAA,IACvB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,OAAc,UAAuC;AAClE,QAAI,iBAAwB,iBAAiB,KAAK,SAAS,eAAe;AACxE,aAAO;AAAA,QACL,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,WAAW;AAAA,MACb;AAAA,IACF;AAEA,QAAI,OAAO,KAAK,aAAa,eAAe,eAAe,KAAK,aAAa,cAAc,GAAG;AAC5F,aAAO;AAAA,QACL,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,WAAW;AAAA,MACb;AAAA,IACF;AAEA,QAAI,YAAY,KAAK,aAAa,YAAY;AAC5C,aAAO;AAAA,QACL,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,WAAW,IAAW,2BAA2B,CAAC,KAAK,QAAQ,GAAG,EAAE,OAAO,MAAM,CAAC;AAAA,MACpF;AAAA,IACF;AAEA,QAAI,KAAK,aAAa,SAAS;AAC7B,aAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS,KAAK,aAAa,QAAQ,EAAE,eAAe,WAAW,CAAC;AAAA,MAClE;AAAA,IACF;AAEA,WAAO,EAAE,MAAM,QAAQ;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,wBAAwB,QAAqB,gBAAwB;AACnE,UAAM,UAAU,KAAK;AACrB,QAAI;AAEJ,UAAM,eAAe,IAAI,QAAe,CAAC,GAAG,WAAW;AACrD,qBAAe,MAAM;AACnB,eAAO,IAAW,cAAc,CAAC,gBAAgB,OAAO,CAAC,CAAC;AAAA,MAC5D;AAEA,UAAI,OAAO,SAAS;AAClB,qBAAa;AACb;AAAA,MACF;AAEA,aAAO,iBAAiB,SAAS,cAAc,EAAE,MAAM,KAAK,CAAC;AAAA,IAC/D,CAAC;AAED,WAAO;AAAA,MACL;AAAA,MACA,sBAAsB,MAAM;AAC1B,YAAI,cAAc;AAChB,iBAAO,oBAAoB,SAAS,YAAY;AAAA,QAClD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}