@orbytautomation/engine 0.1.0

package/dist/automation/FailureStrategy.js

@@ -0,0 +1,246 @@
+/**
+ * Failure Strategy
+ *
+ * Defines how to handle step failures in workflow execution.
+ * Controls failure propagation and workflow continuation behavior.
+ *
+ * @module automation
+ */
+/**
+ * Failure strategy for workflow execution
+ */
+export class FailureStrategy {
+    config;
+    failureCount = 0;
+    constructor(config) {
+        this.config = {
+            type: config.type,
+            allowPartialSuccess: config.allowPartialSuccess ?? false,
+            maxFailures: config.maxFailures ?? Infinity,
+            criticalSteps: config.criticalSteps ?? [],
+            onFailure: config.onFailure ?? (() => { }),
+        };
+        this.validateConfig();
+    }
+    /**
+     * Decide what to do after a step failure
+     *
+     * @param stepId - ID of failed step
+     * @param error - Error that caused failure
+     * @param totalSteps - Total number of steps
+     * @param completedSteps - Number of completed steps
+     * @returns Failure decision
+     */
+    async decide(stepId, error, _totalSteps, completedSteps) {
+        this.failureCount++;
+        // Critical step failure = always abort
+        if (this.isCriticalStep(stepId)) {
+            await this.executeCleanup(stepId, error);
+            return {
+                continueWorkflow: false,
+                runCleanup: true,
+                skipDependentSteps: true,
+                reason: `Critical step "${stepId}" failed`,
+                finalStatus: 'failed',
+            };
+        }
+        // Max failures exceeded = abort
+        if (this.failureCount > this.config.maxFailures) {
+            await this.executeCleanup(stepId, error);
+            return {
+                continueWorkflow: false,
+                runCleanup: true,
+                skipDependentSteps: true,
+                reason: `Maximum failures (${this.config.maxFailures}) exceeded`,
+                finalStatus: this.config.allowPartialSuccess && completedSteps > 0
+                    ? 'partial'
+                    : 'failed',
+            };
+        }
+        // Strategy-specific decision
+        switch (this.config.type) {
+            case 'abort':
+                await this.executeCleanup(stepId, error);
+                return {
+                    continueWorkflow: false,
+                    runCleanup: true,
+                    skipDependentSteps: true,
+                    reason: 'Abort strategy - stop on failure',
+                    finalStatus: this.config.allowPartialSuccess && completedSteps > 0
+                        ? 'partial'
+                        : 'failed',
+                };
+            case 'continue':
+                return {
+                    continueWorkflow: true,
+                    runCleanup: false,
+                    skipDependentSteps: false,
+                    reason: 'Continue strategy - proceed with remaining steps',
+                };
+            case 'skipDependent':
+                return {
+                    continueWorkflow: true,
+                    runCleanup: false,
+                    skipDependentSteps: true,
+                    reason: 'Skip dependent strategy - skip steps depending on failed step',
+                };
+            default:
+                throw new Error(`Unknown failure strategy: ${this.config.type}`);
+        }
+    }
+    /**
+     * Check if step is critical
+     *
+     * @param stepId - Step ID to check
+     * @returns True if critical
+     */
+    isCriticalStep(stepId) {
+        return this.config.criticalSteps.includes(stepId);
+    }
+    /**
+     * Get current failure count
+     */
+    getFailureCount() {
+        return this.failureCount;
+    }
+    /**
+     * Reset failure count (for new workflow execution)
+     */
+    reset() {
+        this.failureCount = 0;
+    }
+    /**
+     * Get strategy type
+     */
+    getType() {
+        return this.config.type;
+    }
+    /**
+     * Check if partial success is allowed
+     */
+    allowsPartialSuccess() {
+        return this.config.allowPartialSuccess;
+    }
+    /**
+     * Execute cleanup handler
+     */
+    async executeCleanup(stepId, error) {
+        try {
+            await this.config.onFailure(stepId, error);
+        }
+        catch (cleanupError) {
+            // Log cleanup error but don't throw
+            console.error(`Cleanup failed for step "${stepId}":`, cleanupError);
+        }
+    }
+    /**
+     * Validate configuration
+     */
+    validateConfig() {
+        if (this.config.maxFailures < 1) {
+            throw new Error(`Max failures must be >= 1, got: ${this.config.maxFailures}`);
+        }
+    }
+}
+/**
+ * Predefined failure strategies
+ */
+export const FailureStrategies = {
+    /**
+     * Abort workflow on first failure
+     */
+    abort: new FailureStrategy({
+        type: 'abort',
+        allowPartialSuccess: false,
+    }),
+    /**
+     * Abort but allow partial success
+     */
+    abortWithPartial: new FailureStrategy({
+        type: 'abort',
+        allowPartialSuccess: true,
+    }),
+    /**
+     * Continue executing all steps regardless of failures
+     */
+    continue: new FailureStrategy({
+        type: 'continue',
+        allowPartialSuccess: true,
+    }),
+    /**
+     * Skip dependent steps on failure
+     */
+    skipDependent: new FailureStrategy({
+        type: 'skipDependent',
+        allowPartialSuccess: true,
+    }),
+    /**
+     * Abort after 3 failures
+     */
+    maxThreeFailures: new FailureStrategy({
+        type: 'continue',
+        maxFailures: 3,
+        allowPartialSuccess: true,
+    }),
+};
+/**
+ * Create failure strategy from workflow step configuration
+ *
+ * @param continueOnError - Continue on error flag from step
+ * @param criticalSteps - List of critical step IDs
+ * @returns Failure strategy instance
+ */
+export function createFailureStrategyFromStep(continueOnError, criticalSteps) {
+    if (continueOnError) {
+        return new FailureStrategy({
+            type: 'continue',
+            allowPartialSuccess: true,
+            criticalSteps,
+        });
+    }
+    return new FailureStrategy({
+        type: 'abort',
+        allowPartialSuccess: false,
+        criticalSteps,
+    });
+}
+/**
+ * Failure strategy builder for fluent API
+ */
+export class FailureStrategyBuilder {
+    type = 'abort';
+    allowPartialSuccess = false;
+    maxFailures;
+    criticalSteps = [];
+    failureHandler;
+    withType(type) {
+        this.type = type;
+        return this;
+    }
+    withPartialSuccess(allow = true) {
+        this.allowPartialSuccess = allow;
+        return this;
+    }
+    withMaxFailures(max) {
+        this.maxFailures = max;
+        return this;
+    }
+    withCriticalSteps(...stepIds) {
+        this.criticalSteps = stepIds;
+        return this;
+    }
+    onFailure(handler) {
+        this.failureHandler = handler;
+        return this;
+    }
+    build() {
+        return new FailureStrategy({
+            type: this.type,
+            allowPartialSuccess: this.allowPartialSuccess,
+            maxFailures: this.maxFailures,
+            criticalSteps: this.criticalSteps,
+            onFailure: this.failureHandler,
+        });
+    }
+}
+//# sourceMappingURL=FailureStrategy.js.map

