// ❌ Потрібно вручну створити 4+ файли
// users/users.controller.ts
// users/users.service.ts
// users/users.module.ts
// users/dto/create-user.dto.ts
// users/users.controller.spec.ts
// users/users.service.spec.ts

// Потім вручну імпортувати контролер у модуль
// Потім зареєструвати модуль у app.module.ts
// Ризик помилок у іменуванні та імпортах

# ✅ Одна команда створює всі файли та реєстрацію
nest generate resource users

nest generate <schematic> <name> [options]

# Скорочений варіант:
nest g <schematic> <name> [options]

# Створення у кореневій папці src/
nest g module users
# → src/users/users.module.ts

# Створення у вкладеній папці
nest g controller users/admin
# → src/users/admin/admin.controller.ts

# Створення у глибокій ієрархії
nest g service api/v1/users
# → src/api/v1/users/users.service.ts

nest generate module <name>

# Скорочення:
nest g mo <name>

# Модуль у папці features/
nest g mo features/auth
# → src/features/auth/auth.module.ts

# Модуль у папці api/v1/
nest g mo api/v1/products
# → src/api/v1/products/products.module.ts

src/
├── app.module.ts
├── features/
│   └── auth/
│       └── auth.module.ts
└── api/
    └── v1/
        └── products/
            └── products.module.ts

nest generate controller <name>

# Скорочення:
nest g co <name>

# Контролер у підпапці admin
nest g co users/admin
# → src/users/admin/admin.controller.ts
# → Реєструється у UsersModule (якщо існує)

nest generate service <name>

# Скорочення:
nest g s <name>

// src/users/users.controller.ts
import { Controller, Get } from '@nestjs/common';
import { UsersService } from './users.service';

@Controller('users')
export class UsersController {
  constructor(private readonly usersService: UsersService) {}
  
  @Get()
  findAll() {
    return this.usersService.findAll();
  }
}

// src/users/users.service.ts
import { Injectable } from '@nestjs/common';

@Injectable()
export class UsersService {
  private users = [
    { id: 1, name: 'Alice' },
    { id: 2, name: 'Bob' },
  ];
  
  findAll() {
    return this.users;
  }
}

nest generate resource <name>

# Скорочення:
nest g res <name>

nest generate class <path>

# Скорочення:
nest g cl <path>

// src/users/dto/create-user.dto.ts
export class CreateUserDto {}

import { IsEmail, IsString, MinLength, MaxLength } from 'class-validator';

export class CreateUserDto {
  @IsEmail()
  email: string;

  @IsString()
  @MinLength(2)
  @MaxLength(50)
  name: string;

  @IsString()
  @MinLength(8)
  password: string;
}

nest generate interface <path>

# Скорочення:
nest g itf <path>

// src/config/database-config.interface.ts
export interface DatabaseConfig {}

export interface DatabaseConfig {
  host: string;
  port: number;
  username: string;
  password: string;
  database: string;
}

nest g service users --no-spec
# → Створює лише users.service.ts (без users.service.spec.ts)

nest g controller products --no-spec
# → Створює лише products.controller.ts

# Без --flat (стандартна поведінка):
nest g service logger
# → src/logger/logger.service.ts
# → src/logger/logger.service.spec.ts

# З --flat:
nest g service logger --flat
# → src/logger.service.ts (без папки logger/)
# → src/logger.service.spec.ts

nest g service auth --skip-import
# → Створює auth.service.ts, але не оновлює auth.module.ts

# Сервіс без тестів, плоска структура, dry-run
nest g service logger --no-spec --flat --dry-run

# Контролер без тестів та реєстрації
nest g controller admin --no-spec --skip-import

# Ресурс без тестів у вкладеній папці
nest g resource api/v1/users --no-spec

nest start

npm run start:dev
# або
nest start --watch

npm run start:debug

// .vscode/launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach NestJS Debugger",
      "port": 9229,
      "restart": true,
      "stopOnEntry": false,
      "protocol": "inspector"
    }
  ]
}

nest build

dist/
├── main.js
├── main.js.map
├── app.module.js
├── users/
│   ├── users.controller.js
│   ├── users.service.js
│   └── users.module.js
└── ... (всі файли застосунку)

node dist/main.js

npm run start:prod

# Еквівалентно:
nest build && node dist/main

nest info

nest new <project-name>

my-app/
├── src/
│   ├── app.controller.ts
│   ├── app.controller.spec.ts
│   ├── app.module.ts
│   ├── app.service.ts
│   ├── app.service.spec.ts
│   └── main.ts
├── test/
│   ├── app.e2e-spec.ts
│   └── jest-e2e.json
├── node_modules/
├── .eslintrc.js
├── .prettierrc
├── nest-cli.json
├── package.json
├── tsconfig.json
└── tsconfig.build.json

# Генерація модуля
nest g module posts
# → src/posts/posts.module.ts

# Генерація контролера
nest g controller posts --no-spec
# → src/posts/posts.controller.ts

# Генерація сервісу
nest g service posts --no-spec
# → src/posts/posts.service.ts

