@tonytang99/integration-core 1.0.0 → 1.2.0

package/dist/pipeline/executor.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pipeline = void 0;
+const common_1 = require("../types/common");
+// Error class for explicit phase errors
+class PhaseError extends Error {
+    phase;
+    code;
+    recoverable;
+    constructor(phase, code, message, recoverable) {
+        super(message);
+        this.phase = phase;
+        this.code = code;
+        this.recoverable = recoverable;
+        this.name = 'PhaseError';
+    }
+}
+class Pipeline {
+    phases;
+    errorHandlers;
+    constructor(phases, errorHandlers) {
+        this.phases = phases;
+        this.errorHandlers = errorHandlers;
+    }
+    async execute(initialCtx) {
+        const startTime = Date.now();
+        let ctx = initialCtx;
+        const executed = [];
+        for (let i = 0; i < this.phases.length; i++) {
+            const phase = this.phases[i];
+            ctx = ctx.startPhase(phase.name);
+            try {
+                if (phase.shouldSkip && await phase.shouldSkip(ctx)) {
+                    ctx = ctx.completePhase(phase.name, 'skipped');
+                    continue;
+                }
+                this.validateRequirements(ctx, phase);
+                // Execute
+                ctx = await phase.execute(ctx);
+                executed.push(phase.name);
+                ctx = ctx.completePhase(phase.name, 'completed');
+                // Check for halt signal
+                const haltKey = (0, common_1.createSlotKey)('control.shouldHalt');
+                const reasonKey = (0, common_1.createSlotKey)('control.haltReason');
+                if (ctx.has(haltKey)) {
+                    return {
+                        success: true,
+                        skipped: true,
+                        reason: ctx.get(reasonKey) ?? 'Pipeline halted',
+                        context: ctx,
+                        executedPhases: executed,
+                        duration: Date.now() - startTime,
+                    };
+                }
+            }
+            catch (error) {
+                const pipelineError = this.toPipelineError(error, phase.name);
+                ctx = ctx.addError(pipelineError);
+                ctx = ctx.completePhase(phase.name, 'failed', pipelineError);
+                const decision = await this.handleError(ctx, pipelineError);
+                if (decision === 'halt') {
+                    await this.rollback(ctx, executed);
+                    return {
+                        success: false,
+                        error: pipelineError,
+                        context: ctx,
+                        executedPhases: executed,
+                        duration: Date.now() - startTime,
+                    };
+                }
+                else if (decision === 'retry') {
+                    i--; // Simple retry
+                    continue;
+                }
+            }
+        }
+        return {
+            success: true,
+            context: ctx,
+            executedPhases: executed,
+            duration: Date.now() - startTime,
+        };
+    }
+    validateRequirements(ctx, phase) {
+        for (const req of phase.requires) {
+            if (!ctx.has(req)) {
+                throw new PhaseError(phase.name, 'MISSING_REQUIREMENT', `Required slot "${String(req)}" is not present`, false);
+            }
+        }
+    }
+    async handleError(ctx, error) {
+        const phaseHandler = this.errorHandlers.get(error.phase);
+        if (phaseHandler)
+            return phaseHandler(ctx, error);
+        const codeHandler = this.errorHandlers.get(error.code);
+        if (codeHandler)
+            return codeHandler(ctx, error);
+        return error.recoverable ? 'continue' : 'halt';
+    }
+    async rollback(ctx, executed) {
+        const lastError = ctx.errors[ctx.errors.length - 1];
+        const reverseExecuted = [...executed].reverse();
+        for (const phaseName of reverseExecuted) {
+            const phase = this.phases.find(p => p.name === phaseName);
+            if (phase?.rollback) {
+                try {
+                    await phase.rollback(ctx, lastError);
+                }
+                catch (e) {
+                    console.error(`Rollback failed for ${phaseName}`, e);
+                }
+            }
+        }
+    }
+    toPipelineError(error, phaseName) {
+        if (error instanceof PhaseError) {
+            return {
+                phase: error.phase,
+                code: error.code,
+                message: error.message,
+                recoverable: error.recoverable
+            };
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            phase: phaseName,
+            code: 'UNKNOWN_ERROR',
+            message,
+            recoverable: false,
+            cause: error,
+            timestamp: new Date()
+        };
+    }
+}
+exports.Pipeline = Pipeline;
+//# sourceMappingURL=executor.js.map

