@archlast/server 0.0.1

package/dist/startup/cluster-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-manager.d.ts","sourceRoot":"","sources":["../../src/startup/cluster-manager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,WAAW;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,MAAM,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,UAAU,WAAW;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAyC;IACtE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAkC;IAC3D,OAAO,CAAC,MAAM,CAAC,cAAc,CAAkB;IAE/C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI;IAuEzE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM;IAiB3D,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B,MAAM,CAAC,QAAQ,IAAI,OAAO;IAI1B,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,SAAS;IAIxC,MAAM,CAAC,YAAY,IAAI,MAAM;IAI7B,MAAM,CAAC,cAAc;;;;;;;IAUrB;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,EAAE,CAAA;KAAE,GAAG,IAAI;CAyB/E"}

package/dist/startup/cluster-manager.js

@@ -0,0 +1,238 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClusterService = void 0;
+const node_cluster_1 = __importDefault(require("node:cluster"));
+const node_os_1 = require("node:os");
+const node_process_1 = __importDefault(require("node:process"));
+/**
+ * NestJS-style ClusterService with optional monitoring
+ * Provides a callback-based API for easy integration
+ */
+class ClusterService {
+    static metricsStorage = new Map();
+    static heartbeats = new Map();
+    static metricsEnabled = false;
+    /**
+     * Main entry point - clusterize your application
+     */
+    static clusterize(callback, options = {}) {
+        const { enabled = false, divider = 2, minWorkers = 2, maxWorkers = 8, autoRestart = true, enableMetrics = false, metricsInterval = 5000, heartbeatInterval = 3000, } = options;
+        ClusterService.metricsEnabled = enableMetrics;
+        // If clustering is disabled, just run the callback directly
+        if (!enabled) {
+            console.log("Clustering disabled, running in single process mode");
+            callback();
+            return;
+        }
+        const availableCpus = (0, node_os_1.cpus)().length;
+        let numWorkers = Math.max(Math.floor(availableCpus / divider), minWorkers);
+        if (maxWorkers !== undefined) {
+            numWorkers = Math.min(numWorkers, maxWorkers);
+        }
+        if (node_cluster_1.default.isPrimary) {
+            console.log(`Available CPUs: ${availableCpus}`);
+            console.log(`Starting ${numWorkers} worker processes`);
+            console.log(`MASTER SERVER (PID: ${node_process_1.default.pid}) IS RUNNING`);
+            // Set up metrics collection if enabled
+            if (enableMetrics) {
+                setupMetricsCollection();
+            }
+            for (let i = 0; i < numWorkers; i++) {
+                createWorker();
+            }
+            setupPrimaryProcessHandlers(autoRestart);
+        }
+        else {
+            setupWorkerProcessHandlers();
+            // Send metrics if enabled
+            if (enableMetrics) {
+                setInterval(() => {
+                    const cpuUsage = node_process_1.default.cpuUsage();
+                    const memUsage = node_process_1.default.memoryUsage();
+                    node_process_1.default.send({
+                        type: "metrics",
+                        data: {
+                            cpu: cpuUsage,
+                            memory: memUsage,
+                        },
+                    });
+                }, metricsInterval);
+                // Send heartbeat
+                setInterval(() => {
+                    node_process_1.default.send({ type: "heartbeat" });
+                }, heartbeatInterval);
+            }
+            callback();
+        }
+    }
+    /**
+     * Calculate worker count based on options
+     */
+    static getWorkerCount(options = {}) {
+        const { enabled = false, divider = 2, minWorkers = 2, maxWorkers = 8 } = options;
+        if (!enabled) {
+            return 1;
+        }
+        const availableCpus = (0, node_os_1.cpus)().length;
+        let numWorkers = Math.max(Math.floor(availableCpus / divider), minWorkers);
+        if (maxWorkers !== undefined) {
+            numWorkers = Math.min(numWorkers, maxWorkers);
+        }
+        return numWorkers;
+    }
+    static isPrimary() {
+        return node_cluster_1.default.isPrimary;
+    }
+    static isWorker() {
+        return node_cluster_1.default.isWorker;
+    }
+    static getWorkerId() {
+        return node_cluster_1.default.worker?.id;
+    }
+    static getWorkerPid() {
+        return node_process_1.default.pid;
+    }
+    static getClusterInfo() {
+        return {
+            isPrimary: ClusterService.isPrimary(),
+            isWorker: ClusterService.isWorker(),
+            workerId: ClusterService.getWorkerId(),
+            workerPid: ClusterService.getWorkerPid(),
+            availableCpus: (0, node_os_1.cpus)().length,
+        };
+    }
+    /**
+     * Get aggregated metrics (only available in primary process)
+     */
+    static getMetrics() {
+        if (!ClusterService.metricsEnabled || !node_cluster_1.default.isPrimary) {
+            return null;
+        }
+        const workers = [];
+        for (const [pid, metrics] of ClusterService.metricsStorage.entries()) {
+            const lastMetric = metrics[metrics.length - 1];
+            const lastHeartbeat = ClusterService.heartbeats.get(pid);
+            workers.push({
+                pid,
+                alive: ClusterService.heartbeats.has(pid),
+                lastHeartbeat: lastHeartbeat ? new Date(lastHeartbeat).toISOString() : null,
+                metricsCount: metrics.length,
+                lastMetric: lastMetric || null,
+            });
+        }
+        return {
+            totalWorkers: Object.keys(node_cluster_1.default.workers || {}).length,
+            workers,
+        };
+    }
+}
+exports.ClusterService = ClusterService;
+function createWorker() {
+    const worker = node_cluster_1.default.fork();
+    console.log(`Worker started (PID: ${worker.process.pid})`);
+    // Initialize metrics tracking if enabled
+    if (ClusterService["metricsEnabled"]) {
+        const pid = worker.process.pid;
+        ClusterService["metricsStorage"].set(pid, []);
+        ClusterService["heartbeats"].set(pid, Date.now());
+        // Listen for metrics/heartbeat messages
+        worker.on("message", (msg) => handleWorkerMessage(worker, msg));
+    }
+    return worker;
+}
+function handleWorkerMessage(worker, msg) {
+    if (!msg || typeof msg !== "object")
+        return;
+    const pid = worker.process.pid;
+    if (msg.type === "metrics") {
+        const metrics = ClusterService["metricsStorage"].get(pid) || [];
+        metrics.push({
+            timestamp: Date.now(),
+            ...msg.data,
+        });
+        // Keep only last 100 data points
+        if (metrics.length > 100) {
+            metrics.shift();
+        }
+        ClusterService["metricsStorage"].set(pid, metrics);
+    }
+    else if (msg.type === "heartbeat") {
+        ClusterService["heartbeats"].set(pid, Date.now());
+    }
+}
+function setupMetricsCollection() {
+    // Periodically log metrics if DEBUG_CLUSTER is set
+    setInterval(() => {
+        if (node_process_1.default.env.DEBUG_CLUSTER) {
+            const metrics = ClusterService.getMetrics();
+            console.log("[ClusterService] Metrics:", JSON.stringify(metrics, null, 2));
+        }
+    }, 10000);
+}
+function setupPrimaryProcessHandlers(autoRestart) {
+    node_cluster_1.default.on("exit", (worker, code, signal) => {
+        const exitType = signal ? `terminated by signal: ${signal}` : `exited with code: ${code}`;
+        console.log(`Worker ${worker.process.pid} ${exitType}`);
+        // Clean up metrics tracking
+        if (ClusterService["metricsEnabled"]) {
+            ClusterService["metricsStorage"].delete(worker.process.pid);
+            ClusterService["heartbeats"].delete(worker.process.pid);
+        }
+        if (autoRestart) {
+            console.log(`Restarting worker...`);
+            createWorker();
+        }
+    });
+    node_cluster_1.default.on("online", (worker) => {
+        console.log(`Worker ${worker.process.pid} is online`);
+    });
+    node_cluster_1.default.on("listening", (worker, address) => {
+        console.log(`Worker ${worker.process.pid} listening on ${address.address}:${address.port}`);
+    });
+    node_cluster_1.default.on("disconnect", (worker) => {
+        console.log(`Worker ${worker.process.pid} disconnected`);
+    });
+    const signals = ["SIGTERM", "SIGINT", "SIGUSR2"];
+    signals.forEach((signal) => {
+        node_process_1.default.on(signal, () => {
+            console.log(`Primary process received ${signal}, shutting down...`);
+            for (const id in node_cluster_1.default.workers) {
+                const worker = node_cluster_1.default.workers[id];
+                if (worker) {
+                    worker.disconnect();
+                    setTimeout(() => {
+                        if (!worker.isDead()) {
+                            worker.kill("SIGKILL");
+                        }
+                    }, 5000);
+                }
+            }
+            setTimeout(() => {
+                node_process_1.default.exit(0);
+            }, 6000);
+        });
+    });
+}
+function setupWorkerProcessHandlers() {
+    console.log(`Worker started (PID: ${node_process_1.default.pid})`);
+    node_process_1.default.on("uncaughtException", (err) => {
+        console.error(`Uncaught exception in worker ${node_process_1.default.pid}:`, err);
+        node_process_1.default.exit(1);
+    });
+    node_process_1.default.on("unhandledRejection", (reason, promise) => {
+        console.error(`Unhandled rejection in worker ${node_process_1.default.pid}:`, reason);
+        node_process_1.default.exit(1);
+    });
+    node_process_1.default.on("SIGTERM", () => {
+        console.log(`Worker ${node_process_1.default.pid} received SIGTERM, shutting down gracefully...`);
+        node_process_1.default.exit(0);
+    });
+    node_process_1.default.on("SIGINT", () => {
+        console.log(`Worker ${node_process_1.default.pid} received SIGINT, shutting down gracefully...`);
+        node_process_1.default.exit(0);
+    });
+}
+//# sourceMappingURL=cluster-manager.js.map

