@the-real-insight/tri-bpmn-engine 0.1.0

package/dist/worklist/routes.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.worklistRouter = void 0;
+/**
+ * Worklist REST API: /v1/tasks
+ */
+const uuid_1 = require("uuid");
+const express_1 = require("express");
+const client_1 = require("../db/client");
+const collections_1 = require("../db/collections");
+exports.worklistRouter = (0, express_1.Router)();
+exports.worklistRouter.get('/v1/tasks', async (req, res) => {
+    try {
+        const { assigneeUserId, candidateRole, status, instanceId, limit, cursor } = req.query;
+        const db = (0, client_1.getDb)();
+        const { HumanTasks } = (0, collections_1.getCollections)(db);
+        const filter = {};
+        if (status)
+            filter.status = status;
+        else
+            filter.status = 'OPEN';
+        if (assigneeUserId)
+            filter.assigneeUserId = assigneeUserId;
+        if (candidateRole)
+            filter.candidateRoles = candidateRole;
+        if (instanceId)
+            filter.instanceId = instanceId;
+        const limitNum = Math.min(parseInt(String(limit || '50'), 10) || 50, 100);
+        const opts = {
+            limit: limitNum,
+            sort: { createdAt: -1 },
+        };
+        if (cursor)
+            opts.skip = parseInt(String(cursor), 10) || 0;
+        const items = await HumanTasks.find(filter, opts).toArray();
+        const nextCursor = items.length === limitNum ? String((opts.skip ?? 0) + items.length) : undefined;
+        res.json({ items, nextCursor });
+    }
+    catch (err) {
+        res.status(500).json({ error: 'List failed' });
+    }
+});
+exports.worklistRouter.get('/v1/tasks/:taskId', async (req, res) => {
+    try {
+        const db = (0, client_1.getDb)();
+        const { HumanTasks } = (0, collections_1.getCollections)(db);
+        const doc = await HumanTasks.findOne({ _id: req.params.taskId });
+        if (!doc) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        res.json(doc);
+    }
+    catch (err) {
+        res.status(500).json({ error: 'Get failed' });
+    }
+});
+/** Transition OPEN → CLAIMED with assignee; blocks other users. Used by both claim and activate. */
+async function activateTask(db, taskId, userId) {
+    const { HumanTasks } = (0, collections_1.getCollections)(db);
+    const now = new Date();
+    return HumanTasks.findOneAndUpdate({ _id: taskId, status: 'OPEN' }, {
+        $set: { status: 'CLAIMED', assigneeUserId: userId, claimedAt: now },
+        $inc: { version: 1 },
+    }, { returnDocument: 'after' });
+}
+exports.worklistRouter.post('/v1/tasks/:taskId/activate', async (req, res) => {
+    try {
+        const { taskId } = req.params;
+        const { commandId, userId } = req.body;
+        if (!commandId || !userId) {
+            res.status(400).json({ error: 'commandId and userId are required' });
+            return;
+        }
+        const db = (0, client_1.getDb)();
+        const result = await activateTask(db, taskId, userId);
+        if (!result) {
+            const { HumanTasks } = (0, collections_1.getCollections)(db);
+            const existing = await HumanTasks.findOne({ _id: taskId });
+            if (!existing) {
+                res.status(404).json({ error: 'Task not found' });
+            }
+            else {
+                res.status(409).json({ error: 'Task already activated by another user or not OPEN' });
+            }
+            return;
+        }
+        res.json(result);
+    }
+    catch (err) {
+        res.status(500).json({ error: 'Activate failed' });
+    }
+});
+exports.worklistRouter.post('/v1/tasks/:taskId/claim', async (req, res) => {
+    try {
+        const { taskId } = req.params;
+        const { commandId, userId } = req.body;
+        if (!commandId || !userId) {
+            res.status(400).json({ error: 'commandId and userId are required' });
+            return;
+        }
+        const db = (0, client_1.getDb)();
+        const result = await activateTask(db, taskId, userId);
+        if (!result) {
+            const { HumanTasks } = (0, collections_1.getCollections)(db);
+            const existing = await HumanTasks.findOne({ _id: taskId });
+            if (!existing) {
+                res.status(404).json({ error: 'Task not found' });
+            }
+            else {
+                res.status(409).json({ error: 'Task already claimed or not OPEN' });
+            }
+            return;
+        }
+        res.json(result);
+    }
+    catch (err) {
+        res.status(500).json({ error: 'Claim failed' });
+    }
+});
+exports.worklistRouter.post('/v1/tasks/:taskId/unclaim', async (req, res) => {
+    try {
+        const { taskId } = req.params;
+        const { commandId, userId } = req.body;
+        if (!commandId || !userId) {
+            res.status(400).json({ error: 'commandId and userId are required' });
+            return;
+        }
+        const db = (0, client_1.getDb)();
+        const { HumanTasks } = (0, collections_1.getCollections)(db);
+        const now = new Date();
+        const result = await HumanTasks.findOneAndUpdate({ _id: taskId, status: 'CLAIMED', assigneeUserId: userId }, {
+            $set: { status: 'OPEN' },
+            $unset: { assigneeUserId: '', claimedAt: '' },
+            $inc: { version: 1 },
+        }, { returnDocument: 'after' });
+        if (!result) {
+            const existing = await HumanTasks.findOne({ _id: taskId });
+            if (!existing) {
+                res.status(404).json({ error: 'Task not found' });
+            }
+            else {
+                res.status(409).json({ error: 'Task not claimed by user or not CLAIMED' });
+            }
+            return;
+        }
+        res.json(result);
+    }
+    catch (err) {
+        res.status(500).json({ error: 'Unclaim failed' });
+    }
+});
+exports.worklistRouter.post('/v1/tasks/:taskId/complete', async (req, res) => {
+    try {
+        const { taskId } = req.params;
+        const { commandId, userId, result: taskResult } = req.body;
+        if (!commandId || !userId) {
+            res.status(400).json({ error: 'commandId and userId are required' });
+            return;
+        }
+        const db = (0, client_1.getDb)();
+        const cols = (0, collections_1.getCollections)(db);
+        const { HumanTasks, Continuations } = cols;
+        const task = await HumanTasks.findOne({ _id: taskId });
+        if (!task) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        if (task.status !== 'OPEN' && task.status !== 'CLAIMED') {
+            res.status(409).json({ error: 'Task already completed or canceled' });
+            return;
+        }
+        if (task.status === 'CLAIMED' && task.assigneeUserId !== userId) {
+            res.status(403).json({ error: 'Task claimed by another user' });
+            return;
+        }
+        const now = new Date();
+        await Continuations.insertOne({
+            _id: (0, uuid_1.v4)(),
+            instanceId: task.instanceId,
+            dueAt: now,
+            kind: 'WORK_COMPLETED',
+            payload: { workItemId: taskId, commandId, result: taskResult },
+            status: 'READY',
+            attempts: 0,
+            createdAt: now,
+            updatedAt: now,
+        });
+        // Projection will mark COMPLETED when engine emits WORK_ITEM_COMPLETED
+        res.status(202).json({ accepted: true });
+    }
+    catch (err) {
+        res.status(500).json({ error: 'Complete failed' });
+    }
+});
+//# sourceMappingURL=routes.js.map

