ts-workflow-engine-lite 2.1.0

package/dist/src/api/routes/dlq.js

@@ -0,0 +1,248 @@
+import { Router } from "express";
+import { parseEnvInt } from "../../utils/env.js";
+import { Logger } from "../../utils/Logger.js";
+import { sendError, sendSuccess } from "../response.js";
+const router = Router();
+const VALID_STATUSES = [
+    "pending",
+    "retried",
+    "acknowledged",
+    "permanently_failed",
+];
+function getMaxRetries() {
+    return parseEnvInt(process.env.DLQ_MAX_RETRIES, 5, { min: 0 });
+}
+function getBatchMaxSize() {
+    return parseEnvInt(process.env.BATCH_MAX_SIZE, 100, { min: 1 });
+}
+function parseBatchIds(req, res) {
+    const ids = req.body?.ids;
+    if (!Array.isArray(ids) || ids.length === 0) {
+        sendError(res, 400, 400, "Body must contain a non-empty ids array");
+        return null;
+    }
+    const max = getBatchMaxSize();
+    if (ids.length > max) {
+        sendError(res, 400, 400, `Batch size exceeds limit (${max})`);
+        return null;
+    }
+    return ids.map(String);
+}
+function requireDlq(req) {
+    if (!req.dlq) {
+        throw new Error("DLQ is not available on request context");
+    }
+    return req.dlq;
+}
+function requireRetryEngine(req) {
+    if (!req.engine) {
+        throw new Error("Workflow engine is not available on request context");
+    }
+    return req.engine;
+}
+async function retryEntry(dlq, engine, id) {
+    const entry = await dlq.get(id);
+    if (!entry) {
+        return { ok: false, error: "DLQ entry not found", statusCode: 404 };
+    }
+    if (entry.status === "permanently_failed") {
+        return {
+            ok: false,
+            error: "Entry is permanently failed",
+            statusCode: 429,
+        };
+    }
+    if (entry.retryCount >= getMaxRetries()) {
+        await dlq.updateStatus(id, "permanently_failed");
+        return {
+            ok: false,
+            error: `Max retries (${getMaxRetries()}) exceeded`,
+            statusCode: 429,
+        };
+    }
+    if (entry.type !== "workflow" || !entry.workflowId) {
+        return {
+            ok: false,
+            error: "Retry not supported for this entry type",
+            statusCode: 400,
+        };
+    }
+    await dlq.incrementRetry(id);
+    const newInstanceId = await engine.start(entry.workflowId, entry.payload?.context || {});
+    await dlq.updateStatus(id, "retried");
+    await dlq.remove(id);
+    return { ok: true, newInstanceId, statusCode: 200 };
+}
+router.get("/", async (req, res) => {
+    try {
+        const dlq = requireDlq(req);
+        const limit = Number.parseInt(req.query.limit, 10) || 100;
+        const offset = Number.parseInt(req.query.offset, 10) || 0;
+        const type = req.query.type;
+        const workflowId = req.query.workflowId;
+        const result = await dlq.list({ limit, offset, type, workflowId });
+        return sendSuccess(res, 200, {
+            entries: result.entries,
+            pagination: {
+                total: result.total,
+                limit,
+                offset,
+            },
+        }, "DLQ entries retrieved");
+    }
+    catch (error) {
+        Logger.error("api", "dlq", "Failed to list DLQ entries", error instanceof Error ? error.stack : String(error));
+        return sendError(res, 500, 500, "Failed to list DLQ entries");
+    }
+});
+router.get("/stats", (req, res) => {
+    void (async () => {
+        try {
+            const dlq = requireDlq(req);
+            const stats = await dlq.getStats();
+            return sendSuccess(res, 200, stats, "DLQ stats retrieved");
+        }
+        catch (error) {
+            Logger.error("api", "dlq", "Failed to get DLQ stats", error instanceof Error ? error.stack : String(error));
+            return sendError(res, 500, 500, "Failed to get DLQ stats");
+        }
+    })();
+});
+router.get("/:id", async (req, res) => {
+    try {
+        const dlq = requireDlq(req);
+        const id = req.params.id;
+        const entry = await dlq.get(id);
+        if (!entry) {
+            return sendError(res, 404, 404, "DLQ entry not found");
+        }
+        return sendSuccess(res, 200, entry, "DLQ entry retrieved");
+    }
+    catch (error) {
+        Logger.error("api", "dlq", "Failed to get DLQ entry", error instanceof Error ? error.stack : String(error));
+        return sendError(res, 500, 500, "Failed to get DLQ entry");
+    }
+});
+router.delete("/:id", async (req, res) => {
+    try {
+        const dlq = requireDlq(req);
+        const id = req.params.id;
+        const removed = await dlq.remove(id);
+        return removed
+            ? sendSuccess(res, 200, { removed }, "Entry removed")
+            : sendError(res, 404, 404, "Entry not found");
+    }
+    catch (error) {
+        Logger.error("api", "dlq", "Failed to remove DLQ entry", error instanceof Error ? error.stack : String(error));
+        return sendError(res, 500, 500, "Failed to remove DLQ entry");
+    }
+});
+router.post("/clear", async (req, res) => {
+    try {
+        const dlq = requireDlq(req);
+        const count = await dlq.clear();
+        return sendSuccess(res, 200, { cleared: count }, "DLQ cleared");
+    }
+    catch (error) {
+        Logger.error("api", "dlq", "Failed to clear DLQ", error instanceof Error ? error.stack : String(error));
+        return sendError(res, 500, 500, "Failed to clear DLQ");
+    }
+});
+router.post("/batch/retry", async (req, res) => {
+    try {
+        const dlq = requireDlq(req);
+        const engine = requireRetryEngine(req);
+        const ids = parseBatchIds(req, res);
+        if (!ids)
+            return;
+        const results = [];
+        for (const id of ids) {
+            try {
+                const outcome = await retryEntry(dlq, engine, id);
+                results.push({
+                    id,
+                    ok: outcome.ok,
+                    newInstanceId: outcome.newInstanceId,
+                    error: outcome.error,
+                });
+            }
+            catch (error) {
+                results.push({
+                    id,
+                    ok: false,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        const succeeded = results.filter((r) => r.ok).length;
+        return sendSuccess(res, 200, { succeeded, failed: results.length - succeeded, results }, "Batch retry completed");
+    }
+    catch (error) {
+        Logger.error("api", "dlq", "Failed to batch retry DLQ entries", error instanceof Error ? error.stack : String(error));
+        return sendError(res, 500, 500, "Failed to batch retry DLQ entries");
+    }
+});
+router.post("/batch/delete", async (req, res) => {
+    try {
+        const dlq = requireDlq(req);
+        const ids = parseBatchIds(req, res);
+        if (!ids)
+            return;
+        const results = [];
+        for (const id of ids) {
+            const entry = await dlq.get(id);
+            if (!entry) {
+                results.push({ id, ok: false, error: "DLQ entry not found" });
+                continue;
+            }
+            const removed = await dlq.remove(id);
+            results.push(removed
+                ? { id, ok: true }
+                : { id, ok: false, error: "Failed to remove entry" });
+        }
+        const succeeded = results.filter((r) => r.ok).length;
+        return sendSuccess(res, 200, { succeeded, failed: results.length - succeeded, results }, "Batch delete completed");
+    }
+    catch (error) {
+        Logger.error("api", "dlq", "Failed to batch delete DLQ entries", error instanceof Error ? error.stack : String(error));
+        return sendError(res, 500, 500, "Failed to batch delete DLQ entries");
+    }
+});
+router.patch("/:id", async (req, res) => {
+    try {
+        const dlq = requireDlq(req);
+        const id = req.params.id;
+        const status = req.body?.status;
+        const notes = req.body?.notes;
+        if (!status || !VALID_STATUSES.includes(status)) {
+            return sendError(res, 400, 400, `Invalid status. Must be one of: ${VALID_STATUSES.join(", ")}`);
+        }
+        const updated = await dlq.updateStatus(id, status, notes);
+        if (!updated) {
+            return sendError(res, 404, 404, "DLQ entry not found");
+        }
+        return sendSuccess(res, 200, { id, status, notes }, "Entry updated");
+    }
+    catch (error) {
+        Logger.error("api", "dlq", "Failed to update DLQ entry", error instanceof Error ? error.stack : String(error));
+        return sendError(res, 500, 500, "Failed to update DLQ entry");
+    }
+});
+router.post("/:id/retry", async (req, res) => {
+    try {
+        const dlq = requireDlq(req);
+        const engine = requireRetryEngine(req);
+        const id = req.params.id;
+        const outcome = await retryEntry(dlq, engine, id);
+        if (!outcome.ok) {
+            return sendError(res, outcome.statusCode, outcome.statusCode, outcome.error ?? "Retry failed");
+        }
+        return sendSuccess(res, 200, { newInstanceId: outcome.newInstanceId }, "Workflow restarted");
+    }
+    catch (error) {
+        Logger.error("api", "dlq", "Failed to retry DLQ entry", error instanceof Error ? error.stack : String(error));
+        return sendError(res, 500, 500, "Failed to retry DLQ entry");
+    }
+});
+export default router;
+//# sourceMappingURL=dlq.js.map

package/dist/src/api/routes/dlq.js.map

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

package/dist/src/api/routes/eventHistory.d.ts

@@ -0,0 +1,3 @@
+import { type Router } from "express";
+import type { EventHistoryManager } from "../EventHistory.js";
+export declare function createEventRoutes(eventHistoryManager: EventHistoryManager): Router;

package/dist/src/api/routes/eventHistory.js

@@ -0,0 +1,48 @@
+import express from "express";
+import { ApiError, asyncHandler, ErrorCode } from "../ErrorHandler.js";
+import { sendSuccess } from "../response.js";
+export function createEventRoutes(eventHistoryManager) {
+    const router = express.Router();
+    router.get("/", asyncHandler(async (req, res) => {
+        const limit = req.query.limit
+            ? Number.parseInt(req.query.limit, 10)
+            : 20;
+        const offset = req.query.offset
+            ? Number.parseInt(req.query.offset, 10)
+            : 0;
+        const events = await eventHistoryManager.getEvents(limit, offset);
+        sendSuccess(res, 200, events, "Event history retrieved");
+    }));
+    router.get("/:id", asyncHandler(async (req, res) => {
+        const id = req.params.id;
+        const event = await eventHistoryManager.getEvent(id);
+        if (!event) {
+            throw ApiError.notFound(`事件记录不存在: ${id}`, ErrorCode.DATA_NOT_FOUND);
+        }
+        sendSuccess(res, 200, event, "Event retrieved");
+    }));
+    router.get("/type/:eventType", asyncHandler(async (req, res) => {
+        const eventType = req.params.eventType;
+        const limit = req.query.limit
+            ? Number.parseInt(req.query.limit, 10)
+            : 20;
+        const offset = req.query.offset
+            ? Number.parseInt(req.query.offset, 10)
+            : 0;
+        const events = await eventHistoryManager.getEventsByType(eventType, limit, offset);
+        sendSuccess(res, 200, events, "Events by type retrieved");
+    }));
+    router.get("/instance/:instanceId", asyncHandler(async (req, res) => {
+        const instanceId = req.params.instanceId;
+        const limit = req.query.limit
+            ? Number.parseInt(req.query.limit, 10)
+            : 20;
+        const offset = req.query.offset
+            ? Number.parseInt(req.query.offset, 10)
+            : 0;
+        const events = await eventHistoryManager.getEventsByInstance(instanceId, limit, offset);
+        sendSuccess(res, 200, events, "Events by instance retrieved");
+    }));
+    return router;
+}
+//# sourceMappingURL=eventHistory.js.map

package/dist/src/api/routes/eventHistory.js.map

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

package/dist/src/api/routes/events.d.ts

@@ -0,0 +1,3 @@
+import { type Router } from "express";
+declare const router: Router;
+export default router;

package/dist/src/api/routes/events.js

@@ -0,0 +1,205 @@
+import express from "express";
+import { body, query, validationResult } from "express-validator";
+import { getContainer } from "../../container.js";
+import { errorMessage, errorStack, Logger } from "../../utils/Logger.js";
+import { sendError, sendSuccess } from "../response.js";
+import { hashRequestBody, sharedIdempotencyStore, } from "../utils/IdempotencyStore.js";
+import { getRequestEngine, getRequestStorage, requireRequestEventHistoryManager, requireRequestWebhookManager, } from "../utils/requestContext.js";
+const router = express.Router();
+router.post("/trigger", [
+    body("event").isString().notEmpty().withMessage("Event name is required"),
+    body("data").isObject().withMessage("Event data must be an object"),
+    body("instanceId")
+        .optional()
+        .isString()
+        .withMessage("Instance ID must be a string"),
+], async (req, res) => {
+    const errors = validationResult(req);
+    if (!errors.isEmpty()) {
+        return sendError(res, 400, 400, errors.array()[0].msg);
+    }
+    try {
+        const webhookManager = requireRequestWebhookManager(req);
+        const { event, data, instanceId } = req.body;
+        const idempotencyKey = req.get("Idempotency-Key");
+        if (idempotencyKey) {
+            const store = sharedIdempotencyStore;
+            const bodyHash = hashRequestBody(req.body ?? {});
+            const reserve = await store.reserve(`event-trigger:${event}`, idempotencyKey, bodyHash);
+            if (reserve.type === "conflict") {
+                return sendError(res, 409, 409, reserve.message);
+            }
+            if (reserve.type === "in_progress") {
+                return sendError(res, 409, 409, "Request is already in progress");
+            }
+            if (reserve.type === "hit") {
+                return sendSuccess(res, 200, reserve.value, "Event already triggered");
+            }
+            try {
+                const eventData = { ...data };
+                if (instanceId) {
+                    eventData.instanceId = instanceId;
+                }
+                const container = getContainer();
+                if (!container) {
+                    return sendError(res, 500, 500, "Container not initialized");
+                }
+                container.eventBus.emit(event, eventData);
+                await webhookManager.triggerEvent(event, eventData);
+                const result = { event, withInstanceId: !!instanceId };
+                await store.complete(`event-trigger:${event}`, idempotencyKey, bodyHash, result);
+                return sendSuccess(res, 200, result, `Event ${event} triggered successfully`);
+            }
+            catch (error) {
+                await store.fail(`event-trigger:${event}`, idempotencyKey);
+                throw error;
+            }
+        }
+        const eventData = { ...data };
+        if (instanceId) {
+            eventData.instanceId = instanceId;
+        }
+        const container = getContainer();
+        if (!container) {
+            return sendError(res, 500, 500, "Container not initialized");
+        }
+        container.eventBus.emit(event, eventData);
+        await webhookManager.triggerEvent(event, eventData);
+        return sendSuccess(res, 200, {
+            event,
+            withInstanceId: !!instanceId,
+        }, `Event ${event} triggered successfully`);
+    }
+    catch (error) {
+        Logger.error("api", "events", `Error triggering event: ${errorMessage(error)}`, errorStack(error));
+        return sendError(res, 500, 500, errorMessage(error) || "Failed to trigger event");
+    }
+});
+router.get("/registered", async (req, res) => {
+    try {
+        const engine = getRequestEngine(req);
+        const getRegisteredEvents = engine
+            ?.getRegisteredEvents;
+        let registeredEvents;
+        if (typeof getRegisteredEvents === "function") {
+            registeredEvents = await getRegisteredEvents.call(engine);
+        }
+        else {
+            const storage = getRequestStorage(req);
+            if (!storage?.listWorkflowsWithMetadata) {
+                return sendError(res, 501, 501, "getRegisteredEvents is not supported by the current engine and storage is not available");
+            }
+            const workflows = await storage.listWorkflowsWithMetadata();
+            const events = new Set();
+            for (const workflow of workflows) {
+                const definition = workflow.definition;
+                if (definition?.triggerEvents) {
+                    for (const event of definition.triggerEvents) {
+                        events.add(event);
+                    }
+                }
+                if (definition?.nodes) {
+                    for (const node of Object.values(definition.nodes)) {
+                        if (node.type === "event" && node.onEvent) {
+                            events.add(node.onEvent);
+                        }
+                    }
+                }
+            }
+            registeredEvents = Array.from(events);
+        }
+        return sendSuccess(res, 200, registeredEvents, "Registered events retrieved");
+    }
+    catch (error) {
+        Logger.error("api", "events", `Error getting registered events: ${errorMessage(error)}`, errorStack(error));
+        return sendError(res, 500, 500, errorMessage(error) || "Failed to retrieve registered events");
+    }
+});
+router.get("/", [
+    query("instanceId").optional().isString(),
+    query("eventType").optional().isString(),
+    query("startTime").optional().isInt({ min: 0 }).toInt(),
+    query("endTime").optional().isInt({ min: 0 }).toInt(),
+    query("page").optional().isInt({ min: 1 }).toInt(),
+    query("pageSize").optional().isInt({ min: 1, max: 100 }).toInt(),
+    query("sortOrder").optional().isIn(["asc", "desc"]),
+], async (req, res) => {
+    const errors = validationResult(req);
+    if (!errors.isEmpty()) {
+        return sendError(res, 400, 400, errors.array()[0].msg);
+    }
+    try {
+        const eventHistoryManager = requireRequestEventHistoryManager(req);
+        const params = {
+            instanceId: req.query.instanceId,
+            eventType: req.query.eventType,
+            startTime: req.query.startTime
+                ? Number.parseInt(req.query.startTime, 10)
+                : undefined,
+            endTime: req.query.endTime
+                ? Number.parseInt(req.query.endTime, 10)
+                : undefined,
+            page: req.query.page
+                ? Number.parseInt(req.query.page, 10)
+                : undefined,
+            pageSize: req.query.pageSize
+                ? Number.parseInt(req.query.pageSize, 10)
+                : undefined,
+            sortOrder: req.query.sortOrder || "desc",
+        };
+        const result = await eventHistoryManager.queryEvents(params);
+        return sendSuccess(res, 200, result, "Events queried");
+    }
+    catch (error) {
+        Logger.error("api", "events", `Error querying events: ${errorMessage(error)}`, errorStack(error));
+        return sendError(res, 500, 500, errorMessage(error) || "Failed to query events");
+    }
+});
+router.get("/aggregate", [
+    query("groupBy")
+        .isString()
+        .isIn(["eventType", "instanceId", "workflowId"])
+        .withMessage("groupBy must be eventType, instanceId, or workflowId"),
+    query("startTime").optional().isInt({ min: 0 }).toInt(),
+    query("endTime").optional().isInt({ min: 0 }).toInt(),
+], async (req, res) => {
+    const errors = validationResult(req);
+    if (!errors.isEmpty()) {
+        return sendError(res, 400, 400, errors.array()[0].msg);
+    }
+    try {
+        const eventHistoryManager = requireRequestEventHistoryManager(req);
+        const params = {
+            groupBy: req.query.groupBy,
+            startTime: req.query.startTime
+                ? Number.parseInt(req.query.startTime, 10)
+                : undefined,
+            endTime: req.query.endTime
+                ? Number.parseInt(req.query.endTime, 10)
+                : undefined,
+        };
+        const result = await eventHistoryManager.aggregateEvents(params);
+        return sendSuccess(res, 200, result, "Events aggregated");
+    }
+    catch (error) {
+        Logger.error("api", "events", `Error aggregating events: ${errorMessage(error)}`, errorStack(error));
+        return sendError(res, 500, 500, errorMessage(error) || "Failed to aggregate events");
+    }
+});
+router.get("/:id", async (req, res) => {
+    try {
+        const eventHistoryManager = requireRequestEventHistoryManager(req);
+        const { id } = req.params;
+        const event = await eventHistoryManager.getEvent(id);
+        if (!event) {
+            return sendError(res, 404, 404, `Event ${id} not found`);
+        }
+        return sendSuccess(res, 200, event, "Event retrieved");
+    }
+    catch (error) {
+        Logger.error("api", "events", `Error getting event: ${errorMessage(error)}`, errorStack(error));
+        return sendError(res, 500, 500, errorMessage(error) || "Failed to get event");
+    }
+});
+export default router;
+//# sourceMappingURL=events.js.map

package/dist/src/api/routes/events.js.map

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

package/dist/src/api/routes/functions.d.ts

@@ -0,0 +1,3 @@
+import { Router } from "express";
+declare const router: Router;
+export default router;

package/dist/src/api/routes/functions.js

@@ -0,0 +1,85 @@
+import { Router } from "express";
+import { getFunctionCatalog } from "../../engine/functions/index.js";
+import { getCustomFunction, listCustomFunctions, registerCustomFunction, unregisterCustomFunction, } from "../../engine/functions/customFunctions.js";
+import { sendError, sendSuccess } from "../response.js";
+const router = Router();
+router.get("/", (_req, res) => {
+    try {
+        const builtin = getFunctionCatalog();
+        const custom = listCustomFunctions().map((f) => ({
+            name: f.name,
+            category: "custom",
+            description: f.description,
+            args: f.params,
+            expression: f.expression,
+        }));
+        sendSuccess(res, 200, {
+            builtin,
+            custom,
+            total: builtin.length + custom.length,
+        });
+    }
+    catch (err) {
+        sendError(res, 500, "FUNCTIONS_LIST_ERROR", err instanceof Error
+            ? err instanceof Error
+                ? err.message
+                : String(err)
+            : String(err));
+    }
+});
+router.post("/", (req, res) => {
+    try {
+        const { name, expression, params, description } = req.body ?? {};
+        if (!name || typeof name !== "string") {
+            sendError(res, 400, "INVALID_NAME", "name is required and must be a string");
+            return;
+        }
+        if (!expression || typeof expression !== "string") {
+            sendError(res, 400, "INVALID_EXPRESSION", "expression is required and must be a string");
+            return;
+        }
+        if (!Array.isArray(params)) {
+            sendError(res, 400, "INVALID_PARAMS", "params must be an array of parameter names");
+            return;
+        }
+        const existing = getCustomFunction(name);
+        const force = req.query.force === "true";
+        if (existing && !force) {
+            sendError(res, 409, "ALREADY_EXISTS", `Custom function "${name}" already registered. Use ?force=true to override.`);
+            return;
+        }
+        registerCustomFunction(name, expression, params, description ?? "", force);
+        sendSuccess(res, 201, getCustomFunction(name), "Function registered");
+    }
+    catch (err) {
+        sendError(res, 500, "FUNCTION_REGISTER_ERROR", err instanceof Error
+            ? err instanceof Error
+                ? err.message
+                : String(err)
+            : String(err));
+    }
+});
+router.delete("/:name", (req, res) => {
+    try {
+        const { name } = req.params;
+        if (!name) {
+            sendError(res, 400, "INVALID_NAME", "name parameter is required");
+            return;
+        }
+        const removed = unregisterCustomFunction(name);
+        if (!removed) {
+            sendError(res, 404, "NOT_FOUND", `Custom function "${name}" not found`);
+            return;
+        }
+        sendSuccess(res, 200, { name, removed: true }, "Function unregistered");
+    }
+    catch (err) {
+        sendError(res, 500, "FUNCTION_DELETE_ERROR", err instanceof Error
+            ? err instanceof Error
+                ? err.message
+                : String(err)
+            : String(err));
+    }
+});
+export default router;
+//# sourceMappingURL=functions.js.map

package/dist/src/api/routes/functions.js.map

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