@fluojs/queue 1.0.2 → 3.0.0

package/dist/service.js

@@ -1,28 +1,24 @@
-let _initClass;
-function _applyDecs(e, t, n, r, o, i) { var a, c, u, s, f, l, p, d = Symbol.metadata || Symbol.for("Symbol.metadata"), m = Object.defineProperty, h = Object.create, y = [h(null), h(null)], v = t.length; function g(t, n, r) { return function (o, i) { n && (i = o, o = e); for (var a = 0; a < t.length; a++) i = t[a].apply(o, r ? [i] : []); return r ? i : o; }; } function b(e, t, n, r) { if ("function" != typeof e && (r || void 0 !== e)) throw new TypeError(t + " must " + (n || "be") + " a function" + (r ? "" : " or undefined")); return e; } function applyDec(e, t, n, r, o, i, u, s, f, l, p) { function d(e) { if (!p(e)) throw new TypeError("Attempted to access private element on non-instance"); } var h = [].concat(t[0]), v = t[3], w = !u, D = 1 === o, S = 3 === o, j = 4 === o, E = 2 === o; function I(t, n, r) { return function (o, i) { return n && (i = o, o = e), r && r(o), P[t].call(o, i); }; } if (!w) { var P = {}, k = [], F = S ? "get" : j || D ? "set" : "value"; if (f ? (l || D ? P = { get: _setFunctionName(function () { return v(this); }, r, "get"), set: function (e) { t[4](this, e); } } : P[F] = v, l || _setFunctionName(P[F], r, E ? "" : F)) : l || (P = Object.getOwnPropertyDescriptor(e, r)), !l && !f) { if ((c = y[+s][r]) && 7 !== (c ^ o)) throw Error("Decorating two elements with the same name (" + P[F].name + ") is not supported yet"); y[+s][r] = o < 3 ? 1 : o; } } for (var N = e, O = h.length - 1; O >= 0; O -= n ? 2 : 1) { var T = b(h[O], "A decorator", "be", !0), z = n ? h[O - 1] : void 0, A = {}, H = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: r, metadata: a, addInitializer: function (e, t) { if (e.v) throw new TypeError("attempted to call addInitializer after decoration was finished"); b(t, "An initializer", "be", !0), i.push(t); }.bind(null, A) }; if (w) c = T.call(z, N, H), A.v = 1, b(c, "class decorators", "return") && (N = c);else if (H.static = s, H.private = f, c = H.access = { has: f ? p.bind() : function (e) { return r in e; } }, j || (c.get = f ? E ? function (e) { return d(e), P.value; } : I("get", 0, d) : function (e) { return e[r]; }), E || S || (c.set = f ? I("set", 0, d) : function (e, t) { e[r] = t; }), N = T.call(z, D ? { get: P.get, set: P.set } : P[F], H), A.v = 1, D) { if ("object" == typeof N && N) (c = b(N.get, "accessor.get")) && (P.get = c), (c = b(N.set, "accessor.set")) && (P.set = c), (c = b(N.init, "accessor.init")) && k.unshift(c);else if (void 0 !== N) throw new TypeError("accessor decorators must return an object with get, set, or init properties or undefined"); } else b(N, (l ? "field" : "method") + " decorators", "return") && (l ? k.unshift(N) : P[F] = N); } return o < 2 && u.push(g(k, s, 1), g(i, s, 0)), l || w || (f ? D ? u.splice(-1, 0, I("get", s), I("set", s)) : u.push(E ? P[F] : b.call.bind(P[F])) : m(e, r, P)), N; } function w(e) { return m(e, d, { configurable: !0, enumerable: !0, value: a }); } return void 0 !== i && (a = i[d]), a = h(null == a ? null : a), f = [], l = function (e) { e && f.push(g(e)); }, p = function (t, r) { for (var i = 0; i < n.length; i++) { var a = n[i], c = a[1], l = 7 & c; if ((8 & c) == t && !l == r) { var p = a[2], d = !!a[3], m = 16 & c; applyDec(t ? e : e.prototype, a, m, d ? "#" + p : _toPropertyKey(p), l, l < 2 ? [] : t ? s = s || [] : u = u || [], f, !!t, d, r, t && d ? function (t) { return _checkInRHS(t) === e; } : o); } } }, p(8, 0), p(0, 0), p(8, 1), p(0, 1), l(u), l(s), c = f, v || w(e), { e: c, get c() { var n = []; return v && [w(e = applyDec(e, [t], r, e.name, 5, n)), g(n, 1)]; } }; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
-function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
-function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
-import { Inject } from '@fluojs/core';
 import { cloneWithFallback } from '@fluojs/core/internal';