package/dist/pipeline/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/pipeline/executor.ts"],"names":[],"mappings":";;;AAGA,4CAAwE;AAiBxE,wCAAwC;AACxC,MAAM,UAAW,SAAQ,KAAK;IAEnB;IACA;IAEA;IAJT,YACS,KAAa,EACb,IAAY,EACnB,OAAe,EACR,WAAoB;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QALR,UAAK,GAAL,KAAK,CAAQ;QACb,SAAI,GAAJ,IAAI,CAAQ;QAEZ,gBAAW,GAAX,WAAW,CAAS;QAG3B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAa,QAAQ;IAET;IACA;IAFV,YACU,MAAe,EACf,aAAwC;QADxC,WAAM,GAAN,MAAM,CAAS;QACf,kBAAa,GAAb,aAAa,CAA2B;IAC/C,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,UAA2B;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,GAAG,GAAG,UAAU,CAAC;QACrB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7B,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEjC,IAAI,CAAC;gBACH,IAAI,KAAK,CAAC,UAAU,IAAI,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpD,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;oBAC/C,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAEtC,UAAU;gBACV,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAE/B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAEjD,wBAAwB;gBACxB,MAAM,OAAO,GAAG,IAAA,sBAAa,EAAU,oBAAoB,CAAC,CAAC;gBAC7D,MAAM,SAAS,GAAG,IAAA,sBAAa,EAAS,oBAAoB,CAAC,CAAC;gBAE9D,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBACrB,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,iBAAiB;wBAC/C,OAAO,EAAE,GAAG;wBACZ,cAAc,EAAE,QAAQ;wBACxB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACjC,CAAC;gBACJ,CAAC;YAEH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9D,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;gBAClC,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;gBAE7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;gBAE5D,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oBACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;oBACnC,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,aAAa;wBACpB,OAAO,EAAE,GAAG;wBACZ,cAAc,EAAE,QAAQ;wBACxB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACjC,CAAC;gBACJ,CAAC;qBAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;oBAC/B,CAAC,EAAE,CAAC,CAAC,eAAe;oBACpB,SAAS;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG;YACZ,cAAc,EAAE,QAAQ;YACxB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACjC,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,GAAoB,EAAE,KAAY;QAC7D,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,UAAU,CAClB,KAAK,CAAC,IAAI,EACV,qBAAqB,EACrB,kBAAkB,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAC/C,KAAK,CACN,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,GAAoB,EACpB,KAAoB;QAEpB,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,YAAY;YAAE,OAAO,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAElD,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEhD,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,GAAoB,EAAE,QAAkB;QAC7D,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpD,MAAM,eAAe,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAEhD,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;YAC1D,IAAI,KAAK,EAAE,QAAQ,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACvC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,KAAc,EAAE,SAAiB;QACvD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAChC,OAAO;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,eAAe;YACrB,OAAO;YACP,WAAW,EAAE,KAAK;YAClB,KAAK,EAAE,KAAK;YACZ,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;CACF;AAxID,4BAwIC"}

package/dist/pipeline/iterators.d.ts

