@donkeylabs/server 2.0.30 → 2.0.31

package/docs/workflows.md

@@ -89,6 +89,19 @@ const instanceId = await ctx.core.workflows.start("process-order", {
 });
 ```
 
+### Concurrency Guard
+
+Limit concurrent instances per workflow name:
+
+```ts
+const server = new AppServer({
+  db,
+  workflows: {
+    concurrentWorkflows: 1, // 0 = unlimited
+  },
+});
+```
+
 ### 3. Track Progress
 
 ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donkeylabs/server",
-  "version": "2.0.30",
+  "version": "2.0.31",
   "type": "module",
   "description": "Type-safe plugin system for building RPC-style APIs with Bun",
   "main": "./src/index.ts",

package/src/core/workflows.ts

@@ -766,6 +766,8 @@ export interface WorkflowsConfig {
   sqlitePragmas?: SqlitePragmaConfig;
   /** Disable in-process watchdog timers (use external watchdog instead) */
   useWatchdog?: boolean;
+  /** Max concurrent instances per workflow name (0 = unlimited, default: 0) */
+  concurrentWorkflows?: number;
   /** Resume strategy for orphaned workflows (default: "blocking") */
   resumeStrategy?: WorkflowResumeStrategy;
 }
@@ -871,6 +873,7 @@ class WorkflowsImpl implements Workflows {
   private killGraceMs: number;
   private sqlitePragmas?: SqlitePragmaConfig;
   private useWatchdog: boolean;
+  private concurrentWorkflows: number;
   private resumeStrategy!: WorkflowResumeStrategy;
   private workflowModulePaths = new Map<string, string>();
   private isolatedProcesses = new Map<string, IsolatedProcessInfo>();
@@ -908,6 +911,7 @@ class WorkflowsImpl implements Workflows {
     this.killGraceMs = config.killGraceMs ?? 5000;
     this.sqlitePragmas = config.sqlitePragmas;
     this.useWatchdog = config.useWatchdog ?? false;
+    this.concurrentWorkflows = config.concurrentWorkflows ?? 0;
     this.resumeStrategy = config.resumeStrategy ?? "blocking";
   }
 
@@ -1006,6 +1010,16 @@ class WorkflowsImpl implements Workflows {
       throw new Error(`Workflow "${workflowName}" is not registered`);
     }
 
+    if (this.concurrentWorkflows > 0) {
+      const running = await this.adapter.getInstancesByWorkflow(workflowName, "running");
+      const pending = await this.adapter.getInstancesByWorkflow(workflowName, "pending");
+      if (running.length + pending.length >= this.concurrentWorkflows) {
+        throw new Error(
+          `Workflow "${workflowName}" has reached its concurrency limit (${this.concurrentWorkflows})`
+        );
+      }
+    }
+
     const instance = await this.adapter.createInstance({
       workflowName,
       status: "pending",