@masuidrive/procman 0.1.0

package/dist/src/process-manager/process-lifecycle-manager.js

@@ -0,0 +1,372 @@
+/**
+ * ProcessLifecycleManager - Handles process lifecycle operations
+ *
+ * This class is responsible for:
+ * - Starting and stopping processes
+ * - Signal handling and graceful shutdown
+ * - Child process management
+ * - Process state transitions
+ * - Mutex-based concurrency control
+ */
+import { EventEmitter } from 'events';
+import { spawn } from 'child_process';
+import { GRACEFUL_SHUTDOWN_TIMEOUT, FORCE_KILL_TIMEOUT, GRACEFUL_SHUTDOWN_SIGNAL, FORCE_KILL_SIGNAL, } from '../shared/constants.js';
+import { KeyedMutex, withKeyedLock } from './utils/mutex.js';
+/**
+ * ProcessLifecycleManager implementation
+ */
+export class ProcessLifecycleManagerImpl extends EventEmitter {
+    processes;
+    childProcesses;
+    operationMutex;
+    constructor(processes, childProcesses) {
+        super();
+        this.processes = processes;
+        this.childProcesses = childProcesses;
+        this.operationMutex = new KeyedMutex();
+    }
+    /**
+     * Start a process with the given configuration
+     */
+    async startProcess(name) {
+        return withKeyedLock(this.operationMutex, name, async () => {
+            return this.startProcessInternal(name);
+        });
+    }
+    /**
+     * Internal start process implementation (no mutex)
+     */
+    async startProcessInternal(name) {
+        const managedProcess = this.processes.get(name);
+        if (!managedProcess) {
+            return {
+                success: false,
+                error: `Process '${name}' not found. Use initializeProcess() first.`,
+            };
+        }
+        const config = managedProcess.getConfig();
+        const currentStatus = managedProcess.getStatus();
+        // Check if process is already running or starting
+        if (currentStatus === 'online' || currentStatus === 'starting') {
+            return {
+                success: false,
+                error: `Process '${name}' is already ${currentStatus}`,
+            };
+        }
+        return new Promise((resolve) => {
+            try {
+                // Set status to starting
+                managedProcess.setStatus('starting');
+                // Determine the command and arguments
+                let command;
+                let commandArgs;
+                // If script ends with .js, .mjs, or .cjs, run it with node
+                if (config.script.match(/\.(js|mjs|cjs)$/i)) {
+                    command = process.execPath; // Use the same node binary that's running this process
+                    commandArgs = [config.script, ...config.args];
+                }
+                else {
+                    command = config.script;
+                    commandArgs = config.args;
+                }
+                // Spawn the child process
+                const childProcess = spawn(command, commandArgs, {
+                    cwd: config.cwd,
+                    env: config.env,
+                    detached: false,
+                    stdio: ['ignore', 'pipe', 'pipe'], // stdin ignored, stdout/stderr captured
+                });
+                // Store the child process reference
+                this.childProcesses.set(name, childProcess);
+                // Handle spawn errors
+                childProcess.on('error', (error) => {
+                    managedProcess.setStatus('errored');
+                    managedProcess.emitError(error);
+                    this.childProcesses.delete(name);
+                    this.emit('process:error', name, error);
+                    resolve({
+                        success: false,
+                        error: error.message,
+                    });
+                });
+                // Handle successful spawn
+                childProcess.on('spawn', () => {
+                    // Set up remaining event handlers
+                    this.setupChildProcessEventHandlers(name, childProcess, managedProcess);
+                    // Handle process startup
+                    const pid = childProcess.pid;
+                    if (!pid) {
+                        const error = new Error(`Failed to get PID for process '${name}'`);
+                        managedProcess.setStatus('errored');
+                        managedProcess.emitError(error);
+                        this.childProcesses.delete(name);
+                        this.emit('process:error', name, error);
+                        resolve({
+                            success: false,
+                            error: error.message,
+                        });
+                        return;
+                    }
+                    // Set process info
+                    managedProcess.emitStart(pid);
+                    managedProcess.setStatus('online');
+                    this.emit('process:started', name, pid);
+                    resolve({
+                        success: true,
+                        pid,
+                    });
+                });
+            }
+            catch (error) {
+                // Handle synchronous startup error
+                managedProcess.setStatus('errored');
+                const errorInstance = error instanceof Error ? error : new Error(String(error));
+                managedProcess.emitError(errorInstance);
+                this.childProcesses.delete(name);
+                this.emit('process:error', name, errorInstance);
+                resolve({
+                    success: false,
+                    error: errorInstance.message,
+                });
+            }
+        });
+    }
+    /**
+     * Stop a running process gracefully
+     */
+    async stopProcess(name) {
+        return withKeyedLock(this.operationMutex, name, async () => {
+            return this.stopProcessInternal(name);
+        });
+    }
+    /**
+     * Internal stop process implementation (no mutex)
+     */
+    async stopProcessInternal(name) {
+        const managedProcess = this.processes.get(name);
+        if (!managedProcess) {
+            return {
+                success: false,
+                error: `Process '${name}' not found`,
+            };
+        }
+        const currentStatus = managedProcess.getStatus();
+        if (currentStatus === 'stopped' || currentStatus === 'errored') {
+            return {
+                success: true,
+                metadata: { wasAlreadyStopped: true },
+            };
+        }
+        const childProcess = this.childProcesses.get(name);
+        if (!childProcess) {
+            managedProcess.setStatus('stopped');
+            return {
+                success: true,
+                metadata: { wasAlreadyStopped: true },
+            };
+        }
+        return new Promise((resolve) => {
+            let resolved = false;
+            let forceKillTimeout = null;
+            // Handle process exit
+            const handleExit = (code, signal) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                if (forceKillTimeout) {
+                    clearTimeout(forceKillTimeout);
+                }
+                managedProcess.setStatus('stopped');
+                managedProcess.emitStop(code);
+                this.childProcesses.delete(name);
+                this.emit('process:stopped', name, code, signal);
+                resolve({
+                    success: true,
+                    metadata: { exitCode: code, signal },
+                });
+            };
+            // Set status to stopping
+            managedProcess.setStatus('stopping');
+            // Remove existing exit handler and add our own
+            childProcess.removeAllListeners('exit');
+            childProcess.once('exit', handleExit);
+            // Try graceful shutdown first
+            const killed = childProcess.kill(GRACEFUL_SHUTDOWN_SIGNAL);
+            if (!killed) {
+                // Process already died
+                handleExit(null, null);
+                return;
+            }
+            // Set timeout for force kill
+            forceKillTimeout = setTimeout(() => {
+                if (!resolved) {
+                    console.warn(`Process '${name}' did not exit gracefully, sending SIGKILL`);
+                    childProcess.kill(FORCE_KILL_SIGNAL);
+                    // Set another timeout in case SIGKILL doesn't work
+                    setTimeout(() => {
+                        if (!resolved) {
+                            resolved = true;
+                            console.error(`Failed to kill process '${name}'`);
+                            managedProcess.setStatus('errored');
+                            this.emit('process:error', name, new Error('Failed to kill process'));
+                            resolve({
+                                success: false,
+                                error: 'Failed to kill process after timeout',
+                            });
+                        }
+                    }, FORCE_KILL_TIMEOUT);
+                }
+            }, GRACEFUL_SHUTDOWN_TIMEOUT);
+        });
+    }
+    /**
+     * Restart a process (stop then start)
+     */
+    async restartProcess(name) {
+        // We acquire the lock for the entire restart operation
+        return withKeyedLock(this.operationMutex, name, async () => {
+            // Call the internal methods that don't acquire locks again
+            const stopResult = await this.stopProcessInternal(name);
+            if (!stopResult.success) {
+                return stopResult;
+            }
+            // Wait a bit before starting again
+            await new Promise((resolve) => setTimeout(resolve, 100));
+            const startResult = await this.startProcessInternal(name);
+            if (startResult.success) {
+                const managedProcess = this.processes.get(name);
+                if (managedProcess) {
+                    managedProcess.recordRestart();
+                    this.emit('process:restart', name);
+                    this.emit('process:restarted', name);
+                }
+            }
+            return startResult;
+        });
+    }
+    /**
+     * Send a signal to a process
+     */
+    async sendSignalToProcess(name, signal) {
+        return withKeyedLock(this.operationMutex, name, async () => {
+            const managedProcess = this.processes.get(name);
+            if (!managedProcess) {
+                return {
+                    success: false,
+                    error: `Process '${name}' not found`,
+                };
+            }
+            const childProcess = this.childProcesses.get(name);
+            if (!childProcess) {
+                return {
+                    success: false,
+                    error: `Process '${name}' is not running`,
+                };
+            }
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const killed = childProcess.kill(signal);
+                if (!killed) {
+                    return {
+                        success: false,
+                        error: `Failed to send signal ${signal} to process '${name}'`,
+                    };
+                }
+                this.emit('process:signal-sent', name, signal);
+                return {
+                    success: true,
+                    metadata: { signal },
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    success: false,
+                    error: `Error sending signal: ${errorMessage}`,
+                };
+            }
+        });
+    }
+    /**
+     * Get the child process instance
+     */
+    getChildProcess(name) {
+        return this.childProcesses.get(name);
+    }
+    /**
+     * Check if a process is running
+     */
+    isProcessRunning(name) {
+        const managedProcess = this.processes.get(name);
+        if (!managedProcess) {
+            return false;
+        }
+        const status = managedProcess.getStatus();
+        return status === 'online' || status === 'starting';
+    }
+    /**
+     * Check if any operations are currently locked
+     */
+    getLockedProcesses() {
+        return this.operationMutex.getLockedKeys();
+    }
+    /**
+     * Clean up resources
+     */
+    async cleanup() {
+        // Stop all running processes
+        const runningProcesses = Array.from(this.processes.entries())
+            .filter(([, process]) => {
+            const status = process.getStatus();
+            return status === 'online' || status === 'starting';
+        })
+            .map(([name]) => name);
+        await Promise.all(runningProcesses.map((name) => this.stopProcess(name)));
+        // Clear all references
+        this.childProcesses.clear();
+        this.removeAllListeners();
+    }
+    /**
+     * Set up event handlers for child process
+     */
+    setupChildProcessEventHandlers(name, childProcess, managedProcess) {
+        // Handle process exit
+        childProcess.on('exit', (code, signal) => {
+            const wasUnexpected = managedProcess.isUnexpectedExit(code, signal);
+            if (wasUnexpected) {
+                managedProcess.setStatus('errored', true, 'Unexpected exit');
+                managedProcess.recordRestartFailure();
+            }
+            else {
+                managedProcess.setStatus('stopped', true, 'Normal exit');
+                managedProcess.recordRestartSuccess();
+            }
+            managedProcess.emitStop(code);
+            this.childProcesses.delete(name);
+            this.emit('process:exit', name, code, signal, wasUnexpected);
+            // Check if auto-restart should happen
+            if (wasUnexpected && managedProcess.shouldRestart()) {
+                const delay = managedProcess.getNextRestartDelay();
+                console.log(`Process '${name}' will be restarted after ${delay}ms delay`);
+                setTimeout(() => {
+                    this.startProcess(name).catch((error) => {
+                        console.error(`Failed to auto-restart process '${name}':`, error);
+                    });
+                }, delay);
+            }
+        });
+        // Handle stdout
+        if (childProcess.stdout) {
+            childProcess.stdout.on('data', (data) => {
+                this.emit('process:stdout', name, data.toString());
+            });
+        }
+        // Handle stderr
+        if (childProcess.stderr) {
+            childProcess.stderr.on('data', (data) => {
+                this.emit('process:stderr', name, data.toString());
+            });
+        }
+    }
+}
+//# sourceMappingURL=process-lifecycle-manager.js.map

