ts-workflow-engine-lite 2.1.0

package/dist/src/utils/concurrency.js

@@ -0,0 +1,22 @@
+export const DEFAULT_CONCURRENCY = 16;
+export async function mapWithConcurrency(items, worker, concurrency = DEFAULT_CONCURRENCY) {
+    if (items.length === 0)
+        return [];
+    const limit = Math.max(1, Math.min(Math.floor(concurrency), items.length));
+    const results = Array.from({ length: items.length });
+    let nextIndex = 0;
+    const runners = Array.from({ length: limit }, async () => {
+        while (true) {
+            const index = nextIndex++;
+            if (index >= items.length)
+                return;
+            results[index] = await worker(items[index], index);
+        }
+    });
+    await Promise.all(runners);
+    return results;
+}
+export async function forEachWithConcurrency(items, worker, concurrency = DEFAULT_CONCURRENCY) {
+    await mapWithConcurrency(items, worker, concurrency);
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/src/utils/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../../src/utils/concurrency.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAYtC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAmB,EACnB,MAA8C,EAC9C,cAAsB,mBAAmB;IAEzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAQ,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,IAAI,SAAS,GAAG,CAAC,CAAC;IAIlB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE;QACvD,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;YAC1B,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAClC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAM,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAmB,EACnB,MAAiD,EACjD,cAAsB,mBAAmB;IAEzC,MAAM,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACvD,CAAC"}

package/dist/src/utils/env.d.ts

@@ -0,0 +1,5 @@
+export interface ParseEnvIntOptions {
+    min?: number;
+    max?: number;
+}
+export declare function parseEnvInt(value: string | undefined, defaultValue: number, options?: ParseEnvIntOptions): number;

package/dist/src/utils/env.js

@@ -0,0 +1,15 @@
+export function parseEnvInt(value, defaultValue, options = {}) {
+    if (value === undefined || value.trim() === "")
+        return defaultValue;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed))
+        return defaultValue;
+    const truncated = Math.trunc(parsed);
+    const { min, max } = options;
+    if (min !== undefined && truncated < min)
+        return defaultValue;
+    if (max !== undefined && truncated > max)
+        return defaultValue;
+    return truncated;
+}
+//# sourceMappingURL=env.js.map

package/dist/src/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/utils/env.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,WAAW,CACzB,KAAyB,EACzB,YAAoB,EACpB,UAA8B,EAAE;IAEhC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC;IAEpE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IAElD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,SAAS,GAAG,GAAG;QAAE,OAAO,YAAY,CAAC;IAC9D,IAAI,GAAG,KAAK,SAAS,IAAI,SAAS,GAAG,GAAG;QAAE,OAAO,YAAY,CAAC;IAE9D,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,5 @@
+export type { AuditAction, AuditEntry } from "./AuditLogger.js";
+export { AuditLogger, sanitizeObject, sanitizeValue } from "./AuditLogger.js";
+export { Logger } from "./Logger.js";
+export type { LogContext, LogEntry } from "./StructuredLogger.js";
+export { createInstanceLogger, createRequestLogger, defaultLogger, LogLevel, StructuredLogger, } from "./StructuredLogger.js";

package/dist/src/utils/index.js

@@ -0,0 +1,4 @@
+export { AuditLogger, sanitizeObject, sanitizeValue } from "./AuditLogger.js";
+export { Logger } from "./Logger.js";
+export { createInstanceLogger, createRequestLogger, defaultLogger, LogLevel, StructuredLogger, } from "./StructuredLogger.js";
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/src/utils/secrets.d.ts

@@ -0,0 +1,5 @@
+import { SecretManager } from "./SecretManager.js";
+export declare function setSecretManager(manager: SecretManager | null): void;
+export declare function getSecretManager(): SecretManager | null;
+export declare function disposeSecretManager(): void;
+export declare function resolveSecrets<T>(config: T): Promise<T>;

package/dist/src/utils/secrets.js

