robodev 0.37.0 → 0.38.0

package/package.json

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

package/src/dev-clients.test.ts

@@ -0,0 +1,38 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { test } from "node:test";
+import { consoleEmailClient } from "./dev-clients.js";
+import { createDevInspect } from "./dev-inspect.js";
+
+test("consoleEmailClient renders a local robodev/emails catalog file", async () => {
+  const root = await mkdtemp(join(tmpdir(), "robodev-dev-email-"));
+  await mkdir(join(root, "robodev", "emails"), { recursive: true });
+  await writeFile(join(root, "robodev", "emails", "welcome.html"), "<p>Hi {{name}}</p>", "utf8");
+  await writeFile(
+    join(root, "robodev", "emails", "welcome.json"),
+    JSON.stringify({ subject: "Hello {{name}}", text: "Hi {{name}}" }),
+    "utf8",
+  );
+  const lines: string[] = [];
+  const inspect = createDevInspect({ max: 20 });
+  const email = consoleEmailClient((line) => lines.push(line), inspect, root);
+  const result = await email.send({
+    to: "ada@example.com",
+    template: "welcome",
+    vars: { name: "Ada" },
+  });
+  assert.equal(result.status, "sent");
+  assert.match(lines[0] ?? "", /Hello Ada/);
+  assert.match(lines[1] ?? "", /Hi Ada/);
+});
+
+test("consoleEmailClient throws template_not_found without a local file or body", async () => {
+  const inspect = createDevInspect({ max: 20 });
+  const email = consoleEmailClient(() => undefined, inspect, await mkdtemp(join(tmpdir(), "robodev-dev-email-")));
+  await assert.rejects(
+    () => email.send({ to: "ada@example.com", template: "missing" }),
+    /template_not_found/,
+  );
+});

package/src/dev-clients.ts

@@ -1,6 +1,9 @@
 import {
+  createHopPdfClient,
   createLocalStorageClient,
   createProjectSocketsClient,
+  loadLocalEmailTemplate,
+  resolveEmailSendInput,
   type StorageQueryable,
 } from "@robodev-ai/runtime";
 import type { RouteClients } from "@robodev-ai/runtime";
@@ -8,6 +11,7 @@ import type {
   EmailClient,
   JobEnqueueInput,
   LlmClient,
+  PdfClient,
   SocketsClient,
   StorageClient,
 } from "@robodev-ai/sdk";
@@ -19,8 +23,8 @@ import {
 
 /**
  * The `ctx.*` clients `robodev dev` can offer offline. `email` prints to the terminal;
- * `jobs`, `storage`, and `sockets` run locally. llm / agent / push throw hosted-style
- * not-configured codes rather than silently doing nothing.
+ * `jobs`, `storage`, and `sockets` run locally. `pdf` hops to Starbase. llm / agent / push
+ * throw hosted-style not-configured codes rather than silently doing nothing.
  */
 
 function notConfigured(code: string): never {
@@ -57,6 +61,29 @@ function inspectStorageClient(client: StorageClient, inspect: DevInspectStore):
   };
 }
 
