nestjs-prisma-cli 1.0.1

package/bin/index.js

@@ -0,0 +1,193 @@
+import inquirer from "inquirer";
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "path";
+import { execa } from "execa";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function main() {
+  console.log(chalk.blue("🚀 Welcome to NestJS + Prisma Project Generator!"));
+
+  const { projectName } = await inquirer.prompt([
+    { type: "input", name: "projectName", message: "Enter your project name:" }
+  ]);
+
+  const dbSafeName = projectName.replace(/-/g, "_") + "_db";
+  const projectPath = path.join(process.cwd(), projectName);
+
+  if (fs.existsSync(projectPath)) {
+    console.log(chalk.red(`❌ Folder "${projectName}" already exists!`));
+    process.exit(1);
+  }
+
+  const { database } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "database",
+      message: "Select your database:",
+      choices: ["PostgreSQL", "MySQL", "SQLite", "MongoDB", "CockroachDB", "SQLServer"]
+    }
+  ]);
+
+  console.log(chalk.green(`📦 Creating NestJS project "${projectName}"...`));
+  await execa("npx", ["@nestjs/cli", "new", projectName, "--skip-install"], { stdio: "inherit" });
+
+  console.log(chalk.green("📥 Installing dependencies..."));
+  await execa("npm", ["install"], { cwd: projectPath, stdio: "inherit" });
+
+  await execa("npm", [
+    "install",
+    "--save",
+    "@aws-sdk/client-s3",
+    "@aws-sdk/s3-request-presigner",
+    "@nestjs/config",
+    "@nestjs/jwt",
+    "@nestjs/passport",
+    "@nestjs/swagger",
+    "argon2",
+    "class-transformer",
+    "class-validator",
+    "moment",
+    "multer",
+    "passport",
+    "passport-jwt",
+    "prisma",
+    "@prisma/client",
+    "reflect-metadata",
+    "rxjs",
+    "swagger-ui-express",
+    "winston",
+    "winston-daily-rotate-file"
+  ], { cwd: projectPath, stdio: "inherit" });
+
+  await execa("npm", [
+    "install",
+    "--save-dev",
+    "@eslint/eslintrc",
+    "@eslint/js",
+    "@nestjs/cli",
+    "@nestjs/schematics",
+    "@nestjs/testing",
+    "@swc/cli",
+    "@swc/core",
+    "@types/express",
+    "@types/jest",
+    "@types/multer",
+    "@types/node",
+    "@types/supertest",
+    "eslint",
+    "eslint-config-prettier",
+    "eslint-plugin-prettier",
+    "globals",
+    "jest",
+    "prettier",
+    "source-map-support",
+    "supertest",
+    "ts-jest",
+    "ts-loader",
+    "ts-node",
+    "tsconfig-paths",
+    "typescript",
+    "typescript-eslint"
+  ], { cwd: projectPath, stdio: "inherit" });
+
+  console.log(chalk.green("✅ Dependencies installed!"));
+
+  const provider = database.toLowerCase() === "sqlserver" ? "sqlserver" : database.toLowerCase();
+  const prismaSchema = `generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "${provider}"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id        Int      @id @default(autoincrement())
+  userId    String   @unique
+  name      String?
+  email     String
+  password  String
+  isActive  Boolean   @default(true)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@map("tbl_user")
+}
+`;
+  await fs.outputFile(path.join(projectPath, "prisma/schema.prisma"), prismaSchema);
+
+  const defaultUrlMap = {
+    postgresql: `postgresql://root:password@localhost:5432/${dbSafeName}?schema=public`,
+    mysql: `mysql://root:password@localhost:3306/${dbSafeName}?schema=public`,
+    sqlite: `file:./dev.db`,
+    mongodb: `mongodb://localhost:27017/${dbSafeName}`,
+    cockroachdb: `postgresql://root:password@localhost:26257/${dbSafeName}?sslmode=disable`,
+    sqlserver: `sqlserver://localhost:1433;database=${dbSafeName};user=sa;password=your_password;encrypt=false`
+  };
+
+  const envContent = `DATABASE_URL="${defaultUrlMap[provider]}"
+
+JWT_ACCESS_SECRET="JWT_ACCESS_SECRET"
+JWT_REFRESH_SECRET="JWT_REFRESH_SECRET"
+JWT_ACCESS_EXPIRATION_TIME="1d"
+JWT_REFRESH_EXPIRATION_TIME="30d"
+
+AWS_ACCESS_KEY_ID="AWS_ACCESS_KEY_ID"
+AWS_SECRET_ACCESS_KEY="AWS_SECRET_ACCESS_KEY"
+AWS_REGION=ap-southeast-1
+S3_BUCKET="S3_BUCKET"
+
+NODE_ENV=dev
+PROJECT_NAME=${dbSafeName}
+PORT=3000
+`;
+
+  await fs.outputFile(path.join(projectPath, ".env"), envContent);
+  console.log(chalk.green("✅ Prisma schema + .env created!"));
+
+  await execa("npx", ["prisma", "generate"], { cwd: projectPath, stdio: "inherit" });
+  console.log(chalk.green("✅ Prisma client generated!"));
+
+  const templatePath = path.join(__dirname, "template");
+  if (!fs.existsSync(templatePath)) {
+    console.log(chalk.red("❌ Template folder not found!"));
+    process.exit(1);
+  }
+  await fs.copy(templatePath, projectPath, { overwrite: true });
+  console.log(chalk.green("✅ Template files copied successfully!"));
+
+  const packageJsonPath = path.join(projectPath, "package.json");
+  const packageJson = await fs.readJSON(packageJsonPath);
+  packageJson.scripts = {
+    ...packageJson.scripts,
+    "prisma:migrate": "prisma migrate dev --name init",
+    "prisma:generate": "prisma generate",
+    "prisma:deploy": "prisma migrate deploy",
+    "prisma:studio": "prisma studio",
+    "prisma:reset": "prisma migrate reset --force",
+    "postinstall": "prisma generate",
+    "migrate:dev": "dotenv -e .env -- prisma migrate dev",
+    "migrate:staging": "dotenv -e .env -- prisma migrate deploy",
+    "migrate:prod": "dotenv -e .env -- prisma migrate deploy",
+    "seed": "ts-node prisma/seed.ts"
+  };
+  await fs.writeJSON(packageJsonPath, packageJson, { spaces: 2 });
+  console.log(chalk.green("✅ package.json scripts updated successfully!"));
+
+  console.log(chalk.yellow("🎉 Project is ready! Next steps:"));
+  console.log(chalk.cyan(`cd ${projectName}`));
+  console.log(chalk.cyan("Check .env"));
+  console.log(chalk.cyan("npm run prisma:migrate"));
+  console.log(chalk.cyan("npm run seed"));
+  console.log(chalk.cyan("npm run start:dev"));
+}
+
+main().catch(err => {
+  console.error(chalk.red("❌ Error:"), err);
+  process.exit(1);
+});

