@tonytang99/integration-core 1.0.0 → 1.2.0

package/dist/pipeline/phase.js

@@ -1,10 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BasePhase = void 0;
+exports.PhaseError = exports.BasePhase = void 0;
 class BasePhase {
-    fail(code, message) {
-        throw new Error(`[${this.name}] ${code}: ${message}`);
+    optionalReads;
+    dependsOn;
+    tags;
+    async shouldSkip(ctx) {
+        return false;
+    }
+    async rollback(ctx, error) {
+        // Default: no rollback action
+    }
+    fail(code, message, recoverable = false, data) {
+        throw new PhaseError(this.name, code, message, recoverable, data);
+    }
+    warn(ctx, message) {
+        return ctx.addWarning(`[${this.name}] ${message}`);
     }
 }
 exports.BasePhase = BasePhase;
+class PhaseError extends Error {
+    phase;
+    code;
+    recoverable;
+    data;
+    cause;
+    constructor(phase, code, message, recoverable, data, cause) {
+        super(message);
+        this.phase = phase;
+        this.code = code;
+        this.recoverable = recoverable;
+        this.data = data;
+        this.cause = cause;
+        this.name = 'PhaseError';
+        Object.setPrototypeOf(this, PhaseError.prototype);
+    }
+}
+exports.PhaseError = PhaseError;
 //# sourceMappingURL=phase.js.map

package/dist/pipeline/phase.js.map

@@ -1 +1 @@
-{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":";;;AAWA,MAAsB,SAAS;IAQnB,IAAI,CAAC,IAAY,EAAE,OAAe;QAC1C,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;CACF;AAXD,8BAWC"}
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":";;;AAsBA,MAAsB,SAAS;IAMpB,aAAa,CAAa;IAC1B,SAAS,CAAY;IACrB,IAAI,CAAY;IAIzB,KAAK,CAAC,UAAU,CAAE,GAAoB;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ,CAAE,GAAoB,EAAE,KAAoB;QACxD,8BAA8B;IAChC,CAAC;IAES,IAAI,CACZ,IAAY,EACZ,OAAe,EACf,WAAW,GAAG,KAAK,EACnB,IAA8B;QAE9B,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAES,IAAI,CAAC,GAAoB,EAAE,OAAe;QAClD,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;CACF;AAhCD,8BAgCC;AAED,MAAa,UAAW,SAAQ,KAAK;IAEjB;IACA;IAEA;IACA;IACA;IANlB,YACkB,KAAa,EACb,IAAY,EAC5B,OAAe,EACC,WAAoB,EACpB,IAA8B,EAC9B,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAPC,UAAK,GAAL,KAAK,CAAQ;QACb,SAAI,GAAJ,IAAI,CAAQ;QAEZ,gBAAW,GAAX,WAAW,CAAS;QACpB,SAAI,GAAJ,IAAI,CAA0B;QAC9B,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAbD,gCAaC"}

package/dist/pipeline/retry.d.ts

@@ -0,0 +1,57 @@
+import { Phase } from './phase';
+import { PipelineContext } from './context';
+import { SlotKey, PipelineError } from '../types/common';
+/**
+ * Configuration for retry behavior
+ */
+export interface RetryPolicy {
+    /** Maximum number of retry attempts (not including initial attempt) */
+    maxAttempts: number;
+    /** Base delay in milliseconds before first retry */
+    baseDelayMs: number;
+    /** Maximum delay in milliseconds (caps exponential backoff) */
+    maxDelayMs: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    backoffMultiplier?: number;
+    /** Error codes that should trigger a retry */
+    retryableErrors?: string[];
+    /** HTTP status codes that should trigger a retry */
+    retryableStatuses?: number[];
+    /** Callback invoked before each retry attempt */
+    onRetry?: (attempt: number, error: PipelineError, delayMs: number) => void;
+    /** Whether to add jitter to delays to prevent thundering herd */
+    jitter?: boolean;
+}
+/**
+ * Default retry policy with sensible defaults
+ */
+export declare const DefaultRetryPolicy: RetryPolicy;
+/**
+ * Wraps a phase with retry logic
+ */
+export declare function withRetry(phase: Phase, policy?: RetryPolicy): Phase;
+/**
+ * Phase wrapper that implements retry logic with exponential backoff
+ */
+declare class RetryPhase implements Phase {
+    private inner;
+    private readonly policy;
+    constructor(inner: Phase, policy: RetryPolicy);
+    get name(): string;
+    get description(): string;
+    get requires(): SlotKey<unknown>[];
+    get produces(): SlotKey<unknown>[];
+    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>;
+    private shouldRetry;
+    private calculateDelay;
+    private toPipelineError;
+    private isPipelineError;
+    private sleep;
+}
+export { RetryPhase };
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/pipeline/retry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3E,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAQhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,GAAE,WAAgC,GAAG,KAAK,CAEvF;AAED;;GAEG;AACH,cAAM,UAAW,YAAW,KAAK;IAI7B,OAAO,CAAC,KAAK;IAHf,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAGrC,KAAK,EAAE,KAAK,EACpB,MAAM,EAAE,WAAW;IAcrB,IAAI,IAAI,WAAyC;IACjD,IAAI,WAAW,WAAuD;IACtE,IAAI,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAgC;IAClE,IAAI,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAgC;IAClE,IAAI,aAAa,0BAAuC;IACxD,IAAI,SAAS,yBAAmC;IAChD,IAAI,IAAI,yBAA8B;IAEhC,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA4BvD,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;IAMzE,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,KAAK;CAGd;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/pipeline/retry.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryPhase = exports.DefaultRetryPolicy = void 0;
+exports.withRetry = withRetry;
+/**
+ * Default retry policy with sensible defaults
+ */
+exports.DefaultRetryPolicy = {
+    maxAttempts: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+    retryableErrors: ['RATE_LIMITED', 'TIMEOUT', 'CONNECTION_ERROR', 'SERVICE_UNAVAILABLE'],
+    retryableStatuses: [408, 429, 500, 502, 503, 504],
+    jitter: true,
+};
+/**
+ * Wraps a phase with retry logic
+ */
+function withRetry(phase, policy = exports.DefaultRetryPolicy) {
+    return new RetryPhase(phase, policy);
+}
+/**
+ * Phase wrapper that implements retry logic with exponential backoff
+ */
+class RetryPhase {
+    inner;
+    policy;
+    constructor(inner, policy) {
+        this.inner = inner;
+        this.policy = {
+            maxAttempts: policy.maxAttempts,
+            baseDelayMs: policy.baseDelayMs,
+            maxDelayMs: policy.maxDelayMs,
+            backoffMultiplier: policy.backoffMultiplier ?? 2,
+            retryableErrors: policy.retryableErrors ?? [],
+            retryableStatuses: policy.retryableStatuses ?? [],
+            onRetry: policy.onRetry ?? (() => { }),
+            jitter: policy.jitter ?? true,
+        };
+    }
+    get name() { return `retry:${this.inner.name}`; }
+    get description() { return `${this.inner.description} (with retry)`; }
+    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) {
+        let lastError;
+        let attempt = 0;
+        while (attempt <= this.policy.maxAttempts) {
+            try {
+                return await this.inner.execute(ctx);
+            }
+            catch (error) {
+                const pipelineError = this.toPipelineError(error);
+                lastError = pipelineError;
+                if (!this.shouldRetry(pipelineError, attempt)) {
+                    throw error;
+                }
+                attempt++;
+                if (attempt <= this.policy.maxAttempts) {
+                    const delay = this.calculateDelay(attempt);
+                    this.policy.onRetry(attempt, pipelineError, delay);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        // Should not reach here, but throw last error if we do
+        throw lastError;
+    }
+    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);
+        }
+    }
+    shouldRetry(error, currentAttempt) {
+        // Don't retry if we've exhausted attempts
+        if (currentAttempt >= this.policy.maxAttempts) {
+            return false;
+        }
+        // Don't retry non-recoverable errors
+        if (!error.recoverable) {
+            return false;
+        }
+        // Check if error code is in retryable list
+        if (this.policy.retryableErrors.includes(error.code)) {
+            return true;
+        }
+        // Check if HTTP status is in retryable list
+        const httpStatus = error.data?.httpStatus ?? 0;
+        if (this.policy.retryableStatuses.includes(httpStatus)) {
+            return true;
+        }
+        // Default: retry all recoverable errors
+        return error.recoverable;
+    }
+    calculateDelay(attempt) {
+        // Exponential backoff: baseDelay * multiplier^(attempt-1)
+        let delay = this.policy.baseDelayMs * Math.pow(this.policy.backoffMultiplier, attempt - 1);
+        // Cap at max delay
+        delay = Math.min(delay, this.policy.maxDelayMs);
+        // Add jitter (0-25% of delay)
+        if (this.policy.jitter) {
+            const jitter = delay * 0.25 * Math.random();
+            delay = delay + jitter;
+        }
+        return Math.floor(delay);
+    }
+    toPipelineError(error) {
+        if (this.isPipelineError(error)) {
+            return error;
+        }
+        const err = error;
+        return {
+            phase: this.inner.name,
+            code: 'UNKNOWN_ERROR',
+            message: err?.message ?? String(error),
+            recoverable: true,
+            stack: err?.stack,
+        };
+    }
+    isPipelineError(error) {
+        return (typeof error === 'object' &&
+            error !== null &&
+            'phase' in error &&
+            'code' in error &&
+            'message' in error);
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.RetryPhase = RetryPhase;
+//# sourceMappingURL=retry.js.map

package/dist/pipeline/retry.js.map

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

package/dist/registry/phase-registry.d.ts

@@ -0,0 +1,24 @@
+import { Phase, PhaseContract } from '../pipeline/phase';
+export type PhaseFactory = (config?: Record<string, unknown>) => Phase;
+export declare class PhaseRegistry {
+    private phases;
+    private tagIndex;
+    private metadata;
+    register(name: string, factory: PhaseFactory, metadata?: PhaseMetadata): this;
+    get(name: string, config?: Record<string, unknown>): Phase;
+    has(name: string): boolean;
+    findByTags(...tags: string[]): Phase[];
+    list(): string[];
+    listByTag(tag: string): string[];
+    describe(name: string): PhaseContract & PhaseMetadata | undefined;
+    describeAll(): Array<PhaseContract & PhaseMetadata>;
+}
+export interface PhaseMetadata {
+    tags?: string[];
+    category?: string;
+    author?: string;
+    version?: string;
+    deprecated?: boolean;
+    deprecationMessage?: string;
+}
+//# sourceMappingURL=phase-registry.d.ts.map

package/dist/registry/phase-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-registry.d.ts","sourceRoot":"","sources":["../../src/registry/phase-registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,CAAC;AAEvE,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAoC;IAEpD,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,QAAQ,GAAE,aAAkB,GAC3B,IAAI;IAeP,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK;IAQ1D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,UAAU,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE;IAWtC,IAAI,IAAI,MAAM,EAAE;IAIhB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAIhC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS;IAmBjE,WAAW,IAAI,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;CAGpD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/registry/phase-registry.js

@@ -0,0 +1,69 @@
+"use strict";
+// ============================================================================
+// packages/core/src/registry/phase-registry.ts
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhaseRegistry = void 0;
+class PhaseRegistry {
+    phases = new Map();
+    tagIndex = new Map();
+    metadata = new Map();
+    register(name, factory, metadata = {}) {
+        this.phases.set(name, factory);
+        this.metadata.set(name, metadata);
+        // Index by tags
+        for (const tag of metadata.tags ?? []) {
+            if (!this.tagIndex.has(tag)) {
+                this.tagIndex.set(tag, new Set());
+            }
+            this.tagIndex.get(tag).add(name);
+        }
+        return this;
+    }
+    get(name, config) {
+        const factory = this.phases.get(name);
+        if (!factory) {
+            throw new Error(`Phase "${name}" not found in registry`);
+        }
+        return factory(config);
+    }
+    has(name) {
+        return this.phases.has(name);
+    }
+    findByTags(...tags) {
+        if (tags.length === 0)
+            return [];
+        const matchingSets = tags.map(t => this.tagIndex.get(t) ?? new Set());
+        const intersection = matchingSets.reduce((acc, set) => new Set([...acc].filter(x => set.has(x))));
+        return [...intersection].map(name => this.get(name));
+    }
+    list() {
+        return [...this.phases.keys()];
+    }
+    listByTag(tag) {
+        return [...(this.tagIndex.get(tag) ?? [])];
+    }
+    describe(name) {
+        const factory = this.phases.get(name);
+        const metadata = this.metadata.get(name);
+        if (!factory)
+            return undefined;
+        // Create instance to read contract
+        const instance = factory({});
+        return {
+            name: instance.name,
+            description: instance.description,
+            requires: instance.requires,
+            produces: instance.produces,
+            optionalReads: instance.optionalReads,
+            dependsOn: instance.dependsOn,
+            tags: instance.tags,
+            ...metadata,
+        };
+    }
+    describeAll() {
+        return this.list().map(name => this.describe(name)).filter(Boolean);
+    }
+}
+exports.PhaseRegistry = PhaseRegistry;
+//# sourceMappingURL=phase-registry.js.map

package/dist/registry/phase-registry.js.map

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

package/dist/slots/well-known-slots.d.ts

@@ -0,0 +1,27 @@
+export interface ValidationIssue {
+    field: string;
+    code: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface SourceMetadata {
+    system: string;
+    originalId: string;
+    fetchedAt: Date;
+    version?: string;
+}
+/**
+ * Core Infrastructure Slots
+ */
+export declare const CoreSlots: {
+    readonly SOURCE_RAW: import("../types/common").SlotKey<unknown>;
+    readonly SOURCE_METADATA: import("../types/common").SlotKey<SourceMetadata>;
+    readonly TARGET_PAYLOAD: import("../types/common").SlotKey<unknown>;
+    readonly TARGET_RESPONSE: import("../types/common").SlotKey<unknown>;
+    readonly CONTROL_SHOULD_HALT: import("../types/common").SlotKey<boolean>;
+    readonly CONTROL_HALT_REASON: import("../types/common").SlotKey<string>;
+    readonly CONTROL_DRY_RUN: import("../types/common").SlotKey<boolean>;
+    readonly PROCESSING_BATCH_ID: import("../types/common").SlotKey<string>;
+    readonly VALIDATION_ISSUES: import("../types/common").SlotKey<ValidationIssue[]>;
+};
+//# sourceMappingURL=well-known-slots.d.ts.map

package/dist/slots/well-known-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known-slots.d.ts","sourceRoot":"","sources":["../../src/slots/well-known-slots.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;CA0BZ,CAAC"}

package/dist/slots/well-known-slots.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreSlots = void 0;
+const common_1 = require("../types/common");
+/**
+ * Core Infrastructure Slots
+ */
+exports.CoreSlots = {
+    // ─────────────────────────────────────
+    // GENERIC SOURCE DATA
+    // ─────────────────────────────────────
+    SOURCE_RAW: (0, common_1.createSlotKey)('source.raw'),
+    SOURCE_METADATA: (0, common_1.createSlotKey)('source.metadata'),
+    // ─────────────────────────────────────
+    // GENERIC TARGET DATA
+    // ─────────────────────────────────────
+    TARGET_PAYLOAD: (0, common_1.createSlotKey)('target.payload'),
+    TARGET_RESPONSE: (0, common_1.createSlotKey)('target.response'),
+    // ─────────────────────────────────────
+    // CONTROL FLOW & META
+    // ─────────────────────────────────────
+    CONTROL_SHOULD_HALT: (0, common_1.createSlotKey)('control.shouldHalt'),
+    CONTROL_HALT_REASON: (0, common_1.createSlotKey)('control.haltReason'),
+    CONTROL_DRY_RUN: (0, common_1.createSlotKey)('control.dryRun'),
+    PROCESSING_BATCH_ID: (0, common_1.createSlotKey)('processing.batchId'),
+    // ─────────────────────────────────────
+    // VALIDATION
+    // ─────────────────────────────────────
+    VALIDATION_ISSUES: (0, common_1.createSlotKey)('validation.issues'),
+};
+//# sourceMappingURL=well-known-slots.js.map

package/dist/slots/well-known-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known-slots.js","sourceRoot":"","sources":["../../src/slots/well-known-slots.ts"],"names":[],"mappings":";;;AAAA,4CAAgD;AAiBhD;;GAEG;AACU,QAAA,SAAS,GAAG;IACvB,wCAAwC;IACxC,sBAAsB;IACtB,wCAAwC;IACxC,UAAU,EAAE,IAAA,sBAAa,EAAU,YAAY,CAAC;IAChD,eAAe,EAAE,IAAA,sBAAa,EAAiB,iBAAiB,CAAC;IAEjE,wCAAwC;IACxC,sBAAsB;IACtB,wCAAwC;IACxC,cAAc,EAAE,IAAA,sBAAa,EAAU,gBAAgB,CAAC;IACxD,eAAe,EAAE,IAAA,sBAAa,EAAU,iBAAiB,CAAC;IAE1D,wCAAwC;IACxC,sBAAsB;IACtB,wCAAwC;IACxC,mBAAmB,EAAE,IAAA,sBAAa,EAAU,oBAAoB,CAAC;IACjE,mBAAmB,EAAE,IAAA,sBAAa,EAAS,oBAAoB,CAAC;IAChE,eAAe,EAAE,IAAA,sBAAa,EAAU,gBAAgB,CAAC;IAEzD,mBAAmB,EAAE,IAAA,sBAAa,EAAS,oBAAoB,CAAC;IAEhE,wCAAwC;IACxC,aAAa;IACb,wCAAwC;IACxC,iBAAiB,EAAE,IAAA,sBAAa,EAAoB,mBAAmB,CAAC;CAChE,CAAC"}

package/dist/types/common.d.ts

@@ -0,0 +1,45 @@
+export type SlotKey<T = unknown> = string & {
+    __brand: 'SlotKey';
+    __type: T;
+};
+/**
+ * Creates a typed slot key.
+ * Usage: const MY_SLOT = createSlotKey<MyType>('my-slot');
+ */
+export declare const createSlotKey: <T = unknown>(key: string) => SlotKey<T>;
+export interface ClientConfig {
+    clientId: string;
+    environment: 'dev' | 'staging' | 'prod';
+    features?: Record<string, boolean>;
+    settings?: Record<string, unknown>;
+}
+export interface PipelineError {
+    phase: string;
+    code: string;
+    message: string;
+    recoverable: boolean;
+    data?: Record<string, unknown>;
+    cause?: unknown;
+    stack?: string;
+    timestamp?: Date;
+}
+export interface PhaseExecution {
+    phaseName: string;
+    startedAt: Date;
+    completedAt?: Date;
+    duration?: number;
+    status: 'running' | 'completed' | 'skipped' | 'failed';
+    error?: PipelineError;
+    slotsRead: string[];
+    slotsWritten: string[];
+}
+export interface ExecutionMetadata {
+    pipelineId: string;
+    executionId: string;
+    traceId: string;
+    startedAt: Date;
+    phaseHistory: PhaseExecution[];
+    currentPhase?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,GAAG;IAC1C,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,KAAG,OAAO,CAAC,CAAC,CACpC,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/common.js

@@ -0,0 +1,11 @@
+"use strict";
+// packages/core/src/types/common.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSlotKey = void 0;
+/**
+ * Creates a typed slot key.
+ * Usage: const MY_SLOT = createSlotKey<MyType>('my-slot');
+ */
+const createSlotKey = (key) => key;
+exports.createSlotKey = createSlotKey;
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;AAYpC;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAc,GAAW,EAAc,EAAE,CACpE,GAA4B,CAAC;AADlB,QAAA,aAAa,iBACK"}

package/dist/types/errors.d.ts

@@ -0,0 +1,62 @@
+import { PipelineError } from './common';
+/**
+ * Categories of errors for classification and handling decisions
+ */
+export declare enum ErrorCategory {
+    /** Input validation failures */
+    VALIDATION = "VALIDATION",
+    /** Network connectivity issues */
+    NETWORK = "NETWORK",
+    /** Authentication failures (invalid credentials, expired tokens) */
+    AUTHENTICATION = "AUTHENTICATION",
+    /** Authorization failures (insufficient permissions) */
+    AUTHORIZATION = "AUTHORIZATION",
+    /** Rate limiting / throttling */
+    RATE_LIMIT = "RATE_LIMIT",
+    /** Resource not found */
+    NOT_FOUND = "NOT_FOUND",
+    /** Conflict (e.g., duplicate, optimistic lock failure) */
+    CONFLICT = "CONFLICT",
+    /** Business logic errors */
+    BUSINESS_LOGIC = "BUSINESS_LOGIC",
+    /** External service errors (5xx from APIs) */
+    SERVICE_ERROR = "SERVICE_ERROR",
+    /** Timeout errors */
+    TIMEOUT = "TIMEOUT",
+    /** Internal system errors */
+    SYSTEM = "SYSTEM",
+    /** Unknown/unclassified errors */
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Extended error interface with categorization
+ */
+export interface CategorizedError extends PipelineError {
+    /** Error category for handling decisions */
+    category: ErrorCategory;
+    /** HTTP status code if applicable */
+    httpStatus?: number;
+    /** Suggested retry delay in milliseconds */
+    retryAfterMs?: number;
+}
+/**
+ * Categorizes an error for handling decisions
+ */
+export declare function categorizeError(error: unknown, phaseName?: string): CategorizedError;
+/**
+ * Helper to check if an error category is retryable
+ */
+export declare function isRetryableCategory(category: ErrorCategory): boolean;
+/**
+ * Helper to create a validation error
+ */
+export declare function validationError(phase: string, message: string, field?: string): CategorizedError;
+/**
+ * Helper to create a not found error
+ */
+export declare function notFoundError(phase: string, resource: string, id?: string): CategorizedError;
+/**
+ * Helper to create a rate limit error
+ */
+export declare function rateLimitError(phase: string, retryAfterMs?: number): CategorizedError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;GAEG;AACH,oBAAY,aAAa;IACvB,gCAAgC;IAChC,UAAU,eAAe;IACzB,kCAAkC;IAClC,OAAO,YAAY;IACnB,oEAAoE;IACpE,cAAc,mBAAmB;IACjC,wDAAwD;IACxD,aAAa,kBAAkB;IAC/B,iCAAiC;IACjC,UAAU,eAAe;IACzB,yBAAyB;IACzB,SAAS,cAAc;IACvB,0DAA0D;IAC1D,QAAQ,aAAa;IACrB,4BAA4B;IAC5B,cAAc,mBAAmB;IACjC,8CAA8C;IAC9C,aAAa,kBAAkB;IAC/B,qBAAqB;IACrB,OAAO,YAAY;IACnB,6BAA6B;IAC7B,MAAM,WAAW;IACjB,kCAAkC;IAClC,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,4CAA4C;IAC5C,QAAQ,EAAE,aAAa,CAAC;IACxB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA6CD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,SAAY,GAAG,gBAAgB,CAyDvF;AA4FD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,gBAAgB,CASlB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,MAAM,GACV,gBAAgB,CAUlB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAUlB"}