@masuidrive/procman 0.1.0

package/dist/src/daemon/procman-daemon.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Main daemon class for procman
+ *
+ * Orchestrates daemon components using specialized managers.
+ * Follows Single Responsibility Principle by delegating to:
+ * - DaemonStateManager: State management and transitions
+ * - ComponentManager: Component lifecycle management
+ * - SignalHandler: Process signal handling
+ * - DataDirectory & PIDManager: File system management
+ */
+import { EventEmitter } from 'events';
+import { DaemonState } from './daemon-state-manager.js';
+import { ConfigLoader } from '../config/config-loader.js';
+import { ProcessManager } from '../process-manager/process-manager.js';
+import { LogManager } from '../services/log-manager.js';
+import { IPCServerBase } from './ipc-server-base.js';
+import { AppConfig } from '../shared/config.js';
+/**
+ * Shutdown reason types for graceful shutdown
+ */
+export type ShutdownReason = 'signal' | 'memory' | 'manual' | 'error';
+export { DaemonState };
+/**
+ * Events emitted by ProcmanDaemon
+ */
+export interface ProcmanDaemonEvents {
+    stateChange: (state: DaemonState) => void;
+    error: (error: Error) => void;
+    componentStarted: (componentName: string) => void;
+    componentStopped: (componentName: string) => void;
+    recoveryStarted: () => void;
+    recoveryCompleted: () => void;
+    recoveryFailed: (error: Error) => void;
+    shutdownStarted: (reason: ShutdownReason) => void;
+    shutdownCompleted: (reason: ShutdownReason, totalTime: number) => void;
+    shutdownFailed: (reason: ShutdownReason, error: Error, totalTime: number) => void;
+    newConnectionsRejected: () => void;
+}
+/**
+ * Main daemon class that coordinates all procman components
+ */
+export declare class ProcmanDaemon extends EventEmitter {
+    private dataDirectory;
+    private pidManager;
+    private stateManager;
+    private componentManager;
+    private signalHandler;
+    private memoryMonitor;
+    private currentConfig?;
+    private configFilePath?;
+    private recoveryAttempts;
+    private readonly maxRecoveryAttempts;
+    private isShuttingDown;
+    constructor();
+    /**
+     * Get current daemon state
+     */
+    getState(): DaemonState;
+    /**
+     * Check if daemon is currently running
+     */
+    isRunning(): boolean;
+    /**
+     * Check if daemon is ready to handle requests
+     * Performs comprehensive health checks on all components
+     */
+    isReady(): Promise<boolean>;
+    /**
+     * Get detailed health status of all components
+     */
+    getHealthStatus(): Promise<{
+        ready: boolean;
+        components: Record<string, {
+            status: 'healthy' | 'unhealthy' | 'unknown';
+            message: string;
+        }>;
+        memory?: {
+            status: 'healthy' | 'warning' | 'critical';
+            currentMemory: any;
+            thresholds: {
+                warning: number;
+                critical: number;
+            };
+            trend?: any;
+        };
+    }>;
+    /**
+     * Start the daemon
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the daemon
+     */
+    stop(): Promise<void>;
+    /**
+     * Restart the daemon
+     */
+    restart(): Promise<void>;
+    /**
+     * Graceful shutdown with extended capabilities and state preservation
+     *
+     * @param reason The reason for shutdown
+     * @param timeoutMs Maximum time to wait for graceful shutdown (default: 30s)
+     */
+    shutdown(reason?: ShutdownReason, timeoutMs?: number): Promise<void>;
+    /**
+     * Save shutdown state to disk for recovery/analysis
+     */
+    private saveShutdownState;
+    /**
+     * Get count of active IPC connections
+     */
+    private getActiveConnectionCount;
+    /**
+     * Drain active IPC connections gracefully
+     */
+    private drainActiveConnections;
+    /**
+     * Stop all managed processes gracefully
+     */
+    private stopManagedProcesses;
+    /**
+     * Execute a function with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Format bytes to human-readable string
+     */
+    private formatBytes;
+    /**
+     * Perform environment checks before daemon startup
+     */
+    private performEnvironmentChecks;
+    /**
+     * Attempt error recovery
+     */
+    attemptRecovery(): Promise<boolean>;
+    /**
+     * Load configuration and apply it
+     */
+    loadConfig(configFilePath: string): Promise<AppConfig[]>;
+    /**
+     * Get current configuration
+     */
+    getConfig(): AppConfig[] | undefined;
+    /**
+     * Get component instances (for backward compatibility)
+     */
+    getConfigLoader(): ConfigLoader | undefined;
+    getProcessManager(): ProcessManager | undefined;
+    getLogManager(): LogManager | undefined;
+    getIPCServer(): IPCServerBase | undefined;
+    /**
+     * Get all process statuses (moved from old implementation)
+     */
+    getAllProcessStatuses(): Promise<{
+        name: string;
+        namespace: string;
+        pid: number | null;
+        status: import("../shared/process.js").ProcessStatus;
+        uptime: number;
+        memory: number;
+        cpu: number;
+        restarts: number;
+    }[]>;
+    /**
+     * Setup event listeners for internal managers
+     */
+    private setupEventListeners;
+    /**
+     * Perform startup cleanup on failure
+     */
+    private performStartupCleanup;
+    /**
+     * Perform emergency cleanup when normal stop fails
+     */
+    private performEmergencyCleanup;
+    /**
+     * Perform recovery steps when in RECOVERING state
+     */
+    private performRecoverySteps;
+    /**
+     * Override EventEmitter methods for type safety
+     */
+    emit<K extends keyof ProcmanDaemonEvents>(event: K, ...args: any[]): boolean;
+    on<K extends keyof ProcmanDaemonEvents>(event: K, listener: (...args: any[]) => void): this;
+}
+//# sourceMappingURL=procman-daemon.d.ts.map

package/dist/src/daemon/procman-daemon.d.ts.map

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