@plumbus/core 0.1.0

package/dist/fields/__tests__/fields.test.js

@@ -0,0 +1,60 @@
+import { describe, expect, it } from 'vitest';
+import { field } from '../index.js';
+describe('field constructors', () => {
+    it('creates an id field', () => {
+        const f = field.id();
+        expect(f.type).toBe('id');
+        expect(f.options).toEqual({});
+    });
+    it('creates a string field with options', () => {
+        const f = field.string({ required: true, unique: true, classification: 'personal' });
+        expect(f.type).toBe('string');
+        expect(f.options.required).toBe(true);
+        expect(f.options.unique).toBe(true);
+        expect(f.options.classification).toBe('personal');
+    });
+    it('creates a number field', () => {
+        const f = field.number({ nullable: true });
+        expect(f.type).toBe('number');
+        expect(f.options.nullable).toBe(true);
+    });
+    it('creates a decimal field', () => {
+        const f = field.decimal({ nullable: true });
+        expect(f.type).toBe('decimal');
+        expect(f.options.nullable).toBe(true);
+    });
+    it('creates a boolean field with default', () => {
+        const f = field.boolean({ default: true });
+        expect(f.type).toBe('boolean');
+        expect(f.options.default).toBe(true);
+    });
+    it('creates a timestamp field', () => {
+        const f = field.timestamp({ maskedInLogs: true });
+        expect(f.type).toBe('timestamp');
+        expect(f.options.maskedInLogs).toBe(true);
+    });
+    it('creates a json field', () => {
+        const f = field.json({ encrypted: true, classification: 'highly_sensitive' });
+        expect(f.type).toBe('json');
+        expect(f.options.encrypted).toBe(true);
+        expect(f.options.classification).toBe('highly_sensitive');
+    });
+    it('creates an enum field', () => {
+        const f = field.enum(['active', 'inactive', 'pending']);
+        expect(f.type).toBe('enum');
+        expect(f.values).toEqual(['active', 'inactive', 'pending']);
+    });
+    it('throws on empty enum values', () => {
+        expect(() => field.enum([])).toThrow('at least one value');
+    });
+    it('creates a relation field', () => {
+        const f = field.relation({ entity: 'Organization', type: 'many-to-one' });
+        expect(f.type).toBe('relation');
+        expect(f.entity).toBe('Organization');
+        expect(f.relationType).toBe('many-to-one');
+    });
+    it('throws on relation without entity', () => {
+        expect(() => field.relation({ entity: '', type: 'one-to-one' })).toThrow('entity name');
+    });
+});
+//# sourceMappingURL=fields.test.js.map

package/dist/fields/__tests__/fields.test.js.map

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

package/dist/fields/index.d.ts

