create-surf-app 0.1.4 → 0.1.6

package/dist/cli.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import {
+  createSurfApp
+} from "./chunk-AMAMASIV.js";
+
+// src/cli.ts
+var VALUE_FLAGS = /* @__PURE__ */ new Set([
+  "--frontend-port",
+  "--backend-port",
+  "--preview-base",
+  "--swagger-url"
+]);
+function getFlag(args, name) {
+  const idx = args.indexOf(name);
+  return idx >= 0 && args[idx + 1] ? args[idx + 1] : void 0;
+}
+function parseCliArgs(args) {
+  const positionalArgs = [];
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (!arg.startsWith("--")) {
+      positionalArgs.push(arg);
+      continue;
+    }
+    if (!VALUE_FLAGS.has(arg)) {
+      throw new Error(`Unknown flag: ${arg}`);
+    }
+    if (!args[index + 1] || args[index + 1].startsWith("--")) {
+      throw new Error(`Missing value for flag: ${arg}`);
+    }
+    index += 1;
+  }
+  if (positionalArgs.length > 1) {
+    throw new Error(`Expected at most one project directory, got: ${positionalArgs.join(", ")}`);
+  }
+  return {
+    projectName: positionalArgs[0] || ".",
+    frontendPort: getFlag(args, "--frontend-port"),
+    backendPort: getFlag(args, "--backend-port"),
+    previewBase: getFlag(args, "--preview-base"),
+    swaggerUrl: getFlag(args, "--swagger-url")
+  };
+}
+async function runCli() {
+  const args = process.argv.slice(2);
+  await createSurfApp(parseCliArgs(args));
+}
+runCli().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

package/dist/index.js

