@plumbus/core 0.1.0

package/dist/flows/engine.js

@@ -0,0 +1,402 @@
+import { and, eq, inArray, isNull, lte, or } from 'drizzle-orm';
+import { randomUUID } from 'node:crypto';
+import { BackoffStrategy } from '../types/enums.js';
+import { flowExecutionsTable } from './schema.js';
+import { FlowStatus, StepStatus, assertTransition, isTerminal, } from './state-machine.js';
+import { buildHistoryEntry, executeStep } from './step-executor.js';
+/**
+ * Creates the flow execution engine that manages flow lifecycle:
+ * start, run steps, handle wait/resume, and persist state.
+ */
+export function createFlowEngine(config) {
+    const { db, registry, stepDeps, audit } = config;
+    /**
+     * Start a new flow execution.
+     */
+    async function start(flowName, input, auth, opts) {
+        const flow = registry.get(flowName);
+        if (!flow) {
+            throw new Error(`Flow "${flowName}" is not registered`);
+        }
+        // Validate input
+        const parseResult = flow.input.safeParse(input);
+        if (!parseResult.success) {
+            throw new Error(`Flow "${flowName}": invalid input — ${parseResult.error.message}`);
+        }
+        const executionId = randomUUID();
+        const initialState = flow.state ? {} : null;
+        await db.insert(flowExecutionsTable).values({
+            id: executionId,
+            flowName,
+            domain: flow.domain,
+            status: FlowStatus.Created,
+            input: parseResult.data,
+            state: initialState,
+            currentStep: flow.steps[0]?.name ?? null,
+            stepHistory: [],
+            actor: auth.userId ?? 'system',
+            tenantId: auth.tenantId ?? null,
+            correlationId: opts?.correlationId ?? null,
+            triggerEventId: opts?.triggerEventId ?? null,
+        });
+        if (audit) {
+            await audit.record(`flow.started.${flowName}`, {
+                executionId,
+                flowName,
+                actor: auth.userId,
+                tenantId: auth.tenantId,
+                outcome: 'success',
+            });
+        }
+        return {
+            id: executionId,
+            flowName,
+            status: FlowStatus.Created,
+        };
+    }
+    /**
+     * Run the next step(s) for a flow execution.
+     * This is designed to be called by a worker process.
+     */
+    async function runNext(executionId, ctx) {
+        const rows = await db
+            .select()
+            .from(flowExecutionsTable)
+            .where(eq(flowExecutionsTable.id, executionId))
+            .limit(1);
+        const row = rows[0];
+        if (!row) {
+            throw new Error(`Flow execution "${executionId}" not found`);
+        }
+        if (isTerminal(row.status)) {
+            return { id: row.id, flowName: row.flowName, status: row.status };
+        }
+        const flow = registry.get(row.flowName);
+        if (!flow) {
+            throw new Error(`Flow "${row.flowName}" is not registered`);
+        }
+        // Do not auto-run event waits, and do not run delayed waits until due.
+        if (row.status === FlowStatus.Waiting && row.waitingForEvent) {
+            return { id: row.id, flowName: row.flowName, status: FlowStatus.Waiting };
+        }
+        if (row.status === FlowStatus.Waiting && row.wakeAt && row.wakeAt.getTime() > Date.now()) {
+            return { id: row.id, flowName: row.flowName, status: FlowStatus.Waiting };
+        }
+        // Transition to running
+        if (row.status === FlowStatus.Created || row.status === FlowStatus.Waiting) {
+            assertTransition(row.status, FlowStatus.Running);
+            await updateExecution(executionId, {
+                status: FlowStatus.Running,
+                waitingForEvent: null,
+                wakeAt: null,
+            });
+        }
+        // Find current step
+        const currentStepName = row.currentStep;
+        if (!currentStepName) {
+            // No more steps — complete the flow
+            await completeFlow(executionId, row.flowName);
+            return { id: executionId, flowName: row.flowName, status: FlowStatus.Completed };
+        }
+        const step = flow.steps.find((s) => s.name === currentStepName);
+        if (!step) {
+            await failFlow(executionId, row.flowName, `Step "${currentStepName}" not found in flow definition`);
+            return { id: executionId, flowName: row.flowName, status: FlowStatus.Failed };
+        }
+        // Build flow-scoped context
+        const flowCtx = {
+            ...ctx,
+            state: row.state,
+            step: currentStepName,
+            flowId: executionId,
+        };
+        // Execute the step
+        const startedAt = new Date();
+        const result = await executeStep(step, flowCtx, row.state, stepDeps);
+        const completedAt = new Date();
+        const historyEntry = buildHistoryEntry(currentStepName, result, startedAt, completedAt);
+        const history = Array.isArray(row.stepHistory) ? row.stepHistory : [];
+        history.push(historyEntry);
+        if (audit) {
+            await audit.record(`flow.step.${result.status}.${currentStepName}`, {
+                executionId,
+                flowName: row.flowName,
+                step: currentStepName,
+                status: result.status,
+                error: result.error,
+            });
+        }
+        // Handle result
+        if (result.status === StepStatus.Failed) {
+            return handleStepFailure(executionId, row, flow, history, result.error);
+        }
+        // Wait step — pause the flow
+        if (result.waitEvent) {
+            await updateExecution(executionId, {
+                status: FlowStatus.Waiting,
+                stepHistory: history,
+                currentStep: currentStepName, // stay on current step until resumed
+                waitingForEvent: result.waitEvent,
+                wakeAt: null,
+            });
+            return { id: executionId, flowName: row.flowName, status: FlowStatus.Waiting };
+        }
+        // Delay step — schedule next step after duration
+        if (result.delayDuration) {
+            const nextStep = getNextStepName(flow.steps, currentStepName);
+            let delayMs;
+            try {
+                delayMs = parseDurationToMs(result.delayDuration);
+            }
+            catch (err) {
+                return handleStepFailure(executionId, row, flow, history, err instanceof Error ? err.message : String(err));
+            }
+            await updateExecution(executionId, {
+                status: FlowStatus.Waiting,
+                stepHistory: history,
+                currentStep: nextStep,
+                waitingForEvent: null,
+                wakeAt: new Date(Date.now() + delayMs),
+            });
+            return { id: executionId, flowName: row.flowName, status: FlowStatus.Waiting };
+        }
+        // Parallel step — execute all branches concurrently, then advance
+        if (result.parallelBranches) {
+            const branchSteps = result.parallelBranches
+                .map((branchName) => flow.steps.find((s) => s.name === branchName))
+                .filter((s) => s != null);
+            const branchResults = await Promise.allSettled(branchSteps.map(async (branchStep) => {
+                const branchStart = new Date();
+                const branchResult = await executeStep(branchStep, flowCtx, row.state, stepDeps);
+                const branchEnd = new Date();
+                return { branchStep, branchResult, branchStart, branchEnd };
+            }));
+            // Merge branch history entries after all branches complete (avoids concurrent mutation)
+            for (const settled of branchResults) {
+                if (settled.status === 'fulfilled') {
+                    const { branchStep, branchResult, branchStart, branchEnd } = settled.value;
+                    history.push(buildHistoryEntry(branchStep.name, branchResult, branchStart, branchEnd));
+                }
+            }
+            const anyFailed = branchResults.some((r) => r.status === 'rejected' ||
+                (r.status === 'fulfilled' && r.value.branchResult.status === StepStatus.Failed));
+            if (anyFailed) {
+                return handleStepFailure(executionId, row, flow, history, 'One or more parallel branches failed');
+            }
+            const nextStep = getNextStepName(flow.steps, currentStepName);
+            await updateExecution(executionId, {
+                stepHistory: history,
+                currentStep: nextStep,
+            });
+            if (!nextStep) {
+                await completeFlow(executionId, row.flowName);
+                return { id: executionId, flowName: row.flowName, status: FlowStatus.Completed };
+            }
+            return { id: executionId, flowName: row.flowName, status: FlowStatus.Running };
+        }
+        // Conditional step — jump to the chosen branch
+        if (result.nextStep) {
+            await updateExecution(executionId, {
+                stepHistory: history,
+                currentStep: result.nextStep,
+            });
+            return { id: executionId, flowName: row.flowName, status: FlowStatus.Running };
+        }
+        // Normal completion — advance to next step
+        const nextStep = getNextStepName(flow.steps, currentStepName);
+        if (!nextStep) {
+            await updateExecution(executionId, { stepHistory: history });
+            await completeFlow(executionId, row.flowName);
+            return { id: executionId, flowName: row.flowName, status: FlowStatus.Completed };
+        }
+        await updateExecution(executionId, {
+            stepHistory: history,
+            currentStep: nextStep,
+        });
+        return { id: executionId, flowName: row.flowName, status: FlowStatus.Running };
+    }
+    /**
+     * Resume a waiting flow (e.g., after an event arrives or approval granted).
+     */
+    async function resume(executionId, signal) {
+        const rows = await db
+            .select()
+            .from(flowExecutionsTable)
+            .where(eq(flowExecutionsTable.id, executionId))
+            .limit(1);
+        const row = rows[0];
+        if (!row)
+            throw new Error(`Flow execution "${executionId}" not found`);
+        if (row.status !== FlowStatus.Waiting) {
+            throw new Error(`Cannot resume flow "${executionId}" — current status is "${row.status}"`);
+        }
+        const flow = registry.get(row.flowName);
+        if (!flow)
+            throw new Error(`Flow "${row.flowName}" not registered`);
+        // Advance past the wait/delay step
+        const nextStep = getNextStepName(flow.steps, row.currentStep ?? '');
+        await updateExecution(executionId, {
+            status: FlowStatus.Running,
+            currentStep: nextStep,
+            state: signal !== undefined ? signal : row.state,
+            waitingForEvent: null,
+            wakeAt: null,
+        });
+    }
+    /**
+     * Resume all flows waiting on a specific event type.
+     * Returns the number of executions resumed.
+     */
+    async function resumeWaitingByEvent(eventType, signal) {
+        const rows = await db
+            .select({ id: flowExecutionsTable.id })
+            .from(flowExecutionsTable)
+            .where(and(eq(flowExecutionsTable.status, FlowStatus.Waiting), eq(flowExecutionsTable.waitingForEvent, eventType)));
+        for (const row of rows) {
+            await resume(row.id, signal);
+        }
+        return rows.length;
+    }
+    /**
+     * Returns execution IDs that should be processed now.
+     */
+    async function listRunnable(limit = 50) {
+        const now = new Date();
+        const rows = await db
+            .select({ id: flowExecutionsTable.id })
+            .from(flowExecutionsTable)
+            .where(or(inArray(flowExecutionsTable.status, [FlowStatus.Created, FlowStatus.Running]), and(eq(flowExecutionsTable.status, FlowStatus.Waiting), isNull(flowExecutionsTable.waitingForEvent), lte(flowExecutionsTable.wakeAt, now))))
+            .limit(limit);
+        return rows.map((row) => row.id);
+    }
+    /**
+     * Cancel a running or waiting flow.
+     */
+    async function cancel(executionId) {
+        const rows = await db
+            .select()
+            .from(flowExecutionsTable)
+            .where(eq(flowExecutionsTable.id, executionId))
+            .limit(1);
+        const row = rows[0];
+        if (!row)
+            throw new Error(`Flow execution "${executionId}" not found`);
+        if (isTerminal(row.status)) {
+            throw new Error(`Cannot cancel flow "${executionId}" — already in terminal state "${row.status}"`);
+        }
+        assertTransition(row.status, FlowStatus.Cancelled);
+        await updateExecution(executionId, {
+            status: FlowStatus.Cancelled,
+            completedAt: new Date(),
+        });
+        if (audit) {
+            await audit.record(`flow.cancelled.${row.flowName}`, {
+                executionId,
+                flowName: row.flowName,
+            });
+        }
+    }
+    /**
+     * Get the current status of a flow execution.
+     */
+    async function status(executionId) {
+        const rows = await db
+            .select()
+            .from(flowExecutionsTable)
+            .where(eq(flowExecutionsTable.id, executionId))
+            .limit(1);
+        const row = rows[0];
+        if (!row)
+            throw new Error(`Flow execution "${executionId}" not found`);
+        return { id: row.id, flowName: row.flowName, status: row.status };
+    }
+    // ── Internal helpers ──
+    async function handleStepFailure(executionId, row, flow, history, error) {
+        const retryCount = row.retryCount + 1;
+        const maxRetries = flow.retry?.attempts ?? 0;
+        if (retryCount <= maxRetries) {
+            // Retry: keep current step, increment counter
+            await updateExecution(executionId, {
+                stepHistory: history,
+                retryCount,
+                lastError: error ?? null,
+            });
+            return { id: executionId, flowName: row.flowName, status: FlowStatus.Running };
+        }
+        // Exhausted retries — fail the flow
+        await failFlow(executionId, row.flowName, error);
+        return { id: executionId, flowName: row.flowName, status: FlowStatus.Failed };
+    }
+    async function completeFlow(executionId, flowName) {
+        await updateExecution(executionId, {
+            status: FlowStatus.Completed,
+            currentStep: null,
+            completedAt: new Date(),
+        });
+        if (audit) {
+            await audit.record(`flow.completed.${flowName}`, { executionId, flowName });
+        }
+    }
+    async function failFlow(executionId, flowName, error) {
+        await updateExecution(executionId, {
+            status: FlowStatus.Failed,
+            lastError: error ?? 'Unknown error',
+            completedAt: new Date(),
+        });
+        if (audit) {
+            await audit.record(`flow.failed.${flowName}`, {
+                executionId,
+                flowName,
+                error,
+            });
+        }
+    }
+    async function updateExecution(id, updates) {
+        await db
+            .update(flowExecutionsTable)
+            .set({ ...updates, updatedAt: new Date() })
+            .where(eq(flowExecutionsTable.id, id));
+    }
+    return { start, runNext, resume, resumeWaitingByEvent, listRunnable, cancel, status };
+}
+/**
+ * Get the next step name in a linear flow sequence.
+ * Returns undefined if we're at the last step.
+ */
+function getNextStepName(steps, currentStepName) {
+    const idx = steps.findIndex((s) => s.name === currentStepName);
+    if (idx === -1 || idx >= steps.length - 1)
+        return undefined;
+    return steps[idx + 1]?.name;
+}
+/**
+ * Compute a retry delay in milliseconds given the retry policy.
+ */
+export function computeRetryDelay(retryCount, backoff, baseDelayMs = 1000) {
+    if (backoff === BackoffStrategy.Exponential) {
+        return baseDelayMs * 2 ** (retryCount - 1);
+    }
+    return baseDelayMs; // fixed
+}
+function parseDurationToMs(duration) {
+    const trimmed = duration.trim().toLowerCase();
+    const match = trimmed.match(/^(\d+)(ms|s|m|h|d)$/);
+    if (!match) {
+        throw new Error(`Invalid delay duration "${duration}". Expected formats like "30s", "5m", "1h".`);
+    }
+    const [, valueRaw, unit] = match;
+    if (!valueRaw || !unit) {
+        throw new Error(`Invalid delay duration "${duration}".`);
+    }
+    const value = parseInt(valueRaw, 10);
+    if (unit === 'ms')
+        return value;
+    if (unit === 's')
+        return value * 1000;
+    if (unit === 'm')
+        return value * 60_000;
+    if (unit === 'h')
+        return value * 3_600_000;
+    return value * 86_400_000;
+}
+//# sourceMappingURL=engine.js.map

