robodev 0.10.0 → 0.12.0

package/templates/space/api/files/presigned-url.ts

@@ -0,0 +1,48 @@
+import { defineApi, z } from "@robodev-ai/sdk";
+import { media, PLANET_IMAGE_RESOURCE } from "../_lib";
+
+const ALLOWED = new Set(["image/jpeg", "image/png", "image/webp"]);
+const MAX_BYTES = 2 * 1024 * 1024;
+
+export const post = defineApi({
+  auth: "required",
+  body: z.object({
+    resourceName: z.string().optional(),
+    fileName: z.string().min(1),
+    fileSize: z.number().int().positive(),
+    mimeType: z.string().optional(),
+    method: z.string().optional(),
+  }),
+  handler: async (ctx) => {
+    const mimeType = ctx.body.mimeType || "application/octet-stream";
+    if (ctx.body.fileSize > MAX_BYTES) {
+      return { status: 400, body: { message: "File is too large" } };
+    }
+    if (ctx.body.resourceName === PLANET_IMAGE_RESOURCE && !ALLOWED.has(mimeType)) {
+      return { status: 400, body: { message: "Unsupported image type" } };
+    }
+
+    const key = `planet-images/${ctx.user!.id}/${crypto.randomUUID()}-${ctx.body.fileName.replaceAll("/", "-")}`;
+    const [row] = await ctx.db
+      .insert(media)
+      .values({
+        key,
+        userId: ctx.user!.id,
+        resourceName: ctx.body.resourceName || PLANET_IMAGE_RESOURCE,
+        fileName: ctx.body.fileName,
+        fileSize: ctx.body.fileSize,
+        mimeType,
+      })
+      .returning();
+
+    return {
+      id: row!.id,
+      method: "post",
+      url: "/api/files/upload",
+      fields: [
+        ["id", row!.id],
+        ["key", key],
+      ],
+    };
+  },
+});

package/templates/space/api/files/upload.ts

@@ -0,0 +1,29 @@
+import { defineApi, eq } from "@robodev-ai/sdk";
+import { fail, media } from "../_lib";
+
+export const post = defineApi({
+  auth: "required",
+  multipart: true,
+  handler: async (ctx) => {
+    const id =
+      typeof ctx.body === "object" && ctx.body && "id" in ctx.body ? String(ctx.body.id) : "";
+    const file = ctx.files?.[0];
+    if (!id || !file) return fail(400, "Missing file upload");
+
+    const [row] = await ctx.db.select().from(media).where(eq(media.id, id)).limit(1);
+    if (!row) return fail(404, "Media not found");
+    if (row.userId !== ctx.user!.id) return fail(403, "You can only upload your own media");
+
+    try {
+      await ctx.storage.upload(row.key, file.data, {
+        public: true,
+        contentType: file.mimetype || row.mimeType,
+      });
+    } catch (error) {
+      return fail(503, error instanceof Error ? error.message : "Storage is not configured");
+    }
+
+    await ctx.db.update(media).set({ uploaded: new Date() }).where(eq(media.id, row.id));
+    return { ok: true, id: row.id };
+  },
+});

package/templates/space/api/planets/[id]/like.ts

@@ -0,0 +1,36 @@
+import { and, defineApi, eq } from "@robodev-ai/sdk";
+import { enrichOne, fail, findPlanet, planetLikes } from "../../_lib";
+
+export const post = defineApi({
+  auth: "required",
+  handler: async (ctx) => {
+    const planet = await findPlanet(ctx.db, ctx.params.id);
+    if (!planet) return fail(404, "Planet not found");
+    const [existing] = await ctx.db
+      .select({ id: planetLikes.id })
+      .from(planetLikes)
+      .where(and(eq(planetLikes.planetId, planet.id), eq(planetLikes.userId, ctx.user!.id)))
+      .limit(1);
+    if (!existing) {
+      await ctx.db.insert(planetLikes).values({
+        planetId: planet.id,
+        userId: ctx.user!.id,
+      });
+    }
+    return enrichOne(ctx, planet, ctx.user!.id);
+  },
+});
+
+const unlikePlanet = defineApi({
+  auth: "required",
+  handler: async (ctx) => {
+    const planet = await findPlanet(ctx.db, ctx.params.id);
+    if (!planet) return fail(404, "Planet not found");
+    await ctx.db
+      .delete(planetLikes)
+      .where(and(eq(planetLikes.planetId, planet.id), eq(planetLikes.userId, ctx.user!.id)));
+    return enrichOne(ctx, planet, ctx.user!.id);
+  },
+});
+
+export { unlikePlanet as delete };

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

