@omnitron-dev/omnitron 0.1.1

package/dist/orchestrator/classic-launcher.js

@@ -0,0 +1,111 @@
+/**
+ * Classic Launcher — Fork existing main.ts as a child process
+ *
+ * Uses Node's child_process.fork() to spawn the app. The app manages its own
+ * lifecycle; the daemon only monitors, restarts, and collects metrics.
+ *
+ * Readiness detection:
+ * 1. IPC message { type: 'ready' } from child (preferred)
+ * 2. HTTP health probe on configured port
+ * 3. Timeout fallback (assumes ready after N seconds)
+ */
+import { fork } from 'node:child_process';
+import path from 'node:path';
+const READY_TIMEOUT = 30_000;
+export async function launchClassic(entry, handle, cwd, logger, logHandlers = []) {
+    let scriptPath = path.resolve(cwd, entry.script);
+    // If the script is TypeScript, compile it via esbuild instead of using tsx
+    if (scriptPath.endsWith('.ts')) {
+        try {
+            const { compileTypeScript } = await import('./ts-compiler.js');
+            const result = await compileTypeScript(scriptPath);
+            scriptPath = result.outputPath;
+        }
+        catch {
+            // Fall back to tsx if esbuild is not available
+            logger.warn({ app: entry.name }, 'esbuild not available for classic script — falling back to tsx');
+        }
+    }
+    const env = {
+        ...process.env,
+        ...entry.env,
+        OMNITRON_MANAGED: '1',
+        OMNITRON_APP_NAME: entry.name,
+    };
+    handle.markStarting();
+    const child = fork(scriptPath, [], {
+        cwd,
+        env,
+        stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+        // No tsx execArgv — script is either pre-compiled .js or bundled via esbuild
+        ...(scriptPath.endsWith('.ts') ? { execArgv: ['--import', 'tsx/esm'] } : {}),
+    });
+    handle.childProcess = child;
+    handle.pid = child.pid ?? null;
+    // Capture stdout/stderr → ring buffer + optional log handlers (disk persistence)
+    const captureOutput = (chunk) => {
+        const lines = chunk.toString().split('\n').filter(Boolean);
+        for (const line of lines) {
+            handle.appendLog(line);
+            // Persist to disk via registered log handlers (LogManager)
+            for (const handler of logHandlers) {
+                try {
+                    handler(entry.name, line);
+                }
+                catch {
+                    /* must not break the app */
+                }
+            }
+        }
+    };
+    child.stdout?.on('data', captureOutput);
+    child.stderr?.on('data', captureOutput);
+    // Wait for readiness
+    await waitForReady(child, handle, logger);
+    return child;
+}
+function waitForReady(child, handle, logger) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const timeout = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            // Assume ready on timeout
+            logger.warn({ app: handle.name }, 'No ready signal received, assuming ready after timeout');
+            handle.markOnline(child.pid ?? 0);
+            resolve();
+        }, READY_TIMEOUT);
+        const onMessage = (msg) => {
+            if (settled)
+                return;
+            if (msg && (msg.type === 'ready' || msg === 'ready')) {
+                settled = true;
+                clearTimeout(timeout);
+                handle.markOnline(child.pid ?? 0);
+                logger.info({ app: handle.name, pid: child.pid }, 'App ready (IPC signal)');
+                resolve();
+            }
+        };
+        const onExit = (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            handle.markErrored();
+            reject(new Error(`App '${handle.name}' exited during startup with code ${code}`));
+        };
+        const onError = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            handle.markErrored();
+            reject(err);
+        };
+        child.on('message', onMessage);
+        child.once('exit', onExit);
+        child.once('error', onError);
+    });
+}
+//# sourceMappingURL=classic-launcher.js.map

package/dist/orchestrator/classic-launcher.js.map

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

package/dist/orchestrator/dependency-resolver.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Dependency Resolver — Topological sort for app startup order
+ */
+import type { IEcosystemAppEntry } from '../config/types.js';
+/**
+ * Returns apps grouped by dependency level.
+ * Each batch can be started in parallel; batches must be started sequentially.
+ */
+export declare function resolveStartupOrder(apps: IEcosystemAppEntry[]): IEcosystemAppEntry[][];
+/**
+ * Returns reverse dependency order for shutdown.
+ */
+export declare function resolveShutdownOrder(apps: IEcosystemAppEntry[]): IEcosystemAppEntry[][];
+//# sourceMappingURL=dependency-resolver.d.ts.map