package/dist/worklist/routes.js.map

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

package/dist/ws/broadcast.d.ts

@@ -0,0 +1,24 @@
+/**
+ * WebSocket broadcast for outbox callbacks and lifecycle events.
+ * Used in REST mode to push to subscribed clients.
+ * In-process handlers (e.g. worklist projection) also receive notifications.
+ */
+import type { WebSocket } from 'ws';
+import type { OutboxDoc, ProcessInstanceEventDoc } from '../db/collections';
+export type StreamPayload = {
+    callbacks?: Array<{
+        kind: string;
+        instanceId: string;
+        payload: Record<string, unknown>;
+    }>;
+    lifecycle?: ProcessInstanceEventDoc[];
+};
+type StreamHandler = (payload: StreamPayload) => void | Promise<void>;
+export declare function addClient(ws: WebSocket): void;
+export declare function removeClient(ws: WebSocket): void;
+export declare function addStreamHandler(handler: StreamHandler): () => void;
+export declare function broadcastOutbox(entries: Omit<OutboxDoc, '_id'>[]): void;
+export declare function broadcastLifecycle(events: ProcessInstanceEventDoc[]): void;
+export declare function broadcastAll(outbox: Omit<OutboxDoc, '_id'>[], events: ProcessInstanceEventDoc[]): void;
+export {};
+//# sourceMappingURL=broadcast.d.ts.map

