@nest-arch/tui 0.1.1

package/dist/templates/monorepo/packages/env/src/api-gateway.ts.hbs

@@ -0,0 +1,37 @@
+import "dotenv/config";
+import { createEnv } from "@t3-oss/env-core";
+import * as z from "zod";
+
+export const env = createEnv({
+  /**
+   * By default, this library will feed the environment variables directly to
+   * the Zod validator.
+   *
+   * This means that if you have an empty string for a value that is supposed
+   * to be a number (e.g. `PORT=` in a ".env" file), Zod will incorrectly flag
+   * it as a type mismatch violation. Additionally, if you have an empty string
+   * for a value that is supposed to be a string with a default value (e.g.
+   * `DOMAIN=` in an ".env" file), the default value will never be applied.
+   *
+   * In order to solve these issues, we recommend that all new projects
+   * explicitly specify this option as true.
+   */
+  emptyStringAsUndefined: true,
+
+  /**
+   * What object holds the environment variables at runtime. This is usually
+   * `process.env` or `import.meta.env`.
+   */
+  runtimeEnv: process.env,
+
+  server: {
+    CORS_ORIGIN: z.string().default("*"),
+    NODE_ENV: z
+      .enum(["development", "production", "test"])
+      .default("development"),
+    PORT: z
+      .string()
+      .transform((val) => Number.parseInt(val, 10))
+      .default(3000),
+  },
+});

package/dist/templates/monorepo/packages/env/tsconfig.json.hbs

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@repo/config/tsconfig.base.json"
+}

package/dist/templates/monorepo/packages/shared/package.json.hbs

@@ -0,0 +1,17 @@
+{
+  "name": "@repo/shared",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "exports": {
+    "./*": "./src/*"
+  },
+  "dependencies": {
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@repo/config": "workspace:*",
+    "@types/node": "catalog:",
+    "typescript": "catalog:"
+  }
+}

package/dist/templates/monorepo/packages/shared/tsconfig.json.hbs

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@repo/config/tsconfig.base.json"
+}

package/dist/templates/monorepo/root/.gitignore.hbs

@@ -0,0 +1,48 @@
+# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Build outputs
+dist
+build
+*.tsbuildinfo
+
+# Environment variables
+.env
+.env*.local
+
+# IDEs and editors
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+.idea
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Turbo
+.turbo
+.nx
+
+# Testing
+coverage
+.nyc_output
+
+# Misc
+*.tgz
+.cache
+tmp
+temp

package/dist/templates/monorepo/root/.yarnrc.yml.hbs

@@ -0,0 +1,6 @@
+nodeLinker: node-modules
+catalog:
+  "@types/node": ^22.13.14
+  dotenv: ^17.2.2
+  typescript: ^6.0.2
+  zod: ^4.4.3

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

@@ -0,0 +1,33 @@
+# {{projectName}}
+
+{{description}}
+
+## Setup
+
+```bash
+# Install dependencies
+{{#if isPnpm}}pnpm install{{else if isYarn}}yarn install{{else if isBun}}bun install{{else}}npm install{{/if}}
+```
+
+## Running the App
+
+```bash
+# development mode (live reload)
+{{#if isPnpm}}pnpm dev{{else if isYarn}}yarn dev{{else if isBun}}bun run dev{{else}}npm run dev{{/if}}
+
+# build and production mode
+{{#if isPnpm}}pnpm build{{else if isYarn}}yarn build{{else if isBun}}bun run build{{else}}npm run build{{/if}}
+```
+
+## Testing
+
+```bash
+# unit tests
+{{#if isPnpm}}pnpm test{{else if isYarn}}yarn test{{else if isBun}}bun run test{{else}}npm test{{/if}}
+
+# e2e tests
+{{#if isPnpm}}pnpm test:e2e{{else if isYarn}}yarn test:e2e{{else if isBun}}bun run test:e2e{{else}}npm run test:e2e{{/if}}
+
+# test coverage
+{{#if isPnpm}}pnpm test:cov{{else if isYarn}}yarn test:cov{{else if isBun}}bun run test:cov{{else}}npm run test:cov{{/if}}
+```

package/dist/templates/monorepo/root/package.json.hbs

