nestworker 2.0.8 → 2.1.1

package/dist/core/worker.service.js

@@ -11,51 +11,32 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
+var WorkerService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkerService = void 0;
 const common_1 = require("@nestjs/common");
 const worker_pool_1 = require("./worker.pool");
 const discovery_service_1 = require("../discovery/discovery.service");
 const di_serializer_1 = require("../di/di-serializer");
-/**
- * WorkerService
- *
- * Main entry point for executing worker-thread tasks.
- *
- * Features:
- * - Lazy worker pool initialization
- * - Automatic worker discovery
- * - Priority queue support
- * - Timeout support
- * - Worker thread execution
- * - NestJS dependency integration
- *
- * Lifecycle:
- * 1. Discovers worker-enabled services
- * 2. Serializes metadata for worker runtime
- * 3. Creates WorkerPool
- * 4. Dispatches tasks to workers
- * 5. Handles graceful shutdown
- *
- * Example:
- *
- * ```ts
- * await workerService.run(
- *   'ImageService',
- *   'resizeImage',
- *   [500],
- *   {
- *     priority: 'HIGH',
- *     timeout: 5000,
- *   },
- * );
- * ```
- */
-let WorkerService = class WorkerService {
+// Monotonic ID generator — far cheaper than crypto.randomUUID() and unique
+// per-process which is all we need (jobs never leave this process).
+let __jobIdCounter = 0;
+const __jobIdPrefix = `j${Date.now().toString(36)}-`;
+const nextId = () => __jobIdPrefix + (++__jobIdCounter).toString(36);
+// Hot-path shared frozen sentinels — let v8 elide allocations on the common
+// "no proxies / no ALS context" path.
+const EMPTY_PROXIES = Object.freeze([]);
+const EMPTY_ALS = Object.freeze({});
+const DEFAULT_TASK = Object.freeze({ priority: 'NORMAL' });
+let WorkerService = WorkerService_1 = class WorkerService {
     discovery;
     options;
+    logger = new common_1.Logger(WorkerService_1.name);
     pool = null;
-    taskOptions = new Map();
+    taskDefaults = new Map();
+    taskProxies = new Map();
+    /** Cached array of ALS storages — avoids `?? []` + entries() per call. */
+    alsStorages = [];
     constructor(discovery, options) {
         this.discovery = discovery;
         this.options = options;
@@ -66,70 +47,142 @@ let WorkerService = class WorkerService {
     initPool() {
         if (this.pool)
             return;
+        this.alsStorages = (this.options.asyncLocalStorages ?? []);
         const tasks = this.discovery.scan();
+        const proxyMap = new Map();
         for (const task of tasks) {
-            this.taskOptions.set(`${task.serviceName}.${task.methodName}`, { priority: task.priority, timeout: task.timeout });
+            const key = `${task.serviceName}.${task.methodName}`;
+            this.taskDefaults.set(key, {
+                priority: task.priority,
+                timeout: task.timeout,
+                retry: task.retry,
+                retryDelay: task.retryDelay,
+            });
+            const descriptors = task.proxyInstances.map((p) => {
+                if (!proxyMap.has(p.propertyKey)) {
+                    proxyMap.set(p.propertyKey, { methodNames: p.methodNames, instance: p.instance });
+                }
+                return { propertyKey: p.propertyKey, methodNames: p.methodNames };
+            });
+            this.taskProxies.set(key, descriptors);
         }
         const serialized = (0, di_serializer_1.serializeForWorker)(tasks);
-        this.pool = new worker_pool_1.WorkerPool(serialized, this.options.poolSize);
+        const proxyInstances = Array.from(proxyMap.entries()).map(([propertyKey, { methodNames, instance }]) => ({ propertyKey, methodNames, instance }));
+        this.pool = new worker_pool_1.WorkerPool(serialized, proxyInstances, this.options.poolSize, this.options.shutdownTimeout);
+        // Forward pool events to logger and expose via EventEmitter
+        this.pool.on('dead', (event) => {
+            this.logger.error(`Dead letter: ${event.serviceName}.${event.methodName} ` +
+                `failed after ${event.attempts} attempt(s) — ${event.error.message}`);
+        });
+        this.pool.on('error', (err) => {
+            this.logger.error(`Worker pool error: ${err.message}`, err.stack);
+        });
     }
     /**
-     * Executes a worker task.
-     *
-     * Parameters:
-     * - serviceName: target service
-     * - methodName: target method
-     * - args: serialized arguments
-     * - overrides: runtime priority/timeout overrides
-     *
-     * Priority:
-     * - HIGH
-     * - NORMAL
-     * - LOW
-     *
-     * Timeout:
-     * Automatically terminates timed-out workers.
+     * Run a @WorkerTask method in a worker thread.
      *
-     * Example:
-     *
-     * ```ts
-     * await workerService.run(
-     *   'ImageService',
-     *   'generateThumbnail',
-     *   [1920, 1080],
-     *   {
-     *     priority: 'HIGH',
-     *     timeout: 3000,
-     *   },
-     * );
-     * ```
+     * @param serviceName  Class name of the @WorkerClass provider
+     * @param methodName   Method decorated with @WorkerTask
+     * @param args         structuredClone-compatible arguments
+     * @param options      Optional priority / timeout / retry / AbortSignal overrides
      */
-    run(serviceName, methodName, args = [], overrides = {}) {
+    run(serviceName, methodName, args = [], options = {}) {
         const key = `${serviceName}.${methodName}`;
-        const defaults = this.taskOptions.get(key) ??
-            { priority: 'NORMAL' };
+        const defaults = this.taskDefaults.get(key) ?? DEFAULT_TASK;
+        const proxyServices = this.taskProxies.get(key) ?? EMPTY_PROXIES;
+        // Capture ALS context only if any storages are registered. Empty objects
+        // still cost allocation + a structuredClone hop across the worker boundary.
+        let alsContext;
+        const storages = this.alsStorages;
+        for (let i = 0, len = storages.length; i < len; i++) {
+            const store = storages[i].getStore();
+            if (store !== undefined) {
+                (alsContext ??= {})[i < 10 ? String.fromCharCode(48 + i) : String(i)] = store;
+            }
+        }
+        // Capture OTEL trace context if available (lazy, cached lookup).
+        const traceContext = captureTraceContext();
+        // Generate a unique signal ID if an AbortSignal was provided
+        const abortSignalId = options.signal ? nextId() : undefined;
         return this.pool.execute({
+            jobId: nextId(),
             serviceName,
             methodName,
             args,
-            priority: overrides.priority ?? defaults.priority,
-            timeout: overrides.timeout ?? defaults.timeout,
-        });
+            priority: options.priority ?? defaults.priority,
+            timeout: options.timeout ?? defaults.timeout,
+            retry: options.retry ?? defaults.retry ?? 0,
+            retryDelay: options.retryDelay ?? defaults.retryDelay ?? 0,
+            proxyServices,
+            alsContext: alsContext ?? EMPTY_ALS,
+            traceContext,
+            abortSignalId,
+        }, options.signal);
+    }
+    /** Listen for dead-letter events (jobs that exhausted all retry attempts) */
+    onDead(listener) {
+        this.pool?.on('dead', listener);
+        return this;
+    }
+    /** Listen for task lifecycle events */
+    onTaskEnd(listener) {
+        this.pool?.on('taskEnd', listener);
+        return this;
+    }
+    onTaskStart(listener) {
+        this.pool?.on('taskStart', listener);
+        return this;
+    }
+    onTaskError(listener) {
+        this.pool?.on('taskError', listener);
+        return this;
+    }
+    /** Current pool stats — use for health checks and metrics */
+    stats() {
+        return this.pool?.stats() ?? {
+            poolSize: this.options.poolSize ?? 0,
+            idle: 0, busy: 0, queued: 0, warmingUp: 0,
+        };
     }
-    /**
-     * Gracefully shuts down worker pool.
-     *
-     * Called automatically by NestJS
-     * during application shutdown.
-     */
     async onModuleDestroy() {
         await this.pool?.destroy();
     }
 };
 exports.WorkerService = WorkerService;
-exports.WorkerService = WorkerService = __decorate([
+exports.WorkerService = WorkerService = WorkerService_1 = __decorate([
     (0, common_1.Injectable)(),
     __param(1, (0, common_1.Inject)('WORKER_OPTIONS')),
     __metadata("design:paramtypes", [discovery_service_1.WorkerDiscoveryService, Object])
 ], WorkerService);
+/**
+ * Capture the active OpenTelemetry trace context if @opentelemetry/api is
+ * available. Returns an empty object otherwise — no hard dependency.
+ *
+ * The require() lookup is performed at most once and cached, since it shows
+ * up on the hot path of every `run()` call.
+ */
+const EMPTY_TRACE = Object.freeze({});
+let __otelApi;
+function captureTraceContext() {
+    if (__otelApi === undefined) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            __otelApi = require('@opentelemetry/api');
+        }
+        catch {
+            __otelApi = null;
+        }
+    }
+    if (!__otelApi)
+        return EMPTY_TRACE;
+    const carrier = {};
+    __otelApi.propagation.inject(__otelApi.context.active(), carrier);
+    // Return the shared empty object when nothing was injected to avoid
+    // a per-call structuredClone of an empty object across the worker boundary.
+    for (const _k in carrier) {
+        void _k;
+        return carrier;
+    }
+    return EMPTY_TRACE;
+}
 //# sourceMappingURL=worker.service.js.map

package/dist/core/worker.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.service.js","sourceRoot":"","sources":["../../src/core/worker.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAmF;AACnF,+CAAyC;AACzC,sEAAsE;AACtE,uDAAuD;AAGvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAa;IAWL;IAEA;IAZX,IAAI,GAAsB,IAAI,CAAC;IACtB,WAAW,GAAG,IAAI,GAAG,EAMnC,CAAC;IAEJ,YACmB,SAAiC,EAEjC,OAA4B;QAF5B,cAAS,GAAT,SAAS,CAAwB;QAEjC,YAAO,GAAP,OAAO,CAAqB;IAE/C,CAAC;IAED,YAAY;QACV,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAEO,QAAQ;QACd,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO;QAEtB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,EAAE,EACxC,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAC,CACjD,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAA,kCAAkB,EAAC,KAAK,CAAC,CAAC;QAE7C,IAAI,CAAC,IAAI,GAAG,IAAI,wBAAU,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,GAAG,CACD,WAAmB,EACnB,UAAkB,EAClB,OAAkB,EAAE,EACpB,YAA2D,EAAE;QAE7D,MAAM,GAAG,GAAG,GAAG,WAAW,IAAI,UAAU,EAAE,CAAC;QAE3C,MAAM,QAAQ,GACZ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YACzB,EAAC,QAAQ,EAAE,QAAwB,EAAC,CAAC;QAEvC,OAAO,IAAI,CAAC,IAAK,CAAC,OAAO,CAAI;YAC3B,WAAW;YACX,UAAU;YACV,IAAI;YACJ,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;YACjD,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;SAC/C,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;CACF,CAAA;AAnGY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;IAaR,WAAA,IAAA,eAAM,EAAC,gBAAgB,CAAC,CAAA;qCADG,0CAAsB;GAXzC,aAAa,CAmGzB"}
+{"version":3,"file":"worker.service.js","sourceRoot":"","sources":["../../src/core/worker.service.ts"],"names":[],"mappings":"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"}

package/dist/decorators/worker-task.decorator.d.ts

@@ -2,36 +2,18 @@ import 'reflect-metadata';
 export declare const WORKER_CLASS_META = "worker:class";
 export declare const WORKER_METHOD_META = "worker:method";
 export declare const WORKER_DEPS_META = "worker:deps";
+export declare const WORKER_PROXY_META = "worker:proxy";
 export interface WorkerTaskOptions {
     priority?: 'HIGH' | 'NORMAL' | 'LOW';
     timeout?: number;
+    /** Number of additional attempts after the first failure. Default: 0. */
+    retry?: number;
+    /** Delay in ms between retry attempts. Supports exponential backoff
+     *  when set as a function: (attempt) => attempt * 1000 */
+    retryDelay?: number | ((attempt: number) => number);
 }
-/**
- * @WorkerClass() – marks a provider as a container of worker tasks.
- *
- * The discovery service scans all NestJS providers for this marker,
- * then inspects each method for @WorkerTask().
- *
- * Declare any injectable deps that your @WorkerTask methods need via
- * the `deps` option. These are resolved from the live NestJS container,
- * serialised, and reconstructed inside each worker thread.
- *
- * @example
- *   @WorkerClass({ deps: [ConfigService] })
- *   export class ImageService { ... }
- */
 export declare function WorkerClass(options?: {
     deps?: (abstract new (...a: unknown[]) => unknown)[];
+    proxy?: (abstract new (...a: unknown[]) => unknown)[];
 }): ClassDecorator;
-/**
- * @WorkerTask() – marks a method to be offloaded to a worker thread.
- *
- * The method must be pure with respect to thread-crossing:
- * its arguments and return value must be structured-clone compatible.
- * Any NestJS deps it needs should be declared on @WorkerClass({ deps }).
- *
- * @example
- *   @WorkerTask({ priority: 'HIGH', timeout: 5000 })
- *   resizeImage(value: number): number { ... }
- */
 export declare function WorkerTask(options?: WorkerTaskOptions): MethodDecorator;

package/dist/decorators/worker-task.decorator.js

@@ -1,45 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKER_DEPS_META = exports.WORKER_METHOD_META = exports.WORKER_CLASS_META = void 0;
+exports.WORKER_PROXY_META = exports.WORKER_DEPS_META = exports.WORKER_METHOD_META = exports.WORKER_CLASS_META = void 0;
 exports.WorkerClass = WorkerClass;
 exports.WorkerTask = WorkerTask;
 require("reflect-metadata");
 exports.WORKER_CLASS_META = 'worker:class';
 exports.WORKER_METHOD_META = 'worker:method';
 exports.WORKER_DEPS_META = 'worker:deps';
-/**
- * @WorkerClass() – marks a provider as a container of worker tasks.
- *
- * The discovery service scans all NestJS providers for this marker,
- * then inspects each method for @WorkerTask().
- *
- * Declare any injectable deps that your @WorkerTask methods need via
- * the `deps` option. These are resolved from the live NestJS container,
- * serialised, and reconstructed inside each worker thread.
- *
- * @example
- *   @WorkerClass({ deps: [ConfigService] })
- *   export class ImageService { ... }
- */
+exports.WORKER_PROXY_META = 'worker:proxy';
 function WorkerClass(options = {}) {
     return (target) => {
         Reflect.defineMetadata(exports.WORKER_CLASS_META, true, target);
         if (options.deps?.length) {
             Reflect.defineMetadata(exports.WORKER_DEPS_META, options.deps, target);
         }
+        if (options.proxy?.length) {
+            Reflect.defineMetadata(exports.WORKER_PROXY_META, options.proxy, target);
+        }
     };
 }
-/**
- * @WorkerTask() – marks a method to be offloaded to a worker thread.
- *
- * The method must be pure with respect to thread-crossing:
- * its arguments and return value must be structured-clone compatible.
- * Any NestJS deps it needs should be declared on @WorkerClass({ deps }).
- *
- * @example
- *   @WorkerTask({ priority: 'HIGH', timeout: 5000 })
- *   resizeImage(value: number): number { ... }
- */
 function WorkerTask(options = {}) {
     return (target, propertyKey) => {
         Reflect.defineMetadata(exports.WORKER_METHOD_META, options, target, propertyKey);

package/dist/decorators/worker-task.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker-task.decorator.js","sourceRoot":"","sources":["../../src/decorators/worker-task.decorator.ts"],"names":[],"mappings":";;;AAyBA,kCASC;AAaD,gCAIC;AAnDD,4BAA0B;AAEb,QAAA,iBAAiB,GAAG,cAAc,CAAC;AACnC,QAAA,kBAAkB,GAAG,eAAe,CAAC;AACrC,QAAA,gBAAgB,GAAG,aAAa,CAAC;AAO9C;;;;;;;;;;;;;GAaG;AACH,SAAgB,WAAW,CACzB,UAAoE,EAAE;IAEtE,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,CAAC,cAAc,CAAC,yBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,cAAc,CAAC,wBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,UAAU,CAAC,UAA6B,EAAE;IACxD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,OAAO,CAAC,cAAc,CAAC,0BAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"worker-task.decorator.js","sourceRoot":"","sources":["../../src/decorators/worker-task.decorator.ts"],"names":[],"mappings":";;;AAiBA,kCAeC;AAED,gCAIC;AAtCD,4BAA0B;AAEb,QAAA,iBAAiB,GAAI,cAAc,CAAC;AACpC,QAAA,kBAAkB,GAAG,eAAe,CAAC;AACrC,QAAA,gBAAgB,GAAK,aAAa,CAAC;AACnC,QAAA,iBAAiB,GAAI,cAAc,CAAC;AAYjD,SAAgB,WAAW,CACzB,UAGI,EAAE;IAEN,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,CAAC,cAAc,CAAC,yBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,cAAc,CAAC,wBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAC1B,OAAO,CAAC,cAAc,CAAC,yBAAiB,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,UAAU,CAAC,UAA6B,EAAE;IACxD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,OAAO,CAAC,cAAc,CAAC,0BAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC"}

package/dist/discovery/discovery.service.d.ts

@@ -1,20 +1,13 @@
 import { ModuleRef, ModulesContainer } from '@nestjs/core';
 import type { DiscoveredTask } from '../core/worker.interfaces';
-/**
- * WorkerDiscoveryService
- *
- * Scans both module.providers AND module.controllers so that
- * @WorkerClass() / @WorkerTask() work on NestJS controllers too.
- *
- * scan() is called lazily by WorkerService on the first run() call,
- * guaranteeing all providers and controllers are fully instantiated.
- */
 export declare class WorkerDiscoveryService {
     private readonly modulesContainer;
     private readonly moduleRef;
+    private readonly logger;
     private scanned;
     private discovered;
     constructor(modulesContainer: ModulesContainer, moduleRef: ModuleRef);
     scan(): DiscoveredTask[];
     private inspectWrapper;
+    private resolveToken;
 }

package/dist/discovery/discovery.service.js

@@ -8,23 +8,16 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var WorkerDiscoveryService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkerDiscoveryService = void 0;
 const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
 const worker_task_decorator_1 = require("../decorators/worker-task.decorator");
-/**
- * WorkerDiscoveryService
- *
- * Scans both module.providers AND module.controllers so that
- * @WorkerClass() / @WorkerTask() work on NestJS controllers too.
- *
- * scan() is called lazily by WorkerService on the first run() call,
- * guaranteeing all providers and controllers are fully instantiated.
- */
-let WorkerDiscoveryService = class WorkerDiscoveryService {
+let WorkerDiscoveryService = WorkerDiscoveryService_1 = class WorkerDiscoveryService {
     modulesContainer;
     moduleRef;
+    logger = new common_1.Logger(WorkerDiscoveryService_1.name);
     scanned = false;
     discovered = [];
     constructor(modulesContainer, moduleRef) {
@@ -36,59 +29,131 @@ let WorkerDiscoveryService = class WorkerDiscoveryService {
             return this.discovered;
         this.scanned = true;
         for (const module of this.modulesContainer.values()) {
-            // Scan providers (services, repositories, etc.)
             for (const wrapper of module.providers.values()) {
                 this.inspectWrapper(wrapper);
             }
-            // Scan controllers — NestJS registers these separately
             for (const wrapper of module.controllers.values()) {
                 this.inspectWrapper(wrapper);
             }
         }
+        if (this.discovered.length === 0) {
+            this.logger.warn('No @WorkerTask methods found. Ensure at least one class is decorated ' +
+                'with @WorkerClass() and has methods decorated with @WorkerTask().');
+        }
         return this.discovered;
     }
     inspectWrapper(wrapper) {
         const { instance, metatype } = wrapper;
         if (!instance || !metatype)
             return;
-        const isWorkerClass = Reflect.getMetadata(worker_task_decorator_1.WORKER_CLASS_META, metatype);
-        if (!isWorkerClass)
+        if (!Reflect.getMetadata(worker_task_decorator_1.WORKER_CLASS_META, metatype))
             return;
         const serviceName = metatype.name;
-        const proto = Object.getPrototypeOf(instance);
+        const proto = metatype.prototype;
+        // ── serialised deps ───────────────────────────────────────────────────
         const depTypes = Reflect.getMetadata(worker_task_decorator_1.WORKER_DEPS_META, metatype) ?? [];
-        const deps = depTypes.map((token) => {
-            try {
-                return this.moduleRef.get(token, { strict: false });
+        const deps = depTypes.map((token) => this.resolveToken(token, serviceName, 'deps'));
+        // ── proxy services ────────────────────────────────────────────────────
+        const proxyTypes = Reflect.getMetadata(worker_task_decorator_1.WORKER_PROXY_META, metatype) ?? [];
+        const proxyInstances = proxyTypes.map((token) => {
+            const svcInstance = this.resolveToken(token, serviceName, 'proxy');
+            const tokenName = token.name ?? 'unknown';
+            const propertyKey = findPropertyKey(instance, svcInstance) ?? camelCase(tokenName);
+            if (!findPropertyKey(instance, svcInstance)) {
+                this.logger.warn(`${serviceName}: could not find property key for proxy "${tokenName}" ` +
+                    `— falling back to camelCase: "${propertyKey}".`);
             }
-            catch {
-                return undefined;
+            const methodNames = [];
+            if (svcInstance) {
+                let cursor = Object.getPrototypeOf(svcInstance);
+                while (cursor && cursor !== Object.prototype) {
+                    for (const k of Object.getOwnPropertyNames(cursor)) {
+                        if (k !== 'constructor' && !methodNames.includes(k)) {
+                            const desc = Object.getOwnPropertyDescriptor(cursor, k);
+                            if (desc && typeof desc.value === 'function')
+                                methodNames.push(k);
+                        }
+                    }
+                    cursor = Object.getPrototypeOf(cursor);
+                }
             }
+            return { propertyKey, methodNames, instance: svcInstance ?? {} };
         });
+        // ── @WorkerTask methods ───────────────────────────────────────────────
+        let tasksFound = 0;
         for (const methodName of Object.getOwnPropertyNames(proto)) {
             if (methodName === 'constructor')
                 continue;
             const options = Reflect.getMetadata(worker_task_decorator_1.WORKER_METHOD_META, proto, methodName);
             if (!options)
                 continue;
+            tasksFound++;
+            // Normalise retryDelay: function form → serialised as max of first 3 calls
+            // (functions can't cross the thread boundary; we store the numeric value)
+            let retryDelay;
+            if (typeof options.retryDelay === 'function') {
+                // Store delays for attempts 1-3 as a simple average to give workers
+                // a representative delay. For production use, pass a number.
+                const fn = options.retryDelay;
+                retryDelay = Math.round((fn(1) + fn(2) + fn(3)) / 3);
+                this.logger.warn(`${serviceName}.${methodName}: retryDelay as a function is not supported ` +
+                    `across thread boundaries. Computed average: ${retryDelay}ms. ` +
+                    `Pass a number for precise control.`);
+            }
+            else {
+                retryDelay = options.retryDelay;
+            }
             const fn = instance[methodName].bind(instance);
             this.discovered.push({
                 serviceName,
                 methodName,
                 priority: options.priority ?? 'NORMAL',
                 timeout: options.timeout,
+                retry: options.retry,
+                retryDelay,
                 fn,
                 metatype: metatype,
                 instance,
                 deps,
+                proxyInstances,
             });
+            this.logger.debug(`Registered task: ${serviceName}.${methodName} ` +
+                `[priority=${options.priority ?? 'NORMAL'}` +
+                `${options.timeout ? `, timeout=${options.timeout}ms` : ''}` +
+                `${options.retry ? `, retry=${options.retry}` : ''}]`);
+        }
+        if (tasksFound === 0) {
+            this.logger.warn(`${serviceName} has @WorkerClass() but no @WorkerTask() methods.`);
+        }
+    }
+    resolveToken(token, ownerName, role) {
+        try {
+            return this.moduleRef.get(token, { strict: false });
+        }
+        catch (err) {
+            const name = token.name ?? String(token);
+            this.logger.error(`${ownerName}: failed to resolve ${role} token "${name}". ` +
+                `Original error: ${err.message}`);
+            return undefined;
         }
     }
 };
 exports.WorkerDiscoveryService = WorkerDiscoveryService;
-exports.WorkerDiscoveryService = WorkerDiscoveryService = __decorate([
+exports.WorkerDiscoveryService = WorkerDiscoveryService = WorkerDiscoveryService_1 = __decorate([
     (0, common_1.Injectable)(),
     __metadata("design:paramtypes", [core_1.ModulesContainer,
         core_1.ModuleRef])
 ], WorkerDiscoveryService);
+function findPropertyKey(serviceInstance, depInstance) {
+    if (!serviceInstance || !depInstance || typeof serviceInstance !== 'object')
+        return undefined;
+    for (const key of Object.getOwnPropertyNames(serviceInstance)) {
+        if (serviceInstance[key] === depInstance)
+            return key;
+    }
+    return undefined;
+}
+function camelCase(name) {
+    return name.charAt(0).toLowerCase() + name.slice(1);
+}
 //# sourceMappingURL=discovery.service.js.map

package/dist/discovery/discovery.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.service.js","sourceRoot":"","sources":["../../src/discovery/discovery.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,uCAA2D;AAE3D,+EAK6C;AAG7C;;;;;;;;GAQG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAKd;IACA;IALX,OAAO,GAAG,KAAK,CAAC;IAChB,UAAU,GAAqB,EAAE,CAAC;IAE1C,YACmB,gBAAkC,EAClC,SAAoB;QADpB,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,cAAS,GAAT,SAAS,CAAW;IACpC,CAAC;IAEJ,IAAI;QACF,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;YACpD,gDAAgD;YAChD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChD,IAAI,CAAC,cAAc,CAAC,OAA0B,CAAC,CAAC;YAClD,CAAC;YACD,uDAAuD;YACvD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;gBAClD,IAAI,CAAC,cAAc,CAAC,OAA0B,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAEO,cAAc,CAAC,OAAwB;QAC7C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QACvC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEnC,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,yCAAiB,EAAE,QAAQ,CAAC,CAAC;QACvE,IAAI,CAAC,aAAa;YAAE,OAAO;QAE3B,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAA4B,CAAC;QAEzE,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,wCAAgB,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAExD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAClC,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,IAAI,UAAU,KAAK,aAAa;gBAAE,SAAS;YAC3C,MAAM,OAAO,GAAkC,OAAO,CAAC,WAAW,CAChE,0CAAkB,EAClB,KAAK,EACL,UAAU,CACX,CAAC;YACF,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,EAAE,GACN,QACD,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAE7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBACnB,WAAW;gBACX,UAAU;gBACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ;gBACtC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,EAAE;gBACF,QAAQ,EAAE,QAA+C;gBACzD,QAAQ;gBACR,IAAI;aACL,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAA;AAzEY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAM0B,uBAAgB;QACvB,gBAAS;GAN5B,sBAAsB,CAyElC"}
+{"version":3,"file":"discovery.service.js","sourceRoot":"","sources":["../../src/discovery/discovery.service.ts"],"names":[],"mappings":"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"}

package/dist/example/bench.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Throughput / latency micro-benchmark.
+ *
+ * Usage:
+ *   npx ts-node src/example/bench.ts            # default 5000 tasks
+ *   TASKS=20000 POOL=8 npx ts-node src/example/bench.ts
+ *
+ * Reports:
+ *   - cold-start time (until pool is ready for first task)
+ *   - p50 / p95 / p99 / max round-trip latency
+ *   - sustained throughput (tasks / second)
+ */
+import 'reflect-metadata';