create-zhx-monorepo 0.2.2 → 2.0.0

package/templates/monorepo-starter/pnpm-workspace.yaml

@@ -1,17 +1,4 @@
 packages:
-  - "apps/*"
-  - "packages/*"
-  - "server"
-
-onlyBuiltDependencies:
-  - "@nestjs/core"
-  - "@swc/core"
-  - "@tailwindcss/oxide"
-  - "core-js-pure"
-  - "esbuild"
-  - "sharp"
-  - "unrs-resolver"
-  - "@prisma/client"
-  - "@prisma/engines"
-  - "prisma"
-  - argon2
+  - apps/*
+  - packages/*
+  - server

package/templates/monorepo-starter/server/.env.example

@@ -13,7 +13,7 @@ ADMIN_ENDPOINT="http://localhost:3001"
 # Database
 # ==============================
 # example "postgresql://DB_USER:DB_PASSWORD@DB_HOST:DB_PORT/DB_NAME"
-DB_URI="postgresql://postgres:47425@localhost:5432/your-proj"
+DB_URI="postgresql://postgres:47425@localhost:5432/owits-agency"
 
 # ==============================
 # OTP
@@ -47,9 +47,12 @@ TWILIO_AUTH_TOKEN="your-twilio-auth-token"
 TWILIO_PHONE_NUMBER="+1234567890"
 
 # ==============================
-# Email (Resend)
+# Email (Nodemailer)
 # ==============================
-RESEND_API_KEY="your-resend-api-key"
+SMTP_HOST='your-smtp-host'
+SMTP_PORT='your-smtp-port'
+SMTP_USER='your-smtp-user'
+SMTP_PASS='your-smtp-pass'
 
 # ==============================
 # API Keys
@@ -59,7 +62,6 @@ IP_STACK_API_KEY="your-ipstack-api-key"
 # ==============================
 # Admin
 # ==============================
+ADMIN_NAME="Admin User"
 ADMIN_EMAIL="admin@example.com"
 ADMIN_PASSWORD="super-secret-password"
-ADMIN_NAME="Admin User"
-ADMIN_PHONE="+1234567890"

package/templates/monorepo-starter/server/eslint.config.mjs

@@ -1,4 +1 @@
-import { config } from '@workspace/config/eslint/nest';
-
-/** @type {import("eslint").Linter.Config} */
-export default config;
+export { default } from "@workspace/config/eslint/node";

package/templates/monorepo-starter/server/package.json