package/bin/template/.github/workflows/deploy-to-ecr.yml

@@ -0,0 +1,68 @@
+name: Build, Push to ECR, and Deploy to App Runner
+
+on:
+  push:
+    branches:
+      - dev-server
+      - staging-server
+      - prod-server
+
+env:
+  AWS_REGION: ap-southeast-1
+  ECR_REGISTRY: 339713129923.dkr.ecr.ap-southeast-1.amazonaws.com
+  ECR_REPOSITORY: freshmoe-hrms-api
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout source code
+        uses: actions/checkout@v3
+
+      - name: Configure AWS credentials
+        uses: aws-actions/configure-aws-credentials@v2
+        with:
+          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          aws-region: ${{ env.AWS_REGION }}
+
+      - name: Login to Amazon ECR
+        id: login-ecr
+        uses: aws-actions/amazon-ecr-login@v1
+
+      - name: Determine image tag based on branch
+        id: vars
+        run: |
+          SHORT_SHA=${GITHUB_SHA::7}
+
+          case "${GITHUB_REF##*/}" in
+            dev-server)
+              BRANCH_TAG="dev"
+              ;;
+            staging-server)
+              BRANCH_TAG="staging"
+              ;;
+            prod-server)
+              BRANCH_TAG="prod"
+              ;;
+            *)
+              echo "Unsupported branch: ${GITHUB_REF##*/}"
+              exit 1
+              ;;
+          esac
+
+          echo "SHORT_SHA=${SHORT_SHA}" >> $GITHUB_ENV
+          echo "BRANCH_TAG=${BRANCH_TAG}" >> $GITHUB_ENV
+
+      - name: Build, tag, and push Docker image to ECR
+        run: |
+          docker build --no-cache -t $ECR_REGISTRY/$ECR_REPOSITORY:$BRANCH_TAG .
+          docker tag $ECR_REGISTRY/$ECR_REPOSITORY:$BRANCH_TAG $ECR_REGISTRY/$ECR_REPOSITORY:$SHORT_SHA
+
+          docker push $ECR_REGISTRY/$ECR_REPOSITORY:$BRANCH_TAG
+          docker push $ECR_REGISTRY/$ECR_REPOSITORY:$SHORT_SHA
+
+          echo "Docker images pushed:"
+          echo " - $ECR_REGISTRY/$ECR_REPOSITORY:$BRANCH_TAG"
+          echo " - $ECR_REGISTRY/$ECR_REPOSITORY:$SHORT_SHA"

