pipework 0.8.7 → 0.8.8

package/dist/pipeline/errors.js

@@ -0,0 +1,28 @@
+import { PipeworkError } from '../errors/base.js';
+export class PipelineStepError extends PipeworkError {
+    code = 'PIPELINE_STEP_FAILED';
+    httpStatus = 500;
+    pipelineName;
+    stepName;
+    stepIndex;
+    constructor(pipelineName, stepName, stepIndex, cause) {
+        const causeMsg = cause instanceof Error ? cause.message : String(cause);
+        super(`Pipeline "${pipelineName}" failed at step ${stepIndex} ("${stepName}"): ${causeMsg}. ` +
+            `Prior steps may have committed. Check pipeline run status for details.`);
+        this.pipelineName = pipelineName;
+        this.stepName = stepName;
+        this.stepIndex = stepIndex;
+    }
+}
+export class PipelineResumeError extends PipeworkError {
+    code = 'PIPELINE_RESUME_FAILED';
+    httpStatus = 409;
+    runId;
+    reason;
+    constructor(runId, reason) {
+        super(`Cannot resume pipeline run "${runId}": ${reason}`);
+        this.runId = runId;
+        this.reason = reason;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/pipeline/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/pipeline/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IACzC,IAAI,GAAG,sBAA+B,CAAA;IACtC,UAAU,GAAG,GAAY,CAAA;IACzB,YAAY,CAAQ;IACpB,QAAQ,CAAQ;IAChB,SAAS,CAAQ;IAE1B,YAAY,YAAoB,EAAE,QAAgB,EAAE,SAAiB,EAAE,KAAc;QACnF,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACvE,KAAK,CACH,aAAa,YAAY,oBAAoB,SAAS,MAAM,QAAQ,OAAO,QAAQ,IAAI;YACvF,wEAAwE,CACzE,CAAA;QACD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAC3C,IAAI,GAAG,wBAAiC,CAAA;IACxC,UAAU,GAAG,GAAY,CAAA;IACzB,KAAK,CAAQ;IACb,MAAM,CAAQ;IAEvB,YAAY,KAAa,EAAE,MAAc;QACvC,KAAK,CACH,+BAA+B,KAAK,MAAM,MAAM,EAAE,CACnD,CAAA;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF"}

package/dist/pipeline/execute.d.ts

@@ -0,0 +1,4 @@
+import type { DB } from '../db/index.js';
+import type { PipelineConfig, PipelineRun, PipelineExecuteContext } from './types.js';
+export declare function executePipeline(db: DB, config: PipelineConfig, input: unknown, context: PipelineExecuteContext): Promise<PipelineRun>;
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/pipeline/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,sBAAsB,EAAe,MAAM,YAAY,CAAA;AAGlG,wBAAsB,eAAe,CACnC,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAsGtB"}

package/dist/pipeline/execute.js

@@ -0,0 +1,90 @@
+import { sql } from '../db/sql.js';
+import { PipelineStepError } from './errors.js';
+export async function executePipeline(db, config, input, context) {
+    const [runRow] = await db.execute(sql `
+    INSERT INTO pipework_pipeline_runs (pipeline_name, tenant_id, status, current_step, input, metadata)
+    VALUES (${config.name}, ${context.tenant}, 'running', 0, ${JSON.stringify(input)}::jsonb, ${JSON.stringify(context.metadata ?? {})}::jsonb)
+    RETURNING id, started_at
+  `);
+    const runId = String(runRow['id']);
+    const startedAt = new Date(String(runRow['started_at']));
+    for (let i = 0; i < config.steps.length; i++) {
+        const step = config.steps[i];
+        await db.execute(sql `
+      INSERT INTO pipework_pipeline_steps (run_id, step_index, step_name, status)
+      VALUES (${runId}::uuid, ${i}, ${step.name}, 'pending')
+    `);
+    }
+    let lastOutput = input;
+    for (let i = 0; i < config.steps.length; i++) {
+        const step = config.steps[i];
+        if (step.async === true) {
+            await db.execute(sql `
+        UPDATE pipework_pipeline_runs SET status = 'waiting', current_step = ${i}
+        WHERE id = ${runId}::uuid
+      `);
+            return {
+                id: runId,
+                pipelineName: config.name,
+                status: 'waiting',
+                currentStep: i,
+                input,
+                startedAt,
+                completedAt: null,
+                error: null,
+            };
+        }
+        await db.execute(sql `
+      UPDATE pipework_pipeline_steps SET status = 'running', started_at = now()
+      WHERE run_id = ${runId}::uuid AND step_index = ${i}
+    `);
+        try {
+            const stepCtx = {
+                db,
+                input: lastOutput,
+                runId,
+                stepIndex: i,
+                tenant: context.tenant,
+                metadata: context.metadata ?? {},
+            };
+            lastOutput = await step.handler(stepCtx);
+            await db.execute(sql `
+        UPDATE pipework_pipeline_steps SET status = 'completed', output = ${JSON.stringify(lastOutput ?? null)}::jsonb, completed_at = now()
+        WHERE run_id = ${runId}::uuid AND step_index = ${i}
+      `);
+            await db.execute(sql `
+        UPDATE pipework_pipeline_runs SET current_step = ${i + 1}
+        WHERE id = ${runId}::uuid
+      `);
+        }
+        catch (error) {
+            const errorJson = error instanceof Error
+                ? { message: error.message, stack: error.stack }
+                : { message: String(error) };
+            await db.execute(sql `
+        UPDATE pipework_pipeline_steps SET status = 'failed', error = ${JSON.stringify(errorJson)}::jsonb, completed_at = now()
+        WHERE run_id = ${runId}::uuid AND step_index = ${i}
+      `);
+            await db.execute(sql `
+        UPDATE pipework_pipeline_runs SET status = 'failed', error = ${JSON.stringify(errorJson)}::jsonb, completed_at = now()
+        WHERE id = ${runId}::uuid
+      `);
+            throw new PipelineStepError(config.name, step.name, i, error);
+        }
+    }
+    await db.execute(sql `
+    UPDATE pipework_pipeline_runs SET status = 'completed', completed_at = now()
+    WHERE id = ${runId}::uuid
+  `);
+    return {
+        id: runId,
+        pipelineName: config.name,
+        status: 'completed',
+        currentStep: config.steps.length,
+        input,
+        startedAt,
+        completedAt: new Date(),
+        error: null,
+    };
+}
+//# sourceMappingURL=execute.js.map

package/dist/pipeline/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/pipeline/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAGlC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAAM,EACN,MAAsB,EACtB,KAAc,EACd,OAA+B;IAE/B,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;;cAEzB,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;;GAEnI,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAEzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAA;QAE7B,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;;gBAER,KAAK,WAAW,CAAC,KAAK,IAAI,CAAC,IAAI;KAC1C,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,UAAU,GAAY,KAAK,CAAA;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAA;QAE7B,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;+EACqD,CAAC;qBAC3D,KAAK;OACnB,CAAC,CAAA;YAEF,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,YAAY,EAAE,MAAM,CAAC,IAAI;gBACzB,MAAM,EAAE,SAAS;gBACjB,WAAW,EAAE,CAAC;gBACd,KAAK;gBACL,SAAS;gBACT,WAAW,EAAE,IAAI;gBACjB,KAAK,EAAE,IAAI;aACZ,CAAA;QACH,CAAC;QAED,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;;uBAED,KAAK,2BAA2B,CAAC;KACnD,CAAC,CAAA;QAEF,IAAI,CAAC;YACH,MAAM,OAAO,GAAgB;gBAC3B,EAAE;gBACF,KAAK,EAAE,UAAU;gBACjB,KAAK;gBACL,SAAS,EAAE,CAAC;gBACZ,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;aACjC,CAAA;YAED,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAExC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;4EACkD,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC;yBACrF,KAAK,2BAA2B,CAAC;OACnD,CAAC,CAAA;YAEF,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;2DACiC,CAAC,GAAG,CAAC;qBAC3C,KAAK;OACnB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,KAAK,YAAY,KAAK;gBACtC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;gBAChD,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;YAE9B,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;wEAC8C,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;yBACxE,KAAK,2BAA2B,CAAC;OACnD,CAAC,CAAA;YAEF,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;uEAC6C,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;qBAC3E,KAAK;OACnB,CAAC,CAAA;YAEF,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IAED,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;;iBAEL,KAAK;GACnB,CAAC,CAAA;IAEF,OAAO;QACL,EAAE,EAAE,KAAK;QACT,YAAY,EAAE,MAAM,CAAC,IAAI;QACzB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;QAChC,KAAK;QACL,SAAS;QACT,WAAW,EAAE,IAAI,IAAI,EAAE;QACvB,KAAK,EAAE,IAAI;KACZ,CAAA;AACH,CAAC"}

package/dist/pipeline/index.d.ts

@@ -0,0 +1,4 @@
+export { definePipeline } from './define.js';
+export { PipelineStepError, PipelineResumeError } from './errors.js';
+export type { PipelineConfig, Pipeline, PipelineRun, PipelineExecuteContext, StepDefinition, StepContext, StepRunResult, PipelineStatus, StepStatus, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACpE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAA"}

package/dist/pipeline/index.js

@@ -0,0 +1,3 @@
+export { definePipeline } from './define.js';
+export { PipelineStepError, PipelineResumeError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}

package/dist/pipeline/namespace.d.ts

@@ -0,0 +1,12 @@
+import { definePipeline } from './define.js';
+import { PipelineStepError, PipelineResumeError } from './errors.js';
+/** Multi-step pipeline namespace — define, execute, pause, and resume ordered step sequences. */
+export declare const pipeline: {
+    /** Defines a pipeline from a config of named steps with handlers. Returns a Pipeline with execute/resume/getStatus. */
+    define: typeof definePipeline;
+    /** Thrown when an individual pipeline step fails. */
+    PipelineStepError: typeof PipelineStepError;
+    /** Thrown when resuming a pipeline from an invalid state. */
+    PipelineResumeError: typeof PipelineResumeError;
+};
+//# sourceMappingURL=namespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/pipeline/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEpE,iGAAiG;AACjG,eAAO,MAAM,QAAQ;IACnB,uHAAuH;;IAEvH,qDAAqD;;IAErD,6DAA6D;;CAE9D,CAAA"}

package/dist/pipeline/namespace.js

@@ -0,0 +1,12 @@
+import { definePipeline } from './define.js';
+import { PipelineStepError, PipelineResumeError } from './errors.js';
+/** Multi-step pipeline namespace — define, execute, pause, and resume ordered step sequences. */
+export const pipeline = {
+    /** Defines a pipeline from a config of named steps with handlers. Returns a Pipeline with execute/resume/getStatus. */
+    define: definePipeline,
+    /** Thrown when an individual pipeline step fails. */
+    PipelineStepError,
+    /** Thrown when resuming a pipeline from an invalid state. */
+    PipelineResumeError,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/pipeline/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/pipeline/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEpE,iGAAiG;AACjG,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,uHAAuH;IACvH,MAAM,EAAE,cAAc;IACtB,qDAAqD;IACrD,iBAAiB;IACjB,6DAA6D;IAC7D,mBAAmB;CACpB,CAAA"}

package/dist/pipeline/resume.d.ts

@@ -0,0 +1,4 @@
+import type { DB } from '../db/index.js';
+import type { PipelineConfig, PipelineRun } from './types.js';
+export declare function resumePipeline(db: DB, config: PipelineConfig, runId: string, stepOutput: unknown): Promise<PipelineRun>;
+//# sourceMappingURL=resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/pipeline/resume.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAe,MAAM,YAAY,CAAA;AAG1E,wBAAsB,cAAc,CAClC,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,WAAW,CAAC,CAmHtB"}

package/dist/pipeline/resume.js

@@ -0,0 +1,100 @@
+import { sql } from '../db/sql.js';
+import { PipelineResumeError, PipelineStepError } from './errors.js';
+export async function resumePipeline(db, config, runId, stepOutput) {
+    const [runRow] = await db.execute(sql `
+    UPDATE pipework_pipeline_runs
+    SET status = 'running'
+    WHERE id = ${runId}::uuid AND status = 'waiting'
+    RETURNING id, current_step, input, tenant_id, metadata, started_at
+  `);
+    if (runRow === undefined) {
+        const [existingRow] = await db.execute(sql `
+      SELECT status FROM pipework_pipeline_runs WHERE id = ${runId}::uuid
+    `);
+        if (existingRow === undefined) {
+            throw new PipelineResumeError(runId, 'Pipeline run not found.');
+        }
+        throw new PipelineResumeError(runId, `Expected status "waiting" but found "${String(existingRow['status'])}".`);
+    }
+    const currentStep = Number(runRow['current_step']);
+    const input = runRow['input'];
+    const tenant = String(runRow['tenant_id']);
+    const metadata = runRow['metadata'] ?? {};
+    const startedAt = new Date(String(runRow['started_at']));
+    await db.execute(sql `
+    UPDATE pipework_pipeline_steps SET status = 'completed', output = ${JSON.stringify(stepOutput ?? null)}::jsonb, completed_at = now()
+    WHERE run_id = ${runId}::uuid AND step_index = ${currentStep}
+  `);
+    let lastOutput = stepOutput;
+    for (let i = currentStep + 1; i < config.steps.length; i++) {
+        const step = config.steps[i];
+        if (step.async === true) {
+            await db.execute(sql `
+        UPDATE pipework_pipeline_runs SET status = 'waiting', current_step = ${i}
+        WHERE id = ${runId}::uuid
+      `);
+            return {
+                id: runId,
+                pipelineName: config.name,
+                status: 'waiting',
+                currentStep: i,
+                input,
+                startedAt,
+                completedAt: null,
+                error: null,
+            };
+        }
+        await db.execute(sql `
+      UPDATE pipework_pipeline_steps SET status = 'running', started_at = now()
+      WHERE run_id = ${runId}::uuid AND step_index = ${i}
+    `);
+        try {
+            const stepCtx = {
+                db,
+                input: lastOutput,
+                runId,
+                stepIndex: i,
+                tenant,
+                metadata,
+            };
+            lastOutput = await step.handler(stepCtx);
+            await db.execute(sql `
+        UPDATE pipework_pipeline_steps SET status = 'completed', output = ${JSON.stringify(lastOutput ?? null)}::jsonb, completed_at = now()
+        WHERE run_id = ${runId}::uuid AND step_index = ${i}
+      `);
+            await db.execute(sql `
+        UPDATE pipework_pipeline_runs SET current_step = ${i + 1}
+        WHERE id = ${runId}::uuid
+      `);
+        }
+        catch (error) {
+            const errorJson = error instanceof Error
+                ? { message: error.message, stack: error.stack }
+                : { message: String(error) };
+            await db.execute(sql `
+        UPDATE pipework_pipeline_steps SET status = 'failed', error = ${JSON.stringify(errorJson)}::jsonb, completed_at = now()
+        WHERE run_id = ${runId}::uuid AND step_index = ${i}
+      `);
+            await db.execute(sql `
+        UPDATE pipework_pipeline_runs SET status = 'failed', error = ${JSON.stringify(errorJson)}::jsonb, completed_at = now()
+        WHERE id = ${runId}::uuid
+      `);
+            throw new PipelineStepError(config.name, step.name, i, error);
+        }
+    }
+    await db.execute(sql `
+    UPDATE pipework_pipeline_runs SET status = 'completed', current_step = ${config.steps.length}, completed_at = now()
+    WHERE id = ${runId}::uuid
+  `);
+    return {
+        id: runId,
+        pipelineName: config.name,
+        status: 'completed',
+        currentStep: config.steps.length,
+        input,
+        startedAt,
+        completedAt: new Date(),
+        error: null,
+    };
+}
+//# sourceMappingURL=resume.js.map

package/dist/pipeline/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/pipeline/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAGlC,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAM,EACN,MAAsB,EACtB,KAAa,EACb,UAAmB;IAEnB,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;;;iBAGtB,KAAK;;GAEnB,CAAC,CAAA;IAEF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;6DACe,KAAK;KAC7D,CAAC,CAAA;QACF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,mBAAmB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAA;QACjE,CAAC;QACD,MAAM,IAAI,mBAAmB,CAC3B,KAAK,EACL,wCAAwC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC1E,CAAA;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAA;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAI,MAAM,CAAC,UAAU,CAAoC,IAAI,EAAE,CAAA;IAC7E,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAExD,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;wEACkD,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC;qBACrF,KAAK,2BAA2B,WAAW;GAC7D,CAAC,CAAA;IAEF,IAAI,UAAU,GAAY,UAAU,CAAA;IAEpC,KAAK,IAAI,CAAC,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAA;QAE7B,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;+EACqD,CAAC;qBAC3D,KAAK;OACnB,CAAC,CAAA;YAEF,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,YAAY,EAAE,MAAM,CAAC,IAAI;gBACzB,MAAM,EAAE,SAAS;gBACjB,WAAW,EAAE,CAAC;gBACd,KAAK;gBACL,SAAS;gBACT,WAAW,EAAE,IAAI;gBACjB,KAAK,EAAE,IAAI;aACZ,CAAA;QACH,CAAC;QAED,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;;uBAED,KAAK,2BAA2B,CAAC;KACnD,CAAC,CAAA;QAEF,IAAI,CAAC;YACH,MAAM,OAAO,GAAgB;gBAC3B,EAAE;gBACF,KAAK,EAAE,UAAU;gBACjB,KAAK;gBACL,SAAS,EAAE,CAAC;gBACZ,MAAM;gBACN,QAAQ;aACT,CAAA;YAED,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAExC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;4EACkD,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC;yBACrF,KAAK,2BAA2B,CAAC;OACnD,CAAC,CAAA;YAEF,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;2DACiC,CAAC,GAAG,CAAC;qBAC3C,KAAK;OACnB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,KAAK,YAAY,KAAK;gBACtC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;gBAChD,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;YAE9B,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;wEAC8C,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;yBACxE,KAAK,2BAA2B,CAAC;OACnD,CAAC,CAAA;YAEF,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;uEAC6C,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;qBAC3E,KAAK;OACnB,CAAC,CAAA;YAEF,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IAED,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;6EACuD,MAAM,CAAC,KAAK,CAAC,MAAM;iBAC/E,KAAK;GACnB,CAAC,CAAA;IAEF,OAAO;QACL,EAAE,EAAE,KAAK;QACT,YAAY,EAAE,MAAM,CAAC,IAAI;QACzB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;QAChC,KAAK;QACL,SAAS;QACT,WAAW,EAAE,IAAI,IAAI,EAAE;QACvB,KAAK,EAAE,IAAI;KACZ,CAAA;AACH,CAAC"}

package/dist/pipeline/types.d.ts

@@ -0,0 +1,50 @@
+import type { DB } from '../db/index.js';
+export interface StepDefinition<TInput = unknown, TOutput = unknown> {
+    readonly name: string;
+    readonly async?: boolean;
+    readonly handler: (ctx: StepContext<TInput>) => Promise<TOutput>;
+}
+export interface StepContext<TInput = unknown> {
+    readonly db: DB;
+    readonly input: TInput;
+    readonly runId: string;
+    readonly stepIndex: number;
+    readonly tenant: string;
+    readonly metadata: Record<string, unknown>;
+}
+export interface PipelineConfig {
+    readonly name: string;
+    readonly database: string;
+    readonly steps: readonly StepDefinition[];
+}
+export type PipelineStatus = 'running' | 'waiting' | 'completed' | 'failed';
+export type StepStatus = 'pending' | 'running' | 'completed' | 'failed';
+export interface PipelineRun {
+    readonly id: string;
+    readonly pipelineName: string;
+    readonly status: PipelineStatus;
+    readonly currentStep: number;
+    readonly input: unknown;
+    readonly startedAt: Date;
+    readonly completedAt: Date | null;
+    readonly error: unknown | null;
+}
+export interface StepRunResult {
+    readonly stepName: string;
+    readonly status: StepStatus;
+    readonly output: unknown | null;
+    readonly startedAt: Date | null;
+    readonly completedAt: Date | null;
+    readonly error: unknown | null;
+}
+export interface PipelineExecuteContext {
+    readonly tenant: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface Pipeline {
+    execute(db: DB, input: unknown, context: PipelineExecuteContext): Promise<PipelineRun>;
+    resume(db: DB, runId: string, stepOutput: unknown): Promise<PipelineRun>;
+    getStatus(db: DB, runId: string): Promise<PipelineRun | null>;
+    readonly definition: PipelineConfig;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AAExC,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,WAAW,CAAC,MAAM,GAAG,OAAO;IAC3C,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAA;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;CAC1C;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;AAC3E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEvE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IACtF,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IACxE,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC7D,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAA;CACpC"}

package/dist/pipeline/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":""}

package/dist/pipework.d.ts

@@ -0,0 +1,88 @@
+import type { ResolvedConfig } from './config/load.js';
+import type { ResolvedDatabase } from './config/load.js';
+import type { Blueprint } from './config/schema.js';
+import type { EnvDefs, ResolveEnvDefs } from './config/env-types.js';
+import type { ManagedConnection } from './db/pool.js';
+import type { Surface } from './surface/types.js';
+import type { LifecycleConfig } from './lifecycle/types.js';
+/** The application instance — holds config, connection pools, surfaces, and lifecycle. */
+export interface Manifold<TEnv extends EnvDefs = EnvDefs> {
+    /** Resolved configuration derived from the Blueprint passed to createManifold. */
+    readonly config: ResolvedConfig;
+    /** Typed environment variables resolved from the `env` config field. */
+    readonly env: Readonly<ResolveEnvDefs<TEnv>>;
+    /** Database connection pool manager — use `pool.getOrCreate(config.database(name))` outside managed contexts. */
+    readonly pool: PoolState;
+    /** Test isolation lifecycle tracker — used internally by pipework/test. */
+    readonly isolation: IsolationState;
+    /** Connection leak detector — tracks active connections for assertNoLeaks(). */
+    readonly connections: ConnectionTracker;
+    /** Returns the names of all registered surfaces (http, worker, script). */
+    surfaceNames(): readonly string[];
+    /** Returns a copy of the surface map keyed by surface name. */
+    surfaceMap(): Readonly<Record<string, Surface>>;
+    /** Starts all surfaces and installs SIGTERM/SIGINT handlers. Throws if already started. */
+    start(): Promise<void>;
+    /** Gracefully shuts down surfaces, runs pre-shutdown hooks, and closes all pools. */
+    stop(): Promise<void>;
+    /** Runs a callback in a managed job context — the canonical entry point for seed scripts and one-off tasks. */
+    seed<T>(fn: () => T | Promise<T>, options?: SeedOptions): Promise<T>;
+}
+export interface SeedOptions {
+    tenant?: string | null;
+    auth?: unknown;
+    jobType?: string;
+}
+/** Manages database connection pools keyed by database name. */
+export interface PoolState {
+    /** Returns existing pool or creates one for this database config. */
+    getOrCreate(config: ResolvedDatabase): ManagedConnection;
+    /** Returns pool by name, or undefined if not yet created. */
+    get(name: string): ManagedConnection | undefined;
+    /** Closes all managed connections. */
+    closeAll(): Promise<void>;
+    /** Number of active connection pools. */
+    count(): number;
+    /** Registers a test-mode connection override. getOrCreate() returns overrides before creating new connections. */
+    override(name: string, conn: ManagedConnection): void;
+    /** Removes all test-mode connection overrides. */
+    clearOverrides(): void;
+}
+/** Tracks test isolation lifecycle — detects leaked isolation contexts. */
+export interface IsolationState {
+    /** Marks the start of an isolation context (e.g. BEGIN in a test). */
+    markBegin(): void;
+    /** Marks the end of an isolation context (e.g. ROLLBACK in a test). */
+    markEnd(): void;
+    /** Throws InvariantViolation if any isolation contexts are still active. */
+    assertClean(): void;
+    /** Returns counts of active, total begins, and total ends. */
+    stats(): {
+        active: number;
+        totalBegins: number;
+        totalEnds: number;
+    };
+    /** Resets all counters — only for test infrastructure. */
+    reset(): void;
+}
+/** Tracks active database connections for leak detection. */
+export interface ConnectionTracker {
+    /** Records a new active connection with its origin context. */
+    track(id: string, name: string, context: string): void;
+    /** Marks a connection as released. */
+    release(id: string): void;
+    /** Number of currently tracked connections. */
+    activeCount(): number;
+    /** Throws InvariantViolation if active connections exceed maxExpected. */
+    assertNoLeaks(maxExpected: number): void;
+}
+/**
+ * Creates the Pipework application instance. This is the entry point for every Pipework app.
+ * Define in `pipework.config.ts` and export as default.
+ */
+export declare function createManifold<const TEnv extends EnvDefs = EnvDefs>(raw: Omit<Blueprint, 'env'> & {
+    env?: TEnv | undefined;
+    surfaces?: Record<string, Surface>;
+    lifecycle?: LifecycleConfig;
+}): Manifold<TEnv>;
+//# sourceMappingURL=pipework.d.ts.map

package/dist/pipework.d.ts.map

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