@masuidrive/procman 0.1.0

package/dist/src/shared/logger.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Structured Logging System using Winston
+ *
+ * This module provides a centralized logging system with structured JSON output,
+ * log rotation, and configurable log levels for the procman system.
+ */
+import * as winston from 'winston';
+/**
+ * Create a logger instance for a specific module
+ * @param moduleName The name of the module using the logger
+ * @returns Winston logger instance
+ */
+export declare function createLogger(moduleName: string): winston.Logger;
+/**
+ * Default logger for shared utilities
+ */
+export declare const logger: winston.Logger;
+/**
+ * Log level type is exported from types.ts to avoid conflicts
+ */
+/**
+ * Helper function to log process lifecycle events
+ */
+export declare function logProcessEvent(logger: winston.Logger, event: string, processName: string, metadata?: Record<string, unknown>): void;
+/**
+ * Helper function to log process errors
+ */
+export declare function logProcessError(logger: winston.Logger, error: Error | unknown, processName: string, context?: string): void;
+/**
+ * Helper function to log performance metrics
+ */
+export declare function logPerformanceMetrics(logger: winston.Logger, processName: string, metrics: {
+    memory?: number;
+    cpu?: number;
+    uptime?: number;
+    restarts?: number;
+}): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/shared/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/shared/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAqCnC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAkF/D;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,gBAAyB,CAAC;AAE7C;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,KAAK,EAAE,KAAK,GAAG,OAAO,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,IAAI,CAMN"}

package/dist/src/shared/logger.js