package/bin/template/prisma/schema.prisma

@@ -0,0 +1,20 @@
+generator client {
+    provider = "prisma-client-js"
+  }
+
+  datasource db {
+    provider = "mysql"
+    url      = env("DATABASE_URL")
+  }
+
+  model User {
+    id        Int      @id @default(autoincrement())
+    userId    String   @unique
+    name      String?
+    email     String
+    password  String
+    createdAt DateTime @default(now())
+    updatedAt DateTime @updatedAt
+    @@map("tbl_user")
+  }
+  

package/bin/template/prisma/seed.ts

@@ -0,0 +1,30 @@
+import { PrismaClient } from "@prisma/client";
+import * as argon2 from "argon2";
+
+const prisma = new PrismaClient();
+
+async function main() {
+  const hashedPassword = await argon2.hash("Asdfasdf@123");
+
+  const user = await prisma.user.upsert({
+    where: { userId: "USER_20250815001" },
+    update: {},
+    create: {
+      userId: "USER_20250815001",
+      name: "Kyaw Soe",
+      email: "kyawsoe@gmail.com",
+      password: hashedPassword,
+    },
+  });
+
+  console.log("Seeded user successfully.");
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });

package/bin/template/src/app.controller.spec.ts

@@ -0,0 +1,22 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+
+describe('AppController', () => {
+  let appController: AppController;
+
+  beforeEach(async () => {
+    const app: TestingModule = await Test.createTestingModule({
+      controllers: [AppController],
+      providers: [AppService],
+    }).compile();
+
+    appController = app.get<AppController>(AppController);
+  });
+
+  describe('root', () => {
+    it('should return "Hello World!"', () => {
+      expect(appController.getHello()).toBe('Hello World!');
+    });
+  });
+});

package/bin/template/src/app.controller.ts

@@ -0,0 +1,14 @@
+import { Controller, Get } from '@nestjs/common';
+import { AppService } from './app.service';
+import { Public } from './common/decorator/public.decorator';
+
+@Public()
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get()
+  getHello(): string {
+    return this.appService.getHello();
+  }
+}

package/bin/template/src/app.module.ts

@@ -0,0 +1,42 @@
+import { Module } from '@nestjs/common';
+import { APP_INTERCEPTOR } from '@nestjs/core';
+import { APP_GUARD } from '@nestjs/core';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+import { PrismaModule } from './prisma/prisma.module';
+import {
+  HttpResponseInterceptor,
+  LoggingInterceptor,
+} from './common/http-interceptor/index';
+import { JwtAuthGuard } from './modules/auth/jwt/jwt.guard';
+import { ConfigModule } from '@nestjs/config';
+import { UserModule } from './modules/user/user.module';
+import { AuthModule } from './modules/auth/auth.module';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+    }),
+    PrismaModule,
+    UserModule,
+    AuthModule
+  ],
+  controllers: [AppController],
+  providers: [
+    {
+      provide: APP_INTERCEPTOR,
+      useClass: LoggingInterceptor,
+    },
+    {
+      provide: APP_INTERCEPTOR,
+      useClass: HttpResponseInterceptor,
+    },
+    {
+      provide: APP_GUARD,
+      useClass: JwtAuthGuard,
+    },
+    AppService,
+  ],
+})
+export class AppModule {}

package/bin/template/src/app.service.ts

@@ -0,0 +1,8 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHello(): string {
+    return 'Hello World!';
+  }
+}

package/bin/template/src/common/classes/base64.ts

@@ -0,0 +1,22 @@
+import { IsString, IsNotEmpty, Matches } from 'class-validator';
+
+export default class Base64File {
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+
+  @IsString()
+  @IsNotEmpty()
+  @Matches(
+    /^data:([A-Za-z0-9]+\/[A-Za-z0-9\-\.]+);base64,[A-Za-z0-9\-_+=/]+$/,
+    {
+      message:
+        'content must be a valid base64-encoded string with a valid data URI scheme',
+    },
+  )
+  content: string;
+
+  @IsString()
+  @IsNotEmpty()
+  mimeType: string;
+}

