@boringnode/queue 0.0.1-alpha.3 → 0.0.1-alpha.4

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/job_dispatcher.ts","../src/queue_manager.ts","../src/utils.ts","../src/job.ts","../src/worker.ts","../src/job_pool.ts","../src/strategies/backoff_strategy.ts"],"sourcesContent":["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 { Duration } from './types/main.js'\nimport { parse } from './utils.js'\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\n  constructor(name: string, payload: T) {\n    this.#name = name\n    this.#payload = payload\n  }\n\n  toQueue(queue: string): this {\n    this.#queue = queue\n\n    return this\n  }\n  in(delay: Duration): this {\n    this.#delay = delay\n\n    return this\n  }\n\n  priority(priority: number): this {\n    this.#priority = priority\n\n    return this\n  }\n\n  with(adapter: string | (() => Adapter)) {\n    this.#adapter = adapter\n\n    return this\n  }\n\n  async run() {\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    }\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 id\n  }\n\n  then(onFulfilled?: (value: string) => any, onRejected?: (reason: any) => any): Promise<any> {\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 * as errors from './exceptions.js'\nimport debug from './debug.js'\nimport { Locator } from './locator.js'\nimport type { Adapter } from './contracts/adapter.js'\nimport type { AdapterFactory, QueueConfig, QueueManagerConfig, RetryConfig } from './types/main.js'\n\nclass QueueManagerSingleton {\n  #defaultAdapter!: string\n  #adapters: Record<string, AdapterFactory> = {}\n  #adapterInstances: Map<string, Adapter> = new Map()\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.#adapterInstances.clear()\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    // 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      // 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 [name, adapter] of this.#adapterInstances) {\n      debug('destroying adapter \"%s\"', name)\n      await adapter.destroy()\n    }\n    this.#adapterInstances.clear()\n  }\n}\n\nexport const QueueManager = new QueueManagerSingleton()\n","import { parse as parseDuration } from '@lukeed/ms'\nimport type { Duration } from './types/main.js'\nimport * as errors from './exceptions.js'\n\nexport function parse(duration: Duration): number {\n  if (typeof duration === 'number') {\n    return duration\n  }\n\n  const milliseconds = parseDuration(duration)\n\n  if (typeof milliseconds === 'undefined') {\n    throw new errors.E_INVALID_DURATION_EXPRESSION([duration])\n  }\n\n  return milliseconds\n}\n","import { JobDispatcher } from './job_dispatcher.js'\nimport type { JobOptions } from './types/main.js'\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(signal?: AbortSignal): 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 './debug.js'\nimport { parse } from './utils.js'\nimport * as errors from './exceptions.js'\nimport { QueueManager } from './queue_manager.js'\nimport { JobPool } from './job_pool.js'\nimport type { Adapter, AcquiredJob } from './contracts/adapter.js'\nimport type { QueueManagerConfig, WorkerCycle } from './types/main.js'\nimport { Locator } from './locator.js'\nimport type { JobOptions } from './types/main.js'\nimport type { Job } from './job.js'\n\nexport class Worker {\n  readonly #id: string\n  readonly #config: QueueManagerConfig\n  #adapter!: Adapter\n  #running = false\n  #initialized = false\n  #generator?: AsyncGenerator<WorkerCycle, void, unknown>\n  #pool?: JobPool\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.#adapter.setWorkerId(this.#id)\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.#pool) {\n      debug('worker %s: waiting for %d running jobs to complete', this.#id, this.#pool.size)\n      await this.#pool.drain()\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 pollingInterval = parse(this.#config.worker?.pollingInterval || '2s')\n    this.#pool = new JobPool()\n\n    while (this.#running) {\n      try {\n        yield* this.#fillPool(queues)\n\n        if (this.#pool.isEmpty()) {\n          yield { type: 'idle', suggestedDelay: pollingInterval }\n          continue\n        }\n\n        const completed = await this.#pool.waitForNextCompletion()\n        yield { type: 'completed', queue: completed.queue, job: completed.job }\n      } catch (error) {\n        yield { type: 'error', error: error as Error, suggestedDelay: parse('5s') }\n      }\n    }\n  }\n\n  async *#fillPool(queues: string[]): AsyncGenerator<WorkerCycle, void, unknown> {\n    const concurrency = this.#config.worker?.concurrency || 1\n    const slotsAvailable = concurrency - this.#pool!.size\n\n    if (slotsAvailable <= 0) return\n\n    const popPromises = Array.from({ length: slotsAvailable }, () => this.#acquireNextJob(queues))\n\n    const results = await Promise.all(popPromises)\n\n    for (const result of results) {\n      if (!result) continue\n\n      const { job, queue } = result\n      const promise = this.#execute(job, queue)\n      this.#pool!.add(job, queue, promise)\n\n      yield { type: 'started', queue, job }\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    const { instance, options, timeout } = await this.#initJob(job, queue)\n\n    try {\n      await this.#executeWithTimeout(instance, timeout)\n      await this.#adapter.completeJob(job.id, queue)\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 isTimeout = e instanceof errors.E_JOB_TIMEOUT\n\n      if (isTimeout && options.failOnTimeout) {\n        debug('worker %s: job %s timed out and failOnTimeout is set', this.#id, job.id)\n        await this.#adapter.failJob(job.id, queue, e as Error)\n        await instance.failed?.(e as Error)\n        return\n      }\n\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        await this.#adapter.failJob(job.id, queue, e as Error)\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        await this.#adapter.failJob(job.id, queue, e as Error)\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.#adapter.retryJob(job.id, queue, nextRetryAt)\n        return\n      }\n\n      await this.#adapter.retryJob(job.id, queue)\n    }\n  }\n\n  async #initJob(\n    job: AcquiredJob,\n    queue: string\n  ): Promise<{ instance: Job; options: JobOptions; timeout: number | undefined }> {\n    try {\n      const JobClass = Locator.getOrThrow(job.name)\n      const instance = new JobClass(job.payload)\n      const options = JobClass.options || {}\n      const timeout = this.#getJobTimeout(options)\n\n      return { instance, options, timeout }\n    } catch (error) {\n      debug('worker %s: failed to initialize job %s (%s)', this.#id, job.id, job.name)\n      await this.#adapter.failJob(job.id, queue, error as Error)\n      throw error\n    }\n  }\n\n  #getJobTimeout(options: JobOptions): number | undefined {\n    if (options.timeout !== undefined) {\n      return parse(options.timeout)\n    }\n\n    if (this.#config.worker?.timeout !== undefined) {\n      return parse(this.#config.worker.timeout)\n    }\n\n    return undefined\n  }\n\n  async #executeWithTimeout(instance: Job, timeout?: number): Promise<void> {\n    if (!timeout) {\n      return instance.execute()\n    }\n\n    const signal = AbortSignal.timeout(timeout)\n\n    const abortPromise = new Promise<never>((_, reject) => {\n      signal.addEventListener('abort', () => {\n        reject(new errors.E_JOB_TIMEOUT([instance.constructor.name, timeout]))\n      })\n    })\n\n    await Promise.race([instance.execute(signal), abortPromise])\n  }\n\n  async #acquireNextJob(queues: string[]): Promise<{ job: AcquiredJob; queue: string } | null> {\n    for (const queue of queues) {\n      const job = await this.#adapter.popFrom(queue)\n\n      if (!job) {\n        continue\n      }\n\n      debug('worker %s: acquired job %s', this.#id, job.id)\n      return { job, queue }\n    }\n\n    return null\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 type { AcquiredJob } from './contracts/adapter.js'\n\ninterface PoolEntry {\n  promise: Promise<void>\n  job: AcquiredJob\n  queue: string\n}\n\nexport class JobPool {\n  #activeJobs = new Map<string, PoolEntry>()\n\n  get size() {\n    return this.#activeJobs.size\n  }\n\n  isEmpty() {\n    return this.#activeJobs.size === 0\n  }\n\n  hasCapacity(concurrency: number) {\n    return this.#activeJobs.size < concurrency\n  }\n\n  add(job: AcquiredJob, queue: string, promise: Promise<void>) {\n    this.#activeJobs.set(job.id, { promise, job, queue })\n  }\n\n  async waitForNextCompletion(): Promise<PoolEntry> {\n    const completedJobId = await Promise.race(\n      [...this.#activeJobs.entries()].map(async ([id, { promise }]) => {\n        try {\n          await promise\n        } catch {\n          // Errors are handled in Worker#execute\n        }\n        return id\n      })\n    )\n\n    const completed = this.#activeJobs.get(completedJobId)!\n    this.#activeJobs.delete(completedJobId)\n\n    return completed\n  }\n\n  async drain(): Promise<void> {\n    const promises = [...this.#activeJobs.values()].map(async ({ promise }) => {\n      try {\n        await promise\n      } catch {\n        // Errors are handled in Worker#execute\n      }\n    })\n\n    await Promise.all(promises)\n    this.#activeJobs.clear()\n  }\n}\n","import type { BackoffConfig, Duration } from '../types/main.js'\nimport * as errors from '../exceptions.js'\nimport { parse } from '../utils.js'\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":";;;;;;;;;;;;;AACA,SAAS,kBAAkB;;;ACK3B,IAAM,wBAAN,MAA4B;AAAA,EAC1B;AAAA,EACA,YAA4C,CAAC;AAAA,EAC7C,oBAA0C,oBAAI,IAAI;AAAA,EAClD;AAAA,EACA,gBAA0C,oBAAI,IAAI;AAAA,EAElD,MAAM,KAAK,QAA4B;AACrC,kBAAM,8CAA8C,MAAM;AAE1D,SAAK,gBAAgB,MAAM;AAE3B,SAAK,kBAAkB,MAAM;AAE7B,SAAK,kBAAkB,OAAO;AAC9B,SAAK,YAAY,OAAO;AACxB,SAAK,qBAAqB,OAAO;AAEjC,QAAI,OAAO,QAAQ;AACjB,iBAAW,CAAC,OAAO,WAAW,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AAChE,aAAK,cAAc,IAAI,OAAO,WAA0B;AAAA,MAC1D;AAAA,IACF;AAEA,UAAM,QAAQ,iBAAiB,OAAO,SAAS;AAE/C,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,SAA2B;AAC7B,QAAI,CAAC,SAAS;AACZ,gBAAU,KAAK;AAAA,IACjB;AAGA,UAAM,SAAS,KAAK,kBAAkB,IAAI,OAAO;AACjD,QAAI,QAAQ;AACV,aAAO;AAAA,IACT;AAEA,UAAM,iBAAiB,KAAK,UAAU,OAAO;AAE7C,QAAI,CAAC,gBAAgB;AACnB,YAAM,IAAW,sBAAsB,CAAC,YAAY,OAAO,qBAAqB,CAAC;AAAA,IACnF;AAEA,kBAAM,sBAAsB,OAAO;AAEnC,QAAI;AACF,YAAM,WAAW,eAAe;AAChC,WAAK,kBAAkB,IAAI,SAAS,QAAQ;AAC5C,aAAO;AAAA,IACT,SAAS,OAAO;AAEd,YAAM,IAAI,MAAM;AAAA,IAElB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,qBAAqB,OAAe,gBAA2C;AAC7E,UAAM,cAAc,KAAK,cAAc,IAAI,KAAK;AAChD,UAAM,mBAAmB,aAAa,SAAS,CAAC;AAEhD,QAAI,aACF,gBAAgB,cAChB,iBAAiB,cACjB,KAAK,oBAAoB,cACzB;AAEF,QAAI,UACF,gBAAgB,WAAW,iBAAiB,WAAW,KAAK,oBAAoB;AAElF,WAAO,EAAE,YAAY,QAAQ;AAAA,EAC/B;AAAA,EAEA,gBAAgB,QAAkC;AAChD,QAAI,CAAC,OAAO,YAAY,OAAO,KAAK,OAAO,QAAQ,EAAE,WAAW,GAAG;AACjE,YAAM,IAAW,sBAAsB,CAAC,yCAAyC,CAAC;AAAA,IACpF;AAEA,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,IAAW,sBAAsB,CAAC,mCAAmC,CAAC;AAAA,IAC9E;AAEA,QAAI,CAAC,OAAO,aAAa,OAAO,UAAU,WAAW,GAAG;AACtD,YAAM,IAAW,sBAAsB,CAAC,iCAAiC,CAAC;AAAA,IAC5E;AAEA,QAAI,CAAC,OAAO,SAAS,OAAO,OAAO,GAAG;AACpC,YAAM,IAAW,sBAAsB;AAAA,QACrC,oBAAoB,OAAO,OAAO;AAAA,MACpC,CAAC;AAAA,IACH;AAEA,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,OAAO,QAAQ,GAAG;AAC7D,UAAI,OAAO,YAAY,YAAY;AACjC,cAAM,IAAW,sBAAsB,CAAC,YAAY,IAAI,8BAA8B,CAAC;AAAA,MACzF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,UAAU;AACd,eAAW,CAAC,MAAM,OAAO,KAAK,KAAK,mBAAmB;AACpD,oBAAM,2BAA2B,IAAI;AACrC,YAAM,QAAQ,QAAQ;AAAA,IACxB;AACA,SAAK,kBAAkB,MAAM;AAAA,EAC/B;AACF;AAEO,IAAM,eAAe,IAAI,sBAAsB;;;ACvHtD,SAAS,SAAS,qBAAqB;AAIhC,SAAS,MAAM,UAA4B;AAChD,MAAI,OAAO,aAAa,UAAU;AAChC,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,cAAc,QAAQ;AAE3C,MAAI,OAAO,iBAAiB,aAAa;AACvC,UAAM,IAAW,8BAA8B,CAAC,QAAQ,CAAC;AAAA,EAC3D;AAEA,SAAO;AACT;;;AFTO,IAAM,gBAAN,MAAuB;AAAA,EACnB;AAAA,EACA;AAAA,EACT,SAAiB;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,MAAc,SAAY;AACpC,SAAK,QAAQ;AACb,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,QAAQ,OAAqB;AAC3B,SAAK,SAAS;AAEd,WAAO;AAAA,EACT;AAAA,EACA,GAAG,OAAuB;AACxB,SAAK,SAAS;AAEd,WAAO;AAAA,EACT;AAAA,EAEA,SAAS,UAAwB;AAC/B,SAAK,YAAY;AAEjB,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,SAAmC;AACtC,SAAK,WAAW;AAEhB,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,MAAM;AACV,UAAM,KAAK,WAAW;AAEtB,kBAAM,kDAAkD,KAAK,OAAO,IAAI,KAAK,QAAQ;AAErF,UAAM,UAAU,KAAK,oBAAoB;AAEzC,UAAM,UAAU;AAAA,MACd;AAAA,MACA,MAAM,KAAK;AAAA,MACX,SAAS,KAAK;AAAA,MACd,UAAU;AAAA,MACV,UAAU,KAAK;AAAA,IACjB;AAEA,QAAI,KAAK,QAAQ;AACf,YAAM,cAAc,MAAM,KAAK,MAAM;AAErC,YAAM,QAAQ,YAAY,KAAK,QAAQ,SAAS,WAAW;AAAA,IAC7D,OAAO;AACL,YAAM,QAAQ,OAAO,KAAK,QAAQ,OAAO;AAAA,IAC3C;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,aAAsC,YAAiD;AAC1F,WAAO,KAAK,IAAI,EAAE,KAAK,aAAa,UAAU;AAAA,EAChD;AAAA,EAEA,sBAA+B;AAC7B,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO,aAAa,IAAI;AAAA,IAC1B;AAEA,QAAI,OAAO,KAAK,aAAa,UAAU;AACrC,aAAO,aAAa,IAAI,KAAK,QAAQ;AAAA,IACvC;AAEA,WAAO,KAAK,SAAS;AAAA,EACvB;AACF;;;AGjFO,IAAe,MAAf,MAAkC;AAAA,EAC9B;AAAA,EAET,OAAO,UAAsB,CAAC;AAAA,EAE9B,IAAI,UAAmB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAY,SAAkB;AAC5B,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAO,SAEL,SACmD;AACnD,UAAM,aAAa,IAAI;AAAA,MACpB,KAAa;AAAA,MACd;AAAA,IACF;AAEA,QAAK,KAAa,QAAQ,OAAO;AAC/B,iBAAW,QAAS,KAAa,QAAQ,KAAK;AAAA,IAChD;AAEA,QAAK,KAAa,QAAQ,SAAS;AACjC,iBAAW,KAAM,KAAa,QAAQ,OAAO;AAAA,IAC/C;AAEA,QAAK,KAAa,QAAQ,aAAa,QAAW;AAChD,iBAAW,SAAU,KAAa,QAAQ,QAAQ;AAAA,IACpD;AAEA,WAAO;AAAA,EACT;AAKF;;;AC3CA,SAAS,cAAAA,mBAAkB;AAC3B,SAAS,kBAAkB;;;ACOpB,IAAM,UAAN,MAAc;AAAA,EACnB,cAAc,oBAAI,IAAuB;AAAA,EAEzC,IAAI,OAAO;AACT,WAAO,KAAK,YAAY;AAAA,EAC1B;AAAA,EAEA,UAAU;AACR,WAAO,KAAK,YAAY,SAAS;AAAA,EACnC;AAAA,EAEA,YAAY,aAAqB;AAC/B,WAAO,KAAK,YAAY,OAAO;AAAA,EACjC;AAAA,EAEA,IAAI,KAAkB,OAAe,SAAwB;AAC3D,SAAK,YAAY,IAAI,IAAI,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;AAAA,EACtD;AAAA,EAEA,MAAM,wBAA4C;AAChD,UAAM,iBAAiB,MAAM,QAAQ;AAAA,MACnC,CAAC,GAAG,KAAK,YAAY,QAAQ,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM;AAC/D,YAAI;AACF,gBAAM;AAAA,QACR,QAAQ;AAAA,QAER;AACA,eAAO;AAAA,MACT,CAAC;AAAA,IACH;AAEA,UAAM,YAAY,KAAK,YAAY,IAAI,cAAc;AACrD,SAAK,YAAY,OAAO,cAAc;AAEtC,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,QAAuB;AAC3B,UAAM,WAAW,CAAC,GAAG,KAAK,YAAY,OAAO,CAAC,EAAE,IAAI,OAAO,EAAE,QAAQ,MAAM;AACzE,UAAI;AACF,cAAM;AAAA,MACR,QAAQ;AAAA,MAER;AAAA,IACF,CAAC;AAED,UAAM,QAAQ,IAAI,QAAQ;AAC1B,SAAK,YAAY,MAAM;AAAA,EACzB;AACF;;;AD5CO,IAAM,SAAN,MAAa;AAAA,EACT;AAAA,EACA;AAAA,EACT;AAAA,EACA,WAAW;AAAA,EACX,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EAEA,IAAI,KAAK;AACP,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAY,QAA4B;AACtC,SAAK,UAAU;AACf,SAAK,MAAMC,YAAW;AAEtB,kBAAM,2CAA2C,KAAK,KAAK,MAAM;AAAA,EACnE;AAAA,EAEA,MAAM,OAAO;AACX,QAAI,KAAK,cAAc;AACrB;AAAA,IACF;AAEA,kBAAM,0BAA0B,KAAK,GAAG;AAExC,UAAM,aAAa,KAAK,KAAK,OAAO;AAEpC,SAAK,WAAW,aAAa,IAAI;AACjC,SAAK,SAAS,YAAY,KAAK,GAAG;AAElC,SAAK,eAAe;AAEpB,kBAAM,yBAAyB,KAAK,GAAG;AAAA,EACzC;AAAA,EAEA,MAAM,MAAM,SAAmB,CAAC,SAAS,GAAkB;AACzD,UAAM,KAAK,KAAK;AAEhB,QAAI,KAAK,UAAU;AACjB,oBAAM,gCAAgC,KAAK,GAAG;AAC9C;AAAA,IACF;AAEA,SAAK,WAAW;AAEhB,kBAAM,oCAAoC,KAAK,KAAK,MAAM;AAE1D,UAAM,KAAK,uBAAuB;AAElC,qBAAiB,SAAS,KAAK,QAAQ,MAAM,GAAG;AAC9C,UAAI,CAAC,WAAW,WAAW,EAAE,SAAS,MAAM,IAAI,GAAG;AACjD;AAAA,MACF;AAEA,UAAI,CAAC,QAAQ,OAAO,EAAE,SAAS,MAAM,IAAI,GAAG;AAE1C,cAAM,QAAQ,MAAM,MAAM,cAAc;AAExC,YAAI,MAAM,SAAS,SAAS;AAC1B,wBAAM,sCAAsC,KAAK,KAAK,MAAM,KAAK;AAAA,QACnE,OAAO;AACL,wBAAM,uCAAuC,KAAK,KAAK,KAAK;AAAA,QAC9D;AAEA,cAAM,WAAW,KAAK;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,OAAO;AACX,kBAAM,sBAAsB,KAAK,GAAG;AAEpC,SAAK,WAAW;AAEhB,QAAI,KAAK,OAAO;AACd,oBAAM,sDAAsD,KAAK,KAAK,KAAK,MAAM,IAAI;AACrF,YAAM,KAAK,MAAM,MAAM;AAAA,IACzB;AAEA,QAAI,KAAK,UAAU;AACjB,YAAM,KAAK,SAAS,QAAQ;AAAA,IAC9B;AAAA,EACF;AAAA,EAEA,MAAM,aAAa,QAA+C;AAChE,UAAM,KAAK,KAAK;AAEhB,SAAK,WAAW;AAEhB,QAAI,CAAC,KAAK,YAAY;AACpB,WAAK,aAAa,KAAK,QAAQ,MAAM;AAAA,IACvC;AAEA,UAAM,SAAS,MAAM,KAAK,WAAW,KAAK;AAE1C,QAAI,OAAO,MAAM;AACf,WAAK,aAAa;AAClB,aAAO;AAAA,IACT;AAEA,WAAO,OAAO;AAAA,EAChB;AAAA,EAEA,OAAO,QAAQ,QAA8D;AAC3E,UAAM,kBAAkB,MAAM,KAAK,QAAQ,QAAQ,mBAAmB,IAAI;AAC1E,SAAK,QAAQ,IAAI,QAAQ;AAEzB,WAAO,KAAK,UAAU;AACpB,UAAI;AACF,eAAO,KAAK,UAAU,MAAM;AAE5B,YAAI,KAAK,MAAM,QAAQ,GAAG;AACxB,gBAAM,EAAE,MAAM,QAAQ,gBAAgB,gBAAgB;AACtD;AAAA,QACF;AAEA,cAAM,YAAY,MAAM,KAAK,MAAM,sBAAsB;AACzD,cAAM,EAAE,MAAM,aAAa,OAAO,UAAU,OAAO,KAAK,UAAU,IAAI;AAAA,MACxE,SAAS,OAAO;AACd,cAAM,EAAE,MAAM,SAAS,OAAuB,gBAAgB,MAAM,IAAI,EAAE;AAAA,MAC5E;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO,UAAU,QAA8D;AAC7E,UAAM,cAAc,KAAK,QAAQ,QAAQ,eAAe;AACxD,UAAM,iBAAiB,cAAc,KAAK,MAAO;AAEjD,QAAI,kBAAkB,EAAG;AAEzB,UAAM,cAAc,MAAM,KAAK,EAAE,QAAQ,eAAe,GAAG,MAAM,KAAK,gBAAgB,MAAM,CAAC;AAE7F,UAAM,UAAU,MAAM,QAAQ,IAAI,WAAW;AAE7C,eAAW,UAAU,SAAS;AAC5B,UAAI,CAAC,OAAQ;AAEb,YAAM,EAAE,KAAK,MAAM,IAAI;AACvB,YAAM,UAAU,KAAK,SAAS,KAAK,KAAK;AACxC,WAAK,MAAO,IAAI,KAAK,OAAO,OAAO;AAEnC,YAAM,EAAE,MAAM,WAAW,OAAO,IAAI;AAAA,IACtC;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,KAAkB,OAA8B;AAC7D,UAAM,YAAY,YAAY,IAAI;AAElC,kBAAM,oCAAoC,KAAK,KAAK,IAAI,IAAI,IAAI,IAAI;AAEpE,UAAM,EAAE,UAAU,SAAS,QAAQ,IAAI,MAAM,KAAK,SAAS,KAAK,KAAK;AAErE,QAAI;AACF,YAAM,KAAK,oBAAoB,UAAU,OAAO;AAChD,YAAM,KAAK,SAAS,YAAY,IAAI,IAAI,KAAK;AAE7C,YAAM,YAAY,YAAY,IAAI,IAAI,WAAW,QAAQ,CAAC;AAC1D,oBAAM,mDAAmD,KAAK,KAAK,IAAI,IAAI,QAAQ;AAAA,IACrF,SAAS,GAAG;AACV,YAAM,YAAY,aAAoB;AAEtC,UAAI,aAAa,QAAQ,eAAe;AACtC,sBAAM,wDAAwD,KAAK,KAAK,IAAI,EAAE;AAC9E,cAAM,KAAK,SAAS,QAAQ,IAAI,IAAI,OAAO,CAAU;AACrD,cAAM,SAAS,SAAS,CAAU;AAClC;AAAA,MACF;AAEA,YAAM,eAAe,aAAa,qBAAqB,OAAO,QAAQ,KAAK;AAE3E,UAAI,OAAO,aAAa,eAAe,eAAe,aAAa,cAAc,GAAG;AAClF,sBAAM,kEAAkE,KAAK,KAAK,IAAI,EAAE;AACxF,cAAM,KAAK,SAAS,QAAQ,IAAI,IAAI,OAAO,CAAU;AACrD,cAAM,SAAS,SAAS,CAAU;AAClC;AAAA,MACF;AAEA,UAAI,IAAI,YAAY,aAAa,YAAa;AAC5C;AAAA,UACE;AAAA,UACA,KAAK;AAAA,UACL,IAAI;AAAA,UACJ,aAAa;AAAA,QACf;AACA,cAAM,KAAK,SAAS,QAAQ,IAAI,IAAI,OAAO,CAAU;AACrD,cAAM,YAAY,IAAW,2BAA2B,CAAC,IAAI,IAAI,CAAC;AAClE,cAAM,SAAS,SAAS,SAAS;AAEjC;AAAA,MACF;AAEA,UAAI,aAAa,SAAS;AACxB,cAAM,WAAW,aAAa,QAAQ;AACtC,cAAM,cAAc,SAAS,eAAe,IAAI,WAAW,CAAC;AAE5D,sBAAM,sCAAsC,KAAK,KAAK,IAAI,IAAI,YAAY,YAAY,CAAC;AAEvF,cAAM,KAAK,SAAS,SAAS,IAAI,IAAI,OAAO,WAAW;AACvD;AAAA,MACF;AAEA,YAAM,KAAK,SAAS,SAAS,IAAI,IAAI,KAAK;AAAA,IAC5C;AAAA,EACF;AAAA,EAEA,MAAM,SACJ,KACA,OAC8E;AAC9E,QAAI;AACF,YAAM,WAAW,QAAQ,WAAW,IAAI,IAAI;AAC5C,YAAM,WAAW,IAAI,SAAS,IAAI,OAAO;AACzC,YAAM,UAAU,SAAS,WAAW,CAAC;AACrC,YAAM,UAAU,KAAK,eAAe,OAAO;AAE3C,aAAO,EAAE,UAAU,SAAS,QAAQ;AAAA,IACtC,SAAS,OAAO;AACd,oBAAM,+CAA+C,KAAK,KAAK,IAAI,IAAI,IAAI,IAAI;AAC/E,YAAM,KAAK,SAAS,QAAQ,IAAI,IAAI,OAAO,KAAc;AACzD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,eAAe,SAAyC;AACtD,QAAI,QAAQ,YAAY,QAAW;AACjC,aAAO,MAAM,QAAQ,OAAO;AAAA,IAC9B;AAEA,QAAI,KAAK,QAAQ,QAAQ,YAAY,QAAW;AAC9C,aAAO,MAAM,KAAK,QAAQ,OAAO,OAAO;AAAA,IAC1C;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,oBAAoB,UAAe,SAAiC;AACxE,QAAI,CAAC,SAAS;AACZ,aAAO,SAAS,QAAQ;AAAA,IAC1B;AAEA,UAAM,SAAS,YAAY,QAAQ,OAAO;AAE1C,UAAM,eAAe,IAAI,QAAe,CAAC,GAAG,WAAW;AACrD,aAAO,iBAAiB,SAAS,MAAM;AACrC,eAAO,IAAW,cAAc,CAAC,SAAS,YAAY,MAAM,OAAO,CAAC,CAAC;AAAA,MACvE,CAAC;AAAA,IACH,CAAC;AAED,UAAM,QAAQ,KAAK,CAAC,SAAS,QAAQ,MAAM,GAAG,YAAY,CAAC;AAAA,EAC7D;AAAA,EAEA,MAAM,gBAAgB,QAAuE;AAC3F,eAAW,SAAS,QAAQ;AAC1B,YAAM,MAAM,MAAM,KAAK,SAAS,QAAQ,KAAK;AAE7C,UAAI,CAAC,KAAK;AACR;AAAA,MACF;AAEA,oBAAM,8BAA8B,KAAK,KAAK,IAAI,EAAE;AACpD,aAAO,EAAE,KAAK,MAAM;AAAA,IACtB;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,yBAAyB;AAC7B,UAAM,WAAW,YAAY;AAC3B,oBAAM,8CAA8C;AACpD,YAAM,KAAK,KAAK;AAChB,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,YAAQ,GAAG,UAAU,QAAQ;AAC7B,YAAQ,GAAG,WAAW,QAAQ;AAAA,EAChC;AACF;;;AEhSA,SAAS,wBAAwB;AACjC,SAAS,yBAAyB;AAE3B,IAAM,kBAAN,MAAsB;AAAA,EAClB;AAAA,EAET,YAAY,QAAuB;AACjC,SAAK,UAAU;AACf,SAAK,gBAAgB;AAAA,EACvB;AAAA,EAEA,eAAe,SAAyB;AACtC,QAAI,UAAU,GAAG;AACf,YAAM,IAAI,iBAAiB,6BAA6B;AAAA,IAC1D;AAEA,UAAM,cAAc,MAAM,KAAK,QAAQ,SAAS;AAChD,UAAM,aAAa,KAAK,QAAQ,WAAW,MAAM,KAAK,QAAQ,QAAQ,IAAI;AAC1E,UAAM,aAAa,KAAK,QAAQ,cAAc;AAE9C,QAAI;AAEJ,YAAQ,KAAK,QAAQ,UAAU;AAAA,MAC7B,KAAK;AACH,gBAAQ,cAAc,KAAK,IAAI,YAAY,UAAU,CAAC;AACtD;AAAA,MACF,KAAK;AACH,gBAAQ,cAAc;AACtB;AAAA,MACF,KAAK;AACH,gBAAQ;AACR;AAAA,MACF;AACE,0BAAkB,KAAK,QAAQ,QAAQ;AAAA,IAC3C;AAGA,YAAQ,KAAK,IAAI,OAAO,UAAU;AAElC,QAAI,KAAK,QAAQ,QAAQ;AACvB,cAAQ,KAAK,aAAa,KAAK;AAAA,IACjC;AAEA,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB;AAAA,EAEA,eAAe,SAAuB;AACpC,UAAM,QAAQ,KAAK,eAAe,OAAO;AACzC,WAAO,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK;AAAA,EACpC;AAAA,EAEA,YAAqC;AACnC,WAAO,OAAO,OAAO,EAAE,GAAG,KAAK,QAAQ,CAAC;AAAA,EAC1C;AAAA,EAEA,kBAAkB;AAChB,UAAM,cAAc,MAAM,KAAK,QAAQ,SAAS;AAEhD,QAAI,eAAe,GAAG;AACpB,YAAM,IAAW,qBAAqB;AAAA,QACpC;AAAA,MACF,CAAC;AAAA,IACH;AAEA,QAAI,KAAK,QAAQ,UAAU;AACzB,YAAM,aAAa,MAAM,KAAK,QAAQ,QAAQ;AAE9C,UAAI,cAAc,GAAG;AACnB,cAAM,IAAW,oBAAoB;AAAA,UACnC;AAAA,QACF,CAAC;AAAA,MACH;AAEA,UAAI,cAAc,aAAa;AAC7B,cAAM,IAAW,oBAAoB,CAAC,6CAA6C,CAAC;AAAA,MACtF;AAAA,IACF;AAEA,QAAI,KAAK,QAAQ,eAAe,QAAW;AACzC,UAAI,KAAK,QAAQ,cAAc,GAAG;AAChC,cAAM,IAAW,qBAAqB;AAAA,UACpC;AAAA,QACF,CAAC;AAAA,MACH;AAEA,UAAI,KAAK,QAAQ,aAAa,iBAAiB,KAAK,QAAQ,aAAa,GAAG;AAC1E,cAAM,IAAW,qBAAqB,CAAC,gDAAgD,CAAC;AAAA,MAC1F;AAAA,IACF;AAAA,EACF;AAAA,EAEA,aAAa,OAAuB;AAClC,UAAM,cAAc,QAAQ;AAC5B,UAAM,UAAU,KAAK,OAAO,IAAI,OAAO,IAAI;AAE3C,WAAO,KAAK,IAAI,GAAG,QAAQ,MAAM;AAAA,EACnC;AACF;AAEO,SAAS,mBAAmB,QAAmD;AACpF,SAAO,MACL,IAAI,gBAAgB;AAAA,IAClB,UAAU;AAAA,IACV,WAAW;AAAA,IACX,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,GAAG;AAAA,EACL,CAAC;AACL;AAEO,SAAS,cAAc,QAAmD;AAC/E,SAAO,MACL,IAAI,gBAAgB;AAAA,IAClB,UAAU;AAAA,IACV,WAAW;AAAA,IACX,UAAU;AAAA,IACV,GAAG;AAAA,EACL,CAAC;AACL;AAEO,SAAS,aAAa,QAAkB,OAAO;AACpD,SAAO,MACL,IAAI,gBAAgB;AAAA,IAClB,UAAU;AAAA,IACV,WAAW;AAAA,EACb,CAAC;AACL;AAEO,SAAS,cAAc,QAAuB;AACnD,SAAO,MAAM,IAAI,gBAAgB,MAAM;AACzC;","names":["randomUUID","randomUUID"]}
+{"version":3,"sources":["../src/job_dispatcher.ts","../src/job.ts","../src/worker.ts","../src/job_pool.ts","../src/strategies/backoff_strategy.ts"],"sourcesContent":["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 { 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\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   * 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 The unique job ID\n   *\n   * @example\n   * ```typescript\n   * const jobId = await SendEmailJob.dispatch(payload).run()\n   * console.log(`Dispatched job: ${jobId}`)\n   * ```\n   */\n  async run() {\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    }\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 id\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 job ID\n   */\n  then(onFulfilled?: (value: string) => any, onRejected?: (reason: any) => any): Promise<any> {\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 { JobDispatcher } from './job_dispatcher.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 * @typeParam Payload - The type of data this job receives\n *\n * @example\n * ```typescript\n * import { Job } from '@boringnode/queue'\n * import type { JobContext } 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(payload: SendEmailPayload, context: JobContext) {\n *     super(payload, context)\n *   }\n *\n *   async execute() {\n *     console.log(`Attempt ${this.context.attempt} for job ${this.context.jobId}`)\n *     await sendEmail(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  readonly #payload: Payload\n  readonly #context: JobContext\n\n  /** Static options for this job class (queue, retries, timeout, etc.) */\n  static options: JobOptions = {}\n\n  /** The payload data passed to this job instance */\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   * Create a new job instance.\n   *\n   * @param payload - The data to be processed by this job\n   * @param context - The job execution context (provided by the worker)\n   */\n  constructor(payload: Payload, context: JobContext) {\n    this.#payload = payload\n    this.#context = Object.freeze(context)\n  }\n\n  /**\n   * Dispatch this job to the queue.\n   *\n   * Returns a JobDispatcher for fluent configuration before dispatching.\n   * The job is not actually dispatched until `.run()` is called or the\n   * dispatcher is awaited.\n   *\n   * @param payload - The data to pass to the job\n   * @returns A JobDispatcher for fluent configuration\n   *\n   * @example\n   * ```typescript\n   * // Simple dispatch\n   * await SendEmailJob.dispatch({ to: 'user@example.com', subject: 'Hello' })\n   *\n   * // With options\n   * await SendEmailJob.dispatch({ to: 'user@example.com' })\n   *   .toQueue('high-priority')\n   *   .priority(1)\n   *   .in('5m')\n   *   .run()\n   * ```\n   */\n  static dispatch<T extends Job>(\n    this: new (payload: any, context: JobContext) => 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  /**\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   * @param signal - Optional AbortSignal for timeout handling.\n   *                 Check `signal.aborted` for long-running operations.\n   * @throws Any error thrown will trigger retry logic (if configured)\n   *\n   * @example\n   * ```typescript\n   * async execute(signal?: AbortSignal) {\n   *   for (const item of this.payload.items) {\n   *     if (signal?.aborted) {\n   *       throw new Error('Job timed out')\n   *     }\n   *     await processItem(item)\n   *   }\n   * }\n   * ```\n   */\n  abstract execute(signal?: AbortSignal): 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","import { randomUUID } from 'node:crypto'\nimport { setTimeout } from 'node:timers/promises'\nimport debug from './debug.js'\nimport { parse } from './utils.js'\nimport * as errors from './exceptions.js'\nimport { QueueManager } from './queue_manager.js'\nimport { JobPool } from './job_pool.js'\nimport type { Adapter, AcquiredJob } from './contracts/adapter.js'\nimport type { JobContext, JobOptions, QueueManagerConfig, WorkerCycle } from './types/main.js'\nimport { Locator } from './locator.js'\nimport { DEFAULT_PRIORITY } from './constants.js'\nimport type { Job } from './job.js'\nimport {\n  DEFAULT_IDLE_DELAY,\n  DEFAULT_STALLED_INTERVAL,\n  DEFAULT_STALLED_THRESHOLD,\n  DEFAULT_ERROR_RETRY_DELAY,\n} from './constants.js'\n\n/**\n * Job processing worker.\n *\n * The Worker continuously polls queues for jobs and executes them\n * with configurable concurrency. It handles:\n * - Concurrent job execution via JobPool\n * - Automatic retries with backoff strategies\n * - Stalled job detection and recovery\n * - Graceful shutdown on SIGINT/SIGTERM\n *\n * @example\n * ```typescript\n * import { Worker, redis } from '@boringnode/queue'\n *\n * const worker = new Worker({\n *   default: 'redis',\n *   adapters: { redis: redis() },\n *   locations: ['./jobs/**\\/*.js'],\n *   worker: {\n *     concurrency: 5,\n *     idleDelay: '1s',\n *   },\n * })\n *\n * // Start processing jobs\n * await worker.start(['default', 'emails'])\n *\n * // Or for testing, process one cycle at a time\n * const cycle = await worker.processCycle(['default'])\n * ```\n */\nexport class Worker {\n  readonly #id: string\n  readonly #config: QueueManagerConfig\n  readonly #idleDelay: number\n  readonly #stalledInterval: number\n  readonly #stalledThreshold: number\n  readonly #maxStalledCount: number\n  readonly #concurrency: number\n  readonly #gracefulShutdown: boolean\n  readonly #onShutdownSignal?: () => void | Promise<void>\n\n  #adapter!: Adapter\n  #running = false\n  #initialized = false\n  #generator?: AsyncGenerator<WorkerCycle, void, unknown>\n  #pool?: JobPool\n  #lastStalledCheck = 0\n  #shutdownHandler?: () => Promise<void>\n\n  /** Unique identifier for this worker instance */\n  get id() {\n    return this.#id\n  }\n\n  /**\n   * Create a new worker instance.\n   *\n   * @param config - Queue configuration including adapter and worker settings\n   */\n  constructor(config: QueueManagerConfig) {\n    this.#config = config\n    this.#id = randomUUID()\n\n    // Parse worker config once at construction\n    this.#idleDelay = parse(config.worker?.idleDelay ?? DEFAULT_IDLE_DELAY)\n    this.#stalledInterval = parse(config.worker?.stalledInterval ?? DEFAULT_STALLED_INTERVAL)\n    this.#stalledThreshold = parse(config.worker?.stalledThreshold ?? DEFAULT_STALLED_THRESHOLD)\n    this.#maxStalledCount = config.worker?.maxStalledCount ?? 1\n    this.#concurrency = config.worker?.concurrency ?? 1\n    this.#gracefulShutdown = config.worker?.gracefulShutdown ?? true\n    this.#onShutdownSignal = config.worker?.onShutdownSignal\n\n    debug('created worker with id %s and config %O', this.#id, config)\n  }\n\n  /**\n   * Initialize the worker (called automatically by `start()`).\n   *\n   * Sets up the QueueManager and adapter connection.\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.#adapter.setWorkerId(this.#id)\n\n    this.#initialized = true\n\n    debug('worker %s initialized', this.#id)\n  }\n\n  /**\n   * Start processing jobs from the specified queues.\n   *\n   * This method blocks until the worker is stopped (via `stop()` or signal).\n   * Jobs are processed concurrently up to the configured concurrency limit.\n   *\n   * @param queues - Queue names to process (default: ['default'])\n   *\n   * @example\n   * ```typescript\n   * // Process single queue\n   * await worker.start()\n   *\n   * // Process multiple queues (priority order)\n   * await worker.start(['high-priority', 'default', 'low-priority'])\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    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  /**\n   * Stop the worker gracefully.\n   *\n   * Waits for all running jobs to complete before shutting down.\n   * Called automatically on SIGINT/SIGTERM if gracefulShutdown is enabled.\n   */\n  async stop() {\n    debug('stopping worker %s', this.#id)\n\n    this.#running = false\n\n    if (this.#pool) {\n      debug('worker %s: waiting for %d running jobs to complete', this.#id, this.#pool.size)\n      await this.#pool.drain()\n    }\n\n    if (this.#adapter) {\n      await this.#adapter.destroy()\n    }\n\n    this.#removeShutdownHandlers()\n  }\n\n  /**\n   * Process a single cycle and return the result.\n   *\n   * Useful for testing or when you need fine-grained control.\n   * Each cycle may start new jobs, complete a job, or return idle.\n   *\n   * @param queues - Queue names to process\n   * @returns The cycle result, or null if the worker was stopped\n   *\n   * @example\n   * ```typescript\n   * const worker = new Worker(config)\n   *\n   * // Process cycles manually\n   * let cycle = await worker.processCycle(['default'])\n   * while (cycle) {\n   *   console.log('Cycle:', cycle.type)\n   *   cycle = await worker.processCycle(['default'])\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  /**\n   * Generator that yields worker cycle events.\n   *\n   * Low-level API for processing jobs. Yields events for:\n   * - `started`: A new job began execution\n   * - `completed`: A job finished (success or failure)\n   * - `idle`: No jobs available, suggest waiting\n   * - `error`: An error occurred during processing\n   *\n   * @param queues - Queue names to process\n   * @yields WorkerCycle events\n   *\n   * @example\n   * ```typescript\n   * for await (const cycle of worker.process(['default'])) {\n   *   switch (cycle.type) {\n   *     case 'started':\n   *       console.log(`Started job ${cycle.job.id}`)\n   *       break\n   *     case 'completed':\n   *       console.log(`Completed job ${cycle.job.id}`)\n   *       break\n   *     case 'idle':\n   *       await sleep(cycle.suggestedDelay)\n   *       break\n   *   }\n   * }\n   * ```\n   */\n  async *process(queues: string[]): AsyncGenerator<WorkerCycle, void, unknown> {\n    this.#pool = new JobPool()\n\n    while (this.#running) {\n      try {\n        // Check for stalled jobs periodically\n        await this.#checkStalledJobs(queues)\n\n        yield* this.#fillPool(queues)\n\n        if (this.#pool.isEmpty()) {\n          yield { type: 'idle', suggestedDelay: this.#idleDelay }\n          continue\n        }\n\n        const completed = await this.#pool.waitForNextCompletion()\n        yield { type: 'completed', queue: completed.queue, job: completed.job }\n      } catch (error) {\n        yield {\n          type: 'error',\n          error: error as Error,\n          suggestedDelay: parse(DEFAULT_ERROR_RETRY_DELAY),\n        }\n      }\n    }\n  }\n\n  async *#fillPool(queues: string[]): AsyncGenerator<WorkerCycle, void, unknown> {\n    const slotsAvailable = this.#concurrency - this.#pool!.size\n\n    if (slotsAvailable <= 0) return\n\n    const popPromises = Array.from({ length: slotsAvailable }, () => this.#acquireNextJob(queues))\n\n    const results = await Promise.all(popPromises)\n\n    for (const result of results) {\n      if (!result) continue\n\n      const { job, queue } = result\n      const promise = this.#execute(job, queue)\n      this.#pool!.add(job, queue, promise)\n\n      yield { type: 'started', queue, job }\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    const { instance, options, timeout } = await this.#initJob(job, queue)\n\n    try {\n      await this.#executeWithTimeout(instance, timeout)\n      await this.#adapter.completeJob(job.id, queue)\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 isTimeout = e instanceof errors.E_JOB_TIMEOUT\n\n      if (isTimeout && options.failOnTimeout) {\n        debug('worker %s: job %s timed out and failOnTimeout is set', this.#id, job.id)\n        await this.#adapter.failJob(job.id, queue, e as Error)\n        await instance.failed?.(e as Error)\n        return\n      }\n\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        await this.#adapter.failJob(job.id, queue, e as Error)\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        await this.#adapter.failJob(job.id, queue, e as Error)\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.#adapter.retryJob(job.id, queue, nextRetryAt)\n        return\n      }\n\n      await this.#adapter.retryJob(job.id, queue)\n    }\n  }\n\n  async #initJob(\n    job: AcquiredJob,\n    queue: string\n  ): Promise<{ instance: Job; options: JobOptions; timeout: number | undefined }> {\n    try {\n      const JobClass = Locator.getOrThrow(job.name)\n\n      const context: JobContext = Object.freeze({\n        jobId: job.id,\n        name: job.name,\n        attempt: job.attempts + 1,\n        queue,\n        priority: job.priority ?? DEFAULT_PRIORITY,\n        acquiredAt: new Date(job.acquiredAt),\n        stalledCount: job.stalledCount ?? 0,\n      })\n\n      const jobFactory = QueueManager.getJobFactory()\n      const instance = jobFactory\n        ? await jobFactory(JobClass, job.payload, context)\n        : new JobClass(job.payload, context)\n      const options = JobClass.options || {}\n      const timeout = this.#getJobTimeout(options)\n\n      return { instance, options, timeout }\n    } catch (error) {\n      debug('worker %s: failed to initialize job %s (%s)', this.#id, job.id, job.name)\n      await this.#adapter.failJob(job.id, queue, error as Error)\n      throw error\n    }\n  }\n\n  #getJobTimeout(options: JobOptions): number | undefined {\n    if (options.timeout !== undefined) {\n      return parse(options.timeout)\n    }\n\n    if (this.#config.worker?.timeout !== undefined) {\n      return parse(this.#config.worker.timeout)\n    }\n\n    return undefined\n  }\n\n  async #executeWithTimeout(instance: Job, timeout?: number): Promise<void> {\n    if (!timeout) {\n      return instance.execute()\n    }\n\n    const signal = AbortSignal.timeout(timeout)\n\n    const abortPromise = new Promise<never>((_, reject) => {\n      signal.addEventListener('abort', () => {\n        reject(new errors.E_JOB_TIMEOUT([instance.constructor.name, timeout]))\n      })\n    })\n\n    await Promise.race([instance.execute(signal), abortPromise])\n  }\n\n  async #acquireNextJob(queues: string[]): Promise<{ job: AcquiredJob; queue: string } | null> {\n    for (const queue of queues) {\n      const job = await this.#adapter.popFrom(queue)\n\n      if (!job) {\n        continue\n      }\n\n      debug('worker %s: acquired job %s', this.#id, job.id)\n      return { job, queue }\n    }\n\n    return null\n  }\n\n  async #checkStalledJobs(queues: string[]): Promise<void> {\n    const now = Date.now()\n\n    // Only check if enough time has passed since last check\n    if (now - this.#lastStalledCheck < this.#stalledInterval) {\n      return\n    }\n\n    this.#lastStalledCheck = now\n\n    for (const queue of queues) {\n      const recovered = await this.#adapter.recoverStalledJobs(\n        queue,\n        this.#stalledThreshold,\n        this.#maxStalledCount\n      )\n\n      if (recovered > 0) {\n        debug('worker %s: recovered %d stalled jobs from queue %s', this.#id, recovered, queue)\n      }\n    }\n  }\n\n  #setupGracefulShutdown() {\n    if (!this.#gracefulShutdown) {\n      return\n    }\n\n    this.#shutdownHandler = async () => {\n      debug('received shutdown signal, stopping worker...')\n\n      if (this.#onShutdownSignal) {\n        await this.#onShutdownSignal()\n      }\n\n      await this.stop()\n    }\n\n    process.on('SIGINT', this.#shutdownHandler)\n    process.on('SIGTERM', this.#shutdownHandler)\n  }\n\n  #removeShutdownHandlers() {\n    if (this.#shutdownHandler) {\n      process.off('SIGINT', this.#shutdownHandler)\n      process.off('SIGTERM', this.#shutdownHandler)\n      this.#shutdownHandler = undefined\n    }\n  }\n}\n","import type { AcquiredJob } from './contracts/adapter.js'\n\n/**\n * Entry representing an active job in the pool.\n */\ninterface PoolEntry {\n  /** Promise that resolves when the job completes */\n  promise: Promise<void>\n  /** The acquired job data */\n  job: AcquiredJob\n  /** The queue this job came from */\n  queue: string\n}\n\n/**\n * Manages concurrent job execution with a fixed pool size.\n *\n * The pool tracks running jobs and returns the first one to complete,\n * allowing maximum throughput regardless of individual job duration:\n *\n * ```\n * Job A: ████████████████████░░░░░░░░░░  (slow - 10s)\n * Job B: ████ done                       (fast - 100ms) ← returns first\n * Job C: ████████████░░░░░░░░░░░░░░░░░░  (medium - 2s)\n *             ↑\n *      Slot freed, new job can start immediately\n * ```\n *\n * Key insight: slow jobs don't block the pool. As soon as any job\n * completes, its slot becomes available for new work.\n */\nexport class JobPool {\n  #activeJobs = new Map<string, PoolEntry>()\n\n  /** Number of currently running jobs */\n  get size() {\n    return this.#activeJobs.size\n  }\n\n  /**\n   * Check if the pool has no running jobs.\n   *\n   * @returns True if no jobs are running\n   */\n  isEmpty() {\n    return this.#activeJobs.size === 0\n  }\n\n  /**\n   * Check if the pool can accept more jobs.\n   *\n   * @param concurrency - Maximum number of concurrent jobs\n   * @returns True if there's room for more jobs\n   */\n  hasCapacity(concurrency: number) {\n    return this.#activeJobs.size < concurrency\n  }\n\n  /**\n   * Add a job to the pool.\n   *\n   * @param job - The acquired job data\n   * @param queue - The queue the job came from\n   * @param promise - Promise that resolves when the job completes\n   */\n  add(job: AcquiredJob, queue: string, promise: Promise<void>) {\n    this.#activeJobs.set(job.id, { promise, job, queue })\n  }\n\n  /**\n   * Wait for the next job to complete and return it.\n   *\n   * Uses `Promise.race()` internally, so the fastest job wins.\n   * The completed job is removed from the pool.\n   *\n   * @returns The first job to complete (success or failure)\n   */\n  async waitForNextCompletion(): Promise<PoolEntry> {\n    const completedJobId = await Promise.race(\n      [...this.#activeJobs.entries()].map(async ([id, { promise }]) => {\n        try {\n          await promise\n        } catch {\n          // Errors are handled in Worker#execute\n        }\n        return id\n      })\n    )\n\n    const completed = this.#activeJobs.get(completedJobId)!\n    this.#activeJobs.delete(completedJobId)\n\n    return completed\n  }\n\n  /**\n   * Wait for all running jobs to complete.\n   *\n   * Used during graceful shutdown to ensure no jobs are abandoned.\n   * Clears the pool after all jobs finish.\n   */\n  async drain(): Promise<void> {\n    const promises = [...this.#activeJobs.values()].map(async ({ promise }) => {\n      try {\n        await promise\n      } catch {\n        // Errors are handled in Worker#execute\n      }\n    })\n\n    await Promise.all(promises)\n    this.#activeJobs.clear()\n  }\n}\n","import type { BackoffConfig, Duration } from '../types/main.js'\nimport * as errors from '../exceptions.js'\nimport { parse } from '../utils.js'\nimport { RuntimeException } from '@poppinss/utils'\nimport { assertUnreachable } from '@poppinss/utils/assert'\n\n/**\n * Calculates retry delays using configurable strategies.\n *\n * Supports three built-in strategies:\n * - `exponential`: Delay doubles each attempt (1s, 2s, 4s, 8s, ...)\n * - `linear`: Delay increases linearly (5s, 10s, 15s, 20s, ...)\n * - `fixed`: Same delay every time (10s, 10s, 10s, ...)\n *\n * All strategies support:\n * - `maxDelay`: Cap the maximum delay\n * - `jitter`: Add randomness to prevent thundering herd\n *\n * @example\n * ```typescript\n * const strategy = new BackoffStrategy({\n *   strategy: 'exponential',\n *   baseDelay: '1s',\n *   maxDelay: '5m',\n *   multiplier: 2,\n *   jitter: true,\n * })\n *\n * strategy.calculateDelay(1) // ~1000ms\n * strategy.calculateDelay(2) // ~2000ms\n * strategy.calculateDelay(3) // ~4000ms\n * ```\n */\nexport class BackoffStrategy {\n  readonly #config: BackoffConfig\n\n  /**\n   * Create a new backoff strategy.\n   *\n   * @param config - Backoff configuration\n   * @throws {E_INVALID_BASE_DELAY} If baseDelay is not positive\n   * @throws {E_INVALID_MAX_DELAY} If maxDelay is invalid\n   * @throws {E_INVALID_MULTIPLIER} If multiplier is invalid\n   */\n  constructor(config: BackoffConfig) {\n    this.#config = config\n    this.#validateConfig()\n  }\n\n  /**\n   * Calculate the delay for a given attempt number.\n   *\n   * @param attempt - The attempt number (1-based)\n   * @returns Delay in milliseconds\n   * @throws {RuntimeException} If attempt is less than 1\n   *\n   * @example\n   * ```typescript\n   * // Exponential: 1s, 2s, 4s, 8s, 16s, ...\n   * strategy.calculateDelay(1) // 1000\n   * strategy.calculateDelay(2) // 2000\n   * strategy.calculateDelay(3) // 4000\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  /**\n   * Get the Date when the next retry should occur.\n   *\n   * @param attempt - The attempt number (1-based)\n   * @returns Date for the next retry\n   *\n   * @example\n   * ```typescript\n   * const nextRetry = strategy.getNextRetryAt(3)\n   * console.log(`Retry at: ${nextRetry.toISOString()}`)\n   * ```\n   */\n  getNextRetryAt(attempt: number): Date {\n    const delay = this.calculateDelay(attempt)\n    return new Date(Date.now() + delay)\n  }\n\n  /**\n   * Get a frozen copy of the configuration.\n   *\n   * @returns Readonly configuration object\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\n/**\n * Create an exponential backoff strategy factory.\n *\n * Delay doubles with each attempt: 1s → 2s → 4s → 8s → ...\n *\n * Default config:\n * - baseDelay: 1s\n * - maxDelay: 5m\n * - multiplier: 2\n * - jitter: true\n *\n * @param config - Optional overrides for default config\n * @returns Factory function for creating BackoffStrategy instances\n *\n * @example\n * ```typescript\n * const config = {\n *   retry: {\n *     maxRetries: 5,\n *     backoff: exponentialBackoff({ baseDelay: '500ms', maxDelay: '1m' }),\n *   },\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\n/**\n * Create a linear backoff strategy factory.\n *\n * Delay increases linearly: 5s → 10s → 15s → 20s → ...\n *\n * Default config:\n * - baseDelay: 5s\n * - maxDelay: 2m\n *\n * @param config - Optional overrides for default config\n * @returns Factory function for creating BackoffStrategy instances\n *\n * @example\n * ```typescript\n * const config = {\n *   retry: {\n *     maxRetries: 3,\n *     backoff: linearBackoff({ baseDelay: '10s' }),\n *   },\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\n/**\n * Create a fixed delay backoff strategy factory.\n *\n * Same delay every time: 10s → 10s → 10s → ...\n *\n * @param delay - The fixed delay (default: '10s')\n * @returns Factory function for creating BackoffStrategy instances\n *\n * @example\n * ```typescript\n * const config = {\n *   retry: {\n *     maxRetries: 3,\n *     backoff: fixedBackoff('30s'),\n *   },\n * }\n * ```\n */\nexport function fixedBackoff(delay: Duration = '10s') {\n  return () =>\n    new BackoffStrategy({\n      strategy: 'fixed',\n      baseDelay: delay,\n    })\n}\n\n/**\n * Create a custom backoff strategy factory.\n *\n * Use this when you need full control over the configuration.\n *\n * @param config - Complete backoff configuration\n * @returns Factory function for creating BackoffStrategy instances\n *\n * @example\n * ```typescript\n * const config = {\n *   retry: {\n *     maxRetries: 5,\n *     backoff: customBackoff({\n *       strategy: 'exponential',\n *       baseDelay: '100ms',\n *       maxDelay: '30s',\n *       multiplier: 3,\n *       jitter: false,\n *     }),\n *   },\n * }\n * ```\n */\nexport function customBackoff(config: BackoffConfig) {\n  return () => new BackoffStrategy(config)\n}\n"],"mappings":"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","names":["randomUUID","randomUUID"]}

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

@@ -1 +1 @@
-export { a as AcquiredJob, A as Adapter } from '../../job-Bd_c2lFK.js';
+export { a as AcquiredJob, A as Adapter } from '../../index-C3_tlebh.js';

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

@@ -1,5 +1,5 @@
 import { Knex } from 'knex';
-import { A as Adapter, a as AcquiredJob, b as JobData } from '../../job-Bd_c2lFK.js';
+import { A as Adapter, a as AcquiredJob, J as JobData } from '../../index-C3_tlebh.js';
 
 interface KnexAdapterOptions {
     connection: Knex;
@@ -38,6 +38,7 @@ declare class KnexAdapter implements Adapter {
     pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void>;
     size(): Promise<number>;
     sizeOf(queue: string): Promise<number>;
+    recoverStalledJobs(queue: string, stalledThreshold: number, maxStalledCount: number): Promise<number>;
 }
 
 export { KnexAdapter, type KnexAdapterOptions, knex };

package/build/src/drivers/knex_adapter.js

@@ -1,3 +1,10 @@
+import {
+  calculateScore
+} from "../../chunk-5PDDRF5O.js";
+import {
+  DEFAULT_PRIORITY
+} from "../../chunk-HMGNQSSG.js";
+
 // src/drivers/knex_adapter.ts
 import KnexPkg from "knex";
 function knex(config, tableName) {
@@ -62,7 +69,11 @@ var KnexAdapter = class {
     const now = Date.now();
     await this.#processDelayedJobs(queue, now);
     return this.#connection.transaction(async (trx) => {
-      const job = await trx(this.#tableName).where("queue", queue).where("status", "pending").orderBy("score", "asc").first();
+      let query = trx(this.#tableName).where("queue", queue).where("status", "pending").orderBy("score", "asc");
+      if (this.#supportsSkipLocked()) {
+        query = query.forUpdate().skipLocked();
+      }
+      const job = await query.first();
       if (!job) {
         return null;
       }
@@ -78,19 +89,34 @@ var KnexAdapter = class {
       };
     });
   }
+  /**
+   * Check if the database supports FOR UPDATE SKIP LOCKED.
+   * PostgreSQL 9.5+, MySQL 8.0+, and MariaDB 10.6+ support it.
+   * SQLite does not, but it's single-writer so it doesn't need it.
+   */
+  #supportsSkipLocked() {
+    const client = this.#connection.client.config.client;
+    return client === "pg" || client === "mysql" || client === "mysql2" || client === "mariadb";
+  }
   async #processDelayedJobs(queue, now) {
-    const delayedJobs = await this.#connection(this.#tableName).where("queue", queue).where("status", "delayed").where("execute_at", "<=", now).select("id", "data");
-    if (delayedJobs.length === 0) return;
-    for (const job of delayedJobs) {
-      const jobData = JSON.parse(job.data);
-      const priority = jobData.priority ?? 5;
-      const score = priority * 1e13 + now;
-      await this.#connection(this.#tableName).where("id", job.id).where("queue", queue).update({
-        status: "pending",
-        score,
-        execute_at: null
-      });
-    }
+    await this.#connection.transaction(async (trx) => {
+      let query = trx(this.#tableName).where("queue", queue).where("status", "delayed").where("execute_at", "<=", now).select("id", "data");
+      if (this.#supportsSkipLocked()) {
+        query = query.forUpdate().skipLocked();
+      }
+      const delayedJobs = await query;
+      if (delayedJobs.length === 0) return;
+      for (const job of delayedJobs) {
+        const jobData = JSON.parse(job.data);
+        const priority = jobData.priority ?? DEFAULT_PRIORITY;
+        const score = calculateScore(priority, now);
+        await trx(this.#tableName).where("id", job.id).where("queue", queue).update({
+          status: "pending",
+          score,
+          execute_at: null
+        });
+      }
+    });
   }
   async completeJob(jobId, queue) {
     await this.#ensureTableExists();
@@ -118,8 +144,8 @@ var KnexAdapter = class {
         execute_at: retryAt.getTime()
       });
     } else {
-      const priority = jobData.priority ?? 5;
-      const score = priority * 1e13 + now;
+      const priority = jobData.priority ?? DEFAULT_PRIORITY;
+      const score = calculateScore(priority, now);
       await this.#connection(this.#tableName).where("id", jobId).where("queue", queue).update({
         status: "pending",
         data: updatedData,
@@ -135,9 +161,9 @@ var KnexAdapter = class {
   }
   async pushOn(queue, jobData) {
     await this.#ensureTableExists();
-    const priority = jobData.priority ?? 5;
+    const priority = jobData.priority ?? DEFAULT_PRIORITY;
     const timestamp = Date.now();
-    const score = priority * 1e13 + timestamp;
+    const score = calculateScore(priority, timestamp);
     await this.#connection(this.#tableName).insert({
       id: jobData.id,
       queue,
@@ -168,6 +194,39 @@ var KnexAdapter = class {
     const result = await this.#connection(this.#tableName).where("queue", queue).where("status", "pending").count("* as count").first();
     return Number(result?.count ?? 0);
   }
+  async recoverStalledJobs(queue, stalledThreshold, maxStalledCount) {
+    await this.#ensureTableExists();
+    const now = Date.now();
+    const stalledCutoff = now - stalledThreshold;
+    return this.#connection.transaction(async (trx) => {
+      let recovered = 0;
+      let query = trx(this.#tableName).where("queue", queue).where("status", "active").where("acquired_at", "<", stalledCutoff).select("id", "data");
+      if (this.#supportsSkipLocked()) {
+        query = query.forUpdate().skipLocked();
+      }
+      const stalledJobs = await query;
+      for (const row of stalledJobs) {
+        const jobData = JSON.parse(row.data);
+        const currentStalledCount = jobData.stalledCount ?? 0;
+        if (currentStalledCount >= maxStalledCount) {
+          await trx(this.#tableName).where("id", row.id).where("queue", queue).delete();
+        } else {
+          jobData.stalledCount = currentStalledCount + 1;
+          const priority = jobData.priority ?? DEFAULT_PRIORITY;
+          const score = calculateScore(priority, now);
+          await trx(this.#tableName).where("id", row.id).where("queue", queue).update({
+            status: "pending",
+            data: JSON.stringify(jobData),
+            worker_id: null,
+            acquired_at: null,
+            score
+          });
+          recovered++;
+        }
+      }
+      return recovered;
+    });
+  }
 };
 export {
   KnexAdapter,

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/drivers/knex_adapter.ts"],"sourcesContent":["import KnexPkg from 'knex'\nimport type { Knex } from 'knex'\nimport type { Adapter, AcquiredJob } from '../contracts/adapter.js'\nimport type { JobData } from '../types/main.js'\n\nexport interface KnexAdapterOptions {\n  connection: Knex\n  tableName?: string\n  ownsConnection?: boolean\n}\n\ntype KnexConfig = Knex | Knex.Config\n\n/**\n * Create a new Knex adapter factory.\n * Accepts either a Knex instance or a Knex configuration object.\n *\n * When passing a config object, the adapter will create and manage\n * the connection lifecycle (closing it on destroy).\n *\n * When passing a Knex instance, the caller is responsible for\n * managing the connection lifecycle.\n */\nexport function knex(config: KnexConfig, tableName?: string) {\n  return () => {\n    const isKnexInstance = typeof config === 'function'\n    const connection = isKnexInstance ? config : KnexPkg(config)\n    return new KnexAdapter({ connection, tableName, ownsConnection: !isKnexInstance })\n  }\n}\n\n/**\n * Knex adapter for the queue system.\n * Stores jobs in a SQL database using Knex.\n */\nexport class KnexAdapter implements Adapter {\n  readonly #connection: Knex\n  readonly #tableName: string\n  readonly #ownsConnection: boolean\n  #workerId: string = ''\n  #initialized: boolean = false\n\n  constructor(config: KnexAdapterOptions) {\n    this.#connection = config.connection\n    this.#tableName = config.tableName ?? 'queue_jobs'\n    this.#ownsConnection = config.ownsConnection ?? false\n  }\n\n  setWorkerId(workerId: string): void {\n    this.#workerId = workerId\n  }\n\n  /**\n   * Ensure the jobs table exists.\n   * Creates it if not exists, handles race conditions.\n   */\n  async #ensureTableExists(): Promise<void> {\n    if (this.#initialized) return\n\n    try {\n      await this.#connection.schema.createTable(this.#tableName, (table) => {\n        table.string('id', 255).notNullable()\n        table.string('queue', 255).notNullable()\n        table.enu('status', ['pending', 'active', 'delayed']).notNullable()\n        table.text('data').notNullable()\n        table.bigint('score').unsigned().nullable()\n        table.string('worker_id', 255).nullable()\n        table.bigint('acquired_at').unsigned().nullable()\n        table.bigint('execute_at').unsigned().nullable()\n        table.primary(['id', 'queue'])\n        table.index(['queue', 'status', 'score'])\n        table.index(['queue', 'status', 'execute_at'])\n      })\n    } catch {\n      /**\n       * If table creation fails, verify the table actually exists.\n       * This handles race conditions where multiple instances try to create\n       * the table simultaneously.\n       */\n      const hasTable = await this.#connection.schema.hasTable(this.#tableName)\n      if (!hasTable) {\n        throw new Error(`Failed to create table \"${this.#tableName}\"`)\n      }\n    }\n\n    this.#initialized = true\n  }\n\n  async destroy(): Promise<void> {\n    if (this.#ownsConnection) {\n      await this.#connection.destroy()\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    await this.#ensureTableExists()\n\n    const now = Date.now()\n\n    // First, move ready delayed jobs to pending\n    await this.#processDelayedJobs(queue, now)\n\n    // Use a transaction to atomically pop a job\n    return this.#connection.transaction(async (trx) => {\n      // Select the highest priority job (lowest score)\n      const job = await trx(this.#tableName)\n        .where('queue', queue)\n        .where('status', 'pending')\n        .orderBy('score', 'asc')\n        .first()\n\n      if (!job) {\n        return null\n      }\n\n      // Update job to active status\n      await trx(this.#tableName)\n        .where('id', job.id)\n        .where('queue', queue)\n        .update({\n          status: 'active',\n          worker_id: this.#workerId,\n          acquired_at: now,\n        })\n\n      const jobData: JobData = JSON.parse(job.data)\n\n      return {\n        ...jobData,\n        acquiredAt: now,\n      }\n    })\n  }\n\n  async #processDelayedJobs(queue: string, now: number): Promise<void> {\n    // Get all ready delayed jobs\n    const delayedJobs = await this.#connection(this.#tableName)\n      .where('queue', queue)\n      .where('status', 'delayed')\n      .where('execute_at', '<=', now)\n      .select('id', 'data')\n\n    if (delayedJobs.length === 0) return\n\n    // Move them to pending\n    for (const job of delayedJobs) {\n      const jobData: JobData = JSON.parse(job.data)\n      const priority = jobData.priority ?? 5\n      const score = priority * 1e13 + now\n\n      await this.#connection(this.#tableName)\n        .where('id', job.id)\n        .where('queue', queue)\n        .update({\n          status: 'pending',\n          score,\n          execute_at: null,\n        })\n    }\n  }\n\n  async completeJob(jobId: string, queue: string): Promise<void> {\n    await this.#ensureTableExists()\n\n    await this.#connection(this.#tableName)\n      .where('id', jobId)\n      .where('queue', queue)\n      .delete()\n  }\n\n  async failJob(jobId: string, queue: string, _error?: Error): Promise<void> {\n    await this.#ensureTableExists()\n\n    await this.#connection(this.#tableName)\n      .where('id', jobId)\n      .where('queue', queue)\n      .delete()\n  }\n\n  async retryJob(jobId: string, queue: string, retryAt?: Date): Promise<void> {\n    await this.#ensureTableExists()\n\n    const now = Date.now()\n\n    // Get the active job\n    const activeJob = await this.#connection(this.#tableName)\n      .where('id', jobId)\n      .where('queue', queue)\n      .where('status', 'active')\n      .first()\n\n    if (!activeJob) return\n\n    const jobData: JobData = JSON.parse(activeJob.data)\n    jobData.attempts = (jobData.attempts || 0) + 1\n\n    const updatedData = JSON.stringify(jobData)\n\n    if (retryAt && retryAt.getTime() > now) {\n      // Move to delayed\n      await this.#connection(this.#tableName)\n        .where('id', jobId)\n        .where('queue', queue)\n        .update({\n          status: 'delayed',\n          data: updatedData,\n          worker_id: null,\n          acquired_at: null,\n          score: null,\n          execute_at: retryAt.getTime(),\n        })\n    } else {\n      // Move back to pending\n      const priority = jobData.priority ?? 5\n      const score = priority * 1e13 + now\n\n      await this.#connection(this.#tableName)\n        .where('id', jobId)\n        .where('queue', queue)\n        .update({\n          status: 'pending',\n          data: updatedData,\n          worker_id: null,\n          acquired_at: null,\n          score,\n          execute_at: null,\n        })\n    }\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    await this.#ensureTableExists()\n\n    const priority = jobData.priority ?? 5\n    const timestamp = Date.now()\n    const score = priority * 1e13 + timestamp\n\n    await this.#connection(this.#tableName).insert({\n      id: jobData.id,\n      queue,\n      status: 'pending',\n      data: JSON.stringify(jobData),\n      score,\n    })\n  }\n\n  async 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    await this.#ensureTableExists()\n\n    const executeAt = Date.now() + delay\n\n    await this.#connection(this.#tableName).insert({\n      id: jobData.id,\n      queue,\n      status: 'delayed',\n      data: JSON.stringify(jobData),\n      execute_at: executeAt,\n    })\n  }\n\n  async size(): Promise<number> {\n    return this.sizeOf('default')\n  }\n\n  async sizeOf(queue: string): Promise<number> {\n    await this.#ensureTableExists()\n\n    const result = await this.#connection(this.#tableName)\n      .where('queue', queue)\n      .where('status', 'pending')\n      .count('* as count')\n      .first()\n\n    return Number(result?.count ?? 0)\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/drivers/knex_adapter.ts"],"sourcesContent":["import KnexPkg from 'knex'\nimport type { Knex } from 'knex'\nimport type { Adapter, AcquiredJob } from '../contracts/adapter.js'\nimport type { JobData } from '../types/main.js'\nimport { DEFAULT_PRIORITY } from '../constants.js'\nimport { calculateScore } from '../utils.js'\n\nexport interface KnexAdapterOptions {\n  connection: Knex\n  tableName?: string\n  ownsConnection?: boolean\n}\n\ntype KnexConfig = Knex | Knex.Config\n\n/**\n * Create a new Knex adapter factory.\n * Accepts either a Knex instance or a Knex configuration object.\n *\n * When passing a config object, the adapter will create and manage\n * the connection lifecycle (closing it on destroy).\n *\n * When passing a Knex instance, the caller is responsible for\n * managing the connection lifecycle.\n */\nexport function knex(config: KnexConfig, tableName?: string) {\n  return () => {\n    const isKnexInstance = typeof config === 'function'\n    const connection = isKnexInstance ? config : KnexPkg(config)\n    return new KnexAdapter({ connection, tableName, ownsConnection: !isKnexInstance })\n  }\n}\n\n/**\n * Knex adapter for the queue system.\n * Stores jobs in a SQL database using Knex.\n */\nexport class KnexAdapter implements Adapter {\n  readonly #connection: Knex\n  readonly #tableName: string\n  readonly #ownsConnection: boolean\n  #workerId: string = ''\n  #initialized: boolean = false\n\n  constructor(config: KnexAdapterOptions) {\n    this.#connection = config.connection\n    this.#tableName = config.tableName ?? 'queue_jobs'\n    this.#ownsConnection = config.ownsConnection ?? false\n  }\n\n  setWorkerId(workerId: string): void {\n    this.#workerId = workerId\n  }\n\n  /**\n   * Ensure the jobs table exists.\n   * Creates it if not exists, handles race conditions.\n   */\n  async #ensureTableExists(): Promise<void> {\n    if (this.#initialized) return\n\n    try {\n      await this.#connection.schema.createTable(this.#tableName, (table) => {\n        table.string('id', 255).notNullable()\n        table.string('queue', 255).notNullable()\n        table.enu('status', ['pending', 'active', 'delayed']).notNullable()\n        table.text('data').notNullable()\n        table.bigint('score').unsigned().nullable()\n        table.string('worker_id', 255).nullable()\n        table.bigint('acquired_at').unsigned().nullable()\n        table.bigint('execute_at').unsigned().nullable()\n        table.primary(['id', 'queue'])\n        table.index(['queue', 'status', 'score'])\n        table.index(['queue', 'status', 'execute_at'])\n      })\n    } catch {\n      /**\n       * If table creation fails, verify the table actually exists.\n       * This handles race conditions where multiple instances try to create\n       * the table simultaneously.\n       */\n      const hasTable = await this.#connection.schema.hasTable(this.#tableName)\n      if (!hasTable) {\n        throw new Error(`Failed to create table \"${this.#tableName}\"`)\n      }\n    }\n\n    this.#initialized = true\n  }\n\n  async destroy(): Promise<void> {\n    if (this.#ownsConnection) {\n      await this.#connection.destroy()\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    await this.#ensureTableExists()\n\n    const now = Date.now()\n\n    // First, move ready delayed jobs to pending\n    await this.#processDelayedJobs(queue, now)\n\n    // Use a transaction to atomically pop a job\n    return this.#connection.transaction(async (trx) => {\n      // Build the query for highest priority job (lowest score)\n      let query = trx(this.#tableName)\n        .where('queue', queue)\n        .where('status', 'pending')\n        .orderBy('score', 'asc')\n\n      if (this.#supportsSkipLocked()) {\n        query = query.forUpdate().skipLocked()\n      }\n\n      const job = await query.first()\n\n      if (!job) {\n        return null\n      }\n\n      // Update job to active status\n      await trx(this.#tableName).where('id', job.id).where('queue', queue).update({\n        status: 'active',\n        worker_id: this.#workerId,\n        acquired_at: now,\n      })\n\n      const jobData: JobData = JSON.parse(job.data)\n\n      return {\n        ...jobData,\n        acquiredAt: now,\n      }\n    })\n  }\n\n  /**\n   * Check if the database supports FOR UPDATE SKIP LOCKED.\n   * PostgreSQL 9.5+, MySQL 8.0+, and MariaDB 10.6+ support it.\n   * SQLite does not, but it's single-writer so it doesn't need it.\n   */\n  #supportsSkipLocked(): boolean {\n    const client = this.#connection.client.config.client\n    return client === 'pg' || client === 'mysql' || client === 'mysql2' || client === 'mariadb'\n  }\n\n  async #processDelayedJobs(queue: string, now: number): Promise<void> {\n    // Use a transaction with row locking to prevent race conditions\n    await this.#connection.transaction(async (trx) => {\n      let query = trx(this.#tableName)\n        .where('queue', queue)\n        .where('status', 'delayed')\n        .where('execute_at', '<=', now)\n        .select('id', 'data')\n\n      if (this.#supportsSkipLocked()) {\n        query = query.forUpdate().skipLocked()\n      }\n\n      const delayedJobs = await query\n\n      if (delayedJobs.length === 0) return\n\n      // Move them to pending\n      for (const job of delayedJobs) {\n        const jobData: JobData = JSON.parse(job.data)\n        const priority = jobData.priority ?? DEFAULT_PRIORITY\n        const score = calculateScore(priority, now)\n\n        await trx(this.#tableName).where('id', job.id).where('queue', queue).update({\n          status: 'pending',\n          score,\n          execute_at: null,\n        })\n      }\n    })\n  }\n\n  async completeJob(jobId: string, queue: string): Promise<void> {\n    await this.#ensureTableExists()\n\n    await this.#connection(this.#tableName).where('id', jobId).where('queue', queue).delete()\n  }\n\n  async failJob(jobId: string, queue: string, _error?: Error): Promise<void> {\n    await this.#ensureTableExists()\n\n    await this.#connection(this.#tableName).where('id', jobId).where('queue', queue).delete()\n  }\n\n  async retryJob(jobId: string, queue: string, retryAt?: Date): Promise<void> {\n    await this.#ensureTableExists()\n\n    const now = Date.now()\n\n    // Get the active job\n    const activeJob = await this.#connection(this.#tableName)\n      .where('id', jobId)\n      .where('queue', queue)\n      .where('status', 'active')\n      .first()\n\n    if (!activeJob) return\n\n    const jobData: JobData = JSON.parse(activeJob.data)\n    jobData.attempts = (jobData.attempts || 0) + 1\n\n    const updatedData = JSON.stringify(jobData)\n\n    if (retryAt && retryAt.getTime() > now) {\n      // Move to delayed\n      await this.#connection(this.#tableName).where('id', jobId).where('queue', queue).update({\n        status: 'delayed',\n        data: updatedData,\n        worker_id: null,\n        acquired_at: null,\n        score: null,\n        execute_at: retryAt.getTime(),\n      })\n    } else {\n      // Move back to pending\n      const priority = jobData.priority ?? DEFAULT_PRIORITY\n      const score = calculateScore(priority, now)\n\n      await this.#connection(this.#tableName).where('id', jobId).where('queue', queue).update({\n        status: 'pending',\n        data: updatedData,\n        worker_id: null,\n        acquired_at: null,\n        score,\n        execute_at: null,\n      })\n    }\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    await this.#ensureTableExists()\n\n    const priority = jobData.priority ?? DEFAULT_PRIORITY\n    const timestamp = Date.now()\n    const score = calculateScore(priority, timestamp)\n\n    await this.#connection(this.#tableName).insert({\n      id: jobData.id,\n      queue,\n      status: 'pending',\n      data: JSON.stringify(jobData),\n      score,\n    })\n  }\n\n  async 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    await this.#ensureTableExists()\n\n    const executeAt = Date.now() + delay\n\n    await this.#connection(this.#tableName).insert({\n      id: jobData.id,\n      queue,\n      status: 'delayed',\n      data: JSON.stringify(jobData),\n      execute_at: executeAt,\n    })\n  }\n\n  async size(): Promise<number> {\n    return this.sizeOf('default')\n  }\n\n  async sizeOf(queue: string): Promise<number> {\n    await this.#ensureTableExists()\n\n    const result = await this.#connection(this.#tableName)\n      .where('queue', queue)\n      .where('status', 'pending')\n      .count('* as count')\n      .first()\n\n    return Number(result?.count ?? 0)\n  }\n\n  async recoverStalledJobs(\n    queue: string,\n    stalledThreshold: number,\n    maxStalledCount: number\n  ): Promise<number> {\n    await this.#ensureTableExists()\n\n    const now = Date.now()\n    const stalledCutoff = now - stalledThreshold\n\n    // Use a transaction with row locking to prevent race conditions\n    return this.#connection.transaction(async (trx) => {\n      let recovered = 0\n\n      let query = trx(this.#tableName)\n        .where('queue', queue)\n        .where('status', 'active')\n        .where('acquired_at', '<', stalledCutoff)\n        .select('id', 'data')\n\n      if (this.#supportsSkipLocked()) {\n        query = query.forUpdate().skipLocked()\n      }\n\n      const stalledJobs = await query\n\n      for (const row of stalledJobs) {\n        const jobData: JobData = JSON.parse(row.data)\n        const currentStalledCount = jobData.stalledCount ?? 0\n\n        if (currentStalledCount >= maxStalledCount) {\n          // Fail permanently - remove the job\n          await trx(this.#tableName).where('id', row.id).where('queue', queue).delete()\n        } else {\n          // Recover: increment stalledCount and put back in pending\n          jobData.stalledCount = currentStalledCount + 1\n          const priority = jobData.priority ?? DEFAULT_PRIORITY\n          const score = calculateScore(priority, now)\n\n          await trx(this.#tableName)\n            .where('id', row.id)\n            .where('queue', queue)\n            .update({\n              status: 'pending',\n              data: JSON.stringify(jobData),\n              worker_id: null,\n              acquired_at: null,\n              score,\n            })\n\n          recovered++\n        }\n      }\n\n      return recovered\n    })\n  }\n}\n"],"mappings":"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","names":[]}

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

@@ -1,5 +1,5 @@
 import { Redis, RedisOptions } from 'ioredis';
-import { A as Adapter, a as AcquiredJob, b as JobData } from '../../job-Bd_c2lFK.js';
+import { A as Adapter, a as AcquiredJob, J as JobData } from '../../index-C3_tlebh.js';
 
 type RedisConfig = Redis | RedisOptions;
 /**
@@ -20,7 +20,6 @@ declare class RedisAdapter implements Adapter {
     destroy(): Promise<void>;
     pop(): Promise<AcquiredJob | null>;
     popFrom(queue: string): Promise<AcquiredJob | null>;
-    popAndWait(queue: string, timeout: number): Promise<AcquiredJob | null>;
     completeJob(jobId: string, queue: string): Promise<void>;
     failJob(jobId: string, queue: string, _error?: Error): Promise<void>;
     retryJob(jobId: string, queue: string, retryAt?: Date): Promise<void>;
@@ -30,6 +29,7 @@ declare class RedisAdapter implements Adapter {
     pushOn(queue: string, jobData: JobData): Promise<void>;
     size(): Promise<number>;
     sizeOf(queue: string): Promise<number>;
+    recoverStalledJobs(queue: string, stalledThreshold: number, maxStalledCount: number): Promise<number>;
 }
 
 export { RedisAdapter, redis };

package/build/src/drivers/redis_adapter.js

@@ -1,3 +1,10 @@
+import {
+  calculateScore
+} from "../../chunk-5PDDRF5O.js";
+import {
+  DEFAULT_PRIORITY
+} from "../../chunk-HMGNQSSG.js";
+
 // src/drivers/redis_adapter.ts
 import { Redis } from "ioredis";
 var redisKey = "jobs";
@@ -14,6 +21,8 @@ var ACQUIRE_JOB_SCRIPT = `
     for i = 1, #ready_jobs do
       local job_data = ready_jobs[i]
       local job = cjson.decode(job_data)
+      -- Score = priority * 1e13 + timestamp
+      -- Lower score = higher priority, FIFO within same priority
       local priority = job.priority or 5
       local timestamp = tonumber(now)
       local score = priority * 10000000000000 + timestamp
@@ -86,6 +95,8 @@ var RETRY_JOB_SCRIPT = `
   if retry_at and retry_at > now then
     redis.call('ZADD', delayed_key, retry_at, job_data)
   else
+    -- Score = priority * 1e13 + timestamp
+    -- Lower score = higher priority, FIFO within same priority
     local priority = job.priority or 5
     local score = priority * 10000000000000 + now
     redis.call('ZADD', pending_key, score, job_data)
@@ -93,6 +104,52 @@ var RETRY_JOB_SCRIPT = `
 
   return 1
 `;
+var RECOVER_STALLED_JOBS_SCRIPT = `
+  local active_key = KEYS[1]
+  local pending_key = KEYS[2]
+  local now = tonumber(ARGV[1])
+  local stalled_threshold = tonumber(ARGV[2])
+  local max_stalled_count = tonumber(ARGV[3])
+
+  local recovered = 0
+  local stalled_cutoff = now - stalled_threshold
+
+  -- Get all active jobs
+  local active_jobs = redis.call('HGETALL', active_key)
+
+  -- HGETALL returns [field1, value1, field2, value2, ...]
+  for i = 1, #active_jobs, 2 do
+    local job_id = active_jobs[i]
+    local active_data = active_jobs[i + 1]
+    local active = cjson.decode(active_data)
+
+    -- Check if job is stalled
+    if active.acquiredAt < stalled_cutoff then
+      local job = active.data
+      local current_stalled_count = job.stalledCount or 0
+
+      -- Remove from active hash
+      redis.call('HDEL', active_key, job_id)
+
+      -- Check if job has exceeded max stalled count
+      if current_stalled_count >= max_stalled_count then
+        -- Job failed permanently, just remove (already done above)
+      else
+        -- Recover: increment stalledCount and put back in pending
+        job.stalledCount = current_stalled_count + 1
+        local job_data = cjson.encode(job)
+        -- Score = priority * 1e13 + timestamp
+        -- Lower score = higher priority, FIFO within same priority
+        local priority = job.priority or 5
+        local score = priority * 10000000000000 + now
+        redis.call('ZADD', pending_key, score, job_data)
+        recovered = recovered + 1
+      end
+    end
+  end
+
+  return recovered
+`;
 function redis(config) {
   return () => {
     if (config instanceof Redis) {
@@ -147,31 +204,6 @@ var RedisAdapter = class {
     }
     return JSON.parse(result);
   }
-  async popAndWait(queue, timeout) {
-    const immediate = await this.popFrom(queue);
-    if (immediate) {
-      return immediate;
-    }
-    const pendingKey = `${redisKey}::${queue}`;
-    const activeKey = `${redisKey}::${queue}::active`;
-    const now = Date.now();
-    const result = await this.#connection.bzpopmin(pendingKey, timeout / 1e3);
-    if (!result) {
-      return null;
-    }
-    const [, jobData] = result;
-    const job = JSON.parse(jobData);
-    const activeData = JSON.stringify({
-      workerId: this.#workerId,
-      acquiredAt: now,
-      data: job
-    });
-    await this.#connection.hset(activeKey, job.id, activeData);
-    return {
-      ...job,
-      acquiredAt: now
-    };
-  }
   async completeJob(jobId, queue) {
     const activeKey = `${redisKey}::${queue}::active`;
     await this.#connection.eval(COMPLETE_JOB_SCRIPT, 1, activeKey, jobId);
@@ -208,9 +240,9 @@ var RedisAdapter = class {
     await this.#connection.zadd(delayedKey, executeAt, JSON.stringify(jobData));
   }
   async pushOn(queue, jobData) {
-    const priority = jobData.priority ?? 5;
+    const priority = jobData.priority ?? DEFAULT_PRIORITY;
     const timestamp = Date.now();
-    const score = priority * 1e13 + timestamp;
+    const score = calculateScore(priority, timestamp);
     await this.#connection.zadd(`${redisKey}::${queue}`, score, JSON.stringify(jobData));
   }
   size() {
@@ -219,6 +251,21 @@ var RedisAdapter = class {
   sizeOf(queue) {
     return this.#connection.zcard(`${redisKey}::${queue}`);
   }
+  async recoverStalledJobs(queue, stalledThreshold, maxStalledCount) {
+    const now = Date.now();
+    const activeKey = `${redisKey}::${queue}::active`;
+    const pendingKey = `${redisKey}::${queue}`;
+    const recovered = await this.#connection.eval(
+      RECOVER_STALLED_JOBS_SCRIPT,
+      2,
+      activeKey,
+      pendingKey,
+      now.toString(),
+      stalledThreshold.toString(),
+      maxStalledCount.toString()
+    );
+    return recovered;
+  }
 };
 export {
   RedisAdapter,