@boringnode/queue 0.0.1-alpha

package/LICENSE.md

@@ -0,0 +1,9 @@
+# The MIT License
+
+Copyright 2025 Romain Lanz, contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/build/index.d.ts

@@ -0,0 +1,28 @@
+import { Q as QueueManagerConfig, W as WorkerCycle, A as Adapter, R as RetryConfig } from './job-CcAUWe8j.js';
+export { J as Job, c as customBackoff, e as exponentialBackoff, f as fixedBackoff, l as linearBackoff } from './job-CcAUWe8j.js';
+import './src/contracts/lease_manager.js';
+
+declare class Worker {
+    #private;
+    get id(): string;
+    constructor(config: QueueManagerConfig);
+    init(): Promise<void>;
+    start(queues?: string[]): Promise<void>;
+    stop(): Promise<void>;
+    processCycle(queues: string[]): Promise<WorkerCycle | null>;
+    process(queues: string[]): AsyncGenerator<WorkerCycle, void, unknown>;
+}
+
+declare class QueueManagerSingleton {
+    #private;
+    init(config: QueueManagerConfig): Promise<this>;
+    use(adapter?: string): Adapter;
+    /**
+     * Priority: job > queue > global
+     */
+    getMergedRetryConfig(queue: string, jobRetryConfig?: RetryConfig): RetryConfig;
+    destroy(): Promise<void>;
+}
+declare const QueueManager: QueueManagerSingleton;
+
+export { QueueManager, Worker };

package/build/index.js