package/bin/template/src/common/decorator/public.decorator.ts

@@ -0,0 +1,4 @@
+import { SetMetadata } from '@nestjs/common';
+
+export const IS_PUBLIC_KEY = 'isPublic';
+export const Public = () => SetMetadata(IS_PUBLIC_KEY, true);

package/bin/template/src/common/dto/index.ts

@@ -0,0 +1,4 @@
+import { PaginatedResponseDto } from './paginated-response.dto';
+import { PaginationDto } from './pagination.dto';
+
+export { PaginationDto, PaginatedResponseDto };

package/bin/template/src/common/dto/paginated-response.dto.ts

@@ -0,0 +1,15 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+export class PaginatedResponseDto<T> {
+  @ApiProperty()
+  total: number;
+
+  @ApiProperty()
+  page: number;
+
+  @ApiProperty()
+  limit: number;
+
+  @ApiProperty({ isArray: true })
+  data: T[];
+}

package/bin/template/src/common/dto/pagination.dto.ts

@@ -0,0 +1,34 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsInt,
+  IsOptional,
+  IsString,
+  Min,
+  IsBooleanString,
+} from 'class-validator';
+
+export class PaginationDto {
+  @ApiPropertyOptional({ example: 1, description: 'Page number' })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page?: number = 1;
+
+  @ApiPropertyOptional({ example: 20, description: 'Items per page' })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  limit?: number = 20;
+
+  @ApiPropertyOptional({ example: '', description: 'Search term' })
+  @IsOptional()
+  @IsString()
+  search?: string;
+
+  @IsOptional()
+  @IsBooleanString()
+  all?: string;
+}

package/bin/template/src/common/enums/db-error-code.enum.ts

@@ -0,0 +1,5 @@
+export enum DBErrorCode {
+  PgNotNullConstraintViolation = '23502',
+  PgForeignKeyConstraintViolation = '23503',
+  PgUniqueConstraintViolation = '23505',
+}

package/bin/template/src/common/enums/index.ts

@@ -0,0 +1,4 @@
+import { DBErrorCode } from './db-error-code.enum';
+import { MESSAGE_CODE } from './message-code.enum';
+
+export { DBErrorCode, MESSAGE_CODE };

package/bin/template/src/common/enums/message-code.enum.ts

@@ -0,0 +1,20 @@
+export enum MESSAGE_CODE {
+  SAVE_SUCCESS = 201,
+  SIGNIN_SUCCESS = 202,
+  SUCCESS = 203,
+  PASSWORD_SUCCESS = 204,
+  DATA_NOT_FOUND = 205,
+  USER_VERIFY = 206,
+  WRONG_USER_PW = 401,
+  INVALID_USER_ID = 402,
+  MISSED_TOKEN = 403,
+  UNAUTHORIZED = 404,
+  USER_EXIST = 406,
+  TOKEN_ERROR = 407,
+  INVALID = 408,
+  NOT_FOUND = 409,
+  ROUTE_NOT_FOUND = 410,
+  REQUEST_FIELD_REQUIRED = 411,
+  DELETE_USER = 412,
+  SERVER_ERROR = 501,
+}

package/bin/template/src/common/http-interceptor/http-error-type.ts

@@ -0,0 +1,31 @@
+export const HttpErrorType = {
+  400: 'BAD_REQUEST',
+  401: 'UNAUTHORIZED',
+  402: 'PAYMENT_REQUIRED',
+  403: 'FORBIDDEN',
+  404: 'NOT_FOUND',
+  405: 'METHOD_NOT_ALLOWED',
+  406: 'NOT_ACCEPTABLE',
+  407: 'PROXY_AUTHENTICATION_REQUIRED',
+  408: 'REQUEST_TIMEOUT',
+  409: 'CONFLICT',
+  410: 'GONE',
+  411: 'LENGTH_REQUIRED',
+  412: 'PRECONDITION_FAILED',
+  413: 'PAYLOAD_TOO_LARGE',
+  414: 'URI_TOO_LONG',
+  415: 'UNSUPPORTED_MEDIA_TYPE',
+  416: 'REQUESTED_RANGE_NOT_SATISFIABLE',
+  417: 'EXPECTATION_FAILED',
+  418: 'I_AM_A_TEAPOT',
+  421: 'MISDIRECTED',
+  422: 'UNPROCESSABLE_ENTITY',
+  424: 'FAILED_DEPENDENCY',
+  429: 'TOO_MANY_REQUESTS',
+  500: 'INTERNAL_SERVER_ERROR',
+  501: 'NOT_IMPLEMENTED',
+  502: 'BAD_GATEWAY',
+  503: 'SERVICE_UNAVAILABLE',
+  504: 'GATEWAY_TIMEOUT',
+  505: 'HTTP_VERSION_NOT_SUPPORTED',
+};

