@plumbus/core 0.1.0

package/dist/flows/__tests__/scheduler.test.js.map

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

package/dist/flows/__tests__/state-machine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state-machine.test.d.ts.map

package/dist/flows/__tests__/state-machine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.test.d.ts","sourceRoot":"","sources":["../../../src/flows/__tests__/state-machine.test.ts"],"names":[],"mappings":""}

package/dist/flows/__tests__/state-machine.test.js

@@ -0,0 +1,62 @@
+import { describe, expect, it } from 'vitest';
+import { assertTransition, FlowStatus, isTerminal, isValidTransition } from '../state-machine.js';
+describe('FlowStateMachine', () => {
+    describe('isValidTransition', () => {
+        it('allows created → running', () => {
+            expect(isValidTransition(FlowStatus.Created, FlowStatus.Running)).toBe(true);
+        });
+        it('allows created → cancelled', () => {
+            expect(isValidTransition(FlowStatus.Created, FlowStatus.Cancelled)).toBe(true);
+        });
+        it('allows running → waiting', () => {
+            expect(isValidTransition(FlowStatus.Running, FlowStatus.Waiting)).toBe(true);
+        });
+        it('allows running → completed', () => {
+            expect(isValidTransition(FlowStatus.Running, FlowStatus.Completed)).toBe(true);
+        });
+        it('allows running → failed', () => {
+            expect(isValidTransition(FlowStatus.Running, FlowStatus.Failed)).toBe(true);
+        });
+        it('allows waiting → running (resume)', () => {
+            expect(isValidTransition(FlowStatus.Waiting, FlowStatus.Running)).toBe(true);
+        });
+        it('rejects completed → running', () => {
+            expect(isValidTransition(FlowStatus.Completed, FlowStatus.Running)).toBe(false);
+        });
+        it('rejects failed → running', () => {
+            expect(isValidTransition(FlowStatus.Failed, FlowStatus.Running)).toBe(false);
+        });
+        it('rejects created → completed (skip running)', () => {
+            expect(isValidTransition(FlowStatus.Created, FlowStatus.Completed)).toBe(false);
+        });
+    });
+    describe('assertTransition', () => {
+        it('does not throw for valid transitions', () => {
+            expect(() => assertTransition(FlowStatus.Created, FlowStatus.Running)).not.toThrow();
+        });
+        it('throws for invalid transitions', () => {
+            expect(() => assertTransition(FlowStatus.Completed, FlowStatus.Running)).toThrow('Invalid flow status transition');
+        });
+    });
+    describe('isTerminal', () => {
+        it('completed is terminal', () => {
+            expect(isTerminal(FlowStatus.Completed)).toBe(true);
+        });
+        it('failed is terminal', () => {
+            expect(isTerminal(FlowStatus.Failed)).toBe(true);
+        });
+        it('cancelled is terminal', () => {
+            expect(isTerminal(FlowStatus.Cancelled)).toBe(true);
+        });
+        it('running is not terminal', () => {
+            expect(isTerminal(FlowStatus.Running)).toBe(false);
+        });
+        it('waiting is not terminal', () => {
+            expect(isTerminal(FlowStatus.Waiting)).toBe(false);
+        });
+        it('created is not terminal', () => {
+            expect(isTerminal(FlowStatus.Created)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=state-machine.test.js.map

package/dist/flows/__tests__/state-machine.test.js.map

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

package/dist/flows/__tests__/step-executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=step-executor.test.d.ts.map

package/dist/flows/__tests__/step-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-executor.test.d.ts","sourceRoot":"","sources":["../../../src/flows/__tests__/step-executor.test.ts"],"names":[],"mappings":""}

package/dist/flows/__tests__/step-executor.test.js

@@ -0,0 +1,139 @@
+import { describe, expect, it, vi } from 'vitest';
+import { FlowStepType } from '../../types/enums.js';
+import { StepStatus } from '../state-machine.js';
+import { buildHistoryEntry, executeStep } from '../step-executor.js';
+const mockCtx = {
+    events: { emit: vi.fn().mockResolvedValue(undefined) },
+};
+const defaultDeps = {
+    executeCapability: vi.fn().mockResolvedValue({ success: true, data: {} }),
+    evaluateCondition: vi.fn().mockReturnValue(true),
+};
+describe('StepExecutor', () => {
+    it('executes a capability step successfully', async () => {
+        const step = { name: 'processOrder', type: FlowStepType.Capability };
+        const result = await executeStep(step, mockCtx, {}, defaultDeps);
+        expect(result.status).toBe(StepStatus.Completed);
+        expect(defaultDeps.executeCapability).toHaveBeenCalledWith('processOrder', mockCtx, {});
+    });
+    it('returns failed status when capability fails', async () => {
+        const step = { name: 'badCap', type: FlowStepType.Capability };
+        const deps = {
+            ...defaultDeps,
+            executeCapability: vi.fn().mockResolvedValue({ success: false, error: 'oops' }),
+        };
+        const result = await executeStep(step, mockCtx, {}, deps);
+        expect(result.status).toBe(StepStatus.Failed);
+        expect(result.error).toContain('oops');
+    });
+    it('returns failed status when capability throws', async () => {
+        const step = { name: 'throwCap', type: FlowStepType.Capability };
+        const deps = {
+            ...defaultDeps,
+            executeCapability: vi.fn().mockRejectedValue(new Error('boom')),
+        };
+        const result = await executeStep(step, mockCtx, {}, deps);
+        expect(result.status).toBe(StepStatus.Failed);
+        expect(result.error).toBe('boom');
+    });
+    it('executes a conditional step — true branch', async () => {
+        const step = {
+            name: 'check',
+            type: FlowStepType.Conditional,
+            if: 'amount > 100',
+            then: 'approve',
+            else: 'reject',
+        };
+        const deps = {
+            ...defaultDeps,
+            evaluateCondition: vi.fn().mockReturnValue(true),
+        };
+        const result = await executeStep(step, mockCtx, {}, deps);
+        expect(result.status).toBe(StepStatus.Completed);
+        expect(result.nextStep).toBe('approve');
+    });
+    it('executes a conditional step — false branch', async () => {
+        const step = {
+            name: 'check',
+            type: FlowStepType.Conditional,
+            if: 'amount > 100',
+            then: 'approve',
+            else: 'reject',
+        };
+        const deps = {
+            ...defaultDeps,
+            evaluateCondition: vi.fn().mockReturnValue(false),
+        };
+        const result = await executeStep(step, mockCtx, {}, deps);
+        expect(result.status).toBe(StepStatus.Completed);
+        expect(result.nextStep).toBe('reject');
+    });
+    it('executes a wait step — returns waitEvent', async () => {
+        const step = {
+            name: 'waitForApproval',
+            type: FlowStepType.Wait,
+            event: 'approval.received',
+        };
+        const result = await executeStep(step, mockCtx, {}, defaultDeps);
+        expect(result.status).toBe(StepStatus.Completed);
+        expect(result.waitEvent).toBe('approval.received');
+    });
+    it('executes a delay step — returns delayDuration', async () => {
+        const step = {
+            name: 'cooldown',
+            type: FlowStepType.Delay,
+            duration: '30m',
+        };
+        const result = await executeStep(step, mockCtx, {}, defaultDeps);
+        expect(result.status).toBe(StepStatus.Completed);
+        expect(result.delayDuration).toBe('30m');
+    });
+    it('executes a parallel step — returns branches', async () => {
+        const step = {
+            name: 'parallelWork',
+            type: FlowStepType.Parallel,
+            branches: ['branchA', 'branchB'],
+        };
+        const result = await executeStep(step, mockCtx, {}, defaultDeps);
+        expect(result.status).toBe(StepStatus.Completed);
+        expect(result.parallelBranches).toEqual(['branchA', 'branchB']);
+    });
+    it('executes an event emit step', async () => {
+        const step = {
+            name: 'notifyComplete',
+            type: FlowStepType.EventEmit,
+            event: 'order.shipped',
+        };
+        const result = await executeStep(step, mockCtx, { orderId: '123' }, defaultDeps);
+        expect(result.status).toBe(StepStatus.Completed);
+        expect(mockCtx.events.emit).toHaveBeenCalledWith('order.shipped', { orderId: '123' });
+    });
+    it('event emit step fails gracefully on emit error', async () => {
+        const ctx = {
+            events: { emit: vi.fn().mockRejectedValue(new Error('emit failed')) },
+        };
+        const step = {
+            name: 'failEmit',
+            type: FlowStepType.EventEmit,
+            event: 'order.shipped',
+        };
+        const result = await executeStep(step, ctx, {}, defaultDeps);
+        expect(result.status).toBe(StepStatus.Failed);
+        expect(result.error).toBe('emit failed');
+    });
+});
+describe('buildHistoryEntry', () => {
+    it('creates a history entry', () => {
+        const start = new Date('2026-01-01T00:00:00Z');
+        const end = new Date('2026-01-01T00:00:01Z');
+        const entry = buildHistoryEntry('step1', { status: StepStatus.Completed }, start, end);
+        expect(entry).toEqual({
+            step: 'step1',
+            status: StepStatus.Completed,
+            startedAt: start.toISOString(),
+            completedAt: end.toISOString(),
+            error: undefined,
+        });
+    });
+});
+//# sourceMappingURL=step-executor.test.js.map

package/dist/flows/__tests__/step-executor.test.js.map

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

package/dist/flows/__tests__/triggers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=triggers.test.d.ts.map

package/dist/flows/__tests__/triggers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.test.d.ts","sourceRoot":"","sources":["../../../src/flows/__tests__/triggers.test.ts"],"names":[],"mappings":""}

package/dist/flows/__tests__/triggers.test.js

@@ -0,0 +1,98 @@
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { defineFlow } from '../../define/defineFlow.js';
+import { FlowStepType } from '../../types/enums.js';
+import { FlowRegistry } from '../registry.js';
+import { createFlowTriggerHandler } from '../triggers.js';
+describe('FlowTriggerHandler', () => {
+    it('starts flows matching the event trigger', async () => {
+        const registry = new FlowRegistry();
+        registry.register(defineFlow({
+            name: 'on-order-created',
+            domain: 'orders',
+            input: z.object({}),
+            steps: [{ name: 's1', type: FlowStepType.Capability }],
+            trigger: { event: 'order.created' },
+        }));
+        const started = [];
+        const engine = {
+            start: vi.fn().mockImplementation(async (name, input, auth, opts) => {
+                started.push({ name, input, auth, opts });
+                return { id: 'exec-1', flowName: name, status: 'created' };
+            }),
+            resumeWaitingByEvent: vi.fn().mockResolvedValue(0),
+        };
+        const handler = createFlowTriggerHandler({ registry, engine });
+        const envelope = {
+            id: 'evt-1',
+            eventType: 'order.created',
+            version: '1',
+            occurredAt: new Date(),
+            actor: 'user-1',
+            tenantId: 'tenant-1',
+            correlationId: 'corr-1',
+            payload: { orderId: 'abc' },
+        };
+        const count = await handler.handleEvent(envelope);
+        expect(count).toBe(1);
+        expect(started).toHaveLength(1);
+        expect(started[0].name).toBe('on-order-created');
+        expect(started[0].auth.userId).toBe('user-1');
+        expect(started[0].opts.triggerEventId).toBe('evt-1');
+        expect(started[0].opts.correlationId).toBe('corr-1');
+    });
+    it('returns 0 when no flows match', async () => {
+        const registry = new FlowRegistry();
+        const engine = {
+            start: vi.fn(),
+            resumeWaitingByEvent: vi.fn().mockResolvedValue(0),
+        };
+        const handler = createFlowTriggerHandler({ registry, engine });
+        const envelope = {
+            id: 'evt-2',
+            eventType: 'no.match',
+            version: '1',
+            occurredAt: new Date(),
+            actor: 'user-1',
+            correlationId: 'corr-2',
+            payload: {},
+        };
+        const count = await handler.handleEvent(envelope);
+        expect(count).toBe(0);
+        expect(engine.start).not.toHaveBeenCalled();
+    });
+    it('starts multiple flows when multiple match', async () => {
+        const registry = new FlowRegistry();
+        registry.register(defineFlow({
+            name: 'flow-a',
+            domain: 'orders',
+            input: z.object({}),
+            steps: [{ name: 's1', type: FlowStepType.Capability }],
+            trigger: { event: 'order.created' },
+        }));
+        registry.register(defineFlow({
+            name: 'flow-b',
+            domain: 'notifications',
+            input: z.object({}),
+            steps: [{ name: 's1', type: FlowStepType.Capability }],
+            trigger: { event: 'order.created' },
+        }));
+        const engine = {
+            start: vi.fn().mockResolvedValue({ id: 'x', flowName: 'x', status: 'created' }),
+            resumeWaitingByEvent: vi.fn().mockResolvedValue(0),
+        };
+        const handler = createFlowTriggerHandler({ registry, engine });
+        const count = await handler.handleEvent({
+            id: 'evt-3',
+            eventType: 'order.created',
+            version: '1',
+            occurredAt: new Date(),
+            actor: 'user-1',
+            correlationId: 'corr-3',
+            payload: {},
+        });
+        expect(count).toBe(2);
+        expect(engine.start).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=triggers.test.js.map

package/dist/flows/__tests__/triggers.test.js.map

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

package/dist/flows/dead-letter.d.ts

@@ -0,0 +1,12 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+/**
+ * Moves failed flow executions to the dead-letter table.
+ * Call this after a flow has exhausted retries and entered Failed status.
+ */
+export declare function deadLetterFlow(db: PostgresJsDatabase, executionId: string): Promise<void>;
+/**
+ * Scans for failed flow executions and moves them to dead-letter.
+ * Returns the number of executions moved.
+ */
+export declare function sweepFailedFlows(db: PostgresJsDatabase, limit?: number): Promise<number>;
+//# sourceMappingURL=dead-letter.d.ts.map

package/dist/flows/dead-letter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.d.ts","sourceRoot":"","sources":["../../src/flows/dead-letter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE;;;GAGG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC/F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB3F"}

package/dist/flows/dead-letter.js

@@ -0,0 +1,63 @@
+import { eq } from 'drizzle-orm';
+import { flowDeadLetterTable, flowExecutionsTable } from './schema.js';
+import { FlowStatus } from './state-machine.js';
+/**
+ * Moves failed flow executions to the dead-letter table.
+ * Call this after a flow has exhausted retries and entered Failed status.
+ */
+export async function deadLetterFlow(db, 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 (row.status !== FlowStatus.Failed) {
+        throw new Error(`Cannot dead-letter flow "${executionId}" — status is "${row.status}", expected "failed"`);
+    }
+    await db
+        .insert(flowDeadLetterTable)
+        .values({
+        executionId: row.id,
+        flowName: row.flowName,
+        input: row.input,
+        state: row.state,
+        stepHistory: row.stepHistory,
+        lastError: row.lastError,
+        retryCount: row.retryCount,
+        metadata: {
+            actor: row.actor,
+            tenantId: row.tenantId,
+            correlationId: row.correlationId,
+            triggerEventId: row.triggerEventId,
+            createdAt: row.createdAt?.toISOString(),
+            failedAt: row.completedAt?.toISOString(),
+        },
+    })
+        .onConflictDoNothing({ target: flowDeadLetterTable.executionId });
+}
+/**
+ * Scans for failed flow executions and moves them to dead-letter.
+ * Returns the number of executions moved.
+ */
+export async function sweepFailedFlows(db, limit = 100) {
+    const failedRows = await db
+        .select({ id: flowExecutionsTable.id })
+        .from(flowExecutionsTable)
+        .where(eq(flowExecutionsTable.status, FlowStatus.Failed))
+        .limit(limit);
+    let moved = 0;
+    for (const row of failedRows) {
+        try {
+            await deadLetterFlow(db, row.id);
+            moved++;
+        }
+        catch {
+            // Skip rows that fail to move — will be retried next sweep
+        }
+    }
+    return moved;
+}
+//# sourceMappingURL=dead-letter.js.map

package/dist/flows/dead-letter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.js","sourceRoot":"","sources":["../../src/flows/dead-letter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAsB,EAAE,WAAmB;IAC9E,MAAM,IAAI,GAAG,MAAM,EAAE;SAClB,MAAM,EAAE;SACR,IAAI,CAAC,mBAAmB,CAAC;SACzB,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;SAC9C,KAAK,CAAC,CAAC,CAAC,CAAC;IAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,WAAW,aAAa,CAAC,CAAC;IAEvE,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,4BAA4B,WAAW,kBAAkB,GAAG,CAAC,MAAM,sBAAsB,CAC1F,CAAC;IACJ,CAAC;IAED,MAAM,EAAE;SACL,MAAM,CAAC,mBAAmB,CAAC;SAC3B,MAAM,CAAC;QACN,WAAW,EAAE,GAAG,CAAC,EAAE;QACnB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAY;QACvB,KAAK,EAAE,GAAG,CAAC,KAAY;QACvB,WAAW,EAAE,GAAG,CAAC,WAAkB;QACnC,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,QAAQ,EAAE;YACR,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE;YACvC,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE;SACzC;KACF,CAAC;SACD,mBAAmB,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAsB,EAAE,KAAK,GAAG,GAAG;IACxE,MAAM,UAAU,GAAG,MAAM,EAAE;SACxB,MAAM,CAAC,EAAE,EAAE,EAAE,mBAAmB,CAAC,EAAE,EAAE,CAAC;SACtC,IAAI,CAAC,mBAAmB,CAAC;SACzB,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;SACxD,KAAK,CAAC,KAAK,CAAC,CAAC;IAEhB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,KAAK,EAAE,CAAC;QACV,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/flows/engine.d.ts

@@ -0,0 +1,35 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import type { EventQueue } from '../events/queue.js';
+import type { AuditService } from '../types/audit.js';
+import type { ExecutionContext, FlowExecution } from '../types/context.js';
+import type { AuthContext } from '../types/security.js';
+import type { FlowRegistry } from './registry.js';
+import { type StepExecutorDeps } from './step-executor.js';
+export interface FlowEngineConfig {
+    db: PostgresJsDatabase;
+    registry: FlowRegistry;
+    stepDeps: StepExecutorDeps;
+    audit?: AuditService;
+    queue?: EventQueue;
+}
+/**
+ * Creates the flow execution engine that manages flow lifecycle:
+ * start, run steps, handle wait/resume, and persist state.
+ */
+export declare function createFlowEngine(config: FlowEngineConfig): {
+    start: (flowName: string, input: unknown, auth: AuthContext, opts?: {
+        correlationId?: string;
+        triggerEventId?: string;
+    }) => Promise<FlowExecution>;
+    runNext: (executionId: string, ctx: ExecutionContext) => Promise<FlowExecution>;
+    resume: (executionId: string, signal?: unknown) => Promise<void>;
+    resumeWaitingByEvent: (eventType: string, signal?: unknown) => Promise<number>;
+    listRunnable: (limit?: number) => Promise<string[]>;
+    cancel: (executionId: string) => Promise<void>;
+    status: (executionId: string) => Promise<FlowExecution>;
+};
+/**
+ * Compute a retry delay in milliseconds given the retry policy.
+ */
+export declare function computeRetryDelay(retryCount: number, backoff: string, baseDelayMs?: number): number;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/flows/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AASlD,OAAO,EAAkC,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,kBAAkB,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAsCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB;sBAO3C,MAAM,SACT,OAAO,QACR,WAAW,SACV;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,KACzD,OAAO,CAAC,aAAa,CAAC;2BAmDW,MAAM,OAAO,gBAAgB,KAAG,OAAO,CAAC,aAAa,CAAC;0BA4MvD,MAAM,WAAW,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;sCAiC5B,MAAM,WAAW,OAAO,KAAG,OAAO,CAAC,MAAM,CAAC;sCAoBhD,OAAO,CAAC,MAAM,EAAE,CAAC;0BAuBvB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;0BAiCtB,MAAM,KAAG,OAAO,CAAC,aAAa,CAAC;EA0EnE;AAYD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,SAAO,GAAG,MAAM,CAKjG"}