package/dist/ws/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../src/ws/broadcast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAI5E,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC1F,SAAS,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACvC,CAAC;AAEF,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAItE,wBAAgB,SAAS,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAE7C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAEhD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAGnE;AA8BD,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,CAUvE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAK1E;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAChC,MAAM,EAAE,uBAAuB,EAAE,GAChC,IAAI,CAgBN"}

package/dist/ws/broadcast.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addClient = addClient;
+exports.removeClient = removeClient;
+exports.addStreamHandler = addStreamHandler;
+exports.broadcastOutbox = broadcastOutbox;
+exports.broadcastLifecycle = broadcastLifecycle;
+exports.broadcastAll = broadcastAll;
+const clients = new Set();
+const inProcessHandlers = new Set();
+function addClient(ws) {
+    clients.add(ws);
+}
+function removeClient(ws) {
+    clients.delete(ws);
+}
+function addStreamHandler(handler) {
+    inProcessHandlers.add(handler);
+    return () => inProcessHandlers.delete(handler);
+}
+function broadcastToWebSocket(payload) {
+    const wsPayload = { ...payload };
+    if (payload.callbacks?.length) {
+        wsPayload.type = 'callbacks';
+        wsPayload.items = payload.callbacks.map((c) => ({ kind: c.kind, instanceId: c.instanceId, payload: c.payload }));
+    }
+    const message = JSON.stringify(wsPayload);
+    for (const ws of clients) {
+        if (ws.readyState === 1 /* OPEN */) {
+            try {
+                ws.send(message);
+            }
+            catch (_err) {
+                // Ignore send errors
+            }
+        }
+    }
+}
+async function notifyHandlers(payload) {
+    for (const h of inProcessHandlers) {
+        try {
+            await h(payload);
+        }
+        catch (err) {
+            console.error('Stream handler error:', err);
+        }
+    }
+}
+function broadcastOutbox(entries) {
+    const payload = {
+        callbacks: entries.map((e) => ({
+            kind: e.kind,
+            instanceId: e.instanceId,
+            payload: e.payload,
+        })),
+    };
+    broadcastToWebSocket(payload);
+    void notifyHandlers(payload);
+}
+function broadcastLifecycle(events) {
+    if (events.length === 0)
+        return;
+    const payload = { lifecycle: events };
+    broadcastToWebSocket(payload);
+    void notifyHandlers(payload);
+}
+function broadcastAll(outbox, events) {
+    const payload = {};
+    if (outbox.length > 0) {
+        payload.callbacks = outbox.map((e) => ({
+            kind: e.kind,
+            instanceId: e.instanceId,
+            payload: e.payload,
+        }));
+    }
+    if (events.length > 0) {
+        payload.lifecycle = events;
+    }
+    if (payload.callbacks?.length ?? payload.lifecycle?.length) {
+        broadcastToWebSocket(payload);
+        void notifyHandlers(payload);
+    }
+}
+//# sourceMappingURL=broadcast.js.map

package/dist/ws/broadcast.js.map

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