@@ -1,380 +1,6 @@
-#!/usr/bin/env node
-
-// src/index.ts
-import fs from "fs";
-import path from "path";
-var args = process.argv.slice(2);
-var projectName = args.find((a) => !a.startsWith("--")) || ".";
-var frontendPort = getFlag("--port") || process.env.VITE_PORT || "5173";
-var backendPort = getFlag("--backend-port") || process.env.VITE_BACKEND_PORT || "3001";
-function getFlag(name2) {
-  const idx = args.indexOf(name2);
-  return idx >= 0 && args[idx + 1] ? args[idx + 1] : void 0;
-}
-var frontendPkg = {
-  name: "frontend",
-  private: true,
-  type: "module",
-  scripts: {
-    dev: "vite",
-    build: "vite build",
-    preview: "vite preview",
-    lint: "eslint ."
-  },
-  dependencies: {
-    "@surf-ai/sdk": "latest",
-    "@surf-ai/theme": "latest",
-    "@radix-ui/react-accordion": "1.2.12",
-    "@radix-ui/react-aspect-ratio": "1.1.8",
-    "@radix-ui/react-avatar": "1.1.11",
-    "@radix-ui/react-checkbox": "1.3.3",
-    "@radix-ui/react-collapsible": "1.1.12",
-    "@radix-ui/react-context-menu": "2.2.16",
-    "@radix-ui/react-dialog": "1.1.15",
-    "@radix-ui/react-dropdown-menu": "2.1.16",
-    "@radix-ui/react-hover-card": "1.1.15",
-    "@radix-ui/react-label": "2.1.8",
-    "@radix-ui/react-menubar": "1.1.16",
-    "@radix-ui/react-navigation-menu": "1.2.14",
-    "@radix-ui/react-popover": "1.1.15",
-    "@radix-ui/react-progress": "1.1.8",
-    "@radix-ui/react-radio-group": "1.3.8",
-    "@radix-ui/react-scroll-area": "1.2.10",
-    "@radix-ui/react-select": "2.2.6",
-    "@radix-ui/react-separator": "1.1.8",
-    "@radix-ui/react-slider": "1.3.6",
-    "@radix-ui/react-slot": "1.2.4",
-    "@radix-ui/react-switch": "1.2.6",
-    "@radix-ui/react-tabs": "1.1.13",
-    "@radix-ui/react-toast": "1.2.15",
-    "@radix-ui/react-toggle": "1.1.10",
-    "@radix-ui/react-toggle-group": "1.1.11",
-    "@radix-ui/react-tooltip": "1.2.8",
-    "@tanstack/react-query": "5.94.5",
-    "class-variance-authority": "0.7.1",
-    "clsx": "2.1.1",
-    "cmdk": "1.1.1",
-    "echarts": "5.6.0",
-    "echarts-for-react": "3.0.6",
-    "embla-carousel-react": "8.6.0",
-    "lucide-react": "0.454.0",
-    "next-themes": "0.4.6",
-    "react": "19.2.4",
-    "react-dom": "19.2.4",
-    "react-router-dom": "7.6.1",
-    "sonner": "1.7.4",
-    "tailwind-merge": "2.6.1",
-    "vaul": "1.1.2",
-    "zod": "3.25.76"
-  },
-  devDependencies: {
-    "@eslint/js": "9.39.4",
-    "@tailwindcss/vite": "4.2.2",
-    "@types/node": "22.19.15",
-    "@types/react": "19.2.14",
-    "@types/react-dom": "19.2.3",
-    "@vitejs/plugin-react": "4.7.0",
-    "eslint": "9.39.4",
-    "eslint-plugin-react-hooks": "5.2.0",
-    "eslint-plugin-react-refresh": "0.4.26",
-    "globals": "16.5.0",
-    "tailwindcss": "4.2.2",
-    "tw-animate-css": "1.4.0",
-    "typescript": "5.9.3",
-    "typescript-eslint": "8.57.1",
-    "vite": "6.4.1"
-  }
+import {
+  createSurfApp
+} from "./chunk-AMAMASIV.js";
+export {
+  createSurfApp
 };
-var templates = {
-  // ── Backend ──────────────────────────────────────────────────────────────
-  "backend/package.json": JSON.stringify({
-    name: "backend",
-    private: true,
-    scripts: {
-      start: "node server.js",
-      dev: "node --env-file=.env --watch server.js"
-    },
-    dependencies: {
-      "@surf-ai/sdk": "latest",
-      "express": "^4.22.0"
-    }
-  }, null, 2),
-  "backend/server.js": `const { createServer } = require('@surf-ai/sdk/server')
-createServer().start()
-`,
-  "backend/routes/.gitkeep": "",
-  "backend/db/schema.js": `// Define your Drizzle ORM tables here.
-// Example:
-//   const { pgTable, serial, text, timestamp } = require('drizzle-orm/pg-core')
-//   exports.users = pgTable('users', {
-//     id: serial('id').primaryKey(),
-//     name: text('name').notNull(),
-//     created_at: timestamp('created_at').defaultNow(),
-//   })
-`,
-  "backend/.env": `PORT=${backendPort}
-`,
-  // ── Frontend ─────────────────────────────────────────────────────────────
-  "frontend/package.json": JSON.stringify(frontendPkg, null, 2),
-  "frontend/.env": `VITE_PORT=${frontendPort}
-VITE_BACKEND_PORT=${backendPort}
-VITE_BASE=${process.env.VITE_BASE || "/"}
-`,
-  "frontend/vite.config.ts": `import { defineConfig, loadEnv } from 'vite'
-import react from '@vitejs/plugin-react'
-import tailwindcss from '@tailwindcss/vite'
-import path from 'path'
-
-const env = loadEnv('', process.cwd(), '')
-
-function requiredPort(name: string) {
-  const value = env[name]
-  if (!value) {
-    throw new Error(\`Missing \${name}. Set it in frontend/.env or your shell environment.\`)
-  }
-
-  const port = Number.parseInt(value, 10)
-  if (!Number.isInteger(port) || port < 1 || port > 65535) {
-    throw new Error(\`Invalid \${name}: \${value}\`)
-  }
-
-  return port
-}
-
-const FRONTEND_PORT = requiredPort('VITE_PORT')
-const BACKEND_PORT = requiredPort('VITE_BACKEND_PORT')
-const BASE = env.VITE_BASE || '/'
-
-export default defineConfig({
-  base: BASE,
-  plugins: [react(), tailwindcss()],
-  server: {
-    port: FRONTEND_PORT,
-    host: '0.0.0.0',
-    proxy: {
-      '/proxy': { target: \`http://127.0.0.1:\${BACKEND_PORT}\`, changeOrigin: true },
-      '/api': { target: \`http://127.0.0.1:\${BACKEND_PORT}\`, changeOrigin: true },
-    },
-  },
-  resolve: {
-    alias: {
-      '@': path.resolve(__dirname, './src'),
-    },
-  },
-})
-`,
-  // index.html comes from templates/ directory (has cold-start guard script)
-  "frontend/tsconfig.json": JSON.stringify({
-    compilerOptions: {
-      target: "ES2020",
-      module: "ESNext",
-      moduleResolution: "bundler",
-      jsx: "react-jsx",
-      strict: true,
-      esModuleInterop: true,
-      skipLibCheck: true,
-      paths: { "@/*": ["./src/*"] }
-    },
-    include: ["src"]
-  }, null, 2),
-  "frontend/components.json": JSON.stringify({
-    "$schema": "https://ui.shadcn.com/schema.json",
-    "style": "default",
-    "rsc": false,
-    "tsx": true,
-    "tailwind": {
-      "config": "",
-      "css": "src/index.css",
-      "baseColor": "slate",
-      "cssVariables": true
-    },
-    "aliases": {
-      "components": "@/components",
-      "utils": "@surf-ai/sdk/react",
-      "hooks": "@/hooks"
-    }
-  }, null, 2),
-  // entry-client.tsx replaces main.tsx — comes from templates/ directory
-  "frontend/src/App.tsx": `import { useMarketPrice } from '@surf-ai/sdk/react'
-
-export default function App() {
-  const { data, isLoading, error } = useMarketPrice({ symbol: 'BTC', time_range: '1d' })
-
-  return (
-    <div className="min-h-screen bg-background text-foreground p-10">
-      <h1 className="text-3xl font-bold mb-4">Surf App</h1>
-      {isLoading && <p className="text-muted-foreground">Loading BTC price...</p>}
-      {error && <p className="text-destructive">Error: {(error as Error).message}</p>}
-      {data?.data?.[0] && (
-        <p className="text-4xl font-bold">
-          BTC: <span className="text-primary">\${data.data[0].value?.toLocaleString()}</span>
-        </p>
-      )}
-    </div>
-  )
-}
-`,
-  "frontend/src/index.css": `@import url('https://fonts.googleapis.com/css2?family=Lato:wght@400;600;700;900&family=Roboto+Mono:wght@400;500&display=swap');
-@import "tailwindcss";
-@import "tw-animate-css";
-@import "@surf-ai/theme";
-`,
-  // cn() and useToast() are now in @surf-ai/sdk/react
-  "frontend/src/db/schema.ts": `// Database schema definition \u2014 keep in sync with backend/db/schema.js.
-// This file mirrors the backend schema for TypeScript type safety in the frontend.
-//
-// Example:
-//   import { pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core'
-//   export const users = pgTable('users', {
-//     id: serial('id').primaryKey(),
-//     name: text('name').notNull(),
-//     created_at: timestamp('created_at').defaultNow(),
-//   })
-`,
-  "frontend/src/vite-env.d.ts": `/// <reference types="vite/client" />
-`,
-  // ── Root ──────────────────────────────────────────────────────────────────
-  "CLAUDE.md": `# Project
-
-Built with [Surf SDK](https://github.com/cyberconnecthq/urania/tree/main/packages/sdk).
-
-## Imports from @surf-ai/sdk
-
-Everything comes from \`@surf-ai/sdk\`. Do NOT create local utility files for these.
-
-**Frontend (\`@surf-ai/sdk/react\`):**
-\`\`\`tsx
-import { useMarketPrice, useTokenHolders } from '@surf-ai/sdk/react'  // data hooks
-import { cn } from '@surf-ai/sdk/react'                                // Tailwind class merge
-import { useToast, toast } from '@surf-ai/sdk/react'                   // toast notifications
-\`\`\`
-
-**Backend (\`@surf-ai/sdk/server\`):**
-\`\`\`js
-const { dataApi } = require('@surf-ai/sdk/server')
-const data = await dataApi.market.price({ symbol: 'BTC' })
-const holders = await dataApi.token.holders({ address: '0x...', chain: 'ethereum' })
-// Escape hatch for new endpoints:
-const raw = await dataApi.get('newcategory/endpoint', { foo: 'bar' })
-\`\`\`
-
-## Structure
-
-\`\`\`
-frontend/src/App.tsx       - build your UI here
-frontend/src/components/   - add components
-frontend/src/db/schema.ts  - frontend DB schema mirror
-backend/routes/*.js        - add API routes (auto-mounted at /api/{name})
-backend/db/schema.js       - define database tables
-\`\`\`
-
-## Built-in Endpoints (from @surf-ai/sdk/server)
-
-\`createServer()\` provides these automatically \u2014 do NOT create routes for them:
-
-| Endpoint | Method | Purpose |
-|----------|--------|---------|
-| \`/api/health\` | GET | Health check \u2014 \`{ status: 'ok' }\` |
-| \`/api/__sync-schema\` | POST | Sync \`backend/db/schema.js\` tables to database |
-| \`/api/cron\` | GET | List cron jobs with status and next run time |
-| \`/api/cron\` | POST | Create a new cron task |
-| \`/api/cron/:id\` | PATCH | Update a cron task (schedule, enabled, etc.) |
-| \`/api/cron/:id\` | DELETE | Delete a cron task |
-| \`/api/cron/:id/run\` | POST | Manually trigger a cron task |
-| \`/proxy/*\` | ANY | Data API passthrough \u2014 \`/proxy/market/price\` \u2192 hermod |
-
-Auto-registered from \`backend/routes/*.js\`:
-| File | Endpoint |
-|------|----------|
-| \`routes/btc.js\` | \`/api/btc\` |
-| \`routes/portfolio.js\` | \`/api/portfolio\` |
-
-## Database
-
-Define tables in \`backend/db/schema.js\` using Drizzle ORM:
-\`\`\`js
-const { pgTable, serial, text, timestamp } = require('drizzle-orm/pg-core')
-exports.users = pgTable('users', {
-  id: serial('id').primaryKey(),
-  name: text('name').notNull(),
-  created_at: timestamp('created_at').defaultNow(),
-})
-\`\`\`
-
-Tables are auto-created on startup and when \`schema.js\` changes (file watcher).
-The agent can also call \`POST /api/__sync-schema\` explicitly after editing.
-
-## Dev Servers
-
-- Frontend: \`cd frontend && npm run dev\` (port from \`.env\`, do NOT pass \`--port\`)
-- Backend: \`cd backend && npm run dev\` (port from \`.env\`)
-- After \`npm install\` new packages, do NOT restart servers \u2014 Vite auto-discovers deps, backend uses \`node --watch\`
-- If a server crashes, restart with \`npm run dev\` in that directory
-- NEVER use \`npx vite\` \u2014 always use \`npm run dev\`
-
-## Do NOT modify
-
-- \`vite.config.ts\` \u2014 proxy and build config
-- \`frontend/.env\` \u2014 port configuration (auto-generated)
-- \`backend/server.js\` \u2014 uses @surf-ai/sdk/server
-- \`entry-client.tsx\` \u2014 app bootstrap with SSR hydration
-- \`entry-server.tsx\` \u2014 SSR render for deploy
-- \`index.html\` \u2014 cold-start guard and Surf badge
-- \`eslint.config.*\` \u2014 lint rules
-- \`index.css\` \u2014 only imports, do not add styles here (use Tailwind classes)
-
-## Rules
-
-- Use \`@surf-ai/sdk/react\` hooks in frontend, \`@surf-ai/sdk/server\` dataApi in backend
-- Use Tailwind CSS classes for styling (Surf Design System theme via \`@surf-ai/theme\`)
-- Use shadcn/ui components \u2014 install with \`npx shadcn@latest add button\`
-- Use \`cn()\` from \`@surf-ai/sdk/react\` to merge Tailwind classes
-- Frontend packages are pre-installed \u2014 check \`package.json\` before installing
-- Dark theme is the default (configured in entry-client.tsx)
-`
-};
-var root = path.resolve(projectName);
-var name = path.basename(root);
-console.log(`
-  Creating Surf app in ./${projectName === "." ? "" : name}
-`);
-fs.mkdirSync(root, { recursive: true });
-for (const [relPath, content] of Object.entries(templates)) {
-  const fullPath = path.join(root, relPath);
-  fs.mkdirSync(path.dirname(fullPath), { recursive: true });
-  fs.writeFileSync(fullPath, content);
-  console.log(`  ${relPath}`);
-}
-var templatesDir = path.join(new URL(".", import.meta.url).pathname, "templates");
-if (fs.existsSync(templatesDir)) {
-  copyDir(templatesDir, root);
-}
-function copyDir(src, dest) {
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      fs.mkdirSync(destPath, { recursive: true });
-      copyDir(srcPath, destPath);
-    } else {
-      fs.writeFileSync(destPath, fs.readFileSync(srcPath));
-      console.log(`  ${path.relative(root, destPath)}`);
-    }
-  }
-}
-var cdStep = projectName === "." ? "" : `  cd ${name}
-`;
-console.log(`
-Done! Next steps:
-
-${cdStep}  cd backend && npm install && cd ..
-  cd frontend && npm install && cd ..
-
-  # Start backend
-  cd backend && npm run dev &
-
-  # Start frontend
-  cd frontend && npm run dev
-
-  Open http://localhost:${frontendPort}
-`);