@@ -0,0 +1,74 @@
+import { Phase } from './phase';
+import { PipelineContext } from './context';
+import { SlotKey, PipelineError } from '../types/common';
+/**
+ * Configuration for MapPhase iteration
+ */
+export interface MapPhaseConfig<TInput, TOutput> {
+    /** Slot containing the input array to iterate over */
+    inputSlot: SlotKey<TInput[]>;
+    /** Slot where results array will be stored */
+    outputSlot: SlotKey<TOutput[]>;
+    /** Slot for current item during iteration (available to sub-phases) */
+    itemSlot: SlotKey<TInput>;
+    /** Slot for result of current iteration (set by sub-phases) */
+    resultSlot: SlotKey<TOutput>;
+    /** Phases to execute for each item */
+    phases: Phase[];
+    /** Max concurrent executions (default: 1 for sequential) */
+    concurrency?: number;
+    /** Continue processing remaining items if one fails (default: false) */
+    continueOnError?: boolean;
+    /** Callback for progress updates */
+    onProgress?: (completed: number, total: number, item: TInput) => void;
+}
+/**
+ * Phase that iterates over a collection, executing sub-phases for each item.
+ * Similar to AWS Step Functions Map state.
+ */
+export declare class MapPhase<TInput, TOutput> implements Phase {
+    readonly name: string;
+    readonly description: string;
+    private readonly config;
+    constructor(name: string, config: MapPhaseConfig<TInput, TOutput>);
+    get requires(): SlotKey<unknown>[];
+    get produces(): SlotKey<unknown>[];
+    get optionalReads(): SlotKey<unknown>[] | undefined;
+    execute(ctx: PipelineContext): Promise<PipelineContext>;
+    private processItem;
+    private toPipelineError;
+    private isPipelineError;
+    private chunk;
+    shouldSkip(ctx: PipelineContext): Promise<boolean>;
+    rollback(ctx: PipelineContext, error: PipelineError): Promise<void>;
+}
+/**
+ * Configuration for ForEachPhase (side-effect iteration without collecting results)
+ */
+export interface ForEachPhaseConfig<TInput> {
+    /** Slot containing the input array to iterate over */
+    inputSlot: SlotKey<TInput[]>;
+    /** Slot for current item during iteration */
+    itemSlot: SlotKey<TInput>;
+    /** Phases to execute for each item */
+    phases: Phase[];
+    /** Continue processing remaining items if one fails */
+    continueOnError?: boolean;
+}
+/**
+ * Phase that iterates over a collection for side effects (no result collection).
+ * Useful for operations like "notify each user" or "delete each file".
+ */
+export declare class ForEachPhase<TInput> implements Phase {
+    readonly name: string;
+    readonly description: string;
+    private readonly config;
+    constructor(name: string, config: ForEachPhaseConfig<TInput>);
+    get requires(): SlotKey<unknown>[];
+    get produces(): SlotKey<unknown>[];
+    execute(ctx: PipelineContext): Promise<PipelineContext>;
+    private toPipelineError;
+    shouldSkip(ctx: PipelineContext): Promise<boolean>;
+    rollback(ctx: PipelineContext, error: PipelineError): Promise<void>;
+}
+//# sourceMappingURL=iterators.d.ts.map

package/dist/pipeline/iterators.d.ts.map

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

