@masuidrive/procman 0.1.0

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

@@ -0,0 +1,307 @@
+/**
+ * ManagedProcessInfo - Individual process information management
+ *
+ * This class manages the information and statistics for a single process,
+ * including uptime tracking, restart counting, and state change recording.
+ */
+import { EventEmitter } from 'events';
+import { ProcessInfo, ProcessStatus, ProcessStateChange, MemorySample, CPUSample, PersistedManagedProcessInfo } from '../shared/process.js';
+import { ProcessConfig } from './process-manager.js';
+/**
+ * Process statistics for tracking performance and behavior
+ */
+export interface ProcessStatistics {
+    /** Start time timestamp */
+    startedAt: number | null;
+    /** Last status change timestamp */
+    lastStatusChange: number;
+    /** Total restart count */
+    restarts: number;
+    /** Last restart timestamp */
+    lastRestart: number | null;
+    /** Memory usage history (last 10 measurements) - DEPRECATED: use memoryHistory instead */
+    memoryHistory: number[];
+    /** CPU usage history (last 10 measurements) - DEPRECATED: use cpuHistory instead */
+    cpuHistory: number[];
+    /** Current memory usage in bytes */
+    currentMemory: number;
+    /** Current CPU usage percentage */
+    currentCpu: number;
+    /** Consecutive failure count for restart control */
+    consecutiveFailures: number;
+    /** Timestamp of first failure in current window */
+    firstFailureTime: number | null;
+    /** Flag to indicate auto-restart is enabled */
+    autoRestartEnabled: boolean;
+    /** Next restart delay in milliseconds */
+    nextRestartDelay: number;
+}
+/**
+ * Events emitted by ManagedProcessInfo
+ */
+export interface ManagedProcessEvents {
+    /** Process status changed */
+    'status-change': (newStatus: ProcessStatus, oldStatus: ProcessStatus) => void;
+    /** Process started */
+    start: (pid: number) => void;
+    /** Process stopped */
+    stop: (exitCode: number | null) => void;
+    /** Process restarted */
+    restart: (restartCount: number) => void;
+    /** Process memory limit exceeded */
+    'memory-limit': (memoryUsage: number, limit: number) => void;
+    /** Process error occurred */
+    error: (error: Error) => void;
+}
+/**
+ * Manages information and statistics for a single process
+ */
+export declare class ManagedProcessInfo extends EventEmitter {
+    private readonly config;
+    private status;
+    private pid;
+    private statistics;
+    private stateHistory;
+    private memoryHistoryDetailed;
+    private cpuHistoryDetailed;
+    private lastCrashTime;
+    constructor(config: ProcessConfig);
+    /**
+     * Update process configuration
+     * @param newConfig New configuration
+     */
+    updateConfig(newConfig: ProcessConfig): void;
+    /**
+     * Get process name
+     * @returns Process name
+     */
+    getName(): string;
+    /**
+     * Get process namespace
+     * @returns Process namespace
+     */
+    getNamespace(): string;
+    /**
+     * Get process configuration
+     * @returns Process configuration (read-only copy)
+     */
+    getConfig(): Readonly<ProcessConfig>;
+    /**
+     * Get current process information
+     * @returns Process information
+     */
+    getProcessInfo(): ProcessInfo;
+    /**
+     * Get current process information (alias for getProcessInfo)
+     * @returns Process information
+     */
+    toProcessInfo(): ProcessInfo;
+    /**
+     * Get detailed process statistics
+     * @returns Process statistics
+     */
+    getStatistics(): Readonly<ProcessStatistics>;
+    /**
+     * Get current status
+     * @returns Current process status
+     */
+    getStatus(): ProcessStatus;
+    /**
+     * Set process status
+     * @param newStatus New status
+     * @param emitEvent Whether to emit status change event (default: true)
+     * @param reason Optional reason for the status change
+     */
+    setStatus(newStatus: ProcessStatus, emitEvent?: boolean, reason?: string): void;
+    /**
+     * Get current PID
+     * @returns Process ID or null if not running
+     */
+    getPid(): number | null;
+    /**
+     * Set process PID
+     * @param pid Process ID
+     */
+    setPid(pid: number | null): void;
+    /**
+     * Calculate process uptime in milliseconds
+     * @returns Uptime in milliseconds
+     */
+    calculateUptime(): number;
+    /**
+     * Update memory usage
+     * @param memoryUsage Memory usage in bytes
+     */
+    updateMemoryUsage(memoryUsage: number): void;
+    /**
+     * Update CPU usage
+     * @param cpuUsage CPU usage percentage
+     */
+    updateCpuUsage(cpuUsage: number): void;
+    /**
+     * Get average memory usage from history
+     * @returns Average memory usage in bytes
+     */
+    getAverageMemoryUsage(): number;
+    /**
+     * Get average CPU usage from history
+     * @returns Average CPU usage percentage
+     */
+    getAverageCpuUsage(): number;
+    /**
+     * Get current memory usage
+     * @returns Current memory usage in bytes
+     */
+    getMemoryUsage(): number;
+    /**
+     * Record a restart
+     */
+    recordRestart(): void;
+    /**
+     * Increment restart count (alias for recordRestart)
+     */
+    incrementRestarts(): void;
+    /**
+     * Reset restart count
+     */
+    resetRestartCount(): void;
+    /**
+     * Get time since last restart
+     * @returns Time since last restart in milliseconds, or null if never restarted
+     */
+    getTimeSinceLastRestart(): number | null;
+    /**
+     * Emit start event
+     * @param pid Process ID
+     */
+    emitStart(pid: number): void;
+    /**
+     * Emit stop event
+     * @param exitCode Exit code
+     */
+    emitStop(exitCode: number | null): void;
+    /**
+     * Emit error event
+     * @param error Error object
+     */
+    emitError(error: Error): void;
+    /**
+     * Check if process should be monitored
+     * @returns True if process is in a monitorable state
+     */
+    isMonitorable(): boolean;
+    /**
+     * Check if process is running
+     * @returns True if process is running
+     */
+    isRunning(): boolean;
+    /**
+     * Check if process is stopped
+     * @returns True if process is stopped
+     */
+    isStopped(): boolean;
+    /**
+     * Check if process has memory limit configured
+     * @returns True if memory limit is configured
+     */
+    hasMemoryLimit(): boolean;
+    /**
+     * Get memory limit in bytes
+     * @returns Memory limit in bytes or undefined if not configured
+     */
+    getMemoryLimit(): number | undefined;
+    /**
+     * Check if auto-restart is enabled
+     * @returns True if auto-restart is enabled
+     */
+    isAutoRestartEnabled(): boolean;
+    /**
+     * Enable or disable auto-restart
+     * @param enabled Auto-restart enabled flag
+     */
+    setAutoRestartEnabled(enabled: boolean): void;
+    /**
+     * Record a restart failure
+     */
+    recordRestartFailure(): void;
+    /**
+     * Record a successful restart (reset failure counters)
+     */
+    recordRestartSuccess(): void;
+    /**
+     * Reset restart failure counters
+     */
+    resetRestartFailures(): void;
+    /**
+     * Get consecutive failure count
+     * @returns Number of consecutive failures
+     */
+    getConsecutiveFailures(): number;
+    /**
+     * Get next restart delay
+     * @returns Next restart delay in milliseconds
+     */
+    getNextRestartDelay(): number;
+    /**
+     * Calculate next restart delay using exponential backoff
+     */
+    private calculateNextRestartDelay;
+    /**
+     * Check if restart should be attempted based on failure count
+     * @returns True if restart should be attempted
+     */
+    shouldRestart(): boolean;
+    /**
+     * Check if this is an unexpected exit (crash detection)
+     * @param exitCode Process exit code
+     * @param signal Process exit signal
+     * @returns True if this is considered an unexpected exit
+     */
+    isUnexpectedExit(exitCode: number | null, signal: string | null): boolean;
+    /**
+     * Clean up resources (non-destructive, maintains data for persistence)
+     */
+    cleanup(): void;
+    /**
+     * Dispose of all resources (destructive, clears all data)
+     */
+    dispose(): void;
+    /**
+     * Add a state change to history
+     * @param from Previous status
+     * @param to New status
+     * @param reason Optional reason for change
+     */
+    private addStateChange;
+    /**
+     * Get state change history
+     * @returns Array of state changes
+     */
+    getStateHistory(): Readonly<ProcessStateChange[]>;
+    /**
+     * Get memory usage history with timestamps
+     * @returns Array of memory samples
+     */
+    getMemoryHistory(): Readonly<MemorySample[]>;
+    /**
+     * Get CPU usage history with timestamps
+     * @returns Array of CPU samples
+     */
+    getCpuHistory(): Readonly<CPUSample[]>;
+    /**
+     * Get last crash time
+     * @returns Last crash timestamp or null if never crashed
+     */
+    getLastCrashTime(): number | null;
+    /**
+     * Serialize process information for persistence
+     * @returns Serializable process information
+     */
+    toJSON(): PersistedManagedProcessInfo;
+    /**
+     * Restore process state from persisted data
+     * @param persistedState Previously saved state
+     */
+    restoreState(persistedState: Omit<PersistedManagedProcessInfo, 'name'>): void;
+}
+//# sourceMappingURL=managed-process-info.d.ts.map

package/dist/src/process-manager/managed-process-info.d.ts.map

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