snow-flow 1.1.0

package/dist/api/error-handling.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Comprehensive Error Handling and Rollback System
+ * Advanced error handling with automatic rollback capabilities
+ */
+import { ServiceNowClient } from '../utils/servicenow-client.js';
+export interface ErrorContext {
+    operation: string;
+    flow_id?: string;
+    component_type?: string;
+    component_id?: string;
+    user_input?: any;
+    system_state?: any;
+    timestamp: Date;
+}
+export interface ErrorRecoveryAction {
+    type: 'rollback' | 'retry' | 'skip' | 'fallback' | 'notify';
+    description: string;
+    parameters?: Record<string, any>;
+    priority: 'high' | 'medium' | 'low';
+}
+export interface ErrorHandlingResult {
+    success: boolean;
+    recovered: boolean;
+    actions_taken: ErrorRecoveryAction[];
+    final_state?: any;
+    user_message?: string;
+    technical_details?: string;
+}
+export declare enum ErrorType {
+    VALIDATION_ERROR = "validation_error",
+    API_ERROR = "api_error",
+    AUTHENTICATION_ERROR = "authentication_error",
+    AUTHORIZATION_ERROR = "authorization_error",
+    NETWORK_ERROR = "network_error",
+    TIMEOUT_ERROR = "timeout_error",
+    RATE_LIMIT_ERROR = "rate_limit_error",
+    RESOURCE_NOT_FOUND = "resource_not_found",
+    CONFLICT_ERROR = "conflict_error",
+    SERVICE_UNAVAILABLE = "service_unavailable",
+    FLOW_LOGIC_ERROR = "flow_logic_error",
+    ROLLBACK_ERROR = "rollback_error",
+    UNKNOWN_ERROR = "unknown_error"
+}
+export declare enum ErrorSeverity {
+    CRITICAL = "critical",
+    HIGH = "high",
+    MEDIUM = "medium",
+    LOW = "low"
+}
+export interface FlowError {
+    type: ErrorType;
+    severity: ErrorSeverity;
+    message: string;
+    context: ErrorContext;
+    original_error?: Error;
+    recoverable: boolean;
+    suggested_actions: ErrorRecoveryAction[];
+    retry_count?: number;
+    max_retries?: number;
+}
+export interface RollbackOperation {
+    id: string;
+    type: 'create' | 'update' | 'delete';
+    table: string;
+    record_id?: string;
+    original_data?: any;
+    new_data?: any;
+    timestamp: Date;
+    dependencies: string[];
+    rollback_function?: () => Promise<void>;
+}
+export interface TransactionState {
+    id: string;
+    flow_id: string;
+    operations: RollbackOperation[];
+    status: 'active' | 'committed' | 'rolled_back' | 'failed';
+    start_time: Date;
+    end_time?: Date;
+    checkpoints: TransactionCheckpoint[];
+}
+export interface TransactionCheckpoint {
+    id: string;
+    timestamp: Date;
+    operation_count: number;
+    state_snapshot: any;
+    description: string;
+}
+export declare class FlowErrorHandler {
+    private client;
+    private logger;
+    private transactions;
+    private errorHistory;
+    private maxErrorHistory;
+    private retryDelays;
+    constructor(client: ServiceNowClient);
+    /**
+     * Handle an error with automatic recovery
+     */
+    handleError(error: Error, context: ErrorContext): Promise<ErrorHandlingResult>;
+    /**
+     * Start a new transaction
+     */
+    startTransaction(flowId: string): string;
+    /**
+     * Add operation to transaction
+     */
+    addOperation(transactionId: string, operation: Omit<RollbackOperation, 'id' | 'timestamp'>): void;
+    /**
+     * Create checkpoint in transaction
+     */
+    createCheckpoint(transactionId: string, description: string): string;
+    /**
+     * Commit transaction
+     */
+    commitTransaction(transactionId: string): Promise<void>;
+    /**
+     * Rollback transaction
+     */
+    rollbackTransaction(transactionId: string, toCheckpoint?: string): Promise<void>;
+    /**
+     * Rollback a single operation
+     */
+    private rollbackOperation;
+    /**
+     * Classify error type and severity
+     */
+    private classifyError;
+    /**
+     * Determine recovery actions based on error
+     */
+    private determineRecoveryActions;
+    /**
+     * Execute a recovery action
+     */
+    private executeRecoveryAction;
+    /**
+     * Execute retry action
+     */
+    private executeRetry;
+    /**
+     * Execute rollback action
+     */
+    private executeRollback;
+    /**
+     * Execute fallback action
+     */
+    private executeFallback;
+    /**
+     * Execute skip action
+     */
+    private executeSkip;
+    /**
+     * Execute notify action
+     */
+    private executeNotify;
+    /**
+     * Retry original operation
+     */
+    private retryOriginalOperation;
+    /**
+     * Create missing resource
+     */
+    private createMissingResource;
+    /**
+     * Use fallback values
+     */
+    private useFallbackValues;
+    /**
+     * Use cached data
+     */
+    private useCachedData;
+    /**
+     * Generate user-friendly error message
+     */
+    private generateUserMessage;
+    /**
+     * Generate technical details
+     */
+    private generateTechnicalDetails;
+    /**
+     * Get max retries for error type
+     */
+    private getMaxRetries;
+    /**
+     * Capture state snapshot
+     */
+    private captureStateSnapshot;
+    /**
+     * Generate transaction ID
+     */
+    private generateTransactionId;
+    /**
+     * Generate operation ID
+     */
+    private generateOperationId;
+    /**
+     * Generate checkpoint ID
+     */
+    private generateCheckpointId;
+    /**
+     * Get error statistics
+     */
+    getErrorStatistics(): {
+        total_errors: number;
+        errors_by_type: Record<string, number>;
+        errors_by_severity: Record<string, number>;
+        recovery_rate: number;
+    };
+    /**
+     * Get active transactions
+     */
+    getActiveTransactions(): TransactionState[];
+}
+//# sourceMappingURL=error-handling.d.ts.map

package/dist/api/error-handling.d.ts.map

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