robodev 0.7.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robodev",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "CLI for Robodev Starbase — create, auth, link, and deploy hosted apps",
   "type": "module",
   "license": "MIT",

package/src/emit-starter.ts

@@ -2,7 +2,12 @@ import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
-export type Starter = { id: string; title: string; description: string };
+export type Starter = {
+  id: string;
+  title: string;
+  description: string;
+  kind?: "app" | "backend";
+};
 
 export type PackageVersions = {
   robodev: string;

package/src/index.ts

@@ -38,9 +38,9 @@ Commands:
   logout               Remove stored credentials
   whoami               Show the signed-in user
   projects             List your projects
-  create [path] [--starter <id>]  Create a project, scaffold a starter, and deploy
+  create [path] [--starter <id>] [--empty]  Create a project, scaffold a starter, and deploy
   link [projectId]     Write .robodev in the current folder
-  deploy [--force]     Deploy schema, APIs, jobs, and frontend (includes jobs/**/*.ts and api/**/[id].ts)
+  deploy [--force]     Deploy database.ts, api/*.ts, jobs, and frontend files (no Vite / npm run build)
 `);
   process.exit(1);
 }
@@ -282,8 +282,13 @@ function validIdsMessage(starters: Starter[]): string {
 function parseCreateArgs(args: string[]): { path?: string; starterId?: string } {
   let path: string | undefined;
   let starterId: string | undefined;
+  let empty = false;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
+    if (arg === "--empty") {
+      empty = true;
+      continue;
+    }
     if (arg === "--starter") {
       const value = args[i + 1];
       if (!value || value.startsWith("-")) {
@@ -309,6 +314,12 @@ function parseCreateArgs(args: string[]): { path?: string; starterId?: string }
     }
     path = arg;
   }
+  if (empty && starterId !== undefined) {
+    throw new Error("Use either --empty or --starter, not both.");
+  }
+  if (empty) {
+    starterId = "empty";
+  }
   return { path, starterId };
 }
 
@@ -426,7 +437,14 @@ async function runCreate(args: string[]): Promise<void> {
     await npmInstall(root);
   } catch (error) {
     console.log(error instanceof Error ? error.message : error);
-    console.log("Run `npm install` in the project folder, then `npm run dev`.");
+    if (starter.kind === "backend") {
+      console.log(
+        "npm install failed. Copy the API URL printed above into Lovable, Bolt, or v0 as VITE_API_URL.",
+      );
+      console.log("https://robodev.povio.dev/docs/frontend");
+    } else {
+      console.log("Run `npm install` in the project folder, then `npm run dev`.");
+    }
     return;
   }
 
@@ -436,7 +454,13 @@ async function runCreate(args: string[]): Promise<void> {
   if (displayPath !== ".") {
     console.log(`  cd ${displayPath}`);
   }
-  console.log("  npm run dev");
+  if (starter.kind === "backend") {
+    console.log("  Copy the API URL printed above into Lovable, Bolt, or v0 as VITE_API_URL.");
+    console.log("  Do not run robodev deploy or npm run build inside those tools.");
+    console.log("  https://robodev.povio.dev/docs/frontend");
+  } else {
+    console.log("  npm run dev");
+  }
 }
 
 async function main(): Promise<void> {

package/templates/auth-chat/package.json

@@ -20,6 +20,6 @@
     "@vitejs/plugin-react": "^4.7.0",
     "typescript": "^5.9.2",
     "vite": "^6.3.5",
-    "robodev": "^0.7.0"
+    "robodev": "^0.9.0"
   }
 }

package/templates/backend/README.md

@@ -0,0 +1,17 @@
+# {{NAME}}
+
+Space APIs only — no Vite UI. For Lovable, Bolt, or v0.
+
+Deploy `database.ts` and `api/` from a real terminal:
+
+```bash
+npx robodev deploy
+```
+
+Build the UI elsewhere against `VITE_API_URL` (written to `.env` by `robodev create` / `robodev link`). Paste that URL into the frontend tool.
+
+Do not run `npm run dev` or `npm run build` in this folder. Do not run `robodev` (auth, create, deploy) or `npm run build` inside Lovable, Bolt, or v0 — those tools cannot complete loopback OAuth and must not treat this folder as a Vite app.
+
+Frontend how-to: https://robodev.povio.dev/docs/frontend
+
+`GET /me` (`api/me.ts`) requires a Robodev Auth Bearer token. Planet and rocket routes stay public.

package/templates/backend/api/health.ts

@@ -0,0 +1,7 @@
+/** GET /health — liveness check for the deployed project host. */
+import { defineApi, z } from "@robodev-ai/sdk";
+
+export const get = defineApi({
+  response: z.object({ ok: z.literal(true) }),
+  handler: async () => ({ ok: true as const }),
+});

package/templates/backend/api/launch.ts

@@ -0,0 +1,29 @@
+/** POST /launch — marks a rocket as launched. */
+import { rockets } from "../database";
+import { defineApi, eq, z } from "@robodev-ai/sdk";
+
+const Rocket = z.object({
+  id: z.string(),
+  name: z.string(),
+  destinationId: z.string(),
+  launched: z.boolean(),
+});
+
+export const post = defineApi({
+  body: z.object({
+    id: z.string().uuid(),
+  }),
+  response: Rocket,
+  handler: async ({ db, body }) => {
+    const rows = await db
+      .update(rockets)
+      .set({ launched: true })
+      .where(eq(rockets.id, body.id))
+      .returning();
+    const row = rows[0];
+    if (!row) {
+      throw new Error("Rocket not found");
+    }
+    return Rocket.parse(row);
+  },
+});

package/templates/backend/api/me.ts

@@ -0,0 +1,14 @@
+/** GET /me — current project user (Robodev Auth required). */
+import { defineApi, z } from "@robodev-ai/sdk";
+
+export const get = defineApi({
+  auth: "required",
+  response: z.object({
+    user: z.object({
+      id: z.string(),
+      email: z.string(),
+      name: z.string().nullable().optional(),
+    }),
+  }),
+  handler: async ({ user }) => ({ user }),
+});

package/templates/backend/api/motto.ts

@@ -0,0 +1,9 @@
+/** GET /motto — plain-text envelope response. */
+import { defineApi } from "@robodev-ai/sdk";
+
+export const get = defineApi({
+  handler: async () => ({
+    contentType: "text/plain; charset=utf-8",
+    body: "Ad astra",
+  }),
+});

package/templates/backend/api/planets/[id].ts

@@ -0,0 +1,21 @@
+/** GET /planets/:id — one planet by path param. */
+import { defineApi, eq, z } from "@robodev-ai/sdk";
+import { planets } from "../../database";
+
+const Planet = z.object({
+  id: z.string(),
+  name: z.string(),
+  climate: z.string(),
+  moons: z.coerce.number(),
+});
+
+export const get = defineApi({
+  response: Planet,
+  handler: async ({ db, params }) => {
+    const [row] = await db.select().from(planets).where(eq(planets.id, params.id)).limit(1);
+    if (!row) {
+      return { status: 404, body: { error: "not_found" } };
+    }
+    return Planet.parse(row);
+  },
+});

package/templates/backend/api/planets.ts

@@ -0,0 +1,60 @@
+/** GET/POST /planets — list (seeds sample rows on first GET) and create planets. */
+import { planets, rockets } from "../database";
+import { defineApi, z } from "@robodev-ai/sdk";
+
+const EARTH = "11111111-1111-1111-1111-111111111111";
+const MARS = "22222222-2222-2222-2222-222222222222";
+const KEPLER = "33333333-3333-3333-3333-333333333333";
+const VOYAGER = "44444444-4444-4444-4444-444444444444";
+const ODYSSEY = "55555555-5555-5555-5555-555555555555";
+
+const Planet = z.object({
+  id: z.string(),
+  name: z.string(),
+  climate: z.string(),
+  moons: z.coerce.number(),
+});
+
+export const get = defineApi({
+  response: z.array(Planet),
+  handler: async ({ db }) => {
+    const existing = await db.select().from(planets).limit(1);
+    if (existing.length === 0) {
+      try {
+        await db.insert(planets).values([
+          { id: EARTH, name: "Earth", climate: "temperate", moons: 1 },
+          { id: MARS, name: "Mars", climate: "arid", moons: 2 },
+          { id: KEPLER, name: "Kepler-452b", climate: "unknown", moons: 0 },
+        ]);
+        await db.insert(rockets).values([
+          { id: VOYAGER, name: "Voyager", destinationId: MARS, launched: false },
+          { id: ODYSSEY, name: "Odyssey", destinationId: KEPLER, launched: true },
+        ]);
+      } catch {
+        // First request won the seed race.
+      }
+    }
+    const rows = await db.select().from(planets);
+    return Planet.array().parse(rows);
+  },
+});
+
+export const post = defineApi({
+  body: z.object({
+    name: z.string().min(1),
+    climate: z.string().min(1),
+    moons: z.coerce.number().int().min(0).default(0),
+  }),
+  response: Planet,
+  handler: async ({ db, body }) => {
+    const [row] = await db
+      .insert(planets)
+      .values({
+        name: body.name,
+        climate: body.climate,
+        moons: body.moons,
+      })
+      .returning();
+    return Planet.parse(row);
+  },
+});

package/templates/backend/api/rockets.ts

@@ -0,0 +1,43 @@
+/** GET/POST /rockets — list (optional `?destinationId=`) and create rockets. */
+import { rockets } from "../database";
+import { defineApi, eq, z } from "@robodev-ai/sdk";
+
+const Rocket = z.object({
+  id: z.string(),
+  name: z.string(),
+  destinationId: z.string(),
+  launched: z.boolean(),
+});
+
+export const get = defineApi({
+  query: z.object({
+    destinationId: z.string().optional(),
+  }),
+  response: z.array(Rocket),
+  handler: async ({ db, query }) => {
+    const rows = query.destinationId
+      ? await db.select().from(rockets).where(eq(rockets.destinationId, query.destinationId))
+      : await db.select().from(rockets);
+    return Rocket.array().parse(rows);
+  },
+});
+
+export const post = defineApi({
+  body: z.object({
+    name: z.string().min(1),
+    destinationId: z.string().uuid(),
+    launched: z.boolean().optional(),
+  }),
+  response: Rocket,
+  handler: async ({ db, body }) => {
+    const [row] = await db
+      .insert(rockets)
+      .values({
+        name: body.name,
+        destinationId: body.destinationId,
+        launched: body.launched ?? false,
+      })
+      .returning();
+    return Rocket.parse(row);
+  },
+});

package/templates/backend/database.ts

@@ -0,0 +1,27 @@
+/**
+ * Starter schema. `robodev deploy` creates the `space` database and these tables
+ * (no migration files). Edit here and deploy again to sync.
+ */
+import { boolean, defineDatabase, integer, pgTable, text, timestamp, uuid } from "@robodev-ai/sdk";
+
+export const planets = pgTable("planets", {
+  id: uuid("id").primaryKey().defaultRandom(),
+  name: text("name").notNull(),
+  climate: text("climate").notNull(),
+  moons: integer("moons").default(0),
+});
+
+export const rockets = pgTable("rockets", {
+  id: uuid("id").primaryKey().defaultRandom(),
+  name: text("name").notNull(),
+  destinationId: uuid("destinationId")
+    .notNull()
+    .references(() => planets.id, { onDelete: "cascade" }),
+  launched: boolean("launched").default(false),
+  createdAt: timestamp("createdAt", { withTimezone: true }).defaultNow(),
+});
+
+export default defineDatabase({
+  name: "space",
+  tables: { planets, rockets },
+});

package/templates/backend/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "{{PACKAGE_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "deploy": "robodev deploy"
+  },
+  "dependencies": {
+    "@robodev-ai/sdk": "^0.6.0"
+  },
+  "devDependencies": {
+    "robodev": "^0.9.0",
+    "typescript": "^5.9.2"
+  }
+}