package/dist/templates/default/CLAUDE.md

@@ -0,0 +1,46 @@
+# Project Rules
+
+## Do NOT Touch
+
+- `vite.config.ts` — pre-configured proxy chain; changing it breaks preview.
+- `.env` files — managed by the system; editing causes Vite restart & preview downtime.
+- `entry-client.tsx` `notifyParentReady` / `data-surf-placeholder` — hosting app depends on these.
+- Dev servers — NEVER start/stop/kill/restart them manually (`pkill`, `kill`, `node`, `npm run dev`). Causes EADDRINUSE.
+
+## npm install Rules
+
+- **ALL packages in `frontend/package.json` are already installed.** Just import them directly — do NOT run `npm install` for them.
+- Running `npm install` on pre-installed packages corrupts the node_modules tmpfs mount, kills the Vite dev server, and causes 5+ minute preview downtime (white screen).
+- Only `npm install` packages that are NOT in package.json. When in doubt, read `frontend/package.json` first.
+
+## Editing Rules
+
+- **Read before edit** — always Read a file before using Edit or Write on it.
+- **Edit, don't rewrite** — use the Edit tool on scaffold files (marked SCAFFOLD). Never use Write to replace them entirely; it breaks infrastructure (proxy, HMR, cold-start guards).
+- **One file per tool call** — enables streaming progress and faster error recovery.
+- **200-line limit** — split components exceeding 200 lines into sub-components.
+
+## Storage Rules
+
+- **Never use localStorage or in-memory arrays for persistent user data** (CRUD, todos, plans, bookmarks, notes, watchlists, etc.). Read `.claude/skills/database/SKILL.md` and use PostgreSQL + Drizzle ORM.
+- localStorage is ONLY acceptable for: theme preference, UI collapsed/expanded state, session tokens.
+
+## Data Table Rules
+
+- **List tables need sorting + pagination + search.** Tables displaying browsable collections (token lists, tx history, leaderboards — unbounded row count) MUST use the SortableTable pattern from `component-reference/references/data-display.md`. Plain `<Table>` is fine for summary/comparison tables or small bounded-size API results (top-5, recent-3).
+
+## First-Edit Checklist (do on every new project)
+
+- **Page title** — ALWAYS update `<title>App</title>` in `frontend/index.html` to a meaningful title matching the website purpose. Never ship with `<title>App</title>`.
+- **Favicon** — `frontend/public/favicon.ico` is already provided; do NOT delete or overwrite it.
+
+## Common Mistakes to Avoid
+
+- **API URLs** — NEVER use bare `/proxy/...` or `/api/...`. Always use `${API_BASE}/proxy/...`, `${API_BASE}/api/...`, or the generated hooks in `api.ts`.
+- **No React.lazy / dynamic import()** — HMR is unavailable in preview; causes "Invalid hook call" crashes.
+- **Hooks at top level** — ALL React hooks MUST be called before any conditional `return`. Use `useQuery({ enabled: !!condition })` for conditional fetching.
+- **SSR safety** — NEVER access `document`, `window`, `localStorage` at module top level or during render. Use `typeof window !== 'undefined'` or `useEffect`.
+- **API response safety** — NEVER render API fields without type-checking. Objects as React children cause white-screen crashes: `typeof x === 'string' ? x : x?.name ?? ''`.
+- **ThemeProvider** — MUST set `storageKey="surf-studio-theme"` to avoid conflicts with the parent Surf app iframe.
+- **No mock data** — never hardcode data. Use real API calls; show proper error/empty states.
+- **ASCII only** — no curly quotes, en-dash, em-dash in code. Non-ASCII punctuation causes build failures.

