create-better-t-stack 3.7.3-canary.8e4d5716 → 3.7.3-canary.98ba1e7a

package/src/utils/config-validation.ts

@@ -1,470 +0,0 @@
-import type { CLIInput, Database, DatabaseSetup, ProjectConfig, Runtime } from "../types";
-import {
-  ensureSingleWebAndNative,
-  isWebFrontend,
-  validateAddonsAgainstFrontends,
-  validateApiFrontendCompatibility,
-  validateExamplesCompatibility,
-  validatePaymentsCompatibility,
-  validateSelfBackendCompatibility,
-  validateServerDeployRequiresBackend,
-  validateWebDeployRequiresWebFrontend,
-  validateWorkersCompatibility,
-} from "./compatibility-rules";
-import { exitWithError } from "./errors";
-
-export function validateDatabaseOrmAuth(cfg: Partial<ProjectConfig>, flags?: Set<string>) {
-  const db = cfg.database;
-  const orm = cfg.orm;
-  const has = (k: string) => (flags ? flags.has(k) : true);
-
-  if (has("orm") && has("database") && orm === "mongoose" && db !== "mongodb") {
-    exitWithError(
-      "Mongoose ORM requires MongoDB database. Please use '--database mongodb' or choose a different ORM.",
-    );
-  }
-
-  if (has("orm") && has("database") && orm === "drizzle" && db === "mongodb") {
-    exitWithError(
-      "Drizzle ORM does not support MongoDB. Please use '--orm mongoose' or '--orm prisma' or choose a different database.",
-    );
-  }
-
-  if (
-    has("database") &&
-    has("orm") &&
-    db === "mongodb" &&
-    orm &&
-    orm !== "mongoose" &&
-    orm !== "prisma" &&
-    orm !== "none"
-  ) {
-    exitWithError(
-      "MongoDB database requires Mongoose or Prisma ORM. Please use '--orm mongoose' or '--orm prisma' or choose a different database.",
-    );
-  }
-
-  if (has("database") && has("orm") && db && db !== "none" && orm === "none") {
-    exitWithError(
-      "Database selection requires an ORM. Please choose '--orm drizzle', '--orm prisma', or '--orm mongoose'.",
-    );
-  }
-
-  if (has("orm") && has("database") && orm && orm !== "none" && db === "none") {
-    exitWithError(
-      "ORM selection requires a database. Please choose a database or set '--orm none'.",
-    );
-  }
-}
-
-export function validateDatabaseSetup(config: Partial<ProjectConfig>, providedFlags: Set<string>) {
-  const { dbSetup, database, runtime } = config;
-
-  if (
-    providedFlags.has("dbSetup") &&
-    providedFlags.has("database") &&
-    dbSetup &&
-    dbSetup !== "none" &&
-    database === "none"
-  ) {
-    exitWithError(
-      "Database setup requires a database. Please choose a database or set '--db-setup none'.",
-    );
-  }
-
-  const setupValidations: Record<
-    DatabaseSetup,
-    { database?: Database; runtime?: Runtime; errorMessage: string }
-  > = {
-    turso: {
-      database: "sqlite",
-      errorMessage:
-        "Turso setup requires SQLite database. Please use '--database sqlite' or choose a different setup.",
-    },
-    neon: {
-      database: "postgres",
-      errorMessage:
-        "Neon setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.",
-    },
-    "prisma-postgres": {
-      database: "postgres",
-      errorMessage:
-        "Prisma PostgreSQL setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.",
-    },
-    planetscale: {
-      errorMessage:
-        "PlanetScale setup requires PostgreSQL or MySQL database. Please use '--database postgres' or '--database mysql' or choose a different setup.",
-    },
-    "mongodb-atlas": {
-      database: "mongodb",
-      errorMessage:
-        "MongoDB Atlas setup requires MongoDB database. Please use '--database mongodb' or choose a different setup.",
-    },
-    supabase: {
-      database: "postgres",
-      errorMessage:
-        "Supabase setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.",
-    },
-    d1: {
-      database: "sqlite",
-      runtime: "workers",
-      errorMessage: "Cloudflare D1 setup requires SQLite database and Cloudflare Workers runtime.",
-    },
-    docker: {
-      errorMessage:
-        "Docker setup is not compatible with SQLite database or Cloudflare Workers runtime.",
-    },
-    none: { errorMessage: "" },
-  };
-
-  if (dbSetup && dbSetup !== "none") {
-    const validation = setupValidations[dbSetup];
-
-    if (dbSetup === "planetscale") {
-      if (database !== "postgres" && database !== "mysql") {
-        exitWithError(validation.errorMessage);
-      }
-    } else {
-      if (validation.database && database !== validation.database) {
-        exitWithError(validation.errorMessage);
-      }
-    }
-
-    if (validation.runtime && runtime !== validation.runtime) {
-      exitWithError(validation.errorMessage);
-    }
-
-    if (dbSetup === "docker") {
-      if (database === "sqlite") {
-        exitWithError(
-          "Docker setup is not compatible with SQLite database. SQLite is file-based and doesn't require Docker. Please use '--database postgres', '--database mysql', '--database mongodb', or choose a different setup.",
-        );
-      }
-      if (runtime === "workers") {
-        exitWithError(
-          "Docker setup is not compatible with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.",
-        );
-      }
-    }
-  }
-}
-
-export function validateConvexConstraints(
-  config: Partial<ProjectConfig>,
-  providedFlags: Set<string>,
-) {
-  const { backend } = config;
-
-  if (backend !== "convex") {
-    return;
-  }
-
-  const has = (k: string) => providedFlags.has(k);
-
-  if (has("runtime") && config.runtime !== "none") {
-    exitWithError(
-      "Convex backend requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.",
-    );
-  }
-
-  if (has("database") && config.database !== "none") {
-    exitWithError(
-      "Convex backend requires '--database none'. Please remove the --database flag or set it to 'none'.",
-    );
-  }
-
-  if (has("orm") && config.orm !== "none") {
-    exitWithError(
-      "Convex backend requires '--orm none'. Please remove the --orm flag or set it to 'none'.",
-    );
-  }
-
-  if (has("api") && config.api !== "none") {
-    exitWithError(
-      "Convex backend requires '--api none'. Please remove the --api flag or set it to 'none'.",
-    );
-  }
-
-  if (has("dbSetup") && config.dbSetup !== "none") {
-    exitWithError(
-      "Convex backend requires '--db-setup none'. Please remove the --db-setup flag or set it to 'none'.",
-    );
-  }
-
-  if (has("serverDeploy") && config.serverDeploy !== "none") {
-    exitWithError(
-      "Convex backend requires '--server-deploy none'. Please remove the --server-deploy flag or set it to 'none'.",
-    );
-  }
-
-  if (has("auth") && config.auth === "better-auth") {
-    const supportedFrontends = [
-      "tanstack-router",
-      "tanstack-start",
-      "next",
-      "native-bare",
-      "native-uniwind",
-      "native-unistyles",
-    ];
-    const hasSupportedFrontend = config.frontend?.some((f) => supportedFrontends.includes(f));
-
-    if (!hasSupportedFrontend) {
-      exitWithError(
-        "Better-Auth with Convex backend requires a supported frontend (TanStack Router, TanStack Start, Next.js, or Native).",
-      );
-    }
-  }
-}
-
-export function validateBackendNoneConstraints(
-  config: Partial<ProjectConfig>,
-  providedFlags: Set<string>,
-) {
-  const { backend } = config;
-
-  if (backend !== "none") {
-    return;
-  }
-
-  const has = (k: string) => providedFlags.has(k);
-
-  if (has("runtime") && config.runtime !== "none") {
-    exitWithError(
-      "Backend 'none' requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.",
-    );
-  }
-
-  if (has("database") && config.database !== "none") {
-    exitWithError(
-      "Backend 'none' requires '--database none'. Please remove the --database flag or set it to 'none'.",
-    );
-  }
-
-  if (has("orm") && config.orm !== "none") {
-    exitWithError(
-      "Backend 'none' requires '--orm none'. Please remove the --orm flag or set it to 'none'.",
-    );
-  }
-
-  if (has("api") && config.api !== "none") {
-    exitWithError(
-      "Backend 'none' requires '--api none'. Please remove the --api flag or set it to 'none'.",
-    );
-  }
-
-  if (has("auth") && config.auth !== "none") {
-    exitWithError(
-      "Backend 'none' requires '--auth none'. Please remove the --auth flag or set it to 'none'.",
-    );
-  }
-
-  if (has("payments") && config.payments !== "none") {
-    exitWithError(
-      "Backend 'none' requires '--payments none'. Please remove the --payments flag or set it to 'none'.",
-    );
-  }
-
-  if (has("dbSetup") && config.dbSetup !== "none") {
-    exitWithError(
-      "Backend 'none' requires '--db-setup none'. Please remove the --db-setup flag or set it to 'none'.",
-    );
-  }
-
-  if (has("serverDeploy") && config.serverDeploy !== "none") {
-    exitWithError(
-      "Backend 'none' requires '--server-deploy none'. Please remove the --server-deploy flag or set it to 'none'.",
-    );
-  }
-}
-
-export function validateSelfBackendConstraints(
-  config: Partial<ProjectConfig>,
-  providedFlags: Set<string>,
-) {
-  const { backend } = config;
-
-  if (backend !== "self") {
-    return;
-  }
-
-  const has = (k: string) => providedFlags.has(k);
-
-  if (has("runtime") && config.runtime !== "none") {
-    exitWithError(
-      "Backend 'self' (fullstack) requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.",
-    );
-  }
-}
-
-export function validateBackendConstraints(
-  config: Partial<ProjectConfig>,
-  providedFlags: Set<string>,
-  options: CLIInput,
-) {
-  const { backend } = config;
-
-  if (config.auth === "clerk" && backend !== "convex") {
-    exitWithError(
-      "Clerk authentication is only supported with the Convex backend. Please use '--backend convex' or choose a different auth provider.",
-    );
-  }
-
-  if (backend === "convex" && config.auth === "clerk" && config.frontend) {
-    const incompatibleFrontends = config.frontend.filter((f) =>
-      ["nuxt", "svelte", "solid"].includes(f),
-    );
-    if (incompatibleFrontends.length > 0) {
-      exitWithError(
-        `Clerk authentication is not compatible with the following frontends: ${incompatibleFrontends.join(
-          ", ",
-        )}. Please choose a different frontend or auth provider.`,
-      );
-    }
-  }
-
-  if (
-    providedFlags.has("backend") &&
-    backend &&
-    backend !== "convex" &&
-    backend !== "none" &&
-    backend !== "self"
-  ) {
-    if (providedFlags.has("runtime") && options.runtime === "none") {
-      exitWithError(
-        "'--runtime none' is only supported with '--backend convex', '--backend none', or '--backend self'. Please choose 'bun', 'node', or remove the --runtime flag.",
-      );
-    }
-  }
-
-  if (backend === "convex" && providedFlags.has("frontend") && options.frontend) {
-    const incompatibleFrontends = options.frontend.filter((f) => f === "solid");
-    if (incompatibleFrontends.length > 0) {
-      exitWithError(
-        `The following frontends are not compatible with '--backend convex': ${incompatibleFrontends.join(
-          ", ",
-        )}. Please choose a different frontend or backend.`,
-      );
-    }
-  }
-}
-
-export function validateFrontendConstraints(
-  config: Partial<ProjectConfig>,
-  providedFlags: Set<string>,
-) {
-  const { frontend } = config;
-
-  if (frontend && frontend.length > 0) {
-    ensureSingleWebAndNative(frontend);
-
-    if (providedFlags.has("api") && providedFlags.has("frontend") && config.api) {
-      validateApiFrontendCompatibility(config.api, frontend);
-    }
-  }
-
-  const hasWebFrontendFlag = (frontend ?? []).some((f) => isWebFrontend(f));
-  validateWebDeployRequiresWebFrontend(config.webDeploy, hasWebFrontendFlag);
-}
-
-export function validateApiConstraints(config: Partial<ProjectConfig>, options: CLIInput) {
-  if (config.api === "none") {
-    if (
-      options.examples &&
-      !(options.examples.length === 1 && options.examples[0] === "none") &&
-      options.backend !== "convex" &&
-      options.backend !== "none"
-    ) {
-      exitWithError(
-        "Cannot use '--examples' when '--api' is set to 'none'. Please remove the --examples flag or choose an API type.",
-      );
-    }
-  }
-}
-
-export function validateFullConfig(
-  config: Partial<ProjectConfig>,
-  providedFlags: Set<string>,
-  options: CLIInput,
-) {
-  validateDatabaseOrmAuth(config, providedFlags);
-  validateDatabaseSetup(config, providedFlags);
-
-  validateConvexConstraints(config, providedFlags);
-  validateBackendNoneConstraints(config, providedFlags);
-  validateSelfBackendConstraints(config, providedFlags);
-  validateBackendConstraints(config, providedFlags, options);
-
-  validateFrontendConstraints(config, providedFlags);
-
-  validateApiConstraints(config, options);
-
-  validateServerDeployRequiresBackend(config.serverDeploy, config.backend);
-
-  validateSelfBackendCompatibility(providedFlags, options, config);
-  validateWorkersCompatibility(providedFlags, options, config);
-
-  if (config.runtime === "workers" && config.serverDeploy === "none") {
-    exitWithError(
-      "Cloudflare Workers runtime requires a server deployment. Please choose 'alchemy' for --server-deploy.",
-    );
-  }
-
-  if (
-    providedFlags.has("serverDeploy") &&
-    config.serverDeploy === "alchemy" &&
-    config.runtime !== "workers"
-  ) {
-    exitWithError(
-      `Server deployment '${config.serverDeploy}' requires '--runtime workers'. Please use '--runtime workers' or choose a different server deployment.`,
-    );
-  }
-
-  if (config.addons && config.addons.length > 0) {
-    validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
-    config.addons = [...new Set(config.addons)];
-  }
-
-  validateExamplesCompatibility(
-    config.examples ?? [],
-    config.backend,
-    config.database,
-    config.frontend ?? [],
-  );
-
-  validatePaymentsCompatibility(
-    config.payments,
-    config.auth,
-    config.backend,
-    config.frontend ?? [],
-  );
-}
-
-export function validateConfigForProgrammaticUse(config: Partial<ProjectConfig>) {
-  try {
-    validateDatabaseOrmAuth(config);
-
-    if (config.frontend && config.frontend.length > 0) {
-      ensureSingleWebAndNative(config.frontend);
-    }
-
-    validateApiFrontendCompatibility(config.api, config.frontend);
-
-    validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend);
-
-    if (config.addons && config.addons.length > 0) {
-      validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
-    }
-
-    validateExamplesCompatibility(
-      config.examples ?? [],
-      config.backend,
-      config.database,
-      config.frontend ?? [],
-    );
-  } catch (error) {
-    if (error instanceof Error) {
-      throw error;
-    }
-    throw new Error(String(error));
-  }
-}