@@ -1,21 +1,64 @@
-/** GET /planets/:id — one planet by path param. */
 import { defineApi, eq, z } from "@robodev-ai/sdk";
-import { planets } from "../../database";
+import { enrichOne, fail, findPlanet, planets, validateAlien, validateImage } from "../_lib";
 
-const Planet = z.object({
-  id: z.string(),
-  name: z.string(),
-  climate: z.string(),
-  moons: z.coerce.number(),
+const planetBody = z.object({
+  name: z.string().min(1),
+  alienId: z.string().nullish(),
+  discoveryDate: z.string().nullish(),
+  description: z.string().nullish(),
+  image: z.object({ id: z.string() }).nullish(),
 });
 
 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" } };
+  auth: "required",
+  handler: async (ctx) => {
+    const planet = await findPlanet(ctx.db, ctx.params.id);
+    if (!planet) return fail(404, "Planet not found");
+    return enrichOne(ctx, planet, ctx.user!.id);
+  },
+});
+
+export const put = defineApi({
+  auth: "required",
+  body: planetBody,
+  handler: async (ctx) => {
+    const planet = await findPlanet(ctx.db, ctx.params.id);
+    if (!planet) return fail(404, "Planet not found");
+    if (planet.userId !== ctx.user!.id) return fail(403, "You can only update your own planets");
+
+    const alienId = ctx.body.alienId || null;
+    if (alienId && !(await validateAlien(ctx.db, alienId))) {
+      return fail(404, "Alien not found");
     }
-    return Planet.parse(row);
+    const image = await validateImage(ctx.db, ctx.body.image, ctx.user!.id);
+    if (image && "error" in image) return image.error;
+
+    const [updated] = await ctx.db
+      .update(planets)
+      .set({
+        name: ctx.body.name,
+        alienId,
+        discoveryDate: ctx.body.discoveryDate ? new Date(ctx.body.discoveryDate) : null,
+        description: ctx.body.description ?? null,
+        imageId: image?.id ?? null,
+        updatedAt: new Date(),
+      })
+      .where(eq(planets.id, planet.id))
+      .returning();
+    if (!updated) return fail(404, "Planet not found");
+    return enrichOne(ctx, updated, ctx.user!.id);
   },
 });
+
+const deletePlanet = defineApi({
+  auth: "required",
+  handler: async (ctx) => {
+    const planet = await findPlanet(ctx.db, ctx.params.id);
+    if (!planet) return fail(404, "Planet not found");
+    if (planet.userId !== ctx.user!.id) return fail(403, "You can only delete your own planets");
+    await ctx.db.delete(planets).where(eq(planets.id, planet.id));
+    return { status: 204, body: null };
+  },
+});
+
+export { deletePlanet as delete };

package/templates/space/api/planets/paginate.ts

