vela 0.9.1 → 0.10.1

package/dist/bin.js

@@ -7,7 +7,7 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 // package.json
 var package_default = {
   name: "vela",
-  version: "0.9.1",
+  version: "0.10.1",
   type: "module",
   description: "A CLI for creating and updating SvelteKit projects",
   license: "MIT",
@@ -41,8 +41,8 @@ var package_default = {
   dependencies: {
     "@clack/prompts": "^1.7.0",
     "@faker-js/faker": "^10.6.0",
-    "@velastack/patterns": "^0.0.61",
-    "@velastack/pocketbase": "^0.1.0",
+    "@velastack/patterns": "^0.1.0",
+    "@velastack/pocketbase-codegen": "^0.1.0",
     "annotate-json-schema": "^0.1.0",
     commander: "^13.1.0",
     "cross-spawn": "^7.0.6",
@@ -279,6 +279,161 @@ function stubCommand(name, description, fullName) {
   return cmd;
 }
 
+// src/lib/workspace.ts
+import fs3 from "node:fs";
+import path2 from "node:path";
+import process3 from "node:process";
+
+// src/lib/constants.ts
+var DATA_DIR = "data";
+var MIGRATIONS_DIR = "migrations";
+var PUBLIC_DIR = "(public)";
+var APP_DIR = "(app)";
+var LEGAL_DIR = "(legal)";
+var API_URL = "https://velastack.dev";
+var FIXTURE_PREFIX = "vela";
+
+// src/lib/package-json.ts
+import fs2 from "node:fs";
+var DEP_KINDS = ["dependencies", "devDependencies"];
+function mergePackageJson(user, template) {
+  const merged = structuredClone(user);
+  const added = [];
+  const conflicts = [];
+  const replaced = [];
+  for (const kind of DEP_KINDS) {
+    const templateDeps = template[kind];
+    if (!templateDeps) continue;
+    const userDeps = merged[kind] ??= {};
+    const otherKind = kind === "dependencies" ? "devDependencies" : "dependencies";
+    const userOther = user[otherKind] ?? {};
+    for (const [name, templateValue] of Object.entries(templateDeps)) {
+      if (name in userDeps) {
+        if (userDeps[name] !== templateValue) {
+          conflicts.push({ kind, name, templateValue, userValue: userDeps[name] });
+        }
+        continue;
+      }
+      if (name in userOther) {
+        continue;
+      }
+      userDeps[name] = templateValue;
+      added.push({ kind, name, templateValue });
+    }
+  }
+  const templateScripts = template.scripts;
+  if (templateScripts) {
+    const userScripts = merged.scripts ??= {};
+    for (const [name, templateValue] of Object.entries(templateScripts)) {
+      const existing = userScripts[name];
+      if (existing === void 0) {
+        userScripts[name] = templateValue;
+        added.push({ kind: "scripts", name, templateValue });
+        continue;
+      }
+      if (existing === templateValue) continue;
+      userScripts[name] = templateValue;
+      replaced.push({ kind: "scripts", name, templateValue, userValue: existing });
+    }
+  }
+  for (const kind of DEP_KINDS) {
+    const deps = merged[kind];
+    if (deps) merged[kind] = sortKeys(deps);
+  }
+  return { merged, added, conflicts, replaced };
+}
+function readPackageJson(path36) {
+  return JSON.parse(fs2.readFileSync(path36, "utf8"));
+}
+var PACKAGE_NAME_PLACEHOLDER = /~TODO~/g;
+var APP_NAME_PLACEHOLDER = /~APP_NAME~/g;
+var CLI_VERSION_PLACEHOLDER = /~VELA_VERSION~/g;
+function fillTemplatePlaceholders(raw, values) {
+  const packageName = toValidPackageName(values.appName);
+  const appName = escapeSingleQuoted(values.appName);
+  return raw.replace(PACKAGE_NAME_PLACEHOLDER, () => packageName).replace(APP_NAME_PLACEHOLDER, () => appName).replace(CLI_VERSION_PLACEHOLDER, () => values.cliVersion);
+}
+function escapeSingleQuoted(value) {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+function readTemplatePackageJson(path36, values) {
+  const raw = fillTemplatePlaceholders(fs2.readFileSync(path36, "utf8"), values);
+  return JSON.parse(raw);
+}
+function writePackageJson(path36, pkg) {
+  fs2.writeFileSync(path36, JSON.stringify(pkg, null, "	") + "\n");
+}
+function toValidPackageName(name) {
+  return name.trim().toLowerCase().replace(/\s+/g, "-").replace(/^[._]/, "").replace(/[^a-z0-9~.-]+/g, "-");
+}
+function sortKeys(obj) {
+  const sorted = {};
+  for (const key of Object.keys(obj).sort()) sorted[key] = obj[key];
+  return sorted;
+}
+
+// src/lib/workspace.ts
+function findWorkspaceRoot(from = process3.cwd()) {
+  let currentDir = from;
+  while (currentDir !== path2.parse(currentDir).root) {
+    if (fs3.existsSync(path2.join(currentDir, "package.json"))) return currentDir;
+    currentDir = path2.dirname(currentDir);
+  }
+  return null;
+}
+function hasBackend(from = process3.cwd()) {
+  const root = findWorkspaceRoot(from);
+  return root !== null && fs3.existsSync(path2.join(root, DATA_DIR));
+}
+async function getWorkspace() {
+  const workspaceRootDir = findWorkspaceRoot();
+  if (!workspaceRootDir) {
+    throw new Error("Could not find workspace root (no package.json found)");
+  }
+  const routesDir = path2.join("src", "routes");
+  const fullRoutesPath = path2.join(workspaceRootDir, routesDir);
+  if (!fs3.existsSync(fullRoutesPath)) {
+    throw new Error("Could not find src/routes directory");
+  }
+  let publicRoutesDir = path2.join(routesDir, PUBLIC_DIR);
+  if (!fs3.existsSync(path2.join(workspaceRootDir, publicRoutesDir))) {
+    publicRoutesDir = routesDir;
+  }
+  let appRoutesDir;
+  const appRoutesPath = path2.join(fullRoutesPath, APP_DIR);
+  const isAppMode = fs3.existsSync(appRoutesPath);
+  if (isAppMode) appRoutesDir = path2.join(routesDir, APP_DIR);
+  const isPaymentsMode = fs3.existsSync(
+    path2.join(workspaceRootDir, routesDir, "webhooks", "stripe")
+  );
+  const features = detectFeatures(workspaceRootDir, { isAppMode, isPaymentsMode });
+  return {
+    workspaceRootDir,
+    routesDir,
+    publicRoutesDir,
+    appRoutesDir,
+    isAppMode,
+    isPaymentsMode,
+    features
+  };
+}
+function detectFeatures(root, { isAppMode, isPaymentsMode }) {
+  const has = (rel) => fs3.existsSync(path2.join(root, rel));
+  const pkg = readPackageJson(path2.join(root, "package.json"));
+  const hasDep = (name) => Boolean(pkg.dependencies?.[name] || pkg.devDependencies?.[name]);
+  return {
+    auth: isAppMode,
+    api: has("src/routes/api"),
+    apiKeys: has("src/routes/api/api-keys") || has("src/routes/(app)/api-keys"),
+    backend: has(DATA_DIR),
+    i18n: has("src/lib/i18n") || has("messages"),
+    teams: has("src/routes/(app)/teams") || has("src/lib/teams"),
+    payments: isPaymentsMode,
+    blog: hasDep("mdsvex"),
+    contentNegotiation: hasDep("sveltekit-negotiate")
+  };
+}
+
 // src/commands/bless.ts
 import fs12 from "node:fs";
 import path11 from "node:path";
@@ -317,32 +472,32 @@ function toFlag(key) {
 }
 
 // src/lib/templates.ts
-import fs2 from "node:fs";
-import path2 from "node:path";
+import fs4 from "node:fs";
+import path3 from "node:path";
 import { fileURLToPath } from "node:url";
 var TEMPLATE_MANIFEST = "template.json";
 var DEFAULT_TEMPLATE = "minimal";
 var cached;
 function templatesDir() {
-  let dir = path2.dirname(fileURLToPath(import.meta.url));
-  const { root } = path2.parse(dir);
+  let dir = path3.dirname(fileURLToPath(import.meta.url));
+  const { root } = path3.parse(dir);
   while (dir !== root) {
-    const candidate = path2.join(dir, "templates");
+    const candidate = path3.join(dir, "templates");
     if (holdsManifest(candidate)) return candidate;
-    dir = path2.dirname(dir);
+    dir = path3.dirname(dir);
   }
   throw new Error("Could not locate the templates directory");
 }
 function holdsManifest(dir) {
-  if (!fs2.existsSync(dir)) return false;
-  return fs2.readdirSync(dir, { withFileTypes: true }).some(
-    (entry) => entry.isDirectory() && fs2.existsSync(path2.join(dir, entry.name, TEMPLATE_MANIFEST))
+  if (!fs4.existsSync(dir)) return false;
+  return fs4.readdirSync(dir, { withFileTypes: true }).some(
+    (entry) => entry.isDirectory() && fs4.existsSync(path3.join(dir, entry.name, TEMPLATE_MANIFEST))
   );
 }
 function listProjectTemplates() {
   if (cached) return cached;
   const root = templatesDir();
-  cached = fs2.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => readManifest(root, entry.name)).filter((template) => template !== void 0).sort((a, b) => a.name.localeCompare(b.name));
+  cached = fs4.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => readManifest(root, entry.name)).filter((template) => template !== void 0).sort((a, b) => a.name.localeCompare(b.name));
   return cached;
 }
 function projectTemplateNames(options = {}) {
@@ -356,11 +511,11 @@ function findProjectTemplate(name) {
   return template;
 }
 function readManifest(root, name) {
-  const manifestPath = path2.join(root, name, TEMPLATE_MANIFEST);
-  if (!fs2.existsSync(manifestPath)) return void 0;
+  const manifestPath = path3.join(root, name, TEMPLATE_MANIFEST);
+  if (!fs4.existsSync(manifestPath)) return void 0;
   let parsed;
   try {
-    parsed = JSON.parse(fs2.readFileSync(manifestPath, "utf8"));
+    parsed = JSON.parse(fs4.readFileSync(manifestPath, "utf8"));
   } catch (e) {
     throw new Error(
       `Template ${name} has an unreadable ${TEMPLATE_MANIFEST}: ${e.message}`
@@ -376,14 +531,14 @@ function readManifest(root, name) {
     name,
     description: manifest.description,
     backend: manifest.backend,
-    dir: path2.join(root, name)
+    dir: path3.join(root, name)
   };
 }
 
 // src/lib/package-manager.ts
-import fs3 from "node:fs";
-import path3 from "node:path";
-import process3 from "node:process";
+import fs5 from "node:fs";
+import path4 from "node:path";
+import process4 from "node:process";
 import { exec } from "tinyexec";
 import { Option } from "commander";
 import * as p2 from "@clack/prompts";
@@ -399,7 +554,7 @@ var installOption = new Option(
   "installs dependencies with a specified package manager"
 ).choices(AGENT_NAMES);
 function getUserAgent() {
-  const userAgent = process3.env.npm_config_user_agent;
+  const userAgent = process4.env.npm_config_user_agent;
   if (!userAgent) return void 0;
   const pmSpec = userAgent.split(" ")[0];
   const separatorPos = pmSpec.lastIndexOf("/");
@@ -409,7 +564,7 @@ function getUserAgent() {
 async function packageManagerPrompt(cwd) {
   const detected = await detect({ cwd });
   const agent = detected?.name ?? getUserAgent();
-  if (!process3.stdout.isTTY) return agent;
+  if (!process4.stdout.isTTY) return agent;
   const options = [
     { label: "None", value: void 0 },
     ...AGENT_NAMES.map((pm2) => ({ value: pm2, label: pm2 }))
@@ -421,14 +576,14 @@ async function packageManagerPrompt(cwd) {
   });
   if (p2.isCancel(pm)) {
     p2.cancel("Operation cancelled.");
-    process3.exit(1);
+    process4.exit(1);
   }
   return pm;
 }
 async function installDependencies(agent, cwd) {
   const task = p2.taskLog({
     title: `Installing dependencies with ${agent}...`,
-    limit: Math.ceil(process3.stdout.rows / 2),
+    limit: Math.ceil(process4.stdout.rows / 2),
     spacing: 0,
     retainLog: true
   });
@@ -445,14 +600,14 @@ async function installDependencies(agent, cwd) {
   } catch {
     task.error("Failed to install dependencies");
     p2.cancel("Operation failed.");
-    process3.exit(2);
+    process4.exit(2);
   }
 }
 function addPnpmBuildDependencies(cwd, packageManager, allowedPackages) {
   if (!packageManager || packageManager !== "pnpm") return;
-  const pkgPath = path3.join(cwd, "package.json");
-  if (!fs3.existsSync(pkgPath)) return;
-  const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
+  const pkgPath = path4.join(cwd, "package.json");
+  if (!fs5.existsSync(pkgPath)) return;
+  const pkg = JSON.parse(fs5.readFileSync(pkgPath, "utf-8"));
   pkg.pnpm ??= {};
   pkg.pnpm.onlyBuiltDependencies ??= [];
   for (const name of allowedPackages) {
@@ -460,30 +615,19 @@ function addPnpmBuildDependencies(cwd, packageManager, allowedPackages) {
       pkg.pnpm.onlyBuiltDependencies.push(name);
     }
   }
-  fs3.writeFileSync(pkgPath, JSON.stringify(pkg, null, "	") + "\n");
+  fs5.writeFileSync(pkgPath, JSON.stringify(pkg, null, "	") + "\n");
 }
 
 // src/lib/pocketbase.ts
-import fs4 from "node:fs";
+import fs6 from "node:fs";
 import net from "node:net";
-import path4 from "node:path";
-import process4 from "node:process";
+import path5 from "node:path";
+import process5 from "node:process";
 import { spawn } from "node:child_process";
 import PocketBase from "pocketbase";
 import { detect as detect2 } from "package-manager-detector";
 import { resolveCommand } from "package-manager-detector/commands";
 import { x } from "tinyexec";
-
-// src/lib/constants.ts
-var DATA_DIR = "data";
-var MIGRATIONS_DIR = "migrations";
-var PUBLIC_DIR = "(public)";
-var APP_DIR = "(app)";
-var LEGAL_DIR = "(legal)";
-var API_URL = "https://velastack.dev";
-var FIXTURE_PREFIX = "vela";
-
-// src/lib/pocketbase.ts
 function findFreePort(host = "localhost") {
   return new Promise((resolve, reject) => {
     const server = net.createServer();
@@ -589,9 +733,9 @@ async function authWithRetries(pb, email3, password8, attempts = 3) {
   }
 }
 function getPocketbaseMetadata(cwd) {
-  const metadataPath = path4.join(cwd, "node_modules", ".vite", "_pocketbase_metadata.json");
-  if (fs4.existsSync(metadataPath)) {
-    return JSON.parse(fs4.readFileSync(metadataPath, "utf8"));
+  const metadataPath = path5.join(cwd, "node_modules", ".vite", "_pocketbase_metadata.json");
+  if (fs6.existsSync(metadataPath)) {
+    return JSON.parse(fs6.readFileSync(metadataPath, "utf8"));
   }
   return null;
 }
@@ -604,12 +748,12 @@ async function execPackageBin(cwd, args, stdio = "pipe") {
   return x(command, resolvedArgs, { nodeOptions: { cwd, stdio }, throwOnError: true });
 }
 async function withPocketbase(cwd, fn, creds) {
-  const dir = path4.join(cwd, DATA_DIR);
-  const migrationsDir = path4.join(cwd, MIGRATIONS_DIR);
+  const dir = path5.join(cwd, DATA_DIR);
+  const migrationsDir = path5.join(cwd, MIGRATIONS_DIR);
   const host = "localhost";
-  const email3 = creds?.email ?? process4.env.POCKETBASE_SUPERUSER_EMAIL;
-  const password8 = creds?.password ?? process4.env.POCKETBASE_SUPERUSER_PASSWORD;
-  if (!fs4.existsSync(dir)) {
+  const email3 = creds?.email ?? process5.env.POCKETBASE_SUPERUSER_EMAIL;
+  const password8 = creds?.password ?? process5.env.POCKETBASE_SUPERUSER_PASSWORD;
+  if (!fs6.existsSync(dir)) {
     throw new Error("PocketBase data directory does not exist");
   }
   const metadata = getPocketbaseMetadata(cwd);
@@ -634,10 +778,10 @@ async function withPocketbase(cwd, fn, creds) {
   }
 }
 async function createSuperuser(cwd, email3, password8) {
-  const dir = path4.join(cwd, DATA_DIR);
-  const migrationsDir = path4.join(cwd, MIGRATIONS_DIR);
-  fs4.mkdirSync(dir, { recursive: true });
-  fs4.mkdirSync(migrationsDir, { recursive: true });
+  const dir = path5.join(cwd, DATA_DIR);
+  const migrationsDir = path5.join(cwd, MIGRATIONS_DIR);
+  fs6.mkdirSync(dir, { recursive: true });
+  fs6.mkdirSync(migrationsDir, { recursive: true });
   await execPackageBin(
     cwd,
     [
@@ -661,8 +805,8 @@ async function launchPocketbase(cwd, {
   password: password8
 }) {
   const host = "localhost";
-  fs4.mkdirSync(dir, { recursive: true });
-  fs4.mkdirSync(migrationsDir, { recursive: true });
+  fs6.mkdirSync(dir, { recursive: true });
+  fs6.mkdirSync(migrationsDir, { recursive: true });
   await execPackageBin(
     cwd,
     [
@@ -696,8 +840,8 @@ async function launchPocketbase(cwd, {
 }
 
 // src/lib/env.ts
-import fs5 from "node:fs";
-import path5 from "node:path";
+import fs7 from "node:fs";
+import path6 from "node:path";
 function addEnvVar(content, key, value) {
   if (content.includes(`${key}=`)) return content;
   return appendLine(content, `${key}=${value}`);
@@ -712,99 +856,20 @@ function appendLine(existing, line) {
   return withNewline + line + "\n";
 }
 function writeEnvFile(cwd, vars, comments = []) {
-  const envPath = path5.join(cwd, ".env");
-  let content = fs5.existsSync(envPath) ? fs5.readFileSync(envPath, "utf8") : "";
+  const envPath = path6.join(cwd, ".env");
+  let content = fs7.existsSync(envPath) ? fs7.readFileSync(envPath, "utf8") : "";
   for (const comment of comments) content = addEnvComment(content, comment);
   for (const [key, value] of Object.entries(vars)) content = addEnvVar(content, key, value);
-  fs5.writeFileSync(envPath, content);
-}
-
-// src/lib/package-json.ts
-import fs6 from "node:fs";
-var DEP_KINDS = ["dependencies", "devDependencies"];
-function mergePackageJson(user, template) {
-  const merged = structuredClone(user);
-  const added = [];
-  const conflicts = [];
-  const replaced = [];
-  for (const kind of DEP_KINDS) {
-    const templateDeps = template[kind];
-    if (!templateDeps) continue;
-    const userDeps = merged[kind] ??= {};
-    const otherKind = kind === "dependencies" ? "devDependencies" : "dependencies";
-    const userOther = user[otherKind] ?? {};
-    for (const [name, templateValue] of Object.entries(templateDeps)) {
-      if (name in userDeps) {
-        if (userDeps[name] !== templateValue) {
-          conflicts.push({ kind, name, templateValue, userValue: userDeps[name] });
-        }
-        continue;
-      }
-      if (name in userOther) {
-        continue;
-      }
-      userDeps[name] = templateValue;
-      added.push({ kind, name, templateValue });
-    }
-  }
-  const templateScripts = template.scripts;
-  if (templateScripts) {
-    const userScripts = merged.scripts ??= {};
-    for (const [name, templateValue] of Object.entries(templateScripts)) {
-      const existing = userScripts[name];
-      if (existing === void 0) {
-        userScripts[name] = templateValue;
-        added.push({ kind: "scripts", name, templateValue });
-        continue;
-      }
-      if (existing === templateValue) continue;
-      userScripts[name] = templateValue;
-      replaced.push({ kind: "scripts", name, templateValue, userValue: existing });
-    }
-  }
-  for (const kind of DEP_KINDS) {
-    const deps = merged[kind];
-    if (deps) merged[kind] = sortKeys(deps);
-  }
-  return { merged, added, conflicts, replaced };
-}
-function readPackageJson(path36) {
-  return JSON.parse(fs6.readFileSync(path36, "utf8"));
-}
-var PACKAGE_NAME_PLACEHOLDER = /~TODO~/g;
-var APP_NAME_PLACEHOLDER = /~APP_NAME~/g;
-var CLI_VERSION_PLACEHOLDER = /~VELA_VERSION~/g;
-function fillTemplatePlaceholders(raw, values) {
-  const packageName = toValidPackageName(values.appName);
-  const appName = escapeSingleQuoted(values.appName);
-  return raw.replace(PACKAGE_NAME_PLACEHOLDER, () => packageName).replace(APP_NAME_PLACEHOLDER, () => appName).replace(CLI_VERSION_PLACEHOLDER, () => values.cliVersion);
-}
-function escapeSingleQuoted(value) {
-  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
-}
-function readTemplatePackageJson(path36, values) {
-  const raw = fillTemplatePlaceholders(fs6.readFileSync(path36, "utf8"), values);
-  return JSON.parse(raw);
-}
-function writePackageJson(path36, pkg) {
-  fs6.writeFileSync(path36, JSON.stringify(pkg, null, "	") + "\n");
-}
-function toValidPackageName(name) {
-  return name.trim().toLowerCase().replace(/\s+/g, "-").replace(/^[._]/, "").replace(/[^a-z0-9~.-]+/g, "-");
-}
-function sortKeys(obj) {
-  const sorted = {};
-  for (const key of Object.keys(obj).sort()) sorted[key] = obj[key];
-  return sorted;
+  fs7.writeFileSync(envPath, content);
 }
 
 // src/lib/config-merge.ts
-import fs8 from "node:fs";
-import path7 from "node:path";
+import fs9 from "node:fs";
+import path8 from "node:path";
 
 // src/lib/config-target.ts
-import fs7 from "node:fs";
-import path6 from "node:path";
+import fs8 from "node:fs";
+import path7 from "node:path";
 import {
   Project,
   QuoteKind,
@@ -824,8 +889,8 @@ var SVELTE_CONFIG_CANDIDATES = [
 ];
 function probeFirstExisting(root, candidates) {
   for (const rel of candidates) {
-    const abs = path6.join(root, rel);
-    if (fs7.existsSync(abs)) return abs;
+    const abs = path7.join(root, rel);
+    if (fs8.existsSync(abs)) return abs;
   }
   return null;
 }
@@ -901,7 +966,7 @@ function mergeSvelteConfig(projectRoot) {
   };
 }
 function mergeRunesIntoViteArg(vite, arg) {
-  const file = path7.basename(vite.filePath);
+  const file = path8.basename(vite.filePath);
   const compilerOptions = getOrCreateObjectLiteralProperty(arg, "compilerOptions", "{}");
   if (!compilerOptions) {
     return {
@@ -920,8 +985,8 @@ function mergeRunesIntoViteArg(vite, arg) {
   return { applied: true, reason: "added runes compilerOption", file };
 }
 function mergeRunesIntoSvelteConfig(filePath) {
-  const file = path7.basename(filePath);
-  const original = fs8.readFileSync(filePath, "utf8");
+  const file = path8.basename(filePath);
+  const original = fs9.readFileSync(filePath, "utf8");
   if (/runes\s*:/m.test(original)) {
     return { applied: false, reason: "runes already configured", file };
   }
@@ -944,11 +1009,11 @@ function mergeRunesIntoSvelteConfig(filePath) {
   }
   const insertAt = anchor.index + anchor[0].length;
   const updated = original.slice(0, insertAt) + RUNES_SNIPPET + original.slice(insertAt);
-  fs8.writeFileSync(filePath, updated);
+  fs9.writeFileSync(filePath, updated);
   return { applied: true, reason: "added runes compilerOption", file };
 }
 function mergeViteConfig(filePath) {
-  if (!fs8.existsSync(filePath)) {
+  if (!fs9.existsSync(filePath)) {
     return {
       applied: false,
       reason: "vite.config.ts not found",
@@ -956,7 +1021,7 @@ function mergeViteConfig(filePath) {
 // then add tailwindcss() to the plugins array`
     };
   }
-  const original = fs8.readFileSync(filePath, "utf8");
+  const original = fs9.readFileSync(filePath, "utf8");
   if (original.includes("@tailwindcss/vite")) {
     return { applied: false, reason: "tailwindcss plugin already present" };
   }
@@ -975,14 +1040,14 @@ function mergeViteConfig(filePath) {
   const trailing = withImport.slice(insertAt);
   const prefix = /^\s*\]/.test(trailing) ? "tailwindcss()" : "tailwindcss(), ";
   const updated = withImport.slice(0, insertAt) + prefix + withImport.slice(insertAt);
-  fs8.writeFileSync(filePath, updated);
+  fs9.writeFileSync(filePath, updated);
   return { applied: true, reason: "added @tailwindcss/vite plugin" };
 }
 function mergeTsconfig(filePath) {
-  if (!fs8.existsSync(filePath)) {
+  if (!fs9.existsSync(filePath)) {
     return { applied: false, reason: "tsconfig.json not found" };
   }
-  const original = fs8.readFileSync(filePath, "utf8");
+  const original = fs9.readFileSync(filePath, "utf8");
   if (/rewriteRelativeImportExtensions/.test(original)) {
     return { applied: false, reason: "rewriteRelativeImportExtensions already set" };
   }
@@ -998,7 +1063,7 @@ function mergeTsconfig(filePath) {
   const indent = detectIndent(original, insertAt);
   const updated = original.slice(0, insertAt) + `
 ${indent}"rewriteRelativeImportExtensions": true,` + original.slice(insertAt);
-  fs8.writeFileSync(filePath, updated);
+  fs9.writeFileSync(filePath, updated);
   return { applied: true, reason: "added rewriteRelativeImportExtensions" };
 }
 var GITIGNORE_ENTRIES = [
@@ -1010,7 +1075,7 @@ var GITIGNORE_ENTRIES = [
   "vite.config.ts.timestamp-*"
 ];
 function mergeGitignore(filePath) {
-  const existing = fs8.existsSync(filePath) ? fs8.readFileSync(filePath, "utf8") : "";
+  const existing = fs9.existsSync(filePath) ? fs9.readFileSync(filePath, "utf8") : "";
   const lines = existing.split("\n").map((l) => l.trim());
   const missing = GITIGNORE_ENTRIES.filter((entry) => !lines.includes(entry));
   if (missing.length === 0) {
@@ -1019,7 +1084,7 @@ function mergeGitignore(filePath) {
   const needsNewline = existing.length > 0 && !existing.endsWith("\n");
   const appended = `${existing}${needsNewline ? "\n" : ""}${missing.join("\n")}
 `;
-  fs8.writeFileSync(filePath, appended);
+  fs9.writeFileSync(filePath, appended);
   return { applied: true, reason: `added ${missing.length} gitignore entries` };
 }
 function addImport(source, importLine) {
@@ -1044,75 +1109,14 @@ function detectIndent(source, atOffset) {
 }
 
 // src/lib/scaffold-detect.ts
-import fs9 from "node:fs";
-import path8 from "node:path";
-var VANILLA_MARKER = "Welcome to SvelteKit";
-var PAGE_REL = path8.join("src", "routes", "+page.svelte");
-function isVanillaRoutes(cwd) {
-  const pagePath = path8.join(cwd, PAGE_REL);
-  if (!fs9.existsSync(pagePath)) return false;
-  return fs9.readFileSync(pagePath, "utf8").includes(VANILLA_MARKER);
-}
-
-// src/lib/workspace.ts
 import fs10 from "node:fs";
 import path9 from "node:path";
-import process5 from "node:process";
-async function getWorkspace() {
-  let currentDir = process5.cwd();
-  let workspaceRootDir = "";
-  while (currentDir !== path9.parse(currentDir).root) {
-    if (fs10.existsSync(path9.join(currentDir, "package.json"))) {
-      workspaceRootDir = currentDir;
-      break;
-    }
-    currentDir = path9.dirname(currentDir);
-  }
-  if (!workspaceRootDir) {
-    throw new Error("Could not find workspace root (no package.json found)");
-  }
-  const routesDir = path9.join("src", "routes");
-  const fullRoutesPath = path9.join(workspaceRootDir, routesDir);
-  if (!fs10.existsSync(fullRoutesPath)) {
-    throw new Error("Could not find src/routes directory");
-  }
-  let publicRoutesDir = path9.join(routesDir, PUBLIC_DIR);
-  if (!fs10.existsSync(path9.join(workspaceRootDir, publicRoutesDir))) {
-    publicRoutesDir = routesDir;
-  }
-  let appRoutesDir;
-  const appRoutesPath = path9.join(fullRoutesPath, APP_DIR);
-  const isAppMode = fs10.existsSync(appRoutesPath);
-  if (isAppMode) appRoutesDir = path9.join(routesDir, APP_DIR);
-  const isPaymentsMode = fs10.existsSync(
-    path9.join(workspaceRootDir, routesDir, "webhooks", "stripe")
-  );
-  const features = detectFeatures(workspaceRootDir, { isAppMode, isPaymentsMode });
-  return {
-    workspaceRootDir,
-    routesDir,
-    publicRoutesDir,
-    appRoutesDir,
-    isAppMode,
-    isPaymentsMode,
-    features
-  };
-}
-function detectFeatures(root, { isAppMode, isPaymentsMode }) {
-  const has = (rel) => fs10.existsSync(path9.join(root, rel));
-  const pkg = readPackageJson(path9.join(root, "package.json"));
-  const hasDep = (name) => Boolean(pkg.dependencies?.[name] || pkg.devDependencies?.[name]);
-  return {
-    auth: isAppMode,
-    api: has("src/routes/api"),
-    apiKeys: has("src/routes/api/api-keys") || has("src/routes/(app)/api-keys"),
-    backend: has(DATA_DIR),
-    i18n: has("src/lib/i18n") || has("messages"),
-    teams: has("src/routes/(app)/teams") || has("src/lib/teams"),
-    payments: isPaymentsMode,
-    blog: hasDep("mdsvex"),
-    contentNegotiation: hasDep("sveltekit-negotiate")
-  };
+var VANILLA_MARKER = "Welcome to SvelteKit";
+var PAGE_REL = path9.join("src", "routes", "+page.svelte");
+function isVanillaRoutes(cwd) {
+  const pagePath = path9.join(cwd, PAGE_REL);
+  if (!fs10.existsSync(pagePath)) return false;
+  return fs10.readFileSync(pagePath, "utf8").includes(VANILLA_MARKER);
 }
 
 // src/lib/result-report.ts
@@ -1692,6 +1696,17 @@ async function runPattern(slug, argv, input, report) {
       root: workspaceRootDir,
       features,
       input,
+      // Patterns no longer read the schema themselves: @velastack/pocketbase-codegen
+      // takes an injected client, and only the CLI knows how to reach (or spawn)
+      // a PocketBase for this workspace.
+      getCollections: async () => {
+        const { getCollections } = await import("@velastack/pocketbase-codegen");
+        let collections2 = [];
+        await withPocketbase(workspaceRootDir, async (pb) => {
+          collections2 = await getCollections(pb);
+        });
+        return collections2;
+      },
       logger: { info: (message) => log18.message(message) }
     });
     log18.success(report.task.success);
@@ -4892,7 +4907,7 @@ import * as p22 from "@clack/prompts";
 import { annotate } from "annotate-json-schema";
 import { createGenerator } from "json-schema-faker";
 import { faker } from "@faker-js/faker";
-import { collectionToJsonSchema } from "@velastack/pocketbase/internal";
+import { collectionToJsonSchema } from "@velastack/pocketbase-codegen";
 var SKIP_TYPES = /* @__PURE__ */ new Set(["autodate", "file", "relation"]);
 var AUTH_OVERRIDE_FIELDS = ["email", "password", "passwordConfirm", "tokenKey"];
 function padZeros(num, length) {
@@ -5594,17 +5609,25 @@ import fs27 from "node:fs";
 import path29 from "node:path";
 import process17 from "node:process";
 import { performance } from "node:perf_hooks";
-import { Command as Command65 } from "commander";
+import { Command as Command65, InvalidArgumentError as InvalidArgumentError5 } from "commander";
 import pc5 from "picocolors";
 import PocketBase2 from "pocketbase";
-var dev = new Command65("dev").description("start the development server").configureHelp(helpConfig).action(async () => {
+function parsePort(value) {
+  const port = Number(value);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    throw new InvalidArgumentError5("must be a whole number between 1 and 65535.");
+  }
+  return port;
+}
+var dev = new Command65("dev").description("start the development server").option("--open", "open the app in a browser once the server is ready").option("--host [host]", "expose the server on the network").option("--port <port>", "port to listen on", parsePort).configureHelp(helpConfig).action(async (options) => {
   const cwd = process17.cwd();
   const startTime = performance.now();
   const { createServer, version } = await import("vite");
   const viteMetadataDir = path29.join(cwd, "node_modules", ".vite");
   const viteMetadataFile = path29.join(viteMetadataDir, "_pocketbase_metadata.json");
   let pbProc;
-  const needsStart = !process17.env.POCKETBASE_URL;
+  const backend3 = hasBackend(cwd);
+  const needsStart = backend3 && !process17.env.POCKETBASE_URL;
   const cleanup = () => {
     if (pbProc?.pid) pbProc.kill();
     if (fs27.existsSync(viteMetadataFile)) fs27.rmSync(viteMetadataFile);
@@ -5630,8 +5653,13 @@ var dev = new Command65("dev").description("start the development server").confi
       process17.exit(0);
     });
   }
-  const server = await createServer();
+  const serverOptions = {};
+  if (options.open !== void 0) serverOptions.open = options.open;
+  if (options.host !== void 0) serverOptions.host = options.host;
+  if (options.port !== void 0) serverOptions.port = options.port;
+  const server = await createServer({ server: serverOptions });
   server.httpServer?.on("listening", async () => {
+    if (!backend3) return;
     const { address, port: vitePort } = server.httpServer.address();
     const viteHost = address === "::1" ? "localhost" : address;
     await fs27.promises.mkdir(viteMetadataDir, { recursive: true });
@@ -5649,7 +5677,7 @@ var dev = new Command65("dev").description("start the development server").confi
       process17.env.POCKETBASE_SUPERUSER_PASSWORD
     );
     await pb.settings.update({ meta: { appURL: `http://${viteHost}:${vitePort}` } });
-    await startWatchingTypes(cwd);
+    await startWatchingTypes(cwd, pb);
   });
   await server.listen();
   const hasExistingLogs = process17.stdout.bytesWritten > 0 || process17.stderr.bytesWritten > 0;
@@ -5665,25 +5693,25 @@ var dev = new Command65("dev").description("start the development server").confi
   server.printUrls();
   server.bindCLIShortcuts({ print: true });
 });
-async function startWatchingTypes(cwd) {
-  const { processTypes } = await import("@velastack/pocketbase/internal");
-  const config = {
-    pocketbaseUrl: process17.env.POCKETBASE_URL,
-    superuserEmail: process17.env.POCKETBASE_SUPERUSER_EMAIL,
-    superuserPassword: process17.env.POCKETBASE_SUPERUSER_PASSWORD
-  };
+async function startWatchingTypes(cwd, pb) {
+  const { processTypes } = await import("@velastack/pocketbase-codegen");
   const typesDir = path29.resolve(cwd, ".svelte-kit", "types");
   const pocketbaseDir = path29.join(typesDir, "pocketbase");
   const pocketbaseTypes = path29.join(pocketbaseDir, "$types.d.ts");
-  await processTypes(config, typesDir);
-  const watcher = fs27.promises.watch(pocketbaseDir);
-  (async () => {
-    for await (const event of watcher) {
-      if (event.eventType === "rename" && event.filename === "$types.d.ts" && !fs27.existsSync(pocketbaseTypes)) {
-        setTimeout(() => {
-          processTypes(config, typesDir).catch(() => {
-          });
-        }, 100);
+  const regenerate = () => processTypes(pb, typesDir).catch(() => {
+  });
+  await regenerate();
+  void (async () => {
+    for (; ; ) {
+      try {
+        await fs27.promises.mkdir(pocketbaseDir, { recursive: true });
+        for await (const event of fs27.promises.watch(pocketbaseDir)) {
+          if (event.eventType === "rename" && event.filename === "$types.d.ts" && !fs27.existsSync(pocketbaseTypes)) {
+            setTimeout(regenerate, 100);
+          }
+        }
+      } catch {
+        await new Promise((r) => setTimeout(r, 200));
       }
     }
   })();
@@ -5700,7 +5728,7 @@ var build = new Command66("build").description("build the app").configureHelp(he
   process18.env.VITE_BUILD = "true";
   const cwd = process18.cwd();
   let pbProc;
-  const needsStart = !process18.env.POCKETBASE_URL;
+  const needsStart = hasBackend(cwd) && !process18.env.POCKETBASE_URL;
   const cleanup = () => {
     if (pbProc?.pid) pbProc.kill();
   };
@@ -5744,7 +5772,7 @@ import { resolveCommand as resolveCommand6 } from "package-manager-detector/comm
 var preview = new Command67("preview").description("preview the built app").configureHelp(helpConfig).action(async () => {
   const cwd = process19.cwd();
   let pbProc;
-  const needsStart = !process19.env.POCKETBASE_URL;
+  const needsStart = hasBackend(cwd) && !process19.env.POCKETBASE_URL;
   const cleanup = () => {
     if (pbProc?.pid) pbProc.kill();
   };
@@ -5785,15 +5813,10 @@ var sync = new Command68("sync").description("sync types from the database").con
   () => runCommand(async () => {
     const { workspaceRootDir } = await getWorkspace();
     const typesDir = path32.join(workspaceRootDir, ".svelte-kit", "types");
-    const { processTypes } = await import("@velastack/pocketbase/internal");
-    await processTypes(
-      {
-        pocketbaseUrl: process.env.POCKETBASE_URL ?? "",
-        superuserEmail: process.env.POCKETBASE_SUPERUSER_EMAIL,
-        superuserPassword: process.env.POCKETBASE_SUPERUSER_PASSWORD
-      },
-      typesDir
-    );
+    const { processTypes } = await import("@velastack/pocketbase-codegen");
+    await withPocketbase(workspaceRootDir, async (pb) => {
+      await processTypes(pb, typesDir);
+    });
     console.log("types synced");
   }, "Failed to sync types.")
 );
@@ -6171,6 +6194,7 @@ var NO_BACKEND_COMMMANDS = /* @__PURE__ */ new Set([
   "generate schema",
   "generate form"
 ]);
+var BACKEND_OPTIONAL_COMMANDS = /* @__PURE__ */ new Set(["dev", "build", "preview", "deploy"]);
 var program = new Command73().name(package_default.name).description(package_default.description).version(package_default.version, "-v, --version").configureHelp(helpConfig);
 program.hook("preAction", (_thisCommand, actionCommand) => {
   if (isStub(actionCommand)) return;
@@ -6179,6 +6203,19 @@ program.hook("preAction", (_thisCommand, actionCommand) => {
   if (NO_BACKEND_COMMMANDS.has(path36)) return;
   const top = path36.split(" ", 1)[0];
   if (NO_BACKEND_COMMMANDS.has(top)) return;
+  if (!hasBackend()) {
+    if (BACKEND_OPTIONAL_COMMANDS.has(top)) return;
+    p29.log.error(
+      `${pc7.cyan(`vela ${path36}`)} needs a backend, and this project does not have one.
+
+Static projects have no database to talk to.
+
+To add a backend to this project, run ${pc7.cyan("vela bless")}.`
+    );
+    p29.log.message();
+    p29.cancel("Operation failed.");
+    process23.exit(1);
+  }
   if (!process23.env.POCKETBASE_SUPERUSER_EMAIL || !process23.env.POCKETBASE_SUPERUSER_PASSWORD) {
     p29.log.error(
       `PocketBase superuser credentials are required.