package/dist/pipeline/iterators.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForEachPhase = exports.MapPhase = void 0;
+/**
+ * Phase that iterates over a collection, executing sub-phases for each item.
+ * Similar to AWS Step Functions Map state.
+ */
+class MapPhase {
+    name;
+    description;
+    config;
+    constructor(name, config) {
+        this.name = `map:${name}`;
+        this.description = `Iterates over collection and executes phases for each item`;
+        this.config = {
+            inputSlot: config.inputSlot,
+            outputSlot: config.outputSlot,
+            itemSlot: config.itemSlot,
+            resultSlot: config.resultSlot,
+            phases: config.phases,
+            concurrency: config.concurrency ?? 1,
+            continueOnError: config.continueOnError ?? false,
+            onProgress: config.onProgress,
+        };
+    }
+    get requires() {
+        // We require the input slot
+        return [this.config.inputSlot];
+    }
+    get produces() {
+        // We produce the output slot
+        return [this.config.outputSlot];
+    }
+    get optionalReads() {
+        // Collect optional reads from all sub-phases
+        const allOptional = new Set();
+        for (const phase of this.config.phases) {
+            phase.optionalReads?.forEach(slot => allOptional.add(slot));
+        }
+        return allOptional.size > 0 ? Array.from(allOptional) : undefined;
+    }
+    async execute(ctx) {
+        const items = ctx.require(this.config.inputSlot);
+        if (items.length === 0) {
+            return ctx.set(this.config.outputSlot, []);
+        }
+        const results = [];
+        const errors = [];
+        if (this.config.concurrency === 1) {
+            // Sequential execution
+            for (let i = 0; i < items.length; i++) {
+                const result = await this.processItem(ctx, items[i], i);
+                results.push(result);
+                if (!result.success) {
+                    errors.push(result.error);
+                    if (!this.config.continueOnError) {
+                        break;
+                    }
+                }
+                this.config.onProgress?.(i + 1, items.length, items[i]);
+            }
+        }
+        else {
+            // Parallel execution with concurrency limit
+            const batches = this.chunk(items, this.config.concurrency);
+            let completedCount = 0;
+            for (const batch of batches) {
+                const batchPromises = batch.map((item, batchIndex) => {
+                    const globalIndex = completedCount + batchIndex;
+                    return this.processItem(ctx, item, globalIndex);
+                });
+                const batchResults = await Promise.all(batchPromises);
+                for (const result of batchResults) {
+                    results.push(result);
+                    if (!result.success) {
+                        errors.push(result.error);
+                    }
+                    completedCount++;
+                    this.config.onProgress?.(completedCount, items.length, items[result.index]);
+                }
+                // Check if we should stop due to errors
+                if (errors.length > 0 && !this.config.continueOnError) {
+                    break;
+                }
+            }
+        }
+        // Collect successful results in order
+        const successfulResults = results
+            .filter(r => r.success)
+            .sort((a, b) => a.index - b.index)
+            .map(r => r.result);
+        // Add any errors to context
+        let resultCtx = ctx;
+        for (const error of errors) {
+            resultCtx = resultCtx.addError(error);
+        }
+        // If we have errors and didn't continue, throw the first one
+        if (errors.length > 0 && !this.config.continueOnError) {
+            throw errors[0];
+        }
+        return resultCtx.set(this.config.outputSlot, successfulResults);
+    }
+    async processItem(ctx, item, index) {
+        try {
+            // Create iteration context with current item
+            let iterCtx = ctx.set(this.config.itemSlot, item);
+            // Execute all phases for this item
+            for (const phase of this.config.phases) {
+                iterCtx = await phase.execute(iterCtx);
+            }
+            // Get the result from the result slot
+            const result = iterCtx.require(this.config.resultSlot);
+            return {
+                success: true,
+                result,
+                index,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: this.toPipelineError(error, index),
+                index,
+            };
+        }
+    }
+    toPipelineError(error, index) {
+        if (this.isPipelineError(error)) {
+            return {
+                ...error,
+                data: { ...error.data, iterationIndex: index },
+            };
+        }
+        const err = error;
+        return {
+            phase: this.name,
+            code: 'ITERATION_ERROR',
+            message: `Error processing item at index ${index}: ${err?.message ?? String(error)}`,
+            recoverable: false,
+            data: { iterationIndex: index },
+            stack: err?.stack,
+        };
+    }
+    isPipelineError(error) {
+        return (typeof error === 'object' &&
+            error !== null &&
+            'phase' in error &&
+            'code' in error &&
+            'message' in error);
+    }
+    chunk(array, size) {
+        const chunks = [];
+        for (let i = 0; i < array.length; i += size) {
+            chunks.push(array.slice(i, i + size));
+        }
+        return chunks;
+    }
+    async shouldSkip(ctx) {
+        // Skip if input array is empty
+        const items = ctx.get(this.config.inputSlot);
+        return !items || items.length === 0;
+    }
+    async rollback(ctx, error) {
+        // Rollback all sub-phases
+        for (const phase of this.config.phases) {
+            if (phase.rollback) {
+                await phase.rollback(ctx, error);
+            }
+        }
+    }
+}
+exports.MapPhase = MapPhase;
+/**
+ * Phase that iterates over a collection for side effects (no result collection).
+ * Useful for operations like "notify each user" or "delete each file".
+ */
+class ForEachPhase {
+    name;
+    description;
+    config;
+    constructor(name, config) {
+        this.name = `forEach:${name}`;
+        this.description = `Executes phases for each item in collection`;
+        this.config = {
+            inputSlot: config.inputSlot,
+            itemSlot: config.itemSlot,
+            phases: config.phases,
+            continueOnError: config.continueOnError ?? false,
+        };
+    }
+    get requires() {
+        return [this.config.inputSlot];
+    }
+    get produces() {
+        return []; // ForEach doesn't produce output, just side effects
+    }
+    async execute(ctx) {
+        const items = ctx.require(this.config.inputSlot);
+        let resultCtx = ctx;
+        for (const item of items) {
+            try {
+                let iterCtx = resultCtx.set(this.config.itemSlot, item);
+                for (const phase of this.config.phases) {
+                    iterCtx = await phase.execute(iterCtx);
+                }
+                resultCtx = iterCtx;
+            }
+            catch (error) {
+                if (!this.config.continueOnError) {
+                    throw error;
+                }
+                // Add error and continue
+                const pipelineError = this.toPipelineError(error);
+                resultCtx = resultCtx.addError(pipelineError);
+            }
+        }
+        return resultCtx;
+    }
+    toPipelineError(error) {
+        if (typeof error === 'object' && error !== null && 'phase' in error) {
+            return error;
+        }
+        const err = error;
+        return {
+            phase: this.name,
+            code: 'ITERATION_ERROR',
+            message: err?.message ?? String(error),
+            recoverable: false,
+        };
+    }
+    async shouldSkip(ctx) {
+        const items = ctx.get(this.config.inputSlot);
+        return !items || items.length === 0;
+    }
+    async rollback(ctx, error) {
+        for (const phase of this.config.phases) {
+            if (phase.rollback) {
+                await phase.rollback(ctx, error);
+            }
+        }
+    }
+}
+exports.ForEachPhase = ForEachPhase;
+//# sourceMappingURL=iterators.js.map