package/templates/backend/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["database.ts", "api/**/*.ts"]
+}

package/templates/catalog.json

@@ -9,6 +9,18 @@
       "id": "auth-chat",
       "title": "Auth chat",
       "description": "Email + Google sign-in and a shared chat room"
+    },
+    {
+      "id": "backend",
+      "title": "Backend",
+      "description": "Space APIs only — no Vite UI. For Lovable, Bolt, or v0",
+      "kind": "backend"
+    },
+    {
+      "id": "empty",
+      "title": "Empty",
+      "description": "Blank database.ts and GET /health — no sample schema or UI. For Lovable, Bolt, or v0",
+      "kind": "backend"
     }
   ]
 }

package/templates/empty/README.md

@@ -0,0 +1,15 @@
+# {{NAME}}
+
+Blank `database.ts` and `GET /health` — no sample schema or UI. For Lovable, Bolt, or v0.
+
+Deploy `database.ts` and `api/` from a real terminal:
+
+```bash
+npx robodev deploy
+```
+
+Build the UI elsewhere against `VITE_API_URL` (written to `.env` by `robodev create` / `robodev link`). Paste that URL into the frontend tool.
+
+Do not run `npm run dev` or `npm run build` in this folder. Do not run `robodev` (auth, create, deploy) or `npm run build` inside Lovable, Bolt, or v0 — those tools cannot complete loopback OAuth and must not treat this folder as a Vite app.
+
+Frontend how-to: https://robodev.povio.dev/docs/frontend

