create-newt-app 0.31.9 → 0.32.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 //#region src/templates/types.d.ts
+type Nest = "on" | "off" | "di-only";
 type Extra = "anti-slop";
 //#endregion
 //#region src/index.d.ts
@@ -20,7 +21,7 @@ type Options = {
   database: Database;
   linter: Linter;
   deployment: Deployment;
-  nestDiOnly: boolean;
+  nest: Nest;
   includeExample: boolean;
   extras: readonly Extra[];
   explicitFlags: readonly string[];

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/templates/types.ts","../src/index.ts"],"mappings":";KAgCY;;;cCbN;cACA;cACA;cACA;KAGD,kBAAkB;KAClB,mBAAmB;KACnB,iBAAiB;KACjB,qBAAqB;KAcrB;EACH;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,UAAU;EACV,QAAQ;EACR,YAAY;EACZ;EACA;EACA,iBAAiB;EACjB;;iBAWoB,OAAO,SAAS,UAAO"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/templates/types.ts","../src/index.ts"],"mappings":";KAIY;KAgCA;;;cChBN;cACA;cACA;cACA;KAID,kBAAkB;KAClB,mBAAmB;KACnB,iBAAiB;KACjB,qBAAqB;KAcrB;EACH;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,UAAU;EACV,QAAQ;EACR,YAAY;EACZ,MAAM;EACN;EACA,iBAAiB;EACjB;;iBAWoB,OAAO,SAAS,UAAO"}

package/dist/index.js

@@ -11,7 +11,7 @@ import { existsSync, promises } from "fs";
 import path from "path";
 import https from "node:https";
 //#region package.json
-var version = "0.31.9";
+var version = "0.32.0";
 var engines = { "node": ">=24.0.0" };
 //#endregion
 //#region src/templates/root/index.ts