package/dist/pipeline/iterators.js.map

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

package/dist/pipeline/middleware.d.ts

@@ -0,0 +1,26 @@
+import { Phase } from './phase';
+import { PipelineContext } from './context';
+import { PipelineError } from '../types/common';
+export type NextFn = (ctx: PipelineContext) => Promise<PipelineContext>;
+export type PhaseMiddleware = (ctx: PipelineContext, next: NextFn) => Promise<PipelineContext>;
+export declare class ComposablePhase implements Phase {
+    private inner;
+    private middlewares;
+    constructor(inner: Phase);
+    get name(): string;
+    get description(): string;
+    get requires(): import("../types/common").SlotKey[];
+    get produces(): import("../types/common").SlotKey[];
+    get optionalReads(): import("../types/common").SlotKey[] | undefined;
+    get dependsOn(): string[] | undefined;
+    get tags(): string[] | undefined;
+    use(middleware: PhaseMiddleware): this;
+    before(hook: (ctx: PipelineContext) => Promise<PipelineContext>): this;
+    after(hook: (ctx: PipelineContext) => Promise<PipelineContext>): this;
+    execute(ctx: PipelineContext): Promise<PipelineContext>;
+    shouldSkip(ctx: PipelineContext): Promise<boolean>;
+    rollback(ctx: PipelineContext, error: PipelineError): Promise<void>;
+}
+export declare function composable(phase: Phase): ComposablePhase;
+export declare function composeMiddlewares(...middlewares: PhaseMiddleware[]): PhaseMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/pipeline/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/pipeline/middleware.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B,qBAAa,eAAgB,YAAW,KAAK;IAG/B,OAAO,CAAC,KAAK;IAFzB,OAAO,CAAC,WAAW,CAAyB;gBAExB,KAAK,EAAE,KAAK;IAGhC,IAAI,IAAI,WAA8B;IACtC,IAAI,WAAW,WAAqC;IACpD,IAAI,QAAQ,wCAAkC;IAC9C,IAAI,QAAQ,wCAAkC;IAC9C,IAAI,aAAa,oDAAuC;IACxD,IAAI,SAAS,yBAAmC;IAChD,IAAI,IAAI,yBAA8B;IAEtC,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAMtC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAQtE,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAO/D,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBvD,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAK1E;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAExD;AAGD,wBAAgB,kBAAkB,CAAC,GAAG,WAAW,EAAE,eAAe,EAAE,GAAG,eAAe,CAQrF"}