@@ -0,0 +1,36 @@
+import { defineApi } from "@robodev-ai/sdk";
+import {
+  ensureSeed,
+  enrichPlanet,
+  filterPlanetRows,
+  loadLookups,
+  paginate,
+  parseFilter,
+  planets,
+  sortPlanets,
+} from "../_lib";
+
+export const get = defineApi({
+  auth: "required",
+  handler: async (ctx) => {
+    await ensureSeed(ctx.db, ctx.user!.id);
+    const query = ctx.query as Record<string, unknown>;
+    const rows = await ctx.db.select().from(planets);
+    const lookups = await loadLookups(ctx.db);
+    const filter = parseFilter(query);
+    const filtered = filterPlanetRows(rows, lookups.alienById, filter);
+    const page = paginate(
+      sortPlanets(filtered, typeof query.order === "string" ? query.order : undefined),
+      Number(query.page) || undefined,
+      Number(query.limit) || undefined,
+    );
+    return {
+      ...page,
+      items: await Promise.all(
+        page.items.map((row) =>
+          enrichPlanet(ctx, row, ctx.user!.id, lookups.alienById, lookups.likes),
+        ),
+      ),
+    };
+  },
+});

package/templates/space/api/planets.ts

@@ -1,60 +1,68 @@
-/** 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";
+import {
+  ensureSeed,
+  enrichOne,
+  enrichPlanet,
+  fail,
+  filterPlanetRows,
+  loadLookups,
+  parseFilter,
+  planets,
+  sortPlanets,
+  validateAlien,
+  validateImage,
+} from "./_lib";
 
-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 imageRequest = z.object({ id: z.string() }).nullish();
 
-const Planet = z.object({
-  id: z.string(),
-  name: z.string(),
-  climate: z.string(),
-  moons: z.coerce.number(),
+const planetBody = z.object({
+  name: z.string().min(1),
+  alienId: z.string().nullish(),
+  discoveryDate: z.string().nullish(),
+  description: z.string().nullish(),
+  image: imageRequest,
 });
 
 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);
+  auth: "required",
+  handler: async (ctx) => {
+    await ensureSeed(ctx.db, ctx.user!.id);
+    const rows = await ctx.db.select().from(planets);
+    const lookups = await loadLookups(ctx.db);
+    const query = ctx.query as Record<string, unknown>;
+    const filtered = filterPlanetRows(rows, lookups.alienById, parseFilter(query));
+    const order = typeof query.order === "string" ? query.order : undefined;
+    return Promise.all(
+      sortPlanets(filtered, order).map((row) =>
+        enrichPlanet(ctx, row, ctx.user!.id, lookups.alienById, lookups.likes),
+      ),
+    );
   },
 });
 
 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
+  auth: "required",
+  body: planetBody,
+  handler: async (ctx) => {
+    const alienId = ctx.body.alienId || null;
+    if (alienId && !(await validateAlien(ctx.db, alienId))) {
+      return fail(404, "Alien not found");
+    }
+    const image = await validateImage(ctx.db, ctx.body.image, ctx.user!.id);
+    if (image && "error" in image) return image.error;
+
+    const [row] = await ctx.db
       .insert(planets)
       .values({
-        name: body.name,
-        climate: body.climate,
-        moons: body.moons,
+        userId: ctx.user!.id,
+        creatorName: ctx.user!.name ?? ctx.user!.email,
+        alienId,
+        discoveryDate: ctx.body.discoveryDate ? new Date(ctx.body.discoveryDate) : null,
+        name: ctx.body.name,
+        description: ctx.body.description ?? null,
+        imageId: image?.id ?? null,
       })
       .returning();
-    return Planet.parse(row);
+    return enrichOne(ctx, row!, ctx.user!.id);
   },
 });

package/templates/space/apps/fe/index.html

@@ -0,0 +1,24 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link
+      rel="icon"
+      type="image/svg+xml"
+      href="/favicon.svg"
+    />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0"
+    />
+    <title>Space</title>
+  </head>
+
+  <body class="bg-elevation-fill-default-2 text-text-default-1">
+    <div id="app"></div>
+    <script
+      type="module"
+      src="/src/main.tsx"
+    ></script>
+  </body>
+</html>

package/templates/space/apps/fe/openapi-codegen.config.ts

@@ -0,0 +1,37 @@
+/* oxlint-disable import/no-nodejs-modules */
+import type { OpenAPICodegenConfig } from "@povio/openapi-codegen-cli";
+import { resolveConfigSync } from "@povio/resolve-config";
+import { resolve } from "node:path";
+
+const COMPACT_OPENAPI_INPUT = "../../openapi.json";
+const repoRoot = resolve(process.cwd(), "../..");
+const env = resolveConfigSync({ cwd: repoRoot, module: "spa", target: "resolved" }) as Record<
+  string,
+  string | undefined
+>;
+
+function resolveLiveOpenApiInput(apiUrl = env.VITE_PUBLIC_API_URL) {
+  return `${apiUrl?.replace(/\/+$/, "")}/openapi.json`;
+}
+
+export function resolveOpenApiInput() {
+  return process.env.OPENAPI_INPUT || (process.env.OPENAPI_LIVE === "true" ? resolveLiveOpenApiInput() : COMPACT_OPENAPI_INPUT);
+}
+
+const config: OpenAPICodegenConfig = {
+  input: resolveOpenApiInput(),
+  output: "src/openapi",
+  tsPath: "@/openapi",
+  restClientImportPath: "@/clients/app-rest-client",
+  clearOutput: true,
+  excludeRedundantZodSchemas: false,
+  checkAcl: false,
+  acl: false,
+  replaceOptionalWithNullish: true,
+  infiniteQueries: true,
+  mutationDefaultOnError: true,
+  modelsInCommon: true,
+  axiosRequestConfig: true,
+};
+
+export default config;