package/dist/orchestrator/dependency-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../../src/orchestrator/dependency-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,EAAE,CAgDtF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,EAAE,CAEvF"}

package/dist/orchestrator/dependency-resolver.js

@@ -0,0 +1,56 @@
+/**
+ * Dependency Resolver — Topological sort for app startup order
+ */
+/**
+ * Returns apps grouped by dependency level.
+ * Each batch can be started in parallel; batches must be started sequentially.
+ */
+export function resolveStartupOrder(apps) {
+    const byName = new Map(apps.map((a) => [a.name, a]));
+    const inDegree = new Map();
+    const adj = new Map();
+    // Initialize all nodes first so adj/inDegree exist for dependencies
+    for (const app of apps) {
+        inDegree.set(app.name, 0);
+        adj.set(app.name, []);
+    }
+    for (const app of apps) {
+        for (const dep of app.dependsOn ?? []) {
+            if (!byName.has(dep)) {
+                throw new Error(`App '${app.name}' depends on unknown app '${dep}'`);
+            }
+            adj.get(dep).push(app.name);
+            inDegree.set(app.name, (inDegree.get(app.name) ?? 0) + 1);
+        }
+    }
+    const batches = [];
+    let queue = apps.filter((a) => (inDegree.get(a.name) ?? 0) === 0);
+    let remaining = apps.length;
+    while (queue.length > 0) {
+        batches.push(queue);
+        remaining -= queue.length;
+        const next = [];
+        for (const app of queue) {
+            for (const dependent of adj.get(app.name) ?? []) {
+                const deg = (inDegree.get(dependent) ?? 1) - 1;
+                inDegree.set(dependent, deg);
+                if (deg === 0) {
+                    next.push(byName.get(dependent));
+                }
+            }
+        }
+        queue = next;
+    }
+    if (remaining > 0) {
+        const cycled = apps.filter((a) => (inDegree.get(a.name) ?? 0) > 0).map((a) => a.name);
+        throw new Error(`Circular dependency detected among: ${cycled.join(', ')}`);
+    }
+    return batches;
+}
+/**
+ * Returns reverse dependency order for shutdown.
+ */
+export function resolveShutdownOrder(apps) {
+    return resolveStartupOrder(apps).reverse();
+}
+//# sourceMappingURL=dependency-resolver.js.map

package/dist/orchestrator/dependency-resolver.js.map

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

package/dist/orchestrator/file-watcher.d.ts

