express-generator-typescript 3.1.0 → 3.2.0

package/README.md

@@ -14,7 +14,7 @@ A command-line tool that generates production-ready Express projects with TypeSc
 
 ## 🧭 Overview 
 
-`express-generator-typescript` works like the classic `express-generator` package, but the project it creates is fully set up for TypeScript. You get strict typing, linting, hot reloading, testing, and production builds, with defaults aimed at APIs. The project is an ES module and comes with an `@src/*` import alias, so imports stay clean as the app grows.
+`express-generator-typescript` works like the classic `express-generator` package, but the project it creates is fully set up for TypeScript. You get strict typing, linting, hot reloading, and testing, with defaults aimed at APIs and no build step. The project is an ES module and comes with a `#src/*` import alias, so imports stay clean as the app grows.
 
 <p align="center">· · ·</p>
 
@@ -22,15 +22,15 @@ A command-line tool that generates production-ready Express projects with TypeSc
 
 - **TypeScript-first** – strict compiler settings, linting, and sensible tsconfig defaults, ready to go.
 - **Built for APIs** – ideal for SPAs, mobile backends, or services.
-- **Fast development** – runs TypeScript directly with tsx (no build step), restarts the server when you change it, and refreshes the browser when you change front-end files. Vitest, ESLint, and production builds are included.
-- **Path aliases** – import from `@src/*` anywhere. It works in development, tests, and production builds.
+- **Fast development** – runs TypeScript directly with Node's built-in type stripping (no build step, in development or production), restarts the server when you change it, and refreshes the browser when you change front-end files. Node's built-in test runner and ESLint are included.
+- **Path aliases** – import from `#src/*` anywhere. It works in development, tests, and production.
 - **Lean dependencies** – no view engine, ORM, or UI layer; only the essentials for Express + TypeScript.
 
 <p align="center">· · ·</p>
 
 ## 📦 Installation
 
