nestworker 1.1.21 → 2.0.8

package/dist/di/di-serializer.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeForWorker = serializeForWorker;
+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: file paths instead of class source strings.
+ *
+ * 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.
+ *
+ * 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();
+    for (const task of tasks) {
+        if (!byService.has(task.serviceName)) {
+            byService.set(task.serviceName, { representative: task, methods: [] });
+        }
+        byService.get(task.serviceName).methods.push({
+            methodName: task.methodName,
+            priority: task.priority,
+            timeout: task.timeout,
+        });
+    }
+    const result = [];
+    for (const [serviceName, { representative, methods }] of byService) {
+        const { metatype, instance } = representative;
+        const depTypes = Reflect.getMetadata(worker_task_decorator_1.WORKER_DEPS_META, metatype) ?? [];
+        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,
+                filePath: findFilePath(DepType),
+                snapshot: snapshotInstance(depInstance),
+                propertyKey: propertyKey ?? candidateKey,
+            };
+        });
+        result.push({
+            name: serviceName,
+            filePath: findFilePath(metatype),
+            methods,
+            deps: serializedDeps,
+        });
+    }
+    return result;
+}
+/**
+ * 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 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;
+        }
+    }
+    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, DepType) {
+    if (!serviceInstance || typeof serviceInstance !== 'object')
+        return undefined;
+    // 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;
+}
+function snapshotInstance(instance) {
+    if (!instance || typeof instance !== 'object')
+        return {};
+    const out = {};
+    // 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 {
+            // 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 values entirely */ }
+    }
+    return out;
+}
+function camelCase(name) {
+    return name.charAt(0).toLowerCase() + name.slice(1);
+}
+//# sourceMappingURL=di-serializer.js.map

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

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

package/dist/di/worker-container.d.ts

@@ -0,0 +1,60 @@
+/**
+ * WorkerContainer – minimal DI container for worker threads.
+ *
+ * APPROACH: vm.runInNewContext() with a shared module cache.
+ *
+ * Each compiled .js file is executed inside a vm context that has:
+ *   - A custom require() that blocks NestJS bootstrap imports (returning
+ *     transparent Proxy stubs so decorator calls at file-eval time are no-ops)
+ *   - Full access to Node built-ins and third-party packages
+ *   - Correct __filename / __dirname so relative requires resolve properly
+ *
+ * This avoids every problem of the new Function() approach:
+ *   - No alias injection (crypto_1, node_os_1, …)
+ *   - No TS helper injection (__importStar, __importDefault, …)
+ *   - No class-body-only extraction — the full compiled file runs as-is
+ *   - Dynamic import() and require() both work natively
+ */
+export interface SerializedDep {
+    name: string;
+    /** Absolute path to the compiled .js file that exports this class */
+    filePath: string;
+    snapshot: Record<string, unknown>;
+    propertyKey: string;
+}
+export interface SerializedMethod {
+    methodName: string;
+    priority: 'HIGH' | 'NORMAL' | 'LOW';
+    timeout?: number;
+}
+export interface SerializedService {
+    name: string;
+    /** Absolute path to the compiled .js file that exports this class */
+    filePath: string;
+    methods: SerializedMethod[];
+    deps: SerializedDep[];
+}
+export declare class WorkerContainer {
+    private readonly instances;
+    /**
+     * Module export cache — keyed by absolute file path.
+     * Avoids re-executing the same file multiple times when several services
+     * live in the same compiled output (monorepo barrel files, etc.).
+     */
+    private readonly fileCache;
+    load(services: SerializedService[]): void;
+    get<T>(name: string): T;
+    private reconstructFromFile;
+    /**
+     * Load a named export from a compiled .js file by running it in a vm
+     * context. The context's require() stubs NestJS packages so decorators
+     * at file-eval time are silent no-ops, while all other imports resolve
+     * normally through the real Node module system.
+     */
+    private loadClass;
+    /**
+     * Execute a compiled .js file in an isolated vm context and return its
+     * module.exports. Results are cached by file path.
+     */
+    private runFile;
+}

