better-ts-stack 2.0.0 → 2.0.2

package/dist/types/index.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.packageManagerOptions = exports.postgresqlOrmOptions = exports.mongodbOrmOptions = exports.databaseSystemOptions = exports.frontendFrameworkOptions = exports.backendFrameworkOptions = exports.applicationTypeOptions = exports.DEFAULT_PORT = exports.DEFAULT_CHOICES = void 0;
 exports.buildError = buildError;
+exports.isBuildError = isBuildError;
 exports.getApplicationType = getApplicationType;
 // Used for every choice not given as a flag when --yes is passed
 exports.DEFAULT_CHOICES = {
@@ -17,13 +18,17 @@ exports.DEFAULT_CHOICES = {
 // Port the generated server listens on
 exports.DEFAULT_PORT = 3000;
 // Unified error creation function
-function buildError(errorOrMessage, code, context, exitCode = 1) {
+function buildError(errorOrMessage, code, context) {
     const message = errorOrMessage instanceof Error
         ? errorOrMessage.message
         : String(errorOrMessage);
     const fullMessage = context ? `${context}: ${message}` : message;
     const error = new Error(fullMessage);
-    return Object.assign(error, { code, exitCode });
+    return Object.assign(error, { code });
+}
+// True for errors created by buildError(), whose message is meant for the user
+function isBuildError(error) {
+    return error instanceof Error && "code" in error;
 }
 // Type-safe option definitions
 exports.applicationTypeOptions = [
@@ -47,7 +52,7 @@ exports.frontendFrameworkOptions = [
     {
         value: "tanstack",
         label: "TanStack Start",
-        hint: "React, release candidate",
+        hint: "Vite and React",
     },
 ];
 // Database system options; the ORM is chosen in a second step
@@ -76,4 +81,3 @@ function getApplicationType(framework) {
         ? "backend"
         : "fullstack";
 }
-//# sourceMappingURL=index.js.map

package/dist/ui/index.js

@@ -16,4 +16,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./messages"), exports);
 __exportStar(require("./prompts"), exports);
-//# sourceMappingURL=index.js.map

package/dist/ui/messages.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.error = exports.warn = exports.info = exports.success = void 0;
 exports.showBanner = showBanner;
 exports.showSummary = showSummary;
+exports.showPlan = showPlan;
 exports.showNextSteps = showNextSteps;
 // Everything the CLI prints outside of prompts
 const node_path_1 = __importDefault(require("node:path"));
@@ -85,6 +86,30 @@ function showSummary(config, targetDir) {
     write(`  ${(0, theme_1.pink)("Path ")}  ${node_path_1.default.relative((0, node_process_1.cwd)(), targetDir) || "."}`);
     write();
 }
+// Prints a titled list, or nothing when the list is empty
+function showSection(title, lines) {
+    if (lines.length === 0)
+        return;
+    write(`  ${(0, theme_1.amber)((0, theme_1.bold)(title))} ${(0, theme_1.dim)(`(${lines.length})`)}`);
+    for (const line of lines)
+        write(`  ${line}`);
+    write();
+}
+// Formats name/value pairs as two aligned columns
+function toColumns(entries) {
+    const width = Math.max(0, ...Object.keys(entries).map((key) => key.length));
+    return Object.entries(entries).map(([key, value]) => `${key.padEnd(width)}  ${(0, theme_1.dim)(value)}`);
+}
+// Shows everything a build would produce, for --dry-run
+function showPlan(plan) {
+    showSection("Files", plan.files);
+    showSection("Dependencies", toColumns(plan.dependencies));
+    showSection("Dev dependencies", toColumns(plan.devDependencies));
+    showSection("Overrides", toColumns(plan.overrides));
+    showSection("Scripts", toColumns(plan.scripts));
+    showSection("Environment variables", Object.entries(plan.envVars).map(([key, value]) => `${key}=${(0, theme_1.dim)(value)}`));
+    showSection("Commands", plan.commands.map(theme_1.lime));
+}
 // Shows the numbered next steps, with the commands to run highlighted
 function showNextSteps(steps) {
     write();
@@ -97,4 +122,3 @@ function showNextSteps(steps) {
     write(`  ${(0, theme_1.dim)(`Your app will run at http://localhost:${types_1.DEFAULT_PORT}`)}`);
     write();
 }
-//# sourceMappingURL=messages.js.map

package/dist/ui/prompts.js

@@ -68,4 +68,3 @@ function confirm(options) {
         },
     }).prompt();
 }
-//# sourceMappingURL=prompts.js.map

package/dist/ui/theme.js

@@ -21,4 +21,3 @@ const dim = (text) => (0, node_util_1.styleText)("dim", text);
 exports.dim = dim;
 const inverse = (text) => (0, node_util_1.styleText)("inverse", text);
 exports.inverse = inverse;
-//# sourceMappingURL=theme.js.map

package/dist/validators/index.js

@@ -1,44 +1,14 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectNameSchema = void 0;
 exports.validateProjectName = validateProjectName;
 exports.validateProjectPath = validateProjectPath;
 exports.validateDirectoryEmpty = validateDirectoryEmpty;
-const fs = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
 const zod_1 = require("zod");
 // Validates project name: lowercase letters, numbers, and hyphens
 exports.projectNameSchema = zod_1.z
@@ -60,20 +30,19 @@ function validateProjectName(name) {
 // Checks a project path such as "my-app", "apps/api", or "."; the last folder
 // name becomes the package name
 function validateProjectPath(projectPath) {
-    return validateProjectName(path.basename(path.resolve(projectPath)));
+    return validateProjectName(node_path_1.default.basename(node_path_1.default.resolve(projectPath)));
 }
 // Ensures a directory is empty or does not exist before starting build
 async function validateDirectoryEmpty(dirPath) {
-    const exists = await fs.pathExists(dirPath);
+    const exists = await fs_extra_1.default.pathExists(dirPath);
     if (!exists)
         return null;
-    const stats = await fs.stat(dirPath);
+    const stats = await fs_extra_1.default.stat(dirPath);
     if (!stats.isDirectory()) {
         return `Path "${dirPath}" exists but is not a directory`;
     }
-    const files = await fs.readdir(dirPath);
+    const files = await fs_extra_1.default.readdir(dirPath);
     if (files.length === 0)
         return null;
-    return `Directory "${path.basename(dirPath)}" already exists and is not empty`;
+    return `Directory "${node_path_1.default.basename(dirPath)}" already exists and is not empty`;
 }
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-ts-stack",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "A CLI that scaffolds Express, NestJS, Next.js, and TanStack Start projects with a database, authentication, and Docker already set up.",
   "keywords": [
     "cli",
@@ -37,6 +37,7 @@
   ],
   "scripts": {
     "dev": "tsx  src/index.ts",
+    "prebuild": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "tsc",
     "postbuild": "node -e \"const fs=require('fs');const p='dist/index.js';fs.writeFileSync(p,'#!/usr/bin/env node\\n'+fs.readFileSync(p,'utf8'))\"",
     "prepack": "npm run build",

package/templates/backend/express/.prettierrc

@@ -7,8 +7,8 @@
   "useTabs": false,
   "arrowParens": "always",
   "endOfLine": "lf",
-  "plugins": ["@trivago/prettier-plugin-sort-imports", "prettier-plugin-tailwindcss"],
-  "importOrder": ["^react", "^next", "<THIRD_PARTY_MODULES>", "^@repo/(.*)$", "^@/(.*)$", "^[./]"],
+  "plugins": ["@trivago/prettier-plugin-sort-imports"],
+  "importOrder": ["<THIRD_PARTY_MODULES>", "^[./]"],
   "importOrderSeparation": true,
   "importOrderSortSpecifiers": true,
   "importOrderGroupNamespaceSpecifiers": true,

package/templates/backend/express/config.json

@@ -30,15 +30,11 @@
     "eslint": "^10.10.0",
     "eslint-config-prettier": "^10.1.8",
     "prettier": "^3.9.6",
-    "prettier-plugin-tailwindcss": "^0.8.1",
     "tsx": "^4.23.13",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.69.0"
   },
   "envVars": {
     "PORT": "3000"
-  },
-  "templateFiles": [
-    "src/index.ts"
-  ]
+  }
 }

package/templates/backend/express/eslint.config.mjs

@@ -1,40 +1,40 @@
-import eslint from "@eslint/js";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import tseslint from "typescript-eslint";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-export default tseslint.config(
-  {
-    ignores: [
-      "dist",
-      "node_modules",
-      "templates/**/*",
-      "bin/**/*",
-      "src/generated/**",
-    ],
-  },
-  eslint.configs.recommended,
-  ...tseslint.configs.recommended,
-  ...tseslint.configs.recommendedTypeChecked,
-  {
-    languageOptions: {
-      parserOptions: {
-        project: "./tsconfig.eslint.json",
-        tsconfigRootDir: __dirname,
-      },
-    },
-    rules: {
-      "@typescript-eslint/explicit-function-return-type": "off",
-      "@typescript-eslint/no-explicit-any": "warn",
-      "@typescript-eslint/no-unused-vars": [
-        "error",
-        { argsIgnorePattern: "^_" },
-      ],
-      "@typescript-eslint/no-floating-promises": "error",
-      "no-console": "off",
-    },
-  }
-);
+import eslint from "@eslint/js";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import tseslint from "typescript-eslint";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export default tseslint.config(
+  {
+    ignores: [
+      "dist",
+      "node_modules",
+      "templates/**/*",
+      "bin/**/*",
+      "src/generated/**",
+    ],
+  },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: "./tsconfig.eslint.json",
+        tsconfigRootDir: __dirname,
+      },
+    },
+    rules: {
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/no-floating-promises": "error",
+      "no-console": "off",
+    },
+  }
+);