package/dist/pipeline/middleware.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComposablePhase = void 0;
+exports.composable = composable;
+exports.composeMiddlewares = composeMiddlewares;
+class ComposablePhase {
+    inner;
+    middlewares = [];
+    constructor(inner) {
+        this.inner = inner;
+    }
+    // Delegate metadata to inner phase
+    get name() { return this.inner.name; }
+    get description() { return this.inner.description; }
+    get requires() { return this.inner.requires; }
+    get produces() { return this.inner.produces; }
+    get optionalReads() { return this.inner.optionalReads; }
+    get dependsOn() { return this.inner.dependsOn; }
+    get tags() { return this.inner.tags; }
+    use(middleware) {
+        this.middlewares.push(middleware);
+        return this;
+    }
+    // Syntactic sugar for "Before" middleware
+    before(hook) {
+        return this.use(async (ctx, next) => {
+            const modified = await hook(ctx);
+            return next(modified);
+        });
+    }
+    // Syntactic sugar for "After" middleware
+    after(hook) {
+        return this.use(async (ctx, next) => {
+            const result = await next(ctx);
+            return hook(result);
+        });
+    }
+    async execute(ctx) {
+        // 1. The innermost function is the actual phase execution
+        const executeInner = (c) => this.inner.execute(c);
+        // 2. Reduce the middlewares into a single execution function
+        // explicit generic <NextFn> fixes the type inference error
+        const chain = this.middlewares.reduceRight((next, middleware) => (c) => middleware(c, next), executeInner);
+        // 3. Execute the chain
+        return chain(ctx);
+    }
+    // Delegate optional methods
+    async shouldSkip(ctx) {
+        return this.inner.shouldSkip ? await this.inner.shouldSkip(ctx) : false;
+    }
+    async rollback(ctx, error) {
+        if (this.inner.rollback) {
+            await this.inner.rollback(ctx, error);
+        }
+    }
+}
+exports.ComposablePhase = ComposablePhase;
+// Factory function
+function composable(phase) {
+    return new ComposablePhase(phase);
+}
+// Utility to combine multiple middlewares into one
+function composeMiddlewares(...middlewares) {
+    return async (ctx, next) => {
+        const chain = middlewares.reduceRight((nextFn, middleware) => (c) => middleware(c, nextFn), next);
+        return chain(ctx);
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/pipeline/middleware.js.map

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

package/dist/pipeline/phase.d.ts

@@ -1,17 +1,39 @@
-import { PipelineContext, SlotKey } from './context';
-export interface Phase {
+import { PipelineContext } from './context';
+import { SlotKey, PipelineError } from '../types/common';
+export interface PhaseContract {
     readonly name: string;
     readonly description: string;
     readonly requires: SlotKey[];
     readonly produces: SlotKey[];
+    readonly optionalReads?: SlotKey[];
+    readonly dependsOn?: string[];
+    readonly tags?: string[];
+}
+export interface Phase extends PhaseContract {
     execute(ctx: PipelineContext): Promise<PipelineContext>;
+    shouldSkip?(ctx: PipelineContext): Promise<boolean>;
+    rollback?(ctx: PipelineContext, error: PipelineError): Promise<void>;
 }
 export declare abstract class BasePhase implements Phase {
     abstract readonly name: string;
     abstract readonly description: string;
     abstract readonly requires: SlotKey[];
     abstract readonly produces: SlotKey[];
+    readonly optionalReads?: SlotKey[];
+    readonly dependsOn?: string[];
+    readonly tags?: string[];
     abstract execute(ctx: PipelineContext): Promise<PipelineContext>;
-    protected fail(code: string, message: string): never;
+    shouldSkip?(ctx: PipelineContext): Promise<boolean>;
+    rollback?(ctx: PipelineContext, error: PipelineError): Promise<void>;
+    protected fail(code: string, message: string, recoverable?: boolean, data?: Record<string, unknown>): never;
+    protected warn(ctx: PipelineContext, message: string): PipelineContext;
+}
+export declare class PhaseError extends Error implements PipelineError {
+    readonly phase: string;
+    readonly code: string;
+    readonly recoverable: boolean;
+    readonly data?: Record<string, unknown> | undefined;
+    readonly cause?: Error | undefined;
+    constructor(phase: string, code: string, message: string, recoverable: boolean, data?: Record<string, unknown> | undefined, cause?: Error | undefined);
 }
 //# sourceMappingURL=phase.d.ts.map

package/dist/pipeline/phase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAE7B,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACzD;AAED,8BAAsB,SAAU,YAAW,KAAK;IAC9C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEtC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAEhE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;CAGrD"}
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,KAAM,SAAQ,aAAa;IAC1C,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACxD,UAAU,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,8BAAsB,SAAU,YAAW,KAAK;IAC9C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEtC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAE1D,UAAU,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,QAAQ,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,SAAS,CAAC,IAAI,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,UAAQ,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,KAAK;IAIR,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe;CAGvE;AAED,qBAAa,UAAW,SAAQ,KAAM,YAAW,aAAa;aAE1C,KAAK,EAAE,MAAM;aACb,IAAI,EAAE,MAAM;aAEZ,WAAW,EAAE,OAAO;aACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;aAC9B,KAAK,CAAC,EAAE,KAAK;gBALb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EAC9B,KAAK,CAAC,EAAE,KAAK,YAAA;CAMhC"}