package/dist/templates/default/backend/db/index.js

@@ -0,0 +1,23 @@
+/**
+ * Drizzle ORM client (pg-proxy driver).
+ *
+ * Routes all SQL through hermod's DB proxy — works identically in
+ * sandbox (OutboundProxy) and deployed mode (hermod gateway).
+ *
+ * Usage:
+ *   const { db } = require('./db');
+ *   const { todos } = require('./db/schema');
+ *   const rows = await db.select().from(todos);
+ */
+
+const { drizzle } = require('drizzle-orm/pg-proxy');
+const { dbQuery } = require('../lib/db');
+
+const db = drizzle(async (sql, params, method) => {
+  const result = await dbQuery(sql, params, { arrayMode: true });
+  // pg-proxy expects rows as positional arrays — arrayMode makes hermod
+  // return [[val1, val2, ...], ...] instead of [{col: val}, ...].
+  return { rows: result.rows || [] };
+});
+
+module.exports = { db };

package/dist/templates/default/backend/db/schema.js

@@ -0,0 +1,20 @@
+/**
+ * Drizzle ORM schema definitions.
+ *
+ * Define your tables here using Drizzle's pgTable builder.
+ * This file is the single source of truth for your database schema.
+ *
+ * Example:
+ *   const { pgTable, serial, text, boolean, timestamp } = require('drizzle-orm/pg-core');
+ *
+ *   const todos = pgTable('todos', {
+ *     id: serial('id').primaryKey(),
+ *     title: text('title').notNull(),
+ *     completed: boolean('completed').default(false),
+ *     createdAt: timestamp('created_at', { withTimezone: true }).defaultNow(),
+ *   });
+ *
+ *   module.exports = { todos };
+ */
+
+// Add your table definitions here.

