@robota-sdk/agent-core 3.0.0-beta.1

package/dist/abstracts/abstract-workflow-converter.js

@@ -0,0 +1,252 @@
+/**
+ * Abstract Workflow Converter
+ *
+ * Abstract base class for all workflow converters in the Robota SDK.
+ * Uses an enabled flag + injected logger pattern.
+ *
+ * @template TInput - Input workflow data type
+ * @template TOutput - Output workflow data type
+ */
+import { SilentLogger } from '../utils/logger';
+/**
+ * Base Workflow Converter Abstract Class
+ *
+ * Provides common functionality for all workflow converters:
+ * - Statistics tracking
+ * - Logging with dependency injection
+ * - Error handling and validation
+ * - Performance monitoring
+ * - Enable/disable functionality
+ *
+ * @template TInput - Input workflow data type
+ * @template TOutput - Output workflow data type
+ */
+export class AbstractWorkflowConverter {
+    /** Enable/disable state */
+    enabled;
+    /** Logger instance with dependency injection */
+    logger;
+    /** Converter configuration */
+    config;
+    /** Statistics tracking */
+    stats = {
+        totalConversions: 0,
+        successfulConversions: 0,
+        failedConversions: 0,
+        totalProcessingTime: 0
+    };
+    /**
+     * Constructor
+     *
+     * @param options - Converter configuration options
+     */
+    constructor(options = {}) {
+        this.enabled = options.enabled ?? true;
+        this.logger = options.logger || SilentLogger;
+        this.config = options.config || {};
+        this.logger.debug(`${this.constructor.name} initialized`, {
+            enabled: this.enabled
+        });
+    }
+    /**
+     * Main conversion method with comprehensive error handling and metrics
+     *
+     * @param input - Input workflow data
+     * @param options - Conversion options
+     * @returns Promise resolving to conversion result
+     */
+    async convert(input, options = {}) {
+        if (!this.enabled) {
+            throw new Error(`Converter ${this.name} is disabled`);
+        }
+        const startTime = Date.now();
+        const logger = options.logger || this.logger;
+        logger.debug(`Starting conversion from ${this.sourceFormat} to ${this.targetFormat}`);
+        try {
+            // Update statistics
+            this.stats.totalConversions++;
+            // Validate input if requested
+            if (options.validateInput) {
+                const inputValidation = await this.validateInput(input);
+                if (!inputValidation.isValid) {
+                    this.stats.failedConversions++;
+                    return this.createFailureResult(inputValidation.errors, inputValidation.warnings, startTime, input, logger);
+                }
+            }
+            // Perform the actual conversion (implemented by subclass)
+            const convertedData = await this.performConversion(input, options);
+            // Validate output if requested
+            if (options.validateOutput) {
+                const outputValidation = await this.validateOutput(convertedData);
+                if (!outputValidation.isValid) {
+                    this.stats.failedConversions++;
+                    return this.createFailureResult(outputValidation.errors, outputValidation.warnings, startTime, input, logger);
+                }
+            }
+            // Create success result
+            const result = this.createSuccessResult(convertedData, startTime, input, options);
+            // Update statistics
+            this.stats.successfulConversions++;
+            this.stats.totalProcessingTime += result.metadata.processingTime;
+            this.stats.lastConversionAt = result.metadata.convertedAt;
+            logger.debug(`Conversion completed successfully`, {
+                processingTime: result.metadata.processingTime,
+                inputNodes: result.metadata.inputStats.nodeCount,
+                outputNodes: result.metadata.outputStats.nodeCount
+            });
+            return result;
+        }
+        catch (error) {
+            this.stats.failedConversions++;
+            const processingTime = Date.now() - startTime;
+            logger.error(`Conversion failed`, {
+                error: error instanceof Error ? error.message : String(error),
+                processingTime
+            });
+            return this.createFailureResult([error instanceof Error ? error.message : String(error)], [], startTime, input, logger);
+        }
+    }
+    /**
+     * Default input validation (can be overridden by subclasses)
+     *
+     * @param input - Input workflow data
+     * @returns Promise resolving to validation result
+     */
+    async validateInput(input) {
+        // Basic null/undefined check
+        if (input == null) {
+            return {
+                isValid: false,
+                errors: ['Input data is null or undefined'],
+                warnings: []
+            };
+        }
+        // Subclasses should override for specific validation
+        return {
+            isValid: true,
+            errors: [],
+            warnings: []
+        };
+    }
+    /**
+     * Default output validation (can be overridden by subclasses)
+     *
+     * @param output - Output workflow data
+     * @returns Promise resolving to validation result
+     */
+    async validateOutput(output) {
+        // Basic null/undefined check
+        if (output == null) {
+            return {
+                isValid: false,
+                errors: ['Output data is null or undefined'],
+                warnings: []
+            };
+        }
+        // Subclasses should override for specific validation
+        return {
+            isValid: true,
+            errors: [],
+            warnings: []
+        };
+    }
+    /**
+     * Default implementation for checking if converter can handle input
+     * Should be overridden by subclasses for specific type checking
+     *
+     * @param input - Input data to check
+     * @returns True if converter can handle this input
+     */
+    canConvert(input) {
+        // Basic existence check - subclasses should provide more specific logic
+        return input != null;
+    }
+    /**
+     * Get converter statistics
+     *
+     * @returns Converter performance metrics
+     */
+    getStats() {
+        return {
+            totalConversions: this.stats.totalConversions,
+            successfulConversions: this.stats.successfulConversions,
+            failedConversions: this.stats.failedConversions,
+            averageProcessingTime: this.stats.totalConversions > 0
+                ? this.stats.totalProcessingTime / this.stats.totalConversions
+                : 0,
+            lastConversionAt: this.stats.lastConversionAt
+        };
+    }
+    /**
+     * Reset converter statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalConversions: 0,
+            successfulConversions: 0,
+            failedConversions: 0,
+            totalProcessingTime: 0
+        };
+        this.logger.debug(`Statistics reset for converter ${this.name}`);
+    }
+    /**
+     * Create success result with metadata
+     */
+    createSuccessResult(data, startTime, input, options) {
+        const now = new Date();
+        const processingTime = now.getTime() - startTime;
+        return {
+            data,
+            success: true,
+            errors: [],
+            warnings: [],
+            metadata: {
+                convertedAt: now,
+                processingTime,
+                inputStats: this.getDataStats(input),
+                outputStats: this.getDataStats(data),
+                converter: this.name,
+                version: this.version,
+                ...(options.includeDebug ? { options } : {})
+            }
+        };
+    }
+    /**
+     * Create failure result with error information
+     */
+    createFailureResult(errors, warnings, startTime, input, _logger) {
+        const now = new Date();
+        const processingTime = now.getTime() - startTime;
+        return {
+            data: null,
+            success: false,
+            errors,
+            warnings,
+            metadata: {
+                convertedAt: now,
+                processingTime,
+                inputStats: this.getDataStats(input),
+                outputStats: { nodeCount: 0, edgeCount: 0 },
+                converter: this.name,
+                version: this.version
+            }
+        };
+    }
+    /**
+     * Extract basic statistics from workflow data
+     * Can be overridden by subclasses for specific data formats
+     */
+    getDataStats(data) {
+        if (!data) {
+            return { nodeCount: 0, edgeCount: 0 };
+        }
+        // Try to extract node and edge counts from common properties
+        const nodeCount = Array.isArray(data.nodes) ? data.nodes.length :
+            Array.isArray(data.node) ? data.node.length : 0;
+        const edgeCount = Array.isArray(data.edges) ? data.edges.length :
+            Array.isArray(data.connections) ? data.connections.length :
+                Array.isArray(data.edge) ? data.edge.length : 0;
+        return { nodeCount, edgeCount };
+    }
+}
+//# sourceMappingURL=abstract-workflow-converter.js.map