package/templates/backend/express/gitignore

@@ -1,36 +1,36 @@
-# Dependencies
-node_modules/
-
-# Build output
-dist/
-build/
-
-# Environment variables
-.env
-.env.local
-.env.*.local
-
-# Logs
-logs/
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Testing
-coverage/
-.nyc_output/
-
-# Misc
-*.tsbuildinfo
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage/
+.nyc_output/
+
+# Misc
+*.tsbuildinfo

package/templates/backend/express/src/{index.ts → index.ts.hbs}

@@ -1,37 +1,35 @@
-import 'dotenv/config';
-import express, { Express, Request, Response, NextFunction } from 'express';
-import cors from 'cors';
-import helmet from 'helmet';
-import morgan from 'morgan';
+import "dotenv/config";
+import express, { Express, Request, Response, NextFunction } from "express";
+import cors from "cors";
+import helmet from "helmet";
+import morgan from "morgan";
 {{#if (eq database 'mongoose')}}
-import { connectDB } from './lib/db';
+import { connectDB } from "./lib/db";
 {{/if}}
-import healthRouter from './routes/health';
+import healthRouter from "./routes/health";
 {{#if useAuth}}
-import authRouter from './routes/auth';
+import authRouter from "./routes/auth";
 {{/if}}
 
-
-
 const app: Express = express();
 const port = process.env.PORT || 3000;
 
 // Middleware
 app.use(helmet());
 app.use(cors());
-app.use(morgan('dev'));
+app.use(morgan("dev"));
 app.use(express.json());
 app.use(express.urlencoded({ extended: true }));
 
 // Routes
-app.use('/health', healthRouter);
+app.use("/health", healthRouter);
 {{#if useAuth}}
-app.use('/auth', authRouter);
+app.use("/auth", authRouter);
 {{/if}}
 
 // 404 handler
 app.use((_req: Request, res: Response) => {
-  res.status(404).json({ error: 'Not Found' });
+  res.status(404).json({ error: "Not Found" });
 });
 
 // Error handler
@@ -46,31 +44,32 @@ app.use(
     const status = err.status ?? err.statusCode ?? 500;
 
     if (status >= 400 && status < 500) {
-      res.status(status).json({ error: err.expose ? err.message : 'Bad Request' });
+      res.status(status).json({ error: err.expose ? err.message : "Bad Request" });
       return;
     }
 
     console.error(err.stack);
-    res.status(500).json({ error: 'Internal Server Error' });
+    res.status(500).json({ error: "Internal Server Error" });
   },
 );
 
-{{#if (eq database 'mongoose')}}
-void awaitDatabase().catch((error: unknown) => {
-  console.error(error);
-  process.exitCode = 1;
-});
-async function awaitDatabase(): Promise<void> {
-  await connectDB();
-  app.listen(port);
-}
-{{else}}
-app.listen(port, () => {
-  console.log(`Server is running on http://localhost:${port} 
+function listen(): void {
+  app.listen(port, () => {
+    console.log(`Server is running on http://localhost:${port}
     Health: http://localhost:${port}/health
     `);
-});
+  });
+}
 
+{{#if (eq database 'mongoose')}}
+void connectDB()
+  .then(listen)
+  .catch((error: unknown) => {
+    console.error(error);
+    process.exitCode = 1;
+  });
+{{else}}
+listen();
 {{/if}}
 
 export default app;

package/templates/backend/express/src/routes/health.ts

@@ -1,12 +1,12 @@
-import { Request, Response, Router } from "express";
-
-const router: Router = Router();
-
-router.get("/", (_req: Request, res: Response) => {
-  res.status(200).json({
-    status: "ok",
-    timestamp: new Date().toISOString(),
-  });
-});
-
-export default router;
+import { Request, Response, Router } from "express";
+
+const router: Router = Router();
+
+router.get("/", (_req: Request, res: Response) => {
+  res.status(200).json({
+    status: "ok",
+    timestamp: new Date().toISOString(),
+  });
+});
+
+export default router;

package/templates/backend/express/tsconfig.json

@@ -1,25 +1,25 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "NodeNext",
-    "lib": ["ES2020"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "moduleResolution": "NodeNext",
-    "types": ["node"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "NodeNext",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "moduleResolution": "NodeNext",
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/backend/nestjs/.prettierrc

@@ -1,16 +1,16 @@
-{
-  "semi": true,
-  "trailingComma": "es5",
-  "singleQuote": false,
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false,
-  "arrowParens": "always",
-  "endOfLine": "lf",
-  "plugins": ["@trivago/prettier-plugin-sort-imports"],
-  "importOrder": ["<THIRD_PARTY_MODULES>", "^[./]"],
-  "importOrderSeparation": true,
-  "importOrderSortSpecifiers": true,
-  "importOrderCaseInsensitive": true,
-  "importOrderParserPlugins": ["typescript", "decorators-legacy"]
-}
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": false,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "plugins": ["@trivago/prettier-plugin-sort-imports"],
+  "importOrder": ["<THIRD_PARTY_MODULES>", "^[./]"],
+  "importOrderSeparation": true,
+  "importOrderSortSpecifiers": true,
+  "importOrderCaseInsensitive": true,
+  "importOrderParserPlugins": ["typescript", "decorators-legacy"]
+}

package/templates/backend/nestjs/config.json

@@ -37,8 +37,5 @@
   },
   "envVars": {
     "PORT": "3000"
-  },
-  "templateFiles": [
-    "src/app.module.ts.hbs"
-  ]
+  }
 }