package/dist/startup/cluster-manager.js.map

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

package/dist/startup/process-manager.d.ts

@@ -0,0 +1,46 @@
+export declare class ProcessManager {
+    private childProcesses;
+    private isShuttingDown;
+    private shutdownHandlerRegistered;
+    /**
+     * Starts a background process with automatic restart capability
+     */
+    start(name: string, cmd: string[], env?: Record<string, string>): Promise<void>;
+    /**
+     * Spawns or respawns a managed process
+     */
+    private spawn;
+    /**
+     * Handles process exit events
+     */
+    private onExit;
+    /**
+     * Schedules a process restart with exponential backoff
+     */
+    private scheduleRestart;
+    /**
+     * Pipes process output to parent console with label
+     */
+    private pipeOutput;
+    /**
+     * Stops all managed processes gracefully
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Stops a single process with graceful shutdown and force kill fallback
+     */
+    private stopProcess;
+    /**
+     * Registers shutdown handlers for SIGINT and SIGTERM
+     */
+    private registerShutdownHandlers;
+    /**
+     * Gets the current status of all managed processes
+     */
+    getStatus(): Array<{
+        name: string;
+        pid: number | undefined;
+        restartCount: number;
+    }>;
+}
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/startup/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/startup/process-manager.ts"],"names":[],"mappings":"AAuBA,qBAAa,cAAc;IACvB,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,yBAAyB,CAAS;IAE1C;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrF;;OAEG;YACW,KAAK;IAiDnB;;OAEG;IACH,OAAO,CAAC,MAAM;IAuCd;;OAEG;IACH,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyBlB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B9B;;OAEG;YACW,WAAW;IAkDzB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;OAEG;IACH,SAAS,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAOtF"}