@@ -0,0 +1,452 @@
+// src/job.ts
+import { JobDispatcher } from "#src/job_dispatcher";
+var Job = class {
+  #payload;
+  static options = {};
+  get payload() {
+    return this.#payload;
+  }
+  constructor(payload) {
+    this.#payload = payload;
+  }
+  static dispatch(payload) {
+    const dispatcher = new JobDispatcher(
+      this.jobName,
+      payload
+    );
+    if (this.options.queue) {
+      dispatcher.toQueue(this.options.queue);
+    }
+    if (this.options.adapter) {
+      dispatcher.with(this.options.adapter);
+    }
+    if (this.options.priority !== void 0) {
+      dispatcher.priority(this.options.priority);
+    }
+    return dispatcher;
+  }
+};
+
+// src/worker.ts
+import { randomUUID } from "crypto";
+import { setTimeout } from "timers/promises";
+import debug from "#src/debug";
+import { parse } from "#src/utils";
+import * as errors from "#src/exceptions";
+import { QueueManager } from "#src/queue_manager";
+import { Locator } from "#src/locator";
+var Worker = class {
+  #id;
+  #config;
+  #adapter;
+  #leaseManager;
+  #running = false;
+  #initialized = false;
+  #generator;
+  get id() {
+    return this.#id;
+  }
+  constructor(config) {
+    this.#config = config;
+    this.#id = randomUUID();
+    debug("created worker with id %s and config %O", this.#id, config);
+  }
+  async init() {
+    if (this.#initialized) {
+      return;
+    }
+    debug("initializing worker %s", this.#id);
+    await QueueManager.init(this.#config);
+    this.#adapter = QueueManager.use();
+    this.#leaseManager = this.#adapter.createLeaseManager({
+      workerId: this.#id,
+      leaseTimeout: parse(this.#config.worker?.leaseTimeout || "5m"),
+      renewalInterval: parse(this.#config.worker?.renewalInterval || "5m")
+    });
+    this.#initialized = true;
+    debug("worker %s initialized", this.#id);
+  }
+  async start(queues = ["default"]) {
+    await this.init();
+    if (this.#running) {
+      debug("worker %s is already running", this.#id);
+      return;
+    }
+    this.#running = true;
+    debug("starting worker %s on queues: %O", this.#id, queues);
+    await this.#setupGracefulShutdown();
+    for await (const cycle of this.process(queues)) {
+      if (["started", "completed"].includes(cycle.type)) {
+        continue;
+      }
+      if (["idle", "error"].includes(cycle.type)) {
+        const delay = parse(cycle.suggestedDelay);
+        if (cycle.type === "error") {
+          debug("worker %s encountered an error: %O", this.#id, cycle.error);
+        } else {
+          debug("worker %s is idle, waiting for %dms", this.#id, delay);
+        }
+        await setTimeout(delay);
+      }
+    }
+  }
+  async stop() {
+    debug("stopping worker %s", this.#id);
+    this.#running = false;
+    if (this.#leaseManager) {
+      await this.#leaseManager.destroy();
+    }
+    if (this.#adapter) {
+      await this.#adapter.destroy();
+    }
+  }
+  async processCycle(queues) {
+    await this.init();
+    this.#running = true;
+    if (!this.#generator) {
+      this.#generator = this.process(queues);
+    }
+    const result = await this.#generator.next();
+    if (result.done) {
+      this.#generator = void 0;
+      return null;
+    }
+    return result.value;
+  }
+  async *process(queues) {
+    const concurrency = this.#config.worker?.concurrency || 1;
+    runningLoop: while (this.#running) {
+      try {
+        for (const queue of queues) {
+          const jobs = await this.#acquireJobs(queue, concurrency);
+          if (jobs.length > 0) {
+            for (const job of jobs) {
+              yield { type: "started", queue, job };
+            }
+            const results = await Promise.allSettled(jobs.map((job) => this.#execute(job, queue)));
+            for (const job of jobs) {
+              yield { type: "completed", queue, job };
+            }
+            const hasError = results.some((r) => r.status === "rejected");
+            if (hasError) {
+              const error = results.find((r) => r.status === "rejected");
+              yield { type: "error", error: error.reason, suggestedDelay: parse("5s") };
+            }
+            continue runningLoop;
+          }
+        }
+        const pollingInterval = parse(this.#config.worker?.pollingInterval || "2s");
+        yield { type: "idle", suggestedDelay: pollingInterval };
+      } catch (error) {
+        yield { type: "error", error, suggestedDelay: parse("5s") };
+      }
+    }
+  }
+  async #execute(job, queue) {
+    const startTime = performance.now();
+    debug("worker %s: executing job %s (%s)", this.#id, job.id, job.name);
+    let JobClass;
+    try {
+      JobClass = Locator.getOrThrow(job.name);
+    } catch (error) {
+      debug("worker %s: job class %s not found for job %s", this.#id, job.name, job.id);
+      throw error;
+    }
+    const instance = new JobClass(job.payload);
+    const options = JobClass.options || {};
+    try {
+      await instance.execute();
+      await job._lease.commit();
+      const duration = (performance.now() - startTime).toFixed(2);
+      debug("worker %s: successfully executed job %s in %dms", this.#id, job.id, duration);
+    } catch (e) {
+      const mergedConfig = QueueManager.getMergedRetryConfig(queue, options.retry);
+      if (typeof mergedConfig.maxRetries === "undefined" || mergedConfig.maxRetries <= 0) {
+        debug("worker %s: job %s has no retries configured, marking as failed", this.#id, job.id);
+        await instance.failed(e);
+        return;
+      }
+      if (job.attempts >= mergedConfig.maxRetries) {
+        debug(
+          "worker %s: job %s has exceeded max retries (%d), marking as failed",
+          this.#id,
+          job.id,
+          mergedConfig.maxRetries
+        );
+        const exception = new errors.E_JOB_MAX_ATTEMPTS_REACHED([job.name]);
+        await instance.failed(exception);
+        return;
+      }
+      if (mergedConfig.backoff) {
+        const strategy = mergedConfig.backoff();
+        const nextRetryAt = strategy.getNextRetryAt(job.attempts + 1);
+        debug("worker %s: job %s will retry at %s", this.#id, job.id, nextRetryAt.toISOString());
+        await this.#rollbackJobWithBackoff(job, queue, nextRetryAt);
+        return;
+      }
+      await this.#rollbackJob(job, queue);
+    }
+  }
+  async #acquireJobs(queue, count) {
+    const jobs = [];
+    for (let i = 0; i < count; i++) {
+      const job = await this.#adapter.popFrom(queue);
+      if (!job) {
+        break;
+      }
+      debug("worker %s: attempting to acquire lease for job %s", this.#id, job.id);
+      try {
+        const acquired = await this.#leaseManager.acquire(job.id);
+        if (!acquired) {
+          debug("worker %s: failed to acquire lease for job %s", this.#id, job.id);
+          await this.#adapter.pushOn(queue, job);
+          continue;
+        }
+        debug("worker %s: acquired lease for job %s", this.#id, job.id);
+        jobs.push({
+          ...job,
+          _lease: {
+            commit: () => this.#commitJob(job.id),
+            rollback: () => this.#rollbackJob(job, queue)
+          }
+        });
+      } catch (error) {
+        console.log(error);
+        throw error;
+      }
+    }
+    return jobs;
+  }
+  #commitJob(jobId) {
+    debug("worker %s: committing job %s", this.#id, jobId);
+    return this.#leaseManager.release(jobId);
+  }
+  async #rollbackJob(job, queue) {
+    debug("worker %s: rolling back job %s", this.#id, job.id);
+    const updatedJob = {
+      ...job,
+      attempts: (job.attempts || 0) + 1
+    };
+    await Promise.all([this.#leaseManager.release(job.id), this.#adapter.pushOn(queue, updatedJob)]);
+  }
+  async #rollbackJobWithBackoff(job, queue, nextRetryAt) {
+    debug("worker %s: rolling back job %s with backoff", this.#id, job.id);
+    const updatedJob = {
+      ...job,
+      attempts: (job.attempts || 0) + 1,
+      nextRetryAt
+    };
+    await this.#leaseManager.release(job.id);
+    const delay = nextRetryAt.getTime() - Date.now();
+    if (delay > 0) {
+      await this.#adapter.pushLaterOn(queue, updatedJob, delay);
+    } else {
+      await this.#adapter.pushOn(queue, updatedJob);
+    }
+  }
+  async #setupGracefulShutdown() {
+    const shutdown = async () => {
+      debug("received shutdown signal, stopping worker...");
+      await this.stop();
+      process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+  }
+};
+
+// src/queue_manager.ts
+import * as errors2 from "#src/exceptions";
+import debug2 from "#src/debug";
+import { Locator as Locator2 } from "#src/locator";
+var QueueManagerSingleton = class {
+  #defaultAdapter;
+  #adapters = {};
+  #globalRetryConfig;
+  #queueConfigs = /* @__PURE__ */ new Map();
+  async init(config) {
+    debug2("initializing queue manager with config: %O", config);
+    this.#validateConfig(config);
+    this.#defaultAdapter = config.default;
+    this.#adapters = config.adapters;
+    this.#globalRetryConfig = config.retry;
+    if (config.queues) {
+      for (const [queue, queueConfig] of Object.entries(config.queues)) {
+        this.#queueConfigs.set(queue, queueConfig);
+      }
+    }
+    await Locator2.registerFromGlob(config.locations);
+    return this;
+  }
+  use(adapter) {
+    if (!adapter) {
+      adapter = this.#defaultAdapter;
+    }
+    const adapterInstance = this.#adapters[adapter];
+    if (!adapterInstance) {
+      throw new errors2.E_CONFIGURATION_ERROR([`Adapter "${adapter}" is not registered`]);
+    }
+    debug2('using adapter "%s"', adapter);
+    try {
+      return adapterInstance();
+    } catch (error) {
+      throw new Error();
+    }
+  }
+  /**
+   * Priority: job > queue > global
+   */
+  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 };
+  }
+  #validateConfig(config) {
+    if (!config.adapters || Object.keys(config.adapters).length === 0) {
+      throw new errors2.E_CONFIGURATION_ERROR(["At least one adapter must be configured"]);
+    }
+    if (!config.default) {
+      throw new errors2.E_CONFIGURATION_ERROR(["Default adapter must be specified"]);
+    }
+    if (!config.locations || config.locations.length === 0) {
+      throw new errors2.E_CONFIGURATION_ERROR(["Job locations must be specified"]);
+    }
+    if (!config.adapters[config.default]) {
+      throw new errors2.E_CONFIGURATION_ERROR([
+        `Default adapter "${config.default}" not found in adapters configuration`
+      ]);
+    }
+    for (const [name, factory] of Object.entries(config.adapters)) {
+      if (typeof factory !== "function") {
+        throw new errors2.E_CONFIGURATION_ERROR([`Adapter "${name}" must be a factory function`]);
+      }
+    }
+  }
+  async destroy() {
+    for (const adapterName in this.#adapters) {
+      const adapter = this.#adapters[adapterName]();
+      await adapter.destroy();
+    }
+  }
+};
+var QueueManager2 = new QueueManagerSingleton();
+
+// src/strategies/backoff_strategy.ts
+import * as errors3 from "#src/exceptions";
+import { parse as parse2 } from "#src/utils";
+import { RuntimeException } from "@poppinss/utils";
+import { assertUnreachable } from "@poppinss/utils/assert";
+var BackoffStrategy = class {
+  #config;
+  constructor(config) {
+    this.#config = config;
+    this.#validateConfig();
+  }
+  calculateDelay(attempt) {
+    if (attempt < 1) {
+      throw new RuntimeException("Attempt number must be >= 1");
+    }
+    const baseDelayMs = parse2(this.#config.baseDelay);
+    const maxDelayMs = this.#config.maxDelay ? parse2(this.#config.maxDelay) : Infinity;
+    const multiplier = this.#config.multiplier ?? 2;
+    let delay;
+    switch (this.#config.strategy) {
+      case "exponential":
+        delay = baseDelayMs * Math.pow(multiplier, attempt - 1);
+        break;
+      case "linear":
+        delay = baseDelayMs * attempt;
+        break;
+      case "fixed":
+        delay = baseDelayMs;
+        break;
+      default:
+        assertUnreachable(this.#config.strategy);
+    }
+    delay = Math.min(delay, maxDelayMs);
+    if (this.#config.jitter) {
+      delay = this.#applyJitter(delay);
+    }
+    return Math.floor(delay);
+  }
+  getNextRetryAt(attempt) {
+    const delay = this.calculateDelay(attempt);
+    return new Date(Date.now() + delay);
+  }
+  getConfig() {
+    return Object.freeze({ ...this.#config });
+  }
+  #validateConfig() {
+    const baseDelayMs = parse2(this.#config.baseDelay);
+    if (baseDelayMs <= 0) {
+      throw new errors3.E_INVALID_BASE_DELAY([
+        "Base delay must be a positive integer greater than zero"
+      ]);
+    }
+    if (this.#config.maxDelay) {
+      const maxDelayMs = parse2(this.#config.maxDelay);
+      if (maxDelayMs <= 0) {
+        throw new errors3.E_INVALID_MAX_DELAY([
+          "Max delay must be a positive integer greater than zero"
+        ]);
+      }
+      if (maxDelayMs <= baseDelayMs) {
+        throw new errors3.E_INVALID_MAX_DELAY(["Max delay should be greater than base delay"]);
+      }
+    }
+    if (this.#config.multiplier !== void 0) {
+      if (this.#config.multiplier <= 0) {
+        throw new errors3.E_INVALID_MULTIPLIER([
+          "Multiplier must be a positive number greater than zero"
+        ]);
+      }
+      if (this.#config.strategy === "exponential" && this.#config.multiplier < 1) {
+        throw new errors3.E_INVALID_MULTIPLIER(["Exponential strategy multiplier should be >= 1"]);
+      }
+    }
+  }
+  #applyJitter(delay) {
+    const jitterRange = delay * 0.25;
+    const jitter = (Math.random() - 0.5) * 2 * jitterRange;
+    return Math.max(0, delay + jitter);
+  }
+};
+function exponentialBackoff(config) {
+  return () => new BackoffStrategy({
+    strategy: "exponential",
+    baseDelay: "1s",
+    maxDelay: "5m",
+    multiplier: 2,
+    jitter: true,
+    ...config
+  });
+}
+function linearBackoff(config) {
+  return () => new BackoffStrategy({
+    strategy: "linear",
+    baseDelay: "5s",
+    maxDelay: "2m",
+    ...config
+  });
+}
+function fixedBackoff(delay = "10s") {
+  return () => new BackoffStrategy({
+    strategy: "fixed",
+    baseDelay: delay
+  });
+}
+function customBackoff(config) {
+  return () => new BackoffStrategy(config);
+}
+export {
+  Job,
+  QueueManager2 as QueueManager,
+  Worker,
+  customBackoff,
+  exponentialBackoff,
+  fixedBackoff,
+  linearBackoff
+};
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/job.ts","../src/worker.ts","../src/queue_manager.ts","../src/strategies/backoff_strategy.ts"],"sourcesContent":["import { JobDispatcher } from '#src/job_dispatcher'\nimport type { JobOptions } from '#types/main'\n\nexport abstract class Job<Payload = any> {\n  readonly #payload: Payload\n\n  static options: JobOptions = {}\n\n  get payload(): Payload {\n    return this.#payload\n  }\n\n  constructor(payload: Payload) {\n    this.#payload = payload\n  }\n\n  static dispatch<T extends Job>(\n    this: new (payload: any) => T,\n    payload: T extends Job<infer P> ? P : never\n  ): JobDispatcher<T extends Job<infer P> ? P : never> {\n    const dispatcher = new JobDispatcher<T extends Job<infer P> ? P : never>(\n      (this as any).jobName,\n      payload\n    )\n\n    if ((this as any).options.queue) {\n      dispatcher.toQueue((this as any).options.queue)\n    }\n\n    if ((this as any).options.adapter) {\n      dispatcher.with((this as any).options.adapter)\n    }\n\n    if ((this as any).options.priority !== undefined) {\n      dispatcher.priority((this as any).options.priority)\n    }\n\n    return dispatcher\n  }\n\n  abstract execute(): Promise<void>\n\n  failed?(error: Error): Promise<void>\n}\n","import { randomUUID } from 'node:crypto'\nimport { setTimeout } from 'node:timers/promises'\nimport debug from '#src/debug'\nimport { parse } from '#src/utils'\nimport * as errors from '#src/exceptions'\nimport { QueueManager } from '#src/queue_manager'\nimport type { Adapter } from '#contracts/adapter'\nimport type { LeaseManager } from '#contracts/lease_manager'\nimport type { AcquiredJob, JobData, QueueManagerConfig, WorkerCycle } from '#types/main'\nimport { Locator } from '#src/locator'\nimport type { JobOptions } from '#types/main'\n\nexport class Worker {\n  readonly #id: string\n  readonly #config: QueueManagerConfig\n  #adapter!: Adapter\n  #leaseManager!: LeaseManager\n  #running = false\n  #initialized = false\n  #generator?: AsyncGenerator<WorkerCycle, void, unknown>\n\n  get id() {\n    return this.#id\n  }\n\n  constructor(config: QueueManagerConfig) {\n    this.#config = config\n    this.#id = randomUUID()\n\n    debug('created worker with id %s and config %O', this.#id, config)\n  }\n\n  async init() {\n    if (this.#initialized) {\n      return\n    }\n\n    debug('initializing worker %s', this.#id)\n\n    await QueueManager.init(this.#config)\n\n    this.#adapter = QueueManager.use()\n    this.#leaseManager = this.#adapter.createLeaseManager({\n      workerId: this.#id,\n      leaseTimeout: parse(this.#config.worker?.leaseTimeout || '5m'),\n      renewalInterval: parse(this.#config.worker?.renewalInterval || '5m'),\n    })\n\n    this.#initialized = true\n\n    debug('worker %s initialized', this.#id)\n  }\n\n  async start(queues: string[] = ['default']): Promise<void> {\n    await this.init()\n\n    if (this.#running) {\n      debug('worker %s is already running', this.#id)\n      return\n    }\n\n    this.#running = true\n\n    debug('starting worker %s on queues: %O', this.#id, queues)\n\n    await this.#setupGracefulShutdown()\n\n    for await (const cycle of this.process(queues)) {\n      if (['started', 'completed'].includes(cycle.type)) {\n        continue\n      }\n\n      if (['idle', 'error'].includes(cycle.type)) {\n        // @ts-expect-error - we know suggestedDelay exists for these types\n        const delay = parse(cycle.suggestedDelay)\n\n        if (cycle.type === 'error') {\n          debug('worker %s encountered an error: %O', this.#id, cycle.error)\n        } else {\n          debug('worker %s is idle, waiting for %dms', this.#id, delay)\n        }\n\n        await setTimeout(delay)\n      }\n    }\n  }\n\n  async stop() {\n    debug('stopping worker %s', this.#id)\n\n    this.#running = false\n\n    if (this.#leaseManager) {\n      await this.#leaseManager.destroy()\n    }\n\n    if (this.#adapter) {\n      await this.#adapter.destroy()\n    }\n  }\n\n  async processCycle(queues: string[]): Promise<WorkerCycle | null> {\n    await this.init()\n\n    this.#running = true\n\n    if (!this.#generator) {\n      this.#generator = this.process(queues)\n    }\n\n    const result = await this.#generator.next()\n\n    if (result.done) {\n      this.#generator = undefined\n      return null\n    }\n\n    return result.value\n  }\n\n  async *process(queues: string[]): AsyncGenerator<WorkerCycle, void, unknown> {\n    const concurrency = this.#config.worker?.concurrency || 1\n\n    runningLoop: while (this.#running) {\n      try {\n        for (const queue of queues) {\n          const jobs = await this.#acquireJobs(queue, concurrency)\n\n          if (jobs.length > 0) {\n            // Yield started events for all jobs\n            for (const job of jobs) {\n              yield { type: 'started', queue, job }\n            }\n\n            // Execute all jobs in parallel\n            const results = await Promise.allSettled(jobs.map((job) => this.#execute(job, queue)))\n\n            // Yield completed events for all jobs\n            for (const job of jobs) {\n              yield { type: 'completed', queue, job: job }\n            }\n\n            // Check if any job failed\n            const hasError = results.some((r) => r.status === 'rejected')\n            if (hasError) {\n              const error = results.find((r) => r.status === 'rejected') as PromiseRejectedResult\n              yield { type: 'error', error: error.reason, suggestedDelay: parse('5s') }\n            }\n\n            continue runningLoop\n          }\n        }\n\n        const pollingInterval = parse(this.#config.worker?.pollingInterval || '2s')\n        yield { type: 'idle', suggestedDelay: pollingInterval }\n      } catch (error) {\n        yield { type: 'error', error: error as Error, suggestedDelay: parse('5s') }\n      }\n    }\n  }\n\n  async #execute(job: AcquiredJob, queue: string): Promise<void> {\n    const startTime = performance.now()\n\n    debug('worker %s: executing job %s (%s)', this.#id, job.id, job.name)\n\n    let JobClass: any\n\n    try {\n      JobClass = Locator.getOrThrow(job.name)\n    } catch (error) {\n      debug('worker %s: job class %s not found for job %s', this.#id, job.name, job.id)\n      throw error\n    }\n\n    const instance = new JobClass(job.payload)\n    const options: JobOptions = JobClass.options || {}\n\n    try {\n      await instance.execute()\n      await job._lease.commit()\n\n      const duration = (performance.now() - startTime).toFixed(2)\n      debug('worker %s: successfully executed job %s in %dms', this.#id, job.id, duration)\n    } catch (e) {\n      const mergedConfig = QueueManager.getMergedRetryConfig(queue, options.retry)\n\n      if (typeof mergedConfig.maxRetries === 'undefined' || mergedConfig.maxRetries <= 0) {\n        debug('worker %s: job %s has no retries configured, marking as failed', this.#id, job.id)\n\n        await instance.failed(e as Error)\n        return\n      }\n\n      if (job.attempts >= mergedConfig.maxRetries!) {\n        debug(\n          'worker %s: job %s has exceeded max retries (%d), marking as failed',\n          this.#id,\n          job.id,\n          mergedConfig.maxRetries\n        )\n\n        const exception = new errors.E_JOB_MAX_ATTEMPTS_REACHED([job.name])\n        await instance.failed(exception)\n\n        return\n      }\n\n      if (mergedConfig.backoff) {\n        const strategy = mergedConfig.backoff()\n        const nextRetryAt = strategy.getNextRetryAt(job.attempts + 1)\n\n        debug('worker %s: job %s will retry at %s', this.#id, job.id, nextRetryAt.toISOString())\n\n        await this.#rollbackJobWithBackoff(job, queue, nextRetryAt)\n\n        return\n      }\n\n      await this.#rollbackJob(job, queue)\n    }\n  }\n\n  async #acquireJobs(queue: string, count: number): Promise<AcquiredJob[]> {\n    const jobs: AcquiredJob[] = []\n\n    // Try to acquire up to `count` jobs\n    for (let i = 0; i < count; i++) {\n      const job = await this.#adapter.popFrom(queue)\n\n      if (!job) {\n        break\n      }\n\n      debug('worker %s: attempting to acquire lease for job %s', this.#id, job.id)\n\n      try {\n        const acquired = await this.#leaseManager.acquire(job.id)\n\n        if (!acquired) {\n          debug('worker %s: failed to acquire lease for job %s', this.#id, job.id)\n\n          await this.#adapter.pushOn(queue, job)\n          continue\n        }\n\n        debug('worker %s: acquired lease for job %s', this.#id, job.id)\n\n        jobs.push({\n          ...job,\n          _lease: {\n            commit: () => this.#commitJob(job.id),\n            rollback: () => this.#rollbackJob(job, queue),\n          },\n        })\n      } catch (error) {\n        console.log(error)\n        throw error\n      }\n    }\n\n    return jobs\n  }\n\n  #commitJob(jobId: string) {\n    debug('worker %s: committing job %s', this.#id, jobId)\n    return this.#leaseManager.release(jobId)\n  }\n\n  async #rollbackJob(job: JobData, queue: string) {\n    debug('worker %s: rolling back job %s', this.#id, job.id)\n\n    const updatedJob = {\n      ...job,\n      attempts: (job.attempts || 0) + 1,\n    }\n\n    await Promise.all([this.#leaseManager.release(job.id), this.#adapter.pushOn(queue, updatedJob)])\n  }\n\n  async #rollbackJobWithBackoff(job: JobData, queue: string, nextRetryAt: Date) {\n    debug('worker %s: rolling back job %s with backoff', this.#id, job.id)\n\n    const updatedJob = {\n      ...job,\n      attempts: (job.attempts || 0) + 1,\n      nextRetryAt,\n    }\n\n    await this.#leaseManager.release(job.id)\n\n    const delay = nextRetryAt.getTime() - Date.now()\n\n    if (delay > 0) {\n      await this.#adapter.pushLaterOn(queue, updatedJob, delay)\n    } else {\n      await this.#adapter.pushOn(queue, updatedJob)\n    }\n  }\n\n  async #setupGracefulShutdown() {\n    const shutdown = async () => {\n      debug('received shutdown signal, stopping worker...')\n      await this.stop()\n      process.exit(0)\n    }\n\n    process.on('SIGINT', shutdown)\n    process.on('SIGTERM', shutdown)\n  }\n}\n","import * as errors from '#src/exceptions'\nimport debug from '#src/debug'\nimport { Locator } from '#src/locator'\nimport type { Adapter } from '#contracts/adapter'\nimport type { AdapterFactory, QueueConfig, QueueManagerConfig, RetryConfig } from '#types/main'\n\nclass QueueManagerSingleton {\n  #defaultAdapter!: string\n  #adapters: Record<string, AdapterFactory> = {}\n  #globalRetryConfig?: RetryConfig\n  #queueConfigs: Map<string, QueueConfig> = new Map()\n\n  async init(config: QueueManagerConfig) {\n    debug('initializing queue manager with config: %O', config)\n\n    this.#validateConfig(config)\n\n    this.#defaultAdapter = config.default\n    this.#adapters = config.adapters\n    this.#globalRetryConfig = config.retry\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    await Locator.registerFromGlob(config.locations)\n\n    return this\n  }\n\n  use(adapter?: string): Adapter {\n    if (!adapter) {\n      adapter = this.#defaultAdapter\n    }\n\n    const adapterInstance = this.#adapters[adapter]\n\n    if (!adapterInstance) {\n      throw new errors.E_CONFIGURATION_ERROR([`Adapter \"${adapter}\" is not registered`])\n    }\n\n    debug('using adapter \"%s\"', adapter)\n\n    try {\n      return adapterInstance()\n    } catch (error) {\n      // TODO: Improve error handling\n      throw new Error()\n      // throw new errors.E_ADAPTER_ERROR(`Failed to initialize adapter \"${adapter}\"`, error as Error)\n    }\n  }\n\n  /**\n   * Priority: job > queue > global\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  #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.locations || config.locations.length === 0) {\n      throw new errors.E_CONFIGURATION_ERROR(['Job locations 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  async destroy() {\n    for (const adapterName in this.#adapters) {\n      const adapter = this.#adapters[adapterName]()\n      await adapter.destroy()\n    }\n  }\n}\n\nexport const QueueManager = new QueueManagerSingleton()\n","import type { BackoffConfig, Duration } from '#types/main'\nimport * as errors from '#src/exceptions'\nimport { parse } from '#src/utils'\nimport { RuntimeException } from '@poppinss/utils'\nimport { assertUnreachable } from '@poppinss/utils/assert'\n\nexport class BackoffStrategy {\n  readonly #config: BackoffConfig\n\n  constructor(config: BackoffConfig) {\n    this.#config = config\n    this.#validateConfig()\n  }\n\n  calculateDelay(attempt: number): number {\n    if (attempt < 1) {\n      throw new RuntimeException('Attempt number must be >= 1')\n    }\n\n    const baseDelayMs = parse(this.#config.baseDelay)\n    const maxDelayMs = this.#config.maxDelay ? parse(this.#config.maxDelay) : Infinity\n    const multiplier = this.#config.multiplier ?? 2\n\n    let delay: number\n\n    switch (this.#config.strategy) {\n      case 'exponential':\n        delay = baseDelayMs * Math.pow(multiplier, attempt - 1)\n        break\n      case 'linear':\n        delay = baseDelayMs * attempt\n        break\n      case 'fixed':\n        delay = baseDelayMs\n        break\n      default:\n        assertUnreachable(this.#config.strategy)\n    }\n\n    // Apply max delay limit\n    delay = Math.min(delay, maxDelayMs)\n\n    if (this.#config.jitter) {\n      delay = this.#applyJitter(delay)\n    }\n\n    return Math.floor(delay)\n  }\n\n  getNextRetryAt(attempt: number): Date {\n    const delay = this.calculateDelay(attempt)\n    return new Date(Date.now() + delay)\n  }\n\n  getConfig(): Readonly<BackoffConfig> {\n    return Object.freeze({ ...this.#config })\n  }\n\n  #validateConfig() {\n    const baseDelayMs = parse(this.#config.baseDelay)\n\n    if (baseDelayMs <= 0) {\n      throw new errors.E_INVALID_BASE_DELAY([\n        'Base delay must be a positive integer greater than zero',\n      ])\n    }\n\n    if (this.#config.maxDelay) {\n      const maxDelayMs = parse(this.#config.maxDelay)\n\n      if (maxDelayMs <= 0) {\n        throw new errors.E_INVALID_MAX_DELAY([\n          'Max delay must be a positive integer greater than zero',\n        ])\n      }\n\n      if (maxDelayMs <= baseDelayMs) {\n        throw new errors.E_INVALID_MAX_DELAY(['Max delay should be greater than base delay'])\n      }\n    }\n\n    if (this.#config.multiplier !== undefined) {\n      if (this.#config.multiplier <= 0) {\n        throw new errors.E_INVALID_MULTIPLIER([\n          'Multiplier must be a positive number greater than zero',\n        ])\n      }\n\n      if (this.#config.strategy === 'exponential' && this.#config.multiplier < 1) {\n        throw new errors.E_INVALID_MULTIPLIER(['Exponential strategy multiplier should be >= 1'])\n      }\n    }\n  }\n\n  #applyJitter(delay: number): number {\n    const jitterRange = delay * 0.25\n    const jitter = (Math.random() - 0.5) * 2 * jitterRange\n\n    return Math.max(0, delay + jitter)\n  }\n}\n\nexport function exponentialBackoff(config?: Partial<Omit<BackoffConfig, 'strategy'>>) {\n  return () =>\n    new BackoffStrategy({\n      strategy: 'exponential',\n      baseDelay: '1s',\n      maxDelay: '5m',\n      multiplier: 2,\n      jitter: true,\n      ...config,\n    })\n}\n\nexport function linearBackoff(config?: Partial<Omit<BackoffConfig, 'strategy'>>) {\n  return () =>\n    new BackoffStrategy({\n      strategy: 'linear',\n      baseDelay: '5s',\n      maxDelay: '2m',\n      ...config,\n    })\n}\n\nexport function fixedBackoff(delay: Duration = '10s') {\n  return () =>\n    new BackoffStrategy({\n      strategy: 'fixed',\n      baseDelay: delay,\n    })\n}\n\nexport function customBackoff(config: BackoffConfig) {\n  return () => new BackoffStrategy(config)\n}\n"],"mappings":"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","names":["errors","debug","Locator","QueueManager","errors","parse"]}

package/build/job-CcAUWe8j.d.ts

@@ -0,0 +1,125 @@
+import { LeaseManager } from './src/contracts/lease_manager.js';
+
+declare class BackoffStrategy$1 {
+    #private;
+    constructor(config: BackoffConfig);
+    calculateDelay(attempt: number): number;
+    getNextRetryAt(attempt: number): Date;
+    getConfig(): Readonly<BackoffConfig>;
+}
+declare function exponentialBackoff(config?: Partial<Omit<BackoffConfig, 'strategy'>>): () => BackoffStrategy$1;
+declare function linearBackoff(config?: Partial<Omit<BackoffConfig, 'strategy'>>): () => BackoffStrategy$1;
+declare function fixedBackoff(delay?: Duration): () => BackoffStrategy$1;
+declare function customBackoff(config: BackoffConfig): () => BackoffStrategy$1;
+
+type Duration = number | string;
+interface AcquiredJob extends JobData {
+    _lease: {
+        commit: () => Promise<void>;
+        rollback: () => Promise<void>;
+    };
+}
+interface JobData {
+    id: string;
+    name: string;
+    payload: any;
+    attempts: number;
+    priority?: number;
+    nextRetryAt?: Date;
+}
+interface JobOptions {
+    queue?: string;
+    adapter?: string | (() => Adapter);
+    maxRetries?: number;
+    priority?: number;
+    retry?: RetryConfig;
+}
+type JobClass<T extends Job = Job> = new (payload: any) => T;
+interface RetryConfig {
+    maxRetries?: number;
+    backoff?: () => BackoffStrategy$1;
+}
+type BackoffStrategy = 'exponential' | 'linear' | 'fixed';
+interface BackoffConfig {
+    strategy: BackoffStrategy;
+    baseDelay: Duration;
+    maxDelay?: Duration;
+    multiplier?: number;
+    jitter?: boolean;
+}
+interface LeaseConfig {
+    workerId: string;
+    leaseTimeout: Duration;
+    renewalInterval: Duration;
+}
+interface QueueConfig {
+    adapter?: string;
+    retry?: any;
+}
+interface WorkerConfig {
+    concurrency?: number;
+    pollingInterval?: Duration;
+    leaseTimeout?: Duration;
+    renewalInterval?: Duration;
+}
+type WorkerCycle = {
+    type: 'started';
+    queue: string;
+    job: any;
+} | {
+    type: 'completed';
+    queue: string;
+    job: any;
+} | {
+    type: 'idle';
+    suggestedDelay: Duration;
+} | {
+    type: 'error';
+    error: Error;
+    suggestedDelay: Duration;
+};
+type AdapterFactory<T extends Adapter = Adapter> = () => T;
+interface QueueManagerConfig {
+    default: string;
+    adapters: Record<string, AdapterFactory>;
+    retry?: RetryConfig;
+    queues?: Record<string, QueueConfig>;
+    worker?: WorkerConfig;
+    locations: string[];
+}
+
+interface Adapter {
+    createLeaseManager(config: LeaseConfig): LeaseManager;
+    size(): Promise<number>;
+    sizeOf(queue: string): Promise<number>;
+    push(jobData: JobData): Promise<void>;
+    pushOn(queue: string, jobData: JobData): Promise<void>;
+    pushLater(jobData: JobData, delay: number): Promise<void>;
+    pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void>;
+    pop(): Promise<JobData | null>;
+    popFrom(queue: string): Promise<JobData | null>;
+    destroy(): Promise<void>;
+}
+
+declare class JobDispatcher<T> {
+    #private;
+    constructor(name: string, payload: T);
+    toQueue(queue: string): this;
+    in(delay: Duration): this;
+    priority(priority: number): this;
+    with(adapter: string | (() => Adapter)): this;
+    run(): Promise<`${string}-${string}-${string}-${string}-${string}`>;
+    then(onFulfilled?: (value: string) => any, onRejected?: (reason: any) => any): Promise<any>;
+}
+
+declare abstract class Job<Payload = any> {
+    #private;
+    static options: JobOptions;
+    get payload(): Payload;
+    constructor(payload: Payload);
+    static dispatch<T extends Job>(this: new (payload: any) => T, payload: T extends Job<infer P> ? P : never): JobDispatcher<T extends Job<infer P> ? P : never>;
+    abstract execute(): Promise<void>;
+    failed?(error: Error): Promise<void>;
+}
+
+export { type Adapter as A, type BackoffStrategy as B, type Duration as D, Job as J, type LeaseConfig as L, type QueueManagerConfig as Q, type RetryConfig as R, type WorkerCycle as W, type JobData as a, type AcquiredJob as b, customBackoff as c, type JobOptions as d, exponentialBackoff as e, fixedBackoff as f, type JobClass as g, type BackoffConfig as h, type QueueConfig as i, type WorkerConfig as j, type AdapterFactory as k, linearBackoff as l };

package/build/src/contracts/adapter.d.ts

@@ -0,0 +1,2 @@
+import './lease_manager.js';
+export { A as Adapter } from '../../job-CcAUWe8j.js';

package/build/src/contracts/adapter.js

@@ -0,0 +1 @@
+//# sourceMappingURL=adapter.js.map

package/build/src/contracts/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/build/src/contracts/lease_manager.d.ts

@@ -0,0 +1,8 @@
+interface LeaseManager {
+    acquire(jobId: string): Promise<boolean>;
+    renew(jobId: string): Promise<boolean>;
+    release(jobId: string): Promise<void>;
+    destroy(): Promise<void>;
+}
+
+export type { LeaseManager };

package/build/src/contracts/lease_manager.js

@@ -0,0 +1 @@
+//# sourceMappingURL=lease_manager.js.map

package/build/src/contracts/lease_manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/build/src/drivers/redis_adapter.d.ts

@@ -0,0 +1,22 @@
+import { Redis, RedisOptions } from 'ioredis';
+import { A as Adapter, L as LeaseConfig, a as JobData } from '../../job-CcAUWe8j.js';
+import { LeaseManager } from '../contracts/lease_manager.js';
+
+type RedisConfig = Redis | RedisOptions;
+declare function redis(config?: RedisConfig): () => RedisAdapter;
+declare class RedisAdapter implements Adapter {
+    #private;
+    constructor(connection: Redis);
+    createLeaseManager(config: LeaseConfig): LeaseManager;
+    destroy(): Promise<void>;
+    pop(): Promise<JobData | null>;
+    popFrom(queue: string): Promise<JobData | null>;
+    push(jobData: JobData): Promise<void>;
+    pushLater(jobData: JobData, delay: number): Promise<void>;
+    pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void>;
+    pushOn(queue: string, jobData: JobData): Promise<void>;
+    size(): Promise<number>;
+    sizeOf(queue: string): Promise<number>;
+}
+
+export { RedisAdapter, redis };

package/build/src/drivers/redis_adapter.js

@@ -0,0 +1,107 @@
+// src/drivers/redis_adapter.ts
+import { VerrouLeaseManager } from "#lease_managers/verrou";
+import { Redis } from "ioredis";
+var redisKey = "jobs";
+var PROCESS_DELAYED_JOBS_SCRIPT = `
+  local delayed_key = KEYS[1]
+  local queue_key = KEYS[2]
+  local now = ARGV[1]
+
+  -- Get ready jobs (score <= now)
+  local ready_jobs = redis.call('ZRANGEBYSCORE', delayed_key, 0, now)
+
+  if #ready_jobs > 0 then
+    -- Move jobs to priority queue and remove from delayed queue atomically
+    for i = 1, #ready_jobs do
+      local job_data = ready_jobs[i]
+      local job = cjson.decode(job_data)
+      local priority = job.priority or 5
+      redis.call('ZADD', queue_key, priority, job_data)
+      redis.call('ZREM', delayed_key, job_data)
+    end
+
+    return #ready_jobs
+  end
+
+  return 0
+`;
+function redis(config) {
+  return () => {
+    if (config instanceof Redis) {
+      return new RedisAdapter(config);
+    }
+    const options = {
+      host: "localhost",
+      port: 6379,
+      keyPrefix: "boringnode::queue::",
+      db: 0,
+      ...config
+    };
+    const connection = new Redis(options);
+    return new RedisAdapter(connection);
+  };
+}
+var RedisAdapter = class {
+  #connection;
+  constructor(connection) {
+    this.#connection = connection;
+  }
+  createLeaseManager(config) {
+    return new VerrouLeaseManager(config, this.#connection);
+  }
+  async destroy() {
+    await this.#connection.quit();
+  }
+  pop() {
+    return this.popFrom("default");
+  }
+  async popFrom(queue) {
+    await this.#processDelayedJobs(queue);
+    const queueContent = await this.#connection.zpopmin(`${redisKey}::${queue}`);
+    if (queueContent && queueContent.length > 0) {
+      return JSON.parse(queueContent[0]);
+    }
+    return null;
+  }
+  push(jobData) {
+    return this.pushOn("default", jobData);
+  }
+  pushLater(jobData, delay) {
+    return this.pushLaterOn("default", jobData, delay);
+  }
+  async pushLaterOn(queue, jobData, delay) {
+    const executeAt = Date.now() + delay;
+    const delayedKey = `${redisKey}::delayed::${queue}`;
+    await this.#connection.zadd(delayedKey, executeAt, JSON.stringify(jobData));
+  }
+  async pushOn(queue, jobData) {
+    const priority = jobData.priority ?? 5;
+    const timestamp = Date.now();
+    const score = priority * 1e13 + timestamp;
+    await this.#connection.zadd(`${redisKey}::${queue}`, score, JSON.stringify(jobData));
+  }
+  size() {
+    return this.sizeOf("default");
+  }
+  sizeOf(queue) {
+    return this.#connection.zcard(`${redisKey}::${queue}`);
+  }
+  async #processDelayedJobs(queue) {
+    const now = Date.now();
+    const delayedKey = `${redisKey}::delayed::${queue}`;
+    const queueKey = `${redisKey}::${queue}`;
+    return await this.#connection.eval(
+      PROCESS_DELAYED_JOBS_SCRIPT,
+      2,
+      // number of keys
+      delayedKey,
+      queueKey,
+      now.toString()
+    );
+  }
+};
+export {
+  RedisAdapter,
+  redis
+};
+//# sourceMappingURL=redis_adapter.js.map

package/build/src/drivers/redis_adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/drivers/redis_adapter.ts"],"sourcesContent":["import { VerrouLeaseManager } from '#lease_managers/verrou'\nimport { Redis, type RedisOptions } from 'ioredis'\nimport type { Adapter } from '#contracts/adapter'\nimport type { JobData, LeaseConfig } from '#types/main'\nimport type { LeaseManager } from '#contracts/lease_manager'\n\nconst redisKey = 'jobs'\ntype RedisConfig = Redis | RedisOptions\n\n// Lua script for atomic delayed job processing\nconst PROCESS_DELAYED_JOBS_SCRIPT = `\n  local delayed_key = KEYS[1]\n  local queue_key = KEYS[2]\n  local now = ARGV[1]\n\n  -- Get ready jobs (score <= now)\n  local ready_jobs = redis.call('ZRANGEBYSCORE', delayed_key, 0, now)\n\n  if #ready_jobs > 0 then\n    -- Move jobs to priority queue and remove from delayed queue atomically\n    for i = 1, #ready_jobs do\n      local job_data = ready_jobs[i]\n      local job = cjson.decode(job_data)\n      local priority = job.priority or 5\n      redis.call('ZADD', queue_key, priority, job_data)\n      redis.call('ZREM', delayed_key, job_data)\n    end\n\n    return #ready_jobs\n  end\n\n  return 0\n`\n\nexport function redis(config?: RedisConfig) {\n  return () => {\n    if (config instanceof Redis) {\n      return new RedisAdapter(config)\n    }\n\n    // Create new Redis instance from options\n    const options: RedisOptions = {\n      host: 'localhost',\n      port: 6379,\n      keyPrefix: 'boringnode::queue::',\n      db: 0,\n      ...config,\n    }\n\n    const connection = new Redis(options)\n    return new RedisAdapter(connection)\n  }\n}\n\nexport class RedisAdapter implements Adapter {\n  readonly #connection: Redis\n\n  constructor(connection: Redis) {\n    this.#connection = connection\n  }\n\n  createLeaseManager(config: LeaseConfig): LeaseManager {\n    return new VerrouLeaseManager(config, this.#connection)\n  }\n\n  async destroy(): Promise<void> {\n    await this.#connection.quit()\n  }\n\n  pop(): Promise<JobData | null> {\n    return this.popFrom('default')\n  }\n\n  async popFrom(queue: string): Promise<JobData | null> {\n    // First, move any ready delayed jobs to the regular queue\n    await this.#processDelayedJobs(queue)\n\n    // Pop from priority queue (sorted set) - highest priority (lowest score) first\n    const queueContent = await this.#connection.zpopmin(`${redisKey}::${queue}`)\n\n    if (queueContent && queueContent.length > 0) {\n      return JSON.parse(queueContent[0])\n    }\n\n    return null\n  }\n\n  push(jobData: JobData): Promise<void> {\n    return this.pushOn('default', jobData)\n  }\n\n  pushLater(jobData: JobData, delay: number): Promise<void> {\n    return this.pushLaterOn('default', jobData, delay)\n  }\n\n  async pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void> {\n    const executeAt = Date.now() + delay\n    const delayedKey = `${redisKey}::delayed::${queue}`\n\n    await this.#connection.zadd(delayedKey, executeAt, JSON.stringify(jobData))\n  }\n\n  async pushOn(queue: string, jobData: JobData): Promise<void> {\n    const priority = jobData.priority ?? 5\n\n    // Use priority as primary score, add timestamp for FIFO order within same priority\n    // Date.now() precision is sufficient but perfect FIFO within the same millisecond is not guaranteed\n    const timestamp = Date.now()\n    const score = priority * 1e13 + timestamp\n\n    await this.#connection.zadd(`${redisKey}::${queue}`, score, JSON.stringify(jobData))\n  }\n\n  size(): Promise<number> {\n    return this.sizeOf('default')\n  }\n\n  sizeOf(queue: string): Promise<number> {\n    return this.#connection.zcard(`${redisKey}::${queue}`)\n  }\n\n  async #processDelayedJobs(queue: string): Promise<number> {\n    const now = Date.now()\n    const delayedKey = `${redisKey}::delayed::${queue}`\n    const queueKey = `${redisKey}::${queue}`\n\n    // Use Lua script for atomic operation - much faster than pipeline\n    return (await this.#connection.eval(\n      PROCESS_DELAYED_JOBS_SCRIPT,\n      2, // number of keys\n      delayedKey,\n      queueKey,\n      now.toString()\n    )) as number\n  }\n}\n"],"mappings":";AAAA,SAAS,0BAA0B;AACnC,SAAS,aAAgC;AAKzC,IAAM,WAAW;AAIjB,IAAM,8BAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwB7B,SAAS,MAAM,QAAsB;AAC1C,SAAO,MAAM;AACX,QAAI,kBAAkB,OAAO;AAC3B,aAAO,IAAI,aAAa,MAAM;AAAA,IAChC;AAGA,UAAM,UAAwB;AAAA,MAC5B,MAAM;AAAA,MACN,MAAM;AAAA,MACN,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,GAAG;AAAA,IACL;AAEA,UAAM,aAAa,IAAI,MAAM,OAAO;AACpC,WAAO,IAAI,aAAa,UAAU;AAAA,EACpC;AACF;AAEO,IAAM,eAAN,MAAsC;AAAA,EAClC;AAAA,EAET,YAAY,YAAmB;AAC7B,SAAK,cAAc;AAAA,EACrB;AAAA,EAEA,mBAAmB,QAAmC;AACpD,WAAO,IAAI,mBAAmB,QAAQ,KAAK,WAAW;AAAA,EACxD;AAAA,EAEA,MAAM,UAAyB;AAC7B,UAAM,KAAK,YAAY,KAAK;AAAA,EAC9B;AAAA,EAEA,MAA+B;AAC7B,WAAO,KAAK,QAAQ,SAAS;AAAA,EAC/B;AAAA,EAEA,MAAM,QAAQ,OAAwC;AAEpD,UAAM,KAAK,oBAAoB,KAAK;AAGpC,UAAM,eAAe,MAAM,KAAK,YAAY,QAAQ,GAAG,QAAQ,KAAK,KAAK,EAAE;AAE3E,QAAI,gBAAgB,aAAa,SAAS,GAAG;AAC3C,aAAO,KAAK,MAAM,aAAa,CAAC,CAAC;AAAA,IACnC;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,SAAiC;AACpC,WAAO,KAAK,OAAO,WAAW,OAAO;AAAA,EACvC;AAAA,EAEA,UAAU,SAAkB,OAA8B;AACxD,WAAO,KAAK,YAAY,WAAW,SAAS,KAAK;AAAA,EACnD;AAAA,EAEA,MAAM,YAAY,OAAe,SAAkB,OAA8B;AAC/E,UAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,UAAM,aAAa,GAAG,QAAQ,cAAc,KAAK;AAEjD,UAAM,KAAK,YAAY,KAAK,YAAY,WAAW,KAAK,UAAU,OAAO,CAAC;AAAA,EAC5E;AAAA,EAEA,MAAM,OAAO,OAAe,SAAiC;AAC3D,UAAM,WAAW,QAAQ,YAAY;AAIrC,UAAM,YAAY,KAAK,IAAI;AAC3B,UAAM,QAAQ,WAAW,OAAO;AAEhC,UAAM,KAAK,YAAY,KAAK,GAAG,QAAQ,KAAK,KAAK,IAAI,OAAO,KAAK,UAAU,OAAO,CAAC;AAAA,EACrF;AAAA,EAEA,OAAwB;AACtB,WAAO,KAAK,OAAO,SAAS;AAAA,EAC9B;AAAA,EAEA,OAAO,OAAgC;AACrC,WAAO,KAAK,YAAY,MAAM,GAAG,QAAQ,KAAK,KAAK,EAAE;AAAA,EACvD;AAAA,EAEA,MAAM,oBAAoB,OAAgC;AACxD,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,aAAa,GAAG,QAAQ,cAAc,KAAK;AACjD,UAAM,WAAW,GAAG,QAAQ,KAAK,KAAK;AAGtC,WAAQ,MAAM,KAAK,YAAY;AAAA,MAC7B;AAAA,MACA;AAAA;AAAA,MACA;AAAA,MACA;AAAA,MACA,IAAI,SAAS;AAAA,IACf;AAAA,EACF;AACF;","names":[]}

package/build/src/drivers/sync_adapter.d.ts

@@ -0,0 +1,19 @@
+import { A as Adapter, L as LeaseConfig, a as JobData } from '../../job-CcAUWe8j.js';
+import { LeaseManager } from '../contracts/lease_manager.js';
+
+declare function sync(): () => SyncAdapter;
+declare class SyncAdapter implements Adapter {
+    #private;
+    createLeaseManager(_config: LeaseConfig): LeaseManager;
+    push(jobData: JobData): Promise<void>;
+    pushOn(_queue: string, jobData: JobData): Promise<void>;
+    pushLater(jobData: JobData, delay: number): Promise<void>;
+    pushLaterOn(_queue: string, jobData: JobData, delay: number): Promise<void>;
+    size(): Promise<number>;
+    sizeOf(_queue: string): Promise<number>;
+    pop(): Promise<JobData | null>;
+    popFrom(_queue: string): Promise<JobData | null>;
+    destroy(): Promise<void>;
+}
+
+export { SyncAdapter, sync };

package/build/src/drivers/sync_adapter.js

@@ -0,0 +1,53 @@
+// src/drivers/sync_adapter.ts
+import { Locator } from "#src/locator";
+function sync() {
+  return () => new SyncAdapter();
+}
+var SyncAdapter = class {
+  createLeaseManager(_config) {
+    throw new Error("Method not implemented.");
+  }
+  push(jobData) {
+    return this.pushOn("default", jobData);
+  }
+  pushOn(_queue, jobData) {
+    return this.#execute(jobData.name, jobData.payload);
+  }
+  pushLater(jobData, delay) {
+    return this.pushLaterOn("default", jobData, delay);
+  }
+  pushLaterOn(_queue, jobData, delay) {
+    setTimeout(() => {
+      void this.#execute(jobData.name, jobData.payload);
+    }, delay);
+    return Promise.resolve();
+  }
+  size() {
+    return this.sizeOf("default");
+  }
+  sizeOf(_queue) {
+    return Promise.resolve(0);
+  }
+  pop() {
+    return this.popFrom("default");
+  }
+  popFrom(_queue) {
+    throw new Error("Method not implemented.");
+  }
+  destroy() {
+    return Promise.resolve();
+  }
+  async #execute(jobName, payload) {
+    const JobClass = Locator.get(jobName);
+    if (!JobClass) {
+      throw new Error(`Job class ${jobName} not found.`);
+    }
+    const jobInstance = new JobClass(payload);
+    await jobInstance.execute();
+  }
+};
+export {
+  SyncAdapter,
+  sync
+};
+//# sourceMappingURL=sync_adapter.js.map

package/build/src/drivers/sync_adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/drivers/sync_adapter.ts"],"sourcesContent":["import { Locator } from '#src/locator'\nimport type { Adapter } from '#contracts/adapter'\nimport type { JobData, LeaseConfig } from '#types/main'\nimport type { LeaseManager } from '#contracts/lease_manager'\n\nexport function sync() {\n  return () => new SyncAdapter()\n}\n\nexport class SyncAdapter implements Adapter {\n  createLeaseManager(_config: LeaseConfig): LeaseManager {\n    throw new Error('Method not implemented.')\n  }\n\n  push(jobData: JobData): Promise<void> {\n    return this.pushOn('default', jobData)\n  }\n\n  pushOn(_queue: string, jobData: JobData): Promise<void> {\n    return this.#execute(jobData.name, jobData.payload)\n  }\n\n  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    setTimeout(() => {\n      void this.#execute(jobData.name, jobData.payload)\n    }, delay)\n\n    return Promise.resolve()\n  }\n\n  size(): Promise<number> {\n    return this.sizeOf('default')\n  }\n\n  sizeOf(_queue: string): Promise<number> {\n    return Promise.resolve(0)\n  }\n\n  pop(): Promise<JobData | null> {\n    return this.popFrom('default')\n  }\n\n  popFrom(_queue: string): Promise<JobData | null> {\n    throw new Error('Method not implemented.')\n  }\n\n  destroy(): Promise<void> {\n    return Promise.resolve()\n  }\n\n  async #execute(jobName: string, payload: any): Promise<any> {\n    const JobClass = Locator.get(jobName)\n\n    if (!JobClass) {\n      throw new Error(`Job class ${jobName} not found.`)\n    }\n\n    const jobInstance = new JobClass(payload)\n    await jobInstance.execute()\n  }\n}\n"],"mappings":";AAAA,SAAS,eAAe;AAKjB,SAAS,OAAO;AACrB,SAAO,MAAM,IAAI,YAAY;AAC/B;AAEO,IAAM,cAAN,MAAqC;AAAA,EAC1C,mBAAmB,SAAoC;AACrD,UAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AAAA,EAEA,KAAK,SAAiC;AACpC,WAAO,KAAK,OAAO,WAAW,OAAO;AAAA,EACvC;AAAA,EAEA,OAAO,QAAgB,SAAiC;AACtD,WAAO,KAAK,SAAS,QAAQ,MAAM,QAAQ,OAAO;AAAA,EACpD;AAAA,EAEA,UAAU,SAAkB,OAA8B;AACxD,WAAO,KAAK,YAAY,WAAW,SAAS,KAAK;AAAA,EACnD;AAAA,EAEA,YAAY,QAAgB,SAAkB,OAA8B;AAC1E,eAAW,MAAM;AACf,WAAK,KAAK,SAAS,QAAQ,MAAM,QAAQ,OAAO;AAAA,IAClD,GAAG,KAAK;AAER,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,OAAwB;AACtB,WAAO,KAAK,OAAO,SAAS;AAAA,EAC9B;AAAA,EAEA,OAAO,QAAiC;AACtC,WAAO,QAAQ,QAAQ,CAAC;AAAA,EAC1B;AAAA,EAEA,MAA+B;AAC7B,WAAO,KAAK,QAAQ,SAAS;AAAA,EAC/B;AAAA,EAEA,QAAQ,QAAyC;AAC/C,UAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AAAA,EAEA,UAAyB;AACvB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,MAAM,SAAS,SAAiB,SAA4B;AAC1D,UAAM,WAAW,QAAQ,IAAI,OAAO;AAEpC,QAAI,CAAC,UAAU;AACb,YAAM,IAAI,MAAM,aAAa,OAAO,aAAa;AAAA,IACnD;AAEA,UAAM,cAAc,IAAI,SAAS,OAAO;AACxC,UAAM,YAAY,QAAQ;AAAA,EAC5B;AACF;","names":[]}

package/build/src/types/main.d.ts

@@ -0,0 +1,2 @@
+export { b as AcquiredJob, k as AdapterFactory, h as BackoffConfig, B as BackoffStrategy, D as Duration, g as JobClass, a as JobData, d as JobOptions, L as LeaseConfig, i as QueueConfig, Q as QueueManagerConfig, R as RetryConfig, j as WorkerConfig, W as WorkerCycle } from '../../job-CcAUWe8j.js';
+import '../contracts/lease_manager.js';

package/build/src/types/main.js

@@ -0,0 +1 @@
+//# sourceMappingURL=main.js.map

package/build/src/types/main.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@boringnode/queue",
+  "description": "A simple and efficient queue system for Node.js applications",
+  "version": "0.0.1-alpha",
+  "main": "build/index.js",
+  "type": "module",
+  "files": [
+    "build"
+  ],
+  "exports": {
+    ".": "./build/index.js",
+    "./drivers/*": "./build/src/drivers/*.js",
+    "./contracts/*": "./build/src/contracts/*.js",
+    "./types/*": "./build/src/types/*.js"
+  },
+  "imports": {
+    "#src/*": "./src/*.ts",
+    "#drivers/*": "./src/drivers/*.ts",
+    "#lease_managers/*": "./src/lease_managers/*.ts",
+    "#contracts/*": "./src/contracts/*.ts",
+    "#strategies/*": "./src/strategies/*.ts",
+    "#types/*": "./src/types/*.ts"
+  },
+  "scripts": {
+    "build": "yarn clean && tsup-node",
+    "clean": "del-cli build",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "prepublishOnly": "yarn build",
+    "release": "yarn dlx release-it",
+    "test": "c8 node --enable-source-maps bin/test.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@lukeed/ms": "^2.0.2",
+    "@poppinss/utils": "^6.10.1",
+    "@verrou/core": "^0.5.1"
+  },
+  "devDependencies": {
+    "@adonisjs/eslint-config": "^2.1.2",
+    "@adonisjs/prettier-config": "^1.4.5",
+    "@adonisjs/tsconfig": "^1.4.1",
+    "@japa/assert": "^4.1.1",
+    "@japa/expect-type": "^2.0.3",
+    "@japa/file-system": "^2.3.2",
+    "@japa/runner": "^4.4.0",
+    "@types/node": "^24.3.1",
+    "c8": "^10.1.3",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.35.0",
+    "ioredis": "^5.7.0",
+    "prettier": "^3.6.2",
+    "release-it": "^19.0.4",
+    "testcontainers": "^11.5.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.2"
+  },
+  "author": "Romain Lanz <romain.lanz@pm.me>",
+  "license": "MIT",
+  "keywords": [
+    "queue",
+    "job",
+    "task",
+    "worker",
+    "redis"
+  ],
+  "prettier": "@adonisjs/prettier-config",
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore(release): ${version}",
+      "tagAnnotation": "v${version}",
+      "tagName": "v${version}"
+    },
+    "github": {
+      "release": true,
+      "releaseName": "v${version}",
+      "web": true
+    }
+  },
+  "packageManager": "yarn@4.9.4+sha512.7b1cb0b62abba6a537b3a2ce00811a843bea02bcf53138581a6ae5b1bf563f734872bd47de49ce32a9ca9dcaff995aa789577ffb16811da7c603dcf69e73750b",
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}