nestworker 2.0.4 → 2.1.0

package/dist/core/worker.service.js

@@ -11,123 +11,151 @@ 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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var WorkerService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkerService = void 0;
 const common_1 = require("@nestjs/common");
+const node_crypto_1 = __importDefault(require("node:crypto"));
 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 {
+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();
     constructor(discovery, options) {
         this.discovery = discovery;
         this.options = options;
     }
+    onModuleInit() {
+        this.initPool();
+    }
     initPool() {
         if (this.pool)
             return;
         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.
+     * Run a @WorkerTask method in a worker thread.
      *
-     * 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.
-     *
-     * 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 = {}) {
-        this.initPool();
+    run(serviceName, methodName, args = [], options = {}) {
         const key = `${serviceName}.${methodName}`;
-        const defaults = this.taskOptions.get(key) ??
-            { priority: 'NORMAL' };
+        const defaults = this.taskDefaults.get(key) ?? { priority: 'NORMAL' };
+        const proxyServices = this.taskProxies.get(key) ?? [];
+        // Capture ALS context from all registered storages
+        const alsContext = {};
+        for (const [i, als] of (this.options.asyncLocalStorages ?? []).entries()) {
+            const store = als.getStore();
+            if (store !== undefined)
+                alsContext[String(i)] = store;
+        }
+        // Capture OTEL trace context if available
+        const traceContext = captureTraceContext();
+        // Generate a unique signal ID if an AbortSignal was provided
+        const abortSignalId = options.signal ? node_crypto_1.default.randomUUID() : undefined;
         return this.pool.execute({
+            jobId: node_crypto_1.default.randomUUID(),
             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,
+            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.
+ */
+function captureTraceContext() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const api = require('@opentelemetry/api');
+        const carrier = {};
+        api.propagation.inject(api.context.active(), carrier);
+        return carrier;
+    }
+    catch {
+        return {};
+    }
+}
 //# 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,2CAAmE;AACnE,+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;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,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,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;AAjGY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;IAaR,WAAA,IAAA,eAAM,EAAC,gBAAgB,CAAC,CAAA;qCADG,0CAAsB;GAXzC,aAAa,CAiGzB"}
+{"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/di/di-serializer.d.ts

@@ -4,15 +4,16 @@ import type { SerializedService } from './worker-container';
  * serializeForWorker – converts the live NestJS service graph into a
  * structured-clone-safe SerializedService[] payload for workerData.
  *
- * KEY DESIGN DECISION: class source extraction instead of file paths.
+ * KEY DESIGN DECISION: file paths instead of class source strings.
  *
- * We cannot pass filePaths to workers because require(filePath) inside a
- * worker thread re-executes the compiled .ts output which imports @nestjs/common
- * at the top level — crashing the isolated worker context.
+ * The previous approach extracted class source via Class.toString() and
+ * eval()'d it inside the worker. This broke on any import that TS compiled
+ * to a file-scoped alias (crypto_1, node_os_1, …) because those aliases
+ * don't exist inside a bare new Function() scope.
  *
- * Instead we extract each class's constructor and prototype methods as plain JS
- * source strings on the main thread (where NestJS is fully loaded), then send
- * those strings via workerData. WorkerContainer eval()s them in the worker —
- * no require(), no NestJS imports, no crash.
+ * The new approach sends the absolute path to each compiled .js file.
+ * WorkerContainer runs each file in a vm context with a custom require()
+ * that stubs NestJS packages (so decorator calls at file-eval time are
+ * silent no-ops) while letting all other imports resolve normally.
  */
 export declare function serializeForWorker(tasks: DiscoveredTask[]): SerializedService[];

package/dist/di/di-serializer.js

@@ -6,16 +6,17 @@ const worker_task_decorator_1 = require("../decorators/worker-task.decorator");
  * serializeForWorker – converts the live NestJS service graph into a
  * structured-clone-safe SerializedService[] payload for workerData.
  *
- * KEY DESIGN DECISION: class source extraction instead of file paths.
+ * KEY DESIGN DECISION: file paths instead of class source strings.
  *
- * We cannot pass filePaths to workers because require(filePath) inside a
- * worker thread re-executes the compiled .ts output which imports @nestjs/common
- * at the top level — crashing the isolated worker context.
+ * The previous approach extracted class source via Class.toString() and
+ * eval()'d it inside the worker. This broke on any import that TS compiled
+ * to a file-scoped alias (crypto_1, node_os_1, …) because those aliases
+ * don't exist inside a bare new Function() scope.
  *
- * Instead we extract each class's constructor and prototype methods as plain JS
- * source strings on the main thread (where NestJS is fully loaded), then send
- * those strings via workerData. WorkerContainer eval()s them in the worker —
- * no require(), no NestJS imports, no crash.
+ * The new approach sends the absolute path to each compiled .js file.
+ * WorkerContainer runs each file in a vm context with a custom require()
+ * that stubs NestJS packages (so decorator calls at file-eval time are
+ * silent no-ops) while letting all other imports resolve normally.
  */
 function serializeForWorker(tasks) {
     const byService = new Map();
@@ -31,21 +32,32 @@ function serializeForWorker(tasks) {
     }
     const result = [];
     for (const [serviceName, { representative, methods }] of byService) {
-        const { metatype, instance, deps } = representative;
+        const { metatype, instance } = representative;
         const depTypes = Reflect.getMetadata(worker_task_decorator_1.WORKER_DEPS_META, metatype) ?? [];
-        const serializedDeps = depTypes.map((DepType, i) => {
-            const depInstance = deps[i];
-            const propertyKey = findDepPropertyKey(instance, depInstance) ?? camelCase(DepType.name);
+        const serializedDeps = depTypes.map((DepType) => {
+            // Derive the property key from the class name first as a candidate,
+            // then verify by looking at the live instance's own properties.
+            // We read the dep instance DIRECTLY from the service instance's property
+            // rather than from moduleRef.get() — this avoids the NestJS Proxy
+            // mismatch where moduleRef returns the real instance but the service
+            // holds a lazy Proxy wrapper (different references, same underlying object).
+            const candidateKey = camelCase(DepType.name);
+            const propertyKey = findDepPropertyKey(instance, DepType) ?? candidateKey;
+            // Always read the dep from the live service instance by property key —
+            // this gives us the exact object the service will use at runtime,
+            // including any NestJS Proxy wrapper, so snapshot captures real state.
+            const depInstance = instance[propertyKey] ??
+                instance[candidateKey];
             return {
                 name: DepType.name,
-                classSource: extractClassSource(DepType),
+                filePath: findFilePath(DepType),
                 snapshot: snapshotInstance(depInstance),
-                propertyKey,
+                propertyKey: propertyKey ?? candidateKey,
             };
         });
         result.push({
             name: serviceName,
-            classSource: extractClassSource(metatype),
+            filePath: findFilePath(metatype),
             methods,
             deps: serializedDeps,
         });
@@ -53,38 +65,43 @@ function serializeForWorker(tasks) {
     return result;
 }
 /**
- * Extract a plain, self-contained class source string from a constructor.
- *
- * In TypeScript compiled output, Function.prototype.toString() on a class
- * returns the full class body including all methods — but WITHOUT the
- * import statements or decorator calls at the top of the file.
- *
- * Example output:
- *   "class ConfigService {
- *      constructor() { this.config = { MULTIPLIER: '3' }; }
- *      get(k) { return this.config[k]; }
- *      getNumber(k) { return Number(this.config[k]); }
- *    }"
- *
- * This is eval()-safe and has no NestJS dependencies.
+ * Locate the compiled .js file for this constructor by scanning require.cache.
+ * NestJS loads all providers via require() so every user-defined class will
+ * be present in the cache at the time serializeForWorker() is called.
  */
-function extractClassSource(metatype) {
-    const src = metatype.toString();
-    // Compiled TS classes always start with "class ClassName"
-    // Strip any leading helper assignments TypeScript sometimes emits
-    const classStart = src.indexOf('class ');
-    if (classStart === -1) {
-        throw new Error(`Could not extract class source for "${metatype.name}". ` +
-            `Ensure the project is compiled with "target": "ES2022" or higher ` +
-            `so classes are emitted as native class declarations, not functions.`);
+function findFilePath(ctor) {
+    for (const [filePath, mod] of Object.entries(require.cache)) {
+        if (!mod?.exports || typeof mod.exports !== 'object')
+            continue;
+        // Object.values() triggers getters on prototype-based exports (e.g. Express
+        // IncomingMessage.protocol accesses this.socket which is undefined at scan
+        // time). Iterate keys manually and guard each access with try/catch.
+        for (const key of Object.keys(mod.exports)) {
+            // Skip getters entirely — accessing them may trigger deprecation warnings
+            // (e.g. Express req.host) or throw (e.g. IncomingMessage.protocol).
+            // Constructors are always plain value exports, never getters.
+            const desc = Object.getOwnPropertyDescriptor(mod.exports, key);
+            if (!desc || typeof desc.get === 'function')
+                continue;
+            if (desc.value === ctor)
+                return filePath;
+        }
     }
-    return src.slice(classStart);
+    throw new Error(`nestworker: could not find compiled file for "${ctor.name}" in require.cache. ` +
+        `Ensure the class is exported from its module file and the project is ` +
+        `compiled (not running via ts-node) before starting.`);
 }
-function findDepPropertyKey(serviceInstance, depInstance) {
+function findDepPropertyKey(serviceInstance, DepType) {
     if (!serviceInstance || typeof serviceInstance !== 'object')
         return undefined;
-    for (const [key, value] of Object.entries(serviceInstance)) {
-        if (value === depInstance)
+    // private readonly fields are non-enumerable — must use getOwnPropertyNames().
+    // We match by constructor type rather than reference equality to correctly
+    // handle NestJS Proxy wrappers: the service may hold a Proxy of the dep
+    // while moduleRef.get() returns the unwrapped instance — different refs,
+    // same underlying class. instanceof sees through Proxy transparently.
+    for (const key of Object.getOwnPropertyNames(serviceInstance)) {
+        const val = serviceInstance[key];
+        if (val instanceof DepType)
             return key;
     }
     return undefined;
@@ -93,14 +110,20 @@ function snapshotInstance(instance) {
     if (!instance || typeof instance !== 'object')
         return {};
     const out = {};
-    for (const [k, v] of Object.entries(instance)) {
+    // private readonly fields are non-enumerable — must use getOwnPropertyNames()
+    for (const k of Object.getOwnPropertyNames(instance)) {
+        const v = instance[k];
         if (typeof v === 'function' || typeof v === 'symbol')
             continue;
         try {
-            structuredClone(v);
-            out[k] = v;
+            // Store the CLONED value, not the original reference.
+            // structuredClone succeeds for plain outer objects even when they
+            // contain non-cloneable internal slots nested deeply — in that case
+            // storing `v` would pass a live socket/stream reference into workerData,
+            // producing broken objects with missing internal state in the worker.
+            out[k] = structuredClone(v);
         }
-        catch { /* skip non-cloneable */ }
+        catch { /* skip non-cloneable values entirely */ }
     }
     return out;
 }

package/dist/di/di-serializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"di-serializer.js","sourceRoot":"","sources":["../../src/di/di-serializer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"di-serializer.js","sourceRoot":"","sources":["../../src/di/di-serializer.ts"],"names":[],"mappings":"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"}