@boringnode/queue 0.2.0 → 0.3.1

package/build/{chunk-RIXMQXYJ.js → chunk-LI2ZMCNO.js}

@@ -179,6 +179,7 @@ var QueueManagerSingleton = class {
   #adapters = {};
   #adapterInstances = /* @__PURE__ */ new Map();
   #globalRetryConfig;
+  #globalJobOptions;
   #queueConfigs = /* @__PURE__ */ new Map();
   #logger = consoleLogger;
   #jobFactory;
@@ -213,6 +214,7 @@ var QueueManagerSingleton = class {
     this.#defaultAdapter = config.default;
     this.#adapters = config.adapters;
     this.#globalRetryConfig = config.retry;
+    this.#globalJobOptions = config.defaultJobOptions;
     this.#logger = config.logger ?? consoleLogger;
     this.#jobFactory = config.jobFactory;
     if (config.queues) {
@@ -309,6 +311,17 @@ var QueueManagerSingleton = class {
   getJobFactory() {
     return this.#jobFactory;
   }
+  /**
+   * Get the merged job options for a job (priority: job > queue > global).
+   */
+  getMergedJobOptions(queue, jobOptions) {
+    const queueConfig = this.#queueConfigs.get(queue);
+    const queueJobOptions = queueConfig?.defaultJobOptions;
+    return {
+      removeOnComplete: jobOptions?.removeOnComplete ?? queueJobOptions?.removeOnComplete ?? this.#globalJobOptions?.removeOnComplete,
+      removeOnFail: jobOptions?.removeOnFail ?? queueJobOptions?.removeOnFail ?? this.#globalJobOptions?.removeOnFail
+    };
+  }
   #validateConfig(config) {
     if (!config.adapters || Object.keys(config.adapters).length === 0) {
       throw new E_CONFIGURATION_ERROR(["At least one adapter must be configured"]);
@@ -355,4 +368,4 @@ export {
   Locator,
   QueueManager
 };
-//# sourceMappingURL=chunk-RIXMQXYJ.js.map
+//# sourceMappingURL=chunk-LI2ZMCNO.js.map

package/build/chunk-LI2ZMCNO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/debug.ts","../src/locator.ts","../src/logger.ts","../src/queue_manager.ts"],"sourcesContent":["import { debuglog } from 'node:util'\n\nexport default debuglog('boringnode:queue')\n","import { Job } from './job.js'\nimport * as errors from './exceptions.js'\nimport type { JobClass } from './types/main.js'\nimport debug from './debug.js'\nimport { glob } from 'node:fs/promises'\nimport { resolve } from 'node:path'\n\n/**\n * Job class registry.\n *\n * The Locator maintains a mapping of job names to their classes,\n * allowing the Worker to instantiate jobs by name when processing.\n *\n * Jobs are typically registered automatically via `QueueManager.init()`\n * using the `locations` config option, but can also be registered manually.\n *\n * @example\n * ```typescript\n * import { Locator } from '@boringnode/queue'\n * import SendEmailJob from './jobs/send_email_job.js'\n *\n * // Manual registration\n * Locator.register('SendEmailJob', SendEmailJob)\n *\n * // Auto-registration via glob (used by QueueManager.init)\n * await Locator.registerFromGlob(['./jobs/**\\/*.js'])\n *\n * // Retrieve a job class\n * const JobClass = Locator.getOrThrow('SendEmailJob')\n * ```\n */\nclass LocatorSingleton {\n  #registry = new Map<string, JobClass>()\n\n  /**\n   * Register a job class with a given name.\n   *\n   * @param name - The job name (usually the class name)\n   * @param JobClass - The job class constructor\n   *\n   * @example\n   * ```typescript\n   * Locator.register('SendEmailJob', SendEmailJob)\n   * ```\n   */\n  register<T extends Job>(name: string, JobClass: JobClass<T>) {\n    debug('registering job: %s', name)\n\n    this.#registry.set(name, JobClass)\n  }\n\n  /**\n   * Auto-register job classes from files matching glob patterns.\n   *\n   * Each file should have a default export that is a Job class.\n   * The class name is used as the registration name.\n   *\n   * @param patterns - Glob patterns to match job files\n   * @returns Number of jobs successfully registered\n   *\n   * @example\n   * ```typescript\n   * const count = await Locator.registerFromGlob([\n   *   './jobs/**\\/*.js',\n   *   './app/jobs/**\\/*.ts'\n   * ])\n   * console.log(`Registered ${count} jobs`)\n   * ```\n   */\n  async registerFromGlob(patterns: string[]): Promise<number> {\n    let registered = 0\n\n    for (const pattern of patterns) {\n      debug('registering jobs from glob pattern: %s', pattern)\n      for await (const file of glob(pattern)) {\n        debug('found job file: %s', file)\n\n        try {\n          const absolutePath = resolve(file)\n          const module = await import(`file://${absolutePath}`)\n          const JobClass = module.default as JobClass\n\n          if (JobClass && typeof JobClass === 'function') {\n            const jobName = JobClass.options?.name || JobClass.name\n            this.register(jobName, JobClass)\n            registered++\n          }\n        } catch (error) {\n          console.warn(`Failed to load job from ${file}:`, error)\n        }\n      }\n    }\n\n    return registered\n  }\n\n  /**\n   * Get a job class by name.\n   *\n   * @param name - The job name to look up\n   * @returns The job class, or undefined if not found\n   *\n   * @example\n   * ```typescript\n   * const JobClass = Locator.get('SendEmailJob')\n   * if (JobClass) {\n   *   const instance = new JobClass(payload)\n   * }\n   * ```\n   */\n  get<T extends Job = Job>(name: string): JobClass<T> | undefined {\n    return this.#registry.get(name) as JobClass<T> | undefined\n  }\n\n  /**\n   * Get a job class by name, throwing if not found.\n   *\n   * @param name - The job name to look up\n   * @returns The job class\n   * @throws {E_JOB_NOT_FOUND} If the job is not registered\n   *\n   * @example\n   * ```typescript\n   * const JobClass = Locator.getOrThrow('SendEmailJob')\n   * const instance = new JobClass(payload)\n   * ```\n   */\n  getOrThrow<T extends Job = Job>(name: string): JobClass<T> {\n    const JobClass = this.get<T>(name)\n\n    if (!JobClass) {\n      throw new errors.E_JOB_NOT_FOUND([name])\n    }\n\n    return JobClass\n  }\n\n  /**\n   * Remove all registered jobs.\n   *\n   * Primarily useful for testing.\n   */\n  clear(): void {\n    this.#registry.clear()\n  }\n}\n\n/** Global job class registry singleton */\nexport const Locator = new LocatorSingleton()\n","export interface LogObject {\n  [key: string]: unknown\n}\n\nexport interface ErrorObject extends LogObject {\n  err?: Error\n}\n\nexport interface Logger {\n  trace(msg: string): void\n  trace(obj: LogObject, msg: string): void\n\n  debug(msg: string): void\n  debug(obj: LogObject, msg: string): void\n\n  info(msg: string): void\n  info(obj: LogObject, msg: string): void\n\n  warn(msg: string): void\n  warn(obj: LogObject, msg: string): void\n\n  error(msg: string): void\n  error(obj: ErrorObject, msg: string): void\n\n  child(obj: LogObject): Logger\n}\n\n/**\n * A simple logger that writes to console.\n */\nclass ConsoleLogger implements Logger {\n  #prefix: string\n\n  constructor(prefix: string = 'queue') {\n    this.#prefix = prefix\n  }\n\n  #format(level: string, msgOrObj: string | LogObject, msg?: string): [string, LogObject?] {\n    const prefix = `[${this.#prefix}] ${level}:`\n\n    if (typeof msgOrObj === 'object') {\n      return [`${prefix} ${msg}`, msgOrObj]\n    }\n\n    return [`${prefix} ${msgOrObj}`]\n  }\n\n  trace(msg: string): void\n  trace(obj: LogObject, msg: string): void\n  trace(msgOrObj: string | LogObject, msg?: string): void {\n    const [message, obj] = this.#format('TRACE', msgOrObj, msg)\n\n    if (obj) {\n      return console.log(message, obj)\n    }\n\n    console.log(message)\n  }\n\n  debug(msg: string): void\n  debug(obj: LogObject, msg: string): void\n  debug(msgOrObj: string | LogObject, msg?: string): void {\n    const [message, obj] = this.#format('DEBUG', msgOrObj, msg)\n\n    if (obj) {\n      return console.log(message, obj)\n    }\n\n    console.log(message)\n  }\n\n  info(msg: string): void\n  info(obj: LogObject, msg: string): void\n  info(msgOrObj: string | LogObject, msg?: string): void {\n    const [message, obj] = this.#format('INFO', msgOrObj, msg)\n\n    if (obj) {\n      return console.log(message, obj)\n    }\n\n    console.log(message)\n  }\n\n  warn(msg: string): void\n  warn(obj: LogObject, msg: string): void\n  warn(msgOrObj: string | LogObject, msg?: string): void {\n    const [message, obj] = this.#format('WARN', msgOrObj, msg)\n\n    if (obj) {\n      return console.warn(message, obj)\n    }\n\n    console.warn(message)\n  }\n\n  error(msg: string): void\n  error(obj: ErrorObject, msg: string): void\n  error(msgOrObj: string | ErrorObject, msg?: string): void {\n    const [message, obj] = this.#format('ERROR', msgOrObj, msg)\n\n    if (obj) {\n      return console.error(message, obj)\n    }\n\n    console.error(message)\n  }\n\n  child(obj: LogObject): Logger {\n    const childPrefix = obj.pkg ? String(obj.pkg) : this.#prefix\n    return new ConsoleLogger(childPrefix)\n  }\n}\n\nexport const consoleLogger = new ConsoleLogger()\n","import * as errors from './exceptions.js'\nimport debug from './debug.js'\nimport { Locator } from './locator.js'\nimport { consoleLogger, type Logger } from './logger.js'\nimport type { Adapter } from './contracts/adapter.js'\nimport type {\n  AdapterFactory,\n  JobFactory,\n  JobOptions,\n  QueueConfig,\n  QueueManagerConfig,\n  RetryConfig,\n} from './types/main.js'\n\n/**\n * Central configuration and adapter management for the queue system.\n *\n * The QueueManager is responsible for:\n * - Initializing adapters and job registration\n * - Providing adapter instances to workers and dispatchers\n * - Managing retry configuration across global, queue, and job levels\n *\n * @example\n * ```typescript\n * import { QueueManager, redis } from '@boringnode/queue'\n *\n * await QueueManager.init({\n *   default: 'redis',\n *   adapters: {\n *     redis: redis({ host: 'localhost' }),\n *   },\n *   locations: ['./jobs/**\\/*.js'],\n *   retry: {\n *     maxRetries: 3,\n *     backoff: exponentialBackoff(),\n *   },\n * })\n *\n * // Get the default adapter\n * const adapter = QueueManager.use()\n *\n * // Clean up when done\n * await QueueManager.destroy()\n * ```\n */\nclass QueueManagerSingleton {\n  #initialized = false\n  #defaultAdapter!: string\n  #adapters: Record<string, AdapterFactory> = {}\n  #adapterInstances: Map<string, Adapter> = new Map()\n  #globalRetryConfig?: RetryConfig\n  #globalJobOptions?: JobOptions\n  #queueConfigs: Map<string, QueueConfig> = new Map()\n  #logger: Logger = consoleLogger\n  #jobFactory?: JobFactory\n\n  /**\n   * Initialize the queue system with the given configuration.\n   *\n   * This must be called before using the queue system. It:\n   * - Validates the configuration\n   * - Registers adapters\n   * - Auto-discovers and registers job classes from `locations`\n   *\n   * @param config - The queue configuration\n   * @returns This instance for chaining\n   * @throws {E_CONFIGURATION_ERROR} If the configuration is invalid\n   *\n   * @example\n   * ```typescript\n   * await QueueManager.init({\n   *   default: 'redis',\n   *   adapters: {\n   *     redis: redis(),\n   *     postgres: knex(pgConfig),\n   *   },\n   *   locations: ['./jobs/**\\/*.js'],\n   * })\n   * ```\n   */\n  async init(config: QueueManagerConfig) {\n    debug('initializing queue manager with config: %O', config)\n\n    this.#validateConfig(config)\n\n    this.#adapterInstances.clear()\n\n    this.#defaultAdapter = config.default\n    this.#adapters = config.adapters\n    this.#globalRetryConfig = config.retry\n    this.#globalJobOptions = config.defaultJobOptions\n    this.#logger = config.logger ?? consoleLogger\n    this.#jobFactory = config.jobFactory\n\n    if (config.queues) {\n      for (const [queue, queueConfig] of Object.entries(config.queues)) {\n        this.#queueConfigs.set(queue, queueConfig as QueueConfig)\n      }\n    }\n\n    if (config.locations && config.locations.length > 0) {\n      const registered = await Locator.registerFromGlob(config.locations)\n\n      if (registered === 0) {\n        this.#logger.warn(\n          `No jobs found for locations: ${config.locations.join(', ')}. ` +\n            'Verify your glob patterns match your job files.'\n        )\n      }\n    }\n\n    this.#initialized = true\n\n    return this\n  }\n\n  /**\n   * Get an adapter instance by name.\n   *\n   * Adapter instances are cached and reused. If no name is provided,\n   * the default adapter is returned.\n   *\n   * @param adapter - Adapter name (optional, defaults to the default adapter)\n   * @returns The adapter instance\n   * @throws {E_QUEUE_NOT_INITIALIZED} If `init()` hasn't been called\n   * @throws {E_CONFIGURATION_ERROR} If the adapter is not registered\n   * @throws {E_ADAPTER_INIT_ERROR} If the adapter factory throws\n   *\n   * @example\n   * ```typescript\n   * // Get default adapter\n   * const adapter = QueueManager.use()\n   *\n   * // Get specific adapter\n   * const redisAdapter = QueueManager.use('redis')\n   * ```\n   */\n  use(adapter?: string): Adapter {\n    if (!this.#initialized) {\n      throw new errors.E_QUEUE_NOT_INITIALIZED()\n    }\n\n    if (!adapter) {\n      adapter = this.#defaultAdapter\n    }\n\n    // Return cached instance if exists\n    const cached = this.#adapterInstances.get(adapter)\n    if (cached) {\n      return cached\n    }\n\n    const adapterFactory = this.#adapters[adapter]\n\n    if (!adapterFactory) {\n      throw new errors.E_CONFIGURATION_ERROR([`Adapter \"${adapter}\" is not registered`])\n    }\n\n    debug('using adapter \"%s\"', adapter)\n\n    try {\n      const instance = adapterFactory()\n      this.#adapterInstances.set(adapter, instance)\n      return instance\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      throw new errors.E_ADAPTER_INIT_ERROR([adapter, message])\n    }\n  }\n\n  /**\n   * Get the merged retry configuration for a job.\n   *\n   * Configuration is merged with priority: job > queue > global.\n   * This allows specific jobs or queues to override global defaults.\n   *\n   * @param queue - The queue name\n   * @param jobRetryConfig - Optional job-level retry config\n   * @returns The merged retry configuration\n   *\n   * @example\n   * ```typescript\n   * // Global: maxRetries=3, Queue: maxRetries=5, Job: maxRetries=1\n   * // Result: maxRetries=1 (job wins)\n   * const config = QueueManager.getMergedRetryConfig('emails', { maxRetries: 1 })\n   * ```\n   */\n  getMergedRetryConfig(queue: string, jobRetryConfig?: RetryConfig): RetryConfig {\n    const queueConfig = this.#queueConfigs.get(queue)\n    const queueRetryConfig = queueConfig?.retry || {}\n\n    let maxRetries =\n      jobRetryConfig?.maxRetries ||\n      queueRetryConfig.maxRetries ||\n      this.#globalRetryConfig?.maxRetries ||\n      0\n\n    let backoff =\n      jobRetryConfig?.backoff || queueRetryConfig.backoff || this.#globalRetryConfig?.backoff\n\n    return { maxRetries, backoff }\n  }\n\n  /**\n   * Get the configured job factory for custom instantiation.\n   *\n   * @returns The job factory function, or undefined if not configured\n   */\n  getJobFactory(): JobFactory | undefined {\n    return this.#jobFactory\n  }\n\n  /**\n   * Get the merged job options for a job (priority: job > queue > global).\n   */\n  getMergedJobOptions(queue: string, jobOptions?: JobOptions): JobOptions {\n    const queueConfig = this.#queueConfigs.get(queue)\n    const queueJobOptions = queueConfig?.defaultJobOptions\n\n    return {\n      removeOnComplete:\n        jobOptions?.removeOnComplete ??\n        queueJobOptions?.removeOnComplete ??\n        this.#globalJobOptions?.removeOnComplete,\n      removeOnFail:\n        jobOptions?.removeOnFail ??\n        queueJobOptions?.removeOnFail ??\n        this.#globalJobOptions?.removeOnFail,\n    }\n  }\n\n  #validateConfig(config: QueueManagerConfig): void {\n    if (!config.adapters || Object.keys(config.adapters).length === 0) {\n      throw new errors.E_CONFIGURATION_ERROR(['At least one adapter must be configured'])\n    }\n\n    if (!config.default) {\n      throw new errors.E_CONFIGURATION_ERROR(['Default adapter must be specified'])\n    }\n\n    if (!config.adapters[config.default]) {\n      throw new errors.E_CONFIGURATION_ERROR([\n        `Default adapter \"${config.default}\" not found in adapters configuration`,\n      ])\n    }\n\n    for (const [name, factory] of Object.entries(config.adapters)) {\n      if (typeof factory !== 'function') {\n        throw new errors.E_CONFIGURATION_ERROR([`Adapter \"${name}\" must be a factory function`])\n      }\n    }\n  }\n\n  /**\n   * Clean up all adapter instances and reset state.\n   *\n   * Call this when shutting down the application or when\n   * you need to reinitialize with a new configuration.\n   *\n   * @example\n   * ```typescript\n   * // On application shutdown\n   * await QueueManager.destroy()\n   * ```\n   */\n  async destroy() {\n    for (const [name, adapter] of this.#adapterInstances) {\n      debug('destroying adapter \"%s\"', name)\n      await adapter.destroy()\n    }\n    this.#adapterInstances.clear()\n    this.#initialized = false\n  }\n}\n\n/** Global queue manager singleton */\nexport const QueueManager = new QueueManagerSingleton()\n"],"mappings":";;;;;;;;AAAA,SAAS,gBAAgB;AAEzB,IAAO,gBAAQ,SAAS,kBAAkB;;;ACE1C,SAAS,YAAY;AACrB,SAAS,eAAe;AA0BxB,IAAM,mBAAN,MAAuB;AAAA,EACrB,YAAY,oBAAI,IAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAatC,SAAwB,MAAc,UAAuB;AAC3D,kBAAM,uBAAuB,IAAI;AAEjC,SAAK,UAAU,IAAI,MAAM,QAAQ;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,MAAM,iBAAiB,UAAqC;AAC1D,QAAI,aAAa;AAEjB,eAAW,WAAW,UAAU;AAC9B,oBAAM,0CAA0C,OAAO;AACvD,uBAAiB,QAAQ,KAAK,OAAO,GAAG;AACtC,sBAAM,sBAAsB,IAAI;AAEhC,YAAI;AACF,gBAAM,eAAe,QAAQ,IAAI;AACjC,gBAAM,SAAS,MAAM,OAAO,UAAU,YAAY;AAClD,gBAAM,WAAW,OAAO;AAExB,cAAI,YAAY,OAAO,aAAa,YAAY;AAC9C,kBAAM,UAAU,SAAS,SAAS,QAAQ,SAAS;AACnD,iBAAK,SAAS,SAAS,QAAQ;AAC/B;AAAA,UACF;AAAA,QACF,SAAS,OAAO;AACd,kBAAQ,KAAK,2BAA2B,IAAI,KAAK,KAAK;AAAA,QACxD;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,IAAyB,MAAuC;AAC9D,WAAO,KAAK,UAAU,IAAI,IAAI;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,WAAgC,MAA2B;AACzD,UAAM,WAAW,KAAK,IAAO,IAAI;AAEjC,QAAI,CAAC,UAAU;AACb,YAAM,IAAW,gBAAgB,CAAC,IAAI,CAAC;AAAA,IACzC;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAc;AACZ,SAAK,UAAU,MAAM;AAAA,EACvB;AACF;AAGO,IAAM,UAAU,IAAI,iBAAiB;;;ACtH5C,IAAM,gBAAN,MAAM,eAAgC;AAAA,EACpC;AAAA,EAEA,YAAY,SAAiB,SAAS;AACpC,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,QAAQ,OAAe,UAA8B,KAAoC;AACvF,UAAM,SAAS,IAAI,KAAK,OAAO,KAAK,KAAK;AAEzC,QAAI,OAAO,aAAa,UAAU;AAChC,aAAO,CAAC,GAAG,MAAM,IAAI,GAAG,IAAI,QAAQ;AAAA,IACtC;AAEA,WAAO,CAAC,GAAG,MAAM,IAAI,QAAQ,EAAE;AAAA,EACjC;AAAA,EAIA,MAAM,UAA8B,KAAoB;AACtD,UAAM,CAAC,SAAS,GAAG,IAAI,KAAK,QAAQ,SAAS,UAAU,GAAG;AAE1D,QAAI,KAAK;AACP,aAAO,QAAQ,IAAI,SAAS,GAAG;AAAA,IACjC;AAEA,YAAQ,IAAI,OAAO;AAAA,EACrB;AAAA,EAIA,MAAM,UAA8B,KAAoB;AACtD,UAAM,CAAC,SAAS,GAAG,IAAI,KAAK,QAAQ,SAAS,UAAU,GAAG;AAE1D,QAAI,KAAK;AACP,aAAO,QAAQ,IAAI,SAAS,GAAG;AAAA,IACjC;AAEA,YAAQ,IAAI,OAAO;AAAA,EACrB;AAAA,EAIA,KAAK,UAA8B,KAAoB;AACrD,UAAM,CAAC,SAAS,GAAG,IAAI,KAAK,QAAQ,QAAQ,UAAU,GAAG;AAEzD,QAAI,KAAK;AACP,aAAO,QAAQ,IAAI,SAAS,GAAG;AAAA,IACjC;AAEA,YAAQ,IAAI,OAAO;AAAA,EACrB;AAAA,EAIA,KAAK,UAA8B,KAAoB;AACrD,UAAM,CAAC,SAAS,GAAG,IAAI,KAAK,QAAQ,QAAQ,UAAU,GAAG;AAEzD,QAAI,KAAK;AACP,aAAO,QAAQ,KAAK,SAAS,GAAG;AAAA,IAClC;AAEA,YAAQ,KAAK,OAAO;AAAA,EACtB;AAAA,EAIA,MAAM,UAAgC,KAAoB;AACxD,UAAM,CAAC,SAAS,GAAG,IAAI,KAAK,QAAQ,SAAS,UAAU,GAAG;AAE1D,QAAI,KAAK;AACP,aAAO,QAAQ,MAAM,SAAS,GAAG;AAAA,IACnC;AAEA,YAAQ,MAAM,OAAO;AAAA,EACvB;AAAA,EAEA,MAAM,KAAwB;AAC5B,UAAM,cAAc,IAAI,MAAM,OAAO,IAAI,GAAG,IAAI,KAAK;AACrD,WAAO,IAAI,eAAc,WAAW;AAAA,EACtC;AACF;AAEO,IAAM,gBAAgB,IAAI,cAAc;;;ACpE/C,IAAM,wBAAN,MAA4B;AAAA,EAC1B,eAAe;AAAA,EACf;AAAA,EACA,YAA4C,CAAC;AAAA,EAC7C,oBAA0C,oBAAI,IAAI;AAAA,EAClD;AAAA,EACA;AAAA,EACA,gBAA0C,oBAAI,IAAI;AAAA,EAClD,UAAkB;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BA,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;AACjC,SAAK,oBAAoB,OAAO;AAChC,SAAK,UAAU,OAAO,UAAU;AAChC,SAAK,cAAc,OAAO;AAE1B,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,QAAI,OAAO,aAAa,OAAO,UAAU,SAAS,GAAG;AACnD,YAAM,aAAa,MAAM,QAAQ,iBAAiB,OAAO,SAAS;AAElE,UAAI,eAAe,GAAG;AACpB,aAAK,QAAQ;AAAA,UACX,gCAAgC,OAAO,UAAU,KAAK,IAAI,CAAC;AAAA,QAE7D;AAAA,MACF;AAAA,IACF;AAEA,SAAK,eAAe;AAEpB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBA,IAAI,SAA2B;AAC7B,QAAI,CAAC,KAAK,cAAc;AACtB,YAAM,IAAW,wBAAwB;AAAA,IAC3C;AAEA,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;AACd,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAM,IAAW,qBAAqB,CAAC,SAAS,OAAO,CAAC;AAAA,IAC1D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,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;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,gBAAwC;AACtC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAoB,OAAe,YAAqC;AACtE,UAAM,cAAc,KAAK,cAAc,IAAI,KAAK;AAChD,UAAM,kBAAkB,aAAa;AAErC,WAAO;AAAA,MACL,kBACE,YAAY,oBACZ,iBAAiB,oBACjB,KAAK,mBAAmB;AAAA,MAC1B,cACE,YAAY,gBACZ,iBAAiB,gBACjB,KAAK,mBAAmB;AAAA,IAC5B;AAAA,EACF;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,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,UAAU;AACd,eAAW,CAAC,MAAM,OAAO,KAAK,KAAK,mBAAmB;AACpD,oBAAM,2BAA2B,IAAI;AACrC,YAAM,QAAQ,QAAQ;AAAA,IACxB;AACA,SAAK,kBAAkB,MAAM;AAC7B,SAAK,eAAe;AAAA,EACtB;AACF;AAGO,IAAM,eAAe,IAAI,sBAAsB;","names":[]}

package/build/{chunk-NPQKBCCY.js → chunk-PBGPIFI5.js}

@@ -5,6 +5,19 @@ import {
 
 // src/utils.ts
 import { parse as parseDuration } from "@lukeed/ms";
+function resolveRetention(retention) {
+  if (retention === void 0 || retention === true) {
+    return { keep: false, maxAge: 0, maxCount: 0 };
+  }
+  if (retention === false) {
+    return { keep: true, maxAge: 0, maxCount: 0 };
+  }
+  return {
+    keep: true,
+    maxAge: retention.age ? parse(retention.age) : 0,
+    maxCount: retention.count ?? 0
+  };
+}
 function parse(duration) {
   if (typeof duration === "number") {
     return duration;
@@ -20,7 +33,8 @@ function calculateScore(priority, timestamp) {
 }
 
 export {
+  resolveRetention,
   parse,
   calculateScore
 };
-//# sourceMappingURL=chunk-NPQKBCCY.js.map
+//# sourceMappingURL=chunk-PBGPIFI5.js.map

package/build/chunk-PBGPIFI5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["import { parse as parseDuration } from '@lukeed/ms'\nimport type { Duration, JobRetention } from './types/main.js'\nimport * as errors from './exceptions.js'\nimport { PRIORITY_SCORE_MULTIPLIER } from './constants.js'\n\nexport interface ResolvedRetention {\n  keep: boolean\n  maxAge: number\n  maxCount: number\n}\n\nexport function resolveRetention(retention?: JobRetention): ResolvedRetention {\n  if (retention === undefined || retention === true) {\n    return { keep: false, maxAge: 0, maxCount: 0 }\n  }\n\n  if (retention === false) {\n    return { keep: true, maxAge: 0, maxCount: 0 }\n  }\n\n  return {\n    keep: true,\n    maxAge: retention.age ? parse(retention.age) : 0,\n    maxCount: retention.count ?? 0,\n  }\n}\n\nexport function parse(duration: Duration): number {\n  if (typeof duration === 'number') {\n    return duration\n  }\n\n  const milliseconds = parseDuration(duration)\n\n  if (typeof milliseconds === 'undefined') {\n    throw new errors.E_INVALID_DURATION_EXPRESSION([duration])\n  }\n\n  return milliseconds\n}\n\n/**\n * Calculate the score for job ordering in the queue.\n * Lower scores are processed first.\n *\n * @param priority - Job priority (1-10, lower = higher priority)\n * @param timestamp - Timestamp in milliseconds\n * @returns Score for queue ordering\n */\nexport function calculateScore(priority: number, timestamp: number): number {\n  return priority * PRIORITY_SCORE_MULTIPLIER + timestamp\n}\n"],"mappings":";;;;;;AAAA,SAAS,SAAS,qBAAqB;AAWhC,SAAS,iBAAiB,WAA6C;AAC5E,MAAI,cAAc,UAAa,cAAc,MAAM;AACjD,WAAO,EAAE,MAAM,OAAO,QAAQ,GAAG,UAAU,EAAE;AAAA,EAC/C;AAEA,MAAI,cAAc,OAAO;AACvB,WAAO,EAAE,MAAM,MAAM,QAAQ,GAAG,UAAU,EAAE;AAAA,EAC9C;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,UAAU,MAAM,MAAM,UAAU,GAAG,IAAI;AAAA,IAC/C,UAAU,UAAU,SAAS;AAAA,EAC/B;AACF;AAEO,SAAS,MAAM,UAA4B;AAChD,MAAI,OAAO,aAAa,UAAU;AAChC,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,cAAc,QAAQ;AAE3C,MAAI,OAAO,iBAAiB,aAAa;AACvC,UAAM,IAAW,8BAA8B,CAAC,QAAQ,CAAC;AAAA,EAC3D;AAEA,SAAO;AACT;AAUO,SAAS,eAAe,UAAkB,WAA2B;AAC1E,SAAO,WAAW,4BAA4B;AAChD;","names":[]}

package/build/{index-C0Xg6F4E.d.ts → index-BzPIqdx3.d.ts}

@@ -198,6 +198,21 @@ interface Logger {
  * ```
  */
 type Duration = number | string;
+/**
+ * Retention policy for completed/failed jobs.
+ *
+ * - `true` (default): Remove job immediately
+ * - `false`: Keep job in history indefinitely
+ * - `{ age?, count? }`: Keep with pruning by age and/or count
+ */
+type JobRetention = boolean | {
+    age?: Duration;
+    count?: number;
+};
+/**
+ * Possible statuses for a job in the queue.
+ */
+type JobStatus = 'pending' | 'active' | 'delayed' | 'completed' | 'failed';
 /**
  * Result returned when dispatching a job.
  *
@@ -211,6 +226,19 @@ interface DispatchResult {
     /** Unique identifier for this specific job instance */
     jobId: string;
 }
+/**
+ * Result returned when dispatching multiple jobs at once.
+ *
+ * @example
+ * ```typescript
+ * const { jobIds } = await SendEmailJob.dispatchMany(payloads)
+ * console.log(`Dispatched ${jobIds.length} jobs`)
+ * ```
+ */
+interface DispatchManyResult {
+    /** Unique identifiers for all dispatched job instances */
+    jobIds: string[];
+}
 /**
  * Internal representation of a job in the queue.
  *
@@ -248,6 +276,34 @@ interface JobData {
      * Number of times this job was recovered from stalled state.
      */
     stalledCount?: number;
+    /**
+     * Optional group identifier for organizing related jobs.
+     *
+     * Jobs with the same groupId can be filtered and displayed together
+     * in monitoring UIs. Useful for batch operations like newsletters
+     * or bulk exports.
+     *
+     * @example
+     * ```typescript
+     * await SendEmailJob.dispatch({ to: 'user@example.com' })
+     *   .group('newsletter-jan-2025')
+     *   .run()
+     * ```
+     */
+    groupId?: string;
+}
+/**
+ * Record of a job's current state, including history for completed/failed jobs.
+ */
+interface JobRecord {
+    /** Current status of the job */
+    status: JobStatus;
+    /** Original job data */
+    data: JobData;
+    /** Timestamp when the job finished (for completed/failed jobs) */
+    finishedAt?: number;
+    /** Error message (for failed jobs) */
+    error?: string;
 }
 /**
  * Static options for a Job class.
@@ -314,6 +370,8 @@ interface JobOptions {
      * @default true
      */
     failOnTimeout?: boolean;
+    removeOnComplete?: JobRetention;
+    removeOnFail?: JobRetention;
 }
 /**
  * Context information available to a job during execution.
@@ -395,6 +453,7 @@ interface BackoffConfig {
 interface QueueConfig {
     adapter?: string;
     retry?: any;
+    defaultJobOptions?: JobOptions;
 }
 interface WorkerConfig {
     /**
@@ -541,6 +600,7 @@ interface QueueManagerConfig {
     default: string;
     adapters: Record<string, AdapterFactory>;
     retry?: RetryConfig;
+    defaultJobOptions?: JobOptions;
     queues?: Record<string, QueueConfig>;
     worker?: WorkerConfig;
     locations?: string[];
@@ -634,16 +694,18 @@ interface Adapter {
      *
      * @param jobId - The job ID to complete
      * @param queue - The queue the job belongs to
+     * @param removeOnComplete - Optional retention policy for completed jobs
      */
-    completeJob(jobId: string, queue: string): Promise<void>;
+    completeJob(jobId: string, queue: string, removeOnComplete?: JobRetention): Promise<void>;
     /**
      * Mark a job as failed permanently and remove it from the queue.
      *
      * @param jobId - The job ID to fail
      * @param queue - The queue the job belongs to
      * @param error - Optional error that caused the failure
+     * @param removeOnFail - Optional retention policy for failed jobs
      */
-    failJob(jobId: string, queue: string, error?: Error): Promise<void>;
+    failJob(jobId: string, queue: string, error?: Error, removeOnFail?: JobRetention): Promise<void>;
     /**
      * Retry a job by moving it back to pending with incremented attempts.
      *
@@ -652,6 +714,14 @@ interface Adapter {
      * @param retryAt - Optional future date to delay the retry
      */
     retryJob(jobId: string, queue: string, retryAt?: Date): Promise<void>;
+    /**
+     * Get a job record by id.
+     *
+     * @param jobId - The job ID to retrieve
+     * @param queue - The queue the job belongs to
+     * @returns The job record, or null if not found
+     */
+    getJob(jobId: string, queue: string): Promise<JobRecord | null>;
     /**
      * Push a job to the default queue for immediate processing.
      *
@@ -680,6 +750,25 @@ interface Adapter {
      * @param delay - Delay in milliseconds before the job becomes available
      */
     pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void>;
+    /**
+     * Push multiple jobs to the default queue for immediate processing.
+     *
+     * This is more efficient than calling push() multiple times as it
+     * batches the operations (e.g., Redis pipeline, SQL batch insert).
+     *
+     * @param jobs - Array of job data to push
+     */
+    pushMany(jobs: JobData[]): Promise<void>;
+    /**
+     * Push multiple jobs to a specific queue for immediate processing.
+     *
+     * This is more efficient than calling pushOn() multiple times as it
+     * batches the operations (e.g., Redis pipeline, SQL batch insert).
+     *
+     * @param queue - The queue name to push to
+     * @param jobs - Array of job data to push
+     */
+    pushManyOn(queue: string, jobs: JobData[]): Promise<void>;
     /**
      * Get the number of pending jobs in the default queue.
      *
@@ -842,6 +931,25 @@ declare class JobDispatcher<T> {
      * ```
      */
     priority(priority: number): this;
+    /**
+     * Assign this job to a group.
+     *
+     * Jobs with the same groupId can be filtered and displayed together
+     * in monitoring UIs. Useful for batch operations like newsletters
+     * or bulk exports.
+     *
+     * @param groupId - Group identifier
+     * @returns This dispatcher for chaining
+     *
+     * @example
+     * ```typescript
+     * // Group newsletter jobs together
+     * await SendEmailJob.dispatch({ to: 'user@example.com' })
+     *   .group('newsletter-jan-2025')
+     *   .run()
+     * ```
+     */
+    group(groupId: string): this;
     /**
      * Use a specific adapter for this job.
      *
@@ -882,6 +990,127 @@ declare class JobDispatcher<T> {
     then(onFulfilled?: (value: DispatchResult) => any, onRejected?: (reason: any) => any): Promise<any>;
 }
 
+/**
+ * Fluent builder for dispatching multiple jobs to the queue in a single batch.
+ *
+ * Provides a chainable API for configuring job options before dispatch.
+ * Usually created via `Job.dispatchMany()` rather than directly.
+ *
+ * ```
+ * Job.dispatchMany(payloads)
+ *     .toQueue('emails')     // optional: target queue
+ *     .priority(1)           // optional: 1-10, lower = higher priority
+ *     .group('batch-123')    // optional: group all jobs together
+ *     .with('redis')         // optional: specific adapter
+ *     .run()                 // dispatch all jobs
+ * ```
+ *
+ * @typeParam T - The payload type for these jobs
+ *
+ * @example
+ * ```typescript
+ * // Batch dispatch for newsletter
+ * const { jobIds } = await SendEmailJob.dispatchMany([
+ *   { to: 'user1@example.com', subject: 'Newsletter' },
+ *   { to: 'user2@example.com', subject: 'Newsletter' },
+ * ])
+ *   .group('newsletter-jan-2025')
+ *   .toQueue('emails')
+ *   .run()
+ *
+ * console.log(`Dispatched ${jobIds.length} jobs`)
+ * ```
+ */
+declare class JobBatchDispatcher<T> {
+    #private;
+    /**
+     * Create a new batch job dispatcher.
+     *
+     * @param name - The job class name (used to locate the class at runtime)
+     * @param payloads - Array of data to pass to each job
+     */
+    constructor(name: string, payloads: T[]);
+    /**
+     * Set the target queue for all jobs.
+     *
+     * @param queue - Queue name (default: 'default')
+     * @returns This dispatcher for chaining
+     *
+     * @example
+     * ```typescript
+     * await SendEmailJob.dispatchMany(payloads).toQueue('emails')
+     * ```
+     */
+    toQueue(queue: string): this;
+    /**
+     * Set the priority for all jobs.
+     *
+     * Lower numbers = higher priority. Jobs with lower priority values
+     * are processed before jobs with higher values.
+     *
+     * @param priority - Priority level (1-10, default: 5)
+     * @returns This dispatcher for chaining
+     *
+     * @example
+     * ```typescript
+     * await UrgentJob.dispatchMany(payloads).priority(1)
+     * ```
+     */
+    priority(priority: number): this;
+    /**
+     * Assign all jobs to a group.
+     *
+     * Jobs with the same groupId can be filtered and displayed together
+     * in monitoring UIs. Useful for batch operations like newsletters
+     * or bulk exports.
+     *
+     * @param groupId - Group identifier
+     * @returns This dispatcher for chaining
+     *
+     * @example
+     * ```typescript
+     * await SendEmailJob.dispatchMany(recipients)
+     *   .group('newsletter-jan-2025')
+     *   .run()
+     * ```
+     */
+    group(groupId: string): this;
+    /**
+     * Use a specific adapter for these jobs.
+     *
+     * @param adapter - Adapter name or factory function
+     * @returns This dispatcher for chaining
+     *
+     * @example
+     * ```typescript
+     * await Job.dispatchMany(payloads).with('redis')
+     * ```
+     */
+    with(adapter: string | (() => Adapter)): this;
+    /**
+     * Dispatch all jobs to the queue.
+     *
+     * @returns A DispatchManyResult containing all jobIds
+     *
+     * @example
+     * ```typescript
+     * const { jobIds } = await SendEmailJob.dispatchMany(payloads).run()
+     * console.log(`Dispatched ${jobIds.length} jobs`)
+     * ```
+     */
+    run(): Promise<DispatchManyResult>;
+    /**
+     * Thenable implementation for auto-dispatch when awaited.
+     *
+     * Allows `await Job.dispatchMany(payloads)` without explicit `.run()`.
+     *
+     * @param onFulfilled - Success callback
+     * @param onRejected - Error callback
+     * @returns Promise resolving to the DispatchManyResult
+     */
+    then(onFulfilled?: (value: DispatchManyResult) => any, onRejected?: (reason: any) => any): Promise<any>;
+}
+
 /**
  * Fluent builder for creating job schedules.
  *
@@ -1103,6 +1332,34 @@ declare abstract class Job<Payload = any> {
      * ```
      */
     static dispatch<T extends Job>(this: new (...args: any[]) => T, payload: T extends Job<infer P> ? P : never): JobDispatcher<T extends Job<infer P> ? P : never>;
+    /**
+     * Dispatch multiple jobs to the queue in a single batch.
+     *
+     * Returns a JobBatchDispatcher for fluent configuration before dispatching.
+     * The jobs are not actually dispatched until `.run()` is called or the
+     * dispatcher is awaited.
+     *
+     * This is more efficient than calling `dispatch()` multiple times as it
+     * uses batched operations (e.g., Redis pipeline, SQL batch insert).
+     *
+     * @param payloads - Array of data to pass to each job
+     * @returns A JobBatchDispatcher for fluent configuration
+     *
+     * @example
+     * ```typescript
+     * // Batch dispatch for newsletter
+     * const { jobIds } = await SendEmailJob.dispatchMany([
+     *   { to: 'user1@example.com', subject: 'Newsletter' },
+     *   { to: 'user2@example.com', subject: 'Newsletter' },
+     * ])
+     *   .group('newsletter-jan-2025')
+     *   .toQueue('emails')
+     *   .run()
+     *
+     * console.log(`Dispatched ${jobIds.length} jobs`)
+     * ```
+     */
+    static dispatchMany<T extends Job>(this: new (...args: any[]) => T, payloads: (T extends Job<infer P> ? P : never)[]): JobBatchDispatcher<T extends Job<infer P> ? P : never>;
     /**
      * Create a schedule for this job.
      *
@@ -1171,4 +1428,4 @@ declare abstract class Job<Payload = any> {
     failed?(error: Error): Promise<void>;
 }
 
-export { type Adapter as A, type BackoffStrategy as B, type Duration as D, type JobData as J, type Logger as L, type QueueManagerConfig as Q, type RetryConfig as R, type ScheduleConfig as S, type WorkerCycle as W, type AcquiredJob as a, type ScheduleData as b, type ScheduleListOptions as c, type JobFactory as d, Job as e, type JobClass as f, type ScheduleStatus as g, ScheduleBuilder as h, customBackoff as i, exponentialBackoff as j, fixedBackoff as k, linearBackoff as l, type DispatchResult as m, type JobOptions as n, type JobContext as o, type BackoffConfig as p, type QueueConfig as q, type WorkerConfig as r, type AdapterFactory as s, type ScheduleResult as t };
+export { type Adapter as A, type BackoffStrategy as B, type Duration as D, type JobRetention as J, type Logger as L, type QueueManagerConfig as Q, type RetryConfig as R, type ScheduleConfig as S, type WorkerCycle as W, type AcquiredJob as a, type JobRecord as b, type JobData as c, type ScheduleData as d, type ScheduleListOptions as e, type JobFactory as f, type JobOptions as g, Job as h, type JobClass as i, type ScheduleStatus as j, ScheduleBuilder as k, JobBatchDispatcher as l, customBackoff as m, linearBackoff as n, exponentialBackoff as o, fixedBackoff as p, type JobStatus as q, type DispatchResult as r, type DispatchManyResult as s, type JobContext as t, type BackoffConfig as u, type QueueConfig as v, type WorkerConfig as w, type AdapterFactory as x, type ScheduleResult as y };

package/build/index.d.ts

@@ -1,5 +1,5 @@
-import { Q as QueueManagerConfig, W as WorkerCycle, A as Adapter, R as RetryConfig, d as JobFactory, e as Job, f as JobClass, b as ScheduleData, g as ScheduleStatus, c as ScheduleListOptions } from './index-C0Xg6F4E.js';
-export { h as ScheduleBuilder, i as customBackoff, j as exponentialBackoff, k as fixedBackoff, l as linearBackoff } from './index-C0Xg6F4E.js';
+import { Q as QueueManagerConfig, W as WorkerCycle, A as Adapter, R as RetryConfig, f as JobFactory, g as JobOptions, h as Job, i as JobClass, d as ScheduleData, j as ScheduleStatus, e as ScheduleListOptions } from './index-BzPIqdx3.js';
+export { l as JobBatchDispatcher, k as ScheduleBuilder, m as customBackoff, o as exponentialBackoff, p as fixedBackoff, n as linearBackoff } from './index-BzPIqdx3.js';
 import * as _poppinss_utils from '@poppinss/utils';
 
 /**
@@ -232,6 +232,10 @@ declare class QueueManagerSingleton {
      * @returns The job factory function, or undefined if not configured
      */
     getJobFactory(): JobFactory | undefined;
+    /**
+     * Get the merged job options for a job (priority: job > queue > global).
+     */
+    getMergedJobOptions(queue: string, jobOptions?: JobOptions): JobOptions;
     /**
      * Clean up all adapter instances and reset state.
      *