@tonytang99/integration-core 1.0.0 → 1.2.0

package/dist/index.d.ts

@@ -1,3 +1,12 @@
+export * from './types/common';
+export * from './types/errors';
 export * from './pipeline/context';
 export * from './pipeline/phase';
+export * from './pipeline/builder';
+export * from './pipeline/executor';
+export * from './pipeline/middleware';
+export * from './pipeline/retry';
+export * from './pipeline/iterators';
+export * from './slots/well-known-slots';
+export * from './registry/phase-registry';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -14,6 +14,19 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+// Types
+__exportStar(require("./types/common"), exports);
+__exportStar(require("./types/errors"), exports);
+// Pipeline
 __exportStar(require("./pipeline/context"), exports);
 __exportStar(require("./pipeline/phase"), exports);
+__exportStar(require("./pipeline/builder"), exports);
+__exportStar(require("./pipeline/executor"), exports);
+__exportStar(require("./pipeline/middleware"), exports);
+__exportStar(require("./pipeline/retry"), exports);
+__exportStar(require("./pipeline/iterators"), exports);
+// Slots
+__exportStar(require("./slots/well-known-slots"), exports);
+// Registry
+__exportStar(require("./registry/phase-registry"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,iDAA+B;AAC/B,iDAA+B;AAE/B,WAAW;AACX,qDAAmC;AACnC,mDAAiC;AACjC,qDAAmC;AACnC,sDAAoC;AACpC,wDAAsC;AACtC,mDAAiC;AACjC,uDAAqC;AAErC,QAAQ;AACR,2DAAyC;AAEzC,WAAW;AACX,4DAA0C"}

package/dist/pipeline/builder.d.ts

@@ -0,0 +1,83 @@
+import { Phase } from './phase';
+import { Pipeline, ErrorHandler } from './executor';
+import { SlotKey, ClientConfig, PipelineError } from '../types/common';
+import { PipelineContext } from './context';
+export declare class PipelineBuilder {
+    private phases;
+    private errorHandlers;
+    add(phase: Phase): this;
+    addIf(condition: boolean | ((config: ClientConfig) => boolean), phase: Phase): this;
+    addAll(...phases: Phase[]): this;
+    /**
+     * Adds a phase that only executes when the predicate returns true.
+     * Unlike addIf which checks config at build time, addWhen evaluates
+     * the predicate at runtime against the current pipeline context.
+     */
+    addWhen(predicate: (ctx: PipelineContext) => boolean | Promise<boolean>, phase: Phase): this;
+    /**
+     * Adds a branch that executes different phases based on a condition.
+     * @param condition - Predicate evaluated at runtime
+     * @param ifTrue - Phase(s) to execute when condition is true
+     * @param ifFalse - Optional phase(s) to execute when condition is false
+     */
+    addBranch(condition: (ctx: PipelineContext) => boolean | Promise<boolean>, ifTrue: Phase | Phase[], ifFalse?: Phase | Phase[]): this;
+    onError(phaseOrCode: string, handler: ErrorHandler): this;
+    build(): Pipeline;
+    private validate;
+}
+/**
+ * Wraps a phase and checks a condition before executing.
+ * Proxies all metadata (name, description, tags) to the inner phase.
+ */
+declare class ConditionalPhase implements Phase {
+    private inner;
+    private condition;
+    constructor(inner: Phase, condition: (config: ClientConfig) => boolean);
+    get name(): string;
+    get description(): string;
+    get requires(): SlotKey[];
+    get produces(): SlotKey[];
+    get optionalReads(): SlotKey[] | undefined;
+    get dependsOn(): string[] | undefined;
+    get tags(): string[] | undefined;
+    execute(ctx: PipelineContext): Promise<PipelineContext>;
+    shouldSkip(ctx: PipelineContext): Promise<boolean>;
+    rollback(ctx: PipelineContext, error: PipelineError): Promise<void>;
+}
+/**
+ * Wraps a phase and checks a context-based predicate before executing.
+ * This enables runtime decisions based on data in the pipeline context.
+ */
+declare class ContextConditionalPhase implements Phase {
+    private inner;
+    private predicate;
+    constructor(inner: Phase, predicate: (ctx: PipelineContext) => boolean | Promise<boolean>);
+    get name(): string;
+    get description(): string;
+    get requires(): SlotKey[];
+    get produces(): SlotKey[];
+    get optionalReads(): SlotKey[] | undefined;
+    get dependsOn(): string[] | undefined;
+    get tags(): string[] | undefined;
+    execute(ctx: PipelineContext): Promise<PipelineContext>;
+    shouldSkip(ctx: PipelineContext): Promise<boolean>;
+    rollback(ctx: PipelineContext, error: PipelineError): Promise<void>;
+}
+/**
+ * Implements branching logic - executes different phases based on a condition.
+ */
+declare class BranchPhase implements Phase {
+    private condition;
+    private trueBranch;
+    private falseBranch;
+    constructor(condition: (ctx: PipelineContext) => boolean | Promise<boolean>, ifTrue: Phase | Phase[], ifFalse?: Phase | Phase[]);
+    get name(): string;
+    get description(): string;
+    get requires(): SlotKey<unknown>[];
+    get produces(): SlotKey<unknown>[];
+    execute(ctx: PipelineContext): Promise<PipelineContext>;
+    shouldSkip(): Promise<boolean>;
+    rollback(ctx: PipelineContext, error: PipelineError): Promise<void>;
+}
+export { ConditionalPhase, ContextConditionalPhase, BranchPhase };
+//# sourceMappingURL=builder.d.ts.map

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

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

package/dist/pipeline/builder.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BranchPhase = exports.ContextConditionalPhase = exports.ConditionalPhase = exports.PipelineBuilder = void 0;
+const executor_1 = require("./executor");
+class PipelineBuilder {
+    phases = [];
+    errorHandlers = new Map();
+    add(phase) {
+        this.phases.push(phase);
+        return this;
+    }
+    addIf(condition, phase) {
+        if (typeof condition === 'function') {
+            this.phases.push(new ConditionalPhase(phase, condition));
+        }
+        else if (condition) {
+            this.phases.push(phase);
+        }
+        return this;
+    }
+    addAll(...phases) {
+        this.phases.push(...phases);
+        return this;
+    }
+    /**
+     * Adds a phase that only executes when the predicate returns true.
+     * Unlike addIf which checks config at build time, addWhen evaluates
+     * the predicate at runtime against the current pipeline context.
+     */
+    addWhen(predicate, phase) {
+        this.phases.push(new ContextConditionalPhase(phase, predicate));
+        return this;
+    }
+    /**
+     * Adds a branch that executes different phases based on a condition.
+     * @param condition - Predicate evaluated at runtime
+     * @param ifTrue - Phase(s) to execute when condition is true
+     * @param ifFalse - Optional phase(s) to execute when condition is false
+     */
+    addBranch(condition, ifTrue, ifFalse) {
+        this.phases.push(new BranchPhase(condition, ifTrue, ifFalse));
+        return this;
+    }
+    onError(phaseOrCode, handler) {
+        this.errorHandlers.set(phaseOrCode, handler);
+        return this;
+    }
+    build() {
+        const errors = this.validate();
+        if (errors.length > 0) {
+            throw new Error(`Pipeline validation failed:\n${errors.join('\n')}`);
+        }
+        // In a real implementation, restore the topological sort here
+        // For now, we return the phases in added order
+        return new executor_1.Pipeline(this.phases, this.errorHandlers);
+    }
+    validate() {
+        const errors = [];
+        const produced = new Set();
+        for (const phase of this.phases) {
+            for (const req of phase.requires) {
+                // Cast to string for Set lookup
+                if (!produced.has(req)) {
+                    // Warning: strict validation. 
+                    // If you inject slots via Context initial state, this might false-positive.
+                    errors.push(`Phase "${phase.name}" requires slot "${req}" but no earlier phase produces it`);
+                }
+            }
+            for (const prod of phase.produces) {
+                produced.add(prod);
+            }
+        }
+        return errors;
+    }
+}
+exports.PipelineBuilder = PipelineBuilder;
+/**
+ * Wraps a phase and checks a condition before executing.
+ * Proxies all metadata (name, description, tags) to the inner phase.
+ */
+class ConditionalPhase {
+    inner;
+    condition;
+    constructor(inner, condition) {
+        this.inner = inner;
+        this.condition = condition;
+    }
+    // Required Metadata
+    get name() { return this.inner.name; }
+    get description() { return this.inner.description; }
+    get requires() { return this.inner.requires; }
+    get produces() { return this.inner.produces; }
+    // Optional Metadata
+    get optionalReads() { return this.inner.optionalReads; }
+    get dependsOn() { return this.inner.dependsOn; }
+    get tags() { return this.inner.tags; }
+    async execute(ctx) {
+        // Check condition dynamically at runtime
+        if (!this.condition(ctx.config)) {
+            return ctx; // Return context unchanged if skipped
+        }
+        return this.inner.execute(ctx);
+    }
+    async shouldSkip(ctx) {
+        // If the config condition fails, we definitely skip
+        if (!this.condition(ctx.config))
+            return true;
+        // Otherwise, check if the inner phase wants to skip
+        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.ConditionalPhase = ConditionalPhase;
+/**
+ * Wraps a phase and checks a context-based predicate before executing.
+ * This enables runtime decisions based on data in the pipeline context.
+ */
+class ContextConditionalPhase {
+    inner;
+    predicate;
+    constructor(inner, predicate) {
+        this.inner = inner;
+        this.predicate = predicate;
+    }
+    get name() { return `conditional:${this.inner.name}`; }
+    get description() { return `Conditionally executes: ${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; }
+    async execute(ctx) {
+        const shouldExecute = await this.predicate(ctx);
+        if (!shouldExecute) {
+            return ctx; // Skip execution, return context unchanged
+        }
+        return this.inner.execute(ctx);
+    }
+    async shouldSkip(ctx) {
+        const shouldExecute = await this.predicate(ctx);
+        if (!shouldExecute)
+            return true;
+        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.ContextConditionalPhase = ContextConditionalPhase;
+/**
+ * Implements branching logic - executes different phases based on a condition.
+ */
+class BranchPhase {
+    condition;
+    trueBranch;
+    falseBranch;
+    constructor(condition, ifTrue, ifFalse) {
+        this.condition = condition;
+        this.trueBranch = Array.isArray(ifTrue) ? ifTrue : [ifTrue];
+        this.falseBranch = ifFalse
+            ? (Array.isArray(ifFalse) ? ifFalse : [ifFalse])
+            : [];
+    }
+    get name() { return 'branch'; }
+    get description() { return 'Conditional branch execution'; }
+    get requires() {
+        // Combine requires from both branches
+        const allReqs = new Set();
+        [...this.trueBranch, ...this.falseBranch].forEach(p => {
+            p.requires.forEach(r => allReqs.add(r));
+        });
+        return Array.from(allReqs);
+    }
+    get produces() {
+        // Combine produces from both branches
+        const allProds = new Set();
+        [...this.trueBranch, ...this.falseBranch].forEach(p => {
+            p.produces.forEach(r => allProds.add(r));
+        });
+        return Array.from(allProds);
+    }
+    async execute(ctx) {
+        const result = await this.condition(ctx);
+        const branch = result ? this.trueBranch : this.falseBranch;
+        let currentCtx = ctx;
+        for (const phase of branch) {
+            currentCtx = await phase.execute(currentCtx);
+        }
+        return currentCtx;
+    }
+    async shouldSkip() {
+        return false; // Branch itself doesn't skip, it chooses a path
+    }
+    async rollback(ctx, error) {
+        // Rollback all phases in both branches that might have executed
+        for (const phase of [...this.trueBranch, ...this.falseBranch]) {
+            if (phase.rollback) {
+                await phase.rollback(ctx, error);
+            }
+        }
+    }
+}
+exports.BranchPhase = BranchPhase;
+//# sourceMappingURL=builder.js.map

package/dist/pipeline/builder.js.map

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

package/dist/pipeline/context.d.ts

@@ -1,21 +1,48 @@
-export type SlotKey = string & {
-    readonly __brand: unique symbol;
-};
-export declare const createSlotKey: <T = unknown>(key: string) => SlotKey;
+import { SlotKey, PipelineError, ClientConfig, ExecutionMetadata, PhaseExecution } from '../types/common';
+export interface SerializedContext {
+    slots: Record<string, unknown>;
+    errors: readonly PipelineError[];
+    warnings: readonly string[];
+    metadata: ExecutionMetadata;
+}
 export interface PipelineContext {
-    readonly slots: Map<SlotKey, unknown>;
-    readonly config: Record<string, unknown>;
-    get<T>(key: SlotKey): T | undefined;
-    require<T>(key: SlotKey): T;
-    set<T>(key: SlotKey, value: T): PipelineContext;
+    readonly slots: ReadonlyMap<SlotKey<any>, unknown>;
+    readonly errors: readonly PipelineError[];
+    readonly warnings: readonly string[];
+    readonly metadata: ExecutionMetadata;
+    readonly config: ClientConfig;
+    get<T>(key: SlotKey<T>): T | undefined;
+    require<T>(key: SlotKey<T>): T;
+    has(key: SlotKey<any>): boolean;
+    set<T>(key: SlotKey<T>, value: T): PipelineContext;
+    delete(key: SlotKey<any>): PipelineContext;
+    addError(error: PipelineError): PipelineContext;
+    addWarning(message: string): PipelineContext;
+    updateMetadata(update: Partial<ExecutionMetadata>): PipelineContext;
+    startPhase(phaseName: string): PipelineContext;
+    completePhase(phaseName: string, status: PhaseExecution['status'], error?: PipelineError): PipelineContext;
+    toJSON(): SerializedContext;
+    clone(): PipelineContext;
 }
 export declare class PipelineContextImpl implements PipelineContext {
-    readonly slots: Map<SlotKey, unknown>;
-    readonly config: Record<string, unknown>;
-    constructor(slots: Map<SlotKey, unknown>, config: Record<string, unknown>);
-    get<T>(key: SlotKey): T | undefined;
-    require<T>(key: SlotKey): T;
-    set<T>(key: SlotKey, value: T): PipelineContext;
+    readonly slots: ReadonlyMap<SlotKey<any>, unknown>;
+    readonly errors: readonly PipelineError[];
+    readonly warnings: readonly string[];
+    readonly metadata: ExecutionMetadata;
+    readonly config: ClientConfig;
+    constructor(slots: ReadonlyMap<SlotKey<any>, unknown>, errors: readonly PipelineError[], warnings: readonly string[], metadata: ExecutionMetadata, config: ClientConfig);
+    get<T>(key: SlotKey<T>): T | undefined;
+    require<T>(key: SlotKey<T>): T;
+    has(key: SlotKey<any>): boolean;
+    set<T>(key: SlotKey<T>, value: T): PipelineContext;
+    delete(key: SlotKey<any>): PipelineContext;
+    addError(error: PipelineError): PipelineContext;
+    addWarning(message: string): PipelineContext;
+    updateMetadata(update: Partial<ExecutionMetadata>): PipelineContext;
+    startPhase(phaseName: string): PipelineContext;
+    completePhase(phaseName: string, status: PhaseExecution['status'], error?: PipelineError): PipelineContext;
+    clone(): PipelineContext;
+    toJSON(): SerializedContext;
 }
-export declare function createContext(config: Record<string, unknown>): PipelineContext;
+export declare function createContext(config: ClientConfig): PipelineContext;
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAEnE,eAAO,MAAM,aAAa,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,KAAG,OAAyB,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC;IACpC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC;IAC5B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC;CACjD;AAED,qBAAa,mBAAoB,YAAW,eAAe;aAEvC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;aAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAD/B,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGjD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;IAInC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC;IAQ3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe;CAKhD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAE9E"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/context.js

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PipelineContextImpl = exports.createSlotKey = void 0;
+exports.PipelineContextImpl = void 0;
 exports.createContext = createContext;
-const createSlotKey = (key) => key;
-exports.createSlotKey = createSlotKey;
 class PipelineContextImpl {
     slots;
+    errors;
+    warnings;
+    metadata;
     config;
-    constructor(slots, config) {
+    constructor(slots, errors, warnings, metadata, config) {
         this.slots = slots;
+        this.errors = errors;
+        this.warnings = warnings;
+        this.metadata = metadata;
         this.config = config;
     }
     get(key) {
@@ -17,18 +21,87 @@ class PipelineContextImpl {
     require(key) {
         const value = this.get(key);
         if (value === undefined) {
-            throw new Error(`Required slot "${key}" not found`);
+            throw new Error(`Required slot "${key}" is not present in context`);
         }
         return value;
     }
+    has(key) {
+        return this.slots.has(key);
+    }
     set(key, value) {
         const newSlots = new Map(this.slots);
         newSlots.set(key, value);
-        return new PipelineContextImpl(newSlots, this.config);
+        return new PipelineContextImpl(newSlots, this.errors, this.warnings, this.metadata, this.config);
+    }
+    delete(key) {
+        const newSlots = new Map(this.slots);
+        newSlots.delete(key);
+        return new PipelineContextImpl(newSlots, this.errors, this.warnings, this.metadata, this.config);
+    }
+    addError(error) {
+        return new PipelineContextImpl(this.slots, [...this.errors, error], this.warnings, this.metadata, this.config);
+    }
+    addWarning(message) {
+        return new PipelineContextImpl(this.slots, this.errors, [...this.warnings, message], this.metadata, this.config);
+    }
+    updateMetadata(update) {
+        return new PipelineContextImpl(this.slots, this.errors, this.warnings, { ...this.metadata, ...update }, this.config);
+    }
+    startPhase(phaseName) {
+        const execution = {
+            phaseName,
+            startedAt: new Date(),
+            status: 'running',
+            slotsRead: [],
+            slotsWritten: [],
+        };
+        return this.updateMetadata({
+            currentPhase: phaseName,
+            phaseHistory: [...this.metadata.phaseHistory, execution],
+        });
+    }
+    completePhase(phaseName, status, error) {
+        const history = [...this.metadata.phaseHistory];
+        const currentPhaseIndex = history.findIndex(h => h.phaseName === phaseName && h.status === 'running');
+        if (currentPhaseIndex === -1) {
+            // Graceful handling if phase wasn't tracked as running
+            return this;
+        }
+        const currentPhase = history[currentPhaseIndex];
+        const completedAt = new Date();
+        const duration = completedAt.getTime() - currentPhase.startedAt.getTime();
+        history[currentPhaseIndex] = {
+            ...currentPhase,
+            completedAt,
+            duration,
+            status,
+            error,
+        };
+        return this.updateMetadata({
+            currentPhase: undefined,
+            phaseHistory: history,
+        });
+    }
+    clone() {
+        return new PipelineContextImpl(new Map(this.slots), [...this.errors], [...this.warnings], { ...this.metadata, phaseHistory: [...this.metadata.phaseHistory] }, this.config);
+    }
+    toJSON() {
+        return {
+            slots: Object.fromEntries(this.slots),
+            errors: this.errors,
+            warnings: this.warnings,
+            metadata: this.metadata,
+        };
     }
 }
 exports.PipelineContextImpl = PipelineContextImpl;
 function createContext(config) {
-    return new PipelineContextImpl(new Map(), config);
+    return new PipelineContextImpl(new Map(), [], [], {
+        pipelineId: config.clientId,
+        executionId: `exec_${Date.now()}`,
+        traceId: `trace_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`,
+        startedAt: new Date(),
+        phaseHistory: [],
+    }, config);
 }
 //# sourceMappingURL=context.js.map

package/dist/pipeline/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":";;;AAsCA,sCAEC;AAtCM,MAAM,aAAa,GAAG,CAAc,GAAW,EAAW,EAAE,CAAC,GAAc,CAAC;AAAtE,QAAA,aAAa,iBAAyD;AAWnF,MAAa,mBAAmB;IAEZ;IACA;IAFlB,YACkB,KAA4B,EAC5B,MAA+B;QAD/B,UAAK,GAAL,KAAK,CAAuB;QAC5B,WAAM,GAAN,MAAM,CAAyB;IAC9C,CAAC;IAEJ,GAAG,CAAI,GAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;IAC9C,CAAC;IAED,OAAO,CAAI,GAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,aAAa,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAI,GAAY,EAAE,KAAQ;QAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC;CACF;AAvBD,kDAuBC;AAED,SAAgB,aAAa,CAAC,MAA+B;IAC3D,OAAO,IAAI,mBAAmB,CAAC,IAAI,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/executor.d.ts

@@ -0,0 +1,24 @@
+import { Phase } from './phase';
+import { PipelineContext } from './context';
+import { PipelineError } from '../types/common';
+export interface PipelineResult {
+    success: boolean;
+    skipped?: boolean;
+    reason?: string;
+    error?: PipelineError;
+    context: PipelineContext;
+    executedPhases: string[];
+    duration: number;
+}
+export type ErrorHandler = (ctx: PipelineContext, error: PipelineError) => Promise<'continue' | 'halt' | 'retry'>;
+export declare class Pipeline {
+    private phases;
+    private errorHandlers;
+    constructor(phases: Phase[], errorHandlers: Map<string, ErrorHandler>);
+    execute(initialCtx: PipelineContext): Promise<PipelineResult>;
+    private validateRequirements;
+    private handleError;
+    private rollback;
+    private toPipelineError;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/pipeline/executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,aAAa,KACjB,OAAO,CAAC,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAe5C,qBAAa,QAAQ;IAEjB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,aAAa;gBADb,MAAM,EAAE,KAAK,EAAE,EACf,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAG5C,OAAO,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAqEnE,OAAO,CAAC,oBAAoB;YAad,WAAW;YAaX,QAAQ;IAgBtB,OAAO,CAAC,eAAe;CAmBxB"}