robodev 0.31.0 → 0.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robodev",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "CLI for Robodev Starbase — create, auth, link, deploy, and run a project locally with robodev dev",
   "type": "module",
   "license": "MIT",
@@ -25,8 +25,8 @@
     "embedded-postgres": "17.10.0-beta.17",
     "fastify": "^5.12.1",
     "tsx": "^4.20.5",
-    "@robodev-ai/runtime": "0.1.0",
-    "@robodev-ai/sdk": "0.10.0"
+    "@robodev-ai/runtime": "0.2.0",
+    "@robodev-ai/sdk": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",

package/src/dev-clients.ts

@@ -1,10 +1,10 @@
 import type { RouteClients } from "@robodev-ai/runtime";
-import type { EmailClient, LlmClient } from "@robodev-ai/sdk";
+import type { EmailClient, JobEnqueueInput, LlmClient } from "@robodev-ai/sdk";
 
 /**
  * The `ctx.*` clients `robodev dev` can offer offline. `email` prints to the terminal;
- * everything that needs Starbase infrastructure fails with a message that says so rather
- * than silently doing nothing.
+ * `jobs` enqueues onto the local engine; everything else that needs Starbase
+ * infrastructure fails with a message that says so rather than silently doing nothing.
  */
 
 function unavailable(feature: string): never {
@@ -36,6 +36,7 @@ function offlineLlmClient(): LlmClient {
 export function devRouteClients(input: {
   env: Record<string, string>;
   log: (line: string) => void;
+  enqueue: (job: JobEnqueueInput) => Promise<{ id: string }>;
 }): RouteClients {
   return {
     email: consoleEmailClient(input.log),
@@ -55,7 +56,7 @@ export function devRouteClients(input: {
       list: () => unavailable("storage"),
     },
     push: { send: () => unavailable("push") },
-    jobs: { enqueue: () => unavailable("jobs") },
+    jobs: { enqueue: input.enqueue },
     sockets: {
       send: () => unavailable("sockets"),
       broadcast: () => unavailable("sockets"),

package/src/dev-server.ts

@@ -13,7 +13,8 @@ import {
   type AuthQueryable,
   type RuntimeRoute,
 } from "@robodev-ai/runtime";
-import type { RobodevDb } from "@robodev-ai/sdk";
+import type { JobEnqueueInput, RobodevDb } from "@robodev-ai/sdk";
+import type { RuntimeJob } from "@robodev-ai/runtime";
 import { devRouteClients } from "./dev-clients.js";
 
 /** One compiled generation of the project. Swapped wholesale on reload. */
@@ -21,6 +22,7 @@ export type DevRuntime = {
   db: RobodevDb;
   pool: AuthQueryable & { end: () => Promise<void> };
   routes: RuntimeRoute[];
+  jobs: RuntimeJob[];
   openapi: Record<string, unknown>;
 };
 
@@ -30,6 +32,7 @@ export type DevServerOptions = {
   jwtSecret: string;
   env: Record<string, string>;
   log: (line: string) => void;
+  enqueue: (job: JobEnqueueInput) => Promise<{ id: string }>;
 };
 
 const SWAGGER_PATHS = new Set(["/_robodev/docs", "/_robodev/swagger", "/docs", "/swagger"]);
@@ -181,7 +184,8 @@ export async function startDevServer(
           { projectId: options.projectId, jwtSecret: options.jwtSecret },
           authorization,
         ),
-      clients: () => devRouteClients({ env: options.env, log: options.log }),
+      clients: () =>
+        devRouteClients({ env: options.env, log: options.log, enqueue: options.enqueue }),
     });
 
     if (outcome.kind === "error") {

package/src/dev.ts

@@ -6,9 +6,12 @@ import { spawn, type ChildProcess } from "node:child_process";
 import {
   apiBundleExternals,
   applyPlan,
+  assertJobCrons,
   buildPlan,
   compileApiTree,
+  createLocalJobsEngine,
   ensureAuthSchema,
+  ensureJobsSchema,
   isEsbuildFailure,
   loadModules,
   mapEsbuildErrors,
@@ -26,6 +29,7 @@ import {
   type DevProject,
 } from "./dev-project.js";
 import { externalDevPostgres, startDevPostgres, type DevPostgres } from "./dev-postgres.js";
+import { devRouteClients } from "./dev-clients.js";
 import { buildDevOpenApi, startDevServer, type DevRuntime } from "./dev-server.js";
 
 export type DevArgs = {
@@ -154,6 +158,15 @@ export async function main(args: string[]): Promise<void> {
   let closing = false;
 
   const log = (line: string) => console.log(line);
+  const engine = createLocalJobsEngine({
+    query: (sql, values) => {
+      if (!current) throw new Error("jobs engine not ready");
+      return current.pool.query(sql, values);
+    },
+    getGeneration: () => current,
+    log,
+    clients: () => devRouteClients({ env, log, enqueue: (input) => engine.enqueue(input) }),
+  });
 
   async function compileAndActivate(input: { syncSchema: boolean }): Promise<void> {
     const files = await collectBackendFiles(project.backendDir);
@@ -179,6 +192,7 @@ export async function main(args: string[]): Promise<void> {
     }
 
     const loaded = await loadModules(distDir, files);
+    assertJobCrons(loaded.jobs);
     // Any edit to database.ts can change columns, not just tables, so compare its source.
     const schemaSource = files.find((file) => file.path === "database.ts")?.content ?? "";
 
@@ -200,31 +214,36 @@ export async function main(args: string[]): Promise<void> {
     const { db, pool } = createDb(postgres.connectionString, loaded.database.tables);
     await pool.query("SELECT 1");
     await ensureAuthSchema(pool);
+    await ensureJobsSchema(pool);
 
     const previous = current;
     current = {
       db,
       pool,
       routes: loaded.routes,
+      jobs: loaded.jobs,
       openapi: buildDevOpenApi(loaded.database.name, loaded.routes),
     };
-    if (previous) {
-      await previous.pool.end().catch(() => undefined);
-    }
+    await engine.reconcile(loaded.jobs);
 
     for (const route of loaded.routes) {
       console.log(`  ${route.method.toUpperCase()} ${route.path}`);
     }
-    if (loaded.jobs.length > 0) {
-      console.log(
-        `  ${loaded.jobs.length} job(s) compiled but not run — jobs need hosted Starbase.`,
-      );
+    for (const job of loaded.jobs) {
+      if (job.def.cron) {
+        console.log(`  job ${job.name} (cron ${job.def.cron})`);
+      } else {
+        console.log(`  job ${job.name}`);
+      }
     }
     if (loaded.sockets.length > 0) {
       console.log(
         `  ${loaded.sockets.length} socket(s) compiled but not served — sockets need hosted Starbase.`,
       );
     }
+    if (previous) {
+      await previous.pool.end().catch(() => undefined);
+    }
   }
 
   async function releaseDatabase(): Promise<void> {
@@ -235,8 +254,16 @@ export async function main(args: string[]): Promise<void> {
   let server: Awaited<ReturnType<typeof startDevServer>>;
   try {
     await compileAndActivate({ syncSchema: true });
+    await engine.start();
     server = await startDevServer(
-      { port: parsed.port, projectId: DEV_PROJECT_ID, jwtSecret: DEV_JWT_SECRET, env, log },
+      {
+        port: parsed.port,
+        projectId: DEV_PROJECT_ID,
+        jwtSecret: DEV_JWT_SECRET,
+        env,
+        log,
+        enqueue: (input) => engine.enqueue(input),
+      },
       () => current,
     );
   } catch (error) {
@@ -312,6 +339,7 @@ export async function main(args: string[]): Promise<void> {
   async function shutdown(code: number): Promise<void> {
     if (closing) return;
     closing = true;
+    await engine.stop();
     for (const watcher of watchers) watcher.close();
     fe?.kill("SIGTERM");
     await server.close().catch(() => undefined);

package/templates/auth-chat/package.json

@@ -9,10 +9,10 @@
     "rules:gen": "rulesync generate"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.10.0"
+    "@robodev-ai/sdk": "^0.11.0"
   },
   "devDependencies": {
-    "robodev": "^0.31.0",
+    "robodev": "^0.32.0",
     "rulesync": "^8.18.0",
     "typescript": "^5.9.2"
   }

package/templates/backend/package.json

@@ -8,10 +8,10 @@
     "deploy": "robodev deploy"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.10.0"
+    "@robodev-ai/sdk": "^0.11.0"
   },
   "devDependencies": {
-    "robodev": "^0.31.0",
+    "robodev": "^0.32.0",
     "typescript": "^5.9.2"
   }
 }

package/templates/empty/package.json

@@ -8,10 +8,10 @@
     "deploy": "robodev deploy"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.10.0"
+    "@robodev-ai/sdk": "^0.11.0"
   },
   "devDependencies": {
-    "robodev": "^0.31.0",
+    "robodev": "^0.32.0",
     "typescript": "^5.9.2"
   }
 }

package/templates/marketplace/package.json

@@ -9,10 +9,10 @@
     "rules:gen": "rulesync generate"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.10.0"
+    "@robodev-ai/sdk": "^0.11.0"
   },
   "devDependencies": {
-    "robodev": "^0.31.0",
+    "robodev": "^0.32.0",
     "rulesync": "^8.18.0",
     "typescript": "^5.9.2"
   }

package/templates/space/package.json

@@ -9,10 +9,10 @@
     "rules:gen": "rulesync generate"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.10.0"
+    "@robodev-ai/sdk": "^0.11.0"
   },
   "devDependencies": {
-    "robodev": "^0.31.0",
+    "robodev": "^0.32.0",
     "rulesync": "^8.18.0",
     "typescript": "^5.9.2"
   }