@generacy-ai/workflow-engine 0.0.0-preview-20260304013206

package/dist/loader/validator.js

@@ -0,0 +1,135 @@
+/**
+ * Workflow validator using Zod schemas.
+ */
+import { ZodError } from 'zod';
+import { WorkflowDefinitionSchema } from './schema.js';
+/**
+ * Validation error with detailed information
+ */
+export class WorkflowValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.name = 'WorkflowValidationError';
+        this.issues = issues;
+    }
+}
+/**
+ * Validate a workflow definition object
+ * @param data Raw workflow data (parsed from YAML)
+ * @returns Validated WorkflowDefinition
+ * @throws WorkflowValidationError if validation fails
+ */
+export function validateWorkflow(data) {
+    try {
+        const result = WorkflowDefinitionSchema.parse(data);
+        // Transform to our internal type format
+        return {
+            name: result.name,
+            description: result.description,
+            version: result.version,
+            inputs: result.inputs?.map(input => ({
+                name: input.name,
+                description: input.description,
+                default: input.default,
+                required: input.required,
+                type: input.type,
+            })),
+            phases: result.phases.map(phase => ({
+                name: phase.name,
+                condition: phase.condition,
+                steps: phase.steps.map(step => ({
+                    name: step.name,
+                    action: step.action ?? 'shell',
+                    uses: step.uses,
+                    with: step.with,
+                    command: step.command,
+                    script: step.script,
+                    timeout: step.timeout,
+                    continueOnError: step.continueOnError,
+                    condition: step.condition,
+                    env: step.env,
+                    retry: step.retry ? {
+                        maxAttempts: step.retry.maxAttempts,
+                        delay: typeof step.retry.delay === 'number' ? step.retry.delay : parseDuration(step.retry.delay),
+                        backoff: step.retry.backoff,
+                        maxDelay: step.retry.maxDelay
+                            ? (typeof step.retry.maxDelay === 'number' ? step.retry.maxDelay : parseDuration(step.retry.maxDelay))
+                            : undefined,
+                        jitter: step.retry.jitter,
+                    } : undefined,
+                })),
+            })),
+            env: result.env,
+            timeout: result.timeout,
+            retry: result.retry ? {
+                maxAttempts: result.retry.maxAttempts,
+                delay: typeof result.retry.delay === 'number' ? result.retry.delay : parseDuration(result.retry.delay),
+                backoff: result.retry.backoff,
+                maxDelay: result.retry.maxDelay
+                    ? (typeof result.retry.maxDelay === 'number' ? result.retry.maxDelay : parseDuration(result.retry.maxDelay))
+                    : undefined,
+                jitter: result.retry.jitter,
+            } : undefined,
+        };
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            const issues = error.issues.map(issue => ({
+                path: issue.path.join('.'),
+                message: issue.message,
+                code: issue.code,
+            }));
+            const message = `Workflow validation failed:\n${issues.map(i => `  - ${i.path}: ${i.message}`).join('\n')}`;
+            throw new WorkflowValidationError(message, issues);
+        }
+        throw error;
+    }
+}
+/**
+ * Parse a duration string to milliseconds
+ * @param duration Duration string (e.g., '10s', '5m', '1h', '1000ms')
+ * @returns Duration in milliseconds
+ */
+function parseDuration(duration) {
+    const match = duration.match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h)?$/i);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${duration}`);
+    }
+    const [, value, unit] = match;
+    const numValue = parseFloat(value);
+    switch (unit?.toLowerCase()) {
+        case 'h':
+            return numValue * 60 * 60 * 1000;
+        case 'm':
+            return numValue * 60 * 1000;
+        case 's':
+            return numValue * 1000;
+        case 'ms':
+        case undefined:
+            return numValue;
+        default:
+            return numValue;
+    }
+}
+/**
+ * Check if a workflow definition is valid without throwing
+ * @param data Raw workflow data
+ * @returns Object with valid flag and optional error
+ */
+export function isValidWorkflow(data) {
+    try {
+        validateWorkflow(data);
+        return { valid: true };
+    }
+    catch (error) {
+        if (error instanceof WorkflowValidationError) {
+            return { valid: false, error };
+        }
+        return {
+            valid: false,
+            error: new WorkflowValidationError(error instanceof Error ? error.message : 'Unknown validation error', []),
+        };
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/loader/validator.js.map

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

package/dist/registry/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Register a workflow by name.
+ * Validates that the file exists at registration time.
+ * Logs a warning if overwriting an existing registration.
+ *
+ * @param name The workflow name (e.g., 'speckit-feature')
+ * @param filePath The absolute path to the workflow YAML file
+ * @throws Error if filePath does not exist on disk
+ */
+export declare function registerWorkflow(name: string, filePath: string): void;
+/**
+ * Register multiple workflows at once.
+ * Each entry is validated and registered individually.
+ *
+ * @param workflows A Map or Record of workflow name → file path
+ */
+export declare function registerWorkflows(workflows: Map<string, string> | Record<string, string>): void;
+/**
+ * Resolve a workflow name to a file path from the registry.
+ *
+ * @param name The workflow name to look up
+ * @returns The absolute file path, or undefined if not registered
+ */
+export declare function resolveRegisteredWorkflow(name: string): string | undefined;
+/**
+ * Check if a workflow is registered.
+ *
+ * @param name The workflow name to check
+ * @returns true if a workflow is registered under this name
+ */
+export declare function hasRegisteredWorkflow(name: string): boolean;
+/**
+ * Get all registered workflow names.
+ *
+ * @returns Array of registered workflow names
+ */
+export declare function getRegisteredWorkflowNames(): string[];
+/**
+ * Clear the workflow registry. Useful for testing.
+ */
+export declare function clearWorkflowRegistry(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAcrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQ/F;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/registry/index.js

@@ -0,0 +1,77 @@
+/**
+ * Workflow registry — global singleton for plugin-provided workflow discovery.
+ * Provides centralized registration and lookup of workflow file paths by name.
+ * Follows the same pattern as the actionRegistry in actions/index.ts.
+ */
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+/**
+ * Registry of workflow names to absolute file paths.
+ */
+const workflowRegistry = new Map();
+/**
+ * Register a workflow by name.
+ * Validates that the file exists at registration time.
+ * Logs a warning if overwriting an existing registration.
+ *
+ * @param name The workflow name (e.g., 'speckit-feature')
+ * @param filePath The absolute path to the workflow YAML file
+ * @throws Error if filePath does not exist on disk
+ */
+export function registerWorkflow(name, filePath) {
+    const absolutePath = resolve(filePath);
+    if (!existsSync(absolutePath)) {
+        throw new Error(`Cannot register workflow "${name}": file not found at ${absolutePath}`);
+    }
+    if (workflowRegistry.has(name)) {
+        console.warn(`Overwriting existing workflow registration: ${name}`);
+    }
+    workflowRegistry.set(name, absolutePath);
+}
+/**
+ * Register multiple workflows at once.
+ * Each entry is validated and registered individually.
+ *
+ * @param workflows A Map or Record of workflow name → file path
+ */
+export function registerWorkflows(workflows) {
+    const entries = workflows instanceof Map
+        ? workflows.entries()
+        : Object.entries(workflows);
+    for (const [name, filePath] of entries) {
+        registerWorkflow(name, filePath);
+    }
+}
+/**
+ * Resolve a workflow name to a file path from the registry.
+ *
+ * @param name The workflow name to look up
+ * @returns The absolute file path, or undefined if not registered
+ */
+export function resolveRegisteredWorkflow(name) {
+    return workflowRegistry.get(name);
+}
+/**
+ * Check if a workflow is registered.
+ *
+ * @param name The workflow name to check
+ * @returns true if a workflow is registered under this name
+ */
+export function hasRegisteredWorkflow(name) {
+    return workflowRegistry.has(name);
+}
+/**
+ * Get all registered workflow names.
+ *
+ * @returns Array of registered workflow names
+ */
+export function getRegisteredWorkflowNames() {
+    return Array.from(workflowRegistry.keys());
+}
+/**
+ * Clear the workflow registry. Useful for testing.
+ */
+export function clearWorkflowRegistry() {
+    workflowRegistry.clear();
+}
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC7D,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,wBAAwB,YAAY,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,+CAA+C,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAuD;IACvF,MAAM,OAAO,GAAG,SAAS,YAAY,GAAG;QACtC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE;QACrB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC;QACvC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/retry/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Retry manager for workflow step execution.
+ * Wraps action execution with configurable retry and timeout behavior.
+ */
+import type { RetryConfig, StepDefinition } from '../types/workflow.js';
+import type { ActionHandler, ActionContext, ActionResult } from '../types/action.js';
+import type { RetryState, RetryResult } from '../types/retry.js';
+/**
+ * Parse retry configuration from step or workflow defaults
+ */
+export declare function parseRetryConfig(step: StepDefinition): RetryConfig;
+/**
+ * Retry manager class
+ * Wraps action execution with configurable retry behavior
+ */
+export declare class RetryManager {
+    private config;
+    private onRetry?;
+    constructor(config?: Partial<RetryConfig>, onRetry?: (state: RetryState, error: Error) => void);
+    /**
+     * Execute an action with retry logic
+     */
+    executeWithRetry(handler: ActionHandler, step: StepDefinition, context: ActionContext): Promise<RetryResult<ActionResult>>;
+    /**
+     * Create a retry manager from step configuration
+     */
+    static fromStep(step: StepDefinition, onRetry?: (state: RetryState, error: Error) => void): RetryManager;
+}
+/**
+ * Create a timeout wrapper for an async operation.
+ * When the timeout fires, the optional onTimeout callback is invoked so the
+ * caller can abort the underlying operation (e.g. signal an AbortController).
+ */
+export declare function withTimeout<T>(operation: Promise<T>, timeoutMs: number, signal?: AbortSignal, onTimeout?: () => void): Promise<T>;
+export type { RetryState, RetryResult } from '../types/retry.js';
+export { calculateBackoffDelay, constantDelay, linearDelay, exponentialDelay, addJitter, parseDuration, formatDuration, type BackoffStrategy, } from './strategies.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/retry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retry/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmBjE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CAoBlE;AAwBD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAC,CAA4C;gBAG1D,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI;IAMrD;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAyHrC;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAClD,YAAY;CAGhB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,MAAM,IAAI,GACrB,OAAO,CAAC,CAAC,CAAC,CAoDZ;AAGD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjE,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/retry/index.js

@@ -0,0 +1,225 @@
+import { calculateBackoffDelay, parseDuration, formatDuration, } from './strategies.js';
+/**
+ * Default retry configuration
+ */
+const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 1,
+    delay: 1000,
+    backoff: 'exponential',
+    maxDelay: 60000,
+    jitter: 0.1,
+};
+/**
+ * Parse retry configuration from step or workflow defaults
+ */
+export function parseRetryConfig(step) {
+    if (!step.retry) {
+        return DEFAULT_RETRY_CONFIG;
+    }
+    const config = step.retry;
+    return {
+        maxAttempts: config.maxAttempts ?? DEFAULT_RETRY_CONFIG.maxAttempts,
+        delay: typeof config.delay === 'number'
+            ? config.delay
+            : parseDuration(String(config.delay)),
+        backoff: config.backoff ?? DEFAULT_RETRY_CONFIG.backoff,
+        maxDelay: config.maxDelay !== undefined
+            ? (typeof config.maxDelay === 'number'
+                ? config.maxDelay
+                : parseDuration(String(config.maxDelay)))
+            : DEFAULT_RETRY_CONFIG.maxDelay,
+        jitter: config.jitter ?? DEFAULT_RETRY_CONFIG.jitter,
+    };
+}
+/**
+ * Sleep for a specified duration
+ */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error('Sleep aborted'));
+            return;
+        }
+        const timeoutId = setTimeout(resolve, ms);
+        if (signal) {
+            const abortHandler = () => {
+                clearTimeout(timeoutId);
+                reject(new Error('Sleep aborted'));
+            };
+            signal.addEventListener('abort', abortHandler, { once: true });
+        }
+    });
+}
+/**
+ * Retry manager class
+ * Wraps action execution with configurable retry behavior
+ */
+export class RetryManager {
+    config;
+    onRetry;
+    constructor(config, onRetry) {
+        this.config = { ...DEFAULT_RETRY_CONFIG, ...config };
+        this.onRetry = onRetry;
+    }
+    /**
+     * Execute an action with retry logic
+     */
+    async executeWithRetry(handler, step, context) {
+        const stepConfig = parseRetryConfig(step);
+        const config = { ...this.config, ...stepConfig };
+        const errors = [];
+        const startTime = Date.now();
+        let attempt = 1;
+        let lastResult;
+        while (attempt <= config.maxAttempts) {
+            const state = {
+                attempt,
+                previousErrors: [...errors],
+                canRetry: attempt < config.maxAttempts,
+                nextDelay: attempt < config.maxAttempts
+                    ? calculateBackoffDelay(config.backoff, attempt, config.delay, config.maxDelay, config.jitter)
+                    : undefined,
+            };
+            try {
+                // Check for cancellation before each attempt
+                if (context.signal.aborted) {
+                    throw new Error('Execution cancelled');
+                }
+                // Log attempt
+                if (attempt > 1) {
+                    context.logger.info(`Retry attempt ${attempt}/${config.maxAttempts} for step "${step.name}"`);
+                }
+                // Execute the action
+                lastResult = await handler.execute(step, context);
+                // Check if successful
+                if (lastResult.success) {
+                    return {
+                        result: lastResult,
+                        attempts: attempt,
+                        totalDuration: Date.now() - startTime,
+                        errors,
+                    };
+                }
+                // Action failed but didn't throw
+                const error = new Error(lastResult.error ?? 'Action failed');
+                errors.push(error);
+                // Check if we can retry
+                if (state.canRetry) {
+                    // Call retry callback
+                    if (this.onRetry) {
+                        this.onRetry(state, error);
+                    }
+                    // Wait before retrying
+                    context.logger.info(`Waiting ${formatDuration(state.nextDelay)} before retry...`);
+                    await sleep(state.nextDelay, context.signal);
+                }
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                errors.push(err);
+                // Check for cancellation
+                if (err.message.includes('cancelled') || err.message.includes('aborted')) {
+                    // Don't retry on cancellation
+                    return {
+                        result: lastResult ?? {
+                            success: false,
+                            output: null,
+                            error: err.message,
+                            duration: Date.now() - startTime,
+                        },
+                        attempts: attempt,
+                        totalDuration: Date.now() - startTime,
+                        errors,
+                    };
+                }
+                // Check if we can retry
+                if (state.canRetry) {
+                    // Call retry callback
+                    if (this.onRetry) {
+                        this.onRetry(state, err);
+                    }
+                    // Wait before retrying
+                    context.logger.info(`Waiting ${formatDuration(state.nextDelay)} before retry...`);
+                    await sleep(state.nextDelay, context.signal);
+                }
+            }
+            attempt++;
+        }
+        // All retries exhausted
+        const finalError = errors[errors.length - 1];
+        return {
+            result: lastResult ?? {
+                success: false,
+                output: null,
+                error: finalError?.message ?? 'Max retries exceeded',
+                duration: Date.now() - startTime,
+            },
+            attempts: attempt - 1,
+            totalDuration: Date.now() - startTime,
+            errors,
+        };
+    }
+    /**
+     * Create a retry manager from step configuration
+     */
+    static fromStep(step, onRetry) {
+        return new RetryManager(parseRetryConfig(step), onRetry);
+    }
+}
+/**
+ * Create a timeout wrapper for an async operation.
+ * When the timeout fires, the optional onTimeout callback is invoked so the
+ * caller can abort the underlying operation (e.g. signal an AbortController).
+ */
+export function withTimeout(operation, timeoutMs, signal, onTimeout) {
+    return new Promise((resolve, reject) => {
+        // Check if already aborted
+        if (signal?.aborted) {
+            reject(new Error('Operation aborted'));
+            return;
+        }
+        let settled = false;
+        const timeoutId = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                onTimeout?.(); // let caller abort the underlying operation
+                reject(new Error(`Operation timed out after ${formatDuration(timeoutMs)}`));
+            }
+        }, timeoutMs);
+        // Handle abort signal
+        const abortHandler = () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeoutId);
+                reject(new Error('Operation aborted'));
+            }
+        };
+        if (signal) {
+            signal.addEventListener('abort', abortHandler, { once: true });
+        }
+        operation
+            .then((result) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeoutId);
+                if (signal) {
+                    signal.removeEventListener('abort', abortHandler);
+                }
+                resolve(result);
+            }
+        })
+            .catch((error) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeoutId);
+                if (signal) {
+                    signal.removeEventListener('abort', abortHandler);
+                }
+                reject(error);
+            }
+        });
+    });
+}
+// Re-export strategies
+export { calculateBackoffDelay, constantDelay, linearDelay, exponentialDelay, addJitter, parseDuration, formatDuration, } from './strategies.js';
+//# sourceMappingURL=index.js.map

package/dist/retry/index.js.map

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

package/dist/retry/strategies.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Retry backoff strategy calculation functions.
+ * Provides constant, linear, and exponential backoff algorithms.
+ */
+/**
+ * Backoff strategy type
+ */
+export type BackoffStrategy = 'constant' | 'linear' | 'exponential';
+/**
+ * Calculate constant backoff delay
+ * Returns the same delay for every attempt.
+ *
+ * @param _attempt Current attempt number (1-indexed)
+ * @param baseDelay Base delay in milliseconds
+ * @param maxDelay Maximum delay cap in milliseconds
+ * @returns Delay in milliseconds
+ */
+export declare function constantDelay(_attempt: number, baseDelay: number, maxDelay?: number): number;
+/**
+ * Calculate linear backoff delay
+ * Delay increases linearly with each attempt: delay = baseDelay * attempt
+ *
+ * @param attempt Current attempt number (1-indexed)
+ * @param baseDelay Base delay in milliseconds
+ * @param maxDelay Maximum delay cap in milliseconds
+ * @returns Delay in milliseconds
+ */
+export declare function linearDelay(attempt: number, baseDelay: number, maxDelay?: number): number;
+/**
+ * Calculate exponential backoff delay
+ * Delay doubles with each attempt: delay = baseDelay * 2^(attempt-1)
+ *
+ * @param attempt Current attempt number (1-indexed)
+ * @param baseDelay Base delay in milliseconds
+ * @param maxDelay Maximum delay cap in milliseconds
+ * @returns Delay in milliseconds
+ */
+export declare function exponentialDelay(attempt: number, baseDelay: number, maxDelay?: number): number;
+/**
+ * Add jitter to a delay value
+ * Jitter helps prevent thundering herd problems.
+ *
+ * @param delay Base delay in milliseconds
+ * @param jitterFactor Jitter factor (0-1), default 0.1 (10%)
+ * @returns Delay with jitter applied
+ */
+export declare function addJitter(delay: number, jitterFactor?: number): number;
+/**
+ * Calculate backoff delay based on strategy
+ *
+ * @param strategy Backoff strategy
+ * @param attempt Current attempt number (1-indexed)
+ * @param baseDelay Base delay in milliseconds
+ * @param maxDelay Maximum delay cap in milliseconds
+ * @param jitterFactor Optional jitter factor (0-1)
+ * @returns Delay in milliseconds
+ */
+export declare function calculateBackoffDelay(strategy: BackoffStrategy, attempt: number, baseDelay: number, maxDelay?: number, jitterFactor?: number): number;
+/**
+ * Parse a duration string to milliseconds
+ * Supports: '10s', '5m', '1h', '1000ms', '1000'
+ *
+ * @param duration Duration string or number
+ * @returns Duration in milliseconds
+ */
+export declare function parseDuration(duration: string | number): number;
+/**
+ * Format milliseconds as a human-readable duration
+ *
+ * @param ms Duration in milliseconds
+ * @returns Formatted duration string
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=strategies.d.ts.map

package/dist/retry/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../src/retry/strategies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,SAAM,GAAG,MAAM,CAInE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAsBR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CA0B/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAWjD"}