package/dist/flows/engine.js.map

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

package/dist/flows/flow-service.d.ts

@@ -0,0 +1,10 @@
+import type { FlowService } from '../types/context.js';
+import type { AuthContext } from '../types/security.js';
+import type { createFlowEngine } from './engine.js';
+/**
+ * Creates a FlowService that wraps the flow engine for use on ctx.flows.
+ * Binds the current auth context so capability handlers can start flows
+ * without passing auth explicitly.
+ */
+export declare function createFlowService(engine: ReturnType<typeof createFlowEngine>, auth: AuthContext): FlowService;
+//# sourceMappingURL=flow-service.d.ts.map

package/dist/flows/flow-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-service.d.ts","sourceRoot":"","sources":["../../src/flows/flow-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAC3C,IAAI,EAAE,WAAW,GAChB,WAAW,CAkBb"}

package/dist/flows/flow-service.js

@@ -0,0 +1,22 @@
+/**
+ * Creates a FlowService that wraps the flow engine for use on ctx.flows.
+ * Binds the current auth context so capability handlers can start flows
+ * without passing auth explicitly.
+ */
+export function createFlowService(engine, auth) {
+    return {
+        async start(flowName, input) {
+            return engine.start(flowName, input, auth);
+        },
+        async resume(executionId, signal) {
+            return engine.resume(executionId, signal);
+        },
+        async cancel(executionId) {
+            return engine.cancel(executionId);
+        },
+        async status(executionId) {
+            return engine.status(executionId);
+        },
+    };
+}
+//# sourceMappingURL=flow-service.js.map

