@masuidrive/procman 0.1.0

package/dist/src/config/config-reporter.js

@@ -0,0 +1,311 @@
+/**
+ * Configuration Reporter
+ *
+ * Handles reporting logic for procman configuration validation.
+ * Provides detailed validation reports and error tracking.
+ */
+import * as path from 'path';
+import { ProcmanError } from '../shared/errors.js';
+/**
+ * Configuration reporter class
+ * Responsible for generating validation reports and error messages
+ */
+export class ConfigReporter {
+    includeSuggestions;
+    maxIssues;
+    validationIssues = [];
+    lastReport = null;
+    constructor(options = {}) {
+        this.includeSuggestions = options.includeSuggestions !== false;
+        this.maxIssues = options.maxIssues || 100;
+    }
+    /**
+     * Generate validation report for configuration
+     * @param config Validated configuration (or null if validation failed)
+     * @param filePath Path to configuration file
+     * @param issues Array of validation issues
+     * @returns Validation report
+     */
+    generateReport(config, filePath, issues = []) {
+        const absolutePath = path.resolve(filePath);
+        this.validationIssues = [...issues];
+        const report = {
+            success: config !== null,
+            filePath: absolutePath,
+            appCount: config?.apps.length || 0,
+            issues: [...this.validationIssues],
+            summary: this.calculateSummary(this.validationIssues),
+            apps: [],
+        };
+        if (config) {
+            // Generate app summaries
+            report.apps = config.apps.map((app) => ({
+                name: app.name,
+                script: app.script,
+                memoryLimit: app.max_memory_restart,
+                hasEnvVars: !!app.env && Object.keys(app.env).length > 0,
+                hasLogFiles: !!(app.log_file || app.out_file || app.error_file),
+            }));
+        }
+        this.lastReport = report;
+        return report;
+    }
+    /**
+     * Generate report from validation attempt
+     * @param filePath Path to configuration file
+     * @param validationFunction Function that performs validation
+     * @returns Validation report
+     */
+    async generateReportFromValidation(filePath, validationFunction) {
+        const absolutePath = path.resolve(filePath);
+        this.validationIssues = [];
+        const report = {
+            success: false,
+            filePath: absolutePath,
+            appCount: 0,
+            issues: [],
+            summary: { errors: 0, warnings: 0, infos: 0 },
+            apps: [],
+        };
+        try {
+            const config = await validationFunction();
+            // Generate app summaries
+            report.appCount = config.apps.length;
+            report.apps = config.apps.map((app) => ({
+                name: app.name,
+                script: app.script,
+                memoryLimit: app.max_memory_restart,
+                hasEnvVars: !!app.env && Object.keys(app.env).length > 0,
+                hasLogFiles: !!(app.log_file || app.out_file || app.error_file),
+            }));
+            report.success = true;
+        }
+        catch (error) {
+            // Add error to issues
+            if (error instanceof ProcmanError) {
+                this.addValidationIssue({
+                    severity: 'error',
+                    category: 'structure',
+                    message: error.message,
+                });
+            }
+            else {
+                this.addValidationIssue({
+                    severity: 'error',
+                    category: 'structure',
+                    message: `Unexpected error: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+        // Add collected issues to report
+        report.issues = [...this.validationIssues];
+        // Calculate summary
+        report.summary = this.calculateSummary(report.issues);
+        this.lastReport = report;
+        return report;
+    }
+    /**
+     * Add validation issue to collection
+     * @param issue Validation issue to add
+     */
+    addValidationIssue(issue) {
+        if (this.validationIssues.length < this.maxIssues) {
+            this.validationIssues.push(issue);
+        }
+    }
+    /**
+     * Get collected validation issues
+     * @returns Array of validation issues
+     */
+    getValidationIssues() {
+        return [...this.validationIssues];
+    }
+    /**
+     * Clear collected validation issues
+     */
+    clearValidationIssues() {
+        this.validationIssues = [];
+    }
+    /**
+     * Get last validation report
+     * @returns Last validation report or null
+     */
+    getLastReport() {
+        return this.lastReport;
+    }
+    /**
+     * Calculate summary statistics from issues
+     * @param issues Array of validation issues
+     * @returns Summary object with counts
+     */
+    calculateSummary(issues) {
+        const summary = { errors: 0, warnings: 0, infos: 0 };
+        for (const issue of issues) {
+            switch (issue.severity) {
+                case 'error':
+                    summary.errors++;
+                    break;
+                case 'warning':
+                    summary.warnings++;
+                    break;
+                case 'info':
+                    summary.infos++;
+                    break;
+            }
+        }
+        return summary;
+    }
+    /**
+     * Create enhanced validation error with suggestions
+     * @param originalError Original error
+     * @param issues Validation issues
+     * @returns Enhanced validation error
+     */
+    createEnhancedValidationError(originalError, issues = []) {
+        const suggestions = this.includeSuggestions
+            ? this.generateSuggestions(originalError.code, originalError.details?.field)
+            : [];
+        const enhancedError = originalError;
+        enhancedError.suggestions = suggestions;
+        enhancedError.validationIssues = [...issues];
+        return enhancedError;
+    }
+    /**
+     * Generate suggestions for validation errors
+     * @param errorCode Error code
+     * @param field Field name (optional)
+     * @returns Array of suggestions
+     */
+    generateSuggestions(errorCode, field) {
+        const suggestions = [];
+        switch (errorCode) {
+            case 'CONFIG_VALIDATION_ERROR':
+                if (field === 'name') {
+                    suggestions.push('Use only alphanumeric characters, dashes, and underscores');
+                    suggestions.push('Ensure the name is unique across all apps');
+                }
+                else if (field === 'script') {
+                    suggestions.push('Provide the full command to execute');
+                    suggestions.push('Use absolute paths for executables if needed');
+                }
+                else if (field === 'max_memory_restart') {
+                    suggestions.push('Use format like "300M", "1G", or "512000K"');
+                    suggestions.push('Ensure the unit (K/M/G) is specified');
+                }
+                break;
+            case 'CONFIG_SECURITY_ERROR':
+                suggestions.push('Use relative paths within the project directory');
+                suggestions.push('Avoid ".." in paths to prevent directory traversal');
+                suggestions.push('Use absolute paths only when explicitly needed');
+                break;
+            case 'CONFIG_FILE_ERROR':
+                suggestions.push('Ensure the configuration file exists');
+                suggestions.push('Check file permissions for read access');
+                suggestions.push('Verify the file has .js extension');
+                break;
+            default:
+                suggestions.push('Check the configuration documentation');
+                suggestions.push('Verify all required fields are present');
+        }
+        return suggestions;
+    }
+    /**
+     * Format validation report as human-readable text
+     * @param report Validation report to format
+     * @returns Formatted report text
+     */
+    formatReport(report) {
+        const lines = [];
+        lines.push(`Configuration Validation Report`);
+        lines.push(`==============================`);
+        lines.push(`File: ${report.filePath}`);
+        lines.push(`Status: ${report.success ? 'VALID' : 'INVALID'}`);
+        lines.push(`Apps: ${report.appCount}`);
+        lines.push('');
+        if (report.summary.errors > 0 ||
+            report.summary.warnings > 0 ||
+            report.summary.infos > 0) {
+            lines.push(`Summary: ${report.summary.errors} errors, ${report.summary.warnings} warnings, ${report.summary.infos} info`);
+            lines.push('');
+        }
+        if (report.issues.length > 0) {
+            lines.push('Issues:');
+            lines.push('-------');
+            for (const issue of report.issues) {
+                const location = issue.location
+                    ? ` (app[${issue.location.appIndex}]${issue.location.field ? `.${issue.location.field}` : ''})`
+                    : '';
+                lines.push(`[${issue.severity.toUpperCase()}] ${issue.message}${location}`);
+                if (issue.suggestion && this.includeSuggestions) {
+                    lines.push(`  Suggestion: ${issue.suggestion}`);
+                }
+                lines.push('');
+            }
+        }
+        if (report.success && report.apps.length > 0) {
+            lines.push('Apps:');
+            lines.push('-----');
+            for (const app of report.apps) {
+                lines.push(`• ${app.name}: ${app.script}`);
+                const details = [];
+                if (app.memoryLimit)
+                    details.push(`memory: ${app.memoryLimit}`);
+                if (app.hasEnvVars)
+                    details.push('env vars');
+                if (app.hasLogFiles)
+                    details.push('log files');
+                if (details.length > 0) {
+                    lines.push(`  (${details.join(', ')})`);
+                }
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format validation report as JSON
+     * @param report Validation report to format
+     * @param pretty Whether to pretty-print JSON (default: false)
+     * @returns JSON string
+     */
+    formatReportAsJson(report, pretty = false) {
+        return JSON.stringify(report, null, pretty ? 2 : undefined);
+    }
+    /**
+     * Set whether to include suggestions in reports
+     * @param include Whether to include suggestions
+     */
+    setIncludeSuggestions(include) {
+        this.includeSuggestions = include;
+    }
+    /**
+     * Get whether suggestions are included in reports
+     * @returns True if suggestions are included
+     */
+    isIncludingSuggestions() {
+        return this.includeSuggestions;
+    }
+    /**
+     * Set maximum number of issues to collect
+     * @param maxIssues Maximum number of issues
+     */
+    setMaxIssues(maxIssues) {
+        this.maxIssues = Math.max(1, maxIssues);
+    }
+    /**
+     * Get maximum number of issues to collect
+     * @returns Maximum number of issues
+     */
+    getMaxIssues() {
+        return this.maxIssues;
+    }
+}
+/**
+ * Create a new configuration reporter instance
+ * @param options Reporter options
+ * @returns ConfigReporter instance
+ */
+export function createConfigReporter(options) {
+    return new ConfigReporter(options);
+}
+//# sourceMappingURL=config-reporter.js.map

package/dist/src/config/config-reporter.js.map

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

package/dist/src/config/config-validator.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Configuration Validator
+ *
+ * Handles validation logic for procman configuration files.
+ * Provides comprehensive validation with detailed error reporting and suggestions.
+ */
+import { ProcmanConfig } from '../shared/config.js';
+/**
+ * Validation issue severity levels
+ */
+export type ValidationSeverity = 'error' | 'warning' | 'info';
+/**
+ * Validation issue details
+ */
+export interface ValidationIssue {
+    /** Issue severity level */
+    severity: ValidationSeverity;
+    /** Issue category */
+    category: 'structure' | 'security' | 'performance' | 'compatibility';
+    /** Issue message */
+    message: string;
+    /** Location of the issue */
+    location?: {
+        appIndex?: number;
+        field?: string;
+        value?: string;
+    };
+    /** Suggested fix */
+    suggestion?: string;
+}
+/**
+ * Configuration validator options
+ */
+export interface ConfigValidatorOptions {
+    /** Project root path for security validation */
+    projectRoot?: string;
+    /** Whether to collect validation issues for reporting (default: false) */
+    collectIssues?: boolean;
+}
+/**
+ * Configuration validator class
+ * Responsible for validating procman configuration structure and content
+ */
+export declare class ConfigValidator {
+    private projectRoot;
+    private collectIssues;
+    private validationIssues;
+    constructor(options?: ConfigValidatorOptions);
+    /**
+     * Validate configuration structure and content
+     * @param config Configuration object to validate
+     * @throws ProcmanError if validation fails
+     */
+    validateConfig(config: unknown): asserts config is ProcmanConfig;
+    /**
+     * Validate individual app configuration
+     * @param app App configuration to validate
+     * @param index Index in the apps array (for error reporting)
+     * @param appNames Set to track duplicate names
+     * @throws ProcmanError if validation fails
+     */
+    validateAppConfig(app: unknown, index: number, appNames: Set<string>): void;
+    /**
+     * Validate required field exists and has correct type
+     * @param obj Object to validate
+     * @param field Field name
+     * @param expectedType Expected type
+     * @param appIndex App index for error reporting
+     * @throws ProcmanError if validation fails
+     */
+    private validateRequiredField;
+    /**
+     * Validate optional field has correct type if present
+     * @param obj Object to validate
+     * @param field Field name
+     * @param expectedType Expected type
+     * @param appIndex App index for error reporting
+     * @throws ProcmanError if validation fails
+     */
+    private validateOptionalField;
+    /**
+     * Validate environment variables object
+     * @param env Environment variables object
+     * @param appIndex App index for error reporting
+     * @throws ProcmanError if validation fails
+     */
+    private validateEnvObject;
+    /**
+     * Validate memory size format and convert to bytes
+     * @param memorySize Memory size string (e.g., "300M", "1G")
+     * @param appIndex App index for error reporting
+     * @throws ProcmanError if validation fails
+     */
+    validateMemorySize(memorySize: string, appIndex: number): void;
+    /**
+     * Validate script path for security issues
+     * @param scriptPath Script path to validate
+     * @param appIndex App index for error reporting
+     */
+    private validateScriptPathSecurity;
+    /**
+     * Validate file path for security issues
+     * @param filePath File path to validate
+     * @param appIndex App index for error reporting
+     * @param fieldName Field name for error reporting
+     */
+    private validatePathSecurity;
+    /**
+     * Add validation issue to collection (if enabled)
+     * @param issue Validation issue to add
+     */
+    private addValidationIssue;
+    /**
+     * Get collected validation issues
+     * @returns Array of validation issues
+     */
+    getValidationIssues(): ValidationIssue[];
+    /**
+     * Clear collected validation issues
+     */
+    clearValidationIssues(): void;
+    /**
+     * Sanitize file path to prevent path traversal attacks
+     * @param filePath File path to sanitize
+     * @returns Sanitized file path
+     * @throws ProcmanError if path is potentially malicious
+     */
+    private sanitizeFilePath;
+    /**
+     * Validate that a path stays within the project boundaries
+     * @param filePath File path to validate (relative)
+     * @param basePath Base path to resolve against
+     * @returns Resolved absolute path
+     * @throws ProcmanError if path escapes project boundaries
+     */
+    private validatePathWithinProject;
+    /**
+     * Generate suggestions for validation errors
+     * @param errorCode Error code
+     * @param field Field name (optional)
+     * @returns Array of suggestions
+     */
+    generateSuggestions(errorCode: string, field?: string): string[];
+    /**
+     * Enhanced type guard for configuration objects
+     * @param config Unknown input to validate
+     * @returns Type predicate indicating if config is a valid object
+     */
+    private isValidConfigObject;
+    /**
+     * Generate detailed error message for invalid config types
+     * @param config Invalid config to analyze
+     * @returns Descriptive error message
+     */
+    private getConfigTypeErrorMessage;
+}
+/**
+ * Create a new configuration validator instance
+ * @param options Validator options
+ * @returns ConfigValidator instance
+ */
+export declare function createConfigValidator(options?: ConfigValidatorOptions): ConfigValidator;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/src/config/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../../src/config/config-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAmB,MAAM,qBAAqB,CAAC;AAGrE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,qBAAqB;IACrB,QAAQ,EAAE,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;IACrE,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,oBAAoB;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,gBAAgB,CAAyB;gBAErC,OAAO,GAAE,sBAA2B;IAKhD;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa;IA0ChE;;;;;;OAMG;IACH,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAwG3E;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;;;OAKG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA+B9D;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IA2BlC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;OAGG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAIxC;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAI7B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA6CxB;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IA4BjC;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAiChE;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;CA+BlC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,eAAe,CAEjB"}