package/src/utils/display-config.ts

@@ -1,96 +0,0 @@
-import pc from "picocolors";
-import type { ProjectConfig } from "../types";
-
-export function displayConfig(config: Partial<ProjectConfig>) {
-  const configDisplay: string[] = [];
-
-  if (config.projectName) {
-    configDisplay.push(`${pc.blue("Project Name:")} ${config.projectName}`);
-  }
-
-  if (config.frontend !== undefined) {
-    const frontend = Array.isArray(config.frontend) ? config.frontend : [config.frontend];
-    const frontendText =
-      frontend.length > 0 && frontend[0] !== undefined ? frontend.join(", ") : "none";
-    configDisplay.push(`${pc.blue("Frontend:")} ${frontendText}`);
-  }
-
-  if (config.backend !== undefined) {
-    configDisplay.push(`${pc.blue("Backend:")} ${String(config.backend)}`);
-  }
-
-  if (config.runtime !== undefined) {
-    configDisplay.push(`${pc.blue("Runtime:")} ${String(config.runtime)}`);
-  }
-
-  if (config.api !== undefined) {
-    configDisplay.push(`${pc.blue("API:")} ${String(config.api)}`);
-  }
-
-  if (config.database !== undefined) {
-    configDisplay.push(`${pc.blue("Database:")} ${String(config.database)}`);
-  }
-
-  if (config.orm !== undefined) {
-    configDisplay.push(`${pc.blue("ORM:")} ${String(config.orm)}`);
-  }
-
-  if (config.auth !== undefined) {
-    configDisplay.push(`${pc.blue("Auth:")} ${String(config.auth)}`);
-  }
-
-  if (config.payments !== undefined) {
-    configDisplay.push(`${pc.blue("Payments:")} ${String(config.payments)}`);
-  }
-
-  if (config.addons !== undefined) {
-    const addons = Array.isArray(config.addons) ? config.addons : [config.addons];
-    const addonsText = addons.length > 0 && addons[0] !== undefined ? addons.join(", ") : "none";
-    configDisplay.push(`${pc.blue("Addons:")} ${addonsText}`);
-  }
-
-  if (config.examples !== undefined) {
-    const examples = Array.isArray(config.examples) ? config.examples : [config.examples];
-    const examplesText =
-      examples.length > 0 && examples[0] !== undefined ? examples.join(", ") : "none";
-    configDisplay.push(`${pc.blue("Examples:")} ${examplesText}`);
-  }
-
-  if (config.git !== undefined) {
-    const gitText =
-      typeof config.git === "boolean" ? (config.git ? "Yes" : "No") : String(config.git);
-    configDisplay.push(`${pc.blue("Git Init:")} ${gitText}`);
-  }
-
-  if (config.packageManager !== undefined) {
-    configDisplay.push(`${pc.blue("Package Manager:")} ${String(config.packageManager)}`);
-  }
-
-  if (config.install !== undefined) {
-    const installText =
-      typeof config.install === "boolean"
-        ? config.install
-          ? "Yes"
-          : "No"
-        : String(config.install);
-    configDisplay.push(`${pc.blue("Install Dependencies:")} ${installText}`);
-  }
-
-  if (config.dbSetup !== undefined) {
-    configDisplay.push(`${pc.blue("Database Setup:")} ${String(config.dbSetup)}`);
-  }
-
-  if (config.webDeploy !== undefined) {
-    configDisplay.push(`${pc.blue("Web Deployment:")} ${String(config.webDeploy)}`);
-  }
-
-  if (config.serverDeploy !== undefined) {
-    configDisplay.push(`${pc.blue("Server Deployment:")} ${String(config.serverDeploy)}`);
-  }
-
-  if (configDisplay.length === 0) {
-    return pc.yellow("No configuration selected.");
-  }
-
-  return configDisplay.join("\n");
-}