package/dist/templates/{backend → default/backend}/eslint.config.mjs

@@ -2,7 +2,7 @@ import js from '@eslint/js';
 import globals from 'globals';
 
 export default [
-  { ignores: ['node_modules'] },
+  { ignores: ['node_modules', 'lib/api*.js'] },
   {
     files: ['**/*.js'],
     ...js.configs.recommended,

package/dist/templates/default/backend/lib/db.js

@@ -0,0 +1,67 @@
+/**
+ * Server-side database helpers.
+ *
+ * All SQL execution happens here in the backend — NEVER in frontend code.
+ * Calls /proxy/db/* via loopback through the Express proxy middleware,
+ * which handles both sandbox mode (OutboundProxy) and deployed mode (hermod).
+ */
+
+const PORT = Number.parseInt(process.env.PORT || '', 10);
+if (!Number.isInteger(PORT)) {
+  throw new Error('PORT env var is required');
+}
+const BASE = `http://127.0.0.1:${PORT}/proxy/db`;
+
+async function request(path, options = {}) {
+  const res = await fetch(`${BASE}${path}`, options);
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({ message: res.statusText }));
+    const err = new Error(body.detail || body.error || body.message || `DB request failed: ${res.status}`);
+    err.status = res.status;
+    throw err;
+  }
+  return res.json();
+}
+
+/** Provision a database for the current user (idempotent). */
+async function dbProvision(reason) {
+  return request('/provision', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ reason: reason || '' }),
+  });
+}
+
+/**
+ * Execute a parameterized SQL query.
+ * ALWAYS use $1, $2, ... placeholders — NEVER concatenate user input.
+ * @param {string} sql
+ * @param {any[]} params
+ * @param {{ arrayMode?: boolean }} [options] - Pass { arrayMode: true } for Drizzle pg-proxy
+ */
+async function dbQuery(sql, params = [], options = {}) {
+  return request('/query', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ sql, params, ...options }),
+  });
+}
+
+/** List all tables with approximate row counts. */
+async function dbTables() {
+  const data = await request('/tables');
+  return data.tables;
+}
+
+/** Get column definitions for a table. */
+async function dbTableSchema(name) {
+  const data = await request(`/tables/${encodeURIComponent(name)}/schema`);
+  return data.columns;
+}
+
+/** Check database connection status and usage. */
+async function dbStatus() {
+  return request('/status');
+}
+
+module.exports = { dbProvision, dbQuery, dbTables, dbTableSchema, dbStatus };

package/dist/templates/default/backend/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "backend",
+  "private": true,
+  "version": "0.0.0",
+  "scripts": {
+    "check": "node --check server.js && find routes lib db -type f -name '*.js' -print0 | xargs -0 -n1 node --check",
+    "lint": "eslint .",
+    "start": "node server.js",
+    "dev": "node --watch --watch-path=./routes --watch-path=./lib --watch-path=./server.js server.js",
+    "verify": "npm run lint && npm run check"
+  },
+  "dependencies": {
+    "express": "4.22.1",
+    "cors": "2.8.6",
+    "http-proxy-middleware": "3.0.5",
+    "drizzle-orm": "0.44.7",
+    "drizzle-kit": "0.30.6",
+    "croner": "9.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.4",
+    "eslint": "9.39.4",
+    "globals": "16.5.0"
+  }
+}