package/bin/template/src/common/http-interceptor/http-exception.filter.ts

@@ -0,0 +1,94 @@
+import {
+  ExceptionFilter,
+  Catch,
+  ArgumentsHost,
+  HttpException,
+  HttpStatus,
+} from '@nestjs/common';
+import { Request, Response } from 'express';
+import { DBErrorCode, MESSAGE_CODE } from '../enums';
+import { AppLogger } from '../logger/winston.logger';
+
+@Catch()
+export class HttpExceptionFilter implements ExceptionFilter {
+  catch(exception: unknown, host: ArgumentsHost) {
+    console.log(exception, 'exception');
+    const ctx = host.switchToHttp();
+    const request = ctx.getRequest<Request>();
+    const response = ctx.getResponse<Response>();
+
+    let status = HttpStatus.INTERNAL_SERVER_ERROR;
+    let message = 'An unexpected error occurred';
+    let messageCode: string | number = status;
+
+    if (exception instanceof HttpException) {
+      status = exception.getStatus();
+      const exceptionResponse = exception.getResponse();
+
+      if (typeof exceptionResponse === 'string') {
+        message = capitalizeFirst(exceptionResponse);
+        messageCode = MESSAGE_CODE.INVALID;
+      } else if (
+        typeof exceptionResponse === 'object' &&
+        exceptionResponse !== null
+      ) {
+        const res: any = exceptionResponse;
+        const rawMessage = Array.isArray(res.message)
+          ? res.message[0]
+          : (res.message ?? message);
+
+        message = capitalizeFirst(rawMessage);
+        messageCode =
+          res.messageCode ??
+          (status === HttpStatus.BAD_REQUEST ? MESSAGE_CODE.INVALID : status);
+      } else {
+        message = capitalizeFirst(exception.message);
+        messageCode = status;
+      }
+    } else if (typeof exception === 'object' && exception !== null) {
+      const ex: any = exception;
+      if (ex.code) {
+        switch (ex.code) {
+          case DBErrorCode.PgUniqueConstraintViolation:
+            status = HttpStatus.CONFLICT;
+            message = 'Unique constraint violated';
+            messageCode = MESSAGE_CODE.INVALID;
+            break;
+          case DBErrorCode.PgForeignKeyConstraintViolation:
+            status = HttpStatus.CONFLICT;
+            message = 'Foreign key constraint violated';
+            messageCode = MESSAGE_CODE.INVALID;
+            break;
+          case DBErrorCode.PgNotNullConstraintViolation:
+            status = HttpStatus.BAD_REQUEST;
+            message = 'Not null constraint violated';
+            messageCode = MESSAGE_CODE.INVALID;
+            break;
+          default:
+            message = capitalizeFirst(ex.message || 'Database exception');
+            messageCode = status;
+        }
+      }
+    }
+
+    const duration = Date.now() - (request as any).__startTime || 0;
+    const logMessage = `${request.method} ${request.originalUrl} ${status} - ${duration}ms | Message Code: ${messageCode} | Message: ${message} | Headers: ${JSON.stringify(request.headers)}`;
+
+    if (status >= 500) {
+      AppLogger.error(logMessage);
+    } else {
+      AppLogger.warn(logMessage);
+    }
+
+    response.status(status).json({
+      statusCode: status,
+      messageCode,
+      message,
+    });
+  }
+}
+
+function capitalizeFirst(text: string): string {
+  if (!text || typeof text !== 'string') return text;
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}

package/bin/template/src/common/http-interceptor/index.ts

@@ -0,0 +1,5 @@
+import { HttpExceptionFilter } from './http-exception.filter';
+import { LoggingInterceptor } from './logging.interceptor';
+import { HttpResponseInterceptor } from './response.interceptor';
+
+export { HttpResponseInterceptor, LoggingInterceptor, HttpExceptionFilter };