@nest-arch/tui 0.4.5 → 0.5.0

package/dist/templates/monorepo/apps/api-gateway/src/main.ts.hbs

@@ -41,9 +41,7 @@ async function bootstrap() {
       docsPath,
       apiReference({
         content: await createDocs(app, {
-          title: "{{projectNamePascalCase}} API",
           description: "{{description}}",
-          version: "1.0.0",
           integrations: {
             {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
             betterAuth: {
@@ -53,7 +51,7 @@ async function bootstrap() {
             {{/if}}
             {{#if (includes apis "trpc")}}
             trpc: {
-              routerFilePath: "./src/libs/trpc/@generated/server.ts",
+              routerFilePath: "./{{trpcGeneratePath}}/server.ts",
               pathPrefix: "/trpc",
             },
             {{/if}}
@@ -61,16 +59,17 @@ async function bootstrap() {
               withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
             },
           },
-        }),
-        pageTitle: "{{projectNamePascalCase}} API Docs",
+          title: "{{projectNamePascalCase}} API",
+          version: "1.0.0",
+      }),
+      {{#if (eq httpProvider "fastify")}}withFastify: true,{{/if}}
+      pageTitle: "{{projectNamePascalCase}} API Docs",
         theme: "default",
       }),
     );
     {{else}}
     const document = await createDocs(app, {
-      title: "{{projectNamePascalCase}} API",
       description: "{{description}}",
-      version: "1.0.0",
       integrations: {
         {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
         betterAuth: {
@@ -80,7 +79,7 @@ async function bootstrap() {
         {{/if}}
         {{#if (includes apis "trpc")}}
         trpc: {
-          routerFilePath: "./src/trpc/router.ts",
+          routerFilePath: "./{{trpcGeneratePath}}/server.ts",
           pathPrefix: "/trpc",
         },
         {{/if}}
@@ -88,13 +87,15 @@ async function bootstrap() {
           withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
         },
       },
+      title: "{{projectNamePascalCase}} API",
+      version: "1.0.0",
     });
     SwaggerModule.setup(docsPath, app, document);
     {{/if}}
     Logger.log(`Swagger documentation available at http://localhost:${env.PORT ?? 3000}${docsPath}`, "SwaggerDocs");
   }
   {{/if}}
-  await app.listen(env.PORT ?? 3000);
+  await app.listen(env.PORT ?? 3000, "0.0.0.0");
   {{#if hasRest}}
   Logger.log(`Started backend server on http://localhost:${env.PORT ?? 3000}/api`, "Main");
   {{else if hasTrpc}}

package/dist/templates/monorepo/root/README.md.hbs

@@ -4,10 +4,14 @@
 
 ## Setup
 
+{{#if setupInstructions}}
+{{{setupInstructions}}}
+{{else}}
 ```bash
 # Install dependencies
 {{#if isPnpm}}pnpm install{{else if isYarn}}yarn install{{else if isBun}}bun install{{else}}npm install{{/if}}
 ```
+{{/if}}
 
 ## Running the App
 
@@ -35,20 +39,11 @@
 {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
 ## Auth Setup
 
-This project uses **Better Auth**. Generate the database schema by running:
-
-```bash
-{{#if isPnpm}}pnpm dlx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y && pnpm run prisma:format{{else if isYarn}}yarn dlx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y && yarn run prisma:format && pnpm run prisma:format{{else if isBun}}bun x auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y && bun run prisma:format{{else}}npx auth@latest generate --config src/auth/auth.ts --output src/database/orm/prisma/schema.prisma -y && npm run prisma:format{{/if}}
-```
-
-{{#if useDrizzle}}Then run Drizzle migrations:
-
-```bash
-{{#if isPnpm}}pnpm drizzle-kit generate && pnpm drizzle-kit migrate{{else if isYarn}}yarn drizzle-kit generate && yarn drizzle-kit migrate{{else}}npx drizzle-kit generate && npx drizzle-kit migrate{{/if}}
-```
-
+{{#if (eq auth "better-auth:stateless")}}
+Configure the Better Auth secret, URL and external OIDC provider settings. Register the callback URL with your provider. Stateless auth requires no authentication schema generation or database migration.
+{{else}}
+Follow the ordered steps in Setup. Run the generated `auth:generate` script in `apps/api-gateway` before applying the database schema and regenerating Prisma Client in `packages/db`. The script uses the installed CLI version and preserves application-owned models.
 {{/if}}
-See https://better-auth.com/docs/adapters/prisma for more details.
 
 ### Usage
 

package/dist/templates/single-project/architecture/nest-api/.env.hbs

@@ -1,4 +1,4 @@
-CORS_ORIGIN=http://localhost:3001
+CORS_ORIGIN=http://localhost:3000
 PORT=3000
 {{#if hasGraphql}}
 GRAPHQL_PLAYGROUND=true
@@ -13,10 +13,23 @@ MYSQL_URL=mysql://root:mysql@localhost:3306/{{projectNameKebab}}_db
 {{#if hasSqlite}}
 SQLITE_PATH=file:./src/database/dev.db
 {{/if}}
+{{#if hasSqlserver}}
+SQLSERVER_HOST=localhost
+SQLSERVER_PORT=1433
+SQLSERVER_DATABASE={{projectNameKebab}}_db
+SQLSERVER_USER=sa
+SQLSERVER_PASSWORD=DevOnly_Strong_Password_2026!X9
+SQLSERVER_ENCRYPT=true
+SQLSERVER_TRUST_SERVER_CERTIFICATE=true
+{{/if}}
 {{#if hasMongodb}}
 MONGODB_URL=mongodb://localhost:27017/{{projectNameKebab}}_db
 {{/if}}
-{{#if (eq auth "passport")}}
+{{#if (and (eq auth "passport") (not hasDatabase))}}
+OIDC_JWKS_URI=https://identity.example.com/.well-known/jwks.json
+OIDC_ISSUER=https://identity.example.com/
+OIDC_AUDIENCE=generated-resource-server
+{{else if (eq auth "passport")}}
 JWT_ACCESS_SECRET=change-me-to-a-random-secret-at-least-32-characters-long
 {{#if hasDatabase}}
 JWT_REFRESH_SECRET=change-me-to-a-different-random-secret-at-least-32-characters

package/dist/templates/single-project/architecture/nest-api/pnpm-workspace.yaml.hbs

@@ -12,5 +12,11 @@ allowBuilds:
 {{#if hasSqlite}}
   better-sqlite3: true
 {{/if}}
+{{#if hasTrpc}}
+peerDependencyRules:
+  allowedVersions:
+    "nestjs-trpc>@nestjs/common": "^12.0.0"
+    "nestjs-trpc>@nestjs/core": "^12.0.0"
+{{/if}}
 catalog:
   dotenv: ^17.2.2

package/dist/templates/single-project/architecture/nest-api/src/main.ts.hbs

@@ -61,9 +61,7 @@ async function bootstrap() {
       docsPath,
       apiReference({
         content: await createDocs(app, {
-          title: "{{projectNamePascalCase}} API",
           description: "{{description}}",
-          version: "1.0.0",
           integrations: {
             {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
             betterAuth: {
@@ -73,24 +71,25 @@ async function bootstrap() {
             {{/if}}
             {{#if (includes apis "trpc")}}
             trpc: {
-              routerFilePath: "./src/trpc/router.ts",
               pathPrefix: "/trpc",
+              routerFilePath: "./{{trpcGeneratePath}}/server.ts",
             },
             {{/if}}
             zod: {
               withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
             },
           },
-        }),
-        pageTitle: "{{projectNamePascalCase}} API Docs",
+          title: "{{projectNamePascalCase}} API",
+          version: "1.0.0",
+      }),
+      {{#if (eq httpProvider "fastify")}}withFastify: true,{{/if}}
+      pageTitle: "{{projectNamePascalCase}} API Docs",
         theme: "default",
       }),
     );
     {{else}}
     const document = await createDocs(app, {
-      title: "{{projectNamePascalCase}} API",
       description: "{{description}}",
-      version: "1.0.0",
       integrations: {
         {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
         betterAuth: {
@@ -100,14 +99,16 @@ async function bootstrap() {
         {{/if}}
         {{#if (includes apis "trpc")}}
         trpc: {
-          routerFilePath: "./src/trpc/router.ts",
           pathPrefix: "/trpc",
+          routerFilePath: "./{{trpcGeneratePath}}/server.ts",
         },
         {{/if}}
         zod: {
           withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
         },
       },
+      title: "{{projectNamePascalCase}} API",
+      version: "1.0.0",
     });
     SwaggerModule.setup(docsPath, app, document);
     {{/if}}
@@ -115,7 +116,7 @@ async function bootstrap() {
   }
   {{/if}}
 
-  await app.listen(env.PORT);
+  await app.listen(env.PORT, "0.0.0.0");
   {{#if hasRest}}
   Logger.log(`Started backend server on http://localhost:${env.PORT}/api`, "Main");
   {{else if hasTrpc}}

package/dist/templates/single-project/architecture/nest-gateway/src/main.ts.hbs

@@ -33,9 +33,7 @@ async function bootstrap() {
       docsPath,
       apiReference({
         content: await createDocs(app, {
-          title: "{{projectNamePascalCase}} API",
           description: "{{description}}",
-          version: "1.0.0",
           integrations: {
             {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
             betterAuth: {
@@ -45,7 +43,7 @@ async function bootstrap() {
             {{/if}}
             {{#if (includes apis "trpc")}}
             trpc: {
-              routerFilePath: "./src/trpc/router.ts",
+              routerFilePath: "./{{trpcGeneratePath}}/server.ts",
               pathPrefix: "/trpc",
             },
             {{/if}}
@@ -53,16 +51,17 @@ async function bootstrap() {
               withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
             },
           },
-        }),
-        pageTitle: "{{projectNamePascalCase}} API Docs",
+          title: "{{projectNamePascalCase}} API",
+          version: "1.0.0",
+      }),
+      {{#if (eq httpProvider "fastify")}}withFastify: true,{{/if}}
+      pageTitle: "{{projectNamePascalCase}} API Docs",
         theme: "default",
       }),
     );
     {{else}}
     const document = await createDocs(app, {
-      title: "{{projectNamePascalCase}} API",
       description: "{{description}}",
-      version: "1.0.0",
       integrations: {
         {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
         betterAuth: {
@@ -72,7 +71,7 @@ async function bootstrap() {
         {{/if}}
         {{#if (includes apis "trpc")}}
         trpc: {
-          routerFilePath: "./src/trpc/router.ts",
+          routerFilePath: "./{{trpcGeneratePath}}/server.ts",
           pathPrefix: "/trpc",
         },
         {{/if}}
@@ -80,6 +79,8 @@ async function bootstrap() {
           withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
         },
       },
+      title: "{{projectNamePascalCase}} API",
+      version: "1.0.0",
     });
     SwaggerModule.setup(docsPath, app, document);
     {{/if}}
@@ -87,7 +88,7 @@ async function bootstrap() {
   }
   {{/if}}
 
-  await app.listen(env.PORT ?? 3000);
+  await app.listen(env.PORT ?? 3000, "0.0.0.0");
   {{#if hasRest}}
   Logger.log(`Started backend server on http://localhost:${env.PORT ?? 3000}/api`, "Main");
   {{else if hasTrpc}}

package/dist/templates/single-project/architecture/nest-microservice/.env.hbs

@@ -2,21 +2,27 @@ PORT=3000
 MICROSERVICE_PORT=3001
 CORS_ORIGIN=http://localhost:3001
 {{#if (includes microservices "redis")}}
+REDIS_PORT=6379
 REDIS_URL=redis://127.0.0.1:6379
 {{/if}}
 {{#if (includes microservices "mqtt")}}
+MQTT_PORT=1883
 MQTT_URL=mqtt://127.0.0.1:1883
 {{/if}}
 {{#if (includes microservices "nats")}}
+NATS_PORT=4222
 NATS_URL=nats://127.0.0.1:4222
 {{/if}}
 {{#if (includes microservices "rabbitmq")}}
+RABBITMQ_PORT=5672
 RABBITMQ_URL=amqp://127.0.0.1:5672
 {{/if}}
 {{#if (includes microservices "kafka")}}
+KAFKA_PORT=9092
 KAFKA_BROKER=127.0.0.1:9092
 {{/if}}
 {{#if (includes microservices "grpc")}}
+GRPC_PORT=5000
 GRPC_URL=0.0.0.0:5000
 {{/if}}
 {{#if hasGraphql}}

package/dist/templates/single-project/architecture/nest-microservice/src/app.controller.ts.hbs

@@ -9,11 +9,11 @@ import { EventPattern, MessagePattern } from "@nestjs/microservices";
 import { AppService } from "./app.service.js";
 
 {{#unless (includes microservices "grpc")}}
-type AuditEvent = {
+interface AuditEvent {
   id: string;
   payload: Record<string, unknown>;
   source: string;
-};
+}
 
 const isAuditEvent = (value: unknown): value is AuditEvent => {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {

package/dist/templates/single-project/architecture/nest-microservice/src/app.module.ts.hbs

@@ -1,4 +1,8 @@
 import { Module } from "@nestjs/common";
+{{#if hasRateLimiting}}
+import { APP_GUARD } from "@nestjs/core";
+import { ThrottlerModule } from "@nestjs/throttler";
+{{/if}}
 {{#if (or hasDatabase hasOrm)}}
 import { DbModule } from "./database/db.module.js";
 import { env } from "./config/env.js";
@@ -9,6 +13,15 @@ import { AuthModule } from "./auth/auth.module.js";
 
 import { AppController } from "./app.controller.js";
 import { AppService } from "./app.service.js";
+{{#if hasRateLimiting}}
+import { HttpThrottlerGuard } from "./http-throttler.guard.js";
+{{/if}}
+{{#if (and hasRest hasTodoExample)}}
+import { TodoModule } from "./api/todo/todo.module.js";
+{{/if}}
+{{#if hasHealthCheck}}
+import { HealthModule } from "./health/health.module.js";
+{{/if}}
 
 @Module({
   controllers: [AppController],
@@ -24,7 +37,21 @@ import { AppService } from "./app.service.js";
     {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
     AuthModule,
     {{/if}}
+    {{#if hasRateLimiting}}
+    ThrottlerModule.forRoot([{ limit: 60, ttl: 60_000 }]),
+    {{/if}}
+    {{#if (and hasRest hasTodoExample)}}
+    TodoModule,
+    {{/if}}
+    {{#if hasHealthCheck}}
+    HealthModule,
+    {{/if}}
+  ],
+  providers: [
+    AppService,
+    {{#if hasRateLimiting}}
+    { provide: APP_GUARD, useClass: HttpThrottlerGuard },
+    {{/if}}
   ],
-  providers: [AppService],
 })
 export class AppModule {}

package/dist/templates/single-project/architecture/nest-microservice/src/http-throttler.guard.ts.hbs

@@ -0,0 +1,13 @@
+import { Injectable } from "@nestjs/common";
+import type { ExecutionContext } from "@nestjs/common";
+import { ThrottlerGuard } from "@nestjs/throttler";
+
+@Injectable()
+export class HttpThrottlerGuard extends ThrottlerGuard {
+  canActivate(context: ExecutionContext): Promise<boolean> {
+    if (context.getType() !== "http") {
+      return Promise.resolve(true);
+    }
+    return super.canActivate(context);
+  }
+}

package/dist/templates/single-project/architecture/nest-microservice/src/main.ts.hbs

@@ -68,9 +68,7 @@ async function bootstrap() {
       docsPath,
       apiReference({
         content: await createDocs(app, {
-          title: "{{projectNamePascalCase}} API",
           description: "{{description}}",
-          version: "1.0.0",
           integrations: {
             {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
             betterAuth: {
@@ -80,7 +78,7 @@ async function bootstrap() {
             {{/if}}
             {{#if (includes apis "trpc")}}
             trpc: {
-              routerFilePath: "./src/trpc/router.ts",
+              routerFilePath: "./{{trpcGeneratePath}}/server.ts",
               pathPrefix: "/trpc",
             },
             {{/if}}
@@ -88,16 +86,17 @@ async function bootstrap() {
               withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
             },
           },
-        }),
-        pageTitle: "{{projectNamePascalCase}} API Docs",
+          title: "{{projectNamePascalCase}} API",
+          version: "1.0.0",
+      }),
+      {{#if (eq httpProvider "fastify")}}withFastify: true,{{/if}}
+      pageTitle: "{{projectNamePascalCase}} API Docs",
         theme: "default",
       }),
     );
     {{else}}
     const document = await createDocs(app, {
-      title: "{{projectNamePascalCase}} API",
       description: "{{description}}",
-      version: "1.0.0",
       integrations: {
         {{#if (or (eq auth "better-auth") (eq auth "better-auth:stateless"))}}
         betterAuth: {
@@ -107,7 +106,7 @@ async function bootstrap() {
         {{/if}}
         {{#if (includes apis "trpc")}}
         trpc: {
-          routerFilePath: "./src/trpc/router.ts",
+          routerFilePath: "./{{trpcGeneratePath}}/server.ts",
           pathPrefix: "/trpc",
         },
         {{/if}}
@@ -115,6 +114,8 @@ async function bootstrap() {
           withFastify: {{#if (eq httpProvider "fastify")}}true{{else}}false{{/if}},
         },
       },
+      title: "{{projectNamePascalCase}} API",
+      version: "1.0.0",
     });
     SwaggerModule.setup(docsPath, app, document);
     {{/if}}
@@ -123,7 +124,7 @@ async function bootstrap() {
   {{/if}}
 
   await app.startAllMicroservices();
-  await app.listen(env.PORT ?? 3000);
+  await app.listen(env.PORT ?? 3000, "0.0.0.0");
   {{#if hasRest}}
   Logger.log(`Started backend server on http://localhost:${env.PORT ?? 3000}/api`, "Main");
   {{else if hasTrpc}}

package/dist/templates/single-project/architecture/nest-microservice/test/microservice.e2e-spec.ts.hbs

@@ -6,6 +6,9 @@ import { Test } from "@nestjs/testing";
 import { setTimeout as delay } from "node:timers/promises";
 import request from "supertest";
 {{/unless}}
+{{#if (and (includes microservices "grpc") (or hasTodoExample hasHealthCheck hasRateLimiting))}}
+import request from "supertest";
+{{/if}}
 import { firstValueFrom } from "rxjs";
 {{#if (includes microservices "grpc")}}
 import type { Observable } from "rxjs";
@@ -96,6 +99,38 @@ it("sends ping through the selected message transport", async () => {
   {{/if}}
 }, 60_000);
 
+{{#if (or hasTodoExample hasHealthCheck hasRateLimiting)}}
+it("serves the selected HTTP extras alongside the message transport", async () => {
+  const server = app.getHttpServer();
+{{#if hasTodoExample}}
+  const created = await request(server)
+    .post("/api/todos")
+    .send({ completed: false, title: "Microservice todo" })
+    .expect(201);
+  const todo = created.body as { id: string };
+  const listed = await request(server).get("/api/todos").expect(200);
+  expect(listed.body).toEqual(
+    expect.arrayContaining([expect.objectContaining({ id: todo.id })])
+  );
+  await request(server)
+    .put(`/api/todos/${todo.id}`)
+    .send({ completed: true })
+    .expect(200);
+  await request(server).delete(`/api/todos/${todo.id}`).expect(200);
+{{/if}}
+{{#if hasHealthCheck}}
+  const health = await request(server).get("/api/health").expect(200);
+  expect(health.body.info.app.status).toBe("up");
+{{/if}}
+{{#if hasRateLimiting}}
+  const responses = await Promise.all(
+    Array.from({ length: 80 }, () => request(server).get("/api"))
+  );
+  expect(responses.some((response) => response.status === 429)).toBe(true);
+{{/if}}
+}, 60_000);
+{{/if}}
+
 afterAll(async () => {
   await app?.close();
   client.close();

package/dist/templates/single-project/shared/config/env.ts.hbs

@@ -64,6 +64,15 @@ export const env = createEnv({
     {{#if hasSqlite}}
     SQLITE_PATH: z.string().default("sqlite.db"),
     {{/if}}
+    {{#if hasSqlserver}}
+    SQLSERVER_HOST: z.string().default("localhost"),
+    SQLSERVER_PORT: z.string().transform(Number).default(1433),
+    SQLSERVER_DATABASE: z.string().default("{{projectNameKebab}}_db"),
+    SQLSERVER_USER: z.string(),
+    SQLSERVER_PASSWORD: z.string(),
+    SQLSERVER_ENCRYPT: z.string().transform((value) => value !== "false").default(true),
+    SQLSERVER_TRUST_SERVER_CERTIFICATE: z.string().transform((value) => value === "true").default(false),
+    {{/if}}
     {{#if hasMongodb}}
     MONGODB_URL: z.url(),
     {{/if}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nest-arch/tui",
-  "version": "0.4.5",
+  "version": "0.5.0",
   "private": false,
   "description": "Interactive terminal UI for generating NestJS projects",
   "keywords": [
@@ -45,15 +45,15 @@
     "zod": "^4.1.13"
   },
   "devDependencies": {
+    "@nest-arch/core": "0.4.3",
+    "@nest-arch/env": "0.0.0",
+    "@nest-arch/shared": "0.0.0",
     "@types/react": "^18.3.12",
     "@types/semver": "^7.8.0",
     "ink-testing-library": "^4.0.0",
     "pkgroll": "^2.5.2",
     "tsx": "^4.19.2",
-    "vitest": "^4.1.7",
-    "@nest-arch/core": "0.4.3",
-    "@nest-arch/env": "0.0.0",
-    "@nest-arch/shared": "0.0.0"
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
     "typescript": "^5"

package/dist/constants-BbC7KTI7.js

@@ -1 +0,0 @@
-var o="0.4.5",O={version:o};const s="Nest Arch",A=`v${O.version}`,n="Build production-ready NestJS projects.",t="#e54545",c="#A0A0A0",R="#6B6B6B",C="#E5E5E5",E="#61AFEF",_="#3A3A3A",e="#7FD99A",r="#E8C468",L="#e96142ff";export{s as APP_NAME,n as APP_TAGLINE,A as APP_VERSION,E as COLOR_ACCENT,c as COLOR_DIM,R as COLOR_DIMMER,_ as COLOR_DIVIDER,C as COLOR_FG,t as COLOR_RED,e as COLOR_SUCCESS,r as COLOR_WARM,L as COLOR_WARM_SECONDARY};