@masuidrive/procman 0.1.0

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

@@ -0,0 +1,135 @@
+/**
+ * Configuration Normalizer
+ *
+ * Handles normalization logic for procman configuration files.
+ * Applies default values, normalizes paths, and expands environment variables.
+ */
+import { ProcmanConfig, AppConfig } from '../shared/config.js';
+/**
+ * Normalized configuration after applying defaults and path normalization
+ */
+export interface NormalizedConfig {
+    apps: AppConfig[];
+    _metadata: {
+        originalPath: string;
+        normalizedPath: string;
+        normalizedAt: number;
+        defaultsApplied: string[];
+    };
+}
+/**
+ * Configuration normalizer options
+ */
+export interface ConfigNormalizerOptions {
+    /** Base directory for resolving relative paths (default: process.cwd()) */
+    baseDirectory?: string;
+    /** Whether to expand environment variables (default: true) */
+    expandEnvironmentVariables?: boolean;
+}
+/**
+ * Configuration normalizer class
+ * Responsible for applying defaults and normalizing procman configuration
+ */
+export declare class ConfigNormalizer {
+    private baseDirectory;
+    private expandEnvVars;
+    constructor(options?: ConfigNormalizerOptions);
+    /**
+     * Apply default values and normalize paths
+     * @param config Configuration to normalize
+     * @param originalPath Original configuration file path
+     * @returns Normalized configuration
+     */
+    normalizeConfig(config: ProcmanConfig, originalPath: string): NormalizedConfig;
+    /**
+     * Apply only default values without path normalization
+     * @param config Configuration to apply defaults to
+     * @param originalPath Original configuration file path
+     * @returns Configuration with defaults applied
+     */
+    applyDefaults(config: ProcmanConfig, originalPath: string): ProcmanConfig;
+    /**
+     * Normalize file paths (relative to absolute conversion)
+     * @param filePath File path to normalize
+     * @param basePath Base path to resolve relative paths against
+     * @returns Normalized absolute path
+     */
+    normalizePath(filePath: string, basePath: string): string;
+    /**
+     * Expand environment variables in environment configuration
+     * @param env Environment variables object
+     * @returns Environment variables with expanded values
+     */
+    expandEnvironmentVariables(env: Record<string, string>): Record<string, string>;
+    /**
+     * Convert relative paths to absolute based on a base directory
+     * @param config Configuration to resolve paths for
+     * @param baseDir Base directory for path resolution
+     * @returns Configuration with resolved paths
+     */
+    resolvePaths(config: ProcmanConfig, baseDir: string): ProcmanConfig;
+    /**
+     * Merge two configurations, with the second overriding the first
+     * @param base Base configuration
+     * @param override Configuration to merge in
+     * @returns Merged configuration
+     */
+    mergeConfigs(base: ProcmanConfig, override: Partial<ProcmanConfig>): ProcmanConfig;
+    /**
+     * Deep clone configuration to avoid mutations
+     * @param config Configuration to clone
+     * @returns Cloned configuration
+     */
+    cloneConfig(config: ProcmanConfig): ProcmanConfig;
+    /**
+     * Validate that all required defaults have been applied
+     * @param config Configuration to validate
+     * @returns True if all defaults are present
+     */
+    hasAllDefaults(config: ProcmanConfig): boolean;
+    /**
+     * Set base directory for path resolution
+     * @param baseDirectory New base directory
+     */
+    setBaseDirectory(baseDirectory: string): void;
+    /**
+     * Get current base directory
+     * @returns Current base directory
+     */
+    getBaseDirectory(): string;
+    /**
+     * Enable or disable environment variable expansion
+     * @param enable Whether to enable expansion
+     */
+    setExpandEnvironmentVariables(enable: boolean): void;
+    /**
+     * Check if environment variable expansion is enabled
+     * @returns True if expansion is enabled
+     */
+    isExpandEnvironmentVariablesEnabled(): boolean;
+    /**
+     * Save normalized configuration to file
+     * @param config Normalized configuration to save
+     * @param outputPath Output file path
+     */
+    saveNormalizedConfig(config: NormalizedConfig, outputPath: string): Promise<void>;
+    /**
+     * Compare two configurations and return differences
+     * @param config1 First configuration
+     * @param config2 Second configuration
+     * @returns Array of differences
+     */
+    compareConfigs(config1: ProcmanConfig, config2: ProcmanConfig): Array<{
+        type: 'added' | 'removed' | 'modified';
+        path: string;
+        oldValue?: unknown;
+        newValue?: unknown;
+    }>;
+}
+/**
+ * Create a new configuration normalizer instance
+ * @param options Normalizer options
+ * @returns ConfigNormalizer instance
+ */
+export declare function createConfigNormalizer(options?: ConfigNormalizerOptions): ConfigNormalizer;
+//# sourceMappingURL=config-normalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-normalizer.d.ts","sourceRoot":"","sources":["../../../src/config/config-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAU;gBAEnB,OAAO,GAAE,uBAA4B;IAKjD;;;;;OAKG;IACH,eAAe,CACb,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,GACnB,gBAAgB;IA2DnB;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa;IAwBzE;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAOzD;;;;OAIG;IACH,0BAA0B,CACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAyBzB;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;IA8BnE;;;;;OAKG;IACH,YAAY,CACV,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAC/B,aAAa;IAkChB;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa;IASjD;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAM9C;;;OAGG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAI7C;;;OAGG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;OAGG;IACH,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpD;;;OAGG;IACH,mCAAmC,IAAI,OAAO;IAI9C;;;;OAIG;IACG,oBAAoB,CACxB,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;OAKG;IACH,cAAc,CACZ,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,GACrB,KAAK,CAAC;QACP,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;QACvC,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CA4CH;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,uBAAuB,GAChC,gBAAgB,CAElB"}

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

@@ -0,0 +1,309 @@
+/**
+ * Configuration Normalizer
+ *
+ * Handles normalization logic for procman configuration files.
+ * Applies default values, normalizes paths, and expands environment variables.
+ */
+import * as path from 'path';
+/**
+ * Configuration normalizer class
+ * Responsible for applying defaults and normalizing procman configuration
+ */
+export class ConfigNormalizer {
+    baseDirectory;
+    expandEnvVars;
+    constructor(options = {}) {
+        this.baseDirectory = options.baseDirectory || process.cwd();
+        this.expandEnvVars = options.expandEnvironmentVariables !== false;
+    }
+    /**
+     * Apply default values and normalize paths
+     * @param config Configuration to normalize
+     * @param originalPath Original configuration file path
+     * @returns Normalized configuration
+     */
+    normalizeConfig(config, originalPath) {
+        const defaultsApplied = [];
+        const configDir = path.dirname(path.resolve(originalPath));
+        const normalizedApps = config.apps.map((app, index) => {
+            const normalizedApp = { ...app };
+            // Apply defaults
+            if (!normalizedApp.cwd) {
+                normalizedApp.cwd = configDir;
+                defaultsApplied.push(`apps[${index}].cwd`);
+            }
+            if (!normalizedApp.env) {
+                normalizedApp.env = {};
+                defaultsApplied.push(`apps[${index}].env`);
+            }
+            // Normalize paths
+            normalizedApp.cwd = this.normalizePath(normalizedApp.cwd, configDir);
+            if (normalizedApp.log_file) {
+                normalizedApp.log_file = this.normalizePath(normalizedApp.log_file, configDir);
+            }
+            if (normalizedApp.out_file) {
+                normalizedApp.out_file = this.normalizePath(normalizedApp.out_file, configDir);
+            }
+            if (normalizedApp.error_file) {
+                normalizedApp.error_file = this.normalizePath(normalizedApp.error_file, configDir);
+            }
+            // Expand environment variables
+            if (this.expandEnvVars && normalizedApp.env) {
+                normalizedApp.env = this.expandEnvironmentVariables(normalizedApp.env);
+            }
+            return normalizedApp;
+        });
+        return {
+            apps: normalizedApps,
+            _metadata: {
+                originalPath,
+                normalizedPath: originalPath,
+                normalizedAt: Date.now(),
+                defaultsApplied,
+            },
+        };
+    }
+    /**
+     * Apply only default values without path normalization
+     * @param config Configuration to apply defaults to
+     * @param originalPath Original configuration file path
+     * @returns Configuration with defaults applied
+     */
+    applyDefaults(config, originalPath) {
+        const configDir = path.dirname(path.resolve(originalPath));
+        const appsWithDefaults = config.apps.map((app) => {
+            const appWithDefaults = { ...app };
+            // Apply defaults
+            if (!appWithDefaults.cwd) {
+                appWithDefaults.cwd = configDir;
+            }
+            if (!appWithDefaults.env) {
+                appWithDefaults.env = {};
+            }
+            return appWithDefaults;
+        });
+        return {
+            ...config,
+            apps: appsWithDefaults,
+        };
+    }
+    /**
+     * Normalize file paths (relative to absolute conversion)
+     * @param filePath File path to normalize
+     * @param basePath Base path to resolve relative paths against
+     * @returns Normalized absolute path
+     */
+    normalizePath(filePath, basePath) {
+        if (path.isAbsolute(filePath)) {
+            return path.normalize(filePath);
+        }
+        return path.normalize(path.join(basePath, filePath));
+    }
+    /**
+     * Expand environment variables in environment configuration
+     * @param env Environment variables object
+     * @returns Environment variables with expanded values
+     */
+    expandEnvironmentVariables(env) {
+        const expanded = {};
+        for (const [key, value] of Object.entries(env)) {
+            // Simple environment variable expansion
+            let expandedValue = value;
+            // Replace ${VAR} and $VAR patterns
+            expandedValue = expandedValue.replace(/\$\{([^}]+)\}/g, (_, varName) => {
+                return process.env[varName] || `\${${varName}}`;
+            });
+            expandedValue = expandedValue.replace(/\$([A-Z_][A-Z0-9_]*)/g, (_, varName) => {
+                return process.env[varName] || `$${varName}`;
+            });
+            expanded[key] = expandedValue;
+        }
+        return expanded;
+    }
+    /**
+     * Convert relative paths to absolute based on a base directory
+     * @param config Configuration to resolve paths for
+     * @param baseDir Base directory for path resolution
+     * @returns Configuration with resolved paths
+     */
+    resolvePaths(config, baseDir) {
+        const resolvedApps = config.apps.map((app) => {
+            const resolvedApp = { ...app };
+            // Resolve paths if they are relative
+            if (resolvedApp.cwd && !path.isAbsolute(resolvedApp.cwd)) {
+                resolvedApp.cwd = path.resolve(baseDir, resolvedApp.cwd);
+            }
+            if (resolvedApp.log_file && !path.isAbsolute(resolvedApp.log_file)) {
+                resolvedApp.log_file = path.resolve(baseDir, resolvedApp.log_file);
+            }
+            if (resolvedApp.out_file && !path.isAbsolute(resolvedApp.out_file)) {
+                resolvedApp.out_file = path.resolve(baseDir, resolvedApp.out_file);
+            }
+            if (resolvedApp.error_file && !path.isAbsolute(resolvedApp.error_file)) {
+                resolvedApp.error_file = path.resolve(baseDir, resolvedApp.error_file);
+            }
+            return resolvedApp;
+        });
+        return {
+            ...config,
+            apps: resolvedApps,
+        };
+    }
+    /**
+     * Merge two configurations, with the second overriding the first
+     * @param base Base configuration
+     * @param override Configuration to merge in
+     * @returns Merged configuration
+     */
+    mergeConfigs(base, override) {
+        const mergedApps = [...base.apps];
+        // If override has apps, merge them by name
+        if (override.apps) {
+            for (const overrideApp of override.apps) {
+                const existingIndex = mergedApps.findIndex((app) => app.name === overrideApp.name);
+                if (existingIndex !== -1) {
+                    // Merge existing app
+                    mergedApps[existingIndex] = {
+                        ...mergedApps[existingIndex],
+                        ...overrideApp,
+                        env: {
+                            ...mergedApps[existingIndex].env,
+                            ...overrideApp.env,
+                        },
+                    };
+                }
+                else {
+                    // Add new app
+                    mergedApps.push(overrideApp);
+                }
+            }
+        }
+        return {
+            ...base,
+            ...override,
+            apps: mergedApps,
+        };
+    }
+    /**
+     * Deep clone configuration to avoid mutations
+     * @param config Configuration to clone
+     * @returns Cloned configuration
+     */
+    cloneConfig(config) {
+        return {
+            apps: config.apps.map((app) => ({
+                ...app,
+                env: app.env ? { ...app.env } : undefined,
+            })),
+        };
+    }
+    /**
+     * Validate that all required defaults have been applied
+     * @param config Configuration to validate
+     * @returns True if all defaults are present
+     */
+    hasAllDefaults(config) {
+        return config.apps.every((app) => {
+            return app.cwd !== undefined && app.env !== undefined;
+        });
+    }
+    /**
+     * Set base directory for path resolution
+     * @param baseDirectory New base directory
+     */
+    setBaseDirectory(baseDirectory) {
+        this.baseDirectory = baseDirectory;
+    }
+    /**
+     * Get current base directory
+     * @returns Current base directory
+     */
+    getBaseDirectory() {
+        return this.baseDirectory;
+    }
+    /**
+     * Enable or disable environment variable expansion
+     * @param enable Whether to enable expansion
+     */
+    setExpandEnvironmentVariables(enable) {
+        this.expandEnvVars = enable;
+    }
+    /**
+     * Check if environment variable expansion is enabled
+     * @returns True if expansion is enabled
+     */
+    isExpandEnvironmentVariablesEnabled() {
+        return this.expandEnvVars;
+    }
+    /**
+     * Save normalized configuration to file
+     * @param config Normalized configuration to save
+     * @param outputPath Output file path
+     */
+    async saveNormalizedConfig(config, outputPath) {
+        const configToSave = {
+            apps: config.apps,
+            // Don't save metadata
+        };
+        const configContent = `// Generated normalized configuration
+// Original: ${config._metadata.originalPath}
+// Normalized at: ${new Date(config._metadata.normalizedAt).toISOString()}
+// Defaults applied: ${config._metadata.defaultsApplied.join(', ') || 'none'}
+
+module.exports = ${JSON.stringify(configToSave, null, 2)};
+`;
+        const fs = await import('fs');
+        await fs.promises.writeFile(outputPath, configContent, 'utf8');
+    }
+    /**
+     * Compare two configurations and return differences
+     * @param config1 First configuration
+     * @param config2 Second configuration
+     * @returns Array of differences
+     */
+    compareConfigs(config1, config2) {
+        const differences = [];
+        // Create Maps for O(1) lookup instead of O(n) with Array.find()
+        const apps1Map = new Map(config1.apps.map((app) => [app.name, app]));
+        const apps2Map = new Map(config2.apps.map((app) => [app.name, app]));
+        // Find added apps
+        for (const [appName, app] of Array.from(apps2Map.entries())) {
+            if (!apps1Map.has(appName)) {
+                differences.push({
+                    type: 'added',
+                    path: `apps.${appName}`,
+                    newValue: app,
+                });
+            }
+        }
+        // Find removed and modified apps
+        for (const [appName, app1] of Array.from(apps1Map.entries())) {
+            const app2 = apps2Map.get(appName);
+            if (!app2) {
+                differences.push({
+                    type: 'removed',
+                    path: `apps.${appName}`,
+                    oldValue: app1,
+                });
+            }
+            else if (JSON.stringify(app1) !== JSON.stringify(app2)) {
+                differences.push({
+                    type: 'modified',
+                    path: `apps.${appName}`,
+                    oldValue: app1,
+                    newValue: app2,
+                });
+            }
+        }
+        return differences;
+    }
+}
+/**
+ * Create a new configuration normalizer instance
+ * @param options Normalizer options
+ * @returns ConfigNormalizer instance
+ */
+export function createConfigNormalizer(options) {
+    return new ConfigNormalizer(options);
+}
+//# sourceMappingURL=config-normalizer.js.map

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

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

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

