configforge 1.0.0-beta.11 → 1.0.0-beta.13

package/dist/plugins/built-in/AuditPlugin.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditPlugin = void 0;
+exports.createAuditPlugin = createAuditPlugin;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Plugin that logs conversion activities for auditing
+ */
+class AuditPlugin {
+    constructor(options = {}) {
+        this.name = 'audit-plugin';
+        this.version = '1.0.0';
+        this.description = 'Log conversion activities for auditing and compliance';
+        this.author = 'ConfigForge Team';
+        this.startTime = 0;
+        this.logEntries = [];
+        this.hooks = {
+            beforeParse: async (content, format, context) => {
+                this.startTime = Date.now();
+                this.logEvent('conversion_started', context, {
+                    format,
+                    contentLength: content.length,
+                    inputFile: context.metadata.inputFile,
+                });
+                return content;
+            },
+            afterParse: async (data, context) => {
+                this.logEvent('parse_completed', context, {
+                    fieldsCount: this.countFields(data),
+                    dataSize: JSON.stringify(data).length,
+                });
+                return data;
+            },
+            beforeMap: async (source, context) => {
+                this.logEvent('mapping_started', context, {
+                    sourceFields: this.countFields(source),
+                });
+                return source;
+            },
+            afterMap: async (target, context) => {
+                this.logEvent('mapping_completed', context, {
+                    targetFields: this.countFields(target),
+                    mappedFields: this.countFields(target),
+                });
+                return target;
+            },
+            beforeValidate: async (data, context) => {
+                this.logEvent('validation_started', context, {
+                    fieldsToValidate: this.countFields(data),
+                });
+                return data;
+            },
+            afterValidate: async (_data, errors, context) => {
+                this.logEvent('validation_completed', context, {
+                    errorsCount: errors.length,
+                    validationPassed: errors.length === 0,
+                    errors: this.options.logLevel === 'verbose' ? errors : undefined,
+                });
+            },
+            afterSerialize: async (content, format, context) => {
+                const duration = Date.now() - this.startTime;
+                this.logEvent('conversion_completed', context, {
+                    format,
+                    outputLength: content.length,
+                    totalDuration: duration,
+                    success: true,
+                }, duration);
+                // Write accumulated logs
+                await this.flushLogs();
+                return content;
+            },
+            onError: async (error, context) => {
+                const duration = this.startTime ? Date.now() - this.startTime : 0;
+                this.logEvent('conversion_failed', context, {
+                    error: error.message,
+                    stack: this.options.logLevel === 'verbose' ? error.stack : undefined,
+                    totalDuration: duration,
+                    success: false,
+                }, duration);
+                // Write logs immediately on error
+                await this.flushLogs();
+            },
+        };
+        this.options = {
+            logFile: './audit.log',
+            logLevel: 'detailed',
+            includeData: false,
+            maxLogSize: 10 * 1024 * 1024, // 10MB
+            rotateDaily: true,
+            ...options,
+        };
+    }
+    async install(context) {
+        // Ensure log directory exists
+        const logDir = (0, path_1.join)(this.options.logFile, '..');
+        if (!(0, fs_1.existsSync)(logDir)) {
+            (0, fs_1.mkdirSync)(logDir, { recursive: true });
+        }
+        this.logEvent('plugin_installed', context, {
+            pluginName: this.name,
+            options: this.options,
+        });
+        console.log(`Audit plugin installed - logs will be saved to: ${this.options.logFile}`);
+    }
+    /**
+     * Log an event
+     */
+    logEvent(event, context, metadata, duration) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            event,
+            converter: 'ConfigForge', // TODO: Get from context
+            metadata: {
+                ...metadata,
+                environment: context.environment,
+                version: context.version,
+            },
+            success: !event.includes('failed') && !event.includes('error'),
+        };
+        if (duration !== undefined) {
+            entry.duration = duration;
+        }
+        if (metadata.error) {
+            entry.error = metadata.error;
+            entry.success = false;
+        }
+        this.logEntries.push(entry);
+        // Log to console in verbose mode
+        if (this.options.logLevel === 'verbose') {
+            console.log(`[AUDIT] ${event}:`, entry);
+        }
+    }
+    /**
+     * Flush accumulated logs to file
+     */
+    async flushLogs() {
+        if (this.logEntries.length === 0) {
+            return;
+        }
+        try {
+            const logFile = this.getLogFileName();
+            // Check if we need to rotate the log
+            if (this.shouldRotateLog(logFile)) {
+                await this.rotateLog(logFile);
+            }
+            // Write entries to log file
+            for (const entry of this.logEntries) {
+                const logLine = this.formatLogEntry(entry);
+                (0, fs_1.appendFileSync)(logFile, logLine + '\n', 'utf-8');
+            }
+            this.logEntries = [];
+        }
+        catch (error) {
+            console.error('Failed to write audit log:', error);
+        }
+    }
+    /**
+     * Format log entry for file output
+     */
+    formatLogEntry(entry) {
+        if (this.options.logLevel === 'minimal') {
+            return `${entry.timestamp} ${entry.event} ${entry.success ? 'SUCCESS' : 'FAILED'}`;
+        }
+        return JSON.stringify(entry);
+    }
+    /**
+     * Get log file name with rotation if enabled
+     */
+    getLogFileName() {
+        if (!this.options.rotateDaily) {
+            return this.options.logFile;
+        }
+        const date = new Date().toISOString().split('T')[0];
+        const ext = this.options.logFile.split('.').pop();
+        const base = this.options.logFile.replace(`.${ext}`, '');
+        return `${base}.${date}.${ext}`;
+    }
+    /**
+     * Check if log should be rotated
+     */
+    shouldRotateLog(logFile) {
+        if (!(0, fs_1.existsSync)(logFile)) {
+            return false;
+        }
+        try {
+            const fs = require('fs');
+            const stats = fs.statSync(logFile);
+            return stats.size > this.options.maxLogSize;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Rotate log file
+     */
+    async rotateLog(logFile) {
+        try {
+            const fs = require('fs');
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const rotatedFile = logFile.replace(/\.log$/, `.${timestamp}.log`);
+            fs.renameSync(logFile, rotatedFile);
+            console.log(`Rotated audit log to: ${rotatedFile}`);
+        }
+        catch (error) {
+            console.error('Failed to rotate audit log:', error);
+        }
+    }
+    /**
+     * Count fields in an object recursively
+     */
+    countFields(obj) {
+        if (obj === null || obj === undefined) {
+            return 0;
+        }
+        if (typeof obj !== 'object') {
+            return 1;
+        }
+        if (Array.isArray(obj)) {
+            return obj.reduce((count, item) => count + this.countFields(item), 0);
+        }
+        return Object.keys(obj).reduce((count, key) => {
+            return count + 1 + this.countFields(obj[key]);
+        }, 0);
+    }
+}
+exports.AuditPlugin = AuditPlugin;
+/**
+ * Factory function to create audit plugin
+ */
+function createAuditPlugin(options) {
+    return new AuditPlugin(options);
+}
+//# sourceMappingURL=AuditPlugin.js.map

package/dist/plugins/built-in/AuditPlugin.js.map

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

package/dist/plugins/built-in/BackupPlugin.d.ts

@@ -0,0 +1,38 @@
+import { Plugin, PluginContext } from '../Plugin';
+/**
+ * Options for the backup plugin
+ */
+export interface BackupPluginOptions {
+    backupDir?: string;
+    maxBackups?: number;
+    includeTimestamp?: boolean;
+    compress?: boolean;
+}
+/**
+ * Plugin that automatically creates backups before conversion
+ */
+export declare class BackupPlugin implements Plugin {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    options: Required<BackupPluginOptions>;
+    constructor(options?: BackupPluginOptions);
+    install(_context: PluginContext): Promise<void>;
+    hooks: {
+        beforeParse: (content: string, _format: string, context: PluginContext) => Promise<string>;
+    };
+    /**
+     * Create a backup of the file
+     */
+    private createBackup;
+    /**
+     * Clean up old backups to maintain maxBackups limit
+     */
+    private cleanupOldBackups;
+}
+/**
+ * Factory function to create backup plugin
+ */
+export declare function createBackupPlugin(options?: BackupPluginOptions): BackupPlugin;
+//# sourceMappingURL=BackupPlugin.d.ts.map

package/dist/plugins/built-in/BackupPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackupPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/built-in/BackupPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,IAAI,SAAmB;IACvB,OAAO,SAAW;IAClB,WAAW,SAAkD;IAC7D,MAAM,SAAsB;IAC5B,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;gBAE3B,OAAO,GAAE,mBAAwB;IAUvC,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD,KAAK;+BAEQ,MAAM,WACN,MAAM,WACN,aAAa;MAQxB;IAEF;;OAEG;YACW,YAAY;IA+B1B;;OAEG;YACW,iBAAiB;CAuChC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAEd"}

package/dist/plugins/built-in/BackupPlugin.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackupPlugin = void 0;
+exports.createBackupPlugin = createBackupPlugin;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Plugin that automatically creates backups before conversion
+ */
+class BackupPlugin {
+    constructor(options = {}) {
+        this.name = 'backup-plugin';
+        this.version = '1.0.0';
+        this.description = 'Automatically backup files before conversion';
+        this.author = 'ConfigForge Team';
+        this.hooks = {
+            beforeParse: async (content, _format, context) => {
+                // Create backup of the original content
+                if (context.metadata.inputFile) {
+                    await this.createBackup(context.metadata.inputFile, content);
+                }
+                return content;
+            },
+        };
+        this.options = {
+            backupDir: './backups',
+            maxBackups: 10,
+            includeTimestamp: true,
+            compress: false,
+            ...options,
+        };
+    }
+    async install(_context) {
+        // Ensure backup directory exists
+        if (!(0, fs_1.existsSync)(this.options.backupDir)) {
+            (0, fs_1.mkdirSync)(this.options.backupDir, { recursive: true });
+        }
+        console.log(`Backup plugin installed - backups will be saved to: ${this.options.backupDir}`);
+    }
+    /**
+     * Create a backup of the file
+     */
+    async createBackup(filePath, content) {
+        const fileName = (0, path_1.basename)(filePath);
+        const fileExt = (0, path_1.extname)(filePath);
+        const baseName = (0, path_1.basename)(filePath, fileExt);
+        let backupName = fileName;
+        if (this.options.includeTimestamp) {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            backupName = `${baseName}.${timestamp}${fileExt}`;
+        }
+        const backupPath = (0, path_1.join)(this.options.backupDir, backupName);
+        try {
+            (0, fs_1.writeFileSync)(backupPath, content, 'utf-8');
+            console.log(`Created backup: ${backupPath}`);
+            // Clean up old backups if needed
+            await this.cleanupOldBackups(baseName, fileExt);
+            return backupPath;
+        }
+        catch (error) {
+            console.error('Failed to create backup:', error);
+            throw error;
+        }
+    }
+    /**
+     * Clean up old backups to maintain maxBackups limit
+     */
+    async cleanupOldBackups(baseName, fileExt) {
+        if (this.options.maxBackups <= 0) {
+            return;
+        }
+        try {
+            const fs = require('fs');
+            const files = fs.readdirSync(this.options.backupDir);
+            // Filter files that match our backup pattern
+            const backupFiles = files
+                .filter((file) => file.startsWith(baseName) && file.endsWith(fileExt))
+                .map((file) => ({
+                name: file,
+                path: (0, path_1.join)(this.options.backupDir, file),
+                stats: fs.statSync((0, path_1.join)(this.options.backupDir, file)),
+            }))
+                .sort((a, b) => b.stats.mtime.getTime() - a.stats.mtime.getTime());
+            // Remove excess backups
+            if (backupFiles.length > this.options.maxBackups) {
+                const filesToDelete = backupFiles.slice(this.options.maxBackups);
+                for (const file of filesToDelete) {
+                    fs.unlinkSync(file.path);
+                    console.log(`Removed old backup: ${file.name}`);
+                }
+            }
+        }
+        catch (error) {
+            console.error('Error cleaning up old backups:', error);
+        }
+    }
+}
+exports.BackupPlugin = BackupPlugin;
+/**
+ * Factory function to create backup plugin
+ */
+function createBackupPlugin(options) {
+    return new BackupPlugin(options);
+}
+//# sourceMappingURL=BackupPlugin.js.map

package/dist/plugins/built-in/BackupPlugin.js.map

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

package/dist/plugins/built-in/ValidationPlugin.d.ts

@@ -0,0 +1,61 @@
+import { Plugin, PluginContext } from '../Plugin';
+/**
+ * Validation rule definition
+ */
+export interface ValidationRule {
+    name: string;
+    description: string;
+    validate: (value: any, path: string, data: any) => boolean | string;
+    severity: 'error' | 'warning' | 'info';
+}
+/**
+ * Options for the validation plugin
+ */
+export interface ValidationPluginOptions {
+    rules?: ValidationRule[];
+    strictMode?: boolean;
+    failOnWarnings?: boolean;
+    customRules?: Record<string, ValidationRule>;
+}
+/**
+ * Plugin that adds enhanced validation capabilities
+ */
+export declare class ValidationPlugin implements Plugin {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    options: Required<ValidationPluginOptions>;
+    private validationResults;
+    constructor(options?: ValidationPluginOptions);
+    install(_context: PluginContext): Promise<void>;
+    hooks: {
+        afterMap: (target: any, context: PluginContext) => Promise<any>;
+        afterValidate: (_data: any, errors: any[], _context: PluginContext) => Promise<void>;
+    };
+    /**
+     * Add a custom validation rule
+     */
+    addRule(rule: ValidationRule): void;
+    /**
+     * Remove a validation rule by name
+     */
+    removeRule(name: string): boolean;
+    /**
+     * Validate data against all rules
+     */
+    private validateData;
+    /**
+     * Report validation results
+     */
+    private reportValidationResults;
+    /**
+     * Add built-in validation rules
+     */
+    private addBuiltInRules;
+}
+/**
+ * Factory function to create validation plugin
+ */
+export declare function createValidationPlugin(options?: ValidationPluginOptions): ValidationPlugin;
+//# sourceMappingURL=ValidationPlugin.d.ts.map

package/dist/plugins/built-in/ValidationPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/built-in/ValidationPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,GAAG,MAAM,CAAC;IACpE,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,IAAI,SAAuB;IAC3B,OAAO,SAAW;IAClB,WAAW,SAAyD;IACpE,MAAM,SAAsB;IAE5B,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAC3C,OAAO,CAAC,iBAAiB,CAKjB;gBAEI,OAAO,GAAE,uBAA4B;IAa3C,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,KAAK;2BACsB,GAAG,WAAW,aAAa;+BAY3C,GAAG,UACF,GAAG,EAAE,YACH,aAAa;MAkBzB;IAEF;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAInC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASjC;;OAEG;YACW,YAAY;IA0C1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwC/B;;OAEG;IACH,OAAO,CAAC,eAAe;CAwFxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,uBAAuB,GAChC,gBAAgB,CAElB"}