package/dist/startup/process-manager.js

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessManager = void 0;
+const logger_js_1 = require("../logging/logger.js");
+const MIN_RESTART_DELAY_MS = 1000; // 1 second
+const MAX_RESTART_DELAY_MS = 60000; // 1 minute
+const MAX_RESTART_COUNT = 10;
+const RESTART_WINDOW_MS = 60000; // 1 minute window
+class ProcessManager {
+    childProcesses = new Map();
+    isShuttingDown = false;
+    shutdownHandlerRegistered = false;
+    /**
+     * Starts a background process with automatic restart capability
+     */
+    async start(name, cmd, env) {
+        const config = { name, cmd, env };
+        const managedProcess = {
+            name,
+            config,
+            process: null,
+            restartCount: 0,
+            lastRestartTime: 0,
+            isShuttingDown: false,
+        };
+        this.childProcesses.set(name, managedProcess);
+        await this.spawn(managedProcess);
+        // Register shutdown handlers on first process start
+        if (!this.shutdownHandlerRegistered) {
+            this.registerShutdownHandlers();
+            this.shutdownHandlerRegistered = true;
+        }
+    }
+    /**
+     * Spawns or respawns a managed process
+     */
+    async spawn(managedProcess) {
+        const { name, config } = managedProcess;
+        try {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: `Starting process: ${name}`,
+            });
+            const proc = Bun.spawn({
+                cmd: config.cmd,
+                env: {
+                    ...process.env,
+                    ...config.env,
+                },
+                stdout: "pipe",
+                stderr: "pipe",
+                onExit: (proc, exitCode, signalCode) => {
+                    this.onExit(name, exitCode, signalCode);
+                },
+            });
+            managedProcess.process = proc;
+            // Pipe output to parent console
+            this.pipeOutput(proc, name);
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: `Process started: ${name} (PID: ${proc.pid})`,
+            });
+        }
+        catch (err) {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "system",
+                message: `Failed to spawn process: ${name}`,
+                context: { error: err instanceof Error ? err.message : String(err) },
+            });
+            // Schedule restart on spawn failure
+            this.scheduleRestart(managedProcess);
+        }
+    }
+    /**
+     * Handles process exit events
+     */
+    onExit(name, exitCode, signalCode) {
+        const managedProcess = this.childProcesses.get(name);
+        if (!managedProcess)
+            return;
+        // Don't restart if we're shutting down or process was intentionally stopped
+        if (this.isShuttingDown || managedProcess.isShuttingDown) {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: `Process exited during shutdown: ${name}`,
+                context: { exitCode, signalCode },
+            });
+            return;
+        }
+        // Log crash
+        if (exitCode !== 0 && exitCode !== null) {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "system",
+                message: `Process crashed: ${name}`,
+                context: { exitCode, signalCode },
+            });
+        }
+        else {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "warn",
+                kind: "system",
+                message: `Process exited unexpectedly: ${name}`,
+                context: { exitCode, signalCode },
+            });
+        }
+        // Schedule restart with backoff
+        this.scheduleRestart(managedProcess);
+    }
+    /**
+     * Schedules a process restart with exponential backoff
+     */
+    scheduleRestart(managedProcess) {
+        const now = Date.now();
+        // Reset restart count if outside the restart window
+        if (now - managedProcess.lastRestartTime > RESTART_WINDOW_MS) {
+            managedProcess.restartCount = 0;
+        }
+        managedProcess.restartCount++;
+        managedProcess.lastRestartTime = now;
+        // Check if we've exceeded max restart attempts
+        if (managedProcess.restartCount > MAX_RESTART_COUNT) {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "system",
+                message: `Process ${managedProcess.name} exceeded max restart attempts (${MAX_RESTART_COUNT}). Giving up.`,
+            });
+            return;
+        }
+        // Calculate backoff delay (exponential with cap)
+        const baseDelay = MIN_RESTART_DELAY_MS * Math.pow(2, managedProcess.restartCount - 1);
+        const delay = Math.min(baseDelay, MAX_RESTART_DELAY_MS);
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: `Scheduling restart for ${managedProcess.name} in ${delay}ms (attempt ${managedProcess.restartCount}/${MAX_RESTART_COUNT})`,
+        });
+        setTimeout(() => {
+            if (!this.isShuttingDown && !managedProcess.isShuttingDown) {
+                this.spawn(managedProcess);
+            }
+        }, delay);
+    }
+    /**
+     * Pipes process output to parent console with label
+     */
+    pipeOutput(proc, label) {
+        if (proc.stdout && typeof proc.stdout !== "number") {
+            proc.stdout
+                .pipeTo(new WritableStream({
+                write(chunk) {
+                    process.stdout.write(chunk);
+                },
+            }))
+                .catch(() => { });
+        }
+        if (proc.stderr && typeof proc.stderr !== "number") {
+            proc.stderr
+                .pipeTo(new WritableStream({
+                write(chunk) {
+                    process.stderr.write(chunk);
+                },
+            }))
+                .catch(() => { });
+        }
+    }
+    /**
+     * Stops all managed processes gracefully
+     */
+    async stopAll() {
+        this.isShuttingDown = true;
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: "Stopping all background processes...",
+        });
+        const stopPromises = [];
+        for (const [name, managedProcess] of this.childProcesses.entries()) {
+            managedProcess.isShuttingDown = true;
+            if (managedProcess.process && !managedProcess.process.killed) {
+                stopPromises.push(this.stopProcess(name, managedProcess));
+            }
+        }
+        await Promise.all(stopPromises);
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: "All background processes stopped",
+        });
+    }
+    /**
+     * Stops a single process with graceful shutdown and force kill fallback
+     */
+    async stopProcess(name, managedProcess) {
+        const proc = managedProcess.process;
+        if (!proc)
+            return;
+        try {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: `Sending SIGTERM to ${name} (PID: ${proc.pid})`,
+            });
+            // Send SIGTERM for graceful shutdown
+            proc.kill("SIGTERM");
+            // Wait up to 5 seconds for graceful shutdown
+            const timeout = new Promise((resolve) => setTimeout(resolve, 5000));
+            const exited = proc.exited;
+            await Promise.race([exited, timeout]);
+            // If still running, force kill
+            if (!proc.killed) {
+                logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "warn",
+                    kind: "system",
+                    message: `Process ${name} did not exit gracefully, sending SIGKILL`,
+                });
+                proc.kill("SIGKILL");
+                await proc.exited;
+            }
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: `Process ${name} stopped`,
+            });
+        }
+        catch (err) {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "system",
+                message: `Error stopping process ${name}`,
+                context: { error: err instanceof Error ? err.message : String(err) },
+            });
+        }
+    }
+    /**
+     * Registers shutdown handlers for SIGINT and SIGTERM
+     */
+    registerShutdownHandlers() {
+        const shutdown = async (signal) => {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: `Received ${signal}, shutting down...`,
+            });
+            await this.stopAll();
+            process.exit(0);
+        };
+        process.on("SIGINT", () => shutdown("SIGINT"));
+        process.on("SIGTERM", () => shutdown("SIGTERM"));
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: "Shutdown handlers registered (SIGINT, SIGTERM)",
+        });
+    }
+    /**
+     * Gets the current status of all managed processes
+     */
+    getStatus() {
+        return Array.from(this.childProcesses.values()).map((mp) => ({
+            name: mp.name,
+            pid: mp.process?.pid,
+            restartCount: mp.restartCount,
+        }));
+    }
+}
+exports.ProcessManager = ProcessManager;
+//# sourceMappingURL=process-manager.js.map

package/dist/startup/process-manager.js.map

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

package/dist/startup/processes.d.mts

@@ -0,0 +1,15 @@
+import { IpcClient } from "../ipc/socket-bridge.js";
+import { CacheClient } from "../cache/client.js";
+import type { loadServerConfig } from "../config/index.js";
+import { ProcessManager } from "./process-manager.js";
+export interface BackgroundProcessResult {
+    ipcClient: IpcClient | null;
+    cacheClient: CacheClient | null;
+    processManager: ProcessManager;
+}
+/**
+ * Spawns background processes (IPC sidecar, Cache sidecar, Worker, Scheduler)
+ * and establishes connections to the sidecar services.
+ */
+export declare function spawnBackgroundProcesses(config: ReturnType<typeof loadServerConfig>): Promise<BackgroundProcessResult>;
+//# sourceMappingURL=processes.d.mts.map

package/dist/startup/processes.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes.d.mts","sourceRoot":"","sources":["../../src/startup/processes.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAetD,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GAC5C,OAAO,CAAC,uBAAuB,CAAC,CAwClC"}