@urbansolv/create-nestjs-app 1.2.4 → 1.2.7

package/dist/templates/nestjs-app/src/common/dto/api-response.dto.ts

@@ -1,8 +1,8 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 
 export class ApiResponseDto<T = any> {
-  @ApiProperty({ example: true })
-  success: boolean;
+  @ApiProperty({ example: 200 })
+  statusCode: number;
 
   @ApiProperty({ example: 'Operation successful' })
   message: string;

package/dist/templates/nestjs-app/src/common/filters/http-exception.filter.ts

@@ -43,7 +43,7 @@ export class HttpExceptionFilter implements ExceptionFilter {
     );
 
     const errorResponse: ApiResponseDto<null> = {
-      success: false,
+      statusCode: status,
       message,
       data: null,
       errors,

package/dist/templates/nestjs-app/src/common/interceptors/transform.interceptor.ts

@@ -18,7 +18,7 @@ export class TransformInterceptor<T> implements NestInterceptor<T, ApiResponseDt
     return next.handle().pipe(
       map((data) => {
         // If data is already in ApiResponseDto format, return as is
-        if (data && typeof data === 'object' && 'success' in data && 'message' in data) {
+        if (data && typeof data === 'object' && 'statusCode' in data && 'message' in data) {
           return data;
         }
 
@@ -43,7 +43,7 @@ export class TransformInterceptor<T> implements NestInterceptor<T, ApiResponseDt
         }
 
         return {
-          success: true,
+          statusCode: response.statusCode || HttpStatus.OK,
           message,
           data,
           timestamp: new Date().toISOString(),

package/dist/templates/nestjs-app/src/common/prisma/prisma.service.ts

@@ -8,7 +8,6 @@ export class PrismaService extends PrismaClient implements OnModuleInit, OnModul
   constructor() {
     super({
       log: [
-        { level: 'query', emit: 'event' },
         { level: 'error', emit: 'stdout' },
         { level: 'warn', emit: 'stdout' },
       ],

package/dist/templates/nestjs-app/src/modules/auth/auth.service.ts

@@ -48,13 +48,6 @@ export class AuthService {
       throw new UnauthorizedException('Account is inactive');
     }
 
-      console.log({
-        passwordInput: loginDto.password,
-        passwordHash: user.password,
-        isActive: user.is_active,
-        deletedAt: user.deleted_at,
-      });
-
     // Verify password
     const isPasswordValid = await PasswordUtil.compare(password, user.password);
     if (!isPasswordValid) {

package/dist/templates/nestjs-app/src/modules/auth/controllers/v1/auth.controller.ts

@@ -6,9 +6,13 @@ import { RegisterDto } from '../../core/dto/register.dto';
 import { AuthResponseDto } from '../../core/dto/auth-response.dto';
 import { Public } from '@common/decorators/public.decorator';
 import { ApiSuccessResponse } from '@common/decorators/api-response.decorator';
+import { JwtAuthGuard } from '@common/guards/jwt-auth.guard';
+import { PermissionsGuard } from '@common/guards/permissions.guard';
 
 @ApiTags('Authentication')
+@ApiBearerAuth('JWT-auth')
 @Controller({ path: 'auth', version: '1' })
+@UseGuards(JwtAuthGuard, PermissionsGuard)
 export class AuthController {
   constructor(private readonly authService: AuthService) {}
 

package/dist/templates/nestjs-app/src/modules/users/controllers/v1/users.controller.ts

@@ -24,13 +24,13 @@ import { Permissions } from '@common/decorators/permissions.decorator';
 import { PERMISSIONS } from '@common/constants/permissions.constant';
 import { ApiSuccessResponse, ApiSuccessArrayResponse } from '@common/decorators/api-response.decorator';
 import { PaginatedResponseDto } from '@common/dto/pagination.dto';
-import { AuthGuard } from '@nestjs/passport';
 import { PermissionsGuard } from '@common/guards/permissions.guard';
+import { JwtAuthGuard } from '@common/guards/jwt-auth.guard';
 
 @ApiTags('Users')
 @ApiBearerAuth('JWT-auth')
 @Controller({ path: 'users', version: '1' })
-@UseGuards(AuthGuard('jwt'), PermissionsGuard)
+@UseGuards(JwtAuthGuard, PermissionsGuard)
 export class UsersController {
   constructor(private readonly usersService: UsersService) {}
 

package/dist/templates/nestjs-app/src/modules/users/users.service.ts

@@ -114,6 +114,10 @@ export class UsersService {
       this.prisma.user.count({ where }),
     ]);
 
+    if (total === 0) {
+      throw new NotFoundException('No users found');
+    }
+
     return {
       data: UserTransformHelper.toEntities(users),
       meta: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urbansolv/create-nestjs-app",
-  "version": "1.2.4",
+  "version": "1.2.7",
   "description": "CLI generator for Urbansolv NestJS boilerplate with RBAC and Prisma",
   "main": "dist/index.js",
   "bin": {
@@ -39,6 +39,7 @@
   "homepage": "https://github.com/godwimp/create-nestjs-app#readme",
   "files": [
     "dist",
+    "templates",
     "README.md",
     "LICENSE"
   ],

package/templates/nestjs-app/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

package/templates/nestjs-app/.env.example

@@ -0,0 +1,24 @@
+# Application
+NODE_ENV=development
+PORT=3000
+APP_NAME=__PROJECT_NAME__
+
+# Database
+DATABASE_URL="postgresql://username:password@localhost:5432/__DATABASE_NAME__?schema=public"
+
+# JWT
+JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
+JWT_EXPIRATION=7d
+JWT_REFRESH_SECRET=your-super-secret-refresh-key-change-this-in-production
+JWT_REFRESH_EXPIRATION=30d
+
+# CORS
+CORS_ORIGIN=http://localhost:3001
+
+# API
+API_PREFIX=api
+API_VERSION=v1
+
+# Swagger
+SWAGGER_ENABLED=true
+SWAGGER_PATH=docs

package/templates/nestjs-app/.eslintrc.js

@@ -0,0 +1,25 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: 'tsconfig.json',
+    tsconfigRootDir: __dirname,
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint/eslint-plugin'],
+  extends: [
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+  },
+  ignorePatterns: ['.eslintrc.js'],
+  rules: {
+    '@typescript-eslint/interface-name-prefix': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+  },
+};

package/templates/nestjs-app/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "tabWidth": 2,
+  "semi": true,
+  "printWidth": 100,
+  "arrowParens": "always"
+}

package/templates/nestjs-app/README.md

@@ -0,0 +1,133 @@
+# Urbansolv NestJS Backend
+
+Backend application built with NestJS following Urbansolv standardization manual.
+
+## Features
+
+- 🔐 JWT Authentication with RBAC
+- 📝 Complete User Management
+- 🎯 Permission-based Access Control
+- 📚 Auto-generated Swagger Documentation
+- ✅ Input Validation
+- 🔄 API Versioning
+- 📊 Structured Logging
+- 🗃️ Prisma ORM with PostgreSQL
+- 🧪 Testing Setup (Unit & E2E)
+
+## Prerequisites
+
+- Node.js >= 18.x
+- PostgreSQL >= 14.x
+- npm/yarn/pnpm
+
+## Installation
+```bash
+# Install dependencies
+npm install
+
+# Setup environment variables
+cp .env.example .env
+# Edit .env with your database credentials
+
+# Generate Prisma Client
+npm run prisma:generate
+
+# Run migrations
+npm run prisma:migrate
+
+# Seed database
+npm run prisma:seed
+```
+
+## Running the Application
+```bash
+# Development
+npm run start:dev
+
+# Production build
+npm run build
+npm run start:prod
+
+# Debug mode
+npm run start:debug
+```
+
+## Database Commands
+```bash
+# Generate Prisma Client
+npm run prisma:generate
+
+# Create migration
+npm run prisma:migrate
+
+# Seed database
+npm run prisma:seed
+
+# Open Prisma Studio
+npm run prisma:studio
+```
+
+## Testing
+```bash
+# Unit tests
+npm run test
+
+# E2E tests
+npm run test:e2e
+
+# Test coverage
+npm run test:cov
+```
+
+## API Documentation
+
+After starting the application, visit:
+- Swagger UI: `http://localhost:3000/api-docs`
+
+## Default Users
+
+After seeding the database:
+
+**Admin User:**
+- Email: `admin@urbansolv.com`
+- Password: `password123`
+- All permissions granted
+
+**Member User:**
+- Email: `member@urbansolv.com`
+- Password: `password123`
+- Limited permissions (VIEW_USER only)
+
+## Project Structure
+```
+src/
+├── common/              # Shared resources
+│   ├── decorators/      # Custom decorators
+│   ├── filters/         # Exception filters
+│   ├── guards/          # Auth & permission guards
+│   ├── interceptors/    # Logging & transform
+│   ├── prisma/          # Prisma service
+│   └── utils/           # Helper functions
+├── config/              # Configuration files
+├── modules/             # Feature modules
+│   ├── auth/            # Authentication
+│   ├── users/           # User management
+│   └── health/          # Health checks
+├── app.module.ts        # Root module
+└── main.ts              # Application entry point
+```
+
+## Environment Variables
+
+See `.env.example` for all available configuration options.
+
+## License
+
+Proprietary - Urbansolv
+```
+
+### 20.2 .gitkeep for migrations
+
+**templates/nestjs-app/prisma/migrations/.gitkeep**
+```
+# This file keeps the migrations directory in git

package/templates/nestjs-app/nest-cli.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "webpack": true,
+    "tsConfigPath": "tsconfig.json"
+  }
+}

package/templates/nestjs-app/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "my-app",
+  "version": "1.0.0",
+  "description": "Urbansolv NestJS Application",
+  "author": "Urbansolv",
+  "private": true,
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "npm run clean && tsc && npm run copy-templates",
+    "clean": "rm -rf dist",
+    "copy-templates": "cp -r templates dist/",
+    "dev": "ts-node src/cli.ts",
+    "prepublishOnly": "npm run build",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "echo \"No tests yet\" && exit 0",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:e2e": "jest --config ./test/jest-e2e.json",
+    "prisma:generate": "prisma generate",
+    "prisma:migrate": "prisma migrate dev",
+    "prisma:studio": "prisma studio",
+    "prisma:seed": "ts-node prisma/seed.ts"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/jwt": "^11.0.2",
+    "@nestjs/passport": "^11.0.5",
+    "@nestjs/platform-express": "^11.0.1",
+    "@nestjs/swagger": "^11.2.3",
+    "@prisma/client": "^6.19.0",
+    "bcryptjs": "^3.0.3",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.0",
+    "joi": "^18.0.2",
+    "passport": "^0.7.0",
+    "passport-jwt": "^4.0.1",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@types/bcrypt": "^6.0.0",
+    "@types/express": "^5.0.5",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.10.7",
+    "@types/passport-jwt": "^4.0.1",
+    "@types/supertest": "^6.0.2",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "jest": "^30.0.0",
+    "prettier": "^3.4.2",
+    "prisma": "^6.19.0",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3"
+  },
+  "prisma": {
+    "seed": "ts-node prisma/seed.ts"
+  },
+  "jest": {
+    "moduleFileExtensions": ["js", "json", "ts"],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": ["**/*.(t|j)s"],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  }
+}

package/templates/nestjs-app/prisma/schema.prisma

@@ -0,0 +1,79 @@
+// This is your Prisma schema file,
+// learn more about it in the docs: https://pris.ly/d/prisma-schema
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+// ============================================
+// RBAC Schema
+// ============================================
+
+model User {
+  id         Int       @id @default(autoincrement())
+  email      String    @unique
+  password   String
+  first_name String
+  last_name  String
+  is_active  Boolean   @default(true)
+  created_at DateTime  @default(now())
+  updated_at DateTime  @updatedAt
+  deleted_at DateTime?
+
+  // Relations
+  position_id Int
+  position    Position @relation(fields: [position_id], references: [id])
+
+  @@map("users")
+}
+
+model Position {
+  id          Int       @id @default(autoincrement())
+  name        String    @unique
+  description String?
+  is_active   Boolean   @default(true)
+  created_at  DateTime  @default(now())
+  updated_at  DateTime  @updatedAt
+  deleted_at  DateTime?
+
+  // Relations
+  users               User[]
+  position_permissions PositionPermission[]
+
+  @@map("positions")
+}
+
+model Permission {
+  id          Int       @id @default(autoincrement())
+  name        String    @unique
+  description String?
+  resource    String // e.g., 'USER', 'TRANSACTION', 'REPORT'
+  action      String // e.g., 'VIEW', 'ADD', 'UPDATE', 'DELETE'
+  created_at  DateTime  @default(now())
+  updated_at  DateTime  @updatedAt
+  deleted_at  DateTime?
+
+  // Relations
+  position_permissions PositionPermission[]
+
+  @@map("permissions")
+}
+
+model PositionPermission {
+  id            Int      @id @default(autoincrement())
+  position_id   Int
+  permission_id Int
+  created_at    DateTime @default(now())
+
+  // Relations
+  position   Position   @relation(fields: [position_id], references: [id], onDelete: Cascade)
+  permission Permission @relation(fields: [permission_id], references: [id], onDelete: Cascade)
+
+  @@unique([position_id, permission_id])
+  @@map("position_permissions")
+}

package/templates/nestjs-app/prisma/seed.ts

@@ -0,0 +1,153 @@
+import { PrismaClient } from '@prisma/client';
+import * as bcrypt from 'bcryptjs';
+
+const prisma = new PrismaClient();
+
+async function main() {
+  console.log('🌱 Starting database seeding...\n');
+
+  // Clear existing data
+  console.log('🗑️  Clearing existing data...');
+  await prisma.positionPermission.deleteMany();
+  await prisma.user.deleteMany();
+  await prisma.permission.deleteMany();
+  await prisma.position.deleteMany();
+
+  // ============================================
+  // Seed Positions
+  // ============================================
+  console.log('📋 Seeding positions...');
+  const adminPosition = await prisma.position.create({
+    data: {
+      name: 'Administrator',
+      description: 'Full system access with all permissions',
+    },
+  });
+
+  const memberPosition = await prisma.position.create({
+    data: {
+      name: 'Member',
+      description: 'Standard user with limited permissions',
+    },
+  });
+
+  console.log('✅ Positions seeded');
+
+  // ============================================
+  // Seed Permissions
+  // ============================================
+  console.log('🔐 Seeding permissions...');
+
+  const permissionsData = [
+    // User Management
+    { name: 'VIEW_USER', resource: 'USER', action: 'VIEW', description: 'View user information' },
+    { name: 'ADD_USER', resource: 'USER', action: 'ADD', description: 'Create new user' },
+    { name: 'UPDATE_USER', resource: 'USER', action: 'UPDATE', description: 'Update user information' },
+    { name: 'DELETE_USER', resource: 'USER', action: 'DELETE', description: 'Delete user' },
+    { name: 'MANAGE_USER_PERMISSION', resource: 'USER', action: 'MANAGE_PERMISSION', description: 'Assign or revoke user permissions' },
+    { name: 'CHANGE_USER_POSITION', resource: 'USER', action: 'CHANGE_POSITION', description: 'Change user position/role' },
+
+    // Position Management
+    { name: 'VIEW_POSITION', resource: 'POSITION', action: 'VIEW', description: 'View position information' },
+    { name: 'ADD_POSITION', resource: 'POSITION', action: 'ADD', description: 'Create new position' },
+    { name: 'UPDATE_POSITION', resource: 'POSITION', action: 'UPDATE', description: 'Update position information' },
+    { name: 'DELETE_POSITION', resource: 'POSITION', action: 'DELETE', description: 'Delete position' },
+
+    // Permission Management
+    { name: 'VIEW_PERMISSION', resource: 'PERMISSION', action: 'VIEW', description: 'View permission information' },
+    { name: 'ADD_PERMISSION', resource: 'PERMISSION', action: 'ADD', description: 'Create new permission' },
+    { name: 'UPDATE_PERMISSION', resource: 'PERMISSION', action: 'UPDATE', description: 'Update permission information' },
+    { name: 'DELETE_PERMISSION', resource: 'PERMISSION', action: 'DELETE', description: 'Delete permission' },
+  ];
+
+  const permissions = await Promise.all(
+    permissionsData.map((permission) =>
+      prisma.permission.create({ data: permission })
+    )
+  );
+
+  console.log(`✅ ${permissions.length} permissions seeded`);
+
+  // ============================================
+  // Assign Permissions to Positions
+  // ============================================
+  console.log('🔗 Assigning permissions to positions...');
+
+  // Admin gets all permissions
+  const adminPermissions = permissions.map((permission) => ({
+    position_id: adminPosition.id,
+    permission_id: permission.id,
+  }));
+
+  await prisma.positionPermission.createMany({
+    data: adminPermissions,
+  });
+
+  // Member gets only VIEW_USER permission
+  const viewUserPermission = permissions.find((p) => p.name === 'VIEW_USER');
+  if (viewUserPermission) {
+    await prisma.positionPermission.create({
+      data: {
+        position_id: memberPosition.id,
+        permission_id: viewUserPermission.id,
+      },
+    });
+  }
+
+  console.log('✅ Permissions assigned to positions');
+
+  // ============================================
+  // Seed Users
+  // ============================================
+  console.log('👥 Seeding users...');
+
+  const defaultPassword = 'password123';
+  const hashedPassword = await bcrypt.hash(defaultPassword, 10);
+
+  const adminUser = await prisma.user.create({
+    data: {
+      email: 'admin@urbansolv.co.id',
+      password: hashedPassword,
+      first_name: 'Admin',
+      last_name: 'Urbansolv',
+      position_id: adminPosition.id,
+      is_active: true,
+    },
+  });
+
+  const memberUser = await prisma.user.create({
+    data: {
+      email: 'member@urbansolv.co.id',
+      password: hashedPassword,
+      first_name: 'Member',
+      last_name: 'User',
+      position_id: memberPosition.id,
+      is_active: true,
+    },
+  });
+
+  console.log('✅ Users seeded');
+
+  // ============================================
+  // Summary
+  // ============================================
+  console.log('\n✨ Database seeding completed!\n');
+  console.log('📊 Summary:');
+  console.log(`   - Positions: ${await prisma.position.count()}`);
+  console.log(`   - Permissions: ${await prisma.permission.count()}`);
+  console.log(`   - Users: ${await prisma.user.count()}`);
+  console.log(`   - Position-Permission Links: ${await prisma.positionPermission.count()}\n`);
+
+  console.log('🔑 Default Users:');
+  console.log(`   Admin: ${adminUser.email} / ${defaultPassword}`);
+  console.log(`   Member: ${memberUser.email} / ${defaultPassword}\n`);
+}
+
+main()
+  .catch((e) => {
+    console.error('❌ Error seeding database:', e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });