vela 0.22.0 → 0.23.0

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/bin.ts
-import process55 from "node:process";
+import process56 from "node:process";
 
 // src/lib/argv.ts
 function normalizeArgv(argv) {
@@ -11,7 +11,7 @@ function normalizeArgv(argv) {
 }
 
 // src/program.ts
-import process54 from "node:process";
+import process55 from "node:process";
 import * as p75 from "@clack/prompts";
 import { Command as Command122 } from "commander";
 import nodePath from "node:path";
@@ -20,7 +20,7 @@ import dotenv2 from "dotenv";
 // package.json
 var package_default = {
   name: "vela",
-  version: "0.22.0",
+  version: "0.23.0",
   type: "module",
   description: "A CLI for creating and updating SvelteKit projects",
   license: "MIT",
@@ -36,12 +36,19 @@ var package_default = {
     vela: "./dist/bin.js",
     velastack: "./dist/bin.js"
   },
+  exports: {
+    "./testing": {
+      types: "./dist/testing.d.ts",
+      default: "./dist/testing.js"
+    },
+    "./package.json": "./package.json"
+  },
   files: [
     "dist",
     "templates"
   ],
   scripts: {
-    build: "node --experimental-strip-types scripts/build.ts",
+    build: "node --experimental-strip-types scripts/build.ts && tsc -p tsconfig.testing.json",
     dev: "node --experimental-strip-types scripts/build.ts --watch",
     clean: "rm -rf dist",
     lint: "npm run lint:ts && npm run lint:format && npm run lint:sh",
@@ -57,7 +64,7 @@ var package_default = {
   dependencies: {
     "@clack/prompts": "^1.7.0",
     "@faker-js/faker": "^10.6.0",
-    "@velastack/patterns": "^0.10.1",
+    "@velastack/patterns": "^0.11.0",
     "@velastack/pocketbase-codegen": "^0.1.0",
     "@velastack/schema": "^0.3.0",
     "@velastack/schema-ui": "^0.3.1",
@@ -301,8 +308,8 @@ function dropTemplateAdapters(user, template) {
   }
   return copy;
 }
-function readPackageJson(path68) {
-  return JSON.parse(fs2.readFileSync(path68, "utf8"));
+function readPackageJson(path69) {
+  return JSON.parse(fs2.readFileSync(path69, "utf8"));
 }
 var PACKAGE_NAME_PLACEHOLDER = /~TODO~/g;
 var APP_NAME_PLACEHOLDER = /~APP_NAME~/g;
@@ -331,12 +338,12 @@ function jsString(value) {
   const quote2 = count("'") > count('"') ? '"' : "'";
   return `${quote2}${escapeFor(quote2, value)}${quote2}`;
 }
-function readTemplatePackageJson(path68, values) {
-  const raw = fillTemplatePlaceholders(fs2.readFileSync(path68, "utf8"), values);
+function readTemplatePackageJson(path69, values) {
+  const raw = fillTemplatePlaceholders(fs2.readFileSync(path69, "utf8"), values);
   return JSON.parse(raw);
 }
-function writePackageJson(path68, pkg) {
-  fs2.writeFileSync(path68, JSON.stringify(pkg, null, "	") + "\n");
+function writePackageJson(path69, pkg) {
+  fs2.writeFileSync(path69, JSON.stringify(pkg, null, "	") + "\n");
 }
 function toValidPackageName(name) {
   return name.trim().toLowerCase().replace(/\s+/g, "-").replace(/^[._]/, "").replace(/[^a-z0-9~.-]+/g, "-");
@@ -505,16 +512,16 @@ function compareVersions(a, b) {
     return b.prerelease.length - a.prerelease.length;
   }
   for (let i = 0; i < Math.max(a.prerelease.length, b.prerelease.length); i++) {
-    const x8 = a.prerelease[i];
+    const x9 = a.prerelease[i];
     const y = b.prerelease[i];
-    if (x8 === void 0) return -1;
+    if (x9 === void 0) return -1;
     if (y === void 0) return 1;
-    if (x8 === y) continue;
-    const xn = /^\d+$/.test(x8);
+    if (x9 === y) continue;
+    const xn = /^\d+$/.test(x9);
     const yn = /^\d+$/.test(y);
-    if (xn && yn) return Number(x8) - Number(y);
+    if (xn && yn) return Number(x9) - Number(y);
     if (xn !== yn) return xn ? -1 : 1;
-    return x8 < y ? -1 : 1;
+    return x9 < y ? -1 : 1;
   }
   return 0;
 }
@@ -2799,7 +2806,7 @@ var VELA_ONLY_FILES = [
   { path: ".ignore", adds: "search ignores for generated files" },
   {
     path: "vitest.config.ts",
-    adds: "the server test project `vela test:server` runs \u2014 without it test/setup.ts never loads"
+    adds: "the server test project, with the `vela/testing` global setup that starts its servers \u2014 without it test/setup.ts never loads"
   }
 ];
 var VELA_ONLY_DIRS = ["src/lib/components", "src/lib/workflows", "data", "test", "static"];
@@ -3900,8 +3907,8 @@ function cancelled() {
   p9.cancel("Operation cancelled.");
   process14.exit(0);
 }
-async function postForm(fetchCookie, path68, fields) {
-  const res = await fetchCookie(`${API_URL}${path68}`, {
+async function postForm(fetchCookie, path69, fields) {
+  const res = await fetchCookie(`${API_URL}${path69}`, {
     method: "POST",
     headers: {
       "Content-Type": "application/x-www-form-urlencoded",
@@ -7682,8 +7689,13 @@ var apiKeys = new Command16("api-keys").description("enable API key management")
 );
 
 // src/commands/enable/backend.ts
+import fs34 from "node:fs";
+import path34 from "node:path";
 import process18 from "node:process";
 import * as v6 from "valibot";
+import { x as x3 } from "tinyexec";
+import { detect as detect6 } from "package-manager-detector";
+import { resolveCommand as resolveCommand4 } from "package-manager-detector/commands";
 import { Command as Command17 } from "commander";
 import * as p21 from "@clack/prompts";
 import pc7 from "picocolors";
@@ -7711,7 +7723,10 @@ var backend = new Command17("backend").description("enable the PocketBase backen
       },
       // The pattern installs `pocketbase-server` before this runs, and
       // scaffolds the `data/` directory the database lives in.
-      () => initPocketbase(workspaceRootDir, credentials)
+      async () => {
+        await ensureVelaDependency(workspaceRootDir);
+        await initPocketbase(workspaceRootDir, credentials);
+      }
     );
   }, "Failed to enable backend.")
 );
@@ -7731,6 +7746,22 @@ function backendNextSteps(ui2) {
     "`vela enable auth` needs shadcn-svelte: `npx sv add tailwindcss`, then `npx shadcn-svelte@latest init`."
   ];
 }
+async function ensureVelaDependency(root) {
+  const file = path34.join(root, "package.json");
+  if (!fs34.existsSync(file)) return;
+  const manifest = JSON.parse(fs34.readFileSync(file, "utf8"));
+  if (manifest.dependencies?.vela || manifest.devDependencies?.vela) return;
+  p21.log.step("Adding vela to devDependencies...");
+  const pm = (await detect6({ cwd: root }))?.name ?? "npm";
+  const resolved = resolveCommand4(pm, "add", [`vela@^${package_default.version}`, "-D"]);
+  const result = await x3(resolved.command, resolved.args, {
+    nodeOptions: { cwd: root, stdio: "pipe" }
+  });
+  if (result.exitCode !== 0) {
+    throw new Error(`Failed to add vela to devDependencies:
+${result.stderr || result.stdout}`);
+  }
+}
 async function initPocketbase(root, { email: email2, password: password8 }) {
   p21.log.step("Initializing PocketBase...");
   await upsertSuperuser(root, email2, password8);
@@ -7814,22 +7845,22 @@ var teams = new Command19("teams").description("enable team / multi-tenant suppo
 );
 
 // src/commands/enable/payments.ts
-import fs35 from "node:fs";
-import path35 from "node:path";
+import fs36 from "node:fs";
+import path36 from "node:path";
 import process19 from "node:process";
 import { Command as Command20 } from "commander";
 import * as p22 from "@clack/prompts";
 
 // src/lib/order-form.ts
-import fs34 from "node:fs";
-import path34 from "node:path";
+import fs35 from "node:fs";
+import path35 from "node:path";
 var ORDER_FORM_KEY = "order";
 var ORDER_FORM_NAME = "Orders";
 var HOSTED_CMS = /^(https?:\/\/[^/]+)\/v1\/projects\/([^/?#]+)\/cms\/?$/;
 function hostedCmsProject(root) {
   let source;
   try {
-    source = fs34.readFileSync(path34.join(root, "src", "lib", "cms.ts"), "utf8");
+    source = fs35.readFileSync(path35.join(root, "src", "lib", "cms.ts"), "utf8");
   } catch {
     return null;
   }
@@ -7948,9 +7979,9 @@ function isCountry(code2) {
 }
 function declaredBusiness() {
   const root = findWorkspaceRoot();
-  const site = root ? path35.join(root, "src", "lib", "site.ts") : null;
-  if (!site || !fs35.existsSync(site)) return {};
-  const source = fs35.readFileSync(site, "utf8");
+  const site = root ? path36.join(root, "src", "lib", "site.ts") : null;
+  if (!site || !fs36.existsSync(site)) return {};
+  const source = fs36.readFileSync(site, "utf8");
   return {
     currency: /^\s*currency\s*:\s*['"]([A-Za-z]{3})['"]/m.exec(source)?.[1],
     country: /^\s*country\s*:\s*['"]([A-Za-z]{2})['"]/m.exec(source)?.[1],
@@ -8912,25 +8943,25 @@ import * as p26 from "@clack/prompts";
 import pc9 from "picocolors";
 
 // src/lib/deploy-config.ts
-import fs36 from "node:fs";
-import path36 from "node:path";
+import fs37 from "node:fs";
+import path37 from "node:path";
 import crypto2 from "node:crypto";
 function projectFilePath(workspaceRootDir) {
-  return path36.join(workspaceRootDir, ".vela", "project.json");
+  return path37.join(workspaceRootDir, ".vela", "project.json");
 }
 function readProjectFile(workspaceRootDir) {
   const file = projectFilePath(workspaceRootDir);
-  if (!fs36.existsSync(file)) return {};
+  if (!fs37.existsSync(file)) return {};
   try {
-    return JSON.parse(fs36.readFileSync(file, "utf8"));
+    return JSON.parse(fs37.readFileSync(file, "utf8"));
   } catch {
     return {};
   }
 }
 function writeProjectFile(workspaceRootDir, data) {
   const file = projectFilePath(workspaceRootDir);
-  fs36.mkdirSync(path36.dirname(file), { recursive: true });
-  fs36.writeFileSync(file, JSON.stringify(data, null, 2) + "\n");
+  fs37.mkdirSync(path37.dirname(file), { recursive: true });
+  fs37.writeFileSync(file, JSON.stringify(data, null, 2) + "\n");
 }
 function resolveAppIdentity(workspaceRootDir, projectName) {
   const project = readProjectFile(workspaceRootDir);
@@ -8955,11 +8986,11 @@ function readAppIdentity(workspaceRootDir, projectName) {
 }
 function defaultProjectName(workspaceRootDir) {
   try {
-    const pkg = readPackageJson(path36.join(workspaceRootDir, "package.json"));
+    const pkg = readPackageJson(path37.join(workspaceRootDir, "package.json"));
     if (typeof pkg.name === "string" && pkg.name.trim()) return pkg.name.trim();
   } catch {
   }
-  return path36.basename(workspaceRootDir);
+  return path37.basename(workspaceRootDir);
 }
 function slug(value) {
   return value.toLowerCase().replace(/^@/, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 32) || "app";
@@ -9030,15 +9061,15 @@ function randomSuffix() {
 }
 
 // src/lib/artifact.ts
-import fs38 from "node:fs";
-import path38 from "node:path";
-import { detect as detect6 } from "package-manager-detector";
-import { resolveCommand as resolveCommand4 } from "package-manager-detector/commands";
+import fs39 from "node:fs";
+import path39 from "node:path";
+import { detect as detect7 } from "package-manager-detector";
+import { resolveCommand as resolveCommand5 } from "package-manager-detector/commands";
 
 // src/lib/ssh.ts
-import fs37 from "node:fs";
+import fs38 from "node:fs";
 import os5 from "node:os";
-import path37 from "node:path";
+import path38 from "node:path";
 import crypto4 from "node:crypto";
 import process24 from "node:process";
 import { spawn as spawn4 } from "node:child_process";
@@ -9081,9 +9112,9 @@ var SshSession = class {
   }
   async open() {
     if (this.controlPath) return;
-    const dir = path37.join(os5.tmpdir(), "vela-ssh");
-    fs37.mkdirSync(dir, { recursive: true, mode: 448 });
-    const socket = path37.join(dir, `${crypto4.randomBytes(6).toString("hex")}.sock`);
+    const dir = path38.join(os5.tmpdir(), "vela-ssh");
+    fs38.mkdirSync(dir, { recursive: true, mode: 448 });
+    const socket = path38.join(dir, `${crypto4.randomBytes(6).toString("hex")}.sock`);
     this.controlPath = socket;
     const args = [
       ...this.sshArgs(),
@@ -9354,8 +9385,8 @@ async function runBuild(cwd, buildCommand, env2) {
       throw new BuildError(`\`${buildCommand}\` exited ${result2.exitCode}.`);
     return;
   }
-  const pm = (await detect6({ cwd }))?.name ?? "npm";
-  const resolved = resolveCommand4(pm, "run", ["build"]);
+  const pm = (await detect7({ cwd }))?.name ?? "npm";
+  const resolved = resolveCommand5(pm, "run", ["build"]);
   if (!resolved) throw new BuildError(`Could not work out how to run a build with ${pm}.`);
   const result = await spawnCapture(resolved.command, resolved.args, {
     cwd,
@@ -9373,11 +9404,11 @@ function collectArtifact(cwd) {
   const outputDir = DEFAULT_OUTPUT_DIR;
   const entries = [];
   const add2 = (rel, remoteDir = "") => {
-    const localPath = path38.join(cwd, rel);
-    if (fs38.existsSync(localPath)) entries.push({ localPath, remoteDir });
+    const localPath = path39.join(cwd, rel);
+    if (fs39.existsSync(localPath)) entries.push({ localPath, remoteDir });
   };
-  const buildPath = path38.join(cwd, outputDir);
-  if (!fs38.existsSync(path38.join(buildPath, "index.js"))) {
+  const buildPath = path39.join(cwd, outputDir);
+  if (!fs39.existsSync(path39.join(buildPath, "index.js"))) {
     throw new BuildError(
       `No ${outputDir}/index.js to deploy.
 
@@ -9390,18 +9421,18 @@ build ran with it as the adapter, then deploy again.`
   for (const lockfile of [NPM_LOCKFILE, ...FOREIGN_LOCKFILES]) add2(lockfile);
   add2(".npmrc");
   add2(MIGRATIONS_DIR);
-  const hooks = path38.join(cwd, DATA_DIR, "hooks");
-  if (fs38.existsSync(hooks)) entries.push({ localPath: hooks, remoteDir: "hooks" });
+  const hooks = path39.join(cwd, DATA_DIR, "hooks");
+  if (fs39.existsSync(hooks)) entries.push({ localPath: hooks, remoteDir: "hooks" });
   return entries;
 }
 var NPM_LOCKFILE = "package-lock.json";
 var FOREIGN_LOCKFILES = ["pnpm-lock.yaml", "yarn.lock", "bun.lock", "bun.lockb"];
 function hasLockfile(cwd) {
-  return fs38.existsSync(path38.join(cwd, NPM_LOCKFILE));
+  return fs39.existsSync(path39.join(cwd, NPM_LOCKFILE));
 }
 function foreignLockfile(cwd) {
   if (hasLockfile(cwd)) return void 0;
-  return FOREIGN_LOCKFILES.find((name) => fs38.existsSync(path38.join(cwd, name)));
+  return FOREIGN_LOCKFILES.find((name) => fs39.existsSync(path39.join(cwd, name)));
 }
 async function gitSha(cwd) {
   const result = await spawnCapture("git", ["rev-parse", "HEAD"], { cwd });
@@ -9440,8 +9471,8 @@ function sshOptionsFrom(options) {
 
 // src/lib/remote.ts
 import crypto5 from "node:crypto";
-import fs39 from "node:fs";
-import path39 from "node:path";
+import fs40 from "node:fs";
+import path40 from "node:path";
 import process25 from "node:process";
 var VELA_ROOT = "/var/lib/vela";
 var VELA_ETC = "/etc/vela";
@@ -9454,19 +9485,19 @@ function instanceHasBackend(state) {
   return state.backend ?? Boolean(state.pbPort);
 }
 function serverTemplatesDir() {
-  return path39.join(templatesDir(), "server");
+  return path40.join(templatesDir(), "server");
 }
 var DIGEST_LENGTH = 12;
 function serverScriptsDigest(dir = serverTemplatesDir()) {
   const hash = crypto5.createHash("sha256");
   for (const file of listFiles(dir).sort()) {
-    hash.update(file).update("\0").update(fs39.readFileSync(path39.join(dir, file))).update("\0");
+    hash.update(file).update("\0").update(fs40.readFileSync(path40.join(dir, file))).update("\0");
   }
   return hash.digest("hex").slice(0, DIGEST_LENGTH);
 }
 function listFiles(root, prefix = "") {
   const files = [];
-  for (const entry of fs39.readdirSync(path39.join(root, prefix), { withFileTypes: true })) {
+  for (const entry of fs40.readdirSync(path40.join(root, prefix), { withFileTypes: true })) {
     const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
     if (entry.isDirectory()) files.push(...listFiles(root, rel));
     else if (entry.isFile()) files.push(rel);
@@ -9593,7 +9624,7 @@ var remotePaths = {
 };
 
 // src/lib/remote-env.ts
-import fs40 from "node:fs";
+import fs41 from "node:fs";
 import dotenv from "dotenv";
 var KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
 function isValidKey(key) {
@@ -9641,7 +9672,7 @@ function quote(value) {
   return `"${escaped}"`;
 }
 function readLocalEnvFile(file) {
-  const parsed = dotenv.parse(fs40.readFileSync(file));
+  const parsed = dotenv.parse(fs41.readFileSync(file));
   const result = {};
   for (const [key, value] of Object.entries(parsed)) {
     if (isValidKey(key)) result[key] = value;
@@ -10524,14 +10555,14 @@ var ui = new Command59("ui").description("generate ui components").configureHelp
 import { Command as Command62 } from "commander";
 
 // src/commands/legal/terms.ts
-import path41 from "node:path";
+import path42 from "node:path";
 import { Command as Command60 } from "commander";
 import * as p37 from "@clack/prompts";
 
 // src/commands/legal/shared.ts
 import process29 from "node:process";
-import fs41 from "node:fs";
-import path40 from "node:path";
+import fs42 from "node:fs";
+import path41 from "node:path";
 import * as p36 from "@clack/prompts";
 function siteFields(site) {
   const url = site?.url && !isLocalUrl(site.url) ? site.url : void 0;
@@ -10813,16 +10844,16 @@ function writeLegalPage(root, dir, page) {
 
 ${html}`;
   }
-  const pagePath = path40.join(root, dir, "+page.svelte");
-  fs41.mkdirSync(path40.dirname(pagePath), { recursive: true });
-  fs41.writeFileSync(pagePath, html);
+  const pagePath = path41.join(root, dir, "+page.svelte");
+  fs42.mkdirSync(path41.dirname(pagePath), { recursive: true });
+  fs42.writeFileSync(pagePath, html);
   const written = [pagePath];
   if (metaTags) {
-    const loaderPath = path40.join(root, dir, "+page.ts");
-    fs41.writeFileSync(loaderPath, pageMetaTagsLoader(page.title, page.description));
+    const loaderPath = path41.join(root, dir, "+page.ts");
+    fs42.writeFileSync(loaderPath, pageMetaTagsLoader(page.title, page.description));
     written.push(loaderPath);
   }
-  return written.map((file) => path40.relative(root, file));
+  return written.map((file) => path41.relative(root, file));
 }
 
 // src/commands/legal/terms.ts
@@ -11219,7 +11250,7 @@ async function termsAction() {
   });
   const [relativeTermsPage, ...rest] = writeLegalPage(
     workspaceRootDir,
-    path41.join(publicRoutesDir, LEGAL_DIR, "terms"),
+    path42.join(publicRoutesDir, LEGAL_DIR, "terms"),
     {
       html,
       title: "Terms of Service",
@@ -11239,7 +11270,7 @@ async function termsAction() {
 var terms = new Command60("terms").description("generate placeholder terms and conditions").configureHelp(helpConfig).action(() => runCommand(termsAction, "Failed to generate terms and conditions."));
 
 // src/commands/legal/privacy.ts
-import path42 from "node:path";
+import path43 from "node:path";
 import { Command as Command61 } from "commander";
 import * as p38 from "@clack/prompts";
 var mapLabels = {
@@ -11955,7 +11986,7 @@ async function privacyAction() {
   });
   const [relativePrivacyPage, ...rest] = writeLegalPage(
     workspaceRootDir,
-    path42.join(publicRoutesDir, LEGAL_DIR, "privacy"),
+    path43.join(publicRoutesDir, LEGAL_DIR, "privacy"),
     {
       html,
       title: "Privacy Policy",
@@ -11984,8 +12015,8 @@ import { Command as Command68 } from "commander";
 import { Command as Command63 } from "commander";
 
 // src/lib/data.ts
-import fs42 from "node:fs";
-import path43 from "node:path";
+import fs43 from "node:fs";
+import path44 from "node:path";
 import { ClientResponseError } from "pocketbase";
 
 // src/lib/collections.ts
@@ -12022,14 +12053,14 @@ function dependencyOrder(collections2, startingCollectionId) {
 
 // src/lib/data.ts
 function dataDir(cwd, kind) {
-  return path43.join(cwd, DATA_DIR, kind);
+  return path44.join(cwd, DATA_DIR, kind);
 }
 function getDataFiles(cwd, kind) {
   const dir = dataDir(cwd, kind);
-  if (!fs42.existsSync(dir)) return [];
-  return fs42.readdirSync(dir).filter((file) => file.endsWith(".json")).sort((a, b) => a.localeCompare(b)).map((file) => ({
+  if (!fs43.existsSync(dir)) return [];
+  return fs43.readdirSync(dir).filter((file) => file.endsWith(".json")).sort((a, b) => a.localeCompare(b)).map((file) => ({
     collectionName: file.replace(/\.json$/i, "").replace(/^\d+[-_]?/, ""),
-    filePath: path43.join(dir, file)
+    filePath: path44.join(dir, file)
   }));
 }
 function getSeedFiles(cwd) {
@@ -12039,7 +12070,7 @@ function getFixtureFiles(cwd) {
   return getDataFiles(cwd, "fixtures");
 }
 function readRecords(filePath) {
-  return JSON.parse(fs42.readFileSync(filePath, "utf8"));
+  return JSON.parse(fs43.readFileSync(filePath, "utf8"));
 }
 function readSeedIds(cwd) {
   const ids = /* @__PURE__ */ new Map();
@@ -12076,7 +12107,7 @@ function describeError(e) {
   return e instanceof Error ? e.message : String(e);
 }
 function label(cwd, filePath, count) {
-  return `${path43.relative(cwd, filePath)} (${count} records)`;
+  return `${path44.relative(cwd, filePath)} (${count} records)`;
 }
 async function createRecords(pb, kind, cwd, { collectionName, filePath }) {
   const records = readRecords(filePath);
@@ -12084,7 +12115,7 @@ async function createRecords(pb, kind, cwd, { collectionName, filePath }) {
     try {
       await pb.collection(collectionName).create(record);
     } catch (e) {
-      throw new DataLoadError(kind, path43.relative(cwd, filePath), index, e);
+      throw new DataLoadError(kind, path44.relative(cwd, filePath), index, e);
     }
   }
   return records.length;
@@ -12258,8 +12289,8 @@ var reset = new Command65("reset").description("clear and reload fixtures").conf
 );
 
 // src/commands/fixtures/generate.ts
-import fs43 from "node:fs";
-import path44 from "node:path";
+import fs44 from "node:fs";
+import path45 from "node:path";
 import { Command as Command66, InvalidArgumentError } from "commander";
 import * as p39 from "@clack/prompts";
 import { annotate } from "annotate-json-schema";
@@ -12296,9 +12327,9 @@ async function loadCollections(pb) {
 }
 async function generateFixtureFiles(pb, workspaceRootDir, opts) {
   const fixturesDir = dataDir(workspaceRootDir, "fixtures");
-  fs43.mkdirSync(fixturesDir, { recursive: true });
-  for (const file of fs43.readdirSync(fixturesDir)) {
-    if (file.endsWith(".json")) fs43.unlinkSync(path44.join(fixturesDir, file));
+  fs44.mkdirSync(fixturesDir, { recursive: true });
+  for (const file of fs44.readdirSync(fixturesDir)) {
+    if (file.endsWith(".json")) fs44.unlinkSync(path45.join(fixturesDir, file));
   }
   if (opts.seed !== void 0) faker.seed(opts.seed);
   const generator = createGenerator({
@@ -12365,8 +12396,8 @@ async function generateFixtureFiles(pb, workspaceRootDir, opts) {
       items.push(record);
     }
     const filename = `${padZeros(fileIndex, 2)}-${collection.name}.json`;
-    fs43.writeFileSync(path44.join(fixturesDir, filename), JSON.stringify(items, null, 2));
-    writtenFiles.push(`${path44.join(DATA_DIR, "fixtures", filename)} (${items.length} records)`);
+    fs44.writeFileSync(path45.join(fixturesDir, filename), JSON.stringify(items, null, 2));
+    writtenFiles.push(`${path45.join(DATA_DIR, "fixtures", filename)} (${items.length} records)`);
     fileIndex++;
   }
   return { writtenFiles, warnings };
@@ -12513,8 +12544,8 @@ var load2 = new Command69("load").description("load seeds into the database").op
 );
 
 // src/commands/seeds/save.ts
-import fs44 from "node:fs";
-import path45 from "node:path";
+import fs45 from "node:fs";
+import path46 from "node:path";
 import { Command as Command70 } from "commander";
 var padZeros2 = (num, length) => num.toString().padStart(length, "0");
 function filterSystemFields(record, systemFieldNames) {
@@ -12534,10 +12565,10 @@ var save = new Command70("save").description("save the current data as seeds").o
     if (existing.length > 0 && !opts.force) {
       throw new Error("Existing seed files found in data/seeds. Pass --force to overwrite.");
     }
-    fs44.mkdirSync(seedsPath, { recursive: true });
+    fs45.mkdirSync(seedsPath, { recursive: true });
     if (opts.force) {
-      for (const file of fs44.readdirSync(seedsPath)) {
-        if (file.endsWith(".json")) fs44.unlinkSync(path45.join(seedsPath, file));
+      for (const file of fs45.readdirSync(seedsPath)) {
+        if (file.endsWith(".json")) fs45.unlinkSync(path46.join(seedsPath, file));
       }
     }
     const saved = [];
@@ -12566,13 +12597,13 @@ var save = new Command70("save").description("save the current data as seeds").o
         const filtered = records.map(
           (r) => filterSystemFields(r, systemFieldNames)
         );
-        const relativeSeedPath = path45.join(
+        const relativeSeedPath = path46.join(
           DATA_DIR,
           "seeds",
           `${padZeros2(count, 2)}-${collectionName}.json`
         );
-        const seedPath = path45.join(workspaceRootDir, relativeSeedPath);
-        fs44.writeFileSync(seedPath, JSON.stringify(filtered, null, 2));
+        const seedPath = path46.join(workspaceRootDir, relativeSeedPath);
+        fs45.writeFileSync(seedPath, JSON.stringify(filtered, null, 2));
         saved.push(`${relativeSeedPath} (${filtered.length} records)`);
         count++;
       }
@@ -12719,9 +12750,9 @@ import { Command as Command82 } from "commander";
 import { Command as Command76 } from "commander";
 
 // src/lib/migrate.ts
-import path46 from "node:path";
+import path47 from "node:path";
 import process30 from "node:process";
-import { x as x3 } from "tinyexec";
+import { x as x4 } from "tinyexec";
 function migrateRoot() {
   return findWorkspaceRoot() ?? process30.cwd();
 }
@@ -12729,13 +12760,13 @@ async function runPocketbaseMigrate(args) {
   const cwd = migrateRoot();
   const { getBinaryPath } = await import("pocketbase-server");
   const binaryPath = getBinaryPath();
-  await x3(
+  await x4(
     binaryPath,
     [
       "--dir",
-      path46.join(cwd, DATA_DIR),
+      path47.join(cwd, DATA_DIR),
       "--migrationsDir",
-      path46.join(cwd, MIGRATIONS_DIR),
+      path47.join(cwd, MIGRATIONS_DIR),
       "migrate",
       ...args
     ],
@@ -12783,8 +12814,8 @@ var down = new Command77("down").alias("rollback").description("revert the last
 );
 
 // src/commands/migrate/create.ts
-import fs45 from "node:fs";
-import path47 from "node:path";
+import fs46 from "node:fs";
+import path48 from "node:path";
 import { Command as Command78 } from "commander";
 var create2 = new Command78("create").alias("new").description("create a new blank migration").argument("<name>", "migration name (snake_case)").configureHelp(helpConfig).action(
   (name) => runCommand(async () => {
@@ -12795,7 +12826,7 @@ var create2 = new Command78("create").alias("new").description("create a new bla
     const added = [...after].filter((f) => !before.has(f));
     reportResult({
       summary: `Created blank migration ${name}.`,
-      filesCreated: added.map((f) => path47.join(MIGRATIONS_DIR, f)),
+      filesCreated: added.map((f) => path48.join(MIGRATIONS_DIR, f)),
       nextSteps: [
         `Open the new file in ${MIGRATIONS_DIR}/ and fill in the up/down handlers.`,
         "Run `vela migrate up` to apply the migration once the handlers are written."
@@ -12804,14 +12835,14 @@ var create2 = new Command78("create").alias("new").description("create a new bla
   }, "Failed to create migration.")
 );
 function listMigrationFiles(cwd) {
-  const dir = path47.join(cwd, MIGRATIONS_DIR);
-  if (!fs45.existsSync(dir)) return /* @__PURE__ */ new Set();
-  return new Set(fs45.readdirSync(dir).filter((f) => /\.[jt]s$/.test(f)));
+  const dir = path48.join(cwd, MIGRATIONS_DIR);
+  if (!fs46.existsSync(dir)) return /* @__PURE__ */ new Set();
+  return new Set(fs46.readdirSync(dir).filter((f) => /\.[jt]s$/.test(f)));
 }
 
 // src/commands/migrate/collections.ts
-import fs46 from "node:fs";
-import path48 from "node:path";
+import fs47 from "node:fs";
+import path49 from "node:path";
 import { Command as Command79 } from "commander";
 var collections = new Command79("collections").alias("snapshot").description("snapshot local collections into a new migration").configureHelp(helpConfig).action(
   () => runCommand(async () => {
@@ -12828,7 +12859,7 @@ var collections = new Command79("collections").alias("snapshot").description("sn
     }
     reportResult({
       summary: "Snapshotted local collections into a new migration.",
-      filesCreated: added.map((f) => path48.join(MIGRATIONS_DIR, f)),
+      filesCreated: added.map((f) => path49.join(MIGRATIONS_DIR, f)),
       nextSteps: [
         `Review the generated snapshot in ${MIGRATIONS_DIR}/.`,
         "Commit the snapshot so teammates pick up the new schema.",
@@ -12838,9 +12869,9 @@ var collections = new Command79("collections").alias("snapshot").description("sn
   }, "Failed to snapshot collections.")
 );
 function listMigrationFiles2(cwd) {
-  const dir = path48.join(cwd, MIGRATIONS_DIR);
-  if (!fs46.existsSync(dir)) return /* @__PURE__ */ new Set();
-  return new Set(fs46.readdirSync(dir).filter((f) => /\.[jt]s$/.test(f)));
+  const dir = path49.join(cwd, MIGRATIONS_DIR);
+  if (!fs47.existsSync(dir)) return /* @__PURE__ */ new Set();
+  return new Set(fs47.readdirSync(dir).filter((f) => /\.[jt]s$/.test(f)));
 }
 
 // src/commands/migrate/history-sync.ts
@@ -12856,14 +12887,14 @@ var historySync = new Command80("history-sync").description("drop _migrations ro
 );
 
 // src/commands/migrate/sveltekit-3.ts
-import path49 from "node:path";
+import path50 from "node:path";
 import process31 from "node:process";
 import { Command as Command81 } from "commander";
 import * as p44 from "@clack/prompts";
 import pc13 from "picocolors";
 var sveltekit3 = new Command81("sveltekit-3").description("upgrade a SvelteKit 2 project to SvelteKit 3 (sv migrate, then the vela steps)").option("--cwd <path>", "the project to migrate (default: the current project)").option("--no-install", "skip installing dependencies").option("--force", "run even when the git working tree has uncommitted changes").option("--skip-sv", "only run the vela steps (sv has already been run)").configureHelp(helpConfig).action(
   (options) => runCommand(async () => {
-    const root = options.cwd ? path49.resolve(options.cwd) : findWorkspaceRoot() ?? process31.cwd();
+    const root = options.cwd ? path50.resolve(options.cwd) : findWorkspaceRoot() ?? process31.cwd();
     p44.intro(pc13.bgCyan(pc13.black(" vela migrate sveltekit-3 ")));
     const result = await runKit3Migration(root, {
       install: options.install,
@@ -12880,7 +12911,7 @@ function printReport(root, result) {
     sections.push({ label: "Build output removed first", items: result.sv.cleared });
   }
   for (const fixup2 of changed) sections.push({ label: fixup2.name, items: fixup2.details });
-  const summary = result.mode === "repair" ? changed.length > 0 ? "Already on SvelteKit 3; brought the vela setup up to date." : "Already on SvelteKit 3; nothing left to change." : `Migrated ${path49.basename(root)} to SvelteKit 3.`;
+  const summary = result.mode === "repair" ? changed.length > 0 ? "Already on SvelteKit 3; brought the vela setup up to date." : "Already on SvelteKit 3; nothing left to change." : `Migrated ${path50.basename(root)} to SvelteKit 3.`;
   reportResult({ summary, sections });
   const tasks = result.tasks;
   if (tasks && (tasks.sections.length > 0 || tasks.markerComments > 0)) {
@@ -12938,8 +12969,8 @@ function nextStepsFor(result) {
 var migrate = new Command82("migrate").description("manage database migrations (and `migrate sveltekit-3` to upgrade SvelteKit)").configureHelp(helpConfig).action(() => runCommand(runMigrateUp, "Failed to run migrations.")).addCommand(up).addCommand(down).addCommand(create2).addCommand(collections).addCommand(historySync).addCommand(sveltekit3);
 
 // src/commands/dev.ts
-import fs47 from "node:fs";
-import path51 from "node:path";
+import fs48 from "node:fs";
+import path52 from "node:path";
 import process33 from "node:process";
 import { performance } from "node:perf_hooks";
 import { Command as Command83, InvalidArgumentError as InvalidArgumentError4 } from "commander";
@@ -12971,7 +13002,7 @@ function createPocketbaseLogFilter() {
 }
 
 // src/lib/vite.ts
-import path50 from "node:path";
+import path51 from "node:path";
 import process32 from "node:process";
 import { createRequire as createRequire4 } from "node:module";
 import { pathToFileURL } from "node:url";
@@ -12991,7 +13022,7 @@ function viteVersionError(version) {
 }
 function resolveProjectVite(cwd) {
   try {
-    return createRequire4(path50.join(cwd, "package.json")).resolve("vite");
+    return createRequire4(path51.join(cwd, "package.json")).resolve("vite");
   } catch {
     return null;
   }
@@ -13021,8 +13052,8 @@ var dev = new Command83("dev").description("start the development server").optio
   process33.env.VELA_DATA_DIR ??= localDataDir(cwd);
   const startTime = performance.now();
   const { createServer, resolveConfig, version } = await loadVite(cwd);
-  const viteMetadataDir = path51.join(cwd, "node_modules", ".vite");
-  const viteMetadataFile = path51.join(viteMetadataDir, "_pocketbase_metadata.json");
+  const viteMetadataDir = path52.join(cwd, "node_modules", ".vite");
+  const viteMetadataFile = path52.join(viteMetadataDir, "_pocketbase_metadata.json");
   const serverOptions = {};
   if (options.open !== void 0) serverOptions.open = options.open;
   if (options.host !== void 0) serverOptions.host = options.host;
@@ -13038,7 +13069,7 @@ var dev = new Command83("dev").description("start the development server").optio
   const needsStart = backend3 && !process33.env.POCKETBASE_URL;
   const cleanup = () => {
     if (pbProc?.pid) pbProc.kill();
-    if (fs47.existsSync(viteMetadataFile)) fs47.rmSync(viteMetadataFile);
+    if (fs48.existsSync(viteMetadataFile)) fs48.rmSync(viteMetadataFile);
   };
   if (needsStart) {
     const resolved = await resolveConfig(inlineConfig, "serve");
@@ -13056,11 +13087,11 @@ var dev = new Command83("dev").description("start the development server").optio
         )
       );
     }
-    const dataDir2 = path51.join(cwd, DATA_DIR);
+    const dataDir2 = path52.join(cwd, DATA_DIR);
     const started = await startPocketbaseServe({
       dataDir: dataDir2,
       migrationsDir: MIGRATIONS_DIR,
-      hooksDir: path51.join(dataDir2, "hooks"),
+      hooksDir: path52.join(dataDir2, "hooks"),
       dev: true,
       stdio: "pipe",
       env: {
@@ -13082,8 +13113,8 @@ var dev = new Command83("dev").description("start the development server").optio
     if (!backend3) return;
     const { address, port: vitePort } = server.httpServer.address();
     const viteHost = address === "::1" ? "localhost" : address;
-    await fs47.promises.mkdir(viteMetadataDir, { recursive: true });
-    await fs47.promises.writeFile(
+    await fs48.promises.mkdir(viteMetadataDir, { recursive: true });
+    await fs48.promises.writeFile(
       viteMetadataFile,
       JSON.stringify({
         pocketbaseUrl: process33.env.POCKETBASE_URL,
@@ -13114,18 +13145,18 @@ var dev = new Command83("dev").description("start the development server").optio
 });
 async function startWatchingTypes(cwd, pb) {
   const { processTypes } = await import("@velastack/pocketbase-codegen");
-  const typesDir = path51.resolve(cwd, ".svelte-kit", "types");
-  const pocketbaseDir = path51.join(typesDir, "pocketbase");
-  const pocketbaseTypes = path51.join(pocketbaseDir, "$types.d.ts");
+  const typesDir = path52.resolve(cwd, ".svelte-kit", "types");
+  const pocketbaseDir = path52.join(typesDir, "pocketbase");
+  const pocketbaseTypes = path52.join(pocketbaseDir, "$types.d.ts");
   const regenerate = () => processTypes(pb, typesDir).catch(() => {
   });
   await regenerate();
   void (async () => {
     for (; ; ) {
       try {
-        await fs47.promises.mkdir(pocketbaseDir, { recursive: true });
-        for await (const event of fs47.promises.watch(pocketbaseDir)) {
-          if (event.eventType === "rename" && event.filename === "$types.d.ts" && !fs47.existsSync(pocketbaseTypes)) {
+        await fs48.promises.mkdir(pocketbaseDir, { recursive: true });
+        for await (const event of fs48.promises.watch(pocketbaseDir)) {
+          if (event.eventType === "rename" && event.filename === "$types.d.ts" && !fs48.existsSync(pocketbaseTypes)) {
             setTimeout(regenerate, 100);
           }
         }
@@ -13137,15 +13168,15 @@ async function startWatchingTypes(cwd, pb) {
 }
 
 // src/commands/build.ts
-import fs48 from "node:fs";
-import path52 from "node:path";
+import fs49 from "node:fs";
+import path53 from "node:path";
 import process35 from "node:process";
 import { Command as Command84 } from "commander";
 import * as p45 from "@clack/prompts";
 import pc16 from "picocolors";
-import { x as x4 } from "tinyexec";
-import { detect as detect7 } from "package-manager-detector";
-import { resolveCommand as resolveCommand5 } from "package-manager-detector/commands";
+import { x as x5 } from "tinyexec";
+import { detect as detect8 } from "package-manager-detector";
+import { resolveCommand as resolveCommand6 } from "package-manager-detector/commands";
 
 // src/lib/build-env.ts
 function applyBuildEnv(cwd, env2 = process.env) {
@@ -13180,7 +13211,7 @@ function splitHosts(value) {
 }
 
 // src/commands/build.ts
-var PRERENDERED_DIR = path52.join(".svelte-kit", "output", "prerendered");
+var PRERENDERED_DIR = path53.join(".svelte-kit", "output", "prerendered");
 var build = new Command84("build").description("build the app").configureHelp(helpConfig).option("-t, --target <target>", "which copy of the app to build for", PRODUCTION_TARGET).action(async (options) => {
   const cwd = process35.cwd();
   warnIfKit2(findWorkspaceRoot(cwd) ?? cwd, (m) => p45.log.warn(m));
@@ -13198,22 +13229,22 @@ var build = new Command84("build").description("build the app").configureHelp(he
   onTerminate(cleanup);
   if (needsStart) {
     await ensureSuperuser(cwd);
-    const dataDir2 = path52.join(cwd, DATA_DIR);
+    const dataDir2 = path53.join(cwd, DATA_DIR);
     const started = await startPocketbaseServe({
       dataDir: dataDir2,
       migrationsDir: MIGRATIONS_DIR,
-      hooksDir: path52.join(dataDir2, "hooks"),
+      hooksDir: path53.join(dataDir2, "hooks"),
       dev: true
     });
     pbProc = started.proc;
     process35.env.POCKETBASE_URL = started.url;
   }
   try {
-    const pm = (await detect7({ cwd }))?.name ?? "npm";
-    const resolved = resolveCommand5(pm, "execute", ["vite", "build"]);
+    const pm = (await detect8({ cwd }))?.name ?? "npm";
+    const resolved = resolveCommand6(pm, "execute", ["vite", "build"]);
     const args = resolved.args.slice();
     if (pm === "npm") args.unshift("--yes");
-    const vite = x4(resolved.command, args, {
+    const vite = x5(resolved.command, args, {
       nodeOptions: { cwd, stdio: "inherit" },
       throwOnError: true
     });
@@ -13249,8 +13280,8 @@ async function originForBuild(cwd, target) {
   }
 }
 function warnIfPrerendered(cwd) {
-  const dir = path52.join(cwd, PRERENDERED_DIR);
-  if (!fs48.existsSync(dir) || fs48.readdirSync(dir).length === 0) return;
+  const dir = path53.join(cwd, PRERENDERED_DIR);
+  if (!fs49.existsSync(dir) || fs49.readdirSync(dir).length === 0) return;
   if (process35.env.VELA_ORIGIN === "") {
     p45.log.warn(
       `Prerendered pages were built with no origin, on purpose: this app is served on
@@ -13273,16 +13304,16 @@ Set one with ${pc16.cyan("vela deploy --domain example.com")}, or pass ${pc16.cy
 }
 
 // src/commands/preview.ts
-import fs49 from "node:fs";
-import path53 from "node:path";
+import fs50 from "node:fs";
+import path54 from "node:path";
 import process36 from "node:process";
 import { Command as Command85 } from "commander";
 import * as p46 from "@clack/prompts";
 import pc17 from "picocolors";
-import { x as x5 } from "tinyexec";
-import { detect as detect8 } from "package-manager-detector";
-import { resolveCommand as resolveCommand6 } from "package-manager-detector/commands";
-var ADAPTER_NODE_MODULE = path53.join("build", "adapter-node.js");
+import { x as x6 } from "tinyexec";
+import { detect as detect9 } from "package-manager-detector";
+import { resolveCommand as resolveCommand7 } from "package-manager-detector/commands";
+var ADAPTER_NODE_MODULE = path54.join("build", "adapter-node.js");
 var preview = new Command85("preview").description("preview the built app").configureHelp(helpConfig).action(async () => {
   const cwd = process36.cwd();
   process36.env.VELA_DATA_DIR ??= localDataDir(cwd);
@@ -13297,22 +13328,22 @@ var preview = new Command85("preview").description("preview the built app").conf
   };
   onTerminate(cleanup);
   if (needsStart) {
-    const dataDir2 = path53.join(cwd, DATA_DIR);
+    const dataDir2 = path54.join(cwd, DATA_DIR);
     const started = await startPocketbaseServe({
       dataDir: dataDir2,
       migrationsDir: MIGRATIONS_DIR,
-      hooksDir: path53.join(dataDir2, "hooks"),
+      hooksDir: path54.join(dataDir2, "hooks"),
       dev: true
     });
     pbProc = started.proc;
     process36.env.POCKETBASE_URL = started.url;
   }
   try {
-    const pm = (await detect8({ cwd }))?.name ?? "npm";
-    const resolved = resolveCommand6(pm, "execute", ["vite", "preview"]);
+    const pm = (await detect9({ cwd }))?.name ?? "npm";
+    const resolved = resolveCommand7(pm, "execute", ["vite", "preview"]);
     const args = resolved.args.slice();
     if (pm === "npm") args.unshift("--yes");
-    const vite = x5(resolved.command, args, {
+    const vite = x6(resolved.command, args, {
       nodeOptions: { cwd, stdio: "inherit" },
       throwOnError: true
     });
@@ -13335,7 +13366,7 @@ function bakedOrigin(source) {
 function warnIfOriginBaked(cwd) {
   let source;
   try {
-    source = fs49.readFileSync(path53.join(cwd, ADAPTER_NODE_MODULE), "utf8");
+    source = fs50.readFileSync(path54.join(cwd, ADAPTER_NODE_MODULE), "utf8");
   } catch {
     return;
   }
@@ -13351,12 +13382,12 @@ set empty so no domain is baked in.`
 }
 
 // src/commands/sync.ts
-import path54 from "node:path";
+import path55 from "node:path";
 import { Command as Command86 } from "commander";
 var sync = new Command86("sync").description("sync types from the database").configureHelp(helpConfig).action(
   () => runCommand(async () => {
     const { workspaceRootDir } = await getWorkspace();
-    const typesDir = path54.join(workspaceRootDir, ".svelte-kit", "types");
+    const typesDir = path55.join(workspaceRootDir, ".svelte-kit", "types");
     const { processTypes } = await import("@velastack/pocketbase-codegen");
     await withPocketbase(workspaceRootDir, async (pb) => {
       await processTypes(pb, typesDir);
@@ -13427,8 +13458,8 @@ var provision = addSshOptions(
 );
 
 // src/commands/deploy.ts
-import path58 from "node:path";
-import fs53 from "node:fs";
+import path59 from "node:path";
+import fs54 from "node:fs";
 import process38 from "node:process";
 import { Command as Command88, Option as Option2 } from "commander";
 import * as p49 from "@clack/prompts";
@@ -13546,12 +13577,12 @@ function reachedInstances(states, appId, layer) {
 }
 
 // src/lib/build-stack.ts
-import fs51 from "node:fs";
-import path56 from "node:path";
+import fs52 from "node:fs";
+import path57 from "node:path";
 
 // src/lib/static-env.ts
-import fs50 from "node:fs";
-import path55 from "node:path";
+import fs51 from "node:fs";
+import path56 from "node:path";
 import { ENV_DECL_CANDIDATES } from "@velastack/patterns";
 import { Node as Node5, Project as Project5, QuoteKind as QuoteKind3 } from "ts-morph";
 function staticEnv(root) {
@@ -13565,7 +13596,7 @@ function staticEnv(root) {
     };
   }
   const file = findEnvDecl(root);
-  const rel = file ? path55.relative(root, file).split(path55.sep).join("/") : ENV_DECL_CANDIDATES[0];
+  const rel = file ? path56.relative(root, file).split(path56.sep).join("/") : ENV_DECL_CANDIDATES[0];
   return {
     names: file ? staticEnvDeclarations(file) : /* @__PURE__ */ new Set(),
     rule: "declarations",
@@ -13575,8 +13606,8 @@ function staticEnv(root) {
 }
 function findEnvDecl(root) {
   for (const rel of ENV_DECL_CANDIDATES) {
-    const abs = path55.join(root, rel);
-    if (fs50.existsSync(abs)) return abs;
+    const abs = path56.join(root, rel);
+    if (fs51.existsSync(abs)) return abs;
   }
   return null;
 }
@@ -13648,10 +13679,10 @@ var SOURCE_EXTENSIONS2 = /* @__PURE__ */ new Set([".ts", ".js", ".mts", ".mjs",
 var STATIC_IMPORT = /import\s*(?:type\s*)?\{([^}]*)\}\s*from\s*['"]\$env\/static\/(?:private|public)['"]/g;
 function staticEnvImports(root) {
   const names = /* @__PURE__ */ new Set();
-  const src = path55.join(root, "src");
-  if (!fs50.existsSync(src)) return names;
+  const src = path56.join(root, "src");
+  if (!fs51.existsSync(src)) return names;
   for (const file of sourceFiles2(src)) {
-    const content = fs50.readFileSync(file, "utf8");
+    const content = fs51.readFileSync(file, "utf8");
     if (!content.includes("$env/static/")) continue;
     for (const match of content.matchAll(STATIC_IMPORT)) {
       for (const spec of match[1].split(",")) {
@@ -13663,11 +13694,11 @@ function staticEnvImports(root) {
   return names;
 }
 function* sourceFiles2(dir) {
-  for (const entry of fs50.readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of fs51.readdirSync(dir, { withFileTypes: true })) {
     if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
-    const full = path55.join(dir, entry.name);
+    const full = path56.join(dir, entry.name);
     if (entry.isDirectory()) yield* sourceFiles2(full);
-    else if (SOURCE_EXTENSIONS2.has(path55.extname(entry.name))) yield full;
+    else if (SOURCE_EXTENSIONS2.has(path56.extname(entry.name))) yield full;
   }
 }
 
@@ -13678,8 +13709,8 @@ var DevOnlyEnvError = class extends Error {
 function buildStack(root, input) {
   const env2 = { ...input.stack, ...input.derived };
   const blanked = [];
-  const file = path56.join(root, ".env");
-  const local = fs51.existsSync(file) ? readLocalEnvFile(file) : {};
+  const file = path57.join(root, ".env");
+  const local = fs52.existsSync(file) ? readLocalEnvFile(file) : {};
   for (const key of Object.keys(local)) {
     if (key in env2) continue;
     if (!input.tunnel && LOCAL_BUILD_KEYS.test(key)) continue;
@@ -13700,16 +13731,16 @@ The build would bake in your development value. Set ${baked.length === 1 ? "it"
 }
 
 // src/lib/env-nudge.ts
-import fs52 from "node:fs";
-import path57 from "node:path";
+import fs53 from "node:fs";
+import path58 from "node:path";
 import process37 from "node:process";
 import * as p48 from "@clack/prompts";
 import pc19 from "picocolors";
 var ENV_EXAMPLE = ".env.example";
 var SUPPLIED = /^(NODE_ENV|HOST|PORT|ORIGIN|PROTOCOL_HEADER|HOST_HEADER|ADDRESS_HEADER|XFF_DEPTH|PB_PORT|POCKETBASE_URL|POCKETBASE_SUPERUSER_EMAIL|POCKETBASE_SUPERUSER_PASSWORD|APP_NAME|VELA_)/;
 function missingFromExample(root, present) {
-  const file = path57.join(root, ENV_EXAMPLE);
-  if (!fs52.existsSync(file)) return [];
+  const file = path58.join(root, ENV_EXAMPLE);
+  if (!fs53.existsSync(file)) return [];
   const have = new Set(present);
   return Object.keys(readLocalEnvFile(file)).filter((key) => !have.has(key) && !SUPPLIED.test(key)).sort();
 }
@@ -14058,12 +14089,12 @@ ${pc20.cyan(err.snippet)}` : err.message);
     current = detectAdapter(workspaceRootDir);
   } catch {
   }
-  const editable = current !== void 0 && !/^svelte\.config\./.test(path58.basename(current.file));
+  const editable = current !== void 0 && !/^svelte\.config\./.test(path59.basename(current.file));
   if (current && editable && (current.kind === "auto" || current.kind === "none") && isInteractive()) {
     const has = current.kind === "auto" ? `is on ${ADAPTER_AUTO}` : "has no SvelteKit adapter configured";
     const confirmed = await p49.confirm({
       message: `This project ${has}, and vela deploy runs the app as a Node server.
-Switch it to ${ADAPTER_NODE}? This edits ${path58.basename(current.file)} and package.json.`
+Switch it to ${ADAPTER_NODE}? This edits ${path59.basename(current.file)} and package.json.`
     });
     if (p49.isCancel(confirmed) || !confirmed) {
       p49.cancel("Nothing was changed, and nothing was deployed.");
@@ -14187,7 +14218,7 @@ async function uploadRelease(session, instance, release, entries) {
 }
 function isDirectory(target) {
   try {
-    return fs53.statSync(target).isDirectory();
+    return fs54.statSync(target).isDirectory();
   } catch {
     return false;
   }
@@ -14228,7 +14259,7 @@ async function serverTimeOrLocal(session) {
 }
 
 // src/commands/link.ts
-import path59 from "node:path";
+import path60 from "node:path";
 import process39 from "node:process";
 import { Command as Command89 } from "commander";
 import * as p50 from "@clack/prompts";
@@ -14291,12 +14322,12 @@ async function promptProjectName(workspaceRootDir) {
 }
 function defaultProjectName2(workspaceRootDir) {
   try {
-    const pkg = readPackageJson(path59.join(workspaceRootDir, "package.json"));
+    const pkg = readPackageJson(path60.join(workspaceRootDir, "package.json"));
     const name = pkg.name;
     if (typeof name === "string" && name.trim()) return name.trim();
   } catch {
   }
-  return path59.basename(workspaceRootDir);
+  return path60.basename(workspaceRootDir);
 }
 
 // src/commands/env.ts
@@ -14309,17 +14340,17 @@ import * as p53 from "@clack/prompts";
 import pc23 from "picocolors";
 
 // src/lib/local-env.ts
-import fs54 from "node:fs";
+import fs55 from "node:fs";
 import * as p51 from "@clack/prompts";
 import pc21 from "picocolors";
 function readLocalEnv(envFile) {
-  if (!fs54.existsSync(envFile)) return {};
+  if (!fs55.existsSync(envFile)) return {};
   return readLocalEnvFile(envFile);
 }
 function editLocalEnv(envFile, edit) {
-  const before = fs54.existsSync(envFile) ? fs54.readFileSync(envFile, "utf8") : "";
+  const before = fs55.existsSync(envFile) ? fs55.readFileSync(envFile, "utf8") : "";
   const after = edit(before);
-  if (after !== before) fs54.writeFileSync(envFile, after);
+  if (after !== before) fs55.writeFileSync(envFile, after);
 }
 function setLocalEnv(envFile, key, value) {
   editLocalEnv(envFile, (content) => upsertEnvVar(content, key, value));
@@ -14848,8 +14879,8 @@ var envUnset = addEnvTargetOptions(
 );
 
 // src/commands/env/import.ts
-import fs55 from "node:fs";
-import path60 from "node:path";
+import fs56 from "node:fs";
+import path61 from "node:path";
 import process42 from "node:process";
 import { Command as Command93 } from "commander";
 import * as p56 from "@clack/prompts";
@@ -14920,10 +14951,10 @@ function report2(outcome, where) {
   p56.log.success(`${parts.join(", ")} variable(s) updated ${pc26.dim(`(${where})`)}`);
 }
 function resolve(file) {
-  return path60.resolve(process42.cwd(), file);
+  return path61.resolve(process42.cwd(), file);
 }
 function read(resolved, shown) {
-  if (!fs55.existsSync(resolved)) throw new Error(`${shown} does not exist.`);
+  if (!fs56.existsSync(resolved)) throw new Error(`${shown} does not exist.`);
   const incoming = readLocalEnvFile(resolved);
   if (Object.keys(incoming).length === 0) p56.log.info(`${shown} has no variables to import.`);
   return incoming;
@@ -15312,8 +15343,8 @@ var admin = new Command100("admin").description("manage admin panel logins").con
 import { Command as Command106 } from "commander";
 
 // src/commands/backup/create.ts
-import fs56 from "node:fs";
-import path61 from "node:path";
+import fs57 from "node:fs";
+import path62 from "node:path";
 import { Command as Command101 } from "commander";
 import * as p61 from "@clack/prompts";
 import pc32 from "picocolors";
@@ -15527,12 +15558,12 @@ Your bucket's own versioning is what protects the uploaded files.`
   }, "Failed to create the backup.")
 );
 async function download(ctx, key, outputDir) {
-  const dir = path61.resolve(ctx.workspaceRootDir, outputDir);
-  fs56.mkdirSync(dir, { recursive: true });
-  const destination = path61.join(dir, key);
+  const dir = path62.resolve(ctx.workspaceRootDir, outputDir);
+  fs57.mkdirSync(dir, { recursive: true });
+  const destination = path62.join(dir, key);
   if (!ctx.session) {
-    fs56.copyFileSync(path61.join(ctx.workspaceRootDir, "data", "backups", key), destination);
-    return path61.relative(ctx.workspaceRootDir, destination);
+    fs57.copyFileSync(path62.join(ctx.workspaceRootDir, "data", "backups", key), destination);
+    return path62.relative(ctx.workspaceRootDir, destination);
   }
   const spinner9 = p61.spinner();
   spinner9.start(`Downloading ${key}`);
@@ -15543,7 +15574,7 @@ async function download(ctx, key, outputDir) {
     throw error;
   }
   spinner9.stop(`Downloaded ${key}`);
-  return path61.relative(ctx.workspaceRootDir, destination);
+  return path62.relative(ctx.workspaceRootDir, destination);
 }
 
 // src/commands/backup/list.ts
@@ -15577,8 +15608,8 @@ Take one with ${pc33.cyan("vela backup create")}.`
 );
 
 // src/commands/backup/download.ts
-import fs57 from "node:fs";
-import path62 from "node:path";
+import fs58 from "node:fs";
+import path63 from "node:path";
 import { Command as Command103 } from "commander";
 import * as p63 from "@clack/prompts";
 import pc34 from "picocolors";
@@ -15605,11 +15636,11 @@ Run ${pc34.cyan("vela backup list")} to see what it does have.`
 Fetch it from the bucket directly \u2014 vela does not hold its credentials.`
         );
       }
-      const dir = path62.resolve(ctx.workspaceRootDir, options.output);
-      fs57.mkdirSync(dir, { recursive: true });
-      const destination = path62.join(dir, key);
+      const dir = path63.resolve(ctx.workspaceRootDir, options.output);
+      fs58.mkdirSync(dir, { recursive: true });
+      const destination = path63.join(dir, key);
       if (!ctx.session) {
-        fs57.copyFileSync(path62.join(ctx.workspaceRootDir, "data", "backups", key), destination);
+        fs58.copyFileSync(path63.join(ctx.workspaceRootDir, "data", "backups", key), destination);
       } else {
         const spinner9 = p63.spinner();
         spinner9.start(`Downloading ${key} (${formatBytes(found.size)})`);
@@ -15623,7 +15654,7 @@ Fetch it from the bucket directly \u2014 vela does not hold its credentials.`
       }
       reportResult({
         summary: `Saved ${key} from ${ctx.targetName}.`,
-        filesCreated: [path62.relative(ctx.workspaceRootDir, destination)]
+        filesCreated: [path63.relative(ctx.workspaceRootDir, destination)]
       });
     });
   }, "Failed to download the backup.")
@@ -15718,8 +15749,8 @@ Set one with ${pc36.cyan('vela backup schedule "0 3 * * *"')}.`
 var backup = new Command106("backup").description("back up the database and uploads, locally or on a target").configureHelp(helpConfig).addCommand(backupCreate).addCommand(backupList).addCommand(backupDownload).addCommand(backupDelete).addCommand(backupSchedule);
 
 // src/commands/restore.ts
-import fs58 from "node:fs";
-import path63 from "node:path";
+import fs59 from "node:fs";
+import path64 from "node:path";
 import process46 from "node:process";
 import { Command as Command107 } from "commander";
 import * as p66 from "@clack/prompts";
@@ -15749,7 +15780,7 @@ Run \`vela deploy\` first, then restore.`
               `${ctx.targetName} was deployed without a database, so there is nothing to restore.`
             );
           }
-          const local = source && fs58.existsSync(source) ? source : void 0;
+          const local = source && fs59.existsSync(source) ? source : void 0;
           const key = local ? void 0 : await resolveKey(ctx, source);
           if (!options.yes) {
             await confirm14(ctx.appName, ctx.targetName, ctx.envTag, local ?? key);
@@ -15772,7 +15803,7 @@ Run \`vela deploy\` first, then restore.`
           });
           p66.log.success(
             `Restored ${pc37.cyan(`${ctx.appName} (${ctx.targetName})`)} from ${pc37.cyan(
-              local ? path63.basename(local) : key
+              local ? path64.basename(local) : key
             )}.`
           );
           if (result?.storageCarriedOver) {
@@ -15838,21 +15869,21 @@ Take one with ${pc37.cyan("vela backup create")}, or pass the path to an archive
 }
 async function stage(ctx, file) {
   const dir = remotePaths.restoreStage(ctx.instance);
-  const remote = `${dir}/${path63.basename(file)}`;
+  const remote = `${dir}/${path64.basename(file)}`;
   const spinner9 = p66.spinner();
-  spinner9.start(`Uploading ${path63.basename(file)}`);
+  spinner9.start(`Uploading ${path64.basename(file)}`);
   try {
     await ctx.session.script(`mkdir -p "$1"`, { args: [dir] });
     await ctx.session.upload([file], dir);
   } catch (error) {
-    spinner9.stop(`Could not upload ${path63.basename(file)}.`);
+    spinner9.stop(`Could not upload ${path64.basename(file)}.`);
     throw error;
   }
-  spinner9.stop(`Uploaded ${path63.basename(file)}`);
+  spinner9.stop(`Uploaded ${path64.basename(file)}`);
   return remote;
 }
 async function confirm14(appName, targetName, envTag, from) {
-  const what = `${pc37.cyan(`${appName} (${targetName})`)} from ${pc37.cyan(path63.basename(from))}`;
+  const what = `${pc37.cyan(`${appName} (${targetName})`)} from ${pc37.cyan(path64.basename(from))}`;
   if (isProd(envTag)) {
     const answer = await p66.text({
       message: `This replaces the database and uploads of ${what}. Type the app name to confirm`,
@@ -15962,70 +15993,72 @@ Release and domain are shown from what this project recorded.`
 }
 
 // src/commands/test.ts
-import path64 from "node:path";
-import process47 from "node:process";
+import process48 from "node:process";
 import { Command as Command109 } from "commander";
-import PocketBase7 from "pocketbase";
 import pc39 from "picocolors";
-import { x as x6 } from "tinyexec";
-import { detect as detect9 } from "package-manager-detector";
-import { resolveCommand as resolveCommand7 } from "package-manager-detector/commands";
-import fs59 from "node:fs";
-var testServer = new Command109("test:server").description("run server tests").allowUnknownOption(true).allowExcessArguments(true).configureHelp(helpConfig).action(async (_opts, cmd) => {
-  const cwd = process47.cwd();
-  warnIfKit2(cwd, (m) => console.warn(pc39.yellow(`\u25B2 ${m}`)));
+import { x as x7 } from "tinyexec";
+import { detect as detect10 } from "package-manager-detector";
+import { resolveCommand as resolveCommand8 } from "package-manager-detector/commands";
+
+// src/lib/test-harness.ts
+import fs60 from "node:fs";
+import path65 from "node:path";
+import process47 from "node:process";
+import PocketBase7 from "pocketbase";
+var TEST_DATA_DIR = "test-data";
+var HarnessError = class extends Error {
+};
+async function startTestHarness(cwd, { log: log58 = () => {
+} } = {}) {
   const email2 = `test-${Math.random().toString(36).slice(2)}@example.com`;
   const password8 = "password";
-  const testDataDir = path64.join(cwd, "test-data");
-  fs59.rmSync(testDataDir, { recursive: true, force: true });
-  const { stop, url } = await launchPocketbase(cwd, {
-    dir: testDataDir,
-    migrationsDir: path64.join(cwd, MIGRATIONS_DIR),
+  const root = path65.join(cwd, TEST_DATA_DIR);
+  pruneStaleRuns(root);
+  const dataDir2 = path65.join(root, String(process47.pid));
+  fs60.rmSync(dataDir2, { recursive: true, force: true });
+  const { stop: stopPocketbase, url: pocketbaseUrl } = await launchPocketbase(cwd, {
+    dir: dataDir2,
+    migrationsDir: path65.join(cwd, MIGRATIONS_DIR),
     // The app's PocketBase hooks (slug generation, personal teams, …) are part
     // of its behaviour; the suite runs against the same server dev and build
     // start, so it loads them from the same place.
-    hooksDir: path64.join(cwd, DATA_DIR, "hooks"),
+    hooksDir: path65.join(cwd, DATA_DIR, "hooks"),
     email: email2,
     password: password8
   });
-  process47.env.POCKETBASE_URL = url;
-  process47.env.POCKETBASE_SUPERUSER_EMAIL = email2;
-  process47.env.POCKETBASE_SUPERUSER_PASSWORD = password8;
-  process47.env.VELA_DATA_DIR = testDataDir;
-  process47.env.TEST = "true";
-  console.log(`${pc39.greenBright("\u2713")} Created test database`);
   let vite;
-  let cleanedUp = false;
-  const cleanupSync = () => {
-    if (cleanedUp) return;
-    cleanedUp = true;
-    stop();
-    fs59.rmSync(testDataDir, { recursive: true, force: true });
+  let stopped = false;
+  const stopSync = () => {
+    if (stopped) return;
+    stopped = true;
+    stopPocketbase();
+    fs60.rmSync(dataDir2, { recursive: true, force: true });
   };
-  const cleanup = async () => {
-    if (cleanedUp) return;
+  const stop = async () => {
+    if (stopped) return;
     process47.emit("sveltekit:shutdown", 0);
     await vite?.close().catch(() => {
     });
-    cleanupSync();
+    stopSync();
   };
   const fail = async (message) => {
-    console.error(`${pc39.redBright("\u2717")} ${message}`);
-    await cleanup();
-    process47.exit(1);
+    await stop();
+    throw new HarnessError(message);
   };
-  process47.on("exit", cleanupSync);
-  for (const [signal, code2] of [
-    ["SIGINT", 130],
-    ["SIGTERM", 143],
-    ["SIGHUP", 129]
-  ]) {
-    process47.on(signal, () => {
-      cleanupSync();
-      process47.exit(code2);
-    });
-  }
-  const pb = new PocketBase7(url);
+  const env2 = {
+    POCKETBASE_URL: pocketbaseUrl,
+    POCKETBASE_SUPERUSER_EMAIL: email2,
+    POCKETBASE_SUPERUSER_PASSWORD: password8,
+    // The app's data directory is PocketBase's, here as everywhere else. It
+    // points at the throwaway one so that a database or an uploaded file the
+    // suite creates is removed with it, rather than accumulating in the
+    // directory the developer actually works against.
+    VELA_DATA_DIR: dataDir2,
+    TEST: "true"
+  };
+  Object.assign(process47.env, env2);
+  log58("Created test database");
+  const pb = new PocketBase7(pocketbaseUrl);
   try {
     await authWithRetries(pb, email2, password8);
   } catch (e) {
@@ -16033,60 +16066,61 @@ var testServer = new Command109("test:server").description("run server tests").a
   }
   try {
     const seeds2 = await loadSeeds(pb, cwd);
-    if (seeds2.length > 0) {
-      console.log(`${pc39.greenBright("\u2713")} Loaded ${seeds2.length} seed file(s)`);
-    }
+    if (seeds2.length > 0) log58(`Loaded ${seeds2.length} seed file(s)`);
     const fixtures2 = await loadFixtures(pb, cwd);
-    if (fixtures2.length > 0) {
-      console.log(`${pc39.greenBright("\u2713")} Loaded ${fixtures2.length} fixture file(s)`);
-    }
+    if (fixtures2.length > 0) log58(`Loaded ${fixtures2.length} fixture file(s)`);
   } catch (e) {
     await fail(describeLoadFailure(e));
   }
-  const { createServer } = await loadVite(cwd);
-  vite = await createServer({
-    mode: "test",
-    plugins: [stubPagesPlugin()],
-    optimizeDeps: { noDiscovery: true },
-    // This config differs from `vela dev`'s, so sharing node_modules/.vite
-    // would make Vite re-optimize dependencies under a running dev server,
-    // which then loads two copies of Svelte and fails reading `page`.
-    cacheDir: "node_modules/.vite-test"
-  });
-  const vitePort = await findFreePort();
-  await vite.listen(vitePort);
-  process47.env.VITE_TEST_URL = `http://localhost:${vitePort}`;
-  console.log(`${pc39.greenBright("\u2713")} Started Vite: http://localhost:${vitePort}`);
-  console.log(`${pc39.greenBright("\u2713")} Started PocketBase: ${url}`);
-  const extraArgs = (cmd.parent?.args ?? []).slice(1);
-  let filter = extraArgs.find((arg) => !arg.startsWith("-"));
-  const passthrough = filter ? extraArgs.filter((a) => a !== filter) : extraArgs;
-  const defaulted = !filter;
-  if (!filter) filter = "server";
   try {
-    const pm = (await detect9({ cwd }))?.name ?? "npm";
-    const resolved = resolveCommand7(pm, "execute", [
-      "vitest",
-      "run",
-      filter,
-      "--reporter=dot",
-      ...defaulted ? ["--passWithNoTests"] : [],
-      ...passthrough
-    ]);
-    const resolvedArgs = resolved.args.slice();
-    if (pm === "npm") resolvedArgs.unshift("--yes");
-    const result = await x6(resolved.command, resolvedArgs, {
-      nodeOptions: { cwd, stdio: "inherit", env: { ...process47.env, CI: "1" } }
+    const { createServer } = await loadVite(cwd);
+    vite = await createServer({
+      mode: "test",
+      plugins: [stubPagesPlugin()],
+      optimizeDeps: { noDiscovery: true },
+      // This config differs from `vela dev`'s, so sharing node_modules/.vite
+      // would make Vite re-optimize dependencies under a running dev server,
+      // which then loads two copies of Svelte and fails reading `page`.
+      cacheDir: "node_modules/.vite-test"
     });
-    process47.exitCode = result.exitCode ?? 1;
+    const port = await findFreePort();
+    await vite.listen(port);
   } catch (e) {
-    console.error(`${pc39.redBright("\u2717")} ${e.message}`);
-    process47.exitCode = 1;
-  } finally {
-    await cleanup();
-    process47.exit(process47.exitCode ?? 0);
+    await fail(`Failed to start Vite: ${e.message}`);
   }
-});
+  const appUrl = `http://localhost:${vite.config.server.port}`;
+  env2.VITE_TEST_URL = appUrl;
+  process47.env.VITE_TEST_URL = appUrl;
+  log58(`Started Vite: ${appUrl}`);
+  log58(`Started PocketBase: ${pocketbaseUrl}`);
+  return {
+    pocketbaseUrl,
+    appUrl,
+    superuser: { email: email2, password: password8 },
+    dataDir: dataDir2,
+    env: env2,
+    stop,
+    stopSync
+  };
+}
+function pruneStaleRuns(root) {
+  if (!fs60.existsSync(root)) return;
+  for (const entry of fs60.readdirSync(root, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const pid = Number(entry.name);
+    if (!Number.isInteger(pid) || pid === process47.pid) continue;
+    if (isAlive(pid)) continue;
+    fs60.rmSync(path65.join(root, entry.name), { recursive: true, force: true });
+  }
+}
+function isAlive(pid) {
+  try {
+    process47.kill(pid, 0);
+    return true;
+  } catch (e) {
+    return e.code === "EPERM";
+  }
+}
 function describeLoadFailure(e) {
   if (e instanceof DataLoadError) {
     const hint = e.kind === "fixtures" ? "Run `vela fixtures regen` to regenerate fixtures from the current schema." : `Check ${e.file} against the current schema.`;
@@ -16112,9 +16146,83 @@ function stubPagesPlugin() {
   };
 }
 
+// src/commands/test.ts
+var testServer = new Command109("test:server").description("run server tests").allowUnknownOption(true).allowExcessArguments(true).configureHelp(helpConfig).action(async (_opts, cmd) => {
+  const cwd = process48.cwd();
+  warnIfKit2(cwd, (m) => console.warn(pc39.yellow(`\u25B2 ${m}`)));
+  const extraArgs = (cmd.parent?.args ?? []).slice(1);
+  const filtered = extraArgs.some((arg) => !arg.startsWith("-"));
+  try {
+    const pm = (await detect10({ cwd }))?.name ?? "npm";
+    const resolved = resolveCommand8(pm, "execute", [
+      "vitest",
+      "run",
+      "--project",
+      "server",
+      "--reporter=dot",
+      ...filtered ? [] : ["--passWithNoTests"],
+      ...extraArgs
+    ]);
+    const resolvedArgs = resolved.args.slice();
+    if (pm === "npm") resolvedArgs.unshift("--yes");
+    const result = await x7(resolved.command, resolvedArgs, {
+      nodeOptions: { cwd, stdio: "inherit", env: { ...process48.env, CI: "1" } }
+    });
+    process48.exitCode = result.exitCode ?? 1;
+  } catch (e) {
+    console.error(`${pc39.redBright("\u2717")} ${e.message}`);
+    process48.exitCode = 1;
+  }
+});
+var testHarness = new Command109("test:harness").description("start the servers for server tests and wait (used by vela/testing)").configureHelp(helpConfig).action(async () => {
+  const cwd = process48.cwd();
+  if (!process48.send) {
+    console.error(
+      `${pc39.redBright("\u2717")} vela test:harness is started by vitest through \`vela/testing\`. Run \`vela test:server\` instead.`
+    );
+    process48.exit(1);
+  }
+  let harness;
+  let exiting = false;
+  const exit = async (code2) => {
+    if (exiting) return;
+    exiting = true;
+    await harness?.stop();
+    process48.exit(code2);
+  };
+  process48.on("exit", () => harness?.stopSync());
+  for (const [signal, code2] of [
+    ["SIGINT", 130],
+    ["SIGTERM", 143],
+    ["SIGHUP", 129]
+  ]) {
+    process48.on(signal, () => void exit(code2));
+  }
+  process48.on("disconnect", () => void exit(0));
+  process48.on("message", (message) => {
+    if (message === "stop") void exit(0);
+  });
+  try {
+    harness = await startTestHarness(cwd, {
+      log: (message) => console.log(`${pc39.greenBright("\u2713")} ${message}`)
+    });
+  } catch (e) {
+    const message = e instanceof HarnessError ? e.message : `Failed to start the test servers: ${e.message}`;
+    console.error(`${pc39.redBright("\u2717")} ${message}`);
+    process48.send({ type: "error", message });
+    process48.exit(1);
+  }
+  const { pocketbaseUrl, appUrl, superuser, dataDir: dataDir2, env: env2 } = harness;
+  process48.send({
+    type: "ready",
+    servers: { pocketbaseUrl, appUrl, superuser, dataDir: dataDir2 },
+    env: env2
+  });
+});
+
 // src/commands/routes.ts
-import fs60 from "node:fs";
-import path65 from "node:path";
+import fs61 from "node:fs";
+import path66 from "node:path";
 import { Command as Command110 } from "commander";
 var HTTP_METHODS = /* @__PURE__ */ new Set([
   "GET",
@@ -16128,30 +16236,30 @@ var HTTP_METHODS = /* @__PURE__ */ new Set([
 ]);
 var routes = new Command110("routes").description("list routes").configureHelp(helpConfig).action(async () => {
   const { workspaceRootDir, routesDir } = await getWorkspace();
-  const routesRoot = path65.join(workspaceRootDir, routesDir);
+  const routesRoot = path66.join(workspaceRootDir, routesDir);
   const found = walk(routesRoot, routesRoot).filter((r) => r.methods.length > 0);
   found.sort((a, b) => a.urlPattern.localeCompare(b.urlPattern));
   printTable(found);
 });
 function walk(root, dir) {
-  const entries = fs60.readdirSync(dir, { withFileTypes: true });
+  const entries = fs61.readdirSync(dir, { withFileTypes: true });
   const routes2 = [];
   const hasLeaf = entries.some((e) => e.isFile() && isRouteFile(e.name));
   if (hasLeaf) {
-    const id = "/" + path65.relative(root, dir).split(path65.sep).filter(Boolean).join("/");
+    const id = "/" + path66.relative(root, dir).split(path66.sep).filter(Boolean).join("/");
     const urlPattern = id.replace(/\([^)]+\)\/?/g, "").replace(/\/$/, "") || "/";
     const methods = /* @__PURE__ */ new Set();
     for (const entry of entries) {
       if (!entry.isFile()) continue;
       if (entry.name.endsWith("+page.svelte")) methods.add("GET");
       if (entry.name.endsWith("+server.ts") || entry.name.endsWith("+server.js") || entry.name.endsWith("+page.server.ts") || entry.name.endsWith("+page.server.js")) {
-        extractMethods(path65.join(dir, entry.name)).forEach((m) => methods.add(m));
+        extractMethods(path66.join(dir, entry.name)).forEach((m) => methods.add(m));
       }
     }
     routes2.push({ id: id || "/", urlPattern, methods: [...methods] });
   }
   for (const entry of entries) {
-    if (entry.isDirectory()) routes2.push(...walk(root, path65.join(dir, entry.name)));
+    if (entry.isDirectory()) routes2.push(...walk(root, path66.join(dir, entry.name)));
   }
   return routes2;
 }
@@ -16160,7 +16268,7 @@ function isRouteFile(name) {
 }
 function extractMethods(file) {
   try {
-    const content = fs60.readFileSync(file, "utf8");
+    const content = fs61.readFileSync(file, "utf8");
     const methods = [];
     const exportRegex = /export\s+(?:const|async\s+function|function)\s+(\w+)/g;
     let match;
@@ -16201,24 +16309,24 @@ function printTable(routes2) {
 }
 
 // src/commands/i18n.ts
-import fs61 from "node:fs";
-import path66 from "node:path";
-import process48 from "node:process";
+import fs62 from "node:fs";
+import path67 from "node:path";
+import process49 from "node:process";
 import { Command as Command111 } from "commander";
-import { x as x7 } from "tinyexec";
-import { detect as detect10 } from "package-manager-detector";
-import { resolveCommand as resolveCommand8 } from "package-manager-detector/commands";
+import { x as x8 } from "tinyexec";
+import { detect as detect11 } from "package-manager-detector";
+import { resolveCommand as resolveCommand9 } from "package-manager-detector/commands";
 var WUCHALE_CONFIG_NAMES = ["js", "mjs", "ts", "mts"].map((ext) => `wuchale.config.${ext}`);
 async function runWuchale(extraArgs) {
-  const cwd = findWorkspaceRoot() ?? process48.cwd();
-  if (!WUCHALE_CONFIG_NAMES.some((name) => fs61.existsSync(path66.join(cwd, name)))) {
+  const cwd = findWorkspaceRoot() ?? process49.cwd();
+  if (!WUCHALE_CONFIG_NAMES.some((name) => fs62.existsSync(path67.join(cwd, name)))) {
     throw new Error("No wuchale config found. Run `vela enable i18n` to set up i18n.");
   }
-  const pm = (await detect10({ cwd }))?.name ?? "npm";
-  const resolved = resolveCommand8(pm, "execute", ["wuchale", ...extraArgs]);
+  const pm = (await detect11({ cwd }))?.name ?? "npm";
+  const resolved = resolveCommand9(pm, "execute", ["wuchale", ...extraArgs]);
   const args = resolved.args.slice();
   if (pm === "npm") args.unshift("--yes");
-  await x7(resolved.command, args, {
+  await x8(resolved.command, args, {
     nodeOptions: { cwd, stdio: "inherit" },
     throwOnError: true
   });
@@ -16233,7 +16341,7 @@ var i18n3 = new Command111("i18n").description("i18n utilities").configureHelp(h
 import { Command as Command117 } from "commander";
 
 // src/commands/cms/deploy.ts
-import process49 from "node:process";
+import process50 from "node:process";
 import { Command as Command112 } from "commander";
 import * as p68 from "@clack/prompts";
 import pc40 from "picocolors";
@@ -16299,7 +16407,7 @@ function resolveProjectId(explicit) {
     }
     return explicit;
   }
-  const root = findWorkspaceRoot(process49.cwd());
+  const root = findWorkspaceRoot(process50.cwd());
   const link2 = root ? readProjectConfig(root) : null;
   if (!link2) {
     throw new Error(
@@ -16339,15 +16447,15 @@ import pc42 from "picocolors";
 
 // src/lib/cms-backend.ts
 import { createRequire as createRequire5 } from "node:module";
-import path67 from "node:path";
-import process50 from "node:process";
+import path68 from "node:path";
+import process51 from "node:process";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 import pc41 from "picocolors";
 var DEFAULT_PROJECT = "default";
 async function loadBackendModule(root) {
   let entry;
   try {
-    entry = createRequire5(path67.join(root, "package.json")).resolve("@velastack/cms/backend");
+    entry = createRequire5(path68.join(root, "package.json")).resolve("@velastack/cms/backend");
   } catch {
     throw new Error(
       `@velastack/cms is not installed in this project.
@@ -16357,7 +16465,7 @@ Run ${pc41.cyan("vela enable cms")} first.`
   }
   return await import(pathToFileURL2(entry).href);
 }
-async function withCmsBackend(fn, cwd = process50.cwd()) {
+async function withCmsBackend(fn, cwd = process51.cwd()) {
   const root = findWorkspaceRoot(cwd);
   if (!root) {
     throw new Error("Could not find workspace root (no package.json found)");
@@ -16365,8 +16473,8 @@ async function withCmsBackend(fn, cwd = process50.cwd()) {
   const { createCmsBackend } = await loadBackendModule(root);
   const dataDir2 = localDataDir(root);
   const backend3 = createCmsBackend({
-    dbPath: path67.join(dataDir2, "cms.sqlite"),
-    uploadDir: path67.join(dataDir2, "uploads")
+    dbPath: path68.join(dataDir2, "cms.sqlite"),
+    uploadDir: path68.join(dataDir2, "uploads")
   });
   try {
     return await fn(backend3);
@@ -16444,7 +16552,7 @@ var cms2 = new Command117("cms").description("manage the CMS").configureHelp(hel
 import { Command as Command121 } from "commander";
 
 // src/commands/workflows/list.ts
-import process51 from "node:process";
+import process52 from "node:process";
 import { Command as Command118, InvalidArgumentError as InvalidArgumentError5 } from "commander";
 import * as p72 from "@clack/prompts";
 import pc45 from "picocolors";
@@ -16522,7 +16630,7 @@ function formatRun(run, nameWidth) {
 }
 var workflowsList = new Command118("list").description("list recent workflow runs").option("--status <status>", `only runs in this state (${STATUSES.join(", ")})`, parseStatus).option("--name <workflow>", "only runs of this workflow").option("--limit <n>", "how many to show", parseLimit, 50).configureHelp(helpConfig).action(
   (options) => runCommand(async () => {
-    await withPocketbase(process51.cwd(), async (pb) => {
+    await withPocketbase(process52.cwd(), async (pb) => {
       const runs = await listRuns(pb, {
         status: options.status,
         workflowName: options.name,
@@ -16543,7 +16651,7 @@ Start one from server code with ${pc45.cyan("<workflow>.run(input)")}, or with $
 );
 
 // src/commands/workflows/run.ts
-import process52 from "node:process";
+import process53 from "node:process";
 import { Command as Command119, InvalidArgumentError as InvalidArgumentError6 } from "commander";
 import * as p73 from "@clack/prompts";
 import pc46 from "picocolors";
@@ -16556,7 +16664,7 @@ function parseInput(value) {
 }
 var workflowsRun = new Command119("run").description("start a run of a workflow; the running app picks it up").argument("<name>", "the workflow name, as in its defineWorkflow spec").argument("[input]", "the run input as JSON", parseInput).configureHelp(helpConfig).action(
   (name, input) => runCommand(async () => {
-    await withPocketbase(process52.cwd(), async (pb) => {
+    await withPocketbase(process53.cwd(), async (pb) => {
       const run = await createRun(pb, name, input);
       p73.log.success(
         `Queued ${pc46.cyan(name)} as run ${pc46.bold(run.id)}.
@@ -16568,13 +16676,13 @@ It runs once the app is up (${pc46.cyan("vela dev")}); ${pc46.cyan("vela workflo
 );
 
 // src/commands/workflows/cancel.ts
-import process53 from "node:process";
+import process54 from "node:process";
 import { Command as Command120 } from "commander";
 import * as p74 from "@clack/prompts";
 import pc47 from "picocolors";
 var workflowsCancel = new Command120("cancel").description("cancel a pending or running workflow run").argument("<run-id>", "the run id from `vela workflows list`").configureHelp(helpConfig).action(
   (id) => runCommand(async () => {
-    await withPocketbase(process53.cwd(), async (pb) => {
+    await withPocketbase(process54.cwd(), async (pb) => {
       const run = await cancelRun(pb, id);
       p74.log.success(`Canceled run ${pc47.bold(run.id)} of ${pc47.cyan(run.workflowName)}.`);
     });
@@ -16654,30 +16762,30 @@ var PROVIDER_GATED_COMMANDS = /* @__PURE__ */ new Set([
   "destroy shop"
 ]);
 var BACKEND_OPTIONAL_COMMANDS = /* @__PURE__ */ new Set(["dev", "build", "preview", "deploy"]);
-var SELF_CREDENTIALED_COMMANDS = /* @__PURE__ */ new Set(["test:server"]);
+var SELF_CREDENTIALED_COMMANDS = /* @__PURE__ */ new Set(["test:server", "test:harness"]);
 var program = new Command122().name(package_default.name).description(package_default.description).version(package_default.version, "-v, --version").configureHelp(helpConfig);
 program.hook("preAction", (_thisCommand, actionCommand) => {
-  const envRoot = findWorkspaceRoot() ?? process54.cwd();
+  const envRoot = findWorkspaceRoot() ?? process55.cwd();
   dotenv2.config({ path: nodePath.join(envRoot, ".env"), quiet: true });
-  const path68 = getCommandPath(actionCommand);
-  if (NO_BACKEND_COMMMANDS.has(path68)) return;
-  if (PROVIDER_GATED_COMMANDS.has(path68)) return;
-  const top = path68.split(" ", 1)[0];
+  const path69 = getCommandPath(actionCommand);
+  if (NO_BACKEND_COMMMANDS.has(path69)) return;
+  if (PROVIDER_GATED_COMMANDS.has(path69)) return;
+  const top = path69.split(" ", 1)[0];
   if (NO_BACKEND_COMMMANDS.has(top)) return;
   if (!hasBackend()) {
     if (BACKEND_OPTIONAL_COMMANDS.has(top)) return;
-    p75.log.error(missingBackendMessage(`vela ${path68}`));
+    p75.log.error(missingBackendMessage(`vela ${path69}`));
     p75.log.message();
     p75.cancel("Operation failed.");
-    process54.exit(1);
+    process55.exit(1);
   }
-  if (SELF_CREDENTIALED_COMMANDS.has(path68)) return;
-  if (path68 === "generate migration" && actionCommand.opts().ai) return;
+  if (SELF_CREDENTIALED_COMMANDS.has(path69)) return;
+  if (path69 === "generate migration" && actionCommand.opts().ai) return;
   if (!hasSuperuserCredentials()) {
     p75.log.error(missingCredentialsMessage());
     p75.log.message();
     p75.cancel("Operation failed.");
-    process54.exit(1);
+    process55.exit(1);
   }
 });
 function getCommandPath(cmd) {
@@ -16728,7 +16836,8 @@ for (const command of [
 ]) {
   program.addCommand(command);
 }
+program.addCommand(testHarness, { hidden: true });
 
 // src/bin.ts
-program.parse(normalizeArgv(process55.argv.slice(2)), { from: "user" });
+program.parse(normalizeArgv(process56.argv.slice(2)), { from: "user" });
 //# sourceMappingURL=bin.js.map