package/dist/di/worker-container.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * WorkerContainer – minimal DI container for worker threads.
+ *
+ * APPROACH: vm.runInNewContext() with a shared module cache.
+ *
+ * Each compiled .js file is executed inside a vm context that has:
+ *   - A custom require() that blocks NestJS bootstrap imports (returning
+ *     transparent Proxy stubs so decorator calls at file-eval time are no-ops)
+ *   - Full access to Node built-ins and third-party packages
+ *   - Correct __filename / __dirname so relative requires resolve properly
+ *
+ * This avoids every problem of the new Function() approach:
+ *   - No alias injection (crypto_1, node_os_1, …)
+ *   - No TS helper injection (__importStar, __importDefault, …)
+ *   - No class-body-only extraction — the full compiled file runs as-is
+ *   - Dynamic import() and require() both work natively
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerContainer = void 0;
+const node_vm_1 = __importDefault(require("node:vm"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_module_1 = __importDefault(require("node:module"));
+const node_fs_1 = __importDefault(require("node:fs"));
+/**
+ * NestJS packages that must never be required inside a worker.
+ * Requiring them triggers the full NestJS bootstrap chain which crashes
+ * in an isolated vm context. We stub them with a transparent Proxy so
+ * decorator calls (@Injectable, @Controller, etc.) at file-eval time
+ * become silent no-ops.
+ */
+const NESTJS_STUB_PACKAGES = new Set([
+    '@nestjs/common',
+    '@nestjs/core',
+    '@nestjs/microservices',
+    '@nestjs/platform-express',
+    '@nestjs/platform-fastify',
+    'reflect-metadata',
+]);
+/**
+ * A Proxy that silently absorbs NestJS decorator calls at file-eval time.
+ *
+ * The apply trap passes through its first argument when it is a function —
+ * this preserves the class through decorator factory patterns emitted by TS:
+ *
+ *   MyClass = Injectable()(MyClass) ?? MyClass
+ *            └─ NOOP_STUB() ──┘└─ apply(MyClass) → MyClass ─┘
+ *
+ * Without this, NOOP_STUB would replace the class, breaking all exports.
+ */
+const NOOP_STUB = new Proxy(
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+function () { }, {
+    get: (_t, _k) => NOOP_STUB,
+    apply: (_t, _this, args) => {
+        // If called with a class/function as the first arg (decorator pattern),
+        // return it unchanged so the assignment keeps the real class.
+        const first = args[0];
+        return typeof first === 'function' ? first : NOOP_STUB;
+    },
+    construct: () => Object.create(null),
+});
+// ── WorkerContainer ───────────────────────────────────────────────────────
+class WorkerContainer {
+    instances = new Map();
+    /**
+     * Module export cache — keyed by absolute file path.
+     * Avoids re-executing the same file multiple times when several services
+     * live in the same compiled output (monorepo barrel files, etc.).
+     */
+    fileCache = new Map();
+    load(services) {
+        for (const svc of services) {
+            // Reconstruct each dep from its compiled file + snapshot
+            const depsByKey = new Map();
+            for (const dep of svc.deps) {
+                const inst = this.reconstructFromFile(dep.filePath, dep.name, dep.snapshot);
+                this.instances.set(dep.name, inst);
+                depsByKey.set(dep.propertyKey, inst);
+            }
+            // Allocate the service without calling its constructor — deps are
+            // assigned by property key so constructor slot order never matters.
+            const ServiceClass = this.loadClass(svc.filePath, svc.name);
+            const serviceInstance = Object.create(ServiceClass.prototype);
+            for (const [key, inst] of depsByKey) {
+                serviceInstance[key] = inst;
+            }
+            this.instances.set(svc.name, serviceInstance);
+        }
+    }
+    get(name) {
+        const inst = this.instances.get(name);
+        if (!inst)
+            throw new Error(`WorkerContainer: "${name}" not found`);
+        return inst;
+    }
+    reconstructFromFile(filePath, className, snapshot) {
+        const DepClass = this.loadClass(filePath, className);
+        const instance = Object.create(DepClass.prototype);
+        Object.assign(instance, snapshot);
+        return instance;
+    }
+    /**
+     * Load a named export from a compiled .js file by running it in a vm
+     * context. The context's require() stubs NestJS packages so decorators
+     * at file-eval time are silent no-ops, while all other imports resolve
+     * normally through the real Node module system.
+     */
+    loadClass(filePath, className) {
+        const exports = this.runFile(filePath);
+        const cls = exports[className];
+        if (typeof cls !== 'function') {
+            throw new Error(`WorkerContainer: "${className}" not found in "${filePath}". ` +
+                `Available exports: ${Object.keys(exports).join(', ')}`);
+        }
+        return cls;
+    }
+    /**
+     * Execute a compiled .js file in an isolated vm context and return its
+     * module.exports. Results are cached by file path.
+     */
+    runFile(filePath) {
+        const cached = this.fileCache.get(filePath);
+        if (cached)
+            return cached;
+        const source = node_fs_1.default.readFileSync(filePath, 'utf8');
+        const mod = { exports: {} };
+        const customRequire = node_module_1.default.createRequire(filePath);
+        const sandboxRequire = (id) => {
+            if (NESTJS_STUB_PACKAGES.has(id))
+                return NOOP_STUB;
+            return customRequire(id);
+        };
+        const context = node_vm_1.default.createContext({
+            require: sandboxRequire,
+            module: mod,
+            exports: mod.exports,
+            __filename: filePath,
+            __dirname: node_path_1.default.dirname(filePath),
+            // Standard globals the compiled output may reference
+            console,
+            process,
+            Buffer,
+            URL,
+            URLSearchParams,
+            fetch,
+            setTimeout,
+            clearTimeout,
+            setInterval,
+            clearInterval,
+            setImmediate,
+            clearImmediate,
+            Promise,
+            // Make the context's global === the context itself so that
+            // `(this && this.__importStar)` patterns resolve to the context global
+            // rather than to undefined (as they would in new Function()).
+            global: undefined, // set below after createContext
+        });
+        // Wire global → context so self-referential global patterns work
+        context.global = context;
+        node_vm_1.default.runInContext(source, context, { filename: filePath });
+        this.fileCache.set(filePath, mod.exports);
+        return mod.exports;
+    }
+}
+exports.WorkerContainer = WorkerContainer;
+//# sourceMappingURL=worker-container.js.map

package/dist/di/worker-container.js.map

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

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

@@ -0,0 +1,20 @@
+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 scanned;
+    private discovered;
+    constructor(modulesContainer: ModulesContainer, moduleRef: ModuleRef);
+    scan(): DiscoveredTask[];
+    private inspectWrapper;
+}

package/dist/discovery/discovery.service.js

@@ -0,0 +1,94 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+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 {
+    modulesContainer;
+    moduleRef;
+    scanned = false;
+    discovered = [];
+    constructor(modulesContainer, moduleRef) {
+        this.modulesContainer = modulesContainer;
+        this.moduleRef = moduleRef;
+    }
+    scan() {
+        if (this.scanned)
+            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);
+            }
+        }
+        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)
+            return;
+        const serviceName = metatype.name;
+        const proto = Object.getPrototypeOf(instance);
+        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 });
+            }
+            catch {
+                return undefined;
+            }
+        });
+        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;
+            const fn = instance[methodName].bind(instance);
+            this.discovered.push({
+                serviceName,
+                methodName,
+                priority: options.priority ?? 'NORMAL',
+                timeout: options.timeout,
+                fn,
+                metatype: metatype,
+                instance,
+                deps,
+            });
+        }
+    }
+};
+exports.WorkerDiscoveryService = WorkerDiscoveryService;
+exports.WorkerDiscoveryService = WorkerDiscoveryService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ModulesContainer,
+        core_1.ModuleRef])
+], WorkerDiscoveryService);
+//# sourceMappingURL=discovery.service.js.map

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