package/templates/empty/api/health.ts

@@ -0,0 +1,7 @@
+/** GET /health — liveness check for the deployed project host. */
+import { defineApi, z } from "@robodev-ai/sdk";
+
+export const get = defineApi({
+  response: z.object({ ok: z.literal(true) }),
+  handler: async () => ({ ok: true as const }),
+});

package/templates/empty/database.ts

@@ -0,0 +1,14 @@
+/**
+ * Placeholder schema. Replace this table or add tables, then `robodev deploy`.
+ */
+import { defineDatabase, pgTable, text, uuid } from "@robodev-ai/sdk";
+
+export const items = pgTable("items", {
+  id: uuid("id").primaryKey().defaultRandom(),
+  name: text("name").notNull(),
+});
+
+export default defineDatabase({
+  name: "app",
+  tables: { items },
+});

package/templates/empty/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "{{PACKAGE_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "deploy": "robodev deploy"
+  },
+  "dependencies": {
+    "@robodev-ai/sdk": "^0.6.0"
+  },
+  "devDependencies": {
+    "robodev": "^0.9.0",
+    "typescript": "^5.9.2"
+  }
+}

package/templates/empty/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["database.ts", "api/**/*.ts"]
+}

package/templates/space/package.json

@@ -20,6 +20,6 @@
     "@vitejs/plugin-react": "^4.7.0",
     "typescript": "^5.9.2",
     "vite": "^6.3.5",
-    "robodev": "^0.7.0"
+    "robodev": "^0.9.0"
   }
 }