package/dist/ws/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * WebSocket server for push-based callback notifications.
+ * Clients connect to receive CALLBACK_WORK and CALLBACK_DECISION events in real time.
+ */
+import type { Server } from 'http';
+export declare function attachWebSocketServer(httpServer: Server): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/ws/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ws/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAyB9D"}

package/dist/ws/server.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachWebSocketServer = attachWebSocketServer;
+const ws_1 = require("ws");
+const broadcast_1 = require("./broadcast");
+const WS_PATH = '/ws';
+function attachWebSocketServer(httpServer) {
+    const wss = new ws_1.WebSocketServer({
+        server: httpServer,
+        path: WS_PATH,
+    });
+    wss.on('connection', (ws, req) => {
+        (0, broadcast_1.addClient)(ws);
+        ws.on('close', () => {
+            (0, broadcast_1.removeClient)(ws);
+        });
+        // Optional: client can send { action: 'ping' } for keepalive
+        ws.on('message', (data) => {
+            try {
+                const msg = JSON.parse(data.toString());
+                if (msg.action === 'ping') {
+                    ws.send(JSON.stringify({ type: 'pong' }));
+                }
+            }
+            catch {
+                // Ignore invalid JSON
+            }
+        });
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/ws/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/ws/server.ts"],"names":[],"mappings":";;AAUA,sDAyBC;AA9BD,2BAAqC;AACrC,2CAAsD;AAEtD,MAAM,OAAO,GAAG,KAAK,CAAC;AAEtB,SAAgB,qBAAqB,CAAC,UAAkB;IACtD,MAAM,GAAG,GAAG,IAAI,oBAAe,CAAC;QAC9B,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE;QAC/B,IAAA,qBAAS,EAAC,EAAE,CAAC,CAAC;QAEd,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,IAAA,wBAAY,EAAC,EAAE,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,6DAA6D;QAC7D,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACxC,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC1B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@the-real-insight/tri-bpmn-engine",
+  "version": "0.1.0",
+  "description": "BPMN 2.0 subset execution engine with event sourcing",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./sdk": "./dist/sdk/index.js",
+    "./db": "./dist/db/index.js",
+    "./local": "./dist/local.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node-dev --respawn src/index.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:unit": "jest --testPathPattern=src/",
+    "test:conformance": "jest --testPathPattern=test/scripts/conformance --testTimeout=15000",
+    "test:conformance:watch": "jest --testPathPattern=test/scripts/conformance --watch",
+    "test:callback": "jest --testPathPattern=test/scripts/callback-demo --testTimeout=30000 --silent=false",
+    "test:callback:user": "jest --testPathPattern=test/scripts/callback-demo --testNamePattern=\"User task\" --testTimeout=30000 --silent=false",
+    "test:callback:service": "jest --testPathPattern=test/scripts/callback-demo --testNamePattern=\"Service task\" --testTimeout=30000 --silent=false",
+    "test:integration": "ts-node scripts/test-integration.ts",
+    "cli": "ts-node -r dotenv/config test/cli/interactive.ts",
+    "server": "PORT=9100 ts-node -r ./src/server/load-env src/server/index.ts",
+    "diagram:parallel": "mmdc -i readme/input-parallel-with-subprocess.mmd -o readme/input-parallel-with-subprocess.svg",
+    "test:sdk": "jest --testPathPattern=test/sdk --testTimeout=20000 --runInBand"
+  },
+  "keywords": [
+    "bpmn",
+    "workflow",
+    "engine"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@the-real-insight/tri-model": "^0.0.747",
+    "bpmn-moddle": "^9.0.4",
+    "express": "^4.21.0",
+    "mongodb": "^6.10.0",
+    "multer": "^2.0.2",
+    "uuid": "^10.0.0",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "@mermaid-js/mermaid-cli": "^11.12.0",
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.12",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^22.9.0",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.18.1",
+    "dotenv": "^16.4.5",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.6.3"
+  }
+}