@@ -0,0 +1,183 @@
+/**
+ * Configuration Reporter
+ *
+ * Handles reporting logic for procman configuration validation.
+ * Provides detailed validation reports and error tracking.
+ */
+import { ProcmanConfig } from '../shared/config.js';
+import { ProcmanError } from '../shared/errors.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 validation report
+ */
+export interface ValidationReport {
+    /** Whether validation passed */
+    success: boolean;
+    /** Configuration file path */
+    filePath: string;
+    /** Total number of apps */
+    appCount: number;
+    /** List of validation issues */
+    issues: ValidationIssue[];
+    /** Summary statistics */
+    summary: {
+        errors: number;
+        warnings: number;
+        infos: number;
+    };
+    /** Apps summary */
+    apps: Array<{
+        name: string;
+        script: string;
+        memoryLimit?: string;
+        hasEnvVars: boolean;
+        hasLogFiles: boolean;
+    }>;
+}
+/**
+ * Enhanced validation error with suggestions
+ */
+export interface EnhancedValidationError extends ProcmanError {
+    suggestions: string[];
+    validationIssues: ValidationIssue[];
+}
+/**
+ * Configuration reporter options
+ */
+export interface ConfigReporterOptions {
+    /** Whether to include detailed suggestions (default: true) */
+    includeSuggestions?: boolean;
+    /** Maximum number of issues to collect (default: 100) */
+    maxIssues?: number;
+}
+/**
+ * Configuration reporter class
+ * Responsible for generating validation reports and error messages
+ */
+export declare class ConfigReporter {
+    private includeSuggestions;
+    private maxIssues;
+    private validationIssues;
+    private lastReport;
+    constructor(options?: ConfigReporterOptions);
+    /**
+     * 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: ProcmanConfig | null, filePath: string, issues?: ValidationIssue[]): ValidationReport;
+    /**
+     * Generate report from validation attempt
+     * @param filePath Path to configuration file
+     * @param validationFunction Function that performs validation
+     * @returns Validation report
+     */
+    generateReportFromValidation(filePath: string, validationFunction: () => Promise<ProcmanConfig>): Promise<ValidationReport>;
+    /**
+     * Add validation issue to collection
+     * @param issue Validation issue to add
+     */
+    addValidationIssue(issue: ValidationIssue): void;
+    /**
+     * Get collected validation issues
+     * @returns Array of validation issues
+     */
+    getValidationIssues(): ValidationIssue[];
+    /**
+     * Clear collected validation issues
+     */
+    clearValidationIssues(): void;
+    /**
+     * Get last validation report
+     * @returns Last validation report or null
+     */
+    getLastReport(): ValidationReport | null;
+    /**
+     * Calculate summary statistics from issues
+     * @param issues Array of validation issues
+     * @returns Summary object with counts
+     */
+    calculateSummary(issues: ValidationIssue[]): {
+        errors: number;
+        warnings: number;
+        infos: number;
+    };
+    /**
+     * Create enhanced validation error with suggestions
+     * @param originalError Original error
+     * @param issues Validation issues
+     * @returns Enhanced validation error
+     */
+    createEnhancedValidationError(originalError: ProcmanError, issues?: ValidationIssue[]): EnhancedValidationError;
+    /**
+     * Generate suggestions for validation errors
+     * @param errorCode Error code
+     * @param field Field name (optional)
+     * @returns Array of suggestions
+     */
+    generateSuggestions(errorCode: string, field?: string): string[];
+    /**
+     * Format validation report as human-readable text
+     * @param report Validation report to format
+     * @returns Formatted report text
+     */
+    formatReport(report: ValidationReport): string;
+    /**
+     * 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: ValidationReport, pretty?: boolean): string;
+    /**
+     * Set whether to include suggestions in reports
+     * @param include Whether to include suggestions
+     */
+    setIncludeSuggestions(include: boolean): void;
+    /**
+     * Get whether suggestions are included in reports
+     * @returns True if suggestions are included
+     */
+    isIncludingSuggestions(): boolean;
+    /**
+     * Set maximum number of issues to collect
+     * @param maxIssues Maximum number of issues
+     */
+    setMaxIssues(maxIssues: number): void;
+    /**
+     * Get maximum number of issues to collect
+     * @returns Maximum number of issues
+     */
+    getMaxIssues(): number;
+}
+/**
+ * Create a new configuration reporter instance
+ * @param options Reporter options
+ * @returns ConfigReporter instance
+ */
+export declare function createConfigReporter(options?: ConfigReporterOptions): ConfigReporter;
+//# sourceMappingURL=config-reporter.d.ts.map

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

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