package/dist/automation/FailureStrategy.js.map

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

package/dist/automation/RetryPolicy.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Retry Policy
+ *
+ * Defines when and how to retry failed operations.
+ * Includes attempt limits, backoff strategies, and retry conditions.
+ *
+ * @module automation
+ */
+import { BackoffStrategy, type BackoffType } from './BackoffStrategy.js';
+/**
+ * Retry condition - determines if error is retryable
+ */
+export type RetryCondition = (error: Error, attempt: number) => boolean;
+/**
+ * Retry policy configuration
+ */
+export interface RetryPolicyConfig {
+    /** Maximum retry attempts (0 = no retries) */
+    maxAttempts: number;
+    /** Backoff strategy for delays between retries */
+    backoffStrategy: BackoffStrategy;
+    /** Custom retry condition (default: retry all errors) */
+    retryCondition?: RetryCondition;
+    /** Specific error types to retry (if provided, only these are retried) */
+    retryableErrors?: Array<new (...args: any[]) => Error>;
+    /** Error messages to match for retry (regex patterns) */
+    retryableMessages?: RegExp[];
+    /** Abort retry on specific errors (overrides other conditions) */
+    abortOn?: Array<new (...args: any[]) => Error>;
+}
+/**
+ * Retry policy for operation execution
+ */
+export declare class RetryPolicy {
+    private readonly config;
+    constructor(config: RetryPolicyConfig);
+    /**
+     * Check if error should be retried
+     *
+     * @param error - Error that occurred
+     * @param attempt - Current attempt number (1-indexed)
+     * @returns True if should retry
+     */
+    shouldRetry(error: Error, attempt: number): boolean;
+    /**
+     * Check if error should abort retries immediately
+     *
+     * @param error - Error to check
+     * @returns True if should abort
+     */
+    shouldAbort(error: Error): boolean;
+    /**
+     * Get delay for next retry attempt
+     *
+     * @param attempt - Current attempt number (1-indexed)
+     * @returns Delay in milliseconds
+     */
+    getDelay(attempt: number): number;
+    /**
+     * Get maximum number of attempts
+     */
+    getMaxAttempts(): number;
+    /**
+     * Get backoff strategy
+     */
+    getBackoffStrategy(): BackoffStrategy;
+    /**
+     * Get estimated total retry time (worst case)
+     */
+    getEstimatedRetryTime(): number;
+    /**
+     * Validate configuration
+     */
+    private validateConfig;
+}
+/**
+ * Predefined retry policies
+ */
+export declare const RetryPolicies: {
+    /**
+     * No retries
+     */
+    readonly none: RetryPolicy;
+    /**
+     * Standard retry (3 attempts, exponential backoff)
+     */
+    readonly standard: RetryPolicy;
+    /**
+     * Aggressive retry (5 attempts, fast exponential)
+     */
+    readonly aggressive: RetryPolicy;
+    /**
+     * Network retry (retry common network errors)
+     */
+    readonly network: RetryPolicy;
+    /**
+     * Immediate retry (retry once with no delay)
+     */
+    readonly immediate: RetryPolicy;
+};
+/**
+ * Create retry policy from workflow step configuration
+ *
+ * @param stepRetryConfig - Retry config from ParsedStep
+ * @returns Retry policy instance
+ */
+export declare function createRetryPolicyFromStep(stepRetryConfig?: {
+    max: number;
+    backoff?: 'linear' | 'exponential';
+    delay?: number;
+}): RetryPolicy;
+/**
+ * Retry policy builder for fluent API
+ */
+export declare class RetryPolicyBuilder {
+    private maxAttempts;
+    private backoffType;
+    private baseDelayMs;
+    private maxDelayMs?;
+    private retryCondition?;
+    private retryableErrors?;
+    private retryableMessages?;
+    private abortErrors?;
+    withMaxAttempts(max: number): this;
+    withBackoff(type: BackoffType, baseMs: number, maxMs?: number): this;
+    withCondition(condition: RetryCondition): this;
+    onErrors(...errors: Array<new (...args: any[]) => Error>): this;
+    onMessages(...patterns: RegExp[]): this;
+    abortOn(...errors: Array<new (...args: any[]) => Error>): this;
+    build(): RetryPolicy;
+}
+//# sourceMappingURL=RetryPolicy.d.ts.map

