@masuidrive/procman 0.1.0

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

@@ -0,0 +1,97 @@
+/**
+ * Process Lifecycle Management Interface
+ *
+ * Handles the core lifecycle operations for processes:
+ * - Starting and stopping processes
+ * - Signal handling
+ * - Child process management
+ */
+import { ChildProcess } from 'child_process';
+/**
+ * Result of a process lifecycle operation
+ */
+export interface ProcessLifecycleResult {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Error message if operation failed */
+    error?: string;
+    /** Process ID if process was started */
+    pid?: number;
+    /** Additional metadata about the operation */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Interface for process lifecycle management
+ */
+export interface ProcessLifecycleManager {
+    /**
+     * Start a process with the given configuration
+     * @param name Process name
+     * @returns Promise resolving to the result
+     */
+    startProcess(name: string): Promise<ProcessLifecycleResult>;
+    /**
+     * Stop a running process gracefully
+     * @param name Process name
+     * @returns Promise resolving to the result
+     */
+    stopProcess(name: string): Promise<ProcessLifecycleResult>;
+    /**
+     * Restart a process (stop then start)
+     * @param name Process name
+     * @returns Promise resolving to the result
+     */
+    restartProcess(name: string): Promise<ProcessLifecycleResult>;
+    /**
+     * Send a signal to a process
+     * @param name Process name
+     * @param signal Signal to send
+     * @returns Promise resolving to the result
+     */
+    sendSignalToProcess(name: string, signal: string): Promise<ProcessLifecycleResult>;
+    /**
+     * Get the child process for a given process name
+     * @param name Process name
+     * @returns ChildProcess instance or undefined
+     */
+    getChildProcess(name: string): ChildProcess | undefined;
+    /**
+     * Check if a process is running
+     * @param name Process name
+     * @returns True if process is running
+     */
+    isProcessRunning(name: string): boolean;
+    /**
+     * Cleanup all managed processes and resources
+     * @returns Promise resolving when cleanup is complete
+     */
+    cleanup(): Promise<void>;
+}
+/**
+ * Event types emitted by ProcessLifecycleManager
+ */
+export interface ProcessLifecycleEvents {
+    /** Process started successfully */
+    'process:started': {
+        name: string;
+        pid: number;
+    };
+    /** Process stopped */
+    'process:stopped': {
+        name: string;
+        code: number | null;
+        signal: string | null;
+    };
+    /** Process exited unexpectedly */
+    'process:exit': {
+        name: string;
+        code: number | null;
+        signal: string | null;
+    };
+    /** Process startup failed */
+    'process:error': {
+        name: string;
+        error: Error;
+    };
+}
+//# sourceMappingURL=process-lifecycle.d.ts.map

package/dist/src/process-manager/interfaces/process-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/process-manager/interfaces/process-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE5D;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE3D;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAExD;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAExC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,iBAAiB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,sBAAsB;IACtB,iBAAiB,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,kCAAkC;IAClC,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC7E,6BAA6B;IAC7B,eAAe,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;CACjD"}

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

@@ -0,0 +1,10 @@
+/**
+ * Process Lifecycle Management Interface
+ *
+ * Handles the core lifecycle operations for processes:
+ * - Starting and stopping processes
+ * - Signal handling
+ * - Child process management
+ */
+export {};
+//# sourceMappingURL=process-lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process-lifecycle.js","sourceRoot":"","sources":["../../../../src/process-manager/interfaces/process-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

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

@@ -0,0 +1,118 @@
+/**
+ * Process Monitoring Interface
+ *
+ * Handles monitoring of process health and resource usage:
+ * - Memory and CPU monitoring
+ * - Process health checks
+ * - Performance statistics
+ */
+/**
+ * Process resource statistics
+ */
+export interface ProcessStats {
+    /** Memory usage in bytes */
+    memory: number;
+    /** CPU usage percentage */
+    cpu: number;
+    /** Timestamp when stats were collected */
+    timestamp: number;
+}
+/**
+ * Process health status
+ */
+export interface ProcessHealth {
+    /** Whether the process is alive */
+    isAlive: boolean;
+    /** Last health check timestamp */
+    lastCheck: number;
+    /** Number of consecutive failed health checks */
+    consecutiveFailures: number;
+}
+/**
+ * Monitoring configuration
+ */
+export interface MonitoringConfig {
+    /** Interval for health checks in milliseconds */
+    healthCheckInterval: number;
+    /** Interval for memory checks in milliseconds */
+    memoryCheckInterval: number;
+    /** Maximum number of health check failures before marking as unhealthy */
+    maxHealthCheckFailures: number;
+}
+/**
+ * Interface for process monitoring
+ */
+export interface ProcessMonitor {
+    /**
+     * Start monitoring all processes
+     * @param config Monitoring configuration
+     */
+    startMonitoring(config?: Partial<MonitoringConfig>): void;
+    /**
+     * Stop monitoring all processes
+     */
+    stopMonitoring(): void;
+    /**
+     * Start monitoring a specific process
+     * @param name Process name
+     */
+    startProcessMonitoring(name: string): void;
+    /**
+     * Stop monitoring a specific process
+     * @param name Process name
+     */
+    stopProcessMonitoring(name: string): void;
+    /**
+     * Get current resource statistics for a process
+     * @param name Process name
+     * @returns Current stats or undefined if not available
+     */
+    getProcessStats(name: string): Promise<ProcessStats | undefined>;
+    /**
+     * Get health status for a process
+     * @param name Process name
+     * @returns Health status or undefined if not monitored
+     */
+    getProcessHealth(name: string): ProcessHealth | undefined;
+    /**
+     * Check if a process is being monitored
+     * @param name Process name
+     * @returns True if process is being monitored
+     */
+    isProcessMonitored(name: string): boolean;
+    /**
+     * Check if monitoring is enabled globally
+     * @returns True if monitoring is enabled
+     */
+    isMonitoringEnabled(): boolean;
+    /**
+     * Cleanup monitoring resources
+     */
+    cleanup(): void;
+}
+/**
+ * Event types emitted by ProcessMonitor
+ */
+export interface ProcessMonitorEvents {
+    /** Process exceeded memory limit */
+    'process:memory-limit': {
+        name: string;
+        usage: number;
+        limit: number;
+    };
+    /** Process became unresponsive */
+    'process:unhealthy': {
+        name: string;
+        consecutiveFailures: number;
+    };
+    /** Process died unexpectedly */
+    'process:died': {
+        name: string;
+    };
+    /** Process resource statistics updated */
+    'process:stats': {
+        name: string;
+        stats: ProcessStats;
+    };
+}
+//# sourceMappingURL=process-monitor.d.ts.map

package/dist/src/process-manager/interfaces/process-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-monitor.d.ts","sourceRoot":"","sources":["../../../../src/process-manager/interfaces/process-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB;;;OAGG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3C;;;OAGG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAEjE;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAE1D;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1C;;;OAGG;IACH,mBAAmB,IAAI,OAAO,CAAC;IAE/B;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,sBAAsB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,kCAAkC;IAClC,mBAAmB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,gCAAgC;IAChC,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,0CAA0C;IAC1C,eAAe,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;CACxD"}

package/dist/src/process-manager/interfaces/process-monitor.js

@@ -0,0 +1,10 @@
+/**
+ * Process Monitoring Interface
+ *
+ * Handles monitoring of process health and resource usage:
+ * - Memory and CPU monitoring
+ * - Process health checks
+ * - Performance statistics
+ */
+export {};
+//# sourceMappingURL=process-monitor.js.map

package/dist/src/process-manager/interfaces/process-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-monitor.js","sourceRoot":"","sources":["../../../../src/process-manager/interfaces/process-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

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

@@ -0,0 +1,125 @@
+/**
+ * Process Persistence Interface
+ *
+ * Handles saving and loading process state to/from persistent storage:
+ * - State serialization and deserialization
+ * - File I/O operations
+ * - Backup and recovery
+ */
+import { PersistedManagedProcessInfo } from '../../shared/process.js';
+/**
+ * Persistence configuration
+ */
+export interface PersistenceConfig {
+    /** Path to the persistence file */
+    filePath: string;
+    /** Debounce delay for saving state in milliseconds */
+    saveDelay: number;
+    /** Whether to create backup files */
+    enableBackup: boolean;
+}
+/**
+ * Result of a persistence operation
+ */
+export interface PersistenceResult {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Error message if operation failed */
+    error?: string;
+    /** Additional metadata */
+    metadata?: {
+        /** File path used */
+        filePath?: string;
+        /** Whether backup was used */
+        usedBackup?: boolean;
+        /** Number of processes loaded/saved */
+        processCount?: number;
+    };
+}
+/**
+ * Interface for process persistence
+ */
+export interface ProcessPersistence {
+    /**
+     * Initialize persistence with configuration
+     * @param config Persistence configuration
+     */
+    initialize(config: PersistenceConfig): void;
+    /**
+     * Save current process state to persistent storage
+     * @param processes Array of process information to save
+     * @returns Promise resolving to the result
+     */
+    saveState(processes: PersistedManagedProcessInfo[]): Promise<PersistenceResult>;
+    /**
+     * Force save state immediately (bypassing debounce)
+     * @param processes Array of process information to save
+     * @returns Promise resolving to the result
+     */
+    forceSaveState(processes: PersistedManagedProcessInfo[]): Promise<PersistenceResult>;
+    /**
+     * Load process state from persistent storage
+     * @returns Promise resolving to loaded processes or empty array if none found
+     */
+    loadState(): Promise<PersistedManagedProcessInfo[]>;
+    /**
+     * Load process state from backup file
+     * @returns Promise resolving to loaded processes or empty array if none found
+     */
+    loadFromBackup(): Promise<PersistedManagedProcessInfo[]>;
+    /**
+     * Get the persistence file path
+     * @returns File path being used for persistence
+     */
+    getFilePath(): string;
+    /**
+     * Check if persistence file exists
+     * @returns True if persistence file exists
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Check if backup file exists
+     * @returns True if backup file exists
+     */
+    backupExists(): Promise<boolean>;
+    /**
+     * Create a backup of the current persistence file
+     * @returns Promise resolving to the result
+     */
+    createBackup(): Promise<PersistenceResult>;
+    /**
+     * Cleanup persistence resources
+     */
+    cleanup(): void;
+}
+/**
+ * Event types emitted by ProcessPersistence
+ */
+export interface ProcessPersistenceEvents {
+    /** State was saved successfully */
+    'persistence:saved': {
+        filePath: string;
+        processCount: number;
+    };
+    /** State save failed */
+    'persistence:save-error': {
+        filePath: string;
+        error: Error;
+    };
+    /** State was loaded successfully */
+    'persistence:loaded': {
+        filePath: string;
+        processCount: number;
+        usedBackup: boolean;
+    };
+    /** State load failed */
+    'persistence:load-error': {
+        filePath: string;
+        error: Error;
+    };
+    /** Backup was created */
+    'persistence:backup-created': {
+        filePath: string;
+    };
+}
+//# sourceMappingURL=process-persistence.d.ts.map

package/dist/src/process-manager/interfaces/process-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-persistence.d.ts","sourceRoot":"","sources":["../../../../src/process-manager/interfaces/process-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE;QACT,qBAAqB;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,8BAA8B;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,uCAAuC;QACvC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE5C;;;;OAIG;IACH,SAAS,CACP,SAAS,EAAE,2BAA2B,EAAE,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;;;OAIG;IACH,cAAc,CACZ,SAAS,EAAE,2BAA2B,EAAE,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAEpD;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAEzD;;;OAGG;IACH,WAAW,IAAI,MAAM,CAAC;IAEtB;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3B;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3C;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mCAAmC;IACnC,mBAAmB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,wBAAwB;IACxB,wBAAwB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IAC7D,oCAAoC;IACpC,oBAAoB,EAAE;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,wBAAwB;IACxB,wBAAwB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IAC7D,yBAAyB;IACzB,4BAA4B,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD"}

package/dist/src/process-manager/interfaces/process-persistence.js

@@ -0,0 +1,10 @@
+/**
+ * Process Persistence Interface
+ *
+ * Handles saving and loading process state to/from persistent storage:
+ * - State serialization and deserialization
+ * - File I/O operations
+ * - Backup and recovery
+ */
+export {};
+//# sourceMappingURL=process-persistence.js.map

package/dist/src/process-manager/interfaces/process-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-persistence.js","sourceRoot":"","sources":["../../../../src/process-manager/interfaces/process-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}