package/templates/space/apps/fe/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "fe",
+  "version": "0.0.0",
+  "private": true,
+  "description": "Space starter frontend",
+  "type": "module",
+  "scripts": {
+    "dev": "bunx --bun vite",
+    "build": "bunx --bun vite build",
+    "clean": "rimraf dist src/openapi",
+    "lint": "oxlint --type-aware . ../../api ../../database.ts --fix",
+    "lint:check": "oxlint --type-aware . ../../api ../../database.ts --quiet",
+    "format": "oxfmt -c \"../../oxfmt.config.js\" . ../../api ../../database.ts",
+    "format:check": "oxfmt -c \"../../oxfmt.config.js\" --check . ../../api ../../database.ts",
+    "ts:check": "tsc -b --noEmit",
+    "test": "vitest run",
+    "check": "bun ts:check && bun lint:check && bun format:check",
+    "openapi:gen": "openapi-codegen generate && oxfmt -c \"../../oxfmt.config.js\" ./src/openapi",
+    "openapi:check": "openapi-codegen check"
+  },
+  "dependencies": {
+    "@casl/ability": "^6.8.1",
+    "@casl/react": "^5.0.1",
+    "@fontsource-variable/geist": "^5.2.8",
+    "@fontsource-variable/inter": "^5.2.8",
+    "@internationalized/date": "^3.11.0",
+    "@povio/openapi-codegen-cli": "3.1.0",
+    "@povio/resolve-config": "1.3.0",
+    "@povio/ui": "3.4.0-rc.12",
+    "@sentry/react": "^10.38.0",
+    "@tanstack/devtools-vite": "^0.3.11",
+    "@tanstack/react-devtools": "^0.8.1",
+    "@tanstack/react-form": "^1.33.2",
+    "@tanstack/react-query": "^5.90.21",
+    "@tanstack/react-query-devtools": "~5.90.0",
+    "@tanstack/react-router": "^1.136.8",
+    "@tanstack/react-router-devtools": "^1.136.8",
+    "@tanstack/react-table": "^8.21.3",
+    "@tanstack/router-core": "^1.136.8",
+    "@tanstack/router-plugin": "^1.136.8",
+    "axios": "^1.13.2",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "i18next": "^25.7.3",
+    "loglevel": "^1.9.2",
+    "lucide-react": "^1.28.0",
+    "luxon": "^3.7.2",
+    "react": "19.2.4",
+    "react-aria": "^3.46.0",
+    "react-aria-components": "^1.15.1",
+    "react-dom": "19.2.4",
+    "react-i18next": "^16.5.1",
+    "web-vitals": "^5.1.0",
+    "zod": "^4.4.3",
+    "zustand": "^5.0.9"
+  },
+  "devDependencies": {
+    "@axe-core/react": "^4.11.0",
+    "@povio/react-scan": "0.0.0",
+    "@povio/vite-plugin-react-scan": "0.0.2",
+    "@tailwindcss/vite": "^4.2.1",
+    "@types/luxon": "^3.7.1",
+    "@types/node": "^24.10.9",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "@vitejs/plugin-react": "^5.1.2",
+    "babel-plugin-react-compiler": "1.0.0",
+    "oxfmt": "^0.45.0",
+    "oxlint": "1.60.0",
+    "oxlint-tsgolint": "0.21.0",
+    "react-icons-sprite": "^1.1.1",
+    "rimraf": "^6.1.2",
+    "tailwindcss": "^4.2.4",
+    "tailwindcss-react-aria-components": "^2.1.0",
+    "tsx": "^4.22.1",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "vite": "^8.0.0",
+    "vite-plugin-devtools-json": "^1.0.0",
+    "vitest": "^3.2.4"
+  }
+}

