robodev 0.1.1 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robodev",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "CLI for Robodev Starbase — create, auth, link, and deploy file-based APIs",
   "type": "module",
   "license": "MIT",

package/src/api.ts

@@ -55,6 +55,7 @@ async function refresh(refreshToken: string): Promise<Credentials | null> {
   return (await res.json()) as Credentials;
 }
 
+/** Authenticated Starbase request. Reads `~/.robodev/credentials.json` and refreshes on 401. */
 export async function authed<T>(path: string, init: RequestInit = {}): Promise<T> {
   const credentials = await readCredentials();
   if (!credentials) {

package/src/config.ts

@@ -15,18 +15,22 @@ export type ProjectLink = {
 
 const PROD_URL = "https://robodev.povio.dev";
 
+/** Control-plane API. Override with `STARBASE_URL` for local Starbase. */
 export function starbaseUrl(): string {
   return (process.env.STARBASE_URL ?? PROD_URL).replace(/\/$/, "");
 }
 
+/** Browser UI used for OAuth. Override with `STARBASE_FE_URL`. */
 export function feUrl(): string {
   return (process.env.STARBASE_FE_URL ?? process.env.STARBASE_URL ?? PROD_URL).replace(/\/$/, "");
 }
 
+/** `~/.robodev/credentials.json` — tokens from `robodev auth`. */
 export function credentialsPath(): string {
   return join(homedir(), ".robodev", "credentials.json");
 }
 
+/** Project link file written by `create` / `link`. */
 export function linkPath(cwd = process.cwd()): string {
   return join(cwd, ".robodev");
 }
@@ -61,6 +65,7 @@ export async function writeLink(link: ProjectLink, cwd = process.cwd()): Promise
   await writeFile(linkPath(cwd), `${JSON.stringify(link, null, 2)}\n`);
 }
 
+/** Sets `VITE_API_URL` so the starter UI talks to the deployed project host. */
 export async function writeViteApiUrl(projectApiUrl: string, cwd = process.cwd()): Promise<void> {
   const envPath = join(cwd, ".env");
   let content = "";

package/src/index.ts

@@ -55,6 +55,7 @@ function prompt(question: string): Promise<string> {
   return rl.question(question).finally(() => rl.close());
 }
 
+/** Local loopback server that completes the browser OAuth handshake for `robodev auth`. */
 async function waitForOauthCode(): Promise<{ code: string; redirectUri: string }> {
   const state = randomBytes(16).toString("hex");
   return new Promise((resolve, reject) => {
@@ -184,6 +185,7 @@ async function runLink(projectId?: string): Promise<void> {
   console.log(`Frontend API ${project.apiUrl}`);
 }
 
+/** Collects `database.ts` plus every `api/**/*.ts` file for a deploy upload. */
 async function collectFiles(root: string): Promise<{ path: string; content: string }[]> {
   const files: { path: string; content: string }[] = [];
   const database = join(root, "database.ts");
@@ -220,6 +222,7 @@ async function collectFiles(root: string): Promise<{ path: string; content: stri
   return files;
 }
 
+/** Uploads schema + APIs. Destructive schema changes need confirmation or `--force`. */
 async function runDeploy(forceFlag: boolean, root = process.cwd()): Promise<void> {
   const link = await readLink(root);
   if (!link) {
@@ -356,6 +359,7 @@ async function npmInstall(root: string): Promise<void> {
   });
 }
 
+/** Creates a Starbase project, copies the starter template, links, deploys, and installs deps. */
 async function runCreate(pathArg?: string): Promise<void> {
   const root = resolve(process.cwd(), pathArg ?? ".");
   await mkdir(root, { recursive: true });

package/template/README.md

@@ -1,6 +1,6 @@
 # {{NAME}}
 
-Example Robodev app: a `space` database (`planets`, `rockets`), APIs in `api/`, and a small React UI.
+Starter app from `robodev create`: a `space` database (`planets`, `rockets`), file-based APIs in `api/`, and a small React UI.
 
 The backend is already on Starbase. Run the frontend:
 
@@ -10,6 +10,8 @@ npm run dev
 
 It reads `VITE_API_URL` from `.env` (written by `robodev create` / `robodev link`).
 
+Docs: https://robodev.povio.dev/docs
+
 Add tables in `database.ts` and routes as `api/<name>.ts`, then:
 
 ```bash

package/template/api/health.ts

@@ -1,4 +1,5 @@
-import { defineApi, z } from "robodev-lib";
+/** 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) }),

package/template/api/launch.ts

@@ -1,4 +1,6 @@
-import { defineApi, z } from "robodev-lib";
+/** 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(),
@@ -13,10 +15,11 @@ export const post = defineApi({
   }),
   response: Rocket,
   handler: async ({ db, body }) => {
-    const rows = await db.from("rockets").update({
-      where: { id: body.id },
-      data: { launched: true },
-    });
+    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");

package/template/api/planets.ts

@@ -1,4 +1,6 @@
-import { defineApi, z } from "robodev-lib";
+/** 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";
@@ -16,29 +18,23 @@ const Planet = z.object({
 export const get = defineApi({
   response: z.array(Planet),
   handler: async ({ db }) => {
-    const existing = await db.from("planets").findMany({ take: 1 });
+    const existing = await db.select().from(planets).limit(1);
     if (existing.length === 0) {
       try {
-        await db.from("planets").create({
-          data: { id: EARTH, name: "Earth", climate: "temperate", moons: 1 },
-        });
-        await db.from("planets").create({
-          data: { id: MARS, name: "Mars", climate: "arid", moons: 2 },
-        });
-        await db.from("planets").create({
-          data: { id: KEPLER, name: "Kepler-452b", climate: "unknown", moons: 0 },
-        });
-        await db.from("rockets").create({
-          data: { id: VOYAGER, name: "Voyager", destinationId: MARS, launched: false },
-        });
-        await db.from("rockets").create({
-          data: { id: ODYSSEY, name: "Odyssey", destinationId: KEPLER, launched: true },
-        });
+        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.from("planets").findMany();
+    const rows = await db.select().from(planets);
     return Planet.array().parse(rows);
   },
 });
@@ -51,14 +47,14 @@ export const post = defineApi({
   }),
   response: Planet,
   handler: async ({ db, body }) => {
-    const row = await db.from("planets").create({
-      data: {
-        id: crypto.randomUUID(),
+    const [row] = await db
+      .insert(planets)
+      .values({
         name: body.name,
         climate: body.climate,
         moons: body.moons,
-      },
-    });
+      })
+      .returning();
     return Planet.parse(row);
   },
 });

package/template/api/rockets.ts

@@ -1,4 +1,6 @@
-import { defineApi, z } from "robodev-lib";
+/** 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(),
@@ -13,9 +15,9 @@ export const get = defineApi({
   }),
   response: z.array(Rocket),
   handler: async ({ db, query }) => {
-    const rows = await db.from("rockets").findMany({
-      where: query.destinationId ? { destinationId: query.destinationId } : undefined,
-    });
+    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);
   },
 });
@@ -28,14 +30,14 @@ export const post = defineApi({
   }),
   response: Rocket,
   handler: async ({ db, body }) => {
-    const row = await db.from("rockets").create({
-      data: {
-        id: crypto.randomUUID(),
+    const [row] = await db
+      .insert(rockets)
+      .values({
         name: body.name,
         destinationId: body.destinationId,
         launched: body.launched ?? false,
-      },
-    });
+      })
+      .returning();
     return Rocket.parse(row);
   },
 });

package/template/database.ts

@@ -1,20 +1,27 @@
-import { boolean, defineDatabase, integer, table, text, timestamp, uuid } from "robodev-lib";
+/**
+ * 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: table({
-      id: uuid({ primaryKey: true }),
-      name: text({ notNull: true }),
-      climate: text({ notNull: true }),
-      moons: integer({ default: 0 }),
-    }),
-    rockets: table({
-      id: uuid({ primaryKey: true }),
-      name: text({ notNull: true }),
-      destinationId: uuid({ notNull: true }),
-      launched: boolean({ default: false }),
-      createdAt: timestamp({ default: "now()" }),
-    }),
-  },
+  tables: { planets, rockets },
 });

package/template/package.json

@@ -10,13 +10,13 @@
   "dependencies": {
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "robodev-lib": "^0.1.0"
+    "@robodev-ai/sdk": "^0.2.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.24",
     "@types/react-dom": "^18.3.7",
     "@vitejs/plugin-react": "^4.7.0",
-    "robodev": "^0.1.0",
+    "robodev": "^0.2.0",
     "typescript": "^5.9.2",
     "vite": "^6.3.5"
   }

package/template/src/main.tsx

@@ -1,3 +1,4 @@
+/** Starter UI. Calls the deployed project host using `VITE_API_URL` from `.env`. */
 import { StrictMode, useEffect, useState, type FormEvent } from "react";
 import { createRoot } from "react-dom/client";