@fluojs/queue 1.0.1 → 2.0.0

package/dist/status.js

@@ -5,7 +5,22 @@
 /** Queue-specific platform snapshot returned to health and readiness integrations. */
 
 function createReadiness(input) {
+  const workerStartFailures = input.workerStartFailures ?? 0;
+  if (input.lifecycleState === 'failed' || workerStartFailures > 0) {
+    return {
+      critical: true,
+      reason: 'Queue worker startup failed.',
+      status: 'not-ready'
+    };
+  }
   if (input.lifecycleState === 'started') {
+    if (input.workersReady < input.workersDiscovered) {
+      return {
+        critical: true,
+        reason: 'Queue workers are waiting for BullMQ processors to start.',
+        status: 'degraded'
+      };
+    }
     return {
       critical: true,
       status: 'ready'
@@ -39,6 +54,13 @@ function createReadiness(input) {
   };
 }
 function createHealth(input) {
+  const workerStartFailures = input.workerStartFailures ?? 0;
+  if (input.lifecycleState === 'failed' || workerStartFailures > 0) {
+    return {
+      reason: 'Queue worker startup failed.',
+      status: 'unhealthy'
+    };
+  }
   if (input.lifecycleState === 'stopped') {
     return {
       reason: 'Queue workers are stopped.',
@@ -57,6 +79,12 @@ function createHealth(input) {
       status: 'degraded'
     };
   }
+  if (input.lifecycleState === 'started' && input.workersReady < input.workersDiscovered) {
+    return {
+      reason: 'Queue workers are waiting for BullMQ processors to start.',
+      status: 'degraded'
+    };
+  }
   if (input.lifecycleState === 'started' && input.pendingDeadLetterWrites > 0) {
     return {
       reason: 'Queue dead-letter writes are still pending.',
@@ -81,13 +109,18 @@ function createHealth(input) {
  * @returns Readiness, health, ownership, and queue detail fields.
  */
 export function createQueuePlatformStatusSnapshot(input) {
+  const workerStartFailures = input.workerStartFailures ?? 0;
   return {
     details: {
       deadLetterDrainTimeoutMs: 5_000,
       dependencies: [input.dependencyId ?? 'redis.default'],
       lifecycleState: input.lifecycleState,
+      ...(input.lastWorkerStartFailure ? {
+        lastWorkerStartFailure: input.lastWorkerStartFailure
+      } : {}),
       pendingDeadLetterWrites: input.pendingDeadLetterWrites,
       queuesReady: input.queuesReady,
+      workerStartFailures,
       workerShutdownTimeoutMs: input.workerShutdownTimeoutMs,
       workersDiscovered: input.workersDiscovered,
       workersReady: input.workersReady

package/dist/tokens.d.ts

@@ -1,7 +1,61 @@
 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';
+/** Runtime metadata that binds one queue registration to its compiled module graph. */
+export interface QueueModuleContext {
+    readonly moduleType: ModuleType;
+    readonly scope: string;
+}
+/**
+ * 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,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;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,114 @@
+/** Runtime metadata that binds one queue registration to its compiled module graph. */
+
+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

@@ -31,6 +31,8 @@ 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;
     /** Whether queue providers should be visible globally. Defaults to `true`. */
     global?: boolean;
     defaultAttempts?: number;
@@ -44,11 +46,13 @@ export interface QueueModuleOptions {
 /** Normalized queue options resolved once during module registration. */
 export interface NormalizedQueueModuleOptions {
     clientName?: string;
+    scope?: string;
     defaultAttempts: number;
     defaultBackoff?: QueueBackoffOptions;
     defaultConcurrency: number;
     defaultDeadLetterMaxEntries: number | false;
     defaultRateLimiter?: QueueRateLimiterOptions;
+    global: boolean;
     workerShutdownTimeoutMs: number;
 }
 /** Metadata captured by {@link QueueWorker} during decorator evaluation. */
@@ -68,6 +72,27 @@ 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[];
+}
 /** Queue facade exposed to application code and compatibility tokens. */
 export interface Queue {
     /**
@@ -77,5 +102,13 @@ export interface Queue {
      * @returns The BullMQ job id generated for the enqueued payload.
      */
     enqueue<TJob extends object>(job: TJob): Promise<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.
+     */
+    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,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

@@ -1,4 +1,5 @@
 import type { ApplicationLogger, CompiledModule } from '@fluojs/runtime';
+import { type DiscoveryModuleFilter } from './helpers.js';
 import type { NormalizedQueueModuleOptions, QueueJobType, QueueWorkerDescriptor } from './types.js';
 /**
  * Discover queue worker descriptors.
@@ -8,5 +9,5 @@ import type { NormalizedQueueModuleOptions, QueueJobType, QueueWorkerDescriptor
  * @param logger The logger.
  * @returns The discover queue worker descriptors result.
  */
-export declare function discoverQueueWorkerDescriptors(compiledModules: readonly CompiledModule[], options: NormalizedQueueModuleOptions, logger: ApplicationLogger): Map<QueueJobType, QueueWorkerDescriptor>;
+export declare function discoverQueueWorkerDescriptors(compiledModules: readonly CompiledModule[], options: NormalizedQueueModuleOptions, logger: ApplicationLogger, moduleFilter?: DiscoveryModuleFilter): Map<QueueJobType, QueueWorkerDescriptor>;
 //# sourceMappingURL=worker-discovery.d.ts.map

package/dist/worker-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-discovery.d.ts","sourceRoot":"","sources":["../src/worker-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIzE,OAAO,KAAK,EAAE,4BAA4B,EAAE,YAAY,EAAE,qBAAqB,EAAuB,MAAM,YAAY,CAAC;AAEzH;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,OAAO,EAAE,4BAA4B,EACrC,MAAM,EAAE,iBAAiB,GACxB,GAAG,CAAC,YAAY,EAAE,qBAAqB,CAAC,CA4C1C"}
+{"version":3,"file":"worker-discovery.d.ts","sourceRoot":"","sources":["../src/worker-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGzE,OAAO,EAA8B,KAAK,qBAAqB,EAAkD,MAAM,cAAc,CAAC;AACtI,OAAO,KAAK,EAAE,4BAA4B,EAAE,YAAY,EAAE,qBAAqB,EAAuB,MAAM,YAAY,CAAC;AAEzH;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,OAAO,EAAE,4BAA4B,EACrC,MAAM,EAAE,iBAAiB,EACzB,YAAY,CAAC,EAAE,qBAAqB,GACnC,GAAG,CAAC,YAAY,EAAE,qBAAqB,CAAC,CA4C1C"}

package/dist/worker-discovery.js

@@ -8,10 +8,10 @@ import { collectDiscoveryCandidates, normalizePositiveInteger, normalizeRateLimi
  * @param logger The logger.
  * @returns The discover queue worker descriptors result.
  */
-export function discoverQueueWorkerDescriptors(compiledModules, options, logger) {
+export function discoverQueueWorkerDescriptors(compiledModules, options, logger, moduleFilter) {
   const descriptorsByJobType = new Map();
   const seenJobNames = new Set();
-  for (const candidate of collectDiscoveryCandidates(compiledModules)) {
+  for (const candidate of collectDiscoveryCandidates(compiledModules, moduleFilter)) {
     const metadata = getQueueWorkerMetadata(candidate.targetType);
     if (!metadata) {
       continue;

package/package.json

@@ -10,7 +10,7 @@
     "redis",
     "dlq"
   ],
-  "version": "1.0.1",
+  "version": "2.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -38,10 +38,10 @@
   ],
   "dependencies": {
     "bullmq": "^5.58.0",
-    "@fluojs/core": "^1.0.3",
-    "@fluojs/di": "^1.0.3",
-    "@fluojs/redis": "^1.0.1",
-    "@fluojs/runtime": "^1.1.2"
+    "@fluojs/core": "^1.1.0",
+    "@fluojs/di": "^2.0.0",
+    "@fluojs/redis": "^1.1.0",
+    "@fluojs/runtime": "^2.0.1"
   },
   "devDependencies": {
     "vitest": "^3.2.4"