@@ -165,7 +165,7 @@ allowBuilds:
 		filename: "README.md",
 		template: `# <%= projectName %>
 
-Full-stack monorepo: Next.js 16 + NestJS 11 + better-auth + <%= database === 'postgres' ? 'Postgres' : 'SQLite' %>.
+Full-stack monorepo: Next.js 16<% if (nest !== 'off') { %> + NestJS 11<% } %> + better-auth + <%= database === 'postgres' ? 'Postgres' : 'SQLite' %>.
 
 ## Quick start
 
@@ -180,7 +180,11 @@ Open [http://localhost:3000](http://localhost:3000).
 ## Apps
 
 - **web**: Next.js frontend (port 3000)
+<% if (nest === 'on') { -%>
 - **api**: NestJS backend (port 3001)
+<% } else if (nest === 'di-only') { -%>
+- **api**: NestJS providers, resolved from the web process (no HTTP server)
+<% } -%>
 
 ## Packages
 
@@ -227,7 +231,7 @@ This version has breaking changes — APIs, conventions, and file structure may
 const web$1 = {
 	templates: [
 		{
-			when: (s) => !s.nestDiOnly,
+			when: (s) => s.nest !== "di-only",
 			filename: "apps/web/package.json",
 			template: `{
   "name": "web",
@@ -238,8 +242,7 @@ const web$1 = {
     "dev": "next dev --port 3000",
     "build": "next build",
     "start": "next start",
-    "typecheck": "next typegen && tsc --noEmit",
-    "db:migrate": "better-auth migrate"
+    "typecheck": "next typegen && tsc --noEmit"
   },
   "dependencies": {
     "@<%= projectName %>/auth": "workspace:*",
@@ -342,7 +345,7 @@ The easiest way to deploy your Next.js app is to use the [Vercel Platform](https
 Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.`
 		},
 		{
-			when: (s) => s.deployment === "none" && !s.nestDiOnly,
+			when: (s) => s.deployment === "none" && s.nest === "on",
 			filename: "apps/web/next.config.js",
 			template: `import dotenv from 'dotenv';
 import { resolve } from 'path';
@@ -370,7 +373,7 @@ export default nextConfig;`
 			template: `export { default } from "@<%= projectName %>/ui/postcss.config";`
 		},
 		{
-			when: (s) => !s.nestDiOnly,
+			when: (s) => s.nest !== "di-only",
 			filename: "apps/web/tsconfig.json",
 			template: `{
   "extends": "@<%= projectName %>/typescript-config/nextjs.json",
@@ -748,7 +751,7 @@ export const authClient: ReturnType<typeof createAuthClient> = createAuthClient(
 //#region src/templates/api/index.ts
 const api$1 = { templates: [
 	{
-		when: (s) => !s.nestDiOnly && s.deployment !== "spa",
+		when: (s) => s.nest === "on" && s.deployment !== "spa",
 		filename: "apps/api/package.json",
 		template: `{
   "name": "api",
@@ -797,7 +800,7 @@ const api$1 = { templates: [
 }`
 	},
 	{
-		when: (s) => !s.nestDiOnly,
+		when: (s) => s.nest === "on",
 		filename: "apps/api/tsconfig.json",
 		template: `{
   "compilerOptions": {
@@ -834,7 +837,7 @@ const api$1 = { templates: [
 }`
 	},
 	{
-		when: (s) => s.nestDiOnly && !s.todoExample,
+		when: (s) => s.nest === "di-only" && !s.todoExample,
 		filename: "apps/api/src/app.module.ts",
 		template: `import { Module } from '@nestjs/common';
 import { AppService } from './app.service';
@@ -887,7 +890,7 @@ NestJS backend for the monorepo.
 \`\`\`sh
 pnpm dev          # watch mode
 pnpm build        # production build
-pnpm test         # unit tests<% if (!nestDiOnly) { %>
+pnpm test         # unit tests<% if (nest === 'on') { %>
 pnpm test:e2e     # e2e tests<% } %>
 \`\`\``
 	}
@@ -10009,6 +10012,7 @@ export default nextJsConfig;`
 //#endregion
 //#region src/templates/api/templates/eslint-config.ts
 var eslint_config_default$1 = {
+	when: (s) => s.nest !== "off",
 	filename: "apps/api/eslint.config.mjs",
 	template: `// @ts-check
 import eslint from '@eslint/js';
@@ -10732,7 +10736,7 @@ describe('AppController (e2e)', () => {
 //#region src/templates/deployment-standalone/index.ts
 const deploymentStandalone = { templates: [
 	{
-		when: (s) => !s.nestDiOnly,
+		when: (s) => s.nest === "on",
 		filename: "Dockerfile",
 		template: `FROM node:24-alpine AS base
 ENV PNPM_HOME="/pnpm"
@@ -10770,7 +10774,7 @@ WORKDIR /app
 CMD ["pnpm", "db:migrate"]`
 	},
 	{
-		when: (s) => !s.nestDiOnly,
+		when: (s) => s.nest === "on",
 		filename: "docker-compose.yml",
 		template: `x-app-env: &app-env
   BETTER_AUTH_SECRET: \${BETTER_AUTH_SECRET}
@@ -10848,7 +10852,7 @@ volumes:
   db_data:`
 	},
 	{
-		when: (s) => !s.nestDiOnly,
+		when: (s) => s.nest === "on",
 		filename: "apps/web/next.config.js",
 		template: `import dotenv from 'dotenv';
 import { resolve } from 'path';
@@ -11098,8 +11102,7 @@ export async function GET() {
   "scripts": {
     "dev": "next dev --port 3000",
     "build": "next build",
-    "start": "next start",
-    "db:migrate": "better-auth migrate"
+    "start": "next start"
   },
   "dependencies": {
     "@<%= projectName %>/api": "workspace:*",
@@ -11183,8 +11186,38 @@ export default nextConfig;`
 	}
 ] };
 //#endregion
-//#region src/templates/deployment-standalone-di/index.ts
-const deploymentStandaloneDi = { templates: [
+//#region src/templates/nest-off/index.ts
+const nestOff = { templates: [{
+	when: (s) => s.deployment === "none",
+	filename: "apps/web/next.config.js",
+	template: `import dotenv from 'dotenv';
+import { resolve } from 'path';
+
+// Load root .env first, then local .env (local takes precedence)
+dotenv.config({ path: resolve(process.cwd(), '../../.env') });
+dotenv.config({ path: resolve(process.cwd(), '.env') });
+
+// No /api rewrite: there is no second process, so Next serves /api itself.
+/** @type {import('next').NextConfig} */
+const nextConfig = {};
+
+export default nextConfig;`
+}, {
+	filename: "apps/web/app/api/hello/route.ts",
+	template: `import { NextResponse } from 'next/server';
+import { headers } from 'next/headers';
+import { auth } from '@<%= projectName %>/auth';
+
+export async function GET() {
+  const session = await auth.api.getSession({ headers: await headers() });
+  return NextResponse.json({
+    message: session?.user.name ? \`Hello \${session.user.name}\` : 'Hello from Next',
+  });
+}`
+}] };
+//#endregion
+//#region src/templates/deployment-standalone-web/index.ts
+const deploymentStandaloneWeb = { templates: [
 	{
 		filename: "Dockerfile",
 		template: `FROM node:24-alpine AS base
@@ -11196,11 +11229,11 @@ FROM base AS build
 WORKDIR /app
 COPY . .
 RUN pnpm install --frozen-lockfile
-RUN pnpm build --filter=web --filter=@<%= projectName %>/api --filter=@<%= projectName %>/auth
+RUN pnpm build --filter=web<% if (nest === 'di-only') { %> --filter=@<%= projectName %>/api<% } %> --filter=@<%= projectName %>/auth
 
 # --- web ---
-# DI-only has no api entrypoint: Nest is wired into this image through the
-# Next.js server, so there is no separate api stage.
+# One image: <% if (nest === 'di-only') { %>Nest is wired into the Next.js server rather than bootstrapped
+# on its own port<% } else { %>Next.js serves /api itself<% } %>, so there is no separate api stage.
 FROM base AS web
 WORKDIR /app
 ENV NODE_ENV=production
@@ -11285,11 +11318,11 @@ import { resolve } from 'path';
 dotenv.config({ path: resolve(process.cwd(), '../../.env') });
 dotenv.config({ path: resolve(process.cwd(), '.env') });
 
-// No /api rewrite: DI-only runs Nest inside this process, so Next serves
-// /api itself and there is no separate api container to proxy to.
+// No /api rewrite: Next serves /api itself, so there is no api container to
+// proxy to.
 /** @type {import('next').NextConfig} */
 const nextConfig = {
-  output: "standalone",
+  output: "standalone",<% if (nest === 'di-only') { %>
   serverExternalPackages: [
     '@<%= projectName %>/api',
     '@<%= projectName %>/db',
@@ -11300,7 +11333,7 @@ const nextConfig = {
     '@thallesp/nestjs-better-auth',
     'reflect-metadata',
     'express',
-  ],
+  ],<% } %>
 };
 
 export default nextConfig;`
@@ -11358,7 +11391,7 @@ describe('AppController', () => {
 });`
 	},
 	{
-		when: (s) => !s.nestDiOnly && !s.todoExample,
+		when: (s) => s.nest === "on" && !s.todoExample,
 		filename: "apps/api/src/app.module.ts",
 		template: `<% if (deployment === 'spa') { %>import { join } from 'path';
 <% } %>import { Module } from '@nestjs/common';
@@ -11411,7 +11444,7 @@ void bootstrap();`
 //#endregion
 //#region src/templates/todo-example/templates/todos-module.ts
 var todos_module_default = {
-	when: (s) => s.nestDiOnly,
+	when: (s) => s.nest === "di-only",
 	filename: "apps/api/src/todos/todos.module.ts",
 	template: `import { Module } from '@nestjs/common';
 import { TodosService } from './todos.service';
@@ -11671,7 +11704,7 @@ export class TodosModule {}`
 //#endregion
 //#region src/templates/todo-example/templates/app-module-controllers.ts
 var app_module_controllers_default = {
-	when: (s) => !s.nestDiOnly && s.todoExample,
+	when: (s) => s.nest === "on" && s.todoExample,
 	filename: "apps/api/src/app.module.ts",
 	template: `<% if (deployment === 'spa') { %>import { join } from 'path';
 <% } %>import { Module } from '@nestjs/common';
@@ -11702,7 +11735,7 @@ export class AppModule {}`
 //#endregion
 //#region src/templates/todo-example/templates/app-module-di.ts
 var app_module_di_default = {
-	when: (s) => s.nestDiOnly && s.todoExample,
+	when: (s) => s.nest === "di-only" && s.todoExample,
 	filename: "apps/api/src/app.module.ts",
 	template: `import { Module } from '@nestjs/common';
 import { AppService } from './app.service';
@@ -12306,35 +12339,36 @@ const E2E_FILES = [
 	"apps/api/vitest.config.e2e.mts"
 ];
 function selectModules(selection) {
-	const { deployment, nestDiOnly: nestDiOnly$1, todoExample, shadcn, database, linter, testing, extras } = selection;
+	const { deployment, nest, todoExample, shadcn, database, linter, testing, extras } = selection;
 	const deploymentModule = deployment === "standalone" ? deploymentStandalone : deployment === "spa" ? singleProcessStaticExport : null;
 	const webModule = deployment === "spa" ? {
 		...web$1,
 		templates: web$1.templates.filter((t) => t.filename !== "apps/web/app/api/auth/[...all]/route.ts")
 	} : web$1;
 	const selectedTesting = testing === "vitest" ? testingVitest : testingJest;
-	const testingModule = nestDiOnly$1 ? {
+	const testingModule = nest === "off" ? null : nest === "di-only" ? {
 		...selectedTesting,
 		templates: selectedTesting.templates.filter((t) => !E2E_FILES.includes(t.filename)),
 		scripts: selectedTesting.scripts?.filter((s) => s.name !== "test:e2e")
 	} : selectedTesting;
+	const nestModule = nest === "di-only" ? nestDiOnly : nest === "off" ? nestOff : apiControllers;
 	return [
 		root$2,
 		webModule,
-		api$1,
+		...nest === "off" ? [] : [api$1],
 		database === "postgres" ? dbPostgres : dbSqlite,
 		auth,
 		shadcn ? shadcnUi : ui$1,
 		linter === "oxc" ? oxc : eslintConfig,
 		...extras.includes("anti-slop") ? [antiSlop] : [],
 		typescriptConfig,
-		testingModule,
+		...testingModule ? [testingModule] : [],
 		...deploymentModule ? [deploymentModule] : [],
-		...nestDiOnly$1 ? [nestDiOnly] : [apiControllers],
-		...nestDiOnly$1 && deployment === "standalone" ? [deploymentStandaloneDi] : [],
+		nestModule,
+		...nest !== "on" && deployment === "standalone" ? [deploymentStandaloneWeb] : [],
 		...todoExample ? [
 			todoExampleApi,
-			...nestDiOnly$1 ? [todoExampleDi] : [todoExampleControllers],
+			...nest === "di-only" ? [todoExampleDi] : [todoExampleControllers],
 			shadcn ? todoExampleShadcn : todoExampleWeb
 		] : []
 	];
@@ -12442,10 +12476,21 @@ function validateExtrasCombo(extras, linter) {
 	};
 	return { valid: true };
 }
-function validateDeploymentCombo(deployment, nestDiOnly) {
-	if (deployment === "spa" && nestDiOnly) return {
+function validateDeploymentCombo(deployment, nest) {
+	if (deployment === "spa" && nest === "di-only") return {
+		valid: false,
+		error: "--deployment spa cannot be combined with --nest di-only.\nSPA mode statically exports Next.js (output: 'export'), which cannot include the\nAPI route handlers that di-only mode depends on. Pick one: --nest on to get SPA\nmode with NestJS controllers, or drop --deployment spa."
+	};
+	if (deployment === "spa" && nest === "off") return {
 		valid: false,
-		error: "--deployment spa cannot be combined with --nest-di-only.\nSPA mode statically exports Next.js (output: 'export'), which cannot include the\nAPI route handlers that DI-only mode depends on. Pick one: drop --nest-di-only to\nget SPA mode with NestJS controllers, or drop --deployment spa."
+		error: "--deployment spa cannot be combined with --nest off.\nSPA mode statically exports Next.js and hands the output to NestJS to serve, so\nthere is nothing left to serve it. Pick one: --nest on, or drop --deployment spa."
+	};
+	return { valid: true };
+}
+function validateExampleCombo(todoExample, nest) {
+	if (todoExample && nest === "off") return {
+		valid: false,
+		error: "--include-example cannot be combined with --nest off.\nThe todo example is a Nest module: an @Injectable service plus either a controller\nor a Next.js route handler that resolves it. Pick one: --nest on or --nest di-only,\nor drop --include-example."
 	};
 	return { valid: true };
 }
@@ -12502,7 +12547,7 @@ async function scaffold(modules, options) {
 	}
 	const templateData = {
 		projectName: options.name,
-		nestDiOnly: options.selection.nestDiOnly,
+		nest: options.selection.nest,
 		testing: options.testing,
 		database: options.database,
 		deployment: options.deployment,
@@ -12590,7 +12635,7 @@ function buildPayload(report) {
 		database: selection.database,
 		linter: selection.linter,
 		deployment: selection.deployment,
-		nestDiOnly: selection.nestDiOnly,
+		nest: selection.nest,
 		todoExample: selection.todoExample,
 		antiSlop: selection.extras.includes("anti-slop")
 	};
@@ -12635,6 +12680,11 @@ const DEPLOYMENT_CHOICES = [
 	"standalone",
 	"spa"
 ];
+const NEST_CHOICES = [
+	"on",
+	"off",
+	"di-only"
+];
 const EXTRAS_CHOICES = ["anti-slop"];
 var TaskBuilder = class {
 	tasks = [];
@@ -12654,7 +12704,28 @@ async function doInit(options) {
 				message: "Use shadcn/ui?",
 				initialValue: true
 			}),
-			testing: () => p.select({
+			nest: () => p.select({
+				message: "NestJS?",
+				options: [
+					{
+						value: "on",
+						label: "On",
+						hint: "apps/api on port 3001"
+					},
+					{
+						value: "di-only",
+						label: "DI only",
+						hint: "no HTTP server; Next.js route handlers inject its services"
+					},
+					{
+						value: "off",
+						label: "Off",
+						hint: "no apps/api; Next.js owns the backend"
+					}
+				],
+				initialValue: "on"
+			}),
+			testing: ({ results }) => results.nest === "off" ? void 0 : p.select({
 				message: "Testing framework?",
 				options: [{
 					value: "jest",
@@ -12696,11 +12767,7 @@ async function doInit(options) {
 				}],
 				required: false
 			}) : void 0,
-			nestDiOnly: () => p.confirm({
-				message: "Use NestJS for dependency injection only?",
-				initialValue: false
-			}),
-			todoExample: () => p.confirm({
+			todoExample: ({ results }) => results.nest === "off" ? void 0 : p.confirm({
 				message: "Include the todo example?",
 				initialValue: true
 			}),
@@ -12717,11 +12784,11 @@ async function doInit(options) {
 						label: "Standalone + Dockerfile",
 						hint: "Dockerfiles + docker-compose.yml"
 					},
-					...results.nestDiOnly ? [] : [{
+					...results.nest === "on" ? [{
 						value: "spa",
 						label: "SPA Mode",
 						hint: "static export served by NestJS"
-					}]
+					}] : []
 				],
 				initialValue: "none"
 			})
@@ -12746,16 +12813,18 @@ async function doInit(options) {
 		const database = options.nonInteractive ? options.database : answers.database ?? "sqlite";
 		const linter = options.nonInteractive ? options.linter : answers.linter ?? "eslint";
 		const deployment = options.nonInteractive ? options.deployment : answers.deployment ?? "none";
-		const nestDiOnly = options.nonInteractive ? options.nestDiOnly : answers.nestDiOnly ?? false;
-		const todoExample = options.nonInteractive ? options.includeExample : answers.todoExample ?? true;
+		const nest = options.nonInteractive ? options.nest : answers.nest ?? "on";
+		const todoExample = options.nonInteractive ? options.includeExample : nest !== "off" && (answers.todoExample ?? true);
 		const extras = options.nonInteractive ? options.extras : answers.extras ?? [];
-		const deploymentCombo = validateDeploymentCombo(deployment, nestDiOnly);
+		const deploymentCombo = validateDeploymentCombo(deployment, nest);
 		if (!deploymentCombo.valid) throw new Error(deploymentCombo.error);
+		const exampleCombo = validateExampleCombo(todoExample, nest);
+		if (!exampleCombo.valid) throw new Error(exampleCombo.error);
 		const extrasCombo = validateExtrasCombo(extras, linter);
 		if (!extrasCombo.valid) throw new Error(extrasCombo.error);
 		const selection = {
 			deployment,
-			nestDiOnly,
+			nest,
 			todoExample,
 			shadcn: useShadcn,
 			database,
@@ -12826,7 +12895,7 @@ async function doInit(options) {
 	}
 }
 const program = new Command();
-program.name("create-newt-app").version(version).description("Create a new newt-app monorepo").argument("[name]").option("-ni, --no-install", "Skip pnpm install", true).option("-ng, --no-git", "Skip git initialization", true).option("--shadcn", "Include shadcn/ui", false).option("--testing <framework>", "Testing framework: vitest or jest", "jest").option("--database <database>", "Database: sqlite or postgres", "sqlite").option("--linter <linter>", "Linter: eslint or oxc", "eslint").option("--deployment <strategy>", "Deployment: none, standalone, or spa", "none").option("--nest-di-only", "Use NestJS for dependency injection only", false).option("--include-example", "Include the todo example", false).option("--extras <list>", "Extras, comma-separated: anti-slop", "").action(async (name, options, command) => {
+program.name("create-newt-app").version(version).description("Create a new newt-app monorepo").argument("[name]").option("-ni, --no-install", "Skip pnpm install", true).option("-ng, --no-git", "Skip git initialization", true).option("--shadcn", "Include shadcn/ui", false).option("--testing <framework>", "Testing framework: vitest or jest", "jest").option("--database <database>", "Database: sqlite or postgres", "sqlite").option("--linter <linter>", "Linter: eslint or oxc", "eslint").option("--deployment <strategy>", "Deployment: none, standalone, or spa", "none").option("--nest <mode>", "NestJS: on, off, or di-only", "on").option("--include-example", "Include the todo example", false).option("--extras <list>", "Extras, comma-separated: anti-slop", "").action(async (name, options, command) => {
 	intro(`Create a ${chalk.blue("newt")} app.`);
 	const explicitFlags = Object.entries({
 		shadcn: "--shadcn",
@@ -12834,7 +12903,7 @@ program.name("create-newt-app").version(version).description("Create a new newt-
 		database: "--database",
 		linter: "--linter",
 		deployment: "--deployment",
-		nestDiOnly: "--nest-di-only",
+		nest: "--nest",
 		includeExample: "--include-example",
 		extras: "--extras"
 	}).filter(([option]) => command.getOptionValueSource(option) === "cli").map(([, flag]) => flag);
@@ -12861,6 +12930,11 @@ program.name("create-newt-app").version(version).description("Create a new newt-
 			value: options.deployment,
 			allowed: DEPLOYMENT_CHOICES
 		},
+		{
+			flag: "--nest",
+			value: options.nest,
+			allowed: NEST_CHOICES
+		},
 		...extras.map((extra) => ({
 			flag: "--extras",
 			value: extra,
@@ -12881,7 +12955,7 @@ program.name("create-newt-app").version(version).description("Create a new newt-
 		database: options.database,
 		linter: options.linter,
 		deployment: options.deployment,
-		nestDiOnly: options.nestDiOnly,
+		nest: options.nest,
 		includeExample: options.includeExample,
 		extras,
 		explicitFlags