package/dist/flows/flow-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-service.js","sourceRoot":"","sources":["../../src/flows/flow-service.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA2C,EAC3C,IAAiB;IAEjB,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,KAAc;YAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,MAAgB;YAChD,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,WAAmB;YAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,WAAmB;YAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/flows/index.d.ts

@@ -0,0 +1,14 @@
+export { FlowRegistry } from './registry.js';
+export { FlowStatus, StepStatus, assertTransition, isTerminal, isValidTransition, } from './state-machine.js';
+export type { StepHistoryEntry } from './state-machine.js';
+export { flowDeadLetterTable, flowExecutionsTable, flowSchedulesTable, } from './schema.js';
+export { buildHistoryEntry, executeStep } from './step-executor.js';
+export type { StepExecutorDeps, StepResult } from './step-executor.js';
+export { computeRetryDelay, createFlowEngine } from './engine.js';
+export type { FlowEngineConfig } from './engine.js';
+export { createFlowTriggerHandler } from './triggers.js';
+export { computeNextRun, createFlowScheduler } from './scheduler.js';
+export type { SchedulerConfig } from './scheduler.js';
+export { createFlowService } from './flow-service.js';
+export { deadLetterFlow, sweepFailedFlows } from './dead-letter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flows/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EACL,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/flows/index.js

