@stacksjs/buddy 0.70.257 → 0.70.259

package/dist/commands/completion.js

@@ -1,33 +1,4 @@
-import process from "node:process";
-import { log, onUnknownSubcommand } from "@stacksjs/cli";
-export function completion(buddy) {
-  const descriptions = {
-    completion: "Generate shell completion scripts",
-    shell: "Shell type (bash, zsh, fish)"
-  };
-  buddy.command("completion [shell]", descriptions.completion).option("-s, --shell [shell]", descriptions.shell).example("buddy completion bash").example("buddy completion zsh").example("buddy completion fish").example("buddy completion bash > /usr/local/etc/bash_completion.d/buddy").action(async (shell, options) => {
-    log.debug("Running `buddy completion` ...", options);
-    const targetShell = shell || options.shell || "bash", commandNames = (buddy.commands || []).map((cmd) => cmd.name).filter((name) => Boolean(name));
-    switch (targetShell) {
-      case "bash":
-        console.log(generateBashCompletion(commandNames));
-        break;
-      case "zsh":
-        console.log(generateZshCompletion(commandNames));
-        break;
-      case "fish":
-        console.log(generateFishCompletion(commandNames));
-        break;
-      default:
-        console.error(`Unknown shell: ${targetShell}`);
-        console.error("Supported shells: bash, zsh, fish");
-        process.exit(1);
-    }
-  });
-  onUnknownSubcommand(buddy, "completion");
-}
-function generateBashCompletion(commands) {
-  return `# buddy completion for bash
+import process from"node:process";import{log,onUnknownSubcommand}from"@stacksjs/cli";export function completion(buddy){const descriptions={completion:"Generate shell completion scripts",shell:"Shell type (bash, zsh, fish)"};buddy.command("completion [shell]",descriptions.completion).option("-s, --shell [shell]",descriptions.shell).example("buddy completion bash").example("buddy completion zsh").example("buddy completion fish").example("buddy completion bash > /usr/local/etc/bash_completion.d/buddy").action(async(shell,options)=>{log.debug("Running `buddy completion` ...",options);const targetShell=shell||options.shell||"bash",commandNames=(buddy.commands||[]).map((cmd)=>cmd.name).filter((name)=>Boolean(name));switch(targetShell){case"bash":console.log(generateBashCompletion(commandNames));break;case"zsh":console.log(generateZshCompletion(commandNames));break;case"fish":console.log(generateFishCompletion(commandNames));break;default:console.error(`Unknown shell: ${targetShell}`);console.error("Supported shells: bash, zsh, fish");process.exit(1)}});onUnknownSubcommand(buddy,"completion")}function generateBashCompletion(commands){return`# buddy completion for bash
 
 _buddy_completion() {
     local cur prev commands
@@ -60,17 +31,14 @@ complete -F _buddy_completion buddy
 # - macOS: /usr/local/etc/bash_completion.d/buddy
 #
 # Then reload your shell or run: source ~/.bashrc
-`;
-}
-function generateZshCompletion(commands) {
-  return `#compdef buddy
+`}function generateZshCompletion(commands){return`#compdef buddy
 
 # buddy completion for zsh
 
 _buddy() {
     local -a commands
     commands=(
-${commands.map((cmd) => `    '${cmd}:${cmd} command'`).join(`
+${commands.map((cmd)=>`    '${cmd}:${cmd} command'`).join(`
 `)}
     )
 
@@ -111,16 +79,13 @@ _buddy "$@"
 # Then add to your ~/.zshrc:
 # fpath=(~/.zsh/completions $fpath)
 # autoload -Uz compinit && compinit
-`;
-}
-function generateFishCompletion(commands) {
-  return `# buddy completion for fish
+`}function generateFishCompletion(commands){return`# buddy completion for fish
 
 # Remove old completions
 complete -c buddy -e
 
 # Command completions
-${commands.map((cmd) => `complete -c buddy -n "__fish_use_subcommand" -a "${cmd}" -d "${cmd} command"`).join(`
+${commands.map((cmd)=>`complete -c buddy -n "__fish_use_subcommand" -a "${cmd}" -d "${cmd} command"`).join(`
 `)}
 
 # Global flag completions
@@ -139,5 +104,4 @@ complete -c buddy -s f -l force -d "Skip confirmation prompts"
 # ~/.config/fish/completions/buddy.fish
 #
 # Fish will automatically load it on startup
-`;
-}
+`}

package/dist/commands/config-migrate.js

@@ -1,94 +1,6 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import process from "node:process";
-import { italic, log } from "@stacksjs/cli";
-import { projectPath } from "@stacksjs/path";
-const CODEMODS = [
-  {
-    id: "0.65-cache-driver-rename",
-    description: "Rename `cache.driver` to `cache.default` (introduced in 0.65).",
-    files: ["cache.ts"],
-    shouldApply: (c) => /\bdriver\s*:/.test(c) && !c.includes("default:"),
-    apply: (c) => c.replace(/(\bcache\b[\s\S]*?)\bdriver(\s*:)/m, "$1default$2")
-  },
-  {
-    id: "0.68-search-engine-name",
-    description: "Rename `searchEngine.driver` to `searchEngine.default` (matches other configs).",
-    files: ["search-engine.ts"],
-    shouldApply: (c) => /\bdriver\s*:/.test(c),
-    apply: (c) => c.replace(/\bdriver(\s*:)/g, "default$1")
-  },
-  {
-    id: "0.70-ports-string-to-number",
-    description: 'Convert string port values like `"3000"` to numbers (TypeScript types now require number).',
-    files: ["ports.ts"],
-    shouldApply: (c) => /:\s*['"]\d+['"]/.test(c),
-    apply: (c) => c.replace(/:\s*['"](\d+)['"]/g, ": $1")
-  }
-];
-export async function runConfigMigrations(opts) {
-  const changed = [], skipped = [], codemods = opts.only ? CODEMODS.filter((m) => m.id === opts.only) : CODEMODS;
-  if (codemods.length === 0) {
-    log.warn(`No matching codemods. Available: ${CODEMODS.map((m) => m.id).join(", ")}`);
-    return { changed, skipped };
-  }
-  for (const cm of codemods) {
-    log.info(`Codemod ${italic(cm.id)} \u2014 ${cm.description}`);
-    for (const rel of cm.files) {
-      const full = projectPath(`config/${rel}`);
-      if (!existsSync(full)) {
-        skipped.push(`${full} (missing)`);
-        continue;
-      }
-      const before = readFileSync(full, "utf-8");
-      if (!cm.shouldApply(before)) {
-        skipped.push(`${full} (no changes)`);
-        continue;
-      }
-      const after = cm.apply(before);
-      if (after === before) {
-        skipped.push(`${full} (no changes)`);
-        continue;
-      }
-      if (opts.dryRun) {
-        log.info(`[dry-run] would update ${full}`);
-        printDiff(before, after);
-      } else {
-        writeFileSync(full, after);
-        log.success(`updated ${full}`);
-      }
-      changed.push(full);
-    }
-  }
-  return { changed, skipped };
-}
-function printDiff(before, after) {
-  const beforeLines = before.split(`
-`), afterLines = after.split(`
-`), max = Math.max(beforeLines.length, afterLines.length);
-  for (let i = 0;i < max; i++) {
-    const b = beforeLines[i], a = afterLines[i];
-    if (b === a)
-      continue;
-    if (b !== void 0)
-      process.stdout.write(`  - ${b}
-`);
-    if (a !== void 0)
-      process.stdout.write(`  + ${a}
-`);
-  }
-  process.stdout.write(`
-`);
-}
-export function configMigrate(buddy) {
-  buddy.command("config:migrate", "Apply config-shape codemods for the latest Stacks version").option("--dry-run", "Preview changes without writing", { default: !1 }).option("--only [id]", "Run a single codemod by id", { default: "" }).action(async (options) => {
-    log.info("Running `buddy config:migrate` ...");
-    const { changed, skipped } = await runConfigMigrations({
-      dryRun: Boolean(options.dryRun),
-      only: options.only?.length ? options.only : void 0
-    });
-    log.info(`Changed: ${changed.length}, Skipped: ${skipped.length}`);
-    if (skipped.length > 0)
-      for (const s of skipped)
-        log.debug(`  skipped: ${s}`);
-  });
-}
+import{existsSync,readFileSync,writeFileSync}from"node:fs";import process from"node:process";import{italic,log}from"@stacksjs/cli";import{projectPath}from"@stacksjs/path";const CODEMODS=[{id:"0.65-cache-driver-rename",description:"Rename `cache.driver` to `cache.default` (introduced in 0.65).",files:["cache.ts"],shouldApply:(c)=>/\bdriver\s*:/.test(c)&&!c.includes("default:"),apply:(c)=>c.replace(/(\bcache\b[\s\S]*?)\bdriver(\s*:)/m,"$1default$2")},{id:"0.68-search-engine-name",description:"Rename `searchEngine.driver` to `searchEngine.default` (matches other configs).",files:["search-engine.ts"],shouldApply:(c)=>/\bdriver\s*:/.test(c),apply:(c)=>c.replace(/\bdriver(\s*:)/g,"default$1")},{id:"0.70-ports-string-to-number",description:'Convert string port values like `"3000"` to numbers (TypeScript types now require number).',files:["ports.ts"],shouldApply:(c)=>/:\s*['"]\d+['"]/.test(c),apply:(c)=>c.replace(/:\s*['"](\d+)['"]/g,": $1")}];export async function runConfigMigrations(opts){const changed=[],skipped=[],codemods=opts.only?CODEMODS.filter((m)=>m.id===opts.only):CODEMODS;if(codemods.length===0){log.warn(`No matching codemods. Available: ${CODEMODS.map((m)=>m.id).join(", ")}`);return{changed,skipped}}for(const cm of codemods){log.info(`Codemod ${italic(cm.id)} \u2014 ${cm.description}`);for(const rel of cm.files){const full=projectPath(`config/${rel}`);if(!existsSync(full)){skipped.push(`${full} (missing)`);continue}const before=readFileSync(full,"utf-8");if(!cm.shouldApply(before)){skipped.push(`${full} (no changes)`);continue}const after=cm.apply(before);if(after===before){skipped.push(`${full} (no changes)`);continue}if(opts.dryRun){log.info(`[dry-run] would update ${full}`);printDiff(before,after)}else{writeFileSync(full,after);log.success(`updated ${full}`)}changed.push(full)}}return{changed,skipped}}function printDiff(before,after){const beforeLines=before.split(`
+`),afterLines=after.split(`
+`),max=Math.max(beforeLines.length,afterLines.length);for(let i=0;i<max;i++){const b=beforeLines[i],a=afterLines[i];if(b===a)continue;if(b!==void 0)process.stdout.write(`  - ${b}
+`);if(a!==void 0)process.stdout.write(`  + ${a}
+`)}process.stdout.write(`
+`)}export function configMigrate(buddy){buddy.command("config:migrate","Apply config-shape codemods for the latest Stacks version").option("--dry-run","Preview changes without writing",{default:!1}).option("--only [id]","Run a single codemod by id",{default:""}).action(async(options)=>{log.info("Running `buddy config:migrate` ...");const{changed,skipped}=await runConfigMigrations({dryRun:Boolean(options.dryRun),only:options.only?.length?options.only:void 0});log.info(`Changed: ${changed.length}, Skipped: ${skipped.length}`);if(skipped.length>0)for(const s of skipped)log.debug(`  skipped: ${s}`)})}

package/dist/commands/configure.js

@@ -1,48 +1,5 @@
-import process from "node:process";
-import { log, onUnknownSubcommand, outro, runCommand } from "@stacksjs/cli";
-import { path as p } from "@stacksjs/path";
-import { ExitCode } from "@stacksjs/types";
-export function configure(buddy) {
-  const descriptions = {
-    configure: "Configure options",
-    aws: "Configure the AWS connection",
-    project: "Target a specific project",
-    profile: "The AWS profile to use",
-    verbose: "Enable verbose output"
-  };
-  buddy.command("configure", descriptions.configure).option("--aws", descriptions.aws, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    log.debug("Running `buddy configure` ...", options);
-    if (options?.aws) {
-      await configureAws(options);
-      process.exit(ExitCode.Success);
-    }
-    log.info("Not implemented yet. Please use the --aws flag to configure AWS.");
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("configure:aws", descriptions.aws).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--profile", descriptions.profile, {
-    default: process.env.AWS_PROFILE
-  }).option("--verbose", descriptions.verbose, { default: !1 }).option("--access-key-id", "The AWS access key").option("--secret-access-key", "The AWS secret access key").option("--region", "The AWS region").option("--output", "The AWS output format").option("--quiet", "Suppress output").action(async (options) => {
-    log.debug("Running `buddy configure:aws` ...", options);
-    await configureAws(options);
-    process.exit(ExitCode.Success);
-  });
-  onUnknownSubcommand(buddy, "configure");
-}
-async function configureAws(options) {
-  const startTime = performance.now(), awsAccessKeyId = options?.accessKeyId ?? process.env.AWS_ACCESS_KEY_ID, awsSecretAccessKey = options?.secretAccessKey ?? process.env.AWS_SECRET_ACCESS_KEY, defaultRegion = "us-east-1", defaultOutputFormat = options?.output ?? "json", profile = process.env.AWS_PROFILE ?? options?.profile, command = profile ? `aws configure --profile ${profile}` : "aws configure", input = `${awsAccessKeyId}
+import process from"node:process";import{log,onUnknownSubcommand,outro,runCommand}from"@stacksjs/cli";import{path as p}from"@stacksjs/path";import{ExitCode}from"@stacksjs/types";export function configure(buddy){const descriptions={configure:"Configure options",aws:"Configure the AWS connection",project:"Target a specific project",profile:"The AWS profile to use",verbose:"Enable verbose output"};buddy.command("configure",descriptions.configure).option("--aws",descriptions.aws,{default:!1}).option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{log.debug("Running `buddy configure` ...",options);if(options?.aws){await configureAws(options);process.exit(ExitCode.Success)}log.info("Not implemented yet. Please use the --aws flag to configure AWS.");process.exit(ExitCode.Success)});buddy.command("configure:aws",descriptions.aws).option("-p, --project [project]",descriptions.project,{default:!1}).option("--profile",descriptions.profile,{default:process.env.AWS_PROFILE}).option("--verbose",descriptions.verbose,{default:!1}).option("--access-key-id","The AWS access key").option("--secret-access-key","The AWS secret access key").option("--region","The AWS region").option("--output","The AWS output format").option("--quiet","Suppress output").action(async(options)=>{log.debug("Running `buddy configure:aws` ...",options);await configureAws(options);process.exit(ExitCode.Success)});onUnknownSubcommand(buddy,"configure")}async function configureAws(options){const startTime=performance.now(),awsAccessKeyId=options?.accessKeyId??process.env.AWS_ACCESS_KEY_ID,awsSecretAccessKey=options?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY,defaultRegion="us-east-1",defaultOutputFormat=options?.output??"json",profile=process.env.AWS_PROFILE??options?.profile,command=profile?`aws configure --profile ${profile}`:"aws configure",input=`${awsAccessKeyId}
 ${awsSecretAccessKey}
 ${defaultRegion}
 ${defaultOutputFormat}
-`, result = await runCommand(command, {
-    cwd: p.projectPath(),
-    stdin: "pipe",
-    input
-  });
-  if (result.isErr) {
-    await outro("While running the cloud command, there was an issue", { startTime, useSeconds: !0 }, result.error);
-    process.exit(ExitCode.FatalError);
-  }
-  if (options?.quiet)
-    return;
-  await outro("Exited", { startTime, useSeconds: !0 });
-}
+`,result=await runCommand(command,{cwd:p.projectPath(),stdin:"pipe",input});if(result.isErr){await outro("While running the cloud command, there was an issue",{startTime,useSeconds:!0},result.error);process.exit(ExitCode.FatalError)}if(options?.quiet)return;await outro("Exited",{startTime,useSeconds:!0})}

package/dist/commands/create.js

@@ -1,162 +1 @@
-import { chmodSync, existsSync, readdirSync } from "node:fs";
-import process from "node:process";
-import { runAction } from "@stacksjs/actions";
-import { bold, cyan, dim, intro, log, onUnknownSubcommand, runCommand } from "@stacksjs/cli";
-import { Action } from "@stacksjs/enums";
-import { resolve } from "@stacksjs/path";
-import { isFolder } from "@stacksjs/storage";
-import { ExitCode } from "@stacksjs/types";
-import { uninstallAllFeatures } from "./features";
-import { ensurePantryDependencies, ensurePantryInstalled } from "./setup";
-export function create(buddy) {
-  const descriptions = {
-    name: "The name of the project",
-    command: "Create a new Stacks project",
-    ui: "Are you building a UI?",
-    components: "Are you building UI components?",
-    webComponents: "Automagically built optimized custom elements/web components?",
-    views: "How about views?",
-    functions: "Are you developing functions/composables?",
-    api: "Are you building an API?",
-    database: "Do you need a database?",
-    notifications: "Do you need notifications? e.g. email, SMS, push or chat notifications",
-    cache: "Do you need caching?",
-    email: "Do you need email?",
-    project: "Target a specific project",
-    minimal: "Skip optional feature bundles (cms, commerce, dashboard, marketing, monitoring, realtime, queue) \u2014 bare-bones API/SPA starter that can re-add them later via `./buddy <feature>:install`.",
-    withCore: "Keep the framework vendored in `storage/framework/core` as a Bun workspace, for working ON Stacks. Apps that only work WITH Stacks want the default, which resolves every @stacksjs/* package from npm.",
-    verbose: "Enable verbose output"
-  };
-  buddy.command("new [name]", descriptions.command).alias("create [name]").option("-n, --name [name]", descriptions.name, { default: !1 }).option("-u, --ui", descriptions.ui, { default: !0 }).option("-c, --components", descriptions.components, { default: !0 }).option("-w, --web-components", descriptions.webComponents, { default: !0 }).option("-p, --views", descriptions.views, { default: !0 }).option("-f, --functions", descriptions.functions, { default: !0 }).option("-a, --api", descriptions.api, { default: !0 }).option("-d, --database", descriptions.database, { default: !0 }).option("-ca, --cache", descriptions.cache, { default: !1 }).option("-e, --email", descriptions.email, { default: !1 }).option("-P, --project [project]", descriptions.project, { default: !1 }).option("-m, --minimal", descriptions.minimal, { default: !1 }).option("--with-core", descriptions.withCore, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (name, options) => {
-    log.debug("Running `buddy new <name>` ...", options);
-    const startTime = await intro("buddy new");
-    name = name ?? options.name;
-    const path = resolve(process.cwd(), name);
-    isFolderCheck(path);
-    await onlineCheck();
-    const result = await download(name, path, options);
-    if (result.isErr) {
-      log.error(result.error);
-      process.exit(ExitCode.FatalError);
-    }
-    ensureExecutableScripts(path);
-    await ensureEnv(path, options);
-    await install(path, options);
-    if (!options.withCore)
-      await unvendorCore(path, options);
-    if (options.minimal)
-      await stripFeatures(path);
-    if (startTime) {
-      const time = performance.now() - startTime;
-      log.success(dim(`[${time.toFixed(2)}ms] Completed`));
-    }
-    log.info(bold("Welcome to the Stacks Framework! \u269B\uFE0F"));
-    log.info(`Get started: ${cyan(`cd ${name}`)} and then ${cyan("./buddy dev")}`);
-    log.info(`Run ${cyan("./buddy doctor")} anytime to check your setup`);
-    log.info("To learn more, visit https://stacksjs.com");
-    process.exit(ExitCode.Success);
-  });
-  onUnknownSubcommand(buddy, "new");
-}
-function isFolderCheck(path) {
-  if (!isFolder(path))
-    return;
-  if (readdirSync(path).filter((entry) => entry !== ".git").length === 0)
-    return;
-  log.error(`Path ${path} already exists`);
-  process.exit(ExitCode.FatalError);
-}
-async function onlineCheck() {
-  if (await isOnline())
-    return;
-  log.info("It appears you are disconnected from the internet.");
-  log.info("Creating a new project requires a brief internet connection to download the template and install dependencies.");
-  process.exit(ExitCode.FatalError);
-}
-async function isOnline() {
-  try {
-    return (await fetch("https://github.com", {
-      method: "HEAD",
-      signal: AbortSignal.timeout(3000)
-    })).ok;
-  } catch {
-    return !1;
-  }
-}
-async function download(name, path, _options) {
-  log.info("Setting up your stack.");
-  try {
-    const { downloadTemplate } = await import("@stacksjs/gitit");
-    await downloadTemplate("gh:stacksjs/stacks", { dir: name, force: !0 });
-    log.success(`Successfully scaffolded your project at ${cyan(path)}`);
-    return { isErr: !1 };
-  } catch (error) {
-    return { isErr: !0, error: error instanceof Error ? error.message : String(error) };
-  }
-}
-function ensureExecutableScripts(path) {
-  for (const script of ["buddy", "bootstrap"])
-    try {
-      chmodSync(resolve(path, script), 493);
-    } catch {}
-}
-async function ensureEnv(path, _options) {
-  log.info("Ensuring your environment is ready...");
-  await ensurePantryInstalled();
-  await ensurePantryDependencies(path);
-  log.success("Environment is ready");
-}
-async function install(path, options) {
-  log.info("Installing & setting up Stacks");
-  log.info("Copying .env.example \u2192 .env");
-  let result = await runCommand("cp .env.example .env", { ...options, cwd: path });
-  if (result?.isErr) {
-    log.error(result.error);
-    process.exit(ExitCode.FatalError);
-  }
-  log.info("Removing template-encrypted env files...");
-  const { rm } = await import("node:fs/promises");
-  for (const stale of [".env.development", ".env.staging", ".env.production", ".env.keys"])
-    await rm(`${path}/${stale}`, { force: !0 });
-  log.info("Generating application key...");
-  const keyResult = await runAction(Action.KeyGenerate, { ...options, cwd: path });
-  if (keyResult.isErr) {
-    log.error(keyResult.error);
-    process.exit(ExitCode.FatalError);
-  }
-  if (existsSync(resolve(path, ".git")))
-    log.info("Existing git repository detected, skipping git init");
-  else {
-    log.info("Initializing git repository...");
-    result = await runCommand("git init", { ...options, cwd: path });
-    if (result.isErr) {
-      log.error(result.error);
-      process.exit(ExitCode.FatalError);
-    }
-  }
-  log.success("Installed & set-up \uD83D\uDE80");
-}
-async function unvendorCore(path, options) {
-  log.info("Resolving the framework from npm (pass --with-core to keep it vendored)...");
-  const result = await runCommand("./buddy unpublish:core --all --force", { ...options, cwd: path });
-  if (result.isErr) {
-    log.error(result.error);
-    process.exit(ExitCode.FatalError);
-  }
-  log.success("Framework resolved from npm");
-}
-async function stripFeatures(path) {
-  log.info("Stripping optional feature bundles (--minimal)...");
-  const results = await uninstallAllFeatures({ root: path });
-  let strippedAny = !1;
-  for (const { feature, configOutcome, filesRemoved } of results)
-    if (configOutcome === "flipped" || filesRemoved.length > 0) {
-      strippedAny = !0;
-      const fileSummary = filesRemoved.length > 0 ? ` (${filesRemoved.length} path${filesRemoved.length === 1 ? "" : "s"})` : "";
-      log.info(`  - ${feature}${fileSummary}`);
-    }
-  if (!strippedAny)
-    log.info("  \u2192 no feature scaffolding present; nothing to strip.");
-  else
-    log.success("Minimal skeleton ready \u2014 run `./buddy <feature>:install` to add features back.");
-}
+import{chmodSync,existsSync,readdirSync}from"node:fs";import process from"node:process";import{runAction}from"@stacksjs/actions";import{bold,cyan,dim,intro,log,onUnknownSubcommand,runCommand}from"@stacksjs/cli";import{Action}from"@stacksjs/enums";import{resolve}from"@stacksjs/path";import{isFolder}from"@stacksjs/storage";import{ExitCode}from"@stacksjs/types";import{uninstallAllFeatures}from"./features";import{ensurePantryDependencies,ensurePantryInstalled}from"./setup";export function create(buddy){const descriptions={name:"The name of the project",command:"Create a new Stacks project",ui:"Are you building a UI?",components:"Are you building UI components?",webComponents:"Automagically built optimized custom elements/web components?",views:"How about views?",functions:"Are you developing functions/composables?",api:"Are you building an API?",database:"Do you need a database?",notifications:"Do you need notifications? e.g. email, SMS, push or chat notifications",cache:"Do you need caching?",email:"Do you need email?",project:"Target a specific project",minimal:"Skip optional feature bundles (cms, commerce, dashboard, marketing, monitoring, realtime, queue) \u2014 bare-bones API/SPA starter that can re-add them later via `./buddy <feature>:install`.",withCore:"Keep the framework vendored in `storage/framework/core` as a Bun workspace, for working ON Stacks. Apps that only work WITH Stacks want the default, which resolves every @stacksjs/* package from npm.",verbose:"Enable verbose output"};buddy.command("new [name]",descriptions.command).alias("create [name]").option("-n, --name [name]",descriptions.name,{default:!1}).option("-u, --ui",descriptions.ui,{default:!0}).option("-c, --components",descriptions.components,{default:!0}).option("-w, --web-components",descriptions.webComponents,{default:!0}).option("-p, --views",descriptions.views,{default:!0}).option("-f, --functions",descriptions.functions,{default:!0}).option("-a, --api",descriptions.api,{default:!0}).option("-d, --database",descriptions.database,{default:!0}).option("-ca, --cache",descriptions.cache,{default:!1}).option("-e, --email",descriptions.email,{default:!1}).option("-P, --project [project]",descriptions.project,{default:!1}).option("-m, --minimal",descriptions.minimal,{default:!1}).option("--with-core",descriptions.withCore,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(name,options)=>{log.debug("Running `buddy new <name>` ...",options);const startTime=await intro("buddy new");name=name??options.name;const path=resolve(process.cwd(),name);isFolderCheck(path);await onlineCheck();const result=await download(name,path,options);if(result.isErr){log.error(result.error);process.exit(ExitCode.FatalError)}ensureExecutableScripts(path);await ensureEnv(path,options);await install(path,options);if(!options.withCore)await unvendorCore(path,options);if(options.minimal)await stripFeatures(path);if(startTime){const time=performance.now()-startTime;log.success(dim(`[${time.toFixed(2)}ms] Completed`))}log.info(bold("Welcome to the Stacks Framework! \u269B\uFE0F"));log.info(`Get started: ${cyan(`cd ${name}`)} and then ${cyan("./buddy dev")}`);log.info(`Run ${cyan("./buddy doctor")} anytime to check your setup`);log.info("To learn more, visit https://stacksjs.com");process.exit(ExitCode.Success)});onUnknownSubcommand(buddy,"new")}function isFolderCheck(path){if(!isFolder(path))return;if(readdirSync(path).filter((entry)=>entry!==".git").length===0)return;log.error(`Path ${path} already exists`);process.exit(ExitCode.FatalError)}async function onlineCheck(){if(await isOnline())return;log.info("It appears you are disconnected from the internet.");log.info("Creating a new project requires a brief internet connection to download the template and install dependencies.");process.exit(ExitCode.FatalError)}async function isOnline(){try{return(await fetch("https://github.com",{method:"HEAD",signal:AbortSignal.timeout(3000)})).ok}catch{return!1}}async function download(name,path,_options){log.info("Setting up your stack.");try{const{downloadTemplate}=await import("@stacksjs/gitit");await downloadTemplate("gh:stacksjs/stacks",{dir:name,force:!0});log.success(`Successfully scaffolded your project at ${cyan(path)}`);return{isErr:!1}}catch(error){return{isErr:!0,error:error instanceof Error?error.message:String(error)}}}function ensureExecutableScripts(path){for(const script of["buddy","bootstrap"])try{chmodSync(resolve(path,script),493)}catch{}}async function ensureEnv(path,_options){log.info("Ensuring your environment is ready...");await ensurePantryInstalled();await ensurePantryDependencies(path);log.success("Environment is ready")}async function install(path,options){log.info("Installing & setting up Stacks");log.info("Copying .env.example \u2192 .env");let result=await runCommand("cp .env.example .env",{...options,cwd:path});if(result?.isErr){log.error(result.error);process.exit(ExitCode.FatalError)}log.info("Removing template-encrypted env files...");const{rm}=await import("node:fs/promises");for(const stale of[".env.development",".env.staging",".env.production",".env.keys"])await rm(`${path}/${stale}`,{force:!0});log.info("Generating application key...");const keyResult=await runAction(Action.KeyGenerate,{...options,cwd:path});if(keyResult.isErr){log.error(keyResult.error);process.exit(ExitCode.FatalError)}if(existsSync(resolve(path,".git")))log.info("Existing git repository detected, skipping git init");else{log.info("Initializing git repository...");result=await runCommand("git init",{...options,cwd:path});if(result.isErr){log.error(result.error);process.exit(ExitCode.FatalError)}}log.success("Installed & set-up \uD83D\uDE80")}async function unvendorCore(path,options){log.info("Resolving the framework from npm (pass --with-core to keep it vendored)...");const result=await runCommand("./buddy unpublish:core --all --force",{...options,cwd:path});if(result.isErr){log.error(result.error);process.exit(ExitCode.FatalError)}log.success("Framework resolved from npm")}async function stripFeatures(path){log.info("Stripping optional feature bundles (--minimal)...");const results=await uninstallAllFeatures({root:path});let strippedAny=!1;for(const{feature,configOutcome,filesRemoved}of results)if(configOutcome==="flipped"||filesRemoved.length>0){strippedAny=!0;const fileSummary=filesRemoved.length>0?` (${filesRemoved.length} path${filesRemoved.length===1?"":"s"})`:"";log.info(`  - ${feature}${fileSummary}`)}if(!strippedAny)log.info("  \u2192 no feature scaffolding present; nothing to strip.");else log.success("Minimal skeleton ready \u2014 run `./buddy <feature>:install` to add features back.")}

package/dist/commands/deploy.d.ts

@@ -122,10 +122,16 @@ export declare function applyPersistentStatePaths(sites: Record<string, any>, sl
  */
 export declare function applyEnvironmentToSites(sites: Record<string, any>, environment: string, config: any): Record<string, any>;
 /**
- * Load the ts-cloud driver used by Buddy. Published installs use the declared
- * package dependency. Framework and ts-cloud development can point at a built
- * local module with TS_CLOUD_MODULE, avoiding stale nested dependency copies
- * while still exercising the exact Buddy deploy path.
+ * Resolve the app's direct ts-cloud dependency before Buddy's own dependency.
+ * Package managers may retain a stale nested copy below Buddy even after the
+ * app explicitly updates ts-cloud; resolving from the project manifest keeps
+ * the deploy engine selected by the application authoritative.
+ */
+export declare function resolveProjectTsCloudModule(projectRoot?: unknown): string | undefined;
+/**
+ * Load the ts-cloud driver used by Buddy. An explicit TS_CLOUD_MODULE remains
+ * available for framework development; published apps otherwise use their
+ * direct dependency before falling back to Buddy's declared dependency.
  */
 export declare function loadTsCloudDeployApi(): Promise<typeof import('@stacksjs/ts-cloud')>;
 /**