package/dist/automation/RetryPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryPolicy.d.ts","sourceRoot":"","sources":["../../src/automation/RetryPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IAEpB,kDAAkD;IAClD,eAAe,EAAE,eAAe,CAAC;IAEjC,yDAAyD;IACzD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC;IAEvD,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B,kEAAkE;IAClE,OAAO,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,MAAM,EAAE,iBAAiB;IAKrC;;;;;;OAMG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAwCnD;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAQlC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAO/B;;OAEG;IACH,OAAO,CAAC,cAAc;CAKvB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;;IAMH;;OAEG;;IAUH;;OAEG;;IAUH;;OAEG;;IAkBH;;OAEG;;CAKK,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,eAAe,CAAC,EAAE;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,WAAW,CAgBd;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAuC;IAC/D,OAAO,CAAC,iBAAiB,CAAC,CAAW;IACrC,OAAO,CAAC,WAAW,CAAC,CAAuC;IAE3D,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKlC,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAOpE,aAAa,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IAK9C,QAAQ,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,GAAG,IAAI;IAK/D,UAAU,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKvC,OAAO,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,GAAG,IAAI;IAK9D,KAAK,IAAI,WAAW;CAcrB"}

package/dist/automation/RetryPolicy.js

@@ -0,0 +1,241 @@
+/**
+ * Retry Policy
+ *
+ * Defines when and how to retry failed operations.
+ * Includes attempt limits, backoff strategies, and retry conditions.
+ *
+ * @module automation
+ */
+import { BackoffStrategy } from './BackoffStrategy.js';
+/**
+ * Retry policy for operation execution
+ */
+export class RetryPolicy {
+    config;
+    constructor(config) {
+        this.config = config;
+        this.validateConfig();
+    }
+    /**
+     * Check if error should be retried
+     *
+     * @param error - Error that occurred
+     * @param attempt - Current attempt number (1-indexed)
+     * @returns True if should retry
+     */
+    shouldRetry(error, attempt) {
+        // No more attempts available
+        if (attempt >= this.config.maxAttempts) {
+            return false;
+        }
+        // Check abort conditions first
+        if (this.shouldAbort(error)) {
+            return false;
+        }
+        // Check retryable error types
+        if (this.config.retryableErrors && this.config.retryableErrors.length > 0) {
+            const isRetryableType = this.config.retryableErrors.some(ErrorType => error instanceof ErrorType);
+            if (!isRetryableType) {
+                return false;
+            }
+        }
+        // Check retryable message patterns
+        if (this.config.retryableMessages && this.config.retryableMessages.length > 0) {
+            const hasRetryableMessage = this.config.retryableMessages.some(pattern => pattern.test(error.message));
+            if (!hasRetryableMessage) {
+                return false;
+            }
+        }
+        // Apply custom retry condition if provided
+        if (this.config.retryCondition) {
+            return this.config.retryCondition(error, attempt);
+        }
+        // Default: retry all errors (unless explicitly filtered above)
+        return true;
+    }
+    /**
+     * Check if error should abort retries immediately
+     *
+     * @param error - Error to check
+     * @returns True if should abort
+     */
+    shouldAbort(error) {
+        if (!this.config.abortOn || this.config.abortOn.length === 0) {
+            return false;
+        }
+        return this.config.abortOn.some(ErrorType => error instanceof ErrorType);
+    }
+    /**
+     * Get delay for next retry attempt
+     *
+     * @param attempt - Current attempt number (1-indexed)
+     * @returns Delay in milliseconds
+     */
+    getDelay(attempt) {
+        return this.config.backoffStrategy.calculateDelay(attempt);
+    }
+    /**
+     * Get maximum number of attempts
+     */
+    getMaxAttempts() {
+        return this.config.maxAttempts;
+    }
+    /**
+     * Get backoff strategy
+     */
+    getBackoffStrategy() {
+        return this.config.backoffStrategy;
+    }
+    /**
+     * Get estimated total retry time (worst case)
+     */
+    getEstimatedRetryTime() {
+        if (this.config.maxAttempts <= 1) {
+            return 0;
+        }
+        return this.config.backoffStrategy.getTotalDelay(this.config.maxAttempts - 1);
+    }
+    /**
+     * Validate configuration
+     */
+    validateConfig() {
+        if (this.config.maxAttempts < 0) {
+            throw new Error(`Max attempts must be >= 0, got: ${this.config.maxAttempts}`);
+        }
+    }
+}
+/**
+ * Predefined retry policies
+ */
+export const RetryPolicies = {
+    /**
+     * No retries
+     */
+    none: new RetryPolicy({
+        maxAttempts: 1,
+        backoffStrategy: new BackoffStrategy({ type: 'fixed', baseDelayMs: 0 }),
+    }),
+    /**
+     * Standard retry (3 attempts, exponential backoff)
+     */
+    standard: new RetryPolicy({
+        maxAttempts: 3,
+        backoffStrategy: new BackoffStrategy({
+            type: 'exponential',
+            baseDelayMs: 1000,
+            maxDelayMs: 30000,
+        }),
+    }),
+    /**
+     * Aggressive retry (5 attempts, fast exponential)
+     */
+    aggressive: new RetryPolicy({
+        maxAttempts: 5,
+        backoffStrategy: new BackoffStrategy({
+            type: 'exponential',
+            baseDelayMs: 500,
+            maxDelayMs: 20000,
+        }),
+    }),
+    /**
+     * Network retry (retry common network errors)
+     */
+    network: new RetryPolicy({
+        maxAttempts: 4,
+        backoffStrategy: new BackoffStrategy({
+            type: 'exponential',
+            baseDelayMs: 1000,
+            maxDelayMs: 60000,
+        }),
+        retryableMessages: [
+            /ECONNREFUSED/,
+            /ENOTFOUND/,
+            /ETIMEDOUT/,
+            /ECONNRESET/,
+            /socket hang up/i,
+            /network timeout/i,
+        ],
+    }),
+    /**
+     * Immediate retry (retry once with no delay)
+     */
+    immediate: new RetryPolicy({
+        maxAttempts: 2,
+        backoffStrategy: new BackoffStrategy({ type: 'fixed', baseDelayMs: 0 }),
+    }),
+};
+/**
+ * Create retry policy from workflow step configuration
+ *
+ * @param stepRetryConfig - Retry config from ParsedStep
+ * @returns Retry policy instance
+ */
+export function createRetryPolicyFromStep(stepRetryConfig) {
+    if (!stepRetryConfig || stepRetryConfig.max <= 1) {
+        return RetryPolicies.none;
+    }
+    const backoffType = stepRetryConfig.backoff || 'linear';
+    const baseDelayMs = stepRetryConfig.delay || 1000;
+    return new RetryPolicy({
+        maxAttempts: stepRetryConfig.max,
+        backoffStrategy: new BackoffStrategy({
+            type: backoffType,
+            baseDelayMs,
+            maxDelayMs: 60000, // Default 60s cap
+        }),
+    });
+}
+/**
+ * Retry policy builder for fluent API
+ */
+export class RetryPolicyBuilder {
+    maxAttempts = 3;
+    backoffType = 'exponential';
+    baseDelayMs = 1000;
+    maxDelayMs;
+    retryCondition;
+    retryableErrors;
+    retryableMessages;
+    abortErrors;
+    withMaxAttempts(max) {
+        this.maxAttempts = max;
+        return this;
+    }
+    withBackoff(type, baseMs, maxMs) {
+        this.backoffType = type;
+        this.baseDelayMs = baseMs;
+        this.maxDelayMs = maxMs;
+        return this;
+    }
+    withCondition(condition) {
+        this.retryCondition = condition;
+        return this;
+    }
+    onErrors(...errors) {
+        this.retryableErrors = errors;
+        return this;
+    }
+    onMessages(...patterns) {
+        this.retryableMessages = patterns;
+        return this;
+    }
+    abortOn(...errors) {
+        this.abortErrors = errors;
+        return this;
+    }
+    build() {
+        return new RetryPolicy({
+            maxAttempts: this.maxAttempts,
+            backoffStrategy: new BackoffStrategy({
+                type: this.backoffType,
+                baseDelayMs: this.baseDelayMs,
+                maxDelayMs: this.maxDelayMs,
+            }),
+            retryCondition: this.retryCondition,
+            retryableErrors: this.retryableErrors,
+            retryableMessages: this.retryableMessages,
+            abortOn: this.abortErrors,
+        });
+    }
+}
+//# sourceMappingURL=RetryPolicy.js.map

package/dist/automation/RetryPolicy.js.map

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