package/templates/space/apps/fe/public/favicon.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="239.36" height="239.36"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="239.36" height="239.36"><svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 239.36 239.36"><defs><style>.cls-1{fill:#3c60ad;}.cls-2{fill:none;}.cls-3{clip-path:url(#clip-path);}.cls-4{mask:url(#mask);}.cls-5{fill:#fff;}</style><clipPath id="clip-path"><rect class="cls-2" width="239.36" height="239.36"></rect></clipPath><mask id="mask" x="0" y="0" width="239.36" height="239.36" maskUnits="userSpaceOnUse"><g id="mask0_21778_2258" data-name="mask0 21778 2258"><path class="cls-1" d="M0,29.92A29.93,29.93,0,0,1,29.92,0H209.44a29.93,29.93,0,0,1,29.92,29.92V209.44a29.93,29.93,0,0,1-29.92,29.92H29.92A29.93,29.93,0,0,1,0,209.44Z"></path></g></mask></defs><g class="cls-3"><g class="cls-4"><path class="cls-5" d="M0,29.92A29.93,29.93,0,0,1,29.92,0H209.44a29.93,29.93,0,0,1,29.92,29.92V209.44a29.93,29.93,0,0,1-29.92,29.92H29.92A29.93,29.93,0,0,1,0,209.44Z"></path><path d="M119.8,49.55c26.68,0,48.41,22.8,48.5,50.63,0,28.18-21.73,51.06-48.5,51.06A46.64,46.64,0,0,1,83.31,133.4v56.54h-12V100.27C71.29,72.35,93,49.55,119.8,49.55Zm0,12.29c-20.15,0-36.49,17.22-36.49,38.43,0,21.46,16.34,39,36.49,39s36.39-17.5,36.48-39C156.28,79.06,139.94,61.84,119.8,61.84Z"></path></g></g></svg></svg><style>@media (prefers-color-scheme: light) { :root { filter: none; } }
+@media (prefers-color-scheme: dark) { :root { filter: none; } }
+</style></svg>

package/templates/space/apps/fe/public/site.webmanifest

@@ -0,0 +1,21 @@
+{
+  "name": "Povio",
+  "short_name": "Povio",
+  "icons": [
+    {
+      "src": "/web-app-manifest-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "maskable"
+    },
+    {
+      "src": "/web-app-manifest-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable"
+    }
+  ],
+  "theme_color": "#ffffff",
+  "background_color": "#ffffff",
+  "display": "standalone"
+}