package/dist/abstracts/abstract-workflow-converter.js.map

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

package/dist/abstracts/abstract-workflow-validator.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Abstract Workflow Validator
+ *
+ * Abstract base class for all workflow validators in the Robota SDK.
+ * Uses an enabled flag + injected logger pattern.
+ *
+ * @template TWorkflowData - Type of workflow data to validate
+ */
+import { IWorkflowValidator, IValidationOptions, IValidationResult, IValidationIssue, ValidationSeverity } from '../interfaces/workflow-validator';
+import type { IWorkflowData, IWorkflowConfig } from '../interfaces/workflow-converter';
+import type { ILogger } from '../utils/logger';
+/**
+ * Validator options (enabled flag + injected logger).
+ */
+export interface IBaseWorkflowValidatorOptions {
+    /** Enable/disable the validator */
+    enabled?: boolean;
+    /** Custom logger instance */
+    logger?: ILogger;
+    /** Validator-specific configuration */
+    config?: IWorkflowConfig;
+    /** Default validation options */
+    defaultOptions?: Partial<IValidationOptions>;
+}
+/**
+ * Validation rule configuration
+ */
+interface IValidationRuleConfig {
+    enabled: boolean;
+    description: string;
+    severity: ValidationSeverity;
+    category: string;
+}
+/**
+ * Base Workflow Validator Abstract Class
+ *
+ * Provides common functionality for all workflow validators:
+ * - Statistics tracking
+ * - Logging with dependency injection
+ * - Rule management and configuration
+ * - Performance monitoring
+ * - Enable/disable functionality
+ * - Common validation utilities
+ *
+ * @template TWorkflowData - Type of workflow data to validate
+ */
+export declare abstract class AbstractWorkflowValidator<TWorkflowData extends IWorkflowData> implements IWorkflowValidator<TWorkflowData> {
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly dataFormat: string;
+    abstract readonly availableRules: string[];
+    /** Enable/disable state */
+    enabled: boolean;
+    /** Logger instance with dependency injection */
+    protected readonly logger: ILogger;
+    /** Validator configuration */
+    protected readonly config: IWorkflowConfig;
+    /** Default validation options */
+    protected readonly defaultOptions: Partial<IValidationOptions>;
+    /** Rule configurations */
+    protected readonly ruleConfigs: Map<string, IValidationRuleConfig>;
+    /** Statistics tracking */
+    private stats;
+    /**
+     * Constructor
+     *
+     * @param options - Validator configuration options
+     */
+    constructor(options?: IBaseWorkflowValidatorOptions);
+    /**
+     * Main validation method with comprehensive error handling and metrics
+     *
+     * @param data - Workflow data to validate
+     * @param options - Validation options
+     * @returns Promise resolving to validation result
+     */
+    validate(data: TWorkflowData, options?: IValidationOptions): Promise<IValidationResult>;
+    /**
+     * Validate specific rule
+     *
+     * @param data - Workflow data to validate
+     * @param rule - Specific rule to apply
+     * @param options - Validation options
+     * @returns Promise resolving to validation result for this rule
+     */
+    validateRule(data: TWorkflowData, rule: string, options?: IValidationOptions): Promise<IValidationResult>;
+    /**
+     * Abstract method for performing individual rule validation
+     * Must be implemented by subclasses
+     *
+     * @param data - Workflow data to validate
+     * @param rule - Rule to validate
+     * @param options - Validation options
+     * @returns Promise resolving to rule validation result
+     */
+    protected abstract performRuleValidation(data: TWorkflowData, rule: string, options: IValidationOptions): Promise<{
+        issues: IValidationIssue[];
+    }>;
+    /**
+     * Abstract method for initializing rule configurations
+     * Must be implemented by subclasses
+     */
+    protected abstract initializeRuleConfigs(): void;
+    /**
+     * Default implementation for checking if validator can handle data
+     * Should be overridden by subclasses for specific type checking
+     *
+     * @param data - Data to check
+     * @returns True if validator can handle this data
+     */
+    canValidate(data: TWorkflowData): data is TWorkflowData;
+    /**
+     * Get available validation rules with descriptions
+     *
+     * @returns Map of rule names to descriptions
+     */
+    getRuleDescriptions(): Map<string, {
+        description: string;
+        severity: ValidationSeverity;
+        category: string;
+        enabled: boolean;
+    }>;
+    /**
+     * Enable or disable specific validation rules
+     *
+     * @param rules - Map of rule names to enabled status
+     */
+    configureRules(rules: Map<string, boolean>): void;
+    /**
+     * Default auto-recovery implementation
+     * Can be overridden by subclasses for specific recovery strategies
+     *
+     * @param data - Original workflow data
+     * @param issues - Validation issues to recover from
+     * @returns Promise resolving to recovered data and recovery result
+     */
+    autoRecover(data: TWorkflowData, issues: IValidationIssue[]): Promise<{
+        recoveredData: TWorkflowData;
+        recoveryResult: {
+            success: boolean;
+            issuesFixed: IValidationIssue[];
+            remainingIssues: IValidationIssue[];
+            appliedFixes: string[];
+        };
+    }>;
+    /**
+     * Get validator statistics
+     *
+     * @returns Validator performance metrics
+     */
+    getStats(): {
+        totalValidations: number;
+        successfulValidations: number;
+        failedValidations: number;
+        averageProcessingTime: number;
+        averageIssueCount: number;
+        mostCommonIssues: {
+            rule: string;
+            count: number;
+            severity: ValidationSeverity;
+        }[];
+        lastValidationAt: Date | undefined;
+    };
+    /**
+     * Reset validator statistics
+     */
+    resetStats(): void;
+    /**
+     * Get enabled rules based on options
+     */
+    private getEnabledRules;
+    /**
+     * Filter issues based on validation options
+     */
+    private filterIssues;
+    /**
+     * Create validation result with metadata
+     */
+    private createValidationResult;
+    /**
+     * Create failure result for validation errors
+     */
+    private createFailureResult;
+    /**
+     * Update statistics based on validation result
+     */
+    private updateStatistics;
+    /**
+     * Extract simple options representation for metadata
+     */
+    private extractSimpleOptions;
+    /**
+     * Extract simple data representation from workflow data for statistics
+     */
+    private extractSimpleData;
+    /**
+     * Extract basic statistics from workflow data
+     * Can be overridden by subclasses for specific data formats
+     */
+    protected getDataStats(data: Record<string, string | number | boolean>): Record<string, string | number | boolean>;
+}
+export {};
+//# sourceMappingURL=abstract-workflow-validator.d.ts.map

package/dist/abstracts/abstract-workflow-validator.d.ts.map

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