# DTO для створення поста
nest g class posts/dto/create-post.dto --no-spec
# → src/posts/dto/create-post.dto.ts

# DTO для оновлення поста
nest g class posts/dto/update-post.dto --no-spec
# → src/posts/dto/update-post.dto.ts

# Entity для моделі поста
nest g class posts/entities/post.entity --no-spec
# → src/posts/entities/post.entity.ts

src/posts/
├── dto/
│   ├── create-post.dto.ts
│   └── update-post.dto.ts
├── entities/
│   └── post.entity.ts
├── posts.controller.ts
├── posts.module.ts
└── posts.service.ts

# Замість 6 команд вище:
nest g resource posts --no-spec
# → Створює всю структуру автоматично!

# Створення базових модулів
nest g module api/v1/users --no-spec
nest g module api/v1/products --no-spec

# Контролери для кожного модуля
nest g controller api/v1/users --no-spec
nest g controller api/v1/products --no-spec

# Сервіси
nest g service api/v1/users --no-spec
nest g service api/v1/products --no-spec

src/
├── api/
│   └── v1/
│       ├── users/
│       │   ├── users.controller.ts
│       │   ├── users.module.ts
│       │   └── users.service.ts
│       └── products/
│           ├── products.controller.ts
│           ├── products.module.ts
│           └── products.service.ts
└── app.module.ts

// src/main.ts
async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  
  // Глобальний префікс для всіх маршрутів
  app.setGlobalPrefix('api/v1');
  
  await app.listen(3000);
}
bootstrap();

// Тепер маршрути доступні за адресою:
// GET /api/v1/users
// GET /api/v1/products

# Створення папки common
mkdir src/common

# Генерація кастомного декоратора
nest g decorator common/decorators/current-user --flat --no-spec
# → src/common/decorators/current-user.decorator.ts

# Генерація pipe для валідації
nest g pipe common/pipes/parse-int --flat --no-spec
# → src/common/pipes/parse-int.pipe.ts

# Генерація guard для автентифікації
nest g guard common/guards/auth --flat --no-spec
# → src/common/guards/auth.guard.ts

# Генерація interceptor для логування
nest g interceptor common/interceptors/logging --flat --no-spec
# → src/common/interceptors/logging.interceptor.ts

src/common/
├── decorators/
│   └── current-user.decorator.ts
├── pipes/
│   └── parse-int.pipe.ts
├── guards/
│   └── auth.guard.ts
└── interceptors/
    └── logging.interceptor.ts

# Перевірка структури ресурсу
nest g resource notifications --dry-run

# Перевірка вкладеної структури
nest g controller admin/users --dry-run

# Перевірка з опціями
nest g service analytics --no-spec --flat --dry-run

nest generate module users
nest generate controller users
nest generate service users

nest g mo users
nest g co users
nest g s users

nest g resource users

nest g mo users
nest g mo products
nest g mo orders
# → src/users/, src/products/, src/orders/ (плоска структура)

# Групування за доменом
nest g mo features/auth
nest g mo features/billing
nest g mo features/analytics

# Або версіонування API
nest g mo api/v1/users
nest g mo api/v1/products

# NestJS aliases
alias ngs="nest g service"
alias ngc="nest g controller"
alias ngm="nest g module"
alias ngr="nest g resource"
alias ngcl="nest g class"

# З опціями
alias ngs-ns="nest g service --no-spec"
alias ngc-ns="nest g controller --no-spec"

ngs users           # → nest g service users
ngc-ns products     # → nest g controller products --no-spec
ngr orders          # → nest g resource orders

# Швидке прототипування без тестів
nest g resource prototype --no-spec

# Тести додаються пізніше, коли логіка стабілізується

# Завжди з тестами
nest g resource users
# → Створює *.spec.ts файли

# Спочатку симуляція
nest g resource api/v2/users --dry-run

# Переконалися, що структура правильна
nest g resource api/v2/users

# Декоратори
nest g decorator common/decorators/roles --flat --no-spec

# Guards
nest g guard common/guards/roles --flat --no-spec

# Interceptors
nest g interceptor common/interceptors/transform --flat --no-spec

# Pipes
nest g pipe common/pipes/validation --flat --no-spec

# Filters
nest g filter common/filters/http-exception --flat --no-spec

src/common/
├── decorators/
│   ├── roles.decorator.ts
│   └── current-user.decorator.ts
├── guards/
│   ├── roles.guard.ts
│   └── auth.guard.ts
├── interceptors/
│   ├── transform.interceptor.ts
│   └── logging.interceptor.ts
├── pipes/
│   └── validation.pipe.ts
└── filters/
    └── http-exception.filter.ts

{
  "$schema": "https://json.schemastore.org/nest-cli",
  "collection": "@nestjs/schematics",
  "sourceRoot": "src",
  "compilerOptions": {
    "deleteOutDir": true,
    "webpack": true,
    "tsConfigPath": "tsconfig.build.json"
  },
  "generateOptions": {
    "spec": false,
    "flat": false
  }
}

{
  "generateOptions": {
    "spec": false
  }
}

nest g service users
# → Створює лише users.service.ts (без users.service.spec.ts)