@boringnode/queue 0.0.1-alpha.3 → 0.1.0

package/build/chunk-US7THLSZ.js

@@ -0,0 +1,357 @@
+import {
+  E_ADAPTER_INIT_ERROR,
+  E_CONFIGURATION_ERROR,
+  E_JOB_NOT_FOUND,
+  E_QUEUE_NOT_INITIALIZED
+} from "./chunk-SMOKFZ46.js";
+
+// src/debug.ts
+import { debuglog } from "util";
+var debug_default = debuglog("boringnode:queue");
+
+// src/locator.ts
+import { glob } from "fs/promises";
+import { resolve } from "path";
+var LocatorSingleton = class {
+  #registry = /* @__PURE__ */ new Map();
+  /**
+   * Register a job class with a given name.
+   *
+   * @param name - The job name (usually the class name)
+   * @param JobClass - The job class constructor
+   *
+   * @example
+   * ```typescript
+   * Locator.register('SendEmailJob', SendEmailJob)
+   * ```
+   */
+  register(name, JobClass) {
+    debug_default("registering job: %s", name);
+    this.#registry.set(name, JobClass);
+  }
+  /**
+   * Auto-register job classes from files matching glob patterns.
+   *
+   * Each file should have a default export that is a Job class.
+   * The class name is used as the registration name.
+   *
+   * @param patterns - Glob patterns to match job files
+   * @returns Number of jobs successfully registered
+   *
+   * @example
+   * ```typescript
+   * const count = await Locator.registerFromGlob([
+   *   './jobs/**\/*.js',
+   *   './app/jobs/**\/*.ts'
+   * ])
+   * console.log(`Registered ${count} jobs`)
+   * ```
+   */
+  async registerFromGlob(patterns) {
+    let registered = 0;
+    for (const pattern of patterns) {
+      debug_default("registering jobs from glob pattern: %s", pattern);
+      for await (const file of glob(pattern)) {
+        debug_default("found job file: %s", file);
+        try {
+          const absolutePath = resolve(file);
+          const module = await import(`file://${absolutePath}`);
+          const JobClass = module.default;
+          if (JobClass && typeof JobClass === "function" && JobClass.name) {
+            this.register(JobClass.name, JobClass);
+            registered++;
+          }
+        } catch (error) {
+          console.warn(`Failed to load job from ${file}:`, error);
+        }
+      }
+    }
+    return registered;
+  }
+  /**
+   * Get a job class by name.
+   *
+   * @param name - The job name to look up
+   * @returns The job class, or undefined if not found
+   *
+   * @example
+   * ```typescript
+   * const JobClass = Locator.get('SendEmailJob')
+   * if (JobClass) {
+   *   const instance = new JobClass(payload)
+   * }
+   * ```
+   */
+  get(name) {
+    return this.#registry.get(name);
+  }
+  /**
+   * Get a job class by name, throwing if not found.
+   *
+   * @param name - The job name to look up
+   * @returns The job class
+   * @throws {E_JOB_NOT_FOUND} If the job is not registered
+   *
+   * @example
+   * ```typescript
+   * const JobClass = Locator.getOrThrow('SendEmailJob')
+   * const instance = new JobClass(payload)
+   * ```
+   */
+  getOrThrow(name) {
+    const JobClass = this.get(name);
+    if (!JobClass) {
+      throw new E_JOB_NOT_FOUND([name]);
+    }
+    return JobClass;
+  }
+  /**
+   * Remove all registered jobs.
+   *
+   * Primarily useful for testing.
+   */
+  clear() {
+    this.#registry.clear();
+  }
+};
+var Locator = new LocatorSingleton();
+
+// src/logger.ts
+var ConsoleLogger = class _ConsoleLogger {
+  #prefix;
+  constructor(prefix = "queue") {
+    this.#prefix = prefix;
+  }
+  #format(level, msgOrObj, msg) {
+    const prefix = `[${this.#prefix}] ${level}:`;
+    if (typeof msgOrObj === "object") {
+      return [`${prefix} ${msg}`, msgOrObj];
+    }
+    return [`${prefix} ${msgOrObj}`];
+  }
+  trace(msgOrObj, msg) {
+    const [message, obj] = this.#format("TRACE", msgOrObj, msg);
+    if (obj) {
+      return console.log(message, obj);
+    }
+    console.log(message);
+  }
+  debug(msgOrObj, msg) {
+    const [message, obj] = this.#format("DEBUG", msgOrObj, msg);
+    if (obj) {
+      return console.log(message, obj);
+    }
+    console.log(message);
+  }
+  info(msgOrObj, msg) {
+    const [message, obj] = this.#format("INFO", msgOrObj, msg);
+    if (obj) {
+      return console.log(message, obj);
+    }
+    console.log(message);
+  }
+  warn(msgOrObj, msg) {
+    const [message, obj] = this.#format("WARN", msgOrObj, msg);
+    if (obj) {
+      return console.warn(message, obj);
+    }
+    console.warn(message);
+  }
+  error(msgOrObj, msg) {
+    const [message, obj] = this.#format("ERROR", msgOrObj, msg);
+    if (obj) {
+      return console.error(message, obj);
+    }
+    console.error(message);
+  }
+  child(obj) {
+    const childPrefix = obj.pkg ? String(obj.pkg) : this.#prefix;
+    return new _ConsoleLogger(childPrefix);
+  }
+};
+var consoleLogger = new ConsoleLogger();
+
+// src/queue_manager.ts
+var QueueManagerSingleton = class {
+  #initialized = false;
+  #defaultAdapter;
+  #adapters = {};
+  #adapterInstances = /* @__PURE__ */ new Map();
+  #globalRetryConfig;
+  #queueConfigs = /* @__PURE__ */ new Map();
+  #logger = consoleLogger;
+  #jobFactory;
+  /**
+   * Initialize the queue system with the given configuration.
+   *
+   * This must be called before using the queue system. It:
+   * - Validates the configuration
+   * - Registers adapters
+   * - Auto-discovers and registers job classes from `locations`
+   *
+   * @param config - The queue configuration
+   * @returns This instance for chaining
+   * @throws {E_CONFIGURATION_ERROR} If the configuration is invalid
+   *
+   * @example
+   * ```typescript
+   * await QueueManager.init({
+   *   default: 'redis',
+   *   adapters: {
+   *     redis: redis(),
+   *     postgres: knex(pgConfig),
+   *   },
+   *   locations: ['./jobs/**\/*.js'],
+   * })
+   * ```
+   */
+  async init(config) {
+    debug_default("initializing queue manager with config: %O", config);
+    this.#validateConfig(config);
+    this.#adapterInstances.clear();
+    this.#defaultAdapter = config.default;
+    this.#adapters = config.adapters;
+    this.#globalRetryConfig = config.retry;
+    this.#logger = config.logger ?? consoleLogger;
+    this.#jobFactory = config.jobFactory;
+    if (config.queues) {
+      for (const [queue, queueConfig] of Object.entries(config.queues)) {
+        this.#queueConfigs.set(queue, queueConfig);
+      }
+    }
+    if (config.locations && config.locations.length > 0) {
+      const registered = await Locator.registerFromGlob(config.locations);
+      if (registered === 0) {
+        this.#logger.warn(
+          `No jobs found for locations: ${config.locations.join(", ")}. Verify your glob patterns match your job files.`
+        );
+      }
+    }
+    this.#initialized = true;
+    return this;
+  }
+  /**
+   * Get an adapter instance by name.
+   *
+   * Adapter instances are cached and reused. If no name is provided,
+   * the default adapter is returned.
+   *
+   * @param adapter - Adapter name (optional, defaults to the default adapter)
+   * @returns The adapter instance
+   * @throws {E_QUEUE_NOT_INITIALIZED} If `init()` hasn't been called
+   * @throws {E_CONFIGURATION_ERROR} If the adapter is not registered
+   * @throws {E_ADAPTER_INIT_ERROR} If the adapter factory throws
+   *
+   * @example
+   * ```typescript
+   * // Get default adapter
+   * const adapter = QueueManager.use()
+   *
+   * // Get specific adapter
+   * const redisAdapter = QueueManager.use('redis')
+   * ```
+   */
+  use(adapter) {
+    if (!this.#initialized) {
+      throw new E_QUEUE_NOT_INITIALIZED();
+    }
+    if (!adapter) {
+      adapter = this.#defaultAdapter;
+    }
+    const cached = this.#adapterInstances.get(adapter);
+    if (cached) {
+      return cached;
+    }
+    const adapterFactory = this.#adapters[adapter];
+    if (!adapterFactory) {
+      throw new E_CONFIGURATION_ERROR([`Adapter "${adapter}" is not registered`]);
+    }
+    debug_default('using adapter "%s"', adapter);
+    try {
+      const instance = adapterFactory();
+      this.#adapterInstances.set(adapter, instance);
+      return instance;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new E_ADAPTER_INIT_ERROR([adapter, message]);
+    }
+  }
+  /**
+   * Get the merged retry configuration for a job.
+   *
+   * Configuration is merged with priority: job > queue > global.
+   * This allows specific jobs or queues to override global defaults.
+   *
+   * @param queue - The queue name
+   * @param jobRetryConfig - Optional job-level retry config
+   * @returns The merged retry configuration
+   *
+   * @example
+   * ```typescript
+   * // Global: maxRetries=3, Queue: maxRetries=5, Job: maxRetries=1
+   * // Result: maxRetries=1 (job wins)
+   * const config = QueueManager.getMergedRetryConfig('emails', { maxRetries: 1 })
+   * ```
+   */
+  getMergedRetryConfig(queue, jobRetryConfig) {
+    const queueConfig = this.#queueConfigs.get(queue);
+    const queueRetryConfig = queueConfig?.retry || {};
+    let maxRetries = jobRetryConfig?.maxRetries || queueRetryConfig.maxRetries || this.#globalRetryConfig?.maxRetries || 0;
+    let backoff = jobRetryConfig?.backoff || queueRetryConfig.backoff || this.#globalRetryConfig?.backoff;
+    return { maxRetries, backoff };
+  }
+  /**
+   * Get the configured job factory for custom instantiation.
+   *
+   * @returns The job factory function, or undefined if not configured
+   */
+  getJobFactory() {
+    return this.#jobFactory;
+  }
+  #validateConfig(config) {
+    if (!config.adapters || Object.keys(config.adapters).length === 0) {
+      throw new E_CONFIGURATION_ERROR(["At least one adapter must be configured"]);
+    }
+    if (!config.default) {
+      throw new E_CONFIGURATION_ERROR(["Default adapter must be specified"]);
+    }
+    if (!config.adapters[config.default]) {
+      throw new E_CONFIGURATION_ERROR([
+        `Default adapter "${config.default}" not found in adapters configuration`
+      ]);
+    }
+    for (const [name, factory] of Object.entries(config.adapters)) {
+      if (typeof factory !== "function") {
+        throw new E_CONFIGURATION_ERROR([`Adapter "${name}" must be a factory function`]);
+      }
+    }
+  }
+  /**
+   * Clean up all adapter instances and reset state.
+   *
+   * Call this when shutting down the application or when
+   * you need to reinitialize with a new configuration.
+   *
+   * @example
+   * ```typescript
+   * // On application shutdown
+   * await QueueManager.destroy()
+   * ```
+   */
+  async destroy() {
+    for (const [name, adapter] of this.#adapterInstances) {
+      debug_default('destroying adapter "%s"', name);
+      await adapter.destroy();
+    }
+    this.#adapterInstances.clear();
+    this.#initialized = false;
+  }
+};
+var QueueManager = new QueueManagerSingleton();
+
+export {
+  debug_default,
+  Locator,
+  QueueManager
+};
+//# sourceMappingURL=chunk-US7THLSZ.js.map

package/build/chunk-US7THLSZ.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' && JobClass.name) {\n            this.register(JobClass.name, 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  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  #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.#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  #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":"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","names":[]}