-import { getRedisClientToken, getRedisComponentId } from '@fluojs/redis';
-import { APPLICATION_LOGGER, BOOTSTRAP_READY_SIGNAL, COMPILED_MODULES, RUNTIME_CONTAINER } from '@fluojs/runtime/internal';
+import { getRedisComponentId } from '@fluojs/redis';
+import { createHash } from 'node:crypto';
 import { Queue as BullQueue, Worker as BullWorker } from 'bullmq';
 import { QueueDeadLetterManager } from './dead-letter-manager.js';
 import { normalizePositiveInteger, withTimeout } from './helpers.js';
 import { createQueuePlatformStatusSnapshot } from './status.js';
-import { QUEUE, QUEUE_OPTIONS } from './tokens.js';
+import { getQueueLifecycleServiceToken, getQueueToken, QUEUE } from './tokens.js';
 import { discoverQueueWorkerDescriptors } from './worker-discovery.js';
 const IMMEDIATE_BOOTSTRAP_READY_SIGNAL = {
   wait: () => Promise.resolve()
 };
+function createBullMqJobId(deduplicationKey) {
+  return `fluo-${createHash('sha256').update(deduplicationKey).digest('hex')}`;
+}
 function hasQueueRedisClient(value) {
   if (typeof value !== 'object' || value === null) {
     return false;
   }
   const client = value;
-  return typeof client.duplicate === 'function' && typeof client.rpush === 'function' && typeof client.ltrim === 'function';
+  return typeof client.duplicate === 'function' && typeof client.lrange === 'function' && typeof client.rpush === 'function' && typeof client.ltrim === 'function';
 }
 function isQueuePayload(value) {
   return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -66,11 +62,7 @@ async function closeConnection(connection) {
  * The service discovers `@QueueWorker()` providers during bootstrap, creates the
  * BullMQ queues/workers they require, and shuts them down with the application.
  */
-let _QueueLifecycleServic;
-class QueueLifecycleService {
-  static {
-    [_QueueLifecycleServic, _initClass] = _applyDecs(this, [Inject(QUEUE_OPTIONS, RUNTIME_CONTAINER, COMPILED_MODULES, APPLICATION_LOGGER, BOOTSTRAP_READY_SIGNAL)], []).c;
-  }
+export class QueueLifecycleService {
   descriptorsByJobType = new Map();
   queuesByJobName = new Map();
   workersByJobName = new Map();
@@ -80,17 +72,23 @@ class QueueLifecycleService {
   runningWorkerJobNames = new Set();
   failedWorkerJobNames = new Set();
   workerStartFailures = [];
+  compiledModulesByType;
   lifecycleState = 'idle';
-  redisClient;
   startPromise;
   shutdownPromise;
   startupFailureRollbackPromise;
-  constructor(options, runtimeContainer, compiledModules, logger, bootstrapReadySignal = IMMEDIATE_BOOTSTRAP_READY_SIGNAL) {
+  constructor(options, redisClient, runtimeContainer, compiledModules, logger, bootstrapReadySignal = IMMEDIATE_BOOTSTRAP_READY_SIGNAL, moduleContext = {
+    moduleType: QueueLifecycleService,
+    scope: 'default'
+  }) {
     this.options = options;
+    this.redisClient = redisClient;
     this.runtimeContainer = runtimeContainer;
     this.compiledModules = compiledModules;
     this.logger = logger;
     this.bootstrapReadySignal = bootstrapReadySignal;
+    this.moduleContext = moduleContext;
+    this.compiledModulesByType = new Map(this.compiledModules.map(compiledModule => [compiledModule.type, compiledModule]));
     this.deadLetterManager = new QueueDeadLetterManager(this.options, this.logger, () => this.getRedisClient());
   }
   async onApplicationBootstrap() {
@@ -107,28 +105,76 @@ class QueueLifecycleService {
    * Enqueues one job instance using the worker metadata registered for its class.
    *
    * @param job Job instance whose constructor matches a discovered `@QueueWorker()` provider.
-   * @returns The queue-assigned job id, or an empty string when BullMQ does not provide one.
+   * @param options Optional producer controls, including a caller-owned deduplication key.
+   * @returns The backing BullMQ job id, or an empty string when BullMQ does not provide one.
    *
    * @throws {Error} When no worker is registered for the job type or the queue is not initialized.
    */
-  async enqueue(job) {
+  async enqueue(job, options) {
     await this.ensureStarted();
     if (this.lifecycleState !== 'started') {
       throw new Error(`Queue lifecycle state is ${this.lifecycleState}.`);
     }
-    const descriptor = this.descriptorsByJobType.get(job.constructor);
-    if (!descriptor) {
-      throw new Error(`No @QueueWorker() registered for job type ${job.constructor.name}.`);
+    const {
+      descriptor,
+      queue
+    } = this.resolveEnqueueTarget(job);
+    const queuedJob = await queue.add(descriptor.jobName, serializeJobPayload(job), this.createBullMqJobOptions(descriptor, options));
+    return queuedJob.id ?? '';
+  }
+
+  /**
+   * Atomically enqueues ordered jobs that resolve to one registered worker queue.
+   *
+   * @param entries Ordered job instances and per-job producer controls.
+   * @returns Backing BullMQ job ids aligned with the input order.
+   * @throws {Error} When any entry has no registered worker, targets another queue, or the queue is unavailable.
+   */
+  async enqueueMany(entries) {
+    if (entries.length === 0) {
+      return [];
     }
-    const queue = this.queuesByJobName.get(descriptor.jobName);
-    if (!queue) {
-      throw new Error(`Queue ${descriptor.jobName} is not initialized.`);
+    await this.ensureStarted();
+    if (this.lifecycleState !== 'started') {
+      throw new Error(`Queue lifecycle state is ${this.lifecycleState}.`);
     }
-    const queuedJob = await queue.add(descriptor.jobName, serializeJobPayload(job), {
-      attempts: descriptor.attempts,
-      backoff: toBullBackoff(descriptor.backoff)
+    const resolvedEntries = entries.map(entry => {
+      const target = this.resolveEnqueueTarget(entry.job);
+      return {
+        descriptor: target.descriptor,
+        options: entry.options,
+        payload: serializeJobPayload(entry.job),
+        queue: target.queue
+      };
     });
-    return queuedJob.id ?? '';
+    const targetQueue = resolvedEntries[0]?.queue;
+    if (!targetQueue) {
+      return [];
+    }
+    if (resolvedEntries.some(entry => entry.queue !== targetQueue)) {
+      throw new Error('Queue batch jobs must target one registered worker queue.');
+    }
+    const queuedJobs = await targetQueue.addBulk(resolvedEntries.map(entry => ({
+      data: entry.payload,
+      name: entry.descriptor.jobName,
+      opts: this.createBullMqJobOptions(entry.descriptor, entry.options)
+    })));
+    return queuedJobs.map(queuedJob => queuedJob.id ?? '');
+  }
+
+  /**
+   * Reads a bounded snapshot of dead-letter records for one queue job name.
+   *
+   * Inspection reads Redis without starting workers or lifecycle-gating the read. The backing Redis client must
+   * remain reachable; `RedisModule` owns that shared client's shutdown.
+   *
+   * @param jobName Queue worker job name whose dead letters should be inspected.
+   * @param options Optional bounded inspection settings.
+   * @returns Valid records in newest-first order plus the malformed count for the inspected window.
+   * @throws The backing Redis read error when that client is unavailable or already shut down.
+   */
+  async inspectDeadLetters(jobName, options) {
+    return this.deadLetterManager.inspect(jobName, options);
   }
 
   /**
@@ -152,6 +198,29 @@ class QueueLifecycleService {
       workersReady: this.runningWorkerJobNames.size
     });
   }
+  resolveEnqueueTarget(job) {
+    const descriptor = this.descriptorsByJobType.get(job.constructor);
+    if (!descriptor) {
+      throw new Error(`No @QueueWorker() registered for job type ${job.constructor.name}.`);
+    }
+    const queue = this.queuesByJobName.get(descriptor.jobName);
+    if (!queue) {
+      throw new Error(`Queue ${descriptor.jobName} is not initialized.`);
+    }
+    return {
+      descriptor,
+      queue
+    };
+  }
+  createBullMqJobOptions(descriptor, options) {
+    return {
+      attempts: descriptor.attempts,
+      backoff: toBullBackoff(descriptor.backoff),
+      ...(options?.deduplicationKey === undefined ? {} : {
+        jobId: createBullMqJobId(options.deduplicationKey)
+      })
+    };
+  }
   async ensureStarted() {
     if (this.lifecycleState === 'started') {
       return;
@@ -172,8 +241,7 @@ class QueueLifecycleService {
     this.startPromise = undefined;
   }
   async startLifecycle() {
-    const redis = await this.resolveRedisClient();
-    this.redisClient = redis;
+    const redis = this.resolveRedisClient();
     this.descriptorsByJobType.clear();
     for (const [jobType, descriptor] of discoverQueueWorkerDescriptors(this.compiledModules, this.options, this.logger, compiledModule => this.shouldDiscoverWorkersInModule(compiledModule))) {
       this.descriptorsByJobType.set(jobType, descriptor);
@@ -188,31 +256,45 @@ class QueueLifecycleService {
     if (this.options.global) {
       return true;
     }
-    return compiledModule.accessibleTokens.has(_QueueLifecycleServic) || compiledModule.accessibleTokens.has(QUEUE);
+    return this.canReachQueueRegistration(compiledModule);
+  }
+  canReachQueueRegistration(compiledModule, visited = new Set()) {
+    if (visited.has(compiledModule.type)) {
+      return false;
+    }
+    visited.add(compiledModule.type);
+    for (const importedModuleType of compiledModule.definition.imports ?? []) {
+      if (importedModuleType === this.moduleContext.moduleType) {
+        return true;
+      }
+      const importedModule = this.compiledModulesByType.get(importedModuleType);
+      if (!importedModule || !this.exportsQueueRegistration(importedModule)) {
+        continue;
+      }
+      if (this.canReachQueueRegistration(importedModule, visited)) {
+        return true;
+      }
+    }
+    return false;
+  }
+  exportsQueueRegistration(compiledModule) {
+    return compiledModule.exportedTokens.has(QueueLifecycleService) || compiledModule.exportedTokens.has(QUEUE) || compiledModule.exportedTokens.has(getQueueLifecycleServiceToken(this.options.scope)) || compiledModule.exportedTokens.has(getQueueToken(this.options.scope));
   }
   async handleStartupFailure() {
     await this.closeInitializedResources();
+    await this.deadLetterManager.drainPendingWrites();
     if (this.lifecycleState === 'starting') {
       this.lifecycleState = 'idle';
     }
-    this.redisClient = undefined;
     this.startPromise = undefined;
   }
-  async resolveRedisClient() {
-    const redisToken = getRedisClientToken(this.options.clientName);
-    if (!this.runtimeContainer.has(redisToken)) {
-      throw new Error('@fluojs/queue requires a registered Redis client with duplicate(), rpush(), and ltrim() methods.');
-    }
-    const redisClient = await this.runtimeContainer.resolve(redisToken);
-    if (!hasQueueRedisClient(redisClient)) {
-      throw new Error('@fluojs/queue requires a Redis client with duplicate(), rpush(), and ltrim() methods.');
+  resolveRedisClient() {
+    if (!hasQueueRedisClient(this.redisClient)) {
+      throw new Error('@fluojs/queue requires a Redis client with duplicate(), lrange(), rpush(), and ltrim() methods.');
     }
-    return redisClient;
+    return this.redisClient;
   }
   getRedisClient() {
-    if (!this.redisClient) {
-      throw new Error('@fluojs/queue Redis client is not initialized.');
-    }
     return this.redisClient;
   }
   async initializeWorkers(redis) {
@@ -369,9 +451,10 @@ class QueueLifecycleService {
   }
   rollbackAfterWorkerStartupFailure() {
     if (!this.startupFailureRollbackPromise) {
-      this.startupFailureRollbackPromise = this.closeInitializedResources().then(() => {
-        this.redisClient = undefined;
-      }).catch(rollbackError => {
+      this.startupFailureRollbackPromise = (async () => {
+        await this.closeInitializedResources();
+        await this.deadLetterManager.drainPendingWrites();
+      })().catch(rollbackError => {
         this.logger.error('Failed to roll back queue resources after worker startup failure.', rollbackError, 'QueueLifecycleService');
       });
     }
@@ -449,7 +532,6 @@ class QueueLifecycleService {
       await this.closeInitializedResources();
       await this.deadLetterManager.drainPendingWrites();
       this.lifecycleState = 'stopped';
-      this.redisClient = undefined;
       this.startPromise = undefined;
     })();
     await this.shutdownPromise;
@@ -498,7 +580,7 @@ class QueueLifecycleService {
     } catch (error) {
       this.logger.error('Failed to close queue worker within shutdown timeout.', error, 'QueueLifecycleService');
       try {
-        await worker.close(true);
+        await withTimeout(worker.close(true), this.options.workerShutdownTimeoutMs, () => new Error('queue worker force close timed out'));
       } catch (forceCloseError) {
         this.logger.error('Failed to force close queue worker during shutdown.', forceCloseError, 'QueueLifecycleService');
       }
@@ -506,20 +588,19 @@ class QueueLifecycleService {
   }
   async tryCloseQueue(queue) {
     try {
-      await queue.close();
+      await withTimeout(queue.close(), this.options.workerShutdownTimeoutMs, () => new Error('queue shutdown timed out'));
     } catch (error) {
-      this.logger.error('Failed to close queue during shutdown.', error, 'QueueLifecycleService');
+      this.logger.error('Failed to close queue within shutdown timeout.', error, 'QueueLifecycleService');
     }
   }
   async tryCloseOwnedConnection(connection) {
     try {
-      await closeConnection(connection);
+      await withTimeout(closeConnection(connection), this.options.workerShutdownTimeoutMs, () => new Error('queue-owned Redis connection shutdown timed out'));
     } catch (error) {
-      this.logger.error('Failed to close queue-owned Redis connection during shutdown.', error, 'QueueLifecycleService');
+      if (connection.status !== 'end') {
+        connection.disconnect();
+      }
+      this.logger.error('Failed to close queue-owned Redis connection within shutdown timeout.', error, 'QueueLifecycleService');
     }
   }
-  static {
-    _initClass();
-  }
-}
-export { _QueueLifecycleServic as QueueLifecycleService };
+}

package/dist/tokens.d.ts

@@ -1,7 +1,69 @@
 import type { Token } from '@fluojs/core';
-import type { Queue, NormalizedQueueModuleOptions } from './types.js';
+import type { ModuleType } from '@fluojs/runtime';
+import type { QueueLifecycleService } from './service.js';
+import type { NormalizedQueueModuleOptions, Queue } from './types.js';
+/** Internal marker that distinguishes queue registration metadata from application value providers. */
+export declare const QUEUE_MODULE_CONTEXT_MARKER: unique symbol;
+/** Runtime metadata that binds one queue registration to its compiled module graph. */
+export interface QueueModuleContext {
+    readonly moduleType: ModuleType;
+    readonly scope: string;
+}
+/** Internal queue registration metadata used for graph-wide worker ownership validation. */
+export interface QueueRegistrationContext extends QueueModuleContext {
+    readonly [QUEUE_MODULE_CONTEXT_MARKER]: true;
+    readonly options: NormalizedQueueModuleOptions;
+    readonly registrationTokens: readonly Token[];
+}
+/**
+ * Normalize an optional queue registration scope.
+ *
+ * @param scope Optional scope name supplied to {@link QueueModule.forRoot}.
+ * @returns A trimmed non-empty scope name, or `undefined` for the default registration.
+ * @throws When a provided scope contains only whitespace.
+ */
+export declare function normalizeQueueScope(scope?: string): string | undefined;
+/** Queue-owned Redis client token consumed by the default queue registration. */
+export declare const QUEUE_REDIS_CLIENT: Token<unknown>;
 /** Compatibility injection token for the queue facade returned by {@link QueueModule.forRoot}. */
 export declare const QUEUE: Token<Queue>;
 /** Injection token for normalized module defaults consumed by {@link QueueLifecycleService}. */
 export declare const QUEUE_OPTIONS: Token<NormalizedQueueModuleOptions>;
+/** Runtime module-context token consumed by the default queue registration. */
+export declare const QUEUE_MODULE_CONTEXT: Token<QueueModuleContext>;
+/**
+ * Return the queue facade token for a default or explicitly scoped registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The compatibility {@link QUEUE} token when omitted, or a stable token for the scoped queue facade.
+ */
+export declare function getQueueToken(scope?: string): Token<Queue>;
+/**
+ * Return the lifecycle service token for a default or explicitly scoped queue registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The default lifecycle-service token when omitted, or a stable token for the scoped lifecycle service.
+ */
+export declare function getQueueLifecycleServiceToken(scope?: string): Token<QueueLifecycleService>;
+/**
+ * Return the normalized options token for a default or explicitly scoped queue registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The default options token when omitted, or a stable token for scoped normalized options.
+ */
+export declare function getQueueOptionsToken(scope?: string): Token<NormalizedQueueModuleOptions>;
+/**
+ * Return the queue-owned Redis client token for a default or explicitly scoped registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The default Redis client token when omitted, or a stable token for the scoped Redis dependency.
+ */
+export declare function getQueueRedisClientToken(scope?: string): Token<unknown>;
+/**
+ * Return the module-context token for a default or explicitly scoped queue registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The default module-context token when omitted, or a stable token for scoped queue context.
+ */
+export declare function getQueueModuleContextToken(scope?: string): Token<QueueModuleContext>;
 //# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAEtE,kGAAkG;AAClG,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAA4B,CAAC;AAC5D,gGAAgG;AAChG,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,4BAA4B,CAAoC,CAAC"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEtE,uGAAuG;AACvG,eAAO,MAAM,2BAA2B,eAA6C,CAAC;AAEtF,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,4FAA4F;AAC5F,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,QAAQ,CAAC,CAAC,2BAA2B,CAAC,EAAE,IAAI,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,KAAK,EAAE,CAAC;CAC/C;AAQD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYtE;AAcD,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAyC,CAAC;AACxF,kGAAkG;AAClG,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAA4B,CAAC;AAC5D,gGAAgG;AAChG,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,4BAA4B,CAAoC,CAAC;AACnG,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,kBAAkB,CAA2C,CAAC;AAEvG;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAQ1D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAQ1F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,4BAA4B,CAAC,CAQxF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAQvE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAQpF"}

package/dist/tokens.js

@@ -1,4 +1,119 @@
+/** Internal marker that distinguishes queue registration metadata from application value providers. */
+export const QUEUE_MODULE_CONTEXT_MARKER = Symbol('fluo.queue.module-context.marker');
+
+/** Runtime metadata that binds one queue registration to its compiled module graph. */
+
+/** Internal queue registration metadata used for graph-wide worker ownership validation. */
+
+const scopedQueueTokens = new Map();
+const scopedQueueLifecycleServiceTokens = new Map();
+const scopedQueueOptionsTokens = new Map();
+const scopedQueueRedisClientTokens = new Map();
+const scopedQueueModuleContextTokens = new Map();
+
+/**
+ * Normalize an optional queue registration scope.
+ *
+ * @param scope Optional scope name supplied to {@link QueueModule.forRoot}.
+ * @returns A trimmed non-empty scope name, or `undefined` for the default registration.
+ * @throws When a provided scope contains only whitespace.
+ */
+export function normalizeQueueScope(scope) {
+  if (scope === undefined) {
+    return undefined;
+  }
+  const normalized = scope.trim();
+  if (normalized.length === 0) {
+    throw new Error('Queue scope must be a non-empty string when provided.');
+  }
+  return normalized;
+}
+function getScopedToken(tokens, scope, description) {
+  const existing = tokens.get(scope);
+  if (existing) {
+    return existing;
+  }
+  const created = Symbol(`${description}:${scope}`);
+  tokens.set(scope, created);
+  return created;
+}
+
+/** Queue-owned Redis client token consumed by the default queue registration. */
+export const QUEUE_REDIS_CLIENT = Symbol.for('fluo.queue.redis-client');
 /** Compatibility injection token for the queue facade returned by {@link QueueModule.forRoot}. */
 export const QUEUE = Symbol.for('fluo.queue');
 /** Injection token for normalized module defaults consumed by {@link QueueLifecycleService}. */
-export const QUEUE_OPTIONS = Symbol.for('fluo.queue.options');
+export const QUEUE_OPTIONS = Symbol.for('fluo.queue.options');
+/** Runtime module-context token consumed by the default queue registration. */
+export const QUEUE_MODULE_CONTEXT = Symbol.for('fluo.queue.module-context');
+
+/**
+ * Return the queue facade token for a default or explicitly scoped registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The compatibility {@link QUEUE} token when omitted, or a stable token for the scoped queue facade.
+ */
+export function getQueueToken(scope) {
+  const normalizedScope = normalizeQueueScope(scope);
+  if (normalizedScope === undefined) {
+    return QUEUE;
+  }
+  return getScopedToken(scopedQueueTokens, normalizedScope, 'fluo.queue');
+}
+
+/**
+ * Return the lifecycle service token for a default or explicitly scoped queue registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The default lifecycle-service token when omitted, or a stable token for the scoped lifecycle service.
+ */
+export function getQueueLifecycleServiceToken(scope) {
+  const normalizedScope = normalizeQueueScope(scope);
+  if (normalizedScope === undefined) {
+    return QueueLifecycleServiceToken;
+  }
+  return getScopedToken(scopedQueueLifecycleServiceTokens, normalizedScope, 'fluo.queue.lifecycle-service');
+}
+
+/**
+ * Return the normalized options token for a default or explicitly scoped queue registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The default options token when omitted, or a stable token for scoped normalized options.
+ */
+export function getQueueOptionsToken(scope) {
+  const normalizedScope = normalizeQueueScope(scope);
+  if (normalizedScope === undefined) {
+    return QUEUE_OPTIONS;
+  }
+  return getScopedToken(scopedQueueOptionsTokens, normalizedScope, 'fluo.queue.options');
+}
+
+/**
+ * Return the queue-owned Redis client token for a default or explicitly scoped registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The default Redis client token when omitted, or a stable token for the scoped Redis dependency.
+ */
+export function getQueueRedisClientToken(scope) {
+  const normalizedScope = normalizeQueueScope(scope);
+  if (normalizedScope === undefined) {
+    return QUEUE_REDIS_CLIENT;
+  }
+  return getScopedToken(scopedQueueRedisClientTokens, normalizedScope, 'fluo.queue.redis-client');
+}
+
+/**
+ * Return the module-context token for a default or explicitly scoped queue registration.
+ *
+ * @param scope Optional queue registration scope.
+ * @returns The default module-context token when omitted, or a stable token for scoped queue context.
+ */
+export function getQueueModuleContextToken(scope) {
+  const normalizedScope = normalizeQueueScope(scope);
+  if (normalizedScope === undefined) {
+    return QUEUE_MODULE_CONTEXT;
+  }
+  return getScopedToken(scopedQueueModuleContextTokens, normalizedScope, 'fluo.queue.module-context');
+}
+const QueueLifecycleServiceToken = Symbol.for('fluo.queue.lifecycle-service.default');

package/dist/types.d.ts

@@ -5,6 +5,8 @@ export interface QueueJobType<TJob extends object = object> {
 }
 /** Supported retry backoff strategies forwarded to BullMQ workers. */
 export type QueueBackoffType = 'fixed' | 'exponential';
+/** Cross-scope ownership collision action selected during queue bootstrap. */
+export type QueueOwnershipEnforcement = 'warn' | 'reject';
 /** Retry timing settings applied to one queued job type. */
 export interface QueueBackoffOptions {
     delayMs?: number;
@@ -31,6 +33,16 @@ export interface QueueWorkerOptions {
 /** Module-wide defaults used when individual workers omit execution settings. */
 export interface QueueModuleOptions {
     clientName?: string;
+    /** Unique registration scope for non-global queue modules that need isolated providers. */
+    scope?: string;
+    /**
+     * Stable application-supplied identity for the Redis database and BullMQ prefix shared by this registration.
+     *
+     * Registrations that target one BullMQ backend must use the same namespace, regardless of `clientName`.
+     */
+    ownershipNamespace?: string;
+    /** Cross-scope collision action. Defaults to `warn` for 2.x compatibility. */
+    ownershipEnforcement?: QueueOwnershipEnforcement;
     /** Whether queue providers should be visible globally. Defaults to `true`. */
     global?: boolean;
     defaultAttempts?: number;
@@ -44,6 +56,9 @@ export interface QueueModuleOptions {
 /** Normalized queue options resolved once during module registration. */
 export interface NormalizedQueueModuleOptions {
     clientName?: string;
+    scope?: string;
+    ownershipNamespace?: string;
+    ownershipEnforcement: QueueOwnershipEnforcement;
     defaultAttempts: number;
     defaultBackoff?: QueueBackoffOptions;
     defaultConcurrency: number;
@@ -69,14 +84,70 @@ export interface QueueWorkerDescriptor {
     token: Token;
     workerName: string;
 }
+/** Options for one read-only dead-letter inspection. */
+export interface QueueDeadLetterInspectionOptions {
+    /** Maximum number of stored entries to inspect. Defaults to `100` and is capped at `1_000`. */
+    readonly limit?: number;
+}
+/** Parsed operator-facing view of one dead-letter record. */
+export interface QueueDeadLetterRecord {
+    readonly attemptsMade: number;
+    readonly errorMessage: string;
+    readonly failedAt: string;
+    readonly jobId: string;
+    readonly jobName: string;
+    readonly payload: unknown;
+}
+/** Result of a bounded dead-letter inspection. */
+export interface QueueDeadLetterInspectionResult {
+    /** Number of malformed stored values omitted from the inspected window. */
+    readonly malformedRecordCount: number;
+    /** Valid records in newest-first order. */
+    readonly records: readonly QueueDeadLetterRecord[];
+}
+/** Optional producer controls applied to one enqueue operation. */
+export interface QueueEnqueueOptions {
+    /**
+     * Caller-supplied identity used to deduplicate repeated enqueue attempts.
+     *
+     * Queue deterministically maps this value to a BullMQ-safe backing job id,
+     * so callers can use arbitrary identities without inheriting
+     * BullMQ's colon or numeric-only custom-id restrictions.
+     */
+    readonly deduplicationKey?: string;
+}
+/** One ordered job and its producer controls for an atomic queue batch. */
+export interface QueueEnqueueManyEntry<TJob extends object = object> {
+    /** Job instance whose constructor identifies the target worker. */
+    readonly job: TJob;
+    /** Optional producer controls applied only to this batch entry. */
+    readonly options?: QueueEnqueueOptions;
+}
 /** Queue facade exposed to application code and compatibility tokens. */
 export interface Queue {
     /**
      * Enqueues one job instance for the worker registered against its class.
      *
      * @param job Job instance whose constructor identifies the target worker.
-     * @returns The BullMQ job id generated for the enqueued payload.
+     * @param options Optional producer controls, including a caller-owned deduplication key.
+     * @returns The backing BullMQ job id for the enqueued payload.
+     */
+    enqueue<TJob extends object>(job: TJob, options?: QueueEnqueueOptions): Promise<string>;
+    /**
+     * Atomically enqueues ordered jobs that resolve to one registered worker queue.
+     *
+     * @param entries Ordered job instances and per-job producer controls.
+     * @returns Backing BullMQ job ids aligned with the input order.
+     * @throws {Error} When any entry has no registered worker, targets another queue, or the queue is unavailable.
+     */
+    enqueueMany<TJob extends object>(entries: readonly QueueEnqueueManyEntry<TJob>[]): Promise<readonly string[]>;
+    /**
+     * Reads a bounded snapshot of dead-letter records for one queue job name.
+     *
+     * @param jobName Queue worker job name whose dead letters should be inspected.
+     * @param options Optional bounded inspection settings.
+     * @returns Valid records in newest-first order plus the malformed count for the inspected window.
      */
-    enqueue<TJob extends object>(job: TJob): Promise<string>;
+    inspectDeadLetters(jobName: string, options?: QueueDeadLetterInspectionOptions): Promise<QueueDeadLetterInspectionResult>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,oFAAoF;AACpF,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IACxD,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;CAC9B;AAED,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,aAAa,CAAC;AAEvD,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC;AAED,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7C,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAC7C,kHAAkH;IAClH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,yEAAyE;AACzE,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5C,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,MAAM,WAAW,KAAK;IACpB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/worker-discovery.d.ts

@@ -6,8 +6,9 @@ import type { NormalizedQueueModuleOptions, QueueJobType, QueueWorkerDescriptor
  *
  * @param compiledModules The compiled modules.
  * @param options The options.
- * @param logger The logger.
+ * @param logger Optional logger for skipped worker registrations.
+ * @param moduleFilter Optional compiled-module ownership filter.
  * @returns The discover queue worker descriptors result.
  */
-export declare function discoverQueueWorkerDescriptors(compiledModules: readonly CompiledModule[], options: NormalizedQueueModuleOptions, logger: ApplicationLogger, moduleFilter?: DiscoveryModuleFilter): Map<QueueJobType, QueueWorkerDescriptor>;
+export declare function discoverQueueWorkerDescriptors(compiledModules: readonly CompiledModule[], options: NormalizedQueueModuleOptions, logger: ApplicationLogger | undefined, moduleFilter?: DiscoveryModuleFilter): Map<QueueJobType, QueueWorkerDescriptor>;
 //# sourceMappingURL=worker-discovery.d.ts.map