package/src/utils/docker-utils.ts

@@ -1,70 +0,0 @@
-import os from "node:os";
-import { $ } from "execa";
-import pc from "picocolors";
-import type { Database } from "../types";
-import { commandExists } from "./command-exists";
-
-export async function isDockerInstalled() {
-  return commandExists("docker");
-}
-
-export async function isDockerRunning() {
-  try {
-    await $`docker info`;
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export function getDockerInstallInstructions(platform: string, database: Database) {
-  const isMac = platform === "darwin";
-  const isWindows = platform === "win32";
-  const isLinux = platform === "linux";
-
-  let installUrl = "";
-  let platformName = "";
-
-  if (isMac) {
-    installUrl = "https://docs.docker.com/desktop/setup/install/mac-install/";
-    platformName = "macOS";
-  } else if (isWindows) {
-    installUrl = "https://docs.docker.com/desktop/setup/install/windows-install/";
-    platformName = "Windows";
-  } else if (isLinux) {
-    installUrl = "https://docs.docker.com/desktop/setup/install/linux/";
-    platformName = "Linux";
-  }
-
-  const databaseName =
-    database === "mongodb" ? "MongoDB" : database === "mysql" ? "MySQL" : "PostgreSQL";
-
-  return `${pc.yellow("IMPORTANT:")} Docker required for ${databaseName}. Install for ${platformName}:\n${pc.blue(installUrl)}`;
-}
-
-export async function getDockerStatus(database: Database) {
-  const platform = os.platform();
-  const installed = await isDockerInstalled();
-
-  if (!installed) {
-    return {
-      installed: false,
-      running: false,
-      message: getDockerInstallInstructions(platform, database),
-    };
-  }
-
-  const running = await isDockerRunning();
-  if (!running) {
-    return {
-      installed: true,
-      running: false,
-      message: `${pc.yellow("IMPORTANT:")} Docker is installed but not running.`,
-    };
-  }
-
-  return {
-    installed: true,
-    running: true,
-  };
-}

package/src/utils/errors.ts

@@ -1,32 +0,0 @@
-import { cancel } from "@clack/prompts";
-import consola from "consola";
-import pc from "picocolors";
-
-function isProgrammatic() {
-  return process.env.BTS_PROGRAMMATIC === "1";
-}
-
-export function exitWithError(message: string): never {
-  consola.error(pc.red(message));
-  if (isProgrammatic()) {
-    throw new Error(message);
-  }
-  process.exit(1);
-}
-
-export function exitCancelled(message = "Operation cancelled"): never {
-  cancel(pc.red(message));
-  if (isProgrammatic()) {
-    throw new Error(message);
-  }
-  process.exit(0);
-}
-
-export function handleError(error: unknown, fallbackMessage?: string): never {
-  const message = error instanceof Error ? error.message : fallbackMessage || String(error);
-  consola.error(pc.red(message));
-  if (isProgrammatic()) {
-    throw new Error(message);
-  }
-  process.exit(1);
-}