@@ -0,0 +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"}

package/dist/example/config.service.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ConfigService – a plain injectable dep declared on @WorkerClass.
+ *
+ * Its internal `config` map is a plain Record, so it survives
+ * structured-clone intact. WorkerContainer reconstructs it via
+ * Object.create(prototype) + Object.assign(snapshot), restoring
+ * both the get() / getNumber() methods and the runtime config values.
+ */
+export declare class ConfigService {
+    private readonly config;
+    get(key: string): string;
+    getNumber(key: string): number;
+}

package/dist/example/config.service.js

@@ -0,0 +1,35 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigService = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * ConfigService – a plain injectable dep declared on @WorkerClass.
+ *
+ * Its internal `config` map is a plain Record, so it survives
+ * structured-clone intact. WorkerContainer reconstructs it via
+ * Object.create(prototype) + Object.assign(snapshot), restoring
+ * both the get() / getNumber() methods and the runtime config values.
+ */
+let ConfigService = class ConfigService {
+    config = {
+        MULTIPLIER: '3',
+        ITERATIONS: '10000000',
+    };
+    get(key) {
+        return this.config[key] ?? '';
+    }
+    getNumber(key) {
+        return Number(this.config[key] ?? 0);
+    }
+};
+exports.ConfigService = ConfigService;
+exports.ConfigService = ConfigService = __decorate([
+    (0, common_1.Injectable)()
+], ConfigService);
+//# sourceMappingURL=config.service.js.map

package/dist/example/config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.js","sourceRoot":"","sources":["../../src/example/config.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAE5C;;;;;;;GAOG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAa;IACP,MAAM,GAA2B;QAChD,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,UAAU;KACvB,CAAC;IAEF,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;CACF,CAAA;AAbY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;GACA,aAAa,CAazB"}

package/dist/example/image.service.d.ts

@@ -0,0 +1,13 @@
+import { ConfigService } from './config.service';
+export declare class ImageService {
+    private readonly configService;
+    constructor(configService: ConfigService);
+    resizeImage(value: number): number;
+    generateThumbnail(width: number, height: number): string;
+    moduleImport(): Promise<string>;
+    moduleRequire(): Promise<string>;
+    outlineModule(): Promise<{
+        p: number;
+        f: number;
+    }>;
+}