package/dist/src/process-manager/process-lifecycle-manager.js.map

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

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

@@ -0,0 +1,296 @@
+/**
+ * ProcessManager - Main process management facade
+ *
+ * This class provides a unified interface for process management,
+ * delegating operations to specialized components while maintaining
+ * backward compatibility with the existing API.
+ *
+ * ARCHITECTURE:
+ * - Uses composition pattern with specialized components
+ * - Maintains existing public interface for backward compatibility
+ * - Delegates operations to appropriate components
+ * - Acts as a facade for the underlying system
+ */
+import { EventEmitter } from 'events';
+import { ManagedProcessInfo } from './managed-process-info.js';
+import { ProcessLifecycleManager, ProcessMonitor, ProcessPersistence, ProcessGroupManager, MainProcessManager } from './interfaces';
+import { AppConfig } from '../shared/config.js';
+import { ProcessInfo, ProcessStatus } from '../shared/process.js';
+import { ProcessDependency } from './interfaces/process-group.js';
+/**
+ * Process configuration interface
+ */
+export interface ProcessConfig {
+    /** Process name */
+    name: string;
+    /** Script path to execute */
+    script: string;
+    /** Namespace for grouping */
+    namespace: string;
+    /** Command line arguments */
+    args: string[];
+    /** Working directory */
+    cwd: string;
+    /** Environment variables */
+    env: Record<string, string>;
+    /** Number of instances to start */
+    instances: number;
+    /** Enable automatic restart */
+    autorestart: boolean;
+    /** Enable file watching */
+    watch: boolean;
+    /** Memory limit in bytes for auto-restart */
+    max_memory_restart?: number;
+    /** Maximum number of restarts */
+    max_restarts: number;
+    /** Minimum uptime before considering restart */
+    min_uptime: number;
+    /** Delay between restarts */
+    restart_delay: number;
+    /** Optional note or description */
+    note?: string;
+}
+/**
+ * Type definition for batch operation results
+ */
+/**
+ * ProcessManager - Main facade class for process management
+ *
+ * This class coordinates all process management operations by delegating
+ * to specialized components while maintaining the existing public API.
+ */
+export declare class ProcessManager extends EventEmitter implements MainProcessManager {
+    private healthCheckInterval;
+    private memoryCheckInterval;
+    readonly lifecycle: ProcessLifecycleManager;
+    readonly monitor: ProcessMonitor;
+    readonly persistence: ProcessPersistence;
+    readonly groups: ProcessGroupManager;
+    private readonly processes;
+    private readonly processConfigs;
+    private readonly childProcesses;
+    private isInitialized;
+    constructor(healthCheckInterval?: number, memoryCheckInterval?: number, persistenceFilePath?: string);
+    /**
+     * Set up event forwarding from components to maintain compatibility
+     */
+    private setupEventForwarding;
+    /**
+     * Set up internal event handlers for process management
+     */
+    private setupInternalEventHandlers;
+    /**
+     * Static factory method to create ProcessManager with default components
+     */
+    static create(healthCheckInterval?: number, memoryCheckInterval?: number, persistenceFilePath?: string): ProcessManager;
+    /**
+     * Configure a process from app configuration
+     */
+    configureProcess(appConfig: AppConfig): void;
+    /**
+     * Remove process configuration
+     */
+    removeProcessConfig(name: string): void;
+    /**
+     * Get process configuration
+     */
+    getProcessConfig(name: string): ProcessConfig | undefined;
+    /**
+     * Get process information
+     */
+    getProcessInfo(name: string): ProcessInfo | undefined;
+    /**
+     * Get all process information
+     */
+    getAllProcessInfo(): ProcessInfo[];
+    /**
+     * Get processes by namespace
+     */
+    getProcessesByNamespace(namespace: string): ProcessInfo[];
+    /**
+     * Get process names by namespace
+     */
+    getProcessNamesByNamespace(namespace: string): string[];
+    /**
+     * Get all namespaces
+     */
+    getNamespaces(): string[];
+    /**
+     * Get namespace status
+     */
+    getNamespaceStatus(namespace: string): {
+        total: number;
+        online: number;
+        stopped: number;
+        errored: number;
+        starting: number;
+        stopping: number;
+    };
+    /**
+     * Get all process names
+     */
+    getProcessNames(): string[];
+    /**
+     * Check if process exists
+     */
+    hasProcess(name: string): boolean;
+    /**
+     * Initialize a process (create ManagedProcessInfo)
+     */
+    initializeProcess(name: string): boolean;
+    /**
+     * Remove a process
+     */
+    removeProcess(name: string): boolean;
+    /**
+     * Start a process
+     */
+    startProcess(name: string): Promise<void>;
+    /**
+     * Stop a process
+     */
+    stopProcess(name: string): Promise<void>;
+    /**
+     * Restart a process
+     */
+    restartProcess(name: string): Promise<void>;
+    /**
+     * Start multiple processes
+     */
+    startProcesses(names: string[]): Promise<{
+        name: string;
+        success: boolean;
+        error?: string;
+    }[]>;
+    /**
+     * Stop multiple processes
+     */
+    stopProcesses(names: string[]): Promise<{
+        name: string;
+        success: boolean;
+        error?: string;
+    }[]>;
+    /**
+     * Restart multiple processes
+     */
+    restartProcesses(names: string[]): Promise<{
+        name: string;
+        success: boolean;
+        error?: string;
+    }[]>;
+    /**
+     * Start all processes in a namespace
+     */
+    startNamespace(namespace: string): Promise<{
+        name: string;
+        success: boolean;
+        error?: string;
+    }[]>;
+    /**
+     * Stop all processes in a namespace
+     */
+    stopNamespace(namespace: string): Promise<{
+        name: string;
+        success: boolean;
+        error?: string;
+    }[]>;
+    /**
+     * Restart all processes in a namespace
+     */
+    restartNamespace(namespace: string): Promise<{
+        name: string;
+        success: boolean;
+        error?: string;
+    }[]>;
+    /**
+     * Start monitoring all processes
+     */
+    startMonitoring(): void;
+    /**
+     * Stop monitoring all processes
+     */
+    stopMonitoring(): void;
+    /**
+     * Enable auto-restart for a process
+     */
+    enableAutoRestart(name: string): void;
+    /**
+     * Disable auto-restart for a process
+     */
+    disableAutoRestart(name: string): void;
+    /**
+     * Reset restart failures for a process
+     */
+    resetRestartFailures(name: string): void;
+    /**
+     * Get auto-restart status for a process
+     */
+    getAutoRestartStatus(name: string): {
+        enabled: boolean;
+        consecutiveFailures: number;
+        lastFailureTime?: Date;
+        nextRestartDelay?: number;
+    };
+    /**
+     * Configure a process dependency
+     */
+    configureDependency(dependency: ProcessDependency): void;
+    /**
+     * Remove a process dependency
+     */
+    removeDependency(name: string): void;
+    /**
+     * Get process dependency
+     */
+    getDependency(name: string): ProcessDependency | undefined;
+    /**
+     * Get all dependencies
+     */
+    getAllDependencies(): ProcessDependency[];
+    /**
+     * Resolve dependencies for a set of processes
+     */
+    resolveDependencies(names: string[]): any;
+    /**
+     * Start processes with dependencies
+     */
+    startProcessesWithDependencies(processNames: string[]): Promise<{
+        name: string;
+        success: boolean;
+        error?: string;
+    }[]>;
+    /**
+     * Start dependency monitoring
+     */
+    startDependencyMonitoring(): void;
+    /**
+     * Stop dependency monitoring
+     */
+    stopDependencyMonitoring(): void;
+    /**
+     * Initialize the process manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Save current state
+     */
+    saveState(): Promise<void>;
+    /**
+     * Force save state immediately
+     */
+    forceSaveState(): Promise<void>;
+    /**
+     * Get persistence file path
+     */
+    getPersistenceFilePath(): string;
+    /**
+     * Clean up all resources
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Convert AppConfig to ProcessConfig
+     */
+    private convertAppConfigToProcessConfig;
+}
+export { ProcessInfo, ProcessStatus, AppConfig, ProcessDependency, ManagedProcessInfo, };
+//# sourceMappingURL=process-manager.d.ts.map