-Requires Node.js 22.13+ (22.x), 24.x, or 26+.
+Requires Node.js 22.18+ (22.x), 24.x, or 26+.
 
 ```bash
 npx express-generator-typescript
@@ -70,20 +70,19 @@ npm run dev
 
 ## 🧩 Generated Template
 
-The generated project is a small CRUD app for a `User` record. It shows how to structure models, services, and routes in Express + TypeScript. Linting, formatting, building, and hot reloading are all set up for you.
+The generated project is a small CRUD app for a `User` record. It shows how to structure models, services, and routes in Express + TypeScript. Linting, formatting, testing, and hot reloading are all set up for you.
 
 ---
 
 #### Available `package.json` scripts
 
 - `npm run dev` – Run the server in development with live reload and browser refresh.
-- `npm test` – Run the tests with Vitest.
-- `npm test -- users.test.ts` – Run a single test file.
+- `npm test` – Run the tests with Node's built-in test runner.
+- `npm test -- tests/users.test.ts` – Run a single test file.
 - `npm run lint` – Check the code with ESLint.
 - `npm run format` – Format the code with Prettier.
-- `npm run build` – Build the project for production.
-- `npm start` – Run the production build.
-- `npm run typecheck` – Check for TypeScript errors without building.
+- `npm start` – Run the server in production mode (no build step).
+- `npm run typecheck` – Check for TypeScript errors.
 - `npm run install:clean` – Delete `node_modules` and the lockfile, then reinstall.
 
 ---
@@ -187,7 +186,7 @@ To debug with breakpoints in VS Code, start the app or tests from `.vscode/launc
       "console": "integratedTerminal"
     },
     {
-      "name": "Test - Vitest",
+      "name": "Test",
       "type": "node",
       "request": "launch",
       "runtimeExecutable": "npm",

package/lib/template/.prettierrc.json

@@ -2,7 +2,7 @@
   "plugins": ["@trivago/prettier-plugin-sort-imports"],
   "importOrder": [
     "<THIRD_PARTY_MODULES>",
-    "^@src/[^/]+(/.*)?$",
+    "^#src/[^/]+(/.*)?$",
     "^\\.(?!.*\\.css$).*$",
     "^.+\\.css$"
   ],

package/lib/template/README.md

@@ -1,6 +1,6 @@
 ## About
 
-This project was created with [express-generator-typescript](https://github.com/seanpmaxwell/express-generator-typescript). It requires Node.js 22.13+ (22.x), 24.x, or 26+.
+This project was created with [express-generator-typescript](https://github.com/seanpmaxwell/express-generator-typescript). It requires Node.js 22.18+ (22.x), 24.x, or 26+.
 
 The original template follows the [TypeScript best practices](https://github.com/seanpmaxwell/Typescript-Best-Practices).
 
@@ -12,11 +12,11 @@ The original template follows the [TypeScript best practices](https://github.com
 
 Run the server in development at http://localhost:3000. The server restarts when you change server code, and the browser refreshes when you change server code or anything in `src/public` or `src/views`.
 
-> **Note:** development mode runs your `.ts` files directly with `tsx`, which doesn't check for TypeScript errors. Run `npm run typecheck` to check for them, and let your editor catch most of them as you work.
+> **Note:** Node runs your `.ts` files directly with Node's built-in [type stripping](https://nodejs.org/api/typescript.html), which doesn't check for TypeScript errors. Run `npm run typecheck` to check for them, and let your editor catch most of them as you work.
 
 ### `npm test`
 
-Run the tests with [Vitest](https://vitest.dev/guide/).
+Run the tests with Node's built-in [test runner](https://nodejs.org/api/test.html). Pass a file to run only that file (`npm test -- tests/users.test.ts`), or `--test-name-pattern` to run only matching tests (`npm test -- --test-name-pattern="UserRouter"`).
 
 ### `npm run lint`
 
@@ -26,17 +26,13 @@ Check the code with ESLint.
 
 Format `src/` and `tests/` with Prettier.
 
-### `npm run build`
-
-Build the project for production.
-
 ### `npm start`
 
-Run the production build. Run `npm run build` first.
+Run the server in production mode. There's no build step: like `npm run dev`, this runs the `.ts` files in `src/` directly, so run `npm run typecheck` and `npm run lint` before you deploy.
 
 ### `npm run typecheck`
 
-Check for TypeScript errors without building.
+Check for TypeScript errors.
 
 ### `npm run install:clean`
 
@@ -54,16 +50,17 @@ Delete `node_modules/` and `package-lock.json`, then reinstall all dependencies.
   - **General logging**: [jet-logger](https://github.com/seanpmaxwell/jet-logger)
 - **Validation**: [zod](https://github.com/colinhacks/zod)
   - **Middleware Validation**: [express-zod-safe](https://github.com/AngaBlue/express-zod-safe)
-- **Environment variables**: [dotenv](https://github.com/motdotla/dotenv) loads `config/.env.*`
-- **Reloading**: [tsx](https://tsx.hirok.io) (`tsx watch` restarts the server) and [livereload](https://github.com/napcs/node-livereload) + [connect-livereload](https://github.com/intesso/connect-livereload) (refreshes the browser)
-- **Testing**: [Vitest](https://vitest.dev) + [Supertest](https://github.com/ladjs/supertest)
+- **Environment variables**: Node's built-in [`--env-file`](https://nodejs.org/api/cli.html#--env-fileconfig) loads `config/.env.*`
+- **Reloading**: Node's built-in [`--watch`](https://nodejs.org/api/cli.html#--watch) (restarts the server) and [livereload](https://github.com/napcs/node-livereload) + [connect-livereload](https://github.com/intesso/connect-livereload) (refreshes the browser)
+- **Testing**: Node's built-in [`node:test`](https://nodejs.org/api/test.html) + [Supertest](https://github.com/ladjs/supertest)
 - **Linting**: [ESLint](https://eslint.org) with [typescript-eslint](https://typescript-eslint.io/packages/typescript-eslint) and [eslint-plugin-n](https://github.com/eslint-community/eslint-plugin-n)
 - **Formatting**: [Prettier](https://prettier.io) with [@trivago/prettier-plugin-sort-imports](https://github.com/trivago/prettier-plugin-sort-imports)
-- **Building**: `tsc` + [tsc-alias](https://github.com/justkey007/tsc-alias) (rewrites `@src/*` imports in `dist/`)
+- **Type checking**: `tsc` (`npm run typecheck`). There's no build step.
 
 <p align="center">· · ·</p>
 
 ## Additional Notes
 
+- Imports name the `.ts` file (`./server.ts`), because Node runs the source files directly. `#src/*` imports are [subpath imports](https://nodejs.org/api/packages.html#subpath-imports) set up in `package.json` that point at `src/*`.
 - `config/.env.production` is in `.gitignore` so production secrets don't get committed. Keep it out of version control and supply its values through your deployment tooling.
-- The database is a JSON file meant only for the demo: `src/repos/common/database.json` in development, or `dist/repos/common/database.json` in production. It's created automatically if missing, but it isn't safe for simultaneous writes. Replace `src/repos/MockOrm.ts` with a real database before going to production.
+- The database is a JSON file meant only for the demo: `src/repos/common/database.json`. It's created automatically if missing, but it isn't safe for simultaneous writes. Replace `src/repos/MockOrm.ts` with a real database before going to production.

package/lib/template/eslint.config.ts

@@ -10,7 +10,7 @@ import tseslint from 'typescript-eslint';
 
 export default defineConfig([
   // global ignores
-  globalIgnores(['**/dist/**', '**/public/**/lib/**']),
+  globalIgnores(['**/public/**/lib/**']),
   // linting rules (code quality only)
   {
     files: ['**/*.{ts,tsx}'],
@@ -38,6 +38,15 @@ export default defineConfig([
           ignoreRestSiblings: true,
         },
       ],
+      // node:test's `describe`/`it` return promises the runner already tracks
+      '@typescript-eslint/no-floating-promises': [
+        'error',
+        {
+          allowForKnownSafeCalls: [
+            { from: 'package', name: ['describe', 'it'], package: 'node:test' },
+          ],
+        },
+      ],
       'no-console': 'warn',
       'no-extra-boolean-cast': 'off',
       'no-process-env': 'warn',

package/lib/template/gitignore

@@ -1,5 +1,4 @@
 **/node_modules
-dist/
 **/**/*.log
 tsconfig.tsbuildinfo
 

package/lib/template/package.json

@@ -3,29 +3,27 @@
   "version": "1.0.0",
   "type": "module",
   "scripts": {
-    "build": "shx rm -rf dist && npm run lint && tsc --project tsconfig.prod.json && tsc-alias -p tsconfig.prod.json && npm run build:copy-static",
-    "build:copy-static": "shx mkdir -p dist/public dist/views && shx cp -r src/public/* dist/public && shx cp -r src/views/* dist/views",
-    "install:clean": "shx rm -rf ./node_modules package-lock.json && npm i",
-    "dev": "cross-env DOTENV_CONFIG_PATH=./config/.env.development tsx watch --import dotenv/config ./src/main.ts",
+    "install:clean": "node -e \"fs.rmSync('node_modules', { recursive: true, force: true }); fs.rmSync('package-lock.json', { force: true })\" && npm i",
+    "dev": "node --env-file=config/.env.development --watch src/main.ts",
     "lint": "eslint .",
     "format": "prettier --write .",
-    "start": "cross-env DOTENV_CONFIG_PATH=./config/.env.production node --import dotenv/config ./dist/main.js",
-    "test": "cross-env NODE_ENV=test vitest",
+    "start": "node --env-file-if-exists=config/.env.production src/main.ts",
+    "test": "node --env-file=config/.env.test --test --test-concurrency=1",
     "typecheck": "tsc -b --noEmit"
   },
+  "imports": {
+    "#src/*": "./src/*"
+  },
   "engines": {
-    "node": "^22.13.0 || ^24.0.0 || >=26.0.0"
+    "node": "^22.18.0 || ^24.0.0 || >=26.0.0"
   },
   "dependencies": {
-    "cross-env": "^10.1.0",
-    "dotenv": "^18.0.4",
-    "express": "^5.2.1",
+    "express": "^5.3.0",
     "express-zod-safe": "^3.2.1",
     "helmet": "^8.3.0",
     "jet-logger": "3.0.0",
-    "jsonfile": "^6.2.1",
     "morgan": "^1.12.1",
-    "uuid": "^14.0.2",
+    "uuid": "^14.0.3",
     "zod": "^4.6.5"
   },
   "devDependencies": {
@@ -33,27 +31,19 @@
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/connect-livereload": "^0.6.3",
     "@types/express": "^5.0.6",
-    "@types/jsonfile": "^6.1.4",
     "@types/livereload": "^0.9.5",
     "@types/morgan": "^1.9.10",
-    "@types/node": "^26.6.2",
+    "@types/node": "^26.6.5",
     "@types/supertest": "^7.2.1",
     "connect-livereload": "^0.6.1",
-    "eslint": "^10.11.0",
+    "eslint": "^10.12.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-n": "^18.3.0",
+    "eslint-plugin-n": "^18.4.1",
     "jiti": "^2.7.0",
     "livereload": "^0.10.3",
-    "prettier": "^3.9.9",
-    "shx": "^0.4.0",
-    "supertest": "^7.3.0",
-    "tsc-alias": "^1.9.5",
-    "tsx": "^4.23.15",
+    "prettier": "^3.9.10",
+    "supertest": "^7.3.1",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.70.1",
-    "vitest": "^5.0.2"
-  },
-  "allowScripts": {
-    "esbuild@0.28.2": true
+    "typescript-eslint": "^8.71.1"
   }
 }

package/lib/template/src/common/classes/route-errors.ts

@@ -1,4 +1,4 @@
-import HttpStatusCodes from '@src/common/constants/HttpStatusCodes';
+import HttpStatusCodes from '#src/common/constants/HttpStatusCodes.ts';
 
 // ========================================================================= //
 //                                  CLASSES                                  //

package/lib/template/src/common/constants/HttpStatusCodes.ts

@@ -1,4 +1,4 @@
-import type { ValueOf } from '../utils/validators';
+import type { ValueOf } from '../utils/validators.ts';
 
 // ========================================================================= //
 //                                 CONSTANTS                                 //

package/lib/template/src/common/constants/Paths/Paths.ts

@@ -1,4 +1,4 @@
-import { ep, pp } from './helpers';
+import { ep, pp } from './helpers.ts';
 
 // ========================================================================= //
 //                                 CONSTANTS                                 //

package/lib/template/src/common/constants/Paths/index.ts

@@ -1 +1 @@
-export { default as default } from './Paths';
+export { default as default } from './Paths.ts';

package/lib/template/src/common/utils/dev-only.ts

@@ -8,7 +8,7 @@ import livereload from 'livereload';
 
 /**
  * Development only: refresh the browser when front-end files change, and
- * after `tsx watch` restarts the server for a TypeScript change.
+ * after `node --watch` restarts the server for a TypeScript change.
  *
  * Must be registered before the routes that serve html so the reload script
  * gets injected into those pages.

package/lib/template/src/entities/User/index.ts

@@ -1,2 +1,2 @@
-export { default as default } from './module';
-export type { UserEntity, UserInput } from './types';
+export { default as default } from './module.ts';
+export type { UserEntity, UserInput } from './types.ts';

package/lib/template/src/entities/User/module.ts

@@ -5,9 +5,9 @@ import {
   getISOString,
   type ISOString,
   ISOStringSchema,
-} from '@src/common/utils/date.utils';
+} from '#src/common/utils/date.utils.ts';
 
-import type { UserEntity, UserInput } from './types';
+import type { UserEntity, UserInput } from './types.ts';
 
 // ========================================================================= //
 //                                 CONSTANTS                                 //

package/lib/template/src/entities/User/types.ts

@@ -1,4 +1,4 @@
-import type { Entity } from '@src/entities/common/entity-base-types';
+import type { Entity } from '#src/entities/common/entity-base-types.ts';
 
 // ========================================================================= //
 //                                   TYPES                                   //

package/lib/template/src/entities/common/entity-base-types.ts

@@ -1,4 +1,4 @@
-import type { ISOString } from '@src/common/utils/date.utils';
+import type { ISOString } from '#src/common/utils/date.utils.ts';
 
 // ========================================================================= //
 //                                   TYPES                                   //

package/lib/template/src/main.ts

@@ -1,7 +1,7 @@
 import logger from 'jet-logger';
 
-import { Env } from './common/constants/env.constants';
-import server from './server';
+import { Env } from './common/constants/env.constants.ts';
+import server from './server.ts';
 
 // ========================================================================= //
 //                                 CONSTANTS                                 //

package/lib/template/src/repos/MockOrm.ts

@@ -1,9 +1,8 @@
 import fs from 'fs/promises';
-import jsonfile from 'jsonfile';
 import path from 'path';
 
-import { Env, NodeEnvs } from '@src/common/constants/env.constants';
-import type { UserEntity } from '@src/entities/User';
+import { Env, NodeEnvs } from '#src/common/constants/env.constants.ts';
+import type { UserEntity } from '#src/entities/User/index.ts';
 
 // ========================================================================= //
 //                                 CONSTANTS                                 //
@@ -37,7 +36,8 @@ type Database = {
 async function openDb(): Promise<Database> {
   let db: Partial<Database>;
   try {
-    db = (await jsonfile.readFile(DATABASE_FILE_PATH)) as Partial<Database>;
+    const json = await fs.readFile(DATABASE_FILE_PATH, 'utf8');
+    db = JSON.parse(json) as Partial<Database>;
   } catch (err) {
     if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;
     db = {};
@@ -50,7 +50,7 @@ async function openDb(): Promise<Database> {
  */
 async function saveDb(db: Database): Promise<void> {
   await fs.mkdir(path.dirname(DATABASE_FILE_PATH), { recursive: true });
-  return jsonfile.writeFile(DATABASE_FILE_PATH, db, { spaces: 2 });
+  await fs.writeFile(DATABASE_FILE_PATH, JSON.stringify(db, null, 2) + '\n');
 }
 
 /**

package/lib/template/src/repos/UserRepo.ts

@@ -1,6 +1,6 @@
-import { type UserEntity } from '@src/entities/User';
+import { type UserEntity } from '#src/entities/User/index.ts';
 
-import orm from './MockOrm';
+import orm from './MockOrm.ts';
 
 // ========================================================================= //
 //                                 FUNCTIONS                                 //

package/lib/template/src/routers/api.router.ts

@@ -1,8 +1,8 @@
 import { Router } from 'express';
 
-import Paths from '@src/common/constants/Paths';
+import Paths from '#src/common/constants/Paths/index.ts';
 
-import userRouter from './user.router';
+import userRouter from './user.router.ts';
 
 // ========================================================================= //
 //                                   EXEC                                    //

package/lib/template/src/routers/user.router.ts

@@ -1,10 +1,10 @@
 import { Router } from 'express';
 import validate from 'express-zod-safe';
 
-import HttpStatusCodes from '@src/common/constants/HttpStatusCodes';
-import Paths from '@src/common/constants/Paths';
-import User from '@src/entities/User';
-import UserService from '@src/services/UserService';
+import HttpStatusCodes from '#src/common/constants/HttpStatusCodes.ts';
+import Paths from '#src/common/constants/Paths/index.ts';
+import User from '#src/entities/User/index.ts';
+import UserService from '#src/services/UserService.ts';
 
 // ========================================================================= //
 //                                 CONSTANTS                                 //

package/lib/template/src/server.ts

@@ -8,12 +8,12 @@ import logger from 'jet-logger';
 import morgan from 'morgan';
 import path from 'path';
 
-import { RouteError } from '@src/common/classes/route-errors';
-import HttpStatusCodes from '@src/common/constants/HttpStatusCodes';
-import Paths from '@src/common/constants/Paths';
-import BaseRouter from '@src/routers/api.router';
+import { RouteError } from '#src/common/classes/route-errors.ts';
+import HttpStatusCodes from '#src/common/constants/HttpStatusCodes.ts';
+import Paths from '#src/common/constants/Paths/index.ts';
+import BaseRouter from '#src/routers/api.router.ts';
 
-import { Env, NodeEnvs } from './common/constants/env.constants';
+import { Env, NodeEnvs } from './common/constants/env.constants.ts';
 
 // ========================================================================= //
 //                                   EXEC                                    //
@@ -78,7 +78,7 @@ const staticDir = path.join(import.meta.dirname, 'public');
 // Refresh the browser on changes. Imported lazily because livereload is a
 // dev dependency and isn't installed in production.
 if (Env.NODE_ENV === NodeEnvs.DEVELOPMENT) {
-  const { setupLiveReload } = await import('@src/common/utils/dev-only');
+  const { setupLiveReload } = await import('#src/common/utils/dev-only.ts');
   setupLiveReload(app, [staticDir, viewsDir]);
 }
 

package/lib/template/src/services/UserService.ts

@@ -1,6 +1,9 @@
-import { NotFoundError } from '@src/common/classes/route-errors';
-import User, { type UserEntity, type UserInput } from '@src/entities/User';
-import UserRepo from '@src/repos/UserRepo';
+import { NotFoundError } from '#src/common/classes/route-errors.ts';
+import User, {
+  type UserEntity,
+  type UserInput,
+} from '#src/entities/User/index.ts';
+import UserRepo from '#src/repos/UserRepo.ts';
 
 // ========================================================================= //
 //                                 CONSTANTS                                 //

package/lib/template/tests/frontend.test.ts

@@ -1,6 +1,22 @@
-import HttpStatusCodes from '@src/common/constants/HttpStatusCodes';
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
 
-import { agent } from './support/agent';
+import HttpStatusCodes from '#src/common/constants/HttpStatusCodes.ts';
+
+import { agent } from './support/agent.ts';
+
+// ========================================================================= //
+//                                 CONSTANTS                                 //
+// ========================================================================= //
+
+const STATIC_ASSETS = [
+  '/scripts/HttpClient.js',
+  '/scripts/renderUsers.js',
+  '/scripts/users.js',
+  '/scripts/lib/bootstrap.bundle.min.js',
+  '/stylesheets/users.css',
+  '/stylesheets/lib/bootstrap.min.css',
+] as const;
 
 // ========================================================================= //
 //                                   TESTS                                   //
@@ -9,25 +25,20 @@ import { agent } from './support/agent';
 describe('Front-end content', () => {
   it('should redirect "/" to the users page.', async () => {
     const res = await agent.get('/');
-    expect(res.status).toBe(HttpStatusCodes.FOUND);
-    expect(res.headers.location).toBe('/users');
+    assert.equal(res.status, HttpStatusCodes.FOUND);
+    assert.equal(res.headers.location, '/users');
   });
 
   it('should serve the users page.', async () => {
     const res = await agent.get('/users');
-    expect(res.status).toBe(HttpStatusCodes.OK);
-    expect(res.headers['content-type']).toMatch(/html/);
+    assert.equal(res.status, HttpStatusCodes.OK);
+    assert.match(res.headers['content-type'], /html/);
   });
 
-  it.each([
-    '/scripts/HttpClient.js',
-    '/scripts/renderUsers.js',
-    '/scripts/users.js',
-    '/scripts/lib/bootstrap.bundle.min.js',
-    '/stylesheets/users.css',
-    '/stylesheets/lib/bootstrap.min.css',
-  ])('should serve the static asset "%s".', async (asset) => {
-    const res = await agent.get(asset);
-    expect(res.status).toBe(HttpStatusCodes.OK);
-  });
+  for (const asset of STATIC_ASSETS) {
+    it(`should serve the static asset "${asset}".`, async () => {
+      const res = await agent.get(asset);
+      assert.equal(res.status, HttpStatusCodes.OK);
+    });
+  }
 });

package/lib/template/tests/support/agent.ts

@@ -1,9 +1,9 @@
+import { before } from 'node:test';
 import supertest, { type Test } from 'supertest';
 import type TestAgent from 'supertest/lib/agent.js';
-import { beforeAll } from 'vitest';
 
-import MockOrm from '@src/repos/MockOrm';
-import app from '@src/server';
+import MockOrm from '#src/repos/MockOrm.ts';
+import app from '#src/server.ts';
 
 // ========================================================================= //
 //                                   EXEC                                    //
@@ -11,7 +11,7 @@ import app from '@src/server';
 
 let agent: TestAgent<Test>;
 
-beforeAll(async () => {
+before(async () => {
   agent = supertest.agent(app);
   await MockOrm.cleanDb();
 });

package/lib/template/tests/users.test.ts

@@ -1,15 +1,18 @@
-import HttpStatusCodes from '@src/common/constants/HttpStatusCodes';
-import Paths from '@src/common/constants/Paths';
-import User, { type UserEntity } from '@src/entities/User';
-import UserRepo, { UserRepoTestOnly } from '@src/repos/UserRepo';
-import UserService from '@src/services/UserService';
+import assert from 'node:assert/strict';
+import { beforeEach, describe, it } from 'node:test';
 
-import { agent } from './support/agent';
+import HttpStatusCodes from '#src/common/constants/HttpStatusCodes.ts';
+import Paths from '#src/common/constants/Paths/index.ts';
+import User, { type UserEntity } from '#src/entities/User/index.ts';
+import UserRepo, { UserRepoTestOnly } from '#src/repos/UserRepo.ts';
+import UserService from '#src/services/UserService.ts';
+
+import { agent } from './support/agent.ts';
 import {
   extractErrMsg,
   type TypedErrRes,
   type TypedRes,
-} from './support/utils';
+} from './support/utils.ts';
 
 // ========================================================================= //
 //                                 CONSTANTS                                 //
@@ -66,10 +69,6 @@ describe('UserRouter', () => {
     dbUsers = await UserRepoTestOnly.insertMultiple(DUMMY_USERS);
   });
 
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
   // --- `Get` ---
   describe(P.Get.DISPLAY, () => {
     describe('on success', () => {
@@ -77,19 +76,19 @@ describe('UserRouter', () => {
         const res: TypedRes<{ users: UserEntity[] }> = await agent.get(
           P.Get.CALL,
         );
-        expect(res.status).toBe(OK);
-        expect(res.body.users).toStrictEqual(DUMMY_USERS);
+        assert.equal(res.status, OK);
+        assert.deepEqual(res.body.users, DUMMY_USERS);
       });
     });
 
     describe('when an unexpected error is thrown', () => {
-      it(`returns status "${INTERNAL_SERVER_ERROR}"`, async () => {
+      it(`returns status "${INTERNAL_SERVER_ERROR}"`, async (t) => {
         const error = new Error('boom');
-        const getAllSpy = vi.spyOn(UserService, 'getAll');
-        getAllSpy.mockRejectedValueOnce(error);
+        // Mocks made through `t.mock` are restored when the test ends
+        t.mock.method(UserService, 'getAll', () => Promise.reject(error));
         const res: TypedErrRes = await agent.get(P.Get.CALL);
-        expect(res.status).toBe(INTERNAL_SERVER_ERROR);
-        expect(res.body.error).toBe('Internal Server Error');
+        assert.equal(res.status, INTERNAL_SERVER_ERROR);
+        assert.equal(res.body.error, 'Internal Server Error');
       });
     });
   });
@@ -103,21 +102,22 @@ describe('UserRouter', () => {
         const res: TypedRes<{ user: UserEntity }> = await agent
           .post(P.Add.CALL)
           .send({ user: input });
-        expect(res.status).toBe(CREATED);
+        assert.equal(res.status, CREATED);
         const isId = User.is.id(res.body.user.id);
-        expect(isId).toBe(true);
+        assert.equal(isId, true);
         const all = await UserRepo.getAll();
-        expect(all).toHaveLength(DUMMY_USERS.length + 1);
-        expect(all).toContainEqual(res.body.user);
+        assert.equal(all.length, DUMMY_USERS.length + 1);
+        const saved = all.find((u) => u.id === res.body.user.id);
+        assert.deepEqual(saved, res.body.user);
       });
     });
 
     describe('when the user param is missing', () => {
       it('returns a validation error', async () => {
         const res = await agent.post(P.Add.CALL).send({ user: null });
-        expect(res.status).toBe(BAD_REQUEST);
+        assert.equal(res.status, BAD_REQUEST);
         const errMsg = extractErrMsg(res);
-        expect(errMsg).toBe('Invalid input: expected object, received null');
+        assert.equal(errMsg, 'Invalid input: expected object, received null');
       });
     });
 
@@ -126,10 +126,10 @@ describe('UserRouter', () => {
         const res = await agent
           .post(P.Add.CALL)
           .send({ user: { name: '', email: 'a@a.com' } });
-        expect(res.status).toBe(BAD_REQUEST);
+        assert.equal(res.status, BAD_REQUEST);
         // Verify it didn't persist in the database
         const allUsers = await UserRepo.getAll();
-        expect(allUsers).toHaveLength(DUMMY_USERS.length);
+        assert.equal(allUsers.length, DUMMY_USERS.length);
       });
     });
 
@@ -139,12 +139,12 @@ describe('UserRouter', () => {
           .post(P.Add.CALL)
           .set('Content-Type', 'application/json')
           .send('{"user":');
-        expect(res.status).toBe(BAD_REQUEST);
-        expect(res.body).toStrictEqual({ error: 'Invalid JSON' });
-        expect(await UserRepo.getAll()).toStrictEqual(DUMMY_USERS);
+        assert.equal(res.status, BAD_REQUEST);
+        assert.deepEqual(res.body, { error: 'Invalid JSON' });
+        assert.deepEqual(await UserRepo.getAll(), DUMMY_USERS);
       });
 
-      it.each([
+      const oversizedBodies = [
         [
           'application/json',
           JSON.stringify({ user: { name: 'a'.repeat(110000) } }),
@@ -153,15 +153,19 @@ describe('UserRouter', () => {
           'application/x-www-form-urlencoded',
           `user[name]=${'a'.repeat(110000)}`,
         ],
-      ])('returns 413 for an oversized %s body', async (contentType, body) => {
-        const res: TypedErrRes = await agent
-          .post(P.Add.CALL)
-          .set('Content-Type', contentType)
-          .send(body);
-        expect(res.status).toBe(HttpStatusCodes.PAYLOAD_TOO_LARGE);
-        expect(res.body).toStrictEqual({ error: 'Request body too large' });
-        expect(await UserRepo.getAll()).toStrictEqual(DUMMY_USERS);
-      });
+      ] as const;
+
+      for (const [contentType, body] of oversizedBodies) {
+        it(`returns 413 for an oversized ${contentType} body`, async () => {
+          const res: TypedErrRes = await agent
+            .post(P.Add.CALL)
+            .set('Content-Type', contentType)
+            .send(body);
+          assert.equal(res.status, HttpStatusCodes.PAYLOAD_TOO_LARGE);
+          assert.deepEqual(res.body, { error: 'Request body too large' });
+          assert.deepEqual(await UserRepo.getAll(), DUMMY_USERS);
+        });
+      }
     });
   });
 
@@ -171,10 +175,10 @@ describe('UserRouter', () => {
       it(`saves the change and returns status "${OK}"`, async () => {
         const user = { ...dbUsers[0], name: 'Bill' };
         const res = await agent.put(P.Update.CALL).send({ user });
-        expect(res.status).toBe(OK);
+        assert.equal(res.status, OK);
         const allUsers = await UserRepo.getAll();
         const saved = allUsers.find((u) => u.id === user.id);
-        expect(saved?.name).toBe('Bill');
+        assert.equal(saved?.name, 'Bill');
       });
     });
 
@@ -188,9 +192,9 @@ describe('UserRouter', () => {
           id: '5',
         };
         const res = await agent.put(P.Update.CALL).send({ user });
-        expect(res.status).toBe(BAD_REQUEST);
+        assert.equal(res.status, BAD_REQUEST);
         const errMsg = extractErrMsg(res);
-        expect(errMsg).toBe(errMsg);
+        assert.equal(errMsg, 'Not a valid uuid7 id');
       });
     });
 
@@ -198,8 +202,8 @@ describe('UserRouter', () => {
       it(`returns status "${NOT_FOUND}"`, async () => {
         const user = User.create({ name: 'a', email: 'a@a.com' });
         const res: TypedErrRes = await agent.put(P.Update.CALL).send({ user });
-        expect(res.status).toBe(NOT_FOUND);
-        expect(res.body.error).toBe(Errors.USER_NOT_FOUND);
+        assert.equal(res.status, NOT_FOUND);
+        assert.equal(res.body.error, Errors.USER_NOT_FOUND);
       });
     });
   });
@@ -211,9 +215,9 @@ describe('UserRouter', () => {
         const id = dbUsers[0].id;
         const path = P.Delete.CALL(id);
         const res = await agent.delete(path);
-        expect(res.status).toBe(OK);
+        assert.equal(res.status, OK);
         const persists = await UserRepo.persists(id);
-        expect(persists).toBe(false);
+        assert.equal(persists, false);
       });
     });
 
@@ -222,8 +226,8 @@ describe('UserRouter', () => {
         const id = User.genId();
         const path = P.Delete.CALL(id);
         const res: TypedErrRes = await agent.delete(path);
-        expect(res.status).toBe(NOT_FOUND);
-        expect(res.body.error).toBe(Errors.USER_NOT_FOUND);
+        assert.equal(res.status, NOT_FOUND);
+        assert.equal(res.body.error, Errors.USER_NOT_FOUND);
       });
     });
 
@@ -231,16 +235,16 @@ describe('UserRouter', () => {
       it(`returns status "${BAD_REQUEST}"`, async () => {
         const path = P.Delete.CALL('asdf');
         const res = await agent.delete(path);
-        expect(res.status).toBe(BAD_REQUEST);
+        assert.equal(res.status, BAD_REQUEST);
       });
     });
 
     describe('when the id path param is missing', () => {
       it(`returns status "${BAD_REQUEST}"`, async () => {
         const res = await agent.delete(P.Delete.FULL_PATH);
-        expect(res.status).toBe(BAD_REQUEST);
+        assert.equal(res.status, BAD_REQUEST);
         const errMsg = extractErrMsg(res);
-        expect(errMsg).toStrictEqual('Not a valid uuid7 id');
+        assert.equal(errMsg, 'Not a valid uuid7 id');
       });
     });
   });

package/lib/template/tsconfig.json

@@ -1,26 +1,23 @@
 {
   "compilerOptions": {
     "target": "ES2022",
-    "module": "esnext",
-    "moduleResolution": "bundler",
+    "module": "nodenext",
     "esModuleInterop": true,
     "lib": ["ES2022"],
     "strict": true,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
-    "paths": {
-      "@src/*": ["./src/*"]
-    },
-    // tsx transpiles one file at a time, so type-only imports must say so
+    // Node runs the .ts files directly and tsc only typechecks, so imports
+    // name the .ts files
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    // Node strips types one file at a time, so type-only imports must say so
+    // and syntax that needs compiling (enums, namespaces...) isn't allowed
     "verbatimModuleSyntax": true,
+    "erasableSyntaxOnly": true,
     "useUnknownInCatchVariables": false,
-    "types": ["node", "vitest/globals"]
+    "types": ["node"]
   },
-  "include": [
-    "src/**/*.ts",
-    "tests/**/*.ts",
-    "eslint.config.ts",
-    "vitest.config.ts"
-  ],
+  "include": ["src/**/*.ts", "tests/**/*.ts", "eslint.config.ts"],
   "exclude": ["src/public/*"]
 }

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "express-generator-typescript",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Generate new Express applications similar to express-generate which but sets it up to use TypeScript instead",
   "scripts": {
     "install:clean": "rm -rf node_modules && rm -rf package-lock.json && npm i",
     "test": "node --test \"tests/**/*.test.js\"",
     "test:e2e": "node scripts/e2e.js",
-    "_local:commit": "tsx --tsconfig ../my-tools/tsconfig.json ../my-tools/src/workflows/commit/run.ts",
+    "_local:commit": "node ../my-tools/src/workflows/commit/run.ts",
     "_local:commit:push": "npm run _local:commit -- -p",
-    "_local:squash-history": "tsx --tsconfig ../my-tools/tsconfig.json ../my-tools/src/workflows/squash-history/run.ts"
+    "_local:squash-history": "node ../my-tools/src/workflows/squash-history/run.ts"
   },
   "main": "lib/express-generator-typescript.js",
   "bin": {
@@ -26,7 +26,7 @@
     "!lib/template/src/repos/common/database.test.json"
   ],
   "engines": {
-    "node": "^22.13.0 || ^24.0.0 || >=26.0.0"
+    "node": "^22.18.0 || ^24.0.0 || >=26.0.0"
   },
   "repository": {
     "type": "git",
@@ -54,7 +54,6 @@
     "express5",
     "server",
     "tooling",
-    "vitest",
     "eslint"
   ],
   "author": "sean maxwell",

package/lib/template/tsconfig.prod.json

@@ -1,30 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "lib": ["ES2022"],
-    "strict": true,
-    "rootDir": "./src",
-    "outDir": "dist",
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "paths": {
-      "@src/*": ["./src/*"]
-    },
-    "verbatimModuleSyntax": true,
-    "useUnknownInCatchVariables": false,
-    "types": ["node"],
-    "sourceMap": false,
-    "removeComments": true
-  },
-  // After tsc, tsc-alias rewrites "@src/..." imports in dist/ to relative
-  // paths and adds the ".js" extensions Node's ESM loader requires (source
-  // imports are written without extensions)
-  "tsc-alias": {
-    "resolveFullPaths": true
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["src/public/"]
-}

package/lib/template/vitest.config.ts

@@ -1,25 +0,0 @@
-import path from 'path';
-import { defineConfig } from 'vitest/config';
-
-// ========================================================================= //
-//                                  EXPORT                                   //
-// ========================================================================= //
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    setupFiles: ['dotenv/config', './tests/support/agent.ts'],
-    isolate: true,
-    // All test files share one JSON database file, so run them one at a time
-    fileParallelism: false,
-    env: {
-      DOTENV_CONFIG_PATH: 'config/.env.test',
-    },
-  },
-  resolve: {
-    alias: {
-      '@src': path.resolve(import.meta.dirname, './src'),
-    },
-  },
-});