@@ -1,97 +1,129 @@
-{
-  "name": "server",
-  "version": "0.0.1",
-  "type": "module",
-  "private": true,
-  "license": "UNLICENSED",
-  "scripts": {
-    "dev": "tsup src/main.ts --watch",
-    "build": "tsup",
-    "start": "node dist/main.js",
-    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
-    "format": "prettier --write \"{src,apps,libs,test}/**/*.ts\"",
-    "prisma:generate": "prisma generate",
-    "prisma:migrate:dev": "prisma migrate dev --name init",
-    "prisma:migrate:prod": "prisma migrate deploy --name init",
-    "prisma:studio": "prisma studio",
-    "prisma:validate": "prisma validate",
-    "prisma:reset": "prisma migrate reset",
-    "generate:module": "bash ./scripts/nest-gen.sh",
-    "test": "jest",
-    "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"
-  },
-  "dependencies": {
-    "@nestjs/common": "^11.1.9",
-    "@nestjs/config": "^4.0.2",
-    "@nestjs/core": "^11.1.9",
-    "@nestjs/jwt": "^11.0.2",
-    "@nestjs/passport": "^11.0.5",
-    "@nestjs/platform-express": "^11.1.9",
-    "@nestjs/schedule": "^6.1.0",
-    "@prisma/adapter-pg": "^7.2.0",
-    "@prisma/client": "^7.2.0",
-    "argon2": "^0.44.0",
-    "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.3",
-    "cookie-parser": "^1.4.7",
-    "ms": "^2.1.3",
-    "nest-winston": "^1.10.2",
-    "passport": "^0.7.0",
-    "passport-facebook": "^3.0.0",
-    "passport-google-oauth20": "^2.0.0",
-    "pg": "^8.16.3",
-    "reflect-metadata": "^0.2.2",
-    "resend": "^6.6.0",
-    "rxjs": "^7.8.2",
-    "winston": "^3.19.0",
-    "winston-daily-rotate-file": "^5.0.0",
-    "zod": "^4.2.1"
-  },
-  "devDependencies": {
-    "@nestjs/cli": "^11.0.14",
-    "@nestjs/schematics": "^11.0.9",
-    "@nestjs/testing": "^11.1.9",
-    "@swc/cli": "^0.7.9",
-    "@swc/core": "^1.15.7",
-    "@types/cookie-parser": "^1.4.10",
-    "@types/express": "^5.0.6",
-    "@types/jest": "^30.0.0",
-    "@types/ms": "^2.1.0",
-    "@types/node": "^25.0.3",
-    "@types/passport": "^1.0.17",
-    "@types/passport-facebook": "^3.0.4",
-    "@types/passport-google-oauth20": "^2.0.17",
-    "@types/pg": "^8.16.0",
-    "@types/supertest": "^6.0.3",
-    "@workspace/config": "workspace:^",
-    "jest": "^30.2.0",
-    "prisma": "^7.2.0",
-    "source-map-support": "^0.5.21",
-    "supertest": "^7.1.4",
-    "ts-jest": "^29.4.6",
-    "ts-loader": "^9.5.4",
-    "ts-node": "^10.9.2",
-    "tsconfig-paths": "^4.2.0",
-    "tsup": "^8.5.1"
-  },
-  "jest": {
-    "moduleFileExtensions": [
-      "js",
-      "json",
-      "ts"
-    ],
-    "rootDir": "src",
-    "testRegex": ".*\\.spec\\.ts$",
-    "transform": {
-      "^.+\\.(t|j)s$": "ts-jest"
-    },
-    "collectCoverageFrom": [
-      "**/*.(t|j)s"
-    ],
-    "coverageDirectory": "../coverage",
-    "testEnvironment": "node"
-  }
-}
+{
+  "name": "server",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "license": "UNLICENSED",
+  "scripts": {
+    "dev": "tsup src/main.ts --watch",
+    "start": "node dist/main.js",
+    "build": "tsup",
+    "lint": "eslint",
+    "check-types": "tsc --noEmit",
+    "format": "prettier --write \"{src,apps,libs,test}/**/*.ts\"",
+    "generate:module": "bash ./scripts/gen-module.sh",
+    "prisma:generate": "prisma generate && tsx ./scripts/gen-soft-delete",
+    "prisma:migrate:dev": "prisma migrate dev",
+    "prisma:migrate:prod": "dotenv -e .env.prod -- prisma migrate deploy",
+    "prisma:studio": "prisma studio",
+    "prisma:validate": "prisma validate",
+    "prisma:reset": "prisma migrate reset",
+    "prisma:seed": "prisma db seed",
+    "prisma:setup:dev": "prisma migrate dev && pnpm prisma:generate",
+    "admin:bootstrap:dev": "dotenv -e .env -- tsx scripts/admin-bootstrap.ts",
+    "admin:bootstrap:prod": "dotenv -e .env.prod -- tsx scripts/admin-bootstrap.ts",
+    "test": "jest",
+    "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"
+  },
+  "dependencies": {
+    "@keyv/redis": "^5.1.6",
+    "@nestjs/cache-manager": "^3.1.0",
+    "@nestjs/common": "^11.1.16",
+    "@nestjs/config": "^4.0.3",
+    "@nestjs/core": "^11.1.16",
+    "@nestjs/passport": "^11.0.5",
+    "@nestjs/platform-express": "^11.1.16",
+    "@nestjs/schedule": "^6.1.1",
+    "@prisma/adapter-pg": "^7.4.2",
+    "@prisma/client": "^7.4.2",
+    "argon2": "^0.44.0",
+    "axios": "^1.13.6",
+    "cache-manager": "^7.2.8",
+    "cloudinary": "^2.9.0",
+    "cookie-parser": "^1.4.7",
+    "dotenv": "^17.3.1",
+    "firebase-admin": "^13.7.0",
+    "jose": "^6.2.0",
+    "lodash": "^4.17.23",
+    "ms": "^2.1.3",
+    "nest-winston": "^1.10.2",
+    "nestjs-zod": "^5.1.1",
+    "nodemailer": "^8.0.1",
+    "passport": "^0.7.0",
+    "passport-facebook": "^3.0.0",
+    "passport-google-oauth20": "^2.0.0",
+    "pg": "^8.20.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "streamifier": "^0.1.1",
+    "twilio": "^5.12.2",
+    "ua-parser-js": "^2.0.9",
+    "ulid": "^3.0.2",
+    "winston": "^3.19.0",
+    "winston-daily-rotate-file": "^5.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.3",
+    "@nestjs/cli": "^11.0.16",
+    "@nestjs/schematics": "^11.0.9",
+    "@nestjs/testing": "^11.1.16",
+    "@swc/cli": "^0.7.10",
+    "@swc/core": "^1.15.18",
+    "@types/cookie-parser": "^1.4.10",
+    "@types/express": "^5.0.6",
+    "@types/jest": "^30.0.0",
+    "@types/lodash": "^4.17.24",
+    "@types/ms": "^2.1.0",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^25.3.5",
+    "@types/nodemailer": "^7.0.11",
+    "@types/passport": "^1.0.17",
+    "@types/passport-facebook": "^3.0.4",
+    "@types/passport-google-oauth20": "^2.0.17",
+    "@types/pg": "^8.18.0",
+    "@types/streamifier": "^0.1.2",
+    "@types/supertest": "^6.0.3",
+    "@workspace/config": "workspace:*",
+    "@workspace/contracts": "workspace:*",
+    "@workspace/shared": "workspace:*",
+    "@workspace/templates": "workspace:*",
+    "dotenv-cli": "^11.0.0",
+    "eslint": "^9.39.3",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-turbo": "^2.8.13",
+    "globals": "^17.4.0",
+    "jest": "^30.2.0",
+    "prisma": "^7.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.2.2",
+    "ts-jest": "^29.4.6",
+    "ts-loader": "^9.5.4",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript-eslint": "^8.56.1"
+  },
+  "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/monorepo-starter/server/prisma/schema.prisma

@@ -1,5 +1,3 @@
-// prisma/schema.prisma
-
 generator client {
   provider = "prisma-client"
   output   = "./generated"
@@ -13,24 +11,36 @@ datasource db {
 // ENUMS
 //
 
+enum ThemeMode {
+  light
+  dark
+  system
+}
+
 enum UserRole {
   admin
   customer
 }
 
+enum UserStatus {
+  pending
+  active
+  suspended
+}
+
 enum OtpPurpose {
-  setPassword
-  resetPassword
-  verifyIdentifier
-  changeIdentifier
-  enableMfa
-  disableMfa
-  verifyMfa
+  authSetPassword
+  authResetPassword
+  authVerifyIdentifier
+  authUpdateIdentifier
+  authUpdateMfa
+  authDisableMfa
+  authVerifyMfa
 }
 
 enum OtpType {
-  otp
-  token
+  numericCode
+  secureToken
 }
 
 enum MfaMethod {
@@ -40,18 +50,65 @@ enum MfaMethod {
   authApp
 }
 
-enum NotificationType {
+enum SessionStatus {
+  active
+  revoked
+  expired
+}
+
+enum NotificationChannel {
+  push
   email
   sms
   whatsapp
-  inApp
+}
+
+enum MessagingChannel {
+  sms
+  whatsapp
+}
+
+enum PushProvider {
+  fcm
+  expo
+}
+
+enum NotificationPurpose {
+  authSignUp
+  authSignIn
+  authSetPassword
+  authResetPassword
+  authVerifyIdentifier
+  authUpdateIdentifier
+  authUpdateMfa
+  authDisableMfa
+  authVerifyMfa
+
+  accountSuspended
+  accountReactivated
+}
+
+enum NotificationPriority {
+  normal
+  important
 }
 
 enum NotificationStatus {
   pending
+  partial
   sent
   failed
-  read
+}
+
+enum MediaVisibility {
+  private
+  public
+}
+
+enum MediaType {
+  photo
+  logo
+  other
 }
 
 //
@@ -59,102 +116,85 @@ enum NotificationStatus {
 //
 
 model User {
+  // Core fields
   id          String  @id @default(ulid())
-  username    String? @unique
-  password    String?
   firstName   String
   lastName    String?
   displayName String
-  imageUrl    String?
+  password    String? @db.VarChar(255)
+
+  imageId String?
+  image   Media?  @relation("UserImage", fields: [imageId], references: [id])
 
-  // Contact
-  email           String? @unique
-  phone           String? @unique
+  // Contact info
+  email           String? @unique @db.VarChar(255)
+  phone           String? @unique @db.VarChar(20)
   isEmailVerified Boolean @default(false)
   isPhoneVerified Boolean @default(false)
 
-  // Status
+  role   UserRole
+  status UserStatus @default(pending)
+
+  preferredTheme    ThemeMode @default(system)
+  pushNotifications Boolean   @default(false)
+
+  preferredMfa    MfaMethod?
+  fallbackChannel MessagingChannel @default(sms)
+
+  loginAlerts Boolean   @default(true)
   lastLoginAt DateTime?
 
+  // Meta
   createdAt DateTime  @default(now())
   updatedAt DateTime  @updatedAt
   deletedAt DateTime?
 
   // Relations
-  refreshTokens   RefreshToken[]
-  otps            Otp[]
-  roles           RoleAssignment[]
-  securitySetting SecuritySetting?
-
+  otps          Otp[]
+  sessions      Session[]
   notifications Notification[]
-  backupCodes   BackupCode[]
+  medias        Media[]        @relation("UserUploads")
 
-  @@index([email])
-  @@index([phone])
-  @@index([username])
+  // Indexes
+  @@index([status])
+  @@index([role])
   @@index([email, isEmailVerified])
   @@index([phone, isPhoneVerified])
+  @@index([deletedAt])
 }
 
-model RoleAssignment {
-  id     String   @id @default(ulid())
+model Session {
+  id String @id @default(ulid())
+
   userId String
-  user   User     @relation(fields: [userId], references: [id], onDelete: Cascade)
-  role   UserRole
+  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
 
-  createdAt DateTime  @default(now())
-  updatedAt DateTime  @updatedAt
-  revokedAt DateTime?
+  refreshTokenHash String
+  status           SessionStatus @default(active)
 
-  @@unique([userId, role])
-}
+  ip       String
+  location String
+  isp      String?
+  timezone String
 
-model SecuritySetting {
-  id     String @id @default(ulid())
-  userId String @unique
-  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
-
-  preferredMfa  MfaMethod?
-  recoveryEmail String?
-  recoveryPhone String?
-  isMfaEnabled  Boolean    @default(false)
-  loginAlerts   Boolean    @default(true)
+  deviceId   String
+  deviceType String
+  deviceInfo String
 
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  isTrusted  Boolean   @default(false)
+  lastSeenAt DateTime?
 
-  @@index([userId])
-  @@index([isMfaEnabled])
-}
+  pushProvider PushProvider?
+  pushToken    String?
 
-model BackupCode {
-  id        String    @id @default(ulid())
-  userId    String
-  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
-  code      String    @unique
-  usedAt    DateTime?
   createdAt DateTime  @default(now())
   expiresAt DateTime
+  revokedAt DateTime?
 
-  @@index([userId, usedAt])
-}
-
-model RefreshToken {
-  id          String   @id @default(ulid())
-  token       String   @unique
-  userId      String
-  user        User     @relation(fields: [userId], references: [id], onDelete: Cascade)
-  ip          String
-  userAgent   String
-  lastUsed    DateTime @default(now())
-  createdAt   DateTime @default(now())
-  expiresAt   DateTime
-  isActive    Boolean  @default(true)
-  blacklisted Boolean  @default(false)
-
-  @@index([userId])
+  @@unique([userId, deviceId])
   @@index([expiresAt])
-  @@index([userId, expiresAt])
+  @@index([userId, status])
+  @@index([expiresAt, status])
 }
 
 model Otp {
@@ -162,8 +202,9 @@ model Otp {
   userId    String
   user      User       @relation(fields: [userId], references: [id], onDelete: Cascade)
   purpose   OtpPurpose
-  type      OtpType    @default(otp)
+  type      OtpType    @default(numericCode)
   secret    String
+  meta      Json?
   expiresAt DateTime
   usedAt    DateTime?
   createdAt DateTime   @default(now())
@@ -174,20 +215,57 @@ model Otp {
 }
 
 model Notification {
-  id        String             @id @default(cuid())
-  userId    String
-  user      User               @relation(fields: [userId], references: [id], onDelete: Cascade)
-  type      NotificationType
-  title     String?
-  message   String?
-  purpose   String
-  metadata  Json?
-  status    NotificationStatus @default(pending)
-  sentAt    DateTime?
+  id     String @id @default(ulid())
+  userId String
+  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  purpose  NotificationPurpose
+  channels NotificationChannel[]
+  priority NotificationPriority  @default(normal)
+
+  subject   String
+  message   String
+  recipient String
+  meta      Json?
+
+  status NotificationStatus @default(pending)
+
   readAt    DateTime?
-  createdAt DateTime           @default(now())
-  updatedAt DateTime           @updatedAt
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
 
   @@index([userId])
-  @@index([userId, readAt])
+  @@index([status, createdAt])
+}
+
+model Media {
+  id String @id @default(ulid())
+
+  uploadedById String
+  uploadedBy   User   @relation("UserUploads", fields: [uploadedById], references: [id])
+
+  url      String @unique
+  filename String
+  mimeType String
+  size     Int
+  hash     String @unique
+
+  title      String
+  altText    String?
+  type       MediaType
+  visibility MediaVisibility @default(private)
+
+  notes String?
+
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+  deletedAt DateTime?
+
+  users User[] @relation("UserImage")
+
+  @@index([type])
+  @@index([filename])
+  @@index([uploadedById])
+  @@index([createdAt])
+  @@index([deletedAt])
 }

package/templates/monorepo-starter/server/prisma.config.ts

@@ -1,13 +1,13 @@
-import 'dotenv/config'
+import "dotenv/config";
 import { defineConfig, env } from "prisma/config";
 
 export default defineConfig({
-  schema: 'prisma/schema.prisma',
-  migrations: { 
-    path: 'prisma/migrations',
-    seed: 'tsx prisma/seed.ts',
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+    seed: "tsx prisma/seed.ts",
   },
-  datasource: { 
-    url: env("DB_URI") 
-  }
-});
+  datasource: {
+    url: env("DB_URI"),
+  },
+});