@@ -0,0 +1,25 @@
+// ── Flows Module ──
+// Multi-step workflow engine: state machine, step executor, flow engine,
+// triggers, scheduler, dead-letter handling, and flow service (ctx.flow).
+// Supports capability steps, conditionals, delays, waits, parallel, and event-emit steps.
+//
+// Key exports: createFlowEngine, createFlowService, FlowRegistry, simulateFlow (in testing)
+// ── Flow Registry ──
+export { FlowRegistry } from './registry.js';
+// ── Flow State Machine ──
+export { FlowStatus, StepStatus, assertTransition, isTerminal, isValidTransition, } from './state-machine.js';
+// ── Flow Schemas (Drizzle tables) ──
+export { flowDeadLetterTable, flowExecutionsTable, flowSchedulesTable, } from './schema.js';
+// ── Flow Step Executor ──
+export { buildHistoryEntry, executeStep } from './step-executor.js';
+// ── Flow Engine ──
+export { computeRetryDelay, createFlowEngine } from './engine.js';
+// ── Flow Triggers ──
+export { createFlowTriggerHandler } from './triggers.js';
+// ── Flow Scheduler ──
+export { computeNextRun, createFlowScheduler } from './scheduler.js';
+// ── ctx.flow Service ──
+export { createFlowService } from './flow-service.js';
+// ── Dead Letter ──
+export { deadLetterFlow, sweepFailedFlows } from './dead-letter.js';
+//# sourceMappingURL=index.js.map