@@ -0,0 +1,18 @@
+import type { FieldClassification, RelationType } from '../types/enums.js';
+import type { BaseFieldOptions, BooleanFieldDescriptor, DecimalFieldDescriptor, EnumFieldDescriptor, IdFieldDescriptor, JsonFieldDescriptor, NumberFieldDescriptor, RelationFieldDescriptor, StringFieldDescriptor, TimestampFieldDescriptor } from '../types/fields.js';
+export declare const field: {
+    readonly id: (options?: BaseFieldOptions) => IdFieldDescriptor;
+    readonly string: (options?: BaseFieldOptions) => StringFieldDescriptor;
+    readonly number: (options?: BaseFieldOptions) => NumberFieldDescriptor;
+    readonly decimal: (options?: BaseFieldOptions) => DecimalFieldDescriptor;
+    readonly boolean: (options?: BaseFieldOptions) => BooleanFieldDescriptor;
+    readonly timestamp: (options?: BaseFieldOptions) => TimestampFieldDescriptor;
+    readonly json: (options?: BaseFieldOptions) => JsonFieldDescriptor;
+    readonly enum: (values: readonly string[], options?: BaseFieldOptions) => EnumFieldDescriptor;
+    readonly relation: (config: {
+        entity: string;
+        type: RelationType;
+        classification?: FieldClassification;
+    }) => RelationFieldDescriptor;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAM5B,eAAO,MAAM,KAAK;4BACH,gBAAgB,KAAG,iBAAiB;gCAIhC,gBAAgB,KAAG,qBAAqB;gCAIxC,gBAAgB,KAAG,qBAAqB;iCAIvC,gBAAgB,KAAG,sBAAsB;iCAIzC,gBAAgB,KAAG,sBAAsB;mCAIvC,gBAAgB,KAAG,wBAAwB;8BAIhD,gBAAgB,KAAG,mBAAmB;4BAIxC,SAAS,MAAM,EAAE,YAAY,gBAAgB,KAAG,mBAAmB;gCAO/D;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,YAAY,CAAC;QACnB,cAAc,CAAC,EAAE,mBAAmB,CAAC;KACtC,KAAG,uBAAuB;CAanB,CAAC"}

package/dist/fields/index.js

@@ -0,0 +1,51 @@
+// ── Fields Module ──
+// Field constructor factory for entity definitions.
+// Provides field.string(), field.number(), field.enum(), field.relation(), etc.
+//
+// Key exports: field (namespace object with typed constructors)
+function opts(o) {
+    return o ?? {};
+}
+export const field = {
+    id(options) {
+        return { type: 'id', options: opts(options) };
+    },
+    string(options) {
+        return { type: 'string', options: opts(options) };
+    },
+    number(options) {
+        return { type: 'number', options: opts(options) };
+    },
+    decimal(options) {
+        return { type: 'decimal', options: opts(options) };
+    },
+    boolean(options) {
+        return { type: 'boolean', options: opts(options) };
+    },
+    timestamp(options) {
+        return { type: 'timestamp', options: opts(options) };
+    },
+    json(options) {
+        return { type: 'json', options: opts(options) };
+    },
+    enum(values, options) {
+        if (!values || values.length === 0) {
+            throw new Error('Enum field requires at least one value');
+        }
+        return { type: 'enum', values, options: opts(options) };
+    },
+    relation(config) {
+        if (!config.entity) {
+            throw new Error('Relation field requires an entity name');
+        }
+        return {
+            type: 'relation',
+            entity: config.entity,
+            relationType: config.type,
+            options: {
+                classification: config.classification,
+            },
+        };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/fields/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,oDAAoD;AACpD,gFAAgF;AAChF,EAAE;AACF,gEAAgE;AAgBhE,SAAS,IAAI,CAAC,CAAoB;IAChC,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,EAAE,CAAC,OAA0B;QAC3B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,OAA0B;QAC/B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,OAA0B;QAC/B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,CAAC,OAA0B;QAChC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,OAA0B;QAChC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,OAA0B;QAClC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,OAA0B;QAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,MAAyB,EAAE,OAA0B;QACxD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1D,CAAC;IAED,QAAQ,CAAC,MAIR;QACC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY,EAAE,MAAM,CAAC,IAAI;YACzB,OAAO,EAAE;gBACP,cAAc,EAAE,MAAM,CAAC,cAAc;aACtC;SACF,CAAC;IACJ,CAAC;CACO,CAAC"}

package/dist/flows/__tests__/flow-engine.test.d.ts

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

package/dist/flows/__tests__/flow-engine.test.d.ts.map

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

package/dist/flows/__tests__/flow-engine.test.js

@@ -0,0 +1,189 @@
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { defineFlow } from '../../define/defineFlow.js';
+import { FlowStepType } from '../../types/enums.js';
+import { createFlowEngine } from '../engine.js';
+import { FlowRegistry } from '../registry.js';
+import { FlowStatus } from '../state-machine.js';
+/**
+ * Creates a mock DB that tracks inserts and updates,
+ * and returns rows from a provided store.
+ */
+function mockDb(rows = new Map()) {
+    const inserts = [];
+    const updates = [];
+    return {
+        _inserts: inserts,
+        _updates: updates,
+        _rows: rows,
+        insert: vi.fn().mockReturnValue({
+            values: vi.fn().mockImplementation((row) => {
+                inserts.push(row);
+                rows.set(row.id, {
+                    ...row,
+                    createdAt: new Date(),
+                    updatedAt: new Date(),
+                    completedAt: null,
+                });
+                return Promise.resolve();
+            }),
+        }),
+        select: vi.fn().mockReturnValue({
+            from: vi.fn().mockReturnValue({
+                where: vi.fn().mockReturnValue({
+                    limit: vi.fn().mockImplementation(() => {
+                        // Return the most recently queried row from the map
+                        const allRows = Array.from(rows.values());
+                        return Promise.resolve(allRows.length > 0 ? [allRows[allRows.length - 1]] : []);
+                    }),
+                }),
+            }),
+        }),
+        update: vi.fn().mockReturnValue({
+            set: vi.fn().mockImplementation((values) => ({
+                where: vi.fn().mockImplementation(() => {
+                    updates.push(values);
+                    // Apply update to last row
+                    const allRows = Array.from(rows.values());
+                    if (allRows.length > 0) {
+                        const last = allRows[allRows.length - 1];
+                        Object.assign(last, values);
+                    }
+                    return Promise.resolve();
+                }),
+            })),
+        }),
+    };
+}
+function makeTestFlow() {
+    return defineFlow({
+        name: 'order-processing',
+        domain: 'orders',
+        input: z.object({ orderId: z.string() }),
+        steps: [
+            { name: 'validate', type: FlowStepType.Capability },
+            { name: 'process', type: FlowStepType.Capability },
+            { name: 'notify', type: FlowStepType.Capability },
+        ],
+    });
+}
+function makeAuth() {
+    return {
+        userId: 'user-1',
+        tenantId: 'tenant-1',
+        roles: ['admin'],
+        scopes: [],
+        provider: 'test',
+    };
+}
+function makeStepDeps(succeeds = true) {
+    return {
+        executeCapability: vi
+            .fn()
+            .mockResolvedValue(succeeds ? { success: true, data: {} } : { success: false, error: 'step failed' }),
+        evaluateCondition: vi.fn().mockReturnValue(true),
+    };
+}
+describe('FlowEngine', () => {
+    it('starts a flow and creates execution record', async () => {
+        const registry = new FlowRegistry();
+        registry.register(makeTestFlow());
+        const db = mockDb();
+        const engine = createFlowEngine({ db, registry, stepDeps: makeStepDeps() });
+        const exec = await engine.start('order-processing', { orderId: '123' }, makeAuth());
+        expect(exec.flowName).toBe('order-processing');
+        expect(exec.status).toBe(FlowStatus.Created);
+        expect(exec.id).toBeTruthy();
+        expect(db._inserts).toHaveLength(1);
+        expect(db._inserts[0].flowName).toBe('order-processing');
+    });
+    it('throws on unregistered flow', async () => {
+        const registry = new FlowRegistry();
+        const db = mockDb();
+        const engine = createFlowEngine({ db, registry, stepDeps: makeStepDeps() });
+        await expect(engine.start('nope', {}, makeAuth())).rejects.toThrow('not registered');
+    });
+    it('validates input against flow schema', async () => {
+        const registry = new FlowRegistry();
+        registry.register(makeTestFlow());
+        const db = mockDb();
+        const engine = createFlowEngine({ db, registry, stepDeps: makeStepDeps() });
+        await expect(engine.start('order-processing', { wrong: 123 }, makeAuth())).rejects.toThrow('invalid input');
+    });
+    it('gets flow execution status', async () => {
+        const registry = new FlowRegistry();
+        registry.register(makeTestFlow());
+        const db = mockDb();
+        const engine = createFlowEngine({ db, registry, stepDeps: makeStepDeps() });
+        const exec = await engine.start('order-processing', { orderId: 'abc' }, makeAuth());
+        // Mock the select to return the created row
+        const row = db._rows.get(exec.id);
+        db.select = vi.fn().mockReturnValue({
+            from: vi.fn().mockReturnValue({
+                where: vi.fn().mockReturnValue({
+                    limit: vi.fn().mockResolvedValue([row]),
+                }),
+            }),
+        });
+        const st = await engine.status(exec.id);
+        expect(st.id).toBe(exec.id);
+        expect(st.flowName).toBe('order-processing');
+    });
+    it('cancels a created flow', async () => {
+        const registry = new FlowRegistry();
+        registry.register(makeTestFlow());
+        const db = mockDb();
+        const engine = createFlowEngine({ db, registry, stepDeps: makeStepDeps() });
+        const exec = await engine.start('order-processing', { orderId: 'abc' }, makeAuth());
+        const row = db._rows.get(exec.id);
+        db.select = vi.fn().mockReturnValue({
+            from: vi.fn().mockReturnValue({
+                where: vi.fn().mockReturnValue({
+                    limit: vi.fn().mockResolvedValue([row]),
+                }),
+            }),
+        });
+        await engine.cancel(exec.id);
+        expect(db._updates.some((u) => u.status === FlowStatus.Cancelled)).toBe(true);
+    });
+    it('throws when cancelling a terminal flow', async () => {
+        const registry = new FlowRegistry();
+        registry.register(makeTestFlow());
+        const rows = new Map();
+        rows.set('x', {
+            id: 'x',
+            flowName: 'order-processing',
+            status: FlowStatus.Completed,
+            currentStep: null,
+            stepHistory: [],
+            state: null,
+            retryCount: 0,
+        });
+        const db = mockDb(rows);
+        db.select = vi.fn().mockReturnValue({
+            from: vi.fn().mockReturnValue({
+                where: vi.fn().mockReturnValue({
+                    limit: vi.fn().mockResolvedValue([rows.get('x')]),
+                }),
+            }),
+        });
+        const engine = createFlowEngine({ db, registry, stepDeps: makeStepDeps() });
+        await expect(engine.cancel('x')).rejects.toThrow('terminal state');
+    });
+    it('records audit events when audit service provided', async () => {
+        const registry = new FlowRegistry();
+        registry.register(makeTestFlow());
+        const db = mockDb();
+        const auditRecords = [];
+        const audit = {
+            record: vi.fn().mockImplementation(async (action, meta) => {
+                auditRecords.push({ action, ...meta });
+            }),
+        };
+        const engine = createFlowEngine({ db, registry, stepDeps: makeStepDeps(), audit });
+        await engine.start('order-processing', { orderId: 'abc' }, makeAuth());
+        expect(auditRecords).toHaveLength(1);
+        expect(auditRecords[0].action).toBe('flow.started.order-processing');
+    });
+});
+//# sourceMappingURL=flow-engine.test.js.map

package/dist/flows/__tests__/flow-engine.test.js.map

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

package/dist/flows/__tests__/flow-registry.test.d.ts

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

package/dist/flows/__tests__/flow-registry.test.d.ts.map

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

package/dist/flows/__tests__/flow-registry.test.js

@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { defineFlow } from '../../define/defineFlow.js';
+import { FlowStepType } from '../../types/enums.js';
+import { FlowRegistry } from '../registry.js';
+function makeFlow(name, domain = 'orders', opts) {
+    return defineFlow({
+        name,
+        domain,
+        input: z.object({ id: z.string() }),
+        steps: [{ name: 'step1', type: FlowStepType.Capability }],
+        trigger: opts?.trigger ? { event: opts.trigger } : undefined,
+        schedule: opts?.schedule ? { cron: opts.schedule } : undefined,
+    });
+}
+describe('FlowRegistry', () => {
+    it('registers and retrieves a flow by name', () => {
+        const reg = new FlowRegistry();
+        const flow = makeFlow('order-processing');
+        reg.register(flow);
+        expect(reg.get('order-processing')).toBe(flow);
+    });
+    it('throws on duplicate registration', () => {
+        const reg = new FlowRegistry();
+        reg.register(makeFlow('order-processing'));
+        expect(() => reg.register(makeFlow('order-processing'))).toThrow('already registered');
+    });
+    it('has() returns correct boolean', () => {
+        const reg = new FlowRegistry();
+        expect(reg.has('nope')).toBe(false);
+        reg.register(makeFlow('order-processing'));
+        expect(reg.has('order-processing')).toBe(true);
+    });
+    it('getAll() lists all flows', () => {
+        const reg = new FlowRegistry();
+        reg.registerAll([makeFlow('a'), makeFlow('b')]);
+        expect(reg.getAll()).toHaveLength(2);
+    });
+    it('getByDomain() filters correctly', () => {
+        const reg = new FlowRegistry();
+        reg.register(makeFlow('a', 'billing'));
+        reg.register(makeFlow('b', 'orders'));
+        reg.register(makeFlow('c', 'billing'));
+        expect(reg.getByDomain('billing')).toHaveLength(2);
+        expect(reg.getByDomain('orders')).toHaveLength(1);
+    });
+    it('getByTriggerEvent() finds flows with matching event trigger', () => {
+        const reg = new FlowRegistry();
+        reg.register(makeFlow('a', 'orders', { trigger: 'order.created' }));
+        reg.register(makeFlow('b', 'orders', { trigger: 'order.updated' }));
+        reg.register(makeFlow('c', 'orders'));
+        expect(reg.getByTriggerEvent('order.created')).toHaveLength(1);
+        expect(reg.getByTriggerEvent('order.created')[0]?.name).toBe('a');
+        expect(reg.getByTriggerEvent('nothing')).toHaveLength(0);
+    });
+    it('getScheduled() returns flows with a schedule', () => {
+        const reg = new FlowRegistry();
+        reg.register(makeFlow('a', 'orders', { schedule: 'every:60m' }));
+        reg.register(makeFlow('b', 'orders'));
+        expect(reg.getScheduled()).toHaveLength(1);
+        expect(reg.getScheduled()[0]?.name).toBe('a');
+    });
+    it('discoverFlows() returns empty array for non-existent directory', async () => {
+        const reg = new FlowRegistry();
+        const result = await reg.discoverFlows('/tmp/non-existent-dir-plumbus');
+        expect(result).toEqual([]);
+    });
+});
+//# sourceMappingURL=flow-registry.test.js.map

package/dist/flows/__tests__/flow-registry.test.js.map

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

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

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

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

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

package/dist/flows/__tests__/flow-service.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createFlowService } from '../flow-service.js';
+describe('FlowService', () => {
+    function mockEngine() {
+        return {
+            start: vi.fn().mockResolvedValue({ id: 'exec-1', flowName: 'test-flow', status: 'created' }),
+            resume: vi.fn().mockResolvedValue(undefined),
+            cancel: vi.fn().mockResolvedValue(undefined),
+            status: vi.fn().mockResolvedValue({ id: 'exec-1', flowName: 'test-flow', status: 'running' }),
+            runNext: vi.fn(),
+        };
+    }
+    const auth = {
+        userId: 'user-1',
+        tenantId: 'tenant-1',
+        roles: ['admin'],
+        scopes: [],
+        provider: 'test',
+    };
+    it('start() delegates to engine with bound auth', async () => {
+        const engine = mockEngine();
+        const svc = createFlowService(engine, auth);
+        const result = await svc.start('test-flow', { data: 1 });
+        expect(result.id).toBe('exec-1');
+        expect(engine.start).toHaveBeenCalledWith('test-flow', { data: 1 }, auth);
+    });
+    it('resume() delegates to engine', async () => {
+        const engine = mockEngine();
+        const svc = createFlowService(engine, auth);
+        await svc.resume('exec-1', { signal: 'approved' });
+        expect(engine.resume).toHaveBeenCalledWith('exec-1', { signal: 'approved' });
+    });
+    it('cancel() delegates to engine', async () => {
+        const engine = mockEngine();
+        const svc = createFlowService(engine, auth);
+        await svc.cancel('exec-1');
+        expect(engine.cancel).toHaveBeenCalledWith('exec-1');
+    });
+    it('status() delegates to engine', async () => {
+        const engine = mockEngine();
+        const svc = createFlowService(engine, auth);
+        const st = await svc.status('exec-1');
+        expect(st.status).toBe('running');
+        expect(engine.status).toHaveBeenCalledWith('exec-1');
+    });
+});
+//# sourceMappingURL=flow-service.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,120 @@
+import { describe, expect, it, vi } from 'vitest';
+import { FlowRegistry } from '../registry.js';
+import { computeNextRun, createFlowScheduler } from '../scheduler.js';
+function mockDb(dueSchedules = []) {
+    return {
+        select: vi.fn().mockReturnValue({
+            from: vi.fn().mockReturnValue({
+                where: vi.fn().mockReturnValue(Promise.resolve(dueSchedules)),
+            }),
+        }),
+        insert: vi.fn().mockReturnValue({
+            values: vi.fn().mockResolvedValue(undefined),
+        }),
+        update: vi.fn().mockReturnValue({
+            set: vi.fn().mockReturnValue({
+                where: vi.fn().mockResolvedValue(undefined),
+            }),
+        }),
+    };
+}
+function mockEngine(succeeds = true) {
+    return {
+        start: succeeds
+            ? vi.fn().mockResolvedValue({ id: 'exec-1', flowName: 'test', status: 'created' })
+            : vi.fn().mockRejectedValue(new Error('engine failure')),
+        runNext: vi.fn(),
+        resume: vi.fn(),
+        cancel: vi.fn(),
+        status: vi.fn(),
+    };
+}
+describe('FlowScheduler', () => {
+    it('polls and triggers due schedules', async () => {
+        const engine = mockEngine();
+        const db = mockDb([{ id: 's1', flowName: 'daily-report', cron: 'every:24h', enabled: true }]);
+        const scheduler = createFlowScheduler({
+            db,
+            registry: new FlowRegistry(),
+            engine: engine,
+        });
+        const triggered = await scheduler.poll();
+        expect(triggered).toBe(1);
+        expect(engine.start).toHaveBeenCalledWith('daily-report', {}, expect.any(Object));
+    });
+    it('skips disabled schedules', async () => {
+        const engine = mockEngine();
+        const db = mockDb([{ id: 's1', flowName: 'disabled-flow', cron: 'every:1h', enabled: false }]);
+        const scheduler = createFlowScheduler({
+            db,
+            registry: new FlowRegistry(),
+            engine: engine,
+        });
+        const triggered = await scheduler.poll();
+        expect(triggered).toBe(0);
+        expect(engine.start).not.toHaveBeenCalled();
+    });
+    it('logs errors on failed flow starts instead of swallowing them', async () => {
+        const engine = mockEngine(false);
+        const logger = {
+            debug: vi.fn(),
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+        };
+        const db = mockDb([{ id: 's1', flowName: 'broken-flow', cron: 'every:1h', enabled: true }]);
+        const scheduler = createFlowScheduler({
+            db,
+            registry: new FlowRegistry(),
+            engine: engine,
+            logger,
+        });
+        const triggered = await scheduler.poll();
+        expect(triggered).toBe(0);
+        expect(logger.error).toHaveBeenCalledWith('Scheduler failed to start flow "broken-flow"', expect.objectContaining({
+            flowName: 'broken-flow',
+            error: 'engine failure',
+        }));
+    });
+    it('starts and stops the polling timer', () => {
+        const scheduler = createFlowScheduler({
+            db: mockDb(),
+            registry: new FlowRegistry(),
+            engine: mockEngine(),
+        });
+        expect(scheduler.isRunning).toBe(false);
+        scheduler.start();
+        expect(scheduler.isRunning).toBe(true);
+        scheduler.stop();
+        expect(scheduler.isRunning).toBe(false);
+    });
+    it('does not start twice', () => {
+        const scheduler = createFlowScheduler({
+            db: mockDb(),
+            registry: new FlowRegistry(),
+            engine: mockEngine(),
+        });
+        scheduler.start();
+        scheduler.start(); // should be idempotent
+        expect(scheduler.isRunning).toBe(true);
+        scheduler.stop();
+    });
+});
+describe('computeNextRun', () => {
+    it('computes next run for minute interval', () => {
+        const from = new Date('2025-01-01T00:00:00Z');
+        const next = computeNextRun('every:30m', from);
+        expect(next.getTime() - from.getTime()).toBe(30 * 60_000);
+    });
+    it('computes next run for hour interval', () => {
+        const from = new Date('2025-01-01T00:00:00Z');
+        const next = computeNextRun('every:2h', from);
+        expect(next.getTime() - from.getTime()).toBe(2 * 3_600_000);
+    });
+    it('computes next run for day interval', () => {
+        const from = new Date('2025-01-01T00:00:00Z');
+        const next = computeNextRun('every:1d', from);
+        expect(next.getTime() - from.getTime()).toBe(86_400_000);
+    });
+});
+//# sourceMappingURL=scheduler.test.js.map