robodev 0.2.2 → 0.3.1

package/package.json

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

package/src/index.ts

@@ -17,6 +17,7 @@ import {
   writeLink,
   writeViteApiUrl,
 } from "./config.js";
+import { waitUntilLive } from "./wait-until-live.js";
 
 const execFileAsync = promisify(execFile);
 
@@ -245,6 +246,7 @@ async function runDeploy(forceFlag: boolean, root = process.cwd()): Promise<void
         method: "POST",
         body: JSON.stringify({ force, files }),
       });
+      await waitUntilLive(result.apiUrl);
       console.log(`Deployed to ${result.apiUrl}`);
       console.log(`Docs     ${result.docsUrl}`);
       console.log(

package/src/wait-until-live.ts

@@ -0,0 +1,51 @@
+const POLL_INTERVAL_MS = 400;
+const OVERALL_TIMEOUT_MS = 30_000;
+const ATTEMPT_TIMEOUT_MS = 3_000;
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function probe(url: string, timeoutMs: number): Promise<{ status: number; error?: string }> {
+  const res = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+  const body = (await res.json().catch(() => ({}))) as Record<string, unknown>;
+  return {
+    status: res.status,
+    error: typeof body.error === "string" ? body.error : undefined,
+  };
+}
+
+/**
+ * Polls the public project host until it answers as live.
+ * Prefers `GET /_robodev/ready` (200). Falls back to `GET /openapi.json` when an
+ * older Starbase serves a user-route 404 (`error === "not_found"`).
+ */
+export async function waitUntilLive(apiUrl: string): Promise<void> {
+  const base = apiUrl.replace(/\/$/, "");
+  const deadline = Date.now() + OVERALL_TIMEOUT_MS;
+  let path = "/_robodev/ready";
+
+  console.log("Waiting for endpoints to come online…");
+
+  while (Date.now() < deadline) {
+    const remaining = deadline - Date.now();
+    if (remaining <= 0) break;
+
+    try {
+      const result = await probe(`${base}${path}`, Math.min(ATTEMPT_TIMEOUT_MS, remaining));
+      if (result.status === 200) return;
+      if (path === "/_robodev/ready" && result.status === 404 && result.error === "not_found") {
+        path = "/openapi.json";
+        continue;
+      }
+    } catch {
+      // Connection, TLS, or attempt timeout — keep polling until the overall deadline.
+    }
+
+    const wait = Math.min(POLL_INTERVAL_MS, deadline - Date.now());
+    if (wait <= 0) break;
+    await sleep(wait);
+  }
+
+  throw new Error(`Deploy was accepted but the project host did not become reachable: ${base}`);
+}

package/template/README.md

@@ -12,6 +12,8 @@ It reads `VITE_API_URL` from `.env` (written by `robodev create` / `robodev link
 
 Docs: https://robodev.povio.dev/docs
 
+`GET /me` (`api/me.ts`) requires a Robodev Auth Bearer token. Planet and rocket routes stay public. Optional browser helper: `@robodev-ai/client`. Auth how-to: https://robodev.povio.dev/docs/auth
+
 Add tables in `database.ts` and routes as `api/<name>.ts`, then:
 
 ```bash

package/template/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/template/package.json

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