+function inspectPdfClient(client: PdfClient, inspect: DevInspectStore): PdfClient {
+  return {
+    async fromHtml(html, options) {
+      const htmlBytes = Buffer.byteLength(html, "utf8");
+      const format = options?.format ?? "A4";
+      try {
+        const result = await client.fromHtml(html, options);
+        inspect.record({ kind: "pdf", htmlBytes, format, ok: true });
+        return result;
+      } catch (error) {
+        inspect.record({
+          kind: "pdf",
+          htmlBytes,
+          format,
+          ok: false,
+          error: errorMessage(error),
+        });
+        throw error;
+      }
+    },
+  };
+}
+
 function inspectSocketsClient(client: SocketsClient, inspect: DevInspectStore): SocketsClient {
   function tracked(
     socketKind: "send" | "broadcast",
@@ -97,13 +124,24 @@ function inspectSocketsClient(client: SocketsClient, inspect: DevInspectStore):
 export function consoleEmailClient(
   log: (line: string) => void,
   inspect: DevInspectStore,
+  projectRoot?: string,
 ): EmailClient {
   return {
     async send(input) {
-      const to = Array.isArray(input.to) ? input.to.join(", ") : input.to;
-      log(`email → ${to}: ${input.subject}`);
-      if (input.text) log(`  ${input.text}`);
-      inspect.record({ kind: "email", to, subject: input.subject, text: input.text });
+      const catalog =
+        input.template && projectRoot
+          ? await loadLocalEmailTemplate(projectRoot, input.template)
+          : null;
+      const resolved = resolveEmailSendInput(input, catalog);
+      const to = Array.isArray(resolved.to) ? resolved.to.join(", ") : resolved.to;
+      log(`email → ${to}: ${resolved.subject ?? ""}`);
+      if (resolved.text) log(`  ${resolved.text}`);
+      inspect.record({
+        kind: "email",
+        to,
+        subject: resolved.subject ?? "",
+        text: resolved.text,
+      });
       return { id: `local_${Date.now().toString(36)}`, status: "sent" };
     },
   };
@@ -126,9 +164,10 @@ export function devRouteClients(input: {
   publicBaseUrl: string;
   projectId: string;
   jwtSecret: string;
+  projectRoot?: string;
 }): RouteClients {
   return {
-    email: consoleEmailClient(input.log, input.inspect),
+    email: consoleEmailClient(input.log, input.inspect, input.projectRoot),
     llm: offlineLlmClient(),
     agent: {
       createSession: () => notConfigured("llm_not_configured"),
@@ -147,6 +186,7 @@ export function devRouteClients(input: {
       }),
       input.inspect,
     ),
+    pdf: inspectPdfClient(createHopPdfClient(), input.inspect),
     push: { send: () => notConfigured("push_not_configured") },
     jobs: {
       enqueue: async (job) => {

package/src/dev-inspect.test.ts

@@ -383,3 +383,22 @@ test("storage object count is 0 when the query fails", async () => {
   assert.equal(state.overview.storageObjectCount, 0);
   assert.deepEqual(state.storage.objects, []);
 });
+
+test("pdf inspect records byte length and format, not HTML text", () => {
+  const inspect = createDevInspect();
+  const html = "<html><body>secret invoice</body></html>";
+  const event = inspect.record({
+    kind: "pdf",
+    htmlBytes: Buffer.byteLength(html, "utf8"),
+    format: "Letter",
+    ok: false,
+    error: "pdf_failed",
+  });
+  assert.equal(event.kind, "pdf");
+  if (event.kind !== "pdf") throw new Error("expected pdf");
+  assert.equal(event.htmlBytes, Buffer.byteLength(html, "utf8"));
+  assert.equal(event.format, "Letter");
+  assert.equal(event.ok, false);
+  assert.equal(event.error, "pdf_failed");
+  assert.equal(JSON.stringify(event).includes("secret invoice"), false);
+});

package/src/dev-inspect.ts

@@ -55,7 +55,7 @@ export const RESERVED_AUTH_ROUTES: Array<{ method: string; path: string; file: s
 export const SOCKET_PREVIEW_MAX = 200;
 
 export type DevInspectKind =
-  "request" | "email" | "auth_code" | "job" | "job_run" | "log" | "storage" | "socket";
+  "request" | "email" | "auth_code" | "job" | "job_run" | "log" | "storage" | "socket" | "pdf";
 
 export type StorageInspectOp = "upload" | "get" | "getUrl" | "delete" | "list" | "serve";
 export type SocketInspectKind = "connect" | "message" | "close" | "send" | "broadcast";
@@ -127,6 +127,14 @@ export type DevInspectSocketEvent = EventBase & {
   preview?: string;
 };
 
+export type DevInspectPdfEvent = EventBase & {
+  kind: "pdf";
+  htmlBytes: number;
+  format: string;
+  ok: boolean;
+  error?: string;
+};
+
 export type DevInspectEvent =
   | DevInspectRequestEvent
   | DevInspectEmailEvent
@@ -135,7 +143,8 @@ export type DevInspectEvent =
   | DevInspectJobRunEvent
   | DevInspectLogEvent
   | DevInspectStorageEvent
-  | DevInspectSocketEvent;
+  | DevInspectSocketEvent
+  | DevInspectPdfEvent;
 
 export type DevInspectRecordInput =
   | Omit<DevInspectRequestEvent, "id" | "at">
@@ -145,7 +154,8 @@ export type DevInspectRecordInput =
   | Omit<DevInspectJobRunEvent, "id" | "at">
   | Omit<DevInspectLogEvent, "id" | "at">
   | Omit<DevInspectStorageEvent, "id" | "at">
-  | Omit<DevInspectSocketEvent, "id" | "at">;
+  | Omit<DevInspectSocketEvent, "id" | "at">
+  | Omit<DevInspectPdfEvent, "id" | "at">;
 
 export type DashboardGoogle = "broker" | "local_override" | "incomplete";
 

package/src/dev-server.ts

@@ -63,6 +63,7 @@ export type DevServerOptions = {
   googleClientId?: string;
   googleClientSecret?: string;
   storageDir: string;
+  projectRoot?: string;
 };
 
 const SWAGGER_PATHS = new Set(["/_robodev/docs", "/_robodev/swagger", "/docs", "/swagger"]);
@@ -129,6 +130,7 @@ function routeClients(options: DevServerOptions, getRuntime: () => DevRuntime |
     publicBaseUrl: options.listenOrigin,
     projectId: options.projectId,
     jwtSecret: options.jwtSecret,
+    projectRoot: options.projectRoot,
   });
 }
 

package/src/dev.ts

@@ -191,6 +191,7 @@ export async function main(args: string[]): Promise<void> {
         publicBaseUrl: `http://localhost:${parsed.port}`,
         projectId: DEV_PROJECT_ID,
         jwtSecret: DEV_JWT_SECRET,
+        projectRoot: project.root,
       }),
     onJobFinished: (event) => {
       inspect.record({
@@ -310,6 +311,7 @@ export async function main(args: string[]): Promise<void> {
         googleClientId: env.GOOGLE_CLIENT_ID,
         googleClientSecret: env.GOOGLE_CLIENT_SECRET,
         storageDir,
+        projectRoot: project.root,
       },
       () => current,
     );

package/templates/auth-chat/package.json

@@ -9,10 +9,10 @@
     "rules:gen": "rulesync generate"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.11.0"
+    "@robodev-ai/sdk": "^0.12.0"
   },
   "devDependencies": {
-    "robodev": "^0.37.0",
+    "robodev": "^0.38.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.11.0"
+    "@robodev-ai/sdk": "^0.12.0"
   },
   "devDependencies": {
-    "robodev": "^0.37.0",
+    "robodev": "^0.38.0",
     "typescript": "^5.9.2"
   }
 }

package/templates/empty/package.json

@@ -8,10 +8,10 @@
     "deploy": "robodev deploy"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.11.0"
+    "@robodev-ai/sdk": "^0.12.0"
   },
   "devDependencies": {
-    "robodev": "^0.37.0",
+    "robodev": "^0.38.0",
     "typescript": "^5.9.2"
   }
 }

package/templates/marketplace/package.json

@@ -9,10 +9,10 @@
     "rules:gen": "rulesync generate"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.11.0"
+    "@robodev-ai/sdk": "^0.12.0"
   },
   "devDependencies": {
-    "robodev": "^0.37.0",
+    "robodev": "^0.38.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.11.0"
+    "@robodev-ai/sdk": "^0.12.0"
   },
   "devDependencies": {
-    "robodev": "^0.37.0",
+    "robodev": "^0.38.0",
     "rulesync": "^8.18.0",
     "typescript": "^5.9.2"
   }