@@ -0,0 +1,27 @@
+import { Logger } from "./Logger.js";
+let secretManager = null;
+export function setSecretManager(manager) {
+    secretManager = manager;
+}
+export function getSecretManager() {
+    return secretManager;
+}
+export function disposeSecretManager() {
+    secretManager?.dispose();
+    secretManager = null;
+}
+export async function resolveSecrets(config) {
+    if (!secretManager || config === null || typeof config !== "object") {
+        return config;
+    }
+    try {
+        return (await secretManager.resolve(config));
+    }
+    catch (error) {
+        Logger.warn("system", "secret-manager", "Secret resolution failed", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=secrets.js.map

package/dist/src/utils/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../../src/utils/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,IAAI,aAAa,GAAyB,IAAI,CAAC;AAM/C,MAAM,UAAU,gBAAgB,CAAC,OAA6B;IAC5D,aAAa,GAAG,OAAO,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAC;AACvB,CAAC;AAKD,MAAM,UAAU,oBAAoB;IAClC,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,MAAS;IAC/C,IAAI,CAAC,aAAa,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,aAAa,CAAC,OAAO,CACjC,MAAiC,CAClC,CAAM,CAAC;IACV,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,0BAA0B,EAAE;YAClE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,159 @@
+{
+  "name": "ts-workflow-engine-lite",
+  "version": "2.1.0",
+  "description": "Lightweight TypeScript workflow engine with a REST API and local file persistence for single-process applications.",
+  "keywords": [
+    "ai-workflow",
+    "automation",
+    "cron",
+    "dag",
+    "dead-letter-queue",
+    "event-driven",
+    "llm",
+    "orchestration",
+    "rollback",
+    "scheduler",
+    "state-machine",
+    "temporal",
+    "typescript",
+    "workflow",
+    "workflow-engine"
+  ],
+  "homepage": "https://github.com/CracKerMe/ts-runit-lite",
+  "bugs": {
+    "url": "https://github.com/CracKerMe/ts-runit-lite/issues"
+  },
+  "license": "MIT",
+  "author": "Sario(1160948478@qq.com)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CracKerMe/ts-runit-lite.git"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "pnpm clean && tsc -p tsconfig.build.json && node scripts/fix-esm-imports.mjs",
+    "start": "pnpm build && node dist/src/cli.js",
+    "dev": "tsx src/cli.ts",
+    "dev:api": "cross-env START_API_SERVER=true tsx src/cli.ts",
+    "start:api": "pnpm build && cross-env START_API_SERVER=true node dist/src/cli.js",
+    "watch": "tsc -w",
+    "bench": "cross-env VITE_CJS_IGNORE_WARNING=true vitest run --config vitest.bench.config.ts",
+    "test": "cross-env VITE_CJS_IGNORE_WARNING=true vitest run",
+    "test:watch": "cross-env VITE_CJS_IGNORE_WARNING=true vitest",
+    "test:coverage": "cross-env VITE_CJS_IGNORE_WARNING=true vitest run --coverage",
+    "test:workflow": "tsx src/test/test-workflow.ts",
+    "test:data-processing": "tsx src/test/data-processing-workflow.ts",
+    "example:quickstart": "tsx examples/quickstart.ts",
+    "example:order": "tsx examples/order-processing.ts",
+    "example:embedded-express": "tsx examples/embedded-express-app.ts",
+    "example:error-handling": "tsx examples/error-handling.ts",
+    "example:multi-tenant": "tsx examples/multi-tenant-workflow.ts",
+    "example:approval": "tsx examples/approval-pipeline.ts",
+    "example:http": "tsx examples/http-orchestration.ts",
+    "example:cron-sync": "tsx examples/cron-data-sync.ts",
+    "example:parallel": "tsx examples/parallel-fan-out.ts",
+    "example:degradation": "tsx examples/graceful-degradation.ts",
+    "example:headless": "tsx examples/headless-engine.ts",
+    "example:worker-pool": "tsx examples/worker-pool.ts",
+    "example:headless-no-express": "tsx examples/headless-no-express.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "check": "pnpm lint:fix && pnpm format",
+    "check:ci": "pnpm lint && pnpm format:check",
+    "check:all": "pnpm typecheck && pnpm check:ci",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "axios": "^1.11.0",
+    "dotenv": "^16.3.1",
+    "json-schema-to-zod": "^2.8.1",
+    "jsonwebtoken": "^9.0.0",
+    "node-cron": "^3.0.3",
+    "uuid": "^11.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "5.0.3",
+    "@types/jsonwebtoken": "^9.0.0",
+    "@types/morgan": "^1.9.10",
+    "@types/node": "^18.19.130",
+    "@types/node-cron": "^3.0.11",
+    "@types/supertest": "^7.2.0",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^2.0.0",
+    "cross-env": "^10.0.0",
+    "fast-check": "^4.7.0",
+    "oxfmt": "0.63.0",
+    "oxlint": "1.78.0",
+    "supertest": "^7.2.2",
+    "ts-node": "^10.9.0",
+    "tsx": "^4.23.12",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "body-parser": "^2.0.0",
+    "cors": "^2.8.0",
+    "express": "^5.0.0",
+    "express-validator": "^7.0.0",
+    "helmet": "^8.0.0",
+    "morgan": "^1.10.0",
+    "swagger-ui-dist": "^5.0.0",
+    "ws": "^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "body-parser": {
+      "optional": true
+    },
+    "cors": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "express-validator": {
+      "optional": true
+    },
+    "helmet": {
+      "optional": true
+    },
+    "morgan": {
+      "optional": true
+    },
+    "swagger-ui-dist": {
+      "optional": true
+    },
+    "ws": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "packageManager": "pnpm@10.33.4",
+  "pnpm": {
+    "overrides": {
+      "@types/express-serve-static-core": "5.0.7"
+    }
+  }
+}