@@ -0,0 +1,53 @@
+/**
+ * FileWatcher — Watches app source directories for file changes
+ *
+ * Uses Node.js native `fs.watch({ recursive: true })` (stable since Node 20+).
+ * On file change → debounce → orchestrator.restartApp() which handles
+ * any topology: single-process, multi-process (server + worker pools), classic fork.
+ *
+ * Design:
+ *   - One recursive watcher per app directory
+ *   - Debounce: 300ms per app (accumulates changes, then triggers single restart)
+ *   - Ignore: node_modules, dist, .git, build, coverage, test fixtures
+ *   - Restart-aware: won't trigger new restart while one is in progress
+ *   - Topology-transparent: orchestrator.restartApp() handles full topology teardown/startup
+ */
+import type { ILogger } from '@omnitron-dev/titan/module/logger';
+import type { IEcosystemConfig, IEcosystemAppEntry } from '../config/types.js';
+import type { OrchestratorService } from './orchestrator.service.js';
+export declare class FileWatcher {
+    private readonly logger;
+    private readonly orchestrator;
+    private readonly config;
+    private readonly cwd;
+    private readonly debounceMs;
+    private readonly apps;
+    private running;
+    constructor(logger: ILogger, orchestrator: OrchestratorService, config: IEcosystemConfig, cwd: string, debounceMs?: number);
+    /**
+     * Start watching all (or specific) apps.
+     * @param appNames - If provided, only watch these apps. Otherwise watch all.
+     */
+    start(appNames?: string[]): void;
+    stop(): void;
+    /** Dynamically add watch for a new app */
+    addApp(entry: IEcosystemAppEntry): void;
+    /** Dynamically remove watch for an app */
+    removeApp(name: string): void;
+    /** Get list of watched apps and their directories */
+    getWatchedApps(): Array<{
+        name: string;
+        directory: string;
+    }>;
+    private watchApp;
+    private resolveWatchConfig;
+    private onFileChange;
+    private triggerRestart;
+    private shouldIgnore;
+    /**
+     * Resolve the app's root directory from its bootstrap/script entry path.
+     * Walks up from the entry file until a package.json is found.
+     */
+    private resolveAppRoot;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/orchestrator/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/orchestrator/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAgB,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AA0CrE,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,OAAO,CAAS;gBAGL,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAY;IAG3C;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAahC,IAAI,IAAI,IAAI;IAgBZ,0CAA0C;IAC1C,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAMvC,0CAA0C;IAC1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU7B,qDAAqD;IACrD,cAAc,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAO5D,OAAO,CAAC,QAAQ;IA+DhB,OAAO,CAAC,kBAAkB;IA8C1B,OAAO,CAAC,YAAY;YAiBN,cAAc;IA2D5B,OAAO,CAAC,YAAY;IAgBpB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAiBvB"}

package/dist/orchestrator/file-watcher.js

@@ -0,0 +1,307 @@
+/**
+ * FileWatcher — Watches app source directories for file changes
+ *
+ * Uses Node.js native `fs.watch({ recursive: true })` (stable since Node 20+).
+ * On file change → debounce → orchestrator.restartApp() which handles
+ * any topology: single-process, multi-process (server + worker pools), classic fork.
+ *
+ * Design:
+ *   - One recursive watcher per app directory
+ *   - Debounce: 300ms per app (accumulates changes, then triggers single restart)
+ *   - Ignore: node_modules, dist, .git, build, coverage, test fixtures
+ *   - Restart-aware: won't trigger new restart while one is in progress
+ *   - Topology-transparent: orchestrator.restartApp() handles full topology teardown/startup
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/** Directories/patterns to always ignore */
+const IGNORE_PATTERNS = [
+    'node_modules',
+    'dist',
+    '.git',
+    'build',
+    'coverage',
+    '.turbo',
+    '.next',
+    '.cache',
+    '__pycache__',
+    '.omnitron-build',
+];
+/** File extensions to watch */
+const WATCH_EXTENSIONS = new Set([
+    '.ts',
+    '.js',
+    '.mjs',
+    '.cjs',
+    '.json',
+    '.yaml',
+    '.yml',
+    '.env',
+    '.graphql',
+    '.gql',
+    '.sql',
+]);
+export class FileWatcher {
+    logger;
+    orchestrator;
+    config;
+    cwd;
+    debounceMs;
+    apps = new Map();
+    running = false;
+    constructor(logger, orchestrator, config, cwd, debounceMs = 300) {
+        this.logger = logger;
+        this.orchestrator = orchestrator;
+        this.config = config;
+        this.cwd = cwd;
+        this.debounceMs = debounceMs;
+    }
+    /**
+     * Start watching all (or specific) apps.
+     * @param appNames - If provided, only watch these apps. Otherwise watch all.
+     */
+    start(appNames) {
+        if (this.running)
+            return;
+        this.running = true;
+        const entries = appNames
+            ? this.config.apps.filter((a) => appNames.includes(a.name))
+            : this.config.apps.filter((a) => a.enabled !== false);
+        for (const entry of entries) {
+            this.watchApp(entry);
+        }
+    }
+    stop() {
+        this.running = false;
+        for (const [, app] of this.apps) {
+            for (const w of app.watchers)
+                w.close();
+            app.watchers = [];
+            if (app.debounceTimer) {
+                clearTimeout(app.debounceTimer);
+                app.debounceTimer = null;
+            }
+        }
+        this.apps.clear();
+        this.logger.info('File watcher stopped');
+    }
+    /** Dynamically add watch for a new app */
+    addApp(entry) {
+        if (!this.running)
+            return;
+        if (this.apps.has(entry.name))
+            return;
+        this.watchApp(entry);
+    }
+    /** Dynamically remove watch for an app */
+    removeApp(name) {
+        const app = this.apps.get(name);
+        if (!app)
+            return;
+        for (const w of app.watchers)
+            w.close();
+        if (app.debounceTimer)
+            clearTimeout(app.debounceTimer);
+        this.apps.delete(name);
+        this.logger.debug({ app: name }, 'Stopped watching app');
+    }
+    /** Get list of watched apps and their directories */
+    getWatchedApps() {
+        return Array.from(this.apps.values()).map((a) => ({
+            name: a.entry.name,
+            directory: a.watchDir,
+        }));
+    }
+    watchApp(entry) {
+        // If explicitly disabled
+        if (entry.watch === false) {
+            this.logger.debug({ app: entry.name }, 'File watching disabled for this app');
+            return;
+        }
+        // Resolve watch directories from config
+        const { dirs, extraIgnore, debounce } = this.resolveWatchConfig(entry);
+        if (dirs.length === 0) {
+            this.logger.warn({ app: entry.name }, 'No watch directory resolved — skipping watch');
+            return;
+        }
+        const watched = {
+            entry,
+            watchDir: dirs[0], // primary directory for display
+            watchers: [],
+            debounceTimer: null,
+            pendingFiles: new Set(),
+            restarting: false,
+            extraIgnore,
+            debounceMs: debounce,
+        };
+        try {
+            for (const dir of dirs) {
+                if (!fs.existsSync(dir)) {
+                    this.logger.warn({ app: entry.name, directory: dir }, 'Watch directory does not exist — skipping');
+                    continue;
+                }
+                const w = fs.watch(dir, { recursive: true }, (eventType, filename) => {
+                    if (!filename)
+                        return;
+                    this.onFileChange(watched, filename, eventType);
+                });
+                w.on('error', (err) => {
+                    this.logger.warn({ app: entry.name, error: err.message }, 'File watcher error');
+                });
+                watched.watchers.push(w);
+            }
+            if (watched.watchers.length === 0) {
+                this.logger.warn({ app: entry.name }, 'No valid watch directories — skipping');
+                return;
+            }
+            this.apps.set(entry.name, watched);
+            const allDirs = dirs.filter((d) => fs.existsSync(d));
+            if (allDirs.length === 1) {
+                this.logger.info({ app: entry.name, directory: allDirs[0] }, 'Watching for file changes');
+            }
+            else {
+                this.logger.info({ app: entry.name, directories: allDirs }, 'Watching for file changes');
+            }
+        }
+        catch (err) {
+            this.logger.error({ app: entry.name, error: err.message }, 'Failed to start file watcher');
+        }
+    }
+    resolveWatchConfig(entry) {
+        const watchValue = entry.watch;
+        // Explicit string — single directory
+        if (typeof watchValue === 'string') {
+            return {
+                dirs: [path.resolve(this.cwd, watchValue)],
+                extraIgnore: [],
+                debounce: this.debounceMs,
+            };
+        }
+        // Full IWatchConfig
+        if (watchValue && typeof watchValue === 'object') {
+            const cfg = watchValue;
+            const dirs = [path.resolve(this.cwd, cfg.directory)];
+            if (cfg.include) {
+                for (const inc of cfg.include) {
+                    dirs.push(path.resolve(this.cwd, inc));
+                }
+            }
+            return {
+                dirs,
+                extraIgnore: cfg.ignore ?? [],
+                debounce: cfg.debounce ?? this.debounceMs,
+            };
+        }
+        // Auto-detect from bootstrap/script path
+        const entryFile = entry.bootstrap ?? entry.script;
+        if (!entryFile) {
+            return { dirs: [], extraIgnore: [], debounce: this.debounceMs };
+        }
+        const resolved = this.resolveAppRoot(entryFile);
+        return {
+            dirs: resolved ? [resolved] : [],
+            extraIgnore: [],
+            debounce: this.debounceMs,
+        };
+    }
+    onFileChange(app, filename, _eventType) {
+        // Ignore irrelevant files
+        if (this.shouldIgnore(filename, app.extraIgnore))
+            return;
+        app.pendingFiles.add(filename);
+        // Debounce: wait for rapid changes to settle
+        if (app.debounceTimer) {
+            clearTimeout(app.debounceTimer);
+        }
+        app.debounceTimer = setTimeout(() => {
+            app.debounceTimer = null;
+            this.triggerRestart(app);
+        }, app.debounceMs);
+    }
+    async triggerRestart(app) {
+        // Don't stack restarts
+        if (app.restarting) {
+            // Queue another restart after current finishes
+            app.pendingFiles.clear();
+            return;
+        }
+        const changedFiles = [...app.pendingFiles];
+        app.pendingFiles.clear();
+        app.restarting = true;
+        const filesDisplay = changedFiles.length <= 3
+            ? changedFiles.join(', ')
+            : `${changedFiles.slice(0, 3).join(', ')} +${changedFiles.length - 3} more`;
+        this.logger.info({ app: app.entry.name, files: filesDisplay, count: changedFiles.length }, 'File change detected — restarting');
+        // Clear bootstrap loader cache so daemon re-reads fresh topology
+        try {
+            const { clearCompileCache } = await import('./ts-compiler.js');
+            clearCompileCache();
+        }
+        catch {
+            // ts-compiler not available — non-critical
+        }
+        // Note: esbuild rebuilds are handled by BuildService watch mode
+        // or by orchestrator.restartApp() which clears buildResults and rebuilds
+        // Skip restart if the app hasn't been started yet (initial boot in progress)
+        const appStatus = this.orchestrator.getAppStatus?.(app.entry.name);
+        if (appStatus === 'stopped' || appStatus === 'starting') {
+            this.logger.debug({ app: app.entry.name }, 'Skipping restart — app still starting');
+            return;
+        }
+        this.logger.info({ app: app.entry.name, files: filesDisplay }, 'File change detected — restarting');
+        // Resolve actual app handle name — in stack mode it's namespaced (e.g., 'omni/dev/main')
+        const appName = this.orchestrator.resolveAppName?.(app.entry.name) ?? app.entry.name;
+        try {
+            await this.orchestrator.restartApp(appName);
+            this.logger.info({ app: appName }, 'Restart complete');
+        }
+        catch (err) {
+            this.logger.error({ app: appName, error: err.message }, 'Restart failed');
+        }
+        finally {
+            app.restarting = false;
+            // If more changes accumulated during restart, trigger again
+            if (app.pendingFiles.size > 0) {
+                this.triggerRestart(app);
+            }
+        }
+    }
+    shouldIgnore(filename, extraIgnore = []) {
+        // Ignore directories/files matching ignore patterns
+        const parts = filename.split(path.sep);
+        for (const part of parts) {
+            if (IGNORE_PATTERNS.includes(part))
+                return true;
+            if (extraIgnore.includes(part))
+                return true;
+            if (part.startsWith('.') && part !== '.env')
+                return true;
+        }
+        // Only watch known extensions (files without extension are ignored too)
+        const ext = path.extname(filename).toLowerCase();
+        if (!WATCH_EXTENSIONS.has(ext))
+            return true;
+        return false;
+    }
+    /**
+     * Resolve the app's root directory from its bootstrap/script entry path.
+     * Walks up from the entry file until a package.json is found.
+     */
+    resolveAppRoot(entryPath) {
+        const absPath = path.resolve(this.cwd, entryPath);
+        let dir = path.dirname(absPath);
+        const root = path.parse(dir).root;
+        while (dir !== root) {
+            if (fs.existsSync(path.join(dir, 'package.json'))) {
+                return dir;
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+        // Fallback: use the entry file's directory
+        return path.dirname(absPath);
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/orchestrator/file-watcher.js.map

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

package/dist/orchestrator/module-worker-process.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Module Worker Process — @Process-compatible class for PM worker-runtime
+ *
+ * Generic entry point for module-based worker topology entries.
+ * Worker-runtime creates an instance, calls init(bootstrapPath, processName),
+ * and this class:
+ *   1. Loads the app definition from the bootstrap file (same as bootstrap-process)
+ *   2. Finds the matching topology entry by processName
+ *   3. Creates a Titan Application with the entry's module
+ *   4. Finds the @Service-decorated provider in the module
+ *   5. Dynamically exposes all service methods via Netron RPC
+ *
+ * This replaces the need for each worker to have its own @Process-decorated
+ * entry point file. All DI, config, Redis, DB connections are handled by
+ * the module's imports (ConfigModule, DatabaseModule, etc.).
+ */
+import 'reflect-metadata';
+declare class ModuleWorkerProcess {
+    private app;
+    private service;
+    /**
+     * Initialize by loading the bootstrap config and creating a Titan Application
+     * with the topology entry's module.
+     *
+     * Called by worker-runtime with dependencies from spawnOptions:
+     *   init(deps)
+     *
+     * @param deps - Structured dependencies from orchestrator
+     */
+    init(deps: {
+        bootstrapPath: string;
+        processName: string;
+    }): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export default ModuleWorkerProcess;
+//# sourceMappingURL=module-worker-process.d.ts.map

package/dist/orchestrator/module-worker-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-worker-process.d.ts","sourceRoot":"","sources":["../../src/orchestrator/module-worker-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,kBAAkB,CAAC;AAmE1B,cACM,mBAAmB;IACvB,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,OAAO,CAAa;IAE5B;;;;;;;;OAQG;IACG,IAAI,CAAC,IAAI,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEzE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAchC;AAED,eAAe,mBAAmB,CAAC"}