@stacksjs/buddy 0.70.112 → 0.70.114

package/dist/commands/doctor.js

@@ -2,22 +2,28 @@ import process from "node:process";
 import { bold, dim, green, intro, log, onUnknownSubcommand, red, yellow } from "@stacksjs/cli";
 import { feature } from "@stacksjs/config";
 import { storage } from "@stacksjs/storage";
+import { isSupportedBunVersion, isVersionGreaterThanOrEqual, minimumBunVersion } from "@stacksjs/utils";
 import { FEATURE_NAMES, featurePathsPresent } from "./features";
+const minimumSqliteVersion = "3.47.2";
+
+class ProbeWarning extends Error {
+}
 async function probe(checks, name, fn, timeoutMs = 2000) {
-  const start = Date.now();
+  const start = Date.now(), ac = new AbortController, timer = setTimeout(() => ac.abort(), timeoutMs);
   try {
-    const ac = new AbortController, timer = setTimeout(() => ac.abort(), timeoutMs), message = await Promise.race([
+    const message = await Promise.race([
       fn(),
       new Promise((_, rej) => ac.signal.addEventListener("abort", () => rej(Error(`timed out (>${Math.round(timeoutMs / 1000)}s)`))))
     ]);
-    clearTimeout(timer);
     checks.push({ name, status: "pass", message: `${message} (${Date.now() - start}ms)` });
   } catch (err) {
     checks.push({
       name,
-      status: "fail",
+      status: err instanceof ProbeWarning ? "warn" : "fail",
       message: err instanceof Error ? err.message : String(err)
     });
+  } finally {
+    clearTimeout(timer);
   }
 }
 export function doctor(buddy) {
@@ -25,19 +31,18 @@ export function doctor(buddy) {
     log.debug("Running `buddy doctor` ...");
     await intro("buddy doctor");
     const checks = [], bunVersion = process.versions.bun;
-    if (bunVersion)
-      if (Number.parseInt(bunVersion.split(".")[0] || "0", 10) >= 1)
-        checks.push({
-          name: "Bun Runtime",
-          status: "pass",
-          message: `v${bunVersion}`
-        });
-      else
-        checks.push({
-          name: "Bun Runtime",
-          status: "warn",
-          message: `v${bunVersion} (v1.0+ recommended)`
-        });
+    if (bunVersion && isSupportedBunVersion(bunVersion))
+      checks.push({
+        name: "Bun Runtime",
+        status: "pass",
+        message: `v${bunVersion}`
+      });
+    else if (bunVersion)
+      checks.push({
+        name: "Bun Runtime",
+        status: "fail",
+        message: `v${bunVersion} (requires v${minimumBunVersion} or later, run: bun upgrade)`
+      });
     else
       checks.push({
         name: "Bun Runtime",
@@ -100,9 +105,34 @@ export function doctor(buddy) {
         status: "fail",
         message: "Not set \u2014 features that depend on it (encrypted columns, signed URLs, env decryption) will refuse to run. Run `buddy key:generate`."
       });
+    await probe(checks, "SQLite Engine", async () => {
+      const { Database } = await import("bun:sqlite"), memory = new Database(":memory:");
+      let version;
+      try {
+        const row = memory.query("SELECT sqlite_version() AS version").get();
+        if (typeof row?.version === "string")
+          version = row.version;
+      } finally {
+        memory.close();
+      }
+      if (!version)
+        throw new ProbeWarning("could not read sqlite_version() (skipped)");
+      if (!isVersionGreaterThanOrEqual(version, minimumSqliteVersion))
+        throw Error(`v${version} is below the required v${minimumSqliteVersion} (system.sqlite in package.json); upgrade Bun for a newer bundled SQLite`);
+      return `v${version}`;
+    });
     await probe(checks, "Database", async () => {
-      const { db } = await import("@stacksjs/database");
-      await db.unsafe?.("SELECT 1");
+      const { db } = await import("@stacksjs/database"), unsafe = db.unsafe;
+      if (typeof unsafe !== "function")
+        throw new ProbeWarning("driver exposes no raw query method (skipped)");
+      const statement = unsafe("SELECT 1");
+      if (!statement || typeof statement.then !== "function" && typeof statement.execute !== "function")
+        throw new ProbeWarning("driver returned a non-executable statement (skipped)");
+      const result = typeof statement.execute === "function" ? await statement.execute() : await statement;
+      if (result === void 0 || result === null)
+        throw Error("probe query returned no result");
+      if (Array.isArray(result) && result.length === 0)
+        throw Error("probe query returned no rows");
       return "Reachable";
     });
     await probe(checks, "Database FKs", async () => {
@@ -218,6 +248,119 @@ export function doctor(buddy) {
         message: `Could not audit storage config: ${err instanceof Error ? err.message : String(err)}`
       });
     }
+    try {
+      if (process.platform !== "darwin")
+        checks.push({ name: "Dev domains (rpx)", status: "pass", message: "Not macOS (skipped)" });
+      else {
+        const fs = await import("node:fs"), os = await import("node:os"), path = await import("node:path"), isAlive = (pid) => {
+          try {
+            process.kill(pid, 0);
+            return !0;
+          } catch (err) {
+            return err.code === "EPERM";
+          }
+        }, registryDir = path.join(os.homedir(), ".stacks", "rpx", "registry.d"), registered = new Set, deadRegistryFiles = [];
+        if (fs.existsSync(registryDir))
+          for (const file of fs.readdirSync(registryDir)) {
+            if (!file.endsWith(".json"))
+              continue;
+            try {
+              const entry = JSON.parse(fs.readFileSync(path.join(registryDir, file), "utf8"));
+              if (entry.to && (entry.pid === void 0 || isAlive(entry.pid)))
+                registered.add(entry.to.toLowerCase());
+              if (typeof entry.pid === "number" && !isAlive(entry.pid))
+                deadRegistryFiles.push(file);
+            } catch {}
+          }
+        const staleHosts = new Set, staleResolvers = [], hostsPath = "/etc/hosts", hostsLines = fs.existsSync(hostsPath) ? fs.readFileSync(hostsPath, "utf8").split(`
+`) : [];
+        for (let i = 0;i < hostsLines.length; i++) {
+          const line = hostsLines[i];
+          if (line.trim() === "# Added by rpx") {
+            for (let j = i + 1;j < hostsLines.length; j++) {
+              const blockLine = hostsLines[j].trim();
+              if (blockLine === "" || blockLine.startsWith("#"))
+                break;
+              const names = blockLine.split("#")[0]?.trim().split(/\s+/).slice(1) ?? [];
+              for (const name of names)
+                if (!registered.has(name.toLowerCase()))
+                  staleHosts.add(name);
+            }
+            continue;
+          }
+          const hash = line.indexOf("#");
+          if (hash === -1)
+            continue;
+          const marker = /^rpx(?::pid=(\d+))?$/.exec(line.slice(hash + 1).trim());
+          if (!marker)
+            continue;
+          const names = line.slice(0, hash).trim().split(/\s+/).slice(1), pid = marker[1] ? Number.parseInt(marker[1], 10) : null;
+          if (pid !== null ? !isAlive(pid) : names.every((n) => !registered.has(n.toLowerCase())))
+            for (const name of names)
+              staleHosts.add(name);
+        }
+        const resolverDir = "/etc/resolver";
+        if (fs.existsSync(resolverDir))
+          for (const file of fs.readdirSync(resolverDir))
+            try {
+              const content = fs.readFileSync(path.join(resolverDir, file), "utf8");
+              if (!content.includes("127.0.0.1") || !content.includes("15353"))
+                continue;
+              const domain = file.toLowerCase();
+              if (![...registered].some((host) => host === domain || host.endsWith(`.${domain}`)))
+                staleResolvers.push(file);
+            } catch {}
+        if (staleHosts.size > 0 || staleResolvers.length > 0 || deadRegistryFiles.length > 0) {
+          const parts = [];
+          if (staleHosts.size > 0)
+            parts.push(`hosts(${[...staleHosts].join(", ")})`);
+          if (staleResolvers.length > 0)
+            parts.push(`resolver(${staleResolvers.join(", ")})`);
+          if (deadRegistryFiles.length > 0)
+            parts.push(`registry(${deadRegistryFiles.join(", ")})`);
+          checks.push({
+            name: "Dev domains (rpx)",
+            status: "warn",
+            message: `Stale loopback overrides from dead dev sessions: ${parts.join(" ")}. These keep pointing the domain at 127.0.0.1. Remove with: sudo nano /etc/hosts; sudo rm /etc/resolver/<name>; rm ~/.stacks/rpx/registry.d/<file>. Updating @stacksjs/rpx lets the daemon sweep pid-stamped entries automatically.`
+          });
+        } else
+          checks.push({ name: "Dev domains (rpx)", status: "pass", message: "No stale dev-domain overrides" });
+      }
+    } catch (err) {
+      checks.push({
+        name: "Dev domains (rpx)",
+        status: "warn",
+        message: `Could not audit dev-domain overrides: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+    await probe(checks, "Dev ports", async () => {
+      const net = await import("node:net"), { config } = await import("@stacksjs/config"), configured = config.ports ?? {}, targets = [
+        { name: "frontend", key: "frontend", envVar: "PORT", fallback: 3000 },
+        { name: "api", key: "api", envVar: "PORT_API", fallback: 3008 },
+        { name: "docs", key: "docs", envVar: "PORT_DOCS", fallback: 3006 },
+        { name: "dashboard", key: "admin", envVar: "PORT_ADMIN", fallback: 3002 }
+      ].map((t) => ({ ...t, port: Number(configured[t.key]) || t.fallback })), canConnect = (port, host) => new Promise((resolve) => {
+        const socket = net.createConnection({ port, host });
+        socket.setTimeout(400);
+        const done = (occupied) => {
+          socket.destroy();
+          resolve(occupied);
+        };
+        socket.once("connect", () => done(!0));
+        socket.once("timeout", () => done(!1));
+        socket.once("error", () => done(!1));
+      }), occupied = new Set;
+      await Promise.all([...new Set(targets.map((t) => t.port))].map(async (port) => {
+        if (await canConnect(port, "127.0.0.1") || await canConnect(port, "::1"))
+          occupied.add(port);
+      }));
+      const busy = targets.filter((t) => occupied.has(t.port));
+      if (busy.length > 0) {
+        const list = busy.map((t) => `${t.name} :${t.port} (${t.envVar})`).join(", ");
+        throw new ProbeWarning(`in use: ${list}. buddy dev will fail to bind; stop the process holding the port or set the override env var`);
+      }
+      return `All free: ${targets.map((t) => `${t.name} :${t.port}`).join(", ")}`;
+    });
     try {
       const orphans = [];
       for (const name of FEATURE_NAMES) {

package/dist/commands/extension.js

@@ -10,7 +10,7 @@ export function extension(buddy) {
     const pkg = await Bun.file(`${process.cwd()}/package.json`).json().catch(() => ({}));
     return { config, version: pkg.version ?? "0.0.0" };
   };
-  buddy.command("extension:build", "Build the browser extension (Chrome + Firefox) from config/extension.ts").option("--target <target>", "Build a single target (chrome | firefox); omit to build all").option("--version <version>", "Override the extension version (defaults to package.json)").action(async (options) => {
+  buddy.command("extension:build", "Build the browser extension (Chrome + Firefox + Safari) from config/extension.ts").option("--target <target>", "Build a single target (chrome | firefox | safari); omit to build all").option("--version <version>", "Override the extension version (defaults to package.json)").action(async (options) => {
     const { buildExtension, buildAllTargets } = await import("@stacksjs/browser-extension"), { config, version } = await load(), v = options.version ?? version;
     if (options.target) {
       const { outdir } = await buildExtension(config, { target: options.target, version: v });
@@ -68,11 +68,47 @@ console.log('[${name}] popup')
 `);
     log.info("Next: add icons under public/icons, then `buddy extension:build`.");
   });
-  buddy.command("extension:package", "Build + zip the browser extension into store-ready archives").option("--target <target>", "Package a single target (chrome | firefox); omit to package all").option("--version <version>", "Override the extension version (defaults to package.json)").action(async (options) => {
+  buddy.command("extension:package", "Build + zip the browser extension into store-ready archives").option("--target <target>", "Package a single target (chrome | firefox | safari); omit to package all").option("--version <version>", "Override the extension version (defaults to package.json)").action(async (options) => {
     const { packageExtension } = await import("@stacksjs/browser-extension"), { config, version } = await load(), v = options.version ?? version, targets = options.target ? [options.target] : config.targets ?? ["chrome", "firefox"];
     for (const target of targets) {
       const out = await packageExtension(config, { target, version: v });
       log.success(`Packaged ${config.name} (${target}) \u2192 ${out}`);
     }
   });
+  buddy.command("extension:safari:init", "Scaffold the Safari container app (Xcode project) from the template").option("--bundle-id <id>", "Base bundle identifier (defaults to config safariBundleId)").option("--dir <dir>", "Output directory for the Xcode project (default safari)").option("--force", "Overwrite existing scaffold files").option("--team-id <id>", "Apple Developer team used for signing").action(async (options) => {
+    const { scaffoldSafariApp } = await import("@stacksjs/browser-extension"), { config } = await load(), { dir, written, skipped } = await scaffoldSafariApp(config, {
+      bundleId: options.bundleId,
+      dir: options.dir,
+      force: Boolean(options.force),
+      teamId: options.teamId
+    });
+    log.success(`Scaffolded the Safari container app \u2192 ${dir} (${written.length} files)`);
+    if (skipped.length)
+      log.info(`kept ${skipped.length} existing files (use --force to overwrite)`);
+  });
+  buddy.command("extension:safari:app", "Build the extension, sync it into the appex, and xcodebuild the container app").option("--release", "Build the Release configuration (default Debug)").option("--signed", "Allow code signing (needs an Apple Development identity)").option("--skip-xcodebuild", "Only build + sync the extension payload").option("--version <version>", "Override the extension version (defaults to package.json)").action(async (options) => {
+    const { buildSafariApp } = await import("@stacksjs/browser-extension"), { config, version } = await load(), { appPath, resources } = await buildSafariApp(config, {
+      version: options.version ?? version,
+      release: Boolean(options.release),
+      signed: Boolean(options.signed),
+      skipXcodebuild: Boolean(options.skipXcodebuild)
+    });
+    if (appPath) {
+      log.success(`Built ${appPath}`);
+      log.info("Open the app once, then enable the extension in Safari > Settings > Extensions.");
+    } else
+      log.success(`Extension payload synced \u2192 ${resources}`);
+  });
+  buddy.command("extension:safari:publish", "Archive and validate or upload the Safari app to App Store Connect").option("--version <version>", "Override the marketing version (defaults to package.json)").option("--build-number <number>", "CFBundleVersion (defaults to GITHUB_RUN_NUMBER or Unix time)").option("--team-id <id>", "Apple Developer team (defaults to config safariTeamId)").option("--api-key-id <id>", "App Store Connect API key ID").option("--api-issuer-id <id>", "App Store Connect API issuer ID").option("--api-key-path <path>", "Path to the App Store Connect AuthKey_*.p8 file").option("--validate-only", "Create and validate the archive without uploading it").action(async (options) => {
+    const { publishSafariApp } = await import("@stacksjs/browser-extension"), { config, version } = await load(), result = await publishSafariApp(config, {
+      version: options.version ?? version,
+      buildNumber: options.buildNumber,
+      teamId: options.teamId,
+      keyId: options.apiKeyId,
+      issuerId: options.apiIssuerId,
+      keyPath: options.apiKeyPath,
+      validateOnly: Boolean(options.validateOnly)
+    });
+    log.success(options.validateOnly ? `Validated Safari archive ${result.archivePath} (build ${result.buildNumber})` : `Uploaded Safari build ${result.buildNumber} to App Store Connect`);
+  });
 }

package/dist/commands/fresh.js

@@ -1,17 +1,24 @@
 import process from "node:process";
 import { runAction } from "@stacksjs/actions";
 import { intro, log, onUnknownSubcommand, outro } from "@stacksjs/cli";
+import { hasTTY, isCI } from "@stacksjs/env";
 import { Action } from "@stacksjs/enums";
 import { ExitCode } from "@stacksjs/types";
 export function fresh(buddy) {
   const descriptions = {
     fresh: "Re-installs your npm dependencies",
     project: "Target a specific project",
+    force: "Skip the confirmation prompt (required in CI/non-interactive shells)",
     verbose: "Enable verbose output"
   };
-  buddy.command("fresh", descriptions.fresh).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
+  buddy.command("fresh", descriptions.fresh).option("-p, --project [project]", descriptions.project, { default: !1 }).option("-f, --force", descriptions.force, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
     log.debug("Running `buddy fresh` ...", options);
-    if (!buddy.isForce && !buddy.isNoInteraction) {
+    const skipConfirm = options.force === !0 || Boolean(buddy.isForce) || Boolean(buddy.isNoInteraction);
+    if (!skipConfirm && (isCI || !hasTTY || !process.stdin.isTTY)) {
+      log.syncError("Refusing to run `buddy fresh` from a non-interactive shell without confirmation.");
+      log.fatal("   \u27A1\uFE0F  Re-run with `--force` to proceed: `buddy fresh --force`");
+    }
+    if (!skipConfirm) {
       const { confirm } = await import("@stacksjs/cli");
       if (!await confirm({
         message: "This will remove and reinstall all dependencies. Continue?",

package/dist/commands/make.js

@@ -1,5 +1,6 @@
 import process from "node:process";
 import {
+  createFactory,
   createMiddleware,
   createMigration,
   createModel,
@@ -45,16 +46,17 @@ export function make(buddy) {
     resource: "Create a new API resource",
     name: "The name of the action",
     queue: "Make queue migration",
+    queueTable: "Create the queue jobs table migration",
     stack: "Create a new stack",
     certificate: "Create a new SSL Certificate",
     select: "What are you trying to make?",
     project: "Target a specific project",
     verbose: "Enable verbose output"
   };
-  buddy.command("make [make]", "The make command").option("-a, --action [action]", descriptions.action, { default: !1 }).option("-c, --component [component]", descriptions.component, { default: !1 }).option("-d, --database [database]", descriptions.database, { default: !1 }).option("-f, --factory [factory]", descriptions.factory, { default: !1 }).option("-f, --function [function]", descriptions.function, { default: !1 }).option("-l, --language [language]", descriptions.language, { default: !1 }).option("-m, --model [model]", descriptions.model, { default: !1 }).option("-mw, --middleware [middleware]", descriptions.middleware, { default: !1 }).option("-p, --page [page]", descriptions.page, { default: !1 }).option("-m, --migration [migration]", descriptions.migration, { default: !1 }).option("-n, --notification [notification]", descriptions.notification, { default: !1 }).option("-qt, --queue-table", descriptions.queue, { default: !1 }).option("-s, --stack [stack]", descriptions.stack, { default: !1 }).option("--dry-run", "Preview the files that would be generated without writing", { default: !1 }).option("--with-validation", "Include a validation rules block in the generated stub", { default: !1 }).option("--with-auth", "Include auth-aware boilerplate in the generated stub", { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (make, options) => {
+  buddy.command("make [make]", "The make command").option("-a, --action [action]", descriptions.action, { default: !1 }).option("-c, --component [component]", descriptions.component, { default: !1 }).option("-d, --database [database]", descriptions.database, { default: !1 }).option("-f, --factory [factory]", descriptions.factory, { default: !1 }).option("-fn, --function [function]", descriptions.function, { default: !1 }).option("-l, --language [language]", descriptions.language, { default: !1 }).option("-m, --model [model]", descriptions.model, { default: !1 }).option("-mw, --middleware [middleware]", descriptions.middleware, { default: !1 }).option("-p, --page [page]", descriptions.page, { default: !1 }).option("-mg, --migration [migration]", descriptions.migration, { default: !1 }).option("-n, --notification [notification]", descriptions.notification, { default: !1 }).option("-qt, --queue-table", descriptions.queue, { default: !1 }).option("-s, --stack [stack]", descriptions.stack, { default: !1 }).option("--dry-run", "Preview the files that would be generated without writing", { default: !1 }).option("--with-validation", "Include a validation rules block in the generated stub", { default: !1 }).option("--with-auth", "Include auth-aware boilerplate in the generated stub", { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (make, options) => {
     log.debug("Running `buddy make` ...", options);
     if (!buddy.args[0]) {
-      log.error("You need to specify a name. Read more about the documentation here.");
+      console.error("You need to specify a name. Read more about the documentation here.");
       process.exit(ExitCode.FatalError);
     }
     setDryRun(Boolean(options.dryRun || options["dry-run"]));
@@ -115,7 +117,14 @@ export function make(buddy) {
         case "stack":
           await makeStack(options);
           break;
-        default:
+        case "factory":
+          await createFactory(options);
+          break;
+        default: {
+          console.error(`Unknown make subcommand: ${make}`);
+          console.error("Valid subcommands: action, certificate, command, component, database, factory, function, job, language, mail, middleware, migration, model, notification, page, policy, queue-table, resource, stack");
+          process.exit(ExitCode.InvalidArgument);
+        }
       }
     }
     await invoke(options);
@@ -127,7 +136,7 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a name. Read more about the documentation here.");
+      console.error("You need to specify a name. Read more about the documentation here.");
       process.exit(ExitCode.FatalError);
     }
     setDryRun(Boolean(options.dryRun || options["dry-run"]));
@@ -140,7 +149,7 @@ export function make(buddy) {
   buddy.command("scaffold:crud [name]", "Generate model, migration, and CRUD actions").alias("make:crud").alias("make:scaffold").option("-n, --name [name]", "Resource name (PascalCase)", { default: !1 }).option("-f, --fields [fields]", "Comma-separated field list, e.g. title:string,body:text,published:boolean", { default: "" }).option("--dry-run", "Preview the generated files without writing", { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).example("buddy scaffold:crud Post --fields=title:string,body:text,published:boolean").action(async (name, options) => {
     name = name ?? options.name;
     if (!name) {
-      log.error("scaffold:crud requires a resource name. Example: buddy scaffold:crud Post --fields=title:string,body:text");
+      console.error("scaffold:crud requires a resource name. Example: buddy scaffold:crud Post --fields=title:string,body:text");
       process.exit(ExitCode.FatalError);
     }
     const { scaffoldCrud } = await import("@stacksjs/actions");
@@ -148,7 +157,7 @@ export function make(buddy) {
     try {
       await scaffoldCrud(name, options);
     } catch (err) {
-      log.error("scaffold:crud failed:", err);
+      console.error("scaffold:crud failed:", err);
       process.exit(ExitCode.FatalError);
     }
   });
@@ -158,8 +167,8 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a command name.");
-      log.info("Example: buddy make:command SendEmails");
+      console.error("You need to specify a command name.");
+      console.error("Example: buddy make:command SendEmails");
       process.exit(ExitCode.FatalError);
     }
     if (!await makeCommand(options)) {
@@ -180,7 +189,7 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a name. Read more about the documentation here.");
+      console.error("You need to specify a name. Read more about the documentation here.");
       process.exit(ExitCode.FatalError);
     }
     await makeComponent(options);
@@ -190,25 +199,32 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a database name via the `--name` option, or as the command\u2019s argument.");
-      log.info("Example: `buddy make:database my-cool-database`");
-      log.info("Or: `buddy make:database --name=my-cool-database`");
-      log.info("Read more about the documentation here: https://stacksjs.com/docs/make/database");
+      console.error("You need to specify a database name via the `--name` option, or as the command\u2019s argument.");
+      console.error("Example: `buddy make:database my-cool-database`");
+      console.error("Or: `buddy make:database --name=my-cool-database`");
+      console.error("Read more about the documentation here: https://stacksjs.com/docs/make/database");
       process.exit(ExitCode.FatalError);
     }
     makeDatabase(options);
   });
-  buddy.command("make:factory [name]", descriptions.factory).option("-n, --name [name]", descriptions.name, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action((name, options) => {
+  buddy.command("make:factory [name]", descriptions.factory).option("-n, --name [name]", descriptions.name, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (name, options) => {
     log.debug("Running `buddy make:factory` ...", options);
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a name. Read more about the documentation here.");
+      console.error("You need to specify a name. Read more about the documentation here.");
       process.exit(ExitCode.FatalError);
     }
+    await createFactory(options);
   });
-  buddy.command("make:function [name]", descriptions.function).option("-n, --name [name]", descriptions.name, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
+  buddy.command("make:function [name]", descriptions.function).option("-n, --name [name]", descriptions.name, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (name, options) => {
     log.debug("Running `buddy make:function` ...", options);
+    name = name ?? options.name;
+    options.name = name;
+    if (!name) {
+      console.error("You need to specify a name. Read more about the documentation here.");
+      process.exit(ExitCode.FatalError);
+    }
     await makeFunction(options);
   });
   buddy.command("make:lang [name]", descriptions.language).option("-n, --name [name]", descriptions.name, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (name, options) => {
@@ -216,26 +232,27 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a name. Read more about the documentation here.");
+      console.error("You need to specify a name. Read more about the documentation here.");
       process.exit(ExitCode.FatalError);
     }
     await makeLanguage(options);
   });
-  buddy.command("make:migration [name]", descriptions.migration).option("-n, --name [name]", descriptions.name, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action((name, options) => {
+  buddy.command("make:migration [name]", descriptions.migration).option("-n, --name [name]", descriptions.name, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (name, options) => {
     log.debug("Running `buddy make:migration` ...", options);
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a migration name");
+      console.error("You need to specify a migration name");
       process.exit(ExitCode.FatalError);
     }
+    await createMigration(options);
   });
   buddy.command("make:model [name]", descriptions.model).option("-n, --name [name]", descriptions.name, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (name, options) => {
     log.debug("Running `buddy make:model` ...", options);
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a model name");
+      console.error("You need to specify a model name");
       process.exit(ExitCode.FatalError);
     }
     await createModel(options);
@@ -246,7 +263,7 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a name (e.g. `buddy make:mail OrderShipped`).");
+      console.error("You need to specify a name (e.g. `buddy make:mail OrderShipped`).");
       process.exit(ExitCode.FatalError);
     }
     await makeMail(options);
@@ -262,7 +279,7 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a name. Read more about the documentation here.");
+      console.error("You need to specify a name. Read more about the documentation here.");
       process.exit(ExitCode.FatalError);
     }
     if (!await createNotification(options)) {
@@ -284,8 +301,8 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a policy name.");
-      log.info("Example: buddy make:policy PostPolicy");
+      console.error("You need to specify a policy name.");
+      console.error("Example: buddy make:policy PostPolicy");
       process.exit(ExitCode.FatalError);
     }
     if (!await makePolicy(options)) {
@@ -307,8 +324,8 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a resource name.");
-      log.info("Example: buddy make:resource UserResource");
+      console.error("You need to specify a resource name.");
+      console.error("Example: buddy make:resource UserResource");
       process.exit(ExitCode.FatalError);
     }
     if (!await makeResource(options)) {
@@ -324,7 +341,7 @@ export function make(buddy) {
     });
     process.exit(ExitCode.Success);
   });
-  buddy.command("make:queue-table", descriptions.migration).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
+  buddy.command("make:queue-table", descriptions.queueTable).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
     log.debug("Running `buddy make queue:table` ...", options);
     await makeQueueTable();
   });
@@ -333,7 +350,7 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a name. Read more about the documentation here.");
+      console.error("You need to specify a name. Read more about the documentation here.");
       process.exit(ExitCode.FatalError);
     }
     await makeStack(options);
@@ -343,7 +360,7 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a name. Read more about the documentation here.");
+      console.error("You need to specify a name. Read more about the documentation here.");
       process.exit(ExitCode.FatalError);
     }
     await makePage(options);
@@ -354,8 +371,8 @@ export function make(buddy) {
     name = name ?? options.name;
     options.name = name;
     if (!name) {
-      log.error("You need to specify a job name.");
-      log.info("Example: buddy make:job SendWelcomeEmail");
+      console.error("You need to specify a job name.");
+      console.error("Example: buddy make:job SendWelcomeEmail");
       process.exit(ExitCode.FatalError);
     }
     if (!await makeJob(options)) {

package/dist/commands/migrate.js

@@ -181,6 +181,7 @@ function currentDatabaseLabel() {
 export function migrate(buddy) {
   const descriptions = {
     migrate: "Migrates your database",
+    fresh: "Drop all tables and re-run every migration (destroys all data)",
     project: "Target a specific project",
     verbose: "Enable verbose output",
     auth: "Also migrate auth tables (oauth_clients, oauth_access_tokens, oauth_refresh_tokens, password_resets)",
@@ -291,7 +292,7 @@ export function migrate(buddy) {
     });
     process.exit(ExitCode.Success);
   });
-  buddy.command("migrate:fresh", descriptions.migrate).alias("db:fresh").option("-d, --diff", "Show the SQL that would be run", { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("-s, --seed", "Run database seeders after migration", { default: !1 }).option("-a, --auth", descriptions.auth, { default: !0 }).option("--no-auth", "Skip auth/oauth table migrations").option("-f, --force", 'Skip the drop-database confirmation (only honored when the migrateFresh guard is "allow")', { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
+  buddy.command("migrate:fresh", descriptions.fresh).alias("db:fresh").option("-d, --diff", "Show the SQL that would be run", { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("-s, --seed", "Run database seeders after migration", { default: !1 }).option("-a, --auth", descriptions.auth, { default: !0 }).option("--no-auth", "Skip auth/oauth table migrations").option("-f, --force", 'Skip the drop-database confirmation (only honored when the migrateFresh guard is "allow")', { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
     log.debug("Running `buddy migrate:fresh` ...", options);
     const perf = await intro("buddy migrate:fresh"), validation = validateModelsExist();
     if (!validation.valid) {

package/dist/commands/setup.d.ts

@@ -2,6 +2,7 @@ import type { CLI, CliOptions } from '@stacksjs/types';
 export declare function setup(buddy: CLI): void;
 export declare function ensurePantryInstalled(): Promise<void>;
 export declare function ensurePantryDependencies(cwd: string): Promise<void>;
+export declare function ensureNodeDependencies(cwd: string): Promise<void>;
 export declare function ensureAppKey(cwd: string): Promise<void>;
 export declare function pantryDatabasePackage(connection: string): DatabasePackage | undefined;
 /**