@@ -0,0 +1,35 @@
+{
+  "name": "{{projectName}}",
+  "private": true,
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
+  "type": "module",
+  "scripts": {
+    "dev": "turbo dev",
+    "build": "turbo build",
+    "check-types": "turbo check-types"{{#if hasUltracite}},
+    "check": "ultracite check"{{/if}}{{#if hasHusky}},
+    "prepare": "husky"{{/if}}
+  },
+  "dependencies": {
+    "@repo/env": "workspace:*",
+    "dotenv": "catalog:",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@repo/config": "workspace:*",
+    "@types/node": "catalog:",
+    {{#if hasHusky}}"husky": "^9.1.7",{{/if}}
+    "turbo": "^2.8.12",
+    "typescript": "catalog:"
+  }{{#if hasHusky}},
+  "lint-staged": {
+    "*": [
+      "oxlint",
+      "oxfmt --write"
+    ]
+  }{{/if}},
+  "packageManager": {{#if isPnpm}}"pnpm@10.33.0"{{else if isYarn}}"yarn@4.6.0"{{else if isBun}}"bun@1.3.14"{{else}}undefined{{/if}}
+}

package/dist/templates/monorepo/root/pnpm-workspace.yaml.hbs

@@ -0,0 +1,11 @@
+packages:
+  - apps/*
+  - packages/*
+allowBuilds:
+  '@nestjs/core': true
+  esbuild: true
+catalog:
+  "@types/node": ^22.13.14
+  dotenv: ^17.2.2
+  typescript: ^6
+  zod: ^4.4.3

package/dist/templates/monorepo/root/tsconfig.json.hbs

@@ -0,0 +1,3 @@
+{
+  "extends": "@repo-config/config/tsconfig.base.json"
+}

package/dist/templates/monorepo/root/turbo.json.hbs

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "ui": "tui",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "inputs": ["$TURBO_DEFAULT$", ".env*"],
+      "outputs": ["dist/**"]
+    },
+    "lint": {
+      "dependsOn": ["^lint"]
+    },
+    "check-types": {
+      "dependsOn": ["^check-types"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    }
+  }
+}

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

@@ -0,0 +1,2 @@
+PORT=3000
+CORS_ORIGIN=http://localhost:3001

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

@@ -0,0 +1,49 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.1",
+  "private": true,
+  "description": "{{description}}",
+  "license": "UNLICENSED",
+  "author": "",
+  "type": "module",
+  "scripts": {
+    "build": "nest build",
+    "dev": "nest start --watch",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:cov": "vitest run --coverage",
+    "test:debug": "vitest --inspect-brk --no-file-parallelism",
+    "test:e2e": "vitest run --config ./vitest.config.e2e.ts"{{#if hasUltracite}},
+    "check": "ultracite check",
+    "fix": "ultracite fix"{{/if}}{{#if hasHusky}},
+    "prepare": "husky"{{/if}}
+  },
+  "dependencies": {
+    "@nestjs/common": "next",
+    "@nestjs/core": "next",
+    "@nestjs/platform-{{httpProvider}}": "next",
+    "@t3-oss/env-core": "^0.13.11",
+    "dotenv": "^17.2.2",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "next",
+    "@nestjs/schematics": "next",
+    "@nestjs/testing": "next",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.13.14",
+    "@types/supertest": "^7.0.0",
+    "@vitest/coverage-v8": "4.1.6",
+    {{#if hasHusky}}"husky": "^9.1.7",{{/if}}
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}

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

@@ -0,0 +1,4 @@
+allowBuilds:
+  "@nestjs/core": true
+catalog:
+  dotenv: ^17.2.2

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

@@ -0,0 +1,15 @@
+import { NestFactory } from "@nestjs/core";
+
+import { AppModule } from "./app.module.js";
+import { env } from "./config/env.js";
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  app.enableCors({
+    origin: env.CORS_ORIGIN,
+  });
+  app.setGlobalPrefix("api");
+
+  await app.listen(env.PORT ?? 3000);
+}
+await bootstrap();

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

@@ -0,0 +1,19 @@
+import { Controller, Get, Req, Res } from "@nestjs/common";
+import type { Request, Response } from "express";
+
+import { AppService } from "./app.service.js";
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get()
+  getHello(): string {
+    return this.appService.getHello();
+  }
+
+  @Get("*")
+  proxy(@Req() req: Request, @Res() res: Response): void {
+    this.appService.proxyRequest(req, res);
+  }
+}

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

@@ -0,0 +1,12 @@
+import { Module } from "@nestjs/common";
+import { HttpModule } from "@nestjs/axios";
+
+import { AppController } from "./app.controller.js";
+import { AppService } from "./app.service.js";
+
+@Module({
+  controllers: [AppController],
+  imports: [HttpModule],
+  providers: [AppService],
+})
+export class AppModule {}

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

@@ -0,0 +1,26 @@
+import { Injectable } from "@nestjs/common";
+import { HttpService } from "@nestjs/axios";
+import type { Request, Response } from "express";
+
+@Injectable()
+export class AppService {
+  constructor(private readonly httpService: HttpService) {}
+
+  getHello(): string {
+    return "Hello World!";
+  }
+
+  async proxyRequest(req: Request, res: Response): Promise<void> {
+    try {
+      const response = await this.httpService.axiosRef({
+        data: req.body,
+        headers: req.headers,
+        method: req.method,
+        url: `http://localhost:3001${req.url}`,
+      });
+      res.status(response.status).json(response.data);
+    } catch {
+      res.status(502).json({ message: "Bad Gateway" });
+    }
+  }
+}

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

@@ -0,0 +1,15 @@
+import { NestFactory } from "@nestjs/core";
+
+import { AppModule } from "./app.module.js";
+import { env } from "./config/env.js";
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  app.enableCors({
+    origin: env.CORS_ORIGIN,
+  });
+  app.setGlobalPrefix("api");
+
+  await app.listen(env.PORT ?? 3000);
+}
+await bootstrap();

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

@@ -0,0 +1,3 @@
+PORT=3000
+MICROSERVICE_PORT=3001
+CORS_ORIGIN=http://localhost:3001

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

@@ -0,0 +1,18 @@
+import { Controller, EventPattern, MessagePattern } from "@nestjs/common";
+
+import { AppService } from "./app.service.js";
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @MessagePattern("ping")
+  handlePing(): string {
+    return this.appService.handlePing();
+  }
+
+  @EventPattern("log")
+  handleLog(data: Record<string, unknown>): void {
+    this.appService.handleLog(data);
+  }
+}

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

@@ -0,0 +1,11 @@
+import { Module } from "@nestjs/common";
+
+import { AppController } from "./app.controller.js";
+import { AppService } from "./app.service.js";
+
+@Module({
+  controllers: [AppController],
+  imports: [],
+  providers: [AppService],
+})
+export class AppModule {}

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

@@ -0,0 +1,12 @@
+import { Injectable } from "@nestjs/common";
+
+@Injectable()
+export class AppService {
+  handlePing(): string {
+    return "pong";
+  }
+
+  handleLog(data: Record<string, unknown>): void {
+    console.log("Microservice received:", data);
+  }
+}

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

@@ -0,0 +1,21 @@
+import { NestFactory } from "@nestjs/core";
+import { Transport, type MicroserviceOptions } from "@nestjs/microservices";
+
+import { AppModule } from "./app.module.js";
+import { env } from "./config/env.js";
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  app.connectMicroservice<MicroserviceOptions>({
+    transport: Transport.TCP,
+    options: {
+      host: "0.0.0.0",
+      port: env.MICROSERVICE_PORT ?? 3001,
+    },
+  });
+
+  await app.startAllMicroservices();
+  await app.listen(env.PORT ?? 3000);
+}
+await bootstrap();

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

@@ -0,0 +1,37 @@
+import "dotenv/config";
+import { createEnv } from "@t3-oss/env-core";
+import * as z from "zod";
+
+export const env = createEnv({
+  /**
+   * By default, this library will feed the environment variables directly to
+   * the Zod validator.
+   *
+   * This means that if you have an empty string for a value that is supposed
+   * to be a number (e.g. `PORT=` in a ".env" file), Zod will incorrectly flag
+   * it as a type mismatch violation. Additionally, if you have an empty string
+   * for a value that is supposed to be a string with a default value (e.g.
+   * `DOMAIN=` in an ".env" file), the default value will never be applied.
+   *
+   * In order to solve these issues, we recommend that all new projects
+   * explicitly specify this option as true.
+   */
+  emptyStringAsUndefined: true,
+
+  /**
+   * What object holds the environment variables at runtime. This is usually
+   * `process.env` or `import.meta.env`.
+   */
+  runtimeEnv: process.env,
+
+  server: {
+    CORS_ORIGIN: z.string().default("*"),
+    NODE_ENV: z
+      .enum(["development", "production", "test"])
+      .default("development"),
+    PORT: z
+      .string()
+      .transform((val) => Number.parseInt(val, 10))
+      .default(3000),
+  },
+});

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@nest-arch/tui",
+  "version": "0.1.1",
+  "private": false,
+  "description": "Interactive terminal UI for generating NestJS projects",
+  "keywords": [
+    "cli",
+    "generator",
+    "nestjs",
+    "scaffolding",
+    "terminal",
+    "tui"
+  ],
+  "homepage": "https://github.com/Angel-Mario/nest-arch#readme",
+  "bugs": {
+    "url": "https://github.com/Angel-Mario/nest-arch/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Angel-Mario/nest-arch",
+    "directory": "apps/tui"
+  },
+  "bin": {
+    "nest-arch": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.tsx",
+    "dev:watch": "tsx watch src/index.tsx",
+    "build": "pkgroll --minify --target=node18 && node scripts/copy-templates.js",
+    "copy-templates": "node -e \"import('node:fs').then(({cpSync})=>cpSync('../../packages/core/templates','dist/templates',{recursive:true}))\"",
+    "test": "vitest run",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "ink": "^5.0.1",
+    "ink-text-input": "^6.0.0",
+    "open": "^11.0.0",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@nest-arch/core": "workspace:*",
+    "@nest-arch/env": "workspace:*",
+    "@nest-arch/shared": "workspace:*",
+    "@types/react": "^18.3.12",
+    "pkgroll": "^2.5.2",
+    "tsx": "^4.19.2",
+    "vitest": "^4.1.7"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}