@@ -0,0 +1,139 @@
+/**
+ * Structured Logging System using Winston
+ *
+ * This module provides a centralized logging system with structured JSON output,
+ * log rotation, and configurable log levels for the procman system.
+ */
+import * as winston from 'winston';
+import * as path from 'path';
+import * as os from 'os';
+// Log levels
+const LOG_LEVELS = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+};
+// Check if running in test environment
+const isTestEnvironment = process.env.NODE_ENV === 'test' || process.env.VITEST === 'true';
+// Get log level from environment or default
+const getLogLevel = () => {
+    const envLevel = process.env.LOG_LEVEL?.toLowerCase();
+    if (envLevel && envLevel in LOG_LEVELS) {
+        return envLevel;
+    }
+    // In test environment, suppress logs unless explicitly set
+    return isTestEnvironment ? 'error' : 'info';
+};
+// Log directory
+const getLogDirectory = () => {
+    // Enhanced HOME detection: process.env.HOME || os.homedir()
+    const homeDir = process.env.HOME || os.homedir();
+    if (!homeDir) {
+        throw new Error('Unable to determine home directory for log path');
+    }
+    return path.join(homeDir, '.masuidrive-procman', 'logs');
+};
+/**
+ * Create a logger instance for a specific module
+ * @param moduleName The name of the module using the logger
+ * @returns Winston logger instance
+ */
+export function createLogger(moduleName) {
+    const logDir = getLogDirectory();
+    // Define log format
+    const logFormat = winston.format.combine(winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss.SSS' }), winston.format.errors({ stack: true }), winston.format.json());
+    // Console format for development
+    const consoleFormat = winston.format.combine(winston.format.colorize(), winston.format.timestamp({ format: 'HH:mm:ss.SSS' }), winston.format.printf(({ timestamp, level, message, module, ...metadata }) => {
+        let log = `${timestamp} [${module || moduleName}] ${level}: ${message}`;
+        // Add metadata if present
+        const metaKeys = Object.keys(metadata).filter((key) => key !== 'stack');
+        if (metaKeys.length > 0) {
+            const metaString = metaKeys
+                .map((key) => `${key}=${JSON.stringify(metadata[key])}`)
+                .join(' ');
+            log += ` ${metaString}`;
+        }
+        // Add stack trace if present
+        if (metadata.stack) {
+            log += `\n${metadata.stack}`;
+        }
+        return log;
+    }));
+    // Create transports array
+    const transports = [];
+    // Console transport (except in test environment)
+    if (!isTestEnvironment) {
+        transports.push(new winston.transports.Console({
+            format: consoleFormat,
+        }));
+    }
+    // File transports (only if not in test environment)
+    if (!isTestEnvironment && process.env.LOG_TO_FILE !== 'false') {
+        // Combined log file
+        transports.push(new winston.transports.File({
+            filename: path.join(logDir, 'procman.log'),
+            format: logFormat,
+            maxsize: 10 * 1024 * 1024, // 10MB
+            maxFiles: 5,
+        }));
+        // Error log file
+        transports.push(new winston.transports.File({
+            filename: path.join(logDir, 'procman-error.log'),
+            level: 'error',
+            format: logFormat,
+            maxsize: 10 * 1024 * 1024, // 10MB
+            maxFiles: 5,
+        }));
+    }
+    // Create logger instance
+    const logger = winston.createLogger({
+        level: getLogLevel(),
+        levels: LOG_LEVELS,
+        defaultMeta: { module: moduleName },
+        transports,
+    });
+    return logger;
+}
+/**
+ * Default logger for shared utilities
+ */
+export const logger = createLogger('shared');
+/**
+ * Log level type is exported from types.ts to avoid conflicts
+ */
+/**
+ * Helper function to log process lifecycle events
+ */
+export function logProcessEvent(logger, event, processName, metadata) {
+    logger.info(`Process ${event}`, {
+        event,
+        processName,
+        timestamp: Date.now(),
+        ...metadata,
+    });
+}
+/**
+ * Helper function to log process errors
+ */
+export function logProcessError(logger, error, processName, context) {
+    const errorObj = error instanceof Error ? error : new Error(String(error));
+    logger.error(`Process error${context ? ` in ${context}` : ''}`, {
+        processName,
+        error: errorObj.message,
+        stack: errorObj.stack,
+        context,
+        timestamp: Date.now(),
+    });
+}
+/**
+ * Helper function to log performance metrics
+ */
+export function logPerformanceMetrics(logger, processName, metrics) {
+    logger.debug('Process performance metrics', {
+        processName,
+        metrics,
+        timestamp: Date.now(),
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/shared/logger.js.map

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

package/dist/src/shared/logs.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Log Management Type Definitions
+ *
+ * This module defines basic types for log management in the procman system.
+ */
+/**
+ * Basic log entry structure
+ */
+export interface LogEntry {
+    /** Timestamp when the log was created */
+    timestamp: number;
+    /** Log level */
+    level: 'info' | 'warn' | 'error';
+    /** Log message */
+    message: string;
+    /** Application name */
+    app: string;
+    /** Namespace */
+    namespace: string;
+    /** Log type (stdout or stderr) */
+    type: 'stdout' | 'stderr';
+}
+/**
+ * Options for log retrieval and display
+ */
+export interface LogOptions {
+    /** Number of lines to retrieve */
+    lines?: number;
+    /** Use human-readable format */
+    human?: boolean;
+    /** Enable streaming mode */
+    stream?: boolean;
+    /** Enable follow mode (for streaming) */
+    follow?: boolean;
+    /** Filter by log level */
+    level?: Array<'info' | 'warn' | 'error'>;
+    /** Filter by log type */
+    type?: Array<'stdout' | 'stderr'>;
+    /** Show logs since timestamp */
+    since?: number;
+    /** Show logs until timestamp */
+    until?: number;
+}
+/**
+ * Supported log output formats
+ */
+export type LogFormat = 'basic' | 'json' | 'csv' | 'pretty' | 'raw' | 'compact';
+/**
+ * Type guard to check if an object is a LogEntry
+ * Note: This performs complete validation of all required fields.
+ */
+export declare function isLogEntry(obj: unknown): obj is LogEntry;
+//# sourceMappingURL=logs.d.ts.map

package/dist/src/shared/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/shared/logs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACzC,yBAAyB;IACzB,IAAI,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAClC,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAMhF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAexD"}

package/dist/src/shared/logs.js

@@ -0,0 +1,26 @@
+/**
+ * Log Management Type Definitions
+ *
+ * This module defines basic types for log management in the procman system.
+ */
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Type guard to check if an object is a LogEntry
+ * Note: This performs complete validation of all required fields.
+ */
+export function isLogEntry(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const entry = obj;
+    return (typeof entry.timestamp === 'number' &&
+        (entry.level === 'info' ||
+            entry.level === 'warn' ||
+            entry.level === 'error') &&
+        typeof entry.message === 'string' &&
+        typeof entry.app === 'string' &&
+        typeof entry.namespace === 'string' &&
+        (entry.type === 'stdout' || entry.type === 'stderr'));
+}
+//# sourceMappingURL=logs.js.map

package/dist/src/shared/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/shared/logs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2DH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAE1D,MAAM,KAAK,GAAG,GAA8B,CAAC;IAE7C,OAAO,CACL,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM;YACrB,KAAK,CAAC,KAAK,KAAK,MAAM;YACtB,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC;QAC1B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CACrD,CAAC;AACJ,CAAC"}

package/dist/src/shared/process.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Process Management Type Definitions
+ *
+ * This module defines basic types for process management in the procman system.
+ */
+/**
+ * Possible states of a managed process
+ */
+export type ProcessStatus = 'stopped' | 'starting' | 'online' | 'stopping' | 'errored' | 'max-memory';
+/**
+ * Information about a managed process
+ */
+export interface ProcessInfo {
+    /** Process name */
+    name: string;
+    /** Process namespace */
+    namespace: string;
+    /** Current process status */
+    status: ProcessStatus;
+    /** Process ID (null if not running) */
+    pid: number | null;
+    /** Process uptime in milliseconds */
+    uptime: number;
+    /** Memory usage in bytes */
+    memory: number;
+    /** CPU usage percentage */
+    cpu: number;
+    /** Number of restarts */
+    restarts: number;
+    /** Optional note */
+    note?: string;
+}
+/**
+ * Type guard to check if a string is a valid ProcessStatus
+ */
+export declare function isValidProcessStatus(status: string): status is ProcessStatus;
+/**
+ * Type guard to check if an object is a ProcessInfo
+ * Note: This performs complete validation of all required fields.
+ */
+export declare function isProcessInfo(obj: unknown): obj is ProcessInfo;
+/**
+ * Process state change record for history tracking
+ */
+export interface ProcessStateChange {
+    /** Timestamp of the state change */
+    timestamp: number;
+    /** Previous status */
+    from: ProcessStatus;
+    /** New status */
+    to: ProcessStatus;
+    /** Optional reason for the change */
+    reason?: string;
+}
+/**
+ * Memory usage sample for history tracking
+ */
+export interface MemorySample {
+    /** Timestamp of the measurement */
+    timestamp: number;
+    /** Memory usage in bytes */
+    usage: number;
+}
+/**
+ * CPU usage sample for history tracking
+ */
+export interface CPUSample {
+    /** Timestamp of the measurement */
+    timestamp: number;
+    /** CPU usage percentage */
+    usage: number;
+}
+/**
+ * Persisted process information for state restoration
+ */
+export interface PersistedManagedProcessInfo {
+    /** Process name */
+    name: string;
+    /** Process status */
+    status: ProcessStatus;
+    /** Process ID (null after manager restart) */
+    pid: number | null;
+    /** Restart count */
+    restartCount: number;
+    /** Auto-restart enabled flag */
+    autoRestartEnabled: boolean;
+    /** Last start time timestamp */
+    lastStartTime: number | null;
+    /** State change history */
+    stateHistory: ProcessStateChange[];
+    /** Memory usage history */
+    memoryHistory: MemorySample[];
+    /** CPU usage history */
+    cpuHistory: CPUSample[];
+    /** Consecutive restart failures */
+    consecutiveRestarts: number;
+    /** Last restart time timestamp */
+    lastRestartTime: number | null;
+    /** Last crash time timestamp */
+    lastCrashTime: number | null;
+}
+//# sourceMappingURL=process.d.ts.map

package/dist/src/shared/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/shared/process.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,GACT,YAAY,CAAC;AAMjB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,uCAAuC;IACvC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,aAAa,CAU5E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAwB9D;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,iBAAiB;IACjB,EAAE,EAAE,aAAa,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gCAAgC;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2BAA2B;IAC3B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,2BAA2B;IAC3B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,wBAAwB;IACxB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,mCAAmC;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kCAAkC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gCAAgC;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B"}

package/dist/src/shared/process.js

@@ -0,0 +1,55 @@
+/**
+ * Process Management Type Definitions
+ *
+ * This module defines basic types for process management in the procman system.
+ */
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Type guard to check if a string is a valid ProcessStatus
+ */
+export function isValidProcessStatus(status) {
+    const validStatuses = [
+        'stopped',
+        'starting',
+        'online',
+        'stopping',
+        'errored',
+        'max-memory',
+    ];
+    return validStatuses.includes(status);
+}
+/**
+ * Type guard to check if an object is a ProcessInfo
+ * Note: This performs complete validation of all required fields.
+ */
+export function isProcessInfo(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const info = obj;
+    // Check required fields
+    if (typeof info.name !== 'string' || !info.name.trim())
+        return false;
+    if (typeof info.namespace !== 'string')
+        return false;
+    if (!isValidProcessStatus(String(info.status)))
+        return false;
+    if (typeof info.pid !== 'number' && info.pid !== null)
+        return false;
+    if (typeof info.uptime !== 'number' || info.uptime < 0)
+        return false;
+    if (typeof info.memory !== 'number' || info.memory < 0)
+        return false;
+    if (typeof info.cpu !== 'number' || info.cpu < 0)
+        return false;
+    if (typeof info.restarts !== 'number' ||
+        info.restarts < 0 ||
+        !Number.isInteger(info.restarts))
+        return false;
+    // Check optional fields
+    if (info.note !== undefined && typeof info.note !== 'string')
+        return false;
+    return true;
+}
+//# sourceMappingURL=process.js.map

package/dist/src/shared/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../src/shared/process.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6CH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,aAAa,GAAoB;QACrC,SAAS;QACT,UAAU;QACV,QAAQ;QACR,UAAU;QACV,SAAS;QACT,YAAY;KACb,CAAC;IACF,OAAO,aAAa,CAAC,QAAQ,CAAC,MAAuB,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAE1D,MAAM,IAAI,GAAG,GAA8B,CAAC;IAE5C,wBAAwB;IACxB,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,IACE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;QACjC,IAAI,CAAC,QAAQ,GAAG,CAAC;QACjB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QAEhC,OAAO,KAAK,CAAC;IAEf,wBAAwB;IACxB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE3E,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/shared/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utility types for procman constants
+ *
+ * This file contains utility types that work with the system constants,
+ * providing type safety and better developer experience.
+ */
+import { MEMORY_UNITS, LOG_LEVELS, LOG_TYPES } from './constants.js';
+export type MemoryUnit = (typeof MEMORY_UNITS)[number];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+export type LogType = (typeof LOG_TYPES)[number];
+export type Platform = 'WINDOWS' | 'UNIX';
+export type MemorySize = `${number}${MemoryUnit}`;
+export type FilePath = string;
+export type ProcessSignal = 'SIGTERM' | 'SIGKILL' | number;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGrE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAGvD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAGnD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAGjD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAG1C,MAAM,MAAM,UAAU,GAAG,GAAG,MAAM,GAAG,UAAU,EAAE,CAAC;AAGlD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAG9B,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC"}

package/dist/src/shared/types.js

@@ -0,0 +1,8 @@
+/**
+ * Utility types for procman constants
+ *
+ * This file contains utility types that work with the system constants,
+ * providing type safety and better developer experience.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Basic type definitions for procman
+ */
+export interface ProcessInfo {
+    pid: number;
+    name: string;
+    status: 'running' | 'stopped' | 'crashed';
+}
+export interface ServiceConfig {
+    name: string;
+    command: string;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export interface CliOptions {
+    verbose?: boolean;
+    config?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/src/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Basic type definitions for procman
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/utils/event-cleanup.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from 'events';
+/**
+ * Interface for disposable resources
+ */
+interface Disposable {
+    dispose(): Promise<void>;
+}
+/**
+ * Simple helper for tracking and cleaning up EventEmitter listeners
+ *
+ * This is a lightweight alternative to complex listener management systems.
+ * Based on Uncle Bob's recommendation for explicit, simple resource cleanup.
+ */
+export declare class EventCleanupHelper implements Disposable {
+    private listeners;
+    /**
+     * Track a listener for later cleanup
+     */
+    track(emitter: EventEmitter, event: string | symbol, listener: (...args: any[]) => void): void;
+    /**
+     * Clean up all tracked listeners
+     */
+    dispose(): Promise<void>;
+    /**
+     * Get count of tracked listeners (for debugging)
+     */
+    getListenerCount(): number;
+}
+export {};
+//# sourceMappingURL=event-cleanup.d.ts.map

package/dist/src/utils/event-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-cleanup.d.ts","sourceRoot":"","sources":["../../../src/utils/event-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,UAAU,UAAU;IAClB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,SAAS,CAIT;IAER;;OAEG;IACH,KAAK,CACH,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GACjC,IAAI;IAKP;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAG3B"}

package/dist/src/utils/event-cleanup.js

@@ -0,0 +1,32 @@
+/**
+ * Simple helper for tracking and cleaning up EventEmitter listeners
+ *
+ * This is a lightweight alternative to complex listener management systems.
+ * Based on Uncle Bob's recommendation for explicit, simple resource cleanup.
+ */
+export class EventCleanupHelper {
+    listeners = [];
+    /**
+     * Track a listener for later cleanup
+     */
+    track(emitter, event, listener) {
+        emitter.on(event, listener);
+        this.listeners.push({ emitter, event, listener });
+    }
+    /**
+     * Clean up all tracked listeners
+     */
+    async dispose() {
+        for (const { emitter, event, listener } of this.listeners) {
+            emitter.removeListener(event, listener);
+        }
+        this.listeners.length = 0;
+    }
+    /**
+     * Get count of tracked listeners (for debugging)
+     */
+    getListenerCount() {
+        return this.listeners.length;
+    }
+}
+//# sourceMappingURL=event-cleanup.js.map

package/dist/src/utils/event-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-cleanup.js","sourceRoot":"","sources":["../../../src/utils/event-cleanup.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACrB,SAAS,GAIZ,EAAE,CAAC;IAER;;OAEG;IACH,KAAK,CACH,OAAqB,EACrB,KAAsB,EACtB,QAAkC;QAElC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1D,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF"}