@donkeylabs/server 0.5.1 → 0.6.3

package/src/core.ts

@@ -11,6 +11,7 @@ import type { SSE } from "./core/sse";
 import type { RateLimiter } from "./core/rate-limiter";
 import type { Errors, CustomErrorRegistry } from "./core/errors";
 import type { Workflows } from "./core/workflows";
+import type { Processes } from "./core/processes";
 
 export interface PluginRegistry {}
 
@@ -54,6 +55,7 @@ export interface CoreServices {
   rateLimiter: RateLimiter;
   errors: Errors;
   workflows: Workflows;
+  processes: Processes;
 }
 
 /**

package/src/harness.ts

@@ -12,6 +12,7 @@ import {
   createRateLimiter,
   createErrors,
   createWorkflows,
+  createProcesses,
 } from "./core/index";
 
 /**
@@ -36,6 +37,7 @@ export async function createTestHarness(targetPlugin: Plugin, dependencies: Plug
   const rateLimiter = createRateLimiter();
   const errors = createErrors();
   const workflows = createWorkflows({ events, jobs, sse });
+  const processes = createProcesses({ events, autoRecoverOrphans: false });
 
   const core: CoreServices = {
     db,
@@ -49,6 +51,7 @@ export async function createTestHarness(targetPlugin: Plugin, dependencies: Plug
     rateLimiter,
     errors,
     workflows,
+    processes,
   };
 
   const manager = new PluginManager(core);

package/src/server.ts

@@ -15,6 +15,7 @@ import {
   createRateLimiter,
   createErrors,
   createWorkflows,
+  createProcesses,
   extractClientIP,
   HttpError,
   type LoggerConfig,
@@ -26,6 +27,7 @@ import {
   type RateLimiterConfig,
   type ErrorsConfig,
   type WorkflowsConfig,
+  type ProcessesConfig,
 } from "./core/index";
 import { zodSchemaToTs } from "./generator/zod-to-ts";
 
@@ -60,6 +62,7 @@ export interface ServerConfig {
   rateLimiter?: RateLimiterConfig;
   errors?: ErrorsConfig;
   workflows?: WorkflowsConfig;
+  processes?: ProcessesConfig;
 }
 
 export class AppServer {
@@ -88,6 +91,10 @@ export class AppServer {
       jobs,
       sse,
     });
+    const processes = createProcesses({
+      ...options.processes,
+      events,
+    });
 
     this.coreServices = {
       db: options.db,
@@ -101,6 +108,7 @@ export class AppServer {
       rateLimiter,
       errors,
       workflows,
+      processes,
     };
 
     this.manager = new PluginManager(this.coreServices);
@@ -226,12 +234,19 @@ export class AppServer {
       outputSource?: string;
     }> = [];
 
+    const routesWithoutOutput: string[] = [];
+
     for (const router of this.routers) {
       for (const route of router.getRoutes()) {
         const parts = route.name.split(".");
         const routeName = parts[parts.length - 1] || route.name;
         const prefix = parts.slice(0, -1).join(".");
 
+        // Track typed routes without explicit output schema
+        if (route.handler === "typed" && !route.output) {
+          routesWithoutOutput.push(route.name);
+        }
+
         routes.push({
           name: route.name,
           prefix,
@@ -243,6 +258,17 @@ export class AppServer {
       }
     }
 
+    // Warn about routes missing output schemas
+    if (routesWithoutOutput.length > 0) {
+      logger.warn(
+        `${routesWithoutOutput.length} route(s) missing output schema - output type will be 'void'`,
+        { routes: routesWithoutOutput }
+      );
+      logger.debug(
+        "Tip: Add an 'output' Zod schema to define the return type, or ensure handlers return nothing"
+      );
+    }
+
     // Generate the client code
     const code = this.generateClientCode(routes);
 
@@ -334,7 +360,7 @@ export function createApi(options?: ClientOptions) {
            if (r.handler !== "typed") return "";
            const routeNs = toPascalCase(r.routeName);
            const inputType = r.inputSource ?? "Record<string, never>";
-           const outputType = r.outputSource ?? "unknown";
+           const outputType = r.outputSource ?? "void";
            return `${indent}export namespace ${routeNs} {
 ${indent}  export type Input = Expand<${inputType}>;
 ${indent}  export type Output = Expand<${outputType}>;
@@ -458,7 +484,8 @@ ${factoryFunction}
     this.coreServices.cron.start();
     this.coreServices.jobs.start();
     await this.coreServices.workflows.resume();
-    logger.info("Background services started (cron, jobs, workflows)");
+    this.coreServices.processes.start();
+    logger.info("Background services started (cron, jobs, workflows, processes)");
 
     for (const router of this.routers) {
       for (const route of router.getRoutes()) {
@@ -677,7 +704,8 @@ ${factoryFunction}
     this.coreServices.cron.start();
     this.coreServices.jobs.start();
     await this.coreServices.workflows.resume();
-    logger.info("Background services started (cron, jobs, workflows)");
+    this.coreServices.processes.start();
+    logger.info("Background services started (cron, jobs, workflows, processes)");
 
     // 4. Build route map
     for (const router of this.routers) {
@@ -817,6 +845,7 @@ ${factoryFunction}
     this.coreServices.sse.shutdown();
 
     // Stop background services
+    await this.coreServices.processes.shutdown();
     await this.coreServices.workflows.stop();
     await this.coreServices.jobs.stop();
     await this.coreServices.cron.stop();