package/dist/flows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flows/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,yEAAyE;AACzE,0EAA0E;AAC1E,0FAA0F;AAC1F,EAAE;AACF,4FAA4F;AAE5F,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,2BAA2B;AAC3B,OAAO,EACL,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,sCAAsC;AACtC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGpE,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGlE,sBAAsB;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrE,yBAAyB;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/flows/registry.d.ts

@@ -0,0 +1,47 @@
+import type { FlowDefinition } from '../types/flow.js';
+/**
+ * Registry that holds all discovered/registered flow definitions,
+ * indexed by name for lookup during execution and event triggering.
+ */
+export declare class FlowRegistry {
+    private flows;
+    /**
+     * Register a flow definition. Throws on duplicate names.
+     */
+    register(flow: FlowDefinition): void;
+    /**
+     * Register multiple flow definitions at once.
+     */
+    registerAll(flows: FlowDefinition[]): void;
+    /**
+     * Get a flow definition by name.
+     */
+    get(name: string): FlowDefinition | undefined;
+    /**
+     * Check if a flow is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Return all registered flow definitions.
+     */
+    getAll(): FlowDefinition[];
+    /**
+     * Return all flows for a specific domain.
+     */
+    getByDomain(domain: string): FlowDefinition[];
+    /**
+     * Return all flows that have an event trigger matching the given event type.
+     */
+    getByTriggerEvent(eventType: string): FlowDefinition[];
+    /**
+     * Return all flows that have a schedule configured.
+     */
+    getScheduled(): FlowDefinition[];
+    /**
+     * Scan a directory for flow definition files and register them.
+     * Looks for `.ts` and `.js` files, dynamically imports them,
+     * and registers any exported FlowDefinition (via default or named exports).
+     */
+    discoverFlows(dir: string): Promise<string[]>;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/flows/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqC;IAElD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAOpC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAM1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAI7C;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAItD;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE;IAIhC;;;;OAIG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAkCpD"}